From b0173564ff96dc19e77bd3c8ee8dff600ddab771 Mon Sep 17 00:00:00 2001
From: Kostas Krikellas <131142368+kkrik-es@users.noreply.github.com>
Date: Wed, 4 Dec 2024 11:44:42 +0200
Subject: [PATCH 001/119] Doc parsing error logging with throttling (#117828)

* Throttled doc parsing error logging

* add test

* move throttler to separate class

* small changes

* refactor unittest

* fix test
---
 .../index/mapper/DocumentMapper.java          | 10 +--
 .../index/mapper/IntervalThrottler.java       | 66 +++++++++++++++++++
 .../index/mapper/DocumentMapperTests.java     | 37 +++++++++++
 .../index/mapper/IntervalThrottlerTests.java  | 27 ++++++++
 4 files changed, 136 insertions(+), 4 deletions(-)
 create mode 100644 server/src/main/java/org/elasticsearch/index/mapper/IntervalThrottler.java
 create mode 100644 server/src/test/java/org/elasticsearch/index/mapper/IntervalThrottlerTests.java

diff --git a/server/src/main/java/org/elasticsearch/index/mapper/DocumentMapper.java b/server/src/main/java/org/elasticsearch/index/mapper/DocumentMapper.java
index 1c9321737ab5f..c56885eded38f 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/DocumentMapper.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/DocumentMapper.java
@@ -21,6 +21,8 @@
 import java.util.List;
 
 public class DocumentMapper {
+    static final NodeFeature INDEX_SORTING_ON_NESTED = new NodeFeature("mapper.index_sorting_on_nested");
+
     private final String type;
     private final CompressedXContent mappingSource;
     private final MappingLookup mappingLookup;
@@ -29,8 +31,6 @@ public class DocumentMapper {
     private final IndexVersion indexVersion;
     private final Logger logger;
 
-    static final NodeFeature INDEX_SORTING_ON_NESTED = new NodeFeature("mapper.index_sorting_on_nested");
-
     /**
      * Create a new {@link DocumentMapper} that holds empty mappings.
      * @param mapperService the mapper service that holds the needed components
@@ -72,9 +72,11 @@ public static DocumentMapper createEmpty(MapperService mapperService) {
             : "provided source [" + source + "] differs from mapping [" + mapping.toCompressedXContent() + "]";
     }
 
-    private void maybeLogDebug(Exception ex) {
+    private void maybeLog(Exception ex) {
         if (logger.isDebugEnabled()) {
             logger.debug("Error while parsing document: " + ex.getMessage(), ex);
+        } else if (IntervalThrottler.DOCUMENT_PARSING_FAILURE.accept()) {
+            logger.error("Error while parsing document: " + ex.getMessage(), ex);
         }
     }
 
@@ -125,7 +127,7 @@ public ParsedDocument parse(SourceToParse source) throws DocumentParsingExceptio
         try {
             return documentParser.parseDocument(source, mappingLookup);
         } catch (Exception e) {
-            maybeLogDebug(e);
+            maybeLog(e);
             throw e;
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/IntervalThrottler.java b/server/src/main/java/org/elasticsearch/index/mapper/IntervalThrottler.java
new file mode 100644
index 0000000000000..ffc35d9eaf769
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/index/mapper/IntervalThrottler.java
@@ -0,0 +1,66 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.index.mapper;
+
+import java.util.concurrent.atomic.AtomicBoolean;
+
+/**
+ * Throttles tracked operations based on a time interval, restricting them to 1 per N seconds.
+ */
+enum IntervalThrottler {
+    DOCUMENT_PARSING_FAILURE(60);
+
+    static final int MILLISECONDS_IN_SECOND = 1000;
+
+    private final Acceptor acceptor;
+
+    IntervalThrottler(long intervalSeconds) {
+        acceptor = new Acceptor(intervalSeconds * MILLISECONDS_IN_SECOND);
+    }
+
+    /**
+     * @return true if the operation gets accepted, false if throttled.
+     */
+    boolean accept() {
+        return acceptor.accept();
+    }
+
+    // Defined separately for testing.
+    static class Acceptor {
+        private final long intervalMillis;
+        private final AtomicBoolean lastAcceptedGuard = new AtomicBoolean(false);
+        private volatile long lastAcceptedTimeMillis = 0;
+
+        Acceptor(long intervalMillis) {
+            this.intervalMillis = intervalMillis;
+        }
+
+        boolean accept() {
+            final long now = System.currentTimeMillis();
+            // Check without guarding first, to reduce contention.
+            if (now - lastAcceptedTimeMillis > intervalMillis) {
+                // Check if another concurrent operation succeeded.
+                if (lastAcceptedGuard.compareAndSet(false, true)) {
+                    try {
+                        // Repeat check under guard protection, so that only one message gets written per interval.
+                        if (now - lastAcceptedTimeMillis > intervalMillis) {
+                            lastAcceptedTimeMillis = now;
+                            return true;
+                        }
+                    } finally {
+                        // Reset guard.
+                        lastAcceptedGuard.set(false);
+                    }
+                }
+            }
+            return false;
+        }
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperTests.java
index db9fdead949de..b2ba3d60d2174 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/DocumentMapperTests.java
@@ -9,12 +9,18 @@
 
 package org.elasticsearch.index.mapper;
 
+import org.apache.logging.log4j.Level;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.apache.logging.log4j.core.LogEvent;
 import org.apache.lucene.analysis.Analyzer;
 import org.apache.lucene.analysis.core.KeywordAnalyzer;
 import org.apache.lucene.analysis.core.WhitespaceAnalyzer;
 import org.apache.lucene.analysis.standard.StandardAnalyzer;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.compress.CompressedXContent;
+import org.elasticsearch.common.logging.Loggers;
+import org.elasticsearch.common.logging.MockAppender;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.index.IndexSettings;
 import org.elasticsearch.index.IndexVersion;
@@ -493,4 +499,35 @@ public void testDeeplyNestedMapping() throws Exception {
             }
         }
     }
+
+    public void testParsingErrorLogging() throws Exception {
+        MockAppender appender = new MockAppender("mock_appender");
+        appender.start();
+        Logger testLogger = LogManager.getLogger(DocumentMapper.class);
+        Loggers.addAppender(testLogger, appender);
+        Level originalLogLevel = testLogger.getLevel();
+        Loggers.setLevel(testLogger, Level.ERROR);
+
+        try {
+            DocumentMapper doc = createDocumentMapper(mapping(b -> b.startObject("value").field("type", "integer").endObject()));
+
+            DocumentParsingException e = expectThrows(
+                DocumentParsingException.class,
+                () -> doc.parse(source(b -> b.field("value", "foo")))
+            );
+            assertThat(e.getMessage(), containsString("failed to parse field [value] of type [integer] in document with id '1'"));
+            LogEvent event = appender.getLastEventAndReset();
+            if (event != null) {
+                assertThat(event.getMessage().getFormattedMessage(), containsString(e.getMessage()));
+            }
+
+            e = expectThrows(DocumentParsingException.class, () -> doc.parse(source(b -> b.field("value", "foo"))));
+            assertThat(e.getMessage(), containsString("failed to parse field [value] of type [integer] in document with id '1'"));
+            assertThat(appender.getLastEventAndReset(), nullValue());
+        } finally {
+            Loggers.setLevel(testLogger, originalLogLevel);
+            Loggers.removeAppender(testLogger, appender);
+            appender.stop();
+        }
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/IntervalThrottlerTests.java b/server/src/test/java/org/elasticsearch/index/mapper/IntervalThrottlerTests.java
new file mode 100644
index 0000000000000..25fd614524441
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/index/mapper/IntervalThrottlerTests.java
@@ -0,0 +1,27 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.index.mapper;
+
+import org.elasticsearch.test.ESTestCase;
+
+public class IntervalThrottlerTests extends ESTestCase {
+
+    public void testThrottling() throws Exception {
+        var throttler = new IntervalThrottler.Acceptor(10);
+        assertTrue(throttler.accept());
+        assertFalse(throttler.accept());
+        assertFalse(throttler.accept());
+
+        Thread.sleep(20);
+        assertTrue(throttler.accept());
+        assertFalse(throttler.accept());
+        assertFalse(throttler.accept());
+    }
+}

From cda2fe68a3a549e2443ca7137b4df431af6f2ba7 Mon Sep 17 00:00:00 2001
From: Luke Whiting <luke.whiting@elastic.co>
Date: Wed, 4 Dec 2024 10:55:13 +0000
Subject: [PATCH 002/119] [CI] DocsClientYamlTestSuiteIT test
 {yaml=reference/watcher/example-watches/example-watch-clusterstatus/line_137}
 failing - (#115809) (#117354)

* Ignore system index access errors in YAML test index cleanup method

* Remove test mute

* Swap the logic back as it was right the first time

* Resolve conflict with latest merge

* Move warning handler into it's own method to reduce nesting
---
 muted-tests.yml                               |  3 --
 .../test/rest/ESRestTestCase.java             | 41 +++++++++----------
 2 files changed, 20 insertions(+), 24 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index b2f5b08319ff7..17a7b26d1c091 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -100,9 +100,6 @@ tests:
 - class: org.elasticsearch.xpack.test.rest.XPackRestIT
   method: test {p0=transform/transforms_start_stop/Verify start transform reuses destination index}
   issue: https://github.com/elastic/elasticsearch/issues/115808
-- class: org.elasticsearch.smoketest.DocsClientYamlTestSuiteIT
-  method: test {yaml=reference/watcher/example-watches/example-watch-clusterstatus/line_137}
-  issue: https://github.com/elastic/elasticsearch/issues/115809
 - class: org.elasticsearch.search.StressSearchServiceReaperIT
   method: testStressReaper
   issue: https://github.com/elastic/elasticsearch/issues/115816
diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
index bdef0ba631b72..b4f4243fb90fd 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
@@ -26,6 +26,8 @@
 import org.apache.http.ssl.SSLContextBuilder;
 import org.apache.http.ssl.SSLContexts;
 import org.apache.http.util.EntityUtils;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
 import org.elasticsearch.Build;
 import org.elasticsearch.TransportVersion;
 import org.elasticsearch.TransportVersions;
@@ -158,6 +160,8 @@ public abstract class ESRestTestCase extends ESTestCase {
 
     private static final Pattern SEMANTIC_VERSION_PATTERN = Pattern.compile("^(\\d+\\.\\d+\\.\\d+)\\D?.*");
 
+    private static final Logger SUITE_LOGGER = LogManager.getLogger(ESRestTestCase.class);
+
     /**
      * Convert the entity from a {@link Response} into a map of maps.
      * Consumes the underlying HttpEntity, releasing any resources it may be holding.
@@ -1111,7 +1115,14 @@ protected static void wipeAllIndices(boolean preserveSecurityIndices) throws IOE
             }
             final Request deleteRequest = new Request("DELETE", Strings.collectionToCommaDelimitedString(indexPatterns));
             deleteRequest.addParameter("expand_wildcards", "open,closed,hidden");
-            deleteRequest.setOptions(deleteRequest.getOptions().toBuilder().setWarningsHandler(ignoreAsyncSearchWarning()).build());
+
+            // If system index warning, ignore but log
+            // See: https://github.com/elastic/elasticsearch/issues/117099
+            // and: https://github.com/elastic/elasticsearch/issues/115809
+            deleteRequest.setOptions(
+                RequestOptions.DEFAULT.toBuilder().setWarningsHandler(ESRestTestCase::ignoreSystemIndexAccessWarnings)
+            );
+
             final Response response = adminClient().performRequest(deleteRequest);
             try (InputStream is = response.getEntity().getContent()) {
                 assertTrue((boolean) XContentHelper.convertToMap(XContentType.JSON.xContent(), is, true).get("acknowledged"));
@@ -1124,28 +1135,16 @@ protected static void wipeAllIndices(boolean preserveSecurityIndices) throws IOE
         }
     }
 
-    // Make warnings handler that ignores the .async-search warning since .async-search may randomly appear when async requests are slow
-    // See: https://github.com/elastic/elasticsearch/issues/117099
-    protected static WarningsHandler ignoreAsyncSearchWarning() {
-        return new WarningsHandler() {
-            @Override
-            public boolean warningsShouldFailRequest(List<String> warnings) {
-                if (warnings.isEmpty()) {
-                    return false;
-                }
-                return warnings.equals(
-                    List.of(
-                        "this request accesses system indices: [.async-search], "
-                            + "but in a future major version, direct access to system indices will be prevented by default"
-                    )
-                ) == false;
+    private static boolean ignoreSystemIndexAccessWarnings(List<String> warnings) {
+        for (String warning : warnings) {
+            if (warning.startsWith("this request accesses system indices:")) {
+                SUITE_LOGGER.warn("Ignoring system index access warning during test cleanup: {}", warning);
+            } else {
+                return true;
             }
+        }
 
-            @Override
-            public String toString() {
-                return "ignore .async-search warning";
-            }
-        };
+        return false;
     }
 
     protected static void wipeDataStreams() throws IOException {

From 4496aa0cbf5b23bc3146d4dd09d2b6194e3c9e5f Mon Sep 17 00:00:00 2001
From: Jakob Reiter <jakommo@users.noreply.github.com>
Date: Wed, 4 Dec 2024 11:56:23 +0100
Subject: [PATCH 003/119] Update troubleshooting-unstable-cluster.asciidoc
 (#117887)

Added missing word
---
 .../troubleshooting/troubleshooting-unstable-cluster.asciidoc   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/troubleshooting/troubleshooting-unstable-cluster.asciidoc b/docs/reference/troubleshooting/troubleshooting-unstable-cluster.asciidoc
index cbb35f7731034..e47b85aa99547 100644
--- a/docs/reference/troubleshooting/troubleshooting-unstable-cluster.asciidoc
+++ b/docs/reference/troubleshooting/troubleshooting-unstable-cluster.asciidoc
@@ -126,7 +126,7 @@ repeatedly-dropped connections will severely affect its operation.
 The connections from the elected master node to every other node in the cluster
 are particularly important. The elected master never spontaneously closes its
 outbound connections to other nodes. Similarly, once an inbound connection is
-fully established, a node never spontaneously it unless the node is shutting
+fully established, a node never spontaneously closes it unless the node is shutting
 down.
 
 If you see a node unexpectedly leave the cluster with the `disconnected`

From 032b42fcf7c398391d8197c5dcdbf7ee20628ce7 Mon Sep 17 00:00:00 2001
From: Niels Bauman <33722607+nielsbauman@users.noreply.github.com>
Date: Wed, 4 Dec 2024 12:17:13 +0100
Subject: [PATCH 004/119] Make TransportLocalClusterStateAction wait for
 cluster to unblock (#117230)

This will make `TransportLocalClusterStateAction` wait for a new state
that is not blocked. This means we need a timeout (again). For
consistency's sake, we're reusing the REST param `master_timeout` for
this timeout as well.

The only class that was using `TransportLocalClusterStateAction` was
`TransportGetAliasesAction`, so its request needed to accept a timeout
again as well.
---
 docs/changelog/117230.yaml                    |   5 +
 docs/reference/cat/alias.asciidoc             |   2 +
 docs/reference/indices/alias-exists.asciidoc  |   2 +
 docs/reference/indices/get-alias.asciidoc     |   2 +
 .../rest-api-spec/api/cat.aliases.json        |   5 +
 .../api/indices.exists_alias.json             |   5 +
 .../rest-api-spec/api/indices.get_alias.json  |   5 +
 server/src/main/java/module-info.java         |   1 +
 .../indices/alias/get/GetAliasesRequest.java  |  21 ++-
 .../alias/get/TransportGetAliasesAction.java  |   2 +-
 .../TransportLocalClusterStateAction.java     |  64 -------
 .../local/LocalClusterStateRequest.java       |  43 +++++
 .../TransportLocalClusterStateAction.java     | 128 +++++++++++++
 .../admin/indices/RestGetAliasesAction.java   |   4 +-
 .../rest/action/cat/RestAliasAction.java      |   9 +-
 ...TransportLocalClusterStateActionTests.java | 177 ++++++++++++++++++
 16 files changed, 396 insertions(+), 79 deletions(-)
 create mode 100644 docs/changelog/117230.yaml
 delete mode 100644 server/src/main/java/org/elasticsearch/action/support/TransportLocalClusterStateAction.java
 create mode 100644 server/src/main/java/org/elasticsearch/action/support/local/LocalClusterStateRequest.java
 create mode 100644 server/src/main/java/org/elasticsearch/action/support/local/TransportLocalClusterStateAction.java
 create mode 100644 server/src/test/java/org/elasticsearch/action/support/local/TransportLocalClusterStateActionTests.java

diff --git a/docs/changelog/117230.yaml b/docs/changelog/117230.yaml
new file mode 100644
index 0000000000000..001dcef2fe3b1
--- /dev/null
+++ b/docs/changelog/117230.yaml
@@ -0,0 +1,5 @@
+pr: 117230
+summary: Make various alias retrieval APIs wait for cluster to unblock
+area: Distributed
+type: enhancement
+issues: []
diff --git a/docs/reference/cat/alias.asciidoc b/docs/reference/cat/alias.asciidoc
index 41ac279d3b2f5..aab0c9df25ed4 100644
--- a/docs/reference/cat/alias.asciidoc
+++ b/docs/reference/cat/alias.asciidoc
@@ -51,6 +51,8 @@ include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=cat-v]
 
 include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=expand-wildcards]
 
+include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=master-timeout]
+
 [[cat-alias-api-example]]
 ==== {api-examples-title}
 
diff --git a/docs/reference/indices/alias-exists.asciidoc b/docs/reference/indices/alias-exists.asciidoc
index d7b3454dcff56..a514d36a1bfef 100644
--- a/docs/reference/indices/alias-exists.asciidoc
+++ b/docs/reference/indices/alias-exists.asciidoc
@@ -52,6 +52,8 @@ Defaults to `all`.
 (Optional, Boolean) If `false`, requests that include a missing data stream or
 index in the `<target>` return an error. Defaults to `false`.
 
+include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=master-timeout]
+
 [[alias-exists-api-response-codes]]
 ==== {api-response-codes-title}
 
diff --git a/docs/reference/indices/get-alias.asciidoc b/docs/reference/indices/get-alias.asciidoc
index 41d62fb70e01b..d4c5b92116949 100644
--- a/docs/reference/indices/get-alias.asciidoc
+++ b/docs/reference/indices/get-alias.asciidoc
@@ -58,3 +58,5 @@ Defaults to `all`.
 `ignore_unavailable`::
 (Optional, Boolean) If `false`, requests that include a missing data stream or
 index in the `<target>` return an error. Defaults to `false`.
+
+include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=master-timeout]
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.aliases.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.aliases.json
index d3856b455efd1..9f97fe6280dc0 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/cat.aliases.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/cat.aliases.json
@@ -65,6 +65,11 @@
         ],
         "default": "all",
         "description":"Whether to expand wildcard expression to concrete indices that are open, closed or both."
+      },
+      "master_timeout":{
+        "type":"time",
+        "description":"Timeout for waiting for new cluster state in case it is blocked",
+        "default":"30s"
       }
     }
   }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists_alias.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists_alias.json
index 7d7a9c96c6419..7c855335efd00 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists_alias.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.exists_alias.json
@@ -61,6 +61,11 @@
         ],
         "default":"all",
         "description":"Whether to expand wildcard expression to concrete indices that are open, closed or both."
+      },
+      "master_timeout":{
+        "type":"time",
+        "description":"Timeout for waiting for new cluster state in case it is blocked",
+        "default":"30s"
       }
     }
   }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_alias.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_alias.json
index dc02a65adb068..a360582a44a04 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_alias.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.get_alias.json
@@ -79,6 +79,11 @@
         ],
         "default": "all",
         "description":"Whether to expand wildcard expression to concrete indices that are open, closed or both."
+      },
+      "master_timeout":{
+        "type":"time",
+        "description":"Timeout for waiting for new cluster state in case it is blocked",
+        "default":"30s"
       }
     }
   }
diff --git a/server/src/main/java/module-info.java b/server/src/main/java/module-info.java
index 5acc202ebb294..331a2bc0dddac 100644
--- a/server/src/main/java/module-info.java
+++ b/server/src/main/java/module-info.java
@@ -147,6 +147,7 @@
     exports org.elasticsearch.action.support.master;
     exports org.elasticsearch.action.support.master.info;
     exports org.elasticsearch.action.support.nodes;
+    exports org.elasticsearch.action.support.local;
     exports org.elasticsearch.action.support.replication;
     exports org.elasticsearch.action.support.single.instance;
     exports org.elasticsearch.action.support.single.shard;
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/alias/get/GetAliasesRequest.java b/server/src/main/java/org/elasticsearch/action/admin/indices/alias/get/GetAliasesRequest.java
index c28108815ed03..af95787a5fcca 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/alias/get/GetAliasesRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/alias/get/GetAliasesRequest.java
@@ -8,21 +8,20 @@
  */
 package org.elasticsearch.action.admin.indices.alias.get;
 
-import org.elasticsearch.action.ActionRequest;
 import org.elasticsearch.action.ActionRequestValidationException;
 import org.elasticsearch.action.AliasesRequest;
 import org.elasticsearch.action.support.IndicesOptions;
-import org.elasticsearch.action.support.TransportAction;
+import org.elasticsearch.action.support.local.LocalClusterStateRequest;
+import org.elasticsearch.action.support.master.MasterNodeRequest;
 import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.tasks.CancellableTask;
 import org.elasticsearch.tasks.Task;
 import org.elasticsearch.tasks.TaskId;
 
-import java.io.IOException;
 import java.util.Map;
 
-public class GetAliasesRequest extends ActionRequest implements AliasesRequest {
+public class GetAliasesRequest extends LocalClusterStateRequest implements AliasesRequest {
 
     public static final IndicesOptions DEFAULT_INDICES_OPTIONS = IndicesOptions.strictExpandHidden();
 
@@ -31,18 +30,20 @@ public class GetAliasesRequest extends ActionRequest implements AliasesRequest {
     private String[] indices = Strings.EMPTY_ARRAY;
     private IndicesOptions indicesOptions = DEFAULT_INDICES_OPTIONS;
 
+    @Deprecated
     public GetAliasesRequest(String... aliases) {
-        this.aliases = aliases;
-        this.originalAliases = aliases;
+        this(MasterNodeRequest.TRAPPY_IMPLICIT_DEFAULT_MASTER_NODE_TIMEOUT, aliases);
     }
 
+    @Deprecated
     public GetAliasesRequest() {
         this(Strings.EMPTY_ARRAY);
     }
 
-    @Override
-    public void writeTo(StreamOutput out) throws IOException {
-        TransportAction.localOnly();
+    public GetAliasesRequest(TimeValue masterTimeout, String... aliases) {
+        super(masterTimeout);
+        this.aliases = aliases;
+        this.originalAliases = aliases;
     }
 
     @Override
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/alias/get/TransportGetAliasesAction.java b/server/src/main/java/org/elasticsearch/action/admin/indices/alias/get/TransportGetAliasesAction.java
index 67f1a627ae77f..9e0014b0f512b 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/alias/get/TransportGetAliasesAction.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/alias/get/TransportGetAliasesAction.java
@@ -10,7 +10,7 @@
 
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.support.ActionFilters;
-import org.elasticsearch.action.support.TransportLocalClusterStateAction;
+import org.elasticsearch.action.support.local.TransportLocalClusterStateAction;
 import org.elasticsearch.cluster.ClusterState;
 import org.elasticsearch.cluster.block.ClusterBlockException;
 import org.elasticsearch.cluster.block.ClusterBlockLevel;
diff --git a/server/src/main/java/org/elasticsearch/action/support/TransportLocalClusterStateAction.java b/server/src/main/java/org/elasticsearch/action/support/TransportLocalClusterStateAction.java
deleted file mode 100644
index d48dc74295bcb..0000000000000
--- a/server/src/main/java/org/elasticsearch/action/support/TransportLocalClusterStateAction.java
+++ /dev/null
@@ -1,64 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the "Elastic License
- * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
- * Public License v 1"; you may not use this file except in compliance with, at
- * your election, the "Elastic License 2.0", the "GNU Affero General Public
- * License v3.0 only", or the "Server Side Public License, v 1".
- */
-
-package org.elasticsearch.action.support;
-
-import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.action.ActionRequest;
-import org.elasticsearch.action.ActionResponse;
-import org.elasticsearch.action.ActionRunnable;
-import org.elasticsearch.cluster.ClusterState;
-import org.elasticsearch.cluster.block.ClusterBlockException;
-import org.elasticsearch.cluster.service.ClusterService;
-import org.elasticsearch.common.util.concurrent.EsExecutors;
-import org.elasticsearch.tasks.Task;
-import org.elasticsearch.tasks.TaskManager;
-
-import java.util.concurrent.Executor;
-
-/**
- * Analogue of {@link org.elasticsearch.action.support.master.TransportMasterNodeReadAction} except that it runs on the local node rather
- * than delegating to the master.
- */
-public abstract class TransportLocalClusterStateAction<Request extends ActionRequest, Response extends ActionResponse> extends
-    TransportAction<Request, Response> {
-
-    protected final ClusterService clusterService;
-    protected final Executor executor;
-
-    protected TransportLocalClusterStateAction(
-        String actionName,
-        ActionFilters actionFilters,
-        TaskManager taskManager,
-        ClusterService clusterService,
-        Executor executor
-    ) {
-        // TODO replace DIRECT_EXECUTOR_SERVICE when removing workaround for https://github.com/elastic/elasticsearch/issues/97916
-        super(actionName, actionFilters, taskManager, EsExecutors.DIRECT_EXECUTOR_SERVICE);
-        this.clusterService = clusterService;
-        this.executor = executor;
-    }
-
-    protected abstract ClusterBlockException checkBlock(Request request, ClusterState state);
-
-    @Override
-    protected final void doExecute(Task task, Request request, ActionListener<Response> listener) {
-        final var state = clusterService.state();
-        final var clusterBlockException = checkBlock(request, state);
-        if (clusterBlockException != null) {
-            throw clusterBlockException;
-        }
-
-        // Workaround for https://github.com/elastic/elasticsearch/issues/97916 - TODO remove this when we can
-        executor.execute(ActionRunnable.wrap(listener, l -> localClusterStateOperation(task, request, state, l)));
-    }
-
-    protected abstract void localClusterStateOperation(Task task, Request request, ClusterState state, ActionListener<Response> listener)
-        throws Exception;
-}
diff --git a/server/src/main/java/org/elasticsearch/action/support/local/LocalClusterStateRequest.java b/server/src/main/java/org/elasticsearch/action/support/local/LocalClusterStateRequest.java
new file mode 100644
index 0000000000000..dfbcb21c2a959
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/action/support/local/LocalClusterStateRequest.java
@@ -0,0 +1,43 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.action.support.local;
+
+import org.elasticsearch.action.ActionRequest;
+import org.elasticsearch.action.support.TransportAction;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.core.TimeValue;
+
+import java.io.IOException;
+import java.util.Objects;
+
+/**
+ * A base request for actions that are executed locally on the node that receives the request.
+ */
+public abstract class LocalClusterStateRequest extends ActionRequest {
+
+    /**
+     * The timeout for waiting until the cluster is unblocked.
+     * We use the name <code>masterTimeout</code> to be consistent with the master node actions.
+     */
+    private final TimeValue masterTimeout;
+
+    protected LocalClusterStateRequest(TimeValue masterTimeout) {
+        this.masterTimeout = Objects.requireNonNull(masterTimeout);
+    }
+
+    @Override
+    public final void writeTo(StreamOutput out) throws IOException {
+        TransportAction.localOnly();
+    }
+
+    public TimeValue masterTimeout() {
+        return masterTimeout;
+    }
+}
diff --git a/server/src/main/java/org/elasticsearch/action/support/local/TransportLocalClusterStateAction.java b/server/src/main/java/org/elasticsearch/action/support/local/TransportLocalClusterStateAction.java
new file mode 100644
index 0000000000000..66f94050c9826
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/action/support/local/TransportLocalClusterStateAction.java
@@ -0,0 +1,128 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.action.support.local;
+
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.elasticsearch.ElasticsearchTimeoutException;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.ActionResponse;
+import org.elasticsearch.action.ActionRunnable;
+import org.elasticsearch.action.support.ActionFilters;
+import org.elasticsearch.action.support.TransportAction;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.ClusterStateObserver;
+import org.elasticsearch.cluster.block.ClusterBlockException;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.util.concurrent.EsExecutors;
+import org.elasticsearch.core.TimeValue;
+import org.elasticsearch.node.NodeClosedException;
+import org.elasticsearch.tasks.CancellableTask;
+import org.elasticsearch.tasks.Task;
+import org.elasticsearch.tasks.TaskManager;
+
+import java.util.concurrent.Executor;
+
+import static org.elasticsearch.common.Strings.format;
+
+/**
+ * Analogue of {@link org.elasticsearch.action.support.master.TransportMasterNodeReadAction} except that it runs on the local node rather
+ * than delegating to the master.
+ */
+public abstract class TransportLocalClusterStateAction<Request extends LocalClusterStateRequest, Response extends ActionResponse> extends
+    TransportAction<Request, Response> {
+
+    private static final Logger logger = LogManager.getLogger(TransportLocalClusterStateAction.class);
+
+    protected final ClusterService clusterService;
+    protected final Executor executor;
+
+    protected TransportLocalClusterStateAction(
+        String actionName,
+        ActionFilters actionFilters,
+        TaskManager taskManager,
+        ClusterService clusterService,
+        Executor executor
+    ) {
+        // TODO replace DIRECT_EXECUTOR_SERVICE when removing workaround for https://github.com/elastic/elasticsearch/issues/97916
+        super(actionName, actionFilters, taskManager, EsExecutors.DIRECT_EXECUTOR_SERVICE);
+        this.clusterService = clusterService;
+        this.executor = executor;
+    }
+
+    protected abstract ClusterBlockException checkBlock(Request request, ClusterState state);
+
+    protected abstract void localClusterStateOperation(Task task, Request request, ClusterState state, ActionListener<Response> listener)
+        throws Exception;
+
+    @Override
+    protected final void doExecute(Task task, Request request, ActionListener<Response> listener) {
+        final var state = clusterService.state();
+        final var clusterBlockException = checkBlock(request, state);
+        if (clusterBlockException != null) {
+            if (clusterBlockException.retryable() == false) {
+                listener.onFailure(clusterBlockException);
+            } else {
+                waitForClusterUnblock(task, request, listener, state, clusterBlockException);
+            }
+        } else {
+            innerDoExecute(task, request, listener, state);
+        }
+    }
+
+    private void innerDoExecute(Task task, Request request, ActionListener<Response> listener, ClusterState state) {
+        if (task instanceof CancellableTask cancellableTask && cancellableTask.notifyIfCancelled(listener)) {
+            return;
+        }
+        // Workaround for https://github.com/elastic/elasticsearch/issues/97916 - TODO remove this when we can
+        executor.execute(ActionRunnable.wrap(listener, l -> localClusterStateOperation(task, request, state, l)));
+    }
+
+    private void waitForClusterUnblock(
+        Task task,
+        Request request,
+        ActionListener<Response> listener,
+        ClusterState initialState,
+        ClusterBlockException exception
+    ) {
+        var observer = new ClusterStateObserver(
+            initialState,
+            clusterService,
+            request.masterTimeout(),
+            logger,
+            clusterService.threadPool().getThreadContext()
+        );
+        observer.waitForNextChange(new ClusterStateObserver.Listener() {
+            @Override
+            public void onNewClusterState(ClusterState state) {
+                logger.trace("retrying with cluster state version [{}]", state.version());
+                innerDoExecute(task, request, listener, state);
+            }
+
+            @Override
+            public void onClusterServiceClose() {
+                listener.onFailure(new NodeClosedException(clusterService.localNode()));
+            }
+
+            @Override
+            public void onTimeout(TimeValue timeout) {
+                logger.debug(
+                    () -> format("timed out while waiting for cluster to unblock in [%s] (timeout [%s])", actionName, timeout),
+                    exception
+                );
+                listener.onFailure(new ElasticsearchTimeoutException("timed out while waiting for cluster to unblock", exception));
+            }
+        }, clusterState -> isTaskCancelled(task) || checkBlock(request, clusterState) == null);
+    }
+
+    private boolean isTaskCancelled(Task task) {
+        return task instanceof CancellableTask cancellableTask && cancellableTask.isCancelled();
+    }
+}
diff --git a/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestGetAliasesAction.java b/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestGetAliasesAction.java
index dfe501f29ce2e..841d7979862dc 100644
--- a/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestGetAliasesAction.java
+++ b/server/src/main/java/org/elasticsearch/rest/action/admin/indices/RestGetAliasesAction.java
@@ -27,6 +27,7 @@
 import org.elasticsearch.rest.RestRequest;
 import org.elasticsearch.rest.RestResponse;
 import org.elasticsearch.rest.RestStatus;
+import org.elasticsearch.rest.RestUtils;
 import org.elasticsearch.rest.Scope;
 import org.elasticsearch.rest.ServerlessScope;
 import org.elasticsearch.rest.action.RestBuilderListener;
@@ -207,7 +208,8 @@ public RestChannelConsumer prepareRequest(final RestRequest request, final NodeC
 
         final boolean namesProvided = request.hasParam("name");
         final String[] aliases = request.paramAsStringArrayOrEmptyIfAll("name");
-        final GetAliasesRequest getAliasesRequest = new GetAliasesRequest(aliases);
+        final var masterNodeTimeout = RestUtils.getMasterNodeTimeout(request);
+        final GetAliasesRequest getAliasesRequest = new GetAliasesRequest(masterNodeTimeout, aliases);
         final String[] indices = Strings.splitStringByCommaToArray(request.param("index"));
         getAliasesRequest.indices(indices);
         getAliasesRequest.indicesOptions(IndicesOptions.fromRequest(request, getAliasesRequest.indicesOptions()));
diff --git a/server/src/main/java/org/elasticsearch/rest/action/cat/RestAliasAction.java b/server/src/main/java/org/elasticsearch/rest/action/cat/RestAliasAction.java
index 6aa0b1c865682..cfb714c354f02 100644
--- a/server/src/main/java/org/elasticsearch/rest/action/cat/RestAliasAction.java
+++ b/server/src/main/java/org/elasticsearch/rest/action/cat/RestAliasAction.java
@@ -17,6 +17,7 @@
 import org.elasticsearch.common.Table;
 import org.elasticsearch.rest.RestRequest;
 import org.elasticsearch.rest.RestResponse;
+import org.elasticsearch.rest.RestUtils;
 import org.elasticsearch.rest.Scope;
 import org.elasticsearch.rest.ServerlessScope;
 import org.elasticsearch.rest.action.RestCancellableNodeClient;
@@ -47,9 +48,11 @@ public boolean allowSystemIndexAccessByDefault() {
 
     @Override
     protected RestChannelConsumer doCatRequest(final RestRequest request, final NodeClient client) {
-        final GetAliasesRequest getAliasesRequest = request.hasParam("alias")
-            ? new GetAliasesRequest(Strings.commaDelimitedListToStringArray(request.param("alias")))
-            : new GetAliasesRequest();
+        final var masterNodeTimeout = RestUtils.getMasterNodeTimeout(request);
+        final GetAliasesRequest getAliasesRequest = new GetAliasesRequest(
+            masterNodeTimeout,
+            Strings.commaDelimitedListToStringArray(request.param("alias"))
+        );
         getAliasesRequest.indicesOptions(IndicesOptions.fromRequest(request, getAliasesRequest.indicesOptions()));
         return channel -> new RestCancellableNodeClient(client, request.getHttpChannel()).admin()
             .indices()
diff --git a/server/src/test/java/org/elasticsearch/action/support/local/TransportLocalClusterStateActionTests.java b/server/src/test/java/org/elasticsearch/action/support/local/TransportLocalClusterStateActionTests.java
new file mode 100644
index 0000000000000..ea71cefc6608c
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/action/support/local/TransportLocalClusterStateActionTests.java
@@ -0,0 +1,177 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.action.support.local;
+
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.ActionRequestValidationException;
+import org.elasticsearch.action.ActionResponse;
+import org.elasticsearch.action.support.ActionFilters;
+import org.elasticsearch.action.support.ActionTestUtils;
+import org.elasticsearch.action.support.PlainActionFuture;
+import org.elasticsearch.action.support.TransportAction;
+import org.elasticsearch.cluster.ClusterState;
+import org.elasticsearch.cluster.block.ClusterBlock;
+import org.elasticsearch.cluster.block.ClusterBlockException;
+import org.elasticsearch.cluster.block.ClusterBlockLevel;
+import org.elasticsearch.cluster.block.ClusterBlocks;
+import org.elasticsearch.cluster.service.ClusterService;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.util.concurrent.EsExecutors;
+import org.elasticsearch.rest.RestStatus;
+import org.elasticsearch.tasks.CancellableTask;
+import org.elasticsearch.tasks.Task;
+import org.elasticsearch.tasks.TaskCancelHelper;
+import org.elasticsearch.tasks.TaskCancelledException;
+import org.elasticsearch.tasks.TaskId;
+import org.elasticsearch.tasks.TaskManager;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.threadpool.TestThreadPool;
+import org.elasticsearch.threadpool.ThreadPool;
+import org.junit.After;
+import org.junit.AfterClass;
+import org.junit.Before;
+import org.junit.BeforeClass;
+
+import java.io.IOException;
+import java.util.Map;
+import java.util.Set;
+import java.util.concurrent.ExecutionException;
+import java.util.concurrent.TimeUnit;
+
+import static org.elasticsearch.test.ClusterServiceUtils.createClusterService;
+import static org.elasticsearch.test.ClusterServiceUtils.setState;
+
+public class TransportLocalClusterStateActionTests extends ESTestCase {
+
+    private static ThreadPool threadPool;
+
+    private ClusterService clusterService;
+    private TaskManager taskManager;
+
+    @BeforeClass
+    public static void beforeClass() {
+        threadPool = new TestThreadPool(getTestClass().getName());
+    }
+
+    @Override
+    @Before
+    public void setUp() throws Exception {
+        super.setUp();
+        clusterService = createClusterService(threadPool);
+        taskManager = new TaskManager(clusterService.getSettings(), threadPool, Set.of());
+    }
+
+    @After
+    public void tearDown() throws Exception {
+        super.tearDown();
+        clusterService.close();
+    }
+
+    @AfterClass
+    public static void afterClass() {
+        ThreadPool.terminate(threadPool, 30, TimeUnit.SECONDS);
+        threadPool = null;
+    }
+
+    public void testNoBlock() throws ExecutionException, InterruptedException {
+        var request = new Request();
+        PlainActionFuture<Response> listener = new PlainActionFuture<>();
+        ActionTestUtils.execute(new Action(taskManager, clusterService), null, request, listener);
+        assertTrue(listener.isDone());
+        listener.get();
+    }
+
+    public void testRetryAfterBlock() throws ExecutionException, InterruptedException {
+        var request = new Request();
+        ClusterBlock block = new ClusterBlock(randomInt(), "", true, true, false, randomFrom(RestStatus.values()), ClusterBlockLevel.ALL);
+        var state = ClusterState.builder(clusterService.state()).blocks(ClusterBlocks.builder().addGlobalBlock(block)).build();
+        setState(clusterService, state);
+
+        PlainActionFuture<Response> listener = new PlainActionFuture<>();
+        ActionTestUtils.execute(new Action(taskManager, clusterService), null, request, listener);
+
+        assertFalse(listener.isDone());
+        setState(clusterService, ClusterState.builder(state).blocks(ClusterBlocks.EMPTY_CLUSTER_BLOCK).build());
+        assertTrue(listener.isDone());
+        listener.get();
+    }
+
+    public void testNonRetryableBlock() {
+        var request = new Request();
+        ClusterBlock block = new ClusterBlock(randomInt(), "", false, true, false, randomFrom(RestStatus.values()), ClusterBlockLevel.ALL);
+        var state = ClusterState.builder(clusterService.state()).blocks(ClusterBlocks.builder().addGlobalBlock(block)).build();
+        setState(clusterService, state);
+
+        PlainActionFuture<Response> listener = new PlainActionFuture<>();
+        ActionTestUtils.execute(new Action(taskManager, clusterService), null, request, listener);
+
+        assertTrue(listener.isDone());
+        var exception = assertThrows(ExecutionException.class, listener::get);
+        assertTrue(exception.getCause() instanceof ClusterBlockException);
+    }
+
+    public void testTaskCancelledAfterBlock() {
+        var request = new Request();
+        ClusterBlock block = new ClusterBlock(randomInt(), "", true, true, false, randomFrom(RestStatus.values()), ClusterBlockLevel.ALL);
+        var state = ClusterState.builder(clusterService.state()).blocks(ClusterBlocks.builder().addGlobalBlock(block)).build();
+        setState(clusterService, state);
+
+        CancellableTask task = new CancellableTask(randomLong(), "test", Action.ACTION_NAME, "", TaskId.EMPTY_TASK_ID, Map.of());
+        PlainActionFuture<Response> listener = new PlainActionFuture<>();
+        ActionTestUtils.execute(new Action(taskManager, clusterService), task, request, listener);
+
+        TaskCancelHelper.cancel(task, "test");
+        assertFalse(listener.isDone());
+        setState(clusterService, ClusterState.builder(state).blocks(ClusterBlocks.EMPTY_CLUSTER_BLOCK).build());
+        assertTrue(listener.isDone());
+        var exception = assertThrows(ExecutionException.class, listener::get);
+        assertTrue(exception.getCause() instanceof TaskCancelledException);
+    }
+
+    private static class Request extends LocalClusterStateRequest {
+
+        protected Request() {
+            super(TEST_REQUEST_TIMEOUT);
+        }
+
+        @Override
+        public ActionRequestValidationException validate() {
+            return null;
+        }
+    }
+
+    private static class Response extends ActionResponse {
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            TransportAction.localOnly();
+        }
+    }
+
+    private static class Action extends TransportLocalClusterStateAction<Request, Response> {
+        static final String ACTION_NAME = "internal:testAction";
+
+        Action(TaskManager taskManager, ClusterService clusterService) {
+            super(ACTION_NAME, new ActionFilters(Set.of()), taskManager, clusterService, EsExecutors.DIRECT_EXECUTOR_SERVICE);
+        }
+
+        @Override
+        protected void localClusterStateOperation(Task task, Request request, ClusterState state, ActionListener<Response> listener)
+            throws Exception {
+            listener.onResponse(new Response());
+        }
+
+        @Override
+        protected ClusterBlockException checkBlock(Request request, ClusterState state) {
+            Set<ClusterBlock> blocks = state.blocks().global();
+            return blocks.isEmpty() ? null : new ClusterBlockException(blocks);
+        }
+    }
+}

From 9d9eed5bad0ecbaeaa6397b992eff46c5f653a7d Mon Sep 17 00:00:00 2001
From: Yang Wang <yang.wang@elastic.co>
Date: Wed, 4 Dec 2024 22:20:04 +1100
Subject: [PATCH 005/119] Assert for empty routing table when hiding state
 (#117870)

Routing table should always be empty when hiding cluster state for
not-recovered block. This PR adds an explicit assertion for it.
---
 .../java/org/elasticsearch/gateway/ClusterStateUpdaters.java     | 1 +
 1 file changed, 1 insertion(+)

diff --git a/server/src/main/java/org/elasticsearch/gateway/ClusterStateUpdaters.java b/server/src/main/java/org/elasticsearch/gateway/ClusterStateUpdaters.java
index 8d8e661b3a010..9c16bcd9d2cc2 100644
--- a/server/src/main/java/org/elasticsearch/gateway/ClusterStateUpdaters.java
+++ b/server/src/main/java/org/elasticsearch/gateway/ClusterStateUpdaters.java
@@ -143,6 +143,7 @@ public static ClusterState hideStateIfNotRecovered(ClusterState state) {
                 .coordinationMetadata(state.metadata().coordinationMetadata())
                 .build();
 
+            assert state.routingTable().indicesRouting().isEmpty() : "routing table is not empty: " + state.routingTable().indicesRouting();
             return ClusterState.builder(state).metadata(metadata).blocks(blocks.build()).build();
         }
         return state;

From c7e985c3b61ef1aece751e674f5431fb06174935 Mon Sep 17 00:00:00 2001
From: Craig Taverner <craig@amanzi.com>
Date: Wed, 4 Dec 2024 12:20:47 +0100
Subject: [PATCH 006/119] Support ST_ENVELOPE and related ST_XMIN, etc.
 (#116964)

Support ST_ENVELOPE and related ST_XMIN, etc.

Based on the PostGIS equivalents:

https://postgis.net/docs/ST_Envelope.html
https://postgis.net/docs/ST_XMin.html
https://postgis.net/docs/ST_XMax.html
https://postgis.net/docs/ST_YMin.html
https://postgis.net/docs/ST_YMax.html
---
 docs/changelog/116964.yaml                    |   6 +
 .../description/st_envelope.asciidoc          |   5 +
 .../functions/description/st_xmax.asciidoc    |   5 +
 .../functions/description/st_xmin.asciidoc    |   5 +
 .../functions/description/st_ymax.asciidoc    |   5 +
 .../functions/description/st_ymin.asciidoc    |   5 +
 .../functions/examples/st_envelope.asciidoc   |  13 +
 .../esql/functions/examples/st_xmax.asciidoc  |  13 +
 .../esql/functions/examples/st_xmin.asciidoc  |  13 +
 .../esql/functions/examples/st_ymax.asciidoc  |  13 +
 .../esql/functions/examples/st_ymin.asciidoc  |  13 +
 .../kibana/definition/st_envelope.json        |  61 +++
 .../functions/kibana/definition/st_xmax.json  |  61 +++
 .../functions/kibana/definition/st_xmin.json  |  61 +++
 .../functions/kibana/definition/st_ymax.json  |  61 +++
 .../functions/kibana/definition/st_ymin.json  |  61 +++
 .../esql/functions/kibana/docs/st_envelope.md |  13 +
 .../esql/functions/kibana/docs/st_xmax.md     |  15 +
 .../esql/functions/kibana/docs/st_xmin.md     |  15 +
 .../esql/functions/kibana/docs/st_ymax.md     |  15 +
 .../esql/functions/kibana/docs/st_ymin.md     |  15 +
 .../functions/layout/st_envelope.asciidoc     |  15 +
 .../esql/functions/layout/st_xmax.asciidoc    |  15 +
 .../esql/functions/layout/st_xmin.asciidoc    |  15 +
 .../esql/functions/layout/st_ymax.asciidoc    |  15 +
 .../esql/functions/layout/st_ymin.asciidoc    |  15 +
 .../functions/parameters/st_envelope.asciidoc |   6 +
 .../functions/parameters/st_xmax.asciidoc     |   6 +
 .../functions/parameters/st_xmin.asciidoc     |   6 +
 .../functions/parameters/st_ymax.asciidoc     |   6 +
 .../functions/parameters/st_ymin.asciidoc     |   6 +
 .../esql/functions/signature/st_envelope.svg  |   1 +
 .../esql/functions/signature/st_xmax.svg      |   1 +
 .../esql/functions/signature/st_xmin.svg      |   1 +
 .../esql/functions/signature/st_ymax.svg      |   1 +
 .../esql/functions/signature/st_ymin.svg      |   1 +
 .../esql/functions/spatial-functions.asciidoc |  10 +
 .../esql/functions/types/st_envelope.asciidoc |  12 +
 .../esql/functions/types/st_xmax.asciidoc     |  12 +
 .../esql/functions/types/st_xmin.asciidoc     |  12 +
 .../esql/functions/types/st_ymax.asciidoc     |  12 +
 .../esql/functions/types/st_ymin.asciidoc     |  12 +
 .../utils/SpatialEnvelopeVisitor.java         | 356 ++++++++++++++++++
 .../utils/SpatialEnvelopeVisitorTests.java    | 194 ++++++++++
 .../main/resources/spatial_shapes.csv-spec    |  41 ++
 .../spatial/StEnvelopeFromWKBEvaluator.java   | 126 +++++++
 .../StEnvelopeFromWKBGeoEvaluator.java        | 126 +++++++
 .../spatial/StXMaxFromWKBEvaluator.java       | 127 +++++++
 .../spatial/StXMaxFromWKBGeoEvaluator.java    | 127 +++++++
 .../spatial/StXMinFromWKBEvaluator.java       | 127 +++++++
 .../spatial/StXMinFromWKBGeoEvaluator.java    | 127 +++++++
 .../spatial/StYMaxFromWKBEvaluator.java       | 127 +++++++
 .../spatial/StYMaxFromWKBGeoEvaluator.java    | 127 +++++++
 .../spatial/StYMinFromWKBEvaluator.java       | 127 +++++++
 .../spatial/StYMinFromWKBGeoEvaluator.java    | 127 +++++++
 .../xpack/esql/action/EsqlCapabilities.java   |   5 +
 .../esql/expression/ExpressionWritables.java  |  10 +
 .../function/EsqlFunctionRegistry.java        |  10 +
 .../function/scalar/spatial/StEnvelope.java   | 138 +++++++
 .../function/scalar/spatial/StXMax.java       | 123 ++++++
 .../function/scalar/spatial/StXMin.java       | 123 ++++++
 .../function/scalar/spatial/StYMax.java       | 123 ++++++
 .../function/scalar/spatial/StYMin.java       | 123 ++++++
 .../scalar/spatial/StEnvelopeTests.java       |  88 +++++
 .../function/scalar/spatial/StXMaxTests.java  |  75 ++++
 .../function/scalar/spatial/StXMinTests.java  |  75 ++++
 .../function/scalar/spatial/StYMaxTests.java  |  75 ++++
 .../function/scalar/spatial/StYMinTests.java  |  75 ++++
 .../rest-api-spec/test/esql/60_usage.yml      |   4 +-
 69 files changed, 3558 insertions(+), 2 deletions(-)
 create mode 100644 docs/changelog/116964.yaml
 create mode 100644 docs/reference/esql/functions/description/st_envelope.asciidoc
 create mode 100644 docs/reference/esql/functions/description/st_xmax.asciidoc
 create mode 100644 docs/reference/esql/functions/description/st_xmin.asciidoc
 create mode 100644 docs/reference/esql/functions/description/st_ymax.asciidoc
 create mode 100644 docs/reference/esql/functions/description/st_ymin.asciidoc
 create mode 100644 docs/reference/esql/functions/examples/st_envelope.asciidoc
 create mode 100644 docs/reference/esql/functions/examples/st_xmax.asciidoc
 create mode 100644 docs/reference/esql/functions/examples/st_xmin.asciidoc
 create mode 100644 docs/reference/esql/functions/examples/st_ymax.asciidoc
 create mode 100644 docs/reference/esql/functions/examples/st_ymin.asciidoc
 create mode 100644 docs/reference/esql/functions/kibana/definition/st_envelope.json
 create mode 100644 docs/reference/esql/functions/kibana/definition/st_xmax.json
 create mode 100644 docs/reference/esql/functions/kibana/definition/st_xmin.json
 create mode 100644 docs/reference/esql/functions/kibana/definition/st_ymax.json
 create mode 100644 docs/reference/esql/functions/kibana/definition/st_ymin.json
 create mode 100644 docs/reference/esql/functions/kibana/docs/st_envelope.md
 create mode 100644 docs/reference/esql/functions/kibana/docs/st_xmax.md
 create mode 100644 docs/reference/esql/functions/kibana/docs/st_xmin.md
 create mode 100644 docs/reference/esql/functions/kibana/docs/st_ymax.md
 create mode 100644 docs/reference/esql/functions/kibana/docs/st_ymin.md
 create mode 100644 docs/reference/esql/functions/layout/st_envelope.asciidoc
 create mode 100644 docs/reference/esql/functions/layout/st_xmax.asciidoc
 create mode 100644 docs/reference/esql/functions/layout/st_xmin.asciidoc
 create mode 100644 docs/reference/esql/functions/layout/st_ymax.asciidoc
 create mode 100644 docs/reference/esql/functions/layout/st_ymin.asciidoc
 create mode 100644 docs/reference/esql/functions/parameters/st_envelope.asciidoc
 create mode 100644 docs/reference/esql/functions/parameters/st_xmax.asciidoc
 create mode 100644 docs/reference/esql/functions/parameters/st_xmin.asciidoc
 create mode 100644 docs/reference/esql/functions/parameters/st_ymax.asciidoc
 create mode 100644 docs/reference/esql/functions/parameters/st_ymin.asciidoc
 create mode 100644 docs/reference/esql/functions/signature/st_envelope.svg
 create mode 100644 docs/reference/esql/functions/signature/st_xmax.svg
 create mode 100644 docs/reference/esql/functions/signature/st_xmin.svg
 create mode 100644 docs/reference/esql/functions/signature/st_ymax.svg
 create mode 100644 docs/reference/esql/functions/signature/st_ymin.svg
 create mode 100644 docs/reference/esql/functions/types/st_envelope.asciidoc
 create mode 100644 docs/reference/esql/functions/types/st_xmax.asciidoc
 create mode 100644 docs/reference/esql/functions/types/st_xmin.asciidoc
 create mode 100644 docs/reference/esql/functions/types/st_ymax.asciidoc
 create mode 100644 docs/reference/esql/functions/types/st_ymin.asciidoc
 create mode 100644 libs/geo/src/main/java/org/elasticsearch/geometry/utils/SpatialEnvelopeVisitor.java
 create mode 100644 libs/geo/src/test/java/org/elasticsearch/geometry/utils/SpatialEnvelopeVisitorTests.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StEnvelopeFromWKBEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StEnvelopeFromWKBGeoEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMaxFromWKBEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMaxFromWKBGeoEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMinFromWKBEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMinFromWKBGeoEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMaxFromWKBEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMaxFromWKBGeoEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMinFromWKBEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMinFromWKBGeoEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StEnvelope.java
 create mode 100644 x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMax.java
 create mode 100644 x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMin.java
 create mode 100644 x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMax.java
 create mode 100644 x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMin.java
 create mode 100644 x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StEnvelopeTests.java
 create mode 100644 x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMaxTests.java
 create mode 100644 x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMinTests.java
 create mode 100644 x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMaxTests.java
 create mode 100644 x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMinTests.java

diff --git a/docs/changelog/116964.yaml b/docs/changelog/116964.yaml
new file mode 100644
index 0000000000000..2e3ecd06fa098
--- /dev/null
+++ b/docs/changelog/116964.yaml
@@ -0,0 +1,6 @@
+pr: 116964
+summary: "Support ST_ENVELOPE and related (ST_XMIN, ST_XMAX, ST_YMIN, ST_YMAX) functions"
+area: ES|QL
+type: feature
+issues:
+ - 104875
diff --git a/docs/reference/esql/functions/description/st_envelope.asciidoc b/docs/reference/esql/functions/description/st_envelope.asciidoc
new file mode 100644
index 0000000000000..6b7cf8d97538a
--- /dev/null
+++ b/docs/reference/esql/functions/description/st_envelope.asciidoc
@@ -0,0 +1,5 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Description*
+
+Determines the minimum bounding box of the supplied geometry.
diff --git a/docs/reference/esql/functions/description/st_xmax.asciidoc b/docs/reference/esql/functions/description/st_xmax.asciidoc
new file mode 100644
index 0000000000000..f33ec590bf2d4
--- /dev/null
+++ b/docs/reference/esql/functions/description/st_xmax.asciidoc
@@ -0,0 +1,5 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Description*
+
+Extracts the maximum value of the `x` coordinates from the supplied geometry. If the geometry is of type `geo_point` or `geo_shape` this is equivalent to extracting the maximum `longitude` value.
diff --git a/docs/reference/esql/functions/description/st_xmin.asciidoc b/docs/reference/esql/functions/description/st_xmin.asciidoc
new file mode 100644
index 0000000000000..b06cbfacde7bf
--- /dev/null
+++ b/docs/reference/esql/functions/description/st_xmin.asciidoc
@@ -0,0 +1,5 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Description*
+
+Extracts the minimum value of the `x` coordinates from the supplied geometry. If the geometry is of type `geo_point` or `geo_shape` this is equivalent to extracting the minimum `longitude` value.
diff --git a/docs/reference/esql/functions/description/st_ymax.asciidoc b/docs/reference/esql/functions/description/st_ymax.asciidoc
new file mode 100644
index 0000000000000..f9475dd967562
--- /dev/null
+++ b/docs/reference/esql/functions/description/st_ymax.asciidoc
@@ -0,0 +1,5 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Description*
+
+Extracts the maximum value of the `y` coordinates from the supplied geometry. If the geometry is of type `geo_point` or `geo_shape` this is equivalent to extracting the maximum `latitude` value.
diff --git a/docs/reference/esql/functions/description/st_ymin.asciidoc b/docs/reference/esql/functions/description/st_ymin.asciidoc
new file mode 100644
index 0000000000000..7228c63a16030
--- /dev/null
+++ b/docs/reference/esql/functions/description/st_ymin.asciidoc
@@ -0,0 +1,5 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Description*
+
+Extracts the minimum value of the `y` coordinates from the supplied geometry. If the geometry is of type `geo_point` or `geo_shape` this is equivalent to extracting the minimum `latitude` value.
diff --git a/docs/reference/esql/functions/examples/st_envelope.asciidoc b/docs/reference/esql/functions/examples/st_envelope.asciidoc
new file mode 100644
index 0000000000000..df8c0ad5607fa
--- /dev/null
+++ b/docs/reference/esql/functions/examples/st_envelope.asciidoc
@@ -0,0 +1,13 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Example*
+
+[source.merge.styled,esql]
+----
+include::{esql-specs}/spatial_shapes.csv-spec[tag=st_envelope]
+----
+[%header.monospaced.styled,format=dsv,separator=|]
+|===
+include::{esql-specs}/spatial_shapes.csv-spec[tag=st_envelope-result]
+|===
+
diff --git a/docs/reference/esql/functions/examples/st_xmax.asciidoc b/docs/reference/esql/functions/examples/st_xmax.asciidoc
new file mode 100644
index 0000000000000..5bba1761cf29c
--- /dev/null
+++ b/docs/reference/esql/functions/examples/st_xmax.asciidoc
@@ -0,0 +1,13 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Example*
+
+[source.merge.styled,esql]
+----
+include::{esql-specs}/spatial_shapes.csv-spec[tag=st_x_y_min_max]
+----
+[%header.monospaced.styled,format=dsv,separator=|]
+|===
+include::{esql-specs}/spatial_shapes.csv-spec[tag=st_x_y_min_max-result]
+|===
+
diff --git a/docs/reference/esql/functions/examples/st_xmin.asciidoc b/docs/reference/esql/functions/examples/st_xmin.asciidoc
new file mode 100644
index 0000000000000..5bba1761cf29c
--- /dev/null
+++ b/docs/reference/esql/functions/examples/st_xmin.asciidoc
@@ -0,0 +1,13 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Example*
+
+[source.merge.styled,esql]
+----
+include::{esql-specs}/spatial_shapes.csv-spec[tag=st_x_y_min_max]
+----
+[%header.monospaced.styled,format=dsv,separator=|]
+|===
+include::{esql-specs}/spatial_shapes.csv-spec[tag=st_x_y_min_max-result]
+|===
+
diff --git a/docs/reference/esql/functions/examples/st_ymax.asciidoc b/docs/reference/esql/functions/examples/st_ymax.asciidoc
new file mode 100644
index 0000000000000..5bba1761cf29c
--- /dev/null
+++ b/docs/reference/esql/functions/examples/st_ymax.asciidoc
@@ -0,0 +1,13 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Example*
+
+[source.merge.styled,esql]
+----
+include::{esql-specs}/spatial_shapes.csv-spec[tag=st_x_y_min_max]
+----
+[%header.monospaced.styled,format=dsv,separator=|]
+|===
+include::{esql-specs}/spatial_shapes.csv-spec[tag=st_x_y_min_max-result]
+|===
+
diff --git a/docs/reference/esql/functions/examples/st_ymin.asciidoc b/docs/reference/esql/functions/examples/st_ymin.asciidoc
new file mode 100644
index 0000000000000..5bba1761cf29c
--- /dev/null
+++ b/docs/reference/esql/functions/examples/st_ymin.asciidoc
@@ -0,0 +1,13 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Example*
+
+[source.merge.styled,esql]
+----
+include::{esql-specs}/spatial_shapes.csv-spec[tag=st_x_y_min_max]
+----
+[%header.monospaced.styled,format=dsv,separator=|]
+|===
+include::{esql-specs}/spatial_shapes.csv-spec[tag=st_x_y_min_max-result]
+|===
+
diff --git a/docs/reference/esql/functions/kibana/definition/st_envelope.json b/docs/reference/esql/functions/kibana/definition/st_envelope.json
new file mode 100644
index 0000000000000..6c00dda265ac7
--- /dev/null
+++ b/docs/reference/esql/functions/kibana/definition/st_envelope.json
@@ -0,0 +1,61 @@
+{
+  "comment" : "This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.",
+  "type" : "eval",
+  "name" : "st_envelope",
+  "description" : "Determines the minimum bounding box of the supplied geometry.",
+  "signatures" : [
+    {
+      "params" : [
+        {
+          "name" : "geometry",
+          "type" : "cartesian_point",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "cartesian_shape"
+    },
+    {
+      "params" : [
+        {
+          "name" : "geometry",
+          "type" : "cartesian_shape",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "cartesian_shape"
+    },
+    {
+      "params" : [
+        {
+          "name" : "geometry",
+          "type" : "geo_point",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "geo_shape"
+    },
+    {
+      "params" : [
+        {
+          "name" : "geometry",
+          "type" : "geo_shape",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "geo_shape"
+    }
+  ],
+  "examples" : [
+    "FROM airport_city_boundaries\n| WHERE abbrev == \"CPH\"\n| EVAL envelope = ST_ENVELOPE(city_boundary)\n| KEEP abbrev, airport, envelope"
+  ],
+  "preview" : false,
+  "snapshot_only" : false
+}
diff --git a/docs/reference/esql/functions/kibana/definition/st_xmax.json b/docs/reference/esql/functions/kibana/definition/st_xmax.json
new file mode 100644
index 0000000000000..7be22617c0992
--- /dev/null
+++ b/docs/reference/esql/functions/kibana/definition/st_xmax.json
@@ -0,0 +1,61 @@
+{
+  "comment" : "This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.",
+  "type" : "eval",
+  "name" : "st_xmax",
+  "description" : "Extracts the maximum value of the `x` coordinates from the supplied geometry.\nIf the geometry is of type `geo_point` or `geo_shape` this is equivalent to extracting the maximum `longitude` value.",
+  "signatures" : [
+    {
+      "params" : [
+        {
+          "name" : "point",
+          "type" : "cartesian_point",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "double"
+    },
+    {
+      "params" : [
+        {
+          "name" : "point",
+          "type" : "cartesian_shape",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "double"
+    },
+    {
+      "params" : [
+        {
+          "name" : "point",
+          "type" : "geo_point",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "double"
+    },
+    {
+      "params" : [
+        {
+          "name" : "point",
+          "type" : "geo_shape",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "double"
+    }
+  ],
+  "examples" : [
+    "FROM airport_city_boundaries\n| WHERE abbrev == \"CPH\"\n| EVAL envelope = ST_ENVELOPE(city_boundary)\n| EVAL xmin = ST_XMIN(envelope), xmax = ST_XMAX(envelope), ymin = ST_YMIN(envelope), ymax = ST_YMAX(envelope)\n| KEEP abbrev, airport, xmin, xmax, ymin, ymax"
+  ],
+  "preview" : false,
+  "snapshot_only" : false
+}
diff --git a/docs/reference/esql/functions/kibana/definition/st_xmin.json b/docs/reference/esql/functions/kibana/definition/st_xmin.json
new file mode 100644
index 0000000000000..8052fdb861cea
--- /dev/null
+++ b/docs/reference/esql/functions/kibana/definition/st_xmin.json
@@ -0,0 +1,61 @@
+{
+  "comment" : "This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.",
+  "type" : "eval",
+  "name" : "st_xmin",
+  "description" : "Extracts the minimum value of the `x` coordinates from the supplied geometry.\nIf the geometry is of type `geo_point` or `geo_shape` this is equivalent to extracting the minimum `longitude` value.",
+  "signatures" : [
+    {
+      "params" : [
+        {
+          "name" : "point",
+          "type" : "cartesian_point",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "double"
+    },
+    {
+      "params" : [
+        {
+          "name" : "point",
+          "type" : "cartesian_shape",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "double"
+    },
+    {
+      "params" : [
+        {
+          "name" : "point",
+          "type" : "geo_point",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "double"
+    },
+    {
+      "params" : [
+        {
+          "name" : "point",
+          "type" : "geo_shape",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "double"
+    }
+  ],
+  "examples" : [
+    "FROM airport_city_boundaries\n| WHERE abbrev == \"CPH\"\n| EVAL envelope = ST_ENVELOPE(city_boundary)\n| EVAL xmin = ST_XMIN(envelope), xmax = ST_XMAX(envelope), ymin = ST_YMIN(envelope), ymax = ST_YMAX(envelope)\n| KEEP abbrev, airport, xmin, xmax, ymin, ymax"
+  ],
+  "preview" : false,
+  "snapshot_only" : false
+}
diff --git a/docs/reference/esql/functions/kibana/definition/st_ymax.json b/docs/reference/esql/functions/kibana/definition/st_ymax.json
new file mode 100644
index 0000000000000..1a53f7388ea56
--- /dev/null
+++ b/docs/reference/esql/functions/kibana/definition/st_ymax.json
@@ -0,0 +1,61 @@
+{
+  "comment" : "This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.",
+  "type" : "eval",
+  "name" : "st_ymax",
+  "description" : "Extracts the maximum value of the `y` coordinates from the supplied geometry.\nIf the geometry is of type `geo_point` or `geo_shape` this is equivalent to extracting the maximum `latitude` value.",
+  "signatures" : [
+    {
+      "params" : [
+        {
+          "name" : "point",
+          "type" : "cartesian_point",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "double"
+    },
+    {
+      "params" : [
+        {
+          "name" : "point",
+          "type" : "cartesian_shape",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "double"
+    },
+    {
+      "params" : [
+        {
+          "name" : "point",
+          "type" : "geo_point",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "double"
+    },
+    {
+      "params" : [
+        {
+          "name" : "point",
+          "type" : "geo_shape",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "double"
+    }
+  ],
+  "examples" : [
+    "FROM airport_city_boundaries\n| WHERE abbrev == \"CPH\"\n| EVAL envelope = ST_ENVELOPE(city_boundary)\n| EVAL xmin = ST_XMIN(envelope), xmax = ST_XMAX(envelope), ymin = ST_YMIN(envelope), ymax = ST_YMAX(envelope)\n| KEEP abbrev, airport, xmin, xmax, ymin, ymax"
+  ],
+  "preview" : false,
+  "snapshot_only" : false
+}
diff --git a/docs/reference/esql/functions/kibana/definition/st_ymin.json b/docs/reference/esql/functions/kibana/definition/st_ymin.json
new file mode 100644
index 0000000000000..e11722a8f9c07
--- /dev/null
+++ b/docs/reference/esql/functions/kibana/definition/st_ymin.json
@@ -0,0 +1,61 @@
+{
+  "comment" : "This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.",
+  "type" : "eval",
+  "name" : "st_ymin",
+  "description" : "Extracts the minimum value of the `y` coordinates from the supplied geometry.\nIf the geometry is of type `geo_point` or `geo_shape` this is equivalent to extracting the minimum `latitude` value.",
+  "signatures" : [
+    {
+      "params" : [
+        {
+          "name" : "point",
+          "type" : "cartesian_point",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "double"
+    },
+    {
+      "params" : [
+        {
+          "name" : "point",
+          "type" : "cartesian_shape",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "double"
+    },
+    {
+      "params" : [
+        {
+          "name" : "point",
+          "type" : "geo_point",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "double"
+    },
+    {
+      "params" : [
+        {
+          "name" : "point",
+          "type" : "geo_shape",
+          "optional" : false,
+          "description" : "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "double"
+    }
+  ],
+  "examples" : [
+    "FROM airport_city_boundaries\n| WHERE abbrev == \"CPH\"\n| EVAL envelope = ST_ENVELOPE(city_boundary)\n| EVAL xmin = ST_XMIN(envelope), xmax = ST_XMAX(envelope), ymin = ST_YMIN(envelope), ymax = ST_YMAX(envelope)\n| KEEP abbrev, airport, xmin, xmax, ymin, ymax"
+  ],
+  "preview" : false,
+  "snapshot_only" : false
+}
diff --git a/docs/reference/esql/functions/kibana/docs/st_envelope.md b/docs/reference/esql/functions/kibana/docs/st_envelope.md
new file mode 100644
index 0000000000000..5f4c3e4809a82
--- /dev/null
+++ b/docs/reference/esql/functions/kibana/docs/st_envelope.md
@@ -0,0 +1,13 @@
+<!--
+This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+-->
+
+### ST_ENVELOPE
+Determines the minimum bounding box of the supplied geometry.
+
+```
+FROM airport_city_boundaries
+| WHERE abbrev == "CPH"
+| EVAL envelope = ST_ENVELOPE(city_boundary)
+| KEEP abbrev, airport, envelope
+```
diff --git a/docs/reference/esql/functions/kibana/docs/st_xmax.md b/docs/reference/esql/functions/kibana/docs/st_xmax.md
new file mode 100644
index 0000000000000..bbde89df76fd0
--- /dev/null
+++ b/docs/reference/esql/functions/kibana/docs/st_xmax.md
@@ -0,0 +1,15 @@
+<!--
+This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+-->
+
+### ST_XMAX
+Extracts the maximum value of the `x` coordinates from the supplied geometry.
+If the geometry is of type `geo_point` or `geo_shape` this is equivalent to extracting the maximum `longitude` value.
+
+```
+FROM airport_city_boundaries
+| WHERE abbrev == "CPH"
+| EVAL envelope = ST_ENVELOPE(city_boundary)
+| EVAL xmin = ST_XMIN(envelope), xmax = ST_XMAX(envelope), ymin = ST_YMIN(envelope), ymax = ST_YMAX(envelope)
+| KEEP abbrev, airport, xmin, xmax, ymin, ymax
+```
diff --git a/docs/reference/esql/functions/kibana/docs/st_xmin.md b/docs/reference/esql/functions/kibana/docs/st_xmin.md
new file mode 100644
index 0000000000000..1a6cee7dcfd62
--- /dev/null
+++ b/docs/reference/esql/functions/kibana/docs/st_xmin.md
@@ -0,0 +1,15 @@
+<!--
+This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+-->
+
+### ST_XMIN
+Extracts the minimum value of the `x` coordinates from the supplied geometry.
+If the geometry is of type `geo_point` or `geo_shape` this is equivalent to extracting the minimum `longitude` value.
+
+```
+FROM airport_city_boundaries
+| WHERE abbrev == "CPH"
+| EVAL envelope = ST_ENVELOPE(city_boundary)
+| EVAL xmin = ST_XMIN(envelope), xmax = ST_XMAX(envelope), ymin = ST_YMIN(envelope), ymax = ST_YMAX(envelope)
+| KEEP abbrev, airport, xmin, xmax, ymin, ymax
+```
diff --git a/docs/reference/esql/functions/kibana/docs/st_ymax.md b/docs/reference/esql/functions/kibana/docs/st_ymax.md
new file mode 100644
index 0000000000000..61c9b6c288ca5
--- /dev/null
+++ b/docs/reference/esql/functions/kibana/docs/st_ymax.md
@@ -0,0 +1,15 @@
+<!--
+This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+-->
+
+### ST_YMAX
+Extracts the maximum value of the `y` coordinates from the supplied geometry.
+If the geometry is of type `geo_point` or `geo_shape` this is equivalent to extracting the maximum `latitude` value.
+
+```
+FROM airport_city_boundaries
+| WHERE abbrev == "CPH"
+| EVAL envelope = ST_ENVELOPE(city_boundary)
+| EVAL xmin = ST_XMIN(envelope), xmax = ST_XMAX(envelope), ymin = ST_YMIN(envelope), ymax = ST_YMAX(envelope)
+| KEEP abbrev, airport, xmin, xmax, ymin, ymax
+```
diff --git a/docs/reference/esql/functions/kibana/docs/st_ymin.md b/docs/reference/esql/functions/kibana/docs/st_ymin.md
new file mode 100644
index 0000000000000..f5817f10f20a5
--- /dev/null
+++ b/docs/reference/esql/functions/kibana/docs/st_ymin.md
@@ -0,0 +1,15 @@
+<!--
+This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+-->
+
+### ST_YMIN
+Extracts the minimum value of the `y` coordinates from the supplied geometry.
+If the geometry is of type `geo_point` or `geo_shape` this is equivalent to extracting the minimum `latitude` value.
+
+```
+FROM airport_city_boundaries
+| WHERE abbrev == "CPH"
+| EVAL envelope = ST_ENVELOPE(city_boundary)
+| EVAL xmin = ST_XMIN(envelope), xmax = ST_XMAX(envelope), ymin = ST_YMIN(envelope), ymax = ST_YMAX(envelope)
+| KEEP abbrev, airport, xmin, xmax, ymin, ymax
+```
diff --git a/docs/reference/esql/functions/layout/st_envelope.asciidoc b/docs/reference/esql/functions/layout/st_envelope.asciidoc
new file mode 100644
index 0000000000000..a20d4275e0c9f
--- /dev/null
+++ b/docs/reference/esql/functions/layout/st_envelope.asciidoc
@@ -0,0 +1,15 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+[discrete]
+[[esql-st_envelope]]
+=== `ST_ENVELOPE`
+
+*Syntax*
+
+[.text-center]
+image::esql/functions/signature/st_envelope.svg[Embedded,opts=inline]
+
+include::../parameters/st_envelope.asciidoc[]
+include::../description/st_envelope.asciidoc[]
+include::../types/st_envelope.asciidoc[]
+include::../examples/st_envelope.asciidoc[]
diff --git a/docs/reference/esql/functions/layout/st_xmax.asciidoc b/docs/reference/esql/functions/layout/st_xmax.asciidoc
new file mode 100644
index 0000000000000..b0c5e7695521e
--- /dev/null
+++ b/docs/reference/esql/functions/layout/st_xmax.asciidoc
@@ -0,0 +1,15 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+[discrete]
+[[esql-st_xmax]]
+=== `ST_XMAX`
+
+*Syntax*
+
+[.text-center]
+image::esql/functions/signature/st_xmax.svg[Embedded,opts=inline]
+
+include::../parameters/st_xmax.asciidoc[]
+include::../description/st_xmax.asciidoc[]
+include::../types/st_xmax.asciidoc[]
+include::../examples/st_xmax.asciidoc[]
diff --git a/docs/reference/esql/functions/layout/st_xmin.asciidoc b/docs/reference/esql/functions/layout/st_xmin.asciidoc
new file mode 100644
index 0000000000000..55fbad88c4cf0
--- /dev/null
+++ b/docs/reference/esql/functions/layout/st_xmin.asciidoc
@@ -0,0 +1,15 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+[discrete]
+[[esql-st_xmin]]
+=== `ST_XMIN`
+
+*Syntax*
+
+[.text-center]
+image::esql/functions/signature/st_xmin.svg[Embedded,opts=inline]
+
+include::../parameters/st_xmin.asciidoc[]
+include::../description/st_xmin.asciidoc[]
+include::../types/st_xmin.asciidoc[]
+include::../examples/st_xmin.asciidoc[]
diff --git a/docs/reference/esql/functions/layout/st_ymax.asciidoc b/docs/reference/esql/functions/layout/st_ymax.asciidoc
new file mode 100644
index 0000000000000..e1022de4ba664
--- /dev/null
+++ b/docs/reference/esql/functions/layout/st_ymax.asciidoc
@@ -0,0 +1,15 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+[discrete]
+[[esql-st_ymax]]
+=== `ST_YMAX`
+
+*Syntax*
+
+[.text-center]
+image::esql/functions/signature/st_ymax.svg[Embedded,opts=inline]
+
+include::../parameters/st_ymax.asciidoc[]
+include::../description/st_ymax.asciidoc[]
+include::../types/st_ymax.asciidoc[]
+include::../examples/st_ymax.asciidoc[]
diff --git a/docs/reference/esql/functions/layout/st_ymin.asciidoc b/docs/reference/esql/functions/layout/st_ymin.asciidoc
new file mode 100644
index 0000000000000..65511e1925e27
--- /dev/null
+++ b/docs/reference/esql/functions/layout/st_ymin.asciidoc
@@ -0,0 +1,15 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+[discrete]
+[[esql-st_ymin]]
+=== `ST_YMIN`
+
+*Syntax*
+
+[.text-center]
+image::esql/functions/signature/st_ymin.svg[Embedded,opts=inline]
+
+include::../parameters/st_ymin.asciidoc[]
+include::../description/st_ymin.asciidoc[]
+include::../types/st_ymin.asciidoc[]
+include::../examples/st_ymin.asciidoc[]
diff --git a/docs/reference/esql/functions/parameters/st_envelope.asciidoc b/docs/reference/esql/functions/parameters/st_envelope.asciidoc
new file mode 100644
index 0000000000000..a31c6a85de367
--- /dev/null
+++ b/docs/reference/esql/functions/parameters/st_envelope.asciidoc
@@ -0,0 +1,6 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Parameters*
+
+`geometry`::
+Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`.
diff --git a/docs/reference/esql/functions/parameters/st_xmax.asciidoc b/docs/reference/esql/functions/parameters/st_xmax.asciidoc
new file mode 100644
index 0000000000000..788f3485af297
--- /dev/null
+++ b/docs/reference/esql/functions/parameters/st_xmax.asciidoc
@@ -0,0 +1,6 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Parameters*
+
+`point`::
+Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`.
diff --git a/docs/reference/esql/functions/parameters/st_xmin.asciidoc b/docs/reference/esql/functions/parameters/st_xmin.asciidoc
new file mode 100644
index 0000000000000..788f3485af297
--- /dev/null
+++ b/docs/reference/esql/functions/parameters/st_xmin.asciidoc
@@ -0,0 +1,6 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Parameters*
+
+`point`::
+Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`.
diff --git a/docs/reference/esql/functions/parameters/st_ymax.asciidoc b/docs/reference/esql/functions/parameters/st_ymax.asciidoc
new file mode 100644
index 0000000000000..788f3485af297
--- /dev/null
+++ b/docs/reference/esql/functions/parameters/st_ymax.asciidoc
@@ -0,0 +1,6 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Parameters*
+
+`point`::
+Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`.
diff --git a/docs/reference/esql/functions/parameters/st_ymin.asciidoc b/docs/reference/esql/functions/parameters/st_ymin.asciidoc
new file mode 100644
index 0000000000000..788f3485af297
--- /dev/null
+++ b/docs/reference/esql/functions/parameters/st_ymin.asciidoc
@@ -0,0 +1,6 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Parameters*
+
+`point`::
+Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. If `null`, the function returns `null`.
diff --git a/docs/reference/esql/functions/signature/st_envelope.svg b/docs/reference/esql/functions/signature/st_envelope.svg
new file mode 100644
index 0000000000000..885a60e6fd86f
--- /dev/null
+++ b/docs/reference/esql/functions/signature/st_envelope.svg
@@ -0,0 +1 @@
+<svg version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://www.w3.org/2000/svg" width="372" height="46" viewbox="0 0 372 46"><defs><style type="text/css">#guide .c{fill:none;stroke:#222222;}#guide .k{fill:#000000;font-family:Roboto Mono,Sans-serif;font-size:20px;}#guide .s{fill:#e4f4ff;stroke:#222222;}#guide .syn{fill:#8D8D8D;font-family:Roboto Mono,Sans-serif;font-size:20px;}</style></defs><path class="c" d="M0 31h5m152 0h10m32 0h10m116 0h10m32 0h5"/><rect class="s" x="5" y="5" width="152" height="36"/><text class="k" x="15" y="31">ST_ENVELOPE</text><rect class="s" x="167" y="5" width="32" height="36" rx="7"/><text class="syn" x="177" y="31">(</text><rect class="s" x="209" y="5" width="116" height="36" rx="7"/><text class="k" x="219" y="31">geometry</text><rect class="s" x="335" y="5" width="32" height="36" rx="7"/><text class="syn" x="345" y="31">)</text></svg>
\ No newline at end of file
diff --git a/docs/reference/esql/functions/signature/st_xmax.svg b/docs/reference/esql/functions/signature/st_xmax.svg
new file mode 100644
index 0000000000000..348d5a7f72763
--- /dev/null
+++ b/docs/reference/esql/functions/signature/st_xmax.svg
@@ -0,0 +1 @@
+<svg version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://www.w3.org/2000/svg" width="288" height="46" viewbox="0 0 288 46"><defs><style type="text/css">#guide .c{fill:none;stroke:#222222;}#guide .k{fill:#000000;font-family:Roboto Mono,Sans-serif;font-size:20px;}#guide .s{fill:#e4f4ff;stroke:#222222;}#guide .syn{fill:#8D8D8D;font-family:Roboto Mono,Sans-serif;font-size:20px;}</style></defs><path class="c" d="M0 31h5m104 0h10m32 0h10m80 0h10m32 0h5"/><rect class="s" x="5" y="5" width="104" height="36"/><text class="k" x="15" y="31">ST_XMAX</text><rect class="s" x="119" y="5" width="32" height="36" rx="7"/><text class="syn" x="129" y="31">(</text><rect class="s" x="161" y="5" width="80" height="36" rx="7"/><text class="k" x="171" y="31">point</text><rect class="s" x="251" y="5" width="32" height="36" rx="7"/><text class="syn" x="261" y="31">)</text></svg>
\ No newline at end of file
diff --git a/docs/reference/esql/functions/signature/st_xmin.svg b/docs/reference/esql/functions/signature/st_xmin.svg
new file mode 100644
index 0000000000000..13d479b0458be
--- /dev/null
+++ b/docs/reference/esql/functions/signature/st_xmin.svg
@@ -0,0 +1 @@
+<svg version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://www.w3.org/2000/svg" width="288" height="46" viewbox="0 0 288 46"><defs><style type="text/css">#guide .c{fill:none;stroke:#222222;}#guide .k{fill:#000000;font-family:Roboto Mono,Sans-serif;font-size:20px;}#guide .s{fill:#e4f4ff;stroke:#222222;}#guide .syn{fill:#8D8D8D;font-family:Roboto Mono,Sans-serif;font-size:20px;}</style></defs><path class="c" d="M0 31h5m104 0h10m32 0h10m80 0h10m32 0h5"/><rect class="s" x="5" y="5" width="104" height="36"/><text class="k" x="15" y="31">ST_XMIN</text><rect class="s" x="119" y="5" width="32" height="36" rx="7"/><text class="syn" x="129" y="31">(</text><rect class="s" x="161" y="5" width="80" height="36" rx="7"/><text class="k" x="171" y="31">point</text><rect class="s" x="251" y="5" width="32" height="36" rx="7"/><text class="syn" x="261" y="31">)</text></svg>
\ No newline at end of file
diff --git a/docs/reference/esql/functions/signature/st_ymax.svg b/docs/reference/esql/functions/signature/st_ymax.svg
new file mode 100644
index 0000000000000..e6ecb00185c84
--- /dev/null
+++ b/docs/reference/esql/functions/signature/st_ymax.svg
@@ -0,0 +1 @@
+<svg version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://www.w3.org/2000/svg" width="288" height="46" viewbox="0 0 288 46"><defs><style type="text/css">#guide .c{fill:none;stroke:#222222;}#guide .k{fill:#000000;font-family:Roboto Mono,Sans-serif;font-size:20px;}#guide .s{fill:#e4f4ff;stroke:#222222;}#guide .syn{fill:#8D8D8D;font-family:Roboto Mono,Sans-serif;font-size:20px;}</style></defs><path class="c" d="M0 31h5m104 0h10m32 0h10m80 0h10m32 0h5"/><rect class="s" x="5" y="5" width="104" height="36"/><text class="k" x="15" y="31">ST_YMAX</text><rect class="s" x="119" y="5" width="32" height="36" rx="7"/><text class="syn" x="129" y="31">(</text><rect class="s" x="161" y="5" width="80" height="36" rx="7"/><text class="k" x="171" y="31">point</text><rect class="s" x="251" y="5" width="32" height="36" rx="7"/><text class="syn" x="261" y="31">)</text></svg>
\ No newline at end of file
diff --git a/docs/reference/esql/functions/signature/st_ymin.svg b/docs/reference/esql/functions/signature/st_ymin.svg
new file mode 100644
index 0000000000000..ae722f1edc3d4
--- /dev/null
+++ b/docs/reference/esql/functions/signature/st_ymin.svg
@@ -0,0 +1 @@
+<svg version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://www.w3.org/2000/svg" width="288" height="46" viewbox="0 0 288 46"><defs><style type="text/css">#guide .c{fill:none;stroke:#222222;}#guide .k{fill:#000000;font-family:Roboto Mono,Sans-serif;font-size:20px;}#guide .s{fill:#e4f4ff;stroke:#222222;}#guide .syn{fill:#8D8D8D;font-family:Roboto Mono,Sans-serif;font-size:20px;}</style></defs><path class="c" d="M0 31h5m104 0h10m32 0h10m80 0h10m32 0h5"/><rect class="s" x="5" y="5" width="104" height="36"/><text class="k" x="15" y="31">ST_YMIN</text><rect class="s" x="119" y="5" width="32" height="36" rx="7"/><text class="syn" x="129" y="31">(</text><rect class="s" x="161" y="5" width="80" height="36" rx="7"/><text class="k" x="171" y="31">point</text><rect class="s" x="251" y="5" width="32" height="36" rx="7"/><text class="syn" x="261" y="31">)</text></svg>
\ No newline at end of file
diff --git a/docs/reference/esql/functions/spatial-functions.asciidoc b/docs/reference/esql/functions/spatial-functions.asciidoc
index eee44d337b4c6..c6a8467b39996 100644
--- a/docs/reference/esql/functions/spatial-functions.asciidoc
+++ b/docs/reference/esql/functions/spatial-functions.asciidoc
@@ -15,6 +15,11 @@
 * <<esql-st_within>>
 * <<esql-st_x>>
 * <<esql-st_y>>
+* experimental:[] <<esql-st_envelope>>
+* experimental:[] <<esql-st_xmax>>
+* experimental:[] <<esql-st_xmin>>
+* experimental:[] <<esql-st_ymax>>
+* experimental:[] <<esql-st_ymin>>
 // end::spatial_list[]
 
 include::layout/st_distance.asciidoc[]
@@ -24,3 +29,8 @@ include::layout/st_contains.asciidoc[]
 include::layout/st_within.asciidoc[]
 include::layout/st_x.asciidoc[]
 include::layout/st_y.asciidoc[]
+include::layout/st_envelope.asciidoc[]
+include::layout/st_xmax.asciidoc[]
+include::layout/st_xmin.asciidoc[]
+include::layout/st_ymax.asciidoc[]
+include::layout/st_ymin.asciidoc[]
diff --git a/docs/reference/esql/functions/types/st_envelope.asciidoc b/docs/reference/esql/functions/types/st_envelope.asciidoc
new file mode 100644
index 0000000000000..43355394c6015
--- /dev/null
+++ b/docs/reference/esql/functions/types/st_envelope.asciidoc
@@ -0,0 +1,12 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Supported types*
+
+[%header.monospaced.styled,format=dsv,separator=|]
+|===
+geometry | result
+cartesian_point | cartesian_shape
+cartesian_shape | cartesian_shape
+geo_point | geo_shape
+geo_shape | geo_shape
+|===
diff --git a/docs/reference/esql/functions/types/st_xmax.asciidoc b/docs/reference/esql/functions/types/st_xmax.asciidoc
new file mode 100644
index 0000000000000..418c5cafae6f3
--- /dev/null
+++ b/docs/reference/esql/functions/types/st_xmax.asciidoc
@@ -0,0 +1,12 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Supported types*
+
+[%header.monospaced.styled,format=dsv,separator=|]
+|===
+point | result
+cartesian_point | double
+cartesian_shape | double
+geo_point | double
+geo_shape | double
+|===
diff --git a/docs/reference/esql/functions/types/st_xmin.asciidoc b/docs/reference/esql/functions/types/st_xmin.asciidoc
new file mode 100644
index 0000000000000..418c5cafae6f3
--- /dev/null
+++ b/docs/reference/esql/functions/types/st_xmin.asciidoc
@@ -0,0 +1,12 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Supported types*
+
+[%header.monospaced.styled,format=dsv,separator=|]
+|===
+point | result
+cartesian_point | double
+cartesian_shape | double
+geo_point | double
+geo_shape | double
+|===
diff --git a/docs/reference/esql/functions/types/st_ymax.asciidoc b/docs/reference/esql/functions/types/st_ymax.asciidoc
new file mode 100644
index 0000000000000..418c5cafae6f3
--- /dev/null
+++ b/docs/reference/esql/functions/types/st_ymax.asciidoc
@@ -0,0 +1,12 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Supported types*
+
+[%header.monospaced.styled,format=dsv,separator=|]
+|===
+point | result
+cartesian_point | double
+cartesian_shape | double
+geo_point | double
+geo_shape | double
+|===
diff --git a/docs/reference/esql/functions/types/st_ymin.asciidoc b/docs/reference/esql/functions/types/st_ymin.asciidoc
new file mode 100644
index 0000000000000..418c5cafae6f3
--- /dev/null
+++ b/docs/reference/esql/functions/types/st_ymin.asciidoc
@@ -0,0 +1,12 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Supported types*
+
+[%header.monospaced.styled,format=dsv,separator=|]
+|===
+point | result
+cartesian_point | double
+cartesian_shape | double
+geo_point | double
+geo_shape | double
+|===
diff --git a/libs/geo/src/main/java/org/elasticsearch/geometry/utils/SpatialEnvelopeVisitor.java b/libs/geo/src/main/java/org/elasticsearch/geometry/utils/SpatialEnvelopeVisitor.java
new file mode 100644
index 0000000000000..eee4a62c7d588
--- /dev/null
+++ b/libs/geo/src/main/java/org/elasticsearch/geometry/utils/SpatialEnvelopeVisitor.java
@@ -0,0 +1,356 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.geometry.utils;
+
+import org.elasticsearch.geometry.Circle;
+import org.elasticsearch.geometry.Geometry;
+import org.elasticsearch.geometry.GeometryCollection;
+import org.elasticsearch.geometry.GeometryVisitor;
+import org.elasticsearch.geometry.Line;
+import org.elasticsearch.geometry.LinearRing;
+import org.elasticsearch.geometry.MultiLine;
+import org.elasticsearch.geometry.MultiPoint;
+import org.elasticsearch.geometry.MultiPolygon;
+import org.elasticsearch.geometry.Point;
+import org.elasticsearch.geometry.Polygon;
+import org.elasticsearch.geometry.Rectangle;
+
+import java.util.Locale;
+import java.util.Optional;
+
+/**
+ * This visitor is designed to determine the spatial envelope (or BBOX or MBR) of a potentially complex geometry.
+ * It has two modes:
+ * <ul>
+ *     <li>
+ *         Cartesian mode: The envelope is determined by the minimum and maximum x/y coordinates.
+ *         Incoming BBOX geometries with minX &gt; maxX are treated as invalid.
+ *         Resulting BBOX geometries will always have minX &lt;= maxX.
+ *     </li>
+ *     <li>
+ *         Geographic mode: The envelope is determined by the minimum and maximum x/y coordinates,
+ *         considering the possibility of wrapping the longitude around the dateline.
+ *         A bounding box can be determined either by wrapping the longitude around the dateline or not,
+ *         and the smaller bounding box is chosen. It is possible to disable the wrapping of the longitude.
+ * </ul>
+ * Usage of this is as simple as:
+ * <code>
+ *     Optional&lt;Rectangle&gt; bbox = SpatialEnvelopeVisitor.visit(geometry);
+ *     if (bbox.isPresent()) {
+ *         Rectangle envelope = bbox.get();
+ *         // Do stuff with the envelope
+ *     }
+ * </code>
+ * It is also possible to create the inner <code>PointVisitor</code> separately, as well as use the visitor for multiple geometries.
+ * <code>
+ *     PointVisitor pointVisitor = new CartesianPointVisitor();
+ *     SpatialEnvelopeVisitor visitor = new SpatialEnvelopeVisitor(pointVisitor);
+ *     for (Geometry geometry : geometries) {
+ *         geometry.visit(visitor);
+ *     }
+ *     if (visitor.isValid()) {
+ *         Rectangle envelope = visitor.getResult();
+ *         // Do stuff with the envelope
+ *     }
+ * </code>
+ * Code that wishes to modify the behaviour of the visitor can implement the <code>PointVisitor</code> interface,
+ * or extend the existing implementations.
+ */
+public class SpatialEnvelopeVisitor implements GeometryVisitor<Boolean, RuntimeException> {
+
+    private final PointVisitor pointVisitor;
+
+    public SpatialEnvelopeVisitor(PointVisitor pointVisitor) {
+        this.pointVisitor = pointVisitor;
+    }
+
+    /**
+     * Determine the BBOX without considering the CRS or wrapping of the longitude.
+     * Note that incoming BBOX's that do cross the dateline (minx>maxx) will be treated as invalid.
+     */
+    public static Optional<Rectangle> visitCartesian(Geometry geometry) {
+        var visitor = new SpatialEnvelopeVisitor(new CartesianPointVisitor());
+        if (geometry.visit(visitor)) {
+            return Optional.of(visitor.getResult());
+        }
+        return Optional.empty();
+    }
+
+    /**
+     * Determine the BBOX assuming the CRS is geographic (eg WGS84) and optionally wrapping the longitude around the dateline.
+     */
+    public static Optional<Rectangle> visitGeo(Geometry geometry, boolean wrapLongitude) {
+        var visitor = new SpatialEnvelopeVisitor(new GeoPointVisitor(wrapLongitude));
+        if (geometry.visit(visitor)) {
+            return Optional.of(visitor.getResult());
+        }
+        return Optional.empty();
+    }
+
+    public Rectangle getResult() {
+        return pointVisitor.getResult();
+    }
+
+    /**
+     * Visitor for visiting points and rectangles. This is where the actual envelope calculation happens.
+     * There are two implementations, one for cartesian coordinates and one for geographic coordinates.
+     * The latter can optionally wrap the longitude around the dateline.
+     */
+    public interface PointVisitor {
+        void visitPoint(double x, double y);
+
+        void visitRectangle(double minX, double maxX, double maxY, double minY);
+
+        boolean isValid();
+
+        Rectangle getResult();
+    }
+
+    /**
+     * The cartesian point visitor determines the envelope by the minimum and maximum x/y coordinates.
+     * It also disallows invalid rectangles where minX > maxX.
+     */
+    public static class CartesianPointVisitor implements PointVisitor {
+        private double minX = Double.POSITIVE_INFINITY;
+        private double minY = Double.POSITIVE_INFINITY;
+        private double maxX = Double.NEGATIVE_INFINITY;
+        private double maxY = Double.NEGATIVE_INFINITY;
+
+        public double getMinX() {
+            return minX;
+        }
+
+        public double getMinY() {
+            return minY;
+        }
+
+        public double getMaxX() {
+            return maxX;
+        }
+
+        public double getMaxY() {
+            return maxY;
+        }
+
+        @Override
+        public void visitPoint(double x, double y) {
+            minX = Math.min(minX, x);
+            minY = Math.min(minY, y);
+            maxX = Math.max(maxX, x);
+            maxY = Math.max(maxY, y);
+        }
+
+        @Override
+        public void visitRectangle(double minX, double maxX, double maxY, double minY) {
+            if (minX > maxX) {
+                throw new IllegalArgumentException(
+                    String.format(Locale.ROOT, "Invalid cartesian rectangle: minX (%s) > maxX (%s)", minX, maxX)
+                );
+            }
+            this.minX = Math.min(this.minX, minX);
+            this.minY = Math.min(this.minY, minY);
+            this.maxX = Math.max(this.maxX, maxX);
+            this.maxY = Math.max(this.maxY, maxY);
+        }
+
+        @Override
+        public boolean isValid() {
+            return minY != Double.POSITIVE_INFINITY;
+        }
+
+        @Override
+        public Rectangle getResult() {
+            return new Rectangle(minX, maxX, maxY, minY);
+        }
+    }
+
+    /**
+     * The geographic point visitor determines the envelope by the minimum and maximum x/y coordinates,
+     * while allowing for wrapping the longitude around the dateline.
+     * When longitude wrapping is enabled, the visitor will determine the smallest bounding box between the two choices:
+     * <ul>
+     *     <li>Wrapping around the front of the earth, in which case the result will have minx &lt; maxx</li>
+     *     <li>Wrapping around the back of the earth, crossing the dateline, in which case the result will have minx &gt; maxx</li>
+     * </ul>
+     */
+    public static class GeoPointVisitor implements PointVisitor {
+        private double minY = Double.POSITIVE_INFINITY;
+        private double maxY = Double.NEGATIVE_INFINITY;
+        private double minNegX = Double.POSITIVE_INFINITY;
+        private double maxNegX = Double.NEGATIVE_INFINITY;
+        private double minPosX = Double.POSITIVE_INFINITY;
+        private double maxPosX = Double.NEGATIVE_INFINITY;
+
+        public double getMinY() {
+            return minY;
+        }
+
+        public double getMaxY() {
+            return maxY;
+        }
+
+        public double getMinNegX() {
+            return minNegX;
+        }
+
+        public double getMaxNegX() {
+            return maxNegX;
+        }
+
+        public double getMinPosX() {
+            return minPosX;
+        }
+
+        public double getMaxPosX() {
+            return maxPosX;
+        }
+
+        private final boolean wrapLongitude;
+
+        public GeoPointVisitor(boolean wrapLongitude) {
+            this.wrapLongitude = wrapLongitude;
+        }
+
+        @Override
+        public void visitPoint(double x, double y) {
+            minY = Math.min(minY, y);
+            maxY = Math.max(maxY, y);
+            visitLongitude(x);
+        }
+
+        @Override
+        public void visitRectangle(double minX, double maxX, double maxY, double minY) {
+            this.minY = Math.min(this.minY, minY);
+            this.maxY = Math.max(this.maxY, maxY);
+            visitLongitude(minX);
+            visitLongitude(maxX);
+        }
+
+        private void visitLongitude(double x) {
+            if (x >= 0) {
+                minPosX = Math.min(minPosX, x);
+                maxPosX = Math.max(maxPosX, x);
+            } else {
+                minNegX = Math.min(minNegX, x);
+                maxNegX = Math.max(maxNegX, x);
+            }
+        }
+
+        @Override
+        public boolean isValid() {
+            return minY != Double.POSITIVE_INFINITY;
+        }
+
+        @Override
+        public Rectangle getResult() {
+            return getResult(minNegX, minPosX, maxNegX, maxPosX, maxY, minY, wrapLongitude);
+        }
+
+        private static Rectangle getResult(
+            double minNegX,
+            double minPosX,
+            double maxNegX,
+            double maxPosX,
+            double maxY,
+            double minY,
+            boolean wrapLongitude
+        ) {
+            assert Double.isFinite(maxY);
+            if (Double.isInfinite(minPosX)) {
+                return new Rectangle(minNegX, maxNegX, maxY, minY);
+            } else if (Double.isInfinite(minNegX)) {
+                return new Rectangle(minPosX, maxPosX, maxY, minY);
+            } else if (wrapLongitude) {
+                double unwrappedWidth = maxPosX - minNegX;
+                double wrappedWidth = (180 - minPosX) - (-180 - maxNegX);
+                if (unwrappedWidth <= wrappedWidth) {
+                    return new Rectangle(minNegX, maxPosX, maxY, minY);
+                } else {
+                    return new Rectangle(minPosX, maxNegX, maxY, minY);
+                }
+            } else {
+                return new Rectangle(minNegX, maxPosX, maxY, minY);
+            }
+        }
+    }
+
+    private boolean isValid() {
+        return pointVisitor.isValid();
+    }
+
+    @Override
+    public Boolean visit(Circle circle) throws RuntimeException {
+        // TODO: Support circle, if given CRS (needed for radius to x/y coordinate transformation)
+        throw new UnsupportedOperationException("Circle is not supported");
+    }
+
+    @Override
+    public Boolean visit(GeometryCollection<?> collection) throws RuntimeException {
+        collection.forEach(geometry -> geometry.visit(this));
+        return isValid();
+    }
+
+    @Override
+    public Boolean visit(Line line) throws RuntimeException {
+        for (int i = 0; i < line.length(); i++) {
+            pointVisitor.visitPoint(line.getX(i), line.getY(i));
+        }
+        return isValid();
+    }
+
+    @Override
+    public Boolean visit(LinearRing ring) throws RuntimeException {
+        for (int i = 0; i < ring.length(); i++) {
+            pointVisitor.visitPoint(ring.getX(i), ring.getY(i));
+        }
+        return isValid();
+    }
+
+    @Override
+    public Boolean visit(MultiLine multiLine) throws RuntimeException {
+        multiLine.forEach(line -> line.visit(this));
+        return isValid();
+    }
+
+    @Override
+    public Boolean visit(MultiPoint multiPoint) throws RuntimeException {
+        for (int i = 0; i < multiPoint.size(); i++) {
+            visit(multiPoint.get(i));
+        }
+        return isValid();
+    }
+
+    @Override
+    public Boolean visit(MultiPolygon multiPolygon) throws RuntimeException {
+        multiPolygon.forEach(polygon -> polygon.visit(this));
+        return isValid();
+    }
+
+    @Override
+    public Boolean visit(Point point) throws RuntimeException {
+        pointVisitor.visitPoint(point.getX(), point.getY());
+        return isValid();
+    }
+
+    @Override
+    public Boolean visit(Polygon polygon) throws RuntimeException {
+        visit(polygon.getPolygon());
+        for (int i = 0; i < polygon.getNumberOfHoles(); i++) {
+            visit(polygon.getHole(i));
+        }
+        return isValid();
+    }
+
+    @Override
+    public Boolean visit(Rectangle rectangle) throws RuntimeException {
+        pointVisitor.visitRectangle(rectangle.getMinX(), rectangle.getMaxX(), rectangle.getMaxY(), rectangle.getMinY());
+        return isValid();
+    }
+}
diff --git a/libs/geo/src/test/java/org/elasticsearch/geometry/utils/SpatialEnvelopeVisitorTests.java b/libs/geo/src/test/java/org/elasticsearch/geometry/utils/SpatialEnvelopeVisitorTests.java
new file mode 100644
index 0000000000000..fc35df295e566
--- /dev/null
+++ b/libs/geo/src/test/java/org/elasticsearch/geometry/utils/SpatialEnvelopeVisitorTests.java
@@ -0,0 +1,194 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.geometry.utils;
+
+import org.elasticsearch.geo.GeometryTestUtils;
+import org.elasticsearch.geo.ShapeTestUtils;
+import org.elasticsearch.geometry.Point;
+import org.elasticsearch.geometry.Rectangle;
+import org.elasticsearch.test.ESTestCase;
+
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.greaterThanOrEqualTo;
+import static org.hamcrest.Matchers.lessThanOrEqualTo;
+
+public class SpatialEnvelopeVisitorTests extends ESTestCase {
+
+    public void testVisitCartesianShape() {
+        for (int i = 0; i < 1000; i++) {
+            var geometry = ShapeTestUtils.randomGeometryWithoutCircle(0, false);
+            var bbox = SpatialEnvelopeVisitor.visitCartesian(geometry);
+            assertNotNull(bbox);
+            assertTrue(i + ": " + geometry, bbox.isPresent());
+            var result = bbox.get();
+            assertThat(i + ": " + geometry, result.getMinX(), lessThanOrEqualTo(result.getMaxX()));
+            assertThat(i + ": " + geometry, result.getMinY(), lessThanOrEqualTo(result.getMaxY()));
+        }
+    }
+
+    public void testVisitGeoShapeNoWrap() {
+        for (int i = 0; i < 1000; i++) {
+            var geometry = GeometryTestUtils.randomGeometryWithoutCircle(0, false);
+            var bbox = SpatialEnvelopeVisitor.visitGeo(geometry, false);
+            assertNotNull(bbox);
+            assertTrue(i + ": " + geometry, bbox.isPresent());
+            var result = bbox.get();
+            assertThat(i + ": " + geometry, result.getMinX(), lessThanOrEqualTo(result.getMaxX()));
+            assertThat(i + ": " + geometry, result.getMinY(), lessThanOrEqualTo(result.getMaxY()));
+        }
+    }
+
+    public void testVisitGeoShapeWrap() {
+        for (int i = 0; i < 1000; i++) {
+            var geometry = GeometryTestUtils.randomGeometryWithoutCircle(0, true);
+            var bbox = SpatialEnvelopeVisitor.visitGeo(geometry, false);
+            assertNotNull(bbox);
+            assertTrue(i + ": " + geometry, bbox.isPresent());
+            var result = bbox.get();
+            assertThat(i + ": " + geometry, result.getMinX(), lessThanOrEqualTo(result.getMaxX()));
+            assertThat(i + ": " + geometry, result.getMinY(), lessThanOrEqualTo(result.getMaxY()));
+        }
+    }
+
+    public void testVisitCartesianPoints() {
+        var visitor = new SpatialEnvelopeVisitor(new SpatialEnvelopeVisitor.CartesianPointVisitor());
+        double minX = Double.MAX_VALUE;
+        double minY = Double.MAX_VALUE;
+        double maxX = -Double.MAX_VALUE;
+        double maxY = -Double.MAX_VALUE;
+        for (int i = 0; i < 1000; i++) {
+            var x = randomFloat();
+            var y = randomFloat();
+            var point = new Point(x, y);
+            visitor.visit(point);
+            minX = Math.min(minX, x);
+            minY = Math.min(minY, y);
+            maxX = Math.max(maxX, x);
+            maxY = Math.max(maxY, y);
+            var result = visitor.getResult();
+            assertThat(i + ": " + point, result.getMinX(), equalTo(minX));
+            assertThat(i + ": " + point, result.getMinY(), equalTo(minY));
+            assertThat(i + ": " + point, result.getMaxX(), equalTo(maxX));
+            assertThat(i + ": " + point, result.getMaxY(), equalTo(maxY));
+        }
+    }
+
+    public void testVisitGeoPointsNoWrapping() {
+        var visitor = new SpatialEnvelopeVisitor(new SpatialEnvelopeVisitor.GeoPointVisitor(false));
+        double minY = Double.MAX_VALUE;
+        double maxY = -Double.MAX_VALUE;
+        double minX = Double.MAX_VALUE;
+        double maxX = -Double.MAX_VALUE;
+        for (int i = 0; i < 1000; i++) {
+            var point = GeometryTestUtils.randomPoint();
+            visitor.visit(point);
+            minY = Math.min(minY, point.getY());
+            maxY = Math.max(maxY, point.getY());
+            minX = Math.min(minX, point.getX());
+            maxX = Math.max(maxX, point.getX());
+            var result = visitor.getResult();
+            assertThat(i + ": " + point, result.getMinX(), lessThanOrEqualTo(result.getMaxX()));
+            assertThat(i + ": " + point, result.getMinX(), equalTo(minX));
+            assertThat(i + ": " + point, result.getMinY(), equalTo(minY));
+            assertThat(i + ": " + point, result.getMaxX(), equalTo(maxX));
+            assertThat(i + ": " + point, result.getMaxY(), equalTo(maxY));
+        }
+    }
+
+    public void testVisitGeoPointsWrapping() {
+        var visitor = new SpatialEnvelopeVisitor(new SpatialEnvelopeVisitor.GeoPointVisitor(true));
+        double minY = Double.POSITIVE_INFINITY;
+        double maxY = Double.NEGATIVE_INFINITY;
+        double minNegX = Double.POSITIVE_INFINITY;
+        double maxNegX = Double.NEGATIVE_INFINITY;
+        double minPosX = Double.POSITIVE_INFINITY;
+        double maxPosX = Double.NEGATIVE_INFINITY;
+        for (int i = 0; i < 1000; i++) {
+            var point = GeometryTestUtils.randomPoint();
+            visitor.visit(point);
+            minY = Math.min(minY, point.getY());
+            maxY = Math.max(maxY, point.getY());
+            if (point.getX() >= 0) {
+                minPosX = Math.min(minPosX, point.getX());
+                maxPosX = Math.max(maxPosX, point.getX());
+            } else {
+                minNegX = Math.min(minNegX, point.getX());
+                maxNegX = Math.max(maxNegX, point.getX());
+            }
+            var result = visitor.getResult();
+            if (Double.isInfinite(minPosX)) {
+                // Only negative x values were considered
+                assertRectangleResult(i + ": " + point, result, minNegX, maxNegX, maxY, minY, false);
+            } else if (Double.isInfinite(minNegX)) {
+                // Only positive x values were considered
+                assertRectangleResult(i + ": " + point, result, minPosX, maxPosX, maxY, minY, false);
+            } else {
+                // Both positive and negative x values exist, we need to decide which way to wrap the bbox
+                double unwrappedWidth = maxPosX - minNegX;
+                double wrappedWidth = (180 - minPosX) - (-180 - maxNegX);
+                if (unwrappedWidth <= wrappedWidth) {
+                    // The smaller bbox is around the front of the planet, no dateline wrapping required
+                    assertRectangleResult(i + ": " + point, result, minNegX, maxPosX, maxY, minY, false);
+                } else {
+                    // The smaller bbox is around the back of the planet, dateline wrapping required (minx > maxx)
+                    assertRectangleResult(i + ": " + point, result, minPosX, maxNegX, maxY, minY, true);
+                }
+            }
+        }
+    }
+
+    public void testWillCrossDateline() {
+        var visitor = new SpatialEnvelopeVisitor(new SpatialEnvelopeVisitor.GeoPointVisitor(true));
+        visitor.visit(new Point(-90.0, 0.0));
+        visitor.visit(new Point(90.0, 0.0));
+        assertCrossesDateline(visitor, false);
+        visitor.visit(new Point(-89.0, 0.0));
+        visitor.visit(new Point(89.0, 0.0));
+        assertCrossesDateline(visitor, false);
+        visitor.visit(new Point(-100.0, 0.0));
+        visitor.visit(new Point(100.0, 0.0));
+        assertCrossesDateline(visitor, true);
+        visitor.visit(new Point(-70.0, 0.0));
+        visitor.visit(new Point(70.0, 0.0));
+        assertCrossesDateline(visitor, false);
+        visitor.visit(new Point(-120.0, 0.0));
+        visitor.visit(new Point(120.0, 0.0));
+        assertCrossesDateline(visitor, true);
+    }
+
+    private void assertCrossesDateline(SpatialEnvelopeVisitor visitor, boolean crossesDateline) {
+        var result = visitor.getResult();
+        if (crossesDateline) {
+            assertThat("Crosses dateline, minx>maxx", result.getMinX(), greaterThanOrEqualTo(result.getMaxX()));
+        } else {
+            assertThat("Does not cross dateline, minx<maxx", result.getMinX(), lessThanOrEqualTo(result.getMaxX()));
+        }
+    }
+
+    private void assertRectangleResult(
+        String s,
+        Rectangle result,
+        double minX,
+        double maxX,
+        double maxY,
+        double minY,
+        boolean crossesDateline
+    ) {
+        if (crossesDateline) {
+            assertThat(s, result.getMinX(), greaterThanOrEqualTo(result.getMaxX()));
+        } else {
+            assertThat(s, result.getMinX(), lessThanOrEqualTo(result.getMaxX()));
+        }
+        assertThat(s, result.getMinX(), equalTo(minX));
+        assertThat(s, result.getMaxX(), equalTo(maxX));
+        assertThat(s, result.getMaxY(), equalTo(maxY));
+        assertThat(s, result.getMinY(), equalTo(minY));
+    }
+}
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/spatial_shapes.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/spatial_shapes.csv-spec
index dd092130c3406..609aa20798edf 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/spatial_shapes.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/spatial_shapes.csv-spec
@@ -318,6 +318,47 @@ wkt:keyword                               |pt:geo_shape
 "POINT(111)"                              |null
 ;
 
+###############################################
+# Tests for GEO_SHAPE type with ST_ENVELOPE, ST_XMIN, etc.
+#
+
+polygonEnvelope
+required_capability: st_envelope
+
+// tag::st_envelope[]
+FROM airport_city_boundaries
+| WHERE abbrev == "CPH"
+| EVAL envelope = ST_ENVELOPE(city_boundary)
+| KEEP abbrev, airport, envelope
+// end::st_envelope[]
+| LIMIT 1
+;
+
+// tag::st_envelope-result[]
+abbrev:keyword | airport:text  | envelope:geo_shape
+CPH            |  Copenhagen   | BBOX(12.453, 12.6398, 55.7327, 55.6318)
+// end::st_envelope-result[]
+;
+
+polygonEnvelopeXYMinMax
+required_capability: st_envelope
+
+// tag::st_x_y_min_max[]
+FROM airport_city_boundaries
+| WHERE abbrev == "CPH"
+| EVAL envelope = ST_ENVELOPE(city_boundary)
+| EVAL xmin = ST_XMIN(envelope), xmax = ST_XMAX(envelope), ymin = ST_YMIN(envelope), ymax = ST_YMAX(envelope)
+| KEEP abbrev, airport, xmin, xmax, ymin, ymax
+// end::st_x_y_min_max[]
+| LIMIT 1
+;
+
+// tag::st_x_y_min_max-result[]
+abbrev:keyword | airport:text  | xmin:double | xmax:double | ymin:double | ymax:double 
+CPH            |  Copenhagen   | 12.453      | 12.6398     | 55.6318     | 55.7327
+// end::st_x_y_min_max-result[]
+;
+
 ###############################################
 # Tests for CARTESIAN_SHAPE type
 #
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StEnvelopeFromWKBEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StEnvelopeFromWKBEvaluator.java
new file mode 100644
index 0000000000000..3d6dc7277080a
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StEnvelopeFromWKBEvaluator.java
@@ -0,0 +1,126 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BytesRefBlock;
+import org.elasticsearch.compute.data.BytesRefVector;
+import org.elasticsearch.compute.data.Vector;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.function.scalar.convert.AbstractConvertFunction;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link StEnvelope}.
+ * This class is generated. Do not edit it.
+ */
+public final class StEnvelopeFromWKBEvaluator extends AbstractConvertFunction.AbstractEvaluator {
+  public StEnvelopeFromWKBEvaluator(EvalOperator.ExpressionEvaluator field, Source source,
+      DriverContext driverContext) {
+    super(driverContext, field, source);
+  }
+
+  @Override
+  public String name() {
+    return "StEnvelopeFromWKB";
+  }
+
+  @Override
+  public Block evalVector(Vector v) {
+    BytesRefVector vector = (BytesRefVector) v;
+    int positionCount = v.getPositionCount();
+    BytesRef scratchPad = new BytesRef();
+    if (vector.isConstant()) {
+      try {
+        return driverContext.blockFactory().newConstantBytesRefBlockWith(evalValue(vector, 0, scratchPad), positionCount);
+      } catch (IllegalArgumentException  e) {
+        registerException(e);
+        return driverContext.blockFactory().newConstantNullBlock(positionCount);
+      }
+    }
+    try (BytesRefBlock.Builder builder = driverContext.blockFactory().newBytesRefBlockBuilder(positionCount)) {
+      for (int p = 0; p < positionCount; p++) {
+        try {
+          builder.appendBytesRef(evalValue(vector, p, scratchPad));
+        } catch (IllegalArgumentException  e) {
+          registerException(e);
+          builder.appendNull();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static BytesRef evalValue(BytesRefVector container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StEnvelope.fromWellKnownBinary(value);
+  }
+
+  @Override
+  public Block evalBlock(Block b) {
+    BytesRefBlock block = (BytesRefBlock) b;
+    int positionCount = block.getPositionCount();
+    try (BytesRefBlock.Builder builder = driverContext.blockFactory().newBytesRefBlockBuilder(positionCount)) {
+      BytesRef scratchPad = new BytesRef();
+      for (int p = 0; p < positionCount; p++) {
+        int valueCount = block.getValueCount(p);
+        int start = block.getFirstValueIndex(p);
+        int end = start + valueCount;
+        boolean positionOpened = false;
+        boolean valuesAppended = false;
+        for (int i = start; i < end; i++) {
+          try {
+            BytesRef value = evalValue(block, i, scratchPad);
+            if (positionOpened == false && valueCount > 1) {
+              builder.beginPositionEntry();
+              positionOpened = true;
+            }
+            builder.appendBytesRef(value);
+            valuesAppended = true;
+          } catch (IllegalArgumentException  e) {
+            registerException(e);
+          }
+        }
+        if (valuesAppended == false) {
+          builder.appendNull();
+        } else if (positionOpened) {
+          builder.endPositionEntry();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static BytesRef evalValue(BytesRefBlock container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StEnvelope.fromWellKnownBinary(value);
+  }
+
+  public static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory field;
+
+    public Factory(EvalOperator.ExpressionEvaluator.Factory field, Source source) {
+      this.field = field;
+      this.source = source;
+    }
+
+    @Override
+    public StEnvelopeFromWKBEvaluator get(DriverContext context) {
+      return new StEnvelopeFromWKBEvaluator(field.get(context), source, context);
+    }
+
+    @Override
+    public String toString() {
+      return "StEnvelopeFromWKBEvaluator[field=" + field + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StEnvelopeFromWKBGeoEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StEnvelopeFromWKBGeoEvaluator.java
new file mode 100644
index 0000000000000..c61e825c0ee71
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StEnvelopeFromWKBGeoEvaluator.java
@@ -0,0 +1,126 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BytesRefBlock;
+import org.elasticsearch.compute.data.BytesRefVector;
+import org.elasticsearch.compute.data.Vector;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.function.scalar.convert.AbstractConvertFunction;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link StEnvelope}.
+ * This class is generated. Do not edit it.
+ */
+public final class StEnvelopeFromWKBGeoEvaluator extends AbstractConvertFunction.AbstractEvaluator {
+  public StEnvelopeFromWKBGeoEvaluator(EvalOperator.ExpressionEvaluator field, Source source,
+      DriverContext driverContext) {
+    super(driverContext, field, source);
+  }
+
+  @Override
+  public String name() {
+    return "StEnvelopeFromWKBGeo";
+  }
+
+  @Override
+  public Block evalVector(Vector v) {
+    BytesRefVector vector = (BytesRefVector) v;
+    int positionCount = v.getPositionCount();
+    BytesRef scratchPad = new BytesRef();
+    if (vector.isConstant()) {
+      try {
+        return driverContext.blockFactory().newConstantBytesRefBlockWith(evalValue(vector, 0, scratchPad), positionCount);
+      } catch (IllegalArgumentException  e) {
+        registerException(e);
+        return driverContext.blockFactory().newConstantNullBlock(positionCount);
+      }
+    }
+    try (BytesRefBlock.Builder builder = driverContext.blockFactory().newBytesRefBlockBuilder(positionCount)) {
+      for (int p = 0; p < positionCount; p++) {
+        try {
+          builder.appendBytesRef(evalValue(vector, p, scratchPad));
+        } catch (IllegalArgumentException  e) {
+          registerException(e);
+          builder.appendNull();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static BytesRef evalValue(BytesRefVector container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StEnvelope.fromWellKnownBinaryGeo(value);
+  }
+
+  @Override
+  public Block evalBlock(Block b) {
+    BytesRefBlock block = (BytesRefBlock) b;
+    int positionCount = block.getPositionCount();
+    try (BytesRefBlock.Builder builder = driverContext.blockFactory().newBytesRefBlockBuilder(positionCount)) {
+      BytesRef scratchPad = new BytesRef();
+      for (int p = 0; p < positionCount; p++) {
+        int valueCount = block.getValueCount(p);
+        int start = block.getFirstValueIndex(p);
+        int end = start + valueCount;
+        boolean positionOpened = false;
+        boolean valuesAppended = false;
+        for (int i = start; i < end; i++) {
+          try {
+            BytesRef value = evalValue(block, i, scratchPad);
+            if (positionOpened == false && valueCount > 1) {
+              builder.beginPositionEntry();
+              positionOpened = true;
+            }
+            builder.appendBytesRef(value);
+            valuesAppended = true;
+          } catch (IllegalArgumentException  e) {
+            registerException(e);
+          }
+        }
+        if (valuesAppended == false) {
+          builder.appendNull();
+        } else if (positionOpened) {
+          builder.endPositionEntry();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static BytesRef evalValue(BytesRefBlock container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StEnvelope.fromWellKnownBinaryGeo(value);
+  }
+
+  public static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory field;
+
+    public Factory(EvalOperator.ExpressionEvaluator.Factory field, Source source) {
+      this.field = field;
+      this.source = source;
+    }
+
+    @Override
+    public StEnvelopeFromWKBGeoEvaluator get(DriverContext context) {
+      return new StEnvelopeFromWKBGeoEvaluator(field.get(context), source, context);
+    }
+
+    @Override
+    public String toString() {
+      return "StEnvelopeFromWKBGeoEvaluator[field=" + field + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMaxFromWKBEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMaxFromWKBEvaluator.java
new file mode 100644
index 0000000000000..0d51ef709c217
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMaxFromWKBEvaluator.java
@@ -0,0 +1,127 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BytesRefBlock;
+import org.elasticsearch.compute.data.BytesRefVector;
+import org.elasticsearch.compute.data.DoubleBlock;
+import org.elasticsearch.compute.data.Vector;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.function.scalar.convert.AbstractConvertFunction;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link StXMax}.
+ * This class is generated. Do not edit it.
+ */
+public final class StXMaxFromWKBEvaluator extends AbstractConvertFunction.AbstractEvaluator {
+  public StXMaxFromWKBEvaluator(EvalOperator.ExpressionEvaluator field, Source source,
+      DriverContext driverContext) {
+    super(driverContext, field, source);
+  }
+
+  @Override
+  public String name() {
+    return "StXMaxFromWKB";
+  }
+
+  @Override
+  public Block evalVector(Vector v) {
+    BytesRefVector vector = (BytesRefVector) v;
+    int positionCount = v.getPositionCount();
+    BytesRef scratchPad = new BytesRef();
+    if (vector.isConstant()) {
+      try {
+        return driverContext.blockFactory().newConstantDoubleBlockWith(evalValue(vector, 0, scratchPad), positionCount);
+      } catch (IllegalArgumentException  e) {
+        registerException(e);
+        return driverContext.blockFactory().newConstantNullBlock(positionCount);
+      }
+    }
+    try (DoubleBlock.Builder builder = driverContext.blockFactory().newDoubleBlockBuilder(positionCount)) {
+      for (int p = 0; p < positionCount; p++) {
+        try {
+          builder.appendDouble(evalValue(vector, p, scratchPad));
+        } catch (IllegalArgumentException  e) {
+          registerException(e);
+          builder.appendNull();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static double evalValue(BytesRefVector container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StXMax.fromWellKnownBinary(value);
+  }
+
+  @Override
+  public Block evalBlock(Block b) {
+    BytesRefBlock block = (BytesRefBlock) b;
+    int positionCount = block.getPositionCount();
+    try (DoubleBlock.Builder builder = driverContext.blockFactory().newDoubleBlockBuilder(positionCount)) {
+      BytesRef scratchPad = new BytesRef();
+      for (int p = 0; p < positionCount; p++) {
+        int valueCount = block.getValueCount(p);
+        int start = block.getFirstValueIndex(p);
+        int end = start + valueCount;
+        boolean positionOpened = false;
+        boolean valuesAppended = false;
+        for (int i = start; i < end; i++) {
+          try {
+            double value = evalValue(block, i, scratchPad);
+            if (positionOpened == false && valueCount > 1) {
+              builder.beginPositionEntry();
+              positionOpened = true;
+            }
+            builder.appendDouble(value);
+            valuesAppended = true;
+          } catch (IllegalArgumentException  e) {
+            registerException(e);
+          }
+        }
+        if (valuesAppended == false) {
+          builder.appendNull();
+        } else if (positionOpened) {
+          builder.endPositionEntry();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static double evalValue(BytesRefBlock container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StXMax.fromWellKnownBinary(value);
+  }
+
+  public static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory field;
+
+    public Factory(EvalOperator.ExpressionEvaluator.Factory field, Source source) {
+      this.field = field;
+      this.source = source;
+    }
+
+    @Override
+    public StXMaxFromWKBEvaluator get(DriverContext context) {
+      return new StXMaxFromWKBEvaluator(field.get(context), source, context);
+    }
+
+    @Override
+    public String toString() {
+      return "StXMaxFromWKBEvaluator[field=" + field + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMaxFromWKBGeoEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMaxFromWKBGeoEvaluator.java
new file mode 100644
index 0000000000000..3707bf421d550
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMaxFromWKBGeoEvaluator.java
@@ -0,0 +1,127 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BytesRefBlock;
+import org.elasticsearch.compute.data.BytesRefVector;
+import org.elasticsearch.compute.data.DoubleBlock;
+import org.elasticsearch.compute.data.Vector;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.function.scalar.convert.AbstractConvertFunction;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link StXMax}.
+ * This class is generated. Do not edit it.
+ */
+public final class StXMaxFromWKBGeoEvaluator extends AbstractConvertFunction.AbstractEvaluator {
+  public StXMaxFromWKBGeoEvaluator(EvalOperator.ExpressionEvaluator field, Source source,
+      DriverContext driverContext) {
+    super(driverContext, field, source);
+  }
+
+  @Override
+  public String name() {
+    return "StXMaxFromWKBGeo";
+  }
+
+  @Override
+  public Block evalVector(Vector v) {
+    BytesRefVector vector = (BytesRefVector) v;
+    int positionCount = v.getPositionCount();
+    BytesRef scratchPad = new BytesRef();
+    if (vector.isConstant()) {
+      try {
+        return driverContext.blockFactory().newConstantDoubleBlockWith(evalValue(vector, 0, scratchPad), positionCount);
+      } catch (IllegalArgumentException  e) {
+        registerException(e);
+        return driverContext.blockFactory().newConstantNullBlock(positionCount);
+      }
+    }
+    try (DoubleBlock.Builder builder = driverContext.blockFactory().newDoubleBlockBuilder(positionCount)) {
+      for (int p = 0; p < positionCount; p++) {
+        try {
+          builder.appendDouble(evalValue(vector, p, scratchPad));
+        } catch (IllegalArgumentException  e) {
+          registerException(e);
+          builder.appendNull();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static double evalValue(BytesRefVector container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StXMax.fromWellKnownBinaryGeo(value);
+  }
+
+  @Override
+  public Block evalBlock(Block b) {
+    BytesRefBlock block = (BytesRefBlock) b;
+    int positionCount = block.getPositionCount();
+    try (DoubleBlock.Builder builder = driverContext.blockFactory().newDoubleBlockBuilder(positionCount)) {
+      BytesRef scratchPad = new BytesRef();
+      for (int p = 0; p < positionCount; p++) {
+        int valueCount = block.getValueCount(p);
+        int start = block.getFirstValueIndex(p);
+        int end = start + valueCount;
+        boolean positionOpened = false;
+        boolean valuesAppended = false;
+        for (int i = start; i < end; i++) {
+          try {
+            double value = evalValue(block, i, scratchPad);
+            if (positionOpened == false && valueCount > 1) {
+              builder.beginPositionEntry();
+              positionOpened = true;
+            }
+            builder.appendDouble(value);
+            valuesAppended = true;
+          } catch (IllegalArgumentException  e) {
+            registerException(e);
+          }
+        }
+        if (valuesAppended == false) {
+          builder.appendNull();
+        } else if (positionOpened) {
+          builder.endPositionEntry();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static double evalValue(BytesRefBlock container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StXMax.fromWellKnownBinaryGeo(value);
+  }
+
+  public static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory field;
+
+    public Factory(EvalOperator.ExpressionEvaluator.Factory field, Source source) {
+      this.field = field;
+      this.source = source;
+    }
+
+    @Override
+    public StXMaxFromWKBGeoEvaluator get(DriverContext context) {
+      return new StXMaxFromWKBGeoEvaluator(field.get(context), source, context);
+    }
+
+    @Override
+    public String toString() {
+      return "StXMaxFromWKBGeoEvaluator[field=" + field + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMinFromWKBEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMinFromWKBEvaluator.java
new file mode 100644
index 0000000000000..699402ad68dee
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMinFromWKBEvaluator.java
@@ -0,0 +1,127 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BytesRefBlock;
+import org.elasticsearch.compute.data.BytesRefVector;
+import org.elasticsearch.compute.data.DoubleBlock;
+import org.elasticsearch.compute.data.Vector;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.function.scalar.convert.AbstractConvertFunction;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link StXMin}.
+ * This class is generated. Do not edit it.
+ */
+public final class StXMinFromWKBEvaluator extends AbstractConvertFunction.AbstractEvaluator {
+  public StXMinFromWKBEvaluator(EvalOperator.ExpressionEvaluator field, Source source,
+      DriverContext driverContext) {
+    super(driverContext, field, source);
+  }
+
+  @Override
+  public String name() {
+    return "StXMinFromWKB";
+  }
+
+  @Override
+  public Block evalVector(Vector v) {
+    BytesRefVector vector = (BytesRefVector) v;
+    int positionCount = v.getPositionCount();
+    BytesRef scratchPad = new BytesRef();
+    if (vector.isConstant()) {
+      try {
+        return driverContext.blockFactory().newConstantDoubleBlockWith(evalValue(vector, 0, scratchPad), positionCount);
+      } catch (IllegalArgumentException  e) {
+        registerException(e);
+        return driverContext.blockFactory().newConstantNullBlock(positionCount);
+      }
+    }
+    try (DoubleBlock.Builder builder = driverContext.blockFactory().newDoubleBlockBuilder(positionCount)) {
+      for (int p = 0; p < positionCount; p++) {
+        try {
+          builder.appendDouble(evalValue(vector, p, scratchPad));
+        } catch (IllegalArgumentException  e) {
+          registerException(e);
+          builder.appendNull();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static double evalValue(BytesRefVector container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StXMin.fromWellKnownBinary(value);
+  }
+
+  @Override
+  public Block evalBlock(Block b) {
+    BytesRefBlock block = (BytesRefBlock) b;
+    int positionCount = block.getPositionCount();
+    try (DoubleBlock.Builder builder = driverContext.blockFactory().newDoubleBlockBuilder(positionCount)) {
+      BytesRef scratchPad = new BytesRef();
+      for (int p = 0; p < positionCount; p++) {
+        int valueCount = block.getValueCount(p);
+        int start = block.getFirstValueIndex(p);
+        int end = start + valueCount;
+        boolean positionOpened = false;
+        boolean valuesAppended = false;
+        for (int i = start; i < end; i++) {
+          try {
+            double value = evalValue(block, i, scratchPad);
+            if (positionOpened == false && valueCount > 1) {
+              builder.beginPositionEntry();
+              positionOpened = true;
+            }
+            builder.appendDouble(value);
+            valuesAppended = true;
+          } catch (IllegalArgumentException  e) {
+            registerException(e);
+          }
+        }
+        if (valuesAppended == false) {
+          builder.appendNull();
+        } else if (positionOpened) {
+          builder.endPositionEntry();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static double evalValue(BytesRefBlock container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StXMin.fromWellKnownBinary(value);
+  }
+
+  public static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory field;
+
+    public Factory(EvalOperator.ExpressionEvaluator.Factory field, Source source) {
+      this.field = field;
+      this.source = source;
+    }
+
+    @Override
+    public StXMinFromWKBEvaluator get(DriverContext context) {
+      return new StXMinFromWKBEvaluator(field.get(context), source, context);
+    }
+
+    @Override
+    public String toString() {
+      return "StXMinFromWKBEvaluator[field=" + field + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMinFromWKBGeoEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMinFromWKBGeoEvaluator.java
new file mode 100644
index 0000000000000..6a8c041595c1c
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMinFromWKBGeoEvaluator.java
@@ -0,0 +1,127 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BytesRefBlock;
+import org.elasticsearch.compute.data.BytesRefVector;
+import org.elasticsearch.compute.data.DoubleBlock;
+import org.elasticsearch.compute.data.Vector;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.function.scalar.convert.AbstractConvertFunction;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link StXMin}.
+ * This class is generated. Do not edit it.
+ */
+public final class StXMinFromWKBGeoEvaluator extends AbstractConvertFunction.AbstractEvaluator {
+  public StXMinFromWKBGeoEvaluator(EvalOperator.ExpressionEvaluator field, Source source,
+      DriverContext driverContext) {
+    super(driverContext, field, source);
+  }
+
+  @Override
+  public String name() {
+    return "StXMinFromWKBGeo";
+  }
+
+  @Override
+  public Block evalVector(Vector v) {
+    BytesRefVector vector = (BytesRefVector) v;
+    int positionCount = v.getPositionCount();
+    BytesRef scratchPad = new BytesRef();
+    if (vector.isConstant()) {
+      try {
+        return driverContext.blockFactory().newConstantDoubleBlockWith(evalValue(vector, 0, scratchPad), positionCount);
+      } catch (IllegalArgumentException  e) {
+        registerException(e);
+        return driverContext.blockFactory().newConstantNullBlock(positionCount);
+      }
+    }
+    try (DoubleBlock.Builder builder = driverContext.blockFactory().newDoubleBlockBuilder(positionCount)) {
+      for (int p = 0; p < positionCount; p++) {
+        try {
+          builder.appendDouble(evalValue(vector, p, scratchPad));
+        } catch (IllegalArgumentException  e) {
+          registerException(e);
+          builder.appendNull();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static double evalValue(BytesRefVector container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StXMin.fromWellKnownBinaryGeo(value);
+  }
+
+  @Override
+  public Block evalBlock(Block b) {
+    BytesRefBlock block = (BytesRefBlock) b;
+    int positionCount = block.getPositionCount();
+    try (DoubleBlock.Builder builder = driverContext.blockFactory().newDoubleBlockBuilder(positionCount)) {
+      BytesRef scratchPad = new BytesRef();
+      for (int p = 0; p < positionCount; p++) {
+        int valueCount = block.getValueCount(p);
+        int start = block.getFirstValueIndex(p);
+        int end = start + valueCount;
+        boolean positionOpened = false;
+        boolean valuesAppended = false;
+        for (int i = start; i < end; i++) {
+          try {
+            double value = evalValue(block, i, scratchPad);
+            if (positionOpened == false && valueCount > 1) {
+              builder.beginPositionEntry();
+              positionOpened = true;
+            }
+            builder.appendDouble(value);
+            valuesAppended = true;
+          } catch (IllegalArgumentException  e) {
+            registerException(e);
+          }
+        }
+        if (valuesAppended == false) {
+          builder.appendNull();
+        } else if (positionOpened) {
+          builder.endPositionEntry();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static double evalValue(BytesRefBlock container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StXMin.fromWellKnownBinaryGeo(value);
+  }
+
+  public static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory field;
+
+    public Factory(EvalOperator.ExpressionEvaluator.Factory field, Source source) {
+      this.field = field;
+      this.source = source;
+    }
+
+    @Override
+    public StXMinFromWKBGeoEvaluator get(DriverContext context) {
+      return new StXMinFromWKBGeoEvaluator(field.get(context), source, context);
+    }
+
+    @Override
+    public String toString() {
+      return "StXMinFromWKBGeoEvaluator[field=" + field + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMaxFromWKBEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMaxFromWKBEvaluator.java
new file mode 100644
index 0000000000000..e8b50099f38f6
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMaxFromWKBEvaluator.java
@@ -0,0 +1,127 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BytesRefBlock;
+import org.elasticsearch.compute.data.BytesRefVector;
+import org.elasticsearch.compute.data.DoubleBlock;
+import org.elasticsearch.compute.data.Vector;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.function.scalar.convert.AbstractConvertFunction;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link StYMax}.
+ * This class is generated. Do not edit it.
+ */
+public final class StYMaxFromWKBEvaluator extends AbstractConvertFunction.AbstractEvaluator {
+  public StYMaxFromWKBEvaluator(EvalOperator.ExpressionEvaluator field, Source source,
+      DriverContext driverContext) {
+    super(driverContext, field, source);
+  }
+
+  @Override
+  public String name() {
+    return "StYMaxFromWKB";
+  }
+
+  @Override
+  public Block evalVector(Vector v) {
+    BytesRefVector vector = (BytesRefVector) v;
+    int positionCount = v.getPositionCount();
+    BytesRef scratchPad = new BytesRef();
+    if (vector.isConstant()) {
+      try {
+        return driverContext.blockFactory().newConstantDoubleBlockWith(evalValue(vector, 0, scratchPad), positionCount);
+      } catch (IllegalArgumentException  e) {
+        registerException(e);
+        return driverContext.blockFactory().newConstantNullBlock(positionCount);
+      }
+    }
+    try (DoubleBlock.Builder builder = driverContext.blockFactory().newDoubleBlockBuilder(positionCount)) {
+      for (int p = 0; p < positionCount; p++) {
+        try {
+          builder.appendDouble(evalValue(vector, p, scratchPad));
+        } catch (IllegalArgumentException  e) {
+          registerException(e);
+          builder.appendNull();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static double evalValue(BytesRefVector container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StYMax.fromWellKnownBinary(value);
+  }
+
+  @Override
+  public Block evalBlock(Block b) {
+    BytesRefBlock block = (BytesRefBlock) b;
+    int positionCount = block.getPositionCount();
+    try (DoubleBlock.Builder builder = driverContext.blockFactory().newDoubleBlockBuilder(positionCount)) {
+      BytesRef scratchPad = new BytesRef();
+      for (int p = 0; p < positionCount; p++) {
+        int valueCount = block.getValueCount(p);
+        int start = block.getFirstValueIndex(p);
+        int end = start + valueCount;
+        boolean positionOpened = false;
+        boolean valuesAppended = false;
+        for (int i = start; i < end; i++) {
+          try {
+            double value = evalValue(block, i, scratchPad);
+            if (positionOpened == false && valueCount > 1) {
+              builder.beginPositionEntry();
+              positionOpened = true;
+            }
+            builder.appendDouble(value);
+            valuesAppended = true;
+          } catch (IllegalArgumentException  e) {
+            registerException(e);
+          }
+        }
+        if (valuesAppended == false) {
+          builder.appendNull();
+        } else if (positionOpened) {
+          builder.endPositionEntry();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static double evalValue(BytesRefBlock container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StYMax.fromWellKnownBinary(value);
+  }
+
+  public static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory field;
+
+    public Factory(EvalOperator.ExpressionEvaluator.Factory field, Source source) {
+      this.field = field;
+      this.source = source;
+    }
+
+    @Override
+    public StYMaxFromWKBEvaluator get(DriverContext context) {
+      return new StYMaxFromWKBEvaluator(field.get(context), source, context);
+    }
+
+    @Override
+    public String toString() {
+      return "StYMaxFromWKBEvaluator[field=" + field + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMaxFromWKBGeoEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMaxFromWKBGeoEvaluator.java
new file mode 100644
index 0000000000000..00e75f862a86c
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMaxFromWKBGeoEvaluator.java
@@ -0,0 +1,127 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BytesRefBlock;
+import org.elasticsearch.compute.data.BytesRefVector;
+import org.elasticsearch.compute.data.DoubleBlock;
+import org.elasticsearch.compute.data.Vector;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.function.scalar.convert.AbstractConvertFunction;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link StYMax}.
+ * This class is generated. Do not edit it.
+ */
+public final class StYMaxFromWKBGeoEvaluator extends AbstractConvertFunction.AbstractEvaluator {
+  public StYMaxFromWKBGeoEvaluator(EvalOperator.ExpressionEvaluator field, Source source,
+      DriverContext driverContext) {
+    super(driverContext, field, source);
+  }
+
+  @Override
+  public String name() {
+    return "StYMaxFromWKBGeo";
+  }
+
+  @Override
+  public Block evalVector(Vector v) {
+    BytesRefVector vector = (BytesRefVector) v;
+    int positionCount = v.getPositionCount();
+    BytesRef scratchPad = new BytesRef();
+    if (vector.isConstant()) {
+      try {
+        return driverContext.blockFactory().newConstantDoubleBlockWith(evalValue(vector, 0, scratchPad), positionCount);
+      } catch (IllegalArgumentException  e) {
+        registerException(e);
+        return driverContext.blockFactory().newConstantNullBlock(positionCount);
+      }
+    }
+    try (DoubleBlock.Builder builder = driverContext.blockFactory().newDoubleBlockBuilder(positionCount)) {
+      for (int p = 0; p < positionCount; p++) {
+        try {
+          builder.appendDouble(evalValue(vector, p, scratchPad));
+        } catch (IllegalArgumentException  e) {
+          registerException(e);
+          builder.appendNull();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static double evalValue(BytesRefVector container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StYMax.fromWellKnownBinaryGeo(value);
+  }
+
+  @Override
+  public Block evalBlock(Block b) {
+    BytesRefBlock block = (BytesRefBlock) b;
+    int positionCount = block.getPositionCount();
+    try (DoubleBlock.Builder builder = driverContext.blockFactory().newDoubleBlockBuilder(positionCount)) {
+      BytesRef scratchPad = new BytesRef();
+      for (int p = 0; p < positionCount; p++) {
+        int valueCount = block.getValueCount(p);
+        int start = block.getFirstValueIndex(p);
+        int end = start + valueCount;
+        boolean positionOpened = false;
+        boolean valuesAppended = false;
+        for (int i = start; i < end; i++) {
+          try {
+            double value = evalValue(block, i, scratchPad);
+            if (positionOpened == false && valueCount > 1) {
+              builder.beginPositionEntry();
+              positionOpened = true;
+            }
+            builder.appendDouble(value);
+            valuesAppended = true;
+          } catch (IllegalArgumentException  e) {
+            registerException(e);
+          }
+        }
+        if (valuesAppended == false) {
+          builder.appendNull();
+        } else if (positionOpened) {
+          builder.endPositionEntry();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static double evalValue(BytesRefBlock container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StYMax.fromWellKnownBinaryGeo(value);
+  }
+
+  public static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory field;
+
+    public Factory(EvalOperator.ExpressionEvaluator.Factory field, Source source) {
+      this.field = field;
+      this.source = source;
+    }
+
+    @Override
+    public StYMaxFromWKBGeoEvaluator get(DriverContext context) {
+      return new StYMaxFromWKBGeoEvaluator(field.get(context), source, context);
+    }
+
+    @Override
+    public String toString() {
+      return "StYMaxFromWKBGeoEvaluator[field=" + field + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMinFromWKBEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMinFromWKBEvaluator.java
new file mode 100644
index 0000000000000..cab66683261aa
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMinFromWKBEvaluator.java
@@ -0,0 +1,127 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BytesRefBlock;
+import org.elasticsearch.compute.data.BytesRefVector;
+import org.elasticsearch.compute.data.DoubleBlock;
+import org.elasticsearch.compute.data.Vector;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.function.scalar.convert.AbstractConvertFunction;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link StYMin}.
+ * This class is generated. Do not edit it.
+ */
+public final class StYMinFromWKBEvaluator extends AbstractConvertFunction.AbstractEvaluator {
+  public StYMinFromWKBEvaluator(EvalOperator.ExpressionEvaluator field, Source source,
+      DriverContext driverContext) {
+    super(driverContext, field, source);
+  }
+
+  @Override
+  public String name() {
+    return "StYMinFromWKB";
+  }
+
+  @Override
+  public Block evalVector(Vector v) {
+    BytesRefVector vector = (BytesRefVector) v;
+    int positionCount = v.getPositionCount();
+    BytesRef scratchPad = new BytesRef();
+    if (vector.isConstant()) {
+      try {
+        return driverContext.blockFactory().newConstantDoubleBlockWith(evalValue(vector, 0, scratchPad), positionCount);
+      } catch (IllegalArgumentException  e) {
+        registerException(e);
+        return driverContext.blockFactory().newConstantNullBlock(positionCount);
+      }
+    }
+    try (DoubleBlock.Builder builder = driverContext.blockFactory().newDoubleBlockBuilder(positionCount)) {
+      for (int p = 0; p < positionCount; p++) {
+        try {
+          builder.appendDouble(evalValue(vector, p, scratchPad));
+        } catch (IllegalArgumentException  e) {
+          registerException(e);
+          builder.appendNull();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static double evalValue(BytesRefVector container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StYMin.fromWellKnownBinary(value);
+  }
+
+  @Override
+  public Block evalBlock(Block b) {
+    BytesRefBlock block = (BytesRefBlock) b;
+    int positionCount = block.getPositionCount();
+    try (DoubleBlock.Builder builder = driverContext.blockFactory().newDoubleBlockBuilder(positionCount)) {
+      BytesRef scratchPad = new BytesRef();
+      for (int p = 0; p < positionCount; p++) {
+        int valueCount = block.getValueCount(p);
+        int start = block.getFirstValueIndex(p);
+        int end = start + valueCount;
+        boolean positionOpened = false;
+        boolean valuesAppended = false;
+        for (int i = start; i < end; i++) {
+          try {
+            double value = evalValue(block, i, scratchPad);
+            if (positionOpened == false && valueCount > 1) {
+              builder.beginPositionEntry();
+              positionOpened = true;
+            }
+            builder.appendDouble(value);
+            valuesAppended = true;
+          } catch (IllegalArgumentException  e) {
+            registerException(e);
+          }
+        }
+        if (valuesAppended == false) {
+          builder.appendNull();
+        } else if (positionOpened) {
+          builder.endPositionEntry();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static double evalValue(BytesRefBlock container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StYMin.fromWellKnownBinary(value);
+  }
+
+  public static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory field;
+
+    public Factory(EvalOperator.ExpressionEvaluator.Factory field, Source source) {
+      this.field = field;
+      this.source = source;
+    }
+
+    @Override
+    public StYMinFromWKBEvaluator get(DriverContext context) {
+      return new StYMinFromWKBEvaluator(field.get(context), source, context);
+    }
+
+    @Override
+    public String toString() {
+      return "StYMinFromWKBEvaluator[field=" + field + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMinFromWKBGeoEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMinFromWKBGeoEvaluator.java
new file mode 100644
index 0000000000000..8bae9d369fbb4
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMinFromWKBGeoEvaluator.java
@@ -0,0 +1,127 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BytesRefBlock;
+import org.elasticsearch.compute.data.BytesRefVector;
+import org.elasticsearch.compute.data.DoubleBlock;
+import org.elasticsearch.compute.data.Vector;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.function.scalar.convert.AbstractConvertFunction;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link StYMin}.
+ * This class is generated. Do not edit it.
+ */
+public final class StYMinFromWKBGeoEvaluator extends AbstractConvertFunction.AbstractEvaluator {
+  public StYMinFromWKBGeoEvaluator(EvalOperator.ExpressionEvaluator field, Source source,
+      DriverContext driverContext) {
+    super(driverContext, field, source);
+  }
+
+  @Override
+  public String name() {
+    return "StYMinFromWKBGeo";
+  }
+
+  @Override
+  public Block evalVector(Vector v) {
+    BytesRefVector vector = (BytesRefVector) v;
+    int positionCount = v.getPositionCount();
+    BytesRef scratchPad = new BytesRef();
+    if (vector.isConstant()) {
+      try {
+        return driverContext.blockFactory().newConstantDoubleBlockWith(evalValue(vector, 0, scratchPad), positionCount);
+      } catch (IllegalArgumentException  e) {
+        registerException(e);
+        return driverContext.blockFactory().newConstantNullBlock(positionCount);
+      }
+    }
+    try (DoubleBlock.Builder builder = driverContext.blockFactory().newDoubleBlockBuilder(positionCount)) {
+      for (int p = 0; p < positionCount; p++) {
+        try {
+          builder.appendDouble(evalValue(vector, p, scratchPad));
+        } catch (IllegalArgumentException  e) {
+          registerException(e);
+          builder.appendNull();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static double evalValue(BytesRefVector container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StYMin.fromWellKnownBinaryGeo(value);
+  }
+
+  @Override
+  public Block evalBlock(Block b) {
+    BytesRefBlock block = (BytesRefBlock) b;
+    int positionCount = block.getPositionCount();
+    try (DoubleBlock.Builder builder = driverContext.blockFactory().newDoubleBlockBuilder(positionCount)) {
+      BytesRef scratchPad = new BytesRef();
+      for (int p = 0; p < positionCount; p++) {
+        int valueCount = block.getValueCount(p);
+        int start = block.getFirstValueIndex(p);
+        int end = start + valueCount;
+        boolean positionOpened = false;
+        boolean valuesAppended = false;
+        for (int i = start; i < end; i++) {
+          try {
+            double value = evalValue(block, i, scratchPad);
+            if (positionOpened == false && valueCount > 1) {
+              builder.beginPositionEntry();
+              positionOpened = true;
+            }
+            builder.appendDouble(value);
+            valuesAppended = true;
+          } catch (IllegalArgumentException  e) {
+            registerException(e);
+          }
+        }
+        if (valuesAppended == false) {
+          builder.appendNull();
+        } else if (positionOpened) {
+          builder.endPositionEntry();
+        }
+      }
+      return builder.build();
+    }
+  }
+
+  private static double evalValue(BytesRefBlock container, int index, BytesRef scratchPad) {
+    BytesRef value = container.getBytesRef(index, scratchPad);
+    return StYMin.fromWellKnownBinaryGeo(value);
+  }
+
+  public static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory field;
+
+    public Factory(EvalOperator.ExpressionEvaluator.Factory field, Source source) {
+      this.field = field;
+      this.source = source;
+    }
+
+    @Override
+    public StYMinFromWKBGeoEvaluator get(DriverContext context) {
+      return new StYMinFromWKBGeoEvaluator(field.get(context), source, context);
+    }
+
+    @Override
+    public String toString() {
+      return "StYMinFromWKBGeoEvaluator[field=" + field + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
index 4845c7061949b..19ba6a5151eaf 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
@@ -214,6 +214,11 @@ public enum Cap {
          */
         SPATIAL_CENTROID_NO_RECORDS,
 
+        /**
+         * Support ST_ENVELOPE function (and related ST_XMIN, etc.).
+         */
+        ST_ENVELOPE,
+
         /**
          * Fix to GROK and DISSECT that allows extracting attributes with the same name as the input
          * https://github.com/elastic/elasticsearch/issues/110184
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/ExpressionWritables.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/ExpressionWritables.java
index 7e2de0094c2ab..febeccdad9d78 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/ExpressionWritables.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/ExpressionWritables.java
@@ -57,8 +57,13 @@
 import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.SpatialIntersects;
 import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.SpatialWithin;
 import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.StDistance;
+import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.StEnvelope;
 import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.StX;
+import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.StXMax;
+import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.StXMin;
 import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.StY;
+import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.StYMax;
+import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.StYMin;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.ByteLength;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.LTrim;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.Length;
@@ -166,6 +171,11 @@ public static List<NamedWriteableRegistry.Entry> unaryScalars() {
         entries.add(Sinh.ENTRY);
         entries.add(Space.ENTRY);
         entries.add(Sqrt.ENTRY);
+        entries.add(StEnvelope.ENTRY);
+        entries.add(StXMax.ENTRY);
+        entries.add(StXMin.ENTRY);
+        entries.add(StYMax.ENTRY);
+        entries.add(StYMin.ENTRY);
         entries.add(StX.ENTRY);
         entries.add(StY.ENTRY);
         entries.add(Tan.ENTRY);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java
index 37b159922906c..c66a5293eb14a 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java
@@ -117,8 +117,13 @@
 import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.SpatialIntersects;
 import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.SpatialWithin;
 import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.StDistance;
+import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.StEnvelope;
 import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.StX;
+import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.StXMax;
+import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.StXMin;
 import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.StY;
+import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.StYMax;
+import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.StYMin;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.BitLength;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.ByteLength;
 import org.elasticsearch.xpack.esql.expression.function.scalar.string.Concat;
@@ -351,6 +356,11 @@ private static FunctionDefinition[][] functions() {
                 def(SpatialIntersects.class, SpatialIntersects::new, "st_intersects"),
                 def(SpatialWithin.class, SpatialWithin::new, "st_within"),
                 def(StDistance.class, StDistance::new, "st_distance"),
+                def(StEnvelope.class, StEnvelope::new, "st_envelope"),
+                def(StXMax.class, StXMax::new, "st_xmax"),
+                def(StXMin.class, StXMin::new, "st_xmin"),
+                def(StYMax.class, StYMax::new, "st_ymax"),
+                def(StYMin.class, StYMin::new, "st_ymin"),
                 def(StX.class, StX::new, "st_x"),
                 def(StY.class, StY::new, "st_y") },
             // conditional
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StEnvelope.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StEnvelope.java
new file mode 100644
index 0000000000000..934991f3a8088
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StEnvelope.java
@@ -0,0 +1,138 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.compute.ann.ConvertEvaluator;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.geometry.Point;
+import org.elasticsearch.geometry.utils.SpatialEnvelopeVisitor;
+import org.elasticsearch.xpack.esql.core.expression.Expression;
+import org.elasticsearch.xpack.esql.core.expression.TypeResolutions;
+import org.elasticsearch.xpack.esql.core.tree.NodeInfo;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.core.type.DataType;
+import org.elasticsearch.xpack.esql.expression.function.Example;
+import org.elasticsearch.xpack.esql.expression.function.FunctionInfo;
+import org.elasticsearch.xpack.esql.expression.function.Param;
+import org.elasticsearch.xpack.esql.expression.function.scalar.UnaryScalarFunction;
+
+import java.io.IOException;
+import java.util.List;
+
+import static org.elasticsearch.xpack.esql.core.type.DataType.CARTESIAN_SHAPE;
+import static org.elasticsearch.xpack.esql.core.type.DataType.GEO_POINT;
+import static org.elasticsearch.xpack.esql.core.type.DataType.GEO_SHAPE;
+import static org.elasticsearch.xpack.esql.core.type.DataType.NULL;
+import static org.elasticsearch.xpack.esql.core.util.SpatialCoordinateTypes.UNSPECIFIED;
+import static org.elasticsearch.xpack.esql.expression.EsqlTypeResolutions.isSpatial;
+
+/**
+ * Determines the minimum bounding rectangle of a geometry.
+ * The function `st_envelope` is defined in the <a href="https://www.ogc.org/standard/sfs/">OGC Simple Feature Access</a> standard.
+ * Alternatively it is well described in PostGIS documentation at
+ * <a href="https://postgis.net/docs/ST_ENVELOPE.html">PostGIS:ST_ENVELOPE</a>.
+ */
+public class StEnvelope extends UnaryScalarFunction {
+    public static final NamedWriteableRegistry.Entry ENTRY = new NamedWriteableRegistry.Entry(
+        Expression.class,
+        "StEnvelope",
+        StEnvelope::new
+    );
+    private DataType dataType;
+
+    @FunctionInfo(
+        returnType = { "geo_shape", "cartesian_shape" },
+        description = "Determines the minimum bounding box of the supplied geometry.",
+        examples = @Example(file = "spatial_shapes", tag = "st_envelope")
+    )
+    public StEnvelope(
+        Source source,
+        @Param(
+            name = "geometry",
+            type = { "geo_point", "geo_shape", "cartesian_point", "cartesian_shape" },
+            description = "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. "
+                + "If `null`, the function returns `null`."
+        ) Expression field
+    ) {
+        super(source, field);
+    }
+
+    private StEnvelope(StreamInput in) throws IOException {
+        super(in);
+    }
+
+    @Override
+    public String getWriteableName() {
+        return ENTRY.name;
+    }
+
+    @Override
+    protected TypeResolution resolveType() {
+        var resolution = isSpatial(field(), sourceText(), TypeResolutions.ParamOrdinal.DEFAULT);
+        if (resolution.resolved()) {
+            this.dataType = switch (field().dataType()) {
+                case GEO_POINT, GEO_SHAPE -> GEO_SHAPE;
+                case CARTESIAN_POINT, CARTESIAN_SHAPE -> CARTESIAN_SHAPE;
+                default -> NULL;
+            };
+        }
+        return resolution;
+    }
+
+    @Override
+    public EvalOperator.ExpressionEvaluator.Factory toEvaluator(ToEvaluator toEvaluator) {
+        if (field().dataType() == GEO_POINT || field().dataType() == DataType.GEO_SHAPE) {
+            return new StEnvelopeFromWKBGeoEvaluator.Factory(toEvaluator.apply(field()), source());
+        }
+        return new StEnvelopeFromWKBEvaluator.Factory(toEvaluator.apply(field()), source());
+    }
+
+    @Override
+    public DataType dataType() {
+        return dataType;
+    }
+
+    @Override
+    public Expression replaceChildren(List<Expression> newChildren) {
+        return new StEnvelope(source(), newChildren.get(0));
+    }
+
+    @Override
+    protected NodeInfo<? extends Expression> info() {
+        return NodeInfo.create(this, StEnvelope::new, field());
+    }
+
+    @ConvertEvaluator(extraName = "FromWKB", warnExceptions = { IllegalArgumentException.class })
+    static BytesRef fromWellKnownBinary(BytesRef wkb) {
+        var geometry = UNSPECIFIED.wkbToGeometry(wkb);
+        if (geometry instanceof Point) {
+            return wkb;
+        }
+        var envelope = SpatialEnvelopeVisitor.visitCartesian(geometry);
+        if (envelope.isPresent()) {
+            return UNSPECIFIED.asWkb(envelope.get());
+        }
+        throw new IllegalArgumentException("Cannot determine envelope of geometry");
+    }
+
+    @ConvertEvaluator(extraName = "FromWKBGeo", warnExceptions = { IllegalArgumentException.class })
+    static BytesRef fromWellKnownBinaryGeo(BytesRef wkb) {
+        var geometry = UNSPECIFIED.wkbToGeometry(wkb);
+        if (geometry instanceof Point) {
+            return wkb;
+        }
+        var envelope = SpatialEnvelopeVisitor.visitGeo(geometry, true);
+        if (envelope.isPresent()) {
+            return UNSPECIFIED.asWkb(envelope.get());
+        }
+        throw new IllegalArgumentException("Cannot determine envelope of geometry");
+    }
+}
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMax.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMax.java
new file mode 100644
index 0000000000000..d6d710b175113
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMax.java
@@ -0,0 +1,123 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.compute.ann.ConvertEvaluator;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.geometry.Point;
+import org.elasticsearch.geometry.utils.SpatialEnvelopeVisitor;
+import org.elasticsearch.xpack.esql.core.expression.Expression;
+import org.elasticsearch.xpack.esql.core.expression.TypeResolutions;
+import org.elasticsearch.xpack.esql.core.tree.NodeInfo;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.core.type.DataType;
+import org.elasticsearch.xpack.esql.expression.function.Example;
+import org.elasticsearch.xpack.esql.expression.function.FunctionInfo;
+import org.elasticsearch.xpack.esql.expression.function.Param;
+import org.elasticsearch.xpack.esql.expression.function.scalar.UnaryScalarFunction;
+
+import java.io.IOException;
+import java.util.List;
+
+import static org.elasticsearch.xpack.esql.core.type.DataType.DOUBLE;
+import static org.elasticsearch.xpack.esql.core.type.DataType.GEO_POINT;
+import static org.elasticsearch.xpack.esql.core.util.SpatialCoordinateTypes.UNSPECIFIED;
+import static org.elasticsearch.xpack.esql.expression.EsqlTypeResolutions.isSpatial;
+
+/**
+ * Determines the maximum value of the x-coordinate from a geometry.
+ * The function `st_xmax` is defined in the <a href="https://www.ogc.org/standard/sfs/">OGC Simple Feature Access</a> standard.
+ * Alternatively it is well described in PostGIS documentation at <a href="https://postgis.net/docs/ST_XMAX.html">PostGIS:ST_XMAX</a>.
+ */
+public class StXMax extends UnaryScalarFunction {
+    public static final NamedWriteableRegistry.Entry ENTRY = new NamedWriteableRegistry.Entry(Expression.class, "StXMax", StXMax::new);
+
+    @FunctionInfo(
+        returnType = "double",
+        description = "Extracts the maximum value of the `x` coordinates from the supplied geometry.\n"
+            + "If the geometry is of type `geo_point` or `geo_shape` this is equivalent to extracting the maximum `longitude` value.",
+        examples = @Example(file = "spatial_shapes", tag = "st_x_y_min_max")
+    )
+    public StXMax(
+        Source source,
+        @Param(
+            name = "point",
+            type = { "geo_point", "geo_shape", "cartesian_point", "cartesian_shape" },
+            description = "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. "
+                + "If `null`, the function returns `null`."
+        ) Expression field
+    ) {
+        super(source, field);
+    }
+
+    private StXMax(StreamInput in) throws IOException {
+        super(in);
+    }
+
+    @Override
+    public String getWriteableName() {
+        return ENTRY.name;
+    }
+
+    @Override
+    protected TypeResolution resolveType() {
+        return isSpatial(field(), sourceText(), TypeResolutions.ParamOrdinal.DEFAULT);
+    }
+
+    @Override
+    public EvalOperator.ExpressionEvaluator.Factory toEvaluator(ToEvaluator toEvaluator) {
+        if (field().dataType() == GEO_POINT || field().dataType() == DataType.GEO_SHAPE) {
+            return new StXMaxFromWKBGeoEvaluator.Factory(toEvaluator.apply(field()), source());
+        }
+        return new StXMaxFromWKBEvaluator.Factory(toEvaluator.apply(field()), source());
+    }
+
+    @Override
+    public DataType dataType() {
+        return DOUBLE;
+    }
+
+    @Override
+    public Expression replaceChildren(List<Expression> newChildren) {
+        return new StXMax(source(), newChildren.get(0));
+    }
+
+    @Override
+    protected NodeInfo<? extends Expression> info() {
+        return NodeInfo.create(this, StXMax::new, field());
+    }
+
+    @ConvertEvaluator(extraName = "FromWKB", warnExceptions = { IllegalArgumentException.class })
+    static double fromWellKnownBinary(BytesRef wkb) {
+        var geometry = UNSPECIFIED.wkbToGeometry(wkb);
+        if (geometry instanceof Point point) {
+            return point.getX();
+        }
+        var envelope = SpatialEnvelopeVisitor.visitCartesian(geometry);
+        if (envelope.isPresent()) {
+            return envelope.get().getMaxX();
+        }
+        throw new IllegalArgumentException("Cannot determine envelope of geometry");
+    }
+
+    @ConvertEvaluator(extraName = "FromWKBGeo", warnExceptions = { IllegalArgumentException.class })
+    static double fromWellKnownBinaryGeo(BytesRef wkb) {
+        var geometry = UNSPECIFIED.wkbToGeometry(wkb);
+        if (geometry instanceof Point point) {
+            return point.getX();
+        }
+        var envelope = SpatialEnvelopeVisitor.visitGeo(geometry, true);
+        if (envelope.isPresent()) {
+            return envelope.get().getMaxX();
+        }
+        throw new IllegalArgumentException("Cannot determine envelope of geometry");
+    }
+}
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMin.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMin.java
new file mode 100644
index 0000000000000..a5fa11bc11b0f
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMin.java
@@ -0,0 +1,123 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.compute.ann.ConvertEvaluator;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.geometry.Point;
+import org.elasticsearch.geometry.utils.SpatialEnvelopeVisitor;
+import org.elasticsearch.xpack.esql.core.expression.Expression;
+import org.elasticsearch.xpack.esql.core.expression.TypeResolutions;
+import org.elasticsearch.xpack.esql.core.tree.NodeInfo;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.core.type.DataType;
+import org.elasticsearch.xpack.esql.expression.function.Example;
+import org.elasticsearch.xpack.esql.expression.function.FunctionInfo;
+import org.elasticsearch.xpack.esql.expression.function.Param;
+import org.elasticsearch.xpack.esql.expression.function.scalar.UnaryScalarFunction;
+
+import java.io.IOException;
+import java.util.List;
+
+import static org.elasticsearch.xpack.esql.core.type.DataType.DOUBLE;
+import static org.elasticsearch.xpack.esql.core.type.DataType.GEO_POINT;
+import static org.elasticsearch.xpack.esql.core.util.SpatialCoordinateTypes.UNSPECIFIED;
+import static org.elasticsearch.xpack.esql.expression.EsqlTypeResolutions.isSpatial;
+
+/**
+ * Determines the minimum value of the x-coordinate from a geometry.
+ * The function `st_xmin` is defined in the <a href="https://www.ogc.org/standard/sfs/">OGC Simple Feature Access</a> standard.
+ * Alternatively it is well described in PostGIS documentation at <a href="https://postgis.net/docs/ST_XMIN.html">PostGIS:ST_XMIN</a>.
+ */
+public class StXMin extends UnaryScalarFunction {
+    public static final NamedWriteableRegistry.Entry ENTRY = new NamedWriteableRegistry.Entry(Expression.class, "StXMin", StXMin::new);
+
+    @FunctionInfo(
+        returnType = "double",
+        description = "Extracts the minimum value of the `x` coordinates from the supplied geometry.\n"
+            + "If the geometry is of type `geo_point` or `geo_shape` this is equivalent to extracting the minimum `longitude` value.",
+        examples = @Example(file = "spatial_shapes", tag = "st_x_y_min_max")
+    )
+    public StXMin(
+        Source source,
+        @Param(
+            name = "point",
+            type = { "geo_point", "geo_shape", "cartesian_point", "cartesian_shape" },
+            description = "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. "
+                + "If `null`, the function returns `null`."
+        ) Expression field
+    ) {
+        super(source, field);
+    }
+
+    private StXMin(StreamInput in) throws IOException {
+        super(in);
+    }
+
+    @Override
+    public String getWriteableName() {
+        return ENTRY.name;
+    }
+
+    @Override
+    protected TypeResolution resolveType() {
+        return isSpatial(field(), sourceText(), TypeResolutions.ParamOrdinal.DEFAULT);
+    }
+
+    @Override
+    public EvalOperator.ExpressionEvaluator.Factory toEvaluator(ToEvaluator toEvaluator) {
+        if (field().dataType() == GEO_POINT || field().dataType() == DataType.GEO_SHAPE) {
+            return new StXMinFromWKBGeoEvaluator.Factory(toEvaluator.apply(field()), source());
+        }
+        return new StXMinFromWKBEvaluator.Factory(toEvaluator.apply(field()), source());
+    }
+
+    @Override
+    public DataType dataType() {
+        return DOUBLE;
+    }
+
+    @Override
+    public Expression replaceChildren(List<Expression> newChildren) {
+        return new StXMin(source(), newChildren.get(0));
+    }
+
+    @Override
+    protected NodeInfo<? extends Expression> info() {
+        return NodeInfo.create(this, StXMin::new, field());
+    }
+
+    @ConvertEvaluator(extraName = "FromWKB", warnExceptions = { IllegalArgumentException.class })
+    static double fromWellKnownBinary(BytesRef wkb) {
+        var geometry = UNSPECIFIED.wkbToGeometry(wkb);
+        if (geometry instanceof Point point) {
+            return point.getX();
+        }
+        var envelope = SpatialEnvelopeVisitor.visitCartesian(geometry);
+        if (envelope.isPresent()) {
+            return envelope.get().getMinX();
+        }
+        throw new IllegalArgumentException("Cannot determine envelope of geometry");
+    }
+
+    @ConvertEvaluator(extraName = "FromWKBGeo", warnExceptions = { IllegalArgumentException.class })
+    static double fromWellKnownBinaryGeo(BytesRef wkb) {
+        var geometry = UNSPECIFIED.wkbToGeometry(wkb);
+        if (geometry instanceof Point point) {
+            return point.getX();
+        }
+        var envelope = SpatialEnvelopeVisitor.visitGeo(geometry, true);
+        if (envelope.isPresent()) {
+            return envelope.get().getMinX();
+        }
+        throw new IllegalArgumentException("Cannot determine envelope of geometry");
+    }
+}
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMax.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMax.java
new file mode 100644
index 0000000000000..fbbea8e024a6b
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMax.java
@@ -0,0 +1,123 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.compute.ann.ConvertEvaluator;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.geometry.Point;
+import org.elasticsearch.geometry.utils.SpatialEnvelopeVisitor;
+import org.elasticsearch.xpack.esql.core.expression.Expression;
+import org.elasticsearch.xpack.esql.core.expression.TypeResolutions;
+import org.elasticsearch.xpack.esql.core.tree.NodeInfo;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.core.type.DataType;
+import org.elasticsearch.xpack.esql.expression.function.Example;
+import org.elasticsearch.xpack.esql.expression.function.FunctionInfo;
+import org.elasticsearch.xpack.esql.expression.function.Param;
+import org.elasticsearch.xpack.esql.expression.function.scalar.UnaryScalarFunction;
+
+import java.io.IOException;
+import java.util.List;
+
+import static org.elasticsearch.xpack.esql.core.type.DataType.DOUBLE;
+import static org.elasticsearch.xpack.esql.core.type.DataType.GEO_POINT;
+import static org.elasticsearch.xpack.esql.core.util.SpatialCoordinateTypes.UNSPECIFIED;
+import static org.elasticsearch.xpack.esql.expression.EsqlTypeResolutions.isSpatial;
+
+/**
+ * Determines the maximum value of the y-coordinate from a geometry.
+ * The function `st_ymax` is defined in the <a href="https://www.ogc.org/standard/sfs/">OGC Simple Feature Access</a> standard.
+ * Alternatively it is well described in PostGIS documentation at <a href="https://postgis.net/docs/ST_YMAX.html">PostGIS:ST_YMAX</a>.
+ */
+public class StYMax extends UnaryScalarFunction {
+    public static final NamedWriteableRegistry.Entry ENTRY = new NamedWriteableRegistry.Entry(Expression.class, "StYMax", StYMax::new);
+
+    @FunctionInfo(
+        returnType = "double",
+        description = "Extracts the maximum value of the `y` coordinates from the supplied geometry.\n"
+            + "If the geometry is of type `geo_point` or `geo_shape` this is equivalent to extracting the maximum `latitude` value.",
+        examples = @Example(file = "spatial_shapes", tag = "st_x_y_min_max")
+    )
+    public StYMax(
+        Source source,
+        @Param(
+            name = "point",
+            type = { "geo_point", "geo_shape", "cartesian_point", "cartesian_shape" },
+            description = "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. "
+                + "If `null`, the function returns `null`."
+        ) Expression field
+    ) {
+        super(source, field);
+    }
+
+    private StYMax(StreamInput in) throws IOException {
+        super(in);
+    }
+
+    @Override
+    public String getWriteableName() {
+        return ENTRY.name;
+    }
+
+    @Override
+    protected TypeResolution resolveType() {
+        return isSpatial(field(), sourceText(), TypeResolutions.ParamOrdinal.DEFAULT);
+    }
+
+    @Override
+    public EvalOperator.ExpressionEvaluator.Factory toEvaluator(ToEvaluator toEvaluator) {
+        if (field().dataType() == GEO_POINT || field().dataType() == DataType.GEO_SHAPE) {
+            return new StYMaxFromWKBGeoEvaluator.Factory(toEvaluator.apply(field()), source());
+        }
+        return new StYMaxFromWKBEvaluator.Factory(toEvaluator.apply(field()), source());
+    }
+
+    @Override
+    public DataType dataType() {
+        return DOUBLE;
+    }
+
+    @Override
+    public Expression replaceChildren(List<Expression> newChildren) {
+        return new StYMax(source(), newChildren.get(0));
+    }
+
+    @Override
+    protected NodeInfo<? extends Expression> info() {
+        return NodeInfo.create(this, StYMax::new, field());
+    }
+
+    @ConvertEvaluator(extraName = "FromWKB", warnExceptions = { IllegalArgumentException.class })
+    static double fromWellKnownBinary(BytesRef wkb) {
+        var geometry = UNSPECIFIED.wkbToGeometry(wkb);
+        if (geometry instanceof Point point) {
+            return point.getY();
+        }
+        var envelope = SpatialEnvelopeVisitor.visitCartesian(geometry);
+        if (envelope.isPresent()) {
+            return envelope.get().getMaxY();
+        }
+        throw new IllegalArgumentException("Cannot determine envelope of geometry");
+    }
+
+    @ConvertEvaluator(extraName = "FromWKBGeo", warnExceptions = { IllegalArgumentException.class })
+    static double fromWellKnownBinaryGeo(BytesRef wkb) {
+        var geometry = UNSPECIFIED.wkbToGeometry(wkb);
+        if (geometry instanceof Point point) {
+            return point.getY();
+        }
+        var envelope = SpatialEnvelopeVisitor.visitGeo(geometry, true);
+        if (envelope.isPresent()) {
+            return envelope.get().getMaxY();
+        }
+        throw new IllegalArgumentException("Cannot determine envelope of geometry");
+    }
+}
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMin.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMin.java
new file mode 100644
index 0000000000000..1707d3b4f2fb9
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMin.java
@@ -0,0 +1,123 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.compute.ann.ConvertEvaluator;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.geometry.Point;
+import org.elasticsearch.geometry.utils.SpatialEnvelopeVisitor;
+import org.elasticsearch.xpack.esql.core.expression.Expression;
+import org.elasticsearch.xpack.esql.core.expression.TypeResolutions;
+import org.elasticsearch.xpack.esql.core.tree.NodeInfo;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.core.type.DataType;
+import org.elasticsearch.xpack.esql.expression.function.Example;
+import org.elasticsearch.xpack.esql.expression.function.FunctionInfo;
+import org.elasticsearch.xpack.esql.expression.function.Param;
+import org.elasticsearch.xpack.esql.expression.function.scalar.UnaryScalarFunction;
+
+import java.io.IOException;
+import java.util.List;
+
+import static org.elasticsearch.xpack.esql.core.type.DataType.DOUBLE;
+import static org.elasticsearch.xpack.esql.core.type.DataType.GEO_POINT;
+import static org.elasticsearch.xpack.esql.core.util.SpatialCoordinateTypes.UNSPECIFIED;
+import static org.elasticsearch.xpack.esql.expression.EsqlTypeResolutions.isSpatial;
+
+/**
+ * Determines the minimum value of the y-coordinate from a geometry.
+ * The function `st_ymin` is defined in the <a href="https://www.ogc.org/standard/sfs/">OGC Simple Feature Access</a> standard.
+ * Alternatively it is well described in PostGIS documentation at <a href="https://postgis.net/docs/ST_YMIN.html">PostGIS:ST_YMIN</a>.
+ */
+public class StYMin extends UnaryScalarFunction {
+    public static final NamedWriteableRegistry.Entry ENTRY = new NamedWriteableRegistry.Entry(Expression.class, "StYMin", StYMin::new);
+
+    @FunctionInfo(
+        returnType = "double",
+        description = "Extracts the minimum value of the `y` coordinates from the supplied geometry.\n"
+            + "If the geometry is of type `geo_point` or `geo_shape` this is equivalent to extracting the minimum `latitude` value.",
+        examples = @Example(file = "spatial_shapes", tag = "st_x_y_min_max")
+    )
+    public StYMin(
+        Source source,
+        @Param(
+            name = "point",
+            type = { "geo_point", "geo_shape", "cartesian_point", "cartesian_shape" },
+            description = "Expression of type `geo_point`, `geo_shape`, `cartesian_point` or `cartesian_shape`. "
+                + "If `null`, the function returns `null`."
+        ) Expression field
+    ) {
+        super(source, field);
+    }
+
+    private StYMin(StreamInput in) throws IOException {
+        super(in);
+    }
+
+    @Override
+    public String getWriteableName() {
+        return ENTRY.name;
+    }
+
+    @Override
+    protected TypeResolution resolveType() {
+        return isSpatial(field(), sourceText(), TypeResolutions.ParamOrdinal.DEFAULT);
+    }
+
+    @Override
+    public EvalOperator.ExpressionEvaluator.Factory toEvaluator(ToEvaluator toEvaluator) {
+        if (field().dataType() == GEO_POINT || field().dataType() == DataType.GEO_SHAPE) {
+            return new StYMinFromWKBGeoEvaluator.Factory(toEvaluator.apply(field()), source());
+        }
+        return new StYMinFromWKBEvaluator.Factory(toEvaluator.apply(field()), source());
+    }
+
+    @Override
+    public DataType dataType() {
+        return DOUBLE;
+    }
+
+    @Override
+    public Expression replaceChildren(List<Expression> newChildren) {
+        return new StYMin(source(), newChildren.get(0));
+    }
+
+    @Override
+    protected NodeInfo<? extends Expression> info() {
+        return NodeInfo.create(this, StYMin::new, field());
+    }
+
+    @ConvertEvaluator(extraName = "FromWKB", warnExceptions = { IllegalArgumentException.class })
+    static double fromWellKnownBinary(BytesRef wkb) {
+        var geometry = UNSPECIFIED.wkbToGeometry(wkb);
+        if (geometry instanceof Point point) {
+            return point.getY();
+        }
+        var envelope = SpatialEnvelopeVisitor.visitCartesian(geometry);
+        if (envelope.isPresent()) {
+            return envelope.get().getMinY();
+        }
+        throw new IllegalArgumentException("Cannot determine envelope of geometry");
+    }
+
+    @ConvertEvaluator(extraName = "FromWKBGeo", warnExceptions = { IllegalArgumentException.class })
+    static double fromWellKnownBinaryGeo(BytesRef wkb) {
+        var geometry = UNSPECIFIED.wkbToGeometry(wkb);
+        if (geometry instanceof Point point) {
+            return point.getY();
+        }
+        var envelope = SpatialEnvelopeVisitor.visitGeo(geometry, true);
+        if (envelope.isPresent()) {
+            return envelope.get().getMinY();
+        }
+        throw new IllegalArgumentException("Cannot determine envelope of geometry");
+    }
+}
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StEnvelopeTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StEnvelopeTests.java
new file mode 100644
index 0000000000000..ac87d45491447
--- /dev/null
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StEnvelopeTests.java
@@ -0,0 +1,88 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import com.carrotsearch.randomizedtesting.annotations.Name;
+import com.carrotsearch.randomizedtesting.annotations.ParametersFactory;
+
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.geometry.Point;
+import org.elasticsearch.geometry.utils.SpatialEnvelopeVisitor;
+import org.elasticsearch.xpack.esql.core.expression.Expression;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.function.AbstractScalarFunctionTestCase;
+import org.elasticsearch.xpack.esql.expression.function.FunctionName;
+import org.elasticsearch.xpack.esql.expression.function.TestCaseSupplier;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.function.Supplier;
+
+import static org.elasticsearch.xpack.esql.core.type.DataType.CARTESIAN_SHAPE;
+import static org.elasticsearch.xpack.esql.core.type.DataType.GEO_SHAPE;
+import static org.elasticsearch.xpack.esql.core.util.SpatialCoordinateTypes.UNSPECIFIED;
+
+@FunctionName("st_envelope")
+public class StEnvelopeTests extends AbstractScalarFunctionTestCase {
+    public StEnvelopeTests(@Name("TestCase") Supplier<TestCaseSupplier.TestCase> testCaseSupplier) {
+        this.testCase = testCaseSupplier.get();
+    }
+
+    @ParametersFactory
+    public static Iterable<Object[]> parameters() {
+        String expectedGeo = "StEnvelopeFromWKBGeoEvaluator[field=Attribute[channel=0]]";
+        String expectedCartesian = "StEnvelopeFromWKBEvaluator[field=Attribute[channel=0]]";
+        final List<TestCaseSupplier> suppliers = new ArrayList<>();
+        TestCaseSupplier.forUnaryGeoPoint(suppliers, expectedGeo, GEO_SHAPE, StEnvelopeTests::valueOfGeo, List.of());
+        TestCaseSupplier.forUnaryCartesianPoint(
+            suppliers,
+            expectedCartesian,
+            CARTESIAN_SHAPE,
+            StEnvelopeTests::valueOfCartesian,
+            List.of()
+        );
+        TestCaseSupplier.forUnaryGeoShape(suppliers, expectedGeo, GEO_SHAPE, StEnvelopeTests::valueOfGeo, List.of());
+        TestCaseSupplier.forUnaryCartesianShape(
+            suppliers,
+            expectedCartesian,
+            CARTESIAN_SHAPE,
+            StEnvelopeTests::valueOfCartesian,
+            List.of()
+        );
+        return parameterSuppliersFromTypedDataWithDefaultChecks(
+            false,
+            suppliers,
+            (v, p) -> "geo_point, cartesian_point, geo_shape or cartesian_shape"
+        );
+    }
+
+    private static BytesRef valueOfGeo(BytesRef wkb) {
+        return valueOf(wkb, true);
+    }
+
+    private static BytesRef valueOfCartesian(BytesRef wkb) {
+        return valueOf(wkb, false);
+    }
+
+    private static BytesRef valueOf(BytesRef wkb, boolean geo) {
+        var geometry = UNSPECIFIED.wkbToGeometry(wkb);
+        if (geometry instanceof Point) {
+            return wkb;
+        }
+        var envelope = geo ? SpatialEnvelopeVisitor.visitGeo(geometry, true) : SpatialEnvelopeVisitor.visitCartesian(geometry);
+        if (envelope.isPresent()) {
+            return UNSPECIFIED.asWkb(envelope.get());
+        }
+        throw new IllegalArgumentException("Geometry is empty");
+    }
+
+    @Override
+    protected Expression build(Source source, List<Expression> args) {
+        return new StEnvelope(source, args.get(0));
+    }
+}
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMaxTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMaxTests.java
new file mode 100644
index 0000000000000..dc6e61e44f599
--- /dev/null
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMaxTests.java
@@ -0,0 +1,75 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import com.carrotsearch.randomizedtesting.annotations.Name;
+import com.carrotsearch.randomizedtesting.annotations.ParametersFactory;
+
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.geometry.Point;
+import org.elasticsearch.geometry.utils.SpatialEnvelopeVisitor;
+import org.elasticsearch.xpack.esql.core.expression.Expression;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.function.AbstractScalarFunctionTestCase;
+import org.elasticsearch.xpack.esql.expression.function.FunctionName;
+import org.elasticsearch.xpack.esql.expression.function.TestCaseSupplier;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.function.Supplier;
+
+import static org.elasticsearch.xpack.esql.core.type.DataType.DOUBLE;
+import static org.elasticsearch.xpack.esql.core.util.SpatialCoordinateTypes.UNSPECIFIED;
+
+@FunctionName("st_xmax")
+public class StXMaxTests extends AbstractScalarFunctionTestCase {
+    public StXMaxTests(@Name("TestCase") Supplier<TestCaseSupplier.TestCase> testCaseSupplier) {
+        this.testCase = testCaseSupplier.get();
+    }
+
+    @ParametersFactory
+    public static Iterable<Object[]> parameters() {
+        String expectedGeo = "StXMaxFromWKBGeoEvaluator[field=Attribute[channel=0]]";
+        String expectedCartesian = "StXMaxFromWKBEvaluator[field=Attribute[channel=0]]";
+        final List<TestCaseSupplier> suppliers = new ArrayList<>();
+        TestCaseSupplier.forUnaryGeoPoint(suppliers, expectedGeo, DOUBLE, StXMaxTests::valueOfGeo, List.of());
+        TestCaseSupplier.forUnaryCartesianPoint(suppliers, expectedCartesian, DOUBLE, StXMaxTests::valueOfCartesian, List.of());
+        TestCaseSupplier.forUnaryGeoShape(suppliers, expectedGeo, DOUBLE, StXMaxTests::valueOfGeo, List.of());
+        TestCaseSupplier.forUnaryCartesianShape(suppliers, expectedCartesian, DOUBLE, StXMaxTests::valueOfCartesian, List.of());
+        return parameterSuppliersFromTypedDataWithDefaultChecks(
+            true,
+            suppliers,
+            (v, p) -> "geo_point, cartesian_point, geo_shape or cartesian_shape"
+        );
+    }
+
+    private static double valueOfGeo(BytesRef wkb) {
+        return valueOf(wkb, true);
+    }
+
+    private static double valueOfCartesian(BytesRef wkb) {
+        return valueOf(wkb, false);
+    }
+
+    private static double valueOf(BytesRef wkb, boolean geo) {
+        var geometry = UNSPECIFIED.wkbToGeometry(wkb);
+        if (geometry instanceof Point point) {
+            return point.getX();
+        }
+        var envelope = geo ? SpatialEnvelopeVisitor.visitGeo(geometry, true) : SpatialEnvelopeVisitor.visitCartesian(geometry);
+        if (envelope.isPresent()) {
+            return envelope.get().getMaxX();
+        }
+        throw new IllegalArgumentException("Geometry is empty");
+    }
+
+    @Override
+    protected Expression build(Source source, List<Expression> args) {
+        return new StXMax(source, args.get(0));
+    }
+}
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMinTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMinTests.java
new file mode 100644
index 0000000000000..8c06d18b1e281
--- /dev/null
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StXMinTests.java
@@ -0,0 +1,75 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import com.carrotsearch.randomizedtesting.annotations.Name;
+import com.carrotsearch.randomizedtesting.annotations.ParametersFactory;
+
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.geometry.Point;
+import org.elasticsearch.geometry.utils.SpatialEnvelopeVisitor;
+import org.elasticsearch.xpack.esql.core.expression.Expression;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.function.AbstractScalarFunctionTestCase;
+import org.elasticsearch.xpack.esql.expression.function.FunctionName;
+import org.elasticsearch.xpack.esql.expression.function.TestCaseSupplier;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.function.Supplier;
+
+import static org.elasticsearch.xpack.esql.core.type.DataType.DOUBLE;
+import static org.elasticsearch.xpack.esql.core.util.SpatialCoordinateTypes.UNSPECIFIED;
+
+@FunctionName("st_xmin")
+public class StXMinTests extends AbstractScalarFunctionTestCase {
+    public StXMinTests(@Name("TestCase") Supplier<TestCaseSupplier.TestCase> testCaseSupplier) {
+        this.testCase = testCaseSupplier.get();
+    }
+
+    @ParametersFactory
+    public static Iterable<Object[]> parameters() {
+        String expectedGeo = "StXMinFromWKBGeoEvaluator[field=Attribute[channel=0]]";
+        String expectedCartesian = "StXMinFromWKBEvaluator[field=Attribute[channel=0]]";
+        final List<TestCaseSupplier> suppliers = new ArrayList<>();
+        TestCaseSupplier.forUnaryGeoPoint(suppliers, expectedGeo, DOUBLE, StXMinTests::valueOfGeo, List.of());
+        TestCaseSupplier.forUnaryCartesianPoint(suppliers, expectedCartesian, DOUBLE, StXMinTests::valueOfCartesian, List.of());
+        TestCaseSupplier.forUnaryGeoShape(suppliers, expectedGeo, DOUBLE, StXMinTests::valueOfGeo, List.of());
+        TestCaseSupplier.forUnaryCartesianShape(suppliers, expectedCartesian, DOUBLE, StXMinTests::valueOfCartesian, List.of());
+        return parameterSuppliersFromTypedDataWithDefaultChecks(
+            true,
+            suppliers,
+            (v, p) -> "geo_point, cartesian_point, geo_shape or cartesian_shape"
+        );
+    }
+
+    private static double valueOfGeo(BytesRef wkb) {
+        return valueOf(wkb, true);
+    }
+
+    private static double valueOfCartesian(BytesRef wkb) {
+        return valueOf(wkb, false);
+    }
+
+    private static double valueOf(BytesRef wkb, boolean geo) {
+        var geometry = UNSPECIFIED.wkbToGeometry(wkb);
+        if (geometry instanceof Point point) {
+            return point.getX();
+        }
+        var envelope = geo ? SpatialEnvelopeVisitor.visitGeo(geometry, true) : SpatialEnvelopeVisitor.visitCartesian(geometry);
+        if (envelope.isPresent()) {
+            return envelope.get().getMinX();
+        }
+        throw new IllegalArgumentException("Geometry is empty");
+    }
+
+    @Override
+    protected Expression build(Source source, List<Expression> args) {
+        return new StXMin(source, args.get(0));
+    }
+}
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMaxTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMaxTests.java
new file mode 100644
index 0000000000000..7222d7517f7ff
--- /dev/null
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMaxTests.java
@@ -0,0 +1,75 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import com.carrotsearch.randomizedtesting.annotations.Name;
+import com.carrotsearch.randomizedtesting.annotations.ParametersFactory;
+
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.geometry.Point;
+import org.elasticsearch.geometry.utils.SpatialEnvelopeVisitor;
+import org.elasticsearch.xpack.esql.core.expression.Expression;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.function.AbstractScalarFunctionTestCase;
+import org.elasticsearch.xpack.esql.expression.function.FunctionName;
+import org.elasticsearch.xpack.esql.expression.function.TestCaseSupplier;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.function.Supplier;
+
+import static org.elasticsearch.xpack.esql.core.type.DataType.DOUBLE;
+import static org.elasticsearch.xpack.esql.core.util.SpatialCoordinateTypes.UNSPECIFIED;
+
+@FunctionName("st_ymax")
+public class StYMaxTests extends AbstractScalarFunctionTestCase {
+    public StYMaxTests(@Name("TestCase") Supplier<TestCaseSupplier.TestCase> testCaseSupplier) {
+        this.testCase = testCaseSupplier.get();
+    }
+
+    @ParametersFactory
+    public static Iterable<Object[]> parameters() {
+        String expectedGeo = "StYMaxFromWKBGeoEvaluator[field=Attribute[channel=0]]";
+        String expectedCartesian = "StYMaxFromWKBEvaluator[field=Attribute[channel=0]]";
+        final List<TestCaseSupplier> suppliers = new ArrayList<>();
+        TestCaseSupplier.forUnaryGeoPoint(suppliers, expectedGeo, DOUBLE, StYMaxTests::valueOfGeo, List.of());
+        TestCaseSupplier.forUnaryCartesianPoint(suppliers, expectedCartesian, DOUBLE, StYMaxTests::valueOfCartesian, List.of());
+        TestCaseSupplier.forUnaryGeoShape(suppliers, expectedGeo, DOUBLE, StYMaxTests::valueOfGeo, List.of());
+        TestCaseSupplier.forUnaryCartesianShape(suppliers, expectedCartesian, DOUBLE, StYMaxTests::valueOfCartesian, List.of());
+        return parameterSuppliersFromTypedDataWithDefaultChecks(
+            true,
+            suppliers,
+            (v, p) -> "geo_point, cartesian_point, geo_shape or cartesian_shape"
+        );
+    }
+
+    private static double valueOfGeo(BytesRef wkb) {
+        return valueOf(wkb, true);
+    }
+
+    private static double valueOfCartesian(BytesRef wkb) {
+        return valueOf(wkb, false);
+    }
+
+    private static double valueOf(BytesRef wkb, boolean geo) {
+        var geometry = UNSPECIFIED.wkbToGeometry(wkb);
+        if (geometry instanceof Point point) {
+            return point.getY();
+        }
+        var envelope = geo ? SpatialEnvelopeVisitor.visitGeo(geometry, true) : SpatialEnvelopeVisitor.visitCartesian(geometry);
+        if (envelope.isPresent()) {
+            return envelope.get().getMaxY();
+        }
+        throw new IllegalArgumentException("Geometry is empty");
+    }
+
+    @Override
+    protected Expression build(Source source, List<Expression> args) {
+        return new StYMax(source, args.get(0));
+    }
+}
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMinTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMinTests.java
new file mode 100644
index 0000000000000..843c7bb649114
--- /dev/null
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/scalar/spatial/StYMinTests.java
@@ -0,0 +1,75 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.expression.function.scalar.spatial;
+
+import com.carrotsearch.randomizedtesting.annotations.Name;
+import com.carrotsearch.randomizedtesting.annotations.ParametersFactory;
+
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.geometry.Point;
+import org.elasticsearch.geometry.utils.SpatialEnvelopeVisitor;
+import org.elasticsearch.xpack.esql.core.expression.Expression;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.function.AbstractScalarFunctionTestCase;
+import org.elasticsearch.xpack.esql.expression.function.FunctionName;
+import org.elasticsearch.xpack.esql.expression.function.TestCaseSupplier;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.function.Supplier;
+
+import static org.elasticsearch.xpack.esql.core.type.DataType.DOUBLE;
+import static org.elasticsearch.xpack.esql.core.util.SpatialCoordinateTypes.UNSPECIFIED;
+
+@FunctionName("st_ymin")
+public class StYMinTests extends AbstractScalarFunctionTestCase {
+    public StYMinTests(@Name("TestCase") Supplier<TestCaseSupplier.TestCase> testCaseSupplier) {
+        this.testCase = testCaseSupplier.get();
+    }
+
+    @ParametersFactory
+    public static Iterable<Object[]> parameters() {
+        String expectedGeo = "StYMinFromWKBGeoEvaluator[field=Attribute[channel=0]]";
+        String expectedCartesian = "StYMinFromWKBEvaluator[field=Attribute[channel=0]]";
+        final List<TestCaseSupplier> suppliers = new ArrayList<>();
+        TestCaseSupplier.forUnaryGeoPoint(suppliers, expectedGeo, DOUBLE, StYMinTests::valueOfGeo, List.of());
+        TestCaseSupplier.forUnaryCartesianPoint(suppliers, expectedCartesian, DOUBLE, StYMinTests::valueOfCartesian, List.of());
+        TestCaseSupplier.forUnaryGeoShape(suppliers, expectedGeo, DOUBLE, StYMinTests::valueOfGeo, List.of());
+        TestCaseSupplier.forUnaryCartesianShape(suppliers, expectedCartesian, DOUBLE, StYMinTests::valueOfCartesian, List.of());
+        return parameterSuppliersFromTypedDataWithDefaultChecks(
+            true,
+            suppliers,
+            (v, p) -> "geo_point, cartesian_point, geo_shape or cartesian_shape"
+        );
+    }
+
+    private static double valueOfGeo(BytesRef wkb) {
+        return valueOf(wkb, true);
+    }
+
+    private static double valueOfCartesian(BytesRef wkb) {
+        return valueOf(wkb, false);
+    }
+
+    private static double valueOf(BytesRef wkb, boolean geo) {
+        var geometry = UNSPECIFIED.wkbToGeometry(wkb);
+        if (geometry instanceof Point point) {
+            return point.getY();
+        }
+        var envelope = geo ? SpatialEnvelopeVisitor.visitGeo(geometry, true) : SpatialEnvelopeVisitor.visitCartesian(geometry);
+        if (envelope.isPresent()) {
+            return envelope.get().getMinY();
+        }
+        throw new IllegalArgumentException("Geometry is empty");
+    }
+
+    @Override
+    protected Expression build(Source source, List<Expression> args) {
+        return new StYMin(source, args.get(0));
+    }
+}
diff --git a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml
index c23b44c00bd14..26e3c8ed0ef47 100644
--- a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml
+++ b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml
@@ -92,7 +92,7 @@ setup:
   - gt: {esql.functions.to_long: $functions_to_long}
   - match: {esql.functions.coalesce: $functions_coalesce}
   # Testing for the entire function set isn't feasbile, so we just check that we return the correct count as an approximation.
-  - length: {esql.functions: 122} # check the "sister" test below for a likely update to the same esql.functions length check
+  - length: {esql.functions: 127} # check the "sister" test below for a likely update to the same esql.functions length check
 
 ---
 "Basic ESQL usage output (telemetry) non-snapshot version":
@@ -163,4 +163,4 @@ setup:
   - match: {esql.functions.cos: $functions_cos}
   - gt: {esql.functions.to_long: $functions_to_long}
   - match: {esql.functions.coalesce: $functions_coalesce}
-  - length: {esql.functions: 119} # check the "sister" test above for a likely update to the same esql.functions length check
+  - length: {esql.functions: 123} # check the "sister" test above for a likely update to the same esql.functions length check

From cd58030d46640e22c6e1a736256b5c2ad094cf89 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Wed, 4 Dec 2024 23:05:28 +1100
Subject: [PATCH 007/119] Mute
 org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT test
 {lookup-join.LookupIPFromIndexKeep ASYNC} #117974

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 17a7b26d1c091..1568bed8a4f30 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -244,6 +244,9 @@ tests:
 - class: org.elasticsearch.xpack.ml.integration.RegressionIT
   method: testTwoJobsWithSameRandomizeSeedUseSameTrainingSet
   issue: https://github.com/elastic/elasticsearch/issues/117805
+- class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
+  method: test {lookup-join.LookupIPFromIndexKeep ASYNC}
+  issue: https://github.com/elastic/elasticsearch/issues/117974
 
 # Examples:
 #

From 4389059bec3c3a2a0a267300b74fc7f7b7716394 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Wed, 4 Dec 2024 23:05:43 +1100
Subject: [PATCH 008/119] Mute
 org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT test
 {lookup-join.LookupMessageFromIndex ASYNC} #117975

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 1568bed8a4f30..e0d457b26cc73 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -247,6 +247,9 @@ tests:
 - class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
   method: test {lookup-join.LookupIPFromIndexKeep ASYNC}
   issue: https://github.com/elastic/elasticsearch/issues/117974
+- class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
+  method: test {lookup-join.LookupMessageFromIndex ASYNC}
+  issue: https://github.com/elastic/elasticsearch/issues/117975
 
 # Examples:
 #

From 91d0539c2a1f5926f083c7aee050b5e1b18b8566 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Wed, 4 Dec 2024 23:05:56 +1100
Subject: [PATCH 009/119] Mute
 org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT test
 {lookup-join.LookupMessageFromIndexKeep ASYNC} #117976

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index e0d457b26cc73..944ee0a4ae158 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -250,6 +250,9 @@ tests:
 - class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
   method: test {lookup-join.LookupMessageFromIndex ASYNC}
   issue: https://github.com/elastic/elasticsearch/issues/117975
+- class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
+  method: test {lookup-join.LookupMessageFromIndexKeep ASYNC}
+  issue: https://github.com/elastic/elasticsearch/issues/117976
 
 # Examples:
 #

From 8134d0244ccac43a826d5282c380f68c5863dab3 Mon Sep 17 00:00:00 2001
From: Niels Bauman <33722607+nielsbauman@users.noreply.github.com>
Date: Wed, 4 Dec 2024 13:13:21 +0100
Subject: [PATCH 010/119] Unmute #117893 (#117909)

This test was muted erroneously.
---
 muted-tests.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index 944ee0a4ae158..c3fe9425def2d 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -221,8 +221,6 @@ tests:
   issue: https://github.com/elastic/elasticsearch/issues/117815
 - class: org.elasticsearch.xpack.ml.integration.DatafeedJobsRestIT
   issue: https://github.com/elastic/elasticsearch/issues/111319
-- class: org.elasticsearch.validation.DotPrefixClientYamlTestSuiteIT
-  issue: https://github.com/elastic/elasticsearch/issues/117893
 - class: org.elasticsearch.xpack.core.ml.search.SparseVectorQueryBuilderTests
   method: testToQuery
   issue: https://github.com/elastic/elasticsearch/issues/117904

From 435a0cc2721a23f6c97e5102e86b5babf3b64b47 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lorenzo=20Dematt=C3=A9?= <lorenzo.dematte@elastic.co>
Date: Wed, 4 Dec 2024 13:23:27 +0100
Subject: [PATCH 011/119] CreateClassLoaderEntitlement + extensions to parse
 logic (#117754)

---
 .../policy/CreateClassLoaderEntitlement.java  | 16 ++++
 .../runtime/policy/PolicyParser.java          | 81 ++++++++++++-------
 .../policy/PolicyParserFailureTests.java      |  7 +-
 .../runtime/policy/PolicyParserTests.java     | 39 +++++++++
 4 files changed, 109 insertions(+), 34 deletions(-)
 create mode 100644 libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/CreateClassLoaderEntitlement.java

diff --git a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/CreateClassLoaderEntitlement.java b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/CreateClassLoaderEntitlement.java
new file mode 100644
index 0000000000000..708e0b87711fe
--- /dev/null
+++ b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/CreateClassLoaderEntitlement.java
@@ -0,0 +1,16 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.entitlement.runtime.policy;
+
+public class CreateClassLoaderEntitlement implements Entitlement {
+    @ExternalEntitlement
+    public CreateClassLoaderEntitlement() {}
+
+}
diff --git a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/PolicyParser.java b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/PolicyParser.java
index ea6603af99925..0d1a7c14ece4b 100644
--- a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/PolicyParser.java
+++ b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/PolicyParser.java
@@ -19,22 +19,43 @@
 import java.lang.reflect.Constructor;
 import java.lang.reflect.InvocationTargetException;
 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.List;
+import java.util.Locale;
 import java.util.Map;
 import java.util.Objects;
-
-import static org.elasticsearch.entitlement.runtime.policy.PolicyParserException.newPolicyParserException;
+import java.util.function.Function;
+import java.util.function.Predicate;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
 
 /**
  * A parser to parse policy files for entitlements.
  */
 public class PolicyParser {
 
-    protected static final String entitlementPackageName = Entitlement.class.getPackage().getName();
+    private static final Map<String, Class<?>> EXTERNAL_ENTITLEMENTS = Stream.of(FileEntitlement.class, CreateClassLoaderEntitlement.class)
+        .collect(Collectors.toUnmodifiableMap(PolicyParser::getEntitlementTypeName, Function.identity()));
 
     protected final XContentParser policyParser;
     protected final String policyName;
 
+    static String getEntitlementTypeName(Class<? extends Entitlement> entitlementClass) {
+        var entitlementClassName = entitlementClass.getSimpleName();
+
+        if (entitlementClassName.endsWith("Entitlement") == false) {
+            throw new IllegalArgumentException(
+                entitlementClassName + " is not a valid Entitlement class name. A valid class name must end with 'Entitlement'"
+            );
+        }
+
+        var strippedClassName = entitlementClassName.substring(0, entitlementClassName.indexOf("Entitlement"));
+        return Arrays.stream(strippedClassName.split("(?=\\p{Lu})"))
+            .filter(Predicate.not(String::isEmpty))
+            .map(s -> s.toLowerCase(Locale.ROOT))
+            .collect(Collectors.joining("_"));
+    }
+
     public PolicyParser(InputStream inputStream, String policyName) throws IOException {
         this.policyParser = YamlXContent.yamlXContent.createParser(XContentParserConfiguration.EMPTY, Objects.requireNonNull(inputStream));
         this.policyName = policyName;
@@ -67,18 +88,23 @@ protected Scope parseScope(String scopeName) throws IOException {
             }
             List<Entitlement> entitlements = new ArrayList<>();
             while (policyParser.nextToken() != XContentParser.Token.END_ARRAY) {
-                if (policyParser.currentToken() != XContentParser.Token.START_OBJECT) {
-                    throw newPolicyParserException(scopeName, "expected object <entitlement type>");
-                }
-                if (policyParser.nextToken() != XContentParser.Token.FIELD_NAME) {
+                if (policyParser.currentToken() == XContentParser.Token.VALUE_STRING) {
+                    String entitlementType = policyParser.text();
+                    Entitlement entitlement = parseEntitlement(scopeName, entitlementType);
+                    entitlements.add(entitlement);
+                } else if (policyParser.currentToken() == XContentParser.Token.START_OBJECT) {
+                    if (policyParser.nextToken() != XContentParser.Token.FIELD_NAME) {
+                        throw newPolicyParserException(scopeName, "expected object <entitlement type>");
+                    }
+                    String entitlementType = policyParser.currentName();
+                    Entitlement entitlement = parseEntitlement(scopeName, entitlementType);
+                    entitlements.add(entitlement);
+                    if (policyParser.nextToken() != XContentParser.Token.END_OBJECT) {
+                        throw newPolicyParserException(scopeName, "expected closing object");
+                    }
+                } else {
                     throw newPolicyParserException(scopeName, "expected object <entitlement type>");
                 }
-                String entitlementType = policyParser.currentName();
-                Entitlement entitlement = parseEntitlement(scopeName, entitlementType);
-                entitlements.add(entitlement);
-                if (policyParser.nextToken() != XContentParser.Token.END_OBJECT) {
-                    throw newPolicyParserException(scopeName, "expected closing object");
-                }
             }
             return new Scope(scopeName, entitlements);
         } catch (IOException ioe) {
@@ -87,34 +113,29 @@ protected Scope parseScope(String scopeName) throws IOException {
     }
 
     protected Entitlement parseEntitlement(String scopeName, String entitlementType) throws IOException {
-        Class<?> entitlementClass;
-        try {
-            entitlementClass = Class.forName(
-                entitlementPackageName
-                    + "."
-                    + Character.toUpperCase(entitlementType.charAt(0))
-                    + entitlementType.substring(1)
-                    + "Entitlement"
-            );
-        } catch (ClassNotFoundException cnfe) {
-            throw newPolicyParserException(scopeName, "unknown entitlement type [" + entitlementType + "]");
-        }
-        if (Entitlement.class.isAssignableFrom(entitlementClass) == false) {
+        Class<?> entitlementClass = EXTERNAL_ENTITLEMENTS.get(entitlementType);
+
+        if (entitlementClass == null) {
             throw newPolicyParserException(scopeName, "unknown entitlement type [" + entitlementType + "]");
         }
+
         Constructor<?> entitlementConstructor = entitlementClass.getConstructors()[0];
         ExternalEntitlement entitlementMetadata = entitlementConstructor.getAnnotation(ExternalEntitlement.class);
         if (entitlementMetadata == null) {
             throw newPolicyParserException(scopeName, "unknown entitlement type [" + entitlementType + "]");
         }
 
-        if (policyParser.nextToken() != XContentParser.Token.START_OBJECT) {
-            throw newPolicyParserException(scopeName, entitlementType, "expected entitlement parameters");
+        Class<?>[] parameterTypes = entitlementConstructor.getParameterTypes();
+        String[] parametersNames = entitlementMetadata.parameterNames();
+
+        if (parameterTypes.length != 0 || parametersNames.length != 0) {
+            if (policyParser.nextToken() != XContentParser.Token.START_OBJECT) {
+                throw newPolicyParserException(scopeName, entitlementType, "expected entitlement parameters");
+            }
         }
+
         Map<String, Object> parsedValues = policyParser.map();
 
-        Class<?>[] parameterTypes = entitlementConstructor.getParameterTypes();
-        String[] parametersNames = entitlementMetadata.parameterNames();
         Object[] parameterValues = new Object[parameterTypes.length];
         for (int parameterIndex = 0; parameterIndex < parameterTypes.length; ++parameterIndex) {
             String parameterName = parametersNames[parameterIndex];
diff --git a/libs/entitlement/src/test/java/org/elasticsearch/entitlement/runtime/policy/PolicyParserFailureTests.java b/libs/entitlement/src/test/java/org/elasticsearch/entitlement/runtime/policy/PolicyParserFailureTests.java
index de8280ea87fe5..7eb2b1fb476b3 100644
--- a/libs/entitlement/src/test/java/org/elasticsearch/entitlement/runtime/policy/PolicyParserFailureTests.java
+++ b/libs/entitlement/src/test/java/org/elasticsearch/entitlement/runtime/policy/PolicyParserFailureTests.java
@@ -12,7 +12,6 @@
 import org.elasticsearch.test.ESTestCase;
 
 import java.io.ByteArrayInputStream;
-import java.io.IOException;
 import java.nio.charset.StandardCharsets;
 
 public class PolicyParserFailureTests extends ESTestCase {
@@ -26,7 +25,7 @@ public void testParserSyntaxFailures() {
         assertEquals("[1:1] policy parsing error for [test-failure-policy.yaml]: expected object <scope name>", ppe.getMessage());
     }
 
-    public void testEntitlementDoesNotExist() throws IOException {
+    public void testEntitlementDoesNotExist() {
         PolicyParserException ppe = expectThrows(PolicyParserException.class, () -> new PolicyParser(new ByteArrayInputStream("""
             entitlement-module-name:
               - does_not_exist: {}
@@ -38,7 +37,7 @@ public void testEntitlementDoesNotExist() throws IOException {
         );
     }
 
-    public void testEntitlementMissingParameter() throws IOException {
+    public void testEntitlementMissingParameter() {
         PolicyParserException ppe = expectThrows(PolicyParserException.class, () -> new PolicyParser(new ByteArrayInputStream("""
             entitlement-module-name:
               - file: {}
@@ -61,7 +60,7 @@ public void testEntitlementMissingParameter() throws IOException {
         );
     }
 
-    public void testEntitlementExtraneousParameter() throws IOException {
+    public void testEntitlementExtraneousParameter() {
         PolicyParserException ppe = expectThrows(PolicyParserException.class, () -> new PolicyParser(new ByteArrayInputStream("""
             entitlement-module-name:
               - file:
diff --git a/libs/entitlement/src/test/java/org/elasticsearch/entitlement/runtime/policy/PolicyParserTests.java b/libs/entitlement/src/test/java/org/elasticsearch/entitlement/runtime/policy/PolicyParserTests.java
index 40016b2e3027e..a514cfe418895 100644
--- a/libs/entitlement/src/test/java/org/elasticsearch/entitlement/runtime/policy/PolicyParserTests.java
+++ b/libs/entitlement/src/test/java/org/elasticsearch/entitlement/runtime/policy/PolicyParserTests.java
@@ -11,11 +11,31 @@
 
 import org.elasticsearch.test.ESTestCase;
 
+import java.io.ByteArrayInputStream;
 import java.io.IOException;
+import java.nio.charset.StandardCharsets;
 import java.util.List;
 
+import static org.elasticsearch.test.LambdaMatchers.transformedMatch;
+import static org.hamcrest.Matchers.both;
+import static org.hamcrest.Matchers.contains;
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.instanceOf;
+
 public class PolicyParserTests extends ESTestCase {
 
+    private static class TestWrongEntitlementName implements Entitlement {}
+
+    public void testGetEntitlementTypeName() {
+        assertEquals("create_class_loader", PolicyParser.getEntitlementTypeName(CreateClassLoaderEntitlement.class));
+
+        var ex = expectThrows(IllegalArgumentException.class, () -> PolicyParser.getEntitlementTypeName(TestWrongEntitlementName.class));
+        assertThat(
+            ex.getMessage(),
+            equalTo("TestWrongEntitlementName is not a valid Entitlement class name. A valid class name must end with 'Entitlement'")
+        );
+    }
+
     public void testPolicyBuilder() throws IOException {
         Policy parsedPolicy = new PolicyParser(PolicyParserTests.class.getResourceAsStream("test-policy.yaml"), "test-policy.yaml")
             .parsePolicy();
@@ -25,4 +45,23 @@ public void testPolicyBuilder() throws IOException {
         );
         assertEquals(parsedPolicy, builtPolicy);
     }
+
+    public void testParseCreateClassloader() throws IOException {
+        Policy parsedPolicy = new PolicyParser(new ByteArrayInputStream("""
+            entitlement-module-name:
+              - create_class_loader
+            """.getBytes(StandardCharsets.UTF_8)), "test-policy.yaml").parsePolicy();
+        Policy builtPolicy = new Policy(
+            "test-policy.yaml",
+            List.of(new Scope("entitlement-module-name", List.of(new CreateClassLoaderEntitlement())))
+        );
+        assertThat(
+            parsedPolicy.scopes,
+            contains(
+                both(transformedMatch((Scope scope) -> scope.name, equalTo("entitlement-module-name"))).and(
+                    transformedMatch(scope -> scope.entitlements, contains(instanceOf(CreateClassLoaderEntitlement.class)))
+                )
+            )
+        );
+    }
 }

From c09bdfb5a0215257e8c8cd1f7ef8ffa345503f56 Mon Sep 17 00:00:00 2001
From: Luke Whiting <luke.whiting@elastic.co>
Date: Wed, 4 Dec 2024 12:27:42 +0000
Subject: [PATCH 012/119] Watcher history index has too many indexed fields -
 (#71479) (#117701)

* Exclude result.input.chain from watcher history index mappings

* Update docs/changelog/117701.yaml

* Fixup text now fields are disabled higher up the chain

* Revert priority change
---
 docs/changelog/117701.yaml                               | 6 ++++++
 .../support/WatcherIndexTemplateRegistryField.java       | 3 ++-
 .../src/main/resources/watch-history-no-ilm.json         | 9 +++++++++
 .../src/main/resources/watch-history.json                | 9 +++++++++
 .../test/integration/HistoryIntegrationTests.java        | 6 +++---
 5 files changed, 29 insertions(+), 4 deletions(-)
 create mode 100644 docs/changelog/117701.yaml

diff --git a/docs/changelog/117701.yaml b/docs/changelog/117701.yaml
new file mode 100644
index 0000000000000..5a72bdeb143e6
--- /dev/null
+++ b/docs/changelog/117701.yaml
@@ -0,0 +1,6 @@
+pr: 117701
+summary: Watcher history index has too many indexed fields -
+area: Watcher
+type: bug
+issues:
+ - 71479
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/watcher/support/WatcherIndexTemplateRegistryField.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/watcher/support/WatcherIndexTemplateRegistryField.java
index 20dcb84dffe3f..098549029e0ce 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/watcher/support/WatcherIndexTemplateRegistryField.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/watcher/support/WatcherIndexTemplateRegistryField.java
@@ -22,8 +22,9 @@ public final class WatcherIndexTemplateRegistryField {
     // version 14: move watch history to data stream
     // version 15: remove watches and triggered watches, these are now system indices
     // version 16: change watch history ILM policy
+    // version 17: exclude input chain from indexing
     // Note: if you change this, also inform the kibana team around the watcher-ui
-    public static final int INDEX_TEMPLATE_VERSION = 16;
+    public static final int INDEX_TEMPLATE_VERSION = 17;
     public static final String HISTORY_TEMPLATE_NAME = ".watch-history-" + INDEX_TEMPLATE_VERSION;
     public static final String HISTORY_TEMPLATE_NAME_NO_ILM = ".watch-history-no-ilm-" + INDEX_TEMPLATE_VERSION;
     public static final String[] TEMPLATE_NAMES = new String[] { HISTORY_TEMPLATE_NAME };
diff --git a/x-pack/plugin/core/template-resources/src/main/resources/watch-history-no-ilm.json b/x-pack/plugin/core/template-resources/src/main/resources/watch-history-no-ilm.json
index 2eed69c7c58e6..da459cda13463 100644
--- a/x-pack/plugin/core/template-resources/src/main/resources/watch-history-no-ilm.json
+++ b/x-pack/plugin/core/template-resources/src/main/resources/watch-history-no-ilm.json
@@ -54,6 +54,15 @@
               "enabled": false
             }
           }
+        },
+        {
+          "disabled_result_input_chain_fields": {
+            "path_match": "result.input.chain",
+            "mapping": {
+              "type": "object",
+              "enabled": false
+            }
+          }
         }
       ],
       "dynamic": false,
diff --git a/x-pack/plugin/core/template-resources/src/main/resources/watch-history.json b/x-pack/plugin/core/template-resources/src/main/resources/watch-history.json
index 19e4dc022daa1..2abf6570d1f8e 100644
--- a/x-pack/plugin/core/template-resources/src/main/resources/watch-history.json
+++ b/x-pack/plugin/core/template-resources/src/main/resources/watch-history.json
@@ -55,6 +55,15 @@
               "enabled": false
             }
           }
+        },
+        {
+          "disabled_result_input_chain_fields": {
+            "path_match": "result.input.chain",
+            "mapping": {
+              "type": "object",
+              "enabled": false
+            }
+          }
         }
       ],
       "dynamic": false,
diff --git a/x-pack/plugin/watcher/src/internalClusterTest/java/org/elasticsearch/xpack/watcher/test/integration/HistoryIntegrationTests.java b/x-pack/plugin/watcher/src/internalClusterTest/java/org/elasticsearch/xpack/watcher/test/integration/HistoryIntegrationTests.java
index 0070554d99d27..1bcdd060994ce 100644
--- a/x-pack/plugin/watcher/src/internalClusterTest/java/org/elasticsearch/xpack/watcher/test/integration/HistoryIntegrationTests.java
+++ b/x-pack/plugin/watcher/src/internalClusterTest/java/org/elasticsearch/xpack/watcher/test/integration/HistoryIntegrationTests.java
@@ -130,7 +130,7 @@ public void testFailedInputResultWithDotsInFieldNameGetsStored() throws Exceptio
             String chainedPath = SINGLE_MAPPING_NAME
                 + ".properties.result.properties.input.properties.chain.properties.chained.properties.search"
                 + ".properties.request.properties.body.enabled";
-            assertThat(source.getValue(chainedPath), is(false));
+            assertThat(source.getValue(chainedPath), nullValue());
         } else {
             String path = SINGLE_MAPPING_NAME
                 + ".properties.result.properties.input.properties.search.properties.request.properties.body.enabled";
@@ -168,11 +168,11 @@ public void testPayloadInputWithDotsInFieldNameWorks() throws Exception {
             XContentType.JSON
         );
 
-        // lets make sure the body fields are disabled
+        // let's make sure the body fields are disabled or, in the case of chained, the whole object is not indexed
         if (useChained) {
             String path = SINGLE_MAPPING_NAME
                 + ".properties.result.properties.input.properties.chain.properties.chained.properties.payload.enabled";
-            assertThat(source.getValue(path), is(false));
+            assertThat(source.getValue(path), nullValue());
         } else {
             String path = SINGLE_MAPPING_NAME + ".properties.result.properties.input.properties.payload.enabled";
             assertThat(source.getValue(path), is(false));

From 59fd7bf502eebebf08f56cd73b376f5c5f171851 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Wed, 4 Dec 2024 23:50:37 +1100
Subject: [PATCH 013/119] Mute
 org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT test
 {lookup-join.LookupMessageFromIndex SYNC} #117980

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index c3fe9425def2d..871afa5555f58 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -251,6 +251,9 @@ tests:
 - class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
   method: test {lookup-join.LookupMessageFromIndexKeep ASYNC}
   issue: https://github.com/elastic/elasticsearch/issues/117976
+- class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
+  method: test {lookup-join.LookupMessageFromIndex SYNC}
+  issue: https://github.com/elastic/elasticsearch/issues/117980
 
 # Examples:
 #

From 2244070da4f34d08f6bfc20150c86129251292e4 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Wed, 4 Dec 2024 23:50:57 +1100
Subject: [PATCH 014/119] Mute
 org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
 org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT #117981

---
 muted-tests.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 871afa5555f58..651a1ee1ad1c9 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -254,6 +254,8 @@ tests:
 - class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
   method: test {lookup-join.LookupMessageFromIndex SYNC}
   issue: https://github.com/elastic/elasticsearch/issues/117980
+- class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
+  issue: https://github.com/elastic/elasticsearch/issues/117981
 
 # Examples:
 #

From 97601b1b0b1c2249fcd55d13994981afa6eeeab3 Mon Sep 17 00:00:00 2001
From: Kathleen DeRusso <kathleen.derusso@elastic.co>
Date: Wed, 4 Dec 2024 08:10:56 -0500
Subject: [PATCH 015/119] Kderusso/sparse vector ci failure (#117930)

* Fix CI failure in SparseVectorQueryBuilderTests

* Unmute test
---
 muted-tests.yml                                             | 3 ---
 .../xpack/core/ml/search/SparseVectorQueryBuilderTests.java | 6 ++++++
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index 651a1ee1ad1c9..de11f0da32c44 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -221,9 +221,6 @@ tests:
   issue: https://github.com/elastic/elasticsearch/issues/117815
 - class: org.elasticsearch.xpack.ml.integration.DatafeedJobsRestIT
   issue: https://github.com/elastic/elasticsearch/issues/111319
-- class: org.elasticsearch.xpack.core.ml.search.SparseVectorQueryBuilderTests
-  method: testToQuery
-  issue: https://github.com/elastic/elasticsearch/issues/117904
 - class: org.elasticsearch.packaging.test.ArchiveGenerateInitialCredentialsTests
   method: test20NoAutoGenerationWhenAutoConfigurationDisabled
   issue: https://github.com/elastic/elasticsearch/issues/117891
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/search/SparseVectorQueryBuilderTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/search/SparseVectorQueryBuilderTests.java
index 9872d95de024a..a5c1ba45d90b7 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/search/SparseVectorQueryBuilderTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/search/SparseVectorQueryBuilderTests.java
@@ -232,6 +232,12 @@ public void testToQuery() throws IOException {
 
     private void testDoToQuery(SparseVectorQueryBuilder queryBuilder, SearchExecutionContext context) throws IOException {
         Query query = queryBuilder.doToQuery(context);
+
+        // test query builder can randomly have no vectors, which rewrites to a MatchNoneQuery - nothing more to do in this case.
+        if (query instanceof MatchNoDocsQuery) {
+            return;
+        }
+
         assertTrue(query instanceof SparseVectorQueryWrapper);
         var sparseQuery = (SparseVectorQueryWrapper) query;
         if (queryBuilder.shouldPruneTokens()) {

From ba1d5be199293d843414c5b1e4ea153ce651a06f Mon Sep 17 00:00:00 2001
From: kosabogi <105062005+kosabogi@users.noreply.github.com>
Date: Wed, 4 Dec 2024 14:22:26 +0100
Subject: [PATCH 016/119] Updates minimum_number_of_allocations description
 (#117746)

---
 docs/reference/ml/ml-shared.asciidoc | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/reference/ml/ml-shared.asciidoc b/docs/reference/ml/ml-shared.asciidoc
index d01047eac9815..4948db48664ed 100644
--- a/docs/reference/ml/ml-shared.asciidoc
+++ b/docs/reference/ml/ml-shared.asciidoc
@@ -18,7 +18,8 @@ end::adaptive-allocation-max-number[]
 
 tag::adaptive-allocation-min-number[]
 Specifies the minimum number of allocations to scale to.
-If set, it must be greater than or equal to `1`.
+If set, it must be greater than or equal to `0`.
+If not defined, the deployment scales to `0`.
 end::adaptive-allocation-min-number[]
 
 tag::aggregations[]

From 6855a4ecd3ea8989c995763dafcc0cdbcb25bc41 Mon Sep 17 00:00:00 2001
From: kosabogi <105062005+kosabogi@users.noreply.github.com>
Date: Wed, 4 Dec 2024 14:22:59 +0100
Subject: [PATCH 017/119] [DOCS] Adds adaptive allocations information to
 Inference APIs (#117546)

* Adds adaptive allocations information to Inference APIs

* Update docs/reference/inference/inference-apis.asciidoc

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>

* Update docs/reference/inference/put-inference.asciidoc

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>

* Update docs/reference/inference/inference-apis.asciidoc

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>

---------

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>
---
 docs/reference/inference/inference-apis.asciidoc | 13 +++++++++++++
 docs/reference/inference/put-inference.asciidoc  | 15 ++++++++++++++-
 2 files changed, 27 insertions(+), 1 deletion(-)

diff --git a/docs/reference/inference/inference-apis.asciidoc b/docs/reference/inference/inference-apis.asciidoc
index 037d7abeb2a36..c7b779a994a05 100644
--- a/docs/reference/inference/inference-apis.asciidoc
+++ b/docs/reference/inference/inference-apis.asciidoc
@@ -35,6 +35,19 @@ Elastic –, then create an {infer} endpoint by the <<put-inference-api>>.
 Now use <<semantic-search-semantic-text, semantic text>> to perform
 <<semantic-search, semantic search>> on your data.
 
+[discrete]
+[[adaptive-allocations]]
+=== Adaptive allocations
+
+Adaptive allocations allow inference services to dynamically adjust the number of model allocations based on the current load.
+
+When adaptive allocations are enabled:
+
+* The number of allocations scales up automatically when the load increases.
+- Allocations scale down to a minimum of 0 when the load decreases, saving resources.
+
+For more information about adaptive allocations and resources, refer to the {ml-docs}/ml-nlp-auto-scale.html[trained model autoscaling] documentation.
+
 //[discrete]
 //[[default-enpoints]]
 //=== Default {infer} endpoints
diff --git a/docs/reference/inference/put-inference.asciidoc b/docs/reference/inference/put-inference.asciidoc
index e7e25ec98b49d..ed93c290b6ad4 100644
--- a/docs/reference/inference/put-inference.asciidoc
+++ b/docs/reference/inference/put-inference.asciidoc
@@ -67,4 +67,17 @@ Click the links to review the configuration details of the services:
 * <<infer-service-watsonx-ai>> (`text_embedding`)
 
 The {es} and ELSER services run on a {ml} node in your {es} cluster. The rest of
-the services connect to external providers.
\ No newline at end of file
+the services connect to external providers.
+
+[discrete]
+[[adaptive-allocations-put-inference]]
+==== Adaptive allocations
+
+Adaptive allocations allow inference services to dynamically adjust the number of model allocations based on the current load.
+
+When adaptive allocations are enabled:
+
+- The number of allocations scales up automatically when the load increases.
+- Allocations scale down to a minimum of 0 when the load decreases, saving resources.
+
+For more information about adaptive allocations and resources, refer to the {ml-docs}/ml-nlp-auto-scale.html[trained model autoscaling] documentation.
\ No newline at end of file

From ec27e20c80f402e09822f5e1b4ebc7b02fc6196d Mon Sep 17 00:00:00 2001
From: Keith Massey <keith.massey@elastic.co>
Date: Wed, 4 Dec 2024 07:37:57 -0600
Subject: [PATCH 018/119] Removing unnecessary state from DataStreamReindexTask
 (#117942)

---
 ...indexDataStreamPersistentTaskExecutor.java |  9 ++---
 .../migrate/task/ReindexDataStreamTask.java   | 35 ++++++++++---------
 2 files changed, 24 insertions(+), 20 deletions(-)

diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java
index e2a41ea186643..0f3f8b17f27ad 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java
@@ -51,7 +51,6 @@ protected ReindexDataStreamTask createTask(
             params.startTime(),
             params.totalIndices(),
             params.totalIndicesToBeUpgraded(),
-            threadPool,
             id,
             type,
             action,
@@ -74,9 +73,11 @@ protected void nodeOperation(AllocatedPersistentTask task, ReindexDataStreamTask
                 List<Index> indicesToBeReindexed = indices.stream()
                     .filter(index -> clusterService.state().getMetadata().index(index).getCreationVersion().isLegacyIndexVersion())
                     .toList();
-                reindexDataStreamTask.setPendingIndices(indicesToBeReindexed.stream().map(Index::getName).toList());
+                reindexDataStreamTask.setPendingIndicesCount(indicesToBeReindexed.size());
                 for (Index index : indicesToBeReindexed) {
+                    reindexDataStreamTask.incrementInProgressIndicesCount();
                     // TODO This is just a placeholder. This is where the real data stream reindex logic will go
+                    reindexDataStreamTask.reindexSucceeded();
                 }
 
                 completeSuccessfulPersistentTask(reindexDataStreamTask);
@@ -87,12 +88,12 @@ protected void nodeOperation(AllocatedPersistentTask task, ReindexDataStreamTask
     }
 
     private void completeSuccessfulPersistentTask(ReindexDataStreamTask persistentTask) {
-        persistentTask.reindexSucceeded();
+        persistentTask.allReindexesCompleted();
         threadPool.schedule(persistentTask::markAsCompleted, getTimeToLive(persistentTask), threadPool.generic());
     }
 
     private void completeFailedPersistentTask(ReindexDataStreamTask persistentTask, Exception e) {
-        persistentTask.reindexFailed(e);
+        persistentTask.taskFailed(e);
         threadPool.schedule(() -> persistentTask.markAsFailed(e), getTimeToLive(persistentTask), threadPool.generic());
     }
 
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamTask.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamTask.java
index 722b30d9970db..72ddb87e9dea5 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamTask.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamTask.java
@@ -10,29 +10,27 @@
 import org.elasticsearch.core.Tuple;
 import org.elasticsearch.persistent.AllocatedPersistentTask;
 import org.elasticsearch.tasks.TaskId;
-import org.elasticsearch.threadpool.ThreadPool;
 
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Map;
+import java.util.concurrent.atomic.AtomicInteger;
 
 public class ReindexDataStreamTask extends AllocatedPersistentTask {
     public static final String TASK_NAME = "reindex-data-stream";
     private final long persistentTaskStartTime;
     private final int totalIndices;
     private final int totalIndicesToBeUpgraded;
-    private final ThreadPool threadPool;
     private boolean complete = false;
     private Exception exception;
-    private List<String> inProgress = new ArrayList<>();
-    private List<String> pending = List.of();
+    private AtomicInteger inProgress = new AtomicInteger(0);
+    private AtomicInteger pending = new AtomicInteger();
     private List<Tuple<String, Exception>> errors = new ArrayList<>();
 
     public ReindexDataStreamTask(
         long persistentTaskStartTime,
         int totalIndices,
         int totalIndicesToBeUpgraded,
-        ThreadPool threadPool,
         long id,
         String type,
         String action,
@@ -44,7 +42,6 @@ public ReindexDataStreamTask(
         this.persistentTaskStartTime = persistentTaskStartTime;
         this.totalIndices = totalIndices;
         this.totalIndicesToBeUpgraded = totalIndicesToBeUpgraded;
-        this.threadPool = threadPool;
     }
 
     @Override
@@ -55,30 +52,36 @@ public ReindexDataStreamStatus getStatus() {
             totalIndicesToBeUpgraded,
             complete,
             exception,
-            inProgress.size(),
-            pending.size(),
+            inProgress.get(),
+            pending.get(),
             errors
         );
     }
 
-    public void reindexSucceeded() {
+    public void allReindexesCompleted() {
         this.complete = true;
     }
 
-    public void reindexFailed(Exception e) {
+    public void taskFailed(Exception e) {
         this.complete = true;
         this.exception = e;
     }
 
-    public void setInProgressIndices(List<String> inProgressIndices) {
-        this.inProgress = inProgressIndices;
+    public void reindexSucceeded() {
+        inProgress.decrementAndGet();
+    }
+
+    public void reindexFailed(String index, Exception error) {
+        this.errors.add(Tuple.tuple(index, error));
+        inProgress.decrementAndGet();
     }
 
-    public void setPendingIndices(List<String> pendingIndices) {
-        this.pending = pendingIndices;
+    public void incrementInProgressIndicesCount() {
+        inProgress.incrementAndGet();
+        pending.decrementAndGet();
     }
 
-    public void addErrorIndex(String index, Exception error) {
-        this.errors.add(Tuple.tuple(index, error));
+    public void setPendingIndicesCount(int size) {
+        pending.set(size);
     }
 }

From bbf986dd2c46a1ea4fec2eabe12b5706ab4f3682 Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Wed, 4 Dec 2024 10:20:49 -0500
Subject: [PATCH 019/119] ESQL: Limit size of query (#117898)

Queries bigger than a mb tend to take a lot of memory. In the worse case
it's an astounding amount of memory.
---
 docs/changelog/117898.yaml                    |  5 +++++
 .../xpack/esql/heap_attack/HeapAttackIT.java  | 21 +++++++++++++++++++
 .../xpack/esql/parser/EsqlParser.java         | 17 ++++++++++++++-
 .../xpack/esql/analysis/ParsingTests.java     |  8 +++++++
 4 files changed, 50 insertions(+), 1 deletion(-)
 create mode 100644 docs/changelog/117898.yaml

diff --git a/docs/changelog/117898.yaml b/docs/changelog/117898.yaml
new file mode 100644
index 0000000000000..c60061abc49ff
--- /dev/null
+++ b/docs/changelog/117898.yaml
@@ -0,0 +1,5 @@
+pr: 117898
+summary: Limit size of query
+area: ES|QL
+type: bug
+issues: []
diff --git a/test/external-modules/esql-heap-attack/src/javaRestTest/java/org/elasticsearch/xpack/esql/heap_attack/HeapAttackIT.java b/test/external-modules/esql-heap-attack/src/javaRestTest/java/org/elasticsearch/xpack/esql/heap_attack/HeapAttackIT.java
index 8b9176a346e30..ace3db377664c 100644
--- a/test/external-modules/esql-heap-attack/src/javaRestTest/java/org/elasticsearch/xpack/esql/heap_attack/HeapAttackIT.java
+++ b/test/external-modules/esql-heap-attack/src/javaRestTest/java/org/elasticsearch/xpack/esql/heap_attack/HeapAttackIT.java
@@ -194,6 +194,13 @@ private void assertCircuitBreaks(ThrowingRunnable r) throws IOException {
         );
     }
 
+    private void assertParseFailure(ThrowingRunnable r) throws IOException {
+        ResponseException e = expectThrows(ResponseException.class, r);
+        Map<?, ?> map = responseAsMap(e.getResponse());
+        logger.info("expected parse failure {}", map);
+        assertMap(map, matchesMap().entry("status", 400).entry("error", matchesMap().extraOk().entry("type", "parsing_exception")));
+    }
+
     private Response sortByManyLongs(int count) throws IOException {
         logger.info("sorting by {} longs", count);
         return query(makeSortByManyLongs(count).toString(), null);
@@ -318,6 +325,13 @@ public void testManyConcatFromRow() throws IOException {
         assertManyStrings(resp, strings);
     }
 
+    /**
+     * Fails to parse a huge huge query.
+     */
+    public void testHugeHugeManyConcatFromRow() throws IOException {
+        assertParseFailure(() -> manyConcat("ROW a=9999, b=9999, c=9999, d=9999, e=9999", 50000));
+    }
+
     /**
      * Tests that generate many moderately long strings.
      */
@@ -378,6 +392,13 @@ public void testManyRepeatFromRow() throws IOException {
         assertManyStrings(resp, strings);
     }
 
+    /**
+     * Fails to parse a huge huge query.
+     */
+    public void testHugeHugeManyRepeatFromRow() throws IOException {
+        assertParseFailure(() -> manyRepeat("ROW a = 99", 100000));
+    }
+
     /**
      * Tests that generate many moderately long strings.
      */
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/EsqlParser.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/EsqlParser.java
index 620a25e0170ea..2e55b4df1e223 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/EsqlParser.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/parser/EsqlParser.java
@@ -33,6 +33,15 @@ public class EsqlParser {
 
     private static final Logger log = LogManager.getLogger(EsqlParser.class);
 
+    /**
+     * Maximum number of characters in an ESQL query. Antlr may parse the entire
+     * query into tokens to make the choices, buffering the world. There's a lot we
+     * can do in the grammar to prevent that, but let's be paranoid and assume we'll
+     * fail at preventing antlr from slurping in the world. Instead, let's make sure
+     * that the world just isn't that big.
+     */
+    public static final int MAX_LENGTH = 1_000_000;
+
     private EsqlConfig config = new EsqlConfig();
 
     public EsqlConfig config() {
@@ -60,8 +69,14 @@ private <T> T invokeParser(
         Function<EsqlBaseParser, ParserRuleContext> parseFunction,
         BiFunction<AstBuilder, ParserRuleContext, T> result
     ) {
+        if (query.length() > MAX_LENGTH) {
+            throw new org.elasticsearch.xpack.esql.core.ParsingException(
+                "ESQL statement is too large [{} characters > {}]",
+                query.length(),
+                MAX_LENGTH
+            );
+        }
         try {
-            // new CaseChangingCharStream()
             EsqlBaseLexer lexer = new EsqlBaseLexer(CharStreams.fromString(query));
 
             lexer.removeErrorListeners();
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/ParsingTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/ParsingTests.java
index 3cafd42b731f6..68529e99c6b1b 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/ParsingTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/ParsingTests.java
@@ -103,6 +103,14 @@ public void testInlineCast() throws IOException {
         logger.info("Wrote to file: {}", file);
     }
 
+    public void testTooBigQuery() {
+        StringBuilder query = new StringBuilder("FROM foo | EVAL a = a");
+        while (query.length() < EsqlParser.MAX_LENGTH) {
+            query.append(", a = CONCAT(a, a)");
+        }
+        assertEquals("-1:0: ESQL statement is too large [1000011 characters > 1000000]", error(query.toString()));
+    }
+
     private String functionName(EsqlFunctionRegistry registry, Expression functionCall) {
         for (FunctionDefinition def : registry.listFunctions()) {
             if (functionCall.getClass().equals(def.clazz())) {

From cb35dc96f689e1e7ed4b7ce21a9923ce6d796405 Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Wed, 4 Dec 2024 07:30:26 -0800
Subject: [PATCH 020/119] Make Murmur3Hasher#update public (#117961)

Closes #117883
---
 .../java/org/elasticsearch/common/hash/Murmur3Hasher.java  | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/server/src/main/java/org/elasticsearch/common/hash/Murmur3Hasher.java b/server/src/main/java/org/elasticsearch/common/hash/Murmur3Hasher.java
index 817587771d795..aec28484138fb 100644
--- a/server/src/main/java/org/elasticsearch/common/hash/Murmur3Hasher.java
+++ b/server/src/main/java/org/elasticsearch/common/hash/Murmur3Hasher.java
@@ -40,7 +40,12 @@ public void update(byte[] inputBytes) {
         update(inputBytes, 0, inputBytes.length);
     }
 
-    private void update(byte[] inputBytes, int offset, int length) {
+    /**
+     * Similar to {@link #update(byte[])}, but processes a specific portion of the input bytes
+     * starting from the given {@code offset} for the specified {@code length}.
+     * @see #update(byte[])
+     */
+    public void update(byte[] inputBytes, int offset, int length) {
         if (remainderLength + length >= remainder.length) {
             if (remainderLength > 0) {
                 // fill rest of remainder from inputBytes and hash remainder

From ef11b44b4319e0f5cfef9186519ed1f7dc2fede2 Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Wed, 4 Dec 2024 07:32:00 -0800
Subject: [PATCH 021/119] Acquire stats searcher for data stream stats
 (#117953)

Here, we only need to extract the minimum and maximum values of the
timestamp field; therefore, using a stats searcher should suffice. This
is important for frozen indices.
---
 docs/changelog/117953.yaml                                   | 5 +++++
 .../datastreams/action/DataStreamsStatsTransportAction.java  | 3 ++-
 2 files changed, 7 insertions(+), 1 deletion(-)
 create mode 100644 docs/changelog/117953.yaml

diff --git a/docs/changelog/117953.yaml b/docs/changelog/117953.yaml
new file mode 100644
index 0000000000000..62f0218b1cdc7
--- /dev/null
+++ b/docs/changelog/117953.yaml
@@ -0,0 +1,5 @@
+pr: 117953
+summary: Acquire stats searcher for data stream stats
+area: Data streams
+type: bug
+issues: []
diff --git a/modules/data-streams/src/main/java/org/elasticsearch/datastreams/action/DataStreamsStatsTransportAction.java b/modules/data-streams/src/main/java/org/elasticsearch/datastreams/action/DataStreamsStatsTransportAction.java
index 1b0b0aa6abebe..1d3b1b676282a 100644
--- a/modules/data-streams/src/main/java/org/elasticsearch/datastreams/action/DataStreamsStatsTransportAction.java
+++ b/modules/data-streams/src/main/java/org/elasticsearch/datastreams/action/DataStreamsStatsTransportAction.java
@@ -31,6 +31,7 @@
 import org.elasticsearch.index.Index;
 import org.elasticsearch.index.IndexService;
 import org.elasticsearch.index.engine.Engine;
+import org.elasticsearch.index.engine.ReadOnlyEngine;
 import org.elasticsearch.index.shard.IndexShard;
 import org.elasticsearch.index.store.StoreStats;
 import org.elasticsearch.indices.IndicesService;
@@ -130,7 +131,7 @@ protected void shardOperation(
             DataStream dataStream = indexAbstraction.getParentDataStream();
             assert dataStream != null;
             long maxTimestamp = 0L;
-            try (Engine.Searcher searcher = indexShard.acquireSearcher("data_stream_stats")) {
+            try (Engine.Searcher searcher = indexShard.acquireSearcher(ReadOnlyEngine.FIELD_RANGE_SEARCH_SOURCE)) {
                 IndexReader indexReader = searcher.getIndexReader();
                 byte[] maxPackedValue = PointValues.getMaxPackedValue(indexReader, DataStream.TIMESTAMP_FIELD_NAME);
                 if (maxPackedValue != null) {

From 6b329907dada4ad29a4093bf00ecb71319b95cfd Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Thu, 5 Dec 2024 02:36:05 +1100
Subject: [PATCH 022/119] Mute
 org.elasticsearch.packaging.test.ArchiveGenerateInitialCredentialsTests
 test30NoAutogenerationWhenDaemonized #117956

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index de11f0da32c44..beb8cb9591b4f 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -253,6 +253,9 @@ tests:
   issue: https://github.com/elastic/elasticsearch/issues/117980
 - class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
   issue: https://github.com/elastic/elasticsearch/issues/117981
+- class: org.elasticsearch.packaging.test.ArchiveGenerateInitialCredentialsTests
+  method: test30NoAutogenerationWhenDaemonized
+  issue: https://github.com/elastic/elasticsearch/issues/117956
 
 # Examples:
 #

From 94f65797ccb0378779550a2d4fca2b1528d65197 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Thu, 5 Dec 2024 02:36:09 +1100
Subject: [PATCH 023/119] Mute org.elasticsearch.packaging.test.CertGenCliTests
 test40RunWithCert #117955

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index beb8cb9591b4f..317b960f36c56 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -256,6 +256,9 @@ tests:
 - class: org.elasticsearch.packaging.test.ArchiveGenerateInitialCredentialsTests
   method: test30NoAutogenerationWhenDaemonized
   issue: https://github.com/elastic/elasticsearch/issues/117956
+- class: org.elasticsearch.packaging.test.CertGenCliTests
+  method: test40RunWithCert
+  issue: https://github.com/elastic/elasticsearch/issues/117955
 
 # Examples:
 #

From 9cf0cf155ad1069fe2e8fdaf830c3bc9a5e3d740 Mon Sep 17 00:00:00 2001
From: Ignacio Vera <ignacio.vera@elastic.co>
Date: Wed, 4 Dec 2024 17:05:24 +0100
Subject: [PATCH 024/119] Refactor how we build the final aggregations in
 GlobalOrdinalsStringTermsAggregator (#117627)

This change refactor the method #buildAggregations(LongArray owningBucketOrds) so it is specific to the Collection
strategy.
---
 .../GlobalOrdinalsStringTermsAggregator.java  | 261 +++++++++---------
 1 file changed, 133 insertions(+), 128 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/GlobalOrdinalsStringTermsAggregator.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/GlobalOrdinalsStringTermsAggregator.java
index 4cf710232c7a0..0ec03a6f56dd9 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/GlobalOrdinalsStringTermsAggregator.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/GlobalOrdinalsStringTermsAggregator.java
@@ -20,12 +20,10 @@
 import org.apache.lucene.util.PriorityQueue;
 import org.elasticsearch.common.CheckedSupplier;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.common.util.BigArrays;
 import org.elasticsearch.common.util.LongArray;
 import org.elasticsearch.common.util.LongHash;
 import org.elasticsearch.common.util.ObjectArray;
 import org.elasticsearch.common.util.ObjectArrayPriorityQueue;
-import org.elasticsearch.core.Nullable;
 import org.elasticsearch.core.Releasable;
 import org.elasticsearch.core.Releasables;
 import org.elasticsearch.search.DocValueFormat;
@@ -102,14 +100,14 @@ public GlobalOrdinalsStringTermsAggregator(
         this.valueCount = valuesSupplier.get().getValueCount();
         this.acceptedGlobalOrdinals = acceptedOrds;
         if (remapGlobalOrds) {
-            this.collectionStrategy = new RemapGlobalOrds(cardinality, excludeDeletedDocs);
+            this.collectionStrategy = new RemapGlobalOrds<>(this.resultStrategy, cardinality, excludeDeletedDocs);
         } else {
             this.collectionStrategy = cardinality.map(estimate -> {
                 if (estimate > 1) {
                     // This is a 500 class error, because we should never be able to reach it.
                     throw new AggregationExecutionException("Dense ords don't know how to collect from many buckets");
                 }
-                return new DenseGlobalOrds(excludeDeletedDocs);
+                return new DenseGlobalOrds<>(this.resultStrategy, excludeDeletedDocs);
             });
         }
     }
@@ -193,7 +191,13 @@ public void collect(int doc, long owningBucketOrd) throws IOException {
 
     @Override
     public InternalAggregation[] buildAggregations(LongArray owningBucketOrds) throws IOException {
-        return resultStrategy.buildAggregations(owningBucketOrds);
+        if (valueCount == 0) { // no context in this reader
+            return GlobalOrdinalsStringTermsAggregator.this.buildAggregations(
+                Math.toIntExact(owningBucketOrds.size()),
+                ordIdx -> resultStrategy.buildNoValuesResult(owningBucketOrds.get(ordIdx))
+            );
+        }
+        return collectionStrategy.buildAggregations(owningBucketOrds);
     }
 
     @Override
@@ -401,8 +405,8 @@ private void mapSegmentCountsToGlobalCounts(LongUnaryOperator mapping) throws IO
      * The {@link GlobalOrdinalsStringTermsAggregator} uses one of these
      * to collect the global ordinals by calling
      * {@link CollectionStrategy#collectGlobalOrd} for each global ordinal
-     * that it hits and then calling {@link CollectionStrategy#forEach}
-     * once to iterate on the results.
+     * that it hits and then calling {@link CollectionStrategy#buildAggregations}
+     * to generate the results.
      */
     abstract static class CollectionStrategy implements Releasable {
         /**
@@ -438,15 +442,9 @@ abstract static class CollectionStrategy implements Releasable {
         abstract long globalOrdToBucketOrd(long owningBucketOrd, long globalOrd);
 
         /**
-         * Iterate all of the buckets. Implementations take into account
-         * the {@link BucketCountThresholds}. In particular,
-         * if the {@link BucketCountThresholds#getMinDocCount()} is 0 then
-         * they'll make sure to iterate a bucket even if it was never
-         * {{@link #collectGlobalOrd collected}.
-         * If {@link BucketCountThresholds#getMinDocCount()} is not 0 then
-         * they'll skip all global ords that weren't collected.
+         * Create the aggregation result
          */
-        abstract void forEach(long owningBucketOrd, BucketInfoConsumer consumer) throws IOException;
+        abstract InternalAggregation[] buildAggregations(LongArray owningBucketOrds) throws IOException;
     }
 
     interface BucketInfoConsumer {
@@ -457,12 +455,17 @@ interface BucketInfoConsumer {
      * {@linkplain CollectionStrategy} that just uses the global ordinal as the
      * bucket ordinal.
      */
-    class DenseGlobalOrds extends CollectionStrategy {
+    class DenseGlobalOrds<
+        R extends InternalAggregation,
+        B extends InternalMultiBucketAggregation.InternalBucket,
+        TB extends InternalMultiBucketAggregation.InternalBucket> extends CollectionStrategy {
 
         private final boolean excludeDeletedDocs;
+        private final ResultStrategy<R, B, TB> collectionStrategy;
 
-        DenseGlobalOrds(boolean excludeDeletedDocs) {
+        DenseGlobalOrds(ResultStrategy<R, B, TB> collectionStrategy, boolean excludeDeletedDocs) {
             this.excludeDeletedDocs = excludeDeletedDocs;
+            this.collectionStrategy = collectionStrategy;
         }
 
         @Override
@@ -492,9 +495,7 @@ long globalOrdToBucketOrd(long owningBucketOrd, long globalOrd) {
             return globalOrd;
         }
 
-        @Override
-        void forEach(long owningBucketOrd, BucketInfoConsumer consumer) throws IOException {
-            assert owningBucketOrd == 0;
+        private void collect(BucketInfoConsumer consumer) throws IOException {
             if (excludeDeletedDocs) {
                 forEachExcludeDeletedDocs(consumer);
             } else {
@@ -518,7 +519,7 @@ private void forEachAllowDeletedDocs(BucketInfoConsumer consumer) throws IOExcep
          * Excludes deleted docs in the results by cross-checking with liveDocs.
          */
         private void forEachExcludeDeletedDocs(BucketInfoConsumer consumer) throws IOException {
-            try (LongHash accepted = new LongHash(20, new BigArrays(null, null, ""))) {
+            try (LongHash accepted = new LongHash(20, bigArrays())) {
                 for (LeafReaderContext ctx : searcher().getTopReaderContext().leaves()) {
                     LeafReader reader = ctx.reader();
                     Bits liveDocs = reader.getLiveDocs();
@@ -550,6 +551,55 @@ private void forEachExcludeDeletedDocs(BucketInfoConsumer consumer) throws IOExc
 
         @Override
         public void close() {}
+
+        @Override
+        InternalAggregation[] buildAggregations(LongArray owningBucketOrds) throws IOException {
+            assert owningBucketOrds.size() == 1 && owningBucketOrds.get(0) == 0;
+            try (
+                LongArray otherDocCount = bigArrays().newLongArray(1, true);
+                ObjectArray<B[]> topBucketsPreOrd = collectionStrategy.buildTopBucketsPerOrd(1)
+            ) {
+                GlobalOrdLookupFunction lookupGlobalOrd = valuesSupplier.get()::lookupOrd;
+                final int size = (int) Math.min(valueCount, bucketCountThresholds.getShardSize());
+                try (ObjectArrayPriorityQueue<TB> ordered = collectionStrategy.buildPriorityQueue(size)) {
+                    BucketUpdater<TB> updater = collectionStrategy.bucketUpdater(0, lookupGlobalOrd);
+                    collect(new BucketInfoConsumer() {
+                        TB spare = null;
+
+                        @Override
+                        public void accept(long globalOrd, long bucketOrd, long docCount) throws IOException {
+                            otherDocCount.increment(0, docCount);
+                            if (docCount >= bucketCountThresholds.getShardMinDocCount()) {
+                                if (spare == null) {
+                                    checkRealMemoryCBForInternalBucket();
+                                    spare = collectionStrategy.buildEmptyTemporaryBucket();
+                                }
+                                updater.updateBucket(spare, globalOrd, bucketOrd, docCount);
+                                spare = ordered.insertWithOverflow(spare);
+                            }
+                        }
+                    });
+
+                    // Get the top buckets
+                    topBucketsPreOrd.set(0, collectionStrategy.buildBuckets((int) ordered.size()));
+                    for (int i = (int) ordered.size() - 1; i >= 0; --i) {
+                        checkRealMemoryCBForInternalBucket();
+                        B bucket = collectionStrategy.convertTempBucketToRealBucket(ordered.pop(), lookupGlobalOrd);
+                        topBucketsPreOrd.get(0)[i] = bucket;
+                        otherDocCount.increment(0, -bucket.getDocCount());
+                    }
+                }
+                collectionStrategy.buildSubAggs(topBucketsPreOrd);
+                return GlobalOrdinalsStringTermsAggregator.this.buildAggregations(
+                    Math.toIntExact(owningBucketOrds.size()),
+                    ordIdx -> collectionStrategy.buildResult(
+                        owningBucketOrds.get(ordIdx),
+                        otherDocCount.get(ordIdx),
+                        topBucketsPreOrd.get(ordIdx)
+                    )
+                );
+            }
+        }
     }
 
     /**
@@ -558,13 +608,22 @@ public void close() {}
      * {@link DenseGlobalOrds} when collecting every ordinal, but significantly
      * less when collecting only a few.
      */
-    private class RemapGlobalOrds extends CollectionStrategy {
+    private class RemapGlobalOrds<
+        R extends InternalAggregation,
+        B extends InternalMultiBucketAggregation.InternalBucket,
+        TB extends InternalMultiBucketAggregation.InternalBucket> extends CollectionStrategy {
         private final LongKeyedBucketOrds bucketOrds;
         private final boolean excludeDeletedDocs;
+        private final ResultStrategy<R, B, TB> collectionStrategy;
 
-        private RemapGlobalOrds(CardinalityUpperBound cardinality, boolean excludeDeletedDocs) {
+        private RemapGlobalOrds(
+            ResultStrategy<R, B, TB> collectionStrategy,
+            CardinalityUpperBound cardinality,
+            boolean excludeDeletedDocs
+        ) {
             bucketOrds = LongKeyedBucketOrds.buildForValueRange(bigArrays(), cardinality, 0, valueCount - 1);
             this.excludeDeletedDocs = excludeDeletedDocs;
+            this.collectionStrategy = collectionStrategy;
         }
 
         @Override
@@ -596,30 +655,14 @@ long globalOrdToBucketOrd(long owningBucketOrd, long globalOrd) {
             return bucketOrds.find(owningBucketOrd, globalOrd);
         }
 
-        @Override
-        void forEach(long owningBucketOrd, BucketInfoConsumer consumer) throws IOException {
+        private void collectZeroDocEntriesIfNeeded(long owningBucketOrd) throws IOException {
             if (excludeDeletedDocs) {
-                forEachExcludeDeletedDocs(owningBucketOrd, consumer);
-            } else {
-                forEachAllowDeletedDocs(owningBucketOrd, consumer);
-            }
-        }
-
-        void forEachAllowDeletedDocs(long owningBucketOrd, BucketInfoConsumer consumer) throws IOException {
-            if (bucketCountThresholds.getMinDocCount() == 0) {
+                forEachExcludeDeletedDocs(owningBucketOrd);
+            } else if (bucketCountThresholds.getMinDocCount() == 0) {
                 for (long globalOrd = 0; globalOrd < valueCount; globalOrd++) {
-                    if (false == acceptedGlobalOrdinals.test(globalOrd)) {
-                        continue;
-                    }
-                    addBucketForMinDocCountZero(owningBucketOrd, globalOrd, consumer, null);
-                }
-            } else {
-                LongKeyedBucketOrds.BucketOrdsEnum ordsEnum = bucketOrds.ordsEnum(owningBucketOrd);
-                while (ordsEnum.next()) {
-                    if (false == acceptedGlobalOrdinals.test(ordsEnum.value())) {
-                        continue;
+                    if (acceptedGlobalOrdinals.test(globalOrd)) {
+                        bucketOrds.add(owningBucketOrd, globalOrd);
                     }
-                    consumer.accept(ordsEnum.value(), ordsEnum.ord(), bucketDocCount(ordsEnum.ord()));
                 }
             }
         }
@@ -627,9 +670,9 @@ void forEachAllowDeletedDocs(long owningBucketOrd, BucketInfoConsumer consumer)
         /**
          * Excludes deleted docs in the results by cross-checking with liveDocs.
          */
-        void forEachExcludeDeletedDocs(long owningBucketOrd, BucketInfoConsumer consumer) throws IOException {
+        private void forEachExcludeDeletedDocs(long owningBucketOrd) throws IOException {
             assert bucketCountThresholds.getMinDocCount() == 0;
-            try (LongHash accepted = new LongHash(20, new BigArrays(null, null, ""))) {
+            try (LongHash accepted = new LongHash(20, bigArrays())) {
                 for (LeafReaderContext ctx : searcher().getTopReaderContext().leaves()) {
                     LeafReader reader = ctx.reader();
                     Bits liveDocs = reader.getLiveDocs();
@@ -646,7 +689,8 @@ void forEachExcludeDeletedDocs(long owningBucketOrd, BucketInfoConsumer consumer
                                     if (false == acceptedGlobalOrdinals.test(globalOrd)) {
                                         continue;
                                     }
-                                    addBucketForMinDocCountZero(owningBucketOrd, globalOrd, consumer, accepted);
+                                    bucketOrds.add(owningBucketOrd, globalOrd);
+                                    accepted.add(globalOrd);
                                 }
                             }
                         }
@@ -655,110 +699,71 @@ void forEachExcludeDeletedDocs(long owningBucketOrd, BucketInfoConsumer consumer
             }
         }
 
-        private void addBucketForMinDocCountZero(
-            long owningBucketOrd,
-            long globalOrd,
-            BucketInfoConsumer consumer,
-            @Nullable LongHash accepted
-        ) throws IOException {
-            /*
-             * Use `add` instead of `find` here to assign an ordinal
-             * even if the global ord wasn't found so we can build
-             * sub-aggregations without trouble even though we haven't
-             * hit any documents for them. This is wasteful, but
-             * settings minDocCount == 0 is wasteful in general.....
-             */
-            long bucketOrd = bucketOrds.add(owningBucketOrd, globalOrd);
-            long docCount;
-            if (bucketOrd < 0) {
-                bucketOrd = -1 - bucketOrd;
-                docCount = bucketDocCount(bucketOrd);
-            } else {
-                docCount = 0;
-            }
-            assert globalOrd >= 0;
-            consumer.accept(globalOrd, bucketOrd, docCount);
-            if (accepted != null) {
-                accepted.add(globalOrd);
-            }
-        }
-
         @Override
         public void close() {
             bucketOrds.close();
         }
-    }
-
-    /**
-     * Strategy for building results.
-     */
-    abstract class ResultStrategy<
-        R extends InternalAggregation,
-        B extends InternalMultiBucketAggregation.InternalBucket,
-        TB extends InternalMultiBucketAggregation.InternalBucket> implements Releasable {
-
-        private InternalAggregation[] buildAggregations(LongArray owningBucketOrds) throws IOException {
 
-            if (valueCount == 0) { // no context in this reader
-                return GlobalOrdinalsStringTermsAggregator.this.buildAggregations(
-                    Math.toIntExact(owningBucketOrds.size()),
-                    ordIdx -> buildNoValuesResult(owningBucketOrds.get(ordIdx))
-                );
-            }
+        @Override
+        InternalAggregation[] buildAggregations(LongArray owningBucketOrds) throws IOException {
             try (
                 LongArray otherDocCount = bigArrays().newLongArray(owningBucketOrds.size(), true);
-                ObjectArray<B[]> topBucketsPreOrd = buildTopBucketsPerOrd(owningBucketOrds.size())
+                ObjectArray<B[]> topBucketsPreOrd = collectionStrategy.buildTopBucketsPerOrd(owningBucketOrds.size())
             ) {
                 GlobalOrdLookupFunction lookupGlobalOrd = valuesSupplier.get()::lookupOrd;
                 for (long ordIdx = 0; ordIdx < topBucketsPreOrd.size(); ordIdx++) {
-                    final int size;
-                    if (bucketCountThresholds.getMinDocCount() == 0) {
-                        // if minDocCount == 0 then we can end up with more buckets then maxBucketOrd() returns
-                        size = (int) Math.min(valueCount, bucketCountThresholds.getShardSize());
-                    } else {
-                        size = (int) Math.min(maxBucketOrd(), bucketCountThresholds.getShardSize());
-                    }
-                    try (ObjectArrayPriorityQueue<TB> ordered = buildPriorityQueue(size)) {
-                        final long finalOrdIdx = ordIdx;
-                        final long owningBucketOrd = owningBucketOrds.get(ordIdx);
-                        BucketUpdater<TB> updater = bucketUpdater(owningBucketOrd, lookupGlobalOrd);
-                        collectionStrategy.forEach(owningBucketOrd, new BucketInfoConsumer() {
-                            TB spare = null;
-
-                            @Override
-                            public void accept(long globalOrd, long bucketOrd, long docCount) throws IOException {
-                                otherDocCount.increment(finalOrdIdx, docCount);
-                                if (docCount >= bucketCountThresholds.getShardMinDocCount()) {
-                                    if (spare == null) {
-                                        checkRealMemoryCBForInternalBucket();
-                                        spare = buildEmptyTemporaryBucket();
-                                    }
-                                    updater.updateBucket(spare, globalOrd, bucketOrd, docCount);
-                                    spare = ordered.insertWithOverflow(spare);
-                                }
+                    long owningBucketOrd = owningBucketOrds.get(ordIdx);
+                    collectZeroDocEntriesIfNeeded(owningBucketOrds.get(ordIdx));
+                    int size = (int) Math.min(bucketOrds.bucketsInOrd(owningBucketOrd), bucketCountThresholds.getShardSize());
+                    try (ObjectArrayPriorityQueue<TB> ordered = collectionStrategy.buildPriorityQueue(size)) {
+                        BucketUpdater<TB> updater = collectionStrategy.bucketUpdater(owningBucketOrd, lookupGlobalOrd);
+                        LongKeyedBucketOrds.BucketOrdsEnum ordsEnum = bucketOrds.ordsEnum(owningBucketOrd);
+                        TB spare = null;
+                        while (ordsEnum.next()) {
+                            long docCount = bucketDocCount(ordsEnum.ord());
+                            otherDocCount.increment(ordIdx, docCount);
+                            if (docCount < bucketCountThresholds.getShardMinDocCount()) {
+                                continue;
                             }
-                        });
-
+                            if (spare == null) {
+                                checkRealMemoryCBForInternalBucket();
+                                spare = collectionStrategy.buildEmptyTemporaryBucket();
+                            }
+                            updater.updateBucket(spare, ordsEnum.value(), ordsEnum.ord(), docCount);
+                            spare = ordered.insertWithOverflow(spare);
+                        }
                         // Get the top buckets
-                        topBucketsPreOrd.set(ordIdx, buildBuckets((int) ordered.size()));
+                        topBucketsPreOrd.set(ordIdx, collectionStrategy.buildBuckets((int) ordered.size()));
                         for (int i = (int) ordered.size() - 1; i >= 0; --i) {
                             checkRealMemoryCBForInternalBucket();
-                            B bucket = convertTempBucketToRealBucket(ordered.pop(), lookupGlobalOrd);
+                            B bucket = collectionStrategy.convertTempBucketToRealBucket(ordered.pop(), lookupGlobalOrd);
                             topBucketsPreOrd.get(ordIdx)[i] = bucket;
                             otherDocCount.increment(ordIdx, -bucket.getDocCount());
                         }
                     }
                 }
-
-                buildSubAggs(topBucketsPreOrd);
-
+                collectionStrategy.buildSubAggs(topBucketsPreOrd);
                 return GlobalOrdinalsStringTermsAggregator.this.buildAggregations(
                     Math.toIntExact(owningBucketOrds.size()),
-                    ordIdx -> buildResult(owningBucketOrds.get(ordIdx), otherDocCount.get(ordIdx), topBucketsPreOrd.get(ordIdx))
+                    ordIdx -> collectionStrategy.buildResult(
+                        owningBucketOrds.get(ordIdx),
+                        otherDocCount.get(ordIdx),
+                        topBucketsPreOrd.get(ordIdx)
+                    )
                 );
             }
         }
 
+    }
+
+    /**
+     * Strategy for building results.
+     */
+    abstract class ResultStrategy<
+        R extends InternalAggregation,
+        B extends InternalMultiBucketAggregation.InternalBucket,
+        TB extends InternalMultiBucketAggregation.InternalBucket> implements Releasable {
+
         /**
          * Short description of the collection mechanism added to the profile
          * output to help with debugging.
@@ -780,7 +785,7 @@ public void accept(long globalOrd, long bucketOrd, long docCount) throws IOExcep
          * Update fields in {@code spare} to reflect information collected for
          * this bucket ordinal.
          */
-        abstract BucketUpdater<TB> bucketUpdater(long owningBucketOrd, GlobalOrdLookupFunction lookupGlobalOrd) throws IOException;
+        abstract BucketUpdater<TB> bucketUpdater(long owningBucketOrd, GlobalOrdLookupFunction lookupGlobalOrd);
 
         /**
          * Build a {@link PriorityQueue} to sort the buckets. After we've
@@ -862,7 +867,7 @@ OrdBucket buildEmptyTemporaryBucket() {
         }
 
         @Override
-        BucketUpdater<OrdBucket> bucketUpdater(long owningBucketOrd, GlobalOrdLookupFunction lookupGlobalOrd) throws IOException {
+        BucketUpdater<OrdBucket> bucketUpdater(long owningBucketOrd, GlobalOrdLookupFunction lookupGlobalOrd) {
             return (spare, globalOrd, bucketOrd, docCount) -> {
                 spare.globalOrd = globalOrd;
                 spare.bucketOrd = bucketOrd;

From 0901a2734ee7dad7da84b9590eb942f09b4c5952 Mon Sep 17 00:00:00 2001
From: Jim Ferenczi <jim.ferenczi@elastic.co>
Date: Wed, 4 Dec 2024 17:29:46 +0000
Subject: [PATCH 025/119] Add option to store `sparse_vector` outside `_source`
 (#117917)

This PR introduces an option for `sparse_vector` to store its values separately from `_source` by using term vectors.
This capability is primarly needed by the semantic text field.
---
 docs/changelog/117917.yaml                    |   5 +
 .../mapping/types/sparse-vector.asciidoc      |  17 ++
 .../test/search.vectors/90_sparse_vector.yml  | 117 ++++++++++++
 .../index/mapper/MapperFeatures.java          |   4 +-
 .../vectors/SparseVectorFieldMapper.java      | 155 ++++++++++++++-
 .../index/mapper/vectors/XFeatureField.java   | 177 ++++++++++++++++++
 .../vectors/SparseVectorFieldMapperTests.java | 135 +++++++++++--
 .../vectors/SparseVectorFieldTypeTests.java   |   4 +-
 .../mapper/SemanticTextFieldMapperTests.java  |   4 +-
 9 files changed, 589 insertions(+), 29 deletions(-)
 create mode 100644 docs/changelog/117917.yaml
 create mode 100644 server/src/main/java/org/elasticsearch/index/mapper/vectors/XFeatureField.java

diff --git a/docs/changelog/117917.yaml b/docs/changelog/117917.yaml
new file mode 100644
index 0000000000000..b6dc90f6b903d
--- /dev/null
+++ b/docs/changelog/117917.yaml
@@ -0,0 +1,5 @@
+pr: 117917
+summary: Add option to store `sparse_vector` outside `_source`
+area: Mapping
+type: feature
+issues: []
diff --git a/docs/reference/mapping/types/sparse-vector.asciidoc b/docs/reference/mapping/types/sparse-vector.asciidoc
index b24f65fcf97ca..22d4644ede490 100644
--- a/docs/reference/mapping/types/sparse-vector.asciidoc
+++ b/docs/reference/mapping/types/sparse-vector.asciidoc
@@ -26,6 +26,23 @@ PUT my-index
 
 See <<semantic-search-elser, semantic search with ELSER>> for a complete example on adding documents to a `sparse_vector` mapped field using ELSER.
 
+[[sparse-vectors-params]]
+==== Parameters for `sparse_vector` fields
+
+The following parameters are accepted by `sparse_vector` fields:
+
+[horizontal]
+
+<<mapping-store,store>>::
+
+Indicates whether the field value should be stored and retrievable independently of the <<mapping-source-field,_source>> field.
+Accepted values: true or false (default).
+The field's data is stored using term vectors, a disk-efficient structure compared to the original JSON input.
+The input map can be retrieved during a search request via the <<search-fields-param,`fields` parameter>>.
+To benefit from reduced disk usage, you must either:
+  * Exclude the field from <<source-filtering, _source>>.
+  * Use <<synthetic-source,synthetic `_source`>>.
+
 [[index-multi-value-sparse-vectors]]
 ==== Multi-value sparse vectors
 
diff --git a/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/search.vectors/90_sparse_vector.yml b/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/search.vectors/90_sparse_vector.yml
index 2505e6d7e353b..0b65a69bf500e 100644
--- a/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/search.vectors/90_sparse_vector.yml
+++ b/rest-api-spec/src/yamlRestTest/resources/rest-api-spec/test/search.vectors/90_sparse_vector.yml
@@ -472,3 +472,120 @@
 
   - match:
       _source.ml.tokens: {}
+
+---
+"stored sparse_vector":
+
+  - requires:
+      cluster_features: [ "mapper.sparse_vector.store_support" ]
+      reason: "sparse_vector supports store parameter"
+
+  - do:
+      indices.create:
+        index: test
+        body:
+          mappings:
+            properties:
+              ml.tokens:
+                type: sparse_vector
+                store: true
+
+  - match: { acknowledged: true }
+  - do:
+      index:
+        index: test
+        id: "1"
+        body:
+          ml:
+            tokens:
+              running: 2
+              good: 3
+              run: 5
+              race: 7
+              for: 9
+
+  - match: { result: "created" }
+
+  - do:
+      indices.refresh: { }
+
+  - do:
+      search:
+        index: test
+        body:
+          fields: [ "ml.tokens" ]
+
+  - length: { hits.hits.0.fields.ml\\.tokens: 1 }
+  - length: { hits.hits.0.fields.ml\\.tokens.0: 5 }
+  - match:  { hits.hits.0.fields.ml\\.tokens.0.running: 2.0 }
+  - match:  { hits.hits.0.fields.ml\\.tokens.0.good: 3.0 }
+  - match:  { hits.hits.0.fields.ml\\.tokens.0.run: 5.0 }
+  - match:  { hits.hits.0.fields.ml\\.tokens.0.race: 7.0 }
+  - match:  { hits.hits.0.fields.ml\\.tokens.0.for: 9.0 }
+
+---
+"stored sparse_vector synthetic source":
+
+  - requires:
+      cluster_features: [ "mapper.source.mode_from_index_setting", "mapper.sparse_vector.store_support" ]
+      reason: "sparse_vector supports store parameter"
+
+  - do:
+      indices.create:
+        index: test
+        body:
+          settings:
+            index:
+              mapping.source.mode: synthetic
+          mappings:
+            properties:
+              ml.tokens:
+                type: sparse_vector
+                store: true
+
+  - match: { acknowledged: true }
+
+  - do:
+      index:
+        index: test
+        id: "1"
+        body:
+          ml:
+            tokens:
+              running: 2
+              good: 3
+              run: 5
+              race: 7
+              for: 9
+
+  - match: { result: "created" }
+
+  - do:
+      indices.refresh: { }
+
+  - do:
+      search:
+        index: test
+        body:
+          fields: [ "ml.tokens" ]
+
+  - match:
+      hits.hits.0._source: {
+        ml: {
+          tokens: {
+            running: 2.0,
+            good: 3.0,
+            run: 5.0,
+            race: 7.0,
+            for: 9.0
+          }
+        }
+      }
+
+  - length: { hits.hits.0.fields.ml\\.tokens: 1 }
+  - length: { hits.hits.0.fields.ml\\.tokens.0: 5 }
+  - match:  { hits.hits.0.fields.ml\\.tokens.0.running: 2.0 }
+  - match:  { hits.hits.0.fields.ml\\.tokens.0.good: 3.0 }
+  - match:  { hits.hits.0.fields.ml\\.tokens.0.run: 5.0 }
+  - match:  { hits.hits.0.fields.ml\\.tokens.0.race: 7.0 }
+  - match:  { hits.hits.0.fields.ml\\.tokens.0.for: 9.0 }
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/MapperFeatures.java b/server/src/main/java/org/elasticsearch/index/mapper/MapperFeatures.java
index ffb38d229078e..276d3e151361c 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/MapperFeatures.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/MapperFeatures.java
@@ -62,6 +62,7 @@ public Set<NodeFeature> getFeatures() {
     );
 
     public static final NodeFeature META_FETCH_FIELDS_ERROR_CODE_CHANGED = new NodeFeature("meta_fetch_fields_error_code_changed");
+    public static final NodeFeature SPARSE_VECTOR_STORE_SUPPORT = new NodeFeature("mapper.sparse_vector.store_support");
 
     @Override
     public Set<NodeFeature> getTestFeatures() {
@@ -75,7 +76,8 @@ public Set<NodeFeature> getTestFeatures() {
             MapperService.LOGSDB_DEFAULT_IGNORE_DYNAMIC_BEYOND_LIMIT,
             DocumentParser.FIX_PARSING_SUBOBJECTS_FALSE_DYNAMIC_FALSE,
             CONSTANT_KEYWORD_SYNTHETIC_SOURCE_WRITE_FIX,
-            META_FETCH_FIELDS_ERROR_CODE_CHANGED
+            META_FETCH_FIELDS_ERROR_CODE_CHANGED,
+            SPARSE_VECTOR_STORE_SUPPORT
         );
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/vectors/SparseVectorFieldMapper.java b/server/src/main/java/org/elasticsearch/index/mapper/vectors/SparseVectorFieldMapper.java
index d0a8dfae4f242..552e66336005d 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/vectors/SparseVectorFieldMapper.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/vectors/SparseVectorFieldMapper.java
@@ -11,6 +11,12 @@
 
 import org.apache.lucene.document.FeatureField;
 import org.apache.lucene.index.IndexableField;
+import org.apache.lucene.index.LeafReader;
+import org.apache.lucene.index.LeafReaderContext;
+import org.apache.lucene.index.PostingsEnum;
+import org.apache.lucene.index.TermVectors;
+import org.apache.lucene.index.TermsEnum;
+import org.apache.lucene.search.DocIdSetIterator;
 import org.apache.lucene.search.MatchNoDocsQuery;
 import org.apache.lucene.search.Query;
 import org.apache.lucene.util.BytesRef;
@@ -25,14 +31,22 @@
 import org.elasticsearch.index.mapper.FieldMapper;
 import org.elasticsearch.index.mapper.MappedFieldType;
 import org.elasticsearch.index.mapper.MapperBuilderContext;
+import org.elasticsearch.index.mapper.SourceLoader;
 import org.elasticsearch.index.mapper.SourceValueFetcher;
 import org.elasticsearch.index.mapper.TextSearchInfo;
 import org.elasticsearch.index.mapper.ValueFetcher;
 import org.elasticsearch.index.query.SearchExecutionContext;
+import org.elasticsearch.search.fetch.StoredFieldsSpec;
+import org.elasticsearch.search.lookup.Source;
+import org.elasticsearch.xcontent.XContentBuilder;
 import org.elasticsearch.xcontent.XContentParser.Token;
 
 import java.io.IOException;
+import java.io.UncheckedIOException;
+import java.util.LinkedHashMap;
+import java.util.List;
 import java.util.Map;
+import java.util.stream.Stream;
 
 import static org.elasticsearch.index.query.AbstractQueryBuilder.DEFAULT_BOOST;
 
@@ -52,8 +66,12 @@ public class SparseVectorFieldMapper extends FieldMapper {
     static final IndexVersion NEW_SPARSE_VECTOR_INDEX_VERSION = IndexVersions.NEW_SPARSE_VECTOR;
     static final IndexVersion SPARSE_VECTOR_IN_FIELD_NAMES_INDEX_VERSION = IndexVersions.SPARSE_VECTOR_IN_FIELD_NAMES_SUPPORT;
 
-    public static class Builder extends FieldMapper.Builder {
+    private static SparseVectorFieldMapper toType(FieldMapper in) {
+        return (SparseVectorFieldMapper) in;
+    }
 
+    public static class Builder extends FieldMapper.Builder {
+        private final Parameter<Boolean> stored = Parameter.storeParam(m -> toType(m).fieldType().isStored(), false);
         private final Parameter<Map<String, String>> meta = Parameter.metaParam();
 
         public Builder(String name) {
@@ -62,14 +80,14 @@ public Builder(String name) {
 
         @Override
         protected Parameter<?>[] getParameters() {
-            return new Parameter<?>[] { meta };
+            return new Parameter<?>[] { stored, meta };
         }
 
         @Override
         public SparseVectorFieldMapper build(MapperBuilderContext context) {
             return new SparseVectorFieldMapper(
                 leafName(),
-                new SparseVectorFieldType(context.buildFullName(leafName()), meta.getValue()),
+                new SparseVectorFieldType(context.buildFullName(leafName()), stored.getValue(), meta.getValue()),
                 builderParams(this, context)
             );
         }
@@ -87,8 +105,8 @@ public SparseVectorFieldMapper build(MapperBuilderContext context) {
 
     public static final class SparseVectorFieldType extends MappedFieldType {
 
-        public SparseVectorFieldType(String name, Map<String, String> meta) {
-            super(name, true, false, false, TextSearchInfo.SIMPLE_MATCH_ONLY, meta);
+        public SparseVectorFieldType(String name, boolean isStored, Map<String, String> meta) {
+            super(name, true, isStored, false, TextSearchInfo.SIMPLE_MATCH_ONLY, meta);
         }
 
         @Override
@@ -103,6 +121,9 @@ public IndexFieldData.Builder fielddataBuilder(FieldDataContext fieldDataContext
 
         @Override
         public ValueFetcher valueFetcher(SearchExecutionContext context, String format) {
+            if (isStored()) {
+                return new SparseVectorValueFetcher(name());
+            }
             return SourceValueFetcher.identity(name(), context, format);
         }
 
@@ -135,6 +156,14 @@ private SparseVectorFieldMapper(String simpleName, MappedFieldType mappedFieldTy
         super(simpleName, mappedFieldType, builderParams);
     }
 
+    @Override
+    protected SyntheticSourceSupport syntheticSourceSupport() {
+        if (fieldType().isStored()) {
+            return new SyntheticSourceSupport.Native(new SparseVectorSyntheticFieldLoader(fullPath(), leafName()));
+        }
+        return super.syntheticSourceSupport();
+    }
+
     @Override
     public Map<String, NamedAnalyzer> indexAnalyzers() {
         return Map.of(mappedFieldType.name(), Lucene.KEYWORD_ANALYZER);
@@ -189,9 +218,9 @@ public void parse(DocumentParserContext context) throws IOException {
                     // based on recommendations from this paper: https://arxiv.org/pdf/2305.18494.pdf
                     IndexableField currentField = context.doc().getByKey(key);
                     if (currentField == null) {
-                        context.doc().addWithKey(key, new FeatureField(fullPath(), feature, value));
-                    } else if (currentField instanceof FeatureField && ((FeatureField) currentField).getFeatureValue() < value) {
-                        ((FeatureField) currentField).setFeatureValue(value);
+                        context.doc().addWithKey(key, new XFeatureField(fullPath(), feature, value, fieldType().isStored()));
+                    } else if (currentField instanceof XFeatureField && ((XFeatureField) currentField).getFeatureValue() < value) {
+                        ((XFeatureField) currentField).setFeatureValue(value);
                     }
                 } else {
                     throw new IllegalArgumentException(
@@ -219,4 +248,114 @@ protected String contentType() {
         return CONTENT_TYPE;
     }
 
+    private static class SparseVectorValueFetcher implements ValueFetcher {
+        private final String fieldName;
+        private TermVectors termVectors;
+
+        private SparseVectorValueFetcher(String fieldName) {
+            this.fieldName = fieldName;
+        }
+
+        @Override
+        public void setNextReader(LeafReaderContext context) {
+            try {
+                termVectors = context.reader().termVectors();
+            } catch (IOException exc) {
+                throw new UncheckedIOException(exc);
+            }
+        }
+
+        @Override
+        public List<Object> fetchValues(Source source, int doc, List<Object> ignoredValues) throws IOException {
+            if (termVectors == null) {
+                return List.of();
+            }
+            var terms = termVectors.get(doc, fieldName);
+            if (terms == null) {
+                return List.of();
+            }
+
+            var termsEnum = terms.iterator();
+            PostingsEnum postingsScratch = null;
+            Map<String, Float> result = new LinkedHashMap<>();
+            while (termsEnum.next() != null) {
+                postingsScratch = termsEnum.postings(postingsScratch);
+                postingsScratch.nextDoc();
+                result.put(termsEnum.term().utf8ToString(), XFeatureField.decodeFeatureValue(postingsScratch.freq()));
+                assert postingsScratch.nextDoc() == DocIdSetIterator.NO_MORE_DOCS;
+            }
+            return List.of(result);
+        }
+
+        @Override
+        public StoredFieldsSpec storedFieldsSpec() {
+            return StoredFieldsSpec.NO_REQUIREMENTS;
+        }
+    }
+
+    private static class SparseVectorSyntheticFieldLoader implements SourceLoader.SyntheticFieldLoader {
+        private final String fullPath;
+        private final String leafName;
+
+        private TermsEnum termsDocEnum;
+
+        private SparseVectorSyntheticFieldLoader(String fullPath, String leafName) {
+            this.fullPath = fullPath;
+            this.leafName = leafName;
+        }
+
+        @Override
+        public Stream<Map.Entry<String, StoredFieldLoader>> storedFieldLoaders() {
+            return Stream.of();
+        }
+
+        @Override
+        public DocValuesLoader docValuesLoader(LeafReader leafReader, int[] docIdsInLeaf) throws IOException {
+            var fieldInfos = leafReader.getFieldInfos().fieldInfo(fullPath);
+            if (fieldInfos == null || fieldInfos.hasTermVectors() == false) {
+                return null;
+            }
+            return docId -> {
+                var terms = leafReader.termVectors().get(docId, fullPath);
+                if (terms == null) {
+                    return false;
+                }
+                termsDocEnum = terms.iterator();
+                if (termsDocEnum.next() == null) {
+                    termsDocEnum = null;
+                    return false;
+                }
+                return true;
+            };
+        }
+
+        @Override
+        public boolean hasValue() {
+            return termsDocEnum != null;
+        }
+
+        @Override
+        public void write(XContentBuilder b) throws IOException {
+            assert termsDocEnum != null;
+            PostingsEnum reuse = null;
+            b.startObject(leafName);
+            do {
+                reuse = termsDocEnum.postings(reuse);
+                reuse.nextDoc();
+                b.field(termsDocEnum.term().utf8ToString(), XFeatureField.decodeFeatureValue(reuse.freq()));
+            } while (termsDocEnum.next() != null);
+            b.endObject();
+        }
+
+        @Override
+        public String fieldName() {
+            return leafName;
+        }
+
+        @Override
+        public void reset() {
+            termsDocEnum = null;
+        }
+    }
+
 }
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/vectors/XFeatureField.java b/server/src/main/java/org/elasticsearch/index/mapper/vectors/XFeatureField.java
new file mode 100644
index 0000000000000..5f4afb4a86acc
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/index/mapper/vectors/XFeatureField.java
@@ -0,0 +1,177 @@
+/*
+ * @notice
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.elasticsearch.index.mapper.vectors;
+
+import org.apache.lucene.analysis.Analyzer;
+import org.apache.lucene.analysis.TokenStream;
+import org.apache.lucene.analysis.tokenattributes.CharTermAttribute;
+import org.apache.lucene.analysis.tokenattributes.TermFrequencyAttribute;
+import org.apache.lucene.document.FeatureField;
+import org.apache.lucene.document.Field;
+import org.apache.lucene.document.FieldType;
+import org.apache.lucene.index.IndexOptions;
+
+/**
+ * This class is forked from the Lucene {@link FeatureField} implementation to enable support for storing term vectors.
+ * It should be removed once apache/lucene#14034 becomes available.
+ */
+public final class XFeatureField extends Field {
+    private static final FieldType FIELD_TYPE = new FieldType();
+    private static final FieldType FIELD_TYPE_STORE_TERM_VECTORS = new FieldType();
+
+    static {
+        FIELD_TYPE.setTokenized(false);
+        FIELD_TYPE.setOmitNorms(true);
+        FIELD_TYPE.setIndexOptions(IndexOptions.DOCS_AND_FREQS);
+
+        FIELD_TYPE_STORE_TERM_VECTORS.setTokenized(false);
+        FIELD_TYPE_STORE_TERM_VECTORS.setOmitNorms(true);
+        FIELD_TYPE_STORE_TERM_VECTORS.setIndexOptions(IndexOptions.DOCS_AND_FREQS);
+        FIELD_TYPE_STORE_TERM_VECTORS.setStoreTermVectors(true);
+    }
+
+    private float featureValue;
+
+    /**
+     * Create a feature.
+     *
+     * @param fieldName The name of the field to store the information into. All features may be
+     *     stored in the same field.
+     * @param featureName The name of the feature, eg. 'pagerank`. It will be indexed as a term.
+     * @param featureValue The value of the feature, must be a positive, finite, normal float.
+     */
+    public XFeatureField(String fieldName, String featureName, float featureValue) {
+        this(fieldName, featureName, featureValue, false);
+    }
+
+    /**
+     * Create a feature.
+     *
+     * @param fieldName    The name of the field to store the information into. All features may be
+     *                     stored in the same field.
+     * @param featureName  The name of the feature, eg. 'pagerank`. It will be indexed as a term.
+     * @param featureValue The value of the feature, must be a positive, finite, normal float.
+     */
+    public XFeatureField(String fieldName, String featureName, float featureValue, boolean storeTermVectors) {
+        super(fieldName, featureName, storeTermVectors ? FIELD_TYPE_STORE_TERM_VECTORS : FIELD_TYPE);
+        setFeatureValue(featureValue);
+    }
+
+    /**
+     * Update the feature value of this field.
+     */
+    public void setFeatureValue(float featureValue) {
+        if (Float.isFinite(featureValue) == false) {
+            throw new IllegalArgumentException(
+                "featureValue must be finite, got: " + featureValue + " for feature " + fieldsData + " on field " + name
+            );
+        }
+        if (featureValue < Float.MIN_NORMAL) {
+            throw new IllegalArgumentException(
+                "featureValue must be a positive normal float, got: "
+                    + featureValue
+                    + " for feature "
+                    + fieldsData
+                    + " on field "
+                    + name
+                    + " which is less than the minimum positive normal float: "
+                    + Float.MIN_NORMAL
+            );
+        }
+        this.featureValue = featureValue;
+    }
+
+    @Override
+    public TokenStream tokenStream(Analyzer analyzer, TokenStream reuse) {
+        FeatureTokenStream stream;
+        if (reuse instanceof FeatureTokenStream) {
+            stream = (FeatureTokenStream) reuse;
+        } else {
+            stream = new FeatureTokenStream();
+        }
+
+        int freqBits = Float.floatToIntBits(featureValue);
+        stream.setValues((String) fieldsData, freqBits >>> 15);
+        return stream;
+    }
+
+    /**
+     * This is useful if you have multiple features sharing a name and you want to take action to
+     * deduplicate them.
+     *
+     * @return the feature value of this field.
+     */
+    public float getFeatureValue() {
+        return featureValue;
+    }
+
+    private static final class FeatureTokenStream extends TokenStream {
+        private final CharTermAttribute termAttribute = addAttribute(CharTermAttribute.class);
+        private final TermFrequencyAttribute freqAttribute = addAttribute(TermFrequencyAttribute.class);
+        private boolean used = true;
+        private String value = null;
+        private int freq = 0;
+
+        private FeatureTokenStream() {}
+
+        /**
+         * Sets the values
+         */
+        void setValues(String value, int freq) {
+            this.value = value;
+            this.freq = freq;
+        }
+
+        @Override
+        public boolean incrementToken() {
+            if (used) {
+                return false;
+            }
+            clearAttributes();
+            termAttribute.append(value);
+            freqAttribute.setTermFrequency(freq);
+            used = true;
+            return true;
+        }
+
+        @Override
+        public void reset() {
+            used = false;
+        }
+
+        @Override
+        public void close() {
+            value = null;
+        }
+    }
+
+    static final int MAX_FREQ = Float.floatToIntBits(Float.MAX_VALUE) >>> 15;
+
+    static float decodeFeatureValue(float freq) {
+        if (freq > MAX_FREQ) {
+            // This is never used in practice but callers of the SimScorer API might
+            // occasionally call it on eg. Float.MAX_VALUE to compute the max score
+            // so we need to be consistent.
+            return Float.MAX_VALUE;
+        }
+        int tf = (int) freq; // lossless
+        int featureBits = tf << 15;
+        return Float.intBitsToFloat(featureBits);
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/vectors/SparseVectorFieldMapperTests.java b/server/src/test/java/org/elasticsearch/index/mapper/vectors/SparseVectorFieldMapperTests.java
index ffa5bd339ae06..8e0cd97e518fa 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/vectors/SparseVectorFieldMapperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/vectors/SparseVectorFieldMapperTests.java
@@ -11,17 +11,24 @@
 
 import org.apache.lucene.analysis.TokenStream;
 import org.apache.lucene.analysis.tokenattributes.TermFrequencyAttribute;
-import org.apache.lucene.document.FeatureField;
+import org.apache.lucene.index.DirectoryReader;
 import org.apache.lucene.index.IndexableField;
+import org.apache.lucene.index.LeafReader;
+import org.apache.lucene.search.IndexSearcher;
+import org.apache.lucene.store.Directory;
+import org.apache.lucene.tests.index.RandomIndexWriter;
 import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.compress.CompressedXContent;
 import org.elasticsearch.index.IndexVersion;
 import org.elasticsearch.index.IndexVersions;
 import org.elasticsearch.index.mapper.DocumentMapper;
 import org.elasticsearch.index.mapper.DocumentParsingException;
 import org.elasticsearch.index.mapper.MappedFieldType;
 import org.elasticsearch.index.mapper.MapperParsingException;
+import org.elasticsearch.index.mapper.MapperService;
 import org.elasticsearch.index.mapper.MapperTestCase;
 import org.elasticsearch.index.mapper.ParsedDocument;
+import org.elasticsearch.search.lookup.Source;
 import org.elasticsearch.test.index.IndexVersionUtils;
 import org.elasticsearch.xcontent.XContentBuilder;
 import org.hamcrest.Matchers;
@@ -29,18 +36,25 @@
 
 import java.io.IOException;
 import java.util.Arrays;
+import java.util.LinkedHashMap;
 import java.util.List;
 import java.util.Map;
 
 import static org.elasticsearch.index.mapper.vectors.SparseVectorFieldMapper.NEW_SPARSE_VECTOR_INDEX_VERSION;
 import static org.elasticsearch.index.mapper.vectors.SparseVectorFieldMapper.PREVIOUS_SPARSE_VECTOR_INDEX_VERSION;
+import static org.elasticsearch.xcontent.XContentFactory.jsonBuilder;
 import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.instanceOf;
 
 public class SparseVectorFieldMapperTests extends MapperTestCase {
 
     @Override
     protected Object getSampleValueForDocument() {
-        return Map.of("ten", 10, "twenty", 20);
+        Map<String, Float> map = new LinkedHashMap<>();
+        map.put("ten", 10f);
+        map.put("twenty", 20f);
+        return map;
     }
 
     @Override
@@ -88,14 +102,18 @@ public void testDefaults() throws Exception {
 
         List<IndexableField> fields = doc1.rootDoc().getFields("field");
         assertEquals(2, fields.size());
-        assertThat(fields.get(0), Matchers.instanceOf(FeatureField.class));
-        FeatureField featureField1 = null;
-        FeatureField featureField2 = null;
+        if (IndexVersion.current().luceneVersion().major == 10) {
+            // TODO: Update to use Lucene's FeatureField after upgrading to Lucene 10.1.
+            assertThat(IndexVersion.current().luceneVersion().minor, equalTo(0));
+        }
+        assertThat(fields.get(0), Matchers.instanceOf(XFeatureField.class));
+        XFeatureField featureField1 = null;
+        XFeatureField featureField2 = null;
         for (IndexableField field : fields) {
             if (field.stringValue().equals("ten")) {
-                featureField1 = (FeatureField) field;
+                featureField1 = (XFeatureField) field;
             } else if (field.stringValue().equals("twenty")) {
-                featureField2 = (FeatureField) field;
+                featureField2 = (XFeatureField) field;
             } else {
                 throw new UnsupportedOperationException();
             }
@@ -112,14 +130,14 @@ public void testDotInFieldName() throws Exception {
 
         List<IndexableField> fields = parsedDocument.rootDoc().getFields("field");
         assertEquals(2, fields.size());
-        assertThat(fields.get(0), Matchers.instanceOf(FeatureField.class));
-        FeatureField featureField1 = null;
-        FeatureField featureField2 = null;
+        assertThat(fields.get(0), Matchers.instanceOf(XFeatureField.class));
+        XFeatureField featureField1 = null;
+        XFeatureField featureField2 = null;
         for (IndexableField field : fields) {
             if (field.stringValue().equals("foo.bar")) {
-                featureField1 = (FeatureField) field;
+                featureField1 = (XFeatureField) field;
             } else if (field.stringValue().equals("foobar")) {
-                featureField2 = (FeatureField) field;
+                featureField2 = (XFeatureField) field;
             } else {
                 throw new UnsupportedOperationException();
             }
@@ -167,13 +185,13 @@ public void testHandlesMultiValuedFields() throws MapperParsingException, IOExce
         }));
 
         // then validate that the generate document stored both values appropriately and we have only the max value stored
-        FeatureField barField = ((FeatureField) doc1.rootDoc().getByKey("foo.field\\.bar"));
+        XFeatureField barField = ((XFeatureField) doc1.rootDoc().getByKey("foo.field\\.bar"));
         assertEquals(20, barField.getFeatureValue(), 1);
 
-        FeatureField storedBarField = ((FeatureField) doc1.rootDoc().getFields("foo.field").get(1));
+        XFeatureField storedBarField = ((XFeatureField) doc1.rootDoc().getFields("foo.field").get(1));
         assertEquals(20, storedBarField.getFeatureValue(), 1);
 
-        assertEquals(3, doc1.rootDoc().getFields().stream().filter((f) -> f instanceof FeatureField).count());
+        assertEquals(3, doc1.rootDoc().getFields().stream().filter((f) -> f instanceof XFeatureField).count());
     }
 
     public void testCannotBeUsedInMultiFields() {
@@ -188,6 +206,53 @@ public void testCannotBeUsedInMultiFields() {
         assertThat(e.getMessage(), containsString("Field [feature] of type [sparse_vector] can't be used in multifields"));
     }
 
+    public void testStoreIsNotUpdateable() throws IOException {
+        var mapperService = createMapperService(fieldMapping(this::minimalMapping));
+        XContentBuilder mapping = jsonBuilder().startObject()
+            .startObject("_doc")
+            .startObject("properties")
+            .startObject("field")
+            .field("type", "sparse_vector")
+            .field("store", true)
+            .endObject()
+            .endObject()
+            .endObject()
+            .endObject();
+        var exc = expectThrows(
+            Exception.class,
+            () -> mapperService.merge("_doc", new CompressedXContent(Strings.toString(mapping)), MapperService.MergeReason.MAPPING_UPDATE)
+        );
+        assertThat(exc.getMessage(), containsString("Cannot update parameter [store]"));
+    }
+
+    @SuppressWarnings("unchecked")
+    public void testValueFetcher() throws Exception {
+        for (boolean store : new boolean[] { true, false }) {
+            var mapperService = createMapperService(fieldMapping(store ? this::minimalStoreMapping : this::minimalMapping));
+            var mapper = mapperService.documentMapper();
+            try (Directory directory = newDirectory()) {
+                RandomIndexWriter iw = new RandomIndexWriter(random(), directory);
+                var sourceToParse = source(this::writeField);
+                ParsedDocument doc1 = mapper.parse(sourceToParse);
+                iw.addDocument(doc1.rootDoc());
+                iw.close();
+                try (DirectoryReader reader = wrapInMockESDirectoryReader(DirectoryReader.open(directory))) {
+                    LeafReader leafReader = getOnlyLeafReader(reader);
+                    var searchContext = createSearchExecutionContext(mapperService, new IndexSearcher(leafReader));
+                    var fieldType = mapper.mappers().getFieldType("field");
+                    var valueFetcher = fieldType.valueFetcher(searchContext, null);
+                    valueFetcher.setNextReader(leafReader.getContext());
+
+                    var source = Source.fromBytes(sourceToParse.source());
+                    var result = valueFetcher.fetchValues(source, 0, List.of());
+                    assertThat(result.size(), equalTo(1));
+                    assertThat(result.get(0), instanceOf(Map.class));
+                    assertThat(toFloats((Map<String, ?>) result.get(0)), equalTo(toFloats((Map<String, ?>) source.source().get("field"))));
+                }
+            }
+        }
+    }
+
     @Override
     protected Object generateRandomInputValue(MappedFieldType ft) {
         assumeFalse("Test implemented in a follow up", true);
@@ -201,7 +266,29 @@ protected boolean allowsNullValues() {
 
     @Override
     protected SyntheticSourceSupport syntheticSourceSupport(boolean syntheticSource) {
-        throw new AssumptionViolatedException("not supported");
+        boolean withStore = randomBoolean();
+        return new SyntheticSourceSupport() {
+            @Override
+            public boolean preservesExactSource() {
+                return withStore == false;
+            }
+
+            @Override
+            public SyntheticSourceExample example(int maxValues) {
+                return new SyntheticSourceExample(getSampleValueForDocument(), getSampleValueForDocument(), b -> {
+                    if (withStore) {
+                        minimalStoreMapping(b);
+                    } else {
+                        minimalMapping(b);
+                    }
+                });
+            }
+
+            @Override
+            public List<SyntheticSourceInvalidExample> invalidExample() {
+                return List.of();
+            }
+        };
     }
 
     @Override
@@ -234,4 +321,20 @@ public void testSparseVectorUnsupportedIndex() throws Exception {
         })));
         assertThat(e.getMessage(), containsString(SparseVectorFieldMapper.ERROR_MESSAGE_8X));
     }
+
+    /**
+     * Handles float/double conversion when reading/writing with xcontent by converting all numbers to floats.
+     */
+    private Map<String, Float> toFloats(Map<String, ?> value) {
+        // preserve order
+        Map<String, Float> result = new LinkedHashMap<>();
+        for (var entry : value.entrySet()) {
+            if (entry.getValue() instanceof Number num) {
+                result.put(entry.getKey(), num.floatValue());
+            } else {
+                throw new IllegalArgumentException("Expected Number, got: " + value.getClass().getSimpleName());
+            }
+        }
+        return result;
+    }
 }
diff --git a/server/src/test/java/org/elasticsearch/index/mapper/vectors/SparseVectorFieldTypeTests.java b/server/src/test/java/org/elasticsearch/index/mapper/vectors/SparseVectorFieldTypeTests.java
index 4627d4d871957..0dbe3817c3e87 100644
--- a/server/src/test/java/org/elasticsearch/index/mapper/vectors/SparseVectorFieldTypeTests.java
+++ b/server/src/test/java/org/elasticsearch/index/mapper/vectors/SparseVectorFieldTypeTests.java
@@ -18,13 +18,13 @@
 public class SparseVectorFieldTypeTests extends FieldTypeTestCase {
 
     public void testDocValuesDisabled() {
-        MappedFieldType fieldType = new SparseVectorFieldMapper.SparseVectorFieldType("field", Collections.emptyMap());
+        MappedFieldType fieldType = new SparseVectorFieldMapper.SparseVectorFieldType("field", false, Collections.emptyMap());
         assertFalse(fieldType.hasDocValues());
         expectThrows(IllegalArgumentException.class, () -> fieldType.fielddataBuilder(FieldDataContext.noRuntimeFields("test")));
     }
 
     public void testIsNotAggregatable() {
-        MappedFieldType fieldType = new SparseVectorFieldMapper.SparseVectorFieldType("field", Collections.emptyMap());
+        MappedFieldType fieldType = new SparseVectorFieldMapper.SparseVectorFieldType("field", false, Collections.emptyMap());
         assertFalse(fieldType.isAggregatable());
     }
 }
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/SemanticTextFieldMapperTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/SemanticTextFieldMapperTests.java
index 71ff9fc7d84cf..fd60d9687f437 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/SemanticTextFieldMapperTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/SemanticTextFieldMapperTests.java
@@ -7,7 +7,6 @@
 
 package org.elasticsearch.xpack.inference.mapper;
 
-import org.apache.lucene.document.FeatureField;
 import org.apache.lucene.index.FieldInfo;
 import org.apache.lucene.index.FieldInfos;
 import org.apache.lucene.index.IndexableField;
@@ -47,6 +46,7 @@
 import org.elasticsearch.index.mapper.SourceToParse;
 import org.elasticsearch.index.mapper.vectors.DenseVectorFieldMapper;
 import org.elasticsearch.index.mapper.vectors.SparseVectorFieldMapper;
+import org.elasticsearch.index.mapper.vectors.XFeatureField;
 import org.elasticsearch.index.query.SearchExecutionContext;
 import org.elasticsearch.index.search.ESToParentBlockJoinQuery;
 import org.elasticsearch.inference.Model;
@@ -1130,7 +1130,7 @@ private static void assertChildLeafNestedDocument(
     private static void assertSparseFeatures(LuceneDocument doc, String fieldName, int expectedCount) {
         int count = 0;
         for (IndexableField field : doc.getFields()) {
-            if (field instanceof FeatureField featureField) {
+            if (field instanceof XFeatureField featureField) {
                 assertThat(featureField.name(), equalTo(fieldName));
                 ++count;
             }

From 4efe696b1fe12d003816b4a42ed987e14d132819 Mon Sep 17 00:00:00 2001
From: Luigi Dell'Aquila <luigi.dellaquila@gmail.com>
Date: Wed, 4 Dec 2024 18:45:32 +0100
Subject: [PATCH 026/119] ES|QL: fix lookup-join csv tests with
 nondeterministic order (#118008)

---
 muted-tests.yml                                    | 14 --------------
 .../src/main/resources/lookup-join.csv-spec        |  4 ++++
 2 files changed, 4 insertions(+), 14 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index 317b960f36c56..e69588d6ec359 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -239,20 +239,6 @@ tests:
 - class: org.elasticsearch.xpack.ml.integration.RegressionIT
   method: testTwoJobsWithSameRandomizeSeedUseSameTrainingSet
   issue: https://github.com/elastic/elasticsearch/issues/117805
-- class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
-  method: test {lookup-join.LookupIPFromIndexKeep ASYNC}
-  issue: https://github.com/elastic/elasticsearch/issues/117974
-- class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
-  method: test {lookup-join.LookupMessageFromIndex ASYNC}
-  issue: https://github.com/elastic/elasticsearch/issues/117975
-- class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
-  method: test {lookup-join.LookupMessageFromIndexKeep ASYNC}
-  issue: https://github.com/elastic/elasticsearch/issues/117976
-- class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
-  method: test {lookup-join.LookupMessageFromIndex SYNC}
-  issue: https://github.com/elastic/elasticsearch/issues/117980
-- class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
-  issue: https://github.com/elastic/elasticsearch/issues/117981
 - class: org.elasticsearch.packaging.test.ArchiveGenerateInitialCredentialsTests
   method: test30NoAutogenerationWhenDaemonized
   issue: https://github.com/elastic/elasticsearch/issues/117956
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
index f2800456ceb33..712cadf6d44fd 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
@@ -127,6 +127,7 @@ FROM sample_data
 | EVAL client_ip = client_ip::keyword
 | LOOKUP JOIN clientips_lookup ON client_ip
 ;
+ignoreOrder:true;
 
 @timestamp:date          | event_duration:long | message:keyword       | client_ip:keyword | env:keyword
 2023-10-23T13:55:01.543Z | 1756467             | Connected to 10.1.0.1 | 172.21.3.15       | Production
@@ -146,6 +147,7 @@ FROM sample_data
 | LOOKUP JOIN clientips_lookup ON client_ip
 | KEEP @timestamp, client_ip, event_duration, message, env
 ;
+ignoreOrder:true;
 
 @timestamp:date          | client_ip:keyword | event_duration:long | message:keyword       | env:keyword
 2023-10-23T13:55:01.543Z | 172.21.3.15       | 1756467             | Connected to 10.1.0.1 | Production
@@ -230,6 +232,7 @@ required_capability: join_lookup_v4
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
 ;
+ignoreOrder:true;
 
 @timestamp:date          | client_ip:ip | event_duration:long | message:keyword       | type:keyword
 2023-10-23T13:55:01.543Z | 172.21.3.15  | 1756467             | Connected to 10.1.0.1 | Success
@@ -248,6 +251,7 @@ FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
 | KEEP @timestamp, client_ip, event_duration, message, type
 ;
+ignoreOrder:true;
 
 @timestamp:date          | client_ip:ip | event_duration:long | message:keyword       | type:keyword
 2023-10-23T13:55:01.543Z | 172.21.3.15  | 1756467             | Connected to 10.1.0.1 | Success

From 774c6ea174bdd866ad91c86ba779e1f2b0f8a27a Mon Sep 17 00:00:00 2001
From: Andrei Stefan <astefan@users.noreply.github.com>
Date: Wed, 4 Dec 2024 20:15:55 +0200
Subject: [PATCH 027/119] Create the mapping explicitly, otherwise for 0
 documents indices (#118015)

the mapping will not contain the "value" field
---
 muted-tests.yml                                             | 6 ------
 .../xpack/esql/qa/rest/RequestIndexFilteringTestCase.java   | 5 ++++-
 2 files changed, 4 insertions(+), 7 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index e69588d6ec359..0b9027a406088 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -230,12 +230,6 @@ tests:
 - class: org.elasticsearch.xpack.esql.plugin.ClusterRequestTests
   method: testFallbackIndicesOptions
   issue: https://github.com/elastic/elasticsearch/issues/117937
-- class: org.elasticsearch.xpack.esql.qa.single_node.RequestIndexFilteringIT
-  method: testFieldExistsFilter_KeepWildcard
-  issue: https://github.com/elastic/elasticsearch/issues/117935
-- class: org.elasticsearch.xpack.esql.qa.multi_node.RequestIndexFilteringIT
-  method: testFieldExistsFilter_KeepWildcard
-  issue: https://github.com/elastic/elasticsearch/issues/117935
 - class: org.elasticsearch.xpack.ml.integration.RegressionIT
   method: testTwoJobsWithSameRandomizeSeedUseSameTrainingSet
   issue: https://github.com/elastic/elasticsearch/issues/117805
diff --git a/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RequestIndexFilteringTestCase.java b/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RequestIndexFilteringTestCase.java
index 3314430d63eaa..406997b66dbf0 100644
--- a/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RequestIndexFilteringTestCase.java
+++ b/x-pack/plugin/esql/qa/server/src/main/java/org/elasticsearch/xpack/esql/qa/rest/RequestIndexFilteringTestCase.java
@@ -101,7 +101,7 @@ public void testFieldExistsFilter_KeepWildcard() throws IOException {
         indexTimestampData(docsTest1, "test1", "2024-11-26", "id1");
         indexTimestampData(docsTest2, "test2", "2023-11-26", "id2");
 
-        // filter includes only test1. Columns are rows of test2 are filtered out
+        // filter includes only test1. Columns and rows of test2 are filtered out
         RestEsqlTestCase.RequestObjectBuilder builder = existsFilter("id1").query("FROM test*");
         Map<String, Object> result = runEsql(builder);
         assertMap(
@@ -253,6 +253,9 @@ protected void indexTimestampData(int docs, String indexName, String date, Strin
                   "@timestamp": {
                     "type": "date"
                   },
+                  "value": {
+                    "type": "long"
+                  },
                   "%differentiator_field_name%": {
                     "type": "integer"
                   }

From b716a53084f9329d81f9629dd41fcce5999a6cd2 Mon Sep 17 00:00:00 2001
From: John Verwolf <JVerwolf@users.noreply.github.com>
Date: Wed, 4 Dec 2024 10:25:51 -0800
Subject: [PATCH 028/119] Change deprecation.elasticsearch keyword to
 elasticsearch.deprecation (#117933)

Changes the values of the "data_stream.dataset" and "event.dataset" fields to be "elasticsearch.deprecation" instead of "deprecation.elasticsearch".
---
 distribution/src/config/log4j2.properties     |  2 +-
 docs/changelog/117933.yaml                    | 18 ++++++++++
 .../common/logging/JsonLoggerTests.java       | 34 +++++++++----------
 .../logging/json_layout/log4j2.properties     |  5 ++-
 .../common/logging/DeprecatedMessage.java     |  2 +-
 .../xpack/deprecation/DeprecationHttpIT.java  | 28 +++++++--------
 .../logging/DeprecationIndexingComponent.java |  2 +-
 7 files changed, 54 insertions(+), 37 deletions(-)
 create mode 100644 docs/changelog/117933.yaml

diff --git a/distribution/src/config/log4j2.properties b/distribution/src/config/log4j2.properties
index 36b5b03d9a110..bde4d9d17fc17 100644
--- a/distribution/src/config/log4j2.properties
+++ b/distribution/src/config/log4j2.properties
@@ -63,7 +63,7 @@ appender.deprecation_rolling.name = deprecation_rolling
 appender.deprecation_rolling.fileName = ${sys:es.logs.base_path}${sys:file.separator}${sys:es.logs.cluster_name}_deprecation.json
 appender.deprecation_rolling.layout.type = ECSJsonLayout
 # Intentionally follows a different pattern to above
-appender.deprecation_rolling.layout.dataset = deprecation.elasticsearch
+appender.deprecation_rolling.layout.dataset = elasticsearch.deprecation
 appender.deprecation_rolling.filter.rate_limit.type = RateLimitingFilter
 
 appender.deprecation_rolling.filePattern = ${sys:es.logs.base_path}${sys:file.separator}${sys:es.logs.cluster_name}_deprecation-%i.json.gz
diff --git a/docs/changelog/117933.yaml b/docs/changelog/117933.yaml
new file mode 100644
index 0000000000000..92ae31afa30dd
--- /dev/null
+++ b/docs/changelog/117933.yaml
@@ -0,0 +1,18 @@
+pr: 117933
+summary: Change `deprecation.elasticsearch` keyword to `elasticsearch.deprecation`
+area: Infra/Logging
+type: bug
+issues:
+ - 83251
+breaking:
+  title: Deprecation logging value change for "data_stream.dataset" and "event.dataset"
+  area: Logging
+  details: |-
+    This change modifies the "data_stream.dataset" and "event.dataset" value for deprecation logging
+    to use the value `elasticsearch.deprecation` instead of `deprecation.elasticsearch`. This is now
+    consistent with other values where the name of the service is the first part of the key.
+  impact: |-
+    If you are directly consuming deprecation logs for "data_stream.dataset" and "event.dataset" and filtering on
+    this value, you will need to update your filters to use `elasticsearch.deprecation` instead of
+    `deprecation.elasticsearch`.
+  notable: false
diff --git a/qa/logging-config/src/test/java/org/elasticsearch/common/logging/JsonLoggerTests.java b/qa/logging-config/src/test/java/org/elasticsearch/common/logging/JsonLoggerTests.java
index 1066bf1360e41..ed6205c7a5208 100644
--- a/qa/logging-config/src/test/java/org/elasticsearch/common/logging/JsonLoggerTests.java
+++ b/qa/logging-config/src/test/java/org/elasticsearch/common/logging/JsonLoggerTests.java
@@ -125,14 +125,14 @@ public void testDeprecatedMessageWithoutXOpaqueId() throws IOException {
                 jsonLogs,
                 contains(
                     allOf(
-                        hasEntry("event.dataset", "deprecation.elasticsearch"),
+                        hasEntry("event.dataset", "elasticsearch.deprecation"),
                         hasEntry("log.level", "CRITICAL"),
                         hasEntry("log.logger", "org.elasticsearch.deprecation.test"),
                         hasEntry("elasticsearch.cluster.name", "elasticsearch"),
                         hasEntry("elasticsearch.node.name", "sample-name"),
                         hasEntry("message", "deprecated message1"),
                         hasEntry("data_stream.type", "logs"),
-                        hasEntry("data_stream.dataset", "deprecation.elasticsearch"),
+                        hasEntry("data_stream.dataset", "elasticsearch.deprecation"),
                         hasEntry("data_stream.namespace", "default"),
                         hasKey("ecs.version"),
                         hasEntry(DeprecatedMessage.KEY_FIELD_NAME, "a key"),
@@ -168,8 +168,8 @@ public void testCompatibleLog() throws Exception {
                     contains(
                         allOf(
                             hasEntry("log.level", "CRITICAL"),
-                            hasEntry("event.dataset", "deprecation.elasticsearch"),
-                            hasEntry("data_stream.dataset", "deprecation.elasticsearch"),
+                            hasEntry("event.dataset", "elasticsearch.deprecation"),
+                            hasEntry("data_stream.dataset", "elasticsearch.deprecation"),
                             hasEntry("data_stream.namespace", "default"),
                             hasEntry("data_stream.type", "logs"),
                             hasEntry("log.logger", "org.elasticsearch.deprecation.test"),
@@ -186,8 +186,8 @@ public void testCompatibleLog() throws Exception {
                         allOf(
                             hasEntry("log.level", "CRITICAL"),
                             // event.dataset and data_stream.dataset have to be the same across the data stream
-                            hasEntry("event.dataset", "deprecation.elasticsearch"),
-                            hasEntry("data_stream.dataset", "deprecation.elasticsearch"),
+                            hasEntry("event.dataset", "elasticsearch.deprecation"),
+                            hasEntry("data_stream.dataset", "elasticsearch.deprecation"),
                             hasEntry("data_stream.namespace", "default"),
                             hasEntry("data_stream.type", "logs"),
                             hasEntry("log.logger", "org.elasticsearch.deprecation.test"),
@@ -240,8 +240,8 @@ public void testParseFieldEmittingDeprecatedLogs() throws Exception {
                         // deprecation log for field deprecated_name
                         allOf(
                             hasEntry("log.level", "WARN"),
-                            hasEntry("event.dataset", "deprecation.elasticsearch"),
-                            hasEntry("data_stream.dataset", "deprecation.elasticsearch"),
+                            hasEntry("event.dataset", "elasticsearch.deprecation"),
+                            hasEntry("data_stream.dataset", "elasticsearch.deprecation"),
                             hasEntry("data_stream.namespace", "default"),
                             hasEntry("data_stream.type", "logs"),
                             hasEntry("log.logger", "org.elasticsearch.deprecation.xcontent.ParseField"),
@@ -258,8 +258,8 @@ public void testParseFieldEmittingDeprecatedLogs() throws Exception {
                         // deprecation log for field deprecated_name2 (note it is not being throttled)
                         allOf(
                             hasEntry("log.level", "WARN"),
-                            hasEntry("event.dataset", "deprecation.elasticsearch"),
-                            hasEntry("data_stream.dataset", "deprecation.elasticsearch"),
+                            hasEntry("event.dataset", "elasticsearch.deprecation"),
+                            hasEntry("data_stream.dataset", "elasticsearch.deprecation"),
                             hasEntry("data_stream.namespace", "default"),
                             hasEntry("data_stream.type", "logs"),
                             hasEntry("log.logger", "org.elasticsearch.deprecation.xcontent.ParseField"),
@@ -276,8 +276,8 @@ public void testParseFieldEmittingDeprecatedLogs() throws Exception {
                         // compatible log line
                         allOf(
                             hasEntry("log.level", "CRITICAL"),
-                            hasEntry("event.dataset", "deprecation.elasticsearch"),
-                            hasEntry("data_stream.dataset", "deprecation.elasticsearch"),
+                            hasEntry("event.dataset", "elasticsearch.deprecation"),
+                            hasEntry("data_stream.dataset", "elasticsearch.deprecation"),
                             hasEntry("data_stream.namespace", "default"),
                             hasEntry("data_stream.type", "logs"),
                             hasEntry("log.logger", "org.elasticsearch.deprecation.xcontent.ParseField"),
@@ -327,14 +327,14 @@ public void testDeprecatedMessage() throws Exception {
                     jsonLogs,
                     contains(
                         allOf(
-                            hasEntry("event.dataset", "deprecation.elasticsearch"),
+                            hasEntry("event.dataset", "elasticsearch.deprecation"),
                             hasEntry("log.level", "WARN"),
                             hasEntry("log.logger", "org.elasticsearch.deprecation.test"),
                             hasEntry("elasticsearch.cluster.name", "elasticsearch"),
                             hasEntry("elasticsearch.node.name", "sample-name"),
                             hasEntry("message", "deprecated message1"),
                             hasEntry("data_stream.type", "logs"),
-                            hasEntry("data_stream.dataset", "deprecation.elasticsearch"),
+                            hasEntry("data_stream.dataset", "elasticsearch.deprecation"),
                             hasEntry("data_stream.namespace", "default"),
                             hasKey("ecs.version"),
                             hasEntry(DeprecatedMessage.KEY_FIELD_NAME, "someKey"),
@@ -579,7 +579,7 @@ public void testDuplicateLogMessages() throws Exception {
                     jsonLogs,
                     contains(
                         allOf(
-                            hasEntry("event.dataset", "deprecation.elasticsearch"),
+                            hasEntry("event.dataset", "elasticsearch.deprecation"),
                             hasEntry("log.level", "CRITICAL"),
                             hasEntry("log.logger", "org.elasticsearch.deprecation.test"),
                             hasEntry("elasticsearch.cluster.name", "elasticsearch"),
@@ -612,7 +612,7 @@ public void testDuplicateLogMessages() throws Exception {
                     jsonLogs,
                     contains(
                         allOf(
-                            hasEntry("event.dataset", "deprecation.elasticsearch"),
+                            hasEntry("event.dataset", "elasticsearch.deprecation"),
                             hasEntry("log.level", "CRITICAL"),
                             hasEntry("log.logger", "org.elasticsearch.deprecation.test"),
                             hasEntry("elasticsearch.cluster.name", "elasticsearch"),
@@ -622,7 +622,7 @@ public void testDuplicateLogMessages() throws Exception {
                             hasEntry("elasticsearch.event.category", "other")
                         ),
                         allOf(
-                            hasEntry("event.dataset", "deprecation.elasticsearch"),
+                            hasEntry("event.dataset", "elasticsearch.deprecation"),
                             hasEntry("log.level", "CRITICAL"),
                             hasEntry("log.logger", "org.elasticsearch.deprecation.test"),
                             hasEntry("elasticsearch.cluster.name", "elasticsearch"),
diff --git a/qa/logging-config/src/test/resources/org/elasticsearch/common/logging/json_layout/log4j2.properties b/qa/logging-config/src/test/resources/org/elasticsearch/common/logging/json_layout/log4j2.properties
index 46baac4f1433c..b00caca66d03c 100644
--- a/qa/logging-config/src/test/resources/org/elasticsearch/common/logging/json_layout/log4j2.properties
+++ b/qa/logging-config/src/test/resources/org/elasticsearch/common/logging/json_layout/log4j2.properties
@@ -15,14 +15,13 @@ appender.deprecated.name = deprecated
 appender.deprecated.fileName = ${sys:es.logs.base_path}${sys:file.separator}${sys:es.logs.cluster_name}_deprecated.json
 # Intentionally follows a different pattern to above
 appender.deprecated.layout.type = ECSJsonLayout
-appender.deprecated.layout.dataset = deprecation.elasticsearch
+appender.deprecated.layout.dataset = elasticsearch.deprecation
 appender.deprecated.filter.rate_limit.type = RateLimitingFilter
 
 appender.deprecatedconsole.type = Console
 appender.deprecatedconsole.name = deprecatedconsole
 appender.deprecatedconsole.layout.type = ECSJsonLayout
-# Intentionally follows a different pattern to above
-appender.deprecatedconsole.layout.dataset = deprecation.elasticsearch
+appender.deprecatedconsole.layout.dataset = elasticsearch.deprecation
 appender.deprecatedconsole.filter.rate_limit.type = RateLimitingFilter
 
 
diff --git a/server/src/main/java/org/elasticsearch/common/logging/DeprecatedMessage.java b/server/src/main/java/org/elasticsearch/common/logging/DeprecatedMessage.java
index 0bcde14fcf19a..ca89313e59de2 100644
--- a/server/src/main/java/org/elasticsearch/common/logging/DeprecatedMessage.java
+++ b/server/src/main/java/org/elasticsearch/common/logging/DeprecatedMessage.java
@@ -57,7 +57,7 @@ private static ESLogMessage getEsLogMessage(
         String messagePattern,
         Object[] args
     ) {
-        ESLogMessage esLogMessage = new ESLogMessage(messagePattern, args).field("data_stream.dataset", "deprecation.elasticsearch")
+        ESLogMessage esLogMessage = new ESLogMessage(messagePattern, args).field("data_stream.dataset", "elasticsearch.deprecation")
             .field("data_stream.type", "logs")
             .field("data_stream.namespace", "default")
             .field(KEY_FIELD_NAME, key)
diff --git a/x-pack/plugin/deprecation/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/deprecation/DeprecationHttpIT.java b/x-pack/plugin/deprecation/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/deprecation/DeprecationHttpIT.java
index 4a17c2abbd797..2136129a671c8 100644
--- a/x-pack/plugin/deprecation/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/deprecation/DeprecationHttpIT.java
+++ b/x-pack/plugin/deprecation/qa/rest/src/javaRestTest/java/org/elasticsearch/xpack/deprecation/DeprecationHttpIT.java
@@ -339,12 +339,12 @@ public void testDeprecationMessagesCanBeIndexed() throws Exception {
                         hasEntry("elasticsearch.event.category", "settings"),
                         hasKey("elasticsearch.node.id"),
                         hasKey("elasticsearch.node.name"),
-                        hasEntry("data_stream.dataset", "deprecation.elasticsearch"),
+                        hasEntry("data_stream.dataset", "elasticsearch.deprecation"),
                         hasEntry("data_stream.namespace", "default"),
                         hasEntry("data_stream.type", "logs"),
                         hasKey("ecs.version"),
                         hasEntry(KEY_FIELD_NAME, "deprecated_settings"),
-                        hasEntry("event.dataset", "deprecation.elasticsearch"),
+                        hasEntry("event.dataset", "elasticsearch.deprecation"),
                         hasEntry("log.level", "WARN"),
                         hasKey("log.logger"),
                         hasEntry("message", "[deprecated_settings] usage is deprecated. use [settings] instead")
@@ -357,12 +357,12 @@ public void testDeprecationMessagesCanBeIndexed() throws Exception {
                         hasEntry("elasticsearch.event.category", "api"),
                         hasKey("elasticsearch.node.id"),
                         hasKey("elasticsearch.node.name"),
-                        hasEntry("data_stream.dataset", "deprecation.elasticsearch"),
+                        hasEntry("data_stream.dataset", "elasticsearch.deprecation"),
                         hasEntry("data_stream.namespace", "default"),
                         hasEntry("data_stream.type", "logs"),
                         hasKey("ecs.version"),
                         hasEntry(KEY_FIELD_NAME, "deprecated_route_GET_/_test_cluster/deprecated_settings"),
-                        hasEntry("event.dataset", "deprecation.elasticsearch"),
+                        hasEntry("event.dataset", "elasticsearch.deprecation"),
                         hasEntry("log.level", "WARN"),
                         hasKey("log.logger"),
                         hasEntry("message", "[/_test_cluster/deprecated_settings] exists for deprecated tests")
@@ -402,12 +402,12 @@ public void testDeprecationCriticalWarnMessagesCanBeIndexed() throws Exception {
                         hasEntry("elasticsearch.event.category", "settings"),
                         hasKey("elasticsearch.node.id"),
                         hasKey("elasticsearch.node.name"),
-                        hasEntry("data_stream.dataset", "deprecation.elasticsearch"),
+                        hasEntry("data_stream.dataset", "elasticsearch.deprecation"),
                         hasEntry("data_stream.namespace", "default"),
                         hasEntry("data_stream.type", "logs"),
                         hasKey("ecs.version"),
                         hasEntry(KEY_FIELD_NAME, "deprecated_critical_settings"),
-                        hasEntry("event.dataset", "deprecation.elasticsearch"),
+                        hasEntry("event.dataset", "elasticsearch.deprecation"),
                         hasEntry("log.level", "CRITICAL"),
                         hasKey("log.logger"),
                         hasEntry("message", "[deprecated_settings] usage is deprecated. use [settings] instead")
@@ -443,12 +443,12 @@ public void testDeprecationWarnMessagesCanBeIndexed() throws Exception {
                         hasEntry("elasticsearch.event.category", "settings"),
                         hasKey("elasticsearch.node.id"),
                         hasKey("elasticsearch.node.name"),
-                        hasEntry("data_stream.dataset", "deprecation.elasticsearch"),
+                        hasEntry("data_stream.dataset", "elasticsearch.deprecation"),
                         hasEntry("data_stream.namespace", "default"),
                         hasEntry("data_stream.type", "logs"),
                         hasKey("ecs.version"),
                         hasEntry(KEY_FIELD_NAME, "deprecated_warn_settings"),
-                        hasEntry("event.dataset", "deprecation.elasticsearch"),
+                        hasEntry("event.dataset", "elasticsearch.deprecation"),
                         hasEntry("log.level", "WARN"),
                         hasKey("log.logger"),
                         hasEntry("message", "[deprecated_warn_settings] usage is deprecated but won't be breaking in next version")
@@ -461,12 +461,12 @@ public void testDeprecationWarnMessagesCanBeIndexed() throws Exception {
                         hasEntry("elasticsearch.event.category", "api"),
                         hasKey("elasticsearch.node.id"),
                         hasKey("elasticsearch.node.name"),
-                        hasEntry("data_stream.dataset", "deprecation.elasticsearch"),
+                        hasEntry("data_stream.dataset", "elasticsearch.deprecation"),
                         hasEntry("data_stream.namespace", "default"),
                         hasEntry("data_stream.type", "logs"),
                         hasKey("ecs.version"),
                         hasEntry(KEY_FIELD_NAME, "deprecated_route_GET_/_test_cluster/deprecated_settings"),
-                        hasEntry("event.dataset", "deprecation.elasticsearch"),
+                        hasEntry("event.dataset", "elasticsearch.deprecation"),
                         hasEntry("log.level", "WARN"),
                         hasKey("log.logger"),
                         hasEntry("message", "[/_test_cluster/deprecated_settings] exists for deprecated tests")
@@ -619,12 +619,12 @@ public void testCompatibleMessagesCanBeIndexed() throws Exception {
                         hasEntry("elasticsearch.event.category", "compatible_api"),
                         hasKey("elasticsearch.node.id"),
                         hasKey("elasticsearch.node.name"),
-                        hasEntry("data_stream.dataset", "deprecation.elasticsearch"),
+                        hasEntry("data_stream.dataset", "elasticsearch.deprecation"),
                         hasEntry("data_stream.namespace", "default"),
                         hasEntry("data_stream.type", "logs"),
                         hasKey("ecs.version"),
                         hasEntry(KEY_FIELD_NAME, "compatible_key"),
-                        hasEntry("event.dataset", "deprecation.elasticsearch"),
+                        hasEntry("event.dataset", "elasticsearch.deprecation"),
                         hasEntry("log.level", "CRITICAL"),
                         hasKey("log.logger"),
                         hasEntry("message", "You are using a compatible API for this request")
@@ -637,12 +637,12 @@ public void testCompatibleMessagesCanBeIndexed() throws Exception {
                         hasEntry("elasticsearch.event.category", "compatible_api"),
                         hasKey("elasticsearch.node.id"),
                         hasKey("elasticsearch.node.name"),
-                        hasEntry("data_stream.dataset", "deprecation.elasticsearch"),
+                        hasEntry("data_stream.dataset", "elasticsearch.deprecation"),
                         hasEntry("data_stream.namespace", "default"),
                         hasEntry("data_stream.type", "logs"),
                         hasKey("ecs.version"),
                         hasEntry(KEY_FIELD_NAME, "deprecated_route_GET_/_test_cluster/compat_only"),
-                        hasEntry("event.dataset", "deprecation.elasticsearch"),
+                        hasEntry("event.dataset", "elasticsearch.deprecation"),
                         hasEntry("log.level", "CRITICAL"),
                         hasKey("log.logger"),
                         hasEntry("message", "[/_test_cluster/deprecated_settings] exists for deprecated tests")
diff --git a/x-pack/plugin/deprecation/src/main/java/org/elasticsearch/xpack/deprecation/logging/DeprecationIndexingComponent.java b/x-pack/plugin/deprecation/src/main/java/org/elasticsearch/xpack/deprecation/logging/DeprecationIndexingComponent.java
index 29041b0c58434..507f4b18c79e9 100644
--- a/x-pack/plugin/deprecation/src/main/java/org/elasticsearch/xpack/deprecation/logging/DeprecationIndexingComponent.java
+++ b/x-pack/plugin/deprecation/src/main/java/org/elasticsearch/xpack/deprecation/logging/DeprecationIndexingComponent.java
@@ -91,7 +91,7 @@ private DeprecationIndexingComponent(
         final Configuration configuration = context.getConfiguration();
 
         final EcsLayout ecsLayout = ECSJsonLayout.newBuilder()
-            .setDataset("deprecation.elasticsearch")
+            .setDataset("elasticsearch.deprecation")
             .setConfiguration(configuration)
             .build();
 

From 9a81eb2dbe17c3d8ce2920aec33a1d7a89a93c38 Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Wed, 4 Dec 2024 14:10:32 -0500
Subject: [PATCH 029/119] Indicate that rescore isn't allowed with retrievers,
 yet (#118019)

---
 docs/reference/search/retriever.asciidoc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/reference/search/retriever.asciidoc b/docs/reference/search/retriever.asciidoc
index b90b7e312c790..cb04d4fb6fbf1 100644
--- a/docs/reference/search/retriever.asciidoc
+++ b/docs/reference/search/retriever.asciidoc
@@ -765,11 +765,11 @@ clauses in a <<query-dsl-bool-query, boolean query>>.
 [[retriever-restrictions]]
 ==== Restrictions on search parameters when specifying a retriever
 
-When a retriever is specified as part of a search, the following elements are not allowed at the top-level.
-Instead they are only allowed as elements of specific retrievers:
+When a retriever is specified as part of a search, the following elements are not allowed at the top-level:
 
 * <<request-body-search-query, `query`>>
 * <<search-api-knn, `knn`>>
 * <<search-after, `search_after`>>
 * <<request-body-search-terminate-after, `terminate_after`>>
 * <<search-sort-param, `sort`>>
+* <<rescore, `rescore`>>

From eb0020f0558faefbadab1ee952e3a15410f3eb34 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Wed, 4 Dec 2024 21:04:11 +0100
Subject: [PATCH 030/119] Introduce more parallelism into cross cluster test
 bootstrapping (#117820)

We can parallelize starting the clusters and a few other things
to effectively speed up these tests by 2x which comes out to about a minute
of execution time saved for all of those in :server:internalClusterTests
on my workstation.
---
 .../ResolveClusterDataStreamIT.java           |  2 +-
 .../action/CrossClusterPainlessExecuteIT.java |  2 +-
 .../index/reindex/CrossClusterReindexIT.java  |  2 +-
 .../admin/cluster/remote/RemoteInfoIT.java    |  3 +-
 .../cluster/stats/ClusterStatsRemoteIT.java   |  3 +-
 .../action/search/CCSPointInTimeIT.java       |  2 +-
 .../indices/cluster/ResolveClusterIT.java     |  3 +-
 .../search/ccs/CCSCanMatchIT.java             |  2 +-
 .../search/ccs/CCSUsageTelemetryIT.java       | 72 ++++++++++---------
 .../search/ccs/CrossClusterIT.java            |  2 +-
 .../search/ccs/CrossClusterSearchIT.java      |  2 +-
 .../search/ccs/CrossClusterSearchLeakIT.java  |  2 +-
 .../fieldcaps/CCSFieldCapabilitiesIT.java     |  2 +-
 .../retriever/MinimalCompoundRetrieverIT.java |  3 +-
 .../test/AbstractMultiClustersTestCase.java   | 29 ++++----
 .../CCSUsageTelemetryAsyncSearchIT.java       |  2 +-
 .../search/CrossClusterAsyncSearchIT.java     |  2 +-
 .../xpack/core/termsenum/CCSTermsEnumIT.java  |  2 +-
 .../esql/action/CrossClusterAsyncQueryIT.java |  2 +-
 ...ossClusterEnrichUnavailableClustersIT.java |  2 +-
 ...CrossClusterQueryUnavailableRemotesIT.java |  2 +-
 .../action/CrossClustersCancellationIT.java   |  2 +-
 .../esql/action/CrossClustersEnrichIT.java    |  2 +-
 .../esql/action/CrossClustersQueryIT.java     |  2 +-
 .../xpack/ml/integration/DatafeedCcsIT.java   |  2 +-
 .../checkpoint/TransformCCSCanMatchIT.java    |  2 +-
 26 files changed, 80 insertions(+), 73 deletions(-)

diff --git a/modules/data-streams/src/internalClusterTest/java/org/elasticsearch/datastreams/ResolveClusterDataStreamIT.java b/modules/data-streams/src/internalClusterTest/java/org/elasticsearch/datastreams/ResolveClusterDataStreamIT.java
index 4c85958498da0..aa6ecf35e06fa 100644
--- a/modules/data-streams/src/internalClusterTest/java/org/elasticsearch/datastreams/ResolveClusterDataStreamIT.java
+++ b/modules/data-streams/src/internalClusterTest/java/org/elasticsearch/datastreams/ResolveClusterDataStreamIT.java
@@ -78,7 +78,7 @@ public class ResolveClusterDataStreamIT extends AbstractMultiClustersTestCase {
     private static long LATEST_TIMESTAMP = 1691348820000L;
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE_CLUSTER_1, REMOTE_CLUSTER_2);
     }
 
diff --git a/modules/lang-painless/src/internalClusterTest/java/org/elasticsearch/painless/action/CrossClusterPainlessExecuteIT.java b/modules/lang-painless/src/internalClusterTest/java/org/elasticsearch/painless/action/CrossClusterPainlessExecuteIT.java
index 4669ab25f5d8c..b21cabad9290c 100644
--- a/modules/lang-painless/src/internalClusterTest/java/org/elasticsearch/painless/action/CrossClusterPainlessExecuteIT.java
+++ b/modules/lang-painless/src/internalClusterTest/java/org/elasticsearch/painless/action/CrossClusterPainlessExecuteIT.java
@@ -54,7 +54,7 @@ public class CrossClusterPainlessExecuteIT extends AbstractMultiClustersTestCase
     private static final String KEYWORD_FIELD = "my_field";
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE_CLUSTER);
     }
 
diff --git a/modules/reindex/src/internalClusterTest/java/org/elasticsearch/index/reindex/CrossClusterReindexIT.java b/modules/reindex/src/internalClusterTest/java/org/elasticsearch/index/reindex/CrossClusterReindexIT.java
index 8b94337141243..4624393e9fb60 100644
--- a/modules/reindex/src/internalClusterTest/java/org/elasticsearch/index/reindex/CrossClusterReindexIT.java
+++ b/modules/reindex/src/internalClusterTest/java/org/elasticsearch/index/reindex/CrossClusterReindexIT.java
@@ -36,7 +36,7 @@ protected boolean reuseClusters() {
     }
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE_CLUSTER);
     }
 
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/action/admin/cluster/remote/RemoteInfoIT.java b/server/src/internalClusterTest/java/org/elasticsearch/action/admin/cluster/remote/RemoteInfoIT.java
index 25678939cb375..9e578faaac70c 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/action/admin/cluster/remote/RemoteInfoIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/action/admin/cluster/remote/RemoteInfoIT.java
@@ -15,7 +15,6 @@
 import org.elasticsearch.test.InternalTestCluster;
 import org.elasticsearch.test.NodeRoles;
 
-import java.util.Collection;
 import java.util.HashSet;
 import java.util.List;
 import java.util.Set;
@@ -24,7 +23,7 @@
 
 public class RemoteInfoIT extends AbstractMultiClustersTestCase {
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         if (randomBoolean()) {
             return List.of();
         } else {
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/action/admin/cluster/stats/ClusterStatsRemoteIT.java b/server/src/internalClusterTest/java/org/elasticsearch/action/admin/cluster/stats/ClusterStatsRemoteIT.java
index 6cc9824245247..5f4315abff405 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/action/admin/cluster/stats/ClusterStatsRemoteIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/action/admin/cluster/stats/ClusterStatsRemoteIT.java
@@ -23,7 +23,6 @@
 import org.elasticsearch.test.InternalTestCluster;
 import org.junit.Assert;
 
-import java.util.Collection;
 import java.util.List;
 import java.util.Map;
 import java.util.concurrent.ExecutionException;
@@ -51,7 +50,7 @@ protected boolean reuseClusters() {
     }
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE1, REMOTE2);
     }
 
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/action/search/CCSPointInTimeIT.java b/server/src/internalClusterTest/java/org/elasticsearch/action/search/CCSPointInTimeIT.java
index ed92e7704f4ba..7a75313d44189 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/action/search/CCSPointInTimeIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/action/search/CCSPointInTimeIT.java
@@ -44,7 +44,7 @@ public class CCSPointInTimeIT extends AbstractMultiClustersTestCase {
     public static final String REMOTE_CLUSTER = "remote_cluster";
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE_CLUSTER);
     }
 
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/indices/cluster/ResolveClusterIT.java b/server/src/internalClusterTest/java/org/elasticsearch/indices/cluster/ResolveClusterIT.java
index 1a6674edc5147..4bdc5d63f4a2f 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/indices/cluster/ResolveClusterIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/indices/cluster/ResolveClusterIT.java
@@ -28,7 +28,6 @@
 import org.elasticsearch.transport.RemoteClusterAware;
 
 import java.io.IOException;
-import java.util.Collection;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
@@ -54,7 +53,7 @@ public class ResolveClusterIT extends AbstractMultiClustersTestCase {
     private static long LATEST_TIMESTAMP = 1691348820000L;
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE_CLUSTER_1, REMOTE_CLUSTER_2);
     }
 
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CCSCanMatchIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CCSCanMatchIT.java
index 3f354baace85a..ce898d9be15ca 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CCSCanMatchIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CCSCanMatchIT.java
@@ -55,7 +55,7 @@ public class CCSCanMatchIT extends AbstractMultiClustersTestCase {
     static final String REMOTE_CLUSTER = "cluster_a";
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of("cluster_a");
     }
 
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CCSUsageTelemetryIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CCSUsageTelemetryIT.java
index c9d34dbf14015..9c1daccd2cc9e 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CCSUsageTelemetryIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CCSUsageTelemetryIT.java
@@ -11,16 +11,19 @@
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
+import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.admin.cluster.stats.CCSTelemetrySnapshot;
 import org.elasticsearch.action.admin.cluster.stats.CCSUsageTelemetry.Result;
+import org.elasticsearch.action.bulk.BulkRequestBuilder;
 import org.elasticsearch.action.search.ClosePointInTimeRequest;
 import org.elasticsearch.action.search.OpenPointInTimeRequest;
 import org.elasticsearch.action.search.SearchRequest;
-import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.action.search.TransportClosePointInTimeAction;
 import org.elasticsearch.action.search.TransportOpenPointInTimeAction;
 import org.elasticsearch.action.search.TransportSearchAction;
 import org.elasticsearch.action.support.PlainActionFuture;
+import org.elasticsearch.action.support.RefCountingListener;
+import org.elasticsearch.action.support.WriteRequest;
 import org.elasticsearch.client.internal.Client;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.settings.Settings;
@@ -78,7 +81,7 @@ protected boolean reuseClusters() {
     }
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE1, REMOTE2);
     }
 
@@ -126,12 +129,9 @@ private CCSTelemetrySnapshot getTelemetryFromFailedSearch(SearchRequest searchRe
         // We want to send search to a specific node (we don't care which one) so that we could
         // collect the CCS telemetry from it later
         String nodeName = cluster(LOCAL_CLUSTER).getRandomNodeName();
-        PlainActionFuture<SearchResponse> queryFuture = new PlainActionFuture<>();
-        cluster(LOCAL_CLUSTER).client(nodeName).search(searchRequest, queryFuture);
-        assertBusy(() -> assertTrue(queryFuture.isDone()));
 
         // We expect failure, but we don't care too much which failure it is in this test
-        ExecutionException ee = expectThrows(ExecutionException.class, queryFuture::get);
+        ExecutionException ee = expectThrows(ExecutionException.class, cluster(LOCAL_CLUSTER).client(nodeName).search(searchRequest)::get);
         assertNotNull(ee.getCause());
 
         return getTelemetrySnapshot(nodeName);
@@ -637,56 +637,62 @@ private CCSTelemetrySnapshot getTelemetrySnapshot(String nodeName) {
         return usage.getCcsUsageHolder().getCCSTelemetrySnapshot();
     }
 
-    private Map<String, Object> setupClusters() {
+    private Map<String, Object> setupClusters() throws ExecutionException, InterruptedException {
         String localIndex = "demo";
+        String remoteIndex = "prod";
         int numShardsLocal = randomIntBetween(2, 10);
         Settings localSettings = indexSettings(numShardsLocal, randomIntBetween(0, 1)).build();
-        assertAcked(
+        final PlainActionFuture<Void> future = new PlainActionFuture<>();
+        try (RefCountingListener refCountingListener = new RefCountingListener(future)) {
             client(LOCAL_CLUSTER).admin()
                 .indices()
                 .prepareCreate(localIndex)
                 .setSettings(localSettings)
                 .setMapping("@timestamp", "type=date", "f", "type=text")
-        );
-        indexDocs(client(LOCAL_CLUSTER), localIndex);
-
-        String remoteIndex = "prod";
-        int numShardsRemote = randomIntBetween(2, 10);
-        for (String clusterAlias : remoteClusterAlias()) {
-            final InternalTestCluster remoteCluster = cluster(clusterAlias);
-            remoteCluster.ensureAtLeastNumDataNodes(randomIntBetween(2, 3));
-            assertAcked(
+                .execute(refCountingListener.acquire(r -> {
+                    assertAcked(r);
+                    indexDocs(client(LOCAL_CLUSTER), localIndex, refCountingListener.acquire());
+                }));
+
+            int numShardsRemote = randomIntBetween(2, 10);
+            var remotes = remoteClusterAlias();
+            runInParallel(remotes.size(), i -> {
+                final String clusterAlias = remotes.get(i);
+                final InternalTestCluster remoteCluster = cluster(clusterAlias);
+                remoteCluster.ensureAtLeastNumDataNodes(randomIntBetween(2, 3));
                 client(clusterAlias).admin()
                     .indices()
                     .prepareCreate(remoteIndex)
                     .setSettings(indexSettings(numShardsRemote, randomIntBetween(0, 1)))
                     .setMapping("@timestamp", "type=date", "f", "type=text")
-            );
-            assertFalse(
-                client(clusterAlias).admin()
-                    .cluster()
-                    .prepareHealth(TEST_REQUEST_TIMEOUT, remoteIndex)
-                    .setWaitForYellowStatus()
-                    .setTimeout(TimeValue.timeValueSeconds(10))
-                    .get()
-                    .isTimedOut()
-            );
-            indexDocs(client(clusterAlias), remoteIndex);
+                    .execute(refCountingListener.acquire(r -> {
+                        assertAcked(r);
+                        client(clusterAlias).admin()
+                            .cluster()
+                            .prepareHealth(TEST_REQUEST_TIMEOUT, remoteIndex)
+                            .setWaitForYellowStatus()
+                            .setTimeout(TimeValue.timeValueSeconds(10))
+                            .execute(refCountingListener.acquire(healthResponse -> {
+                                assertFalse(healthResponse.isTimedOut());
+                                indexDocs(client(clusterAlias), remoteIndex, refCountingListener.acquire());
+                            }));
+                    }));
+            });
         }
-
+        future.get();
         Map<String, Object> clusterInfo = new HashMap<>();
         clusterInfo.put("local.index", localIndex);
         clusterInfo.put("remote.index", remoteIndex);
         return clusterInfo;
     }
 
-    private int indexDocs(Client client, String index) {
+    private void indexDocs(Client client, String index, ActionListener<Void> listener) {
         int numDocs = between(5, 20);
+        final BulkRequestBuilder bulkRequest = client.prepareBulk();
         for (int i = 0; i < numDocs; i++) {
-            client.prepareIndex(index).setSource("f", "v", "@timestamp", randomNonNegativeLong()).get();
+            bulkRequest.add(client.prepareIndex(index).setSource("f", "v", "@timestamp", randomNonNegativeLong()));
         }
-        client.admin().indices().prepareRefresh(index).get();
-        return numDocs;
+        bulkRequest.setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE).execute(listener.safeMap(r -> null));
     }
 
     /**
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CrossClusterIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CrossClusterIT.java
index cb4d0681cdb23..57a9f8131ac2d 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CrossClusterIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CrossClusterIT.java
@@ -86,7 +86,7 @@
 public class CrossClusterIT extends AbstractMultiClustersTestCase {
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of("cluster_a");
     }
 
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CrossClusterSearchIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CrossClusterSearchIT.java
index 63eece88a53fc..823d3198bc7a2 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CrossClusterSearchIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CrossClusterSearchIT.java
@@ -60,7 +60,7 @@ public class CrossClusterSearchIT extends AbstractMultiClustersTestCase {
     private static long LATEST_TIMESTAMP = 1691348820000L;
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE_CLUSTER);
     }
 
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CrossClusterSearchLeakIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CrossClusterSearchLeakIT.java
index 8b493782d55b5..e8a3df353a01e 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CrossClusterSearchLeakIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/ccs/CrossClusterSearchLeakIT.java
@@ -38,7 +38,7 @@
 public class CrossClusterSearchLeakIT extends AbstractMultiClustersTestCase {
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of("cluster_a");
     }
 
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/fieldcaps/CCSFieldCapabilitiesIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/fieldcaps/CCSFieldCapabilitiesIT.java
index 56b34f9b1dfec..f29cff98c6495 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/fieldcaps/CCSFieldCapabilitiesIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/fieldcaps/CCSFieldCapabilitiesIT.java
@@ -34,7 +34,7 @@
 public class CCSFieldCapabilitiesIT extends AbstractMultiClustersTestCase {
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of("remote_cluster");
     }
 
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/retriever/MinimalCompoundRetrieverIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/retriever/MinimalCompoundRetrieverIT.java
index 97aa428822fae..8dc37bad675e8 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/retriever/MinimalCompoundRetrieverIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/retriever/MinimalCompoundRetrieverIT.java
@@ -26,7 +26,6 @@
 import org.elasticsearch.xcontent.XContentBuilder;
 
 import java.io.IOException;
-import java.util.Collection;
 import java.util.Collections;
 import java.util.HashMap;
 import java.util.List;
@@ -43,7 +42,7 @@ public class MinimalCompoundRetrieverIT extends AbstractMultiClustersTestCase {
     private static final String REMOTE_CLUSTER = "cluster_a";
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE_CLUSTER);
     }
 
diff --git a/test/framework/src/main/java/org/elasticsearch/test/AbstractMultiClustersTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/AbstractMultiClustersTestCase.java
index ea82c9d21ab89..b4f91f68b8bb7 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/AbstractMultiClustersTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/AbstractMultiClustersTestCase.java
@@ -36,10 +36,10 @@
 import java.util.ArrayList;
 import java.util.Collection;
 import java.util.Collections;
-import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 import java.util.Set;
+import java.util.concurrent.ConcurrentHashMap;
 import java.util.function.Function;
 import java.util.stream.Collectors;
 
@@ -58,7 +58,7 @@ public abstract class AbstractMultiClustersTestCase extends ESTestCase {
 
     private static volatile ClusterGroup clusterGroup;
 
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return randomSubsetOf(List.of("cluster-a", "cluster-b"));
     }
 
@@ -100,17 +100,18 @@ public final void startClusters() throws Exception {
             return;
         }
         stopClusters();
-        final Map<String, InternalTestCluster> clusters = new HashMap<>();
+        final Map<String, InternalTestCluster> clusters = new ConcurrentHashMap<>();
         final List<String> clusterAliases = new ArrayList<>(remoteClusterAlias());
         clusterAliases.add(LOCAL_CLUSTER);
-        for (String clusterAlias : clusterAliases) {
+        final List<Class<? extends Plugin>> mockPlugins = List.of(
+            MockHttpTransport.TestPlugin.class,
+            MockTransportService.TestPlugin.class,
+            getTestTransportPlugin()
+        );
+        runInParallel(clusterAliases.size(), i -> {
+            String clusterAlias = clusterAliases.get(i);
             final String clusterName = clusterAlias.equals(LOCAL_CLUSTER) ? "main-cluster" : clusterAlias;
             final int numberOfNodes = randomIntBetween(1, 3);
-            final List<Class<? extends Plugin>> mockPlugins = List.of(
-                MockHttpTransport.TestPlugin.class,
-                MockTransportService.TestPlugin.class,
-                getTestTransportPlugin()
-            );
             final Collection<Class<? extends Plugin>> nodePlugins = nodePlugins(clusterAlias);
 
             final NodeConfigurationSource nodeConfigurationSource = nodeConfigurationSource(nodeSettings(), nodePlugins);
@@ -128,10 +129,14 @@ public final void startClusters() throws Exception {
                 mockPlugins,
                 Function.identity()
             );
-            cluster.beforeTest(random());
+            try {
+                cluster.beforeTest(random());
+            } catch (Exception e) {
+                throw new RuntimeException(e);
+            }
             clusters.put(clusterAlias, cluster);
-        }
-        clusterGroup = new ClusterGroup(clusters);
+        });
+        clusterGroup = new ClusterGroup(Map.copyOf(clusters));
         configureAndConnectsToRemoteClusters();
     }
 
diff --git a/x-pack/plugin/async-search/src/internalClusterTest/java/org/elasticsearch/xpack/search/CCSUsageTelemetryAsyncSearchIT.java b/x-pack/plugin/async-search/src/internalClusterTest/java/org/elasticsearch/xpack/search/CCSUsageTelemetryAsyncSearchIT.java
index 65f9f13846126..1b19f6f04693b 100644
--- a/x-pack/plugin/async-search/src/internalClusterTest/java/org/elasticsearch/xpack/search/CCSUsageTelemetryAsyncSearchIT.java
+++ b/x-pack/plugin/async-search/src/internalClusterTest/java/org/elasticsearch/xpack/search/CCSUsageTelemetryAsyncSearchIT.java
@@ -60,7 +60,7 @@ protected boolean reuseClusters() {
     }
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE1, REMOTE2);
     }
 
diff --git a/x-pack/plugin/async-search/src/internalClusterTest/java/org/elasticsearch/xpack/search/CrossClusterAsyncSearchIT.java b/x-pack/plugin/async-search/src/internalClusterTest/java/org/elasticsearch/xpack/search/CrossClusterAsyncSearchIT.java
index 3b5647da1399f..2a8daf8bfe12c 100644
--- a/x-pack/plugin/async-search/src/internalClusterTest/java/org/elasticsearch/xpack/search/CrossClusterAsyncSearchIT.java
+++ b/x-pack/plugin/async-search/src/internalClusterTest/java/org/elasticsearch/xpack/search/CrossClusterAsyncSearchIT.java
@@ -88,7 +88,7 @@ public class CrossClusterAsyncSearchIT extends AbstractMultiClustersTestCase {
     private static final long LATEST_TIMESTAMP = 1691348820000L;
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE_CLUSTER);
     }
 
diff --git a/x-pack/plugin/core/src/internalClusterTest/java/org/elasticsearch/xpack/core/termsenum/CCSTermsEnumIT.java b/x-pack/plugin/core/src/internalClusterTest/java/org/elasticsearch/xpack/core/termsenum/CCSTermsEnumIT.java
index 157628be9fbc9..f5c070073d9b5 100644
--- a/x-pack/plugin/core/src/internalClusterTest/java/org/elasticsearch/xpack/core/termsenum/CCSTermsEnumIT.java
+++ b/x-pack/plugin/core/src/internalClusterTest/java/org/elasticsearch/xpack/core/termsenum/CCSTermsEnumIT.java
@@ -26,7 +26,7 @@
 public class CCSTermsEnumIT extends AbstractMultiClustersTestCase {
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of("remote_cluster");
     }
 
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClusterAsyncQueryIT.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClusterAsyncQueryIT.java
index 440582dcfbb45..c8206621de419 100644
--- a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClusterAsyncQueryIT.java
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClusterAsyncQueryIT.java
@@ -66,7 +66,7 @@ public class CrossClusterAsyncQueryIT extends AbstractMultiClustersTestCase {
     private static final String INDEX_WITH_RUNTIME_MAPPING = "blocking";
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE_CLUSTER_1, REMOTE_CLUSTER_2);
     }
 
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClusterEnrichUnavailableClustersIT.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClusterEnrichUnavailableClustersIT.java
index d142752d0c408..5c3e1974e924f 100644
--- a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClusterEnrichUnavailableClustersIT.java
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClusterEnrichUnavailableClustersIT.java
@@ -53,7 +53,7 @@ public class CrossClusterEnrichUnavailableClustersIT extends AbstractMultiCluste
     public static String REMOTE_CLUSTER_2 = "c2";
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE_CLUSTER_1, REMOTE_CLUSTER_2);
     }
 
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClusterQueryUnavailableRemotesIT.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClusterQueryUnavailableRemotesIT.java
index 0f1aa8541fdd9..d1c9b5cfb2ac7 100644
--- a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClusterQueryUnavailableRemotesIT.java
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClusterQueryUnavailableRemotesIT.java
@@ -42,7 +42,7 @@ public class CrossClusterQueryUnavailableRemotesIT extends AbstractMultiClusters
     private static final String REMOTE_CLUSTER_2 = "cluster-b";
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE_CLUSTER_1, REMOTE_CLUSTER_2);
     }
 
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClustersCancellationIT.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClustersCancellationIT.java
index f29f79976dc0d..5291ad3b0d039 100644
--- a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClustersCancellationIT.java
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClustersCancellationIT.java
@@ -55,7 +55,7 @@ public class CrossClustersCancellationIT extends AbstractMultiClustersTestCase {
     private static final String REMOTE_CLUSTER = "cluster-a";
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE_CLUSTER);
     }
 
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClustersEnrichIT.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClustersEnrichIT.java
index e8e9f45694e9c..57f85751999a5 100644
--- a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClustersEnrichIT.java
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClustersEnrichIT.java
@@ -64,7 +64,7 @@
 public class CrossClustersEnrichIT extends AbstractMultiClustersTestCase {
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of("c1", "c2");
     }
 
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClustersQueryIT.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClustersQueryIT.java
index 596c70e57ccd6..46bbad5551e6b 100644
--- a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClustersQueryIT.java
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/CrossClustersQueryIT.java
@@ -67,7 +67,7 @@ public class CrossClustersQueryIT extends AbstractMultiClustersTestCase {
     private static String REMOTE_INDEX = "logs-2";
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE_CLUSTER_1, REMOTE_CLUSTER_2);
     }
 
diff --git a/x-pack/plugin/ml/src/internalClusterTest/java/org/elasticsearch/xpack/ml/integration/DatafeedCcsIT.java b/x-pack/plugin/ml/src/internalClusterTest/java/org/elasticsearch/xpack/ml/integration/DatafeedCcsIT.java
index 139d1b074c7b2..e437c91c8e50e 100644
--- a/x-pack/plugin/ml/src/internalClusterTest/java/org/elasticsearch/xpack/ml/integration/DatafeedCcsIT.java
+++ b/x-pack/plugin/ml/src/internalClusterTest/java/org/elasticsearch/xpack/ml/integration/DatafeedCcsIT.java
@@ -94,7 +94,7 @@ protected Collection<Class<? extends Plugin>> nodePlugins(String clusterAlias) {
     }
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE_CLUSTER);
     }
 
diff --git a/x-pack/plugin/transform/src/internalClusterTest/java/org/elasticsearch/xpack/transform/checkpoint/TransformCCSCanMatchIT.java b/x-pack/plugin/transform/src/internalClusterTest/java/org/elasticsearch/xpack/transform/checkpoint/TransformCCSCanMatchIT.java
index 208da4177fd4c..e4e577299d0d7 100644
--- a/x-pack/plugin/transform/src/internalClusterTest/java/org/elasticsearch/xpack/transform/checkpoint/TransformCCSCanMatchIT.java
+++ b/x-pack/plugin/transform/src/internalClusterTest/java/org/elasticsearch/xpack/transform/checkpoint/TransformCCSCanMatchIT.java
@@ -385,7 +385,7 @@ protected NamedXContentRegistry xContentRegistry() {
     }
 
     @Override
-    protected Collection<String> remoteClusterAlias() {
+    protected List<String> remoteClusterAlias() {
         return List.of(REMOTE_CLUSTER);
     }
 

From a2ea8549c8a0fe7efd22617a8fd6bf74a2b55cd4 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Thu, 5 Dec 2024 08:20:22 +1100
Subject: [PATCH 031/119] Mute org.elasticsearch.upgrades.QueryBuilderBWCIT
 testQueryBuilderBWC {cluster=UPGRADED} #116990

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 0b9027a406088..1f2f5735c4a7c 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -239,6 +239,9 @@ tests:
 - class: org.elasticsearch.packaging.test.CertGenCliTests
   method: test40RunWithCert
   issue: https://github.com/elastic/elasticsearch/issues/117955
+- class: org.elasticsearch.upgrades.QueryBuilderBWCIT
+  method: testQueryBuilderBWC {cluster=UPGRADED}
+  issue: https://github.com/elastic/elasticsearch/issues/116990
 
 # Examples:
 #

From 9df4a4968f297d1407743a2f55be2f1feec52f70 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Thu, 5 Dec 2024 08:20:32 +1100
Subject: [PATCH 032/119] Mute
 org.elasticsearch.xpack.restart.QueryBuilderBWCIT testQueryBuilderBWC
 {p0=UPGRADED} #116989

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 1f2f5735c4a7c..0b400f420e86b 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -242,6 +242,9 @@ tests:
 - class: org.elasticsearch.upgrades.QueryBuilderBWCIT
   method: testQueryBuilderBWC {cluster=UPGRADED}
   issue: https://github.com/elastic/elasticsearch/issues/116990
+- class: org.elasticsearch.xpack.restart.QueryBuilderBWCIT
+  method: testQueryBuilderBWC {p0=UPGRADED}
+  issue: https://github.com/elastic/elasticsearch/issues/116989
 
 # Examples:
 #

From 4e8e9731567d66ed4cb7c3a2c7ed5af744e32ae7 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Wed, 4 Dec 2024 22:22:36 +0100
Subject: [PATCH 033/119] Remove some dead code from SearchPhase and friends
 (#116645)

The separate `onFailure` is unnecessary, just fail the phase like we do
elsewhere. Also make utility method static.
---
 .../action/search/AbstractSearchAsyncAction.java         | 9 +--------
 .../elasticsearch/action/search/ExpandSearchPhase.java   | 8 ++++++--
 .../action/search/MockSearchPhaseContext.java            | 5 -----
 3 files changed, 7 insertions(+), 15 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/action/search/AbstractSearchAsyncAction.java b/server/src/main/java/org/elasticsearch/action/search/AbstractSearchAsyncAction.java
index 09fb70fb06ba4..800193e258dba 100644
--- a/server/src/main/java/org/elasticsearch/action/search/AbstractSearchAsyncAction.java
+++ b/server/src/main/java/org/elasticsearch/action/search/AbstractSearchAsyncAction.java
@@ -739,7 +739,7 @@ void sendReleaseSearchContext(ShardSearchContextId contextId, Transport.Connecti
      * @see #onShardFailure(int, SearchShardTarget, Exception)
      * @see #onShardResult(SearchPhaseResult, SearchShardIterator)
      */
-    final void onPhaseDone() {  // as a tribute to @kimchy aka. finishHim()
+    private void onPhaseDone() {  // as a tribute to @kimchy aka. finishHim()
         executeNextPhase(this, this::getNextPhase);
     }
 
@@ -762,13 +762,6 @@ public final void execute(Runnable command) {
         executor.execute(command);
     }
 
-    /**
-      * Notifies the top-level listener of the provided exception
-    */
-    public void onFailure(Exception e) {
-        listener.onFailure(e);
-    }
-
     /**
      * Builds an request for the initial search phase.
      *
diff --git a/server/src/main/java/org/elasticsearch/action/search/ExpandSearchPhase.java b/server/src/main/java/org/elasticsearch/action/search/ExpandSearchPhase.java
index 8feed2aea00b0..e8d94c32bdcc7 100644
--- a/server/src/main/java/org/elasticsearch/action/search/ExpandSearchPhase.java
+++ b/server/src/main/java/org/elasticsearch/action/search/ExpandSearchPhase.java
@@ -102,7 +102,7 @@ private void doRun() {
                 for (InnerHitBuilder innerHitBuilder : innerHitBuilders) {
                     MultiSearchResponse.Item item = it.next();
                     if (item.isFailure()) {
-                        context.onPhaseFailure(this, "failed to expand hits", item.getFailure());
+                        phaseFailure(item.getFailure());
                         return;
                     }
                     SearchHits innerHits = item.getResponse().getHits();
@@ -119,7 +119,11 @@ private void doRun() {
                 }
             }
             onPhaseDone();
-        }, context::onFailure));
+        }, this::phaseFailure));
+    }
+
+    private void phaseFailure(Exception ex) {
+        context.onPhaseFailure(this, "failed to expand hits", ex);
     }
 
     private static SearchSourceBuilder buildExpandSearchSourceBuilder(InnerHitBuilder options, CollapseBuilder innerCollapseBuilder) {
diff --git a/server/src/test/java/org/elasticsearch/action/search/MockSearchPhaseContext.java b/server/src/test/java/org/elasticsearch/action/search/MockSearchPhaseContext.java
index 484b3c6b386fd..7a38858d8477a 100644
--- a/server/src/test/java/org/elasticsearch/action/search/MockSearchPhaseContext.java
+++ b/server/src/test/java/org/elasticsearch/action/search/MockSearchPhaseContext.java
@@ -154,11 +154,6 @@ protected void executePhaseOnShard(
         }, shardIt);
     }
 
-    @Override
-    public void onFailure(Exception e) {
-        Assert.fail("should not be called");
-    }
-
     @Override
     public void sendReleaseSearchContext(ShardSearchContextId contextId, Transport.Connection connection, OriginalIndices originalIndices) {
         releasedSearchContexts.add(contextId);

From 2a677db7d3ba3f4bdc9f48f3e3c287c32604d189 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Thu, 5 Dec 2024 16:48:39 +1100
Subject: [PATCH 034/119] Mute
 org.elasticsearch.index.reindex.ReindexNodeShutdownIT testReindexWithShutdown
 #118040

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 0b400f420e86b..f525607a848d0 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -245,6 +245,9 @@ tests:
 - class: org.elasticsearch.xpack.restart.QueryBuilderBWCIT
   method: testQueryBuilderBWC {p0=UPGRADED}
   issue: https://github.com/elastic/elasticsearch/issues/116989
+- class: org.elasticsearch.index.reindex.ReindexNodeShutdownIT
+  method: testReindexWithShutdown
+  issue: https://github.com/elastic/elasticsearch/issues/118040
 
 # Examples:
 #

From fa48715f85eb6dae0eee93153b34ead02278b553 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Thu, 5 Dec 2024 17:30:01 +1100
Subject: [PATCH 035/119] Mute org.elasticsearch.xpack.test.rest.XPackRestIT
 test {p0=esql/60_usage/Basic ESQL usage output (telemetry) non-snapshot
 version} #117862

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index f525607a848d0..de18c08337e11 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -248,6 +248,9 @@ tests:
 - class: org.elasticsearch.index.reindex.ReindexNodeShutdownIT
   method: testReindexWithShutdown
   issue: https://github.com/elastic/elasticsearch/issues/118040
+- class: org.elasticsearch.xpack.test.rest.XPackRestIT
+  method: test {p0=esql/60_usage/Basic ESQL usage output (telemetry) non-snapshot version}
+  issue: https://github.com/elastic/elasticsearch/issues/117862
 
 # Examples:
 #

From 0d4c0f208087ca84d9727b777a366bb1448f2a4c Mon Sep 17 00:00:00 2001
From: Panagiotis Bailis <pmpailis@gmail.com>
Date: Thu, 5 Dec 2024 09:06:53 +0200
Subject: [PATCH 036/119] Fix for propagating filters from compound to inner
 retrievers (#117914)

---
 docs/changelog/117914.yaml                    |  5 ++
 .../retriever/CompoundRetrieverBuilder.java   | 32 +++++---
 .../search/retriever/KnnRetrieverBuilder.java |  3 +-
 .../retriever/RankDocsRetrieverBuilder.java   | 16 +---
 .../RankDocsRetrieverBuilderTests.java        |  7 +-
 .../vectors/TestQueryVectorBuilderPlugin.java |  8 +-
 .../TestCompoundRetrieverBuilder.java         | 10 ++-
 .../retriever/QueryRuleRetrieverBuilder.java  | 15 +++-
 .../TextSimilarityRankRetrieverBuilder.java   |  7 +-
 .../xpack/rank/rrf/RRFRetrieverBuilderIT.java | 38 +++++++++-
 .../xpack/rank/rrf/RRFFeatures.java           |  6 ++
 .../xpack/rank/rrf/RRFRetrieverBuilder.java   |  7 +-
 ...rrf_retriever_search_api_compatibility.yml | 74 +++++++++++++++++++
 13 files changed, 180 insertions(+), 48 deletions(-)
 create mode 100644 docs/changelog/117914.yaml

diff --git a/docs/changelog/117914.yaml b/docs/changelog/117914.yaml
new file mode 100644
index 0000000000000..da58ed7bb04b7
--- /dev/null
+++ b/docs/changelog/117914.yaml
@@ -0,0 +1,5 @@
+pr: 117914
+summary: Fix for propagating filters from compound to inner retrievers
+area: Ranking
+type: bug
+issues: []
diff --git a/server/src/main/java/org/elasticsearch/search/retriever/CompoundRetrieverBuilder.java b/server/src/main/java/org/elasticsearch/search/retriever/CompoundRetrieverBuilder.java
index db839de9f573a..2ab6395db73b5 100644
--- a/server/src/main/java/org/elasticsearch/search/retriever/CompoundRetrieverBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/retriever/CompoundRetrieverBuilder.java
@@ -20,6 +20,7 @@
 import org.elasticsearch.action.search.SearchRequest;
 import org.elasticsearch.action.search.SearchResponse;
 import org.elasticsearch.action.search.TransportMultiSearchAction;
+import org.elasticsearch.features.NodeFeature;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryRewriteContext;
 import org.elasticsearch.rest.RestStatus;
@@ -46,6 +47,8 @@
  */
 public abstract class CompoundRetrieverBuilder<T extends CompoundRetrieverBuilder<T>> extends RetrieverBuilder {
 
+    public static final NodeFeature INNER_RETRIEVERS_FILTER_SUPPORT = new NodeFeature("inner_retrievers_filter_support");
+
     public record RetrieverSource(RetrieverBuilder retriever, SearchSourceBuilder source) {}
 
     protected final int rankWindowSize;
@@ -64,9 +67,9 @@ public T addChild(RetrieverBuilder retrieverBuilder) {
 
     /**
      * Returns a clone of the original retriever, replacing the sub-retrievers with
-     * the provided {@code newChildRetrievers}.
+     * the provided {@code newChildRetrievers} and the filters with the {@code newPreFilterQueryBuilders}.
      */
-    protected abstract T clone(List<RetrieverSource> newChildRetrievers);
+    protected abstract T clone(List<RetrieverSource> newChildRetrievers, List<QueryBuilder> newPreFilterQueryBuilders);
 
     /**
      * Combines the provided {@code rankResults} to return the final top documents.
@@ -85,13 +88,25 @@ public final RetrieverBuilder rewrite(QueryRewriteContext ctx) throws IOExceptio
         }
 
         // Rewrite prefilters
-        boolean hasChanged = false;
+        // We eagerly rewrite prefilters, because some of the innerRetrievers
+        // could be compound too, so we want to propagate all the necessary filter information to them
+        // and have it available as part of their own rewrite step
         var newPreFilters = rewritePreFilters(ctx);
-        hasChanged |= newPreFilters != preFilterQueryBuilders;
+        if (newPreFilters != preFilterQueryBuilders) {
+            return clone(innerRetrievers, newPreFilters);
+        }
 
+        boolean hasChanged = false;
         // Rewrite retriever sources
         List<RetrieverSource> newRetrievers = new ArrayList<>();
         for (var entry : innerRetrievers) {
+            // we propagate the filters only for compound retrievers as they won't be attached through
+            // the createSearchSourceBuilder.
+            // We could remove this check, but we would end up adding the same filters
+            // multiple times in case an inner retriever rewrites itself, when we re-enter to rewrite
+            if (entry.retriever.isCompound() && false == preFilterQueryBuilders.isEmpty()) {
+                entry.retriever.getPreFilterQueryBuilders().addAll(preFilterQueryBuilders);
+            }
             RetrieverBuilder newRetriever = entry.retriever.rewrite(ctx);
             if (newRetriever != entry.retriever) {
                 newRetrievers.add(new RetrieverSource(newRetriever, null));
@@ -106,7 +121,7 @@ public final RetrieverBuilder rewrite(QueryRewriteContext ctx) throws IOExceptio
             }
         }
         if (hasChanged) {
-            return clone(newRetrievers);
+            return clone(newRetrievers, newPreFilters);
         }
 
         // execute searches
@@ -166,12 +181,7 @@ public void onFailure(Exception e) {
             });
         });
 
-        return new RankDocsRetrieverBuilder(
-            rankWindowSize,
-            newRetrievers.stream().map(s -> s.retriever).toList(),
-            results::get,
-            newPreFilters
-        );
+        return new RankDocsRetrieverBuilder(rankWindowSize, newRetrievers.stream().map(s -> s.retriever).toList(), results::get);
     }
 
     @Override
diff --git a/server/src/main/java/org/elasticsearch/search/retriever/KnnRetrieverBuilder.java b/server/src/main/java/org/elasticsearch/search/retriever/KnnRetrieverBuilder.java
index 8be9a78dae154..f1464c41ca3be 100644
--- a/server/src/main/java/org/elasticsearch/search/retriever/KnnRetrieverBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/retriever/KnnRetrieverBuilder.java
@@ -184,8 +184,7 @@ public RetrieverBuilder rewrite(QueryRewriteContext ctx) throws IOException {
                     ll.onResponse(null);
                 }));
             });
-            var rewritten = new KnnRetrieverBuilder(this, () -> toSet.get(), null);
-            return rewritten;
+            return new KnnRetrieverBuilder(this, () -> toSet.get(), null);
         }
         return super.rewrite(ctx);
     }
diff --git a/server/src/main/java/org/elasticsearch/search/retriever/RankDocsRetrieverBuilder.java b/server/src/main/java/org/elasticsearch/search/retriever/RankDocsRetrieverBuilder.java
index 02f890f51d011..4d3f3fefd4462 100644
--- a/server/src/main/java/org/elasticsearch/search/retriever/RankDocsRetrieverBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/retriever/RankDocsRetrieverBuilder.java
@@ -33,19 +33,13 @@ public class RankDocsRetrieverBuilder extends RetrieverBuilder {
     final List<RetrieverBuilder> sources;
     final Supplier<RankDoc[]> rankDocs;
 
-    public RankDocsRetrieverBuilder(
-        int rankWindowSize,
-        List<RetrieverBuilder> sources,
-        Supplier<RankDoc[]> rankDocs,
-        List<QueryBuilder> preFilterQueryBuilders
-    ) {
+    public RankDocsRetrieverBuilder(int rankWindowSize, List<RetrieverBuilder> sources, Supplier<RankDoc[]> rankDocs) {
         this.rankWindowSize = rankWindowSize;
         this.rankDocs = rankDocs;
         if (sources == null || sources.isEmpty()) {
             throw new IllegalArgumentException("sources must not be null or empty");
         }
         this.sources = sources;
-        this.preFilterQueryBuilders = preFilterQueryBuilders;
     }
 
     @Override
@@ -73,10 +67,6 @@ private boolean sourceShouldRewrite(QueryRewriteContext ctx) throws IOException
     @Override
     public RetrieverBuilder rewrite(QueryRewriteContext ctx) throws IOException {
         assert false == sourceShouldRewrite(ctx) : "retriever sources should be rewritten first";
-        var rewrittenFilters = rewritePreFilters(ctx);
-        if (rewrittenFilters != preFilterQueryBuilders) {
-            return new RankDocsRetrieverBuilder(rankWindowSize, sources, rankDocs, rewrittenFilters);
-        }
         return this;
     }
 
@@ -94,7 +84,7 @@ public QueryBuilder topDocsQuery() {
                 boolQuery.should(query);
             }
         }
-        // ignore prefilters of this level, they are already propagated to children
+        // ignore prefilters of this level, they were already propagated to children
         return boolQuery;
     }
 
@@ -133,7 +123,7 @@ public void extractToSearchSourceBuilder(SearchSourceBuilder searchSourceBuilder
         } else {
             rankQuery = new RankDocsQueryBuilder(rankDocResults, null, false);
         }
-        // ignore prefilters of this level, they are already propagated to children
+        // ignore prefilters of this level, they were already propagated to children
         searchSourceBuilder.query(rankQuery);
         if (sourceHasMinScore()) {
             searchSourceBuilder.minScore(this.minScore() == null ? Float.MIN_VALUE : this.minScore());
diff --git a/server/src/test/java/org/elasticsearch/search/retriever/RankDocsRetrieverBuilderTests.java b/server/src/test/java/org/elasticsearch/search/retriever/RankDocsRetrieverBuilderTests.java
index af6782c45dce8..ccf33c0b71b6b 100644
--- a/server/src/test/java/org/elasticsearch/search/retriever/RankDocsRetrieverBuilderTests.java
+++ b/server/src/test/java/org/elasticsearch/search/retriever/RankDocsRetrieverBuilderTests.java
@@ -95,12 +95,7 @@ private List<QueryBuilder> preFilters(QueryRewriteContext queryRewriteContext) t
     }
 
     private RankDocsRetrieverBuilder createRandomRankDocsRetrieverBuilder(QueryRewriteContext queryRewriteContext) throws IOException {
-        return new RankDocsRetrieverBuilder(
-            randomIntBetween(1, 100),
-            innerRetrievers(queryRewriteContext),
-            rankDocsSupplier(),
-            preFilters(queryRewriteContext)
-        );
+        return new RankDocsRetrieverBuilder(randomIntBetween(1, 100), innerRetrievers(queryRewriteContext), rankDocsSupplier());
     }
 
     public void testExtractToSearchSourceBuilder() throws IOException {
diff --git a/server/src/test/java/org/elasticsearch/search/vectors/TestQueryVectorBuilderPlugin.java b/server/src/test/java/org/elasticsearch/search/vectors/TestQueryVectorBuilderPlugin.java
index c47c8c16f6a2f..5733a51bb7e9c 100644
--- a/server/src/test/java/org/elasticsearch/search/vectors/TestQueryVectorBuilderPlugin.java
+++ b/server/src/test/java/org/elasticsearch/search/vectors/TestQueryVectorBuilderPlugin.java
@@ -27,9 +27,9 @@
 /**
  * A SearchPlugin to exercise query vector builder
  */
-class TestQueryVectorBuilderPlugin implements SearchPlugin {
+public class TestQueryVectorBuilderPlugin implements SearchPlugin {
 
-    static class TestQueryVectorBuilder implements QueryVectorBuilder {
+    public static class TestQueryVectorBuilder implements QueryVectorBuilder {
         private static final String NAME = "test_query_vector_builder";
 
         private static final ParseField QUERY_VECTOR = new ParseField("query_vector");
@@ -47,11 +47,11 @@ static class TestQueryVectorBuilder implements QueryVectorBuilder {
 
         private List<Float> vectorToBuild;
 
-        TestQueryVectorBuilder(List<Float> vectorToBuild) {
+        public TestQueryVectorBuilder(List<Float> vectorToBuild) {
             this.vectorToBuild = vectorToBuild;
         }
 
-        TestQueryVectorBuilder(float[] expected) {
+        public TestQueryVectorBuilder(float[] expected) {
             this.vectorToBuild = new ArrayList<>(expected.length);
             for (float f : expected) {
                 vectorToBuild.add(f);
diff --git a/test/framework/src/main/java/org/elasticsearch/search/retriever/TestCompoundRetrieverBuilder.java b/test/framework/src/main/java/org/elasticsearch/search/retriever/TestCompoundRetrieverBuilder.java
index 9f199aa7f3ef8..4a5f280c10a99 100644
--- a/test/framework/src/main/java/org/elasticsearch/search/retriever/TestCompoundRetrieverBuilder.java
+++ b/test/framework/src/main/java/org/elasticsearch/search/retriever/TestCompoundRetrieverBuilder.java
@@ -10,6 +10,7 @@
 package org.elasticsearch.search.retriever;
 
 import org.apache.lucene.search.ScoreDoc;
+import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.search.rank.RankDoc;
 import org.elasticsearch.xcontent.XContentBuilder;
 
@@ -23,16 +24,17 @@ public class TestCompoundRetrieverBuilder extends CompoundRetrieverBuilder<TestC
     public static final String NAME = "test_compound_retriever_builder";
 
     public TestCompoundRetrieverBuilder(int rankWindowSize) {
-        this(new ArrayList<>(), rankWindowSize);
+        this(new ArrayList<>(), rankWindowSize, new ArrayList<>());
     }
 
-    TestCompoundRetrieverBuilder(List<RetrieverSource> childRetrievers, int rankWindowSize) {
+    TestCompoundRetrieverBuilder(List<RetrieverSource> childRetrievers, int rankWindowSize, List<QueryBuilder> preFilterQueryBuilders) {
         super(childRetrievers, rankWindowSize);
+        this.preFilterQueryBuilders = preFilterQueryBuilders;
     }
 
     @Override
-    protected TestCompoundRetrieverBuilder clone(List<RetrieverSource> newChildRetrievers) {
-        return new TestCompoundRetrieverBuilder(newChildRetrievers, rankWindowSize);
+    protected TestCompoundRetrieverBuilder clone(List<RetrieverSource> newChildRetrievers, List<QueryBuilder> newPreFilterQueryBuilders) {
+        return new TestCompoundRetrieverBuilder(newChildRetrievers, rankWindowSize, newPreFilterQueryBuilders);
     }
 
     @Override
diff --git a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/rules/retriever/QueryRuleRetrieverBuilder.java b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/rules/retriever/QueryRuleRetrieverBuilder.java
index 54a89d061de35..5b27cc7a3e05a 100644
--- a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/rules/retriever/QueryRuleRetrieverBuilder.java
+++ b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/rules/retriever/QueryRuleRetrieverBuilder.java
@@ -110,12 +110,14 @@ public QueryRuleRetrieverBuilder(
         Map<String, Object> matchCriteria,
         List<RetrieverSource> retrieverSource,
         int rankWindowSize,
-        String retrieverName
+        String retrieverName,
+        List<QueryBuilder> preFilterQueryBuilders
     ) {
         super(retrieverSource, rankWindowSize);
         this.rulesetIds = rulesetIds;
         this.matchCriteria = matchCriteria;
         this.retrieverName = retrieverName;
+        this.preFilterQueryBuilders = preFilterQueryBuilders;
     }
 
     @Override
@@ -156,8 +158,15 @@ public void doToXContent(XContentBuilder builder, Params params) throws IOExcept
     }
 
     @Override
-    protected QueryRuleRetrieverBuilder clone(List<RetrieverSource> newChildRetrievers) {
-        return new QueryRuleRetrieverBuilder(rulesetIds, matchCriteria, newChildRetrievers, rankWindowSize, retrieverName);
+    protected QueryRuleRetrieverBuilder clone(List<RetrieverSource> newChildRetrievers, List<QueryBuilder> newPreFilterQueryBuilders) {
+        return new QueryRuleRetrieverBuilder(
+            rulesetIds,
+            matchCriteria,
+            newChildRetrievers,
+            rankWindowSize,
+            retrieverName,
+            newPreFilterQueryBuilders
+        );
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverBuilder.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverBuilder.java
index c239319b6283a..fd2427dc8ac6a 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverBuilder.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankRetrieverBuilder.java
@@ -129,7 +129,10 @@ public TextSimilarityRankRetrieverBuilder(
     }
 
     @Override
-    protected TextSimilarityRankRetrieverBuilder clone(List<RetrieverSource> newChildRetrievers) {
+    protected TextSimilarityRankRetrieverBuilder clone(
+        List<RetrieverSource> newChildRetrievers,
+        List<QueryBuilder> newPreFilterQueryBuilders
+    ) {
         return new TextSimilarityRankRetrieverBuilder(
             newChildRetrievers,
             inferenceId,
@@ -138,7 +141,7 @@ protected TextSimilarityRankRetrieverBuilder clone(List<RetrieverSource> newChil
             rankWindowSize,
             minScore,
             retrieverName,
-            preFilterQueryBuilders
+            newPreFilterQueryBuilders
         );
     }
 
diff --git a/x-pack/plugin/rank-rrf/src/internalClusterTest/java/org/elasticsearch/xpack/rank/rrf/RRFRetrieverBuilderIT.java b/x-pack/plugin/rank-rrf/src/internalClusterTest/java/org/elasticsearch/xpack/rank/rrf/RRFRetrieverBuilderIT.java
index 37e1807d138aa..ae35153b6f39f 100644
--- a/x-pack/plugin/rank-rrf/src/internalClusterTest/java/org/elasticsearch/xpack/rank/rrf/RRFRetrieverBuilderIT.java
+++ b/x-pack/plugin/rank-rrf/src/internalClusterTest/java/org/elasticsearch/xpack/rank/rrf/RRFRetrieverBuilderIT.java
@@ -33,6 +33,7 @@
 import org.elasticsearch.search.sort.SortOrder;
 import org.elasticsearch.search.vectors.KnnVectorQueryBuilder;
 import org.elasticsearch.search.vectors.QueryVectorBuilder;
+import org.elasticsearch.search.vectors.TestQueryVectorBuilderPlugin;
 import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.test.hamcrest.ElasticsearchAssertions;
 import org.elasticsearch.xcontent.XContentBuilder;
@@ -57,7 +58,6 @@
 public class RRFRetrieverBuilderIT extends ESIntegTestCase {
 
     protected static String INDEX = "test_index";
-    protected static final String ID_FIELD = "_id";
     protected static final String DOC_FIELD = "doc";
     protected static final String TEXT_FIELD = "text";
     protected static final String VECTOR_FIELD = "vector";
@@ -743,6 +743,42 @@ public void extractToSearchSourceBuilder(SearchSourceBuilder searchSourceBuilder
         expectThrows(UnsupportedOperationException.class, () -> client().prepareSearch(INDEX).setSource(source).get());
     }
 
+    public void testRRFFiltersPropagatedToKnnQueryVectorBuilder() {
+        final int rankWindowSize = 100;
+        final int rankConstant = 10;
+        SearchSourceBuilder source = new SearchSourceBuilder();
+        // this will retriever all but 7 only due to top-level filter
+        StandardRetrieverBuilder standardRetriever = new StandardRetrieverBuilder(QueryBuilders.matchAllQuery());
+        // this will too retrieve just doc 7
+        KnnRetrieverBuilder knnRetriever = new KnnRetrieverBuilder(
+            "vector",
+            null,
+            new TestQueryVectorBuilderPlugin.TestQueryVectorBuilder(new float[] { 3 }),
+            10,
+            10,
+            null
+        );
+        source.retriever(
+            new RRFRetrieverBuilder(
+                Arrays.asList(
+                    new CompoundRetrieverBuilder.RetrieverSource(standardRetriever, null),
+                    new CompoundRetrieverBuilder.RetrieverSource(knnRetriever, null)
+                ),
+                rankWindowSize,
+                rankConstant
+            )
+        );
+        source.retriever().getPreFilterQueryBuilders().add(QueryBuilders.boolQuery().must(QueryBuilders.termQuery(DOC_FIELD, "doc_7")));
+        source.size(10);
+        SearchRequestBuilder req = client().prepareSearch(INDEX).setSource(source);
+        ElasticsearchAssertions.assertResponse(req, resp -> {
+            assertNull(resp.pointInTimeId());
+            assertNotNull(resp.getHits().getTotalHits());
+            assertThat(resp.getHits().getTotalHits().value(), equalTo(1L));
+            assertThat(resp.getHits().getHits()[0].getId(), equalTo("doc_7"));
+        });
+    }
+
     public void testRewriteOnce() {
         final float[] vector = new float[] { 1 };
         AtomicInteger numAsyncCalls = new AtomicInteger();
diff --git a/x-pack/plugin/rank-rrf/src/main/java/org/elasticsearch/xpack/rank/rrf/RRFFeatures.java b/x-pack/plugin/rank-rrf/src/main/java/org/elasticsearch/xpack/rank/rrf/RRFFeatures.java
index bbc0f622724a3..bb61fa951948d 100644
--- a/x-pack/plugin/rank-rrf/src/main/java/org/elasticsearch/xpack/rank/rrf/RRFFeatures.java
+++ b/x-pack/plugin/rank-rrf/src/main/java/org/elasticsearch/xpack/rank/rrf/RRFFeatures.java
@@ -12,6 +12,7 @@
 
 import java.util.Set;
 
+import static org.elasticsearch.search.retriever.CompoundRetrieverBuilder.INNER_RETRIEVERS_FILTER_SUPPORT;
 import static org.elasticsearch.xpack.rank.rrf.RRFRetrieverBuilder.RRF_RETRIEVER_COMPOSITION_SUPPORTED;
 
 /**
@@ -23,4 +24,9 @@ public class RRFFeatures implements FeatureSpecification {
     public Set<NodeFeature> getFeatures() {
         return Set.of(RRFRetrieverBuilder.RRF_RETRIEVER_SUPPORTED, RRF_RETRIEVER_COMPOSITION_SUPPORTED);
     }
+
+    @Override
+    public Set<NodeFeature> getTestFeatures() {
+        return Set.of(INNER_RETRIEVERS_FILTER_SUPPORT);
+    }
 }
diff --git a/x-pack/plugin/rank-rrf/src/main/java/org/elasticsearch/xpack/rank/rrf/RRFRetrieverBuilder.java b/x-pack/plugin/rank-rrf/src/main/java/org/elasticsearch/xpack/rank/rrf/RRFRetrieverBuilder.java
index 792ff4eac3893..f1171b74f7468 100644
--- a/x-pack/plugin/rank-rrf/src/main/java/org/elasticsearch/xpack/rank/rrf/RRFRetrieverBuilder.java
+++ b/x-pack/plugin/rank-rrf/src/main/java/org/elasticsearch/xpack/rank/rrf/RRFRetrieverBuilder.java
@@ -11,6 +11,7 @@
 import org.elasticsearch.common.ParsingException;
 import org.elasticsearch.common.util.Maps;
 import org.elasticsearch.features.NodeFeature;
+import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.license.LicenseUtils;
 import org.elasticsearch.search.rank.RankBuilder;
 import org.elasticsearch.search.rank.RankDoc;
@@ -108,8 +109,10 @@ public String getName() {
     }
 
     @Override
-    protected RRFRetrieverBuilder clone(List<RetrieverSource> newRetrievers) {
-        return new RRFRetrieverBuilder(newRetrievers, this.rankWindowSize, this.rankConstant);
+    protected RRFRetrieverBuilder clone(List<RetrieverSource> newRetrievers, List<QueryBuilder> newPreFilterQueryBuilders) {
+        RRFRetrieverBuilder clone = new RRFRetrieverBuilder(newRetrievers, this.rankWindowSize, this.rankConstant);
+        clone.preFilterQueryBuilders = newPreFilterQueryBuilders;
+        return clone;
     }
 
     @Override
diff --git a/x-pack/plugin/rank-rrf/src/yamlRestTest/resources/rest-api-spec/test/rrf/700_rrf_retriever_search_api_compatibility.yml b/x-pack/plugin/rank-rrf/src/yamlRestTest/resources/rest-api-spec/test/rrf/700_rrf_retriever_search_api_compatibility.yml
index 42c01f0b9636c..cb30542d80003 100644
--- a/x-pack/plugin/rank-rrf/src/yamlRestTest/resources/rest-api-spec/test/rrf/700_rrf_retriever_search_api_compatibility.yml
+++ b/x-pack/plugin/rank-rrf/src/yamlRestTest/resources/rest-api-spec/test/rrf/700_rrf_retriever_search_api_compatibility.yml
@@ -1071,3 +1071,77 @@ setup:
 
   - match: { hits.hits.2.inner_hits.nested_data_field.hits.total.value: 0 }
   - match: { hits.hits.2.inner_hits.nested_vector_field.hits.total.value: 0 }
+
+
+---
+"rrf retriever with filters to be passed to nested rrf retrievers":
+  - requires:
+      cluster_features: 'inner_retrievers_filter_support'
+      reason: 'requires fix for properly propagating filters to nested sub-retrievers'
+
+  - do:
+      search:
+        _source: false
+        index: test
+        body:
+          retriever:
+            {
+              rrf:
+                {
+                  filter: {
+                    term: {
+                      keyword: "technology"
+                    }
+                  },
+                  retrievers: [
+                    {
+                      rrf: {
+                        retrievers: [
+                          {
+                            # this should only return docs 3 and 5 due to top level filter
+                            standard: {
+                              query: {
+                                knn: {
+                                  field: vector,
+                                  query_vector: [ 4.0 ],
+                                  k: 3
+                                }
+                              }
+                            } },
+                          {
+                            # this should return no docs as no docs match both biology and technology
+                            standard: {
+                              query: {
+                                term: {
+                                  keyword: "biology"
+                                }
+                              }
+                            }
+                          }
+                        ],
+                        rank_window_size: 10,
+                        rank_constant: 10
+                      }
+                    },
+                    # this should only return doc 5
+                    {
+                      standard: {
+                        query: {
+                          term: {
+                            text: "term5"
+                          }
+                        }
+                      }
+                    }
+                  ],
+                  rank_window_size: 10,
+                  rank_constant: 10
+                }
+            }
+          size: 10
+
+  - match: { hits.total.value: 2 }
+  - match: { hits.hits.0._id: "5" }
+  - match: { hits.hits.1._id: "3" }
+
+

From 6087badce32fbcd095d115d4aaa69b62bd967a26 Mon Sep 17 00:00:00 2001
From: Ievgen Degtiarenko <ievgen.degtiarenko@elastic.co>
Date: Thu, 5 Dec 2024 08:21:39 +0100
Subject: [PATCH 037/119] cleanups (#117997)

---
 .../core/planner/ExpressionTranslators.java   |  4 +-
 .../xpack/esql/core/util/CollectionUtils.java | 15 +-----
 .../xpack/ql/type/DataTypes.java              | 50 ++++++-------------
 3 files changed, 18 insertions(+), 51 deletions(-)

diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/planner/ExpressionTranslators.java b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/planner/ExpressionTranslators.java
index 7836522c77130..468d076c1b7ef 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/planner/ExpressionTranslators.java
+++ b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/planner/ExpressionTranslators.java
@@ -107,9 +107,7 @@ protected Query asQuery(Not not, TranslatorHandler handler) {
         }
 
         public static Query doTranslate(Not not, TranslatorHandler handler) {
-            Query wrappedQuery = handler.asQuery(not.field());
-            Query q = wrappedQuery.negate(not.source());
-            return q;
+            return handler.asQuery(not.field()).negate(not.source());
         }
     }
 
diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/util/CollectionUtils.java b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/util/CollectionUtils.java
index 8bfcf4ca5c405..ce0540687121f 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/util/CollectionUtils.java
+++ b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/util/CollectionUtils.java
@@ -30,12 +30,8 @@ public static <T> List<T> combine(List<? extends T> left, List<? extends T> righ
         }
 
         List<T> list = new ArrayList<>(left.size() + right.size());
-        if (left.isEmpty() == false) {
-            list.addAll(left);
-        }
-        if (right.isEmpty() == false) {
-            list.addAll(right);
-        }
+        list.addAll(left);
+        list.addAll(right);
         return list;
     }
 
@@ -73,13 +69,6 @@ public static <T> List<T> combine(Collection<? extends T> left, T... entries) {
         return list;
     }
 
-    public static int mapSize(int size) {
-        if (size < 2) {
-            return size + 1;
-        }
-        return (int) (size / 0.75f + 1f);
-    }
-
     @SafeVarargs
     @SuppressWarnings("varargs")
     public static <T> List<T> nullSafeList(T... entries) {
diff --git a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DataTypes.java b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DataTypes.java
index 6aa47f7c817a7..c67d943b11e22 100644
--- a/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DataTypes.java
+++ b/x-pack/plugin/ql/src/main/java/org/elasticsearch/xpack/ql/type/DataTypes.java
@@ -112,41 +112,21 @@ public static DataType fromEs(String name) {
     }
 
     public static DataType fromJava(Object value) {
-        if (value == null) {
-            return NULL;
-        }
-        if (value instanceof Integer) {
-            return INTEGER;
-        }
-        if (value instanceof Long) {
-            return LONG;
-        }
-        if (value instanceof BigInteger) {
-            return UNSIGNED_LONG;
-        }
-        if (value instanceof Boolean) {
-            return BOOLEAN;
-        }
-        if (value instanceof Double) {
-            return DOUBLE;
-        }
-        if (value instanceof Float) {
-            return FLOAT;
-        }
-        if (value instanceof Byte) {
-            return BYTE;
-        }
-        if (value instanceof Short) {
-            return SHORT;
-        }
-        if (value instanceof ZonedDateTime) {
-            return DATETIME;
-        }
-        if (value instanceof String || value instanceof Character) {
-            return KEYWORD;
-        }
-
-        return null;
+        return switch (value) {
+            case null -> NULL;
+            case Integer i -> INTEGER;
+            case Long l -> LONG;
+            case BigInteger bigInteger -> UNSIGNED_LONG;
+            case Boolean b -> BOOLEAN;
+            case Double v -> DOUBLE;
+            case Float v -> FLOAT;
+            case Byte b -> BYTE;
+            case Short s -> SHORT;
+            case ZonedDateTime zonedDateTime -> DATETIME;
+            case String s -> KEYWORD;
+            case Character c -> KEYWORD;
+            default -> null;
+        };
     }
 
     public static boolean isUnsupported(DataType from) {

From 2051401d5049aaa6308838920230514698321b38 Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Thu, 5 Dec 2024 09:05:32 +0100
Subject: [PATCH 038/119] Address mapping and compute engine runtime field
 issues (#117792)

This change addresses the following issues:

Fields mapped as runtime fields not getting stored if source mode is synthetic.
Address java.io.EOFException when an es|ql query uses multiple runtime fields that fallback to source when source mode is synthetic. (1)
Address concurrency issue when runtime fields get pushed down to Lucene. (2)
1: ValueSourceOperator can read values in row striding or columnar fashion. When values are read in columnar fashion and multiple runtime fields synthetize source then this can cause the same SourceProvider evaluation the same range of docs ids multiple times. This can then result in unexpected io errors at the codec level. This is because the same doc value instances are used by SourceProvider. Re-evaluating the same docids is in violation of the contract of the DocIdSetIterator#advance(...) / DocIdSetIterator#advanceExact(...) methods, which documents that unexpected behaviour can occur if target docid is lower than current docid position.

Note that this is only an issue for synthetic source loader and not for stored source loader. And not when executing in row stride fashion which sometimes happen in compute engine and always happen in _search api.

2: The concurrency issue that arrises with source provider if source operator executes in parallel with data portioning set to DOC. The same SourceProvider instance then gets access by multiple threads concurrently. SourceProviders implementations are not designed to handle concurrent access.

Closes #117644
---
 docs/changelog/117792.yaml                    |   6 +
 .../index/mapper/DocumentParser.java          |   4 +-
 .../index/query/SearchExecutionContext.java   |  10 +-
 .../search/lookup/SearchLookup.java           |  12 ++
 .../xpack/esql/action/EsqlActionIT.java       |  39 ++++++
 .../planner/EsPhysicalOperationProviders.java |  12 +-
 .../xpack/esql/plugin/ComputeService.java     |  17 ++-
 .../plugin/ReinitializingSourceProvider.java  |  43 +++++++
 .../xpack/logsdb/LogsdbRestIT.java            | 117 ++++++++++++++++++
 9 files changed, 250 insertions(+), 10 deletions(-)
 create mode 100644 docs/changelog/117792.yaml
 create mode 100644 x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ReinitializingSourceProvider.java

diff --git a/docs/changelog/117792.yaml b/docs/changelog/117792.yaml
new file mode 100644
index 0000000000000..2d7ddda1ace40
--- /dev/null
+++ b/docs/changelog/117792.yaml
@@ -0,0 +1,6 @@
+pr: 117792
+summary: Address mapping and compute engine runtime field issues
+area: Mapping
+type: bug
+issues:
+ - 117644
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/DocumentParser.java b/server/src/main/java/org/elasticsearch/index/mapper/DocumentParser.java
index e00e7b2320000..9ddb6f0d496a0 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/DocumentParser.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/DocumentParser.java
@@ -946,7 +946,9 @@ public Query termQuery(Object value, SearchExecutionContext context) {
             protected void parseCreateField(DocumentParserContext context) {
                 // Run-time fields are mapped to this mapper, so it needs to handle storing values for use in synthetic source.
                 // #parseValue calls this method once the run-time field is created.
-                if (context.dynamic() == ObjectMapper.Dynamic.RUNTIME && context.canAddIgnoredField()) {
+                var fieldType = context.mappingLookup().getFieldType(path);
+                boolean isRuntimeField = fieldType instanceof AbstractScriptFieldType;
+                if ((context.dynamic() == ObjectMapper.Dynamic.RUNTIME || isRuntimeField) && context.canAddIgnoredField()) {
                     try {
                         context.addIgnoredField(
                             IgnoredSourceFieldMapper.NameValue.fromContext(context, path, context.encodeFlattenedToken())
diff --git a/server/src/main/java/org/elasticsearch/index/query/SearchExecutionContext.java b/server/src/main/java/org/elasticsearch/index/query/SearchExecutionContext.java
index b07112440d3c2..d5e48a6a54daa 100644
--- a/server/src/main/java/org/elasticsearch/index/query/SearchExecutionContext.java
+++ b/server/src/main/java/org/elasticsearch/index/query/SearchExecutionContext.java
@@ -493,14 +493,18 @@ public boolean containsBrokenAnalysis(String field) {
      */
     public SearchLookup lookup() {
         if (this.lookup == null) {
-            SourceProvider sourceProvider = isSourceSynthetic()
-                ? SourceProvider.fromSyntheticSource(mappingLookup.getMapping(), mapperMetrics.sourceFieldMetrics())
-                : SourceProvider.fromStoredFields();
+            var sourceProvider = createSourceProvider();
             setLookupProviders(sourceProvider, LeafFieldLookupProvider.fromStoredFields());
         }
         return this.lookup;
     }
 
+    public SourceProvider createSourceProvider() {
+        return isSourceSynthetic()
+            ? SourceProvider.fromSyntheticSource(mappingLookup.getMapping(), mapperMetrics.sourceFieldMetrics())
+            : SourceProvider.fromStoredFields();
+    }
+
     /**
      * Replace the standard source provider and field lookup provider on the SearchLookup
      *
diff --git a/server/src/main/java/org/elasticsearch/search/lookup/SearchLookup.java b/server/src/main/java/org/elasticsearch/search/lookup/SearchLookup.java
index f7f8cee30ee15..9eb0170af5efb 100644
--- a/server/src/main/java/org/elasticsearch/search/lookup/SearchLookup.java
+++ b/server/src/main/java/org/elasticsearch/search/lookup/SearchLookup.java
@@ -102,6 +102,14 @@ private SearchLookup(SearchLookup searchLookup, Set<String> fieldChain) {
         this.fieldLookupProvider = searchLookup.fieldLookupProvider;
     }
 
+    private SearchLookup(SearchLookup searchLookup, SourceProvider sourceProvider, Set<String> fieldChain) {
+        this.fieldChain = Collections.unmodifiableSet(fieldChain);
+        this.sourceProvider = sourceProvider;
+        this.fieldTypeLookup = searchLookup.fieldTypeLookup;
+        this.fieldDataLookup = searchLookup.fieldDataLookup;
+        this.fieldLookupProvider = searchLookup.fieldLookupProvider;
+    }
+
     /**
      * Creates a copy of the current {@link SearchLookup} that looks fields up in the same way, but also tracks field references
      * in order to detect cycles and prevent resolving fields that depend on more than {@link #MAX_FIELD_CHAIN_DEPTH} other fields.
@@ -144,4 +152,8 @@ public IndexFieldData<?> getForField(MappedFieldType fieldType, MappedFieldType.
     public Source getSource(LeafReaderContext ctx, int doc) throws IOException {
         return sourceProvider.getSource(ctx, doc);
     }
+
+    public SearchLookup swapSourceProvider(SourceProvider sourceProvider) {
+        return new SearchLookup(this, sourceProvider, fieldChain);
+    }
 }
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EsqlActionIT.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EsqlActionIT.java
index 147b13b36c44b..00f53d31165b1 100644
--- a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EsqlActionIT.java
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EsqlActionIT.java
@@ -18,6 +18,7 @@
 import org.elasticsearch.client.internal.ClusterAdminClient;
 import org.elasticsearch.cluster.metadata.IndexMetadata;
 import org.elasticsearch.cluster.node.DiscoveryNode;
+import org.elasticsearch.common.collect.Iterators;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.index.Index;
@@ -1648,6 +1649,44 @@ public void testMaxTruncationSizeSetting() {
         }
     }
 
+    public void testScriptField() throws Exception {
+        XContentBuilder mapping = JsonXContent.contentBuilder();
+        mapping.startObject();
+        {
+            mapping.startObject("runtime");
+            {
+                mapping.startObject("k1");
+                mapping.field("type", "long");
+                mapping.endObject();
+                mapping.startObject("k2");
+                mapping.field("type", "long");
+                mapping.endObject();
+            }
+            mapping.endObject();
+            {
+                mapping.startObject("properties");
+                mapping.startObject("meter").field("type", "double").endObject();
+                mapping.endObject();
+            }
+        }
+        mapping.endObject();
+        String sourceMode = randomBoolean() ? "stored" : "synthetic";
+        Settings.Builder settings = indexSettings(1, 0).put(indexSettings()).put("index.mapping.source.mode", sourceMode);
+        client().admin().indices().prepareCreate("test-script").setMapping(mapping).setSettings(settings).get();
+        for (int i = 0; i < 10; i++) {
+            index("test-script", Integer.toString(i), Map.of("k1", i, "k2", "b-" + i, "meter", 10000 * i));
+        }
+        refresh("test-script");
+        try (EsqlQueryResponse resp = run("FROM test-script | SORT k1 |  LIMIT 10")) {
+            List<Object> k1Column = Iterators.toList(resp.column(0));
+            assertThat(k1Column, contains(0L, 1L, 2L, 3L, 4L, 5L, 6L, 7L, 8L, 9L));
+            List<Object> k2Column = Iterators.toList(resp.column(1));
+            assertThat(k2Column, contains(null, null, null, null, null, null, null, null, null, null));
+            List<Object> meterColumn = Iterators.toList(resp.column(2));
+            assertThat(meterColumn, contains(0.0, 10000.0, 20000.0, 30000.0, 40000.0, 50000.0, 60000.0, 70000.0, 80000.0, 90000.0));
+        }
+    }
+
     private void clearPersistentSettings(Setting<?>... settings) {
         Settings.Builder clearedSettings = Settings.builder();
 
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsPhysicalOperationProviders.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsPhysicalOperationProviders.java
index 7bf7d0e2d08eb..39e2a3bc1d5af 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsPhysicalOperationProviders.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsPhysicalOperationProviders.java
@@ -39,6 +39,7 @@
 import org.elasticsearch.index.mapper.FieldNamesFieldMapper;
 import org.elasticsearch.index.mapper.MappedFieldType;
 import org.elasticsearch.index.mapper.NestedLookup;
+import org.elasticsearch.index.mapper.SourceFieldMapper;
 import org.elasticsearch.index.mapper.SourceLoader;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.index.query.QueryBuilders;
@@ -348,7 +349,16 @@ public MappedFieldType.FieldExtractPreference fieldExtractPreference() {
 
                 @Override
                 public SearchLookup lookup() {
-                    return ctx.lookup();
+                    boolean syntheticSource = SourceFieldMapper.isSynthetic(indexSettings());
+                    var searchLookup = ctx.lookup();
+                    if (syntheticSource) {
+                        // in the context of scripts and when synthetic source is used the search lookup can't always be reused between
+                        // users of SearchLookup. This is only an issue when scripts fallback to _source, but since we can't always
+                        // accurately determine whether a script uses _source, we should do this for all script usages.
+                        // This lookup() method is only invoked for scripts / runtime fields, so it is ok to do here.
+                        searchLookup = searchLookup.swapSourceProvider(ctx.createSourceProvider());
+                    }
+                    return searchLookup;
                 }
 
                 @Override
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeService.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeService.java
index c9c8635a60f57..ed037d24139f8 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeService.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeService.java
@@ -45,6 +45,7 @@
 import org.elasticsearch.search.internal.AliasFilter;
 import org.elasticsearch.search.internal.SearchContext;
 import org.elasticsearch.search.internal.ShardSearchRequest;
+import org.elasticsearch.search.lookup.SourceProvider;
 import org.elasticsearch.tasks.CancellableTask;
 import org.elasticsearch.tasks.Task;
 import org.elasticsearch.tasks.TaskCancelledException;
@@ -87,6 +88,7 @@
 import java.util.concurrent.Executor;
 import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.concurrent.atomic.AtomicLong;
+import java.util.function.Supplier;
 
 import static org.elasticsearch.xpack.esql.plugin.EsqlPlugin.ESQL_WORKER_THREAD_POOL_NAME;
 
@@ -471,12 +473,17 @@ void runCompute(CancellableTask task, ComputeContext context, PhysicalPlan plan,
         List<EsPhysicalOperationProviders.ShardContext> contexts = new ArrayList<>(context.searchContexts.size());
         for (int i = 0; i < context.searchContexts.size(); i++) {
             SearchContext searchContext = context.searchContexts.get(i);
+            var searchExecutionContext = new SearchExecutionContext(searchContext.getSearchExecutionContext()) {
+
+                @Override
+                public SourceProvider createSourceProvider() {
+                    final Supplier<SourceProvider> supplier = () -> super.createSourceProvider();
+                    return new ReinitializingSourceProvider(supplier);
+
+                }
+            };
             contexts.add(
-                new EsPhysicalOperationProviders.DefaultShardContext(
-                    i,
-                    searchContext.getSearchExecutionContext(),
-                    searchContext.request().getAliasFilter()
-                )
+                new EsPhysicalOperationProviders.DefaultShardContext(i, searchExecutionContext, searchContext.request().getAliasFilter())
             );
         }
         final List<Driver> drivers;
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ReinitializingSourceProvider.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ReinitializingSourceProvider.java
new file mode 100644
index 0000000000000..b6b2c6dfec755
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ReinitializingSourceProvider.java
@@ -0,0 +1,43 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.plugin;
+
+import org.apache.lucene.index.LeafReaderContext;
+import org.elasticsearch.search.lookup.Source;
+import org.elasticsearch.search.lookup.SourceProvider;
+
+import java.io.IOException;
+import java.util.function.Supplier;
+
+/**
+ * This is a workaround for when compute engine executes concurrently with data partitioning by docid.
+ */
+final class ReinitializingSourceProvider implements SourceProvider {
+
+    private PerThreadSourceProvider perThreadProvider;
+    private final Supplier<SourceProvider> sourceProviderFactory;
+
+    ReinitializingSourceProvider(Supplier<SourceProvider> sourceProviderFactory) {
+        this.sourceProviderFactory = sourceProviderFactory;
+    }
+
+    @Override
+    public Source getSource(LeafReaderContext ctx, int doc) throws IOException {
+        var currentThread = Thread.currentThread();
+        PerThreadSourceProvider provider = perThreadProvider;
+        if (provider == null || provider.creatingThread != currentThread) {
+            provider = new PerThreadSourceProvider(sourceProviderFactory.get(), currentThread);
+            this.perThreadProvider = provider;
+        }
+        return perThreadProvider.source.getSource(ctx, doc);
+    }
+
+    private record PerThreadSourceProvider(SourceProvider source, Thread creatingThread) {
+
+    }
+}
diff --git a/x-pack/plugin/logsdb/src/javaRestTest/java/org/elasticsearch/xpack/logsdb/LogsdbRestIT.java b/x-pack/plugin/logsdb/src/javaRestTest/java/org/elasticsearch/xpack/logsdb/LogsdbRestIT.java
index 2bf8b00cf551c..ef9480681f559 100644
--- a/x-pack/plugin/logsdb/src/javaRestTest/java/org/elasticsearch/xpack/logsdb/LogsdbRestIT.java
+++ b/x-pack/plugin/logsdb/src/javaRestTest/java/org/elasticsearch/xpack/logsdb/LogsdbRestIT.java
@@ -10,6 +10,8 @@
 import org.elasticsearch.client.Request;
 import org.elasticsearch.cluster.metadata.DataStream;
 import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.time.DateFormatter;
+import org.elasticsearch.common.time.FormatNames;
 import org.elasticsearch.test.cluster.ElasticsearchCluster;
 import org.elasticsearch.test.cluster.local.distribution.DistributionType;
 import org.elasticsearch.test.rest.ESRestTestCase;
@@ -17,6 +19,7 @@
 import org.junit.ClassRule;
 
 import java.io.IOException;
+import java.time.Instant;
 import java.util.List;
 import java.util.Map;
 
@@ -108,4 +111,118 @@ public void testLogsdbSourceModeForLogsIndex() throws IOException {
         assertNull(settings.get("index.mapping.source.mode"));
     }
 
+    public void testEsqlRuntimeFields() throws IOException {
+        String mappings = """
+            {
+                "runtime": {
+                    "message_length": {
+                        "type": "long"
+                    },
+                    "log.offset": {
+                        "type": "long"
+                    }
+                },
+                "dynamic": false,
+                "properties": {
+                    "@timestamp": {
+                        "type": "date"
+                    },
+                    "log" : {
+                        "properties": {
+                            "level": {
+                                "type": "keyword"
+                            },
+                            "file": {
+                                "type": "keyword"
+                            }
+                        }
+                    }
+                }
+            }
+            """;
+        String indexName = "test-foo";
+        createIndex(indexName, Settings.builder().put("index.mode", "logsdb").build(), mappings);
+
+        int numDocs = 500;
+        var sb = new StringBuilder();
+        var now = Instant.now();
+
+        var expectedMinTimestamp = now;
+        for (int i = 0; i < numDocs; i++) {
+            String level = randomBoolean() ? "info" : randomBoolean() ? "warning" : randomBoolean() ? "error" : "fatal";
+            String msg = randomAlphaOfLength(20);
+            String path = randomAlphaOfLength(8);
+            String messageLength = Integer.toString(msg.length());
+            String offset = Integer.toString(randomNonNegativeInt());
+            sb.append("{ \"create\": {} }").append('\n');
+            if (randomBoolean()) {
+                sb.append(
+                    """
+                        {"@timestamp":"$now","message":"$msg","message_length":$l,"file":{"level":"$level","offset":5,"file":"$path"}}
+                        """.replace("$now", formatInstant(now))
+                        .replace("$level", level)
+                        .replace("$msg", msg)
+                        .replace("$path", path)
+                        .replace("$l", messageLength)
+                        .replace("$o", offset)
+                );
+            } else {
+                sb.append("""
+                    {"@timestamp": "$now", "message": "$msg", "message_length": $l}
+                    """.replace("$now", formatInstant(now)).replace("$msg", msg).replace("$l", messageLength));
+            }
+            sb.append('\n');
+            if (i != numDocs - 1) {
+                now = now.plusSeconds(1);
+            }
+        }
+        var expectedMaxTimestamp = now;
+
+        var bulkRequest = new Request("POST", "/" + indexName + "/_bulk");
+        bulkRequest.setJsonEntity(sb.toString());
+        bulkRequest.addParameter("refresh", "true");
+        var bulkResponse = client().performRequest(bulkRequest);
+        var bulkResponseBody = responseAsMap(bulkResponse);
+        assertThat(bulkResponseBody, Matchers.hasEntry("errors", false));
+
+        var forceMergeRequest = new Request("POST", "/" + indexName + "/_forcemerge");
+        forceMergeRequest.addParameter("max_num_segments", "1");
+        var forceMergeResponse = client().performRequest(forceMergeRequest);
+        assertOK(forceMergeResponse);
+
+        String query = "FROM test-foo | STATS count(*), min(@timestamp), max(@timestamp), min(message_length), max(message_length)"
+            + " ,sum(message_length), avg(message_length), min(log.offset), max(log.offset) | LIMIT 1";
+        final Request esqlRequest = new Request("POST", "/_query");
+        esqlRequest.setJsonEntity("""
+            {
+                "query": "$query"
+            }
+            """.replace("$query", query));
+        var esqlResponse = client().performRequest(esqlRequest);
+        assertOK(esqlResponse);
+        Map<String, Object> esqlResponseBody = responseAsMap(esqlResponse);
+
+        List<?> values = (List<?>) esqlResponseBody.get("values");
+        assertThat(values, Matchers.not(Matchers.empty()));
+        var count = ((List<?>) values.getFirst()).get(0);
+        assertThat(count, equalTo(numDocs));
+        logger.warn("VALUES: {}", values);
+
+        var minTimestamp = ((List<?>) values.getFirst()).get(1);
+        assertThat(minTimestamp, equalTo(formatInstant(expectedMinTimestamp)));
+        var maxTimestamp = ((List<?>) values.getFirst()).get(2);
+        assertThat(maxTimestamp, equalTo(formatInstant(expectedMaxTimestamp)));
+
+        var minLength = ((List<?>) values.getFirst()).get(3);
+        assertThat(minLength, equalTo(20));
+        var maxLength = ((List<?>) values.getFirst()).get(4);
+        assertThat(maxLength, equalTo(20));
+        var sumLength = ((List<?>) values.getFirst()).get(5);
+        assertThat(sumLength, equalTo(20 * numDocs));
+    }
+
+    static String formatInstant(Instant instant) {
+        return DateFormatter.forPattern(FormatNames.STRICT_DATE_OPTIONAL_TIME.getName()).format(instant);
+    }
+
 }

From 6fe8894adce71905cea578d41d652cb88ec3c6e8 Mon Sep 17 00:00:00 2001
From: Simon Cooper <simon.cooper@elastic.co>
Date: Thu, 5 Dec 2024 08:59:48 +0000
Subject: [PATCH 039/119] Collapse transport versions for 8.16 (#117991)

---
 .../geoip/EnterpriseGeoIpTaskState.java       |  2 +-
 .../ingest/geoip/GeoIpTaskState.java          |  2 +-
 .../ingest/geoip/IngestGeoIpMetadata.java     |  4 +-
 .../geoip/direct/DatabaseConfiguration.java   |  4 +-
 .../elasticsearch/ElasticsearchException.java |  4 +-
 .../org/elasticsearch/TransportVersions.java  | 73 +------------------
 .../TransportGetAllocationStatsAction.java    |  4 +-
 .../stats/NodesStatsRequestParameters.java    |  4 +-
 .../create/CreateSnapshotRequest.java         |  4 +-
 .../stats/ClusterStatsNodeResponse.java       | 13 +---
 .../stats/RemoteClusterStatsRequest.java      |  4 +-
 .../admin/cluster/stats/SearchUsageStats.java |  6 +-
 .../stats/TransportClusterStatsAction.java    |  5 +-
 .../get/GetComponentTemplateAction.java       |  6 +-
 .../get/GetComposableIndexTemplateAction.java |  6 +-
 .../post/SimulateIndexTemplateResponse.java   |  6 +-
 .../action/bulk/BulkItemResponse.java         |  4 +-
 .../action/bulk/BulkRequest.java              |  4 +-
 .../action/bulk/BulkResponse.java             |  4 +-
 .../bulk/IndexDocFailureStoreStatus.java      |  4 +-
 .../action/bulk/SimulateBulkRequest.java      | 11 +--
 .../datastreams/GetDataStreamAction.java      |  8 +-
 .../FieldCapabilitiesIndexResponse.java       |  8 +-
 .../action/index/IndexRequest.java            |  8 +-
 .../action/index/IndexResponse.java           |  8 +-
 .../action/search/OpenPointInTimeRequest.java |  4 +-
 .../search/OpenPointInTimeResponse.java       |  2 +-
 .../action/search/SearchContextId.java        |  6 +-
 .../action/search/SearchContextIdForNode.java |  8 +-
 .../TransportOpenPointInTimeAction.java       |  3 +-
 .../action/support/IndicesOptions.java        | 10 +--
 .../cluster/health/ClusterIndexHealth.java    |  4 +-
 .../cluster/health/ClusterShardHealth.java    |  4 +-
 .../cluster/health/ClusterStateHealth.java    |  4 +-
 .../cluster/metadata/DataStream.java          | 11 ++-
 .../metadata/InferenceFieldMetadata.java      |  7 +-
 .../cluster/routing/RoutingTable.java         |  8 +-
 .../common/io/stream/StreamInput.java         |  7 +-
 .../common/io/stream/StreamOutput.java        |  9 +--
 .../index/engine/CommitStats.java             |  4 +-
 .../index/mapper/NodeMappingStats.java        |  4 +-
 .../index/query/IntervalsSourceProvider.java  |  4 +-
 .../index/query/RankDocsQueryBuilder.java     |  8 +-
 .../index/search/stats/SearchStats.java       |  4 +-
 .../inference/EmptySecretSettings.java        |  2 +-
 .../inference/ModelConfigurations.java        |  4 +-
 .../ingest/EnterpriseGeoIpTask.java           |  2 +-
 .../elasticsearch/search/DocValueFormat.java  |  4 +-
 .../elasticsearch/search/rank/RankDoc.java    |  2 +-
 .../search/vectors/ExactKnnQueryBuilder.java  |  6 +-
 .../vectors/KnnScoreDocQueryBuilder.java      |  6 +-
 .../snapshots/RegisteredPolicySnapshots.java  |  4 +-
 .../elasticsearch/TransportVersionTests.java  |  2 +-
 .../NodesStatsRequestParametersTests.java     |  2 +-
 .../cluster/stats/SearchUsageStatsTests.java  |  2 +-
 .../common/io/stream/AbstractStreamTests.java | 15 ++--
 .../DataStreamLifecycleFeatureSetUsage.java   |  4 +-
 .../core/enrich/action/EnrichStatsAction.java |  4 +-
 .../ilm/IndexLifecycleExplainResponse.java    |  4 +-
 .../core/ilm/SearchableSnapshotAction.java    |  8 +-
 .../action/DeleteInferenceEndpointAction.java |  4 +-
 .../action/GetInferenceModelAction.java       |  4 +-
 .../ml/MachineLearningFeatureSetUsage.java    |  4 +-
 .../CreateTrainedModelAssignmentAction.java   |  4 +-
 .../StartTrainedModelDeploymentAction.java    |  8 +-
 .../UpdateTrainedModelDeploymentAction.java   |  4 +-
 .../core/ml/calendars/ScheduledEvent.java     |  4 +-
 .../inference/assignment/AssignmentStats.java |  4 +-
 .../assignment/TrainedModelAssignment.java    |  4 +-
 .../trainedmodel/LearningToRankConfig.java    |  3 +-
 .../core/ml/job/config/DetectionRule.java     |  4 +-
 .../ConfigurableClusterPrivileges.java        |  2 +-
 .../MachineLearningFeatureSetUsageTests.java  |  2 +-
 .../rules/QueryRulesetListItem.java           |  6 +-
 ...setsActionResponseBWCSerializingTests.java |  3 +-
 ...lesetActionRequestBWCSerializingTests.java |  2 +-
 ...esetActionResponseBWCSerializingTests.java |  2 +-
 .../xpack/esql/core/type/EsField.java         |  2 +-
 .../xpack/esql/core/util/PlanStreamInput.java |  2 +-
 .../esql/core/util/PlanStreamOutput.java      |  2 +-
 .../compute/operator/AggregationOperator.java |  4 +-
 .../compute/operator/DriverProfile.java       |  4 +-
 .../compute/operator/DriverSleeps.java        |  4 +-
 .../xpack/esql/action/EsqlExecutionInfo.java  |  4 +-
 .../xpack/esql/action/EsqlQueryResponse.java  |  4 +-
 .../esql/action/EsqlResolveFieldsAction.java  |  2 +-
 .../esql/enrich/ResolvedEnrichPolicy.java     |  6 +-
 .../function/UnsupportedAttribute.java        |  6 +-
 .../function/aggregate/AggregateFunction.java |  8 +-
 .../function/aggregate/CountDistinct.java     |  6 +-
 .../function/aggregate/FromPartial.java       |  6 +-
 .../function/aggregate/Percentile.java        |  6 +-
 .../expression/function/aggregate/Rate.java   |  6 +-
 .../function/aggregate/ToPartial.java         |  6 +-
 .../expression/function/aggregate/Top.java    |  6 +-
 .../function/aggregate/WeightedAvg.java       |  6 +-
 .../xpack/esql/index/EsIndex.java             |  4 +-
 .../xpack/esql/io/stream/PlanStreamInput.java |  6 +-
 .../esql/io/stream/PlanStreamOutput.java      |  6 +-
 .../esql/plan/physical/AggregateExec.java     |  2 +-
 .../xpack/esql/plugin/ComputeResponse.java    |  4 +-
 .../xpack/esql/plugin/DataNodeRequest.java    |  4 +-
 .../xpack/esql/plugin/RemoteClusterPlan.java  |  4 +-
 .../esql/querydsl/query/SingleValueQuery.java |  4 +-
 .../xpack/esql/session/Configuration.java     |  4 +-
 .../esql/plugin/ClusterRequestTests.java      |  6 +-
 .../SentenceBoundaryChunkingSettings.java     |  6 +-
 .../WordBoundaryChunkingSettings.java         |  2 +-
 .../rank/random/RandomRankBuilder.java        |  2 +-
 .../textsimilarity/TextSimilarityRankDoc.java |  2 +-
 .../AlibabaCloudSearchService.java            |  2 +-
 .../AlibabaCloudSearchServiceSettings.java    |  2 +-
 ...aCloudSearchCompletionServiceSettings.java |  2 +-
 ...babaCloudSearchCompletionTaskSettings.java |  2 +-
 ...aCloudSearchEmbeddingsServiceSettings.java |  2 +-
 ...babaCloudSearchEmbeddingsTaskSettings.java |  2 +-
 ...ibabaCloudSearchRerankServiceSettings.java |  2 +-
 .../AlibabaCloudSearchRerankTaskSettings.java |  2 +-
 ...ibabaCloudSearchSparseServiceSettings.java |  2 +-
 .../AlibabaCloudSearchSparseTaskSettings.java |  2 +-
 .../rerank/CohereRerankServiceSettings.java   |  4 +-
 .../elastic/ElasticInferenceService.java      |  2 +-
 ...erviceSparseEmbeddingsServiceSettings.java |  2 +-
 .../ElasticsearchInternalServiceSettings.java | 14 ++--
 .../ibmwatsonx/IbmWatsonxService.java         |  2 +-
 .../IbmWatsonxEmbeddingsServiceSettings.java  |  2 +-
 .../ltr/LearningToRankRescorerBuilder.java    |  2 +-
 .../xpack/rank/rrf/RRFRankDoc.java            |  6 +-
 .../xpack/security/authc/ApiKeyService.java   |  8 +-
 .../authz/store/NativeRolesStore.java         |  4 +-
 .../RolesBackwardsCompatibilityIT.java        | 10 +--
 131 files changed, 260 insertions(+), 414 deletions(-)

diff --git a/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/EnterpriseGeoIpTaskState.java b/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/EnterpriseGeoIpTaskState.java
index c4d0aef0183ed..c128af69009be 100644
--- a/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/EnterpriseGeoIpTaskState.java
+++ b/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/EnterpriseGeoIpTaskState.java
@@ -123,7 +123,7 @@ public String getWriteableName() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ENTERPRISE_GEOIP_DOWNLOADER;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/GeoIpTaskState.java b/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/GeoIpTaskState.java
index 47ca79e3cb3b9..96525d427d3e8 100644
--- a/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/GeoIpTaskState.java
+++ b/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/GeoIpTaskState.java
@@ -44,7 +44,7 @@
 public class GeoIpTaskState implements PersistentTaskState, VersionedNamedWriteable {
 
     private static boolean includeSha256(TransportVersion version) {
-        return version.isPatchFrom(TransportVersions.V_8_15_0) || version.onOrAfter(TransportVersions.ENTERPRISE_GEOIP_DOWNLOADER);
+        return version.onOrAfter(TransportVersions.V_8_15_0);
     }
 
     private static final ParseField DATABASES = new ParseField("databases");
diff --git a/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/IngestGeoIpMetadata.java b/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/IngestGeoIpMetadata.java
index b6e73f3f33f7c..a50fe7dee9008 100644
--- a/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/IngestGeoIpMetadata.java
+++ b/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/IngestGeoIpMetadata.java
@@ -69,7 +69,7 @@ public String getWriteableName() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ENTERPRISE_GEOIP_DOWNLOADER;
+        return TransportVersions.V_8_16_0;
     }
 
     public Map<String, DatabaseConfigurationMetadata> getDatabases() {
@@ -138,7 +138,7 @@ public String getWriteableName() {
 
         @Override
         public TransportVersion getMinimalSupportedVersion() {
-            return TransportVersions.ENTERPRISE_GEOIP_DOWNLOADER;
+            return TransportVersions.V_8_16_0;
         }
     }
 
diff --git a/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/direct/DatabaseConfiguration.java b/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/direct/DatabaseConfiguration.java
index a26364f9305e1..aa48c73cf1d73 100644
--- a/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/direct/DatabaseConfiguration.java
+++ b/modules/ingest-geoip/src/main/java/org/elasticsearch/ingest/geoip/direct/DatabaseConfiguration.java
@@ -138,7 +138,7 @@ public DatabaseConfiguration(StreamInput in) throws IOException {
     }
 
     private static Provider readProvider(StreamInput in) throws IOException {
-        if (in.getTransportVersion().onOrAfter(TransportVersions.INGEST_GEO_DATABASE_PROVIDERS)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             return in.readNamedWriteable(Provider.class);
         } else {
             // prior to the above version, everything was always a maxmind, so this half of the if is logical
@@ -154,7 +154,7 @@ public static DatabaseConfiguration parse(XContentParser parser, String id) {
     public void writeTo(StreamOutput out) throws IOException {
         out.writeString(id);
         out.writeString(name);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.INGEST_GEO_DATABASE_PROVIDERS)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeNamedWriteable(provider);
         } else {
             if (provider instanceof Maxmind maxmind) {
diff --git a/server/src/main/java/org/elasticsearch/ElasticsearchException.java b/server/src/main/java/org/elasticsearch/ElasticsearchException.java
index 3c5c365654206..fcb5c20c28162 100644
--- a/server/src/main/java/org/elasticsearch/ElasticsearchException.java
+++ b/server/src/main/java/org/elasticsearch/ElasticsearchException.java
@@ -1947,13 +1947,13 @@ private enum ElasticsearchExceptionHandle {
             org.elasticsearch.ingest.IngestPipelineException.class,
             org.elasticsearch.ingest.IngestPipelineException::new,
             182,
-            TransportVersions.INGEST_PIPELINE_EXCEPTION_ADDED
+            TransportVersions.V_8_16_0
         ),
         INDEX_RESPONSE_WRAPPER_EXCEPTION(
             IndexDocFailureStoreStatus.ExceptionWithFailureStoreStatus.class,
             IndexDocFailureStoreStatus.ExceptionWithFailureStoreStatus::new,
             183,
-            TransportVersions.FAILURE_STORE_STATUS_IN_INDEX_RESPONSE
+            TransportVersions.V_8_16_0
         );
 
         final Class<? extends ElasticsearchException> exceptionClass;
diff --git a/server/src/main/java/org/elasticsearch/TransportVersions.java b/server/src/main/java/org/elasticsearch/TransportVersions.java
index 2e4842912dfae..1a1219825bbbe 100644
--- a/server/src/main/java/org/elasticsearch/TransportVersions.java
+++ b/server/src/main/java/org/elasticsearch/TransportVersions.java
@@ -104,78 +104,7 @@ static TransportVersion def(int id) {
     public static final TransportVersion V_8_14_0 = def(8_636_00_1);
     public static final TransportVersion V_8_15_0 = def(8_702_00_2);
     public static final TransportVersion V_8_15_2 = def(8_702_00_3);
-    public static final TransportVersion QUERY_RULES_LIST_INCLUDES_TYPES_BACKPORT_8_15 = def(8_702_00_4);
-    public static final TransportVersion ML_INFERENCE_DONT_DELETE_WHEN_SEMANTIC_TEXT_EXISTS = def(8_703_00_0);
-    public static final TransportVersion INFERENCE_ADAPTIVE_ALLOCATIONS = def(8_704_00_0);
-    public static final TransportVersion INDEX_REQUEST_UPDATE_BY_SCRIPT_ORIGIN = def(8_705_00_0);
-    public static final TransportVersion ML_INFERENCE_COHERE_UNUSED_RERANK_SETTINGS_REMOVED = def(8_706_00_0);
-    public static final TransportVersion ENRICH_CACHE_STATS_SIZE_ADDED = def(8_707_00_0);
-    public static final TransportVersion ENTERPRISE_GEOIP_DOWNLOADER = def(8_708_00_0);
-    public static final TransportVersion NODES_STATS_ENUM_SET = def(8_709_00_0);
-    public static final TransportVersion MASTER_NODE_METRICS = def(8_710_00_0);
-    public static final TransportVersion SEGMENT_LEVEL_FIELDS_STATS = def(8_711_00_0);
-    public static final TransportVersion ML_ADD_DETECTION_RULE_PARAMS = def(8_712_00_0);
-    public static final TransportVersion FIX_VECTOR_SIMILARITY_INNER_HITS = def(8_713_00_0);
-    public static final TransportVersion INDEX_REQUEST_UPDATE_BY_DOC_ORIGIN = def(8_714_00_0);
-    public static final TransportVersion ESQL_ATTRIBUTE_CACHED_SERIALIZATION = def(8_715_00_0);
-    public static final TransportVersion REGISTER_SLM_STATS = def(8_716_00_0);
-    public static final TransportVersion ESQL_NESTED_UNSUPPORTED = def(8_717_00_0);
-    public static final TransportVersion ESQL_SINGLE_VALUE_QUERY_SOURCE = def(8_718_00_0);
-    public static final TransportVersion ESQL_ORIGINAL_INDICES = def(8_719_00_0);
-    public static final TransportVersion ML_INFERENCE_EIS_INTEGRATION_ADDED = def(8_720_00_0);
-    public static final TransportVersion INGEST_PIPELINE_EXCEPTION_ADDED = def(8_721_00_0);
-    public static final TransportVersion ZDT_NANOS_SUPPORT_BROKEN = def(8_722_00_0);
-    public static final TransportVersion REMOVE_GLOBAL_RETENTION_FROM_TEMPLATES = def(8_723_00_0);
-    public static final TransportVersion RANDOM_RERANKER_RETRIEVER = def(8_724_00_0);
-    public static final TransportVersion ESQL_PROFILE_SLEEPS = def(8_725_00_0);
-    public static final TransportVersion ZDT_NANOS_SUPPORT = def(8_726_00_0);
-    public static final TransportVersion LTR_SERVERLESS_RELEASE = def(8_727_00_0);
-    public static final TransportVersion ALLOW_PARTIAL_SEARCH_RESULTS_IN_PIT = def(8_728_00_0);
-    public static final TransportVersion RANK_DOCS_RETRIEVER = def(8_729_00_0);
-    public static final TransportVersion ESQL_ES_FIELD_CACHED_SERIALIZATION = def(8_730_00_0);
-    public static final TransportVersion ADD_MANAGE_ROLES_PRIVILEGE = def(8_731_00_0);
-    public static final TransportVersion REPOSITORIES_TELEMETRY = def(8_732_00_0);
-    public static final TransportVersion ML_INFERENCE_ALIBABACLOUD_SEARCH_ADDED = def(8_733_00_0);
-    public static final TransportVersion FIELD_CAPS_RESPONSE_INDEX_MODE = def(8_734_00_0);
-    public static final TransportVersion GET_DATA_STREAMS_VERBOSE = def(8_735_00_0);
-    public static final TransportVersion ESQL_ADD_INDEX_MODE_CONCRETE_INDICES = def(8_736_00_0);
-    public static final TransportVersion UNASSIGNED_PRIMARY_COUNT_ON_CLUSTER_HEALTH = def(8_737_00_0);
-    public static final TransportVersion ESQL_AGGREGATE_EXEC_TRACKS_INTERMEDIATE_ATTRS = def(8_738_00_0);
-    public static final TransportVersion CCS_TELEMETRY_STATS = def(8_739_00_0);
-    public static final TransportVersion GLOBAL_RETENTION_TELEMETRY = def(8_740_00_0);
-    public static final TransportVersion ROUTING_TABLE_VERSION_REMOVED = def(8_741_00_0);
-    public static final TransportVersion ML_SCHEDULED_EVENT_TIME_SHIFT_CONFIGURATION = def(8_742_00_0);
-    public static final TransportVersion SIMULATE_COMPONENT_TEMPLATES_SUBSTITUTIONS = def(8_743_00_0);
-    public static final TransportVersion ML_INFERENCE_IBM_WATSONX_EMBEDDINGS_ADDED = def(8_744_00_0);
-    public static final TransportVersion BULK_INCREMENTAL_STATE = def(8_745_00_0);
-    public static final TransportVersion FAILURE_STORE_STATUS_IN_INDEX_RESPONSE = def(8_746_00_0);
-    public static final TransportVersion ESQL_AGGREGATION_OPERATOR_STATUS_FINISH_NANOS = def(8_747_00_0);
-    public static final TransportVersion ML_TELEMETRY_MEMORY_ADDED = def(8_748_00_0);
-    public static final TransportVersion ILM_ADD_SEARCHABLE_SNAPSHOT_TOTAL_SHARDS_PER_NODE = def(8_749_00_0);
-    public static final TransportVersion SEMANTIC_TEXT_SEARCH_INFERENCE_ID = def(8_750_00_0);
-    public static final TransportVersion ML_INFERENCE_CHUNKING_SETTINGS = def(8_751_00_0);
-    public static final TransportVersion SEMANTIC_QUERY_INNER_HITS = def(8_752_00_0);
-    public static final TransportVersion RETAIN_ILM_STEP_INFO = def(8_753_00_0);
-    public static final TransportVersion ADD_DATA_STREAM_OPTIONS = def(8_754_00_0);
-    public static final TransportVersion CCS_REMOTE_TELEMETRY_STATS = def(8_755_00_0);
-    public static final TransportVersion ESQL_CCS_EXECUTION_INFO = def(8_756_00_0);
-    public static final TransportVersion REGEX_AND_RANGE_INTERVAL_QUERIES = def(8_757_00_0);
-    public static final TransportVersion RRF_QUERY_REWRITE = def(8_758_00_0);
-    public static final TransportVersion SEARCH_FAILURE_STATS = def(8_759_00_0);
-    public static final TransportVersion INGEST_GEO_DATABASE_PROVIDERS = def(8_760_00_0);
-    public static final TransportVersion DATE_TIME_DOC_VALUES_LOCALES = def(8_761_00_0);
-    public static final TransportVersion FAST_REFRESH_RCO = def(8_762_00_0);
-    public static final TransportVersion TEXT_SIMILARITY_RERANKER_QUERY_REWRITE = def(8_763_00_0);
-    public static final TransportVersion SIMULATE_INDEX_TEMPLATES_SUBSTITUTIONS = def(8_764_00_0);
-    public static final TransportVersion RETRIEVERS_TELEMETRY_ADDED = def(8_765_00_0);
-    public static final TransportVersion ESQL_CACHED_STRING_SERIALIZATION = def(8_766_00_0);
-    public static final TransportVersion CHUNK_SENTENCE_OVERLAP_SETTING_ADDED = def(8_767_00_0);
-    public static final TransportVersion OPT_IN_ESQL_CCS_EXECUTION_INFO = def(8_768_00_0);
-    public static final TransportVersion QUERY_RULE_TEST_API = def(8_769_00_0);
-    public static final TransportVersion ESQL_PER_AGGREGATE_FILTER = def(8_770_00_0);
-    public static final TransportVersion ML_INFERENCE_ATTACH_TO_EXISTSING_DEPLOYMENT = def(8_771_00_0);
-    public static final TransportVersion CONVERT_FAILURE_STORE_OPTIONS_TO_SELECTOR_OPTIONS_INTERNALLY = def(8_772_00_0);
-    public static final TransportVersion INFERENCE_DONT_PERSIST_ON_READ_BACKPORT_8_16 = def(8_772_00_1);
+    public static final TransportVersion V_8_16_0 = def(8_772_00_1);
     public static final TransportVersion ADD_COMPATIBILITY_VERSIONS_TO_NODE_INFO_BACKPORT_8_16 = def(8_772_00_2);
     public static final TransportVersion SKIP_INNER_HITS_SEARCH_SOURCE_BACKPORT_8_16 = def(8_772_00_3);
     public static final TransportVersion QUERY_RULES_LIST_INCLUDES_TYPES_BACKPORT_8_16 = def(8_772_00_4);
diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/allocation/TransportGetAllocationStatsAction.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/allocation/TransportGetAllocationStatsAction.java
index e14f229f17acf..d929fb457d5d1 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/cluster/allocation/TransportGetAllocationStatsAction.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/allocation/TransportGetAllocationStatsAction.java
@@ -118,7 +118,7 @@ public Request(TimeValue masterNodeTimeout, TaskId parentTaskId, EnumSet<Metric>
 
         public Request(StreamInput in) throws IOException {
             super(in);
-            this.metrics = in.getTransportVersion().onOrAfter(TransportVersions.MASTER_NODE_METRICS)
+            this.metrics = in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)
                 ? in.readEnumSet(Metric.class)
                 : EnumSet.of(Metric.ALLOCATIONS, Metric.FS);
         }
@@ -127,7 +127,7 @@ public Request(StreamInput in) throws IOException {
         public void writeTo(StreamOutput out) throws IOException {
             assert out.getTransportVersion().onOrAfter(TransportVersions.V_8_14_0);
             super.writeTo(out);
-            if (out.getTransportVersion().onOrAfter(TransportVersions.MASTER_NODE_METRICS)) {
+            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 out.writeEnumSet(metrics);
             }
         }
diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/node/stats/NodesStatsRequestParameters.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/node/stats/NodesStatsRequestParameters.java
index d34bc3ec0dc2f..c5e8f37ed3a96 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/cluster/node/stats/NodesStatsRequestParameters.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/node/stats/NodesStatsRequestParameters.java
@@ -117,7 +117,7 @@ public static Metric get(String name) {
         }
 
         public static void writeSetTo(StreamOutput out, EnumSet<Metric> metrics) throws IOException {
-            if (out.getTransportVersion().onOrAfter(TransportVersions.NODES_STATS_ENUM_SET)) {
+            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 out.writeEnumSet(metrics);
             } else {
                 out.writeCollection(metrics, (output, metric) -> output.writeString(metric.metricName));
@@ -125,7 +125,7 @@ public static void writeSetTo(StreamOutput out, EnumSet<Metric> metrics) throws
         }
 
         public static EnumSet<Metric> readSetFrom(StreamInput in) throws IOException {
-            if (in.getTransportVersion().onOrAfter(TransportVersions.NODES_STATS_ENUM_SET)) {
+            if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 return in.readEnumSet(Metric.class);
             } else {
                 return in.readCollection((i) -> EnumSet.noneOf(Metric.class), (is, out) -> {
diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/snapshots/create/CreateSnapshotRequest.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/snapshots/create/CreateSnapshotRequest.java
index 9c9467db40de3..b6ced06623306 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/cluster/snapshots/create/CreateSnapshotRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/snapshots/create/CreateSnapshotRequest.java
@@ -118,7 +118,7 @@ public CreateSnapshotRequest(StreamInput in) throws IOException {
         waitForCompletion = in.readBoolean();
         partial = in.readBoolean();
         userMetadata = in.readGenericMap();
-        uuid = in.getTransportVersion().onOrAfter(TransportVersions.REGISTER_SLM_STATS) ? in.readOptionalString() : null;
+        uuid = in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0) ? in.readOptionalString() : null;
     }
 
     @Override
@@ -136,7 +136,7 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeBoolean(waitForCompletion);
         out.writeBoolean(partial);
         out.writeGenericMap(userMetadata);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.REGISTER_SLM_STATS)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeOptionalString(uuid);
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/stats/ClusterStatsNodeResponse.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/stats/ClusterStatsNodeResponse.java
index f99baa855404c..abeb73e5d8c3e 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/cluster/stats/ClusterStatsNodeResponse.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/stats/ClusterStatsNodeResponse.java
@@ -44,14 +44,11 @@ public ClusterStatsNodeResponse(StreamInput in) throws IOException {
         } else {
             searchUsageStats = new SearchUsageStats();
         }
-        if (in.getTransportVersion().onOrAfter(TransportVersions.REPOSITORIES_TELEMETRY)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             repositoryUsageStats = RepositoryUsageStats.readFrom(in);
-        } else {
-            repositoryUsageStats = RepositoryUsageStats.EMPTY;
-        }
-        if (in.getTransportVersion().onOrAfter(TransportVersions.CCS_TELEMETRY_STATS)) {
             ccsMetrics = new CCSTelemetrySnapshot(in);
         } else {
+            repositoryUsageStats = RepositoryUsageStats.EMPTY;
             ccsMetrics = new CCSTelemetrySnapshot();
         }
     }
@@ -118,12 +115,10 @@ public void writeTo(StreamOutput out) throws IOException {
         if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_6_0)) {
             searchUsageStats.writeTo(out);
         }
-        if (out.getTransportVersion().onOrAfter(TransportVersions.REPOSITORIES_TELEMETRY)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             repositoryUsageStats.writeTo(out);
-        } // else just drop these stats, ok for bwc
-        if (out.getTransportVersion().onOrAfter(TransportVersions.CCS_TELEMETRY_STATS)) {
             ccsMetrics.writeTo(out);
-        }
+        } // else just drop these stats, ok for bwc
     }
 
 }
diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/stats/RemoteClusterStatsRequest.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/stats/RemoteClusterStatsRequest.java
index 47843a91351ee..6c3c5cbb50ece 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/cluster/stats/RemoteClusterStatsRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/stats/RemoteClusterStatsRequest.java
@@ -36,9 +36,9 @@ public ActionRequestValidationException validate() {
 
     @Override
     public void writeTo(StreamOutput out) throws IOException {
-        assert out.getTransportVersion().onOrAfter(TransportVersions.CCS_REMOTE_TELEMETRY_STATS)
+        assert out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)
             : "RemoteClusterStatsRequest is not supported by the remote cluster";
-        if (out.getTransportVersion().before(TransportVersions.CCS_REMOTE_TELEMETRY_STATS)) {
+        if (out.getTransportVersion().before(TransportVersions.V_8_16_0)) {
             throw new UnsupportedOperationException("RemoteClusterStatsRequest is not supported by the remote cluster");
         }
         super.writeTo(out);
diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/stats/SearchUsageStats.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/stats/SearchUsageStats.java
index 0f6c56fd21bd7..a6e80b5efd08c 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/cluster/stats/SearchUsageStats.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/stats/SearchUsageStats.java
@@ -22,8 +22,8 @@
 import java.util.Map;
 import java.util.Objects;
 
-import static org.elasticsearch.TransportVersions.RETRIEVERS_TELEMETRY_ADDED;
 import static org.elasticsearch.TransportVersions.V_8_12_0;
+import static org.elasticsearch.TransportVersions.V_8_16_0;
 
 /**
  * Holds a snapshot of the search usage statistics.
@@ -71,7 +71,7 @@ public SearchUsageStats(StreamInput in) throws IOException {
         this.sections = in.readMap(StreamInput::readLong);
         this.totalSearchCount = in.readVLong();
         this.rescorers = in.getTransportVersion().onOrAfter(V_8_12_0) ? in.readMap(StreamInput::readLong) : Map.of();
-        this.retrievers = in.getTransportVersion().onOrAfter(RETRIEVERS_TELEMETRY_ADDED) ? in.readMap(StreamInput::readLong) : Map.of();
+        this.retrievers = in.getTransportVersion().onOrAfter(V_8_16_0) ? in.readMap(StreamInput::readLong) : Map.of();
     }
 
     @Override
@@ -83,7 +83,7 @@ public void writeTo(StreamOutput out) throws IOException {
         if (out.getTransportVersion().onOrAfter(V_8_12_0)) {
             out.writeMap(rescorers, StreamOutput::writeLong);
         }
-        if (out.getTransportVersion().onOrAfter(RETRIEVERS_TELEMETRY_ADDED)) {
+        if (out.getTransportVersion().onOrAfter(V_8_16_0)) {
             out.writeMap(retrievers, StreamOutput::writeLong);
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/action/admin/cluster/stats/TransportClusterStatsAction.java b/server/src/main/java/org/elasticsearch/action/admin/cluster/stats/TransportClusterStatsAction.java
index 97585ea9a1024..2c20daa5d7afb 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/cluster/stats/TransportClusterStatsAction.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/cluster/stats/TransportClusterStatsAction.java
@@ -12,6 +12,7 @@
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.apache.lucene.store.AlreadyClosedException;
+import org.elasticsearch.TransportVersions;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.ActionRunnable;
 import org.elasticsearch.action.ActionType;
@@ -72,8 +73,6 @@
 import java.util.function.BooleanSupplier;
 import java.util.stream.Collectors;
 
-import static org.elasticsearch.TransportVersions.CCS_REMOTE_TELEMETRY_STATS;
-
 /**
  * Transport action implementing _cluster/stats API.
  */
@@ -450,7 +449,7 @@ protected void sendItemRequest(String clusterAlias, ActionListener<RemoteCluster
             var remoteRequest = new RemoteClusterStatsRequest();
             remoteRequest.setParentTask(taskId);
             remoteClusterClient.getConnection(remoteRequest, listener.delegateFailureAndWrap((responseListener, connection) -> {
-                if (connection.getTransportVersion().before(CCS_REMOTE_TELEMETRY_STATS)) {
+                if (connection.getTransportVersion().before(TransportVersions.V_8_16_0)) {
                     responseListener.onResponse(null);
                 } else {
                     remoteClusterClient.execute(connection, TransportRemoteClusterStatsAction.REMOTE_TYPE, remoteRequest, responseListener);
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/template/get/GetComponentTemplateAction.java b/server/src/main/java/org/elasticsearch/action/admin/indices/template/get/GetComponentTemplateAction.java
index c6d990e5a1d62..f729455edcc24 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/template/get/GetComponentTemplateAction.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/template/get/GetComponentTemplateAction.java
@@ -131,8 +131,7 @@ public Response(StreamInput in) throws IOException {
             } else {
                 rolloverConfiguration = null;
             }
-            if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_14_0)
-                && in.getTransportVersion().before(TransportVersions.REMOVE_GLOBAL_RETENTION_FROM_TEMPLATES)) {
+            if (in.getTransportVersion().between(TransportVersions.V_8_14_0, TransportVersions.V_8_16_0)) {
                 in.readOptionalWriteable(DataStreamGlobalRetention::read);
             }
         }
@@ -190,8 +189,7 @@ public void writeTo(StreamOutput out) throws IOException {
             if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_9_X)) {
                 out.writeOptionalWriteable(rolloverConfiguration);
             }
-            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_14_0)
-                && out.getTransportVersion().before(TransportVersions.REMOVE_GLOBAL_RETENTION_FROM_TEMPLATES)) {
+            if (out.getTransportVersion().between(TransportVersions.V_8_14_0, TransportVersions.V_8_16_0)) {
                 out.writeOptionalWriteable(null);
             }
         }
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/template/get/GetComposableIndexTemplateAction.java b/server/src/main/java/org/elasticsearch/action/admin/indices/template/get/GetComposableIndexTemplateAction.java
index a47f89030cc60..67f87476ea6a5 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/template/get/GetComposableIndexTemplateAction.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/template/get/GetComposableIndexTemplateAction.java
@@ -132,8 +132,7 @@ public Response(StreamInput in) throws IOException {
             } else {
                 rolloverConfiguration = null;
             }
-            if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_14_0)
-                && in.getTransportVersion().before(TransportVersions.REMOVE_GLOBAL_RETENTION_FROM_TEMPLATES)) {
+            if (in.getTransportVersion().between(TransportVersions.V_8_14_0, TransportVersions.V_8_16_0)) {
                 in.readOptionalWriteable(DataStreamGlobalRetention::read);
             }
         }
@@ -191,8 +190,7 @@ public void writeTo(StreamOutput out) throws IOException {
             if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_9_X)) {
                 out.writeOptionalWriteable(rolloverConfiguration);
             }
-            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_14_0)
-                && out.getTransportVersion().before(TransportVersions.REMOVE_GLOBAL_RETENTION_FROM_TEMPLATES)) {
+            if (out.getTransportVersion().between(TransportVersions.V_8_14_0, TransportVersions.V_8_16_0)) {
                 out.writeOptionalWriteable(null);
             }
         }
diff --git a/server/src/main/java/org/elasticsearch/action/admin/indices/template/post/SimulateIndexTemplateResponse.java b/server/src/main/java/org/elasticsearch/action/admin/indices/template/post/SimulateIndexTemplateResponse.java
index 064c24cf4afa3..80e6fbfe051a4 100644
--- a/server/src/main/java/org/elasticsearch/action/admin/indices/template/post/SimulateIndexTemplateResponse.java
+++ b/server/src/main/java/org/elasticsearch/action/admin/indices/template/post/SimulateIndexTemplateResponse.java
@@ -82,8 +82,7 @@ public SimulateIndexTemplateResponse(StreamInput in) throws IOException {
         rolloverConfiguration = in.getTransportVersion().onOrAfter(TransportVersions.V_8_9_X)
             ? in.readOptionalWriteable(RolloverConfiguration::new)
             : null;
-        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_14_0)
-            && in.getTransportVersion().before(TransportVersions.REMOVE_GLOBAL_RETENTION_FROM_TEMPLATES)) {
+        if (in.getTransportVersion().between(TransportVersions.V_8_14_0, TransportVersions.V_8_16_0)) {
             in.readOptionalWriteable(DataStreamGlobalRetention::read);
         }
     }
@@ -104,8 +103,7 @@ public void writeTo(StreamOutput out) throws IOException {
         if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_9_X)) {
             out.writeOptionalWriteable(rolloverConfiguration);
         }
-        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_14_0)
-            && out.getTransportVersion().before(TransportVersions.REMOVE_GLOBAL_RETENTION_FROM_TEMPLATES)) {
+        if (out.getTransportVersion().between(TransportVersions.V_8_14_0, TransportVersions.V_8_16_0)) {
             out.writeOptionalWriteable(null);
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/action/bulk/BulkItemResponse.java b/server/src/main/java/org/elasticsearch/action/bulk/BulkItemResponse.java
index d5931c85bb2e1..1ff970de7525e 100644
--- a/server/src/main/java/org/elasticsearch/action/bulk/BulkItemResponse.java
+++ b/server/src/main/java/org/elasticsearch/action/bulk/BulkItemResponse.java
@@ -200,7 +200,7 @@ public Failure(StreamInput in) throws IOException {
             seqNo = in.readZLong();
             term = in.readVLong();
             aborted = in.readBoolean();
-            if (in.getTransportVersion().onOrAfter(TransportVersions.FAILURE_STORE_STATUS_IN_INDEX_RESPONSE)) {
+            if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 failureStoreStatus = IndexDocFailureStoreStatus.read(in);
             } else {
                 failureStoreStatus = IndexDocFailureStoreStatus.NOT_APPLICABLE_OR_UNKNOWN;
@@ -218,7 +218,7 @@ public void writeTo(StreamOutput out) throws IOException {
             out.writeZLong(seqNo);
             out.writeVLong(term);
             out.writeBoolean(aborted);
-            if (out.getTransportVersion().onOrAfter(TransportVersions.FAILURE_STORE_STATUS_IN_INDEX_RESPONSE)) {
+            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 failureStoreStatus.writeTo(out);
             }
         }
diff --git a/server/src/main/java/org/elasticsearch/action/bulk/BulkRequest.java b/server/src/main/java/org/elasticsearch/action/bulk/BulkRequest.java
index f62b2f48fa2fd..91caebc420ffb 100644
--- a/server/src/main/java/org/elasticsearch/action/bulk/BulkRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/bulk/BulkRequest.java
@@ -98,7 +98,7 @@ public BulkRequest(StreamInput in) throws IOException {
         for (DocWriteRequest<?> request : requests) {
             indices.add(Objects.requireNonNull(request.index(), "request index must not be null"));
         }
-        if (in.getTransportVersion().onOrAfter(TransportVersions.BULK_INCREMENTAL_STATE)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             incrementalState = new BulkRequest.IncrementalState(in);
         } else {
             incrementalState = BulkRequest.IncrementalState.EMPTY;
@@ -454,7 +454,7 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeCollection(requests, DocWriteRequest::writeDocumentRequest);
         refreshPolicy.writeTo(out);
         out.writeTimeValue(timeout);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.BULK_INCREMENTAL_STATE)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             incrementalState.writeTo(out);
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/action/bulk/BulkResponse.java b/server/src/main/java/org/elasticsearch/action/bulk/BulkResponse.java
index ec7a08007de93..12d3aa67ca9bb 100644
--- a/server/src/main/java/org/elasticsearch/action/bulk/BulkResponse.java
+++ b/server/src/main/java/org/elasticsearch/action/bulk/BulkResponse.java
@@ -46,7 +46,7 @@ public BulkResponse(StreamInput in) throws IOException {
         responses = in.readArray(BulkItemResponse::new, BulkItemResponse[]::new);
         tookInMillis = in.readVLong();
         ingestTookInMillis = in.readZLong();
-        if (in.getTransportVersion().onOrAfter(TransportVersions.BULK_INCREMENTAL_STATE)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             incrementalState = new BulkRequest.IncrementalState(in);
         } else {
             incrementalState = BulkRequest.IncrementalState.EMPTY;
@@ -151,7 +151,7 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeArray(responses);
         out.writeVLong(tookInMillis);
         out.writeZLong(ingestTookInMillis);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.BULK_INCREMENTAL_STATE)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             incrementalState.writeTo(out);
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/action/bulk/IndexDocFailureStoreStatus.java b/server/src/main/java/org/elasticsearch/action/bulk/IndexDocFailureStoreStatus.java
index cb83d693a415b..7367dfa1d53fd 100644
--- a/server/src/main/java/org/elasticsearch/action/bulk/IndexDocFailureStoreStatus.java
+++ b/server/src/main/java/org/elasticsearch/action/bulk/IndexDocFailureStoreStatus.java
@@ -124,7 +124,7 @@ public ExceptionWithFailureStoreStatus(BulkItemResponse.Failure failure) {
 
         public ExceptionWithFailureStoreStatus(StreamInput in) throws IOException {
             super(in);
-            if (in.getTransportVersion().onOrAfter(TransportVersions.FAILURE_STORE_STATUS_IN_INDEX_RESPONSE)) {
+            if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 failureStoreStatus = IndexDocFailureStoreStatus.fromId(in.readByte());
             } else {
                 failureStoreStatus = NOT_APPLICABLE_OR_UNKNOWN;
@@ -134,7 +134,7 @@ public ExceptionWithFailureStoreStatus(StreamInput in) throws IOException {
         @Override
         protected void writeTo(StreamOutput out, Writer<Throwable> nestedExceptionsWriter) throws IOException {
             super.writeTo(out, nestedExceptionsWriter);
-            if (out.getTransportVersion().onOrAfter(TransportVersions.FAILURE_STORE_STATUS_IN_INDEX_RESPONSE)) {
+            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 out.writeByte(failureStoreStatus.getId());
             }
         }
diff --git a/server/src/main/java/org/elasticsearch/action/bulk/SimulateBulkRequest.java b/server/src/main/java/org/elasticsearch/action/bulk/SimulateBulkRequest.java
index cc7fd431d8097..290d342e9dc12 100644
--- a/server/src/main/java/org/elasticsearch/action/bulk/SimulateBulkRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/bulk/SimulateBulkRequest.java
@@ -135,14 +135,11 @@ public SimulateBulkRequest(
     public SimulateBulkRequest(StreamInput in) throws IOException {
         super(in);
         this.pipelineSubstitutions = (Map<String, Map<String, Object>>) in.readGenericValue();
-        if (in.getTransportVersion().onOrAfter(TransportVersions.SIMULATE_COMPONENT_TEMPLATES_SUBSTITUTIONS)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             this.componentTemplateSubstitutions = (Map<String, Map<String, Object>>) in.readGenericValue();
-        } else {
-            componentTemplateSubstitutions = Map.of();
-        }
-        if (in.getTransportVersion().onOrAfter(TransportVersions.SIMULATE_INDEX_TEMPLATES_SUBSTITUTIONS)) {
             this.indexTemplateSubstitutions = (Map<String, Map<String, Object>>) in.readGenericValue();
         } else {
+            componentTemplateSubstitutions = Map.of();
             indexTemplateSubstitutions = Map.of();
         }
         if (in.getTransportVersion().onOrAfter(TransportVersions.SIMULATE_MAPPING_ADDITION)) {
@@ -156,10 +153,8 @@ public SimulateBulkRequest(StreamInput in) throws IOException {
     public void writeTo(StreamOutput out) throws IOException {
         super.writeTo(out);
         out.writeGenericValue(pipelineSubstitutions);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.SIMULATE_COMPONENT_TEMPLATES_SUBSTITUTIONS)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeGenericValue(componentTemplateSubstitutions);
-        }
-        if (out.getTransportVersion().onOrAfter(TransportVersions.SIMULATE_INDEX_TEMPLATES_SUBSTITUTIONS)) {
             out.writeGenericValue(indexTemplateSubstitutions);
         }
         if (out.getTransportVersion().onOrAfter(TransportVersions.SIMULATE_MAPPING_ADDITION)) {
diff --git a/server/src/main/java/org/elasticsearch/action/datastreams/GetDataStreamAction.java b/server/src/main/java/org/elasticsearch/action/datastreams/GetDataStreamAction.java
index c1cf0fa7aab42..93c40ad18cc8a 100644
--- a/server/src/main/java/org/elasticsearch/action/datastreams/GetDataStreamAction.java
+++ b/server/src/main/java/org/elasticsearch/action/datastreams/GetDataStreamAction.java
@@ -112,7 +112,7 @@ public Request(StreamInput in) throws IOException {
             } else {
                 this.includeDefaults = false;
             }
-            if (in.getTransportVersion().onOrAfter(TransportVersions.GET_DATA_STREAMS_VERBOSE)) {
+            if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 this.verbose = in.readBoolean();
             } else {
                 this.verbose = false;
@@ -127,7 +127,7 @@ public void writeTo(StreamOutput out) throws IOException {
             if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_9_X)) {
                 out.writeBoolean(includeDefaults);
             }
-            if (out.getTransportVersion().onOrAfter(TransportVersions.GET_DATA_STREAMS_VERBOSE)) {
+            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 out.writeBoolean(verbose);
             }
         }
@@ -275,7 +275,7 @@ public DataStreamInfo(
                     in.getTransportVersion().onOrAfter(TransportVersions.V_8_3_0) ? in.readOptionalWriteable(TimeSeries::new) : null,
                     in.getTransportVersion().onOrAfter(V_8_11_X) ? in.readMap(Index::new, IndexProperties::new) : Map.of(),
                     in.getTransportVersion().onOrAfter(V_8_11_X) ? in.readBoolean() : true,
-                    in.getTransportVersion().onOrAfter(TransportVersions.GET_DATA_STREAMS_VERBOSE) ? in.readOptionalVLong() : null
+                    in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0) ? in.readOptionalVLong() : null
                 );
             }
 
@@ -328,7 +328,7 @@ public void writeTo(StreamOutput out) throws IOException {
                     out.writeMap(indexSettingsValues);
                     out.writeBoolean(templatePreferIlmValue);
                 }
-                if (out.getTransportVersion().onOrAfter(TransportVersions.GET_DATA_STREAMS_VERBOSE)) {
+                if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                     out.writeOptionalVLong(maximumTimestamp);
                 }
             }
diff --git a/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilitiesIndexResponse.java b/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilitiesIndexResponse.java
index d16100a64713e..6f510ad26f5ec 100644
--- a/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilitiesIndexResponse.java
+++ b/server/src/main/java/org/elasticsearch/action/fieldcaps/FieldCapabilitiesIndexResponse.java
@@ -62,7 +62,7 @@ public FieldCapabilitiesIndexResponse(
         } else {
             this.indexMappingHash = null;
         }
-        if (in.getTransportVersion().onOrAfter(TransportVersions.FIELD_CAPS_RESPONSE_INDEX_MODE)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             this.indexMode = IndexMode.readFrom(in);
         } else {
             this.indexMode = IndexMode.STANDARD;
@@ -77,7 +77,7 @@ public void writeTo(StreamOutput out) throws IOException {
         if (out.getTransportVersion().onOrAfter(MAPPING_HASH_VERSION)) {
             out.writeOptionalString(indexMappingHash);
         }
-        if (out.getTransportVersion().onOrAfter(TransportVersions.FIELD_CAPS_RESPONSE_INDEX_MODE)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             IndexMode.writeTo(indexMode, out);
         }
     }
@@ -105,7 +105,7 @@ static List<FieldCapabilitiesIndexResponse> readList(StreamInput input) throws I
     private static void collectCompressedResponses(StreamInput input, int groups, ArrayList<FieldCapabilitiesIndexResponse> responses)
         throws IOException {
         final CompressedGroup[] compressedGroups = new CompressedGroup[groups];
-        final boolean readIndexMode = input.getTransportVersion().onOrAfter(TransportVersions.FIELD_CAPS_RESPONSE_INDEX_MODE);
+        final boolean readIndexMode = input.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0);
         for (int i = 0; i < groups; i++) {
             final String[] indices = input.readStringArray();
             final IndexMode indexMode = readIndexMode ? IndexMode.readFrom(input) : IndexMode.STANDARD;
@@ -179,7 +179,7 @@ private static void writeCompressedResponses(StreamOutput output, Map<String, Li
         output.writeCollection(groupedResponsesMap.values(), (o, fieldCapabilitiesIndexResponses) -> {
             o.writeCollection(fieldCapabilitiesIndexResponses, (oo, r) -> oo.writeString(r.indexName));
             var first = fieldCapabilitiesIndexResponses.get(0);
-            if (output.getTransportVersion().onOrAfter(TransportVersions.FIELD_CAPS_RESPONSE_INDEX_MODE)) {
+            if (output.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 IndexMode.writeTo(first.indexMode, o);
             }
             o.writeString(first.indexMappingHash);
diff --git a/server/src/main/java/org/elasticsearch/action/index/IndexRequest.java b/server/src/main/java/org/elasticsearch/action/index/IndexRequest.java
index c0811e7424b0d..5254c6fd06db7 100644
--- a/server/src/main/java/org/elasticsearch/action/index/IndexRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/index/IndexRequest.java
@@ -205,10 +205,8 @@ public IndexRequest(@Nullable ShardId shardId, StreamInput in) throws IOExceptio
             if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_13_0)) {
                 in.readZLong(); // obsolete normalisedBytesParsed
             }
-            if (in.getTransportVersion().onOrAfter(TransportVersions.INDEX_REQUEST_UPDATE_BY_SCRIPT_ORIGIN)) {
+            if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 in.readBoolean(); // obsolete originatesFromUpdateByScript
-            }
-            if (in.getTransportVersion().onOrAfter(TransportVersions.INDEX_REQUEST_UPDATE_BY_DOC_ORIGIN)) {
                 in.readBoolean(); // obsolete originatesFromUpdateByDoc
             }
         }
@@ -789,10 +787,8 @@ private void writeBody(StreamOutput out) throws IOException {
             if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_13_0)) {
                 out.writeZLong(-1);  // obsolete normalisedBytesParsed
             }
-            if (out.getTransportVersion().onOrAfter(TransportVersions.INDEX_REQUEST_UPDATE_BY_SCRIPT_ORIGIN)) {
+            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 out.writeBoolean(false); // obsolete originatesFromUpdateByScript
-            }
-            if (out.getTransportVersion().onOrAfter(TransportVersions.INDEX_REQUEST_UPDATE_BY_DOC_ORIGIN)) {
                 out.writeBoolean(false); // obsolete originatesFromUpdateByDoc
             }
         }
diff --git a/server/src/main/java/org/elasticsearch/action/index/IndexResponse.java b/server/src/main/java/org/elasticsearch/action/index/IndexResponse.java
index 8d1bdf227e24d..7c45de8905174 100644
--- a/server/src/main/java/org/elasticsearch/action/index/IndexResponse.java
+++ b/server/src/main/java/org/elasticsearch/action/index/IndexResponse.java
@@ -46,7 +46,7 @@ public IndexResponse(ShardId shardId, StreamInput in) throws IOException {
         } else {
             executedPipelines = null;
         }
-        if (in.getTransportVersion().onOrAfter(TransportVersions.FAILURE_STORE_STATUS_IN_INDEX_RESPONSE)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             failureStoreStatus = IndexDocFailureStoreStatus.read(in);
         } else {
             failureStoreStatus = IndexDocFailureStoreStatus.NOT_APPLICABLE_OR_UNKNOWN;
@@ -60,7 +60,7 @@ public IndexResponse(StreamInput in) throws IOException {
         } else {
             executedPipelines = null;
         }
-        if (in.getTransportVersion().onOrAfter(TransportVersions.FAILURE_STORE_STATUS_IN_INDEX_RESPONSE)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             failureStoreStatus = IndexDocFailureStoreStatus.read(in);
         } else {
             failureStoreStatus = IndexDocFailureStoreStatus.NOT_APPLICABLE_OR_UNKNOWN;
@@ -126,7 +126,7 @@ public void writeTo(StreamOutput out) throws IOException {
         if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_12_0)) {
             out.writeOptionalCollection(executedPipelines, StreamOutput::writeString);
         }
-        if (out.getTransportVersion().onOrAfter(TransportVersions.FAILURE_STORE_STATUS_IN_INDEX_RESPONSE)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             failureStoreStatus.writeTo(out);
         }
     }
@@ -137,7 +137,7 @@ public void writeThin(StreamOutput out) throws IOException {
         if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_12_0)) {
             out.writeOptionalCollection(executedPipelines, StreamOutput::writeString);
         }
-        if (out.getTransportVersion().onOrAfter(TransportVersions.FAILURE_STORE_STATUS_IN_INDEX_RESPONSE)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             failureStoreStatus.writeTo(out);
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/action/search/OpenPointInTimeRequest.java b/server/src/main/java/org/elasticsearch/action/search/OpenPointInTimeRequest.java
index 969ba2ad983ce..d68e2ce1b02b7 100644
--- a/server/src/main/java/org/elasticsearch/action/search/OpenPointInTimeRequest.java
+++ b/server/src/main/java/org/elasticsearch/action/search/OpenPointInTimeRequest.java
@@ -63,7 +63,7 @@ public OpenPointInTimeRequest(StreamInput in) throws IOException {
         if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_12_0)) {
             this.indexFilter = in.readOptionalNamedWriteable(QueryBuilder.class);
         }
-        if (in.getTransportVersion().onOrAfter(TransportVersions.ALLOW_PARTIAL_SEARCH_RESULTS_IN_PIT)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             this.allowPartialSearchResults = in.readBoolean();
         }
     }
@@ -82,7 +82,7 @@ public void writeTo(StreamOutput out) throws IOException {
         if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_12_0)) {
             out.writeOptionalWriteable(indexFilter);
         }
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ALLOW_PARTIAL_SEARCH_RESULTS_IN_PIT)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeBoolean(allowPartialSearchResults);
         } else if (allowPartialSearchResults) {
             throw new IOException("[allow_partial_search_results] is not supported on nodes with version " + out.getTransportVersion());
diff --git a/server/src/main/java/org/elasticsearch/action/search/OpenPointInTimeResponse.java b/server/src/main/java/org/elasticsearch/action/search/OpenPointInTimeResponse.java
index 3c830c8ed9dc1..b3ffc564d848c 100644
--- a/server/src/main/java/org/elasticsearch/action/search/OpenPointInTimeResponse.java
+++ b/server/src/main/java/org/elasticsearch/action/search/OpenPointInTimeResponse.java
@@ -47,7 +47,7 @@ public OpenPointInTimeResponse(
     @Override
     public void writeTo(StreamOutput out) throws IOException {
         out.writeBytesReference(pointInTimeId);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ALLOW_PARTIAL_SEARCH_RESULTS_IN_PIT)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeVInt(totalShards);
             out.writeVInt(successfulShards);
             out.writeVInt(failedShards);
diff --git a/server/src/main/java/org/elasticsearch/action/search/SearchContextId.java b/server/src/main/java/org/elasticsearch/action/search/SearchContextId.java
index ca810bb88653f..c2f1510341fb0 100644
--- a/server/src/main/java/org/elasticsearch/action/search/SearchContextId.java
+++ b/server/src/main/java/org/elasticsearch/action/search/SearchContextId.java
@@ -63,14 +63,14 @@ public static BytesReference encode(
         TransportVersion version,
         ShardSearchFailure[] shardFailures
     ) {
-        assert shardFailures.length == 0 || version.onOrAfter(TransportVersions.ALLOW_PARTIAL_SEARCH_RESULTS_IN_PIT)
+        assert shardFailures.length == 0 || version.onOrAfter(TransportVersions.V_8_16_0)
             : "[allow_partial_search_results] cannot be enabled on a cluster that has not been fully upgraded to version ["
-                + TransportVersions.ALLOW_PARTIAL_SEARCH_RESULTS_IN_PIT
+                + TransportVersions.V_8_16_0.toReleaseVersion()
                 + "] or higher.";
         try (var out = new BytesStreamOutput()) {
             out.setTransportVersion(version);
             TransportVersion.writeVersion(version, out);
-            boolean allowNullContextId = out.getTransportVersion().onOrAfter(TransportVersions.ALLOW_PARTIAL_SEARCH_RESULTS_IN_PIT);
+            boolean allowNullContextId = out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0);
             int shardSize = searchPhaseResults.size() + (allowNullContextId ? shardFailures.length : 0);
             out.writeVInt(shardSize);
             for (var searchResult : searchPhaseResults) {
diff --git a/server/src/main/java/org/elasticsearch/action/search/SearchContextIdForNode.java b/server/src/main/java/org/elasticsearch/action/search/SearchContextIdForNode.java
index 7509a7b0fed04..f91a9d09f4bb4 100644
--- a/server/src/main/java/org/elasticsearch/action/search/SearchContextIdForNode.java
+++ b/server/src/main/java/org/elasticsearch/action/search/SearchContextIdForNode.java
@@ -37,7 +37,7 @@ public final class SearchContextIdForNode implements Writeable {
     }
 
     SearchContextIdForNode(StreamInput in) throws IOException {
-        boolean allowNull = in.getTransportVersion().onOrAfter(TransportVersions.ALLOW_PARTIAL_SEARCH_RESULTS_IN_PIT);
+        boolean allowNull = in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0);
         this.node = allowNull ? in.readOptionalString() : in.readString();
         this.clusterAlias = in.readOptionalString();
         this.searchContextId = allowNull ? in.readOptionalWriteable(ShardSearchContextId::new) : new ShardSearchContextId(in);
@@ -45,7 +45,7 @@ public final class SearchContextIdForNode implements Writeable {
 
     @Override
     public void writeTo(StreamOutput out) throws IOException {
-        boolean allowNull = out.getTransportVersion().onOrAfter(TransportVersions.ALLOW_PARTIAL_SEARCH_RESULTS_IN_PIT);
+        boolean allowNull = out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0);
         if (allowNull) {
             out.writeOptionalString(node);
         } else {
@@ -53,7 +53,7 @@ public void writeTo(StreamOutput out) throws IOException {
                 // We should never set a null node if the cluster is not fully upgraded to a version that can handle it.
                 throw new IOException(
                     "Cannot write null node value to a node in version "
-                        + out.getTransportVersion()
+                        + out.getTransportVersion().toReleaseVersion()
                         + ". The target node must be specified to retrieve the ShardSearchContextId."
                 );
             }
@@ -67,7 +67,7 @@ public void writeTo(StreamOutput out) throws IOException {
                 // We should never set a null search context id if the cluster is not fully upgraded to a version that can handle it.
                 throw new IOException(
                     "Cannot write null search context ID to a node in version "
-                        + out.getTransportVersion()
+                        + out.getTransportVersion().toReleaseVersion()
                         + ". A valid search context ID is required to identify the shard's search context in this version."
                 );
             }
diff --git a/server/src/main/java/org/elasticsearch/action/search/TransportOpenPointInTimeAction.java b/server/src/main/java/org/elasticsearch/action/search/TransportOpenPointInTimeAction.java
index 9e60eedbad6a2..36ca0fba94372 100644
--- a/server/src/main/java/org/elasticsearch/action/search/TransportOpenPointInTimeAction.java
+++ b/server/src/main/java/org/elasticsearch/action/search/TransportOpenPointInTimeAction.java
@@ -104,8 +104,7 @@ public TransportOpenPointInTimeAction(
     protected void doExecute(Task task, OpenPointInTimeRequest request, ActionListener<OpenPointInTimeResponse> listener) {
         final ClusterState clusterState = clusterService.state();
         // Check if all the nodes in this cluster know about the service
-        if (request.allowPartialSearchResults()
-            && clusterState.getMinTransportVersion().before(TransportVersions.ALLOW_PARTIAL_SEARCH_RESULTS_IN_PIT)) {
+        if (request.allowPartialSearchResults() && clusterState.getMinTransportVersion().before(TransportVersions.V_8_16_0)) {
             listener.onFailure(
                 new ElasticsearchStatusException(
                     format(
diff --git a/server/src/main/java/org/elasticsearch/action/support/IndicesOptions.java b/server/src/main/java/org/elasticsearch/action/support/IndicesOptions.java
index 85889d8398cb1..ebbd47336e3da 100644
--- a/server/src/main/java/org/elasticsearch/action/support/IndicesOptions.java
+++ b/server/src/main/java/org/elasticsearch/action/support/IndicesOptions.java
@@ -982,12 +982,11 @@ public void writeIndicesOptions(StreamOutput out) throws IOException {
             states.add(WildcardStates.HIDDEN);
         }
         out.writeEnumSet(states);
-        if (out.getTransportVersion()
-            .between(TransportVersions.V_8_14_0, TransportVersions.CONVERT_FAILURE_STORE_OPTIONS_TO_SELECTOR_OPTIONS_INTERNALLY)) {
+        if (out.getTransportVersion().between(TransportVersions.V_8_14_0, TransportVersions.V_8_16_0)) {
             out.writeBoolean(includeRegularIndices());
             out.writeBoolean(includeFailureIndices());
         }
-        if (out.getTransportVersion().onOrAfter(TransportVersions.CONVERT_FAILURE_STORE_OPTIONS_TO_SELECTOR_OPTIONS_INTERNALLY)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             selectorOptions.writeTo(out);
         }
     }
@@ -1010,8 +1009,7 @@ public static IndicesOptions readIndicesOptions(StreamInput in) throws IOExcepti
             .ignoreThrottled(options.contains(Option.IGNORE_THROTTLED))
             .build();
         SelectorOptions selectorOptions = SelectorOptions.DEFAULT;
-        if (in.getTransportVersion()
-            .between(TransportVersions.V_8_14_0, TransportVersions.CONVERT_FAILURE_STORE_OPTIONS_TO_SELECTOR_OPTIONS_INTERNALLY)) {
+        if (in.getTransportVersion().between(TransportVersions.V_8_14_0, TransportVersions.V_8_16_0)) {
             // Reading from an older node, which will be sending two booleans that we must read out and ignore.
             var includeData = in.readBoolean();
             var includeFailures = in.readBoolean();
@@ -1023,7 +1021,7 @@ public static IndicesOptions readIndicesOptions(StreamInput in) throws IOExcepti
                 selectorOptions = SelectorOptions.FAILURES;
             }
         }
-        if (in.getTransportVersion().onOrAfter(TransportVersions.CONVERT_FAILURE_STORE_OPTIONS_TO_SELECTOR_OPTIONS_INTERNALLY)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             selectorOptions = SelectorOptions.read(in);
         }
         return new IndicesOptions(
diff --git a/server/src/main/java/org/elasticsearch/cluster/health/ClusterIndexHealth.java b/server/src/main/java/org/elasticsearch/cluster/health/ClusterIndexHealth.java
index b6c1defe91a75..9cf567c219660 100644
--- a/server/src/main/java/org/elasticsearch/cluster/health/ClusterIndexHealth.java
+++ b/server/src/main/java/org/elasticsearch/cluster/health/ClusterIndexHealth.java
@@ -111,7 +111,7 @@ public ClusterIndexHealth(final StreamInput in) throws IOException {
         unassignedShards = in.readVInt();
         status = ClusterHealthStatus.readFrom(in);
         shards = in.readMapValues(ClusterShardHealth::new, ClusterShardHealth::getShardId);
-        if (in.getTransportVersion().onOrAfter(TransportVersions.UNASSIGNED_PRIMARY_COUNT_ON_CLUSTER_HEALTH)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             unassignedPrimaryShards = in.readVInt();
         } else {
             unassignedPrimaryShards = 0;
@@ -203,7 +203,7 @@ public void writeTo(final StreamOutput out) throws IOException {
         out.writeVInt(unassignedShards);
         out.writeByte(status.value());
         out.writeMapValues(shards);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.UNASSIGNED_PRIMARY_COUNT_ON_CLUSTER_HEALTH)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeVInt(unassignedPrimaryShards);
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/cluster/health/ClusterShardHealth.java b/server/src/main/java/org/elasticsearch/cluster/health/ClusterShardHealth.java
index 63863542564cd..f512acb6e04d0 100644
--- a/server/src/main/java/org/elasticsearch/cluster/health/ClusterShardHealth.java
+++ b/server/src/main/java/org/elasticsearch/cluster/health/ClusterShardHealth.java
@@ -96,7 +96,7 @@ public ClusterShardHealth(final StreamInput in) throws IOException {
         initializingShards = in.readVInt();
         unassignedShards = in.readVInt();
         primaryActive = in.readBoolean();
-        if (in.getTransportVersion().onOrAfter(TransportVersions.UNASSIGNED_PRIMARY_COUNT_ON_CLUSTER_HEALTH)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             unassignedPrimaryShards = in.readVInt();
         } else {
             unassignedPrimaryShards = 0;
@@ -167,7 +167,7 @@ public void writeTo(final StreamOutput out) throws IOException {
         out.writeVInt(initializingShards);
         out.writeVInt(unassignedShards);
         out.writeBoolean(primaryActive);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.UNASSIGNED_PRIMARY_COUNT_ON_CLUSTER_HEALTH)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeVInt(unassignedPrimaryShards);
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/cluster/health/ClusterStateHealth.java b/server/src/main/java/org/elasticsearch/cluster/health/ClusterStateHealth.java
index 579429b5d51dd..31f275e29c368 100644
--- a/server/src/main/java/org/elasticsearch/cluster/health/ClusterStateHealth.java
+++ b/server/src/main/java/org/elasticsearch/cluster/health/ClusterStateHealth.java
@@ -120,7 +120,7 @@ public ClusterStateHealth(final StreamInput in) throws IOException {
         status = ClusterHealthStatus.readFrom(in);
         indices = in.readMapValues(ClusterIndexHealth::new, ClusterIndexHealth::getIndex);
         activeShardsPercent = in.readDouble();
-        if (in.getTransportVersion().onOrAfter(TransportVersions.UNASSIGNED_PRIMARY_COUNT_ON_CLUSTER_HEALTH)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             unassignedPrimaryShards = in.readVInt();
         } else {
             unassignedPrimaryShards = 0;
@@ -212,7 +212,7 @@ public void writeTo(final StreamOutput out) throws IOException {
         out.writeByte(status.value());
         out.writeMapValues(indices);
         out.writeDouble(activeShardsPercent);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.UNASSIGNED_PRIMARY_COUNT_ON_CLUSTER_HEALTH)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeVInt(unassignedPrimaryShards);
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/DataStream.java b/server/src/main/java/org/elasticsearch/cluster/metadata/DataStream.java
index 4dcc7c73c280e..979434950cf7a 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/DataStream.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/DataStream.java
@@ -71,6 +71,7 @@ public final class DataStream implements SimpleDiffable<DataStream>, ToXContentO
     public static final FeatureFlag FAILURE_STORE_FEATURE_FLAG = new FeatureFlag("failure_store");
     public static final TransportVersion ADDED_FAILURE_STORE_TRANSPORT_VERSION = TransportVersions.V_8_12_0;
     public static final TransportVersion ADDED_AUTO_SHARDING_EVENT_VERSION = TransportVersions.V_8_14_0;
+    public static final TransportVersion ADD_DATA_STREAM_OPTIONS_VERSION = TransportVersions.V_8_16_0;
 
     public static boolean isFailureStoreFeatureFlagEnabled() {
         return FAILURE_STORE_FEATURE_FLAG.isEnabled();
@@ -200,9 +201,7 @@ public static DataStream read(StreamInput in) throws IOException {
             : null;
         // This boolean flag has been moved in data stream options
         var failureStoreEnabled = in.getTransportVersion()
-            .between(DataStream.ADDED_FAILURE_STORE_TRANSPORT_VERSION, TransportVersions.ADD_DATA_STREAM_OPTIONS)
-                ? in.readBoolean()
-                : false;
+            .between(DataStream.ADDED_FAILURE_STORE_TRANSPORT_VERSION, TransportVersions.V_8_16_0) ? in.readBoolean() : false;
         var failureIndices = in.getTransportVersion().onOrAfter(DataStream.ADDED_FAILURE_STORE_TRANSPORT_VERSION)
             ? readIndices(in)
             : List.<Index>of();
@@ -216,7 +215,7 @@ public static DataStream read(StreamInput in) throws IOException {
                 .setAutoShardingEvent(in.readOptionalWriteable(DataStreamAutoShardingEvent::new));
         }
         DataStreamOptions dataStreamOptions;
-        if (in.getTransportVersion().onOrAfter(TransportVersions.ADD_DATA_STREAM_OPTIONS)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             dataStreamOptions = in.readOptionalWriteable(DataStreamOptions::read);
         } else {
             // We cannot distinguish if failure store was explicitly disabled or not. Given that failure store
@@ -1077,7 +1076,7 @@ public void writeTo(StreamOutput out) throws IOException {
             out.writeOptionalWriteable(lifecycle);
         }
         if (out.getTransportVersion()
-            .between(DataStream.ADDED_FAILURE_STORE_TRANSPORT_VERSION, TransportVersions.ADD_DATA_STREAM_OPTIONS)) {
+            .between(DataStream.ADDED_FAILURE_STORE_TRANSPORT_VERSION, DataStream.ADD_DATA_STREAM_OPTIONS_VERSION)) {
             out.writeBoolean(isFailureStoreEnabled());
         }
         if (out.getTransportVersion().onOrAfter(DataStream.ADDED_FAILURE_STORE_TRANSPORT_VERSION)) {
@@ -1093,7 +1092,7 @@ public void writeTo(StreamOutput out) throws IOException {
             out.writeBoolean(failureIndices.rolloverOnWrite);
             out.writeOptionalWriteable(failureIndices.autoShardingEvent);
         }
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ADD_DATA_STREAM_OPTIONS)) {
+        if (out.getTransportVersion().onOrAfter(DataStream.ADD_DATA_STREAM_OPTIONS_VERSION)) {
             out.writeOptionalWriteable(dataStreamOptions.isEmpty() ? null : dataStreamOptions);
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/cluster/metadata/InferenceFieldMetadata.java b/server/src/main/java/org/elasticsearch/cluster/metadata/InferenceFieldMetadata.java
index 271c60e829a87..8917d5a9cbbb5 100644
--- a/server/src/main/java/org/elasticsearch/cluster/metadata/InferenceFieldMetadata.java
+++ b/server/src/main/java/org/elasticsearch/cluster/metadata/InferenceFieldMetadata.java
@@ -9,6 +9,7 @@
 
 package org.elasticsearch.cluster.metadata;
 
+import org.elasticsearch.TransportVersions;
 import org.elasticsearch.cluster.Diff;
 import org.elasticsearch.cluster.SimpleDiffable;
 import org.elasticsearch.common.io.stream.StreamInput;
@@ -23,8 +24,6 @@
 import java.util.List;
 import java.util.Objects;
 
-import static org.elasticsearch.TransportVersions.SEMANTIC_TEXT_SEARCH_INFERENCE_ID;
-
 /**
  * Contains inference field data for fields.
  * As inference is done in the coordinator node to avoid re-doing it at shard / replica level, the coordinator needs to check for the need
@@ -56,7 +55,7 @@ public InferenceFieldMetadata(String name, String inferenceId, String searchInfe
     public InferenceFieldMetadata(StreamInput input) throws IOException {
         this.name = input.readString();
         this.inferenceId = input.readString();
-        if (input.getTransportVersion().onOrAfter(SEMANTIC_TEXT_SEARCH_INFERENCE_ID)) {
+        if (input.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             this.searchInferenceId = input.readString();
         } else {
             this.searchInferenceId = this.inferenceId;
@@ -68,7 +67,7 @@ public InferenceFieldMetadata(StreamInput input) throws IOException {
     public void writeTo(StreamOutput out) throws IOException {
         out.writeString(name);
         out.writeString(inferenceId);
-        if (out.getTransportVersion().onOrAfter(SEMANTIC_TEXT_SEARCH_INFERENCE_ID)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeString(searchInferenceId);
         }
         out.writeStringArray(sourceFields);
diff --git a/server/src/main/java/org/elasticsearch/cluster/routing/RoutingTable.java b/server/src/main/java/org/elasticsearch/cluster/routing/RoutingTable.java
index 790b8e4ab75fa..60cf6b10417fa 100644
--- a/server/src/main/java/org/elasticsearch/cluster/routing/RoutingTable.java
+++ b/server/src/main/java/org/elasticsearch/cluster/routing/RoutingTable.java
@@ -317,7 +317,7 @@ public static Diff<RoutingTable> readDiffFrom(StreamInput in) throws IOException
 
     public static RoutingTable readFrom(StreamInput in) throws IOException {
         Builder builder = new Builder();
-        if (in.getTransportVersion().before(TransportVersions.ROUTING_TABLE_VERSION_REMOVED)) {
+        if (in.getTransportVersion().before(TransportVersions.V_8_16_0)) {
             in.readLong(); // previously 'version', unused in all applicable versions so any number will do
         }
         int size = in.readVInt();
@@ -331,7 +331,7 @@ public static RoutingTable readFrom(StreamInput in) throws IOException {
 
     @Override
     public void writeTo(StreamOutput out) throws IOException {
-        if (out.getTransportVersion().before(TransportVersions.ROUTING_TABLE_VERSION_REMOVED)) {
+        if (out.getTransportVersion().before(TransportVersions.V_8_16_0)) {
             out.writeLong(0); // previously 'version', unused in all applicable versions so any number will do
         }
         out.writeCollection(indicesRouting.values());
@@ -349,7 +349,7 @@ private static class RoutingTableDiff implements Diff<RoutingTable> {
             new DiffableUtils.DiffableValueReader<>(IndexRoutingTable::readFrom, IndexRoutingTable::readDiffFrom);
 
         RoutingTableDiff(StreamInput in) throws IOException {
-            if (in.getTransportVersion().before(TransportVersions.ROUTING_TABLE_VERSION_REMOVED)) {
+            if (in.getTransportVersion().before(TransportVersions.V_8_16_0)) {
                 in.readLong(); // previously 'version', unused in all applicable versions so any number will do
             }
             indicesRouting = DiffableUtils.readImmutableOpenMapDiff(in, DiffableUtils.getStringKeySerializer(), DIFF_VALUE_READER);
@@ -366,7 +366,7 @@ public RoutingTable apply(RoutingTable part) {
 
         @Override
         public void writeTo(StreamOutput out) throws IOException {
-            if (out.getTransportVersion().before(TransportVersions.ROUTING_TABLE_VERSION_REMOVED)) {
+            if (out.getTransportVersion().before(TransportVersions.V_8_16_0)) {
                 out.writeLong(0); // previously 'version', unused in all applicable versions so any number will do
             }
             indicesRouting.writeTo(out);
diff --git a/server/src/main/java/org/elasticsearch/common/io/stream/StreamInput.java b/server/src/main/java/org/elasticsearch/common/io/stream/StreamInput.java
index 644cc6bb69927..e07861ba05433 100644
--- a/server/src/main/java/org/elasticsearch/common/io/stream/StreamInput.java
+++ b/server/src/main/java/org/elasticsearch/common/io/stream/StreamInput.java
@@ -908,11 +908,8 @@ public final Instant readOptionalInstant() throws IOException {
     private ZonedDateTime readZonedDateTime() throws IOException {
         final String timeZoneId = readString();
         final Instant instant;
-        if (getTransportVersion().onOrAfter(TransportVersions.ZDT_NANOS_SUPPORT_BROKEN)) {
-            // epoch seconds can be negative, but it was incorrectly first written as vlong
-            boolean zlong = getTransportVersion().onOrAfter(TransportVersions.ZDT_NANOS_SUPPORT);
-            long seconds = zlong ? readZLong() : readVLong();
-            instant = Instant.ofEpochSecond(seconds, readInt());
+        if (getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
+            instant = Instant.ofEpochSecond(readZLong(), readInt());
         } else {
             instant = Instant.ofEpochMilli(readLong());
         }
diff --git a/server/src/main/java/org/elasticsearch/common/io/stream/StreamOutput.java b/server/src/main/java/org/elasticsearch/common/io/stream/StreamOutput.java
index d724e5ea25ca6..6738af32f04d6 100644
--- a/server/src/main/java/org/elasticsearch/common/io/stream/StreamOutput.java
+++ b/server/src/main/java/org/elasticsearch/common/io/stream/StreamOutput.java
@@ -768,13 +768,8 @@ public final void writeOptionalInstant(@Nullable Instant instant) throws IOExcep
             final ZonedDateTime zonedDateTime = (ZonedDateTime) v;
             o.writeString(zonedDateTime.getZone().getId());
             Instant instant = zonedDateTime.toInstant();
-            if (o.getTransportVersion().onOrAfter(TransportVersions.ZDT_NANOS_SUPPORT_BROKEN)) {
-                // epoch seconds can be negative, but it was incorrectly first written as vlong
-                if (o.getTransportVersion().onOrAfter(TransportVersions.ZDT_NANOS_SUPPORT)) {
-                    o.writeZLong(instant.getEpochSecond());
-                } else {
-                    o.writeVLong(instant.getEpochSecond());
-                }
+            if (o.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
+                o.writeZLong(instant.getEpochSecond());
                 o.writeInt(instant.getNano());
             } else {
                 o.writeLong(instant.toEpochMilli());
diff --git a/server/src/main/java/org/elasticsearch/index/engine/CommitStats.java b/server/src/main/java/org/elasticsearch/index/engine/CommitStats.java
index a871524b45e9e..520174a4b3638 100644
--- a/server/src/main/java/org/elasticsearch/index/engine/CommitStats.java
+++ b/server/src/main/java/org/elasticsearch/index/engine/CommitStats.java
@@ -46,7 +46,7 @@ public CommitStats(SegmentInfos segmentInfos) {
         generation = in.readLong();
         id = in.readOptionalString();
         numDocs = in.readInt();
-        numLeaves = in.getTransportVersion().onOrAfter(TransportVersions.SEGMENT_LEVEL_FIELDS_STATS) ? in.readVInt() : 0;
+        numLeaves = in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0) ? in.readVInt() : 0;
     }
 
     @Override
@@ -100,7 +100,7 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeLong(generation);
         out.writeOptionalString(id);
         out.writeInt(numDocs);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.SEGMENT_LEVEL_FIELDS_STATS)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeVInt(numLeaves);
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/index/mapper/NodeMappingStats.java b/server/src/main/java/org/elasticsearch/index/mapper/NodeMappingStats.java
index 56210a292995c..10b0856540399 100644
--- a/server/src/main/java/org/elasticsearch/index/mapper/NodeMappingStats.java
+++ b/server/src/main/java/org/elasticsearch/index/mapper/NodeMappingStats.java
@@ -52,7 +52,7 @@ public NodeMappingStats() {
     public NodeMappingStats(StreamInput in) throws IOException {
         totalCount = in.readVLong();
         totalEstimatedOverhead = in.readVLong();
-        if (in.getTransportVersion().onOrAfter(TransportVersions.SEGMENT_LEVEL_FIELDS_STATS)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             totalSegments = in.readVLong();
             totalSegmentFields = in.readVLong();
         }
@@ -93,7 +93,7 @@ public long getTotalSegmentFields() {
     public void writeTo(StreamOutput out) throws IOException {
         out.writeVLong(totalCount);
         out.writeVLong(totalEstimatedOverhead);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.SEGMENT_LEVEL_FIELDS_STATS)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeVLong(totalSegments);
             out.writeVLong(totalSegmentFields);
         }
diff --git a/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java b/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
index 647e45d1beda1..6ae0c4872cfa5 100644
--- a/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
+++ b/server/src/main/java/org/elasticsearch/index/query/IntervalsSourceProvider.java
@@ -825,7 +825,7 @@ public String getWriteableName() {
 
         @Override
         public TransportVersion getMinimalSupportedVersion() {
-            return TransportVersions.REGEX_AND_RANGE_INTERVAL_QUERIES;
+            return TransportVersions.V_8_16_0;
         }
 
         @Override
@@ -1129,7 +1129,7 @@ public String getWriteableName() {
 
         @Override
         public TransportVersion getMinimalSupportedVersion() {
-            return TransportVersions.REGEX_AND_RANGE_INTERVAL_QUERIES;
+            return TransportVersions.V_8_16_0;
         }
 
         @Override
diff --git a/server/src/main/java/org/elasticsearch/index/query/RankDocsQueryBuilder.java b/server/src/main/java/org/elasticsearch/index/query/RankDocsQueryBuilder.java
index 33077697a2ce6..889fa40b79aa1 100644
--- a/server/src/main/java/org/elasticsearch/index/query/RankDocsQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/RankDocsQueryBuilder.java
@@ -25,8 +25,6 @@
 import java.util.Map;
 import java.util.Objects;
 
-import static org.elasticsearch.TransportVersions.RRF_QUERY_REWRITE;
-
 public class RankDocsQueryBuilder extends AbstractQueryBuilder<RankDocsQueryBuilder> {
 
     public static final String NAME = "rank_docs_query";
@@ -44,7 +42,7 @@ public RankDocsQueryBuilder(RankDoc[] rankDocs, QueryBuilder[] queryBuilders, bo
     public RankDocsQueryBuilder(StreamInput in) throws IOException {
         super(in);
         this.rankDocs = in.readArray(c -> c.readNamedWriteable(RankDoc.class), RankDoc[]::new);
-        if (in.getTransportVersion().onOrAfter(RRF_QUERY_REWRITE)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             this.queryBuilders = in.readOptionalArray(c -> c.readNamedWriteable(QueryBuilder.class), QueryBuilder[]::new);
             this.onlyRankDocs = in.readBoolean();
         } else {
@@ -85,7 +83,7 @@ public RankDoc[] rankDocs() {
     @Override
     protected void doWriteTo(StreamOutput out) throws IOException {
         out.writeArray(StreamOutput::writeNamedWriteable, rankDocs);
-        if (out.getTransportVersion().onOrAfter(RRF_QUERY_REWRITE)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeOptionalArray(StreamOutput::writeNamedWriteable, queryBuilders);
             out.writeBoolean(onlyRankDocs);
         }
@@ -145,6 +143,6 @@ protected int doHashCode() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.RANK_DOCS_RETRIEVER;
+        return TransportVersions.V_8_16_0;
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/index/search/stats/SearchStats.java b/server/src/main/java/org/elasticsearch/index/search/stats/SearchStats.java
index ff514091979c3..8b19d72ccc09d 100644
--- a/server/src/main/java/org/elasticsearch/index/search/stats/SearchStats.java
+++ b/server/src/main/java/org/elasticsearch/index/search/stats/SearchStats.java
@@ -105,7 +105,7 @@ private Stats(StreamInput in) throws IOException {
             suggestTimeInMillis = in.readVLong();
             suggestCurrent = in.readVLong();
 
-            if (in.getTransportVersion().onOrAfter(TransportVersions.SEARCH_FAILURE_STATS)) {
+            if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 queryFailure = in.readVLong();
                 fetchFailure = in.readVLong();
             }
@@ -129,7 +129,7 @@ public void writeTo(StreamOutput out) throws IOException {
             out.writeVLong(suggestTimeInMillis);
             out.writeVLong(suggestCurrent);
 
-            if (out.getTransportVersion().onOrAfter(TransportVersions.SEARCH_FAILURE_STATS)) {
+            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 out.writeVLong(queryFailure);
                 out.writeVLong(fetchFailure);
             }
diff --git a/server/src/main/java/org/elasticsearch/inference/EmptySecretSettings.java b/server/src/main/java/org/elasticsearch/inference/EmptySecretSettings.java
index 9c666bd4a35f5..ee38273f13daf 100644
--- a/server/src/main/java/org/elasticsearch/inference/EmptySecretSettings.java
+++ b/server/src/main/java/org/elasticsearch/inference/EmptySecretSettings.java
@@ -44,7 +44,7 @@ public String getWriteableName() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ML_INFERENCE_EIS_INTEGRATION_ADDED;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/server/src/main/java/org/elasticsearch/inference/ModelConfigurations.java b/server/src/main/java/org/elasticsearch/inference/ModelConfigurations.java
index ebf32f0411555..53ce0bab63612 100644
--- a/server/src/main/java/org/elasticsearch/inference/ModelConfigurations.java
+++ b/server/src/main/java/org/elasticsearch/inference/ModelConfigurations.java
@@ -121,7 +121,7 @@ public ModelConfigurations(StreamInput in) throws IOException {
         this.service = in.readString();
         this.serviceSettings = in.readNamedWriteable(ServiceSettings.class);
         this.taskSettings = in.readNamedWriteable(TaskSettings.class);
-        this.chunkingSettings = in.getTransportVersion().onOrAfter(TransportVersions.ML_INFERENCE_CHUNKING_SETTINGS)
+        this.chunkingSettings = in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)
             ? in.readOptionalNamedWriteable(ChunkingSettings.class)
             : null;
     }
@@ -133,7 +133,7 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeString(service);
         out.writeNamedWriteable(serviceSettings);
         out.writeNamedWriteable(taskSettings);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ML_INFERENCE_CHUNKING_SETTINGS)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeOptionalNamedWriteable(chunkingSettings);
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/ingest/EnterpriseGeoIpTask.java b/server/src/main/java/org/elasticsearch/ingest/EnterpriseGeoIpTask.java
index e696c38b9f017..ff6a687da9b4d 100644
--- a/server/src/main/java/org/elasticsearch/ingest/EnterpriseGeoIpTask.java
+++ b/server/src/main/java/org/elasticsearch/ingest/EnterpriseGeoIpTask.java
@@ -64,7 +64,7 @@ public String getWriteableName() {
 
         @Override
         public TransportVersion getMinimalSupportedVersion() {
-            return TransportVersions.ENTERPRISE_GEOIP_DOWNLOADER;
+            return TransportVersions.V_8_16_0;
         }
 
         @Override
diff --git a/server/src/main/java/org/elasticsearch/search/DocValueFormat.java b/server/src/main/java/org/elasticsearch/search/DocValueFormat.java
index a1e8eb25f4780..f8d161ef1f5e5 100644
--- a/server/src/main/java/org/elasticsearch/search/DocValueFormat.java
+++ b/server/src/main/java/org/elasticsearch/search/DocValueFormat.java
@@ -263,7 +263,7 @@ private DateTime(DateFormatter formatter, ZoneId timeZone, DateFieldMapper.Resol
 
         private DateTime(StreamInput in) throws IOException {
             String formatterPattern = in.readString();
-            Locale locale = in.getTransportVersion().onOrAfter(TransportVersions.DATE_TIME_DOC_VALUES_LOCALES)
+            Locale locale = in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)
                 ? LocaleUtils.parse(in.readString())
                 : DateFieldMapper.DEFAULT_LOCALE;
             String zoneId = in.readString();
@@ -297,7 +297,7 @@ public static DateTime readFrom(StreamInput in) throws IOException {
         @Override
         public void writeTo(StreamOutput out) throws IOException {
             out.writeString(formatter.pattern());
-            if (out.getTransportVersion().onOrAfter(TransportVersions.DATE_TIME_DOC_VALUES_LOCALES)) {
+            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 out.writeString(formatter.locale().toString());
             }
             out.writeString(timeZone.getId());
diff --git a/server/src/main/java/org/elasticsearch/search/rank/RankDoc.java b/server/src/main/java/org/elasticsearch/search/rank/RankDoc.java
index 9ab14aa9362b5..d4127836a4e4a 100644
--- a/server/src/main/java/org/elasticsearch/search/rank/RankDoc.java
+++ b/server/src/main/java/org/elasticsearch/search/rank/RankDoc.java
@@ -44,7 +44,7 @@ public String getWriteableName() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.RANK_DOCS_RETRIEVER;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/server/src/main/java/org/elasticsearch/search/vectors/ExactKnnQueryBuilder.java b/server/src/main/java/org/elasticsearch/search/vectors/ExactKnnQueryBuilder.java
index c8670a8dfeec2..77d708432cf26 100644
--- a/server/src/main/java/org/elasticsearch/search/vectors/ExactKnnQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/vectors/ExactKnnQueryBuilder.java
@@ -55,8 +55,7 @@ public ExactKnnQueryBuilder(StreamInput in) throws IOException {
             this.query = VectorData.fromFloats(in.readFloatArray());
         }
         this.field = in.readString();
-        if (in.getTransportVersion().onOrAfter(TransportVersions.FIX_VECTOR_SIMILARITY_INNER_HITS)
-            || in.getTransportVersion().isPatchFrom(TransportVersions.V_8_15_0)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_15_0)) {
             this.vectorSimilarity = in.readOptionalFloat();
         } else {
             this.vectorSimilarity = null;
@@ -88,8 +87,7 @@ protected void doWriteTo(StreamOutput out) throws IOException {
             out.writeFloatArray(query.asFloatVector());
         }
         out.writeString(field);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.FIX_VECTOR_SIMILARITY_INNER_HITS)
-            || out.getTransportVersion().isPatchFrom(TransportVersions.V_8_15_0)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_15_0)) {
             out.writeOptionalFloat(vectorSimilarity);
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/search/vectors/KnnScoreDocQueryBuilder.java b/server/src/main/java/org/elasticsearch/search/vectors/KnnScoreDocQueryBuilder.java
index f52addefc8b1c..b5ba97906f0ec 100644
--- a/server/src/main/java/org/elasticsearch/search/vectors/KnnScoreDocQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/vectors/KnnScoreDocQueryBuilder.java
@@ -71,8 +71,7 @@ public KnnScoreDocQueryBuilder(StreamInput in) throws IOException {
             this.fieldName = null;
             this.queryVector = null;
         }
-        if (in.getTransportVersion().onOrAfter(TransportVersions.FIX_VECTOR_SIMILARITY_INNER_HITS)
-            || in.getTransportVersion().isPatchFrom(TransportVersions.V_8_15_0)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_15_0)) {
             this.vectorSimilarity = in.readOptionalFloat();
         } else {
             this.vectorSimilarity = null;
@@ -116,8 +115,7 @@ protected void doWriteTo(StreamOutput out) throws IOException {
                 out.writeBoolean(false);
             }
         }
-        if (out.getTransportVersion().onOrAfter(TransportVersions.FIX_VECTOR_SIMILARITY_INNER_HITS)
-            || out.getTransportVersion().isPatchFrom(TransportVersions.V_8_15_0)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_15_0)) {
             out.writeOptionalFloat(vectorSimilarity);
         }
     }
diff --git a/server/src/main/java/org/elasticsearch/snapshots/RegisteredPolicySnapshots.java b/server/src/main/java/org/elasticsearch/snapshots/RegisteredPolicySnapshots.java
index f34b876697473..231894875b7fa 100644
--- a/server/src/main/java/org/elasticsearch/snapshots/RegisteredPolicySnapshots.java
+++ b/server/src/main/java/org/elasticsearch/snapshots/RegisteredPolicySnapshots.java
@@ -101,7 +101,7 @@ public String getWriteableName() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.REGISTER_SLM_STATS;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
@@ -171,7 +171,7 @@ public void writeTo(StreamOutput out) throws IOException {
 
         @Override
         public TransportVersion getMinimalSupportedVersion() {
-            return TransportVersions.REGISTER_SLM_STATS;
+            return TransportVersions.V_8_16_0;
         }
     }
 
diff --git a/server/src/test/java/org/elasticsearch/TransportVersionTests.java b/server/src/test/java/org/elasticsearch/TransportVersionTests.java
index 6c2cc5c1f4cc0..08b12cec2e17e 100644
--- a/server/src/test/java/org/elasticsearch/TransportVersionTests.java
+++ b/server/src/test/java/org/elasticsearch/TransportVersionTests.java
@@ -211,7 +211,7 @@ public void testDenseTransportVersions() {
         Set<Integer> missingVersions = new TreeSet<>();
         TransportVersion previous = null;
         for (var tv : TransportVersions.getAllVersions()) {
-            if (tv.before(TransportVersions.V_8_15_2)) {
+            if (tv.before(TransportVersions.V_8_16_0)) {
                 continue;
             }
             if (previous == null) {
diff --git a/server/src/test/java/org/elasticsearch/action/admin/cluster/node/stats/NodesStatsRequestParametersTests.java b/server/src/test/java/org/elasticsearch/action/admin/cluster/node/stats/NodesStatsRequestParametersTests.java
index f37b1d1b41712..cfdbfdfbfcf8c 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/cluster/node/stats/NodesStatsRequestParametersTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/cluster/node/stats/NodesStatsRequestParametersTests.java
@@ -23,7 +23,7 @@
 public class NodesStatsRequestParametersTests extends ESTestCase {
 
     public void testReadWriteMetricSet() {
-        for (var version : List.of(TransportVersions.V_8_15_0, TransportVersions.NODES_STATS_ENUM_SET)) {
+        for (var version : List.of(TransportVersions.V_8_15_0, TransportVersions.V_8_16_0)) {
             var randSet = randomSubsetOf(Metric.ALL);
             var metricsOut = randSet.isEmpty() ? EnumSet.noneOf(Metric.class) : EnumSet.copyOf(randSet);
             try {
diff --git a/server/src/test/java/org/elasticsearch/action/admin/cluster/stats/SearchUsageStatsTests.java b/server/src/test/java/org/elasticsearch/action/admin/cluster/stats/SearchUsageStatsTests.java
index 89ccd4ab63d7f..46b757407e6a9 100644
--- a/server/src/test/java/org/elasticsearch/action/admin/cluster/stats/SearchUsageStatsTests.java
+++ b/server/src/test/java/org/elasticsearch/action/admin/cluster/stats/SearchUsageStatsTests.java
@@ -199,7 +199,7 @@ public void testSerializationBWC() throws IOException {
                 randomQueryUsage(QUERY_TYPES.size()),
                 version.onOrAfter(TransportVersions.V_8_12_0) ? randomRescorerUsage(RESCORER_TYPES.size()) : Map.of(),
                 randomSectionsUsage(SECTIONS.size()),
-                version.onOrAfter(TransportVersions.RETRIEVERS_TELEMETRY_ADDED) ? randomRetrieversUsage(RETRIEVERS.size()) : Map.of(),
+                version.onOrAfter(TransportVersions.V_8_16_0) ? randomRetrieversUsage(RETRIEVERS.size()) : Map.of(),
                 randomLongBetween(0, Long.MAX_VALUE)
             );
             assertSerialization(testInstance, version);
diff --git a/server/src/test/java/org/elasticsearch/common/io/stream/AbstractStreamTests.java b/server/src/test/java/org/elasticsearch/common/io/stream/AbstractStreamTests.java
index d2b6d0a6ec6d7..afaa7a9a32888 100644
--- a/server/src/test/java/org/elasticsearch/common/io/stream/AbstractStreamTests.java
+++ b/server/src/test/java/org/elasticsearch/common/io/stream/AbstractStreamTests.java
@@ -11,6 +11,7 @@
 
 import org.apache.lucene.util.BytesRef;
 import org.elasticsearch.TransportVersion;
+import org.elasticsearch.TransportVersions;
 import org.elasticsearch.common.CheckedBiConsumer;
 import org.elasticsearch.common.bytes.BytesArray;
 import org.elasticsearch.common.bytes.BytesReference;
@@ -53,8 +54,6 @@
 
 import static java.time.Instant.ofEpochSecond;
 import static java.time.ZonedDateTime.ofInstant;
-import static org.elasticsearch.TransportVersions.ZDT_NANOS_SUPPORT;
-import static org.elasticsearch.TransportVersions.ZDT_NANOS_SUPPORT_BROKEN;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.hasToString;
@@ -729,15 +728,11 @@ public void testReadAfterReachingEndOfStream() throws IOException {
     }
 
     public void testZonedDateTimeSerialization() throws IOException {
-        checkZonedDateTimeSerialization(ZDT_NANOS_SUPPORT);
-    }
-
-    public void testZonedDateTimeMillisBwcSerializationV1() throws IOException {
-        checkZonedDateTimeSerialization(TransportVersionUtils.getPreviousVersion(ZDT_NANOS_SUPPORT_BROKEN));
+        checkZonedDateTimeSerialization(TransportVersions.V_8_16_0);
     }
 
     public void testZonedDateTimeMillisBwcSerialization() throws IOException {
-        checkZonedDateTimeSerialization(TransportVersionUtils.getPreviousVersion(ZDT_NANOS_SUPPORT));
+        checkZonedDateTimeSerialization(TransportVersionUtils.getPreviousVersion(TransportVersions.V_8_16_0));
     }
 
     public void checkZonedDateTimeSerialization(TransportVersion tv) throws IOException {
@@ -745,12 +740,12 @@ public void checkZonedDateTimeSerialization(TransportVersion tv) throws IOExcept
         assertGenericRoundtrip(ofInstant(ofEpochSecond(1), randomZone()), tv);
         // just want to test a large number that will use 5+ bytes
         long maxEpochSecond = Integer.MAX_VALUE;
-        long minEpochSecond = tv.between(ZDT_NANOS_SUPPORT_BROKEN, ZDT_NANOS_SUPPORT) ? 0 : Integer.MIN_VALUE;
+        long minEpochSecond = Integer.MIN_VALUE;
         assertGenericRoundtrip(ofInstant(ofEpochSecond(maxEpochSecond), randomZone()), tv);
         assertGenericRoundtrip(ofInstant(ofEpochSecond(randomLongBetween(minEpochSecond, maxEpochSecond)), randomZone()), tv);
         assertGenericRoundtrip(ofInstant(ofEpochSecond(randomLongBetween(minEpochSecond, maxEpochSecond), 1_000_000), randomZone()), tv);
         assertGenericRoundtrip(ofInstant(ofEpochSecond(randomLongBetween(minEpochSecond, maxEpochSecond), 999_000_000), randomZone()), tv);
-        if (tv.onOrAfter(ZDT_NANOS_SUPPORT)) {
+        if (tv.onOrAfter(TransportVersions.V_8_16_0)) {
             assertGenericRoundtrip(
                 ofInstant(ofEpochSecond(randomLongBetween(minEpochSecond, maxEpochSecond), 999_999_999), randomZone()),
                 tv
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/datastreams/DataStreamLifecycleFeatureSetUsage.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/datastreams/DataStreamLifecycleFeatureSetUsage.java
index 7a31888a440c3..a61a86eea7104 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/datastreams/DataStreamLifecycleFeatureSetUsage.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/datastreams/DataStreamLifecycleFeatureSetUsage.java
@@ -111,7 +111,7 @@ public LifecycleStats(
         }
 
         public static LifecycleStats read(StreamInput in) throws IOException {
-            if (in.getTransportVersion().onOrAfter(TransportVersions.GLOBAL_RETENTION_TELEMETRY)) {
+            if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 return new LifecycleStats(
                     in.readVLong(),
                     in.readBoolean(),
@@ -139,7 +139,7 @@ public static LifecycleStats read(StreamInput in) throws IOException {
 
         @Override
         public void writeTo(StreamOutput out) throws IOException {
-            if (out.getTransportVersion().onOrAfter(TransportVersions.GLOBAL_RETENTION_TELEMETRY)) {
+            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 out.writeVLong(dataStreamsWithLifecyclesCount);
                 out.writeBoolean(defaultRolloverUsed);
                 dataRetentionStats.writeTo(out);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/enrich/action/EnrichStatsAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/enrich/action/EnrichStatsAction.java
index 0457de6edcc9f..36322ed6c6cbd 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/enrich/action/EnrichStatsAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/enrich/action/EnrichStatsAction.java
@@ -209,7 +209,7 @@ public CacheStats(StreamInput in) throws IOException {
                     in.readVLong(),
                     in.getTransportVersion().onOrAfter(TransportVersions.V_8_15_0) ? in.readLong() : -1,
                     in.getTransportVersion().onOrAfter(TransportVersions.V_8_15_0) ? in.readLong() : -1,
-                    in.getTransportVersion().onOrAfter(TransportVersions.ENRICH_CACHE_STATS_SIZE_ADDED) ? in.readLong() : -1
+                    in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0) ? in.readLong() : -1
                 );
             }
 
@@ -237,7 +237,7 @@ public void writeTo(StreamOutput out) throws IOException {
                     out.writeLong(hitsTimeInMillis);
                     out.writeLong(missesTimeInMillis);
                 }
-                if (out.getTransportVersion().onOrAfter(TransportVersions.ENRICH_CACHE_STATS_SIZE_ADDED)) {
+                if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                     out.writeLong(cacheSizeInBytes);
                 }
             }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/IndexLifecycleExplainResponse.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/IndexLifecycleExplainResponse.java
index 33402671a2236..5d635c97d9c8c 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/IndexLifecycleExplainResponse.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/IndexLifecycleExplainResponse.java
@@ -328,7 +328,7 @@ public IndexLifecycleExplainResponse(StreamInput in) throws IOException {
             } else {
                 indexCreationDate = null;
             }
-            if (in.getTransportVersion().onOrAfter(TransportVersions.RETAIN_ILM_STEP_INFO)) {
+            if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 previousStepInfo = in.readOptionalBytesReference();
             } else {
                 previousStepInfo = null;
@@ -379,7 +379,7 @@ public void writeTo(StreamOutput out) throws IOException {
             if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_1_0)) {
                 out.writeOptionalLong(indexCreationDate);
             }
-            if (out.getTransportVersion().onOrAfter(TransportVersions.RETAIN_ILM_STEP_INFO)) {
+            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 out.writeOptionalBytesReference(previousStepInfo);
             }
         }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/SearchableSnapshotAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/SearchableSnapshotAction.java
index c06dcc0f083d1..da64df2672bdb 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/SearchableSnapshotAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ilm/SearchableSnapshotAction.java
@@ -8,6 +8,7 @@
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
+import org.elasticsearch.TransportVersions;
 import org.elasticsearch.client.internal.Client;
 import org.elasticsearch.cluster.health.ClusterHealthStatus;
 import org.elasticsearch.cluster.metadata.IndexAbstraction;
@@ -32,7 +33,6 @@
 import java.util.List;
 import java.util.Objects;
 
-import static org.elasticsearch.TransportVersions.ILM_ADD_SEARCHABLE_SNAPSHOT_TOTAL_SHARDS_PER_NODE;
 import static org.elasticsearch.snapshots.SearchableSnapshotsSettings.SEARCHABLE_SNAPSHOTS_REPOSITORY_NAME_SETTING_KEY;
 import static org.elasticsearch.snapshots.SearchableSnapshotsSettings.SEARCHABLE_SNAPSHOTS_SNAPSHOT_NAME_SETTING_KEY;
 import static org.elasticsearch.snapshots.SearchableSnapshotsSettings.SEARCHABLE_SNAPSHOT_PARTIAL_SETTING_KEY;
@@ -102,9 +102,7 @@ public SearchableSnapshotAction(String snapshotRepository) {
     public SearchableSnapshotAction(StreamInput in) throws IOException {
         this.snapshotRepository = in.readString();
         this.forceMergeIndex = in.readBoolean();
-        this.totalShardsPerNode = in.getTransportVersion().onOrAfter(ILM_ADD_SEARCHABLE_SNAPSHOT_TOTAL_SHARDS_PER_NODE)
-            ? in.readOptionalInt()
-            : null;
+        this.totalShardsPerNode = in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0) ? in.readOptionalInt() : null;
     }
 
     boolean isForceMergeIndex() {
@@ -424,7 +422,7 @@ public String getWriteableName() {
     public void writeTo(StreamOutput out) throws IOException {
         out.writeString(snapshotRepository);
         out.writeBoolean(forceMergeIndex);
-        if (out.getTransportVersion().onOrAfter(ILM_ADD_SEARCHABLE_SNAPSHOT_TOTAL_SHARDS_PER_NODE)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeOptionalInt(totalShardsPerNode);
         }
     }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/DeleteInferenceEndpointAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/DeleteInferenceEndpointAction.java
index 226fe3630b387..c3f991a8b4e1e 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/DeleteInferenceEndpointAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/DeleteInferenceEndpointAction.java
@@ -127,7 +127,7 @@ public Response(StreamInput in) throws IOException {
                 pipelineIds = Set.of();
             }
 
-            if (in.getTransportVersion().onOrAfter(TransportVersions.ML_INFERENCE_DONT_DELETE_WHEN_SEMANTIC_TEXT_EXISTS)) {
+            if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 indexes = in.readCollectionAsSet(StreamInput::readString);
                 dryRunMessage = in.readOptionalString();
             } else {
@@ -143,7 +143,7 @@ public void writeTo(StreamOutput out) throws IOException {
             if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_15_0)) {
                 out.writeCollection(pipelineIds, StreamOutput::writeString);
             }
-            if (out.getTransportVersion().onOrAfter(TransportVersions.ML_INFERENCE_DONT_DELETE_WHEN_SEMANTIC_TEXT_EXISTS)) {
+            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 out.writeCollection(indexes, StreamOutput::writeString);
                 out.writeOptionalString(dryRunMessage);
             }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/GetInferenceModelAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/GetInferenceModelAction.java
index ea0462d0f103e..ba3d417d02672 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/GetInferenceModelAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/GetInferenceModelAction.java
@@ -63,7 +63,7 @@ public Request(StreamInput in) throws IOException {
             this.inferenceEntityId = in.readString();
             this.taskType = TaskType.fromStream(in);
             if (in.getTransportVersion().onOrAfter(TransportVersions.INFERENCE_DONT_PERSIST_ON_READ)
-                || in.getTransportVersion().isPatchFrom(TransportVersions.INFERENCE_DONT_PERSIST_ON_READ_BACKPORT_8_16)) {
+                || in.getTransportVersion().isPatchFrom(TransportVersions.V_8_16_0)) {
                 this.persistDefaultConfig = in.readBoolean();
             } else {
                 this.persistDefaultConfig = PERSIST_DEFAULT_CONFIGS;
@@ -89,7 +89,7 @@ public void writeTo(StreamOutput out) throws IOException {
             out.writeString(inferenceEntityId);
             taskType.writeTo(out);
             if (out.getTransportVersion().onOrAfter(TransportVersions.INFERENCE_DONT_PERSIST_ON_READ)
-                || out.getTransportVersion().isPatchFrom(TransportVersions.INFERENCE_DONT_PERSIST_ON_READ_BACKPORT_8_16)) {
+                || out.getTransportVersion().isPatchFrom(TransportVersions.V_8_16_0)) {
                 out.writeBoolean(this.persistDefaultConfig);
             }
         }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/MachineLearningFeatureSetUsage.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/MachineLearningFeatureSetUsage.java
index 0645299dfc30e..8c4611f05e72a 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/MachineLearningFeatureSetUsage.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/MachineLearningFeatureSetUsage.java
@@ -66,7 +66,7 @@ public MachineLearningFeatureSetUsage(StreamInput in) throws IOException {
         this.analyticsUsage = in.readGenericMap();
         this.inferenceUsage = in.readGenericMap();
         this.nodeCount = in.readInt();
-        if (in.getTransportVersion().onOrAfter(TransportVersions.ML_TELEMETRY_MEMORY_ADDED)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             this.memoryUsage = in.readGenericMap();
         } else {
             this.memoryUsage = Map.of();
@@ -86,7 +86,7 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeGenericMap(analyticsUsage);
         out.writeGenericMap(inferenceUsage);
         out.writeInt(nodeCount);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ML_TELEMETRY_MEMORY_ADDED)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeGenericMap(memoryUsage);
         }
     }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/CreateTrainedModelAssignmentAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/CreateTrainedModelAssignmentAction.java
index c6976ab4b513e..2aedb46347534 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/CreateTrainedModelAssignmentAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/CreateTrainedModelAssignmentAction.java
@@ -47,7 +47,7 @@ public Request(StartTrainedModelDeploymentAction.TaskParams taskParams, Adaptive
         public Request(StreamInput in) throws IOException {
             super(in);
             this.taskParams = new StartTrainedModelDeploymentAction.TaskParams(in);
-            if (in.getTransportVersion().onOrAfter(TransportVersions.INFERENCE_ADAPTIVE_ALLOCATIONS)) {
+            if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 this.adaptiveAllocationsSettings = in.readOptionalWriteable(AdaptiveAllocationsSettings::new);
             } else {
                 this.adaptiveAllocationsSettings = null;
@@ -63,7 +63,7 @@ public ActionRequestValidationException validate() {
         public void writeTo(StreamOutput out) throws IOException {
             super.writeTo(out);
             taskParams.writeTo(out);
-            if (out.getTransportVersion().onOrAfter(TransportVersions.INFERENCE_ADAPTIVE_ALLOCATIONS)) {
+            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 out.writeOptionalWriteable(adaptiveAllocationsSettings);
             }
         }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/StartTrainedModelDeploymentAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/StartTrainedModelDeploymentAction.java
index b298d486c9e03..1bf92262b30fb 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/StartTrainedModelDeploymentAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/StartTrainedModelDeploymentAction.java
@@ -169,7 +169,7 @@ public Request(StreamInput in) throws IOException {
             modelId = in.readString();
             timeout = in.readTimeValue();
             waitForState = in.readEnum(AllocationStatus.State.class);
-            if (in.getTransportVersion().onOrAfter(TransportVersions.INFERENCE_ADAPTIVE_ALLOCATIONS)) {
+            if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 numberOfAllocations = in.readOptionalVInt();
             } else {
                 numberOfAllocations = in.readVInt();
@@ -189,7 +189,7 @@ public Request(StreamInput in) throws IOException {
             } else {
                 this.deploymentId = modelId;
             }
-            if (in.getTransportVersion().onOrAfter(TransportVersions.INFERENCE_ADAPTIVE_ALLOCATIONS)) {
+            if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 this.adaptiveAllocationsSettings = in.readOptionalWriteable(AdaptiveAllocationsSettings::new);
             } else {
                 this.adaptiveAllocationsSettings = null;
@@ -297,7 +297,7 @@ public void writeTo(StreamOutput out) throws IOException {
             out.writeString(modelId);
             out.writeTimeValue(timeout);
             out.writeEnum(waitForState);
-            if (out.getTransportVersion().onOrAfter(TransportVersions.INFERENCE_ADAPTIVE_ALLOCATIONS)) {
+            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 out.writeOptionalVInt(numberOfAllocations);
             } else {
                 out.writeVInt(numberOfAllocations);
@@ -313,7 +313,7 @@ public void writeTo(StreamOutput out) throws IOException {
             if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_8_0)) {
                 out.writeString(deploymentId);
             }
-            if (out.getTransportVersion().onOrAfter(TransportVersions.INFERENCE_ADAPTIVE_ALLOCATIONS)) {
+            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 out.writeOptionalWriteable(adaptiveAllocationsSettings);
             }
         }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/UpdateTrainedModelDeploymentAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/UpdateTrainedModelDeploymentAction.java
index cb578fdb157de..2018c9526ec83 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/UpdateTrainedModelDeploymentAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/action/UpdateTrainedModelDeploymentAction.java
@@ -87,7 +87,7 @@ public Request(String deploymentId) {
         public Request(StreamInput in) throws IOException {
             super(in);
             deploymentId = in.readString();
-            if (in.getTransportVersion().before(TransportVersions.INFERENCE_ADAPTIVE_ALLOCATIONS)) {
+            if (in.getTransportVersion().before(TransportVersions.V_8_16_0)) {
                 numberOfAllocations = in.readVInt();
                 adaptiveAllocationsSettings = null;
                 isInternal = false;
@@ -134,7 +134,7 @@ public AdaptiveAllocationsSettings getAdaptiveAllocationsSettings() {
         public void writeTo(StreamOutput out) throws IOException {
             super.writeTo(out);
             out.writeString(deploymentId);
-            if (out.getTransportVersion().before(TransportVersions.INFERENCE_ADAPTIVE_ALLOCATIONS)) {
+            if (out.getTransportVersion().before(TransportVersions.V_8_16_0)) {
                 out.writeVInt(numberOfAllocations);
             } else {
                 out.writeOptionalVInt(numberOfAllocations);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/calendars/ScheduledEvent.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/calendars/ScheduledEvent.java
index b007c1da451f5..742daa1bf6137 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/calendars/ScheduledEvent.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/calendars/ScheduledEvent.java
@@ -115,7 +115,7 @@ public ScheduledEvent(StreamInput in) throws IOException {
         description = in.readString();
         startTime = in.readInstant();
         endTime = in.readInstant();
-        if (in.getTransportVersion().onOrAfter(TransportVersions.ML_SCHEDULED_EVENT_TIME_SHIFT_CONFIGURATION)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             skipResult = in.readBoolean();
             skipModelUpdate = in.readBoolean();
             forceTimeShift = in.readOptionalInt();
@@ -204,7 +204,7 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeString(description);
         out.writeInstant(startTime);
         out.writeInstant(endTime);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ML_SCHEDULED_EVENT_TIME_SHIFT_CONFIGURATION)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeBoolean(skipResult);
             out.writeBoolean(skipModelUpdate);
             out.writeOptionalInt(forceTimeShift);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/assignment/AssignmentStats.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/assignment/AssignmentStats.java
index 858d97bf6f956..31b513eea161e 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/assignment/AssignmentStats.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/assignment/AssignmentStats.java
@@ -483,7 +483,7 @@ public AssignmentStats(StreamInput in) throws IOException {
         } else {
             deploymentId = modelId;
         }
-        if (in.getTransportVersion().onOrAfter(TransportVersions.INFERENCE_ADAPTIVE_ALLOCATIONS)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             adaptiveAllocationsSettings = in.readOptionalWriteable(AdaptiveAllocationsSettings::new);
         } else {
             adaptiveAllocationsSettings = null;
@@ -666,7 +666,7 @@ public void writeTo(StreamOutput out) throws IOException {
         if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_8_0)) {
             out.writeString(deploymentId);
         }
-        if (out.getTransportVersion().onOrAfter(TransportVersions.INFERENCE_ADAPTIVE_ALLOCATIONS)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeOptionalWriteable(adaptiveAllocationsSettings);
         }
     }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/assignment/TrainedModelAssignment.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/assignment/TrainedModelAssignment.java
index efd07cceae09b..249e27d6f25e0 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/assignment/TrainedModelAssignment.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/assignment/TrainedModelAssignment.java
@@ -178,7 +178,7 @@ public TrainedModelAssignment(StreamInput in) throws IOException {
         } else {
             this.maxAssignedAllocations = totalCurrentAllocations();
         }
-        if (in.getTransportVersion().onOrAfter(TransportVersions.INFERENCE_ADAPTIVE_ALLOCATIONS)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             this.adaptiveAllocationsSettings = in.readOptionalWriteable(AdaptiveAllocationsSettings::new);
         } else {
             this.adaptiveAllocationsSettings = null;
@@ -382,7 +382,7 @@ public void writeTo(StreamOutput out) throws IOException {
         if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_4_0)) {
             out.writeVInt(maxAssignedAllocations);
         }
-        if (out.getTransportVersion().onOrAfter(TransportVersions.INFERENCE_ADAPTIVE_ALLOCATIONS)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeOptionalWriteable(adaptiveAllocationsSettings);
         }
     }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/LearningToRankConfig.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/LearningToRankConfig.java
index 9929e59a9c803..a4d7c9c7fa08f 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/LearningToRankConfig.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/inference/trainedmodel/LearningToRankConfig.java
@@ -41,7 +41,6 @@
 public class LearningToRankConfig extends RegressionConfig implements Rewriteable<LearningToRankConfig> {
 
     public static final ParseField NAME = new ParseField("learning_to_rank");
-    static final TransportVersion MIN_SUPPORTED_TRANSPORT_VERSION = TransportVersions.LTR_SERVERLESS_RELEASE;
     public static final ParseField NUM_TOP_FEATURE_IMPORTANCE_VALUES = new ParseField("num_top_feature_importance_values");
     public static final ParseField FEATURE_EXTRACTORS = new ParseField("feature_extractors");
     public static final ParseField DEFAULT_PARAMS = new ParseField("default_params");
@@ -226,7 +225,7 @@ public MlConfigVersion getMinimalSupportedMlConfigVersion() {
 
     @Override
     public TransportVersion getMinimalSupportedTransportVersion() {
-        return MIN_SUPPORTED_TRANSPORT_VERSION;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/config/DetectionRule.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/config/DetectionRule.java
index eb952a7dc7e5c..4bdced325311f 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/config/DetectionRule.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/ml/job/config/DetectionRule.java
@@ -68,7 +68,7 @@ public DetectionRule(StreamInput in) throws IOException {
         actions = in.readEnumSet(RuleAction.class);
         scope = new RuleScope(in);
         conditions = in.readCollectionAsList(RuleCondition::new);
-        if (in.getTransportVersion().onOrAfter(TransportVersions.ML_ADD_DETECTION_RULE_PARAMS)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             params = new RuleParams(in);
         } else {
             params = new RuleParams();
@@ -80,7 +80,7 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeEnumSet(actions);
         scope.writeTo(out);
         out.writeCollection(conditions);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ML_ADD_DETECTION_RULE_PARAMS)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             params.writeTo(out);
         }
     }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/privilege/ConfigurableClusterPrivileges.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/privilege/ConfigurableClusterPrivileges.java
index b93aa079a28d2..148fdf21fd2df 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/privilege/ConfigurableClusterPrivileges.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/privilege/ConfigurableClusterPrivileges.java
@@ -82,7 +82,7 @@ public static ConfigurableClusterPrivilege[] readArray(StreamInput in) throws IO
      * Utility method to write an array of {@link ConfigurableClusterPrivilege} objects to a {@link StreamOutput}
      */
     public static void writeArray(StreamOutput out, ConfigurableClusterPrivilege[] privileges) throws IOException {
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ADD_MANAGE_ROLES_PRIVILEGE)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeArray(WRITER, privileges);
         } else {
             out.writeArray(
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/MachineLearningFeatureSetUsageTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/MachineLearningFeatureSetUsageTests.java
index 87d658c6f983c..e9ec8dfe8ee52 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/MachineLearningFeatureSetUsageTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/ml/MachineLearningFeatureSetUsageTests.java
@@ -57,7 +57,7 @@ protected MachineLearningFeatureSetUsage mutateInstance(MachineLearningFeatureSe
 
     @Override
     protected MachineLearningFeatureSetUsage mutateInstanceForVersion(MachineLearningFeatureSetUsage instance, TransportVersion version) {
-        if (version.before(TransportVersions.ML_TELEMETRY_MEMORY_ADDED)) {
+        if (version.before(TransportVersions.V_8_16_0)) {
             return new MachineLearningFeatureSetUsage(
                 instance.available(),
                 instance.enabled(),
diff --git a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/rules/QueryRulesetListItem.java b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/rules/QueryRulesetListItem.java
index 3a61c848d3813..d694b2681ee88 100644
--- a/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/rules/QueryRulesetListItem.java
+++ b/x-pack/plugin/ent-search/src/main/java/org/elasticsearch/xpack/application/rules/QueryRulesetListItem.java
@@ -68,8 +68,7 @@ public QueryRulesetListItem(StreamInput in) throws IOException {
             this.criteriaTypeToCountMap = Map.of();
         }
         TransportVersion streamTransportVersion = in.getTransportVersion();
-        if (streamTransportVersion.isPatchFrom(TransportVersions.QUERY_RULES_LIST_INCLUDES_TYPES_BACKPORT_8_15)
-            || streamTransportVersion.isPatchFrom(TransportVersions.QUERY_RULES_LIST_INCLUDES_TYPES_BACKPORT_8_16)
+        if (streamTransportVersion.isPatchFrom(TransportVersions.QUERY_RULES_LIST_INCLUDES_TYPES_BACKPORT_8_16)
             || streamTransportVersion.onOrAfter(TransportVersions.QUERY_RULES_LIST_INCLUDES_TYPES)) {
             this.ruleTypeToCountMap = in.readMap(m -> in.readEnum(QueryRule.QueryRuleType.class), StreamInput::readInt);
         } else {
@@ -104,8 +103,7 @@ public void writeTo(StreamOutput out) throws IOException {
             out.writeMap(criteriaTypeToCountMap, StreamOutput::writeEnum, StreamOutput::writeInt);
         }
         TransportVersion streamTransportVersion = out.getTransportVersion();
-        if (streamTransportVersion.isPatchFrom(TransportVersions.QUERY_RULES_LIST_INCLUDES_TYPES_BACKPORT_8_15)
-            || streamTransportVersion.isPatchFrom(TransportVersions.QUERY_RULES_LIST_INCLUDES_TYPES_BACKPORT_8_16)
+        if (streamTransportVersion.isPatchFrom(TransportVersions.QUERY_RULES_LIST_INCLUDES_TYPES_BACKPORT_8_16)
             || streamTransportVersion.onOrAfter(TransportVersions.QUERY_RULES_LIST_INCLUDES_TYPES)) {
             out.writeMap(ruleTypeToCountMap, StreamOutput::writeEnum, StreamOutput::writeInt);
         }
diff --git a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/rules/action/ListQueryRulesetsActionResponseBWCSerializingTests.java b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/rules/action/ListQueryRulesetsActionResponseBWCSerializingTests.java
index 27d5e240534b2..c822dd123d3f8 100644
--- a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/rules/action/ListQueryRulesetsActionResponseBWCSerializingTests.java
+++ b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/rules/action/ListQueryRulesetsActionResponseBWCSerializingTests.java
@@ -59,8 +59,7 @@ protected ListQueryRulesetsAction.Response mutateInstanceForVersion(
         ListQueryRulesetsAction.Response instance,
         TransportVersion version
     ) {
-        if (version.isPatchFrom(TransportVersions.QUERY_RULES_LIST_INCLUDES_TYPES_BACKPORT_8_15)
-            || version.isPatchFrom(TransportVersions.QUERY_RULES_LIST_INCLUDES_TYPES_BACKPORT_8_16)
+        if (version.isPatchFrom(TransportVersions.QUERY_RULES_LIST_INCLUDES_TYPES_BACKPORT_8_16)
             || version.onOrAfter(TransportVersions.QUERY_RULES_LIST_INCLUDES_TYPES)) {
             return instance;
         } else if (version.onOrAfter(QueryRulesetListItem.EXPANDED_RULESET_COUNT_TRANSPORT_VERSION)) {
diff --git a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/rules/action/TestQueryRulesetActionRequestBWCSerializingTests.java b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/rules/action/TestQueryRulesetActionRequestBWCSerializingTests.java
index 7041de1106b50..8582ee1bd8d24 100644
--- a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/rules/action/TestQueryRulesetActionRequestBWCSerializingTests.java
+++ b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/rules/action/TestQueryRulesetActionRequestBWCSerializingTests.java
@@ -51,6 +51,6 @@ protected TestQueryRulesetAction.Request mutateInstanceForVersion(TestQueryRules
 
     @Override
     protected List<TransportVersion> bwcVersions() {
-        return getAllBWCVersions().stream().filter(v -> v.onOrAfter(TransportVersions.QUERY_RULE_TEST_API)).collect(Collectors.toList());
+        return getAllBWCVersions().stream().filter(v -> v.onOrAfter(TransportVersions.V_8_16_0)).collect(Collectors.toList());
     }
 }
diff --git a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/rules/action/TestQueryRulesetActionResponseBWCSerializingTests.java b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/rules/action/TestQueryRulesetActionResponseBWCSerializingTests.java
index a6562fb7b52af..142310ac40332 100644
--- a/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/rules/action/TestQueryRulesetActionResponseBWCSerializingTests.java
+++ b/x-pack/plugin/ent-search/src/test/java/org/elasticsearch/xpack/application/rules/action/TestQueryRulesetActionResponseBWCSerializingTests.java
@@ -47,6 +47,6 @@ protected TestQueryRulesetAction.Response mutateInstanceForVersion(TestQueryRule
 
     @Override
     protected List<TransportVersion> bwcVersions() {
-        return getAllBWCVersions().stream().filter(v -> v.onOrAfter(TransportVersions.QUERY_RULE_TEST_API)).collect(Collectors.toList());
+        return getAllBWCVersions().stream().filter(v -> v.onOrAfter(TransportVersions.V_8_16_0)).collect(Collectors.toList());
     }
 }
diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/type/EsField.java b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/type/EsField.java
index 47dadcbb11de2..73e2d5ec626ac 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/type/EsField.java
+++ b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/type/EsField.java
@@ -72,7 +72,7 @@ public EsField(StreamInput in) throws IOException {
 
     private DataType readDataType(StreamInput in) throws IOException {
         String name = readCachedStringWithVersionCheck(in);
-        if (in.getTransportVersion().before(TransportVersions.ESQL_NESTED_UNSUPPORTED) && name.equalsIgnoreCase("NESTED")) {
+        if (in.getTransportVersion().before(TransportVersions.V_8_16_0) && name.equalsIgnoreCase("NESTED")) {
             /*
              * The "nested" data type existed in older versions of ESQL but was
              * entirely used to filter mappings away. Those versions will still
diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/util/PlanStreamInput.java b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/util/PlanStreamInput.java
index e8ccae3429001..b570a50535a59 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/util/PlanStreamInput.java
+++ b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/util/PlanStreamInput.java
@@ -52,7 +52,7 @@ public interface PlanStreamInput {
     String readCachedString() throws IOException;
 
     static String readCachedStringWithVersionCheck(StreamInput planStreamInput) throws IOException {
-        if (planStreamInput.getTransportVersion().before(TransportVersions.ESQL_CACHED_STRING_SERIALIZATION)) {
+        if (planStreamInput.getTransportVersion().before(TransportVersions.V_8_16_0)) {
             return planStreamInput.readString();
         }
         return ((PlanStreamInput) planStreamInput).readCachedString();
diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/util/PlanStreamOutput.java b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/util/PlanStreamOutput.java
index fb4af33d2fd60..a5afcb5fa29a6 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/util/PlanStreamOutput.java
+++ b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/util/PlanStreamOutput.java
@@ -37,7 +37,7 @@ public interface PlanStreamOutput {
     void writeCachedString(String field) throws IOException;
 
     static void writeCachedStringWithVersionCheck(StreamOutput planStreamOutput, String string) throws IOException {
-        if (planStreamOutput.getTransportVersion().before(TransportVersions.ESQL_CACHED_STRING_SERIALIZATION)) {
+        if (planStreamOutput.getTransportVersion().before(TransportVersions.V_8_16_0)) {
             planStreamOutput.writeString(string);
         } else {
             ((PlanStreamOutput) planStreamOutput).writeCachedString(string);
diff --git a/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/AggregationOperator.java b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/AggregationOperator.java
index 9338077a55570..f57f450c7ee39 100644
--- a/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/AggregationOperator.java
+++ b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/AggregationOperator.java
@@ -219,7 +219,7 @@ public Status(long aggregationNanos, long aggregationFinishNanos, int pagesProce
 
         protected Status(StreamInput in) throws IOException {
             aggregationNanos = in.readVLong();
-            if (in.getTransportVersion().onOrAfter(TransportVersions.ESQL_AGGREGATION_OPERATOR_STATUS_FINISH_NANOS)) {
+            if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 aggregationFinishNanos = in.readOptionalVLong();
             } else {
                 aggregationFinishNanos = null;
@@ -230,7 +230,7 @@ protected Status(StreamInput in) throws IOException {
         @Override
         public void writeTo(StreamOutput out) throws IOException {
             out.writeVLong(aggregationNanos);
-            if (out.getTransportVersion().onOrAfter(TransportVersions.ESQL_AGGREGATION_OPERATOR_STATUS_FINISH_NANOS)) {
+            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 out.writeOptionalVLong(aggregationFinishNanos);
             }
             out.writeVInt(pagesProcessed);
diff --git a/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/DriverProfile.java b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/DriverProfile.java
index d98613f1817ab..c071b5055df76 100644
--- a/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/DriverProfile.java
+++ b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/DriverProfile.java
@@ -79,7 +79,7 @@ public DriverProfile(
     }
 
     public DriverProfile(StreamInput in) throws IOException {
-        if (in.getTransportVersion().onOrAfter(TransportVersions.ESQL_PROFILE_SLEEPS)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             this.startMillis = in.readVLong();
             this.stopMillis = in.readVLong();
         } else {
@@ -101,7 +101,7 @@ public DriverProfile(StreamInput in) throws IOException {
 
     @Override
     public void writeTo(StreamOutput out) throws IOException {
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ESQL_PROFILE_SLEEPS)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeVLong(startMillis);
             out.writeVLong(stopMillis);
         }
diff --git a/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/DriverSleeps.java b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/DriverSleeps.java
index 01e9a73c4fb5f..d8856ebedb80b 100644
--- a/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/DriverSleeps.java
+++ b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/DriverSleeps.java
@@ -76,7 +76,7 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
     static final int RECORDS = 10;
 
     public static DriverSleeps read(StreamInput in) throws IOException {
-        if (in.getTransportVersion().before(TransportVersions.ESQL_PROFILE_SLEEPS)) {
+        if (in.getTransportVersion().before(TransportVersions.V_8_16_0)) {
             return empty();
         }
         return new DriverSleeps(
@@ -88,7 +88,7 @@ public static DriverSleeps read(StreamInput in) throws IOException {
 
     @Override
     public void writeTo(StreamOutput out) throws IOException {
-        if (out.getTransportVersion().before(TransportVersions.ESQL_PROFILE_SLEEPS)) {
+        if (out.getTransportVersion().before(TransportVersions.V_8_16_0)) {
             return;
         }
         out.writeMap(counts, StreamOutput::writeVLong);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlExecutionInfo.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlExecutionInfo.java
index ba7a7e8266845..52170dfb05256 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlExecutionInfo.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlExecutionInfo.java
@@ -107,7 +107,7 @@ public EsqlExecutionInfo(StreamInput in) throws IOException {
             clusterList.forEach(c -> m.put(c.getClusterAlias(), c));
             this.clusterInfo = m;
         }
-        if (in.getTransportVersion().onOrAfter(TransportVersions.OPT_IN_ESQL_CCS_EXECUTION_INFO)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             this.includeCCSMetadata = in.readBoolean();
         } else {
             this.includeCCSMetadata = false;
@@ -124,7 +124,7 @@ public void writeTo(StreamOutput out) throws IOException {
         } else {
             out.writeCollection(Collections.emptyList());
         }
-        if (out.getTransportVersion().onOrAfter(TransportVersions.OPT_IN_ESQL_CCS_EXECUTION_INFO)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeBoolean(includeCCSMetadata);
         }
     }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlQueryResponse.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlQueryResponse.java
index 77aed298baea5..dc0e9fd1fb06d 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlQueryResponse.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlQueryResponse.java
@@ -113,7 +113,7 @@ static EsqlQueryResponse deserialize(BlockStreamInput in) throws IOException {
         }
         boolean columnar = in.readBoolean();
         EsqlExecutionInfo executionInfo = null;
-        if (in.getTransportVersion().onOrAfter(TransportVersions.ESQL_CCS_EXECUTION_INFO)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             executionInfo = in.readOptionalWriteable(EsqlExecutionInfo::new);
         }
         return new EsqlQueryResponse(columns, pages, profile, columnar, asyncExecutionId, isRunning, isAsync, executionInfo);
@@ -132,7 +132,7 @@ public void writeTo(StreamOutput out) throws IOException {
             out.writeOptionalWriteable(profile);
         }
         out.writeBoolean(columnar);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ESQL_CCS_EXECUTION_INFO)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeOptionalWriteable(executionInfo);
         }
     }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlResolveFieldsAction.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlResolveFieldsAction.java
index f7e6793fc4fb3..f7fd991a9ef16 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlResolveFieldsAction.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlResolveFieldsAction.java
@@ -58,7 +58,7 @@ void executeRemoteRequest(
         ActionListener<FieldCapabilitiesResponse> remoteListener
     ) {
         remoteClient.getConnection(remoteRequest, remoteListener.delegateFailure((l, conn) -> {
-            var remoteAction = conn.getTransportVersion().onOrAfter(TransportVersions.ESQL_ORIGINAL_INDICES)
+            var remoteAction = conn.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)
                 ? RESOLVE_REMOTE_TYPE
                 : TransportFieldCapabilitiesAction.REMOTE_TYPE;
             remoteClient.execute(conn, remoteAction, remoteRequest, l);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/enrich/ResolvedEnrichPolicy.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/enrich/ResolvedEnrichPolicy.java
index e891089aa55b5..64595e776a96e 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/enrich/ResolvedEnrichPolicy.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/enrich/ResolvedEnrichPolicy.java
@@ -35,8 +35,7 @@ public ResolvedEnrichPolicy(StreamInput in) throws IOException {
     }
 
     private static Reader<EsField> getEsFieldReader(StreamInput in) {
-        if (in.getTransportVersion().onOrAfter(TransportVersions.ESQL_ES_FIELD_CACHED_SERIALIZATION)
-            || in.getTransportVersion().isPatchFrom(TransportVersions.V_8_15_2)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_15_2)) {
             return EsField::readFrom;
         }
         return EsField::new;
@@ -56,8 +55,7 @@ public void writeTo(StreamOutput out) throws IOException {
              */
             (o, v) -> {
                 var field = new EsField(v.getName(), v.getDataType(), v.getProperties(), v.isAggregatable(), v.isAlias());
-                if (out.getTransportVersion().onOrAfter(TransportVersions.ESQL_ES_FIELD_CACHED_SERIALIZATION)
-                    || out.getTransportVersion().isPatchFrom(TransportVersions.V_8_15_2)) {
+                if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_15_2)) {
                     field.writeTo(o);
                 } else {
                     field.writeContent(o);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/UnsupportedAttribute.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/UnsupportedAttribute.java
index d372eddb961ae..089f6db373c54 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/UnsupportedAttribute.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/UnsupportedAttribute.java
@@ -81,8 +81,7 @@ private UnsupportedAttribute(StreamInput in) throws IOException {
         this(
             Source.readFrom((PlanStreamInput) in),
             readCachedStringWithVersionCheck(in),
-            in.getTransportVersion().onOrAfter(TransportVersions.ESQL_ES_FIELD_CACHED_SERIALIZATION)
-                || in.getTransportVersion().isPatchFrom(TransportVersions.V_8_15_2) ? EsField.readFrom(in) : new UnsupportedEsField(in),
+            in.getTransportVersion().onOrAfter(TransportVersions.V_8_15_2) ? EsField.readFrom(in) : new UnsupportedEsField(in),
             in.readOptionalString(),
             NameId.readFrom((PlanStreamInput) in)
         );
@@ -93,8 +92,7 @@ public void writeTo(StreamOutput out) throws IOException {
         if (((PlanStreamOutput) out).writeAttributeCacheHeader(this)) {
             Source.EMPTY.writeTo(out);
             writeCachedStringWithVersionCheck(out, name());
-            if (out.getTransportVersion().onOrAfter(TransportVersions.ESQL_ES_FIELD_CACHED_SERIALIZATION)
-                || out.getTransportVersion().isPatchFrom(TransportVersions.V_8_15_2)) {
+            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_15_2)) {
                 field().writeTo(out);
             } else {
                 field().writeContent(out);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/AggregateFunction.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/AggregateFunction.java
index 87efccfc90ab3..265b08de5556d 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/AggregateFunction.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/AggregateFunction.java
@@ -53,10 +53,8 @@ protected AggregateFunction(StreamInput in) throws IOException {
         this(
             Source.readFrom((PlanStreamInput) in),
             in.readNamedWriteable(Expression.class),
-            in.getTransportVersion().onOrAfter(TransportVersions.ESQL_PER_AGGREGATE_FILTER)
-                ? in.readNamedWriteable(Expression.class)
-                : Literal.TRUE,
-            in.getTransportVersion().onOrAfter(TransportVersions.ESQL_PER_AGGREGATE_FILTER)
+            in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0) ? in.readNamedWriteable(Expression.class) : Literal.TRUE,
+            in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)
                 ? in.readNamedWriteableCollectionAsList(Expression.class)
                 : emptyList()
         );
@@ -66,7 +64,7 @@ protected AggregateFunction(StreamInput in) throws IOException {
     public final void writeTo(StreamOutput out) throws IOException {
         Source.EMPTY.writeTo(out);
         out.writeNamedWriteable(field);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ESQL_PER_AGGREGATE_FILTER)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeNamedWriteable(filter);
             out.writeNamedWriteableCollection(parameters);
         } else {
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/CountDistinct.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/CountDistinct.java
index 2e45b1c1fe082..7436db9e00dd2 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/CountDistinct.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/CountDistinct.java
@@ -147,10 +147,8 @@ private CountDistinct(StreamInput in) throws IOException {
         this(
             Source.readFrom((PlanStreamInput) in),
             in.readNamedWriteable(Expression.class),
-            in.getTransportVersion().onOrAfter(TransportVersions.ESQL_PER_AGGREGATE_FILTER)
-                ? in.readNamedWriteable(Expression.class)
-                : Literal.TRUE,
-            in.getTransportVersion().onOrAfter(TransportVersions.ESQL_PER_AGGREGATE_FILTER)
+            in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0) ? in.readNamedWriteable(Expression.class) : Literal.TRUE,
+            in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)
                 ? in.readNamedWriteableCollectionAsList(Expression.class)
                 : nullSafeList(in.readOptionalNamedWriteable(Expression.class))
         );
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/FromPartial.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/FromPartial.java
index 0f9037a28d7d7..a67b87c7617c4 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/FromPartial.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/FromPartial.java
@@ -58,10 +58,8 @@ private FromPartial(StreamInput in) throws IOException {
         this(
             Source.readFrom((PlanStreamInput) in),
             in.readNamedWriteable(Expression.class),
-            in.getTransportVersion().onOrAfter(TransportVersions.ESQL_PER_AGGREGATE_FILTER)
-                ? in.readNamedWriteable(Expression.class)
-                : Literal.TRUE,
-            in.getTransportVersion().onOrAfter(TransportVersions.ESQL_PER_AGGREGATE_FILTER)
+            in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0) ? in.readNamedWriteable(Expression.class) : Literal.TRUE,
+            in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)
                 ? in.readNamedWriteableCollectionAsList(Expression.class).get(0)
                 : in.readNamedWriteable(Expression.class)
         );
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/Percentile.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/Percentile.java
index febd9f28b2291..0d57267da1e29 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/Percentile.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/Percentile.java
@@ -92,10 +92,8 @@ private Percentile(StreamInput in) throws IOException {
         this(
             Source.readFrom((PlanStreamInput) in),
             in.readNamedWriteable(Expression.class),
-            in.getTransportVersion().onOrAfter(TransportVersions.ESQL_PER_AGGREGATE_FILTER)
-                ? in.readNamedWriteable(Expression.class)
-                : Literal.TRUE,
-            in.getTransportVersion().onOrAfter(TransportVersions.ESQL_PER_AGGREGATE_FILTER)
+            in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0) ? in.readNamedWriteable(Expression.class) : Literal.TRUE,
+            in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)
                 ? in.readNamedWriteableCollectionAsList(Expression.class).get(0)
                 : in.readNamedWriteable(Expression.class)
         );
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/Rate.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/Rate.java
index b7b04658f8d58..87ac9b77a6826 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/Rate.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/Rate.java
@@ -74,10 +74,8 @@ public Rate(StreamInput in) throws IOException {
         this(
             Source.readFrom((PlanStreamInput) in),
             in.readNamedWriteable(Expression.class),
-            in.getTransportVersion().onOrAfter(TransportVersions.ESQL_PER_AGGREGATE_FILTER)
-                ? in.readNamedWriteable(Expression.class)
-                : Literal.TRUE,
-            in.getTransportVersion().onOrAfter(TransportVersions.ESQL_PER_AGGREGATE_FILTER)
+            in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0) ? in.readNamedWriteable(Expression.class) : Literal.TRUE,
+            in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)
                 ? in.readNamedWriteableCollectionAsList(Expression.class)
                 : nullSafeList(in.readNamedWriteable(Expression.class), in.readOptionalNamedWriteable(Expression.class))
         );
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/ToPartial.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/ToPartial.java
index cffac616b3c8c..a2856f60e4c51 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/ToPartial.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/ToPartial.java
@@ -80,10 +80,8 @@ private ToPartial(StreamInput in) throws IOException {
         this(
             Source.readFrom((PlanStreamInput) in),
             in.readNamedWriteable(Expression.class),
-            in.getTransportVersion().onOrAfter(TransportVersions.ESQL_PER_AGGREGATE_FILTER)
-                ? in.readNamedWriteable(Expression.class)
-                : Literal.TRUE,
-            in.getTransportVersion().onOrAfter(TransportVersions.ESQL_PER_AGGREGATE_FILTER)
+            in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0) ? in.readNamedWriteable(Expression.class) : Literal.TRUE,
+            in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)
                 ? in.readNamedWriteableCollectionAsList(Expression.class).get(0)
                 : in.readNamedWriteable(Expression.class)
         );
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/Top.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/Top.java
index e0a7da806b3ac..40777b4d78dc2 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/Top.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/Top.java
@@ -81,10 +81,8 @@ private Top(StreamInput in) throws IOException {
         super(
             Source.readFrom((PlanStreamInput) in),
             in.readNamedWriteable(Expression.class),
-            in.getTransportVersion().onOrAfter(TransportVersions.ESQL_PER_AGGREGATE_FILTER)
-                ? in.readNamedWriteable(Expression.class)
-                : Literal.TRUE,
-            in.getTransportVersion().onOrAfter(TransportVersions.ESQL_PER_AGGREGATE_FILTER)
+            in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0) ? in.readNamedWriteable(Expression.class) : Literal.TRUE,
+            in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)
                 ? in.readNamedWriteableCollectionAsList(Expression.class)
                 : asList(in.readNamedWriteable(Expression.class), in.readNamedWriteable(Expression.class))
         );
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/WeightedAvg.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/WeightedAvg.java
index dbcc50cea3b9b..49c68d002440f 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/WeightedAvg.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/aggregate/WeightedAvg.java
@@ -68,10 +68,8 @@ private WeightedAvg(StreamInput in) throws IOException {
         this(
             Source.readFrom((PlanStreamInput) in),
             in.readNamedWriteable(Expression.class),
-            in.getTransportVersion().onOrAfter(TransportVersions.ESQL_PER_AGGREGATE_FILTER)
-                ? in.readNamedWriteable(Expression.class)
-                : Literal.TRUE,
-            in.getTransportVersion().onOrAfter(TransportVersions.ESQL_PER_AGGREGATE_FILTER)
+            in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0) ? in.readNamedWriteable(Expression.class) : Literal.TRUE,
+            in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)
                 ? in.readNamedWriteableCollectionAsList(Expression.class).get(0)
                 : in.readNamedWriteable(Expression.class)
         );
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/index/EsIndex.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/index/EsIndex.java
index ce52b3a7611b3..ee51a6f391a65 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/index/EsIndex.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/index/EsIndex.java
@@ -50,7 +50,7 @@ public void writeTo(StreamOutput out) throws IOException {
 
     @SuppressWarnings("unchecked")
     private static Map<String, IndexMode> readIndexNameWithModes(StreamInput in) throws IOException {
-        if (in.getTransportVersion().onOrAfter(TransportVersions.ESQL_ADD_INDEX_MODE_CONCRETE_INDICES)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             return in.readMap(IndexMode::readFrom);
         } else {
             Set<String> indices = (Set<String>) in.readGenericValue();
@@ -60,7 +60,7 @@ private static Map<String, IndexMode> readIndexNameWithModes(StreamInput in) thr
     }
 
     private static void writeIndexNameWithModes(Map<String, IndexMode> concreteIndices, StreamOutput out) throws IOException {
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ESQL_ADD_INDEX_MODE_CONCRETE_INDICES)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeMap(concreteIndices, (o, v) -> IndexMode.writeTo(v, out));
         } else {
             out.writeGenericValue(concreteIndices.keySet());
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/io/stream/PlanStreamInput.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/io/stream/PlanStreamInput.java
index 47e5b9acfbf9d..948fd1c683544 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/io/stream/PlanStreamInput.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/io/stream/PlanStreamInput.java
@@ -182,8 +182,7 @@ public NameId mapNameId(long l) {
     @Override
     @SuppressWarnings("unchecked")
     public <A extends Attribute> A readAttributeWithCache(CheckedFunction<StreamInput, A, IOException> constructor) throws IOException {
-        if (getTransportVersion().onOrAfter(TransportVersions.ESQL_ATTRIBUTE_CACHED_SERIALIZATION)
-            || getTransportVersion().isPatchFrom(TransportVersions.V_8_15_2)) {
+        if (getTransportVersion().onOrAfter(TransportVersions.V_8_15_2)) {
             // it's safe to cast to int, since the max value for this is {@link PlanStreamOutput#MAX_SERIALIZED_ATTRIBUTES}
             int cacheId = Math.toIntExact(readZLong());
             if (cacheId < 0) {
@@ -222,8 +221,7 @@ private void cacheAttribute(int id, Attribute attr) {
 
     @SuppressWarnings("unchecked")
     public <A extends EsField> A readEsFieldWithCache() throws IOException {
-        if (getTransportVersion().onOrAfter(TransportVersions.ESQL_ES_FIELD_CACHED_SERIALIZATION)
-            || getTransportVersion().isPatchFrom(TransportVersions.V_8_15_2)) {
+        if (getTransportVersion().onOrAfter(TransportVersions.V_8_15_2)) {
             // it's safe to cast to int, since the max value for this is {@link PlanStreamOutput#MAX_SERIALIZED_ATTRIBUTES}
             int cacheId = Math.toIntExact(readZLong());
             if (cacheId < 0) {
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/io/stream/PlanStreamOutput.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/io/stream/PlanStreamOutput.java
index 615c4266620c7..63d95c21d7d9d 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/io/stream/PlanStreamOutput.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/io/stream/PlanStreamOutput.java
@@ -154,8 +154,7 @@ public void writeCachedBlock(Block block) throws IOException {
 
     @Override
     public boolean writeAttributeCacheHeader(Attribute attribute) throws IOException {
-        if (getTransportVersion().onOrAfter(TransportVersions.ESQL_ATTRIBUTE_CACHED_SERIALIZATION)
-            || getTransportVersion().isPatchFrom(TransportVersions.V_8_15_2)) {
+        if (getTransportVersion().onOrAfter(TransportVersions.V_8_15_2)) {
             Integer cacheId = attributeIdFromCache(attribute);
             if (cacheId != null) {
                 writeZLong(cacheId);
@@ -186,8 +185,7 @@ private int cacheAttribute(Attribute attr) {
 
     @Override
     public boolean writeEsFieldCacheHeader(EsField field) throws IOException {
-        if (getTransportVersion().onOrAfter(TransportVersions.ESQL_ES_FIELD_CACHED_SERIALIZATION)
-            || getTransportVersion().isPatchFrom(TransportVersions.V_8_15_2)) {
+        if (getTransportVersion().onOrAfter(TransportVersions.V_8_15_2)) {
             Integer cacheId = esFieldIdFromCache(field);
             if (cacheId != null) {
                 writeZLong(cacheId);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plan/physical/AggregateExec.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plan/physical/AggregateExec.java
index dff55f0738975..891d03c571b27 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plan/physical/AggregateExec.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plan/physical/AggregateExec.java
@@ -85,7 +85,7 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeNamedWriteable(child());
         out.writeNamedWriteableCollection(groupings());
         out.writeNamedWriteableCollection(aggregates());
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ESQL_AGGREGATE_EXEC_TRACKS_INTERMEDIATE_ATTRS)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeEnum(getMode());
             out.writeNamedWriteableCollection(intermediateAttributes());
         } else {
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeResponse.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeResponse.java
index 308192704fe0e..8d2e092cd4149 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeResponse.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeResponse.java
@@ -61,7 +61,7 @@ final class ComputeResponse extends TransportResponse {
         } else {
             profiles = null;
         }
-        if (in.getTransportVersion().onOrAfter(TransportVersions.ESQL_CCS_EXECUTION_INFO)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             this.took = in.readOptionalTimeValue();
             this.totalShards = in.readVInt();
             this.successfulShards = in.readVInt();
@@ -86,7 +86,7 @@ public void writeTo(StreamOutput out) throws IOException {
                 out.writeCollection(profiles);
             }
         }
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ESQL_CCS_EXECUTION_INFO)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeOptionalTimeValue(took);
             out.writeVInt(totalShards);
             out.writeVInt(successfulShards);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/DataNodeRequest.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/DataNodeRequest.java
index 8f890e63bf54e..4c01d326ed7bc 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/DataNodeRequest.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/DataNodeRequest.java
@@ -81,7 +81,7 @@ final class DataNodeRequest extends TransportRequest implements IndicesRequest.R
         this.shardIds = in.readCollectionAsList(ShardId::new);
         this.aliasFilters = in.readMap(Index::new, AliasFilter::readFrom);
         this.plan = new PlanStreamInput(in, in.namedWriteableRegistry(), configuration).readNamedWriteable(PhysicalPlan.class);
-        if (in.getTransportVersion().onOrAfter(TransportVersions.ESQL_ORIGINAL_INDICES)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             this.indices = in.readStringArray();
             this.indicesOptions = IndicesOptions.readIndicesOptions(in);
         } else {
@@ -101,7 +101,7 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeCollection(shardIds);
         out.writeMap(aliasFilters);
         new PlanStreamOutput(out, configuration).writeNamedWriteable(plan);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ESQL_ORIGINAL_INDICES)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeStringArray(indices);
             indicesOptions.writeIndicesOptions(out);
         }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/RemoteClusterPlan.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/RemoteClusterPlan.java
index 031bfd7139a84..aed196f963e9b 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/RemoteClusterPlan.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/RemoteClusterPlan.java
@@ -23,7 +23,7 @@ static RemoteClusterPlan from(PlanStreamInput planIn) throws IOException {
         var plan = planIn.readNamedWriteable(PhysicalPlan.class);
         var targetIndices = planIn.readStringArray();
         final OriginalIndices originalIndices;
-        if (planIn.getTransportVersion().onOrAfter(TransportVersions.ESQL_ORIGINAL_INDICES)) {
+        if (planIn.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             originalIndices = OriginalIndices.readOriginalIndices(planIn);
         } else {
             // fallback to the previous behavior
@@ -35,7 +35,7 @@ static RemoteClusterPlan from(PlanStreamInput planIn) throws IOException {
     public void writeTo(PlanStreamOutput out) throws IOException {
         out.writeNamedWriteable(plan);
         out.writeStringArray(targetIndices);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ESQL_ORIGINAL_INDICES)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             OriginalIndices.writeOriginalIndices(originalIndices, out);
         } else {
             out.writeStringArray(originalIndices.indices());
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/querydsl/query/SingleValueQuery.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/querydsl/query/SingleValueQuery.java
index 8d33e9b480594..bc11d246904d5 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/querydsl/query/SingleValueQuery.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/querydsl/query/SingleValueQuery.java
@@ -107,7 +107,7 @@ public static class Builder extends AbstractQueryBuilder<Builder> {
             super(in);
             this.next = in.readNamedWriteable(QueryBuilder.class);
             this.field = in.readString();
-            if (in.getTransportVersion().onOrAfter(TransportVersions.ESQL_SINGLE_VALUE_QUERY_SOURCE)) {
+            if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 if (in instanceof PlanStreamInput psi) {
                     this.source = Source.readFrom(psi);
                 } else {
@@ -128,7 +128,7 @@ public static class Builder extends AbstractQueryBuilder<Builder> {
         protected void doWriteTo(StreamOutput out) throws IOException {
             out.writeNamedWriteable(next);
             out.writeString(field);
-            if (out.getTransportVersion().onOrAfter(TransportVersions.ESQL_SINGLE_VALUE_QUERY_SOURCE)) {
+            if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
                 source.writeTo(out);
             } else if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_12_0)) {
                 writeOldSource(out, source);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/Configuration.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/Configuration.java
index 4ec2746b24ee4..997f3265803f7 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/Configuration.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/Configuration.java
@@ -101,7 +101,7 @@ public Configuration(BlockStreamInput in) throws IOException {
         } else {
             this.tables = Map.of();
         }
-        if (in.getTransportVersion().onOrAfter(TransportVersions.ESQL_CCS_EXECUTION_INFO)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             this.queryStartTimeNanos = in.readLong();
         } else {
             this.queryStartTimeNanos = -1;
@@ -127,7 +127,7 @@ public void writeTo(StreamOutput out) throws IOException {
         if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_15_0)) {
             out.writeMap(tables, (o1, columns) -> o1.writeMap(columns, StreamOutput::writeWriteable));
         }
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ESQL_CCS_EXECUTION_INFO)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeLong(queryStartTimeNanos);
         }
     }
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/plugin/ClusterRequestTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/plugin/ClusterRequestTests.java
index 07ca112e8c527..3dfc0f611eb2b 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/plugin/ClusterRequestTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/plugin/ClusterRequestTests.java
@@ -156,11 +156,7 @@ protected ClusterComputeRequest mutateInstance(ClusterComputeRequest in) throws
 
     public void testFallbackIndicesOptions() throws Exception {
         ClusterComputeRequest request = createTestInstance();
-        var version = TransportVersionUtils.randomVersionBetween(
-            random(),
-            TransportVersions.V_8_14_0,
-            TransportVersions.ESQL_ORIGINAL_INDICES
-        );
+        var version = TransportVersionUtils.randomVersionBetween(random(), TransportVersions.V_8_14_0, TransportVersions.V_8_16_0);
         ClusterComputeRequest cloned = copyInstance(request, version);
         assertThat(cloned.clusterAlias(), equalTo(request.clusterAlias()));
         assertThat(cloned.sessionId(), equalTo(request.sessionId()));
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/chunking/SentenceBoundaryChunkingSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/chunking/SentenceBoundaryChunkingSettings.java
index def52e97666f9..9d6f5bb89218f 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/chunking/SentenceBoundaryChunkingSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/chunking/SentenceBoundaryChunkingSettings.java
@@ -49,7 +49,7 @@ public SentenceBoundaryChunkingSettings(Integer maxChunkSize, @Nullable Integer
 
     public SentenceBoundaryChunkingSettings(StreamInput in) throws IOException {
         maxChunkSize = in.readInt();
-        if (in.getTransportVersion().onOrAfter(TransportVersions.CHUNK_SENTENCE_OVERLAP_SETTING_ADDED)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             sentenceOverlap = in.readVInt();
         }
     }
@@ -113,13 +113,13 @@ public String getWriteableName() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ML_INFERENCE_CHUNKING_SETTINGS;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
     public void writeTo(StreamOutput out) throws IOException {
         out.writeInt(maxChunkSize);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.CHUNK_SENTENCE_OVERLAP_SETTING_ADDED)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeVInt(sentenceOverlap);
         }
     }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/chunking/WordBoundaryChunkingSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/chunking/WordBoundaryChunkingSettings.java
index 7fb0fdc91bf72..7e0378d5b0cd1 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/chunking/WordBoundaryChunkingSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/chunking/WordBoundaryChunkingSettings.java
@@ -104,7 +104,7 @@ public String getWriteableName() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ML_INFERENCE_CHUNKING_SETTINGS;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/random/RandomRankBuilder.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/random/RandomRankBuilder.java
index fdb5503e491eb..15d41301d0a3c 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/random/RandomRankBuilder.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/random/RandomRankBuilder.java
@@ -85,7 +85,7 @@ public String getWriteableName() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.RANDOM_RERANKER_RETRIEVER;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankDoc.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankDoc.java
index d208623e53324..7ad3e8eea0538 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankDoc.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rank/textsimilarity/TextSimilarityRankDoc.java
@@ -98,6 +98,6 @@ protected void doToXContent(XContentBuilder builder, Params params) throws IOExc
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.TEXT_SIMILARITY_RERANKER_QUERY_REWRITE;
+        return TransportVersions.V_8_16_0;
     }
 }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/AlibabaCloudSearchService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/AlibabaCloudSearchService.java
index d7ac7caed7efc..5adc2a11b19d9 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/AlibabaCloudSearchService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/AlibabaCloudSearchService.java
@@ -359,7 +359,7 @@ public Model updateModelWithEmbeddingDetails(Model model, int embeddingSize) {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ML_INFERENCE_ALIBABACLOUD_SEARCH_ADDED;
+        return TransportVersions.V_8_16_0;
     }
 
     public static class Configuration {
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/AlibabaCloudSearchServiceSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/AlibabaCloudSearchServiceSettings.java
index 3500bdf814e16..f6ddac34a2b27 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/AlibabaCloudSearchServiceSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/AlibabaCloudSearchServiceSettings.java
@@ -163,7 +163,7 @@ public ToXContentObject getFilteredXContentObject() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ML_INFERENCE_ALIBABACLOUD_SEARCH_ADDED;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/completion/AlibabaCloudSearchCompletionServiceSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/completion/AlibabaCloudSearchCompletionServiceSettings.java
index 631ec8a8648e8..a299cf5b655c5 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/completion/AlibabaCloudSearchCompletionServiceSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/completion/AlibabaCloudSearchCompletionServiceSettings.java
@@ -74,7 +74,7 @@ public ToXContentObject getFilteredXContentObject() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ML_INFERENCE_ALIBABACLOUD_SEARCH_ADDED;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/completion/AlibabaCloudSearchCompletionTaskSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/completion/AlibabaCloudSearchCompletionTaskSettings.java
index 05b5873a81d8d..7883e7b1d90df 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/completion/AlibabaCloudSearchCompletionTaskSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/completion/AlibabaCloudSearchCompletionTaskSettings.java
@@ -115,7 +115,7 @@ public String getWriteableName() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ML_INFERENCE_ALIBABACLOUD_SEARCH_ADDED;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/embeddings/AlibabaCloudSearchEmbeddingsServiceSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/embeddings/AlibabaCloudSearchEmbeddingsServiceSettings.java
index 8896e983d3e7f..8f40ce2a8b8b7 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/embeddings/AlibabaCloudSearchEmbeddingsServiceSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/embeddings/AlibabaCloudSearchEmbeddingsServiceSettings.java
@@ -135,7 +135,7 @@ public ToXContentObject getFilteredXContentObject() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ML_INFERENCE_ALIBABACLOUD_SEARCH_ADDED;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/embeddings/AlibabaCloudSearchEmbeddingsTaskSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/embeddings/AlibabaCloudSearchEmbeddingsTaskSettings.java
index 9a431717d9fb9..a08ca6cce66d6 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/embeddings/AlibabaCloudSearchEmbeddingsTaskSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/embeddings/AlibabaCloudSearchEmbeddingsTaskSettings.java
@@ -151,7 +151,7 @@ public String getWriteableName() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ML_INFERENCE_ALIBABACLOUD_SEARCH_ADDED;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/rerank/AlibabaCloudSearchRerankServiceSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/rerank/AlibabaCloudSearchRerankServiceSettings.java
index 42c7238aefa7f..40e645074f61c 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/rerank/AlibabaCloudSearchRerankServiceSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/rerank/AlibabaCloudSearchRerankServiceSettings.java
@@ -74,7 +74,7 @@ public ToXContentObject getFilteredXContentObject() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ML_INFERENCE_ALIBABACLOUD_SEARCH_ADDED;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/rerank/AlibabaCloudSearchRerankTaskSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/rerank/AlibabaCloudSearchRerankTaskSettings.java
index 40c3dee00d6c7..2a7806f4beab3 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/rerank/AlibabaCloudSearchRerankTaskSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/rerank/AlibabaCloudSearchRerankTaskSettings.java
@@ -85,7 +85,7 @@ public String getWriteableName() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ML_INFERENCE_ALIBABACLOUD_SEARCH_ADDED;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/sparse/AlibabaCloudSearchSparseServiceSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/sparse/AlibabaCloudSearchSparseServiceSettings.java
index fe44c936c4e61..0a55d2aba6cea 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/sparse/AlibabaCloudSearchSparseServiceSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/sparse/AlibabaCloudSearchSparseServiceSettings.java
@@ -74,7 +74,7 @@ public ToXContentObject getFilteredXContentObject() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ML_INFERENCE_ALIBABACLOUD_SEARCH_ADDED;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/sparse/AlibabaCloudSearchSparseTaskSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/sparse/AlibabaCloudSearchSparseTaskSettings.java
index 0f4ebce920167..17c5b178c2a13 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/sparse/AlibabaCloudSearchSparseTaskSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/sparse/AlibabaCloudSearchSparseTaskSettings.java
@@ -164,7 +164,7 @@ public String getWriteableName() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ML_INFERENCE_ALIBABACLOUD_SEARCH_ADDED;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/cohere/rerank/CohereRerankServiceSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/cohere/rerank/CohereRerankServiceSettings.java
index a3d2483a068e2..78178466f9f3a 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/cohere/rerank/CohereRerankServiceSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/cohere/rerank/CohereRerankServiceSettings.java
@@ -92,7 +92,7 @@ public CohereRerankServiceSettings(@Nullable String url, @Nullable String modelI
     public CohereRerankServiceSettings(StreamInput in) throws IOException {
         this.uri = createOptionalUri(in.readOptionalString());
 
-        if (in.getTransportVersion().before(TransportVersions.ML_INFERENCE_COHERE_UNUSED_RERANK_SETTINGS_REMOVED)) {
+        if (in.getTransportVersion().before(TransportVersions.V_8_16_0)) {
             // An older node sends these fields, so we need to skip them to progress through the serialized data
             in.readOptionalEnum(SimilarityMeasure.class);
             in.readOptionalVInt();
@@ -162,7 +162,7 @@ public void writeTo(StreamOutput out) throws IOException {
         var uriToWrite = uri != null ? uri.toString() : null;
         out.writeOptionalString(uriToWrite);
 
-        if (out.getTransportVersion().before(TransportVersions.ML_INFERENCE_COHERE_UNUSED_RERANK_SETTINGS_REMOVED)) {
+        if (out.getTransportVersion().before(TransportVersions.V_8_16_0)) {
             // An old node expects this data to be present, so we need to send at least the booleans
             // indicating that the fields are not set
             out.writeOptionalEnum(null);
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceService.java
index 1f08c06edaa91..b256861e7dd27 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceService.java
@@ -229,7 +229,7 @@ public Model parsePersistedConfig(String inferenceEntityId, TaskType taskType, M
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ML_INFERENCE_EIS_INTEGRATION_ADDED;
+        return TransportVersions.V_8_16_0;
     }
 
     private ElasticInferenceServiceModel createModelFromPersistent(
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceServiceSparseEmbeddingsServiceSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceServiceSparseEmbeddingsServiceSettings.java
index bbda1bb716794..3af404aeef36b 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceServiceSparseEmbeddingsServiceSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceServiceSparseEmbeddingsServiceSettings.java
@@ -113,7 +113,7 @@ public RateLimitSettings rateLimitSettings() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ML_INFERENCE_EIS_INTEGRATION_ADDED;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalServiceSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalServiceSettings.java
index 962c939146ef2..244108edc3dd4 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalServiceSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalServiceSettings.java
@@ -157,19 +157,17 @@ public ElasticsearchInternalServiceSettings(ElasticsearchInternalServiceSettings
     }
 
     public ElasticsearchInternalServiceSettings(StreamInput in) throws IOException {
-        if (in.getTransportVersion().onOrAfter(TransportVersions.INFERENCE_ADAPTIVE_ALLOCATIONS)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             this.numAllocations = in.readOptionalVInt();
         } else {
             this.numAllocations = in.readVInt();
         }
         this.numThreads = in.readVInt();
         this.modelId = in.readString();
-        this.adaptiveAllocationsSettings = in.getTransportVersion().onOrAfter(TransportVersions.INFERENCE_ADAPTIVE_ALLOCATIONS)
+        this.adaptiveAllocationsSettings = in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)
             ? in.readOptionalWriteable(AdaptiveAllocationsSettings::new)
             : null;
-        this.deploymentId = in.getTransportVersion().onOrAfter(TransportVersions.ML_INFERENCE_ATTACH_TO_EXISTSING_DEPLOYMENT)
-            ? in.readOptionalString()
-            : null;
+        this.deploymentId = in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0) ? in.readOptionalString() : null;
     }
 
     public void setNumAllocations(Integer numAllocations) {
@@ -178,17 +176,15 @@ public void setNumAllocations(Integer numAllocations) {
 
     @Override
     public void writeTo(StreamOutput out) throws IOException {
-        if (out.getTransportVersion().onOrAfter(TransportVersions.INFERENCE_ADAPTIVE_ALLOCATIONS)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeOptionalVInt(getNumAllocations());
         } else {
             out.writeVInt(getNumAllocations());
         }
         out.writeVInt(getNumThreads());
         out.writeString(modelId());
-        if (out.getTransportVersion().onOrAfter(TransportVersions.INFERENCE_ADAPTIVE_ALLOCATIONS)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeOptionalWriteable(getAdaptiveAllocationsSettings());
-        }
-        if (out.getTransportVersion().onOrAfter(TransportVersions.ML_INFERENCE_ATTACH_TO_EXISTSING_DEPLOYMENT)) {
             out.writeOptionalString(deploymentId);
         }
     }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/ibmwatsonx/IbmWatsonxService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/ibmwatsonx/IbmWatsonxService.java
index ea263fb77a2da..981a3e95808ef 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/ibmwatsonx/IbmWatsonxService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/ibmwatsonx/IbmWatsonxService.java
@@ -223,7 +223,7 @@ public Model parsePersistedConfig(String inferenceEntityId, TaskType taskType, M
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ML_INFERENCE_IBM_WATSONX_EMBEDDINGS_ADDED;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/ibmwatsonx/embeddings/IbmWatsonxEmbeddingsServiceSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/ibmwatsonx/embeddings/IbmWatsonxEmbeddingsServiceSettings.java
index 53d5c6c8bb5e8..3a9625aef31c7 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/ibmwatsonx/embeddings/IbmWatsonxEmbeddingsServiceSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/ibmwatsonx/embeddings/IbmWatsonxEmbeddingsServiceSettings.java
@@ -207,7 +207,7 @@ public String getWriteableName() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.ML_INFERENCE_IBM_WATSONX_EMBEDDINGS_ADDED;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ltr/LearningToRankRescorerBuilder.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ltr/LearningToRankRescorerBuilder.java
index 46edcf1f63c01..b59ef0c40e4f9 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ltr/LearningToRankRescorerBuilder.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/ltr/LearningToRankRescorerBuilder.java
@@ -304,7 +304,7 @@ public String getWriteableName() {
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.LTR_SERVERLESS_RELEASE;
+        return TransportVersions.V_8_16_0;
     }
 
     @Override
diff --git a/x-pack/plugin/rank-rrf/src/main/java/org/elasticsearch/xpack/rank/rrf/RRFRankDoc.java b/x-pack/plugin/rank-rrf/src/main/java/org/elasticsearch/xpack/rank/rrf/RRFRankDoc.java
index 4cd10801b298c..84961f8442163 100644
--- a/x-pack/plugin/rank-rrf/src/main/java/org/elasticsearch/xpack/rank/rrf/RRFRankDoc.java
+++ b/x-pack/plugin/rank-rrf/src/main/java/org/elasticsearch/xpack/rank/rrf/RRFRankDoc.java
@@ -62,7 +62,7 @@ public RRFRankDoc(StreamInput in) throws IOException {
         rank = in.readVInt();
         positions = in.readIntArray();
         scores = in.readFloatArray();
-        if (in.getTransportVersion().onOrAfter(TransportVersions.RRF_QUERY_REWRITE)) {
+        if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             this.rankConstant = in.readVInt();
         } else {
             this.rankConstant = DEFAULT_RANK_CONSTANT;
@@ -119,7 +119,7 @@ public void doWriteTo(StreamOutput out) throws IOException {
         out.writeVInt(rank);
         out.writeIntArray(positions);
         out.writeFloatArray(scores);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.RRF_QUERY_REWRITE)) {
+        if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_16_0)) {
             out.writeVInt(rankConstant);
         }
     }
@@ -173,6 +173,6 @@ protected void doToXContent(XContentBuilder builder, Params params) throws IOExc
 
     @Override
     public TransportVersion getMinimalSupportedVersion() {
-        return TransportVersions.RRF_QUERY_REWRITE;
+        return TransportVersions.V_8_16_0;
     }
 }
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/ApiKeyService.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/ApiKeyService.java
index 03558e72fdca3..c1be25b27c51e 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/ApiKeyService.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/ApiKeyService.java
@@ -14,6 +14,7 @@
 import org.elasticsearch.ExceptionsHelper;
 import org.elasticsearch.ResourceNotFoundException;
 import org.elasticsearch.TransportVersion;
+import org.elasticsearch.TransportVersions;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.ActionRunnable;
 import org.elasticsearch.action.DocWriteRequest;
@@ -138,7 +139,6 @@
 import java.util.function.Supplier;
 import java.util.stream.Collectors;
 
-import static org.elasticsearch.TransportVersions.ADD_MANAGE_ROLES_PRIVILEGE;
 import static org.elasticsearch.core.Strings.format;
 import static org.elasticsearch.search.SearchService.DEFAULT_KEEPALIVE_SETTING;
 import static org.elasticsearch.transport.RemoteClusterPortSettings.TRANSPORT_VERSION_ADVANCED_REMOTE_CLUSTER_SECURITY;
@@ -430,17 +430,17 @@ private boolean validateRoleDescriptorsForMixedCluster(
             listener.onFailure(
                 new IllegalArgumentException(
                     "all nodes must have version ["
-                        + ROLE_REMOTE_CLUSTER_PRIVS
+                        + ROLE_REMOTE_CLUSTER_PRIVS.toReleaseVersion()
                         + "] or higher to support remote cluster privileges for API keys"
                 )
             );
             return false;
         }
-        if (transportVersion.before(ADD_MANAGE_ROLES_PRIVILEGE) && hasGlobalManageRolesPrivilege(roleDescriptors)) {
+        if (transportVersion.before(TransportVersions.V_8_16_0) && hasGlobalManageRolesPrivilege(roleDescriptors)) {
             listener.onFailure(
                 new IllegalArgumentException(
                     "all nodes must have version ["
-                        + ADD_MANAGE_ROLES_PRIVILEGE
+                        + TransportVersions.V_8_16_0.toReleaseVersion()
                         + "] or higher to support the manage roles privilege for API keys"
                 )
             );
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/NativeRolesStore.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/NativeRolesStore.java
index 4ae17a679d205..23a1fc188e4a0 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/NativeRolesStore.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authz/store/NativeRolesStore.java
@@ -481,10 +481,10 @@ private Exception validateRoleDescriptor(RoleDescriptor role) {
                     );
                 } else if (Arrays.stream(role.getConditionalClusterPrivileges())
                     .anyMatch(privilege -> privilege instanceof ConfigurableClusterPrivileges.ManageRolesPrivilege)
-                    && clusterService.state().getMinTransportVersion().before(TransportVersions.ADD_MANAGE_ROLES_PRIVILEGE)) {
+                    && clusterService.state().getMinTransportVersion().before(TransportVersions.V_8_16_0)) {
                         return new IllegalStateException(
                             "all nodes must have version ["
-                                + TransportVersions.ADD_MANAGE_ROLES_PRIVILEGE.toReleaseVersion()
+                                + TransportVersions.V_8_16_0.toReleaseVersion()
                                 + "] or higher to support the manage roles privilege"
                         );
                     }
diff --git a/x-pack/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RolesBackwardsCompatibilityIT.java b/x-pack/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RolesBackwardsCompatibilityIT.java
index ea1b2cdac5a1f..54b7ff6fa484c 100644
--- a/x-pack/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RolesBackwardsCompatibilityIT.java
+++ b/x-pack/qa/rolling-upgrade/src/test/java/org/elasticsearch/upgrades/RolesBackwardsCompatibilityIT.java
@@ -158,8 +158,8 @@ public void testRolesWithDescription() throws Exception {
 
     public void testRolesWithManageRoles() throws Exception {
         assumeTrue(
-            "The manage roles privilege is supported after transport version: " + TransportVersions.ADD_MANAGE_ROLES_PRIVILEGE,
-            minimumTransportVersion().before(TransportVersions.ADD_MANAGE_ROLES_PRIVILEGE)
+            "The manage roles privilege is supported after transport version: " + TransportVersions.V_8_16_0,
+            minimumTransportVersion().before(TransportVersions.V_8_16_0)
         );
         switch (CLUSTER_TYPE) {
             case OLD -> {
@@ -190,7 +190,7 @@ public void testRolesWithManageRoles() throws Exception {
             }
             case MIXED -> {
                 try {
-                    this.createClientsByVersion(TransportVersions.ADD_MANAGE_ROLES_PRIVILEGE);
+                    this.createClientsByVersion(TransportVersions.V_8_16_0);
                     // succeed when role manage roles is not provided
                     final String initialRole = randomRoleDescriptorSerialized();
                     createRole(client(), "my-valid-mixed-role", initialRole);
@@ -232,7 +232,7 @@ public void testRolesWithManageRoles() throws Exception {
                             e.getMessage(),
                             containsString(
                                 "all nodes must have version ["
-                                    + TransportVersions.ADD_MANAGE_ROLES_PRIVILEGE.toReleaseVersion()
+                                    + TransportVersions.V_8_16_0.toReleaseVersion()
                                     + "] or higher to support the manage roles privilege"
                             )
                         );
@@ -246,7 +246,7 @@ public void testRolesWithManageRoles() throws Exception {
                             e.getMessage(),
                             containsString(
                                 "all nodes must have version ["
-                                    + TransportVersions.ADD_MANAGE_ROLES_PRIVILEGE.toReleaseVersion()
+                                    + TransportVersions.V_8_16_0.toReleaseVersion()
                                     + "] or higher to support the manage roles privilege"
                             )
                         );

From 724e0524bb56cd38bbe99caf13289eefd1e72793 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lorenzo=20Dematt=C3=A9?= <lorenzo.dematte@elastic.co>
Date: Thu, 5 Dec 2024 10:29:03 +0100
Subject: [PATCH 040/119] [Entitlements] Integrate PluginsLoader with
 PolicyManager (#117239)

This PR expands `PolicyManager` to actually use `Policy` and
`Entitlement` classes for checks, instead of hardcoding them.

It also introduces a separate `PluginsResolver`, with a dedicated
function to map a Class to a Plugin (name). `PluginsResolver` is
initialized with data from `PluginsLoader`, and then its resolve
function is used internally in `PolicyManager` to find a plugin policy
(and then test against the entitlements declared in the policy).
---
 .../src/main/java/module-info.java            |   1 +
 .../EntitlementInitialization.java            |   8 +-
 .../api/ElasticsearchEntitlementChecker.java  |  13 +-
 .../policy/CreateClassLoaderEntitlement.java  |   1 -
 ...lementType.java => ExitVMEntitlement.java} |   8 +-
 .../runtime/policy/FileEntitlement.java       |   7 +-
 .../runtime/policy/PolicyManager.java         | 135 +++++++++-
 .../runtime/policy/PolicyManagerTests.java    | 247 +++++++++++++++++
 .../bootstrap/Elasticsearch.java              |  22 +-
 .../bootstrap/PluginsResolver.java            |  47 ++++
 .../elasticsearch/plugins/PluginsLoader.java  |  47 +++-
 .../bootstrap/PluginsResolverTests.java       | 254 ++++++++++++++++++
 .../plugins/MockPluginsService.java           |   2 +-
 13 files changed, 738 insertions(+), 54 deletions(-)
 rename libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/{FlagEntitlementType.java => ExitVMEntitlement.java} (79%)
 create mode 100644 libs/entitlement/src/test/java/org/elasticsearch/entitlement/runtime/policy/PolicyManagerTests.java
 create mode 100644 server/src/main/java/org/elasticsearch/bootstrap/PluginsResolver.java
 create mode 100644 server/src/test/java/org/elasticsearch/bootstrap/PluginsResolverTests.java

diff --git a/libs/entitlement/src/main/java/module-info.java b/libs/entitlement/src/main/java/module-info.java
index 54075ba60bbef..b8a125b98e641 100644
--- a/libs/entitlement/src/main/java/module-info.java
+++ b/libs/entitlement/src/main/java/module-info.java
@@ -17,6 +17,7 @@
     requires static org.elasticsearch.entitlement.bridge; // At runtime, this will be in java.base
 
     exports org.elasticsearch.entitlement.runtime.api;
+    exports org.elasticsearch.entitlement.runtime.policy;
     exports org.elasticsearch.entitlement.instrumentation;
     exports org.elasticsearch.entitlement.bootstrap to org.elasticsearch.server;
     exports org.elasticsearch.entitlement.initialization to java.base;
diff --git a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/initialization/EntitlementInitialization.java b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/initialization/EntitlementInitialization.java
index 0ffab5f93969f..fb694308466c6 100644
--- a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/initialization/EntitlementInitialization.java
+++ b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/initialization/EntitlementInitialization.java
@@ -18,6 +18,8 @@
 import org.elasticsearch.entitlement.instrumentation.MethodKey;
 import org.elasticsearch.entitlement.instrumentation.Transformer;
 import org.elasticsearch.entitlement.runtime.api.ElasticsearchEntitlementChecker;
+import org.elasticsearch.entitlement.runtime.policy.CreateClassLoaderEntitlement;
+import org.elasticsearch.entitlement.runtime.policy.ExitVMEntitlement;
 import org.elasticsearch.entitlement.runtime.policy.Policy;
 import org.elasticsearch.entitlement.runtime.policy.PolicyManager;
 import org.elasticsearch.entitlement.runtime.policy.PolicyParser;
@@ -86,9 +88,11 @@ private static Class<?> internalNameToClass(String internalName) {
     private static PolicyManager createPolicyManager() throws IOException {
         Map<String, Policy> pluginPolicies = createPluginPolicies(EntitlementBootstrap.bootstrapArgs().pluginData());
 
-        // TODO: What should the name be?
         // TODO(ES-10031): Decide what goes in the elasticsearch default policy and extend it
-        var serverPolicy = new Policy("server", List.of());
+        var serverPolicy = new Policy(
+            "server",
+            List.of(new Scope("org.elasticsearch.server", List.of(new ExitVMEntitlement(), new CreateClassLoaderEntitlement())))
+        );
         return new PolicyManager(serverPolicy, pluginPolicies, EntitlementBootstrap.bootstrapArgs().pluginResolver());
     }
 
diff --git a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/api/ElasticsearchEntitlementChecker.java b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/api/ElasticsearchEntitlementChecker.java
index 28a080470c043..aa63b630ed7cd 100644
--- a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/api/ElasticsearchEntitlementChecker.java
+++ b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/api/ElasticsearchEntitlementChecker.java
@@ -10,7 +10,6 @@
 package org.elasticsearch.entitlement.runtime.api;
 
 import org.elasticsearch.entitlement.bridge.EntitlementChecker;
-import org.elasticsearch.entitlement.runtime.policy.FlagEntitlementType;
 import org.elasticsearch.entitlement.runtime.policy.PolicyManager;
 
 import java.net.URL;
@@ -30,27 +29,27 @@ public ElasticsearchEntitlementChecker(PolicyManager policyManager) {
 
     @Override
     public void check$java_lang_System$exit(Class<?> callerClass, int status) {
-        policyManager.checkFlagEntitlement(callerClass, FlagEntitlementType.SYSTEM_EXIT);
+        policyManager.checkExitVM(callerClass);
     }
 
     @Override
     public void check$java_net_URLClassLoader$(Class<?> callerClass, URL[] urls) {
-        policyManager.checkFlagEntitlement(callerClass, FlagEntitlementType.CREATE_CLASSLOADER);
+        policyManager.checkCreateClassLoader(callerClass);
     }
 
     @Override
     public void check$java_net_URLClassLoader$(Class<?> callerClass, URL[] urls, ClassLoader parent) {
-        policyManager.checkFlagEntitlement(callerClass, FlagEntitlementType.CREATE_CLASSLOADER);
+        policyManager.checkCreateClassLoader(callerClass);
     }
 
     @Override
     public void check$java_net_URLClassLoader$(Class<?> callerClass, URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory) {
-        policyManager.checkFlagEntitlement(callerClass, FlagEntitlementType.CREATE_CLASSLOADER);
+        policyManager.checkCreateClassLoader(callerClass);
     }
 
     @Override
     public void check$java_net_URLClassLoader$(Class<?> callerClass, String name, URL[] urls, ClassLoader parent) {
-        policyManager.checkFlagEntitlement(callerClass, FlagEntitlementType.CREATE_CLASSLOADER);
+        policyManager.checkCreateClassLoader(callerClass);
     }
 
     @Override
@@ -61,6 +60,6 @@ public ElasticsearchEntitlementChecker(PolicyManager policyManager) {
         ClassLoader parent,
         URLStreamHandlerFactory factory
     ) {
-        policyManager.checkFlagEntitlement(callerClass, FlagEntitlementType.CREATE_CLASSLOADER);
+        policyManager.checkCreateClassLoader(callerClass);
     }
 }
diff --git a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/CreateClassLoaderEntitlement.java b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/CreateClassLoaderEntitlement.java
index 708e0b87711fe..138515be9ffcb 100644
--- a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/CreateClassLoaderEntitlement.java
+++ b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/CreateClassLoaderEntitlement.java
@@ -12,5 +12,4 @@
 public class CreateClassLoaderEntitlement implements Entitlement {
     @ExternalEntitlement
     public CreateClassLoaderEntitlement() {}
-
 }
diff --git a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/FlagEntitlementType.java b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/ExitVMEntitlement.java
similarity index 79%
rename from libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/FlagEntitlementType.java
rename to libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/ExitVMEntitlement.java
index d40235ee12166..c4a8fc6833581 100644
--- a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/FlagEntitlementType.java
+++ b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/ExitVMEntitlement.java
@@ -9,7 +9,7 @@
 
 package org.elasticsearch.entitlement.runtime.policy;
 
-public enum FlagEntitlementType {
-    SYSTEM_EXIT,
-    CREATE_CLASSLOADER;
-}
+/**
+ * Internal policy type (not-parseable -- not available to plugins).
+ */
+public class ExitVMEntitlement implements Entitlement {}
diff --git a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/FileEntitlement.java b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/FileEntitlement.java
index 8df199591d3e4..d0837bc096183 100644
--- a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/FileEntitlement.java
+++ b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/FileEntitlement.java
@@ -20,6 +20,9 @@ public class FileEntitlement implements Entitlement {
     public static final int READ_ACTION = 0x1;
     public static final int WRITE_ACTION = 0x2;
 
+    public static final String READ = "read";
+    public static final String WRITE = "write";
+
     private final String path;
     private final int actions;
 
@@ -29,12 +32,12 @@ public FileEntitlement(String path, List<String> actionsList) {
         int actionsInt = 0;
 
         for (String actionString : actionsList) {
-            if ("read".equals(actionString)) {
+            if (READ.equals(actionString)) {
                 if ((actionsInt & READ_ACTION) == READ_ACTION) {
                     throw new IllegalArgumentException("file action [read] specified multiple times");
                 }
                 actionsInt |= READ_ACTION;
-            } else if ("write".equals(actionString)) {
+            } else if (WRITE.equals(actionString)) {
                 if ((actionsInt & WRITE_ACTION) == WRITE_ACTION) {
                     throw new IllegalArgumentException("file action [write] specified multiple times");
                 }
diff --git a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/PolicyManager.java b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/PolicyManager.java
index b3fb5b75a1d5a..a77c86d5ffd04 100644
--- a/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/PolicyManager.java
+++ b/libs/entitlement/src/main/java/org/elasticsearch/entitlement/runtime/policy/PolicyManager.java
@@ -17,17 +17,45 @@
 
 import java.lang.module.ModuleFinder;
 import java.lang.module.ModuleReference;
+import java.util.ArrayList;
 import java.util.Collections;
+import java.util.HashMap;
+import java.util.IdentityHashMap;
+import java.util.List;
 import java.util.Map;
 import java.util.Objects;
 import java.util.Optional;
 import java.util.Set;
 import java.util.function.Function;
 import java.util.stream.Collectors;
+import java.util.stream.Stream;
 
 public class PolicyManager {
     private static final Logger logger = LogManager.getLogger(ElasticsearchEntitlementChecker.class);
 
+    static class ModuleEntitlements {
+        public static final ModuleEntitlements NONE = new ModuleEntitlements(List.of());
+        private final IdentityHashMap<Class<? extends Entitlement>, List<Entitlement>> entitlementsByType;
+
+        ModuleEntitlements(List<Entitlement> entitlements) {
+            this.entitlementsByType = entitlements.stream()
+                .collect(Collectors.toMap(Entitlement::getClass, e -> new ArrayList<>(List.of(e)), (a, b) -> {
+                    a.addAll(b);
+                    return a;
+                }, IdentityHashMap::new));
+        }
+
+        public boolean hasEntitlement(Class<? extends Entitlement> entitlementClass) {
+            return entitlementsByType.containsKey(entitlementClass);
+        }
+
+        public <E extends Entitlement> Stream<E> getEntitlements(Class<E> entitlementClass) {
+            return entitlementsByType.get(entitlementClass).stream().map(entitlementClass::cast);
+        }
+    }
+
+    final Map<Module, ModuleEntitlements> moduleEntitlementsMap = new HashMap<>();
+
     protected final Policy serverPolicy;
     protected final Map<String, Policy> pluginPolicies;
     private final Function<Class<?>, String> pluginResolver;
@@ -56,27 +84,110 @@ public PolicyManager(Policy defaultPolicy, Map<String, Policy> pluginPolicies, F
         this.pluginResolver = pluginResolver;
     }
 
-    public void checkFlagEntitlement(Class<?> callerClass, FlagEntitlementType type) {
+    private static List<Entitlement> lookupEntitlementsForModule(Policy policy, String moduleName) {
+        for (int i = 0; i < policy.scopes.size(); ++i) {
+            var scope = policy.scopes.get(i);
+            if (scope.name.equals(moduleName)) {
+                return scope.entitlements;
+            }
+        }
+        return null;
+    }
+
+    public void checkExitVM(Class<?> callerClass) {
+        checkEntitlementPresent(callerClass, ExitVMEntitlement.class);
+    }
+
+    public void checkCreateClassLoader(Class<?> callerClass) {
+        checkEntitlementPresent(callerClass, CreateClassLoaderEntitlement.class);
+    }
+
+    private void checkEntitlementPresent(Class<?> callerClass, Class<? extends Entitlement> entitlementClass) {
         var requestingModule = requestingModule(callerClass);
         if (isTriviallyAllowed(requestingModule)) {
             return;
         }
 
-        // TODO: real policy check. For now, we only allow our hardcoded System.exit policy for server.
-        // TODO: this will be checked using policies
-        if (requestingModule.isNamed()
-            && requestingModule.getName().equals("org.elasticsearch.server")
-            && (type == FlagEntitlementType.SYSTEM_EXIT || type == FlagEntitlementType.CREATE_CLASSLOADER)) {
-            logger.debug("Allowed: caller [{}] in module [{}] has entitlement [{}]", callerClass, requestingModule.getName(), type);
+        ModuleEntitlements entitlements = getEntitlementsOrThrow(callerClass, requestingModule);
+        if (entitlements.hasEntitlement(entitlementClass)) {
+            logger.debug(
+                () -> Strings.format(
+                    "Entitled: caller [%s], module [%s], type [%s]",
+                    callerClass,
+                    requestingModule.getName(),
+                    entitlementClass.getSimpleName()
+                )
+            );
             return;
         }
-
-        // TODO: plugins policy check using pluginResolver and pluginPolicies
         throw new NotEntitledException(
-            Strings.format("Missing entitlement [%s] for caller [%s] in module [%s]", type, callerClass, requestingModule.getName())
+            Strings.format(
+                "Missing entitlement: caller [%s], module [%s], type [%s]",
+                callerClass,
+                requestingModule.getName(),
+                entitlementClass.getSimpleName()
+            )
         );
     }
 
+    ModuleEntitlements getEntitlementsOrThrow(Class<?> callerClass, Module requestingModule) {
+        ModuleEntitlements cachedEntitlement = moduleEntitlementsMap.get(requestingModule);
+        if (cachedEntitlement != null) {
+            if (cachedEntitlement == ModuleEntitlements.NONE) {
+                throw new NotEntitledException(buildModuleNoPolicyMessage(callerClass, requestingModule) + "[CACHED]");
+            }
+            return cachedEntitlement;
+        }
+
+        if (isServerModule(requestingModule)) {
+            var scopeName = requestingModule.getName();
+            return getModuleEntitlementsOrThrow(callerClass, requestingModule, serverPolicy, scopeName);
+        }
+
+        // plugins
+        var pluginName = pluginResolver.apply(callerClass);
+        if (pluginName != null) {
+            var pluginPolicy = pluginPolicies.get(pluginName);
+            if (pluginPolicy != null) {
+                final String scopeName;
+                if (requestingModule.isNamed() == false) {
+                    scopeName = ALL_UNNAMED;
+                } else {
+                    scopeName = requestingModule.getName();
+                }
+                return getModuleEntitlementsOrThrow(callerClass, requestingModule, pluginPolicy, scopeName);
+            }
+        }
+
+        moduleEntitlementsMap.put(requestingModule, ModuleEntitlements.NONE);
+        throw new NotEntitledException(buildModuleNoPolicyMessage(callerClass, requestingModule));
+    }
+
+    private static String buildModuleNoPolicyMessage(Class<?> callerClass, Module requestingModule) {
+        return Strings.format("Missing entitlement policy: caller [%s], module [%s]", callerClass, requestingModule.getName());
+    }
+
+    private ModuleEntitlements getModuleEntitlementsOrThrow(Class<?> callerClass, Module module, Policy policy, String moduleName) {
+        var entitlements = lookupEntitlementsForModule(policy, moduleName);
+        if (entitlements == null) {
+            // Module without entitlements - remember we don't have any
+            moduleEntitlementsMap.put(module, ModuleEntitlements.NONE);
+            throw new NotEntitledException(buildModuleNoPolicyMessage(callerClass, module));
+        }
+        // We have a policy for this module
+        var classEntitlements = createClassEntitlements(entitlements);
+        moduleEntitlementsMap.put(module, classEntitlements);
+        return classEntitlements;
+    }
+
+    private static boolean isServerModule(Module requestingModule) {
+        return requestingModule.isNamed() && requestingModule.getLayer() == ModuleLayer.boot();
+    }
+
+    private ModuleEntitlements createClassEntitlements(List<Entitlement> entitlements) {
+        return new ModuleEntitlements(entitlements);
+    }
+
     private static Module requestingModule(Class<?> callerClass) {
         if (callerClass != null) {
             Module callerModule = callerClass.getModule();
@@ -102,10 +213,10 @@ private static Module requestingModule(Class<?> callerClass) {
 
     private static boolean isTriviallyAllowed(Module requestingModule) {
         if (requestingModule == null) {
-            logger.debug("Trivially allowed: entire call stack is in composed of classes in system modules");
+            logger.debug("Entitlement trivially allowed: entire call stack is in composed of classes in system modules");
             return true;
         }
-        logger.trace("Not trivially allowed");
+        logger.trace("Entitlement not trivially allowed");
         return false;
     }
 
diff --git a/libs/entitlement/src/test/java/org/elasticsearch/entitlement/runtime/policy/PolicyManagerTests.java b/libs/entitlement/src/test/java/org/elasticsearch/entitlement/runtime/policy/PolicyManagerTests.java
new file mode 100644
index 0000000000000..45bdf2e457824
--- /dev/null
+++ b/libs/entitlement/src/test/java/org/elasticsearch/entitlement/runtime/policy/PolicyManagerTests.java
@@ -0,0 +1,247 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.entitlement.runtime.policy;
+
+import org.elasticsearch.entitlement.runtime.api.NotEntitledException;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.compiler.InMemoryJavaCompiler;
+import org.elasticsearch.test.jar.JarUtils;
+
+import java.io.IOException;
+import java.lang.module.Configuration;
+import java.lang.module.ModuleFinder;
+import java.nio.file.Path;
+import java.util.Arrays;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static java.util.Map.entry;
+import static org.elasticsearch.entitlement.runtime.policy.PolicyManager.ALL_UNNAMED;
+import static org.elasticsearch.test.LambdaMatchers.transformedMatch;
+import static org.hamcrest.Matchers.aMapWithSize;
+import static org.hamcrest.Matchers.contains;
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.endsWith;
+import static org.hamcrest.Matchers.hasEntry;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.sameInstance;
+
+@ESTestCase.WithoutSecurityManager
+public class PolicyManagerTests extends ESTestCase {
+
+    public void testGetEntitlementsThrowsOnMissingPluginUnnamedModule() {
+        var policyManager = new PolicyManager(
+            createEmptyTestServerPolicy(),
+            Map.of("plugin1", createPluginPolicy("plugin.module")),
+            c -> "plugin1"
+        );
+
+        // Any class from the current module (unnamed) will do
+        var callerClass = this.getClass();
+        var requestingModule = callerClass.getModule();
+
+        var ex = assertThrows(
+            "No policy for the unnamed module",
+            NotEntitledException.class,
+            () -> policyManager.getEntitlementsOrThrow(callerClass, requestingModule)
+        );
+
+        assertEquals(
+            "Missing entitlement policy: caller [class org.elasticsearch.entitlement.runtime.policy.PolicyManagerTests], module [null]",
+            ex.getMessage()
+        );
+        assertThat(policyManager.moduleEntitlementsMap, hasEntry(requestingModule, PolicyManager.ModuleEntitlements.NONE));
+    }
+
+    public void testGetEntitlementsThrowsOnMissingPolicyForPlugin() {
+        var policyManager = new PolicyManager(createEmptyTestServerPolicy(), Map.of(), c -> "plugin1");
+
+        // Any class from the current module (unnamed) will do
+        var callerClass = this.getClass();
+        var requestingModule = callerClass.getModule();
+
+        var ex = assertThrows(
+            "No policy for this plugin",
+            NotEntitledException.class,
+            () -> policyManager.getEntitlementsOrThrow(callerClass, requestingModule)
+        );
+
+        assertEquals(
+            "Missing entitlement policy: caller [class org.elasticsearch.entitlement.runtime.policy.PolicyManagerTests], module [null]",
+            ex.getMessage()
+        );
+        assertThat(policyManager.moduleEntitlementsMap, hasEntry(requestingModule, PolicyManager.ModuleEntitlements.NONE));
+    }
+
+    public void testGetEntitlementsFailureIsCached() {
+        var policyManager = new PolicyManager(createEmptyTestServerPolicy(), Map.of(), c -> "plugin1");
+
+        // Any class from the current module (unnamed) will do
+        var callerClass = this.getClass();
+        var requestingModule = callerClass.getModule();
+
+        assertThrows(NotEntitledException.class, () -> policyManager.getEntitlementsOrThrow(callerClass, requestingModule));
+        assertThat(policyManager.moduleEntitlementsMap, hasEntry(requestingModule, PolicyManager.ModuleEntitlements.NONE));
+
+        // A second time
+        var ex = assertThrows(NotEntitledException.class, () -> policyManager.getEntitlementsOrThrow(callerClass, requestingModule));
+
+        assertThat(ex.getMessage(), endsWith("[CACHED]"));
+        // Nothing new in the map
+        assertThat(policyManager.moduleEntitlementsMap, aMapWithSize(1));
+    }
+
+    public void testGetEntitlementsReturnsEntitlementsForPluginUnnamedModule() {
+        var policyManager = new PolicyManager(
+            createEmptyTestServerPolicy(),
+            Map.ofEntries(entry("plugin2", createPluginPolicy(ALL_UNNAMED))),
+            c -> "plugin2"
+        );
+
+        // Any class from the current module (unnamed) will do
+        var callerClass = this.getClass();
+        var requestingModule = callerClass.getModule();
+
+        var entitlements = policyManager.getEntitlementsOrThrow(callerClass, requestingModule);
+        assertThat(entitlements.hasEntitlement(CreateClassLoaderEntitlement.class), is(true));
+    }
+
+    public void testGetEntitlementsThrowsOnMissingPolicyForServer() throws ClassNotFoundException {
+        var policyManager = new PolicyManager(createTestServerPolicy("example"), Map.of(), c -> null);
+
+        // Tests do not run modular, so we cannot use a server class.
+        // But we know that in production code the server module and its classes are in the boot layer.
+        // So we use a random module in the boot layer, and a random class from that module (not java.base -- it is
+        // loaded too early) to mimic a class that would be in the server module.
+        var mockServerClass = ModuleLayer.boot().findLoader("jdk.httpserver").loadClass("com.sun.net.httpserver.HttpServer");
+        var requestingModule = mockServerClass.getModule();
+
+        var ex = assertThrows(
+            "No policy for this module in server",
+            NotEntitledException.class,
+            () -> policyManager.getEntitlementsOrThrow(mockServerClass, requestingModule)
+        );
+
+        assertEquals(
+            "Missing entitlement policy: caller [class com.sun.net.httpserver.HttpServer], module [jdk.httpserver]",
+            ex.getMessage()
+        );
+        assertThat(policyManager.moduleEntitlementsMap, hasEntry(requestingModule, PolicyManager.ModuleEntitlements.NONE));
+    }
+
+    public void testGetEntitlementsReturnsEntitlementsForServerModule() throws ClassNotFoundException {
+        var policyManager = new PolicyManager(createTestServerPolicy("jdk.httpserver"), Map.of(), c -> null);
+
+        // Tests do not run modular, so we cannot use a server class.
+        // But we know that in production code the server module and its classes are in the boot layer.
+        // So we use a random module in the boot layer, and a random class from that module (not java.base -- it is
+        // loaded too early) to mimic a class that would be in the server module.
+        var mockServerClass = ModuleLayer.boot().findLoader("jdk.httpserver").loadClass("com.sun.net.httpserver.HttpServer");
+        var requestingModule = mockServerClass.getModule();
+
+        var entitlements = policyManager.getEntitlementsOrThrow(mockServerClass, requestingModule);
+        assertThat(entitlements.hasEntitlement(CreateClassLoaderEntitlement.class), is(true));
+        assertThat(entitlements.hasEntitlement(ExitVMEntitlement.class), is(true));
+    }
+
+    public void testGetEntitlementsReturnsEntitlementsForPluginModule() throws IOException, ClassNotFoundException {
+        final Path home = createTempDir();
+
+        Path jar = creteMockPluginJar(home);
+
+        var policyManager = new PolicyManager(
+            createEmptyTestServerPolicy(),
+            Map.of("mock-plugin", createPluginPolicy("org.example.plugin")),
+            c -> "mock-plugin"
+        );
+
+        var layer = createLayerForJar(jar, "org.example.plugin");
+        var mockPluginClass = layer.findLoader("org.example.plugin").loadClass("q.B");
+        var requestingModule = mockPluginClass.getModule();
+
+        var entitlements = policyManager.getEntitlementsOrThrow(mockPluginClass, requestingModule);
+        assertThat(entitlements.hasEntitlement(CreateClassLoaderEntitlement.class), is(true));
+        assertThat(
+            entitlements.getEntitlements(FileEntitlement.class).toList(),
+            contains(transformedMatch(FileEntitlement::toString, containsString("/test/path")))
+        );
+    }
+
+    public void testGetEntitlementsResultIsCached() {
+        var policyManager = new PolicyManager(
+            createEmptyTestServerPolicy(),
+            Map.ofEntries(entry("plugin2", createPluginPolicy(ALL_UNNAMED))),
+            c -> "plugin2"
+        );
+
+        // Any class from the current module (unnamed) will do
+        var callerClass = this.getClass();
+        var requestingModule = callerClass.getModule();
+
+        var entitlements = policyManager.getEntitlementsOrThrow(callerClass, requestingModule);
+        assertThat(entitlements.hasEntitlement(CreateClassLoaderEntitlement.class), is(true));
+        assertThat(policyManager.moduleEntitlementsMap, aMapWithSize(1));
+        var cachedResult = policyManager.moduleEntitlementsMap.values().stream().findFirst().get();
+        var entitlementsAgain = policyManager.getEntitlementsOrThrow(callerClass, requestingModule);
+
+        // Nothing new in the map
+        assertThat(policyManager.moduleEntitlementsMap, aMapWithSize(1));
+        assertThat(entitlementsAgain, sameInstance(cachedResult));
+    }
+
+    private static Policy createEmptyTestServerPolicy() {
+        return new Policy("server", List.of());
+    }
+
+    private static Policy createTestServerPolicy(String scopeName) {
+        return new Policy("server", List.of(new Scope(scopeName, List.of(new ExitVMEntitlement(), new CreateClassLoaderEntitlement()))));
+    }
+
+    private static Policy createPluginPolicy(String... pluginModules) {
+        return new Policy(
+            "plugin",
+            Arrays.stream(pluginModules)
+                .map(
+                    name -> new Scope(
+                        name,
+                        List.of(new FileEntitlement("/test/path", List.of(FileEntitlement.READ)), new CreateClassLoaderEntitlement())
+                    )
+                )
+                .toList()
+        );
+    }
+
+    private static Path creteMockPluginJar(Path home) throws IOException {
+        Path jar = home.resolve("mock-plugin.jar");
+
+        Map<String, CharSequence> sources = Map.ofEntries(
+            entry("module-info", "module org.example.plugin { exports q; }"),
+            entry("q.B", "package q; public class B { }")
+        );
+
+        var classToBytes = InMemoryJavaCompiler.compile(sources);
+        JarUtils.createJarWithEntries(
+            jar,
+            Map.ofEntries(entry("module-info.class", classToBytes.get("module-info")), entry("q/B.class", classToBytes.get("q.B")))
+        );
+        return jar;
+    }
+
+    private static ModuleLayer createLayerForJar(Path jar, String moduleName) {
+        Configuration cf = ModuleLayer.boot().configuration().resolve(ModuleFinder.of(jar), ModuleFinder.of(), Set.of(moduleName));
+        var moduleController = ModuleLayer.defineModulesWithOneLoader(
+            cf,
+            List.of(ModuleLayer.boot()),
+            ClassLoader.getPlatformClassLoader()
+        );
+        return moduleController.layer();
+    }
+}
diff --git a/server/src/main/java/org/elasticsearch/bootstrap/Elasticsearch.java b/server/src/main/java/org/elasticsearch/bootstrap/Elasticsearch.java
index c06ea9305aef8..27cbb39c05d38 100644
--- a/server/src/main/java/org/elasticsearch/bootstrap/Elasticsearch.java
+++ b/server/src/main/java/org/elasticsearch/bootstrap/Elasticsearch.java
@@ -42,9 +42,7 @@
 import org.elasticsearch.nativeaccess.NativeAccess;
 import org.elasticsearch.node.Node;
 import org.elasticsearch.node.NodeValidationException;
-import org.elasticsearch.plugins.PluginBundle;
 import org.elasticsearch.plugins.PluginsLoader;
-import org.elasticsearch.plugins.PluginsUtils;
 
 import java.io.IOException;
 import java.io.InputStream;
@@ -54,10 +52,8 @@
 import java.nio.file.Path;
 import java.security.Permission;
 import java.security.Security;
-import java.util.ArrayList;
 import java.util.List;
 import java.util.Objects;
-import java.util.Set;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.TimeUnit;
 
@@ -208,21 +204,17 @@ private static void initPhase2(Bootstrap bootstrap) throws IOException {
         // load the plugin Java modules and layers now for use in entitlements
         var pluginsLoader = PluginsLoader.createPluginsLoader(nodeEnv.modulesFile(), nodeEnv.pluginsFile());
         bootstrap.setPluginsLoader(pluginsLoader);
+        var pluginsResolver = PluginsResolver.create(pluginsLoader);
 
         if (Boolean.parseBoolean(System.getProperty("es.entitlements.enabled"))) {
             LogManager.getLogger(Elasticsearch.class).info("Bootstrapping Entitlements");
 
-            List<Tuple<Path, Boolean>> pluginData = new ArrayList<>();
-            Set<PluginBundle> moduleBundles = PluginsUtils.getModuleBundles(nodeEnv.modulesFile());
-            for (PluginBundle moduleBundle : moduleBundles) {
-                pluginData.add(Tuple.tuple(moduleBundle.getDir(), moduleBundle.pluginDescriptor().isModular()));
-            }
-            Set<PluginBundle> pluginBundles = PluginsUtils.getPluginBundles(nodeEnv.pluginsFile());
-            for (PluginBundle pluginBundle : pluginBundles) {
-                pluginData.add(Tuple.tuple(pluginBundle.getDir(), pluginBundle.pluginDescriptor().isModular()));
-            }
-            // TODO: add a functor to map module to plugin name
-            EntitlementBootstrap.bootstrap(pluginData, callerClass -> null);
+            List<Tuple<Path, Boolean>> pluginData = pluginsLoader.allBundles()
+                .stream()
+                .map(bundle -> Tuple.tuple(bundle.getDir(), bundle.pluginDescriptor().isModular()))
+                .toList();
+
+            EntitlementBootstrap.bootstrap(pluginData, pluginsResolver::resolveClassToPluginName);
         } else {
             // install SM after natives, shutdown hooks, etc.
             LogManager.getLogger(Elasticsearch.class).info("Bootstrapping java SecurityManager");
diff --git a/server/src/main/java/org/elasticsearch/bootstrap/PluginsResolver.java b/server/src/main/java/org/elasticsearch/bootstrap/PluginsResolver.java
new file mode 100644
index 0000000000000..256e91cbee16d
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/bootstrap/PluginsResolver.java
@@ -0,0 +1,47 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.bootstrap;
+
+import org.elasticsearch.plugins.PluginsLoader;
+
+import java.util.HashMap;
+import java.util.Map;
+
+class PluginsResolver {
+    private final Map<Module, String> pluginNameByModule;
+
+    private PluginsResolver(Map<Module, String> pluginNameByModule) {
+        this.pluginNameByModule = pluginNameByModule;
+    }
+
+    public static PluginsResolver create(PluginsLoader pluginsLoader) {
+        Map<Module, String> pluginNameByModule = new HashMap<>();
+
+        pluginsLoader.pluginLayers().forEach(pluginLayer -> {
+            var pluginName = pluginLayer.pluginBundle().pluginDescriptor().getName();
+            if (pluginLayer.pluginModuleLayer() != null && pluginLayer.pluginModuleLayer() != ModuleLayer.boot()) {
+                // This plugin is a Java Module
+                for (var module : pluginLayer.pluginModuleLayer().modules()) {
+                    pluginNameByModule.put(module, pluginName);
+                }
+            } else {
+                // This plugin is not modularized
+                pluginNameByModule.put(pluginLayer.pluginClassLoader().getUnnamedModule(), pluginName);
+            }
+        });
+
+        return new PluginsResolver(pluginNameByModule);
+    }
+
+    public String resolveClassToPluginName(Class<?> clazz) {
+        var module = clazz.getModule();
+        return pluginNameByModule.get(module);
+    }
+}
diff --git a/server/src/main/java/org/elasticsearch/plugins/PluginsLoader.java b/server/src/main/java/org/elasticsearch/plugins/PluginsLoader.java
index aa21e5c64d903..aadda93f977b6 100644
--- a/server/src/main/java/org/elasticsearch/plugins/PluginsLoader.java
+++ b/server/src/main/java/org/elasticsearch/plugins/PluginsLoader.java
@@ -50,7 +50,6 @@
  * to have all the plugin information they need prior to starting.
  */
 public class PluginsLoader {
-
     /**
      * Contains information about the {@link ClassLoader} required to load a plugin
      */
@@ -64,18 +63,26 @@ public interface PluginLayer {
          * @return The {@link ClassLoader} used to instantiate the main class for the plugin
          */
         ClassLoader pluginClassLoader();
+
+        /**
+         * @return The {@link ModuleLayer} for the plugin modules
+         */
+        ModuleLayer pluginModuleLayer();
     }
 
     /**
      * Contains information about the {@link ClassLoader}s and {@link ModuleLayer} required for loading a plugin
-     * @param pluginBundle Information about the bundle of jars used in this plugin
+     *
+     * @param pluginBundle      Information about the bundle of jars used in this plugin
      * @param pluginClassLoader The {@link ClassLoader} used to instantiate the main class for the plugin
-     * @param spiClassLoader The exported {@link ClassLoader} visible to other Java modules
-     * @param spiModuleLayer The exported {@link ModuleLayer} visible to other Java modules
+     * @param pluginModuleLayer The {@link ModuleLayer} containing the Java modules of the plugin
+     * @param spiClassLoader    The exported {@link ClassLoader} visible to other Java modules
+     * @param spiModuleLayer    The exported {@link ModuleLayer} visible to other Java modules
      */
     private record LoadedPluginLayer(
         PluginBundle pluginBundle,
         ClassLoader pluginClassLoader,
+        ModuleLayer pluginModuleLayer,
         ClassLoader spiClassLoader,
         ModuleLayer spiModuleLayer
     ) implements PluginLayer {
@@ -103,6 +110,10 @@ public record LayerAndLoader(ModuleLayer layer, ClassLoader loader) {
         public static LayerAndLoader ofLoader(ClassLoader loader) {
             return new LayerAndLoader(ModuleLayer.boot(), loader);
         }
+
+        public static LayerAndLoader ofUberModuleLoader(UberModuleClassLoader loader) {
+            return new LayerAndLoader(loader.getLayer(), loader);
+        }
     }
 
     private static final Logger logger = LogManager.getLogger(PluginsLoader.class);
@@ -111,6 +122,7 @@ public static LayerAndLoader ofLoader(ClassLoader loader) {
     private final List<PluginDescriptor> moduleDescriptors;
     private final List<PluginDescriptor> pluginDescriptors;
     private final Map<String, LoadedPluginLayer> loadedPluginLayers;
+    private final Set<PluginBundle> allBundles;
 
     /**
      * Constructs a new PluginsLoader
@@ -185,17 +197,19 @@ public static PluginsLoader createPluginsLoader(Path modulesDirectory, Path plug
             }
         }
 
-        return new PluginsLoader(moduleDescriptors, pluginDescriptors, loadedPluginLayers);
+        return new PluginsLoader(moduleDescriptors, pluginDescriptors, loadedPluginLayers, Set.copyOf(seenBundles));
     }
 
     PluginsLoader(
         List<PluginDescriptor> moduleDescriptors,
         List<PluginDescriptor> pluginDescriptors,
-        Map<String, LoadedPluginLayer> loadedPluginLayers
+        Map<String, LoadedPluginLayer> loadedPluginLayers,
+        Set<PluginBundle> allBundles
     ) {
         this.moduleDescriptors = moduleDescriptors;
         this.pluginDescriptors = pluginDescriptors;
         this.loadedPluginLayers = loadedPluginLayers;
+        this.allBundles = allBundles;
     }
 
     public List<PluginDescriptor> moduleDescriptors() {
@@ -210,6 +224,10 @@ public Stream<PluginLayer> pluginLayers() {
         return loadedPluginLayers.values().stream().map(Function.identity());
     }
 
+    public Set<PluginBundle> allBundles() {
+        return allBundles;
+    }
+
     private static void loadPluginLayer(
         PluginBundle bundle,
         Map<String, LoadedPluginLayer> loaded,
@@ -239,7 +257,7 @@ private static void loadPluginLayer(
         }
 
         final ClassLoader pluginParentLoader = spiLayerAndLoader == null ? parentLoader : spiLayerAndLoader.loader();
-        final LayerAndLoader pluginLayerAndLoader = createPlugin(
+        final LayerAndLoader pluginLayerAndLoader = createPluginLayerAndLoader(
             bundle,
             pluginParentLoader,
             extendedPlugins,
@@ -253,7 +271,16 @@ private static void loadPluginLayer(
             spiLayerAndLoader = pluginLayerAndLoader;
         }
 
-        loaded.put(name, new LoadedPluginLayer(bundle, pluginClassLoader, spiLayerAndLoader.loader, spiLayerAndLoader.layer));
+        loaded.put(
+            name,
+            new LoadedPluginLayer(
+                bundle,
+                pluginClassLoader,
+                pluginLayerAndLoader.layer(),
+                spiLayerAndLoader.loader,
+                spiLayerAndLoader.layer
+            )
+        );
     }
 
     static LayerAndLoader createSPI(
@@ -277,7 +304,7 @@ static LayerAndLoader createSPI(
         }
     }
 
-    static LayerAndLoader createPlugin(
+    private static LayerAndLoader createPluginLayerAndLoader(
         PluginBundle bundle,
         ClassLoader pluginParentLoader,
         List<LoadedPluginLayer> extendedPlugins,
@@ -294,7 +321,7 @@ static LayerAndLoader createPlugin(
             return createPluginModuleLayer(bundle, pluginParentLoader, parentLayers, qualifiedExports);
         } else if (plugin.isStable()) {
             logger.debug(() -> "Loading bundle: " + plugin.getName() + ", non-modular as synthetic module");
-            return LayerAndLoader.ofLoader(
+            return LayerAndLoader.ofUberModuleLoader(
                 UberModuleClassLoader.getInstance(
                     pluginParentLoader,
                     ModuleLayer.boot(),
diff --git a/server/src/test/java/org/elasticsearch/bootstrap/PluginsResolverTests.java b/server/src/test/java/org/elasticsearch/bootstrap/PluginsResolverTests.java
new file mode 100644
index 0000000000000..331f0f7ad13e9
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/bootstrap/PluginsResolverTests.java
@@ -0,0 +1,254 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.bootstrap;
+
+import org.elasticsearch.plugins.PluginBundle;
+import org.elasticsearch.plugins.PluginDescriptor;
+import org.elasticsearch.plugins.PluginsLoader;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.test.compiler.InMemoryJavaCompiler;
+import org.elasticsearch.test.jar.JarUtils;
+
+import java.io.IOException;
+import java.lang.module.Configuration;
+import java.lang.module.ModuleFinder;
+import java.net.MalformedURLException;
+import java.net.URL;
+import java.net.URLClassLoader;
+import java.nio.file.Path;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.stream.Stream;
+
+import static java.util.Map.entry;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+
+@ESTestCase.WithoutSecurityManager
+public class PluginsResolverTests extends ESTestCase {
+
+    private record TestPluginLayer(PluginBundle pluginBundle, ClassLoader pluginClassLoader, ModuleLayer pluginModuleLayer)
+        implements
+            PluginsLoader.PluginLayer {}
+
+    public void testResolveModularPlugin() throws IOException, ClassNotFoundException {
+        String moduleName = "modular.plugin";
+        String pluginName = "modular-plugin";
+
+        final Path home = createTempDir();
+
+        Path jar = createModularPluginJar(home, pluginName, moduleName, "p", "A");
+
+        var layer = createModuleLayer(moduleName, jar);
+        var loader = layer.findLoader(moduleName);
+
+        PluginBundle bundle = createMockBundle(pluginName, moduleName, "p.A");
+        PluginsLoader mockPluginsLoader = mock(PluginsLoader.class);
+
+        when(mockPluginsLoader.pluginLayers()).thenReturn(Stream.of(new TestPluginLayer(bundle, loader, layer)));
+        PluginsResolver pluginsResolver = PluginsResolver.create(mockPluginsLoader);
+
+        var testClass = loader.loadClass("p.A");
+        var resolvedPluginName = pluginsResolver.resolveClassToPluginName(testClass);
+        var unresolvedPluginName1 = pluginsResolver.resolveClassToPluginName(PluginsResolver.class);
+        var unresolvedPluginName2 = pluginsResolver.resolveClassToPluginName(String.class);
+
+        assertEquals(pluginName, resolvedPluginName);
+        assertNull(unresolvedPluginName1);
+        assertNull(unresolvedPluginName2);
+    }
+
+    public void testResolveMultipleModularPlugins() throws IOException, ClassNotFoundException {
+        final Path home = createTempDir();
+
+        Path jar1 = createModularPluginJar(home, "plugin1", "module.one", "p", "A");
+        Path jar2 = createModularPluginJar(home, "plugin2", "module.two", "q", "B");
+
+        var layer1 = createModuleLayer("module.one", jar1);
+        var loader1 = layer1.findLoader("module.one");
+        var layer2 = createModuleLayer("module.two", jar2);
+        var loader2 = layer2.findLoader("module.two");
+
+        PluginBundle bundle1 = createMockBundle("plugin1", "module.one", "p.A");
+        PluginBundle bundle2 = createMockBundle("plugin2", "module.two", "q.B");
+        PluginsLoader mockPluginsLoader = mock(PluginsLoader.class);
+
+        when(mockPluginsLoader.pluginLayers()).thenReturn(
+            Stream.of(new TestPluginLayer(bundle1, loader1, layer1), new TestPluginLayer(bundle2, loader2, layer2))
+        );
+        PluginsResolver pluginsResolver = PluginsResolver.create(mockPluginsLoader);
+
+        var testClass1 = loader1.loadClass("p.A");
+        var testClass2 = loader2.loadClass("q.B");
+        var resolvedPluginName1 = pluginsResolver.resolveClassToPluginName(testClass1);
+        var resolvedPluginName2 = pluginsResolver.resolveClassToPluginName(testClass2);
+
+        assertEquals("plugin1", resolvedPluginName1);
+        assertEquals("plugin2", resolvedPluginName2);
+    }
+
+    public void testResolveReferencedModulesInModularPlugins() throws IOException, ClassNotFoundException {
+        final Path home = createTempDir();
+
+        Path dependencyJar = createModularPluginJar(home, "plugin1", "module.one", "p", "A");
+        Path pluginJar = home.resolve("plugin2.jar");
+
+        Map<String, CharSequence> sources = Map.ofEntries(
+            entry("module-info", "module module.two { exports q; requires module.one; }"),
+            entry("q.B", "package q; public class B { public p.A a = null; }")
+        );
+
+        var classToBytes = InMemoryJavaCompiler.compile(sources, "--add-modules", "module.one", "-p", home.toString());
+        JarUtils.createJarWithEntries(
+            pluginJar,
+            Map.ofEntries(entry("module-info.class", classToBytes.get("module-info")), entry("q/B.class", classToBytes.get("q.B")))
+        );
+
+        var layer = createModuleLayer("module.two", pluginJar, dependencyJar);
+        var loader = layer.findLoader("module.two");
+
+        PluginBundle bundle = createMockBundle("plugin2", "module.two", "q.B");
+        PluginsLoader mockPluginsLoader = mock(PluginsLoader.class);
+
+        when(mockPluginsLoader.pluginLayers()).thenReturn(Stream.of(new TestPluginLayer(bundle, loader, layer)));
+        PluginsResolver pluginsResolver = PluginsResolver.create(mockPluginsLoader);
+
+        var testClass1 = loader.loadClass("p.A");
+        var testClass2 = loader.loadClass("q.B");
+        var resolvedPluginName1 = pluginsResolver.resolveClassToPluginName(testClass1);
+        var resolvedPluginName2 = pluginsResolver.resolveClassToPluginName(testClass2);
+
+        assertEquals("plugin2", resolvedPluginName1);
+        assertEquals("plugin2", resolvedPluginName2);
+    }
+
+    public void testResolveMultipleNonModularPlugins() throws IOException, ClassNotFoundException {
+        final Path home = createTempDir();
+
+        Path jar1 = createNonModularPluginJar(home, "plugin1", "p", "A");
+        Path jar2 = createNonModularPluginJar(home, "plugin2", "q", "B");
+
+        var loader1 = createClassLoader(jar1);
+        var loader2 = createClassLoader(jar2);
+
+        PluginBundle bundle1 = createMockBundle("plugin1", null, "p.A");
+        PluginBundle bundle2 = createMockBundle("plugin2", null, "q.B");
+        PluginsLoader mockPluginsLoader = mock(PluginsLoader.class);
+
+        when(mockPluginsLoader.pluginLayers()).thenReturn(
+            Stream.of(new TestPluginLayer(bundle1, loader1, ModuleLayer.boot()), new TestPluginLayer(bundle2, loader2, ModuleLayer.boot()))
+        );
+        PluginsResolver pluginsResolver = PluginsResolver.create(mockPluginsLoader);
+
+        var testClass1 = loader1.loadClass("p.A");
+        var testClass2 = loader2.loadClass("q.B");
+        var resolvedPluginName1 = pluginsResolver.resolveClassToPluginName(testClass1);
+        var resolvedPluginName2 = pluginsResolver.resolveClassToPluginName(testClass2);
+
+        assertEquals("plugin1", resolvedPluginName1);
+        assertEquals("plugin2", resolvedPluginName2);
+    }
+
+    public void testResolveNonModularPlugin() throws IOException, ClassNotFoundException {
+        String pluginName = "non-modular-plugin";
+
+        final Path home = createTempDir();
+
+        Path jar = createNonModularPluginJar(home, pluginName, "p", "A");
+
+        var loader = createClassLoader(jar);
+
+        PluginBundle bundle = createMockBundle(pluginName, null, "p.A");
+        PluginsLoader mockPluginsLoader = mock(PluginsLoader.class);
+
+        when(mockPluginsLoader.pluginLayers()).thenReturn(Stream.of(new TestPluginLayer(bundle, loader, ModuleLayer.boot())));
+        PluginsResolver pluginsResolver = PluginsResolver.create(mockPluginsLoader);
+
+        var testClass = loader.loadClass("p.A");
+        var resolvedPluginName = pluginsResolver.resolveClassToPluginName(testClass);
+        var unresolvedPluginName1 = pluginsResolver.resolveClassToPluginName(PluginsResolver.class);
+        var unresolvedPluginName2 = pluginsResolver.resolveClassToPluginName(String.class);
+
+        assertEquals(pluginName, resolvedPluginName);
+        assertNull(unresolvedPluginName1);
+        assertNull(unresolvedPluginName2);
+    }
+
+    private static URLClassLoader createClassLoader(Path jar) throws MalformedURLException {
+        return new URLClassLoader(new URL[] { jar.toUri().toURL() });
+    }
+
+    private static ModuleLayer createModuleLayer(String moduleName, Path... jars) {
+        var finder = ModuleFinder.of(jars);
+        Configuration cf = ModuleLayer.boot().configuration().resolve(finder, ModuleFinder.of(), Set.of(moduleName));
+        var moduleController = ModuleLayer.defineModulesWithOneLoader(
+            cf,
+            List.of(ModuleLayer.boot()),
+            ClassLoader.getPlatformClassLoader()
+        );
+        return moduleController.layer();
+    }
+
+    private static PluginBundle createMockBundle(String pluginName, String moduleName, String fqClassName) {
+        PluginDescriptor pd = new PluginDescriptor(
+            pluginName,
+            null,
+            null,
+            null,
+            null,
+            fqClassName,
+            moduleName,
+            List.of(),
+            false,
+            false,
+            true,
+            false
+        );
+
+        PluginBundle bundle = mock(PluginBundle.class);
+        when(bundle.pluginDescriptor()).thenReturn(pd);
+        return bundle;
+    }
+
+    private static Path createModularPluginJar(Path home, String pluginName, String moduleName, String packageName, String className)
+        throws IOException {
+        Path jar = home.resolve(pluginName + ".jar");
+        String fqClassName = packageName + "." + className;
+
+        Map<String, CharSequence> sources = Map.ofEntries(
+            entry("module-info", "module " + moduleName + " { exports " + packageName + "; }"),
+            entry(fqClassName, "package " + packageName + "; public class " + className + " {}")
+        );
+
+        var classToBytes = InMemoryJavaCompiler.compile(sources);
+        JarUtils.createJarWithEntries(
+            jar,
+            Map.ofEntries(
+                entry("module-info.class", classToBytes.get("module-info")),
+                entry(packageName + "/" + className + ".class", classToBytes.get(fqClassName))
+            )
+        );
+        return jar;
+    }
+
+    private static Path createNonModularPluginJar(Path home, String pluginName, String packageName, String className) throws IOException {
+        Path jar = home.resolve(pluginName + ".jar");
+        String fqClassName = packageName + "." + className;
+
+        Map<String, CharSequence> sources = Map.ofEntries(
+            entry(fqClassName, "package " + packageName + "; public class " + className + " {}")
+        );
+
+        var classToBytes = InMemoryJavaCompiler.compile(sources);
+        JarUtils.createJarWithEntries(jar, Map.ofEntries(entry(packageName + "/" + className + ".class", classToBytes.get(fqClassName))));
+        return jar;
+    }
+}
diff --git a/test/framework/src/main/java/org/elasticsearch/plugins/MockPluginsService.java b/test/framework/src/main/java/org/elasticsearch/plugins/MockPluginsService.java
index a9a825af3b865..91875600ec000 100644
--- a/test/framework/src/main/java/org/elasticsearch/plugins/MockPluginsService.java
+++ b/test/framework/src/main/java/org/elasticsearch/plugins/MockPluginsService.java
@@ -45,7 +45,7 @@ public MockPluginsService(Settings settings, Environment environment, Collection
         super(
             settings,
             environment.configFile(),
-            new PluginsLoader(Collections.emptyList(), Collections.emptyList(), Collections.emptyMap())
+            new PluginsLoader(Collections.emptyList(), Collections.emptyList(), Collections.emptyMap(), Collections.emptySet())
         );
 
         List<LoadedPlugin> pluginsLoaded = new ArrayList<>();

From 14d9e7c1f5d8ba7a2d30f1a28735c3bf803abc15 Mon Sep 17 00:00:00 2001
From: Luigi Dell'Aquila <luigi.dellaquila@gmail.com>
Date: Thu, 5 Dec 2024 11:24:27 +0100
Subject: [PATCH 041/119] ES|QL: Fix ESQL usage output (telemetry) non-snapshot
 version test (#118051)

---
 muted-tests.yml                                                | 3 ---
 .../resources/rest-api-spec/test/esql/60_usage.yml             | 2 +-
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index de18c08337e11..f525607a848d0 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -248,9 +248,6 @@ tests:
 - class: org.elasticsearch.index.reindex.ReindexNodeShutdownIT
   method: testReindexWithShutdown
   issue: https://github.com/elastic/elasticsearch/issues/118040
-- class: org.elasticsearch.xpack.test.rest.XPackRestIT
-  method: test {p0=esql/60_usage/Basic ESQL usage output (telemetry) non-snapshot version}
-  issue: https://github.com/elastic/elasticsearch/issues/117862
 
 # Examples:
 #
diff --git a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml
index 26e3c8ed0ef47..e6c061f44a9e4 100644
--- a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml
+++ b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml
@@ -163,4 +163,4 @@ setup:
   - match: {esql.functions.cos: $functions_cos}
   - gt: {esql.functions.to_long: $functions_to_long}
   - match: {esql.functions.coalesce: $functions_coalesce}
-  - length: {esql.functions: 123} # check the "sister" test above for a likely update to the same esql.functions length check
+  - length: {esql.functions: 124} # check the "sister" test above for a likely update to the same esql.functions length check

From e4defcaec3f2433fda2d0187543417e679570b37 Mon Sep 17 00:00:00 2001
From: Alexander Spies <alexander.spies@elastic.co>
Date: Thu, 5 Dec 2024 11:43:56 +0100
Subject: [PATCH 042/119] ESQL: Small LOOKUP JOIN cleanups (#117922)

* Simplify InsertFieldExtraction
* Fix wrong error message when looping ResolveRefs
* Add basic verification tests
* Add check for data type mismatch
---
 .../src/main/resources/lookup-join.csv-spec   | 31 ++++++++++
 .../xpack/esql/analysis/Analyzer.java         |  9 +--
 .../xpack/esql/analysis/AnalyzerContext.java  |  8 ++-
 .../xpack/esql/analysis/Verifier.java         | 48 ++++++++++------
 .../physical/local/InsertFieldExtraction.java | 20 ++-----
 .../esql/planner/LocalExecutionPlanner.java   |  9 ---
 .../xpack/esql/session/EsqlSession.java       |  3 +-
 .../esql/analysis/AnalyzerTestUtils.java      | 29 ++++++++--
 .../xpack/esql/analysis/AnalyzerTests.java    | 56 +++++++++++++++++++
 .../xpack/esql/analysis/VerifierTests.java    | 11 ++++
 10 files changed, 173 insertions(+), 51 deletions(-)

diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
index 712cadf6d44fd..584cde55080ef 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
@@ -120,6 +120,19 @@ left:keyword | client_ip:keyword | right:keyword | env:keyword
 left         | 172.21.0.5        | right         | Development
 ;
 
+lookupIPFromRowWithShadowingKeepReordered
+required_capability: join_lookup_v4
+
+ROW left = "left", client_ip = "172.21.0.5", env = "env", right = "right"
+| EVAL client_ip = client_ip::keyword
+| LOOKUP JOIN clientips_lookup ON client_ip
+| KEEP right, env, client_ip
+;
+
+right:keyword | env:keyword | client_ip:keyword
+right         | Development | 172.21.0.5
+;
+
 lookupIPFromIndex
 required_capability: join_lookup_v4
 
@@ -263,6 +276,24 @@ ignoreOrder:true;
 2023-10-23T12:15:03.360Z | 172.21.2.162 | 3450233             | Connected to 10.1.0.3 | Success
 ;
 
+lookupMessageFromIndexKeepReordered
+required_capability: join_lookup_v4
+
+FROM sample_data
+| LOOKUP JOIN message_types_lookup ON message
+| KEEP type, client_ip, event_duration, message
+;
+
+type:keyword | client_ip:ip | event_duration:long | message:keyword
+Success      | 172.21.3.15  | 1756467             | Connected to 10.1.0.1
+Error        | 172.21.3.15  | 5033755             | Connection error
+Error        | 172.21.3.15  | 8268153             | Connection error
+Error        | 172.21.3.15  | 725448              | Connection error
+Disconnected | 172.21.0.5   | 1232382             | Disconnected
+Success      | 172.21.2.113 | 2764889             | Connected to 10.1.0.2
+Success      | 172.21.2.162 | 3450233             | Connected to 10.1.0.3
+;
+
 lookupMessageFromIndexStats
 required_capability: join_lookup_v4
 
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java
index b847508d2b161..cf91c7df9a034 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Analyzer.java
@@ -633,9 +633,10 @@ private Join resolveLookupJoin(LookupJoin join) {
 
                 config = new JoinConfig(coreJoin, leftKeys, leftKeys, rightKeys);
                 join = new LookupJoin(join.source(), join.left(), join.right(), config);
-            }
-            // everything else is unsupported for now
-            else {
+            } else if (type != JoinTypes.LEFT) {
+                // everything else is unsupported for now
+                // LEFT can only happen by being mapped from a USING above. So we need to exclude this as well because this rule can be run
+                // more than once.
                 UnresolvedAttribute errorAttribute = new UnresolvedAttribute(join.source(), "unsupported", "Unsupported join type");
                 // add error message
                 return join.withConfig(new JoinConfig(type, singletonList(errorAttribute), emptyList(), emptyList()));
@@ -651,7 +652,7 @@ private List<Attribute> resolveUsingColumns(List<Attribute> cols, List<Attribute
                     if (resolvedCol instanceof UnresolvedAttribute ucol) {
                         String message = ua.unresolvedMessage();
                         String match = "column [" + ucol.name() + "]";
-                        resolvedCol = ucol.withUnresolvedMessage(message.replace(match, match + "in " + side + " side of join"));
+                        resolvedCol = ucol.withUnresolvedMessage(message.replace(match, match + " in " + side + " side of join"));
                     }
                     resolved.add(resolvedCol);
                 }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/AnalyzerContext.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/AnalyzerContext.java
index c6f24d3abf393..ea6e5ed425711 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/AnalyzerContext.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/AnalyzerContext.java
@@ -26,6 +26,12 @@ public AnalyzerContext(
         IndexResolution indexResolution,
         EnrichResolution enrichResolution
     ) {
-        this(configuration, functionRegistry, indexResolution, IndexResolution.invalid("<none>"), enrichResolution);
+        this(
+            configuration,
+            functionRegistry,
+            indexResolution,
+            IndexResolution.invalid("AnalyzerContext constructed without any lookup join resolution"),
+            enrichResolution
+        );
     }
 }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java
index 49d8a5ee8caad..f5fd82d742bc7 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java
@@ -7,7 +7,6 @@
 
 package org.elasticsearch.xpack.esql.analysis;
 
-import org.elasticsearch.index.IndexMode;
 import org.elasticsearch.license.XPackLicenseState;
 import org.elasticsearch.xpack.esql.action.EsqlCapabilities;
 import org.elasticsearch.xpack.esql.common.Failure;
@@ -55,7 +54,8 @@
 import org.elasticsearch.xpack.esql.plan.logical.RegexExtract;
 import org.elasticsearch.xpack.esql.plan.logical.Row;
 import org.elasticsearch.xpack.esql.plan.logical.UnaryPlan;
-import org.elasticsearch.xpack.esql.plan.logical.join.LookupJoin;
+import org.elasticsearch.xpack.esql.plan.logical.join.Join;
+import org.elasticsearch.xpack.esql.plan.logical.join.JoinConfig;
 import org.elasticsearch.xpack.esql.stats.FeatureMetric;
 import org.elasticsearch.xpack.esql.stats.Metrics;
 
@@ -172,20 +172,6 @@ else if (p instanceof Lookup lookup) {
                 else {
                     lookup.matchFields().forEach(unresolvedExpressions);
                 }
-            } else if (p instanceof LookupJoin lj) {
-                // expect right side to always be a lookup index
-                lj.right().forEachUp(EsRelation.class, r -> {
-                    if (r.indexMode() != IndexMode.LOOKUP) {
-                        failures.add(
-                            fail(
-                                r,
-                                "LOOKUP JOIN right side [{}] must be a lookup index (index_mode=lookup, not [{}]",
-                                r.index().name(),
-                                r.indexMode().getName()
-                            )
-                        );
-                    }
-                });
             }
 
             else {
@@ -217,6 +203,7 @@ else if (p instanceof Lookup lookup) {
             checkSort(p, failures);
 
             checkFullTextQueryFunctions(p, failures);
+            checkJoin(p, failures);
         });
         checkRemoteEnrich(plan, failures);
         checkMetadataScoreNameReserved(plan, failures);
@@ -791,6 +778,35 @@ private static void checkNotPresentInDisjunctions(
         });
     }
 
+    /**
+     * Checks Joins for invalid usage.
+     *
+     * @param plan root plan to check
+     * @param failures failures found
+     */
+    private static void checkJoin(LogicalPlan plan, Set<Failure> failures) {
+        if (plan instanceof Join join) {
+            JoinConfig config = join.config();
+            for (int i = 0; i < config.leftFields().size(); i++) {
+                Attribute leftField = config.leftFields().get(i);
+                Attribute rightField = config.rightFields().get(i);
+                if (leftField.dataType() != rightField.dataType()) {
+                    failures.add(
+                        fail(
+                            leftField,
+                            "JOIN left field [{}] of type [{}] is incompatible with right field [{}] of type [{}]",
+                            leftField.name(),
+                            leftField.dataType(),
+                            rightField.name(),
+                            rightField.dataType()
+                        )
+                    );
+                }
+            }
+
+        }
+    }
+
     /**
      * Checks full text query functions for invalid usage.
      *
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/physical/local/InsertFieldExtraction.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/physical/local/InsertFieldExtraction.java
index dc32a4ad3c282..ed8851b64c27e 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/physical/local/InsertFieldExtraction.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/physical/local/InsertFieldExtraction.java
@@ -11,14 +11,12 @@
 import org.elasticsearch.xpack.esql.core.expression.Expressions;
 import org.elasticsearch.xpack.esql.core.expression.FieldAttribute;
 import org.elasticsearch.xpack.esql.core.expression.MetadataAttribute;
-import org.elasticsearch.xpack.esql.core.expression.TypedAttribute;
 import org.elasticsearch.xpack.esql.expression.function.grouping.Categorize;
 import org.elasticsearch.xpack.esql.optimizer.rules.physical.ProjectAwayColumns;
 import org.elasticsearch.xpack.esql.plan.physical.AggregateExec;
 import org.elasticsearch.xpack.esql.plan.physical.EsQueryExec;
 import org.elasticsearch.xpack.esql.plan.physical.FieldExtractExec;
 import org.elasticsearch.xpack.esql.plan.physical.LeafExec;
-import org.elasticsearch.xpack.esql.plan.physical.LookupJoinExec;
 import org.elasticsearch.xpack.esql.plan.physical.PhysicalPlan;
 import org.elasticsearch.xpack.esql.rule.Rule;
 
@@ -102,25 +100,17 @@ private static Set<Attribute> missingAttributes(PhysicalPlan p) {
         var missing = new LinkedHashSet<Attribute>();
         var input = p.inputSet();
 
-        // For LOOKUP JOIN we only need field-extraction on left fields used to match, since the right side is always materialized
-        if (p instanceof LookupJoinExec join) {
-            join.leftFields().forEach(f -> {
-                if (input.contains(f) == false) {
-                    missing.add(f);
-                }
-            });
-            return missing;
-        }
-
-        // collect field attributes used inside expressions
-        // TODO: Rather than going over all expressions manually, this should just call .references()
-        p.forEachExpression(TypedAttribute.class, f -> {
+        // Collect field attributes referenced by this plan but not yet present in the child's output.
+        // This is also correct for LookupJoinExec, where we only need field extraction on the left fields used to match, since the right
+        // side is always materialized.
+        p.references().forEach(f -> {
             if (f instanceof FieldAttribute || f instanceof MetadataAttribute) {
                 if (input.contains(f) == false) {
                     missing.add(f);
                 }
             }
         });
+
         return missing;
     }
 }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/LocalExecutionPlanner.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/LocalExecutionPlanner.java
index 8c0488afdd42a..b85340936497e 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/LocalExecutionPlanner.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/LocalExecutionPlanner.java
@@ -565,21 +565,12 @@ private PhysicalOperation planHashJoin(HashJoinExec join, LocalExecutionPlannerC
 
     private PhysicalOperation planLookupJoin(LookupJoinExec join, LocalExecutionPlannerContext context) {
         PhysicalOperation source = plan(join.left(), context);
-        // TODO: The source builder includes incoming fields including the ones we're going to drop
         Layout.Builder layoutBuilder = source.layout.builder();
         for (Attribute f : join.addedFields()) {
             layoutBuilder.append(f);
         }
         Layout layout = layoutBuilder.build();
 
-        // TODO: this works when the join happens on the coordinator
-        /*
-         * But when it happens on the data node we get a
-         * \_FieldExtractExec[language_code{f}#15, language_name{f}#16]<[]>
-         *   \_EsQueryExec[languages_lookup], indexMode[lookup], query[][_doc{f}#18], limit[], sort[] estimatedRowSize[62]
-         * Which we'd prefer not to do - at least for now. We already know the fields we're loading
-         * and don't want any local planning.
-         */
         EsQueryExec localSourceExec = (EsQueryExec) join.lookup();
         if (localSourceExec.indexMode() != IndexMode.LOOKUP) {
             throw new IllegalArgumentException("can't plan [" + join + "]");
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/EsqlSession.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/EsqlSession.java
index 71fba5683644d..4f7c620bc8d12 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/EsqlSession.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/session/EsqlSession.java
@@ -374,10 +374,11 @@ private void preAnalyzeLookupIndices(List<TableInfo> indices, ListenerResult lis
             // call the EsqlResolveFieldsAction (field-caps) to resolve indices and get field types
             indexResolver.resolveAsMergedMapping(
                 table.index(),
-                Set.of("*"), // Current LOOKUP JOIN syntax does not allow for field selection
+                Set.of("*"), // TODO: for LOOKUP JOIN, this currently declares all lookup index fields relevant and might fetch too many.
                 null,
                 listener.map(indexResolution -> listenerResult.withLookupIndexResolution(indexResolution))
             );
+            // TODO: Verify that the resolved index actually has indexMode: "lookup"
         } else {
             try {
                 // No lookup indices specified
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTestUtils.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTestUtils.java
index a63ee53cdd498..4e89a09db9ed4 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTestUtils.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTestUtils.java
@@ -38,7 +38,7 @@ public static Analyzer defaultAnalyzer() {
     }
 
     public static Analyzer expandedDefaultAnalyzer() {
-        return analyzer(analyzerExpandedDefaultMapping());
+        return analyzer(expandedDefaultIndexResolution());
     }
 
     public static Analyzer analyzer(IndexResolution indexResolution) {
@@ -47,18 +47,33 @@ public static Analyzer analyzer(IndexResolution indexResolution) {
 
     public static Analyzer analyzer(IndexResolution indexResolution, Verifier verifier) {
         return new Analyzer(
-            new AnalyzerContext(EsqlTestUtils.TEST_CFG, new EsqlFunctionRegistry(), indexResolution, defaultEnrichResolution()),
+            new AnalyzerContext(
+                EsqlTestUtils.TEST_CFG,
+                new EsqlFunctionRegistry(),
+                indexResolution,
+                defaultLookupResolution(),
+                defaultEnrichResolution()
+            ),
             verifier
         );
     }
 
     public static Analyzer analyzer(IndexResolution indexResolution, Verifier verifier, Configuration config) {
-        return new Analyzer(new AnalyzerContext(config, new EsqlFunctionRegistry(), indexResolution, defaultEnrichResolution()), verifier);
+        return new Analyzer(
+            new AnalyzerContext(config, new EsqlFunctionRegistry(), indexResolution, defaultLookupResolution(), defaultEnrichResolution()),
+            verifier
+        );
     }
 
     public static Analyzer analyzer(Verifier verifier) {
         return new Analyzer(
-            new AnalyzerContext(EsqlTestUtils.TEST_CFG, new EsqlFunctionRegistry(), analyzerDefaultMapping(), defaultEnrichResolution()),
+            new AnalyzerContext(
+                EsqlTestUtils.TEST_CFG,
+                new EsqlFunctionRegistry(),
+                analyzerDefaultMapping(),
+                defaultLookupResolution(),
+                defaultEnrichResolution()
+            ),
             verifier
         );
     }
@@ -98,10 +113,14 @@ public static IndexResolution analyzerDefaultMapping() {
         return loadMapping("mapping-basic.json", "test");
     }
 
-    public static IndexResolution analyzerExpandedDefaultMapping() {
+    public static IndexResolution expandedDefaultIndexResolution() {
         return loadMapping("mapping-default.json", "test");
     }
 
+    public static IndexResolution defaultLookupResolution() {
+        return loadMapping("mapping-languages.json", "languages_lookup");
+    }
+
     public static EnrichResolution defaultEnrichResolution() {
         EnrichResolution enrichResolution = new EnrichResolution();
         loadEnrichPolicyResolution(enrichResolution, MATCH_TYPE, "languages", "language_code", "languages_idx", "mapping-languages.json");
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java
index 5a1e109041a16..6edbb55af463d 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/AnalyzerTests.java
@@ -14,6 +14,7 @@
 import org.elasticsearch.index.IndexMode;
 import org.elasticsearch.index.analysis.IndexAnalyzers;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xpack.esql.EsqlTestUtils;
 import org.elasticsearch.xpack.esql.LoadMapping;
 import org.elasticsearch.xpack.esql.VerificationException;
 import org.elasticsearch.xpack.esql.action.EsqlCapabilities;
@@ -73,6 +74,8 @@
 import static org.elasticsearch.xpack.esql.analysis.Analyzer.NO_FIELDS;
 import static org.elasticsearch.xpack.esql.analysis.AnalyzerTestUtils.analyze;
 import static org.elasticsearch.xpack.esql.analysis.AnalyzerTestUtils.analyzer;
+import static org.elasticsearch.xpack.esql.analysis.AnalyzerTestUtils.analyzerDefaultMapping;
+import static org.elasticsearch.xpack.esql.analysis.AnalyzerTestUtils.defaultEnrichResolution;
 import static org.elasticsearch.xpack.esql.analysis.AnalyzerTestUtils.loadMapping;
 import static org.elasticsearch.xpack.esql.analysis.AnalyzerTestUtils.tsdbIndexResolution;
 import static org.elasticsearch.xpack.esql.core.tree.Source.EMPTY;
@@ -83,6 +86,7 @@
 import static org.hamcrest.Matchers.hasSize;
 import static org.hamcrest.Matchers.instanceOf;
 import static org.hamcrest.Matchers.matchesRegex;
+import static org.hamcrest.Matchers.not;
 import static org.hamcrest.Matchers.startsWith;
 
 //@TestLogging(value = "org.elasticsearch.xpack.esql.analysis:TRACE", reason = "debug")
@@ -2002,6 +2006,58 @@ public void testLookupMatchTypeWrong() {
         assertThat(e.getMessage(), containsString("column type mismatch, table column was [integer] and original column was [keyword]"));
     }
 
+    public void testLookupJoinUnknownIndex() {
+        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V4.isEnabled());
+
+        String errorMessage = "Unknown index [foobar]";
+        IndexResolution missingLookupIndex = IndexResolution.invalid(errorMessage);
+
+        Analyzer analyzerMissingLookupIndex = new Analyzer(
+            new AnalyzerContext(
+                EsqlTestUtils.TEST_CFG,
+                new EsqlFunctionRegistry(),
+                analyzerDefaultMapping(),
+                missingLookupIndex,
+                defaultEnrichResolution()
+            ),
+            TEST_VERIFIER
+        );
+
+        String query = "FROM test | LOOKUP JOIN foobar ON last_name";
+
+        VerificationException e = expectThrows(VerificationException.class, () -> analyze(query, analyzerMissingLookupIndex));
+        assertThat(e.getMessage(), containsString("1:25: " + errorMessage));
+
+        String query2 = "FROM test | LOOKUP JOIN foobar ON missing_field";
+
+        e = expectThrows(VerificationException.class, () -> analyze(query2, analyzerMissingLookupIndex));
+        assertThat(e.getMessage(), containsString("1:25: " + errorMessage));
+        assertThat(e.getMessage(), not(containsString("[missing_field]")));
+    }
+
+    public void testLookupJoinUnknownField() {
+        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V4.isEnabled());
+
+        String query = "FROM test | LOOKUP JOIN languages_lookup ON last_name";
+        String errorMessage = "1:45: Unknown column [last_name] in right side of join";
+
+        VerificationException e = expectThrows(VerificationException.class, () -> analyze(query));
+        assertThat(e.getMessage(), containsString(errorMessage));
+
+        String query2 = "FROM test | LOOKUP JOIN languages_lookup ON language_code";
+        String errorMessage2 = "1:45: Unknown column [language_code] in left side of join";
+
+        e = expectThrows(VerificationException.class, () -> analyze(query2));
+        assertThat(e.getMessage(), containsString(errorMessage2));
+
+        String query3 = "FROM test | LOOKUP JOIN languages_lookup ON missing_altogether";
+        String errorMessage3 = "1:45: Unknown column [missing_altogether] in ";
+
+        e = expectThrows(VerificationException.class, () -> analyze(query3));
+        assertThat(e.getMessage(), containsString(errorMessage3 + "left side of join"));
+        assertThat(e.getMessage(), containsString(errorMessage3 + "right side of join"));
+    }
+
     public void testImplicitCasting() {
         var e = expectThrows(VerificationException.class, () -> analyze("""
              from test | eval x = concat("2024", "-04", "-01") + 1 day
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
index 74e2de1141728..882b8b7dbfd7c 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
@@ -1926,6 +1926,17 @@ public void testSortByAggregate() {
         assertEquals("1:18: Aggregate functions are not allowed in SORT [COUNT]", error("FROM test | SORT count(*)"));
     }
 
+    public void testLookupJoinDataTypeMismatch() {
+        assumeTrue("requires LOOKUP JOIN capability", EsqlCapabilities.Cap.JOIN_LOOKUP_V4.isEnabled());
+
+        query("FROM test | EVAL language_code = languages | LOOKUP JOIN languages_lookup ON language_code");
+
+        assertEquals(
+            "1:87: JOIN left field [language_code] of type [KEYWORD] is incompatible with right field [language_code] of type [INTEGER]",
+            error("FROM test | EVAL language_code = languages::keyword | LOOKUP JOIN languages_lookup ON language_code")
+        );
+    }
+
     private void query(String query) {
         defaultAnalyzer.analyze(parser.createStatement(query));
     }

From 2fe6b60af14800a134db79d85b5f2dcb6df9b340 Mon Sep 17 00:00:00 2001
From: Nikolaj Volgushev <n1v0lg@users.noreply.github.com>
Date: Thu, 5 Dec 2024 12:22:22 +0100
Subject: [PATCH 043/119] Fix ProfileIntegTests (#117888)

The test setup for `ProfileIntegTests` is flawed, where the full name of
a user can be a substring of other profile names (e.g., `SER` is a
substring of `User <random-string>-space1`) -- when that's passed into
suggest call with the `*` space, we get a match on all profiles, instead
of only the one profile expected in the test, since we are matching on
e.g. `SER*`. This PR restricts the setup to avoid the wildcard profile
for that particular test.

Closes: https://github.com/elastic/elasticsearch/issues/117782
---
 .../xpack/security/profile/ProfileIntegTests.java            | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/x-pack/plugin/security/src/internalClusterTest/java/org/elasticsearch/xpack/security/profile/ProfileIntegTests.java b/x-pack/plugin/security/src/internalClusterTest/java/org/elasticsearch/xpack/security/profile/ProfileIntegTests.java
index 437fb76351176..3b55295c1efce 100644
--- a/x-pack/plugin/security/src/internalClusterTest/java/org/elasticsearch/xpack/security/profile/ProfileIntegTests.java
+++ b/x-pack/plugin/security/src/internalClusterTest/java/org/elasticsearch/xpack/security/profile/ProfileIntegTests.java
@@ -557,8 +557,11 @@ public void testSuggestProfilesWithHint() throws IOException {
             equalTo(profileHits4.subList(2, profileHits4.size()))
         );
 
+        // Exclude profile for "*" space since that can match _all_ profiles, if the full name is a substring of "user" or the name of
+        // another profile
+        final List<Profile> nonWildcardProfiles = profiles.stream().filter(p -> false == p.user().fullName().endsWith("*")).toList();
         // A record will not be included if name does not match even when it has matching hint
-        final Profile hintedProfile5 = randomFrom(profiles);
+        final Profile hintedProfile5 = randomFrom(nonWildcardProfiles);
         final List<Profile> profileHits5 = Arrays.stream(
             doSuggest(
                 Set.of(),

From 164d737b0556303d82fc84ce33bfa67ec8b7007b Mon Sep 17 00:00:00 2001
From: David Turner <david.turner@elastic.co>
Date: Thu, 5 Dec 2024 13:01:32 +0000
Subject: [PATCH 044/119] Speed up `testRespondAfterClose` (#117969)

Since #106511 this test takes 30s because it waits for the client to
time out and close the connection before allowing the transport to fully
shut down. This commit reinstates the previous behaviour of closing
connections quickly, and tests both client-triggered and
server-triggered connection closure.
---
 .../Netty4HttpServerTransportTests.java       | 35 ++++++++++++++++---
 1 file changed, 31 insertions(+), 4 deletions(-)

diff --git a/modules/transport-netty4/src/test/java/org/elasticsearch/http/netty4/Netty4HttpServerTransportTests.java b/modules/transport-netty4/src/test/java/org/elasticsearch/http/netty4/Netty4HttpServerTransportTests.java
index 3fd5cc44a3403..1d39b993cef92 100644
--- a/modules/transport-netty4/src/test/java/org/elasticsearch/http/netty4/Netty4HttpServerTransportTests.java
+++ b/modules/transport-netty4/src/test/java/org/elasticsearch/http/netty4/Netty4HttpServerTransportTests.java
@@ -40,6 +40,7 @@
 import io.netty.handler.codec.http.HttpUtil;
 import io.netty.handler.codec.http.HttpVersion;
 
+import org.apache.http.ConnectionClosedException;
 import org.apache.http.HttpHost;
 import org.apache.lucene.util.SetOnce;
 import org.elasticsearch.ElasticsearchException;
@@ -48,6 +49,7 @@
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.bulk.IncrementalBulkService;
 import org.elasticsearch.action.support.ActionTestUtils;
+import org.elasticsearch.action.support.PlainActionFuture;
 import org.elasticsearch.action.support.SubscribableListener;
 import org.elasticsearch.client.Request;
 import org.elasticsearch.client.RestClient;
@@ -100,6 +102,7 @@
 import java.util.Collections;
 import java.util.List;
 import java.util.Set;
+import java.util.concurrent.CancellationException;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.TimeUnit;
@@ -110,6 +113,7 @@
 import static com.carrotsearch.randomizedtesting.RandomizedTest.getRandom;
 import static org.elasticsearch.http.HttpTransportSettings.SETTING_CORS_ALLOW_ORIGIN;
 import static org.elasticsearch.http.HttpTransportSettings.SETTING_CORS_ENABLED;
+import static org.elasticsearch.http.HttpTransportSettings.SETTING_HTTP_SERVER_SHUTDOWN_GRACE_PERIOD;
 import static org.elasticsearch.rest.RestStatus.BAD_REQUEST;
 import static org.elasticsearch.rest.RestStatus.OK;
 import static org.elasticsearch.rest.RestStatus.UNAUTHORIZED;
@@ -1039,8 +1043,16 @@ public void dispatchBadRequest(final RestChannel channel, final ThreadContext th
         }
     }
 
-    public void testRespondAfterClose() throws Exception {
-        final String url = "/thing";
+    public void testRespondAfterServiceCloseWithClientCancel() throws Exception {
+        runRespondAfterServiceCloseTest(true);
+    }
+
+    public void testRespondAfterServiceCloseWithServerCancel() throws Exception {
+        runRespondAfterServiceCloseTest(false);
+    }
+
+    private void runRespondAfterServiceCloseTest(boolean clientCancel) throws Exception {
+        final String url = "/" + randomIdentifier();
         final CountDownLatch responseReleasedLatch = new CountDownLatch(1);
         final SubscribableListener<Void> transportClosedFuture = new SubscribableListener<>();
         final CountDownLatch handlingRequestLatch = new CountDownLatch(1);
@@ -1066,7 +1078,9 @@ public void dispatchBadRequest(final RestChannel channel, final ThreadContext th
 
         try (
             Netty4HttpServerTransport transport = new Netty4HttpServerTransport(
-                Settings.EMPTY,
+                clientCancel
+                    ? Settings.EMPTY
+                    : Settings.builder().put(SETTING_HTTP_SERVER_SHUTDOWN_GRACE_PERIOD.getKey(), TimeValue.timeValueMillis(1)).build(),
                 networkService,
                 threadPool,
                 xContentRegistry(),
@@ -1082,11 +1096,24 @@ public void dispatchBadRequest(final RestChannel channel, final ThreadContext th
             transport.start();
             final var address = randomFrom(transport.boundAddress().boundAddresses()).address();
             try (var client = RestClient.builder(new HttpHost(address.getAddress(), address.getPort())).build()) {
-                client.performRequestAsync(new Request("GET", url), ActionTestUtils.wrapAsRestResponseListener(ActionListener.noop()));
+                final var responseExceptionFuture = new PlainActionFuture<Exception>();
+                final var cancellable = client.performRequestAsync(
+                    new Request("GET", url),
+                    ActionTestUtils.wrapAsRestResponseListener(ActionTestUtils.assertNoSuccessListener(responseExceptionFuture::onResponse))
+                );
                 safeAwait(handlingRequestLatch);
+                if (clientCancel) {
+                    threadPool.generic().execute(cancellable::cancel);
+                }
                 transport.close();
                 transportClosedFuture.onResponse(null);
                 safeAwait(responseReleasedLatch);
+                final var responseException = safeGet(responseExceptionFuture);
+                if (clientCancel) {
+                    assertThat(responseException, instanceOf(CancellationException.class));
+                } else {
+                    assertThat(responseException, instanceOf(ConnectionClosedException.class));
+                }
             }
         }
     }

From 5ff37d1cf7e026a08c0f6a5978e85619b527fe91 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Fri, 6 Dec 2024 00:12:50 +1100
Subject: [PATCH 045/119] Mute
 org.elasticsearch.packaging.test.ConfigurationTests
 test20HostnameSubstitution #118028

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index f525607a848d0..efd61da6c2dff 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -248,6 +248,9 @@ tests:
 - class: org.elasticsearch.index.reindex.ReindexNodeShutdownIT
   method: testReindexWithShutdown
   issue: https://github.com/elastic/elasticsearch/issues/118040
+- class: org.elasticsearch.packaging.test.ConfigurationTests
+  method: test20HostnameSubstitution
+  issue: https://github.com/elastic/elasticsearch/issues/118028
 
 # Examples:
 #

From f009147ce96368a5d52e076c518c92ac073892fe Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Fri, 6 Dec 2024 00:13:00 +1100
Subject: [PATCH 046/119] Mute org.elasticsearch.packaging.test.ArchiveTests
 test40AutoconfigurationNotTriggeredWhenNodeIsMeantToJoinExistingCluster
 #118029

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index efd61da6c2dff..b8d82f00bc43f 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -251,6 +251,9 @@ tests:
 - class: org.elasticsearch.packaging.test.ConfigurationTests
   method: test20HostnameSubstitution
   issue: https://github.com/elastic/elasticsearch/issues/118028
+- class: org.elasticsearch.packaging.test.ArchiveTests
+  method: test40AutoconfigurationNotTriggeredWhenNodeIsMeantToJoinExistingCluster
+  issue: https://github.com/elastic/elasticsearch/issues/118029
 
 # Examples:
 #

From fdb1b2bf796fc26d85c98dc3e2c1913f76e35c8d Mon Sep 17 00:00:00 2001
From: Jim Ferenczi <jim.ferenczi@elastic.co>
Date: Thu, 5 Dec 2024 14:20:31 +0000
Subject: [PATCH 047/119] Add a new `offset_source` field to store offsets
 referencing substrings of another field. (#118017)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This field is primarily designed for use with the `semantic_text` field, where it enables storing offsets that point to substrings of the field used to generate its underlying chunks.

To prevent external usage, the field is intentionally undocumented, with detailed javadocs explaining its specific purpose and limitations.
I couldn’t find a way to fully block external usage, but skipping the docs should keep it mostly out of sight for now.
---
 .../xpack/inference/InferencePlugin.java      |   8 +-
 .../inference/mapper/OffsetSourceField.java   | 145 ++++++++++
 .../mapper/OffsetSourceFieldMapper.java       | 253 ++++++++++++++++++
 .../mapper/OffsetSourceFieldMapperTests.java  | 216 +++++++++++++++
 .../mapper/OffsetSourceFieldTests.java        |  72 +++++
 .../mapper/OffsetSourceFieldTypeTests.java    |  44 +++
 6 files changed, 737 insertions(+), 1 deletion(-)
 create mode 100644 x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceField.java
 create mode 100644 x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceFieldMapper.java
 create mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceFieldMapperTests.java
 create mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceFieldTests.java
 create mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceFieldTypeTests.java

diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
index 48458bf4f5086..3c14e51a3c2d4 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
@@ -68,6 +68,7 @@
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.RequestExecutorServiceSettings;
 import org.elasticsearch.xpack.inference.logging.ThrottlerManager;
+import org.elasticsearch.xpack.inference.mapper.OffsetSourceFieldMapper;
 import org.elasticsearch.xpack.inference.mapper.SemanticTextFieldMapper;
 import org.elasticsearch.xpack.inference.queries.SemanticQueryBuilder;
 import org.elasticsearch.xpack.inference.rank.random.RandomRankBuilder;
@@ -392,7 +393,12 @@ public void close() {
 
     @Override
     public Map<String, Mapper.TypeParser> getMappers() {
-        return Map.of(SemanticTextFieldMapper.CONTENT_TYPE, SemanticTextFieldMapper.PARSER);
+        return Map.of(
+            SemanticTextFieldMapper.CONTENT_TYPE,
+            SemanticTextFieldMapper.PARSER,
+            OffsetSourceFieldMapper.CONTENT_TYPE,
+            OffsetSourceFieldMapper.PARSER
+        );
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceField.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceField.java
new file mode 100644
index 0000000000000..d8339f1004da2
--- /dev/null
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceField.java
@@ -0,0 +1,145 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.mapper;
+
+import org.apache.lucene.analysis.Analyzer;
+import org.apache.lucene.analysis.TokenStream;
+import org.apache.lucene.analysis.tokenattributes.CharTermAttribute;
+import org.apache.lucene.analysis.tokenattributes.OffsetAttribute;
+import org.apache.lucene.document.Field;
+import org.apache.lucene.document.FieldType;
+import org.apache.lucene.index.IndexOptions;
+import org.apache.lucene.index.PostingsEnum;
+import org.apache.lucene.index.Term;
+import org.apache.lucene.index.Terms;
+import org.apache.lucene.search.DocIdSetIterator;
+
+import java.io.IOException;
+import java.nio.charset.Charset;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+/**
+ * Represents a {@link Field} that stores a {@link Term} along with its start and end offsets.
+ * Note: The {@link Charset} used to calculate these offsets is not associated with this field.
+ * It is the responsibility of the consumer to handle the appropriate {@link Charset}.
+ */
+public final class OffsetSourceField extends Field {
+    private static final FieldType FIELD_TYPE = new FieldType();
+
+    static {
+        FIELD_TYPE.setTokenized(false);
+        FIELD_TYPE.setOmitNorms(true);
+        FIELD_TYPE.setIndexOptions(IndexOptions.DOCS_AND_FREQS_AND_POSITIONS_AND_OFFSETS);
+    }
+
+    private int startOffset;
+    private int endOffset;
+
+    public OffsetSourceField(String fieldName, String sourceFieldName, int startOffset, int endOffset) {
+        super(fieldName, sourceFieldName, FIELD_TYPE);
+        this.startOffset = startOffset;
+        this.endOffset = endOffset;
+    }
+
+    public void setValues(String fieldName, int startOffset, int endOffset) {
+        this.fieldsData = fieldName;
+        this.startOffset = startOffset;
+        this.endOffset = endOffset;
+    }
+
+    @Override
+    public TokenStream tokenStream(Analyzer analyzer, TokenStream reuse) {
+        OffsetTokenStream stream;
+        if (reuse instanceof OffsetTokenStream) {
+            stream = (OffsetTokenStream) reuse;
+        } else {
+            stream = new OffsetTokenStream();
+        }
+
+        stream.setValues((String) fieldsData, startOffset, endOffset);
+        return stream;
+    }
+
+    public static OffsetSourceLoader loader(Terms terms) throws IOException {
+        return new OffsetSourceLoader(terms);
+    }
+
+    private static final class OffsetTokenStream extends TokenStream {
+        private final CharTermAttribute termAttribute = addAttribute(CharTermAttribute.class);
+        private final OffsetAttribute offsetAttribute = addAttribute(OffsetAttribute.class);
+        private boolean used = true;
+        private String term = null;
+        private int startOffset = 0;
+        private int endOffset = 0;
+
+        private OffsetTokenStream() {}
+
+        /** Sets the values */
+        void setValues(String term, int startOffset, int endOffset) {
+            this.term = term;
+            this.startOffset = startOffset;
+            this.endOffset = endOffset;
+        }
+
+        @Override
+        public boolean incrementToken() {
+            if (used) {
+                return false;
+            }
+            clearAttributes();
+            termAttribute.append(term);
+            offsetAttribute.setOffset(startOffset, endOffset);
+            used = true;
+            return true;
+        }
+
+        @Override
+        public void reset() {
+            used = false;
+        }
+
+        @Override
+        public void close() {
+            term = null;
+        }
+    }
+
+    public static class OffsetSourceLoader {
+        private final Map<String, PostingsEnum> postingsEnums = new LinkedHashMap<>();
+
+        private OffsetSourceLoader(Terms terms) throws IOException {
+            var termsEnum = terms.iterator();
+            while (termsEnum.next() != null) {
+                var postings = termsEnum.postings(null, PostingsEnum.OFFSETS);
+                if (postings.nextDoc() != DocIdSetIterator.NO_MORE_DOCS) {
+                    postingsEnums.put(termsEnum.term().utf8ToString(), postings);
+                }
+            }
+        }
+
+        public OffsetSourceFieldMapper.OffsetSource advanceTo(int doc) throws IOException {
+            for (var it = postingsEnums.entrySet().iterator(); it.hasNext();) {
+                var entry = it.next();
+                var postings = entry.getValue();
+                if (postings.docID() < doc) {
+                    if (postings.advance(doc) == DocIdSetIterator.NO_MORE_DOCS) {
+                        it.remove();
+                        continue;
+                    }
+                }
+                if (postings.docID() == doc) {
+                    assert postings.freq() == 1;
+                    postings.nextPosition();
+                    return new OffsetSourceFieldMapper.OffsetSource(entry.getKey(), postings.startOffset(), postings.endOffset());
+                }
+            }
+            return null;
+        }
+    }
+}
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceFieldMapper.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceFieldMapper.java
new file mode 100644
index 0000000000000..e612076f1aaf2
--- /dev/null
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceFieldMapper.java
@@ -0,0 +1,253 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.mapper;
+
+import org.apache.lucene.index.FieldInfos;
+import org.apache.lucene.index.LeafReaderContext;
+import org.apache.lucene.search.Query;
+import org.elasticsearch.index.fielddata.FieldDataContext;
+import org.elasticsearch.index.fielddata.IndexFieldData;
+import org.elasticsearch.index.mapper.DocumentParserContext;
+import org.elasticsearch.index.mapper.FieldMapper;
+import org.elasticsearch.index.mapper.MappedFieldType;
+import org.elasticsearch.index.mapper.MapperBuilderContext;
+import org.elasticsearch.index.mapper.TextSearchInfo;
+import org.elasticsearch.index.mapper.ValueFetcher;
+import org.elasticsearch.index.query.SearchExecutionContext;
+import org.elasticsearch.search.fetch.StoredFieldsSpec;
+import org.elasticsearch.search.lookup.Source;
+import org.elasticsearch.xcontent.ConstructingObjectParser;
+import org.elasticsearch.xcontent.ParseField;
+import org.elasticsearch.xcontent.ToXContentObject;
+import org.elasticsearch.xcontent.XContentBuilder;
+import org.elasticsearch.xcontent.XContentParser;
+
+import java.io.IOException;
+import java.io.UncheckedIOException;
+import java.nio.charset.Charset;
+import java.nio.charset.StandardCharsets;
+import java.util.List;
+import java.util.Map;
+
+import static org.elasticsearch.xcontent.ConstructingObjectParser.constructorArg;
+
+/**
+ * A {@link FieldMapper} that maps a field name to its start and end offsets.
+ * The {@link CharsetFormat} used to compute the offsets is specified via the charset parameter.
+ * Currently, only {@link CharsetFormat#UTF_16} is supported, aligning with Java's {@code String} charset
+ * for simpler internal usage and integration.
+ *
+ * Each document can store at most one value in this field.
+ *
+ * Note: This mapper is not yet documented and is intended exclusively for internal use by
+ * {@link SemanticTextFieldMapper}. If exposing this mapper directly to users becomes necessary,
+ * extending charset compatibility should be considered, as the current default (and sole supported charset)
+ * was chosen for ease of Java integration.
+ */
+public class OffsetSourceFieldMapper extends FieldMapper {
+    public static final String CONTENT_TYPE = "offset_source";
+
+    private static final String SOURCE_NAME_FIELD = "field";
+    private static final String START_OFFSET_FIELD = "start";
+    private static final String END_OFFSET_FIELD = "end";
+
+    public record OffsetSource(String field, int start, int end) implements ToXContentObject {
+        public OffsetSource {
+            if (start < 0 || end < 0) {
+                throw new IllegalArgumentException("Illegal offsets, expected positive numbers, got: " + start + ":" + end);
+            }
+            if (start > end) {
+                throw new IllegalArgumentException("Illegal offsets, expected start < end, got: " + start + " > " + end);
+            }
+        }
+
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            builder.startObject();
+            builder.field(SOURCE_NAME_FIELD, field);
+            builder.field(START_OFFSET_FIELD, start);
+            builder.field(END_OFFSET_FIELD, end);
+            return builder.endObject();
+        }
+    }
+
+    private static final ConstructingObjectParser<OffsetSource, Void> OFFSET_SOURCE_PARSER = new ConstructingObjectParser<>(
+        CONTENT_TYPE,
+        true,
+        args -> new OffsetSource((String) args[0], (int) args[1], (int) args[2])
+    );
+
+    static {
+        OFFSET_SOURCE_PARSER.declareString(constructorArg(), new ParseField(SOURCE_NAME_FIELD));
+        OFFSET_SOURCE_PARSER.declareInt(constructorArg(), new ParseField(START_OFFSET_FIELD));
+        OFFSET_SOURCE_PARSER.declareInt(constructorArg(), new ParseField(END_OFFSET_FIELD));
+    }
+
+    public enum CharsetFormat {
+        UTF_16(StandardCharsets.UTF_16);
+
+        private Charset charSet;
+
+        CharsetFormat(Charset charSet) {
+            this.charSet = charSet;
+        }
+    }
+
+    public static class Builder extends FieldMapper.Builder {
+        private final Parameter<CharsetFormat> charset = Parameter.enumParam(
+            "charset",
+            false,
+            i -> CharsetFormat.UTF_16,
+            CharsetFormat.UTF_16,
+            CharsetFormat.class
+        );
+        private final Parameter<Map<String, String>> meta = Parameter.metaParam();
+
+        public Builder(String name) {
+            super(name);
+        }
+
+        @Override
+        protected Parameter<?>[] getParameters() {
+            return new Parameter<?>[] { meta, charset };
+        }
+
+        @Override
+        public OffsetSourceFieldMapper build(MapperBuilderContext context) {
+            return new OffsetSourceFieldMapper(
+                leafName(),
+                new OffsetSourceFieldType(context.buildFullName(leafName()), charset.get(), meta.getValue()),
+                builderParams(this, context)
+            );
+        }
+    }
+
+    public static final TypeParser PARSER = new TypeParser((n, c) -> new Builder(n));
+
+    public static final class OffsetSourceFieldType extends MappedFieldType {
+        private final CharsetFormat charset;
+
+        public OffsetSourceFieldType(String name, CharsetFormat charset, Map<String, String> meta) {
+            super(name, true, false, false, TextSearchInfo.NONE, meta);
+            this.charset = charset;
+        }
+
+        public Charset getCharset() {
+            return charset.charSet;
+        }
+
+        @Override
+        public String typeName() {
+            return CONTENT_TYPE;
+        }
+
+        @Override
+        public boolean fieldHasValue(FieldInfos fieldInfos) {
+            return fieldInfos.fieldInfo(name()) != null;
+        }
+
+        @Override
+        public IndexFieldData.Builder fielddataBuilder(FieldDataContext fieldDataContext) {
+            throw new IllegalArgumentException("[offset_source] fields do not support sorting, scripting or aggregating");
+        }
+
+        @Override
+        public ValueFetcher valueFetcher(SearchExecutionContext context, String format) {
+            return new ValueFetcher() {
+                OffsetSourceField.OffsetSourceLoader offsetLoader;
+
+                @Override
+                public void setNextReader(LeafReaderContext context) {
+                    try {
+                        var terms = context.reader().terms(name());
+                        offsetLoader = terms != null ? OffsetSourceField.loader(terms) : null;
+                    } catch (IOException exc) {
+                        throw new UncheckedIOException(exc);
+                    }
+                }
+
+                @Override
+                public List<Object> fetchValues(Source source, int doc, List<Object> ignoredValues) throws IOException {
+                    var offsetSource = offsetLoader != null ? offsetLoader.advanceTo(doc) : null;
+                    return offsetSource != null ? List.of(offsetSource) : null;
+                }
+
+                @Override
+                public StoredFieldsSpec storedFieldsSpec() {
+                    return StoredFieldsSpec.NO_REQUIREMENTS;
+                }
+            };
+        }
+
+        @Override
+        public Query termQuery(Object value, SearchExecutionContext context) {
+            throw new IllegalArgumentException("Queries on [offset_source] fields are not supported");
+        }
+
+        @Override
+        public boolean isSearchable() {
+            return false;
+        }
+    }
+
+    /**
+     * @param simpleName      the leaf name of the mapper
+     * @param mappedFieldType
+     * @param params          initialization params for this field mapper
+     */
+    protected OffsetSourceFieldMapper(String simpleName, MappedFieldType mappedFieldType, BuilderParams params) {
+        super(simpleName, mappedFieldType, params);
+    }
+
+    @Override
+    protected String contentType() {
+        return CONTENT_TYPE;
+    }
+
+    @Override
+    protected boolean supportsParsingObject() {
+        return true;
+    }
+
+    @Override
+    protected void parseCreateField(DocumentParserContext context) throws IOException {
+        var parser = context.parser();
+        if (parser.currentToken() == XContentParser.Token.VALUE_NULL) {
+            // skip
+            return;
+        }
+
+        if (context.doc().getByKey(fullPath()) != null) {
+            throw new IllegalArgumentException(
+                "[offset_source] fields do not support indexing multiple values for the same field ["
+                    + fullPath()
+                    + "] in the same document"
+            );
+        }
+
+        // make sure that we don't expand dots in field names while parsing
+        boolean isWithinLeafObject = context.path().isWithinLeafObject();
+        context.path().setWithinLeafObject(true);
+        try {
+            var offsetSource = OFFSET_SOURCE_PARSER.parse(parser, null);
+            context.doc()
+                .addWithKey(
+                    fieldType().name(),
+                    new OffsetSourceField(fullPath(), offsetSource.field, offsetSource.start, offsetSource.end)
+                );
+            context.addToFieldNames(fieldType().name());
+        } finally {
+            context.path().setWithinLeafObject(isWithinLeafObject);
+        }
+    }
+
+    @Override
+    public FieldMapper.Builder getMergeBuilder() {
+        return new Builder(leafName()).init(this);
+    }
+}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceFieldMapperTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceFieldMapperTests.java
new file mode 100644
index 0000000000000..40140d6da5eb5
--- /dev/null
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceFieldMapperTests.java
@@ -0,0 +1,216 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.mapper;
+
+import org.apache.lucene.analysis.TokenStream;
+import org.apache.lucene.analysis.tokenattributes.CharTermAttribute;
+import org.apache.lucene.analysis.tokenattributes.OffsetAttribute;
+import org.apache.lucene.index.IndexableField;
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.index.mapper.DocumentMapper;
+import org.elasticsearch.index.mapper.DocumentParsingException;
+import org.elasticsearch.index.mapper.MappedFieldType;
+import org.elasticsearch.index.mapper.MapperService;
+import org.elasticsearch.index.mapper.MapperTestCase;
+import org.elasticsearch.index.mapper.ParsedDocument;
+import org.elasticsearch.index.mapper.SourceToParse;
+import org.elasticsearch.index.mapper.ValueFetcher;
+import org.elasticsearch.index.query.SearchExecutionContext;
+import org.elasticsearch.plugins.Plugin;
+import org.elasticsearch.search.lookup.Source;
+import org.elasticsearch.search.lookup.SourceProvider;
+import org.elasticsearch.xcontent.XContentBuilder;
+import org.elasticsearch.xpack.inference.InferencePlugin;
+import org.junit.AssumptionViolatedException;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.instanceOf;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+
+public class OffsetSourceFieldMapperTests extends MapperTestCase {
+    @Override
+    protected Collection<? extends Plugin> getPlugins() {
+        return List.of(new InferencePlugin(Settings.EMPTY));
+    }
+
+    @Override
+    protected void minimalMapping(XContentBuilder b) throws IOException {
+        b.field("type", "offset_source");
+    }
+
+    @Override
+    protected Object getSampleValueForDocument() {
+        return getSampleObjectForDocument();
+    }
+
+    @Override
+    protected Object getSampleObjectForDocument() {
+        return Map.of("field", "foo", "start", 100, "end", 300);
+    }
+
+    @Override
+    protected Object generateRandomInputValue(MappedFieldType ft) {
+        return new OffsetSourceFieldMapper.OffsetSource("field", randomIntBetween(0, 100), randomIntBetween(101, 1000));
+    }
+
+    @Override
+    protected IngestScriptSupport ingestScriptSupport() {
+        throw new AssumptionViolatedException("not supported");
+    }
+
+    @Override
+    protected void registerParameters(ParameterChecker checker) throws IOException {}
+
+    @Override
+    protected void assertSearchable(MappedFieldType fieldType) {
+        assertFalse(fieldType.isSearchable());
+    }
+
+    @Override
+    protected boolean supportsStoredFields() {
+        return false;
+    }
+
+    @Override
+    protected boolean supportsEmptyInputArray() {
+        return false;
+    }
+
+    @Override
+    protected boolean supportsCopyTo() {
+        return false;
+    }
+
+    @Override
+    protected boolean supportsIgnoreMalformed() {
+        return false;
+    }
+
+    @Override
+    protected SyntheticSourceSupport syntheticSourceSupport(boolean ignoreMalformed) {
+        return new SyntheticSourceSupport() {
+            @Override
+            public SyntheticSourceExample example(int maxValues) {
+                return new SyntheticSourceExample(getSampleValueForDocument(), getSampleValueForDocument(), null, b -> minimalMapping(b));
+            }
+
+            @Override
+            public List<SyntheticSourceInvalidExample> invalidExample() {
+                return List.of();
+            }
+        };
+    }
+
+    @Override
+    public void testSyntheticSourceKeepArrays() {
+        // This mapper doesn't support multiple values (array of objects).
+    }
+
+    public void testDefaults() throws Exception {
+        DocumentMapper mapper = createDocumentMapper(fieldMapping(this::minimalMapping));
+        assertEquals(Strings.toString(fieldMapping(this::minimalMapping)), mapper.mappingSource().toString());
+
+        ParsedDocument doc1 = mapper.parse(
+            source(b -> b.startObject("field").field("field", "foo").field("start", 0).field("end", 128).endObject())
+        );
+        List<IndexableField> fields = doc1.rootDoc().getFields("field");
+        assertEquals(1, fields.size());
+        assertThat(fields.get(0), instanceOf(OffsetSourceField.class));
+        OffsetSourceField offsetField1 = (OffsetSourceField) fields.get(0);
+
+        ParsedDocument doc2 = mapper.parse(
+            source(b -> b.startObject("field").field("field", "bar").field("start", 128).field("end", 512).endObject())
+        );
+        OffsetSourceField offsetField2 = (OffsetSourceField) doc2.rootDoc().getFields("field").get(0);
+
+        assertTokenStream(offsetField1.tokenStream(null, null), "foo", 0, 128);
+        assertTokenStream(offsetField2.tokenStream(null, null), "bar", 128, 512);
+    }
+
+    private void assertTokenStream(TokenStream tk, String expectedTerm, int expectedStartOffset, int expectedEndOffset) throws IOException {
+        CharTermAttribute termAttribute = tk.addAttribute(CharTermAttribute.class);
+        OffsetAttribute offsetAttribute = tk.addAttribute(OffsetAttribute.class);
+        tk.reset();
+        assertTrue(tk.incrementToken());
+        assertThat(new String(termAttribute.buffer(), 0, termAttribute.length()), equalTo(expectedTerm));
+        assertThat(offsetAttribute.startOffset(), equalTo(expectedStartOffset));
+        assertThat(offsetAttribute.endOffset(), equalTo(expectedEndOffset));
+        assertFalse(tk.incrementToken());
+    }
+
+    @Override
+    protected void assertFetch(MapperService mapperService, String field, Object value, String format) throws IOException {
+        MappedFieldType ft = mapperService.fieldType(field);
+        MappedFieldType.FielddataOperation fdt = MappedFieldType.FielddataOperation.SEARCH;
+        SourceToParse source = source(b -> b.field(ft.name(), value));
+        SearchExecutionContext searchExecutionContext = mock(SearchExecutionContext.class);
+        when(searchExecutionContext.isSourceEnabled()).thenReturn(true);
+        when(searchExecutionContext.sourcePath(field)).thenReturn(Set.of(field));
+        when(searchExecutionContext.getForField(ft, fdt)).thenAnswer(inv -> fieldDataLookup(mapperService).apply(ft, () -> {
+            throw new UnsupportedOperationException();
+        }, fdt));
+        ValueFetcher nativeFetcher = ft.valueFetcher(searchExecutionContext, format);
+        ParsedDocument doc = mapperService.documentMapper().parse(source);
+        withLuceneIndex(mapperService, iw -> iw.addDocuments(doc.docs()), ir -> {
+            Source s = SourceProvider.fromStoredFields().getSource(ir.leaves().get(0), 0);
+            nativeFetcher.setNextReader(ir.leaves().get(0));
+            List<Object> fromNative = nativeFetcher.fetchValues(s, 0, new ArrayList<>());
+            assertThat(fromNative.size(), equalTo(1));
+            assertThat("fetching " + value, fromNative.get(0), equalTo(value));
+        });
+    }
+
+    @Override
+    protected void assertFetchMany(MapperService mapperService, String field, Object value, String format, int count) throws IOException {
+        assumeFalse("[offset_source] currently don't support multiple values in the same field", false);
+    }
+
+    public void testInvalidCharset() {
+        var exc = expectThrows(Exception.class, () -> createDocumentMapper(mapping(b -> {
+            b.startObject("field").field("type", "offset_source").field("charset", "utf_8").endObject();
+        })));
+        assertThat(exc.getCause().getMessage(), containsString("Unknown value [utf_8] for field [charset]"));
+    }
+
+    public void testRejectMultiValuedFields() throws IOException {
+        DocumentMapper mapper = createDocumentMapper(mapping(b -> { b.startObject("field").field("type", "offset_source").endObject(); }));
+
+        DocumentParsingException exc = expectThrows(DocumentParsingException.class, () -> mapper.parse(source(b -> {
+            b.startArray("field");
+            {
+                b.startObject().field("field", "bar1").field("start", 128).field("end", 512).endObject();
+                b.startObject().field("field", "bar2").field("start", 128).field("end", 512).endObject();
+            }
+            b.endArray();
+        })));
+        assertThat(exc.getCause().getMessage(), containsString("[offset_source] fields do not support indexing multiple values"));
+    }
+
+    public void testInvalidOffsets() throws IOException {
+        DocumentMapper mapper = createDocumentMapper(mapping(b -> { b.startObject("field").field("type", "offset_source").endObject(); }));
+
+        DocumentParsingException exc = expectThrows(DocumentParsingException.class, () -> mapper.parse(source(b -> {
+            b.startArray("field");
+            {
+                b.startObject().field("field", "bar1").field("start", -1).field("end", 512).endObject();
+            }
+            b.endArray();
+        })));
+        assertThat(exc.getCause().getCause().getCause().getMessage(), containsString("Illegal offsets"));
+    }
+}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceFieldTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceFieldTests.java
new file mode 100644
index 0000000000000..4d86263e446f8
--- /dev/null
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceFieldTests.java
@@ -0,0 +1,72 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.mapper;
+
+import org.apache.lucene.document.Document;
+import org.apache.lucene.store.Directory;
+import org.apache.lucene.tests.index.RandomIndexWriter;
+import org.elasticsearch.core.IOUtils;
+import org.elasticsearch.test.ESTestCase;
+
+public class OffsetSourceFieldTests extends ESTestCase {
+    public void testBasics() throws Exception {
+        Directory dir = newDirectory();
+        RandomIndexWriter writer = new RandomIndexWriter(
+            random(),
+            dir,
+            newIndexWriterConfig().setMergePolicy(newLogMergePolicy(random().nextBoolean()))
+        );
+        Document doc = new Document();
+        OffsetSourceField field1 = new OffsetSourceField("field1", "foo", 1, 10);
+        doc.add(field1);
+        writer.addDocument(doc);
+
+        field1.setValues("bar", 10, 128);
+        writer.addDocument(doc);
+
+        writer.addDocument(new Document()); // gap
+
+        field1.setValues("foo", 50, 256);
+        writer.addDocument(doc);
+
+        writer.addDocument(new Document()); // double gap
+        writer.addDocument(new Document());
+
+        field1.setValues("baz", 32, 512);
+        writer.addDocument(doc);
+
+        writer.forceMerge(1);
+        var reader = writer.getReader();
+        writer.close();
+
+        var searcher = newSearcher(reader);
+        var context = searcher.getIndexReader().leaves().get(0);
+
+        var terms = context.reader().terms("field1");
+        assertNotNull(terms);
+        OffsetSourceField.OffsetSourceLoader loader = OffsetSourceField.loader(terms);
+
+        var offset = loader.advanceTo(0);
+        assertEquals(new OffsetSourceFieldMapper.OffsetSource("foo", 1, 10), offset);
+
+        offset = loader.advanceTo(1);
+        assertEquals(new OffsetSourceFieldMapper.OffsetSource("bar", 10, 128), offset);
+
+        assertNull(loader.advanceTo(2));
+
+        offset = loader.advanceTo(3);
+        assertEquals(new OffsetSourceFieldMapper.OffsetSource("foo", 50, 256), offset);
+
+        offset = loader.advanceTo(6);
+        assertEquals(new OffsetSourceFieldMapper.OffsetSource("baz", 32, 512), offset);
+
+        assertNull(loader.advanceTo(189));
+
+        IOUtils.close(reader, dir);
+    }
+}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceFieldTypeTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceFieldTypeTests.java
new file mode 100644
index 0000000000000..ccb696515a060
--- /dev/null
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/OffsetSourceFieldTypeTests.java
@@ -0,0 +1,44 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.mapper;
+
+import org.apache.lucene.index.FieldInfo;
+import org.apache.lucene.index.FieldInfos;
+import org.elasticsearch.index.mapper.FieldTypeTestCase;
+import org.elasticsearch.index.mapper.MappedFieldType;
+
+import java.util.Collections;
+
+public class OffsetSourceFieldTypeTests extends FieldTypeTestCase {
+    public void testIsNotAggregatable() {
+        MappedFieldType fieldType = getMappedFieldType();
+        assertFalse(fieldType.isAggregatable());
+    }
+
+    @Override
+    public void testFieldHasValue() {
+        MappedFieldType fieldType = getMappedFieldType();
+        FieldInfos fieldInfos = new FieldInfos(new FieldInfo[] { getFieldInfoWithName(fieldType.name()) });
+        assertTrue(fieldType.fieldHasValue(fieldInfos));
+    }
+
+    @Override
+    public void testFieldHasValueWithEmptyFieldInfos() {
+        MappedFieldType fieldType = getMappedFieldType();
+        assertFalse(fieldType.fieldHasValue(FieldInfos.EMPTY));
+    }
+
+    @Override
+    public MappedFieldType getMappedFieldType() {
+        return new OffsetSourceFieldMapper.OffsetSourceFieldType(
+            "field",
+            OffsetSourceFieldMapper.CharsetFormat.UTF_16,
+            Collections.emptyMap()
+        );
+    }
+}

From 422eb1af764f5f35f64016a8da038993b78ba69f Mon Sep 17 00:00:00 2001
From: Ignacio Vera <ignacio.vera@elastic.co>
Date: Thu, 5 Dec 2024 15:25:15 +0100
Subject: [PATCH 048/119] Remove bucketOrd field from InternalTerms and friends
 (#118044)

The field bucketOrd is only used for building the aggregation but has no use after that.
---
 .../search/aggregations/BucketOrder.java      |   8 +-
 .../search/aggregations/InternalOrder.java    |  21 +--
 .../countedterms/CountedTermsAggregator.java  |  89 ++++++-----
 .../bucket/terms/BucketPriorityQueue.java     |   8 +-
 .../BucketSignificancePriorityQueue.java      |   6 +-
 .../GlobalOrdinalsStringTermsAggregator.java  | 144 +++++++++++-------
 .../terms/InternalSignificantTerms.java       |  15 +-
 .../bucket/terms/InternalTerms.java           |  10 --
 .../terms/MapStringTermsAggregator.java       | 103 +++++++------
 .../bucket/terms/NumericTermsAggregator.java  | 115 ++++++++------
 .../bucket/terms/TermsAggregator.java         |   6 +-
 .../bucket/terms/TermsAggregatorFactory.java  |   6 +-
 .../multiterms/InternalMultiTerms.java        |   3 -
 .../multiterms/MultiTermsAggregator.java      | 103 +++++++------
 14 files changed, 355 insertions(+), 282 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/BucketOrder.java b/server/src/main/java/org/elasticsearch/search/aggregations/BucketOrder.java
index 2d360705f75b6..c412ecb5d6361 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/BucketOrder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/BucketOrder.java
@@ -12,6 +12,7 @@
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.search.aggregations.bucket.MultiBucketsAggregation.Bucket;
+import org.elasticsearch.search.aggregations.bucket.terms.BucketAndOrd;
 import org.elasticsearch.search.aggregations.support.AggregationPath;
 import org.elasticsearch.xcontent.ToXContentObject;
 
@@ -20,13 +21,12 @@
 import java.util.Comparator;
 import java.util.List;
 import java.util.function.BiFunction;
-import java.util.function.ToLongFunction;
 
 /**
  * {@link Bucket} ordering strategy. Buckets can be order either as
  * "complete" buckets using {@link #comparator()} or against a combination
  * of the buckets internals with its ordinal with
- * {@link #partiallyBuiltBucketComparator(ToLongFunction, Aggregator)}.
+ * {@link #partiallyBuiltBucketComparator(Aggregator)}.
  */
 public abstract class BucketOrder implements ToXContentObject, Writeable {
     /**
@@ -102,7 +102,7 @@ public final void validate(Aggregator aggregator) throws AggregationExecutionExc
          * to validate this order because doing so checks all of the appropriate
          * paths.
          */
-        partiallyBuiltBucketComparator(null, aggregator);
+        partiallyBuiltBucketComparator(aggregator);
     }
 
     /**
@@ -121,7 +121,7 @@ public final void validate(Aggregator aggregator) throws AggregationExecutionExc
      * with it all the time.
      * </p>
      */
-    public abstract <T extends Bucket> Comparator<T> partiallyBuiltBucketComparator(ToLongFunction<T> ordinalReader, Aggregator aggregator);
+    public abstract <T extends Bucket> Comparator<BucketAndOrd<T>> partiallyBuiltBucketComparator(Aggregator aggregator);
 
     /**
      * Build a comparator for fully built buckets.
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/InternalOrder.java b/server/src/main/java/org/elasticsearch/search/aggregations/InternalOrder.java
index b2ca4a10dc4b3..3593eb5adf7e4 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/InternalOrder.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/InternalOrder.java
@@ -15,6 +15,7 @@
 import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.search.aggregations.Aggregator.BucketComparator;
 import org.elasticsearch.search.aggregations.bucket.MultiBucketsAggregation.Bucket;
+import org.elasticsearch.search.aggregations.bucket.terms.BucketAndOrd;
 import org.elasticsearch.search.aggregations.support.AggregationPath;
 import org.elasticsearch.search.sort.SortOrder;
 import org.elasticsearch.search.sort.SortValue;
@@ -30,7 +31,6 @@
 import java.util.List;
 import java.util.Objects;
 import java.util.function.BiFunction;
-import java.util.function.ToLongFunction;
 
 /**
  * Implementations for {@link Bucket} ordering strategies.
@@ -63,10 +63,10 @@ public AggregationPath path() {
         }
 
         @Override
-        public <T extends Bucket> Comparator<T> partiallyBuiltBucketComparator(ToLongFunction<T> ordinalReader, Aggregator aggregator) {
+        public <T extends Bucket> Comparator<BucketAndOrd<T>> partiallyBuiltBucketComparator(Aggregator aggregator) {
             try {
                 BucketComparator bucketComparator = path.bucketComparator(aggregator, order);
-                return (lhs, rhs) -> bucketComparator.compare(ordinalReader.applyAsLong(lhs), ordinalReader.applyAsLong(rhs));
+                return (lhs, rhs) -> bucketComparator.compare(lhs.ord, rhs.ord);
             } catch (IllegalArgumentException e) {
                 throw new AggregationExecutionException.InvalidPath("Invalid aggregation order path [" + path + "]. " + e.getMessage(), e);
             }
@@ -188,12 +188,13 @@ public XContentBuilder toXContent(XContentBuilder builder, Params params) throws
         }
 
         @Override
-        public <T extends Bucket> Comparator<T> partiallyBuiltBucketComparator(ToLongFunction<T> ordinalReader, Aggregator aggregator) {
-            List<Comparator<T>> comparators = orderElements.stream()
-                .map(oe -> oe.partiallyBuiltBucketComparator(ordinalReader, aggregator))
-                .toList();
+        public <T extends Bucket> Comparator<BucketAndOrd<T>> partiallyBuiltBucketComparator(Aggregator aggregator) {
+            List<Comparator<BucketAndOrd<T>>> comparators = new ArrayList<>(orderElements.size());
+            for (BucketOrder order : orderElements) {
+                comparators.add(order.partiallyBuiltBucketComparator(aggregator));
+            }
             return (lhs, rhs) -> {
-                for (Comparator<T> c : comparators) {
+                for (Comparator<BucketAndOrd<T>> c : comparators) {
                     int result = c.compare(lhs, rhs);
                     if (result != 0) {
                         return result;
@@ -299,9 +300,9 @@ byte id() {
         }
 
         @Override
-        public <T extends Bucket> Comparator<T> partiallyBuiltBucketComparator(ToLongFunction<T> ordinalReader, Aggregator aggregator) {
+        public <T extends Bucket> Comparator<BucketAndOrd<T>> partiallyBuiltBucketComparator(Aggregator aggregator) {
             Comparator<Bucket> comparator = comparator();
-            return comparator::compare;
+            return (lhs, rhs) -> comparator.compare(lhs.bucket, rhs.bucket);
         }
 
         @Override
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/countedterms/CountedTermsAggregator.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/countedterms/CountedTermsAggregator.java
index 344b90b06c4f6..571ce3a9a4519 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/countedterms/CountedTermsAggregator.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/countedterms/CountedTermsAggregator.java
@@ -13,6 +13,7 @@
 import org.apache.lucene.index.SortedDocValues;
 import org.apache.lucene.index.SortedSetDocValues;
 import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.common.util.IntArray;
 import org.elasticsearch.common.util.LongArray;
 import org.elasticsearch.common.util.ObjectArray;
 import org.elasticsearch.core.Releasables;
@@ -26,6 +27,7 @@
 import org.elasticsearch.search.aggregations.InternalOrder;
 import org.elasticsearch.search.aggregations.LeafBucketCollector;
 import org.elasticsearch.search.aggregations.LeafBucketCollectorBase;
+import org.elasticsearch.search.aggregations.bucket.terms.BucketAndOrd;
 import org.elasticsearch.search.aggregations.bucket.terms.BucketPriorityQueue;
 import org.elasticsearch.search.aggregations.bucket.terms.BytesKeyedBucketOrds;
 import org.elasticsearch.search.aggregations.bucket.terms.InternalTerms;
@@ -38,7 +40,6 @@
 import java.util.Arrays;
 import java.util.Map;
 import java.util.function.BiConsumer;
-import java.util.function.Supplier;
 
 import static java.util.Collections.emptyList;
 import static org.elasticsearch.search.aggregations.InternalOrder.isKeyOrder;
@@ -115,51 +116,57 @@ public InternalAggregation[] buildAggregations(LongArray owningBucketOrds) throw
             LongArray otherDocCounts = bigArrays().newLongArray(owningBucketOrds.size());
             ObjectArray<StringTerms.Bucket[]> topBucketsPerOrd = bigArrays().newObjectArray(owningBucketOrds.size())
         ) {
-            for (long ordIdx = 0; ordIdx < topBucketsPerOrd.size(); ordIdx++) {
-                int size = (int) Math.min(bucketOrds.size(), bucketCountThresholds.getShardSize());
-
-                // as users can't control sort order, in practice we'll always sort by doc count descending
-                try (
-                    BucketPriorityQueue<StringTerms.Bucket> ordered = new BucketPriorityQueue<>(
-                        size,
-                        bigArrays(),
-                        partiallyBuiltBucketComparator
-                    )
-                ) {
-                    StringTerms.Bucket spare = null;
-                    BytesKeyedBucketOrds.BucketOrdsEnum ordsEnum = bucketOrds.ordsEnum(owningBucketOrds.get(ordIdx));
-                    Supplier<StringTerms.Bucket> emptyBucketBuilder = () -> new StringTerms.Bucket(
-                        new BytesRef(),
-                        0,
-                        null,
-                        false,
-                        0,
-                        format
-                    );
-                    while (ordsEnum.next()) {
-                        long docCount = bucketDocCount(ordsEnum.ord());
-                        otherDocCounts.increment(ordIdx, docCount);
-                        if (spare == null) {
-                            checkRealMemoryCBForInternalBucket();
-                            spare = emptyBucketBuilder.get();
+            try (IntArray bucketsToCollect = bigArrays().newIntArray(owningBucketOrds.size())) {
+                // find how many buckets we are going to collect
+                long ordsToCollect = 0;
+                for (long ordIdx = 0; ordIdx < owningBucketOrds.size(); ordIdx++) {
+                    int size = (int) Math.min(bucketOrds.bucketsInOrd(owningBucketOrds.get(ordIdx)), bucketCountThresholds.getShardSize());
+                    bucketsToCollect.set(ordIdx, size);
+                    ordsToCollect += size;
+                }
+                try (LongArray ordsArray = bigArrays().newLongArray(ordsToCollect)) {
+                    long ordsCollected = 0;
+                    for (long ordIdx = 0; ordIdx < owningBucketOrds.size(); ordIdx++) {
+                        // as users can't control sort order, in practice we'll always sort by doc count descending
+                        try (
+                            BucketPriorityQueue<StringTerms.Bucket> ordered = new BucketPriorityQueue<>(
+                                bucketsToCollect.get(ordIdx),
+                                bigArrays(),
+                                order.partiallyBuiltBucketComparator(this)
+                            )
+                        ) {
+                            BucketAndOrd<StringTerms.Bucket> spare = null;
+                            BytesKeyedBucketOrds.BucketOrdsEnum ordsEnum = bucketOrds.ordsEnum(owningBucketOrds.get(ordIdx));
+                            while (ordsEnum.next()) {
+                                long docCount = bucketDocCount(ordsEnum.ord());
+                                otherDocCounts.increment(ordIdx, docCount);
+                                if (spare == null) {
+                                    checkRealMemoryCBForInternalBucket();
+                                    spare = new BucketAndOrd<>(new StringTerms.Bucket(new BytesRef(), 0, null, false, 0, format));
+                                }
+                                ordsEnum.readValue(spare.bucket.getTermBytes());
+                                spare.bucket.setDocCount(docCount);
+                                spare.ord = ordsEnum.ord();
+                                spare = ordered.insertWithOverflow(spare);
+                            }
+                            final int orderedSize = (int) ordered.size();
+                            final StringTerms.Bucket[] buckets = new StringTerms.Bucket[orderedSize];
+                            for (int i = orderedSize - 1; i >= 0; --i) {
+                                BucketAndOrd<StringTerms.Bucket> bucketAndOrd = ordered.pop();
+                                buckets[i] = bucketAndOrd.bucket;
+                                ordsArray.set(ordsCollected + i, bucketAndOrd.ord);
+                                otherDocCounts.increment(ordIdx, -bucketAndOrd.bucket.getDocCount());
+                                bucketAndOrd.bucket.setTermBytes(BytesRef.deepCopyOf(bucketAndOrd.bucket.getTermBytes()));
+                            }
+                            topBucketsPerOrd.set(ordIdx, buckets);
+                            ordsCollected += orderedSize;
                         }
-                        ordsEnum.readValue(spare.getTermBytes());
-                        spare.setDocCount(docCount);
-                        spare.setBucketOrd(ordsEnum.ord());
-                        spare = ordered.insertWithOverflow(spare);
-                    }
-
-                    topBucketsPerOrd.set(ordIdx, new StringTerms.Bucket[(int) ordered.size()]);
-                    for (int i = (int) ordered.size() - 1; i >= 0; --i) {
-                        topBucketsPerOrd.get(ordIdx)[i] = ordered.pop();
-                        otherDocCounts.increment(ordIdx, -topBucketsPerOrd.get(ordIdx)[i].getDocCount());
-                        topBucketsPerOrd.get(ordIdx)[i].setTermBytes(BytesRef.deepCopyOf(topBucketsPerOrd.get(ordIdx)[i].getTermBytes()));
                     }
+                    assert ordsCollected == ordsArray.size();
+                    buildSubAggsForAllBuckets(topBucketsPerOrd, ordsArray, InternalTerms.Bucket::setAggregations);
                 }
             }
 
-            buildSubAggsForAllBuckets(topBucketsPerOrd, InternalTerms.Bucket::getBucketOrd, InternalTerms.Bucket::setAggregations);
-
             return buildAggregations(Math.toIntExact(owningBucketOrds.size()), ordIdx -> {
                 final BucketOrder reduceOrder;
                 if (isKeyOrder(order) == false) {
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/BucketPriorityQueue.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/BucketPriorityQueue.java
index 7f8e5c8c885fa..9550003a5bd1e 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/BucketPriorityQueue.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/BucketPriorityQueue.java
@@ -13,17 +13,17 @@
 
 import java.util.Comparator;
 
-public class BucketPriorityQueue<B> extends ObjectArrayPriorityQueue<B> {
+public class BucketPriorityQueue<B> extends ObjectArrayPriorityQueue<BucketAndOrd<B>> {
 
-    private final Comparator<? super B> comparator;
+    private final Comparator<BucketAndOrd<B>> comparator;
 
-    public BucketPriorityQueue(int size, BigArrays bigArrays, Comparator<? super B> comparator) {
+    public BucketPriorityQueue(int size, BigArrays bigArrays, Comparator<BucketAndOrd<B>> comparator) {
         super(size, bigArrays);
         this.comparator = comparator;
     }
 
     @Override
-    protected boolean lessThan(B a, B b) {
+    protected boolean lessThan(BucketAndOrd<B> a, BucketAndOrd<B> b) {
         return comparator.compare(a, b) > 0; // reverse, since we reverse again when adding to a list
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/BucketSignificancePriorityQueue.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/BucketSignificancePriorityQueue.java
index fe751c9e79189..4736f52d93622 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/BucketSignificancePriorityQueue.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/BucketSignificancePriorityQueue.java
@@ -12,14 +12,14 @@
 import org.elasticsearch.common.util.BigArrays;
 import org.elasticsearch.common.util.ObjectArrayPriorityQueue;
 
-public class BucketSignificancePriorityQueue<B extends SignificantTerms.Bucket> extends ObjectArrayPriorityQueue<B> {
+public class BucketSignificancePriorityQueue<B extends SignificantTerms.Bucket> extends ObjectArrayPriorityQueue<BucketAndOrd<B>> {
 
     public BucketSignificancePriorityQueue(int size, BigArrays bigArrays) {
         super(size, bigArrays);
     }
 
     @Override
-    protected boolean lessThan(SignificantTerms.Bucket o1, SignificantTerms.Bucket o2) {
-        return o1.getSignificanceScore() < o2.getSignificanceScore();
+    protected boolean lessThan(BucketAndOrd<B> o1, BucketAndOrd<B> o2) {
+        return o1.bucket.getSignificanceScore() < o2.bucket.getSignificanceScore();
     }
 }
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/GlobalOrdinalsStringTermsAggregator.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/GlobalOrdinalsStringTermsAggregator.java
index 0ec03a6f56dd9..439b61cc43ddf 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/GlobalOrdinalsStringTermsAggregator.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/GlobalOrdinalsStringTermsAggregator.java
@@ -20,6 +20,7 @@
 import org.apache.lucene.util.PriorityQueue;
 import org.elasticsearch.common.CheckedSupplier;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.util.IntArray;
 import org.elasticsearch.common.util.LongArray;
 import org.elasticsearch.common.util.LongHash;
 import org.elasticsearch.common.util.ObjectArray;
@@ -561,10 +562,10 @@ InternalAggregation[] buildAggregations(LongArray owningBucketOrds) throws IOExc
             ) {
                 GlobalOrdLookupFunction lookupGlobalOrd = valuesSupplier.get()::lookupOrd;
                 final int size = (int) Math.min(valueCount, bucketCountThresholds.getShardSize());
-                try (ObjectArrayPriorityQueue<TB> ordered = collectionStrategy.buildPriorityQueue(size)) {
+                try (ObjectArrayPriorityQueue<BucketAndOrd<TB>> ordered = collectionStrategy.buildPriorityQueue(size)) {
                     BucketUpdater<TB> updater = collectionStrategy.bucketUpdater(0, lookupGlobalOrd);
                     collect(new BucketInfoConsumer() {
-                        TB spare = null;
+                        BucketAndOrd<TB> spare = null;
 
                         @Override
                         public void accept(long globalOrd, long bucketOrd, long docCount) throws IOException {
@@ -572,24 +573,31 @@ public void accept(long globalOrd, long bucketOrd, long docCount) throws IOExcep
                             if (docCount >= bucketCountThresholds.getShardMinDocCount()) {
                                 if (spare == null) {
                                     checkRealMemoryCBForInternalBucket();
-                                    spare = collectionStrategy.buildEmptyTemporaryBucket();
+                                    spare = new BucketAndOrd<>(collectionStrategy.buildEmptyTemporaryBucket());
                                 }
-                                updater.updateBucket(spare, globalOrd, bucketOrd, docCount);
+                                spare.ord = bucketOrd;
+                                updater.updateBucket(spare.bucket, globalOrd, docCount);
                                 spare = ordered.insertWithOverflow(spare);
                             }
                         }
                     });
 
                     // Get the top buckets
-                    topBucketsPreOrd.set(0, collectionStrategy.buildBuckets((int) ordered.size()));
-                    for (int i = (int) ordered.size() - 1; i >= 0; --i) {
-                        checkRealMemoryCBForInternalBucket();
-                        B bucket = collectionStrategy.convertTempBucketToRealBucket(ordered.pop(), lookupGlobalOrd);
-                        topBucketsPreOrd.get(0)[i] = bucket;
-                        otherDocCount.increment(0, -bucket.getDocCount());
+                    int orderedSize = (int) ordered.size();
+                    try (LongArray ordsArray = bigArrays().newLongArray(orderedSize)) {
+                        B[] buckets = collectionStrategy.buildBuckets(orderedSize);
+                        for (int i = orderedSize - 1; i >= 0; --i) {
+                            checkRealMemoryCBForInternalBucket();
+                            BucketAndOrd<TB> bucketAndOrd = ordered.pop();
+                            B bucket = collectionStrategy.convertTempBucketToRealBucket(bucketAndOrd.bucket, lookupGlobalOrd);
+                            ordsArray.set(i, bucketAndOrd.ord);
+                            buckets[i] = bucket;
+                            otherDocCount.increment(0, -bucket.getDocCount());
+                        }
+                        topBucketsPreOrd.set(0, buckets);
+                        collectionStrategy.buildSubAggs(topBucketsPreOrd, ordsArray);
                     }
                 }
-                collectionStrategy.buildSubAggs(topBucketsPreOrd);
                 return GlobalOrdinalsStringTermsAggregator.this.buildAggregations(
                     Math.toIntExact(owningBucketOrds.size()),
                     ordIdx -> collectionStrategy.buildResult(
@@ -710,39 +718,61 @@ InternalAggregation[] buildAggregations(LongArray owningBucketOrds) throws IOExc
                 LongArray otherDocCount = bigArrays().newLongArray(owningBucketOrds.size(), true);
                 ObjectArray<B[]> topBucketsPreOrd = collectionStrategy.buildTopBucketsPerOrd(owningBucketOrds.size())
             ) {
-                GlobalOrdLookupFunction lookupGlobalOrd = valuesSupplier.get()::lookupOrd;
-                for (long ordIdx = 0; ordIdx < topBucketsPreOrd.size(); ordIdx++) {
-                    long owningBucketOrd = owningBucketOrds.get(ordIdx);
-                    collectZeroDocEntriesIfNeeded(owningBucketOrds.get(ordIdx));
-                    int size = (int) Math.min(bucketOrds.bucketsInOrd(owningBucketOrd), bucketCountThresholds.getShardSize());
-                    try (ObjectArrayPriorityQueue<TB> ordered = collectionStrategy.buildPriorityQueue(size)) {
-                        BucketUpdater<TB> updater = collectionStrategy.bucketUpdater(owningBucketOrd, lookupGlobalOrd);
-                        LongKeyedBucketOrds.BucketOrdsEnum ordsEnum = bucketOrds.ordsEnum(owningBucketOrd);
-                        TB spare = null;
-                        while (ordsEnum.next()) {
-                            long docCount = bucketDocCount(ordsEnum.ord());
-                            otherDocCount.increment(ordIdx, docCount);
-                            if (docCount < bucketCountThresholds.getShardMinDocCount()) {
-                                continue;
-                            }
-                            if (spare == null) {
-                                checkRealMemoryCBForInternalBucket();
-                                spare = collectionStrategy.buildEmptyTemporaryBucket();
+                try (IntArray bucketsToCollect = bigArrays().newIntArray(owningBucketOrds.size())) {
+                    long ordsToCollect = 0;
+                    for (long ordIdx = 0; ordIdx < owningBucketOrds.size(); ordIdx++) {
+                        final long owningBucketOrd = owningBucketOrds.get(ordIdx);
+                        collectZeroDocEntriesIfNeeded(owningBucketOrd);
+                        final int size = (int) Math.min(bucketOrds.bucketsInOrd(owningBucketOrd), bucketCountThresholds.getShardSize());
+                        ordsToCollect += size;
+                        bucketsToCollect.set(ordIdx, size);
+                    }
+                    try (LongArray ordsArray = bigArrays().newLongArray(ordsToCollect)) {
+                        long ordsCollected = 0;
+                        GlobalOrdLookupFunction lookupGlobalOrd = valuesSupplier.get()::lookupOrd;
+                        for (long ordIdx = 0; ordIdx < topBucketsPreOrd.size(); ordIdx++) {
+                            long owningBucketOrd = owningBucketOrds.get(ordIdx);
+                            try (
+                                ObjectArrayPriorityQueue<BucketAndOrd<TB>> ordered = collectionStrategy.buildPriorityQueue(
+                                    bucketsToCollect.get(ordIdx)
+                                )
+                            ) {
+                                BucketUpdater<TB> updater = collectionStrategy.bucketUpdater(owningBucketOrd, lookupGlobalOrd);
+                                LongKeyedBucketOrds.BucketOrdsEnum ordsEnum = bucketOrds.ordsEnum(owningBucketOrd);
+                                BucketAndOrd<TB> spare = null;
+                                while (ordsEnum.next()) {
+                                    long docCount = bucketDocCount(ordsEnum.ord());
+                                    otherDocCount.increment(ordIdx, docCount);
+                                    if (docCount < bucketCountThresholds.getShardMinDocCount()) {
+                                        continue;
+                                    }
+                                    if (spare == null) {
+                                        checkRealMemoryCBForInternalBucket();
+                                        spare = new BucketAndOrd<>(collectionStrategy.buildEmptyTemporaryBucket());
+                                    }
+                                    updater.updateBucket(spare.bucket, ordsEnum.value(), docCount);
+                                    spare.ord = ordsEnum.ord();
+                                    spare = ordered.insertWithOverflow(spare);
+                                }
+                                // Get the top buckets
+                                int orderedSize = (int) ordered.size();
+                                B[] buckets = collectionStrategy.buildBuckets(orderedSize);
+                                for (int i = orderedSize - 1; i >= 0; --i) {
+                                    checkRealMemoryCBForInternalBucket();
+                                    BucketAndOrd<TB> bucketAndOrd = ordered.pop();
+                                    B bucket = collectionStrategy.convertTempBucketToRealBucket(bucketAndOrd.bucket, lookupGlobalOrd);
+                                    ordsArray.set(ordsCollected + i, bucketAndOrd.ord);
+                                    buckets[i] = bucket;
+                                    otherDocCount.increment(ordIdx, -bucket.getDocCount());
+                                }
+                                topBucketsPreOrd.set(ordIdx, buckets);
+                                ordsCollected += orderedSize;
                             }
-                            updater.updateBucket(spare, ordsEnum.value(), ordsEnum.ord(), docCount);
-                            spare = ordered.insertWithOverflow(spare);
-                        }
-                        // Get the top buckets
-                        topBucketsPreOrd.set(ordIdx, collectionStrategy.buildBuckets((int) ordered.size()));
-                        for (int i = (int) ordered.size() - 1; i >= 0; --i) {
-                            checkRealMemoryCBForInternalBucket();
-                            B bucket = collectionStrategy.convertTempBucketToRealBucket(ordered.pop(), lookupGlobalOrd);
-                            topBucketsPreOrd.get(ordIdx)[i] = bucket;
-                            otherDocCount.increment(ordIdx, -bucket.getDocCount());
                         }
+                        assert ordsCollected == ordsArray.size();
+                        collectionStrategy.buildSubAggs(topBucketsPreOrd, ordsArray);
                     }
                 }
-                collectionStrategy.buildSubAggs(topBucketsPreOrd);
                 return GlobalOrdinalsStringTermsAggregator.this.buildAggregations(
                     Math.toIntExact(owningBucketOrds.size()),
                     ordIdx -> collectionStrategy.buildResult(
@@ -791,7 +821,7 @@ abstract class ResultStrategy<
          * Build a {@link PriorityQueue} to sort the buckets. After we've
          * collected all of the buckets we'll collect all entries in the queue.
          */
-        abstract ObjectArrayPriorityQueue<TB> buildPriorityQueue(int size);
+        abstract ObjectArrayPriorityQueue<BucketAndOrd<TB>> buildPriorityQueue(int size);
 
         /**
          * Build an array to hold the "top" buckets for each ordinal.
@@ -813,7 +843,7 @@ abstract class ResultStrategy<
          * Build the sub-aggregations into the buckets. This will usually
          * delegate to {@link #buildSubAggsForAllBuckets}.
          */
-        abstract void buildSubAggs(ObjectArray<B[]> topBucketsPreOrd) throws IOException;
+        abstract void buildSubAggs(ObjectArray<B[]> topBucketsPreOrd, LongArray ordsArray) throws IOException;
 
         /**
          * Turn the buckets into an aggregation result.
@@ -834,7 +864,7 @@ abstract class ResultStrategy<
     }
 
     interface BucketUpdater<TB extends InternalMultiBucketAggregation.InternalBucket> {
-        void updateBucket(TB spare, long globalOrd, long bucketOrd, long docCount) throws IOException;
+        void updateBucket(TB spare, long globalOrd, long docCount) throws IOException;
     }
 
     /**
@@ -868,29 +898,30 @@ OrdBucket buildEmptyTemporaryBucket() {
 
         @Override
         BucketUpdater<OrdBucket> bucketUpdater(long owningBucketOrd, GlobalOrdLookupFunction lookupGlobalOrd) {
-            return (spare, globalOrd, bucketOrd, docCount) -> {
+            return (spare, globalOrd, docCount) -> {
                 spare.globalOrd = globalOrd;
-                spare.bucketOrd = bucketOrd;
                 spare.docCount = docCount;
             };
         }
 
         @Override
-        ObjectArrayPriorityQueue<OrdBucket> buildPriorityQueue(int size) {
-            return new BucketPriorityQueue<>(size, bigArrays(), partiallyBuiltBucketComparator);
+        ObjectArrayPriorityQueue<BucketAndOrd<OrdBucket>> buildPriorityQueue(int size) {
+            return new BucketPriorityQueue<>(
+                size,
+                bigArrays(),
+                order.partiallyBuiltBucketComparator(GlobalOrdinalsStringTermsAggregator.this)
+            );
         }
 
         @Override
         StringTerms.Bucket convertTempBucketToRealBucket(OrdBucket temp, GlobalOrdLookupFunction lookupGlobalOrd) throws IOException {
             BytesRef term = BytesRef.deepCopyOf(lookupGlobalOrd.apply(temp.globalOrd));
-            StringTerms.Bucket result = new StringTerms.Bucket(term, temp.docCount, null, showTermDocCountError, 0, format);
-            result.bucketOrd = temp.bucketOrd;
-            return result;
+            return new StringTerms.Bucket(term, temp.docCount, null, showTermDocCountError, 0, format);
         }
 
         @Override
-        void buildSubAggs(ObjectArray<StringTerms.Bucket[]> topBucketsPreOrd) throws IOException {
-            buildSubAggsForAllBuckets(topBucketsPreOrd, b -> b.bucketOrd, (b, aggs) -> b.aggregations = aggs);
+        void buildSubAggs(ObjectArray<StringTerms.Bucket[]> topBucketsPreOrd, LongArray ordsArray) throws IOException {
+            buildSubAggsForAllBuckets(topBucketsPreOrd, ordsArray, (b, aggs) -> b.aggregations = aggs);
         }
 
         @Override
@@ -1005,8 +1036,7 @@ private long subsetSize(long owningBucketOrd) {
         @Override
         BucketUpdater<SignificantStringTerms.Bucket> bucketUpdater(long owningBucketOrd, GlobalOrdLookupFunction lookupGlobalOrd) {
             long subsetSize = subsetSize(owningBucketOrd);
-            return (spare, globalOrd, bucketOrd, docCount) -> {
-                spare.bucketOrd = bucketOrd;
+            return (spare, globalOrd, docCount) -> {
                 oversizedCopy(lookupGlobalOrd.apply(globalOrd), spare.termBytes);
                 spare.subsetDf = docCount;
                 spare.supersetDf = backgroundFrequencies.freq(spare.termBytes);
@@ -1020,7 +1050,7 @@ BucketUpdater<SignificantStringTerms.Bucket> bucketUpdater(long owningBucketOrd,
         }
 
         @Override
-        ObjectArrayPriorityQueue<SignificantStringTerms.Bucket> buildPriorityQueue(int size) {
+        ObjectArrayPriorityQueue<BucketAndOrd<SignificantStringTerms.Bucket>> buildPriorityQueue(int size) {
             return new BucketSignificancePriorityQueue<>(size, bigArrays());
         }
 
@@ -1033,8 +1063,8 @@ SignificantStringTerms.Bucket convertTempBucketToRealBucket(
         }
 
         @Override
-        void buildSubAggs(ObjectArray<SignificantStringTerms.Bucket[]> topBucketsPreOrd) throws IOException {
-            buildSubAggsForAllBuckets(topBucketsPreOrd, b -> b.bucketOrd, (b, aggs) -> b.aggregations = aggs);
+        void buildSubAggs(ObjectArray<SignificantStringTerms.Bucket[]> topBucketsPreOrd, LongArray ordsArray) throws IOException {
+            buildSubAggsForAllBuckets(topBucketsPreOrd, ordsArray, (b, aggs) -> b.aggregations = aggs);
         }
 
         @Override
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalSignificantTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalSignificantTerms.java
index 78ae2481f5d99..5108793b8a809 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalSignificantTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalSignificantTerms.java
@@ -10,12 +10,12 @@
 
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.util.ObjectArrayPriorityQueue;
 import org.elasticsearch.common.util.ObjectObjectPagedHashMap;
 import org.elasticsearch.core.Releasables;
 import org.elasticsearch.search.DocValueFormat;
 import org.elasticsearch.search.aggregations.AggregationErrors;
 import org.elasticsearch.search.aggregations.AggregationReduceContext;
-import org.elasticsearch.search.aggregations.Aggregator;
 import org.elasticsearch.search.aggregations.AggregatorReducer;
 import org.elasticsearch.search.aggregations.InternalAggregation;
 import org.elasticsearch.search.aggregations.InternalAggregations;
@@ -58,12 +58,6 @@ public interface Reader<B extends Bucket<B>> {
 
         long subsetDf;
         long supersetDf;
-        /**
-         * Ordinal of the bucket while it is being built. Not used after it is
-         * returned from {@link Aggregator#buildAggregations(org.elasticsearch.common.util.LongArray)} and not
-         * serialized.
-         */
-        transient long bucketOrd;
         double score;
         protected InternalAggregations aggregations;
         final transient DocValueFormat format;
@@ -235,7 +229,12 @@ canLeadReduction here is essentially checking if this shard returned data.  Unma
             public InternalAggregation get() {
                 final SignificanceHeuristic heuristic = getSignificanceHeuristic().rewrite(reduceContext);
                 final int size = (int) (reduceContext.isFinalReduce() == false ? buckets.size() : Math.min(requiredSize, buckets.size()));
-                try (BucketSignificancePriorityQueue<B> ordered = new BucketSignificancePriorityQueue<>(size, reduceContext.bigArrays())) {
+                try (ObjectArrayPriorityQueue<B> ordered = new ObjectArrayPriorityQueue<B>(size, reduceContext.bigArrays()) {
+                    @Override
+                    protected boolean lessThan(B a, B b) {
+                        return a.getSignificanceScore() < b.getSignificanceScore();
+                    }
+                }) {
                     buckets.forEach(entry -> {
                         final B b = createBucket(
                             entry.value.subsetDf[0],
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalTerms.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalTerms.java
index 739f0b923eaab..de35046691b34 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalTerms.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/InternalTerms.java
@@ -38,8 +38,6 @@ public interface Reader<B extends Bucket<B>> {
             B read(StreamInput in, DocValueFormat format, boolean showDocCountError) throws IOException;
         }
 
-        long bucketOrd;
-
         protected long docCount;
         private long docCountError;
         protected InternalAggregations aggregations;
@@ -88,14 +86,6 @@ public void setDocCount(long docCount) {
             this.docCount = docCount;
         }
 
-        public long getBucketOrd() {
-            return bucketOrd;
-        }
-
-        public void setBucketOrd(long bucketOrd) {
-            this.bucketOrd = bucketOrd;
-        }
-
         @Override
         public long getDocCountError() {
             return docCountError;
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/MapStringTermsAggregator.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/MapStringTermsAggregator.java
index b96c495d37489..026912a583ef3 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/MapStringTermsAggregator.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/MapStringTermsAggregator.java
@@ -17,6 +17,7 @@
 import org.apache.lucene.util.BytesRef;
 import org.apache.lucene.util.BytesRefBuilder;
 import org.apache.lucene.util.PriorityQueue;
+import org.elasticsearch.common.util.IntArray;
 import org.elasticsearch.common.util.LongArray;
 import org.elasticsearch.common.util.ObjectArray;
 import org.elasticsearch.common.util.ObjectArrayPriorityQueue;
@@ -43,6 +44,7 @@
 
 import java.io.IOException;
 import java.util.Arrays;
+import java.util.Comparator;
 import java.util.Map;
 import java.util.function.BiConsumer;
 import java.util.function.Function;
@@ -287,40 +289,55 @@ private InternalAggregation[] buildAggregations(LongArray owningBucketOrds) thro
                 LongArray otherDocCounts = bigArrays().newLongArray(owningBucketOrds.size(), true);
                 ObjectArray<B[]> topBucketsPerOrd = buildTopBucketsPerOrd(Math.toIntExact(owningBucketOrds.size()))
             ) {
-                for (long ordIdx = 0; ordIdx < topBucketsPerOrd.size(); ordIdx++) {
-                    long owningOrd = owningBucketOrds.get(ordIdx);
-                    collectZeroDocEntriesIfNeeded(owningOrd, excludeDeletedDocs);
-                    int size = (int) Math.min(bucketOrds.size(), bucketCountThresholds.getShardSize());
-
-                    try (ObjectArrayPriorityQueue<B> ordered = buildPriorityQueue(size)) {
-                        B spare = null;
-                        BytesKeyedBucketOrds.BucketOrdsEnum ordsEnum = bucketOrds.ordsEnum(owningOrd);
-                        BucketUpdater<B> bucketUpdater = bucketUpdater(owningOrd);
-                        while (ordsEnum.next()) {
-                            long docCount = bucketDocCount(ordsEnum.ord());
-                            otherDocCounts.increment(ordIdx, docCount);
-                            if (docCount < bucketCountThresholds.getShardMinDocCount()) {
-                                continue;
-                            }
-                            if (spare == null) {
-                                checkRealMemoryCBForInternalBucket();
-                                spare = buildEmptyBucket();
+                try (IntArray bucketsToCollect = bigArrays().newIntArray(owningBucketOrds.size())) {
+                    long ordsToCollect = 0;
+                    for (long ordIdx = 0; ordIdx < owningBucketOrds.size(); ordIdx++) {
+                        final long owningBucketOrd = owningBucketOrds.get(ordIdx);
+                        collectZeroDocEntriesIfNeeded(owningBucketOrd, excludeDeletedDocs);
+                        final int size = (int) Math.min(bucketOrds.bucketsInOrd(owningBucketOrd), bucketCountThresholds.getShardSize());
+                        ordsToCollect += size;
+                        bucketsToCollect.set(ordIdx, size);
+                    }
+                    try (LongArray ordsArray = bigArrays().newLongArray(ordsToCollect)) {
+                        long ordsCollected = 0;
+                        for (long ordIdx = 0; ordIdx < topBucketsPerOrd.size(); ordIdx++) {
+                            long owningOrd = owningBucketOrds.get(ordIdx);
+                            try (ObjectArrayPriorityQueue<BucketAndOrd<B>> ordered = buildPriorityQueue(bucketsToCollect.get(ordIdx))) {
+                                BucketAndOrd<B> spare = null;
+                                BytesKeyedBucketOrds.BucketOrdsEnum ordsEnum = bucketOrds.ordsEnum(owningOrd);
+                                BucketUpdater<B> bucketUpdater = bucketUpdater(owningOrd);
+                                while (ordsEnum.next()) {
+                                    long docCount = bucketDocCount(ordsEnum.ord());
+                                    otherDocCounts.increment(ordIdx, docCount);
+                                    if (docCount < bucketCountThresholds.getShardMinDocCount()) {
+                                        continue;
+                                    }
+                                    if (spare == null) {
+                                        checkRealMemoryCBForInternalBucket();
+                                        spare = new BucketAndOrd<>(buildEmptyBucket());
+                                    }
+                                    bucketUpdater.updateBucket(spare.bucket, ordsEnum, docCount);
+                                    spare.ord = ordsEnum.ord();
+                                    spare = ordered.insertWithOverflow(spare);
+                                }
+
+                                final int orderedSize = (int) ordered.size();
+                                final B[] buckets = buildBuckets(orderedSize);
+                                for (int i = orderedSize - 1; i >= 0; --i) {
+                                    BucketAndOrd<B> bucketAndOrd = ordered.pop();
+                                    finalizeBucket(bucketAndOrd.bucket);
+                                    buckets[i] = bucketAndOrd.bucket;
+                                    ordsArray.set(ordsCollected + i, bucketAndOrd.ord);
+                                    otherDocCounts.increment(ordIdx, -bucketAndOrd.bucket.getDocCount());
+                                }
+                                topBucketsPerOrd.set(ordIdx, buckets);
+                                ordsCollected += orderedSize;
                             }
-                            bucketUpdater.updateBucket(spare, ordsEnum, docCount);
-                            spare = ordered.insertWithOverflow(spare);
-                        }
-
-                        topBucketsPerOrd.set(ordIdx, buildBuckets((int) ordered.size()));
-                        for (int i = (int) ordered.size() - 1; i >= 0; --i) {
-                            topBucketsPerOrd.get(ordIdx)[i] = ordered.pop();
-                            otherDocCounts.increment(ordIdx, -topBucketsPerOrd.get(ordIdx)[i].getDocCount());
-                            finalizeBucket(topBucketsPerOrd.get(ordIdx)[i]);
                         }
+                        assert ordsCollected == ordsArray.size();
+                        buildSubAggs(topBucketsPerOrd, ordsArray);
                     }
                 }
-
-                buildSubAggs(topBucketsPerOrd);
-
                 return MapStringTermsAggregator.this.buildAggregations(
                     Math.toIntExact(owningBucketOrds.size()),
                     ordIdx -> buildResult(owningBucketOrds.get(ordIdx), otherDocCounts.get(ordIdx), topBucketsPerOrd.get(ordIdx))
@@ -355,7 +372,7 @@ private InternalAggregation[] buildAggregations(LongArray owningBucketOrds) thro
          * Build a {@link PriorityQueue} to sort the buckets. After we've
          * collected all of the buckets we'll collect all entries in the queue.
          */
-        abstract ObjectArrayPriorityQueue<B> buildPriorityQueue(int size);
+        abstract ObjectArrayPriorityQueue<BucketAndOrd<B>> buildPriorityQueue(int size);
 
         /**
          * Update fields in {@code spare} to reflect information collected for
@@ -382,9 +399,9 @@ private InternalAggregation[] buildAggregations(LongArray owningBucketOrds) thro
 
         /**
          * Build the sub-aggregations into the buckets. This will usually
-         * delegate to {@link #buildSubAggsForAllBuckets}.
+         * delegate to {@link #buildSubAggsForAllBuckets(ObjectArray, LongArray, BiConsumer)}.
          */
-        abstract void buildSubAggs(ObjectArray<B[]> topBucketsPerOrd) throws IOException;
+        abstract void buildSubAggs(ObjectArray<B[]> topBucketsPerOrd, LongArray ordsArray) throws IOException;
 
         /**
          * Turn the buckets into an aggregation result.
@@ -407,9 +424,11 @@ interface BucketUpdater<B extends InternalMultiBucketAggregation.InternalBucket>
      */
     class StandardTermsResults extends ResultStrategy<StringTerms, StringTerms.Bucket> {
         private final ValuesSource valuesSource;
+        private final Comparator<BucketAndOrd<StringTerms.Bucket>> comparator;
 
-        StandardTermsResults(ValuesSource valuesSource) {
+        StandardTermsResults(ValuesSource valuesSource, Aggregator aggregator) {
             this.valuesSource = valuesSource;
+            this.comparator = order.partiallyBuiltBucketComparator(aggregator);
         }
 
         @Override
@@ -498,8 +517,8 @@ StringTerms.Bucket buildEmptyBucket() {
         }
 
         @Override
-        ObjectArrayPriorityQueue<StringTerms.Bucket> buildPriorityQueue(int size) {
-            return new BucketPriorityQueue<>(size, bigArrays(), partiallyBuiltBucketComparator);
+        ObjectArrayPriorityQueue<BucketAndOrd<StringTerms.Bucket>> buildPriorityQueue(int size) {
+            return new BucketPriorityQueue<>(size, bigArrays(), comparator);
         }
 
         @Override
@@ -507,7 +526,6 @@ BucketUpdater<StringTerms.Bucket> bucketUpdater(long owningBucketOrd) {
             return (spare, ordsEnum, docCount) -> {
                 ordsEnum.readValue(spare.termBytes);
                 spare.docCount = docCount;
-                spare.bucketOrd = ordsEnum.ord();
             };
         }
 
@@ -532,8 +550,8 @@ void finalizeBucket(StringTerms.Bucket bucket) {
         }
 
         @Override
-        void buildSubAggs(ObjectArray<StringTerms.Bucket[]> topBucketsPerOrd) throws IOException {
-            buildSubAggsForAllBuckets(topBucketsPerOrd, b -> b.bucketOrd, (b, a) -> b.aggregations = a);
+        void buildSubAggs(ObjectArray<StringTerms.Bucket[]> topBucketsPerOrd, LongArray ordArray) throws IOException {
+            buildSubAggsForAllBuckets(topBucketsPerOrd, ordArray, (b, a) -> b.aggregations = a);
         }
 
         @Override
@@ -625,7 +643,7 @@ SignificantStringTerms.Bucket buildEmptyBucket() {
         }
 
         @Override
-        ObjectArrayPriorityQueue<SignificantStringTerms.Bucket> buildPriorityQueue(int size) {
+        ObjectArrayPriorityQueue<BucketAndOrd<SignificantStringTerms.Bucket>> buildPriorityQueue(int size) {
             return new BucketSignificancePriorityQueue<>(size, bigArrays());
         }
 
@@ -634,7 +652,6 @@ BucketUpdater<SignificantStringTerms.Bucket> bucketUpdater(long owningBucketOrd)
             long subsetSize = subsetSizes.get(owningBucketOrd);
             return (spare, ordsEnum, docCount) -> {
                 ordsEnum.readValue(spare.termBytes);
-                spare.bucketOrd = ordsEnum.ord();
                 spare.subsetDf = docCount;
                 spare.supersetDf = backgroundFrequencies.freq(spare.termBytes);
                 /*
@@ -667,8 +684,8 @@ void finalizeBucket(SignificantStringTerms.Bucket bucket) {
         }
 
         @Override
-        void buildSubAggs(ObjectArray<SignificantStringTerms.Bucket[]> topBucketsPerOrd) throws IOException {
-            buildSubAggsForAllBuckets(topBucketsPerOrd, b -> b.bucketOrd, (b, a) -> b.aggregations = a);
+        void buildSubAggs(ObjectArray<SignificantStringTerms.Bucket[]> topBucketsPerOrd, LongArray ordsArray) throws IOException {
+            buildSubAggsForAllBuckets(topBucketsPerOrd, ordsArray, (b, a) -> b.aggregations = a);
         }
 
         @Override
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/NumericTermsAggregator.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/NumericTermsAggregator.java
index 5d4c15d8a3b80..a54053f712f8d 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/NumericTermsAggregator.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/NumericTermsAggregator.java
@@ -14,6 +14,7 @@
 import org.apache.lucene.index.SortedNumericDocValues;
 import org.apache.lucene.search.ScoreMode;
 import org.apache.lucene.util.NumericUtils;
+import org.elasticsearch.common.util.IntArray;
 import org.elasticsearch.common.util.LongArray;
 import org.elasticsearch.common.util.ObjectArray;
 import org.elasticsearch.common.util.ObjectArrayPriorityQueue;
@@ -40,6 +41,7 @@
 
 import java.io.IOException;
 import java.util.Arrays;
+import java.util.Comparator;
 import java.util.Map;
 import java.util.function.BiConsumer;
 import java.util.function.Function;
@@ -167,42 +169,56 @@ private InternalAggregation[] buildAggregations(LongArray owningBucketOrds) thro
                 LongArray otherDocCounts = bigArrays().newLongArray(owningBucketOrds.size(), true);
                 ObjectArray<B[]> topBucketsPerOrd = buildTopBucketsPerOrd(owningBucketOrds.size())
             ) {
-                for (long ordIdx = 0; ordIdx < topBucketsPerOrd.size(); ordIdx++) {
-                    final long owningBucketOrd = owningBucketOrds.get(ordIdx);
-                    collectZeroDocEntriesIfNeeded(owningBucketOrd, excludeDeletedDocs);
-                    long bucketsInOrd = bucketOrds.bucketsInOrd(owningBucketOrd);
-
-                    int size = (int) Math.min(bucketsInOrd, bucketCountThresholds.getShardSize());
-                    try (ObjectArrayPriorityQueue<B> ordered = buildPriorityQueue(size)) {
-                        B spare = null;
-                        BucketOrdsEnum ordsEnum = bucketOrds.ordsEnum(owningBucketOrd);
-                        BucketUpdater<B> bucketUpdater = bucketUpdater(owningBucketOrd);
-                        while (ordsEnum.next()) {
-                            long docCount = bucketDocCount(ordsEnum.ord());
-                            otherDocCounts.increment(ordIdx, docCount);
-                            if (docCount < bucketCountThresholds.getShardMinDocCount()) {
-                                continue;
-                            }
-                            if (spare == null) {
-                                checkRealMemoryCBForInternalBucket();
-                                spare = buildEmptyBucket();
-                            }
-                            bucketUpdater.updateBucket(spare, ordsEnum, docCount);
-                            spare = ordered.insertWithOverflow(spare);
-                        }
+                try (IntArray bucketsToCollect = bigArrays().newIntArray(owningBucketOrds.size())) {
+                    long ordsToCollect = 0;
+                    for (long ordIdx = 0; ordIdx < owningBucketOrds.size(); ordIdx++) {
+                        final long owningBucketOrd = owningBucketOrds.get(ordIdx);
+                        collectZeroDocEntriesIfNeeded(owningBucketOrd, excludeDeletedDocs);
+                        int size = (int) Math.min(bucketOrds.bucketsInOrd(owningBucketOrd), bucketCountThresholds.getShardSize());
+                        bucketsToCollect.set(ordIdx, size);
+                        ordsToCollect += size;
+                    }
+                    try (LongArray ordsArray = bigArrays().newLongArray(ordsToCollect)) {
+                        long ordsCollected = 0;
+                        for (long ordIdx = 0; ordIdx < topBucketsPerOrd.size(); ordIdx++) {
+                            final long owningBucketOrd = owningBucketOrds.get(ordIdx);
+                            try (ObjectArrayPriorityQueue<BucketAndOrd<B>> ordered = buildPriorityQueue(bucketsToCollect.get(ordIdx))) {
+                                BucketAndOrd<B> spare = null;
+                                BucketOrdsEnum ordsEnum = bucketOrds.ordsEnum(owningBucketOrd);
+                                BucketUpdater<B> bucketUpdater = bucketUpdater(owningBucketOrd);
+                                while (ordsEnum.next()) {
+                                    long docCount = bucketDocCount(ordsEnum.ord());
+                                    otherDocCounts.increment(ordIdx, docCount);
+                                    if (docCount < bucketCountThresholds.getShardMinDocCount()) {
+                                        continue;
+                                    }
+                                    if (spare == null) {
+                                        checkRealMemoryCBForInternalBucket();
+                                        spare = new BucketAndOrd<>(buildEmptyBucket());
+                                    }
+                                    bucketUpdater.updateBucket(spare.bucket, ordsEnum, docCount);
+                                    spare.ord = ordsEnum.ord();
+                                    spare = ordered.insertWithOverflow(spare);
+                                }
+
+                                // Get the top buckets
+                                final int orderedSize = (int) ordered.size();
+                                final B[] bucketsForOrd = buildBuckets(orderedSize);
+                                for (int b = orderedSize - 1; b >= 0; --b) {
+                                    BucketAndOrd<B> bucketAndOrd = ordered.pop();
+                                    bucketsForOrd[b] = bucketAndOrd.bucket;
+                                    ordsArray.set(ordsCollected + b, bucketAndOrd.ord);
+                                    otherDocCounts.increment(ordIdx, -bucketAndOrd.bucket.getDocCount());
+                                }
+                                topBucketsPerOrd.set(ordIdx, bucketsForOrd);
+                                ordsCollected += orderedSize;
 
-                        // Get the top buckets
-                        B[] bucketsForOrd = buildBuckets((int) ordered.size());
-                        topBucketsPerOrd.set(ordIdx, bucketsForOrd);
-                        for (int b = (int) ordered.size() - 1; b >= 0; --b) {
-                            topBucketsPerOrd.get(ordIdx)[b] = ordered.pop();
-                            otherDocCounts.increment(ordIdx, -topBucketsPerOrd.get(ordIdx)[b].getDocCount());
+                            }
                         }
+                        assert ordsCollected == ordsArray.size();
+                        buildSubAggs(topBucketsPerOrd, ordsArray);
                     }
                 }
-
-                buildSubAggs(topBucketsPerOrd);
-
                 return NumericTermsAggregator.this.buildAggregations(
                     Math.toIntExact(owningBucketOrds.size()),
                     ordIdx -> buildResult(owningBucketOrds.get(ordIdx), otherDocCounts.get(ordIdx), topBucketsPerOrd.get(ordIdx))
@@ -254,13 +270,13 @@ private InternalAggregation[] buildAggregations(LongArray owningBucketOrds) thro
          * Build a {@link ObjectArrayPriorityQueue} to sort the buckets. After we've
          * collected all of the buckets we'll collect all entries in the queue.
          */
-        abstract ObjectArrayPriorityQueue<B> buildPriorityQueue(int size);
+        abstract ObjectArrayPriorityQueue<BucketAndOrd<B>> buildPriorityQueue(int size);
 
         /**
          * Build the sub-aggregations into the buckets. This will usually
-         * delegate to {@link #buildSubAggsForAllBuckets}.
+         * delegate to {@link #buildSubAggsForAllBuckets(ObjectArray, LongArray, BiConsumer)}.
          */
-        abstract void buildSubAggs(ObjectArray<B[]> topBucketsPerOrd) throws IOException;
+        abstract void buildSubAggs(ObjectArray<B[]> topBucketsPerOrd, LongArray ordsArray) throws IOException;
 
         /**
          * Collect extra entries for "zero" hit documents if they were requested
@@ -287,9 +303,11 @@ interface BucketUpdater<B extends InternalMultiBucketAggregation.InternalBucket>
     abstract class StandardTermsResultStrategy<R extends InternalMappedTerms<R, B>, B extends InternalTerms.Bucket<B>> extends
         ResultStrategy<R, B> {
         protected final boolean showTermDocCountError;
+        private final Comparator<BucketAndOrd<B>> comparator;
 
-        StandardTermsResultStrategy(boolean showTermDocCountError) {
+        StandardTermsResultStrategy(boolean showTermDocCountError, Aggregator aggregator) {
             this.showTermDocCountError = showTermDocCountError;
+            this.comparator = order.partiallyBuiltBucketComparator(aggregator);
         }
 
         @Override
@@ -298,13 +316,13 @@ final LeafBucketCollector wrapCollector(LeafBucketCollector primary) {
         }
 
         @Override
-        final ObjectArrayPriorityQueue<B> buildPriorityQueue(int size) {
-            return new BucketPriorityQueue<>(size, bigArrays(), partiallyBuiltBucketComparator);
+        final ObjectArrayPriorityQueue<BucketAndOrd<B>> buildPriorityQueue(int size) {
+            return new BucketPriorityQueue<>(size, bigArrays(), comparator);
         }
 
         @Override
-        final void buildSubAggs(ObjectArray<B[]> topBucketsPerOrd) throws IOException {
-            buildSubAggsForAllBuckets(topBucketsPerOrd, b -> b.bucketOrd, (b, aggs) -> b.aggregations = aggs);
+        final void buildSubAggs(ObjectArray<B[]> topBucketsPerOrd, LongArray ordsArray) throws IOException {
+            buildSubAggsForAllBuckets(topBucketsPerOrd, ordsArray, (b, aggs) -> b.aggregations = aggs);
         }
 
         @Override
@@ -340,8 +358,8 @@ public final void close() {}
     }
 
     class LongTermsResults extends StandardTermsResultStrategy<LongTerms, LongTerms.Bucket> {
-        LongTermsResults(boolean showTermDocCountError) {
-            super(showTermDocCountError);
+        LongTermsResults(boolean showTermDocCountError, Aggregator aggregator) {
+            super(showTermDocCountError, aggregator);
         }
 
         @Override
@@ -374,7 +392,6 @@ BucketUpdater<LongTerms.Bucket> bucketUpdater(long owningBucketOrd) {
             return (LongTerms.Bucket spare, BucketOrdsEnum ordsEnum, long docCount) -> {
                 spare.term = ordsEnum.value();
                 spare.docCount = docCount;
-                spare.bucketOrd = ordsEnum.ord();
             };
         }
 
@@ -424,8 +441,8 @@ LongTerms buildEmptyResult() {
 
     class DoubleTermsResults extends StandardTermsResultStrategy<DoubleTerms, DoubleTerms.Bucket> {
 
-        DoubleTermsResults(boolean showTermDocCountError) {
-            super(showTermDocCountError);
+        DoubleTermsResults(boolean showTermDocCountError, Aggregator aggregator) {
+            super(showTermDocCountError, aggregator);
         }
 
         @Override
@@ -458,7 +475,6 @@ BucketUpdater<DoubleTerms.Bucket> bucketUpdater(long owningBucketOrd) {
             return (DoubleTerms.Bucket spare, BucketOrdsEnum ordsEnum, long docCount) -> {
                 spare.term = NumericUtils.sortableLongToDouble(ordsEnum.value());
                 spare.docCount = docCount;
-                spare.bucketOrd = ordsEnum.ord();
             };
         }
 
@@ -575,7 +591,6 @@ BucketUpdater<SignificantLongTerms.Bucket> bucketUpdater(long owningBucketOrd) {
                 spare.term = ordsEnum.value();
                 spare.subsetDf = docCount;
                 spare.supersetDf = backgroundFrequencies.freq(spare.term);
-                spare.bucketOrd = ordsEnum.ord();
                 // During shard-local down-selection we use subset/superset stats that are for this shard only
                 // Back at the central reducer these properties will be updated with global stats
                 spare.updateScore(significanceHeuristic, subsetSize, supersetSize);
@@ -583,13 +598,13 @@ BucketUpdater<SignificantLongTerms.Bucket> bucketUpdater(long owningBucketOrd) {
         }
 
         @Override
-        ObjectArrayPriorityQueue<SignificantLongTerms.Bucket> buildPriorityQueue(int size) {
+        ObjectArrayPriorityQueue<BucketAndOrd<SignificantLongTerms.Bucket>> buildPriorityQueue(int size) {
             return new BucketSignificancePriorityQueue<>(size, bigArrays());
         }
 
         @Override
-        void buildSubAggs(ObjectArray<SignificantLongTerms.Bucket[]> topBucketsPerOrd) throws IOException {
-            buildSubAggsForAllBuckets(topBucketsPerOrd, b -> b.bucketOrd, (b, aggs) -> b.aggregations = aggs);
+        void buildSubAggs(ObjectArray<SignificantLongTerms.Bucket[]> topBucketsPerOrd, LongArray ordsArray) throws IOException {
+            buildSubAggsForAllBuckets(topBucketsPerOrd, ordsArray, (b, aggs) -> b.aggregations = aggs);
         }
 
         @Override
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/TermsAggregator.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/TermsAggregator.java
index 4922be7cec1ba..c07c0726a4ae1 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/TermsAggregator.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/TermsAggregator.java
@@ -27,7 +27,6 @@
 import org.elasticsearch.xcontent.XContentBuilder;
 
 import java.io.IOException;
-import java.util.Comparator;
 import java.util.HashSet;
 import java.util.Map;
 import java.util.Objects;
@@ -190,7 +189,6 @@ public boolean equals(Object obj) {
     protected final DocValueFormat format;
     protected final BucketCountThresholds bucketCountThresholds;
     protected final BucketOrder order;
-    protected final Comparator<InternalTerms.Bucket<?>> partiallyBuiltBucketComparator;
     protected final Set<Aggregator> aggsUsedForSorting;
     protected final SubAggCollectionMode collectMode;
 
@@ -209,7 +207,9 @@ public TermsAggregator(
         super(name, factories, context, parent, metadata);
         this.bucketCountThresholds = bucketCountThresholds;
         this.order = order;
-        partiallyBuiltBucketComparator = order == null ? null : order.partiallyBuiltBucketComparator(b -> b.bucketOrd, this);
+        if (order != null) {
+            order.validate(this);
+        }
         this.format = format;
         if ((subAggsNeedScore() && descendsFromNestedAggregator(parent)) || context.isInSortOrderExecutionRequired()) {
             /**
diff --git a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/TermsAggregatorFactory.java b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/TermsAggregatorFactory.java
index 2c7b768fcdbb3..da5ae37b08228 100644
--- a/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/TermsAggregatorFactory.java
+++ b/server/src/main/java/org/elasticsearch/search/aggregations/bucket/terms/TermsAggregatorFactory.java
@@ -195,12 +195,12 @@ private static TermsAggregatorSupplier numericSupplier() {
                 if (includeExclude != null) {
                     longFilter = includeExclude.convertToDoubleFilter();
                 }
-                resultStrategy = agg -> agg.new DoubleTermsResults(showTermDocCountError);
+                resultStrategy = agg -> agg.new DoubleTermsResults(showTermDocCountError, agg);
             } else {
                 if (includeExclude != null) {
                     longFilter = includeExclude.convertToLongFilter(valuesSourceConfig.format());
                 }
-                resultStrategy = agg -> agg.new LongTermsResults(showTermDocCountError);
+                resultStrategy = agg -> agg.new LongTermsResults(showTermDocCountError, agg);
             }
             return new NumericTermsAggregator(
                 name,
@@ -403,7 +403,7 @@ Aggregator create(
                     name,
                     factories,
                     new MapStringTermsAggregator.ValuesSourceCollectorSource(valuesSourceConfig),
-                    a -> a.new StandardTermsResults(valuesSourceConfig.getValuesSource()),
+                    a -> a.new StandardTermsResults(valuesSourceConfig.getValuesSource(), a),
                     order,
                     valuesSourceConfig.format(),
                     bucketCountThresholds,
diff --git a/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/multiterms/InternalMultiTerms.java b/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/multiterms/InternalMultiTerms.java
index 0d42a2856a10e..85510c8a989c0 100644
--- a/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/multiterms/InternalMultiTerms.java
+++ b/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/multiterms/InternalMultiTerms.java
@@ -37,9 +37,6 @@ public class InternalMultiTerms extends AbstractInternalTerms<InternalMultiTerms
     public static final TermsComparator TERMS_COMPARATOR = new TermsComparator();
 
     public static class Bucket extends AbstractInternalTerms.AbstractTermsBucket<Bucket> {
-
-        long bucketOrd;
-
         protected long docCount;
         protected InternalAggregations aggregations;
         private long docCountError;
diff --git a/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/multiterms/MultiTermsAggregator.java b/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/multiterms/MultiTermsAggregator.java
index 1691aedf543f4..5c10e2c8feeb1 100644
--- a/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/multiterms/MultiTermsAggregator.java
+++ b/x-pack/plugin/analytics/src/main/java/org/elasticsearch/xpack/analytics/multiterms/MultiTermsAggregator.java
@@ -20,6 +20,7 @@
 import org.elasticsearch.common.io.stream.BytesStreamOutput;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.util.IntArray;
 import org.elasticsearch.common.util.LongArray;
 import org.elasticsearch.common.util.ObjectArray;
 import org.elasticsearch.common.util.ObjectArrayPriorityQueue;
@@ -40,6 +41,7 @@
 import org.elasticsearch.search.aggregations.LeafBucketCollector;
 import org.elasticsearch.search.aggregations.LeafBucketCollectorBase;
 import org.elasticsearch.search.aggregations.bucket.DeferableBucketAggregator;
+import org.elasticsearch.search.aggregations.bucket.terms.BucketAndOrd;
 import org.elasticsearch.search.aggregations.bucket.terms.BucketPriorityQueue;
 import org.elasticsearch.search.aggregations.bucket.terms.BytesKeyedBucketOrds;
 import org.elasticsearch.search.aggregations.bucket.terms.TermsAggregator;
@@ -72,7 +74,7 @@ class MultiTermsAggregator extends DeferableBucketAggregator {
     protected final List<DocValueFormat> formats;
     protected final TermsAggregator.BucketCountThresholds bucketCountThresholds;
     protected final BucketOrder order;
-    protected final Comparator<InternalMultiTerms.Bucket> partiallyBuiltBucketComparator;
+    protected final Comparator<BucketAndOrd<InternalMultiTerms.Bucket>> partiallyBuiltBucketComparator;
     protected final Set<Aggregator> aggsUsedForSorting;
     protected final SubAggCollectionMode collectMode;
     private final List<TermValuesSource> values;
@@ -99,7 +101,7 @@ protected MultiTermsAggregator(
         super(name, factories, context, parent, metadata);
         this.bucketCountThresholds = bucketCountThresholds;
         this.order = order;
-        partiallyBuiltBucketComparator = order == null ? null : order.partiallyBuiltBucketComparator(b -> b.bucketOrd, this);
+        partiallyBuiltBucketComparator = order == null ? null : order.partiallyBuiltBucketComparator(this);
         this.formats = formats;
         this.showTermDocCountError = showTermDocCountError;
         if (subAggsNeedScore() && descendsFromNestedAggregator(parent) || context.isInSortOrderExecutionRequired()) {
@@ -242,52 +244,67 @@ public InternalAggregation[] buildAggregations(LongArray owningBucketOrds) throw
             LongArray otherDocCounts = bigArrays().newLongArray(owningBucketOrds.size(), true);
             ObjectArray<InternalMultiTerms.Bucket[]> topBucketsPerOrd = bigArrays().newObjectArray(owningBucketOrds.size())
         ) {
-            for (long ordIdx = 0; ordIdx < owningBucketOrds.size(); ordIdx++) {
-                final long owningBucketOrd = owningBucketOrds.get(ordIdx);
-                long bucketsInOrd = bucketOrds.bucketsInOrd(owningBucketOrd);
-
-                int size = (int) Math.min(bucketsInOrd, bucketCountThresholds.getShardSize());
-                try (
-                    ObjectArrayPriorityQueue<InternalMultiTerms.Bucket> ordered = new BucketPriorityQueue<>(
-                        size,
-                        bigArrays(),
-                        partiallyBuiltBucketComparator
-                    )
-                ) {
-                    InternalMultiTerms.Bucket spare = null;
-                    BytesRef spareKey = null;
-                    BytesKeyedBucketOrds.BucketOrdsEnum ordsEnum = bucketOrds.ordsEnum(owningBucketOrd);
-                    while (ordsEnum.next()) {
-                        long docCount = bucketDocCount(ordsEnum.ord());
-                        otherDocCounts.increment(ordIdx, docCount);
-                        if (docCount < bucketCountThresholds.getShardMinDocCount()) {
-                            continue;
-                        }
-                        if (spare == null) {
-                            checkRealMemoryCBForInternalBucket();
-                            spare = new InternalMultiTerms.Bucket(null, 0, null, showTermDocCountError, 0, formats, keyConverters);
-                            spareKey = new BytesRef();
-                        }
-                        ordsEnum.readValue(spareKey);
-                        spare.terms = unpackTerms(spareKey);
-                        spare.docCount = docCount;
-                        spare.bucketOrd = ordsEnum.ord();
-                        spare = ordered.insertWithOverflow(spare);
-                    }
+            try (IntArray bucketsToCollect = bigArrays().newIntArray(owningBucketOrds.size())) {
+                long ordsToCollect = 0;
+                for (long ordIdx = 0; ordIdx < owningBucketOrds.size(); ordIdx++) {
+                    int size = (int) Math.min(bucketOrds.bucketsInOrd(owningBucketOrds.get(ordIdx)), bucketCountThresholds.getShardSize());
+                    ordsToCollect += size;
+                    bucketsToCollect.set(ordIdx, size);
+                }
+                try (LongArray ordsArray = bigArrays().newLongArray(ordsToCollect)) {
+                    long ordsCollected = 0;
+                    for (long ordIdx = 0; ordIdx < owningBucketOrds.size(); ordIdx++) {
+                        final long owningBucketOrd = owningBucketOrds.get(ordIdx);
+                        long bucketsInOrd = bucketOrds.bucketsInOrd(owningBucketOrd);
+
+                        int size = (int) Math.min(bucketsInOrd, bucketCountThresholds.getShardSize());
+                        try (
+                            ObjectArrayPriorityQueue<BucketAndOrd<InternalMultiTerms.Bucket>> ordered = new BucketPriorityQueue<>(
+                                size,
+                                bigArrays(),
+                                partiallyBuiltBucketComparator
+                            )
+                        ) {
+                            BucketAndOrd<InternalMultiTerms.Bucket> spare = null;
+                            BytesRef spareKey = null;
+                            BytesKeyedBucketOrds.BucketOrdsEnum ordsEnum = bucketOrds.ordsEnum(owningBucketOrd);
+                            while (ordsEnum.next()) {
+                                long docCount = bucketDocCount(ordsEnum.ord());
+                                otherDocCounts.increment(ordIdx, docCount);
+                                if (docCount < bucketCountThresholds.getShardMinDocCount()) {
+                                    continue;
+                                }
+                                if (spare == null) {
+                                    checkRealMemoryCBForInternalBucket();
+                                    spare = new BucketAndOrd<>(
+                                        new InternalMultiTerms.Bucket(null, 0, null, showTermDocCountError, 0, formats, keyConverters)
+                                    );
+                                    spareKey = new BytesRef();
+                                }
+                                ordsEnum.readValue(spareKey);
+                                spare.bucket.terms = unpackTerms(spareKey);
+                                spare.bucket.docCount = docCount;
+                                spare.ord = ordsEnum.ord();
+                                spare = ordered.insertWithOverflow(spare);
+                            }
 
-                    // Get the top buckets
-                    InternalMultiTerms.Bucket[] bucketsForOrd = new InternalMultiTerms.Bucket[(int) ordered.size()];
-                    topBucketsPerOrd.set(ordIdx, bucketsForOrd);
-                    for (int b = (int) ordered.size() - 1; b >= 0; --b) {
-                        InternalMultiTerms.Bucket[] buckets = topBucketsPerOrd.get(ordIdx);
-                        buckets[b] = ordered.pop();
-                        otherDocCounts.increment(ordIdx, -buckets[b].getDocCount());
+                            // Get the top buckets
+                            int orderedSize = (int) ordered.size();
+                            InternalMultiTerms.Bucket[] buckets = new InternalMultiTerms.Bucket[orderedSize];
+                            for (int i = orderedSize - 1; i >= 0; --i) {
+                                BucketAndOrd<InternalMultiTerms.Bucket> bucketAndOrd = ordered.pop();
+                                buckets[i] = bucketAndOrd.bucket;
+                                ordsArray.set(ordsCollected + i, bucketAndOrd.ord);
+                                otherDocCounts.increment(ordIdx, -buckets[i].getDocCount());
+                            }
+                            topBucketsPerOrd.set(ordIdx, buckets);
+                            ordsCollected += orderedSize;
+                        }
                     }
+                    buildSubAggsForAllBuckets(topBucketsPerOrd, ordsArray, (b, a) -> b.aggregations = a);
                 }
             }
 
-            buildSubAggsForAllBuckets(topBucketsPerOrd, b -> b.bucketOrd, (b, a) -> b.aggregations = a);
-
             return buildAggregations(
                 Math.toIntExact(owningBucketOrds.size()),
                 ordIdx -> buildResult(otherDocCounts.get(ordIdx), topBucketsPerOrd.get(ordIdx))

From 1fecab19254715941f42bdebe025298e89d5574b Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Thu, 5 Dec 2024 16:25:32 +0100
Subject: [PATCH 049/119] Update synthetic source cutoff date (#118069)

Updating from 01-02-2025T00:00:00UTC to 04-02-2025T00:00:00UTC
---
 .../xpack/logsdb/SyntheticSourceLicenseService.java            | 2 +-
 .../xpack/logsdb/LegacyLicenceIntegrationTests.java            | 3 ++-
 ...SyntheticSourceIndexSettingsProviderLegacyLicenseTests.java | 2 +-
 3 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/x-pack/plugin/logsdb/src/main/java/org/elasticsearch/xpack/logsdb/SyntheticSourceLicenseService.java b/x-pack/plugin/logsdb/src/main/java/org/elasticsearch/xpack/logsdb/SyntheticSourceLicenseService.java
index 26a672fb1c903..e629f9b3998bb 100644
--- a/x-pack/plugin/logsdb/src/main/java/org/elasticsearch/xpack/logsdb/SyntheticSourceLicenseService.java
+++ b/x-pack/plugin/logsdb/src/main/java/org/elasticsearch/xpack/logsdb/SyntheticSourceLicenseService.java
@@ -29,7 +29,7 @@ final class SyntheticSourceLicenseService {
     // You can only override this property if you received explicit approval from Elastic.
     static final String CUTOFF_DATE_SYS_PROP_NAME = "es.mapping.synthetic_source_fallback_to_stored_source.cutoff_date_restricted_override";
     private static final Logger LOGGER = LogManager.getLogger(SyntheticSourceLicenseService.class);
-    static final long DEFAULT_CUTOFF_DATE = LocalDateTime.of(2025, 2, 1, 0, 0).toInstant(ZoneOffset.UTC).toEpochMilli();
+    static final long DEFAULT_CUTOFF_DATE = LocalDateTime.of(2025, 2, 4, 0, 0).toInstant(ZoneOffset.UTC).toEpochMilli();
 
     /**
      * A setting that determines whether source mode should always be stored source. Regardless of licence.
diff --git a/x-pack/plugin/logsdb/src/test/java/org/elasticsearch/xpack/logsdb/LegacyLicenceIntegrationTests.java b/x-pack/plugin/logsdb/src/test/java/org/elasticsearch/xpack/logsdb/LegacyLicenceIntegrationTests.java
index 890bc464a2579..f8f307b572f33 100644
--- a/x-pack/plugin/logsdb/src/test/java/org/elasticsearch/xpack/logsdb/LegacyLicenceIntegrationTests.java
+++ b/x-pack/plugin/logsdb/src/test/java/org/elasticsearch/xpack/logsdb/LegacyLicenceIntegrationTests.java
@@ -69,7 +69,8 @@ public void testSyntheticSourceUsageWithLegacyLicense() {
     }
 
     public void testSyntheticSourceUsageWithLegacyLicensePastCutoff() throws Exception {
-        long startPastCutoff = LocalDateTime.of(2025, 11, 12, 0, 0).toInstant(ZoneOffset.UTC).toEpochMilli();
+        // One day after default cutoff date
+        long startPastCutoff = LocalDateTime.of(2025, 2, 5, 0, 0).toInstant(ZoneOffset.UTC).toEpochMilli();
         putLicense(createGoldOrPlatinumLicense(startPastCutoff));
         ensureGreen();
 
diff --git a/x-pack/plugin/logsdb/src/test/java/org/elasticsearch/xpack/logsdb/SyntheticSourceIndexSettingsProviderLegacyLicenseTests.java b/x-pack/plugin/logsdb/src/test/java/org/elasticsearch/xpack/logsdb/SyntheticSourceIndexSettingsProviderLegacyLicenseTests.java
index eda0d87868745..c871a7d0216ed 100644
--- a/x-pack/plugin/logsdb/src/test/java/org/elasticsearch/xpack/logsdb/SyntheticSourceIndexSettingsProviderLegacyLicenseTests.java
+++ b/x-pack/plugin/logsdb/src/test/java/org/elasticsearch/xpack/logsdb/SyntheticSourceIndexSettingsProviderLegacyLicenseTests.java
@@ -98,7 +98,7 @@ public void testGetAdditionalIndexSettingsTsdb() throws IOException {
     }
 
     public void testGetAdditionalIndexSettingsTsdbAfterCutoffDate() throws Exception {
-        long start = LocalDateTime.of(2025, 2, 2, 0, 0).toInstant(ZoneOffset.UTC).toEpochMilli();
+        long start = LocalDateTime.of(2025, 2, 5, 0, 0).toInstant(ZoneOffset.UTC).toEpochMilli();
         License license = createGoldOrPlatinumLicense(start);
         long time = LocalDateTime.of(2024, 12, 31, 0, 0).toInstant(ZoneOffset.UTC).toEpochMilli();
         var licenseState = new XPackLicenseState(() -> time, new XPackLicenseStatus(license.operationMode(), true, null));

From 9d350537608e89624b660ff40f8b96275d8ba9d9 Mon Sep 17 00:00:00 2001
From: kosabogi <105062005+kosabogi@users.noreply.github.com>
Date: Thu, 5 Dec 2024 16:32:59 +0100
Subject: [PATCH 050/119] Adds warning to Create inference API page (#118073)

---
 docs/reference/inference/put-inference.asciidoc | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/reference/inference/put-inference.asciidoc b/docs/reference/inference/put-inference.asciidoc
index ed93c290b6ad4..4f82889f562d8 100644
--- a/docs/reference/inference/put-inference.asciidoc
+++ b/docs/reference/inference/put-inference.asciidoc
@@ -10,7 +10,6 @@ Creates an {infer} endpoint to perform an {infer} task.
 * For built-in models and models uploaded through Eland, the {infer} APIs offer an alternative way to use and manage trained models. However, if you do not plan to use the {infer} APIs to use these models or if you want to use non-NLP models, use the <<ml-df-trained-models-apis>>.
 ====
 
-
 [discrete]
 [[put-inference-api-request]]
 ==== {api-request-title}
@@ -47,6 +46,14 @@ Refer to the service list in the <<put-inference-api-desc,API description sectio
 
 The create {infer} API enables you to create an {infer} endpoint and configure a {ml} model to perform a specific {infer} task.
 
+[IMPORTANT]
+====
+* When creating an inference endpoint, the associated machine learning model is automatically deployed if it is not already running.
+* After creating the endpoint, wait for the model deployment to complete before using it. You can verify the deployment status by using the <<get-trained-models-stats, Get trained model statistics>> API. In the response, look for `"state": "fully_allocated"` and ensure the `"allocation_count"` matches the `"target_allocation_count"`.
+* Avoid creating multiple endpoints for the same model unless required, as each endpoint consumes significant resources.
+====
+
+
 The following services are available through the {infer} API.
 You can find the available task types next to the service name. 
 Click the links to review the configuration details of the services:

From 5d1bca34f9dbfd3904c624a0f48a474e557577e5 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Thu, 5 Dec 2024 17:22:03 +0100
Subject: [PATCH 051/119] Make NestedHelper a utility class (#118071)

Noticed instantiating these instances taking a visible and unexpected
amount of CPU in profiles (probably from bootstrapping the lambda/callsite for the
predicate). This fixes the logic to effectively disappear from profiling
and makes it easier to reason about as well by removing the indirect use
of the search context and just explicitly passing it around.
No need to instantiate instances of this thing either, escape analysis
probably isn't able to remove it because of the recursive instance
method calls.
---
 .../index/query/NestedQueryBuilder.java       |   3 +-
 .../index/search/NestedHelper.java            |  59 ++--
 .../search/DefaultSearchContext.java          |   5 +-
 .../search/vectors/KnnVectorQueryBuilder.java |   3 +-
 .../index/search/NestedHelperTests.java       | 274 ++++++++++--------
 .../authz/permission/DocumentPermissions.java |   6 +-
 .../planner/EsPhysicalOperationProviders.java |  14 +-
 7 files changed, 185 insertions(+), 179 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/index/query/NestedQueryBuilder.java b/server/src/main/java/org/elasticsearch/index/query/NestedQueryBuilder.java
index 83bca7d27aeeb..503b2adf756f5 100644
--- a/server/src/main/java/org/elasticsearch/index/query/NestedQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/index/query/NestedQueryBuilder.java
@@ -321,8 +321,7 @@ public static <E extends Exception> Query toQuery(
 
         // ToParentBlockJoinQuery requires that the inner query only matches documents
         // in its child space
-        NestedHelper nestedHelper = new NestedHelper(context.nestedLookup(), context::isFieldMapped);
-        if (nestedHelper.mightMatchNonNestedDocs(innerQuery, path)) {
+        if (NestedHelper.mightMatchNonNestedDocs(innerQuery, path, context)) {
             innerQuery = Queries.filtered(innerQuery, mapper.nestedTypeFilter());
         }
 
diff --git a/server/src/main/java/org/elasticsearch/index/search/NestedHelper.java b/server/src/main/java/org/elasticsearch/index/search/NestedHelper.java
index 96e8ac35c8e32..a04f930e052b9 100644
--- a/server/src/main/java/org/elasticsearch/index/search/NestedHelper.java
+++ b/server/src/main/java/org/elasticsearch/index/search/NestedHelper.java
@@ -21,29 +21,21 @@
 import org.apache.lucene.search.Query;
 import org.apache.lucene.search.TermInSetQuery;
 import org.apache.lucene.search.TermQuery;
-import org.elasticsearch.index.mapper.NestedLookup;
 import org.elasticsearch.index.mapper.NestedObjectMapper;
-
-import java.util.function.Predicate;
+import org.elasticsearch.index.query.SearchExecutionContext;
 
 /** Utility class to filter parent and children clauses when building nested
  * queries. */
 public final class NestedHelper {
 
-    private final NestedLookup nestedLookup;
-    private final Predicate<String> isMappedFieldPredicate;
-
-    public NestedHelper(NestedLookup nestedLookup, Predicate<String> isMappedFieldPredicate) {
-        this.nestedLookup = nestedLookup;
-        this.isMappedFieldPredicate = isMappedFieldPredicate;
-    }
+    private NestedHelper() {}
 
     /** Returns true if the given query might match nested documents. */
-    public boolean mightMatchNestedDocs(Query query) {
+    public static boolean mightMatchNestedDocs(Query query, SearchExecutionContext searchExecutionContext) {
         if (query instanceof ConstantScoreQuery) {
-            return mightMatchNestedDocs(((ConstantScoreQuery) query).getQuery());
+            return mightMatchNestedDocs(((ConstantScoreQuery) query).getQuery(), searchExecutionContext);
         } else if (query instanceof BoostQuery) {
-            return mightMatchNestedDocs(((BoostQuery) query).getQuery());
+            return mightMatchNestedDocs(((BoostQuery) query).getQuery(), searchExecutionContext);
         } else if (query instanceof MatchAllDocsQuery) {
             return true;
         } else if (query instanceof MatchNoDocsQuery) {
@@ -51,17 +43,17 @@ public boolean mightMatchNestedDocs(Query query) {
         } else if (query instanceof TermQuery) {
             // We only handle term(s) queries and range queries, which should already
             // cover a high majority of use-cases
-            return mightMatchNestedDocs(((TermQuery) query).getTerm().field());
+            return mightMatchNestedDocs(((TermQuery) query).getTerm().field(), searchExecutionContext);
         } else if (query instanceof TermInSetQuery tis) {
             if (tis.getTermsCount() > 0) {
-                return mightMatchNestedDocs(tis.getField());
+                return mightMatchNestedDocs(tis.getField(), searchExecutionContext);
             } else {
                 return false;
             }
         } else if (query instanceof PointRangeQuery) {
-            return mightMatchNestedDocs(((PointRangeQuery) query).getField());
+            return mightMatchNestedDocs(((PointRangeQuery) query).getField(), searchExecutionContext);
         } else if (query instanceof IndexOrDocValuesQuery) {
-            return mightMatchNestedDocs(((IndexOrDocValuesQuery) query).getIndexQuery());
+            return mightMatchNestedDocs(((IndexOrDocValuesQuery) query).getIndexQuery(), searchExecutionContext);
         } else if (query instanceof final BooleanQuery bq) {
             final boolean hasRequiredClauses = bq.clauses().stream().anyMatch(BooleanClause::isRequired);
             if (hasRequiredClauses) {
@@ -69,13 +61,13 @@ public boolean mightMatchNestedDocs(Query query) {
                     .stream()
                     .filter(BooleanClause::isRequired)
                     .map(BooleanClause::query)
-                    .allMatch(this::mightMatchNestedDocs);
+                    .allMatch(f -> mightMatchNestedDocs(f, searchExecutionContext));
             } else {
                 return bq.clauses()
                     .stream()
                     .filter(c -> c.occur() == Occur.SHOULD)
                     .map(BooleanClause::query)
-                    .anyMatch(this::mightMatchNestedDocs);
+                    .anyMatch(f -> mightMatchNestedDocs(f, searchExecutionContext));
             }
         } else if (query instanceof ESToParentBlockJoinQuery) {
             return ((ESToParentBlockJoinQuery) query).getPath() != null;
@@ -85,7 +77,7 @@ public boolean mightMatchNestedDocs(Query query) {
     }
 
     /** Returns true if a query on the given field might match nested documents. */
-    boolean mightMatchNestedDocs(String field) {
+    private static boolean mightMatchNestedDocs(String field, SearchExecutionContext searchExecutionContext) {
         if (field.startsWith("_")) {
             // meta field. Every meta field behaves differently, eg. nested
             // documents have the same _uid as their parent, put their path in
@@ -94,36 +86,36 @@ boolean mightMatchNestedDocs(String field) {
             // we might add a nested filter when it is nor required.
             return true;
         }
-        if (isMappedFieldPredicate.test(field) == false) {
+        if (searchExecutionContext.isFieldMapped(field) == false) {
             // field does not exist
             return false;
         }
-        return nestedLookup.getNestedParent(field) != null;
+        return searchExecutionContext.nestedLookup().getNestedParent(field) != null;
     }
 
     /** Returns true if the given query might match parent documents or documents
      *  that are nested under a different path. */
-    public boolean mightMatchNonNestedDocs(Query query, String nestedPath) {
+    public static boolean mightMatchNonNestedDocs(Query query, String nestedPath, SearchExecutionContext searchExecutionContext) {
         if (query instanceof ConstantScoreQuery) {
-            return mightMatchNonNestedDocs(((ConstantScoreQuery) query).getQuery(), nestedPath);
+            return mightMatchNonNestedDocs(((ConstantScoreQuery) query).getQuery(), nestedPath, searchExecutionContext);
         } else if (query instanceof BoostQuery) {
-            return mightMatchNonNestedDocs(((BoostQuery) query).getQuery(), nestedPath);
+            return mightMatchNonNestedDocs(((BoostQuery) query).getQuery(), nestedPath, searchExecutionContext);
         } else if (query instanceof MatchAllDocsQuery) {
             return true;
         } else if (query instanceof MatchNoDocsQuery) {
             return false;
         } else if (query instanceof TermQuery) {
-            return mightMatchNonNestedDocs(((TermQuery) query).getTerm().field(), nestedPath);
+            return mightMatchNonNestedDocs(searchExecutionContext, ((TermQuery) query).getTerm().field(), nestedPath);
         } else if (query instanceof TermInSetQuery tis) {
             if (tis.getTermsCount() > 0) {
-                return mightMatchNonNestedDocs(tis.getField(), nestedPath);
+                return mightMatchNonNestedDocs(searchExecutionContext, tis.getField(), nestedPath);
             } else {
                 return false;
             }
         } else if (query instanceof PointRangeQuery) {
-            return mightMatchNonNestedDocs(((PointRangeQuery) query).getField(), nestedPath);
+            return mightMatchNonNestedDocs(searchExecutionContext, ((PointRangeQuery) query).getField(), nestedPath);
         } else if (query instanceof IndexOrDocValuesQuery) {
-            return mightMatchNonNestedDocs(((IndexOrDocValuesQuery) query).getIndexQuery(), nestedPath);
+            return mightMatchNonNestedDocs(((IndexOrDocValuesQuery) query).getIndexQuery(), nestedPath, searchExecutionContext);
         } else if (query instanceof final BooleanQuery bq) {
             final boolean hasRequiredClauses = bq.clauses().stream().anyMatch(BooleanClause::isRequired);
             if (hasRequiredClauses) {
@@ -131,13 +123,13 @@ public boolean mightMatchNonNestedDocs(Query query, String nestedPath) {
                     .stream()
                     .filter(BooleanClause::isRequired)
                     .map(BooleanClause::query)
-                    .allMatch(q -> mightMatchNonNestedDocs(q, nestedPath));
+                    .allMatch(q -> mightMatchNonNestedDocs(q, nestedPath, searchExecutionContext));
             } else {
                 return bq.clauses()
                     .stream()
                     .filter(c -> c.occur() == Occur.SHOULD)
                     .map(BooleanClause::query)
-                    .anyMatch(q -> mightMatchNonNestedDocs(q, nestedPath));
+                    .anyMatch(q -> mightMatchNonNestedDocs(q, nestedPath, searchExecutionContext));
             }
         } else {
             return true;
@@ -146,7 +138,7 @@ public boolean mightMatchNonNestedDocs(Query query, String nestedPath) {
 
     /** Returns true if a query on the given field might match parent documents
      *  or documents that are nested under a different path. */
-    boolean mightMatchNonNestedDocs(String field, String nestedPath) {
+    private static boolean mightMatchNonNestedDocs(SearchExecutionContext searchExecutionContext, String field, String nestedPath) {
         if (field.startsWith("_")) {
             // meta field. Every meta field behaves differently, eg. nested
             // documents have the same _uid as their parent, put their path in
@@ -155,9 +147,10 @@ boolean mightMatchNonNestedDocs(String field, String nestedPath) {
             // we might add a nested filter when it is nor required.
             return true;
         }
-        if (isMappedFieldPredicate.test(field) == false) {
+        if (searchExecutionContext.isFieldMapped(field) == false) {
             return false;
         }
+        var nestedLookup = searchExecutionContext.nestedLookup();
         String nestedParent = nestedLookup.getNestedParent(field);
         if (nestedParent == null || nestedParent.startsWith(nestedPath) == false) {
             // the field is not a sub field of the nested path
diff --git a/server/src/main/java/org/elasticsearch/search/DefaultSearchContext.java b/server/src/main/java/org/elasticsearch/search/DefaultSearchContext.java
index 8ac35f7c40caa..b87d097413b67 100644
--- a/server/src/main/java/org/elasticsearch/search/DefaultSearchContext.java
+++ b/server/src/main/java/org/elasticsearch/search/DefaultSearchContext.java
@@ -444,10 +444,9 @@ public void preProcess() {
     public Query buildFilteredQuery(Query query) {
         List<Query> filters = new ArrayList<>();
         NestedLookup nestedLookup = searchExecutionContext.nestedLookup();
-        NestedHelper nestedHelper = new NestedHelper(nestedLookup, searchExecutionContext::isFieldMapped);
         if (nestedLookup != NestedLookup.EMPTY
-            && nestedHelper.mightMatchNestedDocs(query)
-            && (aliasFilter == null || nestedHelper.mightMatchNestedDocs(aliasFilter))) {
+            && NestedHelper.mightMatchNestedDocs(query, searchExecutionContext)
+            && (aliasFilter == null || NestedHelper.mightMatchNestedDocs(aliasFilter, searchExecutionContext))) {
             filters.add(Queries.newNonNestedFilter(searchExecutionContext.indexVersionCreated()));
         }
 
diff --git a/server/src/main/java/org/elasticsearch/search/vectors/KnnVectorQueryBuilder.java b/server/src/main/java/org/elasticsearch/search/vectors/KnnVectorQueryBuilder.java
index deb7e6bd035b8..5dd2cbf32dd12 100644
--- a/server/src/main/java/org/elasticsearch/search/vectors/KnnVectorQueryBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/vectors/KnnVectorQueryBuilder.java
@@ -481,10 +481,9 @@ protected Query doToQuery(SearchExecutionContext context) throws IOException {
             }
             parentBitSet = context.bitsetFilter(parentFilter);
             if (filterQuery != null) {
-                NestedHelper nestedHelper = new NestedHelper(context.nestedLookup(), context::isFieldMapped);
                 // We treat the provided filter as a filter over PARENT documents, so if it might match nested documents
                 // we need to adjust it.
-                if (nestedHelper.mightMatchNestedDocs(filterQuery)) {
+                if (NestedHelper.mightMatchNestedDocs(filterQuery, context)) {
                     // Ensure that the query only returns parent documents matching `filterQuery`
                     filterQuery = Queries.filtered(filterQuery, parentFilter);
                 }
diff --git a/server/src/test/java/org/elasticsearch/index/search/NestedHelperTests.java b/server/src/test/java/org/elasticsearch/index/search/NestedHelperTests.java
index a7a1d33badf25..b2583eb176deb 100644
--- a/server/src/test/java/org/elasticsearch/index/search/NestedHelperTests.java
+++ b/server/src/test/java/org/elasticsearch/index/search/NestedHelperTests.java
@@ -17,6 +17,7 @@
 import org.apache.lucene.search.Query;
 import org.apache.lucene.search.TermQuery;
 import org.apache.lucene.search.join.ScoreMode;
+import org.elasticsearch.index.mapper.MapperMetrics;
 import org.elasticsearch.index.mapper.MapperService;
 import org.elasticsearch.index.mapper.MapperServiceTestCase;
 import org.elasticsearch.index.query.MatchAllQueryBuilder;
@@ -27,12 +28,15 @@
 import java.io.IOException;
 import java.util.Collections;
 
+import static java.util.Collections.emptyMap;
 import static org.mockito.Mockito.mock;
 
 public class NestedHelperTests extends MapperServiceTestCase {
 
     MapperService mapperService;
 
+    SearchExecutionContext searchExecutionContext;
+
     @Override
     public void setUp() throws Exception {
         super.setUp();
@@ -68,167 +72,185 @@ public void setUp() throws Exception {
             } }
             """;
         mapperService = createMapperService(mapping);
-    }
-
-    private static NestedHelper buildNestedHelper(MapperService mapperService) {
-        return new NestedHelper(mapperService.mappingLookup().nestedLookup(), field -> mapperService.fieldType(field) != null);
+        searchExecutionContext = new SearchExecutionContext(
+            0,
+            0,
+            mapperService.getIndexSettings(),
+            null,
+            null,
+            mapperService,
+            mapperService.mappingLookup(),
+            null,
+            null,
+            parserConfig(),
+            writableRegistry(),
+            null,
+            null,
+            System::currentTimeMillis,
+            null,
+            null,
+            () -> true,
+            null,
+            emptyMap(),
+            MapperMetrics.NOOP
+        );
     }
 
     public void testMatchAll() {
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(new MatchAllDocsQuery()));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(new MatchAllDocsQuery(), "nested1"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(new MatchAllDocsQuery(), "nested2"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(new MatchAllDocsQuery(), "nested3"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(new MatchAllDocsQuery(), "nested_missing"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(new MatchAllDocsQuery(), searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(new MatchAllDocsQuery(), "nested1", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(new MatchAllDocsQuery(), "nested2", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(new MatchAllDocsQuery(), "nested3", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(new MatchAllDocsQuery(), "nested_missing", searchExecutionContext));
     }
 
     public void testMatchNo() {
-        assertFalse(buildNestedHelper(mapperService).mightMatchNestedDocs(new MatchNoDocsQuery()));
-        assertFalse(buildNestedHelper(mapperService).mightMatchNonNestedDocs(new MatchNoDocsQuery(), "nested1"));
-        assertFalse(buildNestedHelper(mapperService).mightMatchNonNestedDocs(new MatchNoDocsQuery(), "nested2"));
-        assertFalse(buildNestedHelper(mapperService).mightMatchNonNestedDocs(new MatchNoDocsQuery(), "nested3"));
-        assertFalse(buildNestedHelper(mapperService).mightMatchNonNestedDocs(new MatchNoDocsQuery(), "nested_missing"));
+        assertFalse(NestedHelper.mightMatchNestedDocs(new MatchNoDocsQuery(), searchExecutionContext));
+        assertFalse(NestedHelper.mightMatchNonNestedDocs(new MatchNoDocsQuery(), "nested1", searchExecutionContext));
+        assertFalse(NestedHelper.mightMatchNonNestedDocs(new MatchNoDocsQuery(), "nested2", searchExecutionContext));
+        assertFalse(NestedHelper.mightMatchNonNestedDocs(new MatchNoDocsQuery(), "nested3", searchExecutionContext));
+        assertFalse(NestedHelper.mightMatchNonNestedDocs(new MatchNoDocsQuery(), "nested_missing", searchExecutionContext));
     }
 
     public void testTermsQuery() {
         Query termsQuery = mapperService.fieldType("foo").termsQuery(Collections.singletonList("bar"), null);
-        assertFalse(buildNestedHelper(mapperService).mightMatchNestedDocs(termsQuery));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termsQuery, "nested1"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termsQuery, "nested2"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termsQuery, "nested3"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termsQuery, "nested_missing"));
+        assertFalse(NestedHelper.mightMatchNestedDocs(termsQuery, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termsQuery, "nested1", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termsQuery, "nested2", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termsQuery, "nested3", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termsQuery, "nested_missing", searchExecutionContext));
 
         termsQuery = mapperService.fieldType("nested1.foo").termsQuery(Collections.singletonList("bar"), null);
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(termsQuery));
-        assertFalse(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termsQuery, "nested1"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termsQuery, "nested2"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termsQuery, "nested3"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termsQuery, "nested_missing"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(termsQuery, searchExecutionContext));
+        assertFalse(NestedHelper.mightMatchNonNestedDocs(termsQuery, "nested1", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termsQuery, "nested2", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termsQuery, "nested3", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termsQuery, "nested_missing", searchExecutionContext));
 
         termsQuery = mapperService.fieldType("nested2.foo").termsQuery(Collections.singletonList("bar"), null);
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(termsQuery));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termsQuery, "nested1"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termsQuery, "nested2"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termsQuery, "nested3"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termsQuery, "nested_missing"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(termsQuery, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termsQuery, "nested1", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termsQuery, "nested2", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termsQuery, "nested3", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termsQuery, "nested_missing", searchExecutionContext));
 
         termsQuery = mapperService.fieldType("nested3.foo").termsQuery(Collections.singletonList("bar"), null);
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(termsQuery));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termsQuery, "nested1"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termsQuery, "nested2"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termsQuery, "nested3"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termsQuery, "nested_missing"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(termsQuery, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termsQuery, "nested1", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termsQuery, "nested2", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termsQuery, "nested3", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termsQuery, "nested_missing", searchExecutionContext));
     }
 
     public void testTermQuery() {
         Query termQuery = mapperService.fieldType("foo").termQuery("bar", null);
-        assertFalse(buildNestedHelper(mapperService).mightMatchNestedDocs(termQuery));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termQuery, "nested1"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termQuery, "nested2"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termQuery, "nested3"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termQuery, "nested_missing"));
+        assertFalse(NestedHelper.mightMatchNestedDocs(termQuery, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termQuery, "nested1", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termQuery, "nested2", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termQuery, "nested3", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termQuery, "nested_missing", searchExecutionContext));
 
         termQuery = mapperService.fieldType("nested1.foo").termQuery("bar", null);
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(termQuery));
-        assertFalse(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termQuery, "nested1"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termQuery, "nested2"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termQuery, "nested3"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termQuery, "nested_missing"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(termQuery, searchExecutionContext));
+        assertFalse(NestedHelper.mightMatchNonNestedDocs(termQuery, "nested1", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termQuery, "nested2", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termQuery, "nested3", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termQuery, "nested_missing", searchExecutionContext));
 
         termQuery = mapperService.fieldType("nested2.foo").termQuery("bar", null);
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(termQuery));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termQuery, "nested1"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termQuery, "nested2"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termQuery, "nested3"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termQuery, "nested_missing"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(termQuery, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termQuery, "nested1", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termQuery, "nested2", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termQuery, "nested3", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termQuery, "nested_missing", searchExecutionContext));
 
         termQuery = mapperService.fieldType("nested3.foo").termQuery("bar", null);
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(termQuery));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termQuery, "nested1"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termQuery, "nested2"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termQuery, "nested3"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(termQuery, "nested_missing"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(termQuery, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termQuery, "nested1", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termQuery, "nested2", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termQuery, "nested3", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(termQuery, "nested_missing", searchExecutionContext));
     }
 
     public void testRangeQuery() {
         SearchExecutionContext context = mock(SearchExecutionContext.class);
         Query rangeQuery = mapperService.fieldType("foo2").rangeQuery(2, 5, true, true, null, null, null, context);
-        assertFalse(buildNestedHelper(mapperService).mightMatchNestedDocs(rangeQuery));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(rangeQuery, "nested1"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(rangeQuery, "nested2"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(rangeQuery, "nested3"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(rangeQuery, "nested_missing"));
+        assertFalse(NestedHelper.mightMatchNestedDocs(rangeQuery, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(rangeQuery, "nested1", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(rangeQuery, "nested2", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(rangeQuery, "nested3", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(rangeQuery, "nested_missing", searchExecutionContext));
 
         rangeQuery = mapperService.fieldType("nested1.foo2").rangeQuery(2, 5, true, true, null, null, null, context);
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(rangeQuery));
-        assertFalse(buildNestedHelper(mapperService).mightMatchNonNestedDocs(rangeQuery, "nested1"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(rangeQuery, "nested2"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(rangeQuery, "nested3"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(rangeQuery, "nested_missing"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(rangeQuery, searchExecutionContext));
+        assertFalse(NestedHelper.mightMatchNonNestedDocs(rangeQuery, "nested1", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(rangeQuery, "nested2", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(rangeQuery, "nested3", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(rangeQuery, "nested_missing", searchExecutionContext));
 
         rangeQuery = mapperService.fieldType("nested2.foo2").rangeQuery(2, 5, true, true, null, null, null, context);
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(rangeQuery));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(rangeQuery, "nested1"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(rangeQuery, "nested2"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(rangeQuery, "nested3"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(rangeQuery, "nested_missing"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(rangeQuery, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(rangeQuery, "nested1", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(rangeQuery, "nested2", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(rangeQuery, "nested3", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(rangeQuery, "nested_missing", searchExecutionContext));
 
         rangeQuery = mapperService.fieldType("nested3.foo2").rangeQuery(2, 5, true, true, null, null, null, context);
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(rangeQuery));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(rangeQuery, "nested1"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(rangeQuery, "nested2"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(rangeQuery, "nested3"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(rangeQuery, "nested_missing"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(rangeQuery, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(rangeQuery, "nested1", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(rangeQuery, "nested2", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(rangeQuery, "nested3", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(rangeQuery, "nested_missing", searchExecutionContext));
     }
 
     public void testDisjunction() {
         BooleanQuery bq = new BooleanQuery.Builder().add(new TermQuery(new Term("foo", "bar")), Occur.SHOULD)
             .add(new TermQuery(new Term("foo", "baz")), Occur.SHOULD)
             .build();
-        assertFalse(buildNestedHelper(mapperService).mightMatchNestedDocs(bq));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(bq, "nested1"));
+        assertFalse(NestedHelper.mightMatchNestedDocs(bq, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(bq, "nested1", searchExecutionContext));
 
         bq = new BooleanQuery.Builder().add(new TermQuery(new Term("nested1.foo", "bar")), Occur.SHOULD)
             .add(new TermQuery(new Term("nested1.foo", "baz")), Occur.SHOULD)
             .build();
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(bq));
-        assertFalse(buildNestedHelper(mapperService).mightMatchNonNestedDocs(bq, "nested1"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(bq, searchExecutionContext));
+        assertFalse(NestedHelper.mightMatchNonNestedDocs(bq, "nested1", searchExecutionContext));
 
         bq = new BooleanQuery.Builder().add(new TermQuery(new Term("nested2.foo", "bar")), Occur.SHOULD)
             .add(new TermQuery(new Term("nested2.foo", "baz")), Occur.SHOULD)
             .build();
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(bq));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(bq, "nested2"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(bq, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(bq, "nested2", searchExecutionContext));
 
         bq = new BooleanQuery.Builder().add(new TermQuery(new Term("nested3.foo", "bar")), Occur.SHOULD)
             .add(new TermQuery(new Term("nested3.foo", "baz")), Occur.SHOULD)
             .build();
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(bq));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(bq, "nested3"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(bq, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(bq, "nested3", searchExecutionContext));
 
         bq = new BooleanQuery.Builder().add(new TermQuery(new Term("foo", "bar")), Occur.SHOULD)
             .add(new MatchAllDocsQuery(), Occur.SHOULD)
             .build();
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(bq));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(bq, "nested1"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(bq, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(bq, "nested1", searchExecutionContext));
 
         bq = new BooleanQuery.Builder().add(new TermQuery(new Term("nested1.foo", "bar")), Occur.SHOULD)
             .add(new MatchAllDocsQuery(), Occur.SHOULD)
             .build();
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(bq));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(bq, "nested1"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(bq, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(bq, "nested1", searchExecutionContext));
 
         bq = new BooleanQuery.Builder().add(new TermQuery(new Term("nested2.foo", "bar")), Occur.SHOULD)
             .add(new MatchAllDocsQuery(), Occur.SHOULD)
             .build();
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(bq));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(bq, "nested2"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(bq, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(bq, "nested2", searchExecutionContext));
 
         bq = new BooleanQuery.Builder().add(new TermQuery(new Term("nested3.foo", "bar")), Occur.SHOULD)
             .add(new MatchAllDocsQuery(), Occur.SHOULD)
             .build();
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(bq));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(bq, "nested3"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(bq, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(bq, "nested3", searchExecutionContext));
     }
 
     private static Occur requiredOccur() {
@@ -239,42 +261,42 @@ public void testConjunction() {
         BooleanQuery bq = new BooleanQuery.Builder().add(new TermQuery(new Term("foo", "bar")), requiredOccur())
             .add(new MatchAllDocsQuery(), requiredOccur())
             .build();
-        assertFalse(buildNestedHelper(mapperService).mightMatchNestedDocs(bq));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(bq, "nested1"));
+        assertFalse(NestedHelper.mightMatchNestedDocs(bq, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(bq, "nested1", searchExecutionContext));
 
         bq = new BooleanQuery.Builder().add(new TermQuery(new Term("nested1.foo", "bar")), requiredOccur())
             .add(new MatchAllDocsQuery(), requiredOccur())
             .build();
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(bq));
-        assertFalse(buildNestedHelper(mapperService).mightMatchNonNestedDocs(bq, "nested1"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(bq, searchExecutionContext));
+        assertFalse(NestedHelper.mightMatchNonNestedDocs(bq, "nested1", searchExecutionContext));
 
         bq = new BooleanQuery.Builder().add(new TermQuery(new Term("nested2.foo", "bar")), requiredOccur())
             .add(new MatchAllDocsQuery(), requiredOccur())
             .build();
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(bq));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(bq, "nested2"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(bq, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(bq, "nested2", searchExecutionContext));
 
         bq = new BooleanQuery.Builder().add(new TermQuery(new Term("nested3.foo", "bar")), requiredOccur())
             .add(new MatchAllDocsQuery(), requiredOccur())
             .build();
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(bq));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(bq, "nested3"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(bq, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(bq, "nested3", searchExecutionContext));
 
         bq = new BooleanQuery.Builder().add(new MatchAllDocsQuery(), requiredOccur()).add(new MatchAllDocsQuery(), requiredOccur()).build();
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(bq));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(bq, "nested1"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(bq, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(bq, "nested1", searchExecutionContext));
 
         bq = new BooleanQuery.Builder().add(new MatchAllDocsQuery(), requiredOccur()).add(new MatchAllDocsQuery(), requiredOccur()).build();
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(bq));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(bq, "nested1"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(bq, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(bq, "nested1", searchExecutionContext));
 
         bq = new BooleanQuery.Builder().add(new MatchAllDocsQuery(), requiredOccur()).add(new MatchAllDocsQuery(), requiredOccur()).build();
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(bq));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(bq, "nested2"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(bq, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(bq, "nested2", searchExecutionContext));
 
         bq = new BooleanQuery.Builder().add(new MatchAllDocsQuery(), requiredOccur()).add(new MatchAllDocsQuery(), requiredOccur()).build();
-        assertTrue(buildNestedHelper(mapperService).mightMatchNestedDocs(bq));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(bq, "nested3"));
+        assertTrue(NestedHelper.mightMatchNestedDocs(bq, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(bq, "nested3", searchExecutionContext));
     }
 
     public void testNested() throws IOException {
@@ -288,11 +310,11 @@ public void testNested() throws IOException {
             .build();
         assertEquals(expectedChildQuery, query.getChildQuery());
 
-        assertFalse(buildNestedHelper(mapperService).mightMatchNestedDocs(query));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(query, "nested1"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(query, "nested2"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(query, "nested3"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(query, "nested_missing"));
+        assertFalse(NestedHelper.mightMatchNestedDocs(query, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(query, "nested1", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(query, "nested2", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(query, "nested3", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(query, "nested_missing", searchExecutionContext));
 
         queryBuilder = new NestedQueryBuilder("nested1", new TermQueryBuilder("nested1.foo", "bar"), ScoreMode.Avg);
         query = (ESToParentBlockJoinQuery) queryBuilder.toQuery(context);
@@ -301,11 +323,11 @@ public void testNested() throws IOException {
         expectedChildQuery = new TermQuery(new Term("nested1.foo", "bar"));
         assertEquals(expectedChildQuery, query.getChildQuery());
 
-        assertFalse(buildNestedHelper(mapperService).mightMatchNestedDocs(query));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(query, "nested1"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(query, "nested2"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(query, "nested3"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(query, "nested_missing"));
+        assertFalse(NestedHelper.mightMatchNestedDocs(query, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(query, "nested1", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(query, "nested2", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(query, "nested3", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(query, "nested_missing", searchExecutionContext));
 
         queryBuilder = new NestedQueryBuilder("nested2", new TermQueryBuilder("nested2.foo", "bar"), ScoreMode.Avg);
         query = (ESToParentBlockJoinQuery) queryBuilder.toQuery(context);
@@ -316,11 +338,11 @@ public void testNested() throws IOException {
             .build();
         assertEquals(expectedChildQuery, query.getChildQuery());
 
-        assertFalse(buildNestedHelper(mapperService).mightMatchNestedDocs(query));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(query, "nested1"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(query, "nested2"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(query, "nested3"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(query, "nested_missing"));
+        assertFalse(NestedHelper.mightMatchNestedDocs(query, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(query, "nested1", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(query, "nested2", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(query, "nested3", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(query, "nested_missing", searchExecutionContext));
 
         queryBuilder = new NestedQueryBuilder("nested3", new TermQueryBuilder("nested3.foo", "bar"), ScoreMode.Avg);
         query = (ESToParentBlockJoinQuery) queryBuilder.toQuery(context);
@@ -331,10 +353,10 @@ public void testNested() throws IOException {
             .build();
         assertEquals(expectedChildQuery, query.getChildQuery());
 
-        assertFalse(buildNestedHelper(mapperService).mightMatchNestedDocs(query));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(query, "nested1"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(query, "nested2"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(query, "nested3"));
-        assertTrue(buildNestedHelper(mapperService).mightMatchNonNestedDocs(query, "nested_missing"));
+        assertFalse(NestedHelper.mightMatchNestedDocs(query, searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(query, "nested1", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(query, "nested2", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(query, "nested3", searchExecutionContext));
+        assertTrue(NestedHelper.mightMatchNonNestedDocs(query, "nested_missing", searchExecutionContext));
     }
 }
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/permission/DocumentPermissions.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/permission/DocumentPermissions.java
index 14ecf4cb0d6e9..24f0a52436203 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/permission/DocumentPermissions.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/permission/DocumentPermissions.java
@@ -160,10 +160,8 @@ private static void buildRoleQuery(
                 failIfQueryUsesClient(queryBuilder, context);
                 Query roleQuery = context.toQuery(queryBuilder).query();
                 filter.add(roleQuery, SHOULD);
-                NestedLookup nestedLookup = context.nestedLookup();
-                if (nestedLookup != NestedLookup.EMPTY) {
-                    NestedHelper nestedHelper = new NestedHelper(nestedLookup, context::isFieldMapped);
-                    if (nestedHelper.mightMatchNestedDocs(roleQuery)) {
+                if (context.nestedLookup() != NestedLookup.EMPTY) {
+                    if (NestedHelper.mightMatchNestedDocs(roleQuery, context)) {
                         roleQuery = new BooleanQuery.Builder().add(roleQuery, FILTER)
                             .add(Queries.newNonNestedFilter(context.indexVersionCreated()), FILTER)
                             .build();
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsPhysicalOperationProviders.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsPhysicalOperationProviders.java
index 39e2a3bc1d5af..17468f7afec1b 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsPhysicalOperationProviders.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsPhysicalOperationProviders.java
@@ -298,15 +298,11 @@ public SourceLoader newSourceLoader() {
         @Override
         public Query toQuery(QueryBuilder queryBuilder) {
             Query query = ctx.toQuery(queryBuilder).query();
-            NestedLookup nestedLookup = ctx.nestedLookup();
-            if (nestedLookup != NestedLookup.EMPTY) {
-                NestedHelper nestedHelper = new NestedHelper(nestedLookup, ctx::isFieldMapped);
-                if (nestedHelper.mightMatchNestedDocs(query)) {
-                    // filter out nested documents
-                    query = new BooleanQuery.Builder().add(query, BooleanClause.Occur.MUST)
-                        .add(newNonNestedFilter(ctx.indexVersionCreated()), BooleanClause.Occur.FILTER)
-                        .build();
-                }
+            if (ctx.nestedLookup() != NestedLookup.EMPTY && NestedHelper.mightMatchNestedDocs(query, ctx)) {
+                // filter out nested documents
+                query = new BooleanQuery.Builder().add(query, BooleanClause.Occur.MUST)
+                    .add(newNonNestedFilter(ctx.indexVersionCreated()), BooleanClause.Occur.FILTER)
+                    .build();
             }
             if (aliasFilter != AliasFilter.EMPTY) {
                 Query filterQuery = ctx.toQuery(aliasFilter.getQueryBuilder()).query();

From 949816f8585982e8b38f0a3433ffb1270e56e9ff Mon Sep 17 00:00:00 2001
From: Dimitris Rempapis <dimitris.rempapis@elastic.co>
Date: Thu, 5 Dec 2024 18:35:41 +0200
Subject: [PATCH 052/119] SearchServiceTests.testParseSourceValidation failure
 (#117963)

Remove test for deprecated code removed for v_9
---
 docs/changelog/117963.yaml                    |   5 +
 muted-tests.yml                               |   3 -
 .../search/SearchServiceTests.java            | 115 ------------------
 3 files changed, 5 insertions(+), 118 deletions(-)
 create mode 100644 docs/changelog/117963.yaml

diff --git a/docs/changelog/117963.yaml b/docs/changelog/117963.yaml
new file mode 100644
index 0000000000000..4a50dc175786b
--- /dev/null
+++ b/docs/changelog/117963.yaml
@@ -0,0 +1,5 @@
+pr: 117963
+summary: '`SearchServiceTests.testParseSourceValidation` failure'
+area: Search
+type: bug
+issues: []
diff --git a/muted-tests.yml b/muted-tests.yml
index b8d82f00bc43f..735a34a3b45db 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -103,9 +103,6 @@ tests:
 - class: org.elasticsearch.search.StressSearchServiceReaperIT
   method: testStressReaper
   issue: https://github.com/elastic/elasticsearch/issues/115816
-- class: org.elasticsearch.search.SearchServiceTests
-  method: testParseSourceValidation
-  issue: https://github.com/elastic/elasticsearch/issues/115936
 - class: org.elasticsearch.xpack.application.connector.ConnectorIndexServiceTests
   issue: https://github.com/elastic/elasticsearch/issues/116087
 - class: org.elasticsearch.backwards.MixedClusterClientYamlTestSuiteIT
diff --git a/server/src/test/java/org/elasticsearch/search/SearchServiceTests.java b/server/src/test/java/org/elasticsearch/search/SearchServiceTests.java
index d1ccfcbe78732..89fd25f638e1c 100644
--- a/server/src/test/java/org/elasticsearch/search/SearchServiceTests.java
+++ b/server/src/test/java/org/elasticsearch/search/SearchServiceTests.java
@@ -95,7 +95,6 @@
 import org.elasticsearch.search.aggregations.support.ValueType;
 import org.elasticsearch.search.builder.PointInTimeBuilder;
 import org.elasticsearch.search.builder.SearchSourceBuilder;
-import org.elasticsearch.search.collapse.CollapseBuilder;
 import org.elasticsearch.search.dfs.AggregatedDfs;
 import org.elasticsearch.search.fetch.FetchSearchResult;
 import org.elasticsearch.search.fetch.ShardFetchRequest;
@@ -124,7 +123,6 @@
 import org.elasticsearch.search.rank.feature.RankFeatureResult;
 import org.elasticsearch.search.rank.feature.RankFeatureShardRequest;
 import org.elasticsearch.search.rank.feature.RankFeatureShardResult;
-import org.elasticsearch.search.slice.SliceBuilder;
 import org.elasticsearch.search.suggest.SuggestBuilder;
 import org.elasticsearch.tasks.TaskCancelHelper;
 import org.elasticsearch.tasks.TaskCancelledException;
@@ -2930,119 +2928,6 @@ public void testSlicingBehaviourForParallelCollection() throws Exception {
         }
     }
 
-    /**
-     * This method tests validation that happens on the data nodes, which is now performed on the coordinating node.
-     * We still need the validation to cover for mixed cluster scenarios where the coordinating node does not perform the check yet.
-     */
-    public void testParseSourceValidation() {
-        String index = randomAlphaOfLengthBetween(5, 10).toLowerCase(Locale.ROOT);
-        IndexService indexService = createIndex(index);
-        final SearchService service = getInstanceFromNode(SearchService.class);
-        {
-            // scroll and search_after
-            SearchRequest searchRequest = new SearchRequest().source(new SearchSourceBuilder());
-            searchRequest.scroll(new TimeValue(1000));
-            searchRequest.source().searchAfter(new String[] { "value" });
-            assertCreateContextValidation(searchRequest, "`search_after` cannot be used in a scroll context.", indexService, service);
-        }
-        {
-            // scroll and collapse
-            SearchRequest searchRequest = new SearchRequest().source(new SearchSourceBuilder());
-            searchRequest.scroll(new TimeValue(1000));
-            searchRequest.source().collapse(new CollapseBuilder("field"));
-            assertCreateContextValidation(searchRequest, "cannot use `collapse` in a scroll context", indexService, service);
-        }
-        {
-            // search_after and `from` isn't valid
-            SearchRequest searchRequest = new SearchRequest().source(new SearchSourceBuilder());
-            searchRequest.source().searchAfter(new String[] { "value" });
-            searchRequest.source().from(10);
-            assertCreateContextValidation(
-                searchRequest,
-                "`from` parameter must be set to 0 when `search_after` is used",
-                indexService,
-                service
-            );
-        }
-        {
-            // slice without scroll or pit
-            SearchRequest searchRequest = new SearchRequest().source(new SearchSourceBuilder());
-            searchRequest.source().slice(new SliceBuilder(1, 10));
-            assertCreateContextValidation(
-                searchRequest,
-                "[slice] can only be used with [scroll] or [point-in-time] requests",
-                indexService,
-                service
-            );
-        }
-        {
-            // stored fields disabled with _source requested
-            SearchRequest searchRequest = new SearchRequest().source(new SearchSourceBuilder());
-            searchRequest.source().storedField("_none_");
-            searchRequest.source().fetchSource(true);
-            assertCreateContextValidation(
-                searchRequest,
-                "[stored_fields] cannot be disabled if [_source] is requested",
-                indexService,
-                service
-            );
-        }
-        {
-            // stored fields disabled with fetch fields requested
-            SearchRequest searchRequest = new SearchRequest().source(new SearchSourceBuilder());
-            searchRequest.source().storedField("_none_");
-            searchRequest.source().fetchSource(false);
-            searchRequest.source().fetchField("field");
-            assertCreateContextValidation(
-                searchRequest,
-                "[stored_fields] cannot be disabled when using the [fields] option",
-                indexService,
-                service
-            );
-        }
-    }
-
-    private static void assertCreateContextValidation(
-        SearchRequest searchRequest,
-        String errorMessage,
-        IndexService indexService,
-        SearchService searchService
-    ) {
-        ShardId shardId = new ShardId(indexService.index(), 0);
-        long nowInMillis = System.currentTimeMillis();
-        String clusterAlias = randomBoolean() ? null : randomAlphaOfLengthBetween(3, 10);
-        searchRequest.allowPartialSearchResults(randomBoolean());
-        ShardSearchRequest request = new ShardSearchRequest(
-            OriginalIndices.NONE,
-            searchRequest,
-            shardId,
-            0,
-            indexService.numberOfShards(),
-            AliasFilter.EMPTY,
-            1f,
-            nowInMillis,
-            clusterAlias
-        );
-
-        SearchShardTask task = new SearchShardTask(1, "type", "action", "description", null, emptyMap());
-
-        ReaderContext readerContext = null;
-        try {
-            ReaderContext createOrGetReaderContext = searchService.createOrGetReaderContext(request);
-            readerContext = createOrGetReaderContext;
-            IllegalArgumentException exception = expectThrows(
-                IllegalArgumentException.class,
-                () -> searchService.createContext(createOrGetReaderContext, request, task, ResultsType.QUERY, randomBoolean())
-            );
-            assertThat(exception.getMessage(), containsString(errorMessage));
-        } finally {
-            if (readerContext != null) {
-                readerContext.close();
-                searchService.freeReaderContext(readerContext.id());
-            }
-        }
-    }
-
     private static ReaderContext createReaderContext(IndexService indexService, IndexShard indexShard) {
         return new ReaderContext(
             new ShardSearchContextId(UUIDs.randomBase64UUID(), randomNonNegativeLong()),

From 176bf7a85abb2e2af06f60901b448bef945d528b Mon Sep 17 00:00:00 2001
From: Mark Tozzi <mark.tozzi@gmail.com>
Date: Thu, 5 Dec 2024 11:53:15 -0500
Subject: [PATCH 053/119] ESQL Javadoc for creating new data types (#117520)

This adds some java doc to the DataType enum, listing out the steps I followed for adding DateNanos. Hopefully it's helpful to future folks adding data types.
---------

Co-authored-by: Bogdan Pintea <pintea@mailbox.org>
---
 .../xpack/esql/core/type/DataType.java        | 107 ++++++++++++++++++
 1 file changed, 107 insertions(+)

diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/type/DataType.java b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/type/DataType.java
index a63571093ba58..d86cdb0de038c 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/type/DataType.java
+++ b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/type/DataType.java
@@ -32,6 +32,113 @@
 import static org.elasticsearch.xpack.esql.core.util.PlanStreamInput.readCachedStringWithVersionCheck;
 import static org.elasticsearch.xpack.esql.core.util.PlanStreamOutput.writeCachedStringWithVersionCheck;
 
+/**
+ * This enum represents data types the ES|QL query processing layer is able to
+ * interact with in some way. This includes fully representable types (e.g.
+ * {@link DataType#LONG}, numeric types which we promote (e.g. {@link DataType#SHORT})
+ * or fold into other types (e.g. {@link DataType#DATE_PERIOD}) early in the
+ * processing pipeline, types for internal use
+ * cases (e.g. {@link DataType#PARTIAL_AGG}), and types which the language
+ * doesn't support, but require special handling anyway (e.g.
+ * {@link DataType#OBJECT})
+ *
+ * <h2>Process for adding a new data type</h2>
+ * Note: it is not expected that all the following steps be done in a single PR.
+ * Use capabilities to gate tests as you go, and use as many PRs as you think
+ * appropriate. New data types are complex, and smaller PRs will make reviews
+ * easier.
+ * <ul>
+ *     <li>
+ *         Create a new feature flag for the type in {@link EsqlCorePlugin}. We
+ *         recommend developing the data type over a series of smaller PRs behind
+ *         a feature flag; even for relatively simple data types.</li>
+ *     <li>
+ *         Add a capability to EsqlCapabilities related to the new type, and
+ *         gated by the feature flag you just created. Again, using the feature
+ *         flag is preferred over snapshot-only. As development progresses, you may
+ *         need to add more capabilities related to the new type, e.g. for
+ *         supporting specific functions. This is fine, and expected.</li>
+ *     <li>
+ *         Create a new CSV test file for the new type. You'll either need to
+ *         create a new data file as well, or add values of the new type to
+ *         and existing data file. See CsvTestDataLoader for creating a new data
+ *         set.</li>
+ *     <li>
+ *         In the new CSV test file, start adding basic functionality tests.
+ *         These should include reading and returning values, both from indexed data
+ *         and from the ROW command.  It should also include functions that support
+ *         "every" type, such as Case or MvFirst.</li>
+ *     <li>
+ *         Add the new type to the CsvTestUtils#Type enum, if it isn't already
+ *         there. You also need to modify CsvAssert to support reading values
+ *         of the new type.</li>
+ *     <li>
+ *         At this point, the CSV tests should fail with a sensible ES|QL error
+ *         message. Make sure they're failing in ES|QL, not in the test
+ *         framework.</li>
+ *     <li>
+ *         Add the new data type to this enum. This will cause a bunch of
+ *         compile errors for switch statements throughout the code.  Resolve those
+ *         as appropriate. That is the main way in which the new type will be tied
+ *         into the framework.</li>
+ *     <li>
+ *         Add the new type to the {@link DataType#UNDER_CONSTRUCTION}
+ *         collection. This is used by the test framework to disable some checks
+ *         around how functions report their supported types, which would otherwise
+ *         generate a lot of noise while the type is still in development.</li>
+ *     <li>
+ *         Add typed data generators to TestCaseSupplier, and make sure all
+ *         functions that support the new type have tests for it.</li>
+ *     <li>
+ *         Work to support things all types should do. Equality and the
+ *         "typeless" MV functions (MvFirst, MvLast, and MvCount) should work for
+ *         most types. Case and Coalesce should also support all types.
+ *         If the type has a natural ordering, make sure to test
+ *         sorting and the other binary comparisons. Make sure these functions all
+ *         have CSV tests that run against indexed data.</li>
+ *     <li>
+ *         Add conversion functions as appropriate.  Almost all types should
+ *         support ToString, and should have a "ToType" function that accepts a
+ *         string.  There may be other logical conversions depending on the nature
+ *         of the type. Make sure to add the conversion function to the
+ *         TYPE_TO_CONVERSION_FUNCTION map in EsqlDataTypeConverter. Make sure the
+ *         conversion functions have CSV tests that run against indexed data.</li>
+ *     <li>
+ *         Support the new type in aggregations that are type independent.
+ *         This includes Values, Count, and Count Distinct. Make sure there are
+ *         CSV tests against indexed data for these.</li>
+ *     <li>
+ *         Support other functions and aggregations as appropriate, making sure
+ *         to included CSV tests.</li>
+ *     <li>
+ *         Consider how the type will interact with other types. For example,
+ *         if the new type is numeric, it may be good for it to be comparable with
+ *         other numbers. Supporting this may require new logic in
+ *         EsqlDataTypeConverter#commonType, individual function type checking, the
+ *         verifier rules, or other places. We suggest starting with CSV tests and
+ *         seeing where they fail.</li>
+ * </ul>
+ * There are some additional steps that should be taken when removing the
+ * feature flag and getting ready for a release:
+ * <ul>
+ *     <li>
+ *         Ensure the capabilities for this type are always enabled
+ *     </li>
+ *     <li>
+ *         Remove the type from the {@link DataType#UNDER_CONSTRUCTION}
+ *         collection</li>
+ *     <li>
+ *         Fix new test failures related to declared function types
+ *     </li>
+ *     <li>
+ *         Make sure to run the full test suite locally via gradle to generate
+ *         the function type tables and helper files with the new type. Ensure all
+ *         the functions that support the type have appropriate docs for it.</li>
+ *     <li>
+ *         If appropriate, remove the type from the ESQL limitations list of
+ *         unsupported types.</li>
+ * </ul>
+ */
 public enum DataType {
     /**
      * Fields of this type are unsupported by any functions and are always

From 162140e1d2e1c82faa5eada4d97a1143ba89afde Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lorenzo=20Dematt=C3=A9?= <lorenzo.dematte@elastic.co>
Date: Thu, 5 Dec 2024 17:58:56 +0100
Subject: [PATCH 054/119] Close URLClassLoaders to make Windows happy deleting
 the temp test jar files (#118083)

---
 .../bootstrap/PluginsResolverTests.java       | 67 ++++++++++---------
 1 file changed, 35 insertions(+), 32 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/bootstrap/PluginsResolverTests.java b/server/src/test/java/org/elasticsearch/bootstrap/PluginsResolverTests.java
index 331f0f7ad13e9..798b576500d72 100644
--- a/server/src/test/java/org/elasticsearch/bootstrap/PluginsResolverTests.java
+++ b/server/src/test/java/org/elasticsearch/bootstrap/PluginsResolverTests.java
@@ -136,25 +136,28 @@ public void testResolveMultipleNonModularPlugins() throws IOException, ClassNotF
         Path jar1 = createNonModularPluginJar(home, "plugin1", "p", "A");
         Path jar2 = createNonModularPluginJar(home, "plugin2", "q", "B");
 
-        var loader1 = createClassLoader(jar1);
-        var loader2 = createClassLoader(jar2);
-
-        PluginBundle bundle1 = createMockBundle("plugin1", null, "p.A");
-        PluginBundle bundle2 = createMockBundle("plugin2", null, "q.B");
-        PluginsLoader mockPluginsLoader = mock(PluginsLoader.class);
-
-        when(mockPluginsLoader.pluginLayers()).thenReturn(
-            Stream.of(new TestPluginLayer(bundle1, loader1, ModuleLayer.boot()), new TestPluginLayer(bundle2, loader2, ModuleLayer.boot()))
-        );
-        PluginsResolver pluginsResolver = PluginsResolver.create(mockPluginsLoader);
-
-        var testClass1 = loader1.loadClass("p.A");
-        var testClass2 = loader2.loadClass("q.B");
-        var resolvedPluginName1 = pluginsResolver.resolveClassToPluginName(testClass1);
-        var resolvedPluginName2 = pluginsResolver.resolveClassToPluginName(testClass2);
-
-        assertEquals("plugin1", resolvedPluginName1);
-        assertEquals("plugin2", resolvedPluginName2);
+        try (var loader1 = createClassLoader(jar1); var loader2 = createClassLoader(jar2)) {
+
+            PluginBundle bundle1 = createMockBundle("plugin1", null, "p.A");
+            PluginBundle bundle2 = createMockBundle("plugin2", null, "q.B");
+            PluginsLoader mockPluginsLoader = mock(PluginsLoader.class);
+
+            when(mockPluginsLoader.pluginLayers()).thenReturn(
+                Stream.of(
+                    new TestPluginLayer(bundle1, loader1, ModuleLayer.boot()),
+                    new TestPluginLayer(bundle2, loader2, ModuleLayer.boot())
+                )
+            );
+            PluginsResolver pluginsResolver = PluginsResolver.create(mockPluginsLoader);
+
+            var testClass1 = loader1.loadClass("p.A");
+            var testClass2 = loader2.loadClass("q.B");
+            var resolvedPluginName1 = pluginsResolver.resolveClassToPluginName(testClass1);
+            var resolvedPluginName2 = pluginsResolver.resolveClassToPluginName(testClass2);
+
+            assertEquals("plugin1", resolvedPluginName1);
+            assertEquals("plugin2", resolvedPluginName2);
+        }
     }
 
     public void testResolveNonModularPlugin() throws IOException, ClassNotFoundException {
@@ -164,22 +167,22 @@ public void testResolveNonModularPlugin() throws IOException, ClassNotFoundExcep
 
         Path jar = createNonModularPluginJar(home, pluginName, "p", "A");
 
-        var loader = createClassLoader(jar);
-
-        PluginBundle bundle = createMockBundle(pluginName, null, "p.A");
-        PluginsLoader mockPluginsLoader = mock(PluginsLoader.class);
+        try (var loader = createClassLoader(jar)) {
+            PluginBundle bundle = createMockBundle(pluginName, null, "p.A");
+            PluginsLoader mockPluginsLoader = mock(PluginsLoader.class);
 
-        when(mockPluginsLoader.pluginLayers()).thenReturn(Stream.of(new TestPluginLayer(bundle, loader, ModuleLayer.boot())));
-        PluginsResolver pluginsResolver = PluginsResolver.create(mockPluginsLoader);
+            when(mockPluginsLoader.pluginLayers()).thenReturn(Stream.of(new TestPluginLayer(bundle, loader, ModuleLayer.boot())));
+            PluginsResolver pluginsResolver = PluginsResolver.create(mockPluginsLoader);
 
-        var testClass = loader.loadClass("p.A");
-        var resolvedPluginName = pluginsResolver.resolveClassToPluginName(testClass);
-        var unresolvedPluginName1 = pluginsResolver.resolveClassToPluginName(PluginsResolver.class);
-        var unresolvedPluginName2 = pluginsResolver.resolveClassToPluginName(String.class);
+            var testClass = loader.loadClass("p.A");
+            var resolvedPluginName = pluginsResolver.resolveClassToPluginName(testClass);
+            var unresolvedPluginName1 = pluginsResolver.resolveClassToPluginName(PluginsResolver.class);
+            var unresolvedPluginName2 = pluginsResolver.resolveClassToPluginName(String.class);
 
-        assertEquals(pluginName, resolvedPluginName);
-        assertNull(unresolvedPluginName1);
-        assertNull(unresolvedPluginName2);
+            assertEquals(pluginName, resolvedPluginName);
+            assertNull(unresolvedPluginName1);
+            assertNull(unresolvedPluginName2);
+        }
     }
 
     private static URLClassLoader createClassLoader(Path jar) throws MalformedURLException {

From eb4f33ae7be785404a97f6ca9c42f94749de3599 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Fri, 6 Dec 2024 04:09:50 +1100
Subject: [PATCH 055/119] Mute
 org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
 org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT #117981

---
 muted-tests.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 735a34a3b45db..a09e46415fdc1 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -251,6 +251,8 @@ tests:
 - class: org.elasticsearch.packaging.test.ArchiveTests
   method: test40AutoconfigurationNotTriggeredWhenNodeIsMeantToJoinExistingCluster
   issue: https://github.com/elastic/elasticsearch/issues/118029
+- class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
+  issue: https://github.com/elastic/elasticsearch/issues/117981
 
 # Examples:
 #

From 21f72f8f6a9e2518a21631e61713880aa027c2c4 Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Thu, 5 Dec 2024 12:15:48 -0500
Subject: [PATCH 056/119] Removing dead/unused deprecation logger code
 (#118082)

---
 .../rest/action/document/RestGetSourceAction.java             | 4 ----
 .../rest/action/document/RestMultiTermVectorsAction.java      | 3 ---
 .../org/elasticsearch/rest/action/search/RestCountAction.java | 3 ---
 .../elasticsearch/rest/action/search/RestSearchAction.java    | 3 ---
 .../org/elasticsearch/search/builder/SearchSourceBuilder.java | 2 --
 .../org/elasticsearch/search/sort/GeoDistanceSortBuilder.java | 2 --
 6 files changed, 17 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/rest/action/document/RestGetSourceAction.java b/server/src/main/java/org/elasticsearch/rest/action/document/RestGetSourceAction.java
index a09fcbd0c5273..7e4d23db70288 100644
--- a/server/src/main/java/org/elasticsearch/rest/action/document/RestGetSourceAction.java
+++ b/server/src/main/java/org/elasticsearch/rest/action/document/RestGetSourceAction.java
@@ -15,7 +15,6 @@
 import org.elasticsearch.action.get.GetResponse;
 import org.elasticsearch.client.internal.node.NodeClient;
 import org.elasticsearch.common.bytes.BytesReference;
-import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.rest.BaseRestHandler;
 import org.elasticsearch.rest.RestChannel;
@@ -40,9 +39,6 @@
  */
 @ServerlessScope(Scope.PUBLIC)
 public class RestGetSourceAction extends BaseRestHandler {
-    private final DeprecationLogger deprecationLogger = DeprecationLogger.getLogger(RestGetSourceAction.class);
-    static final String TYPES_DEPRECATION_MESSAGE = "[types removal] Specifying types in get_source and exist_source "
-        + "requests is deprecated.";
 
     @Override
     public List<Route> routes() {
diff --git a/server/src/main/java/org/elasticsearch/rest/action/document/RestMultiTermVectorsAction.java b/server/src/main/java/org/elasticsearch/rest/action/document/RestMultiTermVectorsAction.java
index 65aa1869a41e4..9d39bf7f343c6 100644
--- a/server/src/main/java/org/elasticsearch/rest/action/document/RestMultiTermVectorsAction.java
+++ b/server/src/main/java/org/elasticsearch/rest/action/document/RestMultiTermVectorsAction.java
@@ -13,7 +13,6 @@
 import org.elasticsearch.action.termvectors.TermVectorsRequest;
 import org.elasticsearch.client.internal.node.NodeClient;
 import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.rest.BaseRestHandler;
 import org.elasticsearch.rest.RestRequest;
 import org.elasticsearch.rest.Scope;
@@ -28,8 +27,6 @@
 
 @ServerlessScope(Scope.PUBLIC)
 public class RestMultiTermVectorsAction extends BaseRestHandler {
-    private static final DeprecationLogger deprecationLogger = DeprecationLogger.getLogger(RestMultiTermVectorsAction.class);
-    static final String TYPES_DEPRECATION_MESSAGE = "[types removal] Specifying types in multi term vector requests is deprecated.";
 
     @Override
     public List<Route> routes() {
diff --git a/server/src/main/java/org/elasticsearch/rest/action/search/RestCountAction.java b/server/src/main/java/org/elasticsearch/rest/action/search/RestCountAction.java
index c1a55874bfc58..b0e08b376f9d0 100644
--- a/server/src/main/java/org/elasticsearch/rest/action/search/RestCountAction.java
+++ b/server/src/main/java/org/elasticsearch/rest/action/search/RestCountAction.java
@@ -14,7 +14,6 @@
 import org.elasticsearch.action.support.IndicesOptions;
 import org.elasticsearch.client.internal.node.NodeClient;
 import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.index.query.QueryBuilder;
 import org.elasticsearch.rest.BaseRestHandler;
 import org.elasticsearch.rest.RestRequest;
@@ -36,8 +35,6 @@
 
 @ServerlessScope(Scope.PUBLIC)
 public class RestCountAction extends BaseRestHandler {
-    private final DeprecationLogger deprecationLogger = DeprecationLogger.getLogger(RestCountAction.class);
-    static final String TYPES_DEPRECATION_MESSAGE = "[types removal] Specifying types in count requests is deprecated.";
 
     @Override
     public List<Route> routes() {
diff --git a/server/src/main/java/org/elasticsearch/rest/action/search/RestSearchAction.java b/server/src/main/java/org/elasticsearch/rest/action/search/RestSearchAction.java
index ff062084a3cbb..a9c2ff7576b05 100644
--- a/server/src/main/java/org/elasticsearch/rest/action/search/RestSearchAction.java
+++ b/server/src/main/java/org/elasticsearch/rest/action/search/RestSearchAction.java
@@ -16,7 +16,6 @@
 import org.elasticsearch.action.support.IndicesOptions;
 import org.elasticsearch.client.internal.node.NodeClient;
 import org.elasticsearch.common.Strings;
-import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.core.Booleans;
 import org.elasticsearch.core.Nullable;
 import org.elasticsearch.features.NodeFeature;
@@ -56,8 +55,6 @@
 
 @ServerlessScope(Scope.PUBLIC)
 public class RestSearchAction extends BaseRestHandler {
-    private static final DeprecationLogger deprecationLogger = DeprecationLogger.getLogger(RestSearchAction.class);
-    public static final String TYPES_DEPRECATION_MESSAGE = "[types removal] Specifying types in search requests is deprecated.";
 
     /**
      * Indicates whether hits.total should be rendered as an integer or an object
diff --git a/server/src/main/java/org/elasticsearch/search/builder/SearchSourceBuilder.java b/server/src/main/java/org/elasticsearch/search/builder/SearchSourceBuilder.java
index 098a2b2f45d2f..3554a6dc08b90 100644
--- a/server/src/main/java/org/elasticsearch/search/builder/SearchSourceBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/builder/SearchSourceBuilder.java
@@ -19,7 +19,6 @@
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.io.stream.Writeable;
-import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.util.CollectionUtils;
 import org.elasticsearch.common.xcontent.XContentHelper;
 import org.elasticsearch.core.Booleans;
@@ -92,7 +91,6 @@
  * @see SearchRequest#source(SearchSourceBuilder)
  */
 public final class SearchSourceBuilder implements Writeable, ToXContentObject, Rewriteable<SearchSourceBuilder> {
-    private static final DeprecationLogger deprecationLogger = DeprecationLogger.getLogger(SearchSourceBuilder.class);
 
     public static final ParseField FROM_FIELD = new ParseField("from");
     public static final ParseField SIZE_FIELD = new ParseField("size");
diff --git a/server/src/main/java/org/elasticsearch/search/sort/GeoDistanceSortBuilder.java b/server/src/main/java/org/elasticsearch/search/sort/GeoDistanceSortBuilder.java
index 6640f0f858404..2aaade35fb8f3 100644
--- a/server/src/main/java/org/elasticsearch/search/sort/GeoDistanceSortBuilder.java
+++ b/server/src/main/java/org/elasticsearch/search/sort/GeoDistanceSortBuilder.java
@@ -28,7 +28,6 @@
 import org.elasticsearch.common.geo.GeoUtils;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
-import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.unit.DistanceUnit;
 import org.elasticsearch.common.util.BigArrays;
 import org.elasticsearch.index.fielddata.FieldData;
@@ -67,7 +66,6 @@
  * A geo distance based sorting on a geo point like field.
  */
 public class GeoDistanceSortBuilder extends SortBuilder<GeoDistanceSortBuilder> {
-    private static final DeprecationLogger deprecationLogger = DeprecationLogger.getLogger(GeoDistanceSortBuilder.class);
 
     public static final String NAME = "_geo_distance";
     public static final String ALTERNATIVE_NAME = "_geoDistance";

From 4740b02a9b1c7c7ae0c6383c5985720bbdfa353c Mon Sep 17 00:00:00 2001
From: Henrique Paes <henriquee.paes1@gmail.com>
Date: Thu, 5 Dec 2024 12:22:48 -0500
Subject: [PATCH 057/119] Wrap jackson exception on malformed json string
 (#114445)

This commit hides the underlying Jackson parse exception when encountered while parsing string tokens.
---
 docs/changelog/114445.yaml                          |  6 ++++++
 .../xcontent/provider/json/JsonXContentParser.java  |  6 +++++-
 .../java/org/elasticsearch/http/BulkRestIT.java     |  3 +--
 .../common/xcontent/json/JsonXContentTests.java     | 13 +++++++++++++
 4 files changed, 25 insertions(+), 3 deletions(-)
 create mode 100644 docs/changelog/114445.yaml

diff --git a/docs/changelog/114445.yaml b/docs/changelog/114445.yaml
new file mode 100644
index 0000000000000..afbc080d1e0b9
--- /dev/null
+++ b/docs/changelog/114445.yaml
@@ -0,0 +1,6 @@
+pr: 114445
+summary: Wrap jackson exception on malformed json string
+area: Infra/Core
+type: bug
+issues:
+ - 114142
diff --git a/libs/x-content/impl/src/main/java/org/elasticsearch/xcontent/provider/json/JsonXContentParser.java b/libs/x-content/impl/src/main/java/org/elasticsearch/xcontent/provider/json/JsonXContentParser.java
index d42c56845d03f..38ef8bc2e4ef0 100644
--- a/libs/x-content/impl/src/main/java/org/elasticsearch/xcontent/provider/json/JsonXContentParser.java
+++ b/libs/x-content/impl/src/main/java/org/elasticsearch/xcontent/provider/json/JsonXContentParser.java
@@ -108,7 +108,11 @@ public String text() throws IOException {
         if (currentToken().isValue() == false) {
             throwOnNoText();
         }
-        return parser.getText();
+        try {
+            return parser.getText();
+        } catch (JsonParseException e) {
+            throw newXContentParseException(e);
+        }
     }
 
     private void throwOnNoText() {
diff --git a/qa/smoke-test-http/src/javaRestTest/java/org/elasticsearch/http/BulkRestIT.java b/qa/smoke-test-http/src/javaRestTest/java/org/elasticsearch/http/BulkRestIT.java
index 369d0824bdb28..3faa88339f0a3 100644
--- a/qa/smoke-test-http/src/javaRestTest/java/org/elasticsearch/http/BulkRestIT.java
+++ b/qa/smoke-test-http/src/javaRestTest/java/org/elasticsearch/http/BulkRestIT.java
@@ -74,8 +74,7 @@ public void testBulkInvalidIndexNameString() throws IOException {
 
         ResponseException responseException = expectThrows(ResponseException.class, () -> getRestClient().performRequest(request));
         assertThat(responseException.getResponse().getStatusLine().getStatusCode(), equalTo(BAD_REQUEST.getStatus()));
-        assertThat(responseException.getMessage(), containsString("could not parse bulk request body"));
-        assertThat(responseException.getMessage(), containsString("json_parse_exception"));
+        assertThat(responseException.getMessage(), containsString("x_content_parse_exception"));
         assertThat(responseException.getMessage(), containsString("Invalid UTF-8"));
     }
 
diff --git a/server/src/test/java/org/elasticsearch/common/xcontent/json/JsonXContentTests.java b/server/src/test/java/org/elasticsearch/common/xcontent/json/JsonXContentTests.java
index 55f6cc5498d80..4135ead545e07 100644
--- a/server/src/test/java/org/elasticsearch/common/xcontent/json/JsonXContentTests.java
+++ b/server/src/test/java/org/elasticsearch/common/xcontent/json/JsonXContentTests.java
@@ -11,6 +11,9 @@
 
 import org.elasticsearch.common.xcontent.BaseXContentTestCase;
 import org.elasticsearch.xcontent.XContentGenerator;
+import org.elasticsearch.xcontent.XContentParseException;
+import org.elasticsearch.xcontent.XContentParser;
+import org.elasticsearch.xcontent.XContentParserConfiguration;
 import org.elasticsearch.xcontent.XContentType;
 import org.elasticsearch.xcontent.json.JsonXContent;
 
@@ -28,4 +31,14 @@ public void testBigInteger() throws Exception {
         XContentGenerator generator = JsonXContent.jsonXContent.createGenerator(os);
         doTestBigInteger(generator, os);
     }
+
+    public void testMalformedJsonFieldThrowsXContentException() throws Exception {
+        String json = "{\"test\":\"/*/}";
+        try (XContentParser parser = JsonXContent.jsonXContent.createParser(XContentParserConfiguration.EMPTY, json)) {
+            parser.nextToken();
+            parser.nextToken();
+            parser.nextToken();
+            assertThrows(XContentParseException.class, () -> parser.text());
+        }
+    }
 }

From 7070e95fa78ef29df363d1d49cd05f0b79a835bf Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Thu, 5 Dec 2024 09:43:18 -0800
Subject: [PATCH 058/119] Update BWC version logic to support multiple bugfix
 versions (#117943)

---
 .buildkite/pipelines/intake.yml               |   2 +-
 .buildkite/pipelines/periodic.yml             |   4 +-
 .ci/snapshotBwcVersions                       |   1 +
 ...lDistributionBwcSetupPluginFuncTest.groovy |  24 ++-
 ...lDistributionDownloadPluginFuncTest.groovy |   4 +-
 ...acyYamlRestCompatTestPluginFuncTest.groovy |  16 +-
 .../distribution/bwc/bugfix2/build.gradle     |   0
 .../distribution/bwc/maintenance/build.gradle |   0
 .../internal/fake_git/remote/settings.gradle  |   2 +
 .../gradle/internal/BwcVersions.java          | 126 ++++++-----
 .../internal/info/GlobalBuildInfoPlugin.java  |  25 ++-
 .../gradle/internal/BwcVersionsSpec.groovy    | 196 +++++++++++-------
 ...stractDistributionDownloadPluginTests.java |  14 +-
 .../fixtures/AbstractGradleFuncTest.groovy    |  18 +-
 distribution/bwc/bugfix2/build.gradle         |   0
 settings.gradle                               |   1 +
 16 files changed, 273 insertions(+), 160 deletions(-)
 create mode 100644 build-tools-internal/src/integTest/resources/org/elasticsearch/gradle/internal/fake_git/remote/distribution/bwc/bugfix2/build.gradle
 create mode 100644 build-tools-internal/src/integTest/resources/org/elasticsearch/gradle/internal/fake_git/remote/distribution/bwc/maintenance/build.gradle
 create mode 100644 distribution/bwc/bugfix2/build.gradle

diff --git a/.buildkite/pipelines/intake.yml b/.buildkite/pipelines/intake.yml
index 6c8b8edfcbac1..4bc72aec20972 100644
--- a/.buildkite/pipelines/intake.yml
+++ b/.buildkite/pipelines/intake.yml
@@ -56,7 +56,7 @@ steps:
         timeout_in_minutes: 300
         matrix:
           setup:
-            BWC_VERSION: ["8.16.2", "8.17.0", "8.18.0", "9.0.0"]
+            BWC_VERSION: ["8.15.6", "8.16.2", "8.17.0", "8.18.0", "9.0.0"]
         agents:
           provider: gcp
           image: family/elasticsearch-ubuntu-2004
diff --git a/.buildkite/pipelines/periodic.yml b/.buildkite/pipelines/periodic.yml
index 69d11ef1dabb6..3d6095d0b9e63 100644
--- a/.buildkite/pipelines/periodic.yml
+++ b/.buildkite/pipelines/periodic.yml
@@ -448,7 +448,7 @@ steps:
           setup:
             ES_RUNTIME_JAVA:
               - openjdk21
-            BWC_VERSION: ["8.16.2", "8.17.0", "8.18.0", "9.0.0"]
+            BWC_VERSION: ["8.15.6", "8.16.2", "8.17.0", "8.18.0", "9.0.0"]
         agents:
           provider: gcp
           image: family/elasticsearch-ubuntu-2004
@@ -490,7 +490,7 @@ steps:
             ES_RUNTIME_JAVA:
               - openjdk21
               - openjdk23
-            BWC_VERSION: ["8.16.2", "8.17.0", "8.18.0", "9.0.0"]
+            BWC_VERSION: ["8.15.6", "8.16.2", "8.17.0", "8.18.0", "9.0.0"]
         agents:
           provider: gcp
           image: family/elasticsearch-ubuntu-2004
diff --git a/.ci/snapshotBwcVersions b/.ci/snapshotBwcVersions
index 5514fc376a285..f92881da7fea4 100644
--- a/.ci/snapshotBwcVersions
+++ b/.ci/snapshotBwcVersions
@@ -1,4 +1,5 @@
 BWC_VERSION:
+  - "8.15.6"
   - "8.16.2"
   - "8.17.0"
   - "8.18.0"
diff --git a/build-tools-internal/src/integTest/groovy/org/elasticsearch/gradle/internal/InternalDistributionBwcSetupPluginFuncTest.groovy b/build-tools-internal/src/integTest/groovy/org/elasticsearch/gradle/internal/InternalDistributionBwcSetupPluginFuncTest.groovy
index 6d080e1c80763..bb100b6b23882 100644
--- a/build-tools-internal/src/integTest/groovy/org/elasticsearch/gradle/internal/InternalDistributionBwcSetupPluginFuncTest.groovy
+++ b/build-tools-internal/src/integTest/groovy/org/elasticsearch/gradle/internal/InternalDistributionBwcSetupPluginFuncTest.groovy
@@ -9,9 +9,10 @@
 
 package org.elasticsearch.gradle.internal
 
+import spock.lang.Unroll
+
 import org.elasticsearch.gradle.fixtures.AbstractGitAwareGradleFuncTest
 import org.gradle.testkit.runner.TaskOutcome
-import spock.lang.Unroll
 
 class InternalDistributionBwcSetupPluginFuncTest extends AbstractGitAwareGradleFuncTest {
 
@@ -23,8 +24,10 @@ class InternalDistributionBwcSetupPluginFuncTest extends AbstractGitAwareGradleF
             apply plugin: 'elasticsearch.internal-distribution-bwc-setup'
         """
         execute("git branch origin/8.x", file("cloned"))
+        execute("git branch origin/8.3", file("cloned"))
+        execute("git branch origin/8.2", file("cloned"))
+        execute("git branch origin/8.1", file("cloned"))
         execute("git branch origin/7.16", file("cloned"))
-        execute("git branch origin/7.15", file("cloned"))
     }
 
     def "builds distribution from branches via archives extractedAssemble"() {
@@ -48,10 +51,11 @@ class InternalDistributionBwcSetupPluginFuncTest extends AbstractGitAwareGradleF
         assertOutputContains(result.output, "[$bwcDistVersion] > Task :distribution:archives:darwin-tar:${expectedAssembleTaskName}")
 
         where:
-        bwcDistVersion | bwcProject | expectedAssembleTaskName
-        "8.0.0"        | "minor"    | "extractedAssemble"
-        "7.16.0"       | "staged"   | "extractedAssemble"
-        "7.15.2"       | "bugfix"   | "extractedAssemble"
+        bwcDistVersion | bwcProject    | expectedAssembleTaskName
+        "8.4.0"        | "minor"       | "extractedAssemble"
+        "8.3.0"        | "staged"      | "extractedAssemble"
+        "8.2.1"        | "bugfix"      | "extractedAssemble"
+        "8.1.3"        | "bugfix2"     | "extractedAssemble"
     }
 
     @Unroll
@@ -70,8 +74,8 @@ class InternalDistributionBwcSetupPluginFuncTest extends AbstractGitAwareGradleF
 
         where:
         bwcDistVersion | platform
-        "8.0.0"       | "darwin"
-        "8.0.0"       | "linux"
+        "8.4.0"       | "darwin"
+        "8.4.0"       | "linux"
     }
 
     def "bwc expanded distribution folder can be resolved as bwc project artifact"() {
@@ -107,11 +111,11 @@ class InternalDistributionBwcSetupPluginFuncTest extends AbstractGitAwareGradleF
         result.task(":resolveExpandedDistribution").outcome == TaskOutcome.SUCCESS
         result.task(":distribution:bwc:minor:buildBwcDarwinTar").outcome == TaskOutcome.SUCCESS
         and: "assemble task triggered"
-        result.output.contains("[8.0.0] > Task :distribution:archives:darwin-tar:extractedAssemble")
+        result.output.contains("[8.4.0] > Task :distribution:archives:darwin-tar:extractedAssemble")
         result.output.contains("expandedRootPath /distribution/bwc/minor/build/bwc/checkout-8.x/" +
                         "distribution/archives/darwin-tar/build/install")
         result.output.contains("nested folder /distribution/bwc/minor/build/bwc/checkout-8.x/" +
-                        "distribution/archives/darwin-tar/build/install/elasticsearch-8.0.0-SNAPSHOT")
+                        "distribution/archives/darwin-tar/build/install/elasticsearch-8.4.0-SNAPSHOT")
     }
 
 }
diff --git a/build-tools-internal/src/integTest/groovy/org/elasticsearch/gradle/internal/InternalDistributionDownloadPluginFuncTest.groovy b/build-tools-internal/src/integTest/groovy/org/elasticsearch/gradle/internal/InternalDistributionDownloadPluginFuncTest.groovy
index eb6185e5aed57..fc5d432a9ef9a 100644
--- a/build-tools-internal/src/integTest/groovy/org/elasticsearch/gradle/internal/InternalDistributionDownloadPluginFuncTest.groovy
+++ b/build-tools-internal/src/integTest/groovy/org/elasticsearch/gradle/internal/InternalDistributionDownloadPluginFuncTest.groovy
@@ -57,7 +57,7 @@ class InternalDistributionDownloadPluginFuncTest extends AbstractGradleFuncTest
 
             elasticsearch_distributions {
               test_distro {
-                  version = "8.0.0"
+                  version = "8.4.0"
                   type = "archive"
                   platform = "linux"
                   architecture = Architecture.current();
@@ -87,7 +87,7 @@ class InternalDistributionDownloadPluginFuncTest extends AbstractGradleFuncTest
 
             elasticsearch_distributions {
               test_distro {
-                  version = "8.0.0"
+                  version = "8.4.0"
                   type = "archive"
                   platform = "linux"
                   architecture = Architecture.current();
diff --git a/build-tools-internal/src/integTest/groovy/org/elasticsearch/gradle/internal/test/rest/LegacyYamlRestCompatTestPluginFuncTest.groovy b/build-tools-internal/src/integTest/groovy/org/elasticsearch/gradle/internal/test/rest/LegacyYamlRestCompatTestPluginFuncTest.groovy
index e3efe3d7ffbf7..15b057a05e039 100644
--- a/build-tools-internal/src/integTest/groovy/org/elasticsearch/gradle/internal/test/rest/LegacyYamlRestCompatTestPluginFuncTest.groovy
+++ b/build-tools-internal/src/integTest/groovy/org/elasticsearch/gradle/internal/test/rest/LegacyYamlRestCompatTestPluginFuncTest.groovy
@@ -40,7 +40,7 @@ class LegacyYamlRestCompatTestPluginFuncTest extends AbstractRestResourcesFuncTe
         given:
         internalBuild()
 
-        subProject(":distribution:bwc:staged") << """
+        subProject(":distribution:bwc:minor") << """
         configurations { checkout }
         artifacts {
             checkout(new File(projectDir, "checkoutDir"))
@@ -61,11 +61,11 @@ class LegacyYamlRestCompatTestPluginFuncTest extends AbstractRestResourcesFuncTe
         result.task(transformTask).outcome == TaskOutcome.NO_SOURCE
     }
 
-    def "yamlRestCompatTest executes and copies api and transforms tests from :bwc:staged"() {
+    def "yamlRestCompatTest executes and copies api and transforms tests from :bwc:minor"() {
         given:
         internalBuild()
 
-        subProject(":distribution:bwc:staged") << """
+        subProject(":distribution:bwc:minor") << """
         configurations { checkout }
         artifacts {
             checkout(new File(projectDir, "checkoutDir"))
@@ -98,8 +98,8 @@ class LegacyYamlRestCompatTestPluginFuncTest extends AbstractRestResourcesFuncTe
         String api = "foo.json"
         String test = "10_basic.yml"
         //add the compatible test and api files, these are the prior version's normal yaml rest tests
-        file("distribution/bwc/staged/checkoutDir/rest-api-spec/src/main/resources/rest-api-spec/api/" + api) << ""
-        file("distribution/bwc/staged/checkoutDir/src/yamlRestTest/resources/rest-api-spec/test/" + test) << ""
+        file("distribution/bwc/minor/checkoutDir/rest-api-spec/src/main/resources/rest-api-spec/api/" + api) << ""
+        file("distribution/bwc/minor/checkoutDir/src/yamlRestTest/resources/rest-api-spec/test/" + test) << ""
 
         when:
         def result = gradleRunner("yamlRestCompatTest").build()
@@ -145,7 +145,7 @@ class LegacyYamlRestCompatTestPluginFuncTest extends AbstractRestResourcesFuncTe
         given:
         internalBuild()
         withVersionCatalogue()
-        subProject(":distribution:bwc:staged") << """
+        subProject(":distribution:bwc:minor") << """
         configurations { checkout }
         artifacts {
             checkout(new File(projectDir, "checkoutDir"))
@@ -186,7 +186,7 @@ class LegacyYamlRestCompatTestPluginFuncTest extends AbstractRestResourcesFuncTe
         given:
         internalBuild()
 
-        subProject(":distribution:bwc:staged") << """
+        subProject(":distribution:bwc:minor") << """
         configurations { checkout }
         artifacts {
             checkout(new File(projectDir, "checkoutDir"))
@@ -230,7 +230,7 @@ class LegacyYamlRestCompatTestPluginFuncTest extends AbstractRestResourcesFuncTe
 
         setupRestResources([], [])
 
-        file("distribution/bwc/staged/checkoutDir/src/yamlRestTest/resources/rest-api-spec/test/test.yml" ) << """
+        file("distribution/bwc/minor/checkoutDir/src/yamlRestTest/resources/rest-api-spec/test/test.yml" ) << """
         "one":
           - do:
               do_.some.key_to_replace:
diff --git a/build-tools-internal/src/integTest/resources/org/elasticsearch/gradle/internal/fake_git/remote/distribution/bwc/bugfix2/build.gradle b/build-tools-internal/src/integTest/resources/org/elasticsearch/gradle/internal/fake_git/remote/distribution/bwc/bugfix2/build.gradle
new file mode 100644
index 0000000000000..e69de29bb2d1d
diff --git a/build-tools-internal/src/integTest/resources/org/elasticsearch/gradle/internal/fake_git/remote/distribution/bwc/maintenance/build.gradle b/build-tools-internal/src/integTest/resources/org/elasticsearch/gradle/internal/fake_git/remote/distribution/bwc/maintenance/build.gradle
new file mode 100644
index 0000000000000..e69de29bb2d1d
diff --git a/build-tools-internal/src/integTest/resources/org/elasticsearch/gradle/internal/fake_git/remote/settings.gradle b/build-tools-internal/src/integTest/resources/org/elasticsearch/gradle/internal/fake_git/remote/settings.gradle
index 8c321294b585f..e931537fcd6e9 100644
--- a/build-tools-internal/src/integTest/resources/org/elasticsearch/gradle/internal/fake_git/remote/settings.gradle
+++ b/build-tools-internal/src/integTest/resources/org/elasticsearch/gradle/internal/fake_git/remote/settings.gradle
@@ -10,9 +10,11 @@
 rootProject.name = "root"
 
 include ":distribution:bwc:bugfix"
+include ":distribution:bwc:bugfix2"
 include ":distribution:bwc:minor"
 include ":distribution:bwc:major"
 include ":distribution:bwc:staged"
+include ":distribution:bwc:maintenance"
 include ":distribution:archives:darwin-tar"
 include ":distribution:archives:oss-darwin-tar"
 include ":distribution:archives:darwin-aarch64-tar"
diff --git a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/BwcVersions.java b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/BwcVersions.java
index 93c2623a23d31..37b28389ad97b 100644
--- a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/BwcVersions.java
+++ b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/BwcVersions.java
@@ -21,14 +21,15 @@
 import java.util.Optional;
 import java.util.Set;
 import java.util.TreeMap;
-import java.util.TreeSet;
 import java.util.function.BiConsumer;
 import java.util.function.Consumer;
 import java.util.function.Predicate;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 
+import static java.util.Collections.reverseOrder;
 import static java.util.Collections.unmodifiableList;
+import static java.util.Comparator.comparing;
 
 /**
  * A container for elasticsearch supported version information used in BWC testing.
@@ -73,11 +74,11 @@ public class BwcVersions implements Serializable {
     private final transient List<Version> versions;
     private final Map<Version, UnreleasedVersionInfo> unreleased;
 
-    public BwcVersions(List<String> versionLines) {
-        this(versionLines, Version.fromString(VersionProperties.getElasticsearch()));
+    public BwcVersions(List<String> versionLines, List<String> developmentBranches) {
+        this(versionLines, Version.fromString(VersionProperties.getElasticsearch()), developmentBranches);
     }
 
-    public BwcVersions(Version currentVersionProperty, List<Version> allVersions) {
+    public BwcVersions(Version currentVersionProperty, List<Version> allVersions, List<String> developmentBranches) {
         if (allVersions.isEmpty()) {
             throw new IllegalArgumentException("Could not parse any versions");
         }
@@ -86,12 +87,12 @@ public BwcVersions(Version currentVersionProperty, List<Version> allVersions) {
         this.currentVersion = allVersions.get(allVersions.size() - 1);
         assertCurrentVersionMatchesParsed(currentVersionProperty);
 
-        this.unreleased = computeUnreleased();
+        this.unreleased = computeUnreleased(developmentBranches);
     }
 
     // Visible for testing
-    BwcVersions(List<String> versionLines, Version currentVersionProperty) {
-        this(currentVersionProperty, parseVersionLines(versionLines));
+    BwcVersions(List<String> versionLines, Version currentVersionProperty, List<String> developmentBranches) {
+        this(currentVersionProperty, parseVersionLines(versionLines), developmentBranches);
     }
 
     private static List<Version> parseVersionLines(List<String> versionLines) {
@@ -126,58 +127,77 @@ public void forPreviousUnreleased(Consumer<UnreleasedVersionInfo> consumer) {
         getUnreleased().stream().filter(version -> version.equals(currentVersion) == false).map(unreleased::get).forEach(consumer);
     }
 
-    private String getBranchFor(Version version) {
-        if (version.equals(currentVersion)) {
-            // Just assume the current branch is 'main'. It's actually not important, we never check out the current branch.
-            return "main";
-        } else {
+    private String getBranchFor(Version version, List<String> developmentBranches) {
+        // If the current version matches a specific feature freeze branch, use that
+        if (developmentBranches.contains(version.getMajor() + "." + version.getMinor())) {
             return version.getMajor() + "." + version.getMinor();
+        } else if (developmentBranches.contains(version.getMajor() + ".x")) { // Otherwise if an n.x branch exists and we are that major
+            return version.getMajor() + ".x";
+        } else { // otherwise we're the main branch
+            return "main";
         }
     }
 
-    private Map<Version, UnreleasedVersionInfo> computeUnreleased() {
-        Set<Version> unreleased = new TreeSet<>();
-        // The current version is being worked, is always unreleased
-        unreleased.add(currentVersion);
-        // Recurse for all unreleased versions starting from the current version
-        addUnreleased(unreleased, currentVersion, 0);
+    private Map<Version, UnreleasedVersionInfo> computeUnreleased(List<String> developmentBranches) {
+        Map<Version, UnreleasedVersionInfo> result = new TreeMap<>();
 
-        // Grab the latest version from the previous major if necessary as well, this is going to be a maintenance release
-        Version maintenance = versions.stream()
-            .filter(v -> v.getMajor() == currentVersion.getMajor() - 1)
-            .max(Comparator.naturalOrder())
-            .orElseThrow();
-        // This is considered the maintenance release only if we haven't yet encountered it
-        boolean hasMaintenanceRelease = unreleased.add(maintenance);
+        // The current version is always in development
+        String currentBranch = getBranchFor(currentVersion, developmentBranches);
+        result.put(currentVersion, new UnreleasedVersionInfo(currentVersion, currentBranch, ":distribution"));
+
+        // Check for an n.x branch as well
+        if (currentBranch.equals("main") && developmentBranches.stream().anyMatch(s -> s.endsWith(".x"))) {
+            // This should correspond to the latest new minor
+            Version version = versions.stream()
+                .sorted(Comparator.reverseOrder())
+                .filter(v -> v.getMajor() == (currentVersion.getMajor() - 1) && v.getRevision() == 0)
+                .findFirst()
+                .orElseThrow(() -> new IllegalStateException("Unable to determine development version for branch"));
+            String branch = getBranchFor(version, developmentBranches);
+            assert branch.equals(currentVersion.getMajor() - 1 + ".x") : "Expected branch does not match development branch";
+
+            result.put(version, new UnreleasedVersionInfo(version, branch, ":distribution:bwc:minor"));
+        }
 
-        List<Version> unreleasedList = unreleased.stream().sorted(Comparator.reverseOrder()).toList();
-        Map<Version, UnreleasedVersionInfo> result = new TreeMap<>();
-        boolean newMinor = false;
-        for (int i = 0; i < unreleasedList.size(); i++) {
-            Version esVersion = unreleasedList.get(i);
-            // This is either a new minor or staged release
-            if (currentVersion.equals(esVersion)) {
-                result.put(esVersion, new UnreleasedVersionInfo(esVersion, getBranchFor(esVersion), ":distribution"));
-            } else if (esVersion.getRevision() == 0) {
-                // If there are two upcoming unreleased minors then this one is the new minor
-                if (newMinor == false && unreleasedList.get(i + 1).getRevision() == 0) {
-                    result.put(esVersion, new UnreleasedVersionInfo(esVersion, esVersion.getMajor() + ".x", ":distribution:bwc:minor"));
-                    newMinor = true;
-                } else if (newMinor == false
-                    && unreleasedList.stream().filter(v -> v.getMajor() == esVersion.getMajor() && v.getRevision() == 0).count() == 1) {
-                        // This is the only unreleased new minor which means we've not yet staged it for release
-                        result.put(esVersion, new UnreleasedVersionInfo(esVersion, esVersion.getMajor() + ".x", ":distribution:bwc:minor"));
-                        newMinor = true;
-                    } else {
-                        result.put(esVersion, new UnreleasedVersionInfo(esVersion, getBranchFor(esVersion), ":distribution:bwc:staged"));
-                    }
-            } else {
-                // If this is the oldest unreleased version and we have a maintenance release
-                if (i == unreleasedList.size() - 1 && hasMaintenanceRelease) {
-                    result.put(esVersion, new UnreleasedVersionInfo(esVersion, getBranchFor(esVersion), ":distribution:bwc:maintenance"));
-                } else {
-                    result.put(esVersion, new UnreleasedVersionInfo(esVersion, getBranchFor(esVersion), ":distribution:bwc:bugfix"));
-                }
+        // Now handle all the feature freeze branches
+        List<String> featureFreezeBranches = developmentBranches.stream()
+            .filter(b -> Pattern.matches("[0-9]+\\.[0-9]+", b))
+            .sorted(reverseOrder(comparing(s -> Version.fromString(s, Version.Mode.RELAXED))))
+            .toList();
+
+        boolean existingBugfix = false;
+        for (int i = 0; i < featureFreezeBranches.size(); i++) {
+            String branch = featureFreezeBranches.get(i);
+            Version version = versions.stream()
+                .sorted(Comparator.reverseOrder())
+                .filter(v -> v.toString().startsWith(branch))
+                .findFirst()
+                .orElse(null);
+
+            // If we don't know about this version we can ignore it
+            if (version == null) {
+                continue;
+            }
+
+            // If this is the current version we can ignore as we've already handled it
+            if (version.equals(currentVersion)) {
+                continue;
+            }
+
+            // We only maintain compatibility back one major so ignore anything older
+            if (currentVersion.getMajor() - version.getMajor() > 1) {
+                continue;
+            }
+
+            // This is the maintenance version
+            if (i == featureFreezeBranches.size() - 1) {
+                result.put(version, new UnreleasedVersionInfo(version, branch, ":distribution:bwc:maintenance"));
+            } else if (version.getRevision() == 0) { // This is the next staged minor
+                result.put(version, new UnreleasedVersionInfo(version, branch, ":distribution:bwc:staged"));
+            } else { // This is a bugfix
+                String project = existingBugfix ? "bugfix2" : "bugfix";
+                result.put(version, new UnreleasedVersionInfo(version, branch, ":distribution:bwc:" + project));
+                existingBugfix = true;
             }
         }
 
diff --git a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/info/GlobalBuildInfoPlugin.java b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/info/GlobalBuildInfoPlugin.java
index 0535026b2594e..27d2a66feb206 100644
--- a/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/info/GlobalBuildInfoPlugin.java
+++ b/build-tools-internal/src/main/java/org/elasticsearch/gradle/internal/info/GlobalBuildInfoPlugin.java
@@ -8,6 +8,9 @@
  */
 package org.elasticsearch.gradle.internal.info;
 
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+
 import org.apache.commons.io.IOUtils;
 import org.elasticsearch.gradle.VersionProperties;
 import org.elasticsearch.gradle.internal.BwcVersions;
@@ -44,11 +47,13 @@
 import java.io.File;
 import java.io.FileInputStream;
 import java.io.IOException;
+import java.io.InputStream;
 import java.io.InputStreamReader;
 import java.io.UncheckedIOException;
 import java.nio.file.Files;
 import java.time.ZoneOffset;
 import java.time.ZonedDateTime;
+import java.util.ArrayList;
 import java.util.List;
 import java.util.Locale;
 import java.util.Random;
@@ -68,6 +73,7 @@ public class GlobalBuildInfoPlugin implements Plugin<Project> {
     private final JavaInstallationRegistry javaInstallationRegistry;
     private final JvmMetadataDetector metadataDetector;
     private final ProviderFactory providers;
+    private final ObjectMapper objectMapper;
     private JavaToolchainService toolChainService;
     private Project project;
 
@@ -82,7 +88,7 @@ public GlobalBuildInfoPlugin(
         this.javaInstallationRegistry = javaInstallationRegistry;
         this.metadataDetector = new ErrorTraceMetadataDetector(metadataDetector);
         this.providers = providers;
-
+        this.objectMapper = new ObjectMapper();
     }
 
     @Override
@@ -190,12 +196,27 @@ private BwcVersions resolveBwcVersions() {
         );
         try (var is = new FileInputStream(versionsFilePath)) {
             List<String> versionLines = IOUtils.readLines(is, "UTF-8");
-            return new BwcVersions(versionLines);
+            return new BwcVersions(versionLines, getDevelopmentBranches());
         } catch (IOException e) {
             throw new IllegalStateException("Unable to resolve to resolve bwc versions from versionsFile.", e);
         }
     }
 
+    private List<String> getDevelopmentBranches() {
+        List<String> branches = new ArrayList<>();
+        File branchesFile = new File(Util.locateElasticsearchWorkspace(project.getGradle()), "branches.json");
+        try (InputStream is = new FileInputStream(branchesFile)) {
+            JsonNode json = objectMapper.readTree(is);
+            for (JsonNode node : json.get("branches")) {
+                branches.add(node.get("branch").asText());
+            }
+        } catch (IOException e) {
+            throw new UncheckedIOException(e);
+        }
+
+        return branches;
+    }
+
     private void logGlobalBuildInfo(BuildParameterExtension buildParams) {
         final String osName = System.getProperty("os.name");
         final String osVersion = System.getProperty("os.version");
diff --git a/build-tools-internal/src/test/groovy/org/elasticsearch/gradle/internal/BwcVersionsSpec.groovy b/build-tools-internal/src/test/groovy/org/elasticsearch/gradle/internal/BwcVersionsSpec.groovy
index 9c7d20d84a670..4d033564a42b4 100644
--- a/build-tools-internal/src/test/groovy/org/elasticsearch/gradle/internal/BwcVersionsSpec.groovy
+++ b/build-tools-internal/src/test/groovy/org/elasticsearch/gradle/internal/BwcVersionsSpec.groovy
@@ -17,8 +17,9 @@ import org.elasticsearch.gradle.internal.BwcVersions.UnreleasedVersionInfo
 class BwcVersionsSpec extends Specification {
     List<String> versionLines = []
 
-    def "current version is next minor with next major and last minor both staged"() {
+    def "current version is next major"() {
         given:
+        addVersion('7.17.10', '8.9.0')
         addVersion('8.14.0', '9.9.0')
         addVersion('8.14.1', '9.9.0')
         addVersion('8.14.2', '9.9.0')
@@ -29,25 +30,25 @@ class BwcVersionsSpec extends Specification {
         addVersion('8.16.1', '9.10.0')
         addVersion('8.17.0', '9.10.0')
         addVersion('9.0.0', '10.0.0')
-        addVersion('9.1.0', '10.1.0')
 
         when:
-        def bwc = new BwcVersions(versionLines, v('9.1.0'))
+        def bwc = new BwcVersions(versionLines, v('9.0.0'), ['main', '8.x', '8.16', '8.15', '7.17'])
         def unreleased = bwc.unreleased.collectEntries { [it, bwc.unreleasedInfo(it)] }
 
         then:
         unreleased == [
+            (v('8.15.2')): new UnreleasedVersionInfo(v('8.15.2'), '8.15', ':distribution:bwc:bugfix2'),
             (v('8.16.1')): new UnreleasedVersionInfo(v('8.16.1'), '8.16', ':distribution:bwc:bugfix'),
-            (v('8.17.0')): new UnreleasedVersionInfo(v('8.17.0'), '8.17', ':distribution:bwc:staged'),
-            (v('9.0.0')): new UnreleasedVersionInfo(v('9.0.0'), '9.x', ':distribution:bwc:minor'),
-            (v('9.1.0')): new UnreleasedVersionInfo(v('9.1.0'), 'main', ':distribution')
+            (v('8.17.0')): new UnreleasedVersionInfo(v('8.17.0'), '8.x', ':distribution:bwc:minor'),
+            (v('9.0.0')): new UnreleasedVersionInfo(v('9.0.0'), 'main', ':distribution'),
         ]
-        bwc.wireCompatible == [v('8.17.0'), v('9.0.0'), v('9.1.0')]
-        bwc.indexCompatible == [v('8.14.0'), v('8.14.1'), v('8.14.2'), v('8.15.0'), v('8.15.1'), v('8.15.2'), v('8.16.0'), v('8.16.1'), v('8.17.0'), v('9.0.0'), v('9.1.0')]
+        bwc.wireCompatible == [v('8.17.0'), v('9.0.0')]
+        bwc.indexCompatible == [v('8.14.0'), v('8.14.1'), v('8.14.2'), v('8.15.0'), v('8.15.1'), v('8.15.2'), v('8.16.0'), v('8.16.1'), v('8.17.0'), v('9.0.0')]
     }
 
-    def "current is next minor with upcoming minor staged"() {
+    def "current version is next major with staged minor"() {
         given:
+        addVersion('7.17.10', '8.9.0')
         addVersion('8.14.0', '9.9.0')
         addVersion('8.14.1', '9.9.0')
         addVersion('8.14.2', '9.9.0')
@@ -57,53 +58,106 @@ class BwcVersionsSpec extends Specification {
         addVersion('8.16.0', '9.10.0')
         addVersion('8.16.1', '9.10.0')
         addVersion('8.17.0', '9.10.0')
-        addVersion('8.17.1', '9.10.0')
+        addVersion('8.18.0', '9.10.0')
         addVersion('9.0.0', '10.0.0')
-        addVersion('9.1.0', '10.1.0')
 
         when:
-        def bwc = new BwcVersions(versionLines, v('9.1.0'))
+        def bwc = new BwcVersions(versionLines, v('9.0.0'), ['main', '8.x', '8.17', '8.16', '8.15', '7.17'])
         def unreleased = bwc.unreleased.collectEntries { [it, bwc.unreleasedInfo(it)] }
 
         then:
         unreleased == [
-            (v('8.17.1')): new UnreleasedVersionInfo(v('8.17.1'), '8.17', ':distribution:bwc:bugfix'),
+            (v('8.15.2')): new UnreleasedVersionInfo(v('8.15.2'), '8.15', ':distribution:bwc:bugfix2'),
+            (v('8.16.1')): new UnreleasedVersionInfo(v('8.16.1'), '8.16', ':distribution:bwc:bugfix'),
+            (v('8.17.0')): new UnreleasedVersionInfo(v('8.17.0'), '8.17', ':distribution:bwc:staged'),
+            (v('8.18.0')): new UnreleasedVersionInfo(v('8.18.0'), '8.x', ':distribution:bwc:minor'),
+            (v('9.0.0')): new UnreleasedVersionInfo(v('9.0.0'), 'main', ':distribution'),
+        ]
+        bwc.wireCompatible == [v('8.18.0'), v('9.0.0')]
+        bwc.indexCompatible == [v('8.14.0'), v('8.14.1'), v('8.14.2'), v('8.15.0'), v('8.15.1'), v('8.15.2'), v('8.16.0'), v('8.16.1'), v('8.17.0'), v('8.18.0'), v('9.0.0')]
+    }
+
+    def "current version is first new minor in major series"() {
+        given:
+        addVersion('7.17.10', '8.9.0')
+        addVersion('8.16.0', '9.10.0')
+        addVersion('8.16.1', '9.10.0')
+        addVersion('8.17.0', '9.10.0')
+        addVersion('8.18.0', '9.10.0')
+        addVersion('9.0.0', '10.0.0')
+        addVersion('9.1.0', '10.0.0')
+
+        when:
+        def bwc = new BwcVersions(versionLines, v('9.1.0'), ['main', '9.0', '8.18'])
+        def unreleased = bwc.unreleased.collectEntries { [it, bwc.unreleasedInfo(it)] }
+
+        then:
+        unreleased == [
+            (v('8.18.0')): new UnreleasedVersionInfo(v('8.18.0'), '8.18', ':distribution:bwc:maintenance'),
             (v('9.0.0')): new UnreleasedVersionInfo(v('9.0.0'), '9.0', ':distribution:bwc:staged'),
-            (v('9.1.0')): new UnreleasedVersionInfo(v('9.1.0'), 'main', ':distribution')
+            (v('9.1.0')): new UnreleasedVersionInfo(v('9.1.0'), 'main', ':distribution'),
         ]
-        bwc.wireCompatible == [v('8.17.0'), v('8.17.1'), v('9.0.0'), v('9.1.0')]
-        bwc.indexCompatible == [v('8.14.0'), v('8.14.1'), v('8.14.2'), v('8.15.0'), v('8.15.1'), v('8.15.2'), v('8.16.0'), v('8.16.1'), v('8.17.0'), v('8.17.1'), v('9.0.0'), v('9.1.0')]
+        bwc.wireCompatible == [v('8.18.0'), v('9.0.0'), v('9.1.0')]
+        bwc.indexCompatible == [v('8.16.0'), v('8.16.1'), v('8.17.0'), v('8.18.0'), v('9.0.0'), v('9.1.0')]
     }
 
-    def "current version is staged major"() {
+    def "current version is new minor with single bugfix"() {
         given:
-        addVersion('8.14.0', '9.9.0')
-        addVersion('8.14.1', '9.9.0')
-        addVersion('8.14.2', '9.9.0')
-        addVersion('8.15.0', '9.9.0')
-        addVersion('8.15.1', '9.9.0')
-        addVersion('8.15.2', '9.9.0')
+        addVersion('7.17.10', '8.9.0')
         addVersion('8.16.0', '9.10.0')
         addVersion('8.16.1', '9.10.0')
         addVersion('8.17.0', '9.10.0')
-        addVersion('8.17.1', '9.10.0')
+        addVersion('8.18.0', '9.10.0')
         addVersion('9.0.0', '10.0.0')
+        addVersion('9.0.1', '10.0.0')
+        addVersion('9.1.0', '10.0.0')
 
         when:
-        def bwc = new BwcVersions(versionLines, v('9.0.0'))
+        def bwc = new BwcVersions(versionLines, v('9.1.0'), ['main', '9.0', '8.18'])
         def unreleased = bwc.unreleased.collectEntries { [it, bwc.unreleasedInfo(it)] }
 
         then:
         unreleased == [
-            (v('8.17.1')): new UnreleasedVersionInfo(v('8.17.1'), '8.17', ':distribution:bwc:bugfix'),
-            (v('9.0.0')): new UnreleasedVersionInfo(v('9.0.0'), 'main', ':distribution'),
+            (v('8.18.0')): new UnreleasedVersionInfo(v('8.18.0'), '8.18', ':distribution:bwc:maintenance'),
+            (v('9.0.1')): new UnreleasedVersionInfo(v('9.0.1'), '9.0', ':distribution:bwc:bugfix'),
+            (v('9.1.0')): new UnreleasedVersionInfo(v('9.1.0'), 'main', ':distribution'),
         ]
-        bwc.wireCompatible == [v('8.17.0'), v('8.17.1'), v('9.0.0')]
-        bwc.indexCompatible == [v('8.14.0'), v('8.14.1'), v('8.14.2'), v('8.15.0'), v('8.15.1'), v('8.15.2'), v('8.16.0'), v('8.16.1'), v('8.17.0'), v('8.17.1'), v('9.0.0')]
+        bwc.wireCompatible == [v('8.18.0'), v('9.0.0'), v('9.0.1'), v('9.1.0')]
+        bwc.indexCompatible == [v('8.16.0'), v('8.16.1'), v('8.17.0'), v('8.18.0'), v('9.0.0'), v('9.0.1'), v('9.1.0')]
     }
 
-    def "current version is major with unreleased next minor"() {
+    def "current version is new minor with single bugfix and staged minor"() {
         given:
+        addVersion('7.17.10', '8.9.0')
+        addVersion('8.16.0', '9.10.0')
+        addVersion('8.16.1', '9.10.0')
+        addVersion('8.17.0', '9.10.0')
+        addVersion('8.18.0', '9.10.0')
+        addVersion('9.0.0', '10.0.0')
+        addVersion('9.0.1', '10.0.0')
+        addVersion('9.1.0', '10.0.0')
+        addVersion('9.2.0', '10.0.0')
+
+        when:
+        def bwc = new BwcVersions(versionLines, v('9.2.0'), ['main', '9.1', '9.0', '8.18'])
+        def unreleased = bwc.unreleased.collectEntries { [it, bwc.unreleasedInfo(it)] }
+
+        then:
+        unreleased == [
+            (v('8.18.0')): new UnreleasedVersionInfo(v('8.18.0'), '8.18', ':distribution:bwc:maintenance'),
+            (v('9.0.1')): new UnreleasedVersionInfo(v('9.0.1'), '9.0', ':distribution:bwc:bugfix'),
+            (v('9.1.0')): new UnreleasedVersionInfo(v('9.1.0'), '9.1', ':distribution:bwc:staged'),
+            (v('9.2.0')): new UnreleasedVersionInfo(v('9.2.0'), 'main', ':distribution'),
+        ]
+        bwc.wireCompatible == [v('8.18.0'), v('9.0.0'), v('9.0.1'), v('9.1.0'), v('9.2.0')]
+        bwc.indexCompatible == [v('8.16.0'), v('8.16.1'), v('8.17.0'), v('8.18.0'), v('9.0.0'), v('9.0.1'), v('9.1.0'), v('9.2.0')]
+    }
+
+    def "current version is next minor"() {
+        given:
+        addVersion('7.16.3', '8.9.0')
+        addVersion('7.17.0', '8.9.0')
+        addVersion('7.17.1', '8.9.0')
         addVersion('8.14.0', '9.9.0')
         addVersion('8.14.1', '9.9.0')
         addVersion('8.14.2', '9.9.0')
@@ -113,24 +167,29 @@ class BwcVersionsSpec extends Specification {
         addVersion('8.16.0', '9.10.0')
         addVersion('8.16.1', '9.10.0')
         addVersion('8.17.0', '9.10.0')
-        addVersion('9.0.0', '10.0.0')
+        addVersion('8.17.1', '9.10.0')
+        addVersion('8.18.0', '9.10.0')
 
         when:
-        def bwc = new BwcVersions(versionLines, v('9.0.0'))
+        def bwc = new BwcVersions(versionLines, v('8.18.0'), ['main', '8.x', '8.17', '8.16', '7.17'])
         def unreleased = bwc.unreleased.collectEntries { [it, bwc.unreleasedInfo(it)] }
 
         then:
         unreleased == [
-            (v('8.16.1')): new UnreleasedVersionInfo(v('8.16.1'), '8.16', ':distribution:bwc:bugfix'),
-            (v('8.17.0')): new UnreleasedVersionInfo(v('8.17.0'), '8.x', ':distribution:bwc:minor'),
-            (v('9.0.0')): new UnreleasedVersionInfo(v('9.0.0'), 'main', ':distribution'),
+            (v('7.17.1')): new UnreleasedVersionInfo(v('7.17.1'), '7.17', ':distribution:bwc:maintenance'),
+            (v('8.16.1')): new UnreleasedVersionInfo(v('8.16.1'), '8.16', ':distribution:bwc:bugfix2'),
+            (v('8.17.1')): new UnreleasedVersionInfo(v('8.17.1'), '8.17', ':distribution:bwc:bugfix'),
+            (v('8.18.0')): new UnreleasedVersionInfo(v('8.18.0'), '8.x', ':distribution'),
         ]
-        bwc.wireCompatible == [v('8.17.0'), v('9.0.0')]
-        bwc.indexCompatible == [v('8.14.0'), v('8.14.1'), v('8.14.2'), v('8.15.0'), v('8.15.1'), v('8.15.2'), v('8.16.0'), v('8.16.1'), v('8.17.0'), v('9.0.0')]
+        bwc.wireCompatible == [v('7.17.0'), v('7.17.1'), v('8.14.0'), v('8.14.1'), v('8.14.2'), v('8.15.0'), v('8.15.1'), v('8.15.2'), v('8.16.0'), v('8.16.1'), v('8.17.0'), v('8.17.1'), v('8.18.0')]
+        bwc.indexCompatible == [v('7.16.3'), v('7.17.0'), v('7.17.1'), v('8.14.0'), v('8.14.1'), v('8.14.2'), v('8.15.0'), v('8.15.1'), v('8.15.2'), v('8.16.0'), v('8.16.1'), v('8.17.0'), v('8.17.1'), v('8.18.0')]
     }
 
-    def "current version is major with staged next minor"() {
+    def "current version is new minor with staged minor"() {
         given:
+        addVersion('7.16.3', '8.9.0')
+        addVersion('7.17.0', '8.9.0')
+        addVersion('7.17.1', '8.9.0')
         addVersion('8.14.0', '9.9.0')
         addVersion('8.14.1', '9.9.0')
         addVersion('8.14.2', '9.9.0')
@@ -138,26 +197,31 @@ class BwcVersionsSpec extends Specification {
         addVersion('8.15.1', '9.9.0')
         addVersion('8.15.2', '9.9.0')
         addVersion('8.16.0', '9.10.0')
+        addVersion('8.16.1', '9.10.0')
         addVersion('8.17.0', '9.10.0')
-        addVersion('9.0.0', '10.0.0')
+        addVersion('8.18.0', '9.10.0')
 
         when:
-        def bwc = new BwcVersions(versionLines, v('9.0.0'))
+        def bwc = new BwcVersions(versionLines, v('8.18.0'), ['main', '8.x', '8.17', '8.16', '8.15', '7.17'])
         def unreleased = bwc.unreleased.collectEntries { [it, bwc.unreleasedInfo(it)] }
 
         then:
         unreleased == [
-            (v('8.15.2')): new UnreleasedVersionInfo(v('8.15.2'), '8.15', ':distribution:bwc:bugfix'),
-            (v('8.16.0')): new UnreleasedVersionInfo(v('8.16.0'), '8.16', ':distribution:bwc:staged'),
-            (v('8.17.0')): new UnreleasedVersionInfo(v('8.17.0'), '8.x', ':distribution:bwc:minor'),
-            (v('9.0.0')): new UnreleasedVersionInfo(v('9.0.0'), 'main', ':distribution'),
+            (v('7.17.1')): new UnreleasedVersionInfo(v('7.17.1'), '7.17', ':distribution:bwc:maintenance'),
+            (v('8.15.2')): new UnreleasedVersionInfo(v('8.15.2'), '8.15', ':distribution:bwc:bugfix2'),
+            (v('8.16.1')): new UnreleasedVersionInfo(v('8.16.1'), '8.16', ':distribution:bwc:bugfix'),
+            (v('8.17.0')): new UnreleasedVersionInfo(v('8.17.0'), '8.17', ':distribution:bwc:staged'),
+            (v('8.18.0')): new UnreleasedVersionInfo(v('8.18.0'), '8.x', ':distribution'),
         ]
-        bwc.wireCompatible == [v('8.17.0'), v('9.0.0')]
-        bwc.indexCompatible == [v('8.14.0'), v('8.14.1'), v('8.14.2'), v('8.15.0'), v('8.15.1'), v('8.15.2'), v('8.16.0'), v('8.17.0'), v('9.0.0')]
+        bwc.wireCompatible == [v('7.17.0'), v('7.17.1'), v('8.14.0'), v('8.14.1'), v('8.14.2'), v('8.15.0'), v('8.15.1'), v('8.15.2'), v('8.16.0'), v('8.16.1'), v('8.17.0'), v('8.18.0')]
+        bwc.indexCompatible == [v('7.16.3'), v('7.17.0'), v('7.17.1'), v('8.14.0'), v('8.14.1'), v('8.14.2'), v('8.15.0'), v('8.15.1'), v('8.15.2'), v('8.16.0'), v('8.16.1'), v('8.17.0'), v('8.18.0')]
     }
 
-    def "current version is next bugfix"() {
+    def "current version is first bugfix"() {
         given:
+        addVersion('7.16.3', '8.9.0')
+        addVersion('7.17.0', '8.9.0')
+        addVersion('7.17.1', '8.9.0')
         addVersion('8.14.0', '9.9.0')
         addVersion('8.14.1', '9.9.0')
         addVersion('8.14.2', '9.9.0')
@@ -166,52 +230,44 @@ class BwcVersionsSpec extends Specification {
         addVersion('8.15.2', '9.9.0')
         addVersion('8.16.0', '9.10.0')
         addVersion('8.16.1', '9.10.0')
-        addVersion('8.17.0', '9.10.0')
-        addVersion('8.17.1', '9.10.0')
-        addVersion('9.0.0', '10.0.0')
-        addVersion('9.0.1', '10.0.0')
 
         when:
-        def bwc = new BwcVersions(versionLines, v('9.0.1'))
+        def bwc = new BwcVersions(versionLines, v('8.16.1'), ['main', '8.x', '8.17', '8.16', '8.15', '7.17'])
         def unreleased = bwc.unreleased.collectEntries { [it, bwc.unreleasedInfo(it)] }
 
         then:
         unreleased == [
-            (v('8.17.1')): new UnreleasedVersionInfo(v('8.17.1'), '8.17', ':distribution:bwc:maintenance'),
-            (v('9.0.1')): new UnreleasedVersionInfo(v('9.0.1'), 'main', ':distribution'),
+            (v('7.17.1')): new UnreleasedVersionInfo(v('7.17.1'), '7.17', ':distribution:bwc:maintenance'),
+            (v('8.15.2')): new UnreleasedVersionInfo(v('8.15.2'), '8.15', ':distribution:bwc:bugfix'),
+            (v('8.16.1')): new UnreleasedVersionInfo(v('8.16.1'), '8.16', ':distribution'),
         ]
-        bwc.wireCompatible == [v('8.17.0'), v('8.17.1'), v('9.0.0'), v('9.0.1')]
-        bwc.indexCompatible == [v('8.14.0'), v('8.14.1'), v('8.14.2'), v('8.15.0'), v('8.15.1'), v('8.15.2'), v('8.16.0'), v('8.16.1'), v('8.17.0'), v('8.17.1'), v('9.0.0'), v('9.0.1')]
+        bwc.wireCompatible == [v('7.17.0'), v('7.17.1'), v('8.14.0'), v('8.14.1'), v('8.14.2'), v('8.15.0'), v('8.15.1'), v('8.15.2'), v('8.16.0'), v('8.16.1')]
+        bwc.indexCompatible == [v('7.16.3'), v('7.17.0'), v('7.17.1'), v('8.14.0'), v('8.14.1'), v('8.14.2'), v('8.15.0'), v('8.15.1'), v('8.15.2'), v('8.16.0'), v('8.16.1')]
     }
 
-    def "current version is next minor with no staged releases"() {
+    def "current version is second bugfix"() {
         given:
+        addVersion('7.16.3', '8.9.0')
+        addVersion('7.17.0', '8.9.0')
+        addVersion('7.17.1', '8.9.0')
         addVersion('8.14.0', '9.9.0')
         addVersion('8.14.1', '9.9.0')
         addVersion('8.14.2', '9.9.0')
         addVersion('8.15.0', '9.9.0')
         addVersion('8.15.1', '9.9.0')
         addVersion('8.15.2', '9.9.0')
-        addVersion('8.16.0', '9.10.0')
-        addVersion('8.16.1', '9.10.0')
-        addVersion('8.17.0', '9.10.0')
-        addVersion('8.17.1', '9.10.0')
-        addVersion('9.0.0', '10.0.0')
-        addVersion('9.0.1', '10.0.0')
-        addVersion('9.1.0', '10.1.0')
 
         when:
-        def bwc = new BwcVersions(versionLines, v('9.1.0'))
+        def bwc = new BwcVersions(versionLines, v('8.15.2'), ['main', '8.x', '8.17', '8.16', '8.15', '7.17'])
         def unreleased = bwc.unreleased.collectEntries { [it, bwc.unreleasedInfo(it)] }
 
         then:
         unreleased == [
-            (v('8.17.1')): new UnreleasedVersionInfo(v('8.17.1'), '8.17', ':distribution:bwc:maintenance'),
-            (v('9.0.1')): new UnreleasedVersionInfo(v('9.0.1'), '9.0', ':distribution:bwc:bugfix'),
-            (v('9.1.0')): new UnreleasedVersionInfo(v('9.1.0'), 'main', ':distribution')
+            (v('7.17.1')): new UnreleasedVersionInfo(v('7.17.1'), '7.17', ':distribution:bwc:maintenance'),
+            (v('8.15.2')): new UnreleasedVersionInfo(v('8.15.2'), '8.15', ':distribution'),
         ]
-        bwc.wireCompatible == [v('8.17.0'), v('8.17.1'), v('9.0.0'), v('9.0.1'), v('9.1.0')]
-        bwc.indexCompatible == [v('8.14.0'), v('8.14.1'), v('8.14.2'), v('8.15.0'), v('8.15.1'), v('8.15.2'), v('8.16.0'), v('8.16.1'), v('8.17.0'), v('8.17.1'), v('9.0.0'), v('9.0.1'), v('9.1.0')]
+        bwc.wireCompatible == [v('7.17.0'), v('7.17.1'), v('8.14.0'), v('8.14.1'), v('8.14.2'), v('8.15.0'), v('8.15.1'), v('8.15.2')]
+        bwc.indexCompatible == [v('7.16.3'), v('7.17.0'), v('7.17.1'), v('8.14.0'), v('8.14.1'), v('8.14.2'), v('8.15.0'), v('8.15.1'), v('8.15.2')]
     }
 
     private void addVersion(String elasticsearch, String lucene) {
diff --git a/build-tools-internal/src/test/java/org/elasticsearch/gradle/AbstractDistributionDownloadPluginTests.java b/build-tools-internal/src/test/java/org/elasticsearch/gradle/AbstractDistributionDownloadPluginTests.java
index 639dec280ae9a..7512fa20814c6 100644
--- a/build-tools-internal/src/test/java/org/elasticsearch/gradle/AbstractDistributionDownloadPluginTests.java
+++ b/build-tools-internal/src/test/java/org/elasticsearch/gradle/AbstractDistributionDownloadPluginTests.java
@@ -16,6 +16,7 @@
 
 import java.io.File;
 import java.util.Arrays;
+import java.util.List;
 
 public class AbstractDistributionDownloadPluginTests {
     protected static Project rootProject;
@@ -28,22 +29,27 @@ public class AbstractDistributionDownloadPluginTests {
     protected static final Version BWC_STAGED_VERSION = Version.fromString("1.0.0");
     protected static final Version BWC_BUGFIX_VERSION = Version.fromString("1.0.1");
     protected static final Version BWC_MAINTENANCE_VERSION = Version.fromString("0.90.1");
+    protected static final List<String> DEVELOPMENT_BRANCHES = Arrays.asList("main", "1.1", "1.0", "0.90");
 
     protected static final BwcVersions BWC_MINOR = new BwcVersions(
         BWC_MAJOR_VERSION,
-        Arrays.asList(BWC_BUGFIX_VERSION, BWC_MINOR_VERSION, BWC_MAJOR_VERSION)
+        Arrays.asList(BWC_BUGFIX_VERSION, BWC_MINOR_VERSION, BWC_MAJOR_VERSION),
+        DEVELOPMENT_BRANCHES
     );
     protected static final BwcVersions BWC_STAGED = new BwcVersions(
         BWC_MAJOR_VERSION,
-        Arrays.asList(BWC_MAINTENANCE_VERSION, BWC_STAGED_VERSION, BWC_MINOR_VERSION, BWC_MAJOR_VERSION)
+        Arrays.asList(BWC_MAINTENANCE_VERSION, BWC_STAGED_VERSION, BWC_MINOR_VERSION, BWC_MAJOR_VERSION),
+        DEVELOPMENT_BRANCHES
     );
     protected static final BwcVersions BWC_BUGFIX = new BwcVersions(
         BWC_MAJOR_VERSION,
-        Arrays.asList(BWC_BUGFIX_VERSION, BWC_MINOR_VERSION, BWC_MAJOR_VERSION)
+        Arrays.asList(BWC_BUGFIX_VERSION, BWC_MINOR_VERSION, BWC_MAJOR_VERSION),
+        DEVELOPMENT_BRANCHES
     );
     protected static final BwcVersions BWC_MAINTENANCE = new BwcVersions(
         BWC_MINOR_VERSION,
-        Arrays.asList(BWC_MAINTENANCE_VERSION, BWC_BUGFIX_VERSION, BWC_MINOR_VERSION)
+        Arrays.asList(BWC_MAINTENANCE_VERSION, BWC_BUGFIX_VERSION, BWC_MINOR_VERSION),
+        DEVELOPMENT_BRANCHES
     );
 
     protected static String projectName(String base, boolean bundledJdk) {
diff --git a/build-tools/src/testFixtures/groovy/org/elasticsearch/gradle/fixtures/AbstractGradleFuncTest.groovy b/build-tools/src/testFixtures/groovy/org/elasticsearch/gradle/fixtures/AbstractGradleFuncTest.groovy
index f3f8e4703eba2..07214b5fbf845 100644
--- a/build-tools/src/testFixtures/groovy/org/elasticsearch/gradle/fixtures/AbstractGradleFuncTest.groovy
+++ b/build-tools/src/testFixtures/groovy/org/elasticsearch/gradle/fixtures/AbstractGradleFuncTest.groovy
@@ -156,12 +156,12 @@ abstract class AbstractGradleFuncTest extends Specification {
 
     File internalBuild(
             List<String> extraPlugins = [],
-            String bugfix = "7.15.2",
-            String bugfixLucene = "8.9.0",
-            String staged = "7.16.0",
-            String stagedLucene = "8.10.0",
-            String minor = "8.0.0",
-            String minorLucene = "9.0.0"
+            String maintenance = "7.16.10",
+            String bugfix2 = "8.1.3",
+            String bugfix = "8.2.1",
+            String staged = "8.3.0",
+            String minor = "8.4.0",
+            String current = "9.0.0"
     ) {
         buildFile << """plugins {
           id 'elasticsearch.global-build-info'
@@ -172,15 +172,17 @@ abstract class AbstractGradleFuncTest extends Specification {
         import org.elasticsearch.gradle.internal.BwcVersions
         import org.elasticsearch.gradle.Version
 
-        Version currentVersion = Version.fromString("8.1.0")
+        Version currentVersion = Version.fromString("${current}")
         def versionList = [
+          Version.fromString("$maintenance"),
+          Version.fromString("$bugfix2"),
           Version.fromString("$bugfix"),
           Version.fromString("$staged"),
           Version.fromString("$minor"),
           currentVersion
         ]
 
-        BwcVersions versions = new BwcVersions(currentVersion, versionList)
+        BwcVersions versions = new BwcVersions(currentVersion, versionList, ['main', '8.x', '8.3', '8.2', '8.1', '7.16'])
         buildParams.getBwcVersionsProperty().set(versions)
         """
     }
diff --git a/distribution/bwc/bugfix2/build.gradle b/distribution/bwc/bugfix2/build.gradle
new file mode 100644
index 0000000000000..e69de29bb2d1d
diff --git a/settings.gradle b/settings.gradle
index 4722fc311480a..747fbb3e439fe 100644
--- a/settings.gradle
+++ b/settings.gradle
@@ -73,6 +73,7 @@ List projects = [
   'distribution:packages:aarch64-rpm',
   'distribution:packages:rpm',
   'distribution:bwc:bugfix',
+  'distribution:bwc:bugfix2',
   'distribution:bwc:maintenance',
   'distribution:bwc:minor',
   'distribution:bwc:staged',

From 584918e39d5f436a20f010163a3ae44fa99046ca Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Thu, 5 Dec 2024 20:27:42 +0100
Subject: [PATCH 059/119] Save duplicate REST client in ESRestTestCase
 (#117910)

I debugged some tests today and noticed that these two clients
are the same in almost all cases, no need to use extra connections.
Might give usa small speedup for these tests that tend to be quite slow
relative to the node client based tests.
---
 .../java/org/elasticsearch/test/rest/ESRestTestCase.java   | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
index b4f4243fb90fd..4428afaaeabe5 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/rest/ESRestTestCase.java
@@ -333,8 +333,11 @@ public void initClient() throws IOException {
             assert testFeatureServiceInitialized() == false;
             clusterHosts = parseClusterHosts(getTestRestCluster());
             logger.info("initializing REST clients against {}", clusterHosts);
-            client = buildClient(restClientSettings(), clusterHosts.toArray(new HttpHost[clusterHosts.size()]));
-            adminClient = buildClient(restAdminSettings(), clusterHosts.toArray(new HttpHost[clusterHosts.size()]));
+            var clientSettings = restClientSettings();
+            var adminSettings = restAdminSettings();
+            var hosts = clusterHosts.toArray(new HttpHost[0]);
+            client = buildClient(clientSettings, hosts);
+            adminClient = clientSettings.equals(adminSettings) ? client : buildClient(adminSettings, hosts);
 
             availableFeatures = EnumSet.of(ProductFeature.LEGACY_TEMPLATES);
             Set<String> versions = new HashSet<>();

From fd81c5111878d4cdbbf299976377a3fffd41cb29 Mon Sep 17 00:00:00 2001
From: Sam Xiao <sam.xiao@elastic.co>
Date: Thu, 5 Dec 2024 14:32:25 -0500
Subject: [PATCH 060/119] Unmute BWC tests FullClusterRestartIT (#118038)

---
 muted-tests.yml | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index a09e46415fdc1..ee5e3dd42236d 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -2,12 +2,6 @@ tests:
 - class: "org.elasticsearch.client.RestClientSingleHostIntegTests"
   issue: "https://github.com/elastic/elasticsearch/issues/102717"
   method: "testRequestResetAndAbort"
-- class: org.elasticsearch.xpack.restart.FullClusterRestartIT
-  method: testSingleDoc {cluster=UPGRADED}
-  issue: https://github.com/elastic/elasticsearch/issues/111434
-- class: org.elasticsearch.xpack.restart.FullClusterRestartIT
-  method: testDataStreams {cluster=UPGRADED}
-  issue: https://github.com/elastic/elasticsearch/issues/111448
 - class: org.elasticsearch.smoketest.WatcherYamlRestIT
   method: test {p0=watcher/usage/10_basic/Test watcher usage stats output}
   issue: https://github.com/elastic/elasticsearch/issues/112189

From 62d94f2920d4e315bcd2867b791022e8a4c33b9f Mon Sep 17 00:00:00 2001
From: Mark Vieira <portugee@gmail.com>
Date: Thu, 5 Dec 2024 13:41:43 -0800
Subject: [PATCH 061/119] Remove released vs unreleased distinction from
 VersionUtils (#118108)

---
 .../java/org/elasticsearch/VersionTests.java  |  41 +--
 test/framework/build.gradle                   |   1 -
 .../org/elasticsearch/test/VersionUtils.java  | 139 +--------
 .../elasticsearch/test/VersionUtilsTests.java | 273 ++----------------
 4 files changed, 30 insertions(+), 424 deletions(-)

diff --git a/server/src/test/java/org/elasticsearch/VersionTests.java b/server/src/test/java/org/elasticsearch/VersionTests.java
index 0b35a3cc23c16..5e10a7d37aea1 100644
--- a/server/src/test/java/org/elasticsearch/VersionTests.java
+++ b/server/src/test/java/org/elasticsearch/VersionTests.java
@@ -179,8 +179,7 @@ public void testParseVersion() {
     }
 
     public void testAllVersionsMatchId() throws Exception {
-        final Set<Version> releasedVersions = new HashSet<>(VersionUtils.allReleasedVersions());
-        final Set<Version> unreleasedVersions = new HashSet<>(VersionUtils.allUnreleasedVersions());
+        final Set<Version> versions = new HashSet<>(VersionUtils.allVersions());
         Map<String, Version> maxBranchVersions = new HashMap<>();
         for (java.lang.reflect.Field field : Version.class.getFields()) {
             if (field.getName().matches("_ID")) {
@@ -195,43 +194,15 @@ public void testAllVersionsMatchId() throws Exception {
 
                 Version v = (Version) versionConstant.get(null);
                 logger.debug("Checking {}", v);
-                if (field.getName().endsWith("_UNRELEASED")) {
-                    assertTrue(unreleasedVersions.contains(v));
-                } else {
-                    assertTrue(releasedVersions.contains(v));
-                }
+                assertTrue(versions.contains(v));
                 assertEquals("Version id " + field.getName() + " does not point to " + constantName, v, Version.fromId(versionId));
                 assertEquals("Version " + constantName + " does not have correct id", versionId, v.id);
                 String number = v.toString();
                 assertEquals("V_" + number.replace('.', '_'), constantName);
-
-                // only the latest version for a branch should be a snapshot (ie unreleased)
-                String branchName = "" + v.major + "." + v.minor;
-                Version maxBranchVersion = maxBranchVersions.get(branchName);
-                if (maxBranchVersion == null) {
-                    maxBranchVersions.put(branchName, v);
-                } else if (v.after(maxBranchVersion)) {
-                    if (v == Version.CURRENT) {
-                        // Current is weird - it counts as released even though it shouldn't.
-                        continue;
-                    }
-                    assertFalse(
-                        "Version " + maxBranchVersion + " cannot be a snapshot because version " + v + " exists",
-                        VersionUtils.allUnreleasedVersions().contains(maxBranchVersion)
-                    );
-                    maxBranchVersions.put(branchName, v);
-                }
             }
         }
     }
 
-    public static void assertUnknownVersion(Version version) {
-        assertFalse(
-            "Version " + version + " has been releaed don't use a new instance of this version",
-            VersionUtils.allReleasedVersions().contains(version)
-        );
-    }
-
     public void testIsCompatible() {
         assertTrue(isCompatible(Version.CURRENT, Version.CURRENT.minimumCompatibilityVersion()));
         assertFalse(isCompatible(Version.V_7_0_0, Version.V_8_0_0));
@@ -279,14 +250,6 @@ public boolean isCompatible(Version left, Version right) {
         return result;
     }
 
-    // This exists because 5.1.0 was never released due to a mistake in the release process.
-    // This verifies that we never declare the version as "released" accidentally.
-    // It would never pass qa tests later on, but those come very far in the build and this is quick to check now.
-    public void testUnreleasedVersion() {
-        Version VERSION_5_1_0_UNRELEASED = Version.fromString("5.1.0");
-        VersionTests.assertUnknownVersion(VERSION_5_1_0_UNRELEASED);
-    }
-
     public void testIllegalMinorAndPatchNumbers() {
         IllegalArgumentException e = expectThrows(IllegalArgumentException.class, () -> Version.fromString("8.2.999"));
         assertThat(
diff --git a/test/framework/build.gradle b/test/framework/build.gradle
index 126b95041da11..c7e08eb3cdfa9 100644
--- a/test/framework/build.gradle
+++ b/test/framework/build.gradle
@@ -86,7 +86,6 @@ tasks.named("thirdPartyAudit").configure {
 tasks.named("test").configure {
   systemProperty 'tests.gradle_index_compat_versions', buildParams.bwcVersions.indexCompatible.join(',')
   systemProperty 'tests.gradle_wire_compat_versions', buildParams.bwcVersions.wireCompatible.join(',')
-  systemProperty 'tests.gradle_unreleased_versions', buildParams.bwcVersions.unreleased.join(',')
 }
 
 tasks.register("integTest", Test) {
diff --git a/test/framework/src/main/java/org/elasticsearch/test/VersionUtils.java b/test/framework/src/main/java/org/elasticsearch/test/VersionUtils.java
index d561c5512b614..8b7ab620774b9 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/VersionUtils.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/VersionUtils.java
@@ -12,132 +12,15 @@
 import org.elasticsearch.Build;
 import org.elasticsearch.Version;
 import org.elasticsearch.core.Nullable;
-import org.elasticsearch.core.Tuple;
 
-import java.util.ArrayList;
-import java.util.Collections;
 import java.util.List;
-import java.util.Map;
 import java.util.Optional;
 import java.util.Random;
-import java.util.stream.Collectors;
-import java.util.stream.Stream;
 
 /** Utilities for selecting versions in tests */
 public class VersionUtils {
 
-    /**
-     * Sort versions that have backwards compatibility guarantees from
-     * those that don't. Doesn't actually check whether or not the versions
-     * are released, instead it relies on gradle to have already checked
-     * this which it does in {@code :core:verifyVersions}. So long as the
-     * rules here match up with the rules in gradle then this should
-     * produce sensible results.
-     * @return a tuple containing versions with backwards compatibility
-     * guarantees in v1 and versions without the guranteees in v2
-     */
-    static Tuple<List<Version>, List<Version>> resolveReleasedVersions(Version current, Class<?> versionClass) {
-        // group versions into major version
-        Map<Integer, List<Version>> majorVersions = Version.getDeclaredVersions(versionClass)
-            .stream()
-            .collect(Collectors.groupingBy(v -> (int) v.major));
-        // this breaks b/c 5.x is still in version list but master doesn't care about it!
-        // assert majorVersions.size() == 2;
-        // TODO: remove oldVersions, we should only ever have 2 majors in Version
-        List<List<Version>> oldVersions = splitByMinor(majorVersions.getOrDefault((int) current.major - 2, Collections.emptyList()));
-        List<List<Version>> previousMajor = splitByMinor(majorVersions.get((int) current.major - 1));
-        List<List<Version>> currentMajor = splitByMinor(majorVersions.get((int) current.major));
-
-        List<Version> unreleasedVersions = new ArrayList<>();
-        final List<List<Version>> stableVersions;
-        if (currentMajor.size() == 1) {
-            // on master branch
-            stableVersions = previousMajor;
-            // remove current
-            moveLastToUnreleased(currentMajor, unreleasedVersions);
-        } else {
-            // on a stable or release branch, ie N.x
-            stableVersions = currentMajor;
-            // remove the next maintenance bugfix
-            moveLastToUnreleased(previousMajor, unreleasedVersions);
-        }
-
-        // remove next minor
-        Version lastMinor = moveLastToUnreleased(stableVersions, unreleasedVersions);
-        if (lastMinor.revision == 0) {
-            if (stableVersions.get(stableVersions.size() - 1).size() == 1) {
-                // a minor is being staged, which is also unreleased
-                moveLastToUnreleased(stableVersions, unreleasedVersions);
-            }
-            // remove the next bugfix
-            if (stableVersions.isEmpty() == false) {
-                moveLastToUnreleased(stableVersions, unreleasedVersions);
-            }
-        }
-
-        // If none of the previous major was released, then the last minor and bugfix of the old version was not released either.
-        if (previousMajor.isEmpty()) {
-            assert currentMajor.isEmpty() : currentMajor;
-            // minor of the old version is being staged
-            moveLastToUnreleased(oldVersions, unreleasedVersions);
-            // bugix of the old version is also being staged
-            moveLastToUnreleased(oldVersions, unreleasedVersions);
-        }
-        List<Version> releasedVersions = Stream.of(oldVersions, previousMajor, currentMajor)
-            .flatMap(List::stream)
-            .flatMap(List::stream)
-            .collect(Collectors.toList());
-        Collections.sort(unreleasedVersions); // we add unreleased out of order, so need to sort here
-        return new Tuple<>(Collections.unmodifiableList(releasedVersions), Collections.unmodifiableList(unreleasedVersions));
-    }
-
-    // split the given versions into sub lists grouped by minor version
-    private static List<List<Version>> splitByMinor(List<Version> versions) {
-        Map<Integer, List<Version>> byMinor = versions.stream().collect(Collectors.groupingBy(v -> (int) v.minor));
-        return byMinor.entrySet().stream().sorted(Map.Entry.comparingByKey()).map(Map.Entry::getValue).collect(Collectors.toList());
-    }
-
-    // move the last version of the last minor in versions to the unreleased versions
-    private static Version moveLastToUnreleased(List<List<Version>> versions, List<Version> unreleasedVersions) {
-        List<Version> lastMinor = new ArrayList<>(versions.get(versions.size() - 1));
-        Version lastVersion = lastMinor.remove(lastMinor.size() - 1);
-        if (lastMinor.isEmpty()) {
-            versions.remove(versions.size() - 1);
-        } else {
-            versions.set(versions.size() - 1, lastMinor);
-        }
-        unreleasedVersions.add(lastVersion);
-        return lastVersion;
-    }
-
-    private static final List<Version> RELEASED_VERSIONS;
-    private static final List<Version> UNRELEASED_VERSIONS;
-    private static final List<Version> ALL_VERSIONS;
-
-    static {
-        Tuple<List<Version>, List<Version>> versions = resolveReleasedVersions(Version.CURRENT, Version.class);
-        RELEASED_VERSIONS = versions.v1();
-        UNRELEASED_VERSIONS = versions.v2();
-        List<Version> allVersions = new ArrayList<>(RELEASED_VERSIONS.size() + UNRELEASED_VERSIONS.size());
-        allVersions.addAll(RELEASED_VERSIONS);
-        allVersions.addAll(UNRELEASED_VERSIONS);
-        Collections.sort(allVersions);
-        ALL_VERSIONS = Collections.unmodifiableList(allVersions);
-    }
-
-    /**
-     * Returns an immutable, sorted list containing all released versions.
-     */
-    public static List<Version> allReleasedVersions() {
-        return RELEASED_VERSIONS;
-    }
-
-    /**
-     * Returns an immutable, sorted list containing all unreleased versions.
-     */
-    public static List<Version> allUnreleasedVersions() {
-        return UNRELEASED_VERSIONS;
-    }
+    private static final List<Version> ALL_VERSIONS = Version.getDeclaredVersions(Version.class);
 
     /**
      * Returns an immutable, sorted list containing all versions, both released and unreleased.
@@ -147,16 +30,16 @@ public static List<Version> allVersions() {
     }
 
     /**
-     * Get the released version before {@code version}.
+     * Get the version before {@code version}.
      */
     public static Version getPreviousVersion(Version version) {
-        for (int i = RELEASED_VERSIONS.size() - 1; i >= 0; i--) {
-            Version v = RELEASED_VERSIONS.get(i);
+        for (int i = ALL_VERSIONS.size() - 1; i >= 0; i--) {
+            Version v = ALL_VERSIONS.get(i);
             if (v.before(version)) {
                 return v;
             }
         }
-        throw new IllegalArgumentException("couldn't find any released versions before [" + version + "]");
+        throw new IllegalArgumentException("couldn't find any versions before [" + version + "]");
     }
 
     /**
@@ -169,22 +52,22 @@ public static Version getPreviousVersion() {
     }
 
     /**
-     * Returns the released {@link Version} before the {@link Version#CURRENT}
+     * Returns the {@link Version} before the {@link Version#CURRENT}
      * where the minor version is less than the currents minor version.
      */
     public static Version getPreviousMinorVersion() {
-        for (int i = RELEASED_VERSIONS.size() - 1; i >= 0; i--) {
-            Version v = RELEASED_VERSIONS.get(i);
+        for (int i = ALL_VERSIONS.size() - 1; i >= 0; i--) {
+            Version v = ALL_VERSIONS.get(i);
             if (v.minor < Version.CURRENT.minor || v.major < Version.CURRENT.major) {
                 return v;
             }
         }
-        throw new IllegalArgumentException("couldn't find any released versions of the minor before [" + Build.current().version() + "]");
+        throw new IllegalArgumentException("couldn't find any versions of the minor before [" + Build.current().version() + "]");
     }
 
-    /** Returns the oldest released {@link Version} */
+    /** Returns the oldest {@link Version} */
     public static Version getFirstVersion() {
-        return RELEASED_VERSIONS.get(0);
+        return ALL_VERSIONS.get(0);
     }
 
     /** Returns a random {@link Version} from all available versions. */
diff --git a/test/framework/src/test/java/org/elasticsearch/test/VersionUtilsTests.java b/test/framework/src/test/java/org/elasticsearch/test/VersionUtilsTests.java
index e0013e06f3248..5ae7e5640fc91 100644
--- a/test/framework/src/test/java/org/elasticsearch/test/VersionUtilsTests.java
+++ b/test/framework/src/test/java/org/elasticsearch/test/VersionUtilsTests.java
@@ -9,19 +9,11 @@
 package org.elasticsearch.test;
 
 import org.elasticsearch.Version;
-import org.elasticsearch.core.Booleans;
-import org.elasticsearch.core.Tuple;
 
 import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.HashSet;
 import java.util.List;
-import java.util.Set;
 
 import static org.elasticsearch.Version.fromId;
-import static org.hamcrest.Matchers.equalTo;
-import static org.hamcrest.Matchers.greaterThanOrEqualTo;
-import static org.hamcrest.Matchers.lessThanOrEqualTo;
 
 /**
  * Tests VersionUtils. Note: this test should remain unchanged across major versions
@@ -30,7 +22,7 @@
 public class VersionUtilsTests extends ESTestCase {
 
     public void testAllVersionsSorted() {
-        List<Version> allVersions = VersionUtils.allReleasedVersions();
+        List<Version> allVersions = VersionUtils.allVersions();
         for (int i = 0, j = 1; j < allVersions.size(); ++i, ++j) {
             assertTrue(allVersions.get(i).before(allVersions.get(j)));
         }
@@ -58,9 +50,9 @@ public void testRandomVersionBetween() {
         got = VersionUtils.randomVersionBetween(random(), null, fromId(7000099));
         assertTrue(got.onOrAfter(VersionUtils.getFirstVersion()));
         assertTrue(got.onOrBefore(fromId(7000099)));
-        got = VersionUtils.randomVersionBetween(random(), null, VersionUtils.allReleasedVersions().get(0));
+        got = VersionUtils.randomVersionBetween(random(), null, VersionUtils.allVersions().get(0));
         assertTrue(got.onOrAfter(VersionUtils.getFirstVersion()));
-        assertTrue(got.onOrBefore(VersionUtils.allReleasedVersions().get(0)));
+        assertTrue(got.onOrBefore(VersionUtils.allVersions().get(0)));
 
         // unbounded upper
         got = VersionUtils.randomVersionBetween(random(), VersionUtils.getFirstVersion(), null);
@@ -83,265 +75,34 @@ public void testRandomVersionBetween() {
         assertEquals(got, VersionUtils.getFirstVersion());
         got = VersionUtils.randomVersionBetween(random(), Version.CURRENT, null);
         assertEquals(got, Version.CURRENT);
-
-        if (Booleans.parseBoolean(System.getProperty("build.snapshot", "true"))) {
-            // max or min can be an unreleased version
-            final Version unreleased = randomFrom(VersionUtils.allUnreleasedVersions());
-            assertThat(VersionUtils.randomVersionBetween(random(), null, unreleased), lessThanOrEqualTo(unreleased));
-            assertThat(VersionUtils.randomVersionBetween(random(), unreleased, null), greaterThanOrEqualTo(unreleased));
-            assertEquals(unreleased, VersionUtils.randomVersionBetween(random(), unreleased, unreleased));
-        }
-    }
-
-    public static class TestReleaseBranch {
-        public static final Version V_4_0_0 = Version.fromString("4.0.0");
-        public static final Version V_4_0_1 = Version.fromString("4.0.1");
-        public static final Version V_5_3_0 = Version.fromString("5.3.0");
-        public static final Version V_5_3_1 = Version.fromString("5.3.1");
-        public static final Version V_5_3_2 = Version.fromString("5.3.2");
-        public static final Version V_5_4_0 = Version.fromString("5.4.0");
-        public static final Version V_5_4_1 = Version.fromString("5.4.1");
-        public static final Version CURRENT = V_5_4_1;
-    }
-
-    public void testResolveReleasedVersionsForReleaseBranch() {
-        Tuple<List<Version>, List<Version>> t = VersionUtils.resolveReleasedVersions(TestReleaseBranch.CURRENT, TestReleaseBranch.class);
-        List<Version> released = t.v1();
-        List<Version> unreleased = t.v2();
-
-        assertThat(
-            released,
-            equalTo(
-                Arrays.asList(
-                    TestReleaseBranch.V_4_0_0,
-                    TestReleaseBranch.V_5_3_0,
-                    TestReleaseBranch.V_5_3_1,
-                    TestReleaseBranch.V_5_3_2,
-                    TestReleaseBranch.V_5_4_0
-                )
-            )
-        );
-        assertThat(unreleased, equalTo(Arrays.asList(TestReleaseBranch.V_4_0_1, TestReleaseBranch.V_5_4_1)));
-    }
-
-    public static class TestStableBranch {
-        public static final Version V_4_0_0 = Version.fromString("4.0.0");
-        public static final Version V_4_0_1 = Version.fromString("4.0.1");
-        public static final Version V_5_0_0 = Version.fromString("5.0.0");
-        public static final Version V_5_0_1 = Version.fromString("5.0.1");
-        public static final Version V_5_0_2 = Version.fromString("5.0.2");
-        public static final Version V_5_1_0 = Version.fromString("5.1.0");
-        public static final Version CURRENT = V_5_1_0;
-    }
-
-    public void testResolveReleasedVersionsForUnreleasedStableBranch() {
-        Tuple<List<Version>, List<Version>> t = VersionUtils.resolveReleasedVersions(TestStableBranch.CURRENT, TestStableBranch.class);
-        List<Version> released = t.v1();
-        List<Version> unreleased = t.v2();
-
-        assertThat(released, equalTo(Arrays.asList(TestStableBranch.V_4_0_0, TestStableBranch.V_5_0_0, TestStableBranch.V_5_0_1)));
-        assertThat(unreleased, equalTo(Arrays.asList(TestStableBranch.V_4_0_1, TestStableBranch.V_5_0_2, TestStableBranch.V_5_1_0)));
-    }
-
-    public static class TestStableBranchBehindStableBranch {
-        public static final Version V_4_0_0 = Version.fromString("4.0.0");
-        public static final Version V_4_0_1 = Version.fromString("4.0.1");
-        public static final Version V_5_3_0 = Version.fromString("5.3.0");
-        public static final Version V_5_3_1 = Version.fromString("5.3.1");
-        public static final Version V_5_3_2 = Version.fromString("5.3.2");
-        public static final Version V_5_4_0 = Version.fromString("5.4.0");
-        public static final Version V_5_5_0 = Version.fromString("5.5.0");
-        public static final Version CURRENT = V_5_5_0;
-    }
-
-    public void testResolveReleasedVersionsForStableBranchBehindStableBranch() {
-        Tuple<List<Version>, List<Version>> t = VersionUtils.resolveReleasedVersions(
-            TestStableBranchBehindStableBranch.CURRENT,
-            TestStableBranchBehindStableBranch.class
-        );
-        List<Version> released = t.v1();
-        List<Version> unreleased = t.v2();
-
-        assertThat(
-            released,
-            equalTo(
-                Arrays.asList(
-                    TestStableBranchBehindStableBranch.V_4_0_0,
-                    TestStableBranchBehindStableBranch.V_5_3_0,
-                    TestStableBranchBehindStableBranch.V_5_3_1
-                )
-            )
-        );
-        assertThat(
-            unreleased,
-            equalTo(
-                Arrays.asList(
-                    TestStableBranchBehindStableBranch.V_4_0_1,
-                    TestStableBranchBehindStableBranch.V_5_3_2,
-                    TestStableBranchBehindStableBranch.V_5_4_0,
-                    TestStableBranchBehindStableBranch.V_5_5_0
-                )
-            )
-        );
-    }
-
-    public static class TestUnstableBranch {
-        public static final Version V_5_3_0 = Version.fromString("5.3.0");
-        public static final Version V_5_3_1 = Version.fromString("5.3.1");
-        public static final Version V_5_3_2 = Version.fromString("5.3.2");
-        public static final Version V_5_4_0 = Version.fromString("5.4.0");
-        public static final Version V_6_0_0 = Version.fromString("6.0.0");
-        public static final Version CURRENT = V_6_0_0;
-    }
-
-    public void testResolveReleasedVersionsForUnstableBranch() {
-        Tuple<List<Version>, List<Version>> t = VersionUtils.resolveReleasedVersions(TestUnstableBranch.CURRENT, TestUnstableBranch.class);
-        List<Version> released = t.v1();
-        List<Version> unreleased = t.v2();
-
-        assertThat(released, equalTo(Arrays.asList(TestUnstableBranch.V_5_3_0, TestUnstableBranch.V_5_3_1)));
-        assertThat(unreleased, equalTo(Arrays.asList(TestUnstableBranch.V_5_3_2, TestUnstableBranch.V_5_4_0, TestUnstableBranch.V_6_0_0)));
-    }
-
-    public static class TestNewMajorRelease {
-        public static final Version V_5_6_0 = Version.fromString("5.6.0");
-        public static final Version V_5_6_1 = Version.fromString("5.6.1");
-        public static final Version V_5_6_2 = Version.fromString("5.6.2");
-        public static final Version V_6_0_0 = Version.fromString("6.0.0");
-        public static final Version V_6_0_1 = Version.fromString("6.0.1");
-        public static final Version CURRENT = V_6_0_1;
-    }
-
-    public void testResolveReleasedVersionsAtNewMajorRelease() {
-        Tuple<List<Version>, List<Version>> t = VersionUtils.resolveReleasedVersions(
-            TestNewMajorRelease.CURRENT,
-            TestNewMajorRelease.class
-        );
-        List<Version> released = t.v1();
-        List<Version> unreleased = t.v2();
-
-        assertThat(released, equalTo(Arrays.asList(TestNewMajorRelease.V_5_6_0, TestNewMajorRelease.V_5_6_1, TestNewMajorRelease.V_6_0_0)));
-        assertThat(unreleased, equalTo(Arrays.asList(TestNewMajorRelease.V_5_6_2, TestNewMajorRelease.V_6_0_1)));
-    }
-
-    public static class TestVersionBumpIn6x {
-        public static final Version V_5_6_0 = Version.fromString("5.6.0");
-        public static final Version V_5_6_1 = Version.fromString("5.6.1");
-        public static final Version V_5_6_2 = Version.fromString("5.6.2");
-        public static final Version V_6_0_0 = Version.fromString("6.0.0");
-        public static final Version V_6_0_1 = Version.fromString("6.0.1");
-        public static final Version V_6_1_0 = Version.fromString("6.1.0");
-        public static final Version CURRENT = V_6_1_0;
-    }
-
-    public void testResolveReleasedVersionsAtVersionBumpIn6x() {
-        Tuple<List<Version>, List<Version>> t = VersionUtils.resolveReleasedVersions(
-            TestVersionBumpIn6x.CURRENT,
-            TestVersionBumpIn6x.class
-        );
-        List<Version> released = t.v1();
-        List<Version> unreleased = t.v2();
-
-        assertThat(released, equalTo(Arrays.asList(TestVersionBumpIn6x.V_5_6_0, TestVersionBumpIn6x.V_5_6_1, TestVersionBumpIn6x.V_6_0_0)));
-        assertThat(
-            unreleased,
-            equalTo(Arrays.asList(TestVersionBumpIn6x.V_5_6_2, TestVersionBumpIn6x.V_6_0_1, TestVersionBumpIn6x.V_6_1_0))
-        );
-    }
-
-    public static class TestNewMinorBranchIn6x {
-        public static final Version V_5_6_0 = Version.fromString("5.6.0");
-        public static final Version V_5_6_1 = Version.fromString("5.6.1");
-        public static final Version V_5_6_2 = Version.fromString("5.6.2");
-        public static final Version V_6_0_0 = Version.fromString("6.0.0");
-        public static final Version V_6_0_1 = Version.fromString("6.0.1");
-        public static final Version V_6_1_0 = Version.fromString("6.1.0");
-        public static final Version V_6_1_1 = Version.fromString("6.1.1");
-        public static final Version V_6_1_2 = Version.fromString("6.1.2");
-        public static final Version V_6_2_0 = Version.fromString("6.2.0");
-        public static final Version CURRENT = V_6_2_0;
-    }
-
-    public void testResolveReleasedVersionsAtNewMinorBranchIn6x() {
-        Tuple<List<Version>, List<Version>> t = VersionUtils.resolveReleasedVersions(
-            TestNewMinorBranchIn6x.CURRENT,
-            TestNewMinorBranchIn6x.class
-        );
-        List<Version> released = t.v1();
-        List<Version> unreleased = t.v2();
-
-        assertThat(
-            released,
-            equalTo(
-                Arrays.asList(
-                    TestNewMinorBranchIn6x.V_5_6_0,
-                    TestNewMinorBranchIn6x.V_5_6_1,
-                    TestNewMinorBranchIn6x.V_6_0_0,
-                    TestNewMinorBranchIn6x.V_6_0_1,
-                    TestNewMinorBranchIn6x.V_6_1_0,
-                    TestNewMinorBranchIn6x.V_6_1_1
-                )
-            )
-        );
-        assertThat(
-            unreleased,
-            equalTo(Arrays.asList(TestNewMinorBranchIn6x.V_5_6_2, TestNewMinorBranchIn6x.V_6_1_2, TestNewMinorBranchIn6x.V_6_2_0))
-        );
     }
 
     /**
-     * Tests that {@link Version#minimumCompatibilityVersion()} and {@link VersionUtils#allReleasedVersions()}
+     * Tests that {@link Version#minimumCompatibilityVersion()} and {@link VersionUtils#allVersions()}
      * agree with the list of wire compatible versions we build in gradle.
      */
     public void testGradleVersionsMatchVersionUtils() {
         // First check the index compatible versions
-        List<Version> released = VersionUtils.allReleasedVersions()
+        List<String> versions = VersionUtils.allVersions()
             .stream()
             /* Java lists all versions from the 5.x series onwards, but we only want to consider
              * ones that we're supposed to be compatible with. */
             .filter(v -> v.onOrAfter(Version.CURRENT.minimumCompatibilityVersion()))
+            .map(Version::toString)
             .toList();
-        VersionsFromProperty wireCompatible = new VersionsFromProperty("tests.gradle_wire_compat_versions");
-
-        Version minimumCompatibleVersion = Version.CURRENT.minimumCompatibilityVersion();
-        List<String> releasedWireCompatible = released.stream()
-            .filter(v -> Version.CURRENT.equals(v) == false)
-            .filter(v -> v.onOrAfter(minimumCompatibleVersion))
-            .map(Object::toString)
-            .toList();
-        assertEquals(releasedWireCompatible, wireCompatible.released);
-
-        List<String> unreleasedWireCompatible = VersionUtils.allUnreleasedVersions()
-            .stream()
-            .filter(v -> v.onOrAfter(minimumCompatibleVersion))
-            .map(Object::toString)
-            .toList();
-        assertEquals(unreleasedWireCompatible, wireCompatible.unreleased);
+        List<String> gradleVersions = versionFromProperty("tests.gradle_wire_compat_versions");
+        assertEquals(versions, gradleVersions);
     }
 
-    /**
-     * Read a versions system property as set by gradle into a tuple of {@code (releasedVersion, unreleasedVersion)}.
-     */
-    private class VersionsFromProperty {
-        private final List<String> released = new ArrayList<>();
-        private final List<String> unreleased = new ArrayList<>();
-
-        private VersionsFromProperty(String property) {
-            Set<String> allUnreleased = new HashSet<>(Arrays.asList(System.getProperty("tests.gradle_unreleased_versions", "").split(",")));
-            if (allUnreleased.isEmpty()) {
-                fail("[tests.gradle_unreleased_versions] not set or empty. Gradle should set this before running.");
-            }
-            String versions = System.getProperty(property);
-            assertNotNull("Couldn't find [" + property + "]. Gradle should set this before running the tests.", versions);
-            logger.info("Looked up versions [{}={}]", property, versions);
-
-            for (String version : versions.split(",")) {
-                if (allUnreleased.contains(version)) {
-                    unreleased.add(version);
-                } else {
-                    released.add(version);
-                }
-            }
+    private List<String> versionFromProperty(String property) {
+        List<String> versions = new ArrayList<>();
+        String versionsString = System.getProperty(property);
+        assertNotNull("Couldn't find [" + property + "]. Gradle should set this before running the tests.", versionsString);
+        logger.info("Looked up versions [{}={}]", property, versionsString);
+        for (String version : versionsString.split(",")) {
+            versions.add(version);
         }
+
+        return versions;
     }
 }

From 6adb3e04ba41657824b71d00b66cbefff68e761f Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Fri, 6 Dec 2024 10:30:14 +1100
Subject: [PATCH 062/119] Mute
 org.elasticsearch.packaging.test.ConfigurationTests test30SymlinkedDataPath
 #118111

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index ee5e3dd42236d..772b03171b237 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -247,6 +247,9 @@ tests:
   issue: https://github.com/elastic/elasticsearch/issues/118029
 - class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
   issue: https://github.com/elastic/elasticsearch/issues/117981
+- class: org.elasticsearch.packaging.test.ConfigurationTests
+  method: test30SymlinkedDataPath
+  issue: https://github.com/elastic/elasticsearch/issues/118111
 
 # Examples:
 #

From 3a292e982f3f9a7e66ecbe8f7892d44cb90533dd Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@iernst.net>
Date: Thu, 5 Dec 2024 15:53:17 -0800
Subject: [PATCH 063/119] Add a diagram of how entitlements loading works
 (#117513)

This commit adds a diagram to source control that explains how the
entitlements lib is loaded.
---
 libs/entitlement/entitlements-loading.svg | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 libs/entitlement/entitlements-loading.svg

diff --git a/libs/entitlement/entitlements-loading.svg b/libs/entitlement/entitlements-loading.svg
new file mode 100644
index 0000000000000..4f0213b853bee
--- /dev/null
+++ b/libs/entitlement/entitlements-loading.svg
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Do not edit this file with editors other than draw.io -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="987px" height="552px" viewBox="-0.5 -0.5 987 552" content="&lt;mxfile host=&quot;app.diagrams.net&quot; agent=&quot;Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1.1 Safari/605.1.15&quot; version=&quot;24.8.6&quot;&gt;&#10;  &lt;diagram id=&quot;6a731a19-8d31-9384-78a2-239565b7b9f0&quot; name=&quot;Page-1&quot;&gt;&#10;    &lt;mxGraphModel dx=&quot;1019&quot; dy=&quot;691&quot; grid=&quot;1&quot; gridSize=&quot;10&quot; guides=&quot;1&quot; tooltips=&quot;1&quot; connect=&quot;1&quot; arrows=&quot;1&quot; fold=&quot;1&quot; page=&quot;1&quot; pageScale=&quot;1&quot; pageWidth=&quot;1169&quot; pageHeight=&quot;827&quot; background=&quot;none&quot; math=&quot;0&quot; shadow=&quot;0&quot;&gt;&#10;      &lt;root&gt;&#10;        &lt;mxCell id=&quot;0&quot; /&gt;&#10;        &lt;mxCell id=&quot;1&quot; parent=&quot;0&quot; /&gt;&#10;        &lt;mxCell id=&quot;2&quot; value=&quot;ES main&quot; style=&quot;shape=mxgraph.flowchart.terminator;strokeWidth=2;gradientColor=none;gradientDirection=north;fontStyle=0;html=1;&quot; parent=&quot;1&quot; vertex=&quot;1&quot;&gt;&#10;          &lt;mxGeometry x=&quot;110&quot; y=&quot;60&quot; width=&quot;160&quot; height=&quot;50&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;7&quot; style=&quot;fontStyle=1;strokeColor=#003366;strokeWidth=1;html=1;entryX=0.5;entryY=0;entryDx=0;entryDy=0;&quot; parent=&quot;1&quot; source=&quot;2&quot; target=&quot;m5HwfOdS2vHtKGNdpC5B-113&quot; edge=&quot;1&quot;&gt;&#10;          &lt;mxGeometry relative=&quot;1&quot; as=&quot;geometry&quot;&gt;&#10;            &lt;mxPoint x=&quot;190&quot; y=&quot;130&quot; as=&quot;targetPoint&quot; /&gt;&#10;          &lt;/mxGeometry&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;-Sy_oc9FBZUt3I15fPpm-59&quot; value=&quot;Boot Loader&quot; style=&quot;rounded=0;whiteSpace=wrap;html=1;align=left;horizontal=1;verticalAlign=top;&quot; parent=&quot;1&quot; vertex=&quot;1&quot;&gt;&#10;          &lt;mxGeometry x=&quot;690&quot; y=&quot;20&quot; width=&quot;400&quot; height=&quot;100&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;-Sy_oc9FBZUt3I15fPpm-67&quot; style=&quot;edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;exitX=0.5;exitY=0;exitDx=0;exitDy=0;entryX=0.5;entryY=1;entryDx=0;entryDy=0;&quot; parent=&quot;1&quot; source=&quot;-Sy_oc9FBZUt3I15fPpm-60&quot; target=&quot;-Sy_oc9FBZUt3I15fPpm-59&quot; edge=&quot;1&quot;&gt;&#10;          &lt;mxGeometry relative=&quot;1&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;-Sy_oc9FBZUt3I15fPpm-60&quot; value=&quot;Platform Loader&quot; style=&quot;rounded=0;whiteSpace=wrap;html=1;align=left;horizontal=1;verticalAlign=top;&quot; parent=&quot;1&quot; vertex=&quot;1&quot;&gt;&#10;          &lt;mxGeometry x=&quot;690&quot; y=&quot;140&quot; width=&quot;400&quot; height=&quot;100&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;-Sy_oc9FBZUt3I15fPpm-68&quot; style=&quot;edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;exitX=0.5;exitY=0;exitDx=0;exitDy=0;entryX=0.5;entryY=1;entryDx=0;entryDy=0;&quot; parent=&quot;1&quot; source=&quot;-Sy_oc9FBZUt3I15fPpm-61&quot; target=&quot;-Sy_oc9FBZUt3I15fPpm-60&quot; edge=&quot;1&quot;&gt;&#10;          &lt;mxGeometry relative=&quot;1&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;-Sy_oc9FBZUt3I15fPpm-61&quot; value=&quot;System Loader&quot; style=&quot;rounded=0;whiteSpace=wrap;html=1;align=left;horizontal=1;verticalAlign=top;&quot; parent=&quot;1&quot; vertex=&quot;1&quot;&gt;&#10;          &lt;mxGeometry x=&quot;690&quot; y=&quot;260&quot; width=&quot;400&quot; height=&quot;100&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;-Sy_oc9FBZUt3I15fPpm-72&quot; style=&quot;edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;dashed=1;&quot; parent=&quot;1&quot; source=&quot;-Sy_oc9FBZUt3I15fPpm-64&quot; target=&quot;m5HwfOdS2vHtKGNdpC5B-109&quot; edge=&quot;1&quot;&gt;&#10;          &lt;mxGeometry relative=&quot;1&quot; as=&quot;geometry&quot;&gt;&#10;            &lt;mxPoint x=&quot;880&quot; y=&quot;319.375&quot; as=&quot;targetPoint&quot; /&gt;&#10;          &lt;/mxGeometry&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;-Sy_oc9FBZUt3I15fPpm-74&quot; value=&quot;reflection&quot; style=&quot;edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];&quot; parent=&quot;-Sy_oc9FBZUt3I15fPpm-72&quot; vertex=&quot;1&quot; connectable=&quot;0&quot;&gt;&#10;          &lt;mxGeometry x=&quot;-0.04&quot; relative=&quot;1&quot; as=&quot;geometry&quot;&gt;&#10;            &lt;mxPoint as=&quot;offset&quot; /&gt;&#10;          &lt;/mxGeometry&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;-Sy_oc9FBZUt3I15fPpm-64&quot; value=&quot;Agent Jar&quot; style=&quot;whiteSpace=wrap;html=1;aspect=fixed;dashed=1;&quot; parent=&quot;1&quot; vertex=&quot;1&quot;&gt;&#10;          &lt;mxGeometry x=&quot;720&quot; y=&quot;290&quot; width=&quot;57.5&quot; height=&quot;57.5&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-104&quot; value=&quot;&quot; style=&quot;edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;&quot; parent=&quot;1&quot; source=&quot;-Sy_oc9FBZUt3I15fPpm-76&quot; edge=&quot;1&quot;&gt;&#10;          &lt;mxGeometry relative=&quot;1&quot; as=&quot;geometry&quot;&gt;&#10;            &lt;mxPoint x=&quot;936.25&quot; y=&quot;319.375&quot; as=&quot;targetPoint&quot; /&gt;&#10;          &lt;/mxGeometry&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;-Sy_oc9FBZUt3I15fPpm-76&quot; value=&quot;&amp;lt;div&amp;gt;Server&amp;lt;/div&amp;gt;&quot; style=&quot;whiteSpace=wrap;html=1;aspect=fixed;&quot; parent=&quot;1&quot; vertex=&quot;1&quot;&gt;&#10;          &lt;mxGeometry x=&quot;990&quot; y=&quot;291.25&quot; width=&quot;56.25&quot; height=&quot;56.25&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-108&quot; value=&quot;&quot; style=&quot;edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;&quot; parent=&quot;1&quot; source=&quot;m5HwfOdS2vHtKGNdpC5B-57&quot; target=&quot;m5HwfOdS2vHtKGNdpC5B-106&quot; edge=&quot;1&quot;&gt;&#10;          &lt;mxGeometry relative=&quot;1&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-57&quot; value=&quot;(Instrumented)&amp;lt;div&amp;gt;JDK classes&amp;lt;/div&amp;gt;&quot; style=&quot;rounded=0;whiteSpace=wrap;html=1;dashed=1;&quot; parent=&quot;1&quot; vertex=&quot;1&quot;&gt;&#10;          &lt;mxGeometry x=&quot;740&quot; y=&quot;170&quot; width=&quot;127.5&quot; height=&quot;60&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-123&quot; value=&quot;&quot; style=&quot;edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;&quot; parent=&quot;1&quot; source=&quot;m5HwfOdS2vHtKGNdpC5B-61&quot; target=&quot;m5HwfOdS2vHtKGNdpC5B-122&quot; edge=&quot;1&quot;&gt;&#10;          &lt;mxGeometry relative=&quot;1&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-61&quot; value=&quot;agent main&amp;lt;div&amp;gt;(in unnamed module)&amp;lt;/div&amp;gt;&quot; style=&quot;shape=mxgraph.flowchart.terminator;strokeWidth=2;gradientColor=none;gradientDirection=north;fontStyle=0;html=1;&quot; parent=&quot;1&quot; vertex=&quot;1&quot;&gt;&#10;          &lt;mxGeometry x=&quot;400&quot; y=&quot;60&quot; width=&quot;160&quot; height=&quot;50&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-80&quot; style=&quot;edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;exitPerimeter=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;entryPerimeter=0;&quot; parent=&quot;1&quot; source=&quot;m5HwfOdS2vHtKGNdpC5B-61&quot; edge=&quot;1&quot;&gt;&#10;          &lt;mxGeometry relative=&quot;1&quot; as=&quot;geometry&quot;&gt;&#10;            &lt;mxPoint x=&quot;480&quot; y=&quot;114&quot; as=&quot;targetPoint&quot; /&gt;&#10;          &lt;/mxGeometry&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-83&quot; value=&quot;entitlements ready&quot; style=&quot;shape=mxgraph.flowchart.terminator;strokeWidth=2;gradientColor=none;gradientDirection=north;fontStyle=0;html=1;&quot; parent=&quot;1&quot; vertex=&quot;1&quot;&gt;&#10;          &lt;mxGeometry x=&quot;129.5&quot; y=&quot;540&quot; width=&quot;120&quot; height=&quot;30&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-129&quot; style=&quot;edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;dashed=1;&quot; parent=&quot;1&quot; source=&quot;m5HwfOdS2vHtKGNdpC5B-106&quot; target=&quot;m5HwfOdS2vHtKGNdpC5B-109&quot; edge=&quot;1&quot;&gt;&#10;          &lt;mxGeometry relative=&quot;1&quot; as=&quot;geometry&quot;&gt;&#10;            &lt;Array as=&quot;points&quot;&gt;&#10;              &lt;mxPoint x=&quot;980&quot; y=&quot;280&quot; /&gt;&#10;              &lt;mxPoint x=&quot;895&quot; y=&quot;280&quot; /&gt;&#10;            &lt;/Array&gt;&#10;          &lt;/mxGeometry&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-130&quot; value=&quot;reflection&quot; style=&quot;edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];&quot; parent=&quot;m5HwfOdS2vHtKGNdpC5B-129&quot; vertex=&quot;1&quot; connectable=&quot;0&quot;&gt;&#10;          &lt;mxGeometry x=&quot;0.4722&quot; y=&quot;-2&quot; relative=&quot;1&quot; as=&quot;geometry&quot;&gt;&#10;            &lt;mxPoint x=&quot;20&quot; as=&quot;offset&quot; /&gt;&#10;          &lt;/mxGeometry&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-106&quot; value=&quot;Bridge&amp;lt;div&amp;gt;(patched into java.base)&amp;lt;/div&amp;gt;&quot; style=&quot;rounded=0;whiteSpace=wrap;html=1;&quot; parent=&quot;1&quot; vertex=&quot;1&quot;&gt;&#10;          &lt;mxGeometry x=&quot;920&quot; y=&quot;170&quot; width=&quot;120&quot; height=&quot;60&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-109&quot; value=&quot;Entitlements&quot; style=&quot;rounded=0;whiteSpace=wrap;html=1;&quot; parent=&quot;1&quot; vertex=&quot;1&quot;&gt;&#10;          &lt;mxGeometry x=&quot;850&quot; y=&quot;293.44&quot; width=&quot;90&quot; height=&quot;50.62&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-113&quot; value=&quot;&amp;lt;b&amp;gt;Entitlements bootstrap&amp;lt;/b&amp;gt;&quot; style=&quot;swimlane;fontStyle=0;childLayout=stackLayout;horizontal=1;startSize=30;horizontalStack=0;resizeParent=1;resizeParentMax=0;resizeLast=0;collapsible=1;marginBottom=0;whiteSpace=wrap;html=1;&quot; parent=&quot;1&quot; vertex=&quot;1&quot;&gt;&#10;          &lt;mxGeometry x=&quot;104.5&quot; y=&quot;140&quot; width=&quot;170&quot; height=&quot;110&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-118&quot; value=&quot;&amp;lt;ul&amp;gt;&amp;lt;li style=&amp;quot;&amp;quot;&amp;gt;Grant access to unnamed module&amp;lt;/li&amp;gt;&amp;lt;li style=&amp;quot;&amp;quot;&amp;gt;Set (static, protected) init arguments&amp;lt;/li&amp;gt;&amp;lt;li style=&amp;quot;&amp;quot;&amp;gt;Load agent&amp;lt;/li&amp;gt;&amp;lt;/ul&amp;gt;&quot; style=&quot;text;html=1;align=left;verticalAlign=middle;whiteSpace=wrap;rounded=0;&quot; parent=&quot;m5HwfOdS2vHtKGNdpC5B-113&quot; vertex=&quot;1&quot;&gt;&#10;          &lt;mxGeometry y=&quot;30&quot; width=&quot;170&quot; height=&quot;80&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-120&quot; style=&quot;edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;entryPerimeter=0;&quot; parent=&quot;1&quot; source=&quot;m5HwfOdS2vHtKGNdpC5B-118&quot; target=&quot;m5HwfOdS2vHtKGNdpC5B-61&quot; edge=&quot;1&quot;&gt;&#10;          &lt;mxGeometry relative=&quot;1&quot; as=&quot;geometry&quot;&gt;&#10;            &lt;Array as=&quot;points&quot;&gt;&#10;              &lt;mxPoint x=&quot;190&quot; y=&quot;280&quot; /&gt;&#10;              &lt;mxPoint x=&quot;310&quot; y=&quot;280&quot; /&gt;&#10;              &lt;mxPoint x=&quot;310&quot; y=&quot;40&quot; /&gt;&#10;              &lt;mxPoint x=&quot;480&quot; y=&quot;40&quot; /&gt;&#10;            &lt;/Array&gt;&#10;          &lt;/mxGeometry&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-128&quot; value=&quot;&quot; style=&quot;edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;&quot; parent=&quot;1&quot; source=&quot;m5HwfOdS2vHtKGNdpC5B-122&quot; target=&quot;m5HwfOdS2vHtKGNdpC5B-125&quot; edge=&quot;1&quot;&gt;&#10;          &lt;mxGeometry relative=&quot;1&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-122&quot; value=&quot;(reflectively) call&amp;amp;nbsp;&amp;lt;div&amp;gt;entitlements init&amp;lt;/div&amp;gt;&amp;lt;div&amp;gt;with Instrumentation&amp;lt;/div&amp;gt;&quot; style=&quot;shape=mxgraph.flowchart.data;strokeWidth=2;gradientColor=none;gradientDirection=north;fontStyle=0;html=1;&quot; parent=&quot;1&quot; vertex=&quot;1&quot;&gt;&#10;          &lt;mxGeometry x=&quot;375&quot; y=&quot;150&quot; width=&quot;210&quot; height=&quot;80&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-124&quot; value=&quot;&amp;lt;b&amp;gt;Entitlements init&amp;lt;/b&amp;gt;&quot; style=&quot;swimlane;fontStyle=0;childLayout=stackLayout;horizontal=1;startSize=30;horizontalStack=0;resizeParent=1;resizeParentMax=0;resizeLast=0;collapsible=1;marginBottom=0;whiteSpace=wrap;html=1;&quot; parent=&quot;1&quot; vertex=&quot;1&quot;&gt;&#10;          &lt;mxGeometry x=&quot;340&quot; y=&quot;270&quot; width=&quot;280&quot; height=&quot;200&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-125&quot; value=&quot;&amp;lt;ul&amp;gt;&amp;lt;li style=&amp;quot;&amp;quot;&amp;gt;Load plugin policies&amp;lt;/li&amp;gt;&amp;lt;li style=&amp;quot;&amp;quot;&amp;gt;Load server policy&amp;lt;/li&amp;gt;&amp;lt;li style=&amp;quot;&amp;quot;&amp;gt;Create entitlements manager&amp;lt;/li&amp;gt;&amp;lt;ul&amp;gt;&amp;lt;li style=&amp;quot;&amp;quot;&amp;gt;Policies&amp;lt;/li&amp;gt;&amp;lt;li style=&amp;quot;&amp;quot;&amp;gt;Method to lookup plugin by Module&amp;lt;/li&amp;gt;&amp;lt;/ul&amp;gt;&amp;lt;li&amp;gt;Set entitlements manager in static (accessible by bridge)&amp;lt;/li&amp;gt;&amp;lt;li&amp;gt;Instrument jdk classes&amp;lt;/li&amp;gt;&amp;lt;li&amp;gt;run self test (force bridge to capture entitlements manager)&amp;lt;/li&amp;gt;&amp;lt;/ul&amp;gt;&quot; style=&quot;text;html=1;align=left;verticalAlign=middle;whiteSpace=wrap;rounded=0;&quot; parent=&quot;m5HwfOdS2vHtKGNdpC5B-124&quot; vertex=&quot;1&quot;&gt;&#10;          &lt;mxGeometry y=&quot;30&quot; width=&quot;280&quot; height=&quot;170&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;        &lt;mxCell id=&quot;m5HwfOdS2vHtKGNdpC5B-127&quot; style=&quot;edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=0.5;entryY=0;entryDx=0;entryDy=0;entryPerimeter=0;exitX=0.5;exitY=1;exitDx=0;exitDy=0;&quot; parent=&quot;1&quot; source=&quot;m5HwfOdS2vHtKGNdpC5B-125&quot; target=&quot;m5HwfOdS2vHtKGNdpC5B-83&quot; edge=&quot;1&quot;&gt;&#10;          &lt;mxGeometry relative=&quot;1&quot; as=&quot;geometry&quot; /&gt;&#10;        &lt;/mxCell&gt;&#10;      &lt;/root&gt;&#10;    &lt;/mxGraphModel&gt;&#10;  &lt;/diagram&gt;&#10;&lt;/mxfile&gt;&#10;"><defs/><g><g data-cell-id="0"><g data-cell-id="1"><g data-cell-id="2"><g><path d="M 54.98 40 L 117.02 40 C 144.07 40 166 51.19 166 65 C 166 78.81 144.07 90 117.02 90 L 54.98 90 C 27.93 90 6 78.81 6 65 C 6 51.19 27.93 40 54.98 40 Z" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-width="2" stroke-miterlimit="10" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 65px; margin-left: 86px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: nowrap;">ES main</div></div></div></foreignObject><text x="86" y="69" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="12px" text-anchor="middle">ES main</text></switch></g></g></g><g data-cell-id="7"><g><path d="M 85.77 90 L 85.56 113.63" fill="none" stroke="#003366" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 85.51 118.88 L 82.07 111.85 L 85.56 113.63 L 89.07 111.91 Z" fill="#003366" stroke="#003366" stroke-miterlimit="10" pointer-events="all"/></g></g><g data-cell-id="-Sy_oc9FBZUt3I15fPpm-59"><g><rect x="586" y="0" width="400" height="100" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 398px; height: 1px; padding-top: 7px; margin-left: 588px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: left;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Boot Loader</div></div></div></foreignObject><text x="588" y="19" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="12px">Boot Loader</text></switch></g></g></g><g data-cell-id="-Sy_oc9FBZUt3I15fPpm-67"><g><path d="M 786 120 L 786 106.37" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 786 101.12 L 789.5 108.12 L 786 106.37 L 782.5 108.12 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g></g><g data-cell-id="-Sy_oc9FBZUt3I15fPpm-60"><g><rect x="586" y="120" width="400" height="100" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 398px; height: 1px; padding-top: 127px; margin-left: 588px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: left;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Platform Loader</div></div></div></foreignObject><text x="588" y="139" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="12px">Platform Loader</text></switch></g></g></g><g data-cell-id="-Sy_oc9FBZUt3I15fPpm-68"><g><path d="M 786 240 L 786 226.37" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 786 221.12 L 789.5 228.12 L 786 226.37 L 782.5 228.12 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g></g><g data-cell-id="-Sy_oc9FBZUt3I15fPpm-61"><g><rect x="586" y="240" width="400" height="100" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 398px; height: 1px; padding-top: 247px; margin-left: 588px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: left;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">System Loader</div></div></div></foreignObject><text x="588" y="259" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="12px">System Loader</text></switch></g></g></g><g data-cell-id="-Sy_oc9FBZUt3I15fPpm-72"><g><path d="M 673.5 298.75 L 739.63 298.75" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="stroke"/><path d="M 744.88 298.75 L 737.88 302.25 L 739.63 298.75 L 737.88 295.25 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g><g data-cell-id="-Sy_oc9FBZUt3I15fPpm-74"><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 299px; margin-left: 709px;"><div data-drawio-colors="color: rgb(0, 0, 0); background-color: rgb(255, 255, 255); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 11px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; background-color: rgb(255, 255, 255); white-space: nowrap;">reflection</div></div></div></foreignObject><text x="709" y="303" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="11px" text-anchor="middle">reflection</text></switch></g></g></g></g><g data-cell-id="-Sy_oc9FBZUt3I15fPpm-64"><g><rect x="616" y="270" width="57.5" height="57.5" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-dasharray="3 3" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 56px; height: 1px; padding-top: 299px; margin-left: 617px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Agent Jar</div></div></div></foreignObject><text x="645" y="302" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="12px" text-anchor="middle">Agent Jar</text></switch></g></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-104"><g><path d="M 886 299.5 L 859.7 299.5 L 838.62 299.4" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 833.37 299.38 L 840.38 295.91 L 838.62 299.4 L 840.35 302.91 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g></g><g data-cell-id="-Sy_oc9FBZUt3I15fPpm-76"><g><rect x="886" y="271.25" width="56.25" height="56.25" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 54px; height: 1px; padding-top: 299px; margin-left: 887px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;"><div>Server</div></div></div></div></foreignObject><text x="914" y="303" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="12px" text-anchor="middle">Server</text></switch></g></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-108"><g><path d="M 763.5 180 L 809.63 180" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 814.88 180 L 807.88 183.5 L 809.63 180 L 807.88 176.5 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-57"><g><rect x="636" y="150" width="127.5" height="60" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-dasharray="3 3" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 126px; height: 1px; padding-top: 180px; margin-left: 637px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">(Instrumented)<div>JDK classes</div></div></div></div></foreignObject><text x="700" y="184" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="12px" text-anchor="middle">(Instrumented)...</text></switch></g></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-123"><g><path d="M 376 90 L 376 123.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 376 128.88 L 372.5 121.88 L 376 123.63 L 379.5 121.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-61"><g><path d="M 344.98 40 L 407.02 40 C 434.07 40 456 51.19 456 65 C 456 78.81 434.07 90 407.02 90 L 344.98 90 C 317.93 90 296 78.81 296 65 C 296 51.19 317.93 40 344.98 40 Z" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-width="2" stroke-miterlimit="10" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 65px; margin-left: 376px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: nowrap;">agent main<div>(in unnamed module)</div></div></div></div></foreignObject><text x="376" y="69" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="12px" text-anchor="middle">agent main...</text></switch></g></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-80"><g><path d="M 376 90 L 376 87.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 376 92.88 L 372.5 85.88 L 376 87.63 L 379.5 85.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-83"><g><path d="M 62.23 520 L 108.77 520 C 129.05 520 145.5 526.72 145.5 535 C 145.5 543.28 129.05 550 108.77 550 L 62.23 550 C 41.95 550 25.5 543.28 25.5 535 C 25.5 526.72 41.95 520 62.23 520 Z" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-width="2" stroke-miterlimit="10" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 535px; margin-left: 86px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: nowrap;">entitlements ready</div></div></div></foreignObject><text x="86" y="539" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="12px" text-anchor="middle">entitlements ready</text></switch></g></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-129"><g><path d="M 876 210 L 876 260 L 791 260 L 791 267.07" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="stroke"/><path d="M 791 272.32 L 787.5 265.32 L 791 267.07 L 794.5 265.32 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-130"><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 259px; margin-left: 838px;"><div data-drawio-colors="color: rgb(0, 0, 0); background-color: rgb(255, 255, 255); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 11px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; background-color: rgb(255, 255, 255); white-space: nowrap;">reflection</div></div></div></foreignObject><text x="838" y="262" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="11px" text-anchor="middle">reflection</text></switch></g></g></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-106"><g><rect x="816" y="150" width="120" height="60" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 180px; margin-left: 817px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Bridge<div>(patched into java.base)</div></div></div></div></foreignObject><text x="876" y="184" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="12px" text-anchor="middle">Bridge...</text></switch></g></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-109"><g><rect x="746" y="273.44" width="90" height="50.62" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 88px; height: 1px; padding-top: 299px; margin-left: 747px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">Entitlements</div></div></div></foreignObject><text x="791" y="302" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="12px" text-anchor="middle">Entitlements</text></switch></g></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-113"><g><path d="M 0.5 150 L 0.5 120 L 170.5 120 L 170.5 150" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 0.5 150 L 0.5 230 L 170.5 230 L 170.5 150" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="none"/><path d="M 0.5 150 L 170.5 150" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="none"/></g><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 168px; height: 1px; padding-top: 135px; margin-left: 2px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;"><b>Entitlements bootstrap</b></div></div></div></foreignObject><text x="86" y="139" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="12px" text-anchor="middle">Entitlements bootstrap</text></switch></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-118"><g><rect x="0.5" y="150" width="170" height="80" fill="none" stroke="none" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe flex-start; width: 168px; height: 1px; padding-top: 190px; margin-left: 3px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: left;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;"><ul><li style="">Grant access to unnamed module</li><li style="">Set (static, protected) init arguments</li><li style="">Load agent</li></ul></div></div></div></foreignObject><text x="3" y="194" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="12px">Grant access to unnamed modu...</text></switch></g></g></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-120"><g><path d="M 85.5 230 L 85.5 260 L 206 260 L 206 20 L 376 20 L 376 33.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 376 38.88 L 372.5 31.88 L 376 33.63 L 379.5 31.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-128"><g><path d="M 376 210 L 376 273.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 376 278.88 L 372.5 271.88 L 376 273.63 L 379.5 271.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-122"><g><path d="M 312.18 136.8 C 314.63 132.53 318.61 130.05 322.81 130.16 L 469.52 130.16 C 472.87 130.11 476.07 130.84 478.16 132.15 C 480.25 133.46 480.99 135.18 480.15 136.8 L 439.75 203.2 C 437.3 207.47 433.32 209.95 429.12 209.84 L 280.29 209.84 C 277.33 209.59 274.71 208.73 273.09 207.46 C 271.47 206.2 270.99 204.65 271.79 203.2 Z" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-width="2" stroke-miterlimit="10" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 170px; margin-left: 376px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: nowrap;">(reflectively) call <div>entitlements init</div><div>with Instrumentation</div></div></div></div></foreignObject><text x="376" y="174" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="12px" text-anchor="middle">(reflectively) call...</text></switch></g></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-124"><g><path d="M 236 280 L 236 250 L 516 250 L 516 280" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/><path d="M 236 280 L 236 450 L 516 450 L 516 280" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="none"/><path d="M 236 280 L 516 280" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="none"/></g><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 278px; height: 1px; padding-top: 265px; margin-left: 237px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;"><b>Entitlements init</b></div></div></div></foreignObject><text x="376" y="269" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="12px" text-anchor="middle">Entitlements init</text></switch></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-125"><g><rect x="236" y="280" width="280" height="170" fill="none" stroke="none" pointer-events="all"/></g><g><g transform="translate(-0.5 -0.5)"><switch><foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe flex-start; width: 278px; height: 1px; padding-top: 365px; margin-left: 238px;"><div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: left;"><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;"><ul><li style="">Load plugin policies</li><li style="">Load server policy</li><li style="">Create entitlements manager</li><ul><li style="">Policies</li><li style="">Method to lookup plugin by Module</li></ul><li>Set entitlements manager in static (accessible by bridge)</li><li>Instrument jdk classes</li><li>run self test (force bridge to capture entitlements manager)</li></ul></div></div></div></foreignObject><text x="238" y="369" fill="rgb(0, 0, 0)" font-family="&quot;Helvetica&quot;" font-size="12px">Load plugin policiesLoad server policyCreate e...</text></switch></g></g></g></g><g data-cell-id="m5HwfOdS2vHtKGNdpC5B-127"><g><path d="M 376 450 L 376 485 L 85.5 485 L 85.5 513.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 85.5 518.88 L 82 511.88 L 85.5 513.63 L 89 511.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/></g></g></g></g></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://www.drawio.com/doc/faq/svg-export-text-problems" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Text is not SVG - cannot display</text></a></switch></svg>
\ No newline at end of file

From e67856895b5a11837ec6c759364177ea23b9000e Mon Sep 17 00:00:00 2001
From: Nick Tindall <nick.tindall@elastic.co>
Date: Fri, 6 Dec 2024 14:22:59 +1100
Subject: [PATCH 064/119] Add link to Tasks experimental issue (#118117)

---
 docs/internal/DistributedArchitectureGuide.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/internal/DistributedArchitectureGuide.md b/docs/internal/DistributedArchitectureGuide.md
index 793d38e3d73b3..11a2c860eb326 100644
--- a/docs/internal/DistributedArchitectureGuide.md
+++ b/docs/internal/DistributedArchitectureGuide.md
@@ -386,6 +386,9 @@ The tasks infrastructure is used to track currently executing operations in the
 
 Each individual task is local to a node, but can be related to other tasks, on the same node or other nodes, via a parent-child relationship.
 
+> [!NOTE]
+> The Task management API is experimental/beta, its status and outstanding issues can be tracked [here](https://github.com/elastic/elasticsearch/issues/51628).
+
 ### Task tracking and registration
 
 Tasks are tracked in-memory on each node in the node's [TaskManager], new tasks are registered via one of the [TaskManager#register] methods.

From dc443524e4397d1514d73f13b676d090d40065be Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Fri, 6 Dec 2024 16:42:52 +1100
Subject: [PATCH 065/119] Mute
 org.elasticsearch.datastreams.ResolveClusterDataStreamIT
 testClusterResolveWithDataStreamsUsingAlias #118124

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 772b03171b237..99d1e170a4f4e 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -250,6 +250,9 @@ tests:
 - class: org.elasticsearch.packaging.test.ConfigurationTests
   method: test30SymlinkedDataPath
   issue: https://github.com/elastic/elasticsearch/issues/118111
+- class: org.elasticsearch.datastreams.ResolveClusterDataStreamIT
+  method: testClusterResolveWithDataStreamsUsingAlias
+  issue: https://github.com/elastic/elasticsearch/issues/118124
 
 # Examples:
 #

From 7bd5c69c8c5ad3c4a21949e80d6bedc14351d073 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lorenzo=20Dematt=C3=A9?= <lorenzo.dematte@elastic.co>
Date: Fri, 6 Dec 2024 08:16:46 +0100
Subject: [PATCH 066/119] Update ASM 9.7 -> 9.7.1 to support JDK 24 (#118094)

---
 distribution/tools/plugin-cli/build.gradle    |  4 +--
 docs/changelog/118094.yaml                    |  5 +++
 gradle/verification-metadata.xml              | 31 +++++--------------
 libs/entitlement/asm-provider/build.gradle    |  4 +--
 .../securitymanager-scanner/build.gradle      |  4 +--
 libs/plugin-scanner/build.gradle              |  4 +--
 test/immutable-collections-patch/build.gradle |  4 +--
 test/logger-usage/build.gradle                |  6 ++--
 8 files changed, 26 insertions(+), 36 deletions(-)
 create mode 100644 docs/changelog/118094.yaml

diff --git a/distribution/tools/plugin-cli/build.gradle b/distribution/tools/plugin-cli/build.gradle
index 57750f2162a71..dc2bcd96b8d9f 100644
--- a/distribution/tools/plugin-cli/build.gradle
+++ b/distribution/tools/plugin-cli/build.gradle
@@ -25,8 +25,8 @@ dependencies {
   implementation project(":libs:plugin-api")
   implementation project(":libs:plugin-scanner")
   // TODO: asm is picked up from the plugin scanner, we should consolidate so it is not defined twice
-  implementation 'org.ow2.asm:asm:9.7'
-  implementation 'org.ow2.asm:asm-tree:9.7'
+  implementation 'org.ow2.asm:asm:9.7.1'
+  implementation 'org.ow2.asm:asm-tree:9.7.1'
 
   api "org.bouncycastle:bcpg-fips:1.0.7.1"
   api "org.bouncycastle:bc-fips:1.0.2.5"
diff --git a/docs/changelog/118094.yaml b/docs/changelog/118094.yaml
new file mode 100644
index 0000000000000..a8866543fa7d2
--- /dev/null
+++ b/docs/changelog/118094.yaml
@@ -0,0 +1,5 @@
+pr: 118094
+summary: Update ASM 9.7 -> 9.7.1 to support JDK 24
+area: Infra/Core
+type: upgrade
+issues: []
diff --git a/gradle/verification-metadata.xml b/gradle/verification-metadata.xml
index 37178fd9439d0..9189d2a27f3f3 100644
--- a/gradle/verification-metadata.xml
+++ b/gradle/verification-metadata.xml
@@ -4383,11 +4383,6 @@
             <sha256 value="3c6fac2424db3d4a853b669f4e3d1d9c3c552235e19a319673f887083c2303a1" origin="Generated by Gradle"/>
          </artifact>
       </component>
-      <component group="org.ow2.asm" name="asm" version="9.7">
-         <artifact name="asm-9.7.jar">
-            <sha256 value="adf46d5e34940bdf148ecdd26a9ee8eea94496a72034ff7141066b3eea5c4e9d" origin="Generated by Gradle"/>
-         </artifact>
-      </component>
       <component group="org.ow2.asm" name="asm" version="9.7.1">
          <artifact name="asm-9.7.1.jar">
             <sha256 value="8cadd43ac5eb6d09de05faecca38b917a040bb9139c7edeb4cc81c740b713281" origin="Generated by Gradle"/>
@@ -4408,9 +4403,9 @@
             <sha256 value="878fbe521731c072d14d2d65b983b1beae6ad06fda0007b6a8bae81f73f433c4" origin="Generated by Gradle"/>
          </artifact>
       </component>
-      <component group="org.ow2.asm" name="asm-analysis" version="9.7">
-         <artifact name="asm-analysis-9.7.jar">
-            <sha256 value="7bc6bcbc21379948a0c8c467fb0f864206e5b818f6bc0b546872f5c9f941556f" origin="Generated by Gradle"/>
+      <component group="org.ow2.asm" name="asm-analysis" version="9.7.1">
+         <artifact name="asm-analysis-9.7.1.jar">
+            <sha256 value="85b29371884ba31bb76edf22323c2c24e172c3267a67152eba3d1ccc2e041ef2" origin="Generated by Gradle"/>
          </artifact>
       </component>
       <component group="org.ow2.asm" name="asm-commons" version="7.2">
@@ -4433,11 +4428,6 @@
             <sha256 value="0c128a9ec3f33c98959272f6d16cf14247b508f58951574bcdbd2b56d6326364" origin="Generated by Gradle"/>
          </artifact>
       </component>
-      <component group="org.ow2.asm" name="asm-commons" version="9.7">
-         <artifact name="asm-commons-9.7.jar">
-            <sha256 value="389bc247958e049fc9a0408d398c92c6d370c18035120395d4cba1d9d9304b7a" origin="Generated by Gradle"/>
-         </artifact>
-      </component>
       <component group="org.ow2.asm" name="asm-commons" version="9.7.1">
          <artifact name="asm-commons-9.7.1.jar">
             <sha256 value="9a579b54d292ad9be171d4313fd4739c635592c2b5ac3a459bbd1049cddec6a0" origin="Generated by Gradle"/>
@@ -4478,11 +4468,6 @@
             <sha256 value="c43ecf17b539c777e15da7b5b86553b377e2d39a683de6285567d5283888e7ef" origin="Generated by Gradle"/>
          </artifact>
       </component>
-      <component group="org.ow2.asm" name="asm-tree" version="9.7">
-         <artifact name="asm-tree-9.7.jar">
-            <sha256 value="62f4b3bc436045c1acb5c3ba2d8ec556ec3369093d7f5d06c747eb04b56d52b1" origin="Generated by Gradle"/>
-         </artifact>
-      </component>
       <component group="org.ow2.asm" name="asm-tree" version="9.7.1">
          <artifact name="asm-tree-9.7.1.jar">
             <sha256 value="9929881f59eb6b840e86d54570c77b59ce721d104e6dfd7a40978991c2d3b41f" origin="Generated by Gradle"/>
@@ -4493,11 +4478,11 @@
             <sha256 value="6e24913b021ffacfe8e7e053d6e0ccc731941148cfa078d4f1ed3d96904530f8" origin="Generated by Gradle"/>
          </artifact>
       </component>
-      <component group="org.ow2.asm" name="asm-util" version="9.7">
-         <artifact name="asm-util-9.7.jar">
-            <sha256 value="37a6414d36641973f1af104937c95d6d921b2ddb4d612c66c5a9f2b13fc14211" origin="Generated by Gradle"/>
-         </artifact>
-      </component>
+       <component group="org.ow2.asm" name="asm-util" version="9.7.1">
+           <artifact name="asm-util-9.7.1.jar">
+               <sha256 value="f885be71b5c90556f5f1ad1c4f9276b29b96057c497d46666fe4ddbec3cb43c6" origin="Generated by Gradle"/>
+           </artifact>
+       </component>
       <component group="org.reactivestreams" name="reactive-streams" version="1.0.4">
          <artifact name="reactive-streams-1.0.4.jar">
             <sha256 value="f75ca597789b3dac58f61857b9ac2e1034a68fa672db35055a8fb4509e325f28" origin="Generated by Gradle"/>
diff --git a/libs/entitlement/asm-provider/build.gradle b/libs/entitlement/asm-provider/build.gradle
index 5f968629fe557..dcec0579a5bae 100644
--- a/libs/entitlement/asm-provider/build.gradle
+++ b/libs/entitlement/asm-provider/build.gradle
@@ -11,10 +11,10 @@ apply plugin: 'elasticsearch.build'
 
 dependencies {
   compileOnly project(':libs:entitlement')
-  implementation 'org.ow2.asm:asm:9.7'
+  implementation 'org.ow2.asm:asm:9.7.1'
   testImplementation project(":test:framework")
   testImplementation project(":libs:entitlement:bridge")
-  testImplementation 'org.ow2.asm:asm-util:9.7'
+  testImplementation 'org.ow2.asm:asm-util:9.7.1'
 }
 
 tasks.named('test').configure {
diff --git a/libs/entitlement/tools/securitymanager-scanner/build.gradle b/libs/entitlement/tools/securitymanager-scanner/build.gradle
index 8d035c9e847c6..ebb671e5487ef 100644
--- a/libs/entitlement/tools/securitymanager-scanner/build.gradle
+++ b/libs/entitlement/tools/securitymanager-scanner/build.gradle
@@ -47,8 +47,8 @@ repositories {
 
 dependencies {
   compileOnly(project(':libs:core'))
-  implementation 'org.ow2.asm:asm:9.7'
-  implementation 'org.ow2.asm:asm-util:9.7'
+  implementation 'org.ow2.asm:asm:9.7.1'
+  implementation 'org.ow2.asm:asm-util:9.7.1'
   implementation(project(':libs:entitlement:tools:common'))
 }
 
diff --git a/libs/plugin-scanner/build.gradle b/libs/plugin-scanner/build.gradle
index d04af0624b3b1..44e6853140a5b 100644
--- a/libs/plugin-scanner/build.gradle
+++ b/libs/plugin-scanner/build.gradle
@@ -20,8 +20,8 @@ dependencies {
   api project(':libs:plugin-api')
   api project(":libs:x-content")
 
-  api 'org.ow2.asm:asm:9.7'
-  api 'org.ow2.asm:asm-tree:9.7'
+  api 'org.ow2.asm:asm:9.7.1'
+  api 'org.ow2.asm:asm-tree:9.7.1'
 
   testImplementation "junit:junit:${versions.junit}"
   testImplementation(project(":test:framework")) {
diff --git a/test/immutable-collections-patch/build.gradle b/test/immutable-collections-patch/build.gradle
index 85a199af2d477..852a19116fb71 100644
--- a/test/immutable-collections-patch/build.gradle
+++ b/test/immutable-collections-patch/build.gradle
@@ -17,8 +17,8 @@ configurations {
 }
 
 dependencies {
-  implementation 'org.ow2.asm:asm:9.7'
-  implementation 'org.ow2.asm:asm-tree:9.7'
+  implementation 'org.ow2.asm:asm:9.7.1'
+  implementation 'org.ow2.asm:asm-tree:9.7.1'
 }
 
 def outputDir = layout.buildDirectory.dir("jdk-patches")
diff --git a/test/logger-usage/build.gradle b/test/logger-usage/build.gradle
index 8677b1404a727..6d6c5ff889a45 100644
--- a/test/logger-usage/build.gradle
+++ b/test/logger-usage/build.gradle
@@ -10,9 +10,9 @@
 apply plugin: 'elasticsearch.java'
 
 dependencies {
-  api 'org.ow2.asm:asm:9.7'
-  api 'org.ow2.asm:asm-tree:9.7'
-  api 'org.ow2.asm:asm-analysis:9.7'
+  api 'org.ow2.asm:asm:9.7.1'
+  api 'org.ow2.asm:asm-tree:9.7.1'
+  api 'org.ow2.asm:asm-analysis:9.7.1'
   api "org.apache.logging.log4j:log4j-api:${versions.log4j}"
   testImplementation project(":test:framework")
 }

From 91605860ee9a112815cb20915d07551cefa4d63f Mon Sep 17 00:00:00 2001
From: Tommaso Teofili <tommaso.teofili@elastic.co>
Date: Fri, 6 Dec 2024 08:42:48 +0100
Subject: [PATCH 067/119] Term query for ES|QL (#117359)

This commit adds a `term` function for ES|QL to run `TermQueries`.

For example:
FROM test | WHERE term(content, "dog")
---
 docs/changelog/117359.yaml                    |   5 +
 .../esql/functions/description/term.asciidoc  |   5 +
 .../esql/functions/examples/term.asciidoc     |  13 ++
 .../functions/kibana/definition/term.json     |  85 ++++++++
 .../esql/functions/kibana/docs/term.md        |  13 ++
 .../esql/functions/layout/term.asciidoc       |  17 ++
 .../esql/functions/parameters/term.asciidoc   |   9 +
 .../esql/functions/signature/term.svg         |   1 +
 .../esql/functions/types/term.asciidoc        |  12 +
 .../src/main/resources/term-function.csv-spec | 206 ++++++++++++++++++
 .../xpack/esql/plugin/TermIT.java             | 139 ++++++++++++
 .../xpack/esql/action/EsqlCapabilities.java   |   7 +-
 .../xpack/esql/analysis/Verifier.java         |   9 +
 .../function/EsqlFunctionRegistry.java        |   4 +-
 .../function/fulltext/FullTextWritables.java  |   3 +
 .../expression/function/fulltext/Term.java    | 124 +++++++++++
 .../physical/local/PushFiltersToSource.java   |   3 +
 .../planner/EsqlExpressionTranslators.java    |  10 +
 .../elasticsearch/xpack/esql/CsvTests.java    |   4 +
 .../xpack/esql/analysis/VerifierTests.java    |  54 +++++
 .../function/fulltext/TermTests.java          | 132 +++++++++++
 .../LocalPhysicalPlanOptimizerTests.java      |  29 +++
 .../rest-api-spec/test/esql/60_usage.yml      |   2 +-
 23 files changed, 883 insertions(+), 3 deletions(-)
 create mode 100644 docs/changelog/117359.yaml
 create mode 100644 docs/reference/esql/functions/description/term.asciidoc
 create mode 100644 docs/reference/esql/functions/examples/term.asciidoc
 create mode 100644 docs/reference/esql/functions/kibana/definition/term.json
 create mode 100644 docs/reference/esql/functions/kibana/docs/term.md
 create mode 100644 docs/reference/esql/functions/layout/term.asciidoc
 create mode 100644 docs/reference/esql/functions/parameters/term.asciidoc
 create mode 100644 docs/reference/esql/functions/signature/term.svg
 create mode 100644 docs/reference/esql/functions/types/term.asciidoc
 create mode 100644 x-pack/plugin/esql/qa/testFixtures/src/main/resources/term-function.csv-spec
 create mode 100644 x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/plugin/TermIT.java
 create mode 100644 x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/fulltext/Term.java
 create mode 100644 x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/fulltext/TermTests.java

diff --git a/docs/changelog/117359.yaml b/docs/changelog/117359.yaml
new file mode 100644
index 0000000000000..87d2d828ace54
--- /dev/null
+++ b/docs/changelog/117359.yaml
@@ -0,0 +1,5 @@
+pr: 117359
+summary: Term query for ES|QL
+area: ES|QL
+type: enhancement
+issues: []
diff --git a/docs/reference/esql/functions/description/term.asciidoc b/docs/reference/esql/functions/description/term.asciidoc
new file mode 100644
index 0000000000000..c43aeb25a0ef7
--- /dev/null
+++ b/docs/reference/esql/functions/description/term.asciidoc
@@ -0,0 +1,5 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Description*
+
+Performs a Term query on the specified field. Returns true if the provided term matches the row.
diff --git a/docs/reference/esql/functions/examples/term.asciidoc b/docs/reference/esql/functions/examples/term.asciidoc
new file mode 100644
index 0000000000000..b9d57f366294b
--- /dev/null
+++ b/docs/reference/esql/functions/examples/term.asciidoc
@@ -0,0 +1,13 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Example*
+
+[source.merge.styled,esql]
+----
+include::{esql-specs}/term-function.csv-spec[tag=term-with-field]
+----
+[%header.monospaced.styled,format=dsv,separator=|]
+|===
+include::{esql-specs}/term-function.csv-spec[tag=term-with-field-result]
+|===
+
diff --git a/docs/reference/esql/functions/kibana/definition/term.json b/docs/reference/esql/functions/kibana/definition/term.json
new file mode 100644
index 0000000000000..d8bb61fd596a1
--- /dev/null
+++ b/docs/reference/esql/functions/kibana/definition/term.json
@@ -0,0 +1,85 @@
+{
+  "comment" : "This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.",
+  "type" : "eval",
+  "name" : "term",
+  "description" : "Performs a Term query on the specified field. Returns true if the provided term matches the row.",
+  "signatures" : [
+    {
+      "params" : [
+        {
+          "name" : "field",
+          "type" : "keyword",
+          "optional" : false,
+          "description" : "Field that the query will target."
+        },
+        {
+          "name" : "query",
+          "type" : "keyword",
+          "optional" : false,
+          "description" : "Term you wish to find in the provided field."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    },
+    {
+      "params" : [
+        {
+          "name" : "field",
+          "type" : "keyword",
+          "optional" : false,
+          "description" : "Field that the query will target."
+        },
+        {
+          "name" : "query",
+          "type" : "text",
+          "optional" : false,
+          "description" : "Term you wish to find in the provided field."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    },
+    {
+      "params" : [
+        {
+          "name" : "field",
+          "type" : "text",
+          "optional" : false,
+          "description" : "Field that the query will target."
+        },
+        {
+          "name" : "query",
+          "type" : "keyword",
+          "optional" : false,
+          "description" : "Term you wish to find in the provided field."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    },
+    {
+      "params" : [
+        {
+          "name" : "field",
+          "type" : "text",
+          "optional" : false,
+          "description" : "Field that the query will target."
+        },
+        {
+          "name" : "query",
+          "type" : "text",
+          "optional" : false,
+          "description" : "Term you wish to find in the provided field."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    }
+  ],
+  "examples" : [
+    "from books \n| where term(author, \"gabriel\")  \n| keep book_no, title\n| limit 3;"
+  ],
+  "preview" : true,
+  "snapshot_only" : true
+}
diff --git a/docs/reference/esql/functions/kibana/docs/term.md b/docs/reference/esql/functions/kibana/docs/term.md
new file mode 100644
index 0000000000000..83e61a949208d
--- /dev/null
+++ b/docs/reference/esql/functions/kibana/docs/term.md
@@ -0,0 +1,13 @@
+<!--
+This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+-->
+
+### TERM
+Performs a Term query on the specified field. Returns true if the provided term matches the row.
+
+```
+from books 
+| where term(author, "gabriel")  
+| keep book_no, title
+| limit 3;
+```
diff --git a/docs/reference/esql/functions/layout/term.asciidoc b/docs/reference/esql/functions/layout/term.asciidoc
new file mode 100644
index 0000000000000..1fe94491bed04
--- /dev/null
+++ b/docs/reference/esql/functions/layout/term.asciidoc
@@ -0,0 +1,17 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+[discrete]
+[[esql-term]]
+=== `TERM`
+
+preview::["Do not use on production environments. This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features."]
+
+*Syntax*
+
+[.text-center]
+image::esql/functions/signature/term.svg[Embedded,opts=inline]
+
+include::../parameters/term.asciidoc[]
+include::../description/term.asciidoc[]
+include::../types/term.asciidoc[]
+include::../examples/term.asciidoc[]
diff --git a/docs/reference/esql/functions/parameters/term.asciidoc b/docs/reference/esql/functions/parameters/term.asciidoc
new file mode 100644
index 0000000000000..edba8625d04c5
--- /dev/null
+++ b/docs/reference/esql/functions/parameters/term.asciidoc
@@ -0,0 +1,9 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Parameters*
+
+`field`::
+Field that the query will target.
+
+`query`::
+Term you wish to find in the provided field.
diff --git a/docs/reference/esql/functions/signature/term.svg b/docs/reference/esql/functions/signature/term.svg
new file mode 100644
index 0000000000000..955dd7fa215ab
--- /dev/null
+++ b/docs/reference/esql/functions/signature/term.svg
@@ -0,0 +1 @@
+<svg version="1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://www.w3.org/2000/svg" width="384" height="46" viewbox="0 0 384 46"><defs><style type="text/css">#guide .c{fill:none;stroke:#222222;}#guide .k{fill:#000000;font-family:Roboto Mono,Sans-serif;font-size:20px;}#guide .s{fill:#e4f4ff;stroke:#222222;}#guide .syn{fill:#8D8D8D;font-family:Roboto Mono,Sans-serif;font-size:20px;}</style></defs><path class="c" d="M0 31h5m68 0h10m32 0h10m80 0h10m32 0h10m80 0h10m32 0h5"/><rect class="s" x="5" y="5" width="68" height="36"/><text class="k" x="15" y="31">TERM</text><rect class="s" x="83" y="5" width="32" height="36" rx="7"/><text class="syn" x="93" y="31">(</text><rect class="s" x="125" y="5" width="80" height="36" rx="7"/><text class="k" x="135" y="31">field</text><rect class="s" x="215" y="5" width="32" height="36" rx="7"/><text class="syn" x="225" y="31">,</text><rect class="s" x="257" y="5" width="80" height="36" rx="7"/><text class="k" x="267" y="31">query</text><rect class="s" x="347" y="5" width="32" height="36" rx="7"/><text class="syn" x="357" y="31">)</text></svg>
\ No newline at end of file
diff --git a/docs/reference/esql/functions/types/term.asciidoc b/docs/reference/esql/functions/types/term.asciidoc
new file mode 100644
index 0000000000000..7523b29c62b1d
--- /dev/null
+++ b/docs/reference/esql/functions/types/term.asciidoc
@@ -0,0 +1,12 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Supported types*
+
+[%header.monospaced.styled,format=dsv,separator=|]
+|===
+field | query | result
+keyword | keyword | boolean
+keyword | text | boolean
+text | keyword | boolean
+text | text | boolean
+|===
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/term-function.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/term-function.csv-spec
new file mode 100644
index 0000000000000..0c72cad02eed1
--- /dev/null
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/term-function.csv-spec
@@ -0,0 +1,206 @@
+###############################################
+# Tests for Term function
+#
+
+termWithTextField
+required_capability: term_function
+
+// tag::term-with-field[]
+FROM books 
+| WHERE TERM(author, "gabriel")  
+| KEEP book_no, title
+| LIMIT 3;
+// end::term-with-field[]
+ignoreOrder:true
+
+book_no:keyword | title:text
+4814            | El Coronel No Tiene Quien Le Escriba / No One Writes to the Colonel (Spanish Edition)
+4917            | Autumn of the Patriarch
+6380            | La hojarasca (Spanish Edition)
+;
+
+termWithKeywordField
+required_capability: term_function
+
+from employees
+| where term(first_name, "Guoxiang")
+| keep emp_no, first_name;
+
+// tag::term-with-keyword-field-result[]
+emp_no:integer | first_name:keyword
+10015            | Guoxiang
+;
+// end::term-with-keyword-field-result[]
+
+termWithQueryExpressions
+required_capability: term_function
+
+from books 
+| where term(author, CONCAT("gab", "riel"))  
+| keep book_no, title;
+ignoreOrder:true
+
+book_no:keyword | title:text
+4814            | El Coronel No Tiene Quien Le Escriba / No One Writes to the Colonel (Spanish Edition)
+4917            | Autumn of the Patriarch
+6380            | La hojarasca (Spanish Edition)
+;
+
+termAfterKeep
+required_capability: term_function
+
+from books 
+| keep book_no, author 
+| where term(author, "faulkner")
+| sort book_no 
+| limit 5;
+
+book_no:keyword | author:text
+2378            | [Carol Faulkner, Holly Byers Ochoa, Lucretia Mott]
+2713            | William Faulkner
+2847            | Colleen Faulkner
+2883            | William Faulkner
+3293            | Danny Faulkner
+;
+
+termAfterDrop
+required_capability: term_function
+
+from books 
+| drop ratings, description, year, publisher, title, author.keyword
+| where term(author, "william")
+| keep book_no, author
+| sort book_no 
+| limit 2;
+
+book_no:keyword | author:text
+2713            | William Faulkner
+2883            | William Faulkner
+;
+
+termAfterEval
+required_capability: term_function
+
+from books 
+| eval stars = to_long(ratings / 2.0) 
+| where term(author, "colleen")
+| sort book_no 
+| keep book_no, author, stars
+| limit 2;
+
+book_no:keyword | author:text      | stars:long
+2847            | Colleen Faulkner | 3
+4502            | Colleen Faulkner | 3
+;
+
+termWithConjunction
+required_capability: term_function
+
+from books 
+| where term(author, "tolkien") and ratings > 4.95
+| eval author = mv_sort(author)
+| keep book_no, ratings, author;
+ignoreOrder:true
+
+book_no:keyword | ratings:double | author:keyword
+2301            | 5.0            | John Ronald Reuel Tolkien    
+3254            | 5.0            | [Christopher Tolkien, John Ronald Reuel Tolkien]
+7350            | 5.0            | [Christopher Tolkien, John Ronald Reuel Tolkien]
+;
+
+termWithConjunctionAndSort
+required_capability: term_function
+
+from books 
+| where term(author, "tolkien") and ratings > 4.95
+| eval author = mv_sort(author)
+| keep book_no, ratings, author
+| sort book_no;
+
+book_no:keyword | ratings:double | author:keyword
+2301            | 5.0            | John Ronald Reuel Tolkien    
+3254            | 5.0            | [Christopher Tolkien, John Ronald Reuel Tolkien]
+7350            | 5.0            | [Christopher Tolkien, John Ronald Reuel Tolkien]
+;
+
+termWithFunctionPushedToLucene
+required_capability: term_function
+
+from hosts 
+| where term(host, "beta") and cidr_match(ip1, "127.0.0.2/32", "127.0.0.3/32") 
+| keep card, host, ip0, ip1;
+ignoreOrder:true
+
+card:keyword   |host:keyword   |ip0:ip                   |ip1:ip
+eth1           |beta           |127.0.0.1                |127.0.0.2
+;
+
+termWithNonPushableConjunction
+required_capability: term_function
+
+from books 
+| where term(title, "rings") and length(title) > 75
+| keep book_no, title;
+ignoreOrder:true
+
+book_no:keyword | title:text
+4023            | A Tolkien Compass: Including J. R. R. Tolkien's Guide to the Names in The Lord of the Rings
+;
+
+termWithMultipleWhereClauses
+required_capability: term_function
+
+from books 
+| where term(title, "rings") 
+| where term(title, "lord") 
+| keep book_no, title;
+ignoreOrder:true
+
+book_no:keyword | title:text
+2675            | The Lord of the Rings - Boxed Set           
+2714            | Return of the King Being the Third Part of The Lord of the Rings
+4023            | A Tolkien Compass: Including J. R. R. Tolkien's Guide to the Names in The Lord of the Rings
+7140            | The Lord of the Rings Poster Collection: Six Paintings by Alan Lee (No. 1)
+;
+
+termWithMultivaluedField
+required_capability: term_function
+
+from employees 
+| where term(job_positions, "Data Scientist") 
+| keep emp_no, first_name, last_name
+| sort emp_no asc
+| limit 2;
+ignoreOrder:true
+
+emp_no:integer | first_name:keyword | last_name:keyword
+10014          | Berni              | Genin    
+10017          | Cristinel          | Bouloucos       
+;
+
+testWithMultiValuedFieldWithConjunction
+required_capability: term_function
+
+from employees 
+| where term(job_positions, "Data Scientist") and term(first_name, "Cristinel")
+| keep emp_no, first_name, last_name
+| limit 1;
+
+emp_no:integer | first_name:keyword | last_name:keyword  
+10017          | Cristinel          | Bouloucos
+;
+
+termWithConjQueryStringFunctions
+required_capability: term_function
+required_capability: qstr_function
+
+from employees 
+| where term(job_positions, "Data Scientist") and qstr("first_name: Cristinel and gender: F")
+| keep emp_no, first_name, last_name
+| sort emp_no ASC
+| limit 1;
+ignoreOrder:true
+
+emp_no:integer | first_name:keyword | last_name:keyword  
+10017          | Cristinel          | Bouloucos
+;
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/plugin/TermIT.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/plugin/TermIT.java
new file mode 100644
index 0000000000000..4bb4897c9db5f
--- /dev/null
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/plugin/TermIT.java
@@ -0,0 +1,139 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.plugin;
+
+import org.elasticsearch.action.index.IndexRequest;
+import org.elasticsearch.action.support.WriteRequest;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.xpack.esql.VerificationException;
+import org.elasticsearch.xpack.esql.action.AbstractEsqlIntegTestCase;
+import org.elasticsearch.xpack.esql.action.EsqlCapabilities;
+import org.elasticsearch.xpack.esql.action.EsqlQueryRequest;
+import org.elasticsearch.xpack.esql.action.EsqlQueryResponse;
+import org.junit.Before;
+
+import java.util.List;
+
+import static org.elasticsearch.test.hamcrest.ElasticsearchAssertions.assertAcked;
+import static org.hamcrest.CoreMatchers.containsString;
+
+public class TermIT extends AbstractEsqlIntegTestCase {
+
+    @Before
+    public void setupIndex() {
+        createAndPopulateIndex();
+    }
+
+    @Override
+    protected EsqlQueryResponse run(EsqlQueryRequest request) {
+        assumeTrue("term function capability not available", EsqlCapabilities.Cap.TERM_FUNCTION.isEnabled());
+        return super.run(request);
+    }
+
+    public void testSimpleTermQuery() throws Exception {
+        var query = """
+            FROM test
+            | WHERE term(content,"dog")
+            | KEEP id
+            | SORT id
+            """;
+
+        try (var resp = run(query)) {
+            assertColumnNames(resp.columns(), List.of("id"));
+            assertColumnTypes(resp.columns(), List.of("integer"));
+            assertValues(resp.values(), List.of(List.of(1), List.of(3), List.of(4), List.of(5)));
+        }
+    }
+
+    public void testTermWithinEval() {
+        var query = """
+            FROM test
+            | EVAL term_query = term(title,"fox")
+            """;
+
+        var error = expectThrows(VerificationException.class, () -> run(query));
+        assertThat(error.getMessage(), containsString("[Term] function is only supported in WHERE commands"));
+    }
+
+    public void testMultipleTerm() {
+        var query = """
+            FROM test
+            | WHERE term(content,"fox") AND term(content,"brown")
+            | KEEP id
+            | SORT id
+            """;
+
+        try (var resp = run(query)) {
+            assertColumnNames(resp.columns(), List.of("id"));
+            assertColumnTypes(resp.columns(), List.of("integer"));
+            assertValues(resp.values(), List.of(List.of(2), List.of(4), List.of(5)));
+        }
+    }
+
+    public void testNotWhereTerm() {
+        var query = """
+            FROM test
+            | WHERE NOT term(content,"brown")
+            | KEEP id
+            | SORT id
+            """;
+
+        try (var resp = run(query)) {
+            assertColumnNames(resp.columns(), List.of("id"));
+            assertColumnTypes(resp.columns(), List.of("integer"));
+            assertValues(resp.values(), List.of(List.of(3)));
+        }
+    }
+
+    private void createAndPopulateIndex() {
+        var indexName = "test";
+        var client = client().admin().indices();
+        var CreateRequest = client.prepareCreate(indexName)
+            .setSettings(Settings.builder().put("index.number_of_shards", 1))
+            .setMapping("id", "type=integer", "content", "type=text");
+        assertAcked(CreateRequest);
+        client().prepareBulk()
+            .add(
+                new IndexRequest(indexName).id("1")
+                    .source("id", 1, "content", "The quick brown animal swiftly jumps over a lazy dog", "title", "A Swift Fox's Journey")
+            )
+            .add(
+                new IndexRequest(indexName).id("2")
+                    .source("id", 2, "content", "A speedy brown fox hops effortlessly over a sluggish canine", "title", "The Fox's Leap")
+            )
+            .add(
+                new IndexRequest(indexName).id("3")
+                    .source("id", 3, "content", "Quick and nimble, the fox vaults over the lazy dog", "title", "Brown Fox in Action")
+            )
+            .add(
+                new IndexRequest(indexName).id("4")
+                    .source(
+                        "id",
+                        4,
+                        "content",
+                        "A fox that is quick and brown jumps over a dog that is quite lazy",
+                        "title",
+                        "Speedy Animals"
+                    )
+            )
+            .add(
+                new IndexRequest(indexName).id("5")
+                    .source(
+                        "id",
+                        5,
+                        "content",
+                        "With agility, a quick brown fox bounds over a slow-moving dog",
+                        "title",
+                        "Foxes and Canines"
+                    )
+            )
+            .setRefreshPolicy(WriteRequest.RefreshPolicy.IMMEDIATE)
+            .get();
+        ensureYellow(indexName);
+    }
+}
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
index 19ba6a5151eaf..ee3f5be185b4f 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
@@ -550,7 +550,12 @@ public enum Cap {
         /**
          * Support the "METADATA _score" directive to enable _score column.
          */
-        METADATA_SCORE(Build.current().isSnapshot());
+        METADATA_SCORE(Build.current().isSnapshot()),
+
+        /**
+         * Term function
+         */
+        TERM_FUNCTION(Build.current().isSnapshot());
 
         private final boolean enabled;
 
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java
index f5fd82d742bc7..d6f0ff766eb40 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java
@@ -36,6 +36,7 @@
 import org.elasticsearch.xpack.esql.expression.function.fulltext.Kql;
 import org.elasticsearch.xpack.esql.expression.function.fulltext.Match;
 import org.elasticsearch.xpack.esql.expression.function.fulltext.QueryString;
+import org.elasticsearch.xpack.esql.expression.function.fulltext.Term;
 import org.elasticsearch.xpack.esql.expression.function.grouping.Categorize;
 import org.elasticsearch.xpack.esql.expression.function.grouping.GroupingFunction;
 import org.elasticsearch.xpack.esql.expression.predicate.operator.arithmetic.Neg;
@@ -837,6 +838,14 @@ private static void checkFullTextQueryFunctions(LogicalPlan plan, Set<Failure> f
                 m -> "[" + m.functionName() + "] " + m.functionType(),
                 failures
             );
+            checkCommandsBeforeExpression(
+                plan,
+                condition,
+                Term.class,
+                lp -> (lp instanceof Limit == false) && (lp instanceof Aggregate == false),
+                m -> "[" + m.functionName() + "] " + m.functionType(),
+                failures
+            );
             checkNotPresentInDisjunctions(condition, ftf -> "[" + ftf.functionName() + "] " + ftf.functionType(), failures);
             checkFullTextFunctionsParents(condition, failures);
         } else {
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java
index c66a5293eb14a..3749b46879354 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java
@@ -36,6 +36,7 @@
 import org.elasticsearch.xpack.esql.expression.function.fulltext.Kql;
 import org.elasticsearch.xpack.esql.expression.function.fulltext.Match;
 import org.elasticsearch.xpack.esql.expression.function.fulltext.QueryString;
+import org.elasticsearch.xpack.esql.expression.function.fulltext.Term;
 import org.elasticsearch.xpack.esql.expression.function.grouping.Bucket;
 import org.elasticsearch.xpack.esql.expression.function.grouping.Categorize;
 import org.elasticsearch.xpack.esql.expression.function.scalar.conditional.Case;
@@ -424,7 +425,8 @@ private static FunctionDefinition[][] snapshotFunctions() {
                 // This is an experimental function and can be removed without notice.
                 def(Delay.class, Delay::new, "delay"),
                 def(Kql.class, Kql::new, "kql"),
-                def(Rate.class, Rate::withUnresolvedTimestamp, "rate") } };
+                def(Rate.class, Rate::withUnresolvedTimestamp, "rate"),
+                def(Term.class, Term::new, "term") } };
     }
 
     public EsqlFunctionRegistry snapshotRegistry() {
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/fulltext/FullTextWritables.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/fulltext/FullTextWritables.java
index 8804a031de78c..d6b79d16b74f6 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/fulltext/FullTextWritables.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/fulltext/FullTextWritables.java
@@ -29,6 +29,9 @@ public static List<NamedWriteableRegistry.Entry> getNamedWriteables() {
         if (EsqlCapabilities.Cap.KQL_FUNCTION.isEnabled()) {
             entries.add(Kql.ENTRY);
         }
+        if (EsqlCapabilities.Cap.TERM_FUNCTION.isEnabled()) {
+            entries.add(Term.ENTRY);
+        }
 
         return Collections.unmodifiableList(entries);
     }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/fulltext/Term.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/fulltext/Term.java
new file mode 100644
index 0000000000000..125a5b02b6e1c
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/fulltext/Term.java
@@ -0,0 +1,124 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.expression.function.fulltext;
+
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.xpack.esql.capabilities.Validatable;
+import org.elasticsearch.xpack.esql.common.Failure;
+import org.elasticsearch.xpack.esql.common.Failures;
+import org.elasticsearch.xpack.esql.core.expression.Expression;
+import org.elasticsearch.xpack.esql.core.expression.FieldAttribute;
+import org.elasticsearch.xpack.esql.core.expression.TypeResolutions;
+import org.elasticsearch.xpack.esql.core.querydsl.query.TermQuery;
+import org.elasticsearch.xpack.esql.core.tree.NodeInfo;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.expression.function.Example;
+import org.elasticsearch.xpack.esql.expression.function.FunctionInfo;
+import org.elasticsearch.xpack.esql.expression.function.Param;
+import org.elasticsearch.xpack.esql.io.stream.PlanStreamInput;
+
+import java.io.IOException;
+import java.util.List;
+
+import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.FIRST;
+import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.ParamOrdinal.SECOND;
+import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.isNotNull;
+import static org.elasticsearch.xpack.esql.core.expression.TypeResolutions.isString;
+
+/**
+ * Full text function that performs a {@link TermQuery} .
+ */
+public class Term extends FullTextFunction implements Validatable {
+
+    public static final NamedWriteableRegistry.Entry ENTRY = new NamedWriteableRegistry.Entry(Expression.class, "Term", Term::readFrom);
+
+    private final Expression field;
+
+    @FunctionInfo(
+        returnType = "boolean",
+        preview = true,
+        description = "Performs a Term query on the specified field. Returns true if the provided term matches the row.",
+        examples = { @Example(file = "term-function", tag = "term-with-field") }
+    )
+    public Term(
+        Source source,
+        @Param(name = "field", type = { "keyword", "text" }, description = "Field that the query will target.") Expression field,
+        @Param(
+            name = "query",
+            type = { "keyword", "text" },
+            description = "Term you wish to find in the provided field."
+        ) Expression termQuery
+    ) {
+        super(source, termQuery, List.of(field, termQuery));
+        this.field = field;
+    }
+
+    private static Term readFrom(StreamInput in) throws IOException {
+        Source source = Source.readFrom((PlanStreamInput) in);
+        Expression field = in.readNamedWriteable(Expression.class);
+        Expression query = in.readNamedWriteable(Expression.class);
+        return new Term(source, field, query);
+    }
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+        source().writeTo(out);
+        out.writeNamedWriteable(field());
+        out.writeNamedWriteable(query());
+    }
+
+    @Override
+    public String getWriteableName() {
+        return ENTRY.name;
+    }
+
+    @Override
+    protected TypeResolution resolveNonQueryParamTypes() {
+        return isNotNull(field, sourceText(), FIRST).and(isString(field, sourceText(), FIRST)).and(super.resolveNonQueryParamTypes());
+    }
+
+    @Override
+    public void validate(Failures failures) {
+        if (field instanceof FieldAttribute == false) {
+            failures.add(
+                Failure.fail(
+                    field,
+                    "[{}] {} cannot operate on [{}], which is not a field from an index mapping",
+                    functionName(),
+                    functionType(),
+                    field.sourceText()
+                )
+            );
+        }
+    }
+
+    @Override
+    public Expression replaceChildren(List<Expression> newChildren) {
+        return new Term(source(), newChildren.get(0), newChildren.get(1));
+    }
+
+    @Override
+    protected NodeInfo<? extends Expression> info() {
+        return NodeInfo.create(this, Term::new, field, query());
+    }
+
+    protected TypeResolutions.ParamOrdinal queryParamOrdinal() {
+        return SECOND;
+    }
+
+    public Expression field() {
+        return field;
+    }
+
+    @Override
+    public String functionName() {
+        return ENTRY.name;
+    }
+}
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/physical/local/PushFiltersToSource.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/physical/local/PushFiltersToSource.java
index 3d6c35e914294..9d02af0efbab0 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/physical/local/PushFiltersToSource.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/physical/local/PushFiltersToSource.java
@@ -32,6 +32,7 @@
 import org.elasticsearch.xpack.esql.core.util.Queries;
 import org.elasticsearch.xpack.esql.expression.function.fulltext.FullTextFunction;
 import org.elasticsearch.xpack.esql.expression.function.fulltext.Match;
+import org.elasticsearch.xpack.esql.expression.function.fulltext.Term;
 import org.elasticsearch.xpack.esql.expression.function.scalar.ip.CIDRMatch;
 import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.BinarySpatialFunction;
 import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.SpatialRelatesFunction;
@@ -254,6 +255,8 @@ static boolean canPushToSource(Expression exp, LucenePushdownPredicates lucenePu
             return canPushSpatialFunctionToSource(spatial, lucenePushdownPredicates);
         } else if (exp instanceof Match mf) {
             return mf.field() instanceof FieldAttribute && DataType.isString(mf.field().dataType());
+        } else if (exp instanceof Term term) {
+            return term.field() instanceof FieldAttribute && DataType.isString(term.field().dataType());
         } else if (exp instanceof FullTextFunction) {
             return true;
         }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsqlExpressionTranslators.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsqlExpressionTranslators.java
index 1580b77931240..1aee8f029e474 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsqlExpressionTranslators.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/planner/EsqlExpressionTranslators.java
@@ -37,6 +37,7 @@
 import org.elasticsearch.xpack.esql.expression.function.fulltext.Kql;
 import org.elasticsearch.xpack.esql.expression.function.fulltext.Match;
 import org.elasticsearch.xpack.esql.expression.function.fulltext.QueryString;
+import org.elasticsearch.xpack.esql.expression.function.fulltext.Term;
 import org.elasticsearch.xpack.esql.expression.function.scalar.ip.CIDRMatch;
 import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.SpatialRelatesFunction;
 import org.elasticsearch.xpack.esql.expression.function.scalar.spatial.SpatialRelatesUtils;
@@ -92,6 +93,7 @@ public final class EsqlExpressionTranslators {
         new MatchFunctionTranslator(),
         new QueryStringFunctionTranslator(),
         new KqlFunctionTranslator(),
+        new TermFunctionTranslator(),
         new Scalars()
     );
 
@@ -548,4 +550,12 @@ protected Query asQuery(Kql kqlFunction, TranslatorHandler handler) {
             return new KqlQuery(kqlFunction.source(), kqlFunction.queryAsText());
         }
     }
+
+    public static class TermFunctionTranslator extends ExpressionTranslator<Term> {
+        @Override
+        protected Query asQuery(Term term, TranslatorHandler handler) {
+            return new TermQuery(term.source(), ((FieldAttribute) term.field()).name(), term.queryAsText());
+        }
+    }
+
 }
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
index 2e8b856cf82a6..2834e5f3f8358 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/CsvTests.java
@@ -265,6 +265,10 @@ public final void test() throws Throwable {
                 "lookup join disabled for csv tests",
                 testCase.requiredCapabilities.contains(EsqlCapabilities.Cap.JOIN_LOOKUP_V4.capabilityName())
             );
+            assumeFalse(
+                "can't use TERM function in csv tests",
+                testCase.requiredCapabilities.contains(EsqlCapabilities.Cap.TERM_FUNCTION.capabilityName())
+            );
             if (Build.current().isSnapshot()) {
                 assertThat(
                     "Capability is not included in the enabled list capabilities on a snapshot build. Spelling mistake?",
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
index 882b8b7dbfd7c..7e3ef4f1f5f87 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/analysis/VerifierTests.java
@@ -1337,6 +1337,11 @@ public void testMatchFunctionOnlyAllowedInWhere() throws Exception {
         checkFullTextFunctionsOnlyAllowedInWhere("MATCH", "match(first_name, \"Anna\")", "function");
     }
 
+    public void testTermFunctionOnlyAllowedInWhere() throws Exception {
+        assumeTrue("term function capability not available", EsqlCapabilities.Cap.TERM_FUNCTION.isEnabled());
+        checkFullTextFunctionsOnlyAllowedInWhere("Term", "term(first_name, \"Anna\")", "function");
+    }
+
     public void testMatchOperatornOnlyAllowedInWhere() throws Exception {
         checkFullTextFunctionsOnlyAllowedInWhere(":", "first_name:\"Anna\"", "operator");
     }
@@ -1401,6 +1406,11 @@ public void testMatchFunctionWithDisjunctions() {
         checkWithDisjunctions("MATCH", "match(first_name, \"Anna\")", "function");
     }
 
+    public void testTermFunctionWithDisjunctions() {
+        assumeTrue("term function capability not available", EsqlCapabilities.Cap.TERM_FUNCTION.isEnabled());
+        checkWithDisjunctions("Term", "term(first_name, \"Anna\")", "function");
+    }
+
     public void testMatchOperatorWithDisjunctions() {
         checkWithDisjunctions(":", "first_name : \"Anna\"", "operator");
     }
@@ -1463,6 +1473,11 @@ public void testMatchFunctionWithNonBooleanFunctions() {
         checkFullTextFunctionsWithNonBooleanFunctions("MATCH", "match(first_name, \"Anna\")", "function");
     }
 
+    public void testTermFunctionWithNonBooleanFunctions() {
+        assumeTrue("term function capability not available", EsqlCapabilities.Cap.TERM_FUNCTION.isEnabled());
+        checkFullTextFunctionsWithNonBooleanFunctions("Term", "term(first_name, \"Anna\")", "function");
+    }
+
     public void testMatchOperatorWithNonBooleanFunctions() {
         checkFullTextFunctionsWithNonBooleanFunctions(":", "first_name:\"Anna\"", "operator");
     }
@@ -1563,6 +1578,45 @@ public void testMatchTargetsExistingField() throws Exception {
         assertEquals("1:33: Unknown column [first_name]", error("from test | keep emp_no | where first_name : \"Anna\""));
     }
 
+    public void testTermFunctionArgNotConstant() throws Exception {
+        assumeTrue("term function capability not available", EsqlCapabilities.Cap.TERM_FUNCTION.isEnabled());
+        assertEquals(
+            "1:19: second argument of [term(first_name, first_name)] must be a constant, received [first_name]",
+            error("from test | where term(first_name, first_name)")
+        );
+        assertEquals(
+            "1:59: second argument of [term(first_name, query)] must be a constant, received [query]",
+            error("from test | eval query = concat(\"first\", \" name\") | where term(first_name, query)")
+        );
+        // Other value types are tested in QueryStringFunctionTests
+    }
+
+    // These should pass eventually once we lift some restrictions on match function
+    public void testTermFunctionCurrentlyUnsupportedBehaviour() throws Exception {
+        assumeTrue("term function capability not available", EsqlCapabilities.Cap.TERM_FUNCTION.isEnabled());
+        assertEquals(
+            "1:67: Unknown column [first_name]",
+            error("from test | stats max_salary = max(salary) by emp_no | where term(first_name, \"Anna\")")
+        );
+    }
+
+    public void testTermFunctionNullArgs() throws Exception {
+        assumeTrue("term function capability not available", EsqlCapabilities.Cap.TERM_FUNCTION.isEnabled());
+        assertEquals(
+            "1:19: first argument of [term(null, \"query\")] cannot be null, received [null]",
+            error("from test | where term(null, \"query\")")
+        );
+        assertEquals(
+            "1:19: second argument of [term(first_name, null)] cannot be null, received [null]",
+            error("from test | where term(first_name, null)")
+        );
+    }
+
+    public void testTermTargetsExistingField() throws Exception {
+        assumeTrue("term function capability not available", EsqlCapabilities.Cap.TERM_FUNCTION.isEnabled());
+        assertEquals("1:38: Unknown column [first_name]", error("from test | keep emp_no | where term(first_name, \"Anna\")"));
+    }
+
     public void testCoalesceWithMixedNumericTypes() {
         assertEquals(
             "1:22: second argument of [coalesce(languages, height)] must be [integer], found value [height] type [double]",
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/fulltext/TermTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/fulltext/TermTests.java
new file mode 100644
index 0000000000000..c1c0dc26880ab
--- /dev/null
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/fulltext/TermTests.java
@@ -0,0 +1,132 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.esql.expression.function.fulltext;
+
+import com.carrotsearch.randomizedtesting.annotations.Name;
+import com.carrotsearch.randomizedtesting.annotations.ParametersFactory;
+
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.xpack.core.security.authc.support.mapper.expressiondsl.FieldExpression;
+import org.elasticsearch.xpack.esql.core.expression.Expression;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+import org.elasticsearch.xpack.esql.core.type.DataType;
+import org.elasticsearch.xpack.esql.expression.function.AbstractFunctionTestCase;
+import org.elasticsearch.xpack.esql.expression.function.FunctionName;
+import org.elasticsearch.xpack.esql.expression.function.TestCaseSupplier;
+
+import java.util.ArrayList;
+import java.util.LinkedList;
+import java.util.List;
+import java.util.Set;
+import java.util.function.Supplier;
+
+import static org.hamcrest.Matchers.equalTo;
+
+@FunctionName("term")
+public class TermTests extends AbstractFunctionTestCase {
+
+    public TermTests(@Name("TestCase") Supplier<TestCaseSupplier.TestCase> testCaseSupplier) {
+        this.testCase = testCaseSupplier.get();
+    }
+
+    @ParametersFactory
+    public static Iterable<Object[]> parameters() {
+        List<Set<DataType>> supportedPerPosition = supportedParams();
+        List<TestCaseSupplier> suppliers = new LinkedList<>();
+        for (DataType fieldType : DataType.stringTypes()) {
+            for (DataType queryType : DataType.stringTypes()) {
+                addPositiveTestCase(List.of(fieldType, queryType), suppliers);
+                addNonFieldTestCase(List.of(fieldType, queryType), supportedPerPosition, suppliers);
+            }
+        }
+
+        List<TestCaseSupplier> suppliersWithErrors = errorsForCasesWithoutExamples(suppliers, (v, p) -> "string");
+
+        // Don't test null, as it is not allowed but the expected message is not a type error - so we check it separately in VerifierTests
+        return parameterSuppliersFromTypedData(
+            suppliersWithErrors.stream().filter(s -> s.types().contains(DataType.NULL) == false).toList()
+        );
+    }
+
+    protected static List<Set<DataType>> supportedParams() {
+        Set<DataType> supportedTextParams = Set.of(DataType.KEYWORD, DataType.TEXT);
+        Set<DataType> supportedNumericParams = Set.of(DataType.DOUBLE, DataType.INTEGER);
+        Set<DataType> supportedFuzzinessParams = Set.of(DataType.INTEGER, DataType.KEYWORD, DataType.TEXT);
+        List<Set<DataType>> supportedPerPosition = List.of(
+            supportedTextParams,
+            supportedTextParams,
+            supportedNumericParams,
+            supportedFuzzinessParams
+        );
+        return supportedPerPosition;
+    }
+
+    protected static void addPositiveTestCase(List<DataType> paramDataTypes, List<TestCaseSupplier> suppliers) {
+
+        // Positive case - creates an ES field from the field parameter type
+        suppliers.add(
+            new TestCaseSupplier(
+                getTestCaseName(paramDataTypes, "-ES field"),
+                paramDataTypes,
+                () -> new TestCaseSupplier.TestCase(
+                    getTestParams(paramDataTypes),
+                    "EndsWithEvaluator[str=Attribute[channel=0], suffix=Attribute[channel=1]]",
+                    DataType.BOOLEAN,
+                    equalTo(true)
+                )
+            )
+        );
+    }
+
+    private static void addNonFieldTestCase(
+        List<DataType> paramDataTypes,
+        List<Set<DataType>> supportedPerPosition,
+        List<TestCaseSupplier> suppliers
+    ) {
+        // Negative case - use directly the field parameter type
+        suppliers.add(
+            new TestCaseSupplier(
+                getTestCaseName(paramDataTypes, "-non ES field"),
+                paramDataTypes,
+                typeErrorSupplier(true, supportedPerPosition, paramDataTypes, TermTests::matchTypeErrorSupplier)
+            )
+        );
+    }
+
+    private static List<TestCaseSupplier.TypedData> getTestParams(List<DataType> paramDataTypes) {
+        String fieldName = randomIdentifier();
+        List<TestCaseSupplier.TypedData> params = new ArrayList<>();
+        params.add(
+            new TestCaseSupplier.TypedData(
+                new FieldExpression(fieldName, List.of(new FieldExpression.FieldValue(fieldName))),
+                paramDataTypes.get(0),
+                "field"
+            )
+        );
+        params.add(new TestCaseSupplier.TypedData(new BytesRef(randomAlphaOfLength(10)), paramDataTypes.get(1), "query"));
+        return params;
+    }
+
+    private static String getTestCaseName(List<DataType> paramDataTypes, String fieldType) {
+        StringBuilder sb = new StringBuilder();
+        sb.append("<");
+        sb.append(paramDataTypes.get(0)).append(fieldType).append(", ");
+        sb.append(paramDataTypes.get(1));
+        sb.append(">");
+        return sb.toString();
+    }
+
+    private static String matchTypeErrorSupplier(boolean includeOrdinal, List<Set<DataType>> validPerPosition, List<DataType> types) {
+        return "[] cannot operate on [" + types.getFirst().typeName() + "], which is not a field from an index mapping";
+    }
+
+    @Override
+    protected Expression build(Source source, List<Expression> args) {
+        return new Match(source, args.get(0), args.get(1));
+    }
+}
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LocalPhysicalPlanOptimizerTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LocalPhysicalPlanOptimizerTests.java
index 86f5c812737b1..d32124c1aaf32 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LocalPhysicalPlanOptimizerTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LocalPhysicalPlanOptimizerTests.java
@@ -1391,6 +1391,35 @@ public void testMultipleMatchFilterPushdown() {
         assertThat(actualLuceneQuery.toString(), is(expectedLuceneQuery.toString()));
     }
 
+    /**
+     * Expecting
+     * LimitExec[1000[INTEGER]]
+     * \_ExchangeExec[[_meta_field{f}#8, emp_no{f}#2, first_name{f}#3, gender{f}#4, job{f}#9, job.raw{f}#10, languages{f}#5, last_na
+     * me{f}#6, long_noidx{f}#11, salary{f}#7],false]
+     *   \_ProjectExec[[_meta_field{f}#8, emp_no{f}#2, first_name{f}#3, gender{f}#4, job{f}#9, job.raw{f}#10, languages{f}#5, last_na
+     * me{f}#6, long_noidx{f}#11, salary{f}#7]]
+     *     \_FieldExtractExec[_meta_field{f}#8, emp_no{f}#2, first_name{f}#3, gen]
+     *       \_EsQueryExec[test], indexMode[standard], query[{"term":{"last_name":{"query":"Smith"}}}]
+     */
+    public void testTermFunction() {
+        // Skip test if the term function is not enabled.
+        assumeTrue("term function capability not available", EsqlCapabilities.Cap.TERM_FUNCTION.isEnabled());
+
+        var plan = plannerOptimizer.plan("""
+            from test
+            | where term(last_name, "Smith")
+            """, IS_SV_STATS);
+
+        var limit = as(plan, LimitExec.class);
+        var exchange = as(limit.child(), ExchangeExec.class);
+        var project = as(exchange.child(), ProjectExec.class);
+        var field = as(project.child(), FieldExtractExec.class);
+        var query = as(field.child(), EsQueryExec.class);
+        assertThat(query.limit().fold(), is(1000));
+        var expected = QueryBuilders.termQuery("last_name", "Smith");
+        assertThat(query.query().toString(), is(expected.toString()));
+    }
+
     private QueryBuilder wrapWithSingleQuery(String query, QueryBuilder inner, String fieldName, Source source) {
         return FilterTests.singleValueQuery(query, inner, fieldName, source);
     }
diff --git a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml
index e6c061f44a9e4..81f65668722fc 100644
--- a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml
+++ b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml
@@ -92,7 +92,7 @@ setup:
   - gt: {esql.functions.to_long: $functions_to_long}
   - match: {esql.functions.coalesce: $functions_coalesce}
   # Testing for the entire function set isn't feasbile, so we just check that we return the correct count as an approximation.
-  - length: {esql.functions: 127} # check the "sister" test below for a likely update to the same esql.functions length check
+  - length: {esql.functions: 128} # check the "sister" test below for a likely update to the same esql.functions length check
 
 ---
 "Basic ESQL usage output (telemetry) non-snapshot version":

From f27cb5efd3ffaf9bfe9a2f553aa9abdc39c9b15e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?=
 <istvan.szabo@elastic.co>
Date: Fri, 6 Dec 2024 09:15:15 +0100
Subject: [PATCH 068/119] [DOCS] Adds examples to inference processor docs
 (#116018)

---
 .../ingest/processors/inference.asciidoc      | 67 +++++++++++++++++++
 1 file changed, 67 insertions(+)

diff --git a/docs/reference/ingest/processors/inference.asciidoc b/docs/reference/ingest/processors/inference.asciidoc
index 9c6f0592a1d91..e079b9d665290 100644
--- a/docs/reference/ingest/processors/inference.asciidoc
+++ b/docs/reference/ingest/processors/inference.asciidoc
@@ -735,3 +735,70 @@ You can also specify the target field as follows:
 
 In this case, {feat-imp} is exposed in the
 `my_field.foo.feature_importance` field.
+
+
+[discrete]
+[[inference-processor-examples]]
+==== {infer-cap} processor examples
+
+The following example uses an <<inference-apis,{infer} endpoint>> in an {infer} processor named `query_helper_pipeline` to perform a chat completion task.
+The processor generates an {es} query from natural language input using a prompt designed for a completion task type.
+Refer to <<put-inference-api-desc,this list>> for the {infer} service you use and check the corresponding examples of setting up an endpoint with the chat completion task type.
+
+
+[source,console]
+--------------------------------------------------
+PUT _ingest/pipeline/query_helper_pipeline
+{
+  "processors": [
+    {
+      "script": {
+        "source": "ctx.prompt = 'Please generate an elasticsearch search query on index `articles_index` for the following natural language query. Dates are in the field `@timestamp`, document types are in the field `type` (options are `news`, `publication`), categories in the field `category` and can be multiple (options are `medicine`, `pharmaceuticals`, `technology`), and document names are in the field `title` which should use a fuzzy match. Ignore fields which cannot be determined from the natural language query context: ' + ctx.content" <1>
+      }
+    },
+    {
+      "inference": {
+        "model_id": "openai_chat_completions", <2>
+        "input_output": {
+          "input_field": "prompt",
+          "output_field": "query"
+        }
+      }
+    },
+    {
+      "remove": {
+        "field": "prompt"
+      }
+    }
+  ]
+}
+--------------------------------------------------
+// TEST[skip: An inference endpoint is required.]
+<1> The `prompt` field contains the prompt used for the completion task, created with <<modules-scripting-painless,Painless>>.
+`+ ctx.content` appends the natural language input to the prompt.
+<2> The ID of the pre-configured {infer} endpoint, which utilizes the <<infer-service-openai,`openai` service>> with the `completion` task type.
+
+The following API request will simulate running a document through the ingest pipeline created previously:
+
+[source,console]
+--------------------------------------------------
+POST _ingest/pipeline/query_helper_pipeline/_simulate
+{
+  "docs": [
+    {
+      "_source": {
+        "content": "artificial intelligence in medicine articles published in the last 12 months" <1>
+      }
+    }
+  ]
+}
+--------------------------------------------------
+// TEST[skip: An inference processor with an inference endpoint is required.]
+<1> The natural language query used to generate an {es} query within the prompt created by the {infer} processor.
+
+
+[discrete]
+[[infer-proc-readings]]
+==== Further readings
+
+* https://www.elastic.co/search-labs/blog/openwebcrawler-llms-semantic-text-resume-job-search[Which job is the best for you? Using LLMs and semantic_text to match resumes to jobs]
\ No newline at end of file

From 0a2c9fbc2925adac6057b86c4ea9d6174121c6ef Mon Sep 17 00:00:00 2001
From: Matteo Piergiovanni <134913285+piergm@users.noreply.github.com>
Date: Fri, 6 Dec 2024 10:59:19 +0100
Subject: [PATCH 069/119] fixes and unmutes
 testSearchableSnapshotShardsAreSkipped... (#118133)

---
 muted-tests.yml                                                | 3 ---
 .../SearchableSnapshotsCanMatchOnCoordinatorIntegTests.java    | 2 +-
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index 99d1e170a4f4e..e5199b0a1e238 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -132,9 +132,6 @@ tests:
 - class: org.elasticsearch.reservedstate.service.FileSettingsServiceTests
   method: testInvalidJSON
   issue: https://github.com/elastic/elasticsearch/issues/116521
-- class: org.elasticsearch.xpack.searchablesnapshots.SearchableSnapshotsCanMatchOnCoordinatorIntegTests
-  method: testSearchableSnapshotShardsAreSkippedBySearchRequestWithoutQueryingAnyNodeWhenTheyAreOutsideOfTheQueryRange
-  issue: https://github.com/elastic/elasticsearch/issues/116523
 - class: org.elasticsearch.reservedstate.service.RepositoriesFileSettingsIT
   method: testSettingsApplied
   issue: https://github.com/elastic/elasticsearch/issues/116694
diff --git a/x-pack/plugin/searchable-snapshots/src/internalClusterTest/java/org/elasticsearch/xpack/searchablesnapshots/SearchableSnapshotsCanMatchOnCoordinatorIntegTests.java b/x-pack/plugin/searchable-snapshots/src/internalClusterTest/java/org/elasticsearch/xpack/searchablesnapshots/SearchableSnapshotsCanMatchOnCoordinatorIntegTests.java
index 21b24db6ce8d5..d4bbd4495df26 100644
--- a/x-pack/plugin/searchable-snapshots/src/internalClusterTest/java/org/elasticsearch/xpack/searchablesnapshots/SearchableSnapshotsCanMatchOnCoordinatorIntegTests.java
+++ b/x-pack/plugin/searchable-snapshots/src/internalClusterTest/java/org/elasticsearch/xpack/searchablesnapshots/SearchableSnapshotsCanMatchOnCoordinatorIntegTests.java
@@ -379,7 +379,7 @@ public void testSearchableSnapshotShardsAreSkippedBySearchRequestWithoutQuerying
                     }
                     if (searchShardsResponse != null) {
                         for (SearchShardsGroup group : searchShardsResponse.getGroups()) {
-                            assertFalse("no shard should be marked as skipped", group.skipped());
+                            assertTrue("the shard is skipped because index value is outside the query time range", group.skipped());
                         }
                     }
                 }

From e9d925e12728943b14f3d73e9db2ec41d1d161e5 Mon Sep 17 00:00:00 2001
From: Luigi Dell'Aquila <luigi.dellaquila@gmail.com>
Date: Fri, 6 Dec 2024 11:15:49 +0100
Subject: [PATCH 070/119] ES|QL: make ignoreOrder parsing more strict in CSV
 tests (#118136)

---
 muted-tests.yml                                           | 2 --
 .../java/org/elasticsearch/xpack/esql/CsvSpecReader.java  | 7 ++++++-
 .../testFixtures/src/main/resources/lookup-join.csv-spec  | 8 ++++----
 3 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index e5199b0a1e238..e4cd94b221536 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -242,8 +242,6 @@ tests:
 - class: org.elasticsearch.packaging.test.ArchiveTests
   method: test40AutoconfigurationNotTriggeredWhenNodeIsMeantToJoinExistingCluster
   issue: https://github.com/elastic/elasticsearch/issues/118029
-- class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
-  issue: https://github.com/elastic/elasticsearch/issues/117981
 - class: org.elasticsearch.packaging.test.ConfigurationTests
   method: test30SymlinkedDataPath
   issue: https://github.com/elastic/elasticsearch/issues/118111
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvSpecReader.java b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvSpecReader.java
index 84e06e0c1b674..ba0d11059a69b 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvSpecReader.java
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/CsvSpecReader.java
@@ -80,7 +80,12 @@ public Object parse(String line) {
                     testCase.expectedWarningsRegexString.add(regex);
                     testCase.expectedWarningsRegex.add(warningRegexToPattern(regex));
                 } else if (lower.startsWith("ignoreorder:")) {
-                    testCase.ignoreOrder = Boolean.parseBoolean(line.substring("ignoreOrder:".length()).trim());
+                    String value = lower.substring("ignoreOrder:".length()).trim();
+                    if ("true".equals(value)) {
+                        testCase.ignoreOrder = true;
+                    } else if ("false".equals(value) == false) {
+                        throw new IllegalArgumentException("Invalid value for ignoreOrder: [" + value + "], it can only be true or false");
+                    }
                 } else if (line.startsWith(";")) {
                     testCase.expectedResults = data.toString();
                     // clean-up and emit
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
index 584cde55080ef..2d4c105cfff20 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/lookup-join.csv-spec
@@ -140,7 +140,7 @@ FROM sample_data
 | EVAL client_ip = client_ip::keyword
 | LOOKUP JOIN clientips_lookup ON client_ip
 ;
-ignoreOrder:true;
+ignoreOrder:true
 
 @timestamp:date          | event_duration:long | message:keyword       | client_ip:keyword | env:keyword
 2023-10-23T13:55:01.543Z | 1756467             | Connected to 10.1.0.1 | 172.21.3.15       | Production
@@ -160,7 +160,7 @@ FROM sample_data
 | LOOKUP JOIN clientips_lookup ON client_ip
 | KEEP @timestamp, client_ip, event_duration, message, env
 ;
-ignoreOrder:true;
+ignoreOrder:true
 
 @timestamp:date          | client_ip:keyword | event_duration:long | message:keyword       | env:keyword
 2023-10-23T13:55:01.543Z | 172.21.3.15       | 1756467             | Connected to 10.1.0.1 | Production
@@ -245,7 +245,7 @@ required_capability: join_lookup_v4
 FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
 ;
-ignoreOrder:true;
+ignoreOrder:true
 
 @timestamp:date          | client_ip:ip | event_duration:long | message:keyword       | type:keyword
 2023-10-23T13:55:01.543Z | 172.21.3.15  | 1756467             | Connected to 10.1.0.1 | Success
@@ -264,7 +264,7 @@ FROM sample_data
 | LOOKUP JOIN message_types_lookup ON message
 | KEEP @timestamp, client_ip, event_duration, message, type
 ;
-ignoreOrder:true;
+ignoreOrder:true
 
 @timestamp:date          | client_ip:ip | event_duration:long | message:keyword       | type:keyword
 2023-10-23T13:55:01.543Z | 172.21.3.15  | 1756467             | Connected to 10.1.0.1 | Success

From 34ea8f365f16b70a31693e6ce8dda3a8dfd13d92 Mon Sep 17 00:00:00 2001
From: Dimitris Rempapis <dimitris.rempapis@elastic.co>
Date: Fri, 6 Dec 2024 12:40:58 +0200
Subject: [PATCH 071/119] Search Queries in parallel assertHitcount - part 1
 (#117467)

Update tests applying an optimization in assertions
---
 .../elasticsearch/cluster/NoMasterNodeIT.java |  9 +--
 .../indices/IndicesOptionsIntegrationIT.java  |  7 ++-
 .../recovery/IndexPrimaryRelocationIT.java    |  6 +-
 .../template/SimpleIndexTemplateIT.java       |  7 +--
 .../search/nested/SimpleNestedIT.java         | 24 ++++----
 .../search/scroll/SearchScrollIT.java         | 32 +++++++---
 .../search/simple/SimpleSearchIT.java         | 61 +++++++++++--------
 .../snapshots/RestoreSnapshotIT.java          | 21 +++++--
 8 files changed, 99 insertions(+), 68 deletions(-)

diff --git a/server/src/internalClusterTest/java/org/elasticsearch/cluster/NoMasterNodeIT.java b/server/src/internalClusterTest/java/org/elasticsearch/cluster/NoMasterNodeIT.java
index 13515d34ec65f..545b38f30ba94 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/cluster/NoMasterNodeIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/cluster/NoMasterNodeIT.java
@@ -261,10 +261,11 @@ public void testNoMasterActionsWriteMasterBlock() throws Exception {
         GetResponse getResponse = clientToMasterlessNode.prepareGet("test1", "1").get();
         assertExists(getResponse);
 
-        assertHitCount(clientToMasterlessNode.prepareSearch("test1").setAllowPartialSearchResults(true).setSize(0), 1L);
-
-        logger.info("--> here 3");
-        assertHitCount(clientToMasterlessNode.prepareSearch("test1").setAllowPartialSearchResults(true), 1L);
+        assertHitCount(
+            1L,
+            clientToMasterlessNode.prepareSearch("test1").setAllowPartialSearchResults(true).setSize(0),
+            clientToMasterlessNode.prepareSearch("test1").setAllowPartialSearchResults(true)
+        );
 
         assertResponse(clientToMasterlessNode.prepareSearch("test2").setAllowPartialSearchResults(true).setSize(0), countResponse -> {
             assertThat(countResponse.getTotalShards(), equalTo(3));
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/indices/IndicesOptionsIntegrationIT.java b/server/src/internalClusterTest/java/org/elasticsearch/indices/IndicesOptionsIntegrationIT.java
index f41277c5b80ca..545ed83bb79c8 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/indices/IndicesOptionsIntegrationIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/indices/IndicesOptionsIntegrationIT.java
@@ -398,8 +398,11 @@ public void testWildcardBehaviourSnapshotRestore() throws Exception {
     public void testAllMissingLenient() throws Exception {
         createIndex("test1");
         prepareIndex("test1").setId("1").setSource("k", "v").setRefreshPolicy(IMMEDIATE).get();
-        assertHitCount(prepareSearch("test2").setIndicesOptions(IndicesOptions.lenientExpandOpen()).setQuery(matchAllQuery()), 0L);
-        assertHitCount(prepareSearch("test2", "test3").setQuery(matchAllQuery()).setIndicesOptions(IndicesOptions.lenientExpandOpen()), 0L);
+        assertHitCount(
+            0L,
+            prepareSearch("test2").setIndicesOptions(IndicesOptions.lenientExpandOpen()).setQuery(matchAllQuery()),
+            prepareSearch("test2", "test3").setQuery(matchAllQuery()).setIndicesOptions(IndicesOptions.lenientExpandOpen())
+        );
         // you should still be able to run empty searches without things blowing up
         assertHitCount(prepareSearch().setIndicesOptions(IndicesOptions.lenientExpandOpen()).setQuery(matchAllQuery()), 1L);
     }
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/indices/recovery/IndexPrimaryRelocationIT.java b/server/src/internalClusterTest/java/org/elasticsearch/indices/recovery/IndexPrimaryRelocationIT.java
index 581145d949cf9..debcf5c06a7d6 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/indices/recovery/IndexPrimaryRelocationIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/indices/recovery/IndexPrimaryRelocationIT.java
@@ -98,11 +98,11 @@ public void run() {
         finished.set(true);
         indexingThread.join();
         refresh("test");
-        ElasticsearchAssertions.assertHitCount(prepareSearch("test").setTrackTotalHits(true), numAutoGenDocs.get());
         ElasticsearchAssertions.assertHitCount(
+            numAutoGenDocs.get(),
+            prepareSearch("test").setTrackTotalHits(true),
             prepareSearch("test").setTrackTotalHits(true)// extra paranoia ;)
-                .setQuery(QueryBuilders.termQuery("auto", true)),
-            numAutoGenDocs.get()
+                .setQuery(QueryBuilders.termQuery("auto", true))
         );
     }
 
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java b/server/src/internalClusterTest/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java
index de9e3f28a2109..8496180e85d4e 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/indices/template/SimpleIndexTemplateIT.java
@@ -500,9 +500,7 @@ public void testIndexTemplateWithAliases() throws Exception {
 
         refresh();
 
-        assertHitCount(prepareSearch("test_index"), 5L);
-        assertHitCount(prepareSearch("simple_alias"), 5L);
-        assertHitCount(prepareSearch("templated_alias-test_index"), 5L);
+        assertHitCount(5L, prepareSearch("test_index"), prepareSearch("simple_alias"), prepareSearch("templated_alias-test_index"));
 
         assertResponse(prepareSearch("filtered_alias"), response -> {
             assertHitCount(response, 1L);
@@ -584,8 +582,7 @@ public void testIndexTemplateWithAliasesSource() {
         prepareIndex("test_index").setId("2").setSource("field", "value2").get();
         refresh();
 
-        assertHitCount(prepareSearch("test_index"), 2L);
-        assertHitCount(prepareSearch("alias1"), 2L);
+        assertHitCount(2L, prepareSearch("test_index"), prepareSearch("alias1"));
 
         assertResponse(prepareSearch("alias2"), response -> {
             assertHitCount(response, 1L);
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/nested/SimpleNestedIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/nested/SimpleNestedIT.java
index 8225386ed02d2..acfc55a740f1e 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/nested/SimpleNestedIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/nested/SimpleNestedIT.java
@@ -53,6 +53,7 @@
 import static org.hamcrest.Matchers.startsWith;
 
 public class SimpleNestedIT extends ESIntegTestCase {
+
     public void testSimpleNested() throws Exception {
         assertAcked(prepareCreate("test").setMapping("nested1", "type=nested"));
         ensureGreen();
@@ -87,21 +88,20 @@ public void testSimpleNested() throws Exception {
         // check the numDocs
         assertDocumentCount("test", 3);
 
-        assertHitCount(prepareSearch("test").setQuery(termQuery("n_field1", "n_value1_1")), 0L);
-
-        // search for something that matches the nested doc, and see that we don't find the nested doc
-        assertHitCount(prepareSearch("test"), 1L);
-        assertHitCount(prepareSearch("test").setQuery(termQuery("n_field1", "n_value1_1")), 0L);
+        assertHitCount(
+            0L,
+            prepareSearch("test").setQuery(termQuery("n_field1", "n_value1_1")),
+            prepareSearch("test").setQuery(termQuery("n_field1", "n_value1_1"))
+        );
 
-        // now, do a nested query
-        assertHitCountAndNoFailures(
+        assertHitCount(
+            1L,
+            // search for something that matches the nested doc, and see that we don't find the nested doc
+            prepareSearch("test"),
+            // now, do a nested query
             prepareSearch("test").setQuery(nestedQuery("nested1", termQuery("nested1.n_field1", "n_value1_1"), ScoreMode.Avg)),
-            1L
-        );
-        assertHitCountAndNoFailures(
             prepareSearch("test").setQuery(nestedQuery("nested1", termQuery("nested1.n_field1", "n_value1_1"), ScoreMode.Avg))
-                .setSearchType(SearchType.DFS_QUERY_THEN_FETCH),
-            1L
+                .setSearchType(SearchType.DFS_QUERY_THEN_FETCH)
         );
 
         // add another doc, one that would match if it was not nested...
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/scroll/SearchScrollIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/scroll/SearchScrollIT.java
index 7ac24b77a4b6d..a54e19b839ad3 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/scroll/SearchScrollIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/scroll/SearchScrollIT.java
@@ -206,11 +206,17 @@ public void testScrollAndUpdateIndex() throws Exception {
 
         indicesAdmin().prepareRefresh().get();
 
-        assertHitCount(prepareSearch().setSize(0).setQuery(matchAllQuery()), 500);
-        assertHitCount(prepareSearch().setSize(0).setQuery(termQuery("message", "test")), 500);
-        assertHitCount(prepareSearch().setSize(0).setQuery(termQuery("message", "test")), 500);
-        assertHitCount(prepareSearch().setSize(0).setQuery(termQuery("message", "update")), 0);
-        assertHitCount(prepareSearch().setSize(0).setQuery(termQuery("message", "update")), 0);
+        assertHitCount(
+            500,
+            prepareSearch().setSize(0).setQuery(matchAllQuery()),
+            prepareSearch().setSize(0).setQuery(termQuery("message", "test")),
+            prepareSearch().setSize(0).setQuery(termQuery("message", "test"))
+        );
+        assertHitCount(
+            0,
+            prepareSearch().setSize(0).setQuery(termQuery("message", "update")),
+            prepareSearch().setSize(0).setQuery(termQuery("message", "update"))
+        );
 
         SearchResponse searchResponse = prepareSearch().setQuery(queryStringQuery("user:kimchy"))
             .setSize(35)
@@ -229,11 +235,17 @@ public void testScrollAndUpdateIndex() throws Exception {
             } while (searchResponse.getHits().getHits().length > 0);
 
             indicesAdmin().prepareRefresh().get();
-            assertHitCount(prepareSearch().setSize(0).setQuery(matchAllQuery()), 500);
-            assertHitCount(prepareSearch().setSize(0).setQuery(termQuery("message", "test")), 0);
-            assertHitCount(prepareSearch().setSize(0).setQuery(termQuery("message", "test")), 0);
-            assertHitCount(prepareSearch().setSize(0).setQuery(termQuery("message", "update")), 500);
-            assertHitCount(prepareSearch().setSize(0).setQuery(termQuery("message", "update")), 500);
+            assertHitCount(
+                500,
+                prepareSearch().setSize(0).setQuery(matchAllQuery()),
+                prepareSearch().setSize(0).setQuery(termQuery("message", "update")),
+                prepareSearch().setSize(0).setQuery(termQuery("message", "update"))
+            );
+            assertHitCount(
+                0,
+                prepareSearch().setSize(0).setQuery(termQuery("message", "test")),
+                prepareSearch().setSize(0).setQuery(termQuery("message", "test"))
+            );
         } finally {
             clearScroll(searchResponse.getScrollId());
             searchResponse.decRef();
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/simple/SimpleSearchIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/simple/SimpleSearchIT.java
index e87c4790aa665..5a9be73d92268 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/simple/SimpleSearchIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/simple/SimpleSearchIT.java
@@ -147,16 +147,22 @@ public void testIpCidr() throws Exception {
         prepareIndex("test").setId("5").setSource("ip", "2001:db8::ff00:42:8329").get();
         refresh();
 
-        assertHitCount(prepareSearch().setQuery(boolQuery().must(QueryBuilders.termQuery("ip", "192.168.0.1"))), 1L);
-        assertHitCount(prepareSearch().setQuery(queryStringQuery("ip: 192.168.0.1")), 1L);
-        assertHitCount(prepareSearch().setQuery(boolQuery().must(QueryBuilders.termQuery("ip", "192.168.0.1/32"))), 1L);
+        assertHitCount(prepareSearch().setQuery(boolQuery().must(QueryBuilders.termQuery("ip", "192.168.1.5/32"))), 0L);
+        assertHitCount(
+            1L,
+            prepareSearch().setQuery(boolQuery().must(QueryBuilders.termQuery("ip", "192.168.0.1"))),
+            prepareSearch().setQuery(queryStringQuery("ip: 192.168.0.1")),
+            prepareSearch().setQuery(boolQuery().must(QueryBuilders.termQuery("ip", "192.168.0.1/32"))),
+            prepareSearch().setQuery(boolQuery().must(QueryBuilders.termQuery("ip", "2001:db8::ff00:42:8329/128"))),
+            prepareSearch().setQuery(boolQuery().must(QueryBuilders.termQuery("ip", "2001:db8::/64")))
+        );
         assertHitCount(prepareSearch().setQuery(boolQuery().must(QueryBuilders.termQuery("ip", "192.168.0.0/24"))), 3L);
-        assertHitCount(prepareSearch().setQuery(boolQuery().must(QueryBuilders.termQuery("ip", "192.0.0.0/8"))), 4L);
-        assertHitCount(prepareSearch().setQuery(boolQuery().must(QueryBuilders.termQuery("ip", "0.0.0.0/0"))), 4L);
-        assertHitCount(prepareSearch().setQuery(boolQuery().must(QueryBuilders.termQuery("ip", "2001:db8::ff00:42:8329/128"))), 1L);
-        assertHitCount(prepareSearch().setQuery(boolQuery().must(QueryBuilders.termQuery("ip", "2001:db8::/64"))), 1L);
+        assertHitCount(
+            4L,
+            prepareSearch().setQuery(boolQuery().must(QueryBuilders.termQuery("ip", "192.0.0.0/8"))),
+            prepareSearch().setQuery(boolQuery().must(QueryBuilders.termQuery("ip", "0.0.0.0/0")))
+        );
         assertHitCount(prepareSearch().setQuery(boolQuery().must(QueryBuilders.termQuery("ip", "::/0"))), 5L);
-        assertHitCount(prepareSearch().setQuery(boolQuery().must(QueryBuilders.termQuery("ip", "192.168.1.5/32"))), 0L);
 
         assertFailures(
             prepareSearch().setQuery(boolQuery().must(QueryBuilders.termQuery("ip", "0/0/0/0/0"))),
@@ -170,8 +176,11 @@ public void testSimpleId() {
 
         prepareIndex("test").setId("XXX1").setSource("field", "value").setRefreshPolicy(IMMEDIATE).get();
         // id is not indexed, but lets see that we automatically convert to
-        assertHitCount(prepareSearch().setQuery(QueryBuilders.termQuery("_id", "XXX1")), 1L);
-        assertHitCount(prepareSearch().setQuery(QueryBuilders.queryStringQuery("_id:XXX1")), 1L);
+        assertHitCount(
+            1L,
+            prepareSearch().setQuery(QueryBuilders.termQuery("_id", "XXX1")),
+            prepareSearch().setQuery(QueryBuilders.queryStringQuery("_id:XXX1"))
+        );
     }
 
     public void testSimpleDateRange() throws Exception {
@@ -324,12 +333,12 @@ public void testLargeFromAndSizeSucceeds() throws Exception {
         createIndex("idx");
         indexRandom(true, prepareIndex("idx").setSource("{}", XContentType.JSON));
 
-        assertHitCount(prepareSearch("idx").setFrom(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY) - 10), 1);
-        assertHitCount(prepareSearch("idx").setSize(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY)), 1);
         assertHitCount(
+            1,
+            prepareSearch("idx").setFrom(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY) - 10),
+            prepareSearch("idx").setSize(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY)),
             prepareSearch("idx").setSize(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY) / 2)
-                .setFrom(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY) / 2 - 1),
-            1
+                .setFrom(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY) / 2 - 1)
         );
     }
 
@@ -340,12 +349,12 @@ public void testTooLargeFromAndSizeOkBySetting() throws Exception {
         ).get();
         indexRandom(true, prepareIndex("idx").setSource("{}", XContentType.JSON));
 
-        assertHitCount(prepareSearch("idx").setFrom(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY)), 1);
-        assertHitCount(prepareSearch("idx").setSize(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY) + 1), 1);
         assertHitCount(
+            1,
+            prepareSearch("idx").setFrom(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY)),
+            prepareSearch("idx").setSize(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY) + 1),
             prepareSearch("idx").setSize(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY))
-                .setFrom(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY)),
-            1
+                .setFrom(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY))
         );
     }
 
@@ -358,12 +367,12 @@ public void testTooLargeFromAndSizeOkByDynamicSetting() throws Exception {
         );
         indexRandom(true, prepareIndex("idx").setSource("{}", XContentType.JSON));
 
-        assertHitCount(prepareSearch("idx").setFrom(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY)), 1);
-        assertHitCount(prepareSearch("idx").setSize(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY) + 1), 1);
         assertHitCount(
+            1,
+            prepareSearch("idx").setFrom(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY)),
+            prepareSearch("idx").setSize(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY) + 1),
             prepareSearch("idx").setSize(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY))
-                .setFrom(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY)),
-            1
+                .setFrom(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY))
         );
     }
 
@@ -371,12 +380,12 @@ public void testTooLargeFromAndSizeBackwardsCompatibilityRecommendation() throws
         prepareCreate("idx").setSettings(Settings.builder().put(IndexSettings.MAX_RESULT_WINDOW_SETTING.getKey(), Integer.MAX_VALUE)).get();
         indexRandom(true, prepareIndex("idx").setSource("{}", XContentType.JSON));
 
-        assertHitCount(prepareSearch("idx").setFrom(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY) * 10), 1);
-        assertHitCount(prepareSearch("idx").setSize(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY) * 10), 1);
         assertHitCount(
+            1,
+            prepareSearch("idx").setFrom(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY) * 10),
+            prepareSearch("idx").setSize(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY) * 10),
             prepareSearch("idx").setSize(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY) * 10)
-                .setFrom(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY) * 10),
-            1
+                .setFrom(IndexSettings.MAX_RESULT_WINDOW_SETTING.get(Settings.EMPTY) * 10)
         );
     }
 
diff --git a/server/src/internalClusterTest/java/org/elasticsearch/snapshots/RestoreSnapshotIT.java b/server/src/internalClusterTest/java/org/elasticsearch/snapshots/RestoreSnapshotIT.java
index fe83073eeb780..b490c7efd52cd 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/snapshots/RestoreSnapshotIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/snapshots/RestoreSnapshotIT.java
@@ -678,9 +678,12 @@ public void testChangeSettingsOnRestore() throws Exception {
         indexRandom(true, builders);
         flushAndRefresh();
 
-        assertHitCount(client.prepareSearch("test-idx").setSize(0).setQuery(matchQuery("field1", "foo")), numdocs);
+        assertHitCount(
+            numdocs,
+            client.prepareSearch("test-idx").setSize(0).setQuery(matchQuery("field1", "foo")),
+            client.prepareSearch("test-idx").setSize(0).setQuery(matchQuery("field1", "bar"))
+        );
         assertHitCount(client.prepareSearch("test-idx").setSize(0).setQuery(matchQuery("field1", "Foo")), 0);
-        assertHitCount(client.prepareSearch("test-idx").setSize(0).setQuery(matchQuery("field1", "bar")), numdocs);
 
         createSnapshot("test-repo", "test-snap", Collections.singletonList("test-idx"));
 
@@ -736,8 +739,11 @@ public void testChangeSettingsOnRestore() throws Exception {
         assertThat(getSettingsResponse.getSetting("test-idx", SETTING_NUMBER_OF_SHARDS), equalTo("" + numberOfShards));
         assertThat(getSettingsResponse.getSetting("test-idx", "index.analysis.analyzer.my_analyzer.type"), equalTo("standard"));
 
-        assertHitCount(client.prepareSearch("test-idx").setSize(0).setQuery(matchQuery("field1", "Foo")), numdocs);
-        assertHitCount(client.prepareSearch("test-idx").setSize(0).setQuery(matchQuery("field1", "bar")), numdocs);
+        assertHitCount(
+            numdocs,
+            client.prepareSearch("test-idx").setSize(0).setQuery(matchQuery("field1", "Foo")),
+            client.prepareSearch("test-idx").setSize(0).setQuery(matchQuery("field1", "bar"))
+        );
 
         logger.info("--> delete the index and recreate it while deleting all index settings");
         cluster().wipeIndices("test-idx");
@@ -758,8 +764,11 @@ public void testChangeSettingsOnRestore() throws Exception {
         // Make sure that number of shards didn't change
         assertThat(getSettingsResponse.getSetting("test-idx", SETTING_NUMBER_OF_SHARDS), equalTo("" + numberOfShards));
 
-        assertHitCount(client.prepareSearch("test-idx").setSize(0).setQuery(matchQuery("field1", "Foo")), numdocs);
-        assertHitCount(client.prepareSearch("test-idx").setSize(0).setQuery(matchQuery("field1", "bar")), numdocs);
+        assertHitCount(
+            numdocs,
+            client.prepareSearch("test-idx").setSize(0).setQuery(matchQuery("field1", "Foo")),
+            client.prepareSearch("test-idx").setSize(0).setQuery(matchQuery("field1", "bar"))
+        );
     }
 
     public void testRestoreChangeIndexMode() {

From a0ac839189431e016ea810ac1e48b6932b6daa0b Mon Sep 17 00:00:00 2001
From: David Kyle <david.kyle@elastic.co>
Date: Fri, 6 Dec 2024 11:02:17 +0000
Subject: [PATCH 072/119] [ML] Wait for the worker service to shutdown before
 closing task processor (#117920)

---
 docs/changelog/117920.yaml                    |  6 ++++
 .../deployment/DeploymentManager.java         | 33 +++++++------------
 2 files changed, 18 insertions(+), 21 deletions(-)
 create mode 100644 docs/changelog/117920.yaml

diff --git a/docs/changelog/117920.yaml b/docs/changelog/117920.yaml
new file mode 100644
index 0000000000000..1bfddabd4462d
--- /dev/null
+++ b/docs/changelog/117920.yaml
@@ -0,0 +1,6 @@
+pr: 117920
+summary: Wait for the worker service to shutdown before closing task processor
+area: Machine Learning
+type: bug
+issues:
+ - 117563
diff --git a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/deployment/DeploymentManager.java b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/deployment/DeploymentManager.java
index 9187969fc25a4..c6f1ebcc10780 100644
--- a/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/deployment/DeploymentManager.java
+++ b/x-pack/plugin/ml/src/main/java/org/elasticsearch/xpack/ml/inference/deployment/DeploymentManager.java
@@ -631,12 +631,15 @@ synchronized void forcefullyStopProcess() {
             logger.debug(() -> format("[%s] Forcefully stopping process", task.getDeploymentId()));
             prepareInternalStateForShutdown();
 
-            if (priorityProcessWorker.isShutdown()) {
-                // most likely there was a crash or exception that caused the
-                // thread to stop. Notify any waiting requests in the work queue
-                handleAlreadyShuttingDownWorker();
-            } else {
-                priorityProcessWorker.shutdown();
+            priorityProcessWorker.shutdownNow();
+            try {
+                // wait for any currently executing work to finish
+                if (priorityProcessWorker.awaitTermination(10L, TimeUnit.SECONDS)) {
+                    priorityProcessWorker.notifyQueueRunnables();
+                }
+            } catch (InterruptedException e) {
+                Thread.currentThread().interrupt();
+                logger.info(Strings.format("[%s] Interrupted waiting for process worker after shutdownNow", PROCESS_NAME));
             }
 
             killProcessIfPresent();
@@ -649,12 +652,6 @@ private void prepareInternalStateForShutdown() {
             stateStreamer.cancel();
         }
 
-        private void handleAlreadyShuttingDownWorker() {
-            logger.debug(() -> format("[%s] Process worker was already marked for shutdown", task.getDeploymentId()));
-
-            priorityProcessWorker.notifyQueueRunnables();
-        }
-
         private void killProcessIfPresent() {
             try {
                 if (process.get() == null) {
@@ -675,15 +672,7 @@ private void closeNlpTaskProcessor() {
         private synchronized void stopProcessAfterCompletingPendingWork() {
             logger.debug(() -> format("[%s] Stopping process after completing its pending work", task.getDeploymentId()));
             prepareInternalStateForShutdown();
-
-            if (priorityProcessWorker.isShutdown()) {
-                // most likely there was a crash or exception that caused the
-                // thread to stop. Notify any waiting requests in the work queue
-                handleAlreadyShuttingDownWorker();
-            } else {
-                signalAndWaitForWorkerTermination();
-            }
-
+            signalAndWaitForWorkerTermination();
             stopProcessGracefully();
             closeNlpTaskProcessor();
         }
@@ -707,6 +696,8 @@ private void awaitTerminationAfterCompletingWork() throws TimeoutException {
                     throw new TimeoutException(
                         Strings.format("Timed out waiting for process worker to complete for process %s", PROCESS_NAME)
                     );
+                } else {
+                    priorityProcessWorker.notifyQueueRunnables();
                 }
             } catch (InterruptedException e) {
                 Thread.currentThread().interrupt();

From 5b5c9adc47acd7f5dc385763fb6f5dafd586e18c Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Fri, 6 Dec 2024 07:22:21 -0500
Subject: [PATCH 073/119] Remove long deprecated special 'base' case for
 similarity service (#118115)

---
 .../index/similarity/SimilarityService.java            | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/index/similarity/SimilarityService.java b/server/src/main/java/org/elasticsearch/index/similarity/SimilarityService.java
index 0f1b40f80c36c..9db316d9683ed 100644
--- a/server/src/main/java/org/elasticsearch/index/similarity/SimilarityService.java
+++ b/server/src/main/java/org/elasticsearch/index/similarity/SimilarityService.java
@@ -20,8 +20,6 @@
 import org.apache.lucene.search.similarities.Similarity.SimScorer;
 import org.apache.lucene.util.BytesRef;
 import org.elasticsearch.common.TriFunction;
-import org.elasticsearch.common.logging.DeprecationCategory;
-import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.common.util.Maps;
 import org.elasticsearch.core.Nullable;
@@ -40,7 +38,6 @@
 import java.util.function.Supplier;
 
 public final class SimilarityService {
-    private static final DeprecationLogger deprecationLogger = DeprecationLogger.getLogger(SimilarityService.class);
     public static final String DEFAULT_SIMILARITY = "BM25";
     private static final Map<String, Function<IndexVersion, Supplier<Similarity>>> DEFAULTS;
     public static final Map<String, TriFunction<Settings, IndexVersion, ScriptService, Similarity>> BUILT_IN;
@@ -115,13 +112,6 @@ public SimilarityService(
         defaultSimilarity = (providers.get("default") != null)
             ? providers.get("default").get()
             : providers.get(SimilarityService.DEFAULT_SIMILARITY).get();
-        if (providers.get("base") != null) {
-            deprecationLogger.warn(
-                DeprecationCategory.QUERIES,
-                "base_similarity_ignored",
-                "The [base] similarity is ignored since query normalization and coords have been removed"
-            );
-        }
     }
 
     /**

From b09f1d72f40c78667f8128c5ef9e451fbe2b7b0e Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Fri, 6 Dec 2024 13:46:07 +0100
Subject: [PATCH 074/119] Add additional debug logging for indexing failure.
 (#117728)

This change adds a new IndexingOperationListener that logs debug logging for indexing failures.

Today `IndexShard` logger needs to be set to TRACE in order to see indexing failures. This logger is very verbose and logs many other aspects of indexing at trace level. This new logger is targeted just for seeing indexing failures.

Relates #117700
---
 .../elasticsearch/index/shard/IndexShard.java |   3 +-
 .../shard/IndexingFailuresDebugListener.java  |  54 +++++++
 .../IndexingFailuresDebugListenerTests.java   | 138 ++++++++++++++++++
 3 files changed, 194 insertions(+), 1 deletion(-)
 create mode 100644 server/src/main/java/org/elasticsearch/index/shard/IndexingFailuresDebugListener.java
 create mode 100644 server/src/test/java/org/elasticsearch/index/shard/IndexingFailuresDebugListenerTests.java

diff --git a/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java b/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java
index 993079a3106d7..f84ac22cd78e4 100644
--- a/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java
+++ b/server/src/main/java/org/elasticsearch/index/shard/IndexShard.java
@@ -345,8 +345,9 @@ public IndexShard(
         this.mapperService = mapperService;
         this.indexCache = indexCache;
         this.internalIndexingStats = new InternalIndexingStats();
+        var indexingFailuresDebugListener = new IndexingFailuresDebugListener(this);
         this.indexingOperationListeners = new IndexingOperationListener.CompositeListener(
-            CollectionUtils.appendToCopyNoNullElements(listeners, internalIndexingStats),
+            CollectionUtils.appendToCopyNoNullElements(listeners, internalIndexingStats, indexingFailuresDebugListener),
             logger
         );
         this.bulkOperationListener = new ShardBulkStats();
diff --git a/server/src/main/java/org/elasticsearch/index/shard/IndexingFailuresDebugListener.java b/server/src/main/java/org/elasticsearch/index/shard/IndexingFailuresDebugListener.java
new file mode 100644
index 0000000000000..13c0d917d492d
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/index/shard/IndexingFailuresDebugListener.java
@@ -0,0 +1,54 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.index.shard;
+
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.elasticsearch.index.engine.Engine;
+
+import static org.elasticsearch.core.Strings.format;
+
+public class IndexingFailuresDebugListener implements IndexingOperationListener {
+
+    private static final Logger LOGGER = LogManager.getLogger(IndexingFailuresDebugListener.class);
+
+    private final IndexShard indexShard;
+
+    public IndexingFailuresDebugListener(IndexShard indexShard) {
+        this.indexShard = indexShard;
+    }
+
+    @Override
+    public void postIndex(ShardId shardId, Engine.Index index, Engine.IndexResult result) {
+        if (LOGGER.isDebugEnabled()) {
+            if (result.getResultType() == Engine.Result.Type.FAILURE) {
+                postIndex(shardId, index, result.getFailure());
+            }
+        }
+    }
+
+    @Override
+    public void postIndex(ShardId shardId, Engine.Index index, Exception ex) {
+        if (LOGGER.isDebugEnabled()) {
+            LOGGER.debug(
+                () -> format(
+                    "index-fail [%s] seq# [%s] allocation-id [%s] primaryTerm [%s] operationPrimaryTerm [%s] origin [%s]",
+                    index.id(),
+                    index.seqNo(),
+                    indexShard.routingEntry().allocationId(),
+                    index.primaryTerm(),
+                    indexShard.getOperationPrimaryTerm(),
+                    index.origin()
+                ),
+                ex
+            );
+        }
+    }
+}
diff --git a/server/src/test/java/org/elasticsearch/index/shard/IndexingFailuresDebugListenerTests.java b/server/src/test/java/org/elasticsearch/index/shard/IndexingFailuresDebugListenerTests.java
new file mode 100644
index 0000000000000..43434a691bd90
--- /dev/null
+++ b/server/src/test/java/org/elasticsearch/index/shard/IndexingFailuresDebugListenerTests.java
@@ -0,0 +1,138 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.index.shard;
+
+import org.apache.logging.log4j.Level;
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.elasticsearch.cluster.routing.ShardRoutingState;
+import org.elasticsearch.cluster.routing.TestShardRouting;
+import org.elasticsearch.common.logging.Loggers;
+import org.elasticsearch.common.logging.MockAppender;
+import org.elasticsearch.index.engine.Engine;
+import org.elasticsearch.index.engine.EngineTestCase;
+import org.elasticsearch.index.mapper.ParsedDocument;
+import org.elasticsearch.index.mapper.Uid;
+import org.elasticsearch.test.ESTestCase;
+import org.junit.AfterClass;
+import org.junit.BeforeClass;
+
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.nullValue;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+
+public class IndexingFailuresDebugListenerTests extends ESTestCase {
+
+    static MockAppender appender;
+    static Logger testLogger1 = LogManager.getLogger(IndexingFailuresDebugListener.class);
+    static Level origLogLevel = testLogger1.getLevel();
+
+    @BeforeClass
+    public static void init() throws IllegalAccessException {
+        appender = new MockAppender("mock_appender");
+        appender.start();
+        Loggers.addAppender(testLogger1, appender);
+        Loggers.setLevel(testLogger1, randomBoolean() ? Level.DEBUG : Level.TRACE);
+    }
+
+    @AfterClass
+    public static void cleanup() {
+        Loggers.removeAppender(testLogger1, appender);
+        appender.stop();
+
+        Loggers.setLevel(testLogger1, origLogLevel);
+    }
+
+    public void testPostIndexException() {
+        var shardId = ShardId.fromString("[index][123]");
+        var mockShard = mock(IndexShard.class);
+        var shardRouting = TestShardRouting.newShardRouting(shardId, "node-id", true, ShardRoutingState.STARTED);
+        when(mockShard.routingEntry()).thenReturn(shardRouting);
+        when(mockShard.getOperationPrimaryTerm()).thenReturn(1L);
+        IndexingFailuresDebugListener indexingFailuresDebugListener = new IndexingFailuresDebugListener(mockShard);
+
+        ParsedDocument doc = EngineTestCase.createParsedDoc("1", null);
+        Engine.Index index = new Engine.Index(Uid.encodeId("doc_id"), 1, doc);
+        indexingFailuresDebugListener.postIndex(shardId, index, new RuntimeException("test exception"));
+        String message = appender.getLastEventAndReset().getMessage().getFormattedMessage();
+        assertThat(
+            message,
+            equalTo(
+                "index-fail [1] seq# [-2] allocation-id ["
+                    + shardRouting.allocationId()
+                    + "] primaryTerm [1] operationPrimaryTerm [1] origin [PRIMARY]"
+            )
+        );
+    }
+
+    public void testPostIndexExceptionInfoLevel() {
+        var previousLevel = testLogger1.getLevel();
+        try {
+            Loggers.setLevel(testLogger1, randomBoolean() ? Level.INFO : Level.WARN);
+            var shardId = ShardId.fromString("[index][123]");
+            var mockShard = mock(IndexShard.class);
+            var shardRouting = TestShardRouting.newShardRouting(shardId, "node-id", true, ShardRoutingState.STARTED);
+            when(mockShard.routingEntry()).thenReturn(shardRouting);
+            when(mockShard.getOperationPrimaryTerm()).thenReturn(1L);
+            IndexingFailuresDebugListener indexingFailuresDebugListener = new IndexingFailuresDebugListener(mockShard);
+
+            ParsedDocument doc = EngineTestCase.createParsedDoc("1", null);
+            Engine.Index index = new Engine.Index(Uid.encodeId("doc_id"), 1, doc);
+            indexingFailuresDebugListener.postIndex(shardId, index, new RuntimeException("test exception"));
+            assertThat(appender.getLastEventAndReset(), nullValue());
+        } finally {
+            Loggers.setLevel(testLogger1, previousLevel);
+        }
+    }
+
+    public void testPostIndexFailure() {
+        var shardId = ShardId.fromString("[index][123]");
+        var mockShard = mock(IndexShard.class);
+        var shardRouting = TestShardRouting.newShardRouting(shardId, "node-id", true, ShardRoutingState.STARTED);
+        when(mockShard.routingEntry()).thenReturn(shardRouting);
+        when(mockShard.getOperationPrimaryTerm()).thenReturn(1L);
+        IndexingFailuresDebugListener indexingFailuresDebugListener = new IndexingFailuresDebugListener(mockShard);
+
+        ParsedDocument doc = EngineTestCase.createParsedDoc("1", null);
+        Engine.Index index = new Engine.Index(Uid.encodeId("doc_id"), 1, doc);
+        Engine.IndexResult indexResult = mock(Engine.IndexResult.class);
+        when(indexResult.getResultType()).thenReturn(Engine.Result.Type.FAILURE);
+        when(indexResult.getFailure()).thenReturn(new RuntimeException("test exception"));
+        indexingFailuresDebugListener.postIndex(shardId, index, indexResult);
+        String message = appender.getLastEventAndReset().getMessage().getFormattedMessage();
+        assertThat(
+            message,
+            equalTo(
+                "index-fail [1] seq# [-2] allocation-id ["
+                    + shardRouting.allocationId()
+                    + "] primaryTerm [1] operationPrimaryTerm [1] origin [PRIMARY]"
+            )
+        );
+    }
+
+    public void testPostIndex() {
+        var shardId = ShardId.fromString("[index][123]");
+        var mockShard = mock(IndexShard.class);
+        var shardRouting = TestShardRouting.newShardRouting(shardId, "node-id", true, ShardRoutingState.STARTED);
+        when(mockShard.routingEntry()).thenReturn(shardRouting);
+        when(mockShard.getOperationPrimaryTerm()).thenReturn(1L);
+        IndexingFailuresDebugListener indexingFailuresDebugListener = new IndexingFailuresDebugListener(mockShard);
+
+        ParsedDocument doc = EngineTestCase.createParsedDoc("1", null);
+        Engine.Index index = new Engine.Index(Uid.encodeId("doc_id"), 1, doc);
+        Engine.IndexResult indexResult = mock(Engine.IndexResult.class);
+        when(indexResult.getResultType()).thenReturn(Engine.Result.Type.SUCCESS);
+        when(indexResult.getFailure()).thenReturn(new RuntimeException("test exception"));
+        indexingFailuresDebugListener.postIndex(shardId, index, indexResult);
+        assertThat(appender.getLastEventAndReset(), nullValue());
+    }
+
+}

From b769dcadad31e4438b451952bb17d20ade52c5db Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Sat, 7 Dec 2024 00:16:14 +1100
Subject: [PATCH 075/119] Mute
 org.elasticsearch.packaging.test.KeystoreManagementTests
 test30KeystorePasswordFromFile #118123

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index e4cd94b221536..3609ce846a0cb 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -248,6 +248,9 @@ tests:
 - class: org.elasticsearch.datastreams.ResolveClusterDataStreamIT
   method: testClusterResolveWithDataStreamsUsingAlias
   issue: https://github.com/elastic/elasticsearch/issues/118124
+- class: org.elasticsearch.packaging.test.KeystoreManagementTests
+  method: test30KeystorePasswordFromFile
+  issue: https://github.com/elastic/elasticsearch/issues/118123
 
 # Examples:
 #

From 06af8d049adec85ddc4db350bcf6c143fb3c531a Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Sat, 7 Dec 2024 00:16:29 +1100
Subject: [PATCH 076/119] Mute org.elasticsearch.packaging.test.ArchiveTests
 test41AutoconfigurationNotTriggeredWhenNodeCannotContainData #118110

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 3609ce846a0cb..c5dfbdcc0623b 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -251,6 +251,9 @@ tests:
 - class: org.elasticsearch.packaging.test.KeystoreManagementTests
   method: test30KeystorePasswordFromFile
   issue: https://github.com/elastic/elasticsearch/issues/118123
+- class: org.elasticsearch.packaging.test.ArchiveTests
+  method: test41AutoconfigurationNotTriggeredWhenNodeCannotContainData
+  issue: https://github.com/elastic/elasticsearch/issues/118110
 
 # Examples:
 #

From 2af2d5e5f55883e31447c784cadf50d2213acfef Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Fri, 6 Dec 2024 08:20:34 -0500
Subject: [PATCH 077/119] Unmuting test #116178 (#118100)

There was a single valid test failure, and this failure COULD have been
caused by some of the weird race conditions introduced around that time
in DFS/query phase optimizations.

Unmuting to see if its actually fixed

Related: https://github.com/elastic/elasticsearch/issues/116178
---
 muted-tests.yml | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index c5dfbdcc0623b..2b4cc3991a25f 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -111,9 +111,6 @@ tests:
 - class: org.elasticsearch.action.search.SearchPhaseControllerTests
   method: testProgressListener
   issue: https://github.com/elastic/elasticsearch/issues/116149
-- class: org.elasticsearch.xpack.test.rest.XPackRestIT
-  method: test {p0=terms_enum/10_basic/Test security}
-  issue: https://github.com/elastic/elasticsearch/issues/116178
 - class: org.elasticsearch.search.basic.SearchWithRandomDisconnectsIT
   method: testSearchWithRandomDisconnects
   issue: https://github.com/elastic/elasticsearch/issues/116175

From d42654a6910a2193a0528d7314b2620e8a1a4178 Mon Sep 17 00:00:00 2001
From: Keith Massey <keith.massey@elastic.co>
Date: Fri, 6 Dec 2024 07:27:51 -0600
Subject: [PATCH 078/119] Using the credentials of the user who calls reindex
 data stream (#117938)

---
 .../ReindexDataStreamTransportAction.java     |  4 +-
 .../task/ExecuteWithHeadersClient.java        | 40 ++++++++++
 ...indexDataStreamPersistentTaskExecutor.java |  3 +-
 .../task/ReindexDataStreamTaskParams.java     | 50 ++++++++++--
 .../ReindexDataStreamTaskParamsTests.java     | 79 ++++++++++++++++++-
 5 files changed, 163 insertions(+), 13 deletions(-)
 create mode 100644 x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ExecuteWithHeadersClient.java

diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamTransportAction.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamTransportAction.java
index d532b001f5aaa..7f68007f821ba 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamTransportAction.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamTransportAction.java
@@ -20,6 +20,7 @@
 import org.elasticsearch.tasks.Task;
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.transport.TransportService;
+import org.elasticsearch.xpack.core.ClientHelper;
 import org.elasticsearch.xpack.migrate.action.ReindexDataStreamAction.ReindexDataStreamRequest;
 import org.elasticsearch.xpack.migrate.action.ReindexDataStreamAction.ReindexDataStreamResponse;
 import org.elasticsearch.xpack.migrate.task.ReindexDataStreamTask;
@@ -72,7 +73,8 @@ protected void doExecute(Task task, ReindexDataStreamRequest request, ActionList
             sourceDataStreamName,
             transportService.getThreadPool().absoluteTimeInMillis(),
             totalIndices,
-            totalIndicesToBeUpgraded
+            totalIndicesToBeUpgraded,
+            ClientHelper.getPersistableSafeSecurityHeaders(transportService.getThreadPool().getThreadContext(), clusterService.state())
         );
         String persistentTaskId = getPersistentTaskId(sourceDataStreamName);
         persistentTasksService.sendStartRequest(
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ExecuteWithHeadersClient.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ExecuteWithHeadersClient.java
new file mode 100644
index 0000000000000..a8962f56468bc
--- /dev/null
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ExecuteWithHeadersClient.java
@@ -0,0 +1,40 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.migrate.task;
+
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.ActionRequest;
+import org.elasticsearch.action.ActionResponse;
+import org.elasticsearch.action.ActionType;
+import org.elasticsearch.client.internal.Client;
+import org.elasticsearch.client.internal.support.AbstractClient;
+import org.elasticsearch.xpack.core.ClientHelper;
+
+import java.util.Map;
+
+public class ExecuteWithHeadersClient extends AbstractClient {
+
+    private final Client client;
+    private final Map<String, String> headers;
+
+    public ExecuteWithHeadersClient(Client client, Map<String, String> headers) {
+        super(client.settings(), client.threadPool());
+        this.client = client;
+        this.headers = headers;
+    }
+
+    @Override
+    protected <Request extends ActionRequest, Response extends ActionResponse> void doExecute(
+        ActionType<Response> action,
+        Request request,
+        ActionListener<Response> listener
+    ) {
+        ClientHelper.executeWithHeadersAsync(headers, null, client, action, request, listener);
+    }
+
+}
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java
index 0f3f8b17f27ad..fc471cfa89f26 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamPersistentTaskExecutor.java
@@ -66,7 +66,8 @@ protected void nodeOperation(AllocatedPersistentTask task, ReindexDataStreamTask
         GetDataStreamAction.Request request = new GetDataStreamAction.Request(TimeValue.MAX_VALUE, new String[] { sourceDataStream });
         assert task instanceof ReindexDataStreamTask;
         final ReindexDataStreamTask reindexDataStreamTask = (ReindexDataStreamTask) task;
-        client.execute(GetDataStreamAction.INSTANCE, request, ActionListener.wrap(response -> {
+        ExecuteWithHeadersClient reindexClient = new ExecuteWithHeadersClient(client, params.headers());
+        reindexClient.execute(GetDataStreamAction.INSTANCE, request, ActionListener.wrap(response -> {
             List<GetDataStreamAction.Response.DataStreamInfo> dataStreamInfos = response.getDataStreams();
             if (dataStreamInfos.size() == 1) {
                 List<Index> indices = dataStreamInfos.getFirst().getDataStream().getIndices();
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamTaskParams.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamTaskParams.java
index 0f26713a75184..7c4b0007bb632 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamTaskParams.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamTaskParams.java
@@ -9,41 +9,65 @@
 
 import org.elasticsearch.TransportVersion;
 import org.elasticsearch.TransportVersions;
+import org.elasticsearch.cluster.metadata.Metadata;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.persistent.PersistentTaskParams;
 import org.elasticsearch.xcontent.ConstructingObjectParser;
+import org.elasticsearch.xcontent.ObjectParser;
 import org.elasticsearch.xcontent.ParseField;
 import org.elasticsearch.xcontent.XContentBuilder;
 import org.elasticsearch.xcontent.XContentParser;
 
 import java.io.IOException;
+import java.util.Map;
 
 import static org.elasticsearch.xcontent.ConstructingObjectParser.constructorArg;
 
-public record ReindexDataStreamTaskParams(String sourceDataStream, long startTime, int totalIndices, int totalIndicesToBeUpgraded)
-    implements
-        PersistentTaskParams {
+public record ReindexDataStreamTaskParams(
+    String sourceDataStream,
+    long startTime,
+    int totalIndices,
+    int totalIndicesToBeUpgraded,
+    Map<String, String> headers
+) implements PersistentTaskParams {
+
+    private static final String API_CONTEXT = Metadata.XContentContext.API.toString();
 
     public static final String NAME = ReindexDataStreamTask.TASK_NAME;
     private static final String SOURCE_DATA_STREAM_FIELD = "source_data_stream";
     private static final String START_TIME_FIELD = "start_time";
     private static final String TOTAL_INDICES_FIELD = "total_indices";
     private static final String TOTAL_INDICES_TO_BE_UPGRADED_FIELD = "total_indices_to_be_upgraded";
+    private static final String HEADERS_FIELD = "headers";
+    @SuppressWarnings("unchecked")
     private static final ConstructingObjectParser<ReindexDataStreamTaskParams, Void> PARSER = new ConstructingObjectParser<>(
         NAME,
         true,
-        args -> new ReindexDataStreamTaskParams((String) args[0], (long) args[1], (int) args[2], (int) args[3])
+        args -> new ReindexDataStreamTaskParams(
+            (String) args[0],
+            (long) args[1],
+            (int) args[2],
+            (int) args[3],
+            args[4] == null ? Map.of() : (Map<String, String>) args[4]
+        )
     );
     static {
         PARSER.declareString(constructorArg(), new ParseField(SOURCE_DATA_STREAM_FIELD));
         PARSER.declareLong(constructorArg(), new ParseField(START_TIME_FIELD));
         PARSER.declareInt(constructorArg(), new ParseField(TOTAL_INDICES_FIELD));
         PARSER.declareInt(constructorArg(), new ParseField(TOTAL_INDICES_TO_BE_UPGRADED_FIELD));
+        PARSER.declareField(
+            ConstructingObjectParser.optionalConstructorArg(),
+            XContentParser::mapStrings,
+            new ParseField(HEADERS_FIELD),
+            ObjectParser.ValueType.OBJECT
+        );
     }
 
+    @SuppressWarnings("unchecked")
     public ReindexDataStreamTaskParams(StreamInput in) throws IOException {
-        this(in.readString(), in.readLong(), in.readInt(), in.readInt());
+        this(in.readString(), in.readLong(), in.readInt(), in.readInt(), (Map<String, String>) in.readGenericValue());
     }
 
     @Override
@@ -62,16 +86,22 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeLong(startTime);
         out.writeInt(totalIndices);
         out.writeInt(totalIndicesToBeUpgraded);
+        out.writeGenericValue(headers);
     }
 
     @Override
     public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
-        return builder.startObject()
+        builder.startObject()
             .field(SOURCE_DATA_STREAM_FIELD, sourceDataStream)
             .field(START_TIME_FIELD, startTime)
             .field(TOTAL_INDICES_FIELD, totalIndices)
-            .field(TOTAL_INDICES_TO_BE_UPGRADED_FIELD, totalIndicesToBeUpgraded)
-            .endObject();
+            .field(TOTAL_INDICES_TO_BE_UPGRADED_FIELD, totalIndicesToBeUpgraded);
+        if (API_CONTEXT.equals(params.param(Metadata.CONTEXT_MODE_PARAM, API_CONTEXT)) == false) {
+            // This makes sure that we don't return the headers to an api request, like _cluster/state
+            builder.stringStringMap(HEADERS_FIELD, headers);
+        }
+        builder.endObject();
+        return builder;
     }
 
     public String getSourceDataStream() {
@@ -81,4 +111,8 @@ public String getSourceDataStream() {
     public static ReindexDataStreamTaskParams fromXContent(XContentParser parser) {
         return PARSER.apply(parser, null);
     }
+
+    public Map<String, String> getHeaders() {
+        return headers;
+    }
 }
diff --git a/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamTaskParamsTests.java b/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamTaskParamsTests.java
index fc39b5d8cb703..67ade297f27ad 100644
--- a/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamTaskParamsTests.java
+++ b/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/task/ReindexDataStreamTaskParamsTests.java
@@ -7,11 +7,14 @@
 
 package org.elasticsearch.xpack.migrate.task;
 
+import org.elasticsearch.cluster.metadata.Metadata;
 import org.elasticsearch.common.bytes.BytesReference;
 import org.elasticsearch.common.io.stream.Writeable;
 import org.elasticsearch.test.AbstractXContentSerializingTestCase;
+import org.elasticsearch.xcontent.ToXContent;
 import org.elasticsearch.xcontent.XContentBuilder;
 import org.elasticsearch.xcontent.XContentParser;
+import org.elasticsearch.xcontent.XContentType;
 import org.elasticsearch.xcontent.json.JsonXContent;
 
 import java.io.IOException;
@@ -29,7 +32,26 @@ protected Writeable.Reader<ReindexDataStreamTaskParams> instanceReader() {
 
     @Override
     protected ReindexDataStreamTaskParams createTestInstance() {
-        return new ReindexDataStreamTaskParams(randomAlphaOfLength(50), randomLong(), randomNonNegativeInt(), randomNonNegativeInt());
+        return createTestInstance(randomBoolean());
+    }
+
+    @Override
+    protected ReindexDataStreamTaskParams createXContextTestInstance(XContentType xContentType) {
+        /*
+         * Since we filter out headers from xcontent in some cases, we can't use them in the standard xcontent round trip testing.
+         * Headers are covered in testToXContentContextMode
+         */
+        return createTestInstance(false);
+    }
+
+    private ReindexDataStreamTaskParams createTestInstance(boolean withHeaders) {
+        return new ReindexDataStreamTaskParams(
+            randomAlphaOfLength(50),
+            randomLong(),
+            randomNonNegativeInt(),
+            randomNonNegativeInt(),
+            getTestHeaders(withHeaders)
+        );
     }
 
     @Override
@@ -38,14 +60,16 @@ protected ReindexDataStreamTaskParams mutateInstance(ReindexDataStreamTaskParams
         long startTime = instance.startTime();
         int totalIndices = instance.totalIndices();
         int totalIndicesToBeUpgraded = instance.totalIndicesToBeUpgraded();
-        switch (randomIntBetween(0, 3)) {
+        Map<String, String> headers = instance.headers();
+        switch (randomIntBetween(0, 4)) {
             case 0 -> sourceDataStream = randomAlphaOfLength(50);
             case 1 -> startTime = randomLong();
             case 2 -> totalIndices = totalIndices + 1;
             case 3 -> totalIndices = totalIndicesToBeUpgraded + 1;
+            case 4 -> headers = headers.isEmpty() ? getTestHeaders(true) : getTestHeaders();
             default -> throw new UnsupportedOperationException();
         }
-        return new ReindexDataStreamTaskParams(sourceDataStream, startTime, totalIndices, totalIndicesToBeUpgraded);
+        return new ReindexDataStreamTaskParams(sourceDataStream, startTime, totalIndices, totalIndicesToBeUpgraded, headers);
     }
 
     @Override
@@ -53,6 +77,18 @@ protected ReindexDataStreamTaskParams doParseInstance(XContentParser parser) {
         return ReindexDataStreamTaskParams.fromXContent(parser);
     }
 
+    private Map<String, String> getTestHeaders() {
+        return getTestHeaders(randomBoolean());
+    }
+
+    private Map<String, String> getTestHeaders(boolean nonEmpty) {
+        if (nonEmpty) {
+            return Map.of(randomAlphaOfLength(20), randomAlphaOfLength(30));
+        } else {
+            return Map.of();
+        }
+    }
+
     public void testToXContent() throws IOException {
         ReindexDataStreamTaskParams params = createTestInstance();
         try (XContentBuilder builder = XContentBuilder.builder(JsonXContent.jsonXContent)) {
@@ -65,4 +101,41 @@ public void testToXContent() throws IOException {
             }
         }
     }
+
+    public void testToXContentContextMode() throws IOException {
+        ReindexDataStreamTaskParams params = createTestInstance(true);
+
+        // We do not expect to get headers if the "content_mode" is "api"
+        try (XContentBuilder builder = XContentBuilder.builder(JsonXContent.jsonXContent)) {
+            builder.humanReadable(true);
+            ToXContent.Params xContentParams = new ToXContent.MapParams(
+                Map.of(Metadata.CONTEXT_MODE_PARAM, Metadata.XContentContext.API.toString())
+            );
+            params.toXContent(builder, xContentParams);
+            try (XContentParser parser = createParser(JsonXContent.jsonXContent, BytesReference.bytes(builder))) {
+                Map<String, Object> parserMap = parser.map();
+                assertThat(parserMap.get("source_data_stream"), equalTo(params.sourceDataStream()));
+                assertThat(((Number) parserMap.get("start_time")).longValue(), equalTo(params.startTime()));
+                assertThat(parserMap.containsKey("headers"), equalTo(false));
+            }
+        }
+
+        // We do expect to get headers if the "content_mode" is anything but "api"
+        try (XContentBuilder builder = XContentBuilder.builder(JsonXContent.jsonXContent)) {
+            builder.humanReadable(true);
+            ToXContent.Params xContentParams = new ToXContent.MapParams(
+                Map.of(
+                    Metadata.CONTEXT_MODE_PARAM,
+                    randomFrom(Metadata.XContentContext.GATEWAY.toString(), Metadata.XContentContext.SNAPSHOT.toString())
+                )
+            );
+            params.toXContent(builder, xContentParams);
+            try (XContentParser parser = createParser(JsonXContent.jsonXContent, BytesReference.bytes(builder))) {
+                Map<String, Object> parserMap = parser.map();
+                assertThat(parserMap.get("source_data_stream"), equalTo(params.sourceDataStream()));
+                assertThat(((Number) parserMap.get("start_time")).longValue(), equalTo(params.startTime()));
+                assertThat(parserMap.get("headers"), equalTo(params.getHeaders()));
+            }
+        }
+    }
 }

From 07deeee9b3e532e829edfc7a2ed7be6b973de70e Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Sat, 7 Dec 2024 00:37:20 +1100
Subject: [PATCH 079/119] Mute
 org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT test
 {lookup-join.LookupMessageFromIndexKeepReordered SYNC} #118150

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 2b4cc3991a25f..de31dc53e7d13 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -251,6 +251,9 @@ tests:
 - class: org.elasticsearch.packaging.test.ArchiveTests
   method: test41AutoconfigurationNotTriggeredWhenNodeCannotContainData
   issue: https://github.com/elastic/elasticsearch/issues/118110
+- class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
+  method: test {lookup-join.LookupMessageFromIndexKeepReordered SYNC}
+  issue: https://github.com/elastic/elasticsearch/issues/118150
 
 # Examples:
 #

From a827970d0bfefb6313964de5e059d24b6a1d7b12 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Sat, 7 Dec 2024 00:37:32 +1100
Subject: [PATCH 080/119] Mute
 org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT test
 {lookup-join.LookupMessageFromIndexKeepReordered ASYNC} #118151

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index de31dc53e7d13..6d48052fe25e1 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -254,6 +254,9 @@ tests:
 - class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
   method: test {lookup-join.LookupMessageFromIndexKeepReordered SYNC}
   issue: https://github.com/elastic/elasticsearch/issues/118150
+- class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
+  method: test {lookup-join.LookupMessageFromIndexKeepReordered ASYNC}
+  issue: https://github.com/elastic/elasticsearch/issues/118151
 
 # Examples:
 #

From 54c320ebc9b262e66ab92af660a8a155311059d4 Mon Sep 17 00:00:00 2001
From: Ying Mao <ying.mao@elastic.co>
Date: Fri, 6 Dec 2024 09:07:57 -0500
Subject: [PATCH 081/119] Adding default endpoint for Elastic Rerank (#117939)

* Adding default endpoint for Elastic Rerank

* CustomElandRerankTaskSettings -> RerankTaskSettings

* Update docs/changelog/117939.yaml
---
 docs/changelog/117939.yaml                    |  5 ++
 .../xpack/inference/DefaultEndPointsIT.java   | 40 ++++++++++++++
 .../inference/InferenceBaseRestTest.java      | 47 ++++++++++++----
 .../xpack/inference/InferenceCrudIT.java      |  4 +-
 .../InferenceNamedWriteablesProvider.java     |  6 +-
 .../elasticsearch/CustomElandRerankModel.java |  4 +-
 .../elasticsearch/ElasticRerankerModel.java   |  5 +-
 .../ElasticsearchInternalService.java         | 55 +++++++++++++------
 ...kSettings.java => RerankTaskSettings.java} | 25 ++++-----
 .../ElasticsearchInternalServiceTests.java    | 42 +++++++-------
 ...ests.java => RerankTaskSettingsTests.java} | 48 ++++++++--------
 11 files changed, 185 insertions(+), 96 deletions(-)
 create mode 100644 docs/changelog/117939.yaml
 rename x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/{CustomElandRerankTaskSettings.java => RerankTaskSettings.java} (79%)
 rename x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/{CustomElandRerankTaskSettingsTests.java => RerankTaskSettingsTests.java} (53%)

diff --git a/docs/changelog/117939.yaml b/docs/changelog/117939.yaml
new file mode 100644
index 0000000000000..d41111f099f97
--- /dev/null
+++ b/docs/changelog/117939.yaml
@@ -0,0 +1,5 @@
+pr: 117939
+summary: Adding default endpoint for Elastic Rerank
+area: Machine Learning
+type: enhancement
+issues: []
diff --git a/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/DefaultEndPointsIT.java b/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/DefaultEndPointsIT.java
index ba3e48e11928d..068b3e1f4ce04 100644
--- a/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/DefaultEndPointsIT.java
+++ b/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/DefaultEndPointsIT.java
@@ -57,6 +57,9 @@ public void testGet() throws IOException {
 
         var e5Model = getModel(ElasticsearchInternalService.DEFAULT_E5_ID);
         assertDefaultE5Config(e5Model);
+
+        var rerankModel = getModel(ElasticsearchInternalService.DEFAULT_RERANK_ID);
+        assertDefaultRerankConfig(rerankModel);
     }
 
     @SuppressWarnings("unchecked")
@@ -125,6 +128,42 @@ private static void assertDefaultE5Config(Map<String, Object> modelConfig) {
         assertDefaultChunkingSettings(modelConfig);
     }
 
+    @SuppressWarnings("unchecked")
+    public void testInferDeploysDefaultRerank() throws IOException {
+        var model = getModel(ElasticsearchInternalService.DEFAULT_RERANK_ID);
+        assertDefaultRerankConfig(model);
+
+        var inputs = List.of("Hello World", "Goodnight moon");
+        var query = "but why";
+        var queryParams = Map.of("timeout", "120s");
+        var results = infer(ElasticsearchInternalService.DEFAULT_RERANK_ID, TaskType.RERANK, inputs, query, queryParams);
+        var embeddings = (List<Map<String, Object>>) results.get("rerank");
+        assertThat(results.toString(), embeddings, hasSize(2));
+    }
+
+    @SuppressWarnings("unchecked")
+    private static void assertDefaultRerankConfig(Map<String, Object> modelConfig) {
+        assertEquals(modelConfig.toString(), ElasticsearchInternalService.DEFAULT_RERANK_ID, modelConfig.get("inference_id"));
+        assertEquals(modelConfig.toString(), ElasticsearchInternalService.NAME, modelConfig.get("service"));
+        assertEquals(modelConfig.toString(), TaskType.RERANK.toString(), modelConfig.get("task_type"));
+
+        var serviceSettings = (Map<String, Object>) modelConfig.get("service_settings");
+        assertThat(modelConfig.toString(), serviceSettings.get("model_id"), is(".rerank-v1"));
+        assertEquals(modelConfig.toString(), 1, serviceSettings.get("num_threads"));
+
+        var adaptiveAllocations = (Map<String, Object>) serviceSettings.get("adaptive_allocations");
+        assertThat(
+            modelConfig.toString(),
+            adaptiveAllocations,
+            Matchers.is(Map.of("enabled", true, "min_number_of_allocations", 0, "max_number_of_allocations", 32))
+        );
+
+        var chunkingSettings = (Map<String, Object>) modelConfig.get("chunking_settings");
+        assertNull(chunkingSettings);
+        var taskSettings = (Map<String, Object>) modelConfig.get("task_settings");
+        assertThat(modelConfig.toString(), taskSettings, Matchers.is(Map.of("return_documents", true)));
+    }
+
     @SuppressWarnings("unchecked")
     private static void assertDefaultChunkingSettings(Map<String, Object> modelConfig) {
         var chunkingSettings = (Map<String, Object>) modelConfig.get("chunking_settings");
@@ -159,6 +198,7 @@ public void onFailure(Exception exception) {
             var request = createInferenceRequest(
                 Strings.format("_inference/%s", ElasticsearchInternalService.DEFAULT_ELSER_ID),
                 inputs,
+                null,
                 queryParams
             );
             client().performRequestAsync(request, listener);
diff --git a/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceBaseRestTest.java b/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceBaseRestTest.java
index 4e32ef99d06dd..86c0128a3e53c 100644
--- a/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceBaseRestTest.java
+++ b/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceBaseRestTest.java
@@ -333,7 +333,7 @@ private List<Object> getInternalAsList(String endpoint) throws IOException {
 
     protected Map<String, Object> infer(String modelId, List<String> input) throws IOException {
         var endpoint = Strings.format("_inference/%s", modelId);
-        return inferInternal(endpoint, input, Map.of());
+        return inferInternal(endpoint, input, null, Map.of());
     }
 
     protected Deque<ServerSentEvent> streamInferOnMockService(String modelId, TaskType taskType, List<String> input) throws Exception {
@@ -344,7 +344,7 @@ protected Deque<ServerSentEvent> streamInferOnMockService(String modelId, TaskTy
     private Deque<ServerSentEvent> callAsync(String endpoint, List<String> input) throws Exception {
         var responseConsumer = new AsyncInferenceResponseConsumer();
         var request = new Request("POST", endpoint);
-        request.setJsonEntity(jsonBody(input));
+        request.setJsonEntity(jsonBody(input, null));
         request.setOptions(RequestOptions.DEFAULT.toBuilder().setHttpAsyncResponseConsumerFactory(() -> responseConsumer).build());
         var latch = new CountDownLatch(1);
         client().performRequestAsync(request, new ResponseListener() {
@@ -364,33 +364,60 @@ public void onFailure(Exception exception) {
 
     protected Map<String, Object> infer(String modelId, TaskType taskType, List<String> input) throws IOException {
         var endpoint = Strings.format("_inference/%s/%s", taskType, modelId);
-        return inferInternal(endpoint, input, Map.of());
+        return inferInternal(endpoint, input, null, Map.of());
     }
 
     protected Map<String, Object> infer(String modelId, TaskType taskType, List<String> input, Map<String, String> queryParameters)
         throws IOException {
         var endpoint = Strings.format("_inference/%s/%s?error_trace", taskType, modelId);
-        return inferInternal(endpoint, input, queryParameters);
+        return inferInternal(endpoint, input, null, queryParameters);
     }
 
-    protected Request createInferenceRequest(String endpoint, List<String> input, Map<String, String> queryParameters) {
+    protected Map<String, Object> infer(
+        String modelId,
+        TaskType taskType,
+        List<String> input,
+        String query,
+        Map<String, String> queryParameters
+    ) throws IOException {
+        var endpoint = Strings.format("_inference/%s/%s?error_trace", taskType, modelId);
+        return inferInternal(endpoint, input, query, queryParameters);
+    }
+
+    protected Request createInferenceRequest(
+        String endpoint,
+        List<String> input,
+        @Nullable String query,
+        Map<String, String> queryParameters
+    ) {
         var request = new Request("POST", endpoint);
-        request.setJsonEntity(jsonBody(input));
+        request.setJsonEntity(jsonBody(input, query));
         if (queryParameters.isEmpty() == false) {
             request.addParameters(queryParameters);
         }
         return request;
     }
 
-    private Map<String, Object> inferInternal(String endpoint, List<String> input, Map<String, String> queryParameters) throws IOException {
-        var request = createInferenceRequest(endpoint, input, queryParameters);
+    private Map<String, Object> inferInternal(
+        String endpoint,
+        List<String> input,
+        @Nullable String query,
+        Map<String, String> queryParameters
+    ) throws IOException {
+        var request = createInferenceRequest(endpoint, input, query, queryParameters);
         var response = client().performRequest(request);
         assertOkOrCreated(response);
         return entityAsMap(response);
     }
 
-    private String jsonBody(List<String> input) {
-        var bodyBuilder = new StringBuilder("{\"input\": [");
+    private String jsonBody(List<String> input, @Nullable String query) {
+        final StringBuilder bodyBuilder = new StringBuilder("{");
+
+        if (query != null) {
+            bodyBuilder.append("\"query\":\"").append(query).append("\",");
+        }
+
+        bodyBuilder.append("\"input\": [");
         for (var in : input) {
             bodyBuilder.append('"').append(in).append('"').append(',');
         }
diff --git a/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceCrudIT.java b/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceCrudIT.java
index f5773e73f2b22..604e1d4f553b2 100644
--- a/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceCrudIT.java
+++ b/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceCrudIT.java
@@ -44,7 +44,7 @@ public void testCRUD() throws IOException {
         }
 
         var getAllModels = getAllModels();
-        int numModels = 11;
+        int numModels = 12;
         assertThat(getAllModels, hasSize(numModels));
 
         var getSparseModels = getModels("_all", TaskType.SPARSE_EMBEDDING);
@@ -482,7 +482,7 @@ public void testSupportedStream() throws Exception {
     }
 
     public void testGetZeroModels() throws IOException {
-        var models = getModels("_all", TaskType.RERANK);
+        var models = getModels("_all", TaskType.COMPLETION);
         assertThat(models, empty());
     }
 }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceNamedWriteablesProvider.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceNamedWriteablesProvider.java
index 2320cca8295d1..673b841317a3d 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceNamedWriteablesProvider.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceNamedWriteablesProvider.java
@@ -62,12 +62,12 @@
 import org.elasticsearch.xpack.inference.services.elastic.ElasticInferenceServiceSparseEmbeddingsServiceSettings;
 import org.elasticsearch.xpack.inference.services.elasticsearch.CustomElandInternalServiceSettings;
 import org.elasticsearch.xpack.inference.services.elasticsearch.CustomElandInternalTextEmbeddingServiceSettings;
-import org.elasticsearch.xpack.inference.services.elasticsearch.CustomElandRerankTaskSettings;
 import org.elasticsearch.xpack.inference.services.elasticsearch.ElasticRerankerServiceSettings;
 import org.elasticsearch.xpack.inference.services.elasticsearch.ElasticsearchInternalServiceSettings;
 import org.elasticsearch.xpack.inference.services.elasticsearch.ElserInternalServiceSettings;
 import org.elasticsearch.xpack.inference.services.elasticsearch.ElserMlNodeTaskSettings;
 import org.elasticsearch.xpack.inference.services.elasticsearch.MultilingualE5SmallInternalServiceSettings;
+import org.elasticsearch.xpack.inference.services.elasticsearch.RerankTaskSettings;
 import org.elasticsearch.xpack.inference.services.googleaistudio.completion.GoogleAiStudioCompletionServiceSettings;
 import org.elasticsearch.xpack.inference.services.googleaistudio.embeddings.GoogleAiStudioEmbeddingsServiceSettings;
 import org.elasticsearch.xpack.inference.services.googlevertexai.GoogleVertexAiSecretSettings;
@@ -510,9 +510,7 @@ private static void addCustomElandWriteables(final List<NamedWriteableRegistry.E
                 CustomElandInternalTextEmbeddingServiceSettings::new
             )
         );
-        namedWriteables.add(
-            new NamedWriteableRegistry.Entry(TaskSettings.class, CustomElandRerankTaskSettings.NAME, CustomElandRerankTaskSettings::new)
-        );
+        namedWriteables.add(new NamedWriteableRegistry.Entry(TaskSettings.class, RerankTaskSettings.NAME, RerankTaskSettings::new));
     }
 
     private static void addAnthropicNamedWritables(List<NamedWriteableRegistry.Entry> namedWriteables) {
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankModel.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankModel.java
index f620b15680c8d..6388bb33bb78d 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankModel.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankModel.java
@@ -17,7 +17,7 @@
 import java.util.HashMap;
 import java.util.Map;
 
-import static org.elasticsearch.xpack.inference.services.elasticsearch.CustomElandRerankTaskSettings.RETURN_DOCUMENTS;
+import static org.elasticsearch.xpack.inference.services.elasticsearch.RerankTaskSettings.RETURN_DOCUMENTS;
 
 public class CustomElandRerankModel extends CustomElandModel {
 
@@ -26,7 +26,7 @@ public CustomElandRerankModel(
         TaskType taskType,
         String service,
         CustomElandInternalServiceSettings serviceSettings,
-        CustomElandRerankTaskSettings taskSettings
+        RerankTaskSettings taskSettings
     ) {
         super(inferenceEntityId, taskType, service, serviceSettings, taskSettings);
     }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticRerankerModel.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticRerankerModel.java
index 115cc9f05599a..276bce6dbe8f8 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticRerankerModel.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticRerankerModel.java
@@ -9,7 +9,6 @@
 
 import org.elasticsearch.ResourceNotFoundException;
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.inference.ChunkingSettings;
 import org.elasticsearch.inference.Model;
 import org.elasticsearch.inference.TaskType;
 import org.elasticsearch.xpack.core.ml.action.CreateTrainedModelAssignmentAction;
@@ -22,9 +21,9 @@ public ElasticRerankerModel(
         TaskType taskType,
         String service,
         ElasticRerankerServiceSettings serviceSettings,
-        ChunkingSettings chunkingSettings
+        RerankTaskSettings taskSettings
     ) {
-        super(inferenceEntityId, taskType, service, serviceSettings, chunkingSettings);
+        super(inferenceEntityId, taskType, service, serviceSettings, taskSettings);
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalService.java
index 2ec3a9d629434..0e64842f873d3 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalService.java
@@ -101,6 +101,7 @@ public class ElasticsearchInternalService extends BaseElasticsearchInternalServi
     public static final int EMBEDDING_MAX_BATCH_SIZE = 10;
     public static final String DEFAULT_ELSER_ID = ".elser-2-elasticsearch";
     public static final String DEFAULT_E5_ID = ".multilingual-e5-small-elasticsearch";
+    public static final String DEFAULT_RERANK_ID = ".rerank-v1-elasticsearch";
 
     private static final EnumSet<TaskType> supportedTaskTypes = EnumSet.of(
         TaskType.RERANK,
@@ -225,7 +226,7 @@ public void parseRequestConfig(
                     )
                 );
             } else if (RERANKER_ID.equals(modelId)) {
-                rerankerCase(inferenceEntityId, taskType, config, serviceSettingsMap, chunkingSettings, modelListener);
+                rerankerCase(inferenceEntityId, taskType, config, serviceSettingsMap, taskSettingsMap, modelListener);
             } else {
                 customElandCase(inferenceEntityId, taskType, serviceSettingsMap, taskSettingsMap, chunkingSettings, modelListener);
             }
@@ -308,7 +309,7 @@ private static CustomElandModel createCustomElandModel(
                 taskType,
                 NAME,
                 elandServiceSettings(serviceSettings, context),
-                CustomElandRerankTaskSettings.fromMap(taskSettings)
+                RerankTaskSettings.fromMap(taskSettings)
             );
             default -> throw new ElasticsearchStatusException(TaskType.unsupportedTaskTypeErrorMsg(taskType, NAME), RestStatus.BAD_REQUEST);
         };
@@ -331,7 +332,7 @@ private void rerankerCase(
         TaskType taskType,
         Map<String, Object> config,
         Map<String, Object> serviceSettingsMap,
-        ChunkingSettings chunkingSettings,
+        Map<String, Object> taskSettingsMap,
         ActionListener<Model> modelListener
     ) {
 
@@ -346,7 +347,7 @@ private void rerankerCase(
                 taskType,
                 NAME,
                 new ElasticRerankerServiceSettings(esServiceSettingsBuilder.build()),
-                chunkingSettings
+                RerankTaskSettings.fromMap(taskSettingsMap)
             )
         );
     }
@@ -512,6 +513,14 @@ public Model parsePersistedConfig(String inferenceEntityId, TaskType taskType, M
                 ElserMlNodeTaskSettings.DEFAULT,
                 chunkingSettings
             );
+        } else if (modelId.equals(RERANKER_ID)) {
+            return new ElasticRerankerModel(
+                inferenceEntityId,
+                taskType,
+                NAME,
+                new ElasticRerankerServiceSettings(ElasticsearchInternalServiceSettings.fromPersistedMap(serviceSettingsMap)),
+                RerankTaskSettings.fromMap(taskSettingsMap)
+            );
         } else {
             return createCustomElandModel(
                 inferenceEntityId,
@@ -653,21 +662,23 @@ public void inferRerank(
     ) {
         var request = buildInferenceRequest(model.mlNodeDeploymentId(), new TextSimilarityConfigUpdate(query), inputs, inputType, timeout);
 
-        var modelSettings = (CustomElandRerankTaskSettings) model.getTaskSettings();
-        var requestSettings = CustomElandRerankTaskSettings.fromMap(requestTaskSettings);
-        Boolean returnDocs = CustomElandRerankTaskSettings.of(modelSettings, requestSettings).returnDocuments();
+        var returnDocs = Boolean.TRUE;
+        if (model.getTaskSettings() instanceof RerankTaskSettings modelSettings) {
+            var requestSettings = RerankTaskSettings.fromMap(requestTaskSettings);
+            returnDocs = RerankTaskSettings.of(modelSettings, requestSettings).returnDocuments();
+        }
 
         Function<Integer, String> inputSupplier = returnDocs == Boolean.TRUE ? inputs::get : i -> null;
 
-        client.execute(
-            InferModelAction.INSTANCE,
-            request,
-            listener.delegateFailureAndWrap(
-                (l, inferenceResult) -> l.onResponse(
-                    textSimilarityResultsToRankedDocs(inferenceResult.getInferenceResults(), inputSupplier)
-                )
-            )
+        ActionListener<InferModelAction.Response> mlResultsListener = listener.delegateFailureAndWrap(
+            (l, inferenceResult) -> l.onResponse(textSimilarityResultsToRankedDocs(inferenceResult.getInferenceResults(), inputSupplier))
+        );
+
+        var maybeDeployListener = mlResultsListener.delegateResponse(
+            (l, exception) -> maybeStartDeployment(model, exception, request, mlResultsListener)
         );
+
+        client.execute(InferModelAction.INSTANCE, request, maybeDeployListener);
     }
 
     public void chunkedInfer(
@@ -811,7 +822,8 @@ private RankedDocsResults textSimilarityResultsToRankedDocs(
     public List<DefaultConfigId> defaultConfigIds() {
         return List.of(
             new DefaultConfigId(DEFAULT_ELSER_ID, TaskType.SPARSE_EMBEDDING, this),
-            new DefaultConfigId(DEFAULT_E5_ID, TaskType.TEXT_EMBEDDING, this)
+            new DefaultConfigId(DEFAULT_E5_ID, TaskType.TEXT_EMBEDDING, this),
+            new DefaultConfigId(DEFAULT_RERANK_ID, TaskType.RERANK, this)
         );
     }
 
@@ -904,12 +916,19 @@ private List<Model> defaultConfigs(boolean useLinuxOptimizedModel) {
             ),
             ChunkingSettingsBuilder.DEFAULT_SETTINGS
         );
-        return List.of(defaultElser, defaultE5);
+        var defaultRerank = new ElasticRerankerModel(
+            DEFAULT_RERANK_ID,
+            TaskType.RERANK,
+            NAME,
+            new ElasticRerankerServiceSettings(null, 1, RERANKER_ID, new AdaptiveAllocationsSettings(Boolean.TRUE, 0, 32)),
+            RerankTaskSettings.DEFAULT_SETTINGS
+        );
+        return List.of(defaultElser, defaultE5, defaultRerank);
     }
 
     @Override
     boolean isDefaultId(String inferenceId) {
-        return DEFAULT_ELSER_ID.equals(inferenceId) || DEFAULT_E5_ID.equals(inferenceId);
+        return DEFAULT_ELSER_ID.equals(inferenceId) || DEFAULT_E5_ID.equals(inferenceId) || DEFAULT_RERANK_ID.equals(inferenceId);
     }
 
     static EmbeddingRequestChunker.EmbeddingType embeddingTypeFromTaskTypeAndSettings(
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankTaskSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/RerankTaskSettings.java
similarity index 79%
rename from x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankTaskSettings.java
rename to x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/RerankTaskSettings.java
index a0be1661b860d..3c25f7a6a9016 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankTaskSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/RerankTaskSettings.java
@@ -26,14 +26,14 @@
 /**
  * Defines the task settings for internal rerank service.
  */
-public class CustomElandRerankTaskSettings implements TaskSettings {
+public class RerankTaskSettings implements TaskSettings {
 
     public static final String NAME = "custom_eland_rerank_task_settings";
     public static final String RETURN_DOCUMENTS = "return_documents";
 
-    static final CustomElandRerankTaskSettings DEFAULT_SETTINGS = new CustomElandRerankTaskSettings(Boolean.TRUE);
+    static final RerankTaskSettings DEFAULT_SETTINGS = new RerankTaskSettings(Boolean.TRUE);
 
-    public static CustomElandRerankTaskSettings defaultsFromMap(Map<String, Object> map) {
+    public static RerankTaskSettings defaultsFromMap(Map<String, Object> map) {
         ValidationException validationException = new ValidationException();
 
         if (map == null || map.isEmpty()) {
@@ -49,7 +49,7 @@ public static CustomElandRerankTaskSettings defaultsFromMap(Map<String, Object>
             returnDocuments = true;
         }
 
-        return new CustomElandRerankTaskSettings(returnDocuments);
+        return new RerankTaskSettings(returnDocuments);
     }
 
     /**
@@ -57,13 +57,13 @@ public static CustomElandRerankTaskSettings defaultsFromMap(Map<String, Object>
      * @param map source map
      * @return Task settings
      */
-    public static CustomElandRerankTaskSettings fromMap(Map<String, Object> map) {
+    public static RerankTaskSettings fromMap(Map<String, Object> map) {
         if (map == null || map.isEmpty()) {
             return DEFAULT_SETTINGS;
         }
 
         Boolean returnDocuments = extractOptionalBoolean(map, RETURN_DOCUMENTS, new ValidationException());
-        return new CustomElandRerankTaskSettings(returnDocuments);
+        return new RerankTaskSettings(returnDocuments);
     }
 
     /**
@@ -74,20 +74,17 @@ public static CustomElandRerankTaskSettings fromMap(Map<String, Object> map) {
      * @param requestTaskSettings the settings passed in within the task_settings field of the request
      * @return Either {@code originalSettings} or {@code requestTaskSettings}
      */
-    public static CustomElandRerankTaskSettings of(
-        CustomElandRerankTaskSettings originalSettings,
-        CustomElandRerankTaskSettings requestTaskSettings
-    ) {
+    public static RerankTaskSettings of(RerankTaskSettings originalSettings, RerankTaskSettings requestTaskSettings) {
         return requestTaskSettings.returnDocuments() != null ? requestTaskSettings : originalSettings;
     }
 
     private final Boolean returnDocuments;
 
-    public CustomElandRerankTaskSettings(StreamInput in) throws IOException {
+    public RerankTaskSettings(StreamInput in) throws IOException {
         this(in.readOptionalBoolean());
     }
 
-    public CustomElandRerankTaskSettings(@Nullable Boolean doReturnDocuments) {
+    public RerankTaskSettings(@Nullable Boolean doReturnDocuments) {
         if (doReturnDocuments == null) {
             this.returnDocuments = true;
         } else {
@@ -133,7 +130,7 @@ public Boolean returnDocuments() {
     public boolean equals(Object o) {
         if (this == o) return true;
         if (o == null || getClass() != o.getClass()) return false;
-        CustomElandRerankTaskSettings that = (CustomElandRerankTaskSettings) o;
+        RerankTaskSettings that = (RerankTaskSettings) o;
         return Objects.equals(returnDocuments, that.returnDocuments);
     }
 
@@ -144,7 +141,7 @@ public int hashCode() {
 
     @Override
     public TaskSettings updatedTaskSettings(Map<String, Object> newSettings) {
-        CustomElandRerankTaskSettings updatedSettings = CustomElandRerankTaskSettings.fromMap(new HashMap<>(newSettings));
+        RerankTaskSettings updatedSettings = RerankTaskSettings.fromMap(new HashMap<>(newSettings));
         return of(this, updatedSettings);
     }
 }
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalServiceTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalServiceTests.java
index 306509ea60cfc..17e6583f11c8f 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalServiceTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalServiceTests.java
@@ -534,16 +534,13 @@ public void testParseRequestConfig_Rerank() {
                 )
             );
             var returnDocs = randomBoolean();
-            settings.put(
-                ModelConfigurations.TASK_SETTINGS,
-                new HashMap<>(Map.of(CustomElandRerankTaskSettings.RETURN_DOCUMENTS, returnDocs))
-            );
+            settings.put(ModelConfigurations.TASK_SETTINGS, new HashMap<>(Map.of(RerankTaskSettings.RETURN_DOCUMENTS, returnDocs)));
 
             ActionListener<Model> modelListener = ActionListener.<Model>wrap(model -> {
                 assertThat(model, instanceOf(CustomElandRerankModel.class));
-                assertThat(model.getTaskSettings(), instanceOf(CustomElandRerankTaskSettings.class));
+                assertThat(model.getTaskSettings(), instanceOf(RerankTaskSettings.class));
                 assertThat(model.getServiceSettings(), instanceOf(CustomElandInternalServiceSettings.class));
-                assertEquals(returnDocs, ((CustomElandRerankTaskSettings) model.getTaskSettings()).returnDocuments());
+                assertEquals(returnDocs, ((RerankTaskSettings) model.getTaskSettings()).returnDocuments());
             }, e -> { fail("Model parsing failed " + e.getMessage()); });
 
             service.parseRequestConfig(randomInferenceEntityId, TaskType.RERANK, settings, modelListener);
@@ -583,9 +580,9 @@ public void testParseRequestConfig_Rerank_DefaultTaskSettings() {
 
             ActionListener<Model> modelListener = ActionListener.<Model>wrap(model -> {
                 assertThat(model, instanceOf(CustomElandRerankModel.class));
-                assertThat(model.getTaskSettings(), instanceOf(CustomElandRerankTaskSettings.class));
+                assertThat(model.getTaskSettings(), instanceOf(RerankTaskSettings.class));
                 assertThat(model.getServiceSettings(), instanceOf(CustomElandInternalServiceSettings.class));
-                assertEquals(Boolean.TRUE, ((CustomElandRerankTaskSettings) model.getTaskSettings()).returnDocuments());
+                assertEquals(Boolean.TRUE, ((RerankTaskSettings) model.getTaskSettings()).returnDocuments());
             }, e -> { fail("Model parsing failed " + e.getMessage()); });
 
             service.parseRequestConfig(randomInferenceEntityId, TaskType.RERANK, settings, modelListener);
@@ -1249,14 +1246,11 @@ public void testParsePersistedConfig_Rerank() {
             );
             settings.put(ElasticsearchInternalServiceSettings.MODEL_ID, "foo");
             var returnDocs = randomBoolean();
-            settings.put(
-                ModelConfigurations.TASK_SETTINGS,
-                new HashMap<>(Map.of(CustomElandRerankTaskSettings.RETURN_DOCUMENTS, returnDocs))
-            );
+            settings.put(ModelConfigurations.TASK_SETTINGS, new HashMap<>(Map.of(RerankTaskSettings.RETURN_DOCUMENTS, returnDocs)));
 
             var model = service.parsePersistedConfig(randomInferenceEntityId, TaskType.RERANK, settings);
-            assertThat(model.getTaskSettings(), instanceOf(CustomElandRerankTaskSettings.class));
-            assertEquals(returnDocs, ((CustomElandRerankTaskSettings) model.getTaskSettings()).returnDocuments());
+            assertThat(model.getTaskSettings(), instanceOf(RerankTaskSettings.class));
+            assertEquals(returnDocs, ((RerankTaskSettings) model.getTaskSettings()).returnDocuments());
         }
 
         // without task settings
@@ -1279,8 +1273,8 @@ public void testParsePersistedConfig_Rerank() {
             settings.put(ElasticsearchInternalServiceSettings.MODEL_ID, "foo");
 
             var model = service.parsePersistedConfig(randomInferenceEntityId, TaskType.RERANK, settings);
-            assertThat(model.getTaskSettings(), instanceOf(CustomElandRerankTaskSettings.class));
-            assertTrue(((CustomElandRerankTaskSettings) model.getTaskSettings()).returnDocuments());
+            assertThat(model.getTaskSettings(), instanceOf(RerankTaskSettings.class));
+            assertTrue(((RerankTaskSettings) model.getTaskSettings()).returnDocuments());
         }
     }
 
@@ -1335,7 +1329,7 @@ private CustomElandModel getCustomElandModel(TaskType taskType) {
                 taskType,
                 ElasticsearchInternalService.NAME,
                 new CustomElandInternalServiceSettings(1, 4, "custom-model", null),
-                CustomElandRerankTaskSettings.DEFAULT_SETTINGS
+                RerankTaskSettings.DEFAULT_SETTINGS
             );
         } else if (taskType == TaskType.TEXT_EMBEDDING) {
             var serviceSettings = new CustomElandInternalTextEmbeddingServiceSettings(1, 4, "custom-model", null);
@@ -1528,20 +1522,30 @@ public void testEmbeddingTypeFromTaskTypeAndSettings() {
             )
         );
 
-        var e = expectThrows(
+        var e1 = expectThrows(
             ElasticsearchStatusException.class,
             () -> ElasticsearchInternalService.embeddingTypeFromTaskTypeAndSettings(
                 TaskType.COMPLETION,
                 new ElasticsearchInternalServiceSettings(1, 1, "foo", null)
             )
         );
-        assertThat(e.getMessage(), containsString("Chunking is not supported for task type [completion]"));
+        assertThat(e1.getMessage(), containsString("Chunking is not supported for task type [completion]"));
+
+        var e2 = expectThrows(
+            ElasticsearchStatusException.class,
+            () -> ElasticsearchInternalService.embeddingTypeFromTaskTypeAndSettings(
+                TaskType.RERANK,
+                new ElasticsearchInternalServiceSettings(1, 1, "foo", null)
+            )
+        );
+        assertThat(e2.getMessage(), containsString("Chunking is not supported for task type [rerank]"));
     }
 
     public void testIsDefaultId() {
         var service = createService(mock(Client.class));
         assertTrue(service.isDefaultId(".elser-2-elasticsearch"));
         assertTrue(service.isDefaultId(".multilingual-e5-small-elasticsearch"));
+        assertTrue(service.isDefaultId(".rerank-v1-elasticsearch"));
         assertFalse(service.isDefaultId("foo"));
     }
 
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankTaskSettingsTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/RerankTaskSettingsTests.java
similarity index 53%
rename from x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankTaskSettingsTests.java
rename to x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/RerankTaskSettingsTests.java
index 4207896fc54f3..255454a1ed62b 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankTaskSettingsTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/RerankTaskSettingsTests.java
@@ -22,7 +22,7 @@
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.sameInstance;
 
-public class CustomElandRerankTaskSettingsTests extends AbstractWireSerializingTestCase<CustomElandRerankTaskSettings> {
+public class RerankTaskSettingsTests extends AbstractWireSerializingTestCase<RerankTaskSettings> {
 
     public void testIsEmpty() {
         var randomSettings = createRandom();
@@ -35,9 +35,9 @@ public void testUpdatedTaskSettings() {
         var newSettings = createRandom();
         Map<String, Object> newSettingsMap = new HashMap<>();
         if (newSettings.returnDocuments() != null) {
-            newSettingsMap.put(CustomElandRerankTaskSettings.RETURN_DOCUMENTS, newSettings.returnDocuments());
+            newSettingsMap.put(RerankTaskSettings.RETURN_DOCUMENTS, newSettings.returnDocuments());
         }
-        CustomElandRerankTaskSettings updatedSettings = (CustomElandRerankTaskSettings) initialSettings.updatedTaskSettings(
+        RerankTaskSettings updatedSettings = (RerankTaskSettings) initialSettings.updatedTaskSettings(
             Collections.unmodifiableMap(newSettingsMap)
         );
         if (newSettings.returnDocuments() == null) {
@@ -48,37 +48,37 @@ public void testUpdatedTaskSettings() {
     }
 
     public void testDefaultsFromMap_MapIsNull_ReturnsDefaultSettings() {
-        var customElandRerankTaskSettings = CustomElandRerankTaskSettings.defaultsFromMap(null);
+        var rerankTaskSettings = RerankTaskSettings.defaultsFromMap(null);
 
-        assertThat(customElandRerankTaskSettings, sameInstance(CustomElandRerankTaskSettings.DEFAULT_SETTINGS));
+        assertThat(rerankTaskSettings, sameInstance(RerankTaskSettings.DEFAULT_SETTINGS));
     }
 
     public void testDefaultsFromMap_MapIsEmpty_ReturnsDefaultSettings() {
-        var customElandRerankTaskSettings = CustomElandRerankTaskSettings.defaultsFromMap(new HashMap<>());
+        var rerankTaskSettings = RerankTaskSettings.defaultsFromMap(new HashMap<>());
 
-        assertThat(customElandRerankTaskSettings, sameInstance(CustomElandRerankTaskSettings.DEFAULT_SETTINGS));
+        assertThat(rerankTaskSettings, sameInstance(RerankTaskSettings.DEFAULT_SETTINGS));
     }
 
     public void testDefaultsFromMap_ExtractedReturnDocumentsNull_SetsReturnDocumentToTrue() {
-        var customElandRerankTaskSettings = CustomElandRerankTaskSettings.defaultsFromMap(new HashMap<>());
+        var rerankTaskSettings = RerankTaskSettings.defaultsFromMap(new HashMap<>());
 
-        assertThat(customElandRerankTaskSettings.returnDocuments(), is(Boolean.TRUE));
+        assertThat(rerankTaskSettings.returnDocuments(), is(Boolean.TRUE));
     }
 
     public void testFromMap_MapIsNull_ReturnsDefaultSettings() {
-        var customElandRerankTaskSettings = CustomElandRerankTaskSettings.fromMap(null);
+        var rerankTaskSettings = RerankTaskSettings.fromMap(null);
 
-        assertThat(customElandRerankTaskSettings, sameInstance(CustomElandRerankTaskSettings.DEFAULT_SETTINGS));
+        assertThat(rerankTaskSettings, sameInstance(RerankTaskSettings.DEFAULT_SETTINGS));
     }
 
     public void testFromMap_MapIsEmpty_ReturnsDefaultSettings() {
-        var customElandRerankTaskSettings = CustomElandRerankTaskSettings.fromMap(new HashMap<>());
+        var rerankTaskSettings = RerankTaskSettings.fromMap(new HashMap<>());
 
-        assertThat(customElandRerankTaskSettings, sameInstance(CustomElandRerankTaskSettings.DEFAULT_SETTINGS));
+        assertThat(rerankTaskSettings, sameInstance(RerankTaskSettings.DEFAULT_SETTINGS));
     }
 
     public void testToXContent_WritesAllValues() throws IOException {
-        var serviceSettings = new CustomElandRerankTaskSettings(Boolean.TRUE);
+        var serviceSettings = new RerankTaskSettings(Boolean.TRUE);
 
         XContentBuilder builder = XContentFactory.contentBuilder(XContentType.JSON);
         serviceSettings.toXContent(builder, null);
@@ -89,30 +89,30 @@ public void testToXContent_WritesAllValues() throws IOException {
     }
 
     public void testOf_PrefersNonNullRequestTaskSettings() {
-        var originalSettings = new CustomElandRerankTaskSettings(Boolean.FALSE);
-        var requestTaskSettings = new CustomElandRerankTaskSettings(Boolean.TRUE);
+        var originalSettings = new RerankTaskSettings(Boolean.FALSE);
+        var requestTaskSettings = new RerankTaskSettings(Boolean.TRUE);
 
-        var taskSettings = CustomElandRerankTaskSettings.of(originalSettings, requestTaskSettings);
+        var taskSettings = RerankTaskSettings.of(originalSettings, requestTaskSettings);
 
         assertThat(taskSettings, sameInstance(requestTaskSettings));
     }
 
-    private static CustomElandRerankTaskSettings createRandom() {
-        return new CustomElandRerankTaskSettings(randomOptionalBoolean());
+    private static RerankTaskSettings createRandom() {
+        return new RerankTaskSettings(randomOptionalBoolean());
     }
 
     @Override
-    protected Writeable.Reader<CustomElandRerankTaskSettings> instanceReader() {
-        return CustomElandRerankTaskSettings::new;
+    protected Writeable.Reader<RerankTaskSettings> instanceReader() {
+        return RerankTaskSettings::new;
     }
 
     @Override
-    protected CustomElandRerankTaskSettings createTestInstance() {
+    protected RerankTaskSettings createTestInstance() {
         return createRandom();
     }
 
     @Override
-    protected CustomElandRerankTaskSettings mutateInstance(CustomElandRerankTaskSettings instance) throws IOException {
-        return randomValueOtherThan(instance, CustomElandRerankTaskSettingsTests::createRandom);
+    protected RerankTaskSettings mutateInstance(RerankTaskSettings instance) throws IOException {
+        return randomValueOtherThan(instance, RerankTaskSettingsTests::createRandom);
     }
 }

From 7cd17d21856f0a90b5eb2bfbe6fa37cc3f5d3ce1 Mon Sep 17 00:00:00 2001
From: Mark Tozzi <mark.tozzi@gmail.com>
Date: Fri, 6 Dec 2024 09:17:32 -0500
Subject: [PATCH 082/119] Esql compare nanos and millis (#118027)

Resolves #116281

Introduces support for comparing millisecond dates with nanosecond dates, without the need for casting. Millisecond dates outside of the nanosecond date range are handled correctly.
---
 docs/changelog/118027.yaml                    |   6 +
 .../functions/kibana/definition/equals.json   |  36 +++++
 .../kibana/definition/greater_than.json       |  36 +++++
 .../definition/greater_than_or_equal.json     |  36 +++++
 .../kibana/definition/less_than.json          |  36 +++++
 .../kibana/definition/less_than_or_equal.json |  36 +++++
 .../kibana/definition/not_equals.json         |  36 +++++
 .../esql/functions/types/equals.asciidoc      |   2 +
 .../functions/types/greater_than.asciidoc     |   2 +
 .../types/greater_than_or_equal.asciidoc      |   2 +
 .../esql/functions/types/less_than.asciidoc   |   2 +
 .../types/less_than_or_equal.asciidoc         |   2 +
 .../esql/functions/types/not_equals.asciidoc  |   2 +
 .../elasticsearch/common/time/DateUtils.java  |  31 ++++
 .../common/time/DateUtilsTests.java           |  40 +++++
 .../xpack/esql/EsqlTestUtils.java             |   2 +-
 .../src/main/resources/date_nanos.csv-spec    |  95 ++++++++++-
 .../EqualsMillisNanosEvaluator.java           | 148 ++++++++++++++++++
 .../EqualsNanosMillisEvaluator.java           | 148 ++++++++++++++++++
 .../GreaterThanMillisNanosEvaluator.java      | 148 ++++++++++++++++++
 .../GreaterThanNanosMillisEvaluator.java      | 148 ++++++++++++++++++
 ...reaterThanOrEqualMillisNanosEvaluator.java | 148 ++++++++++++++++++
 ...reaterThanOrEqualNanosMillisEvaluator.java | 148 ++++++++++++++++++
 .../LessThanMillisNanosEvaluator.java         | 148 ++++++++++++++++++
 .../LessThanNanosMillisEvaluator.java         | 148 ++++++++++++++++++
 .../LessThanOrEqualMillisNanosEvaluator.java  | 148 ++++++++++++++++++
 .../LessThanOrEqualNanosMillisEvaluator.java  | 148 ++++++++++++++++++
 .../NotEqualsMillisNanosEvaluator.java        | 148 ++++++++++++++++++
 .../NotEqualsNanosMillisEvaluator.java        | 148 ++++++++++++++++++
 .../xpack/esql/action/EsqlCapabilities.java   |   5 +
 .../xpack/esql/analysis/Verifier.java         |  13 +-
 .../predicate/operator/comparison/Equals.java |  32 +++-
 .../comparison/EsqlBinaryComparison.java      |  36 ++++-
 .../operator/comparison/GreaterThan.java      |  33 +++-
 .../comparison/GreaterThanOrEqual.java        |  33 +++-
 .../operator/comparison/LessThan.java         |  23 ++-
 .../operator/comparison/LessThanOrEqual.java  |  23 ++-
 .../operator/comparison/NotEquals.java        |  32 +++-
 .../expression/function/TestCaseSupplier.java |   4 +-
 .../operator/comparison/EqualsTests.java      |  28 ++++
 .../comparison/GreaterThanOrEqualTests.java   |  28 ++++
 .../operator/comparison/GreaterThanTests.java |  28 ++++
 .../comparison/LessThanOrEqualTests.java      |  28 ++++
 .../operator/comparison/LessThanTests.java    |  28 ++++
 .../operator/comparison/NotEqualsTests.java   |  32 +++-
 45 files changed, 2560 insertions(+), 24 deletions(-)
 create mode 100644 docs/changelog/118027.yaml
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/EqualsMillisNanosEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/EqualsNanosMillisEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanMillisNanosEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanNanosMillisEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanOrEqualMillisNanosEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanOrEqualNanosMillisEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanMillisNanosEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanNanosMillisEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanOrEqualMillisNanosEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanOrEqualNanosMillisEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/NotEqualsMillisNanosEvaluator.java
 create mode 100644 x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/NotEqualsNanosMillisEvaluator.java

diff --git a/docs/changelog/118027.yaml b/docs/changelog/118027.yaml
new file mode 100644
index 0000000000000..161c156b56a65
--- /dev/null
+++ b/docs/changelog/118027.yaml
@@ -0,0 +1,6 @@
+pr: 118027
+summary: Esql compare nanos and millis
+area: ES|QL
+type: enhancement
+issues:
+ - 116281
diff --git a/docs/reference/esql/functions/kibana/definition/equals.json b/docs/reference/esql/functions/kibana/definition/equals.json
index 885d949f4b20f..40f3d54ba597a 100644
--- a/docs/reference/esql/functions/kibana/definition/equals.json
+++ b/docs/reference/esql/functions/kibana/definition/equals.json
@@ -77,6 +77,42 @@
       "variadic" : false,
       "returnType" : "boolean"
     },
+    {
+      "params" : [
+        {
+          "name" : "lhs",
+          "type" : "date",
+          "optional" : false,
+          "description" : "An expression."
+        },
+        {
+          "name" : "rhs",
+          "type" : "date_nanos",
+          "optional" : false,
+          "description" : "An expression."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    },
+    {
+      "params" : [
+        {
+          "name" : "lhs",
+          "type" : "date_nanos",
+          "optional" : false,
+          "description" : "An expression."
+        },
+        {
+          "name" : "rhs",
+          "type" : "date",
+          "optional" : false,
+          "description" : "An expression."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    },
     {
       "params" : [
         {
diff --git a/docs/reference/esql/functions/kibana/definition/greater_than.json b/docs/reference/esql/functions/kibana/definition/greater_than.json
index cf6e30a0a4547..ea2c0fb1212c7 100644
--- a/docs/reference/esql/functions/kibana/definition/greater_than.json
+++ b/docs/reference/esql/functions/kibana/definition/greater_than.json
@@ -23,6 +23,42 @@
       "variadic" : false,
       "returnType" : "boolean"
     },
+    {
+      "params" : [
+        {
+          "name" : "lhs",
+          "type" : "date",
+          "optional" : false,
+          "description" : "An expression."
+        },
+        {
+          "name" : "rhs",
+          "type" : "date_nanos",
+          "optional" : false,
+          "description" : "An expression."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    },
+    {
+      "params" : [
+        {
+          "name" : "lhs",
+          "type" : "date_nanos",
+          "optional" : false,
+          "description" : "An expression."
+        },
+        {
+          "name" : "rhs",
+          "type" : "date",
+          "optional" : false,
+          "description" : "An expression."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    },
     {
       "params" : [
         {
diff --git a/docs/reference/esql/functions/kibana/definition/greater_than_or_equal.json b/docs/reference/esql/functions/kibana/definition/greater_than_or_equal.json
index 2535c68af6acf..7e1feb37e87b0 100644
--- a/docs/reference/esql/functions/kibana/definition/greater_than_or_equal.json
+++ b/docs/reference/esql/functions/kibana/definition/greater_than_or_equal.json
@@ -23,6 +23,42 @@
       "variadic" : false,
       "returnType" : "boolean"
     },
+    {
+      "params" : [
+        {
+          "name" : "lhs",
+          "type" : "date",
+          "optional" : false,
+          "description" : "An expression."
+        },
+        {
+          "name" : "rhs",
+          "type" : "date_nanos",
+          "optional" : false,
+          "description" : "An expression."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    },
+    {
+      "params" : [
+        {
+          "name" : "lhs",
+          "type" : "date_nanos",
+          "optional" : false,
+          "description" : "An expression."
+        },
+        {
+          "name" : "rhs",
+          "type" : "date",
+          "optional" : false,
+          "description" : "An expression."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    },
     {
       "params" : [
         {
diff --git a/docs/reference/esql/functions/kibana/definition/less_than.json b/docs/reference/esql/functions/kibana/definition/less_than.json
index a73754d200d46..71aae4d759ecf 100644
--- a/docs/reference/esql/functions/kibana/definition/less_than.json
+++ b/docs/reference/esql/functions/kibana/definition/less_than.json
@@ -23,6 +23,42 @@
       "variadic" : false,
       "returnType" : "boolean"
     },
+    {
+      "params" : [
+        {
+          "name" : "lhs",
+          "type" : "date",
+          "optional" : false,
+          "description" : "An expression."
+        },
+        {
+          "name" : "rhs",
+          "type" : "date_nanos",
+          "optional" : false,
+          "description" : "An expression."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    },
+    {
+      "params" : [
+        {
+          "name" : "lhs",
+          "type" : "date_nanos",
+          "optional" : false,
+          "description" : "An expression."
+        },
+        {
+          "name" : "rhs",
+          "type" : "date",
+          "optional" : false,
+          "description" : "An expression."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    },
     {
       "params" : [
         {
diff --git a/docs/reference/esql/functions/kibana/definition/less_than_or_equal.json b/docs/reference/esql/functions/kibana/definition/less_than_or_equal.json
index 7af477db32a34..f119b7ab2eb12 100644
--- a/docs/reference/esql/functions/kibana/definition/less_than_or_equal.json
+++ b/docs/reference/esql/functions/kibana/definition/less_than_or_equal.json
@@ -23,6 +23,42 @@
       "variadic" : false,
       "returnType" : "boolean"
     },
+    {
+      "params" : [
+        {
+          "name" : "lhs",
+          "type" : "date",
+          "optional" : false,
+          "description" : "An expression."
+        },
+        {
+          "name" : "rhs",
+          "type" : "date_nanos",
+          "optional" : false,
+          "description" : "An expression."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    },
+    {
+      "params" : [
+        {
+          "name" : "lhs",
+          "type" : "date_nanos",
+          "optional" : false,
+          "description" : "An expression."
+        },
+        {
+          "name" : "rhs",
+          "type" : "date",
+          "optional" : false,
+          "description" : "An expression."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    },
     {
       "params" : [
         {
diff --git a/docs/reference/esql/functions/kibana/definition/not_equals.json b/docs/reference/esql/functions/kibana/definition/not_equals.json
index 24f31115cbc37..d35a5b43ec238 100644
--- a/docs/reference/esql/functions/kibana/definition/not_equals.json
+++ b/docs/reference/esql/functions/kibana/definition/not_equals.json
@@ -77,6 +77,42 @@
       "variadic" : false,
       "returnType" : "boolean"
     },
+    {
+      "params" : [
+        {
+          "name" : "lhs",
+          "type" : "date",
+          "optional" : false,
+          "description" : "An expression."
+        },
+        {
+          "name" : "rhs",
+          "type" : "date_nanos",
+          "optional" : false,
+          "description" : "An expression."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    },
+    {
+      "params" : [
+        {
+          "name" : "lhs",
+          "type" : "date_nanos",
+          "optional" : false,
+          "description" : "An expression."
+        },
+        {
+          "name" : "rhs",
+          "type" : "date",
+          "optional" : false,
+          "description" : "An expression."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    },
     {
       "params" : [
         {
diff --git a/docs/reference/esql/functions/types/equals.asciidoc b/docs/reference/esql/functions/types/equals.asciidoc
index 8d48b7ebf084a..1bb8bf2122b35 100644
--- a/docs/reference/esql/functions/types/equals.asciidoc
+++ b/docs/reference/esql/functions/types/equals.asciidoc
@@ -9,6 +9,8 @@ boolean | boolean | boolean
 cartesian_point | cartesian_point | boolean
 cartesian_shape | cartesian_shape | boolean
 date | date | boolean
+date | date_nanos | boolean
+date_nanos | date | boolean
 date_nanos | date_nanos | boolean
 double | double | boolean
 double | integer | boolean
diff --git a/docs/reference/esql/functions/types/greater_than.asciidoc b/docs/reference/esql/functions/types/greater_than.asciidoc
index 8000fd34c8507..39253ac445f42 100644
--- a/docs/reference/esql/functions/types/greater_than.asciidoc
+++ b/docs/reference/esql/functions/types/greater_than.asciidoc
@@ -6,6 +6,8 @@
 |===
 lhs | rhs | result
 date | date | boolean
+date | date_nanos | boolean
+date_nanos | date | boolean
 date_nanos | date_nanos | boolean
 double | double | boolean
 double | integer | boolean
diff --git a/docs/reference/esql/functions/types/greater_than_or_equal.asciidoc b/docs/reference/esql/functions/types/greater_than_or_equal.asciidoc
index 8000fd34c8507..39253ac445f42 100644
--- a/docs/reference/esql/functions/types/greater_than_or_equal.asciidoc
+++ b/docs/reference/esql/functions/types/greater_than_or_equal.asciidoc
@@ -6,6 +6,8 @@
 |===
 lhs | rhs | result
 date | date | boolean
+date | date_nanos | boolean
+date_nanos | date | boolean
 date_nanos | date_nanos | boolean
 double | double | boolean
 double | integer | boolean
diff --git a/docs/reference/esql/functions/types/less_than.asciidoc b/docs/reference/esql/functions/types/less_than.asciidoc
index 8000fd34c8507..39253ac445f42 100644
--- a/docs/reference/esql/functions/types/less_than.asciidoc
+++ b/docs/reference/esql/functions/types/less_than.asciidoc
@@ -6,6 +6,8 @@
 |===
 lhs | rhs | result
 date | date | boolean
+date | date_nanos | boolean
+date_nanos | date | boolean
 date_nanos | date_nanos | boolean
 double | double | boolean
 double | integer | boolean
diff --git a/docs/reference/esql/functions/types/less_than_or_equal.asciidoc b/docs/reference/esql/functions/types/less_than_or_equal.asciidoc
index 8000fd34c8507..39253ac445f42 100644
--- a/docs/reference/esql/functions/types/less_than_or_equal.asciidoc
+++ b/docs/reference/esql/functions/types/less_than_or_equal.asciidoc
@@ -6,6 +6,8 @@
 |===
 lhs | rhs | result
 date | date | boolean
+date | date_nanos | boolean
+date_nanos | date | boolean
 date_nanos | date_nanos | boolean
 double | double | boolean
 double | integer | boolean
diff --git a/docs/reference/esql/functions/types/not_equals.asciidoc b/docs/reference/esql/functions/types/not_equals.asciidoc
index 8d48b7ebf084a..1bb8bf2122b35 100644
--- a/docs/reference/esql/functions/types/not_equals.asciidoc
+++ b/docs/reference/esql/functions/types/not_equals.asciidoc
@@ -9,6 +9,8 @@ boolean | boolean | boolean
 cartesian_point | cartesian_point | boolean
 cartesian_shape | cartesian_shape | boolean
 date | date | boolean
+date | date_nanos | boolean
+date_nanos | date | boolean
 date_nanos | date_nanos | boolean
 double | double | boolean
 double | integer | boolean
diff --git a/server/src/main/java/org/elasticsearch/common/time/DateUtils.java b/server/src/main/java/org/elasticsearch/common/time/DateUtils.java
index 9f642734ba832..72306b6ed675e 100644
--- a/server/src/main/java/org/elasticsearch/common/time/DateUtils.java
+++ b/server/src/main/java/org/elasticsearch/common/time/DateUtils.java
@@ -293,6 +293,37 @@ public static long toMilliSeconds(long nanoSecondsSinceEpoch) {
         return nanoSecondsSinceEpoch / 1_000_000;
     }
 
+    /**
+     * Compare an epoch nanosecond date (such as returned by {@link DateUtils#toLong}
+     * to an epoch millisecond date (such as returned by {@link Instant#toEpochMilli()}}.
+     * <p>
+     * NB: This function does not implement {@link java.util.Comparator} in
+     * order to avoid performance costs of autoboxing the input longs.
+     *
+     * @param nanos Epoch date represented as a long number of nanoseconds.
+     *              Note that Elasticsearch does not support nanosecond dates
+     *              before Epoch, so this number should never be negative.
+     * @param millis Epoch date represented as a long number of milliseconds.
+     *               This parameter does not have to be constrained to the
+     *               range of long nanosecond dates.
+     * @return -1 if the nanosecond date is before the millisecond date,
+     *         0  if the two dates represent the same instant,
+     *         1  if the nanosecond date is after the millisecond date
+     */
+    public static int compareNanosToMillis(long nanos, long millis) {
+        assert nanos >= 0;
+        if (millis < 0) {
+            return 1;
+        }
+        if (millis > MAX_NANOSECOND_IN_MILLIS) {
+            return -1;
+        }
+        // This can't overflow, because we know millis is between 0 and MAX_NANOSECOND_IN_MILLIS,
+        // and MAX_NANOSECOND_IN_MILLIS * 1_000_000 doesn't overflow.
+        long diff = nanos - (millis * 1_000_000);
+        return diff == 0 ? 0 : diff < 0 ? -1 : 1;
+    }
+
     /**
      * Rounds the given utc milliseconds sicne the epoch down to the next unit millis
      *
diff --git a/server/src/test/java/org/elasticsearch/common/time/DateUtilsTests.java b/server/src/test/java/org/elasticsearch/common/time/DateUtilsTests.java
index 2dd0a28013058..e15bbbf75a529 100644
--- a/server/src/test/java/org/elasticsearch/common/time/DateUtilsTests.java
+++ b/server/src/test/java/org/elasticsearch/common/time/DateUtilsTests.java
@@ -20,7 +20,11 @@
 import java.time.ZonedDateTime;
 import java.time.temporal.ChronoField;
 
+import static org.elasticsearch.common.time.DateUtils.MAX_MILLIS_BEFORE_MINUS_9999;
+import static org.elasticsearch.common.time.DateUtils.MAX_NANOSECOND_INSTANT;
+import static org.elasticsearch.common.time.DateUtils.MAX_NANOSECOND_IN_MILLIS;
 import static org.elasticsearch.common.time.DateUtils.clampToNanosRange;
+import static org.elasticsearch.common.time.DateUtils.compareNanosToMillis;
 import static org.elasticsearch.common.time.DateUtils.toInstant;
 import static org.elasticsearch.common.time.DateUtils.toLong;
 import static org.elasticsearch.common.time.DateUtils.toMilliSeconds;
@@ -28,9 +32,45 @@
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.lessThan;
 
 public class DateUtilsTests extends ESTestCase {
 
+    public void testCompareNanosToMillis() {
+        assertThat(MAX_NANOSECOND_IN_MILLIS * 1_000_000, lessThan(Long.MAX_VALUE));
+
+        assertThat(compareNanosToMillis(toLong(Instant.EPOCH), Instant.EPOCH.toEpochMilli()), is(0));
+
+        // This should be 1, because the millisecond version should truncate a bit
+        assertThat(compareNanosToMillis(toLong(MAX_NANOSECOND_INSTANT), MAX_NANOSECOND_INSTANT.toEpochMilli()), is(1));
+
+        assertThat(compareNanosToMillis(toLong(MAX_NANOSECOND_INSTANT), -1000), is(1));
+        // millis before epoch
+        assertCompareInstants(
+            randomInstantBetween(Instant.EPOCH, MAX_NANOSECOND_INSTANT),
+            randomInstantBetween(Instant.ofEpochMilli(MAX_MILLIS_BEFORE_MINUS_9999), Instant.ofEpochMilli(-1L))
+        );
+
+        // millis after nanos range
+        assertCompareInstants(
+            randomInstantBetween(Instant.EPOCH, MAX_NANOSECOND_INSTANT),
+            randomInstantBetween(MAX_NANOSECOND_INSTANT.plusMillis(1), Instant.ofEpochMilli(Long.MAX_VALUE))
+        );
+
+        // both in range
+        Instant nanos = randomInstantBetween(Instant.EPOCH, MAX_NANOSECOND_INSTANT);
+        Instant millis = randomInstantBetween(Instant.EPOCH, MAX_NANOSECOND_INSTANT);
+
+        assertCompareInstants(nanos, millis);
+    }
+
+    /**
+     *  check that compareNanosToMillis is consistent with Instant#compare.
+     */
+    private void assertCompareInstants(Instant nanos, Instant millis) {
+        assertThat(compareNanosToMillis(toLong(nanos), millis.toEpochMilli()), equalTo(nanos.compareTo(millis)));
+    }
+
     public void testInstantToLong() {
         assertThat(toLong(Instant.EPOCH), is(0L));
 
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/EsqlTestUtils.java b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/EsqlTestUtils.java
index d6715a932c075..ec9af33dd6690 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/EsqlTestUtils.java
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/EsqlTestUtils.java
@@ -726,7 +726,7 @@ public static Literal randomLiteral(DataType type) {
             case UNSIGNED_LONG, LONG, COUNTER_LONG -> randomLong();
             case DATE_PERIOD -> Period.of(randomIntBetween(-1000, 1000), randomIntBetween(-13, 13), randomIntBetween(-32, 32));
             case DATETIME -> randomMillisUpToYear9999();
-            case DATE_NANOS -> randomLong();
+            case DATE_NANOS -> randomLongBetween(0, Long.MAX_VALUE);
             case DOUBLE, SCALED_FLOAT, COUNTER_DOUBLE -> randomDouble();
             case FLOAT -> randomFloat();
             case HALF_FLOAT -> HalfFloatPoint.sortableShortToHalfFloat(HalfFloatPoint.halfFloatToSortableShort(randomFloat()));
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/date_nanos.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/date_nanos.csv-spec
index daa45825b93fc..0d113c0422562 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/date_nanos.csv-spec
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/date_nanos.csv-spec
@@ -216,11 +216,40 @@ millis:date              | nanos:date_nanos               | num:long
 2023-10-23T13:33:34.937Z | 2023-10-23T13:33:34.937193000Z | 1698068014937193000
 ;
 
+date nanos greater than millis
+required_capability: date_nanos_type
+required_capability: date_nanos_compare_to_millis
+
+FROM date_nanos | WHERE MV_MIN(nanos) > TO_DATETIME("2023-10-23T12:27:28.948Z") | SORT nanos DESC;
+
+millis:date              | nanos:date_nanos               | num:long
+2023-10-23T13:55:01.543Z | 2023-10-23T13:55:01.543123456Z | 1698069301543123456
+2023-10-23T13:53:55.832Z | 2023-10-23T13:53:55.832987654Z | 1698069235832987654
+2023-10-23T13:52:55.015Z | 2023-10-23T13:52:55.015787878Z | 1698069175015787878
+2023-10-23T13:51:54.732Z | 2023-10-23T13:51:54.732102837Z | 1698069114732102837
+2023-10-23T13:33:34.937Z | 2023-10-23T13:33:34.937193000Z | 1698068014937193000
+;
+
 date nanos greater than or equal
 required_capability: to_date_nanos
 required_capability: date_nanos_binary_comparison
 
-FROM date_nanos | WHERE MV_MIN(nanos) >= TO_DATE_NANOS("2023-10-23T12:27:28.948000000Z") | SORT nanos DESC;
+FROM date_nanos | WHERE MV_MIN(nanos) >= TO_DATE_NANOS("2023-10-23T12:27:28.948Z") | SORT nanos DESC;
+
+millis:date              | nanos:date_nanos               | num:long
+2023-10-23T13:55:01.543Z | 2023-10-23T13:55:01.543123456Z | 1698069301543123456
+2023-10-23T13:53:55.832Z | 2023-10-23T13:53:55.832987654Z | 1698069235832987654
+2023-10-23T13:52:55.015Z | 2023-10-23T13:52:55.015787878Z | 1698069175015787878
+2023-10-23T13:51:54.732Z | 2023-10-23T13:51:54.732102837Z | 1698069114732102837
+2023-10-23T13:33:34.937Z | 2023-10-23T13:33:34.937193000Z | 1698068014937193000
+2023-10-23T12:27:28.948Z | 2023-10-23T12:27:28.948000000Z | 1698064048948000000
+;
+
+date nanos greater than or equal millis
+required_capability: date_nanos_type
+required_capability: date_nanos_compare_to_millis
+
+FROM date_nanos | WHERE MV_MIN(nanos) >= TO_DATETIME("2023-10-23T12:27:28.948Z") | SORT nanos DESC;
 
 millis:date              | nanos:date_nanos               | num:long
 2023-10-23T13:55:01.543Z | 2023-10-23T13:55:01.543123456Z | 1698069301543123456
@@ -231,11 +260,23 @@ millis:date              | nanos:date_nanos               | num:long
 2023-10-23T12:27:28.948Z | 2023-10-23T12:27:28.948000000Z | 1698064048948000000
 ;
 
+
 date nanos less than
 required_capability: to_date_nanos
 required_capability: date_nanos_binary_comparison
 
-FROM date_nanos | WHERE MV_MIN(nanos) < TO_DATE_NANOS("2023-10-23T12:27:28.948000000Z") AND millis > "2000-01-01" | SORT nanos DESC;
+FROM date_nanos | WHERE MV_MIN(nanos) < TO_DATE_NANOS("2023-10-23T12:27:28.948Z") AND millis > "2000-01-01" | SORT nanos DESC;
+
+millis:date              | nanos:date_nanos               | num:long
+2023-10-23T12:15:03.360Z | 2023-10-23T12:15:03.360103847Z | 1698063303360103847
+2023-10-23T12:15:03.360Z | 2023-10-23T12:15:03.360103847Z | 1698063303360103847
+;
+
+date nanos less than millis
+required_capability: date_nanos_type
+required_capability: date_nanos_compare_to_millis
+
+FROM date_nanos | WHERE MV_MIN(nanos) < TO_DATETIME("2023-10-23T12:27:28.948Z") AND millis > "2000-01-01" | SORT nanos DESC;
 
 millis:date              | nanos:date_nanos               | num:long
 2023-10-23T12:15:03.360Z | 2023-10-23T12:15:03.360103847Z | 1698063303360103847
@@ -246,7 +287,19 @@ date nanos less than equal
 required_capability: to_date_nanos
 required_capability: date_nanos_binary_comparison
 
-FROM date_nanos | WHERE MV_MIN(nanos) <= TO_DATE_NANOS("2023-10-23T12:27:28.948000000Z") AND millis > "2000-01-01" | SORT nanos DESC;
+FROM date_nanos | WHERE MV_MIN(nanos) <= TO_DATE_NANOS("2023-10-23T12:27:28.948Z") AND millis > "2000-01-01" | SORT nanos DESC;
+
+millis:date              | nanos:date_nanos               | num:long
+2023-10-23T12:27:28.948Z | 2023-10-23T12:27:28.948000000Z | 1698064048948000000
+2023-10-23T12:15:03.360Z | 2023-10-23T12:15:03.360103847Z | 1698063303360103847
+2023-10-23T12:15:03.360Z | 2023-10-23T12:15:03.360103847Z | 1698063303360103847
+;
+
+date nanos less than equal millis
+required_capability: date_nanos_type
+required_capability: date_nanos_compare_to_millis
+
+FROM date_nanos | WHERE MV_MIN(nanos) <= TO_DATETIME("2023-10-23T12:27:28.948Z") AND millis > "2000-01-01" | SORT nanos DESC;
 
 millis:date              | nanos:date_nanos               | num:long
 2023-10-23T12:27:28.948Z | 2023-10-23T12:27:28.948000000Z | 1698064048948000000
@@ -254,6 +307,7 @@ millis:date              | nanos:date_nanos               | num:long
 2023-10-23T12:15:03.360Z | 2023-10-23T12:15:03.360103847Z | 1698063303360103847
 ;
 
+
 date nanos equals
 required_capability: to_date_nanos
 required_capability: date_nanos_binary_comparison
@@ -264,6 +318,25 @@ millis:date              | nanos:date_nanos               | num:long
 2023-10-23T12:27:28.948Z | 2023-10-23T12:27:28.948000000Z | 1698064048948000000
 ;
 
+date nanos equals millis exact match
+required_capability: date_nanos_type
+required_capability: date_nanos_compare_to_millis
+
+FROM date_nanos | WHERE MV_MIN(nanos) == TO_DATETIME("2023-10-23T12:27:28.948Z");
+
+millis:date              | nanos:date_nanos               | num:long
+2023-10-23T12:27:28.948Z | 2023-10-23T12:27:28.948000000Z | 1698064048948000000
+;
+
+date nanos equals millis without exact match
+required_capability: date_nanos_type
+required_capability: date_nanos_compare_to_millis
+
+FROM date_nanos | WHERE MV_MIN(nanos) == TO_DATETIME("2023-10-23T13:33:34.937");
+
+millis:date              | nanos:date_nanos               | num:long
+;
+
 date nanos not equals
 required_capability: to_date_nanos
 required_capability: date_nanos_binary_comparison
@@ -280,6 +353,22 @@ millis:date              | nanos:date_nanos               | num:long
 2023-10-23T12:15:03.360Z | 2023-10-23T12:15:03.360103847Z | 1698063303360103847
 ;
 
+date nanos not equals millis
+required_capability: date_nanos_type
+required_capability: date_nanos_compare_to_millis
+
+FROM date_nanos | WHERE MV_MIN(nanos) != TO_DATETIME("2023-10-23T12:27:28.948Z") AND millis > "2000-01-01" | SORT nanos DESC;
+
+millis:date              | nanos:date_nanos               | num:long
+2023-10-23T13:55:01.543Z | 2023-10-23T13:55:01.543123456Z | 1698069301543123456
+2023-10-23T13:53:55.832Z | 2023-10-23T13:53:55.832987654Z | 1698069235832987654
+2023-10-23T13:52:55.015Z | 2023-10-23T13:52:55.015787878Z | 1698069175015787878
+2023-10-23T13:51:54.732Z | 2023-10-23T13:51:54.732102837Z | 1698069114732102837
+2023-10-23T13:33:34.937Z | 2023-10-23T13:33:34.937193000Z | 1698068014937193000
+2023-10-23T12:15:03.360Z | 2023-10-23T12:15:03.360103847Z | 1698063303360103847
+2023-10-23T12:15:03.360Z | 2023-10-23T12:15:03.360103847Z | 1698063303360103847
+;
+
 date nanos to long, index version
 required_capability: to_date_nanos
 
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/EqualsMillisNanosEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/EqualsMillisNanosEvaluator.java
new file mode 100644
index 0000000000000..b5013c4080507
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/EqualsMillisNanosEvaluator.java
@@ -0,0 +1,148 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.predicate.operator.comparison;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BooleanBlock;
+import org.elasticsearch.compute.data.BooleanVector;
+import org.elasticsearch.compute.data.LongBlock;
+import org.elasticsearch.compute.data.LongVector;
+import org.elasticsearch.compute.data.Page;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.compute.operator.Warnings;
+import org.elasticsearch.core.Releasables;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link Equals}.
+ * This class is generated. Do not edit it.
+ */
+public final class EqualsMillisNanosEvaluator implements EvalOperator.ExpressionEvaluator {
+  private final Source source;
+
+  private final EvalOperator.ExpressionEvaluator lhs;
+
+  private final EvalOperator.ExpressionEvaluator rhs;
+
+  private final DriverContext driverContext;
+
+  private Warnings warnings;
+
+  public EqualsMillisNanosEvaluator(Source source, EvalOperator.ExpressionEvaluator lhs,
+      EvalOperator.ExpressionEvaluator rhs, DriverContext driverContext) {
+    this.source = source;
+    this.lhs = lhs;
+    this.rhs = rhs;
+    this.driverContext = driverContext;
+  }
+
+  @Override
+  public Block eval(Page page) {
+    try (LongBlock lhsBlock = (LongBlock) lhs.eval(page)) {
+      try (LongBlock rhsBlock = (LongBlock) rhs.eval(page)) {
+        LongVector lhsVector = lhsBlock.asVector();
+        if (lhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        LongVector rhsVector = rhsBlock.asVector();
+        if (rhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        return eval(page.getPositionCount(), lhsVector, rhsVector).asBlock();
+      }
+    }
+  }
+
+  public BooleanBlock eval(int positionCount, LongBlock lhsBlock, LongBlock rhsBlock) {
+    try(BooleanBlock.Builder result = driverContext.blockFactory().newBooleanBlockBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        if (lhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (lhsBlock.getValueCount(p) != 1) {
+          if (lhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.getValueCount(p) != 1) {
+          if (rhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        result.appendBoolean(Equals.processMillisNanos(lhsBlock.getLong(lhsBlock.getFirstValueIndex(p)), rhsBlock.getLong(rhsBlock.getFirstValueIndex(p))));
+      }
+      return result.build();
+    }
+  }
+
+  public BooleanVector eval(int positionCount, LongVector lhsVector, LongVector rhsVector) {
+    try(BooleanVector.FixedBuilder result = driverContext.blockFactory().newBooleanVectorFixedBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        result.appendBoolean(p, Equals.processMillisNanos(lhsVector.getLong(p), rhsVector.getLong(p)));
+      }
+      return result.build();
+    }
+  }
+
+  @Override
+  public String toString() {
+    return "EqualsMillisNanosEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+  }
+
+  @Override
+  public void close() {
+    Releasables.closeExpectNoException(lhs, rhs);
+  }
+
+  private Warnings warnings() {
+    if (warnings == null) {
+      this.warnings = Warnings.createWarnings(
+              driverContext.warningsMode(),
+              source.source().getLineNumber(),
+              source.source().getColumnNumber(),
+              source.text()
+          );
+    }
+    return warnings;
+  }
+
+  static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory lhs;
+
+    private final EvalOperator.ExpressionEvaluator.Factory rhs;
+
+    public Factory(Source source, EvalOperator.ExpressionEvaluator.Factory lhs,
+        EvalOperator.ExpressionEvaluator.Factory rhs) {
+      this.source = source;
+      this.lhs = lhs;
+      this.rhs = rhs;
+    }
+
+    @Override
+    public EqualsMillisNanosEvaluator get(DriverContext context) {
+      return new EqualsMillisNanosEvaluator(source, lhs.get(context), rhs.get(context), context);
+    }
+
+    @Override
+    public String toString() {
+      return "EqualsMillisNanosEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/EqualsNanosMillisEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/EqualsNanosMillisEvaluator.java
new file mode 100644
index 0000000000000..3ed1e922608e6
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/EqualsNanosMillisEvaluator.java
@@ -0,0 +1,148 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.predicate.operator.comparison;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BooleanBlock;
+import org.elasticsearch.compute.data.BooleanVector;
+import org.elasticsearch.compute.data.LongBlock;
+import org.elasticsearch.compute.data.LongVector;
+import org.elasticsearch.compute.data.Page;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.compute.operator.Warnings;
+import org.elasticsearch.core.Releasables;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link Equals}.
+ * This class is generated. Do not edit it.
+ */
+public final class EqualsNanosMillisEvaluator implements EvalOperator.ExpressionEvaluator {
+  private final Source source;
+
+  private final EvalOperator.ExpressionEvaluator lhs;
+
+  private final EvalOperator.ExpressionEvaluator rhs;
+
+  private final DriverContext driverContext;
+
+  private Warnings warnings;
+
+  public EqualsNanosMillisEvaluator(Source source, EvalOperator.ExpressionEvaluator lhs,
+      EvalOperator.ExpressionEvaluator rhs, DriverContext driverContext) {
+    this.source = source;
+    this.lhs = lhs;
+    this.rhs = rhs;
+    this.driverContext = driverContext;
+  }
+
+  @Override
+  public Block eval(Page page) {
+    try (LongBlock lhsBlock = (LongBlock) lhs.eval(page)) {
+      try (LongBlock rhsBlock = (LongBlock) rhs.eval(page)) {
+        LongVector lhsVector = lhsBlock.asVector();
+        if (lhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        LongVector rhsVector = rhsBlock.asVector();
+        if (rhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        return eval(page.getPositionCount(), lhsVector, rhsVector).asBlock();
+      }
+    }
+  }
+
+  public BooleanBlock eval(int positionCount, LongBlock lhsBlock, LongBlock rhsBlock) {
+    try(BooleanBlock.Builder result = driverContext.blockFactory().newBooleanBlockBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        if (lhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (lhsBlock.getValueCount(p) != 1) {
+          if (lhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.getValueCount(p) != 1) {
+          if (rhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        result.appendBoolean(Equals.processNanosMillis(lhsBlock.getLong(lhsBlock.getFirstValueIndex(p)), rhsBlock.getLong(rhsBlock.getFirstValueIndex(p))));
+      }
+      return result.build();
+    }
+  }
+
+  public BooleanVector eval(int positionCount, LongVector lhsVector, LongVector rhsVector) {
+    try(BooleanVector.FixedBuilder result = driverContext.blockFactory().newBooleanVectorFixedBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        result.appendBoolean(p, Equals.processNanosMillis(lhsVector.getLong(p), rhsVector.getLong(p)));
+      }
+      return result.build();
+    }
+  }
+
+  @Override
+  public String toString() {
+    return "EqualsNanosMillisEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+  }
+
+  @Override
+  public void close() {
+    Releasables.closeExpectNoException(lhs, rhs);
+  }
+
+  private Warnings warnings() {
+    if (warnings == null) {
+      this.warnings = Warnings.createWarnings(
+              driverContext.warningsMode(),
+              source.source().getLineNumber(),
+              source.source().getColumnNumber(),
+              source.text()
+          );
+    }
+    return warnings;
+  }
+
+  static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory lhs;
+
+    private final EvalOperator.ExpressionEvaluator.Factory rhs;
+
+    public Factory(Source source, EvalOperator.ExpressionEvaluator.Factory lhs,
+        EvalOperator.ExpressionEvaluator.Factory rhs) {
+      this.source = source;
+      this.lhs = lhs;
+      this.rhs = rhs;
+    }
+
+    @Override
+    public EqualsNanosMillisEvaluator get(DriverContext context) {
+      return new EqualsNanosMillisEvaluator(source, lhs.get(context), rhs.get(context), context);
+    }
+
+    @Override
+    public String toString() {
+      return "EqualsNanosMillisEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanMillisNanosEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanMillisNanosEvaluator.java
new file mode 100644
index 0000000000000..bdd877c7f866e
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanMillisNanosEvaluator.java
@@ -0,0 +1,148 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.predicate.operator.comparison;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BooleanBlock;
+import org.elasticsearch.compute.data.BooleanVector;
+import org.elasticsearch.compute.data.LongBlock;
+import org.elasticsearch.compute.data.LongVector;
+import org.elasticsearch.compute.data.Page;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.compute.operator.Warnings;
+import org.elasticsearch.core.Releasables;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link GreaterThan}.
+ * This class is generated. Do not edit it.
+ */
+public final class GreaterThanMillisNanosEvaluator implements EvalOperator.ExpressionEvaluator {
+  private final Source source;
+
+  private final EvalOperator.ExpressionEvaluator lhs;
+
+  private final EvalOperator.ExpressionEvaluator rhs;
+
+  private final DriverContext driverContext;
+
+  private Warnings warnings;
+
+  public GreaterThanMillisNanosEvaluator(Source source, EvalOperator.ExpressionEvaluator lhs,
+      EvalOperator.ExpressionEvaluator rhs, DriverContext driverContext) {
+    this.source = source;
+    this.lhs = lhs;
+    this.rhs = rhs;
+    this.driverContext = driverContext;
+  }
+
+  @Override
+  public Block eval(Page page) {
+    try (LongBlock lhsBlock = (LongBlock) lhs.eval(page)) {
+      try (LongBlock rhsBlock = (LongBlock) rhs.eval(page)) {
+        LongVector lhsVector = lhsBlock.asVector();
+        if (lhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        LongVector rhsVector = rhsBlock.asVector();
+        if (rhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        return eval(page.getPositionCount(), lhsVector, rhsVector).asBlock();
+      }
+    }
+  }
+
+  public BooleanBlock eval(int positionCount, LongBlock lhsBlock, LongBlock rhsBlock) {
+    try(BooleanBlock.Builder result = driverContext.blockFactory().newBooleanBlockBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        if (lhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (lhsBlock.getValueCount(p) != 1) {
+          if (lhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.getValueCount(p) != 1) {
+          if (rhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        result.appendBoolean(GreaterThan.processMillisNanos(lhsBlock.getLong(lhsBlock.getFirstValueIndex(p)), rhsBlock.getLong(rhsBlock.getFirstValueIndex(p))));
+      }
+      return result.build();
+    }
+  }
+
+  public BooleanVector eval(int positionCount, LongVector lhsVector, LongVector rhsVector) {
+    try(BooleanVector.FixedBuilder result = driverContext.blockFactory().newBooleanVectorFixedBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        result.appendBoolean(p, GreaterThan.processMillisNanos(lhsVector.getLong(p), rhsVector.getLong(p)));
+      }
+      return result.build();
+    }
+  }
+
+  @Override
+  public String toString() {
+    return "GreaterThanMillisNanosEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+  }
+
+  @Override
+  public void close() {
+    Releasables.closeExpectNoException(lhs, rhs);
+  }
+
+  private Warnings warnings() {
+    if (warnings == null) {
+      this.warnings = Warnings.createWarnings(
+              driverContext.warningsMode(),
+              source.source().getLineNumber(),
+              source.source().getColumnNumber(),
+              source.text()
+          );
+    }
+    return warnings;
+  }
+
+  static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory lhs;
+
+    private final EvalOperator.ExpressionEvaluator.Factory rhs;
+
+    public Factory(Source source, EvalOperator.ExpressionEvaluator.Factory lhs,
+        EvalOperator.ExpressionEvaluator.Factory rhs) {
+      this.source = source;
+      this.lhs = lhs;
+      this.rhs = rhs;
+    }
+
+    @Override
+    public GreaterThanMillisNanosEvaluator get(DriverContext context) {
+      return new GreaterThanMillisNanosEvaluator(source, lhs.get(context), rhs.get(context), context);
+    }
+
+    @Override
+    public String toString() {
+      return "GreaterThanMillisNanosEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanNanosMillisEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanNanosMillisEvaluator.java
new file mode 100644
index 0000000000000..d509547eb17ce
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanNanosMillisEvaluator.java
@@ -0,0 +1,148 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.predicate.operator.comparison;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BooleanBlock;
+import org.elasticsearch.compute.data.BooleanVector;
+import org.elasticsearch.compute.data.LongBlock;
+import org.elasticsearch.compute.data.LongVector;
+import org.elasticsearch.compute.data.Page;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.compute.operator.Warnings;
+import org.elasticsearch.core.Releasables;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link GreaterThan}.
+ * This class is generated. Do not edit it.
+ */
+public final class GreaterThanNanosMillisEvaluator implements EvalOperator.ExpressionEvaluator {
+  private final Source source;
+
+  private final EvalOperator.ExpressionEvaluator lhs;
+
+  private final EvalOperator.ExpressionEvaluator rhs;
+
+  private final DriverContext driverContext;
+
+  private Warnings warnings;
+
+  public GreaterThanNanosMillisEvaluator(Source source, EvalOperator.ExpressionEvaluator lhs,
+      EvalOperator.ExpressionEvaluator rhs, DriverContext driverContext) {
+    this.source = source;
+    this.lhs = lhs;
+    this.rhs = rhs;
+    this.driverContext = driverContext;
+  }
+
+  @Override
+  public Block eval(Page page) {
+    try (LongBlock lhsBlock = (LongBlock) lhs.eval(page)) {
+      try (LongBlock rhsBlock = (LongBlock) rhs.eval(page)) {
+        LongVector lhsVector = lhsBlock.asVector();
+        if (lhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        LongVector rhsVector = rhsBlock.asVector();
+        if (rhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        return eval(page.getPositionCount(), lhsVector, rhsVector).asBlock();
+      }
+    }
+  }
+
+  public BooleanBlock eval(int positionCount, LongBlock lhsBlock, LongBlock rhsBlock) {
+    try(BooleanBlock.Builder result = driverContext.blockFactory().newBooleanBlockBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        if (lhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (lhsBlock.getValueCount(p) != 1) {
+          if (lhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.getValueCount(p) != 1) {
+          if (rhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        result.appendBoolean(GreaterThan.processNanosMillis(lhsBlock.getLong(lhsBlock.getFirstValueIndex(p)), rhsBlock.getLong(rhsBlock.getFirstValueIndex(p))));
+      }
+      return result.build();
+    }
+  }
+
+  public BooleanVector eval(int positionCount, LongVector lhsVector, LongVector rhsVector) {
+    try(BooleanVector.FixedBuilder result = driverContext.blockFactory().newBooleanVectorFixedBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        result.appendBoolean(p, GreaterThan.processNanosMillis(lhsVector.getLong(p), rhsVector.getLong(p)));
+      }
+      return result.build();
+    }
+  }
+
+  @Override
+  public String toString() {
+    return "GreaterThanNanosMillisEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+  }
+
+  @Override
+  public void close() {
+    Releasables.closeExpectNoException(lhs, rhs);
+  }
+
+  private Warnings warnings() {
+    if (warnings == null) {
+      this.warnings = Warnings.createWarnings(
+              driverContext.warningsMode(),
+              source.source().getLineNumber(),
+              source.source().getColumnNumber(),
+              source.text()
+          );
+    }
+    return warnings;
+  }
+
+  static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory lhs;
+
+    private final EvalOperator.ExpressionEvaluator.Factory rhs;
+
+    public Factory(Source source, EvalOperator.ExpressionEvaluator.Factory lhs,
+        EvalOperator.ExpressionEvaluator.Factory rhs) {
+      this.source = source;
+      this.lhs = lhs;
+      this.rhs = rhs;
+    }
+
+    @Override
+    public GreaterThanNanosMillisEvaluator get(DriverContext context) {
+      return new GreaterThanNanosMillisEvaluator(source, lhs.get(context), rhs.get(context), context);
+    }
+
+    @Override
+    public String toString() {
+      return "GreaterThanNanosMillisEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanOrEqualMillisNanosEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanOrEqualMillisNanosEvaluator.java
new file mode 100644
index 0000000000000..7a0da0a55d0dc
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanOrEqualMillisNanosEvaluator.java
@@ -0,0 +1,148 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.predicate.operator.comparison;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BooleanBlock;
+import org.elasticsearch.compute.data.BooleanVector;
+import org.elasticsearch.compute.data.LongBlock;
+import org.elasticsearch.compute.data.LongVector;
+import org.elasticsearch.compute.data.Page;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.compute.operator.Warnings;
+import org.elasticsearch.core.Releasables;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link GreaterThanOrEqual}.
+ * This class is generated. Do not edit it.
+ */
+public final class GreaterThanOrEqualMillisNanosEvaluator implements EvalOperator.ExpressionEvaluator {
+  private final Source source;
+
+  private final EvalOperator.ExpressionEvaluator lhs;
+
+  private final EvalOperator.ExpressionEvaluator rhs;
+
+  private final DriverContext driverContext;
+
+  private Warnings warnings;
+
+  public GreaterThanOrEqualMillisNanosEvaluator(Source source, EvalOperator.ExpressionEvaluator lhs,
+      EvalOperator.ExpressionEvaluator rhs, DriverContext driverContext) {
+    this.source = source;
+    this.lhs = lhs;
+    this.rhs = rhs;
+    this.driverContext = driverContext;
+  }
+
+  @Override
+  public Block eval(Page page) {
+    try (LongBlock lhsBlock = (LongBlock) lhs.eval(page)) {
+      try (LongBlock rhsBlock = (LongBlock) rhs.eval(page)) {
+        LongVector lhsVector = lhsBlock.asVector();
+        if (lhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        LongVector rhsVector = rhsBlock.asVector();
+        if (rhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        return eval(page.getPositionCount(), lhsVector, rhsVector).asBlock();
+      }
+    }
+  }
+
+  public BooleanBlock eval(int positionCount, LongBlock lhsBlock, LongBlock rhsBlock) {
+    try(BooleanBlock.Builder result = driverContext.blockFactory().newBooleanBlockBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        if (lhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (lhsBlock.getValueCount(p) != 1) {
+          if (lhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.getValueCount(p) != 1) {
+          if (rhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        result.appendBoolean(GreaterThanOrEqual.processMillisNanos(lhsBlock.getLong(lhsBlock.getFirstValueIndex(p)), rhsBlock.getLong(rhsBlock.getFirstValueIndex(p))));
+      }
+      return result.build();
+    }
+  }
+
+  public BooleanVector eval(int positionCount, LongVector lhsVector, LongVector rhsVector) {
+    try(BooleanVector.FixedBuilder result = driverContext.blockFactory().newBooleanVectorFixedBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        result.appendBoolean(p, GreaterThanOrEqual.processMillisNanos(lhsVector.getLong(p), rhsVector.getLong(p)));
+      }
+      return result.build();
+    }
+  }
+
+  @Override
+  public String toString() {
+    return "GreaterThanOrEqualMillisNanosEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+  }
+
+  @Override
+  public void close() {
+    Releasables.closeExpectNoException(lhs, rhs);
+  }
+
+  private Warnings warnings() {
+    if (warnings == null) {
+      this.warnings = Warnings.createWarnings(
+              driverContext.warningsMode(),
+              source.source().getLineNumber(),
+              source.source().getColumnNumber(),
+              source.text()
+          );
+    }
+    return warnings;
+  }
+
+  static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory lhs;
+
+    private final EvalOperator.ExpressionEvaluator.Factory rhs;
+
+    public Factory(Source source, EvalOperator.ExpressionEvaluator.Factory lhs,
+        EvalOperator.ExpressionEvaluator.Factory rhs) {
+      this.source = source;
+      this.lhs = lhs;
+      this.rhs = rhs;
+    }
+
+    @Override
+    public GreaterThanOrEqualMillisNanosEvaluator get(DriverContext context) {
+      return new GreaterThanOrEqualMillisNanosEvaluator(source, lhs.get(context), rhs.get(context), context);
+    }
+
+    @Override
+    public String toString() {
+      return "GreaterThanOrEqualMillisNanosEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanOrEqualNanosMillisEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanOrEqualNanosMillisEvaluator.java
new file mode 100644
index 0000000000000..d4386a64aaf8a
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanOrEqualNanosMillisEvaluator.java
@@ -0,0 +1,148 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.predicate.operator.comparison;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BooleanBlock;
+import org.elasticsearch.compute.data.BooleanVector;
+import org.elasticsearch.compute.data.LongBlock;
+import org.elasticsearch.compute.data.LongVector;
+import org.elasticsearch.compute.data.Page;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.compute.operator.Warnings;
+import org.elasticsearch.core.Releasables;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link GreaterThanOrEqual}.
+ * This class is generated. Do not edit it.
+ */
+public final class GreaterThanOrEqualNanosMillisEvaluator implements EvalOperator.ExpressionEvaluator {
+  private final Source source;
+
+  private final EvalOperator.ExpressionEvaluator lhs;
+
+  private final EvalOperator.ExpressionEvaluator rhs;
+
+  private final DriverContext driverContext;
+
+  private Warnings warnings;
+
+  public GreaterThanOrEqualNanosMillisEvaluator(Source source, EvalOperator.ExpressionEvaluator lhs,
+      EvalOperator.ExpressionEvaluator rhs, DriverContext driverContext) {
+    this.source = source;
+    this.lhs = lhs;
+    this.rhs = rhs;
+    this.driverContext = driverContext;
+  }
+
+  @Override
+  public Block eval(Page page) {
+    try (LongBlock lhsBlock = (LongBlock) lhs.eval(page)) {
+      try (LongBlock rhsBlock = (LongBlock) rhs.eval(page)) {
+        LongVector lhsVector = lhsBlock.asVector();
+        if (lhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        LongVector rhsVector = rhsBlock.asVector();
+        if (rhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        return eval(page.getPositionCount(), lhsVector, rhsVector).asBlock();
+      }
+    }
+  }
+
+  public BooleanBlock eval(int positionCount, LongBlock lhsBlock, LongBlock rhsBlock) {
+    try(BooleanBlock.Builder result = driverContext.blockFactory().newBooleanBlockBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        if (lhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (lhsBlock.getValueCount(p) != 1) {
+          if (lhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.getValueCount(p) != 1) {
+          if (rhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        result.appendBoolean(GreaterThanOrEqual.processNanosMillis(lhsBlock.getLong(lhsBlock.getFirstValueIndex(p)), rhsBlock.getLong(rhsBlock.getFirstValueIndex(p))));
+      }
+      return result.build();
+    }
+  }
+
+  public BooleanVector eval(int positionCount, LongVector lhsVector, LongVector rhsVector) {
+    try(BooleanVector.FixedBuilder result = driverContext.blockFactory().newBooleanVectorFixedBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        result.appendBoolean(p, GreaterThanOrEqual.processNanosMillis(lhsVector.getLong(p), rhsVector.getLong(p)));
+      }
+      return result.build();
+    }
+  }
+
+  @Override
+  public String toString() {
+    return "GreaterThanOrEqualNanosMillisEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+  }
+
+  @Override
+  public void close() {
+    Releasables.closeExpectNoException(lhs, rhs);
+  }
+
+  private Warnings warnings() {
+    if (warnings == null) {
+      this.warnings = Warnings.createWarnings(
+              driverContext.warningsMode(),
+              source.source().getLineNumber(),
+              source.source().getColumnNumber(),
+              source.text()
+          );
+    }
+    return warnings;
+  }
+
+  static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory lhs;
+
+    private final EvalOperator.ExpressionEvaluator.Factory rhs;
+
+    public Factory(Source source, EvalOperator.ExpressionEvaluator.Factory lhs,
+        EvalOperator.ExpressionEvaluator.Factory rhs) {
+      this.source = source;
+      this.lhs = lhs;
+      this.rhs = rhs;
+    }
+
+    @Override
+    public GreaterThanOrEqualNanosMillisEvaluator get(DriverContext context) {
+      return new GreaterThanOrEqualNanosMillisEvaluator(source, lhs.get(context), rhs.get(context), context);
+    }
+
+    @Override
+    public String toString() {
+      return "GreaterThanOrEqualNanosMillisEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanMillisNanosEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanMillisNanosEvaluator.java
new file mode 100644
index 0000000000000..21d7d50af5b1e
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanMillisNanosEvaluator.java
@@ -0,0 +1,148 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.predicate.operator.comparison;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BooleanBlock;
+import org.elasticsearch.compute.data.BooleanVector;
+import org.elasticsearch.compute.data.LongBlock;
+import org.elasticsearch.compute.data.LongVector;
+import org.elasticsearch.compute.data.Page;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.compute.operator.Warnings;
+import org.elasticsearch.core.Releasables;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link LessThan}.
+ * This class is generated. Do not edit it.
+ */
+public final class LessThanMillisNanosEvaluator implements EvalOperator.ExpressionEvaluator {
+  private final Source source;
+
+  private final EvalOperator.ExpressionEvaluator lhs;
+
+  private final EvalOperator.ExpressionEvaluator rhs;
+
+  private final DriverContext driverContext;
+
+  private Warnings warnings;
+
+  public LessThanMillisNanosEvaluator(Source source, EvalOperator.ExpressionEvaluator lhs,
+      EvalOperator.ExpressionEvaluator rhs, DriverContext driverContext) {
+    this.source = source;
+    this.lhs = lhs;
+    this.rhs = rhs;
+    this.driverContext = driverContext;
+  }
+
+  @Override
+  public Block eval(Page page) {
+    try (LongBlock lhsBlock = (LongBlock) lhs.eval(page)) {
+      try (LongBlock rhsBlock = (LongBlock) rhs.eval(page)) {
+        LongVector lhsVector = lhsBlock.asVector();
+        if (lhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        LongVector rhsVector = rhsBlock.asVector();
+        if (rhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        return eval(page.getPositionCount(), lhsVector, rhsVector).asBlock();
+      }
+    }
+  }
+
+  public BooleanBlock eval(int positionCount, LongBlock lhsBlock, LongBlock rhsBlock) {
+    try(BooleanBlock.Builder result = driverContext.blockFactory().newBooleanBlockBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        if (lhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (lhsBlock.getValueCount(p) != 1) {
+          if (lhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.getValueCount(p) != 1) {
+          if (rhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        result.appendBoolean(LessThan.processMillisNanos(lhsBlock.getLong(lhsBlock.getFirstValueIndex(p)), rhsBlock.getLong(rhsBlock.getFirstValueIndex(p))));
+      }
+      return result.build();
+    }
+  }
+
+  public BooleanVector eval(int positionCount, LongVector lhsVector, LongVector rhsVector) {
+    try(BooleanVector.FixedBuilder result = driverContext.blockFactory().newBooleanVectorFixedBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        result.appendBoolean(p, LessThan.processMillisNanos(lhsVector.getLong(p), rhsVector.getLong(p)));
+      }
+      return result.build();
+    }
+  }
+
+  @Override
+  public String toString() {
+    return "LessThanMillisNanosEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+  }
+
+  @Override
+  public void close() {
+    Releasables.closeExpectNoException(lhs, rhs);
+  }
+
+  private Warnings warnings() {
+    if (warnings == null) {
+      this.warnings = Warnings.createWarnings(
+              driverContext.warningsMode(),
+              source.source().getLineNumber(),
+              source.source().getColumnNumber(),
+              source.text()
+          );
+    }
+    return warnings;
+  }
+
+  static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory lhs;
+
+    private final EvalOperator.ExpressionEvaluator.Factory rhs;
+
+    public Factory(Source source, EvalOperator.ExpressionEvaluator.Factory lhs,
+        EvalOperator.ExpressionEvaluator.Factory rhs) {
+      this.source = source;
+      this.lhs = lhs;
+      this.rhs = rhs;
+    }
+
+    @Override
+    public LessThanMillisNanosEvaluator get(DriverContext context) {
+      return new LessThanMillisNanosEvaluator(source, lhs.get(context), rhs.get(context), context);
+    }
+
+    @Override
+    public String toString() {
+      return "LessThanMillisNanosEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanNanosMillisEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanNanosMillisEvaluator.java
new file mode 100644
index 0000000000000..48593f9d537f3
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanNanosMillisEvaluator.java
@@ -0,0 +1,148 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.predicate.operator.comparison;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BooleanBlock;
+import org.elasticsearch.compute.data.BooleanVector;
+import org.elasticsearch.compute.data.LongBlock;
+import org.elasticsearch.compute.data.LongVector;
+import org.elasticsearch.compute.data.Page;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.compute.operator.Warnings;
+import org.elasticsearch.core.Releasables;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link LessThan}.
+ * This class is generated. Do not edit it.
+ */
+public final class LessThanNanosMillisEvaluator implements EvalOperator.ExpressionEvaluator {
+  private final Source source;
+
+  private final EvalOperator.ExpressionEvaluator lhs;
+
+  private final EvalOperator.ExpressionEvaluator rhs;
+
+  private final DriverContext driverContext;
+
+  private Warnings warnings;
+
+  public LessThanNanosMillisEvaluator(Source source, EvalOperator.ExpressionEvaluator lhs,
+      EvalOperator.ExpressionEvaluator rhs, DriverContext driverContext) {
+    this.source = source;
+    this.lhs = lhs;
+    this.rhs = rhs;
+    this.driverContext = driverContext;
+  }
+
+  @Override
+  public Block eval(Page page) {
+    try (LongBlock lhsBlock = (LongBlock) lhs.eval(page)) {
+      try (LongBlock rhsBlock = (LongBlock) rhs.eval(page)) {
+        LongVector lhsVector = lhsBlock.asVector();
+        if (lhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        LongVector rhsVector = rhsBlock.asVector();
+        if (rhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        return eval(page.getPositionCount(), lhsVector, rhsVector).asBlock();
+      }
+    }
+  }
+
+  public BooleanBlock eval(int positionCount, LongBlock lhsBlock, LongBlock rhsBlock) {
+    try(BooleanBlock.Builder result = driverContext.blockFactory().newBooleanBlockBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        if (lhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (lhsBlock.getValueCount(p) != 1) {
+          if (lhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.getValueCount(p) != 1) {
+          if (rhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        result.appendBoolean(LessThan.processNanosMillis(lhsBlock.getLong(lhsBlock.getFirstValueIndex(p)), rhsBlock.getLong(rhsBlock.getFirstValueIndex(p))));
+      }
+      return result.build();
+    }
+  }
+
+  public BooleanVector eval(int positionCount, LongVector lhsVector, LongVector rhsVector) {
+    try(BooleanVector.FixedBuilder result = driverContext.blockFactory().newBooleanVectorFixedBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        result.appendBoolean(p, LessThan.processNanosMillis(lhsVector.getLong(p), rhsVector.getLong(p)));
+      }
+      return result.build();
+    }
+  }
+
+  @Override
+  public String toString() {
+    return "LessThanNanosMillisEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+  }
+
+  @Override
+  public void close() {
+    Releasables.closeExpectNoException(lhs, rhs);
+  }
+
+  private Warnings warnings() {
+    if (warnings == null) {
+      this.warnings = Warnings.createWarnings(
+              driverContext.warningsMode(),
+              source.source().getLineNumber(),
+              source.source().getColumnNumber(),
+              source.text()
+          );
+    }
+    return warnings;
+  }
+
+  static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory lhs;
+
+    private final EvalOperator.ExpressionEvaluator.Factory rhs;
+
+    public Factory(Source source, EvalOperator.ExpressionEvaluator.Factory lhs,
+        EvalOperator.ExpressionEvaluator.Factory rhs) {
+      this.source = source;
+      this.lhs = lhs;
+      this.rhs = rhs;
+    }
+
+    @Override
+    public LessThanNanosMillisEvaluator get(DriverContext context) {
+      return new LessThanNanosMillisEvaluator(source, lhs.get(context), rhs.get(context), context);
+    }
+
+    @Override
+    public String toString() {
+      return "LessThanNanosMillisEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanOrEqualMillisNanosEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanOrEqualMillisNanosEvaluator.java
new file mode 100644
index 0000000000000..06973e71e834a
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanOrEqualMillisNanosEvaluator.java
@@ -0,0 +1,148 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.predicate.operator.comparison;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BooleanBlock;
+import org.elasticsearch.compute.data.BooleanVector;
+import org.elasticsearch.compute.data.LongBlock;
+import org.elasticsearch.compute.data.LongVector;
+import org.elasticsearch.compute.data.Page;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.compute.operator.Warnings;
+import org.elasticsearch.core.Releasables;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link LessThanOrEqual}.
+ * This class is generated. Do not edit it.
+ */
+public final class LessThanOrEqualMillisNanosEvaluator implements EvalOperator.ExpressionEvaluator {
+  private final Source source;
+
+  private final EvalOperator.ExpressionEvaluator lhs;
+
+  private final EvalOperator.ExpressionEvaluator rhs;
+
+  private final DriverContext driverContext;
+
+  private Warnings warnings;
+
+  public LessThanOrEqualMillisNanosEvaluator(Source source, EvalOperator.ExpressionEvaluator lhs,
+      EvalOperator.ExpressionEvaluator rhs, DriverContext driverContext) {
+    this.source = source;
+    this.lhs = lhs;
+    this.rhs = rhs;
+    this.driverContext = driverContext;
+  }
+
+  @Override
+  public Block eval(Page page) {
+    try (LongBlock lhsBlock = (LongBlock) lhs.eval(page)) {
+      try (LongBlock rhsBlock = (LongBlock) rhs.eval(page)) {
+        LongVector lhsVector = lhsBlock.asVector();
+        if (lhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        LongVector rhsVector = rhsBlock.asVector();
+        if (rhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        return eval(page.getPositionCount(), lhsVector, rhsVector).asBlock();
+      }
+    }
+  }
+
+  public BooleanBlock eval(int positionCount, LongBlock lhsBlock, LongBlock rhsBlock) {
+    try(BooleanBlock.Builder result = driverContext.blockFactory().newBooleanBlockBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        if (lhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (lhsBlock.getValueCount(p) != 1) {
+          if (lhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.getValueCount(p) != 1) {
+          if (rhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        result.appendBoolean(LessThanOrEqual.processMillisNanos(lhsBlock.getLong(lhsBlock.getFirstValueIndex(p)), rhsBlock.getLong(rhsBlock.getFirstValueIndex(p))));
+      }
+      return result.build();
+    }
+  }
+
+  public BooleanVector eval(int positionCount, LongVector lhsVector, LongVector rhsVector) {
+    try(BooleanVector.FixedBuilder result = driverContext.blockFactory().newBooleanVectorFixedBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        result.appendBoolean(p, LessThanOrEqual.processMillisNanos(lhsVector.getLong(p), rhsVector.getLong(p)));
+      }
+      return result.build();
+    }
+  }
+
+  @Override
+  public String toString() {
+    return "LessThanOrEqualMillisNanosEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+  }
+
+  @Override
+  public void close() {
+    Releasables.closeExpectNoException(lhs, rhs);
+  }
+
+  private Warnings warnings() {
+    if (warnings == null) {
+      this.warnings = Warnings.createWarnings(
+              driverContext.warningsMode(),
+              source.source().getLineNumber(),
+              source.source().getColumnNumber(),
+              source.text()
+          );
+    }
+    return warnings;
+  }
+
+  static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory lhs;
+
+    private final EvalOperator.ExpressionEvaluator.Factory rhs;
+
+    public Factory(Source source, EvalOperator.ExpressionEvaluator.Factory lhs,
+        EvalOperator.ExpressionEvaluator.Factory rhs) {
+      this.source = source;
+      this.lhs = lhs;
+      this.rhs = rhs;
+    }
+
+    @Override
+    public LessThanOrEqualMillisNanosEvaluator get(DriverContext context) {
+      return new LessThanOrEqualMillisNanosEvaluator(source, lhs.get(context), rhs.get(context), context);
+    }
+
+    @Override
+    public String toString() {
+      return "LessThanOrEqualMillisNanosEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanOrEqualNanosMillisEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanOrEqualNanosMillisEvaluator.java
new file mode 100644
index 0000000000000..4763629873d02
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanOrEqualNanosMillisEvaluator.java
@@ -0,0 +1,148 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.predicate.operator.comparison;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BooleanBlock;
+import org.elasticsearch.compute.data.BooleanVector;
+import org.elasticsearch.compute.data.LongBlock;
+import org.elasticsearch.compute.data.LongVector;
+import org.elasticsearch.compute.data.Page;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.compute.operator.Warnings;
+import org.elasticsearch.core.Releasables;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link LessThanOrEqual}.
+ * This class is generated. Do not edit it.
+ */
+public final class LessThanOrEqualNanosMillisEvaluator implements EvalOperator.ExpressionEvaluator {
+  private final Source source;
+
+  private final EvalOperator.ExpressionEvaluator lhs;
+
+  private final EvalOperator.ExpressionEvaluator rhs;
+
+  private final DriverContext driverContext;
+
+  private Warnings warnings;
+
+  public LessThanOrEqualNanosMillisEvaluator(Source source, EvalOperator.ExpressionEvaluator lhs,
+      EvalOperator.ExpressionEvaluator rhs, DriverContext driverContext) {
+    this.source = source;
+    this.lhs = lhs;
+    this.rhs = rhs;
+    this.driverContext = driverContext;
+  }
+
+  @Override
+  public Block eval(Page page) {
+    try (LongBlock lhsBlock = (LongBlock) lhs.eval(page)) {
+      try (LongBlock rhsBlock = (LongBlock) rhs.eval(page)) {
+        LongVector lhsVector = lhsBlock.asVector();
+        if (lhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        LongVector rhsVector = rhsBlock.asVector();
+        if (rhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        return eval(page.getPositionCount(), lhsVector, rhsVector).asBlock();
+      }
+    }
+  }
+
+  public BooleanBlock eval(int positionCount, LongBlock lhsBlock, LongBlock rhsBlock) {
+    try(BooleanBlock.Builder result = driverContext.blockFactory().newBooleanBlockBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        if (lhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (lhsBlock.getValueCount(p) != 1) {
+          if (lhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.getValueCount(p) != 1) {
+          if (rhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        result.appendBoolean(LessThanOrEqual.processNanosMillis(lhsBlock.getLong(lhsBlock.getFirstValueIndex(p)), rhsBlock.getLong(rhsBlock.getFirstValueIndex(p))));
+      }
+      return result.build();
+    }
+  }
+
+  public BooleanVector eval(int positionCount, LongVector lhsVector, LongVector rhsVector) {
+    try(BooleanVector.FixedBuilder result = driverContext.blockFactory().newBooleanVectorFixedBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        result.appendBoolean(p, LessThanOrEqual.processNanosMillis(lhsVector.getLong(p), rhsVector.getLong(p)));
+      }
+      return result.build();
+    }
+  }
+
+  @Override
+  public String toString() {
+    return "LessThanOrEqualNanosMillisEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+  }
+
+  @Override
+  public void close() {
+    Releasables.closeExpectNoException(lhs, rhs);
+  }
+
+  private Warnings warnings() {
+    if (warnings == null) {
+      this.warnings = Warnings.createWarnings(
+              driverContext.warningsMode(),
+              source.source().getLineNumber(),
+              source.source().getColumnNumber(),
+              source.text()
+          );
+    }
+    return warnings;
+  }
+
+  static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory lhs;
+
+    private final EvalOperator.ExpressionEvaluator.Factory rhs;
+
+    public Factory(Source source, EvalOperator.ExpressionEvaluator.Factory lhs,
+        EvalOperator.ExpressionEvaluator.Factory rhs) {
+      this.source = source;
+      this.lhs = lhs;
+      this.rhs = rhs;
+    }
+
+    @Override
+    public LessThanOrEqualNanosMillisEvaluator get(DriverContext context) {
+      return new LessThanOrEqualNanosMillisEvaluator(source, lhs.get(context), rhs.get(context), context);
+    }
+
+    @Override
+    public String toString() {
+      return "LessThanOrEqualNanosMillisEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/NotEqualsMillisNanosEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/NotEqualsMillisNanosEvaluator.java
new file mode 100644
index 0000000000000..9bede03737a5f
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/NotEqualsMillisNanosEvaluator.java
@@ -0,0 +1,148 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.predicate.operator.comparison;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BooleanBlock;
+import org.elasticsearch.compute.data.BooleanVector;
+import org.elasticsearch.compute.data.LongBlock;
+import org.elasticsearch.compute.data.LongVector;
+import org.elasticsearch.compute.data.Page;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.compute.operator.Warnings;
+import org.elasticsearch.core.Releasables;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link NotEquals}.
+ * This class is generated. Do not edit it.
+ */
+public final class NotEqualsMillisNanosEvaluator implements EvalOperator.ExpressionEvaluator {
+  private final Source source;
+
+  private final EvalOperator.ExpressionEvaluator lhs;
+
+  private final EvalOperator.ExpressionEvaluator rhs;
+
+  private final DriverContext driverContext;
+
+  private Warnings warnings;
+
+  public NotEqualsMillisNanosEvaluator(Source source, EvalOperator.ExpressionEvaluator lhs,
+      EvalOperator.ExpressionEvaluator rhs, DriverContext driverContext) {
+    this.source = source;
+    this.lhs = lhs;
+    this.rhs = rhs;
+    this.driverContext = driverContext;
+  }
+
+  @Override
+  public Block eval(Page page) {
+    try (LongBlock lhsBlock = (LongBlock) lhs.eval(page)) {
+      try (LongBlock rhsBlock = (LongBlock) rhs.eval(page)) {
+        LongVector lhsVector = lhsBlock.asVector();
+        if (lhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        LongVector rhsVector = rhsBlock.asVector();
+        if (rhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        return eval(page.getPositionCount(), lhsVector, rhsVector).asBlock();
+      }
+    }
+  }
+
+  public BooleanBlock eval(int positionCount, LongBlock lhsBlock, LongBlock rhsBlock) {
+    try(BooleanBlock.Builder result = driverContext.blockFactory().newBooleanBlockBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        if (lhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (lhsBlock.getValueCount(p) != 1) {
+          if (lhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.getValueCount(p) != 1) {
+          if (rhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        result.appendBoolean(NotEquals.processMillisNanos(lhsBlock.getLong(lhsBlock.getFirstValueIndex(p)), rhsBlock.getLong(rhsBlock.getFirstValueIndex(p))));
+      }
+      return result.build();
+    }
+  }
+
+  public BooleanVector eval(int positionCount, LongVector lhsVector, LongVector rhsVector) {
+    try(BooleanVector.FixedBuilder result = driverContext.blockFactory().newBooleanVectorFixedBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        result.appendBoolean(p, NotEquals.processMillisNanos(lhsVector.getLong(p), rhsVector.getLong(p)));
+      }
+      return result.build();
+    }
+  }
+
+  @Override
+  public String toString() {
+    return "NotEqualsMillisNanosEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+  }
+
+  @Override
+  public void close() {
+    Releasables.closeExpectNoException(lhs, rhs);
+  }
+
+  private Warnings warnings() {
+    if (warnings == null) {
+      this.warnings = Warnings.createWarnings(
+              driverContext.warningsMode(),
+              source.source().getLineNumber(),
+              source.source().getColumnNumber(),
+              source.text()
+          );
+    }
+    return warnings;
+  }
+
+  static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory lhs;
+
+    private final EvalOperator.ExpressionEvaluator.Factory rhs;
+
+    public Factory(Source source, EvalOperator.ExpressionEvaluator.Factory lhs,
+        EvalOperator.ExpressionEvaluator.Factory rhs) {
+      this.source = source;
+      this.lhs = lhs;
+      this.rhs = rhs;
+    }
+
+    @Override
+    public NotEqualsMillisNanosEvaluator get(DriverContext context) {
+      return new NotEqualsMillisNanosEvaluator(source, lhs.get(context), rhs.get(context), context);
+    }
+
+    @Override
+    public String toString() {
+      return "NotEqualsMillisNanosEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/NotEqualsNanosMillisEvaluator.java b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/NotEqualsNanosMillisEvaluator.java
new file mode 100644
index 0000000000000..e8e28eec7ee27
--- /dev/null
+++ b/x-pack/plugin/esql/src/main/generated/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/NotEqualsNanosMillisEvaluator.java
@@ -0,0 +1,148 @@
+// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+// or more contributor license agreements. Licensed under the Elastic License
+// 2.0; you may not use this file except in compliance with the Elastic License
+// 2.0.
+package org.elasticsearch.xpack.esql.expression.predicate.operator.comparison;
+
+import java.lang.IllegalArgumentException;
+import java.lang.Override;
+import java.lang.String;
+import org.elasticsearch.compute.data.Block;
+import org.elasticsearch.compute.data.BooleanBlock;
+import org.elasticsearch.compute.data.BooleanVector;
+import org.elasticsearch.compute.data.LongBlock;
+import org.elasticsearch.compute.data.LongVector;
+import org.elasticsearch.compute.data.Page;
+import org.elasticsearch.compute.operator.DriverContext;
+import org.elasticsearch.compute.operator.EvalOperator;
+import org.elasticsearch.compute.operator.Warnings;
+import org.elasticsearch.core.Releasables;
+import org.elasticsearch.xpack.esql.core.tree.Source;
+
+/**
+ * {@link EvalOperator.ExpressionEvaluator} implementation for {@link NotEquals}.
+ * This class is generated. Do not edit it.
+ */
+public final class NotEqualsNanosMillisEvaluator implements EvalOperator.ExpressionEvaluator {
+  private final Source source;
+
+  private final EvalOperator.ExpressionEvaluator lhs;
+
+  private final EvalOperator.ExpressionEvaluator rhs;
+
+  private final DriverContext driverContext;
+
+  private Warnings warnings;
+
+  public NotEqualsNanosMillisEvaluator(Source source, EvalOperator.ExpressionEvaluator lhs,
+      EvalOperator.ExpressionEvaluator rhs, DriverContext driverContext) {
+    this.source = source;
+    this.lhs = lhs;
+    this.rhs = rhs;
+    this.driverContext = driverContext;
+  }
+
+  @Override
+  public Block eval(Page page) {
+    try (LongBlock lhsBlock = (LongBlock) lhs.eval(page)) {
+      try (LongBlock rhsBlock = (LongBlock) rhs.eval(page)) {
+        LongVector lhsVector = lhsBlock.asVector();
+        if (lhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        LongVector rhsVector = rhsBlock.asVector();
+        if (rhsVector == null) {
+          return eval(page.getPositionCount(), lhsBlock, rhsBlock);
+        }
+        return eval(page.getPositionCount(), lhsVector, rhsVector).asBlock();
+      }
+    }
+  }
+
+  public BooleanBlock eval(int positionCount, LongBlock lhsBlock, LongBlock rhsBlock) {
+    try(BooleanBlock.Builder result = driverContext.blockFactory().newBooleanBlockBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        if (lhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (lhsBlock.getValueCount(p) != 1) {
+          if (lhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.isNull(p)) {
+          result.appendNull();
+          continue position;
+        }
+        if (rhsBlock.getValueCount(p) != 1) {
+          if (rhsBlock.getValueCount(p) > 1) {
+            warnings().registerException(new IllegalArgumentException("single-value function encountered multi-value"));
+          }
+          result.appendNull();
+          continue position;
+        }
+        result.appendBoolean(NotEquals.processNanosMillis(lhsBlock.getLong(lhsBlock.getFirstValueIndex(p)), rhsBlock.getLong(rhsBlock.getFirstValueIndex(p))));
+      }
+      return result.build();
+    }
+  }
+
+  public BooleanVector eval(int positionCount, LongVector lhsVector, LongVector rhsVector) {
+    try(BooleanVector.FixedBuilder result = driverContext.blockFactory().newBooleanVectorFixedBuilder(positionCount)) {
+      position: for (int p = 0; p < positionCount; p++) {
+        result.appendBoolean(p, NotEquals.processNanosMillis(lhsVector.getLong(p), rhsVector.getLong(p)));
+      }
+      return result.build();
+    }
+  }
+
+  @Override
+  public String toString() {
+    return "NotEqualsNanosMillisEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+  }
+
+  @Override
+  public void close() {
+    Releasables.closeExpectNoException(lhs, rhs);
+  }
+
+  private Warnings warnings() {
+    if (warnings == null) {
+      this.warnings = Warnings.createWarnings(
+              driverContext.warningsMode(),
+              source.source().getLineNumber(),
+              source.source().getColumnNumber(),
+              source.text()
+          );
+    }
+    return warnings;
+  }
+
+  static class Factory implements EvalOperator.ExpressionEvaluator.Factory {
+    private final Source source;
+
+    private final EvalOperator.ExpressionEvaluator.Factory lhs;
+
+    private final EvalOperator.ExpressionEvaluator.Factory rhs;
+
+    public Factory(Source source, EvalOperator.ExpressionEvaluator.Factory lhs,
+        EvalOperator.ExpressionEvaluator.Factory rhs) {
+      this.source = source;
+      this.lhs = lhs;
+      this.rhs = rhs;
+    }
+
+    @Override
+    public NotEqualsNanosMillisEvaluator get(DriverContext context) {
+      return new NotEqualsNanosMillisEvaluator(source, lhs.get(context), rhs.get(context), context);
+    }
+
+    @Override
+    public String toString() {
+      return "NotEqualsNanosMillisEvaluator[" + "lhs=" + lhs + ", rhs=" + rhs + "]";
+    }
+  }
+}
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
index ee3f5be185b4f..7c3f2a45df6a0 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
@@ -345,6 +345,11 @@ public enum Cap {
          */
         DATE_NANOS_BINARY_COMPARISON(),
 
+        /**
+         * Support for mixed comparisons between nanosecond and millisecond dates
+         */
+        DATE_NANOS_COMPARE_TO_MILLIS(),
+
         /**
          * Support Least and Greatest functions on Date Nanos type
          */
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java
index d6f0ff766eb40..ecfe1aa7f9169 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/analysis/Verifier.java
@@ -41,6 +41,7 @@
 import org.elasticsearch.xpack.esql.expression.function.grouping.GroupingFunction;
 import org.elasticsearch.xpack.esql.expression.predicate.operator.arithmetic.Neg;
 import org.elasticsearch.xpack.esql.expression.predicate.operator.comparison.Equals;
+import org.elasticsearch.xpack.esql.expression.predicate.operator.comparison.EsqlBinaryComparison;
 import org.elasticsearch.xpack.esql.expression.predicate.operator.comparison.NotEquals;
 import org.elasticsearch.xpack.esql.plan.logical.Aggregate;
 import org.elasticsearch.xpack.esql.plan.logical.Enrich;
@@ -596,7 +597,11 @@ private void gatherMetrics(LogicalPlan plan, BitSet b) {
     }
 
     /**
-     * Limit QL's comparisons to types we support.
+     * Limit QL's comparisons to types we support.  This should agree with
+     * {@link EsqlBinaryComparison}'s checkCompatibility method
+     *
+     * @return null if the given binary comparison has valid input types,
+     *         otherwise a failure message suitable to return to the user.
      */
     public static Failure validateBinaryComparison(BinaryComparison bc) {
         if (bc.left().dataType().isNumeric()) {
@@ -641,6 +646,12 @@ public static Failure validateBinaryComparison(BinaryComparison bc) {
         if (DataType.isString(bc.left().dataType()) && DataType.isString(bc.right().dataType())) {
             return null;
         }
+
+        // Allow mixed millisecond and nanosecond binary comparisons
+        if (bc.left().dataType().isDate() && bc.right().dataType().isDate()) {
+            return null;
+        }
+
         if (bc.left().dataType() != bc.right().dataType()) {
             return fail(
                 bc,
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/Equals.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/Equals.java
index 6bb249385affe..464553977d3cc 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/Equals.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/Equals.java
@@ -8,6 +8,7 @@
 
 import org.apache.lucene.util.BytesRef;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.time.DateUtils;
 import org.elasticsearch.compute.ann.Evaluator;
 import org.elasticsearch.xpack.esql.core.expression.Expression;
 import org.elasticsearch.xpack.esql.core.expression.predicate.Negatable;
@@ -95,11 +96,28 @@ public Equals(
             description = "An expression."
         ) Expression right
     ) {
-        super(source, left, right, BinaryComparisonOperation.EQ, evaluatorMap);
+        super(
+            source,
+            left,
+            right,
+            BinaryComparisonOperation.EQ,
+            evaluatorMap,
+            EqualsNanosMillisEvaluator.Factory::new,
+            EqualsMillisNanosEvaluator.Factory::new
+        );
     }
 
     public Equals(Source source, Expression left, Expression right, ZoneId zoneId) {
-        super(source, left, right, BinaryComparisonOperation.EQ, zoneId, evaluatorMap);
+        super(
+            source,
+            left,
+            right,
+            BinaryComparisonOperation.EQ,
+            zoneId,
+            evaluatorMap,
+            EqualsNanosMillisEvaluator.Factory::new,
+            EqualsMillisNanosEvaluator.Factory::new
+        );
     }
 
     @Override
@@ -142,6 +160,16 @@ static boolean processLongs(long lhs, long rhs) {
         return lhs == rhs;
     }
 
+    @Evaluator(extraName = "MillisNanos")
+    static boolean processMillisNanos(long lhs, long rhs) {
+        return DateUtils.compareNanosToMillis(rhs, lhs) == 0;
+    }
+
+    @Evaluator(extraName = "NanosMillis")
+    static boolean processNanosMillis(long lhs, long rhs) {
+        return DateUtils.compareNanosToMillis(lhs, rhs) == 0;
+    }
+
     @Evaluator(extraName = "Doubles")
     static boolean processDoubles(double lhs, double rhs) {
         return lhs == rhs;
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/EsqlBinaryComparison.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/EsqlBinaryComparison.java
index cbbf87fb6c4cb..217c6528c9fd6 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/EsqlBinaryComparison.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/EsqlBinaryComparison.java
@@ -35,6 +35,8 @@ public abstract class EsqlBinaryComparison extends BinaryComparison implements E
     private final Map<DataType, EsqlArithmeticOperation.BinaryEvaluator> evaluatorMap;
 
     private final BinaryComparisonOperation functionType;
+    private final EsqlArithmeticOperation.BinaryEvaluator nanosToMillisEvaluator;
+    private final EsqlArithmeticOperation.BinaryEvaluator millisToNanosEvaluator;
 
     @FunctionalInterface
     public interface BinaryOperatorConstructor {
@@ -118,9 +120,11 @@ protected EsqlBinaryComparison(
         Expression left,
         Expression right,
         BinaryComparisonOperation operation,
-        Map<DataType, EsqlArithmeticOperation.BinaryEvaluator> evaluatorMap
+        Map<DataType, EsqlArithmeticOperation.BinaryEvaluator> evaluatorMap,
+        EsqlArithmeticOperation.BinaryEvaluator nanosToMillisEvaluator,
+        EsqlArithmeticOperation.BinaryEvaluator millisToNanosEvaluator
     ) {
-        this(source, left, right, operation, null, evaluatorMap);
+        this(source, left, right, operation, null, evaluatorMap, nanosToMillisEvaluator, millisToNanosEvaluator);
     }
 
     protected EsqlBinaryComparison(
@@ -130,11 +134,15 @@ protected EsqlBinaryComparison(
         BinaryComparisonOperation operation,
         // TODO: We are definitely not doing the right thing with this zoneId
         ZoneId zoneId,
-        Map<DataType, EsqlArithmeticOperation.BinaryEvaluator> evaluatorMap
+        Map<DataType, EsqlArithmeticOperation.BinaryEvaluator> evaluatorMap,
+        EsqlArithmeticOperation.BinaryEvaluator nanosToMillisEvaluator,
+        EsqlArithmeticOperation.BinaryEvaluator millisToNanosEvaluator
     ) {
         super(source, left, right, operation.shim, zoneId);
         this.evaluatorMap = evaluatorMap;
         this.functionType = operation;
+        this.nanosToMillisEvaluator = nanosToMillisEvaluator;
+        this.millisToNanosEvaluator = millisToNanosEvaluator;
     }
 
     public static EsqlBinaryComparison readFrom(StreamInput in) throws IOException {
@@ -163,11 +171,24 @@ public BinaryComparisonOperation getFunctionType() {
 
     @Override
     public EvalOperator.ExpressionEvaluator.Factory toEvaluator(ToEvaluator toEvaluator) {
-        // Our type is always boolean, so figure out the evaluator type from the inputs
-        DataType commonType = commonType(left().dataType(), right().dataType());
         EvalOperator.ExpressionEvaluator.Factory lhs;
         EvalOperator.ExpressionEvaluator.Factory rhs;
 
+        // Special cases for mixed nanosecond and millisecond comparisions
+        if (left().dataType() == DataType.DATE_NANOS && right().dataType() == DataType.DATETIME) {
+            lhs = toEvaluator.apply(left());
+            rhs = toEvaluator.apply(right());
+            return nanosToMillisEvaluator.apply(source(), lhs, rhs);
+        }
+
+        if (left().dataType() == DataType.DATETIME && right().dataType() == DataType.DATE_NANOS) {
+            lhs = toEvaluator.apply(left());
+            rhs = toEvaluator.apply(right());
+            return millisToNanosEvaluator.apply(source(), lhs, rhs);
+        }
+
+        // Our type is always boolean, so figure out the evaluator type from the inputs
+        DataType commonType = commonType(left().dataType(), right().dataType());
         if (commonType.isNumeric()) {
             lhs = Cast.cast(source(), left().dataType(), commonType, toEvaluator.apply(left()));
             rhs = Cast.cast(source(), right().dataType(), commonType, toEvaluator.apply(right()));
@@ -209,7 +230,9 @@ protected TypeResolution resolveInputType(Expression e, TypeResolutions.ParamOrd
     }
 
     /**
-     * Check if the two input types are compatible for this operation
+     * Check if the two input types are compatible for this operation.
+     * NOTE: this method should be consistent with
+     * {@link org.elasticsearch.xpack.esql.analysis.Verifier#validateBinaryComparison(BinaryComparison)}
      *
      * @return TypeResolution.TYPE_RESOLVED iff the types are compatible.  Otherwise, an appropriate type resolution error.
      */
@@ -225,6 +248,7 @@ protected TypeResolution checkCompatibility() {
 
         if ((leftType.isNumeric() && rightType.isNumeric())
             || (DataType.isString(leftType) && DataType.isString(rightType))
+            || (leftType.isDate() && rightType.isDate()) // Millis and Nanos
             || leftType.equals(rightType)
             || DataType.isNull(leftType)
             || DataType.isNull(rightType)) {
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThan.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThan.java
index 3a46070389368..6087240387f01 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThan.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThan.java
@@ -8,6 +8,7 @@
 
 import org.apache.lucene.util.BytesRef;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.time.DateUtils;
 import org.elasticsearch.compute.ann.Evaluator;
 import org.elasticsearch.xpack.esql.core.expression.Expression;
 import org.elasticsearch.xpack.esql.core.expression.predicate.Negatable;
@@ -62,11 +63,28 @@ public GreaterThan(
             description = "An expression."
         ) Expression right
     ) {
-        super(source, left, right, BinaryComparisonOperation.GT, evaluatorMap);
+        super(
+            source,
+            left,
+            right,
+            BinaryComparisonOperation.GT,
+            evaluatorMap,
+            GreaterThanNanosMillisEvaluator.Factory::new,
+            GreaterThanMillisNanosEvaluator.Factory::new
+        );
     }
 
     public GreaterThan(Source source, Expression left, Expression right, ZoneId zoneId) {
-        super(source, left, right, BinaryComparisonOperation.GT, zoneId, evaluatorMap);
+        super(
+            source,
+            left,
+            right,
+            BinaryComparisonOperation.GT,
+            zoneId,
+            evaluatorMap,
+            GreaterThanNanosMillisEvaluator.Factory::new,
+            GreaterThanMillisNanosEvaluator.Factory::new
+        );
     }
 
     @Override
@@ -109,6 +127,17 @@ static boolean processLongs(long lhs, long rhs) {
         return lhs > rhs;
     }
 
+    @Evaluator(extraName = "MillisNanos")
+    static boolean processMillisNanos(long lhs, long rhs) {
+        // Note, parameters are reversed, so we need to invert the check.
+        return DateUtils.compareNanosToMillis(rhs, lhs) < 0;
+    }
+
+    @Evaluator(extraName = "NanosMillis")
+    static boolean processNanosMillis(long lhs, long rhs) {
+        return DateUtils.compareNanosToMillis(lhs, rhs) > 0;
+    }
+
     @Evaluator(extraName = "Doubles")
     static boolean processDoubles(double lhs, double rhs) {
         return lhs > rhs;
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanOrEqual.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanOrEqual.java
index 841fe5294c660..7ec1e5590bef6 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanOrEqual.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanOrEqual.java
@@ -8,6 +8,7 @@
 
 import org.apache.lucene.util.BytesRef;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.time.DateUtils;
 import org.elasticsearch.compute.ann.Evaluator;
 import org.elasticsearch.xpack.esql.core.expression.Expression;
 import org.elasticsearch.xpack.esql.core.expression.predicate.Negatable;
@@ -62,11 +63,28 @@ public GreaterThanOrEqual(
             description = "An expression."
         ) Expression right
     ) {
-        super(source, left, right, BinaryComparisonOperation.GTE, evaluatorMap);
+        super(
+            source,
+            left,
+            right,
+            BinaryComparisonOperation.GTE,
+            evaluatorMap,
+            GreaterThanOrEqualNanosMillisEvaluator.Factory::new,
+            GreaterThanOrEqualMillisNanosEvaluator.Factory::new
+        );
     }
 
     public GreaterThanOrEqual(Source source, Expression left, Expression right, ZoneId zoneId) {
-        super(source, left, right, BinaryComparisonOperation.GTE, zoneId, evaluatorMap);
+        super(
+            source,
+            left,
+            right,
+            BinaryComparisonOperation.GTE,
+            zoneId,
+            evaluatorMap,
+            GreaterThanOrEqualNanosMillisEvaluator.Factory::new,
+            GreaterThanOrEqualMillisNanosEvaluator.Factory::new
+        );
     }
 
     @Override
@@ -109,6 +127,17 @@ static boolean processLongs(long lhs, long rhs) {
         return lhs >= rhs;
     }
 
+    @Evaluator(extraName = "MillisNanos")
+    static boolean processMillisNanos(long lhs, long rhs) {
+        // Note, parameters are reversed, so we need to invert the check.
+        return DateUtils.compareNanosToMillis(rhs, lhs) <= 0;
+    }
+
+    @Evaluator(extraName = "NanosMillis")
+    static boolean processNanosMillis(long lhs, long rhs) {
+        return DateUtils.compareNanosToMillis(lhs, rhs) >= 0;
+    }
+
     @Evaluator(extraName = "Doubles")
     static boolean processDoubles(double lhs, double rhs) {
         return lhs >= rhs;
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThan.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThan.java
index 3ae7bd93092ef..5f130c054cd6f 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThan.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThan.java
@@ -8,6 +8,7 @@
 
 import org.apache.lucene.util.BytesRef;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.time.DateUtils;
 import org.elasticsearch.compute.ann.Evaluator;
 import org.elasticsearch.xpack.esql.core.expression.Expression;
 import org.elasticsearch.xpack.esql.core.expression.predicate.Negatable;
@@ -66,7 +67,16 @@ public LessThan(
     }
 
     public LessThan(Source source, Expression left, Expression right, ZoneId zoneId) {
-        super(source, left, right, BinaryComparisonOperation.LT, zoneId, evaluatorMap);
+        super(
+            source,
+            left,
+            right,
+            BinaryComparisonOperation.LT,
+            zoneId,
+            evaluatorMap,
+            LessThanNanosMillisEvaluator.Factory::new,
+            LessThanMillisNanosEvaluator.Factory::new
+        );
     }
 
     @Override
@@ -109,6 +119,17 @@ static boolean processLongs(long lhs, long rhs) {
         return lhs < rhs;
     }
 
+    @Evaluator(extraName = "MillisNanos")
+    static boolean processMillisNanos(long lhs, long rhs) {
+        // Note, parameters are reversed, so we need to invert the check.
+        return DateUtils.compareNanosToMillis(rhs, lhs) > 0;
+    }
+
+    @Evaluator(extraName = "NanosMillis")
+    static boolean processNanosMillis(long lhs, long rhs) {
+        return DateUtils.compareNanosToMillis(lhs, rhs) < 0;
+    }
+
     @Evaluator(extraName = "Doubles")
     static boolean processDoubles(double lhs, double rhs) {
         return lhs < rhs;
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanOrEqual.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanOrEqual.java
index e084eee1e8c20..0904c408bfab5 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanOrEqual.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanOrEqual.java
@@ -8,6 +8,7 @@
 
 import org.apache.lucene.util.BytesRef;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.time.DateUtils;
 import org.elasticsearch.compute.ann.Evaluator;
 import org.elasticsearch.xpack.esql.core.expression.Expression;
 import org.elasticsearch.xpack.esql.core.expression.predicate.Negatable;
@@ -66,7 +67,16 @@ public LessThanOrEqual(
     }
 
     public LessThanOrEqual(Source source, Expression left, Expression right, ZoneId zoneId) {
-        super(source, left, right, BinaryComparisonOperation.LTE, zoneId, evaluatorMap);
+        super(
+            source,
+            left,
+            right,
+            BinaryComparisonOperation.LTE,
+            zoneId,
+            evaluatorMap,
+            LessThanOrEqualNanosMillisEvaluator.Factory::new,
+            LessThanOrEqualMillisNanosEvaluator.Factory::new
+        );
     }
 
     @Override
@@ -109,6 +119,17 @@ static boolean processLongs(long lhs, long rhs) {
         return lhs <= rhs;
     }
 
+    @Evaluator(extraName = "MillisNanos")
+    static boolean processMillisNanos(long lhs, long rhs) {
+        // Note, parameters are reversed, so we need to invert the check.
+        return DateUtils.compareNanosToMillis(rhs, lhs) >= 0;
+    }
+
+    @Evaluator(extraName = "NanosMillis")
+    static boolean processNanosMillis(long lhs, long rhs) {
+        return DateUtils.compareNanosToMillis(lhs, rhs) <= 0;
+    }
+
     @Evaluator(extraName = "Doubles")
     static boolean processDoubles(double lhs, double rhs) {
         return lhs <= rhs;
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/NotEquals.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/NotEquals.java
index 9e961c04153d6..d4f86e9a878a9 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/NotEquals.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/NotEquals.java
@@ -8,6 +8,7 @@
 
 import org.apache.lucene.util.BytesRef;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.time.DateUtils;
 import org.elasticsearch.compute.ann.Evaluator;
 import org.elasticsearch.xpack.esql.core.expression.Expression;
 import org.elasticsearch.xpack.esql.core.expression.predicate.Negatable;
@@ -95,11 +96,28 @@ public NotEquals(
             description = "An expression."
         ) Expression right
     ) {
-        super(source, left, right, BinaryComparisonOperation.NEQ, evaluatorMap);
+        super(
+            source,
+            left,
+            right,
+            BinaryComparisonOperation.NEQ,
+            evaluatorMap,
+            NotEqualsNanosMillisEvaluator.Factory::new,
+            NotEqualsMillisNanosEvaluator.Factory::new
+        );
     }
 
     public NotEquals(Source source, Expression left, Expression right, ZoneId zoneId) {
-        super(source, left, right, BinaryComparisonOperation.NEQ, zoneId, evaluatorMap);
+        super(
+            source,
+            left,
+            right,
+            BinaryComparisonOperation.NEQ,
+            zoneId,
+            evaluatorMap,
+            NotEqualsNanosMillisEvaluator.Factory::new,
+            NotEqualsMillisNanosEvaluator.Factory::new
+        );
     }
 
     @Override
@@ -117,6 +135,16 @@ static boolean processLongs(long lhs, long rhs) {
         return lhs != rhs;
     }
 
+    @Evaluator(extraName = "MillisNanos")
+    static boolean processMillisNanos(long lhs, long rhs) {
+        return DateUtils.compareNanosToMillis(rhs, lhs) != 0;
+    }
+
+    @Evaluator(extraName = "NanosMillis")
+    static boolean processNanosMillis(long lhs, long rhs) {
+        return DateUtils.compareNanosToMillis(lhs, rhs) != 0;
+    }
+
     @Evaluator(extraName = "Doubles")
     static boolean processDoubles(double lhs, double rhs) {
         return lhs != rhs;
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/TestCaseSupplier.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/TestCaseSupplier.java
index 377027b70fb54..2004fa3a1cdb0 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/TestCaseSupplier.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/TestCaseSupplier.java
@@ -1791,9 +1791,9 @@ public TypedData withData(Object data) {
         @Override
         public String toString() {
             if (type == DataType.UNSIGNED_LONG && data instanceof Long longData) {
-                return type.toString() + "(" + NumericUtils.unsignedLongAsBigInteger(longData).toString() + ")";
+                return type + "(" + NumericUtils.unsignedLongAsBigInteger(longData).toString() + ")";
             }
-            return type.toString() + "(" + (data == null ? "null" : data.toString()) + ")";
+            return type.toString() + "(" + (data == null ? "null" : getValue().toString()) + ")";
         }
 
         /**
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/EqualsTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/EqualsTests.java
index 0fb416584b472..6666eb8adab61 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/EqualsTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/EqualsTests.java
@@ -144,6 +144,34 @@ public static Iterable<Object[]> parameters() {
             )
         );
 
+        suppliers.addAll(
+            TestCaseSupplier.forBinaryNotCasting(
+                "EqualsNanosMillisEvaluator",
+                "lhs",
+                "rhs",
+                Object::equals,
+                DataType.BOOLEAN,
+                TestCaseSupplier.dateNanosCases(),
+                TestCaseSupplier.dateCases(),
+                List.of(),
+                false
+            )
+        );
+
+        suppliers.addAll(
+            TestCaseSupplier.forBinaryNotCasting(
+                "EqualsMillisNanosEvaluator",
+                "lhs",
+                "rhs",
+                Object::equals,
+                DataType.BOOLEAN,
+                TestCaseSupplier.dateCases(),
+                TestCaseSupplier.dateNanosCases(),
+                List.of(),
+                false
+            )
+        );
+
         suppliers.addAll(
             TestCaseSupplier.stringCases(
                 Object::equals,
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanOrEqualTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanOrEqualTests.java
index 395a574028f6a..0fbd49abd885b 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanOrEqualTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanOrEqualTests.java
@@ -121,6 +121,34 @@ public static Iterable<Object[]> parameters() {
             throw new UnsupportedOperationException("Got some weird types");
         }, DataType.BOOLEAN, TestCaseSupplier.dateNanosCases(), TestCaseSupplier.dateNanosCases(), List.of(), false));
 
+        suppliers.addAll(
+            TestCaseSupplier.forBinaryNotCasting(
+                "GreaterThanOrEqualNanosMillisEvaluator",
+                "lhs",
+                "rhs",
+                (lhs, rhs) -> (((Instant) lhs).isAfter((Instant) rhs) || lhs.equals(rhs)),
+                DataType.BOOLEAN,
+                TestCaseSupplier.dateNanosCases(),
+                TestCaseSupplier.dateCases(),
+                List.of(),
+                false
+            )
+        );
+
+        suppliers.addAll(
+            TestCaseSupplier.forBinaryNotCasting(
+                "GreaterThanOrEqualMillisNanosEvaluator",
+                "lhs",
+                "rhs",
+                (lhs, rhs) -> (((Instant) lhs).isAfter((Instant) rhs) || lhs.equals(rhs)),
+                DataType.BOOLEAN,
+                TestCaseSupplier.dateCases(),
+                TestCaseSupplier.dateNanosCases(),
+                List.of(),
+                false
+            )
+        );
+
         suppliers.addAll(
             TestCaseSupplier.stringCases(
                 (l, r) -> ((BytesRef) l).compareTo((BytesRef) r) >= 0,
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanTests.java
index b56ecd7392ba6..ccc66df60fb3f 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/GreaterThanTests.java
@@ -135,6 +135,34 @@ public static Iterable<Object[]> parameters() {
             )
         );
 
+        suppliers.addAll(
+            TestCaseSupplier.forBinaryNotCasting(
+                "GreaterThanNanosMillisEvaluator",
+                "lhs",
+                "rhs",
+                (l, r) -> ((Instant) l).isAfter((Instant) r),
+                DataType.BOOLEAN,
+                TestCaseSupplier.dateNanosCases(),
+                TestCaseSupplier.dateCases(),
+                List.of(),
+                false
+            )
+        );
+
+        suppliers.addAll(
+            TestCaseSupplier.forBinaryNotCasting(
+                "GreaterThanMillisNanosEvaluator",
+                "lhs",
+                "rhs",
+                (l, r) -> ((Instant) l).isAfter((Instant) r),
+                DataType.BOOLEAN,
+                TestCaseSupplier.dateCases(),
+                TestCaseSupplier.dateNanosCases(),
+                List.of(),
+                false
+            )
+        );
+
         suppliers.addAll(
             TestCaseSupplier.stringCases(
                 (l, r) -> ((BytesRef) l).compareTo((BytesRef) r) > 0,
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanOrEqualTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanOrEqualTests.java
index 60062f071c183..1e91a65e04c0e 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanOrEqualTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanOrEqualTests.java
@@ -121,6 +121,34 @@ public static Iterable<Object[]> parameters() {
             throw new UnsupportedOperationException("Got some weird types");
         }, DataType.BOOLEAN, TestCaseSupplier.dateNanosCases(), TestCaseSupplier.dateNanosCases(), List.of(), false));
 
+        suppliers.addAll(
+            TestCaseSupplier.forBinaryNotCasting(
+                "LessThanOrEqualNanosMillisEvaluator",
+                "lhs",
+                "rhs",
+                (l, r) -> (((Instant) l).isBefore((Instant) r) || l.equals(r)),
+                DataType.BOOLEAN,
+                TestCaseSupplier.dateNanosCases(),
+                TestCaseSupplier.dateCases(),
+                List.of(),
+                false
+            )
+        );
+
+        suppliers.addAll(
+            TestCaseSupplier.forBinaryNotCasting(
+                "LessThanOrEqualMillisNanosEvaluator",
+                "lhs",
+                "rhs",
+                (l, r) -> (((Instant) l).isBefore((Instant) r) || l.equals(r)),
+                DataType.BOOLEAN,
+                TestCaseSupplier.dateCases(),
+                TestCaseSupplier.dateNanosCases(),
+                List.of(),
+                false
+            )
+        );
+
         suppliers.addAll(
             TestCaseSupplier.stringCases(
                 (l, r) -> ((BytesRef) l).compareTo((BytesRef) r) <= 0,
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanTests.java
index 30812cf8e538d..69dc59bac6456 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/LessThanTests.java
@@ -135,6 +135,34 @@ public static Iterable<Object[]> parameters() {
             )
         );
 
+        suppliers.addAll(
+            TestCaseSupplier.forBinaryNotCasting(
+                "LessThanNanosMillisEvaluator",
+                "lhs",
+                "rhs",
+                (l, r) -> ((Instant) l).isBefore((Instant) r),
+                DataType.BOOLEAN,
+                TestCaseSupplier.dateNanosCases(),
+                TestCaseSupplier.dateCases(),
+                List.of(),
+                false
+            )
+        );
+
+        suppliers.addAll(
+            TestCaseSupplier.forBinaryNotCasting(
+                "LessThanMillisNanosEvaluator",
+                "lhs",
+                "rhs",
+                (l, r) -> ((Instant) l).isBefore((Instant) r),
+                DataType.BOOLEAN,
+                TestCaseSupplier.dateCases(),
+                TestCaseSupplier.dateNanosCases(),
+                List.of(),
+                false
+            )
+        );
+
         suppliers.addAll(
             TestCaseSupplier.stringCases(
                 (l, r) -> ((BytesRef) l).compareTo((BytesRef) r) < 0,
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/NotEqualsTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/NotEqualsTests.java
index 53676a43b16a0..7b57b97dfe28e 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/NotEqualsTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/NotEqualsTests.java
@@ -128,7 +128,7 @@ public static Iterable<Object[]> parameters() {
                 false
             )
         );
-        // Datetime
+        // Datenanos
         suppliers.addAll(
             TestCaseSupplier.forBinaryNotCasting(
                 "NotEqualsLongsEvaluator",
@@ -142,6 +142,36 @@ public static Iterable<Object[]> parameters() {
                 false
             )
         );
+
+        // nanoseconds to milliseconds. NB: these have different evaluator names depending on the direction
+        suppliers.addAll(
+            TestCaseSupplier.forBinaryNotCasting(
+                "NotEqualsNanosMillisEvaluator",
+                "lhs",
+                "rhs",
+                (l, r) -> false == l.equals(r),
+                DataType.BOOLEAN,
+                TestCaseSupplier.dateNanosCases(),
+                TestCaseSupplier.dateCases(),
+                List.of(),
+                false
+            )
+        );
+
+        suppliers.addAll(
+            TestCaseSupplier.forBinaryNotCasting(
+                "NotEqualsMillisNanosEvaluator",
+                "lhs",
+                "rhs",
+                (l, r) -> false == l.equals(r),
+                DataType.BOOLEAN,
+                TestCaseSupplier.dateCases(),
+                TestCaseSupplier.dateNanosCases(),
+                List.of(),
+                false
+            )
+        );
+
         suppliers.addAll(
             TestCaseSupplier.stringCases(
                 (l, r) -> false == l.equals(r),

From ca09e728711bc1bb39b7c85ac313d255a797a53c Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Sat, 7 Dec 2024 01:48:00 +1100
Subject: [PATCH 083/119] Mute
 org.elasticsearch.xpack.remotecluster.CrossClusterEsqlRCS2UnavailableRemotesIT
 testEsqlRcs2UnavailableRemoteScenarios #117419

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 6d48052fe25e1..fb2fea908ef9e 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -257,6 +257,9 @@ tests:
 - class: org.elasticsearch.xpack.esql.qa.multi_node.EsqlSpecIT
   method: test {lookup-join.LookupMessageFromIndexKeepReordered ASYNC}
   issue: https://github.com/elastic/elasticsearch/issues/118151
+- class: org.elasticsearch.xpack.remotecluster.CrossClusterEsqlRCS2UnavailableRemotesIT
+  method: testEsqlRcs2UnavailableRemoteScenarios
+  issue: https://github.com/elastic/elasticsearch/issues/117419
 
 # Examples:
 #

From e55f07b85037e1c59155b5d08495a32f9b1b495d Mon Sep 17 00:00:00 2001
From: Benjamin Trent <ben.w.trent@gmail.com>
Date: Fri, 6 Dec 2024 10:05:17 -0500
Subject: [PATCH 084/119] Remove long deprecated ignore_case from synonym
 filter (#115985)

ignore_case has been deprecated in synonym filter since ES 6.
---
 .../analysis/common/SynonymTokenFilterFactory.java     | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/SynonymTokenFilterFactory.java b/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/SynonymTokenFilterFactory.java
index 9e31fdde4330b..9dc3478994f1f 100644
--- a/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/SynonymTokenFilterFactory.java
+++ b/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/SynonymTokenFilterFactory.java
@@ -13,7 +13,6 @@
 import org.apache.lucene.analysis.TokenStream;
 import org.apache.lucene.analysis.synonym.SynonymFilter;
 import org.apache.lucene.analysis.synonym.SynonymMap;
-import org.elasticsearch.common.logging.DeprecationCategory;
 import org.elasticsearch.common.logging.DeprecationLogger;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.env.Environment;
@@ -152,15 +151,6 @@ public static SynonymsSource fromSettings(Settings settings) {
         super(name, settings);
         this.settings = settings;
 
-        if (settings.get("ignore_case") != null) {
-            DEPRECATION_LOGGER.warn(
-                DeprecationCategory.ANALYSIS,
-                "synonym_ignore_case_option",
-                "The ignore_case option on the synonym_graph filter is deprecated. "
-                    + "Instead, insert a lowercase filter in the filter chain before the synonym_graph filter."
-            );
-        }
-
         this.synonymsSource = SynonymsSource.fromSettings(settings);
         this.expand = settings.getAsBoolean("expand", true);
         this.format = settings.get("format", "");

From bb60b1d0f4b35a51293485e38101396e29248b83 Mon Sep 17 00:00:00 2001
From: Keith Massey <keith.massey@elastic.co>
Date: Fri, 6 Dec 2024 09:25:17 -0600
Subject: [PATCH 085/119] muting
 KeystoreManagementTests.test31WrongKeystorePasswordFromFile

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index fb2fea908ef9e..9353534a9d830 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -248,6 +248,9 @@ tests:
 - class: org.elasticsearch.packaging.test.KeystoreManagementTests
   method: test30KeystorePasswordFromFile
   issue: https://github.com/elastic/elasticsearch/issues/118123
+- class: org.elasticsearch.packaging.test.KeystoreManagementTests
+  method: test31WrongKeystorePasswordFromFile
+  issue: https://github.com/elastic/elasticsearch/issues/118123
 - class: org.elasticsearch.packaging.test.ArchiveTests
   method: test41AutoconfigurationNotTriggeredWhenNodeCannotContainData
   issue: https://github.com/elastic/elasticsearch/issues/118110

From 3ae2330630e5f5d0fa62e4c41288a6dbae47678f Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Fri, 6 Dec 2024 07:33:06 -0800
Subject: [PATCH 086/119] Ignore cancellation exceptions (#117657)

Today, when an ES|QL task encounters an exception, we trigger a
cancellation on the root task, causing child tasks to fail due to
cancellation. We chose not to include cancellation exceptions in the
output, as they are unhelpful and add noise during problem analysis.
However, these exceptions are still slipping through via
RefCountingListener. This change addresses the issue by introducing
ESQLRefCountingListener, ensuring that no cancellation exceptions are
returned.
---
 docs/changelog/117657.yaml                    |  5 ++
 .../compute/EsqlRefCountingListener.java      | 47 ++++++++++++++++++
 .../compute/operator/FailureCollector.java    | 48 +++++++++----------
 .../exchange/ExchangeSourceHandler.java       | 17 +++----
 .../operator/FailureCollectorTests.java       |  9 ++++
 .../xpack/esql/EsqlTestUtils.java             | 18 +++++++
 .../xpack/esql/action/EnrichIT.java           |  1 +
 .../esql/action/EsqlActionBreakerIT.java      |  2 +
 .../xpack/esql/action/EsqlActionTaskIT.java   | 12 ++++-
 .../xpack/esql/action/EsqlDisruptionIT.java   |  2 +
 .../xpack/esql/plugin/ComputeListener.java    | 10 ++--
 .../xpack/esql/plugin/ComputeService.java     |  6 +--
 12 files changed, 135 insertions(+), 42 deletions(-)
 create mode 100644 docs/changelog/117657.yaml
 create mode 100644 x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/EsqlRefCountingListener.java

diff --git a/docs/changelog/117657.yaml b/docs/changelog/117657.yaml
new file mode 100644
index 0000000000000..0a72e9dabe9e8
--- /dev/null
+++ b/docs/changelog/117657.yaml
@@ -0,0 +1,5 @@
+pr: 117657
+summary: Ignore cancellation exceptions
+area: ES|QL
+type: bug
+issues: []
diff --git a/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/EsqlRefCountingListener.java b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/EsqlRefCountingListener.java
new file mode 100644
index 0000000000000..69df0fb8ceff1
--- /dev/null
+++ b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/EsqlRefCountingListener.java
@@ -0,0 +1,47 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.compute;
+
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.support.RefCountingRunnable;
+import org.elasticsearch.compute.operator.FailureCollector;
+import org.elasticsearch.core.Releasable;
+
+/**
+ * Similar to {@link org.elasticsearch.action.support.RefCountingListener},
+ * but prefers non-task-cancelled exceptions over task-cancelled ones as they are more useful for diagnosing issues.
+ * @see FailureCollector
+ */
+public final class EsqlRefCountingListener implements Releasable {
+    private final FailureCollector failureCollector;
+    private final RefCountingRunnable refs;
+
+    public EsqlRefCountingListener(ActionListener<Void> delegate) {
+        this.failureCollector = new FailureCollector();
+        this.refs = new RefCountingRunnable(() -> {
+            Exception error = failureCollector.getFailure();
+            if (error != null) {
+                delegate.onFailure(error);
+            } else {
+                delegate.onResponse(null);
+            }
+        });
+    }
+
+    public ActionListener<Void> acquire() {
+        return refs.acquireListener().delegateResponse((l, e) -> {
+            failureCollector.unwrapAndCollect(e);
+            l.onFailure(e);
+        });
+    }
+
+    @Override
+    public void close() {
+        refs.close();
+    }
+}
diff --git a/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/FailureCollector.java b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/FailureCollector.java
index 943ba4dc1f4fa..337075edbdcf6 100644
--- a/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/FailureCollector.java
+++ b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/FailureCollector.java
@@ -13,9 +13,8 @@
 import org.elasticsearch.tasks.TaskCancelledException;
 import org.elasticsearch.transport.TransportException;
 
-import java.util.List;
 import java.util.Queue;
-import java.util.concurrent.atomic.AtomicInteger;
+import java.util.concurrent.Semaphore;
 
 /**
  * {@code FailureCollector} is responsible for collecting exceptions that occur in the compute engine.
@@ -26,12 +25,11 @@
  */
 public final class FailureCollector {
     private final Queue<Exception> cancelledExceptions = ConcurrentCollections.newQueue();
-    private final AtomicInteger cancelledExceptionsCount = new AtomicInteger();
+    private final Semaphore cancelledExceptionsPermits;
 
     private final Queue<Exception> nonCancelledExceptions = ConcurrentCollections.newQueue();
-    private final AtomicInteger nonCancelledExceptionsCount = new AtomicInteger();
+    private final Semaphore nonCancelledExceptionsPermits;
 
-    private final int maxExceptions;
     private volatile boolean hasFailure = false;
     private Exception finalFailure = null;
 
@@ -43,7 +41,8 @@ public FailureCollector(int maxExceptions) {
         if (maxExceptions <= 0) {
             throw new IllegalArgumentException("maxExceptions must be at least one");
         }
-        this.maxExceptions = maxExceptions;
+        this.cancelledExceptionsPermits = new Semaphore(maxExceptions);
+        this.nonCancelledExceptionsPermits = new Semaphore(maxExceptions);
     }
 
     private static Exception unwrapTransportException(TransportException te) {
@@ -60,13 +59,12 @@ private static Exception unwrapTransportException(TransportException te) {
     public void unwrapAndCollect(Exception e) {
         e = e instanceof TransportException te ? unwrapTransportException(te) : e;
         if (ExceptionsHelper.unwrap(e, TaskCancelledException.class) != null) {
-            if (cancelledExceptionsCount.incrementAndGet() <= maxExceptions) {
+            if (nonCancelledExceptions.isEmpty() && cancelledExceptionsPermits.tryAcquire()) {
                 cancelledExceptions.add(e);
             }
-        } else {
-            if (nonCancelledExceptionsCount.incrementAndGet() <= maxExceptions) {
-                nonCancelledExceptions.add(e);
-            }
+        } else if (nonCancelledExceptionsPermits.tryAcquire()) {
+            nonCancelledExceptions.add(e);
+            cancelledExceptions.clear();
         }
         hasFailure = true;
     }
@@ -99,20 +97,22 @@ public Exception getFailure() {
     private Exception buildFailure() {
         assert hasFailure;
         assert Thread.holdsLock(this);
-        int total = 0;
         Exception first = null;
-        for (var exceptions : List.of(nonCancelledExceptions, cancelledExceptions)) {
-            for (Exception e : exceptions) {
-                if (first == null) {
-                    first = e;
-                    total++;
-                } else if (first != e) {
-                    first.addSuppressed(e);
-                    total++;
-                }
-                if (total >= maxExceptions) {
-                    return first;
-                }
+        for (Exception e : nonCancelledExceptions) {
+            if (first == null) {
+                first = e;
+            } else if (first != e) {
+                first.addSuppressed(e);
+            }
+        }
+        if (first != null) {
+            return first;
+        }
+        for (Exception e : cancelledExceptions) {
+            if (first == null) {
+                first = e;
+            } else if (first != e) {
+                first.addSuppressed(e);
             }
         }
         assert first != null;
diff --git a/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/exchange/ExchangeSourceHandler.java b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/exchange/ExchangeSourceHandler.java
index 375016a5d51d5..b53ddea3da587 100644
--- a/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/exchange/ExchangeSourceHandler.java
+++ b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/exchange/ExchangeSourceHandler.java
@@ -9,9 +9,10 @@
 
 import org.elasticsearch.ExceptionsHelper;
 import org.elasticsearch.action.ActionListener;
-import org.elasticsearch.action.support.RefCountingListener;
+import org.elasticsearch.action.support.RefCountingRunnable;
 import org.elasticsearch.action.support.SubscribableListener;
 import org.elasticsearch.common.util.concurrent.AbstractRunnable;
+import org.elasticsearch.compute.EsqlRefCountingListener;
 import org.elasticsearch.compute.data.Page;
 import org.elasticsearch.compute.operator.FailureCollector;
 import org.elasticsearch.compute.operator.IsBlockedResult;
@@ -54,20 +55,20 @@ public ExchangeSourceHandler(int maxBufferSize, Executor fetchExecutor, ActionLi
         this.outstandingSinks = new PendingInstances(() -> buffer.finish(false));
         this.outstandingSources = new PendingInstances(() -> buffer.finish(true));
         buffer.addCompletionListener(ActionListener.running(() -> {
-            final ActionListener<Void> listener = ActionListener.assertAtLeastOnce(completionListener).delegateFailure((l, unused) -> {
+            final ActionListener<Void> listener = ActionListener.assertAtLeastOnce(completionListener);
+            try (RefCountingRunnable refs = new RefCountingRunnable(() -> {
                 final Exception e = failure.getFailure();
                 if (e != null) {
-                    l.onFailure(e);
+                    listener.onFailure(e);
                 } else {
-                    l.onResponse(null);
+                    listener.onResponse(null);
                 }
-            });
-            try (RefCountingListener refs = new RefCountingListener(listener)) {
+            })) {
                 for (PendingInstances pending : List.of(outstandingSinks, outstandingSources)) {
                     // Create an outstanding instance and then finish to complete the completionListener
                     // if we haven't registered any instances of exchange sinks or exchange sources before.
                     pending.trackNewInstance();
-                    pending.completion.addListener(refs.acquire());
+                    pending.completion.addListener(refs.acquireListener());
                     pending.finishInstance();
                 }
             }
@@ -269,7 +270,7 @@ public void onFailure(Exception e) {
 
             @Override
             protected void doRun() {
-                try (RefCountingListener refs = new RefCountingListener(sinkListener)) {
+                try (EsqlRefCountingListener refs = new EsqlRefCountingListener(sinkListener)) {
                     for (int i = 0; i < instances; i++) {
                         var fetcher = new RemoteSinkFetcher(remoteSink, failFast, refs.acquire());
                         fetcher.fetchPage();
diff --git a/x-pack/plugin/esql/compute/src/test/java/org/elasticsearch/compute/operator/FailureCollectorTests.java b/x-pack/plugin/esql/compute/src/test/java/org/elasticsearch/compute/operator/FailureCollectorTests.java
index 637cbe8892b3e..5fec82b32ddac 100644
--- a/x-pack/plugin/esql/compute/src/test/java/org/elasticsearch/compute/operator/FailureCollectorTests.java
+++ b/x-pack/plugin/esql/compute/src/test/java/org/elasticsearch/compute/operator/FailureCollectorTests.java
@@ -7,6 +7,7 @@
 
 package org.elasticsearch.compute.operator;
 
+import org.elasticsearch.ExceptionsHelper;
 import org.elasticsearch.cluster.node.DiscoveryNodeUtils;
 import org.elasticsearch.common.Randomness;
 import org.elasticsearch.common.breaker.CircuitBreaker;
@@ -86,6 +87,14 @@ public void testCollect() throws Exception {
         assertNotNull(failure);
         assertThat(failure, Matchers.in(nonCancelledExceptions));
         assertThat(failure.getSuppressed().length, lessThan(maxExceptions));
+        assertTrue(
+            "cancellation exceptions must be ignored",
+            ExceptionsHelper.unwrapCausesAndSuppressed(failure, t -> t instanceof TaskCancelledException).isEmpty()
+        );
+        assertTrue(
+            "remote transport exception must be unwrapped",
+            ExceptionsHelper.unwrapCausesAndSuppressed(failure, t -> t instanceof TransportException).isEmpty()
+        );
     }
 
     public void testEmpty() {
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/EsqlTestUtils.java b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/EsqlTestUtils.java
index ec9af33dd6690..5535e801b1b0c 100644
--- a/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/EsqlTestUtils.java
+++ b/x-pack/plugin/esql/qa/testFixtures/src/main/java/org/elasticsearch/xpack/esql/EsqlTestUtils.java
@@ -10,6 +10,7 @@
 import org.apache.lucene.document.InetAddressPoint;
 import org.apache.lucene.sandbox.document.HalfFloatPoint;
 import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.ExceptionsHelper;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.breaker.CircuitBreaker;
 import org.elasticsearch.common.breaker.NoopCircuitBreaker;
@@ -30,7 +31,9 @@
 import org.elasticsearch.geo.ShapeTestUtils;
 import org.elasticsearch.index.IndexMode;
 import org.elasticsearch.license.XPackLicenseState;
+import org.elasticsearch.tasks.TaskCancelledException;
 import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.transport.RemoteTransportException;
 import org.elasticsearch.xcontent.json.JsonXContent;
 import org.elasticsearch.xpack.esql.action.EsqlQueryResponse;
 import org.elasticsearch.xpack.esql.analysis.EnrichResolution;
@@ -129,6 +132,8 @@
 import static org.elasticsearch.xpack.esql.parser.ParserUtils.ParamClassification.PATTERN;
 import static org.elasticsearch.xpack.esql.parser.ParserUtils.ParamClassification.VALUE;
 import static org.hamcrest.Matchers.instanceOf;
+import static org.junit.Assert.assertNotNull;
+import static org.junit.Assert.assertNull;
 
 public final class EsqlTestUtils {
 
@@ -784,4 +789,17 @@ public static QueryParam paramAsIdentifier(String name, Object value) {
     public static QueryParam paramAsPattern(String name, Object value) {
         return new QueryParam(name, value, NULL, PATTERN);
     }
+
+    /**
+     * Asserts that:
+     * 1. Cancellation exceptions are ignored when more relevant exceptions exist.
+     * 2. Transport exceptions are unwrapped, and the actual causes are reported to users.
+     */
+    public static void assertEsqlFailure(Exception e) {
+        assertNotNull(e);
+        var cancellationFailure = ExceptionsHelper.unwrapCausesAndSuppressed(e, t -> t instanceof TaskCancelledException).orElse(null);
+        assertNull("cancellation exceptions must be ignored", cancellationFailure);
+        ExceptionsHelper.unwrapCausesAndSuppressed(e, t -> t instanceof RemoteTransportException)
+            .ifPresent(transportFailure -> assertNull("remote transport exception must be unwrapped", transportFailure.getCause()));
+    }
 }
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EnrichIT.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EnrichIT.java
index dab99a0f719dd..c4da0bf32ef96 100644
--- a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EnrichIT.java
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EnrichIT.java
@@ -143,6 +143,7 @@ protected EsqlQueryResponse run(EsqlQueryRequest request) {
                 return client.execute(EsqlQueryAction.INSTANCE, request).actionGet(2, TimeUnit.MINUTES);
             } catch (Exception e) {
                 logger.info("request failed", e);
+                EsqlTestUtils.assertEsqlFailure(e);
                 ensureBlocksReleased();
             } finally {
                 setRequestCircuitBreakerLimit(null);
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EsqlActionBreakerIT.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EsqlActionBreakerIT.java
index 37833d8aed2d3..ec7ee8b61c2d5 100644
--- a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EsqlActionBreakerIT.java
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EsqlActionBreakerIT.java
@@ -23,6 +23,7 @@
 import org.elasticsearch.plugins.Plugin;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.test.junit.annotations.TestLogging;
+import org.elasticsearch.xpack.esql.EsqlTestUtils;
 
 import java.util.ArrayList;
 import java.util.Collection;
@@ -85,6 +86,7 @@ private EsqlQueryResponse runWithBreaking(EsqlQueryRequest request) throws Circu
         } catch (Exception e) {
             logger.info("request failed", e);
             ensureBlocksReleased();
+            EsqlTestUtils.assertEsqlFailure(e);
             throw e;
         } finally {
             setRequestCircuitBreakerLimit(null);
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EsqlActionTaskIT.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EsqlActionTaskIT.java
index 1939f81353c0e..abd4f6b49d7b4 100644
--- a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EsqlActionTaskIT.java
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EsqlActionTaskIT.java
@@ -36,6 +36,7 @@
 import org.elasticsearch.test.transport.MockTransportService;
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.transport.TransportService;
+import org.elasticsearch.xpack.esql.EsqlTestUtils;
 import org.elasticsearch.xpack.esql.plugin.QueryPragmas;
 import org.junit.Before;
 
@@ -338,7 +339,15 @@ private void assertCancelled(ActionFuture<EsqlQueryResponse> response) throws Ex
          */
         assertThat(
             cancelException.getMessage(),
-            in(List.of("test cancel", "task cancelled", "request cancelled test cancel", "parent task was cancelled [test cancel]"))
+            in(
+                List.of(
+                    "test cancel",
+                    "task cancelled",
+                    "request cancelled test cancel",
+                    "parent task was cancelled [test cancel]",
+                    "cancelled on failure"
+                )
+            )
         );
         assertBusy(
             () -> assertThat(
@@ -434,6 +443,7 @@ protected void doRun() throws Exception {
                 allowedFetching.countDown();
             }
             Exception failure = expectThrows(Exception.class, () -> future.actionGet().close());
+            EsqlTestUtils.assertEsqlFailure(failure);
             assertThat(failure.getMessage(), containsString("failed to fetch pages"));
             // If we proceed without waiting for pages, we might cancel the main request before starting the data-node request.
             // As a result, the exchange sinks on data-nodes won't be removed until the inactive_timeout elapses, which is
diff --git a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EsqlDisruptionIT.java b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EsqlDisruptionIT.java
index e9eada5def0dc..72a60a6b6b928 100644
--- a/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EsqlDisruptionIT.java
+++ b/x-pack/plugin/esql/src/internalClusterTest/java/org/elasticsearch/xpack/esql/action/EsqlDisruptionIT.java
@@ -23,6 +23,7 @@
 import org.elasticsearch.test.disruption.ServiceDisruptionScheme;
 import org.elasticsearch.test.transport.MockTransportService;
 import org.elasticsearch.transport.TransportSettings;
+import org.elasticsearch.xpack.esql.EsqlTestUtils;
 
 import java.util.ArrayList;
 import java.util.Collection;
@@ -111,6 +112,7 @@ private EsqlQueryResponse runQueryWithDisruption(EsqlQueryRequest request) {
             assertTrue("request must be failed or completed after clearing disruption", future.isDone());
             ensureBlocksReleased();
             logger.info("--> failed to execute esql query with disruption; retrying...", e);
+            EsqlTestUtils.assertEsqlFailure(e);
             return client().execute(EsqlQueryAction.INSTANCE, request).actionGet(2, TimeUnit.MINUTES);
         }
     }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeListener.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeListener.java
index 8d041ffbdf0e4..8bd23230fcde7 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeListener.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeListener.java
@@ -9,8 +9,8 @@
 
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.support.RefCountingListener;
+import org.elasticsearch.compute.EsqlRefCountingListener;
 import org.elasticsearch.compute.operator.DriverProfile;
-import org.elasticsearch.compute.operator.FailureCollector;
 import org.elasticsearch.compute.operator.ResponseHeadersCollector;
 import org.elasticsearch.core.Nullable;
 import org.elasticsearch.core.Releasable;
@@ -39,8 +39,7 @@
 final class ComputeListener implements Releasable {
     private static final Logger LOGGER = LogManager.getLogger(ComputeService.class);
 
-    private final RefCountingListener refs;
-    private final FailureCollector failureCollector = new FailureCollector();
+    private final EsqlRefCountingListener refs;
     private final AtomicBoolean cancelled = new AtomicBoolean();
     private final CancellableTask task;
     private final TransportService transportService;
@@ -105,7 +104,7 @@ private ComputeListener(
             : "clusterAlias and executionInfo must both be null or both non-null";
 
         // listener that executes after all the sub-listeners refs (created via acquireCompute) have completed
-        this.refs = new RefCountingListener(1, ActionListener.wrap(ignored -> {
+        this.refs = new EsqlRefCountingListener(delegate.delegateFailure((l, ignored) -> {
             responseHeaders.finish();
             ComputeResponse result;
 
@@ -131,7 +130,7 @@ private ComputeListener(
                 }
             }
             delegate.onResponse(result);
-        }, e -> delegate.onFailure(failureCollector.getFailure())));
+        }));
     }
 
     private static void setFinalStatusAndShardCounts(String clusterAlias, EsqlExecutionInfo executionInfo) {
@@ -191,7 +190,6 @@ private boolean isCCSListener(String computeClusterAlias) {
      */
     ActionListener<Void> acquireAvoid() {
         return refs.acquire().delegateResponse((l, e) -> {
-            failureCollector.unwrapAndCollect(e);
             try {
                 if (cancelled.compareAndSet(false, true)) {
                     LOGGER.debug("cancelling ESQL task {} on failure", task);
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeService.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeService.java
index ed037d24139f8..9b59b98a7cdc2 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeService.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/plugin/ComputeService.java
@@ -16,11 +16,11 @@
 import org.elasticsearch.action.search.SearchShardsRequest;
 import org.elasticsearch.action.search.SearchShardsResponse;
 import org.elasticsearch.action.support.ChannelActionListener;
-import org.elasticsearch.action.support.RefCountingListener;
 import org.elasticsearch.action.support.RefCountingRunnable;
 import org.elasticsearch.cluster.node.DiscoveryNode;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.util.BigArrays;
+import org.elasticsearch.compute.EsqlRefCountingListener;
 import org.elasticsearch.compute.data.BlockFactory;
 import org.elasticsearch.compute.data.Page;
 import org.elasticsearch.compute.operator.Driver;
@@ -375,7 +375,7 @@ private void startComputeOnDataNodes(
         var lookupListener = ActionListener.releaseAfter(computeListener.acquireAvoid(), exchangeSource.addEmptySink());
         // SearchShards API can_match is done in lookupDataNodes
         lookupDataNodes(parentTask, clusterAlias, requestFilter, concreteIndices, originalIndices, ActionListener.wrap(dataNodeResult -> {
-            try (RefCountingListener refs = new RefCountingListener(lookupListener)) {
+            try (EsqlRefCountingListener refs = new EsqlRefCountingListener(lookupListener)) {
                 // update ExecutionInfo with shard counts (total and skipped)
                 executionInfo.swapCluster(
                     clusterAlias,
@@ -436,7 +436,7 @@ private void startComputeOnRemoteClusters(
     ) {
         var queryPragmas = configuration.pragmas();
         var linkExchangeListeners = ActionListener.releaseAfter(computeListener.acquireAvoid(), exchangeSource.addEmptySink());
-        try (RefCountingListener refs = new RefCountingListener(linkExchangeListeners)) {
+        try (EsqlRefCountingListener refs = new EsqlRefCountingListener(linkExchangeListeners)) {
             for (RemoteCluster cluster : clusters) {
                 final var childSessionId = newChildSession(sessionId);
                 ExchangeService.openExchange(

From 4f030efcd50781fe6e624dc08046b834786edb4a Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Sat, 7 Dec 2024 02:37:17 +1100
Subject: [PATCH 087/119] Mute
 org.elasticsearch.packaging.test.DebPreservationTests test40RestartOnUpgrade
 #118170

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 9353534a9d830..8f1030279efc9 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -263,6 +263,9 @@ tests:
 - class: org.elasticsearch.xpack.remotecluster.CrossClusterEsqlRCS2UnavailableRemotesIT
   method: testEsqlRcs2UnavailableRemoteScenarios
   issue: https://github.com/elastic/elasticsearch/issues/117419
+- class: org.elasticsearch.packaging.test.DebPreservationTests
+  method: test40RestartOnUpgrade
+  issue: https://github.com/elastic/elasticsearch/issues/118170
 
 # Examples:
 #

From 8c380079864c3b98fef872b90102bf1705994f96 Mon Sep 17 00:00:00 2001
From: Nik Everett <nik9000@gmail.com>
Date: Fri, 6 Dec 2024 12:48:37 -0500
Subject: [PATCH 088/119] ESQL: Rework `isNull` (#118101)

This reworks `Expressions#isNull` so it only matches the `null` literal.
This doesn't super change the way ESQL works because we already rewrite
things that `fold` into `null` into the `null` literal. It's just that,
now, `isNull` won't return `true` for things that *fold* to null - only
things that have *already* folded to null.

This is important because `fold` can be quite expensive so we're better
off keeping the results of it when possible. Which is what the constant
folding rules *do*.
---
 .../xpack/esql/core/expression/Expressions.java      | 12 ++++++++++--
 .../expression/predicate/operator/comparison/In.java |  6 +++---
 .../xpack/esql/optimizer/rules/logical/FoldNull.java |  6 +++---
 .../esql/optimizer/rules/logical/PruneFilters.java   |  8 ++++----
 .../rules/logical/SplitInWithFoldableValue.java      |  2 +-
 .../esql/optimizer/LogicalPlanOptimizerTests.java    |  2 +-
 6 files changed, 22 insertions(+), 14 deletions(-)

diff --git a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/Expressions.java b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/Expressions.java
index 8baffbf887e47..4e4338aad3704 100644
--- a/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/Expressions.java
+++ b/x-pack/plugin/esql-core/src/main/java/org/elasticsearch/xpack/esql/core/expression/Expressions.java
@@ -132,8 +132,16 @@ public static String name(Expression e) {
         return e instanceof NamedExpression ne ? ne.name() : e.sourceText();
     }
 
-    public static boolean isNull(Expression e) {
-        return e.dataType() == DataType.NULL || (e.foldable() && e.fold() == null);
+    /**
+     * Is this {@linkplain Expression} <strong>guaranteed</strong> to have
+     * only the {@code null} value. {@linkplain Expression}s that
+     * {@link Expression#fold()} to {@code null} <strong>may</strong>
+     * return {@code false} here, but should <strong>eventually</strong> be folded
+     * into a {@link Literal} containing {@code null} which will return
+     * {@code true} from here.
+     */
+    public static boolean isGuaranteedNull(Expression e) {
+        return e.dataType() == DataType.NULL || (e instanceof Literal lit && lit.value() == null);
     }
 
     public static List<String> names(Collection<? extends Expression> e) {
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/In.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/In.java
index eda6aadccc86a..f6c23304c189b 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/In.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/predicate/operator/comparison/In.java
@@ -151,14 +151,14 @@ public Expression replaceChildren(List<Expression> newChildren) {
     public boolean foldable() {
         // QL's In fold()s to null, if value() is null, but isn't foldable() unless all children are
         // TODO: update this null check in QL too?
-        return Expressions.isNull(value)
+        return Expressions.isGuaranteedNull(value)
             || Expressions.foldable(children())
-            || (Expressions.foldable(list) && list.stream().allMatch(Expressions::isNull));
+            || (Expressions.foldable(list) && list.stream().allMatch(Expressions::isGuaranteedNull));
     }
 
     @Override
     public Object fold() {
-        if (Expressions.isNull(value) || list.stream().allMatch(Expressions::isNull)) {
+        if (Expressions.isGuaranteedNull(value) || list.stream().allMatch(Expressions::isGuaranteedNull)) {
             return null;
         }
         return super.fold();
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/FoldNull.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/FoldNull.java
index 638fa1b8db456..4f97bf60bd863 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/FoldNull.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/FoldNull.java
@@ -30,7 +30,7 @@ public Expression rule(Expression e) {
         // perform this early to prevent the rule from converting the null filter into nullifying the whole expression
         // P.S. this could be done inside the Aggregate but this place better centralizes the logic
         if (e instanceof AggregateFunction agg) {
-            if (Expressions.isNull(agg.filter())) {
+            if (Expressions.isGuaranteedNull(agg.filter())) {
                 return agg.withFilter(Literal.of(agg.filter(), false));
             }
         }
@@ -38,13 +38,13 @@ public Expression rule(Expression e) {
         if (result != e) {
             return result;
         } else if (e instanceof In in) {
-            if (Expressions.isNull(in.value())) {
+            if (Expressions.isGuaranteedNull(in.value())) {
                 return Literal.of(in, null);
             }
         } else if (e instanceof Alias == false
             && e.nullable() == Nullability.TRUE
             && e instanceof Categorize == false
-            && Expressions.anyMatch(e.children(), Expressions::isNull)) {
+            && Expressions.anyMatch(e.children(), Expressions::isGuaranteedNull)) {
                 return Literal.of(e, null);
             }
         return e;
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/PruneFilters.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/PruneFilters.java
index b6f7ac9e464f4..00698d009ea23 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/PruneFilters.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/PruneFilters.java
@@ -29,7 +29,7 @@ protected LogicalPlan rule(Filter filter) {
             if (TRUE.equals(condition)) {
                 return filter.child();
             }
-            if (FALSE.equals(condition) || Expressions.isNull(condition)) {
+            if (FALSE.equals(condition) || Expressions.isGuaranteedNull(condition)) {
                 return PruneEmptyPlans.skipPlan(filter);
             }
         }
@@ -42,8 +42,8 @@ protected LogicalPlan rule(Filter filter) {
 
     private static Expression foldBinaryLogic(BinaryLogic binaryLogic) {
         if (binaryLogic instanceof Or or) {
-            boolean nullLeft = Expressions.isNull(or.left());
-            boolean nullRight = Expressions.isNull(or.right());
+            boolean nullLeft = Expressions.isGuaranteedNull(or.left());
+            boolean nullRight = Expressions.isGuaranteedNull(or.right());
             if (nullLeft && nullRight) {
                 return new Literal(binaryLogic.source(), null, DataType.NULL);
             }
@@ -55,7 +55,7 @@ private static Expression foldBinaryLogic(BinaryLogic binaryLogic) {
             }
         }
         if (binaryLogic instanceof And and) {
-            if (Expressions.isNull(and.left()) || Expressions.isNull(and.right())) {
+            if (Expressions.isGuaranteedNull(and.left()) || Expressions.isGuaranteedNull(and.right())) {
                 return new Literal(binaryLogic.source(), null, DataType.NULL);
             }
         }
diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/SplitInWithFoldableValue.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/SplitInWithFoldableValue.java
index 930b485dbd374..9e9ae6a9a559d 100644
--- a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/SplitInWithFoldableValue.java
+++ b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/optimizer/rules/logical/SplitInWithFoldableValue.java
@@ -30,7 +30,7 @@ public Expression rule(In in) {
             List<Expression> foldables = new ArrayList<>(in.list().size());
             List<Expression> nonFoldables = new ArrayList<>(in.list().size());
             in.list().forEach(e -> {
-                if (e.foldable() && Expressions.isNull(e) == false) { // keep `null`s, needed for the 3VL
+                if (e.foldable() && Expressions.isGuaranteedNull(e) == false) { // keep `null`s, needed for the 3VL
                     foldables.add(e);
                 } else {
                     nonFoldables.add(e);
diff --git a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LogicalPlanOptimizerTests.java b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LogicalPlanOptimizerTests.java
index b76781f76f4af..c2a26845d4e88 100644
--- a/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LogicalPlanOptimizerTests.java
+++ b/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/optimizer/LogicalPlanOptimizerTests.java
@@ -4820,7 +4820,7 @@ private static boolean oneLeaveIsNull(Expression e) {
 
         e.forEachUp(node -> {
             if (node.children().size() == 0) {
-                result.set(result.get() || Expressions.isNull(node));
+                result.set(result.get() || Expressions.isGuaranteedNull(node));
             }
         });
 

From ab6fcc4e749ae575e6505498d18de19ce3db4ca2 Mon Sep 17 00:00:00 2001
From: Martijn van Groningen <martijn.v.groningen@gmail.com>
Date: Fri, 6 Dec 2024 18:50:04 +0100
Subject: [PATCH 089/119] Fix mocking in SyntheticSourceLicenseServiceTests
 (#118155)

Some mock verifies where missing and `LicenseState#copyCurrentLicenseState(...)` wasn't always mocked.

And because of incorrect mocking the testGoldOrPlatinumLicenseCustomCutoffDate() test had an incorrect assertion.
---
 .../SyntheticSourceLicenseServiceTests.java   | 22 ++++++++++++++-----
 1 file changed, 17 insertions(+), 5 deletions(-)

diff --git a/x-pack/plugin/logsdb/src/test/java/org/elasticsearch/xpack/logsdb/SyntheticSourceLicenseServiceTests.java b/x-pack/plugin/logsdb/src/test/java/org/elasticsearch/xpack/logsdb/SyntheticSourceLicenseServiceTests.java
index 90a13b16c028e..0eb0d21ff2e78 100644
--- a/x-pack/plugin/logsdb/src/test/java/org/elasticsearch/xpack/logsdb/SyntheticSourceLicenseServiceTests.java
+++ b/x-pack/plugin/logsdb/src/test/java/org/elasticsearch/xpack/logsdb/SyntheticSourceLicenseServiceTests.java
@@ -41,6 +41,7 @@ public void setup() throws Exception {
 
     public void testLicenseAllowsSyntheticSource() {
         MockLicenseState licenseState = MockLicenseState.createMock();
+        when(licenseState.copyCurrentLicenseState()).thenReturn(licenseState);
         when(licenseState.isAllowed(same(SyntheticSourceLicenseService.SYNTHETIC_SOURCE_FEATURE))).thenReturn(true);
         licenseService.setLicenseState(licenseState);
         licenseService.setLicenseService(mockLicenseService);
@@ -53,6 +54,7 @@ public void testLicenseAllowsSyntheticSource() {
 
     public void testLicenseAllowsSyntheticSourceTemplateValidation() {
         MockLicenseState licenseState = MockLicenseState.createMock();
+        when(licenseState.copyCurrentLicenseState()).thenReturn(licenseState);
         when(licenseState.isAllowed(same(SyntheticSourceLicenseService.SYNTHETIC_SOURCE_FEATURE))).thenReturn(true);
         licenseService.setLicenseState(licenseState);
         licenseService.setLicenseService(mockLicenseService);
@@ -65,6 +67,7 @@ public void testLicenseAllowsSyntheticSourceTemplateValidation() {
 
     public void testDefaultDisallow() {
         MockLicenseState licenseState = MockLicenseState.createMock();
+        when(licenseState.copyCurrentLicenseState()).thenReturn(licenseState);
         when(licenseState.isAllowed(same(SyntheticSourceLicenseService.SYNTHETIC_SOURCE_FEATURE))).thenReturn(false);
         licenseService.setLicenseState(licenseState);
         licenseService.setLicenseService(mockLicenseService);
@@ -77,6 +80,7 @@ public void testDefaultDisallow() {
 
     public void testFallback() {
         MockLicenseState licenseState = MockLicenseState.createMock();
+        when(licenseState.copyCurrentLicenseState()).thenReturn(licenseState);
         when(licenseState.isAllowed(same(SyntheticSourceLicenseService.SYNTHETIC_SOURCE_FEATURE))).thenReturn(true);
         licenseService.setLicenseState(licenseState);
         licenseService.setLicenseService(mockLicenseService);
@@ -95,6 +99,7 @@ public void testGoldOrPlatinumLicense() throws Exception {
         when(mockLicenseService.getLicense()).thenReturn(license);
 
         MockLicenseState licenseState = MockLicenseState.createMock();
+        when(licenseState.copyCurrentLicenseState()).thenReturn(licenseState);
         when(licenseState.getOperationMode()).thenReturn(license.operationMode());
         when(licenseState.isAllowed(same(SyntheticSourceLicenseService.SYNTHETIC_SOURCE_FEATURE_LEGACY))).thenReturn(true);
         licenseService.setLicenseState(licenseState);
@@ -103,6 +108,8 @@ public void testGoldOrPlatinumLicense() throws Exception {
             "legacy licensed usage is allowed, so not fallback to stored source",
             licenseService.fallbackToStoredSource(false, true)
         );
+        Mockito.verify(licenseState, Mockito.times(1)).isAllowed(same(SyntheticSourceLicenseService.SYNTHETIC_SOURCE_FEATURE));
+        Mockito.verify(licenseState, Mockito.times(1)).isAllowed(same(SyntheticSourceLicenseService.SYNTHETIC_SOURCE_FEATURE_LEGACY));
         Mockito.verify(licenseState, Mockito.times(1)).featureUsed(any());
     }
 
@@ -112,6 +119,7 @@ public void testGoldOrPlatinumLicenseLegacyLicenseNotAllowed() throws Exception
         when(mockLicenseService.getLicense()).thenReturn(license);
 
         MockLicenseState licenseState = MockLicenseState.createMock();
+        when(licenseState.copyCurrentLicenseState()).thenReturn(licenseState);
         when(licenseState.getOperationMode()).thenReturn(license.operationMode());
         when(licenseState.isAllowed(same(SyntheticSourceLicenseService.SYNTHETIC_SOURCE_FEATURE))).thenReturn(false);
         licenseService.setLicenseState(licenseState);
@@ -125,14 +133,16 @@ public void testGoldOrPlatinumLicenseLegacyLicenseNotAllowed() throws Exception
     }
 
     public void testGoldOrPlatinumLicenseBeyondCutoffDate() throws Exception {
-        long start = LocalDateTime.of(2025, 1, 1, 0, 0).toInstant(ZoneOffset.UTC).toEpochMilli();
+        long start = LocalDateTime.of(2025, 2, 5, 0, 0).toInstant(ZoneOffset.UTC).toEpochMilli();
         License license = createGoldOrPlatinumLicense(start);
         mockLicenseService = mock(LicenseService.class);
         when(mockLicenseService.getLicense()).thenReturn(license);
 
         MockLicenseState licenseState = MockLicenseState.createMock();
+        when(licenseState.copyCurrentLicenseState()).thenReturn(licenseState);
         when(licenseState.getOperationMode()).thenReturn(license.operationMode());
         when(licenseState.isAllowed(same(SyntheticSourceLicenseService.SYNTHETIC_SOURCE_FEATURE))).thenReturn(false);
+        when(licenseState.isAllowed(same(SyntheticSourceLicenseService.SYNTHETIC_SOURCE_FEATURE_LEGACY))).thenReturn(true);
         licenseService.setLicenseState(licenseState);
         licenseService.setLicenseService(mockLicenseService);
         assertTrue("beyond cutoff date, so fallback to stored source", licenseService.fallbackToStoredSource(false, true));
@@ -143,19 +153,21 @@ public void testGoldOrPlatinumLicenseBeyondCutoffDate() throws Exception {
     public void testGoldOrPlatinumLicenseCustomCutoffDate() throws Exception {
         licenseService = new SyntheticSourceLicenseService(Settings.EMPTY, "2025-01-02T00:00");
 
-        long start = LocalDateTime.of(2025, 1, 1, 0, 0).toInstant(ZoneOffset.UTC).toEpochMilli();
+        long start = LocalDateTime.of(2025, 1, 3, 0, 0).toInstant(ZoneOffset.UTC).toEpochMilli();
         License license = createGoldOrPlatinumLicense(start);
         mockLicenseService = mock(LicenseService.class);
         when(mockLicenseService.getLicense()).thenReturn(license);
 
         MockLicenseState licenseState = MockLicenseState.createMock();
+        when(licenseState.copyCurrentLicenseState()).thenReturn(licenseState);
         when(licenseState.getOperationMode()).thenReturn(license.operationMode());
+        when(licenseState.isAllowed(same(SyntheticSourceLicenseService.SYNTHETIC_SOURCE_FEATURE))).thenReturn(false);
         when(licenseState.isAllowed(same(SyntheticSourceLicenseService.SYNTHETIC_SOURCE_FEATURE_LEGACY))).thenReturn(true);
         licenseService.setLicenseState(licenseState);
         licenseService.setLicenseService(mockLicenseService);
-        assertFalse("custom cutoff date, so fallback to stored source", licenseService.fallbackToStoredSource(false, true));
-        Mockito.verify(licenseState, Mockito.times(1)).featureUsed(any());
-        Mockito.verify(licenseState, Mockito.times(1)).isAllowed(same(SyntheticSourceLicenseService.SYNTHETIC_SOURCE_FEATURE_LEGACY));
+        assertTrue("custom cutoff date, so fallback to stored source", licenseService.fallbackToStoredSource(false, true));
+        Mockito.verify(licenseState, Mockito.times(1)).isAllowed(same(SyntheticSourceLicenseService.SYNTHETIC_SOURCE_FEATURE));
+        Mockito.verify(licenseState, Mockito.never()).featureUsed(any());
     }
 
     static License createEnterpriseLicense() throws Exception {

From 27aac9654d0b226ac5988f635858ae6404a75cda Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Sat, 7 Dec 2024 05:19:17 +1100
Subject: [PATCH 090/119] Mute
 org.elasticsearch.xpack.inference.DefaultEndPointsIT
 testInferDeploysDefaultRerank #118184

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 8f1030279efc9..887b462fa122e 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -266,6 +266,9 @@ tests:
 - class: org.elasticsearch.packaging.test.DebPreservationTests
   method: test40RestartOnUpgrade
   issue: https://github.com/elastic/elasticsearch/issues/118170
+- class: org.elasticsearch.xpack.inference.DefaultEndPointsIT
+  method: testInferDeploysDefaultRerank
+  issue: https://github.com/elastic/elasticsearch/issues/118184
 
 # Examples:
 #

From c580024ea92fd561089380eb4078f576c47b72b9 Mon Sep 17 00:00:00 2001
From: Jim Ferenczi <jim.ferenczi@elastic.co>
Date: Fri, 6 Dec 2024 18:42:50 +0000
Subject: [PATCH 091/119] Add Highlighter for Semantic Text Fields (#118064)

This PR introduces a new highlighter, `semantic`, tailored for semantic text fields.
It extracts the most relevant fragments by scoring nested chunks using the original semantic query.

In this initial version, the highlighter returns only the original chunks computed during ingestion. However, this is an implementation detail, and future enhancements could combine multiple chunks to generate the fragments.
---
 docs/changelog/118064.yaml                    |   5 +
 .../mapping/types/semantic-text.asciidoc      |  55 +--
 .../xpack/inference/InferenceFeatures.java    |   5 +-
 .../xpack/inference/InferencePlugin.java      |   7 +
 .../highlight/SemanticTextHighlighter.java    | 226 +++++++++
 .../inference/mapper/SemanticTextField.java   |   2 +-
 .../mapper/SemanticTextFieldMapper.java       |  20 +-
 .../SemanticTextHighlighterTests.java         | 288 +++++++++++
 .../mapper/SemanticTextFieldMapperTests.java  |   8 +-
 .../queries/SemanticQueryBuilderTests.java    |  10 +-
 .../xpack/inference/highlight/mappings.json   |  27 +
 .../xpack/inference/highlight/queries.json    | 467 ++++++++++++++++++
 .../inference/highlight/sample-doc.json.gz    | Bin 0 -> 388098 bytes
 .../90_semantic_text_highlighter.yml          | 242 +++++++++
 14 files changed, 1314 insertions(+), 48 deletions(-)
 create mode 100644 docs/changelog/118064.yaml
 create mode 100644 x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/highlight/SemanticTextHighlighter.java
 create mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/highlight/SemanticTextHighlighterTests.java
 create mode 100644 x-pack/plugin/inference/src/test/resources/org/elasticsearch/xpack/inference/highlight/mappings.json
 create mode 100644 x-pack/plugin/inference/src/test/resources/org/elasticsearch/xpack/inference/highlight/queries.json
 create mode 100644 x-pack/plugin/inference/src/test/resources/org/elasticsearch/xpack/inference/highlight/sample-doc.json.gz
 create mode 100644 x-pack/plugin/inference/src/yamlRestTest/resources/rest-api-spec/test/inference/90_semantic_text_highlighter.yml

diff --git a/docs/changelog/118064.yaml b/docs/changelog/118064.yaml
new file mode 100644
index 0000000000000..7d12f365bf142
--- /dev/null
+++ b/docs/changelog/118064.yaml
@@ -0,0 +1,5 @@
+pr: 118064
+summary: Add Highlighter for Semantic Text Fields
+area: Highlighting
+type: feature
+issues: []
diff --git a/docs/reference/mapping/types/semantic-text.asciidoc b/docs/reference/mapping/types/semantic-text.asciidoc
index f76a9352c2fe8..b3e103ec6dbd9 100644
--- a/docs/reference/mapping/types/semantic-text.asciidoc
+++ b/docs/reference/mapping/types/semantic-text.asciidoc
@@ -112,50 +112,43 @@ Trying to <<delete-inference-api,delete an {infer} endpoint>> that is used on a
 {infer-cap} endpoints have a limit on the amount of text they can process.
 To allow for large amounts of text to be used in semantic search, `semantic_text` automatically generates smaller passages if needed, called _chunks_.
 
-Each chunk will include the text subpassage and the corresponding embedding generated from it.
+Each chunk refers to a passage of the text and the corresponding embedding generated from it.
 When querying, the individual passages will be automatically searched for each document, and the most relevant passage will be used to compute a score.
 
 For more details on chunking and how to configure chunking settings, see <<infer-chunking-config, Configuring chunking>> in the Inference API documentation.
 
+Refer to <<semantic-search-semantic-text,this tutorial>> to learn more about
+semantic search using `semantic_text` and the `semantic` query.
 
 [discrete]
-[[semantic-text-structure]]
-==== `semantic_text` structure
+[[semantic-text-highlighting]]
+==== Extracting Relevant Fragments from Semantic Text
 
-Once a document is ingested, a `semantic_text` field will have the following structure:
+You can extract the most relevant fragments from a semantic text field by using the <<highlighting,highlight parameter>> in the <<search-search-api-request-body,Search API>>.
 
-[source,console-result]
+[source,console]
 ------------------------------------------------------------
-"inference_field": {
-  "text": "these are not the droids you're looking for", <1>
-  "inference": {
-    "inference_id": "my-elser-endpoint", <2>
-    "model_settings": { <3>
-      "task_type": "sparse_embedding"
+PUT test-index
+{
+    "query": {
+        "semantic": {
+            "field": "my_semantic_field"
+        }
     },
-    "chunks": [ <4>
-      {
-        "text": "these are not the droids you're looking for",
-        "embeddings": {
-          (...)
+    "highlight": {
+        "fields": {
+            "my_semantic_field": {
+                "type": "semantic",
+                "number_of_fragments": 2,  <1>
+                "order": "score"           <2>
+            }
         }
-      }
-    ]
-  }
+    }
 }
 ------------------------------------------------------------
-// TEST[skip:TBD]
-<1> The field will become an object structure to accommodate both the original
-text and the inference results.
-<2> The `inference_id` used to generate the embeddings.
-<3> Model settings, including the task type and dimensions/similarity if
-applicable.
-<4> Inference results will be grouped in chunks, each with its corresponding
-text and embeddings.
-
-Refer to <<semantic-search-semantic-text,this tutorial>> to learn more about
-semantic search using `semantic_text` and the `semantic` query.
-
+// TEST[skip:Requires inference endpoint]
+<1> Specifies the maximum number of fragments to return.
+<2> Sorts highlighted fragments by score when set to `score`. By default, fragments will be output in the order they appear in the field (order: none).
 
 [discrete]
 [[custom-indexing]]
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceFeatures.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceFeatures.java
index c82f287792a7c..67892dfe78624 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceFeatures.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceFeatures.java
@@ -33,6 +33,8 @@ public Set<NodeFeature> getFeatures() {
         );
     }
 
+    private static final NodeFeature SEMANTIC_TEXT_HIGHLIGHTER = new NodeFeature("semantic_text.highlighter");
+
     @Override
     public Set<NodeFeature> getTestFeatures() {
         return Set.of(
@@ -40,7 +42,8 @@ public Set<NodeFeature> getTestFeatures() {
             SemanticTextFieldMapper.SEMANTIC_TEXT_SINGLE_FIELD_UPDATE_FIX,
             SemanticTextFieldMapper.SEMANTIC_TEXT_DELETE_FIX,
             SemanticTextFieldMapper.SEMANTIC_TEXT_ZERO_SIZE_FIX,
-            SemanticTextFieldMapper.SEMANTIC_TEXT_ALWAYS_EMIT_INFERENCE_ID_FIX
+            SemanticTextFieldMapper.SEMANTIC_TEXT_ALWAYS_EMIT_INFERENCE_ID_FIX,
+            SEMANTIC_TEXT_HIGHLIGHTER
         );
     }
 }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
index 3c14e51a3c2d4..d7d623ab20143 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
@@ -37,6 +37,7 @@
 import org.elasticsearch.plugins.SystemIndexPlugin;
 import org.elasticsearch.rest.RestController;
 import org.elasticsearch.rest.RestHandler;
+import org.elasticsearch.search.fetch.subphase.highlight.Highlighter;
 import org.elasticsearch.search.rank.RankBuilder;
 import org.elasticsearch.search.rank.RankDoc;
 import org.elasticsearch.threadpool.ExecutorBuilder;
@@ -67,6 +68,7 @@
 import org.elasticsearch.xpack.inference.external.http.retry.RetrySettings;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.RequestExecutorServiceSettings;
+import org.elasticsearch.xpack.inference.highlight.SemanticTextHighlighter;
 import org.elasticsearch.xpack.inference.logging.ThrottlerManager;
 import org.elasticsearch.xpack.inference.mapper.OffsetSourceFieldMapper;
 import org.elasticsearch.xpack.inference.mapper.SemanticTextFieldMapper;
@@ -417,4 +419,9 @@ public List<RetrieverSpec<?>> getRetrievers() {
             new RetrieverSpec<>(new ParseField(RandomRankBuilder.NAME), RandomRankRetrieverBuilder::fromXContent)
         );
     }
+
+    @Override
+    public Map<String, Highlighter> getHighlighters() {
+        return Map.of(SemanticTextHighlighter.NAME, new SemanticTextHighlighter());
+    }
 }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/highlight/SemanticTextHighlighter.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/highlight/SemanticTextHighlighter.java
new file mode 100644
index 0000000000000..f2bfa72ec617a
--- /dev/null
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/highlight/SemanticTextHighlighter.java
@@ -0,0 +1,226 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.highlight;
+
+import org.apache.lucene.index.LeafReader;
+import org.apache.lucene.index.Term;
+import org.apache.lucene.search.BooleanClause;
+import org.apache.lucene.search.BooleanQuery;
+import org.apache.lucene.search.DocIdSetIterator;
+import org.apache.lucene.search.IndexSearcher;
+import org.apache.lucene.search.KnnByteVectorQuery;
+import org.apache.lucene.search.KnnFloatVectorQuery;
+import org.apache.lucene.search.Query;
+import org.apache.lucene.search.QueryVisitor;
+import org.apache.lucene.search.ScoreMode;
+import org.apache.lucene.search.Scorer;
+import org.apache.lucene.search.Weight;
+import org.elasticsearch.common.text.Text;
+import org.elasticsearch.common.xcontent.support.XContentMapValues;
+import org.elasticsearch.index.mapper.MappedFieldType;
+import org.elasticsearch.index.mapper.vectors.DenseVectorFieldMapper.DenseVectorFieldType;
+import org.elasticsearch.index.mapper.vectors.SparseVectorFieldMapper.SparseVectorFieldType;
+import org.elasticsearch.index.query.SearchExecutionContext;
+import org.elasticsearch.search.fetch.subphase.highlight.FieldHighlightContext;
+import org.elasticsearch.search.fetch.subphase.highlight.HighlightField;
+import org.elasticsearch.search.fetch.subphase.highlight.Highlighter;
+import org.elasticsearch.search.vectors.VectorData;
+import org.elasticsearch.xpack.core.ml.search.SparseVectorQueryWrapper;
+import org.elasticsearch.xpack.inference.mapper.SemanticTextField;
+import org.elasticsearch.xpack.inference.mapper.SemanticTextFieldMapper;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Comparator;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+
+/**
+ * A {@link Highlighter} designed for the {@link SemanticTextFieldMapper}.
+ * This highlighter extracts semantic queries and evaluates them against each chunk produced by the semantic text field.
+ * It returns the top-scoring chunks as snippets, optionally sorted by their scores.
+ */
+public class SemanticTextHighlighter implements Highlighter {
+    public static final String NAME = "semantic";
+
+    private record OffsetAndScore(int offset, float score) {}
+
+    @Override
+    public boolean canHighlight(MappedFieldType fieldType) {
+        if (fieldType instanceof SemanticTextFieldMapper.SemanticTextFieldType) {
+            return true;
+        }
+        return false;
+    }
+
+    @Override
+    public HighlightField highlight(FieldHighlightContext fieldContext) throws IOException {
+        SemanticTextFieldMapper.SemanticTextFieldType fieldType = (SemanticTextFieldMapper.SemanticTextFieldType) fieldContext.fieldType;
+        if (fieldType.getEmbeddingsField() == null) {
+            // nothing indexed yet
+            return null;
+        }
+
+        final List<Query> queries = switch (fieldType.getModelSettings().taskType()) {
+            case SPARSE_EMBEDDING -> extractSparseVectorQueries(
+                (SparseVectorFieldType) fieldType.getEmbeddingsField().fieldType(),
+                fieldContext.query
+            );
+            case TEXT_EMBEDDING -> extractDenseVectorQueries(
+                (DenseVectorFieldType) fieldType.getEmbeddingsField().fieldType(),
+                fieldContext.query
+            );
+            default -> throw new IllegalStateException(
+                "Wrong task type for a semantic text field, got [" + fieldType.getModelSettings().taskType().name() + "]"
+            );
+        };
+        if (queries.isEmpty()) {
+            // nothing to highlight
+            return null;
+        }
+
+        int numberOfFragments = fieldContext.field.fieldOptions().numberOfFragments() <= 0
+            ? 1 // we return the best fragment by default
+            : fieldContext.field.fieldOptions().numberOfFragments();
+
+        List<OffsetAndScore> chunks = extractOffsetAndScores(
+            fieldContext.context.getSearchExecutionContext(),
+            fieldContext.hitContext.reader(),
+            fieldType,
+            fieldContext.hitContext.docId(),
+            queries
+        );
+        if (chunks.size() == 0) {
+            return null;
+        }
+
+        chunks.sort(Comparator.comparingDouble(OffsetAndScore::score).reversed());
+        int size = Math.min(chunks.size(), numberOfFragments);
+        if (fieldContext.field.fieldOptions().scoreOrdered() == false) {
+            chunks = chunks.subList(0, size);
+            chunks.sort(Comparator.comparingInt(c -> c.offset));
+        }
+        Text[] snippets = new Text[size];
+        List<Map<?, ?>> nestedSources = XContentMapValues.extractNestedSources(
+            fieldType.getChunksField().fullPath(),
+            fieldContext.hitContext.source().source()
+        );
+        for (int i = 0; i < size; i++) {
+            var chunk = chunks.get(i);
+            if (nestedSources.size() <= chunk.offset) {
+                throw new IllegalStateException(
+                    String.format(
+                        Locale.ROOT,
+                        "Invalid content detected for field [%s]: the chunks size is [%d], "
+                            + "but a reference to offset [%d] was found in the result.",
+                        fieldType.name(),
+                        nestedSources.size(),
+                        chunk.offset
+                    )
+                );
+            }
+            String content = (String) nestedSources.get(chunk.offset).get(SemanticTextField.CHUNKED_TEXT_FIELD);
+            if (content == null) {
+                throw new IllegalStateException(
+                    String.format(
+                        Locale.ROOT,
+
+                        "Invalid content detected for field [%s]: missing text for the chunk at offset [%d].",
+                        fieldType.name(),
+                        chunk.offset
+                    )
+                );
+            }
+            snippets[i] = new Text(content);
+        }
+        return new HighlightField(fieldContext.fieldName, snippets);
+    }
+
+    private List<OffsetAndScore> extractOffsetAndScores(
+        SearchExecutionContext context,
+        LeafReader reader,
+        SemanticTextFieldMapper.SemanticTextFieldType fieldType,
+        int docId,
+        List<Query> leafQueries
+    ) throws IOException {
+        var bitSet = context.bitsetFilter(fieldType.getChunksField().parentTypeFilter()).getBitSet(reader.getContext());
+        int previousParent = docId > 0 ? bitSet.prevSetBit(docId - 1) : -1;
+
+        BooleanQuery.Builder bq = new BooleanQuery.Builder().add(fieldType.getChunksField().nestedTypeFilter(), BooleanClause.Occur.FILTER);
+        leafQueries.stream().forEach(q -> bq.add(q, BooleanClause.Occur.SHOULD));
+        Weight weight = new IndexSearcher(reader).createWeight(bq.build(), ScoreMode.COMPLETE, 1);
+        Scorer scorer = weight.scorer(reader.getContext());
+        if (previousParent != -1) {
+            if (scorer.iterator().advance(previousParent) == DocIdSetIterator.NO_MORE_DOCS) {
+                return List.of();
+            }
+        } else if (scorer.iterator().nextDoc() == DocIdSetIterator.NO_MORE_DOCS) {
+            return List.of();
+        }
+        List<OffsetAndScore> results = new ArrayList<>();
+        int offset = 0;
+        while (scorer.docID() < docId) {
+            results.add(new OffsetAndScore(offset++, scorer.score()));
+            if (scorer.iterator().nextDoc() == DocIdSetIterator.NO_MORE_DOCS) {
+                break;
+            }
+        }
+        return results;
+    }
+
+    private List<Query> extractDenseVectorQueries(DenseVectorFieldType fieldType, Query querySection) {
+        // TODO: Handle knn section when semantic text field can be used.
+        List<Query> queries = new ArrayList<>();
+        querySection.visit(new QueryVisitor() {
+            @Override
+            public boolean acceptField(String field) {
+                return fieldType.name().equals(field);
+            }
+
+            @Override
+            public void consumeTerms(Query query, Term... terms) {
+                super.consumeTerms(query, terms);
+            }
+
+            @Override
+            public void visitLeaf(Query query) {
+                if (query instanceof KnnFloatVectorQuery knnQuery) {
+                    queries.add(fieldType.createExactKnnQuery(VectorData.fromFloats(knnQuery.getTargetCopy()), null));
+                } else if (query instanceof KnnByteVectorQuery knnQuery) {
+                    queries.add(fieldType.createExactKnnQuery(VectorData.fromBytes(knnQuery.getTargetCopy()), null));
+                }
+            }
+        });
+        return queries;
+    }
+
+    private List<Query> extractSparseVectorQueries(SparseVectorFieldType fieldType, Query querySection) {
+        List<Query> queries = new ArrayList<>();
+        querySection.visit(new QueryVisitor() {
+            @Override
+            public boolean acceptField(String field) {
+                return fieldType.name().equals(field);
+            }
+
+            @Override
+            public void consumeTerms(Query query, Term... terms) {
+                super.consumeTerms(query, terms);
+            }
+
+            @Override
+            public QueryVisitor getSubVisitor(BooleanClause.Occur occur, Query parent) {
+                if (parent instanceof SparseVectorQueryWrapper sparseVectorQuery) {
+                    queries.add(sparseVectorQuery.getTermsQuery());
+                }
+                return this;
+            }
+        });
+        return queries;
+    }
+}
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/mapper/SemanticTextField.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/mapper/SemanticTextField.java
index e60e95b58770f..0f26f6577860f 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/mapper/SemanticTextField.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/mapper/SemanticTextField.java
@@ -61,7 +61,7 @@ public record SemanticTextField(String fieldName, List<String> originalValues, I
     static final String SEARCH_INFERENCE_ID_FIELD = "search_inference_id";
     static final String CHUNKS_FIELD = "chunks";
     static final String CHUNKED_EMBEDDINGS_FIELD = "embeddings";
-    static final String CHUNKED_TEXT_FIELD = "text";
+    public static final String CHUNKED_TEXT_FIELD = "text";
     static final String MODEL_SETTINGS_FIELD = "model_settings";
     static final String TASK_TYPE_FIELD = "task_type";
     static final String DIMENSIONS_FIELD = "dimensions";
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/mapper/SemanticTextFieldMapper.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/mapper/SemanticTextFieldMapper.java
index 3744bf2a6dbed..683bb5a53028b 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/mapper/SemanticTextFieldMapper.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/mapper/SemanticTextFieldMapper.java
@@ -46,7 +46,6 @@
 import org.elasticsearch.index.query.MatchNoneQueryBuilder;
 import org.elasticsearch.index.query.NestedQueryBuilder;
 import org.elasticsearch.index.query.QueryBuilder;
-import org.elasticsearch.index.query.QueryBuilders;
 import org.elasticsearch.index.query.SearchExecutionContext;
 import org.elasticsearch.inference.InferenceResults;
 import org.elasticsearch.inference.SimilarityMeasure;
@@ -57,6 +56,7 @@
 import org.elasticsearch.xcontent.XContentParserConfiguration;
 import org.elasticsearch.xpack.core.ml.inference.results.MlTextEmbeddingResults;
 import org.elasticsearch.xpack.core.ml.inference.results.TextExpansionResults;
+import org.elasticsearch.xpack.core.ml.search.SparseVectorQueryBuilder;
 
 import java.io.IOException;
 import java.util.ArrayList;
@@ -529,17 +529,15 @@ public QueryBuilder semanticQuery(InferenceResults inferenceResults, Integer req
                             );
                         }
 
-                        // TODO: Use WeightedTokensQueryBuilder
                         TextExpansionResults textExpansionResults = (TextExpansionResults) inferenceResults;
-                        var boolQuery = QueryBuilders.boolQuery();
-                        for (var weightedToken : textExpansionResults.getWeightedTokens()) {
-                            boolQuery.should(
-                                QueryBuilders.termQuery(inferenceResultsFieldName, weightedToken.token()).boost(weightedToken.weight())
-                            );
-                        }
-                        boolQuery.minimumShouldMatch(1);
-
-                        yield boolQuery;
+                        yield new SparseVectorQueryBuilder(
+                            inferenceResultsFieldName,
+                            textExpansionResults.getWeightedTokens(),
+                            null,
+                            null,
+                            null,
+                            null
+                        );
                     }
                     case TEXT_EMBEDDING -> {
                         if (inferenceResults instanceof MlTextEmbeddingResults == false) {
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/highlight/SemanticTextHighlighterTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/highlight/SemanticTextHighlighterTests.java
new file mode 100644
index 0000000000000..7dc4d99e06acc
--- /dev/null
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/highlight/SemanticTextHighlighterTests.java
@@ -0,0 +1,288 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.highlight;
+
+import org.apache.lucene.analysis.standard.StandardAnalyzer;
+import org.apache.lucene.index.DirectoryReader;
+import org.apache.lucene.index.IndexWriterConfig;
+import org.apache.lucene.search.IndexSearcher;
+import org.apache.lucene.search.Sort;
+import org.apache.lucene.search.TopDocs;
+import org.apache.lucene.search.join.ScoreMode;
+import org.apache.lucene.store.Directory;
+import org.apache.lucene.tests.index.RandomIndexWriter;
+import org.apache.lucene.util.BytesRef;
+import org.elasticsearch.action.OriginalIndices;
+import org.elasticsearch.action.search.SearchRequest;
+import org.elasticsearch.common.bytes.BytesArray;
+import org.elasticsearch.common.bytes.BytesReference;
+import org.elasticsearch.common.io.Streams;
+import org.elasticsearch.common.lucene.search.Queries;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.xcontent.XContentHelper;
+import org.elasticsearch.index.IndexVersion;
+import org.elasticsearch.index.mapper.MapperService;
+import org.elasticsearch.index.mapper.MapperServiceTestCase;
+import org.elasticsearch.index.mapper.SourceToParse;
+import org.elasticsearch.index.query.NestedQueryBuilder;
+import org.elasticsearch.index.query.QueryBuilder;
+import org.elasticsearch.index.shard.ShardId;
+import org.elasticsearch.plugins.Plugin;
+import org.elasticsearch.search.SearchHit;
+import org.elasticsearch.search.builder.SearchSourceBuilder;
+import org.elasticsearch.search.fetch.FetchContext;
+import org.elasticsearch.search.fetch.FetchSubPhase;
+import org.elasticsearch.search.fetch.subphase.highlight.FieldHighlightContext;
+import org.elasticsearch.search.fetch.subphase.highlight.HighlightBuilder;
+import org.elasticsearch.search.fetch.subphase.highlight.SearchHighlightContext;
+import org.elasticsearch.search.internal.AliasFilter;
+import org.elasticsearch.search.internal.ShardSearchRequest;
+import org.elasticsearch.search.lookup.Source;
+import org.elasticsearch.search.rank.RankDoc;
+import org.elasticsearch.search.vectors.KnnVectorQueryBuilder;
+import org.elasticsearch.xcontent.XContentType;
+import org.elasticsearch.xpack.core.ml.search.SparseVectorQueryBuilder;
+import org.elasticsearch.xpack.core.ml.search.WeightedToken;
+import org.elasticsearch.xpack.inference.InferencePlugin;
+import org.elasticsearch.xpack.inference.mapper.SemanticTextFieldMapper;
+import org.junit.Before;
+import org.mockito.Mockito;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.zip.GZIPInputStream;
+
+import static org.hamcrest.CoreMatchers.equalTo;
+import static org.mockito.Mockito.mock;
+
+public class SemanticTextHighlighterTests extends MapperServiceTestCase {
+    private static final String SEMANTIC_FIELD_E5 = "body-e5";
+    private static final String SEMANTIC_FIELD_ELSER = "body-elser";
+
+    private Map<String, Object> queries;
+
+    @Override
+    protected Collection<? extends Plugin> getPlugins() {
+        return List.of(new InferencePlugin(Settings.EMPTY));
+    }
+
+    @Override
+    @Before
+    public void setUp() throws Exception {
+        super.setUp();
+        var input = Streams.readFully(SemanticTextHighlighterTests.class.getResourceAsStream("queries.json"));
+        this.queries = XContentHelper.convertToMap(input, false, XContentType.JSON).v2();
+    }
+
+    @SuppressWarnings("unchecked")
+    public void testDenseVector() throws Exception {
+        var mapperService = createDefaultMapperService();
+        Map<String, Object> queryMap = (Map<String, Object>) queries.get("dense_vector_1");
+        float[] vector = readDenseVector(queryMap.get("embeddings"));
+        var fieldType = (SemanticTextFieldMapper.SemanticTextFieldType) mapperService.mappingLookup().getFieldType(SEMANTIC_FIELD_E5);
+        KnnVectorQueryBuilder knnQuery = new KnnVectorQueryBuilder(fieldType.getEmbeddingsField().fullPath(), vector, 10, 10, null);
+        NestedQueryBuilder nestedQueryBuilder = new NestedQueryBuilder(fieldType.getChunksField().fullPath(), knnQuery, ScoreMode.Max);
+        var shardRequest = createShardSearchRequest(nestedQueryBuilder);
+        var sourceToParse = new SourceToParse("0", readSampleDoc("sample-doc.json.gz"), XContentType.JSON);
+
+        String[] expectedScorePassages = ((List<String>) queryMap.get("expected_by_score")).toArray(String[]::new);
+        for (int i = 0; i < expectedScorePassages.length; i++) {
+            assertHighlightOneDoc(
+                mapperService,
+                shardRequest,
+                sourceToParse,
+                SEMANTIC_FIELD_E5,
+                i + 1,
+                HighlightBuilder.Order.SCORE,
+                Arrays.copyOfRange(expectedScorePassages, 0, i + 1)
+            );
+        }
+
+        String[] expectedOffsetPassages = ((List<String>) queryMap.get("expected_by_offset")).toArray(String[]::new);
+        assertHighlightOneDoc(
+            mapperService,
+            shardRequest,
+            sourceToParse,
+            SEMANTIC_FIELD_E5,
+            expectedOffsetPassages.length,
+            HighlightBuilder.Order.NONE,
+            expectedOffsetPassages
+        );
+    }
+
+    @SuppressWarnings("unchecked")
+    public void testSparseVector() throws Exception {
+        var mapperService = createDefaultMapperService();
+        Map<String, Object> queryMap = (Map<String, Object>) queries.get("sparse_vector_1");
+        List<WeightedToken> tokens = readSparseVector(queryMap.get("embeddings"));
+        var fieldType = (SemanticTextFieldMapper.SemanticTextFieldType) mapperService.mappingLookup().getFieldType(SEMANTIC_FIELD_ELSER);
+        SparseVectorQueryBuilder sparseQuery = new SparseVectorQueryBuilder(
+            fieldType.getEmbeddingsField().fullPath(),
+            tokens,
+            null,
+            null,
+            null,
+            null
+        );
+        NestedQueryBuilder nestedQueryBuilder = new NestedQueryBuilder(fieldType.getChunksField().fullPath(), sparseQuery, ScoreMode.Max);
+        var shardRequest = createShardSearchRequest(nestedQueryBuilder);
+        var sourceToParse = new SourceToParse("0", readSampleDoc("sample-doc.json.gz"), XContentType.JSON);
+
+        String[] expectedScorePassages = ((List<String>) queryMap.get("expected_by_score")).toArray(String[]::new);
+        for (int i = 0; i < expectedScorePassages.length; i++) {
+            assertHighlightOneDoc(
+                mapperService,
+                shardRequest,
+                sourceToParse,
+                SEMANTIC_FIELD_ELSER,
+                i + 1,
+                HighlightBuilder.Order.SCORE,
+                Arrays.copyOfRange(expectedScorePassages, 0, i + 1)
+            );
+        }
+
+        String[] expectedOffsetPassages = ((List<String>) queryMap.get("expected_by_offset")).toArray(String[]::new);
+        assertHighlightOneDoc(
+            mapperService,
+            shardRequest,
+            sourceToParse,
+            SEMANTIC_FIELD_ELSER,
+            expectedOffsetPassages.length,
+            HighlightBuilder.Order.NONE,
+            expectedOffsetPassages
+        );
+    }
+
+    private MapperService createDefaultMapperService() throws IOException {
+        var mappings = Streams.readFully(SemanticTextHighlighterTests.class.getResourceAsStream("mappings.json"));
+        return createMapperService(mappings.utf8ToString());
+    }
+
+    private float[] readDenseVector(Object value) {
+        if (value instanceof List<?> lst) {
+            float[] res = new float[lst.size()];
+            int pos = 0;
+            for (var obj : lst) {
+                if (obj instanceof Number number) {
+                    res[pos++] = number.floatValue();
+                } else {
+                    throw new IllegalArgumentException("Expected number, got " + obj.getClass().getSimpleName());
+                }
+            }
+            return res;
+        }
+        throw new IllegalArgumentException("Expected list, got " + value.getClass().getSimpleName());
+    }
+
+    private List<WeightedToken> readSparseVector(Object value) {
+        if (value instanceof Map<?, ?> map) {
+            List<WeightedToken> res = new ArrayList<>();
+            for (var entry : map.entrySet()) {
+                if (entry.getValue() instanceof Number number) {
+                    res.add(new WeightedToken((String) entry.getKey(), number.floatValue()));
+                } else {
+                    throw new IllegalArgumentException("Expected number, got " + entry.getValue().getClass().getSimpleName());
+                }
+            }
+            return res;
+        }
+        throw new IllegalArgumentException("Expected map, got " + value.getClass().getSimpleName());
+    }
+
+    private void assertHighlightOneDoc(
+        MapperService mapperService,
+        ShardSearchRequest request,
+        SourceToParse source,
+        String fieldName,
+        int numFragments,
+        HighlightBuilder.Order order,
+        String[] expectedPassages
+    ) throws Exception {
+        SemanticTextFieldMapper fieldMapper = (SemanticTextFieldMapper) mapperService.mappingLookup().getMapper(fieldName);
+        var doc = mapperService.documentMapper().parse(source);
+        assertNull(doc.dynamicMappingsUpdate());
+        try (Directory dir = newDirectory()) {
+            IndexWriterConfig iwc = newIndexWriterConfig(new StandardAnalyzer());
+            RandomIndexWriter iw = new RandomIndexWriter(random(), dir, iwc);
+            iw.addDocuments(doc.docs());
+            try (DirectoryReader reader = wrapInMockESDirectoryReader(iw.getReader())) {
+                IndexSearcher searcher = newSearcher(reader);
+                iw.close();
+                TopDocs topDocs = searcher.search(Queries.newNonNestedFilter(IndexVersion.current()), 1, Sort.INDEXORDER);
+                assertThat(topDocs.totalHits.value(), equalTo(1L));
+                int docID = topDocs.scoreDocs[0].doc;
+                SemanticTextHighlighter highlighter = new SemanticTextHighlighter();
+                var execContext = createSearchExecutionContext(mapperService);
+                var luceneQuery = execContext.toQuery(request.source().query()).query();
+                FetchContext fetchContext = mock(FetchContext.class);
+                Mockito.when(fetchContext.highlight()).thenReturn(new SearchHighlightContext(Collections.emptyList()));
+                Mockito.when(fetchContext.query()).thenReturn(luceneQuery);
+                Mockito.when(fetchContext.getSearchExecutionContext()).thenReturn(execContext);
+
+                FetchSubPhase.HitContext hitContext = new FetchSubPhase.HitContext(
+                    new SearchHit(docID),
+                    getOnlyLeafReader(reader).getContext(),
+                    docID,
+                    Map.of(),
+                    Source.fromBytes(source.source()),
+                    new RankDoc(docID, Float.NaN, 0)
+                );
+                try {
+                    var highlightContext = new HighlightBuilder().field(fieldName, 0, numFragments)
+                        .order(order)
+                        .highlighterType(SemanticTextHighlighter.NAME)
+                        .build(execContext);
+
+                    for (var fieldContext : highlightContext.fields()) {
+                        FieldHighlightContext context = new FieldHighlightContext(
+                            fieldName,
+                            fieldContext,
+                            fieldMapper.fieldType(),
+                            fetchContext,
+                            hitContext,
+                            luceneQuery,
+                            new HashMap<>()
+                        );
+                        var result = highlighter.highlight(context);
+                        assertThat(result.fragments().length, equalTo(expectedPassages.length));
+                        for (int i = 0; i < result.fragments().length; i++) {
+                            assertThat(result.fragments()[i].string(), equalTo(expectedPassages[i]));
+                        }
+                    }
+                } finally {
+                    hitContext.hit().decRef();
+                }
+            }
+        }
+    }
+
+    private SearchRequest createSearchRequest(QueryBuilder queryBuilder) {
+        SearchRequest request = new SearchRequest();
+        request.source(new SearchSourceBuilder());
+        request.allowPartialSearchResults(false);
+        request.source().query(queryBuilder);
+        return request;
+    }
+
+    private ShardSearchRequest createShardSearchRequest(QueryBuilder queryBuilder) {
+        SearchRequest request = createSearchRequest(queryBuilder);
+        return new ShardSearchRequest(OriginalIndices.NONE, request, new ShardId("index", "index", 0), 0, 1, AliasFilter.EMPTY, 1, 0, null);
+    }
+
+    private BytesReference readSampleDoc(String fileName) throws IOException {
+        try (var in = new GZIPInputStream(SemanticTextHighlighterTests.class.getResourceAsStream(fileName))) {
+            return new BytesArray(new BytesRef(in.readAllBytes()));
+        }
+    }
+}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/SemanticTextFieldMapperTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/SemanticTextFieldMapperTests.java
index fd60d9687f437..c6a492dfcf4e9 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/SemanticTextFieldMapperTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/mapper/SemanticTextFieldMapperTests.java
@@ -61,6 +61,7 @@
 import org.elasticsearch.xcontent.XContentParser;
 import org.elasticsearch.xcontent.XContentType;
 import org.elasticsearch.xcontent.json.JsonXContent;
+import org.elasticsearch.xpack.core.ml.search.SparseVectorQueryWrapper;
 import org.elasticsearch.xpack.inference.InferencePlugin;
 import org.elasticsearch.xpack.inference.model.TestModel;
 import org.junit.AssumptionViolatedException;
@@ -1110,7 +1111,12 @@ private static Query generateNestedTermSparseVectorQuery(NestedLookup nestedLook
         }
         queryBuilder.add(new BooleanClause(mapper.nestedTypeFilter(), BooleanClause.Occur.FILTER));
 
-        return new ESToParentBlockJoinQuery(queryBuilder.build(), parentFilter, ScoreMode.Total, null);
+        return new ESToParentBlockJoinQuery(
+            new SparseVectorQueryWrapper(fieldName, queryBuilder.build()),
+            parentFilter,
+            ScoreMode.Total,
+            null
+        );
     }
 
     private static void assertChildLeafNestedDocument(
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/queries/SemanticQueryBuilderTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/queries/SemanticQueryBuilderTests.java
index b8bcb766b53e1..36aa2200eceae 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/queries/SemanticQueryBuilderTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/queries/SemanticQueryBuilderTests.java
@@ -45,12 +45,14 @@
 import org.elasticsearch.xcontent.XContentBuilder;
 import org.elasticsearch.xcontent.XContentType;
 import org.elasticsearch.xcontent.json.JsonXContent;
+import org.elasticsearch.xpack.core.XPackClientPlugin;
 import org.elasticsearch.xpack.core.inference.action.InferenceAction;
 import org.elasticsearch.xpack.core.inference.results.InferenceTextEmbeddingFloatResults;
 import org.elasticsearch.xpack.core.inference.results.SparseEmbeddingResults;
 import org.elasticsearch.xpack.core.ml.inference.MlInferenceNamedXContentProvider;
 import org.elasticsearch.xpack.core.ml.inference.results.MlTextEmbeddingResults;
 import org.elasticsearch.xpack.core.ml.inference.results.TextExpansionResults;
+import org.elasticsearch.xpack.core.ml.search.SparseVectorQueryWrapper;
 import org.elasticsearch.xpack.core.ml.search.WeightedToken;
 import org.elasticsearch.xpack.inference.InferencePlugin;
 import org.elasticsearch.xpack.inference.mapper.SemanticTextField;
@@ -114,7 +116,7 @@ public void setUp() throws Exception {
 
     @Override
     protected Collection<Class<? extends Plugin>> getPlugins() {
-        return List.of(InferencePlugin.class, FakeMlPlugin.class);
+        return List.of(XPackClientPlugin.class, InferencePlugin.class, FakeMlPlugin.class);
     }
 
     @Override
@@ -194,9 +196,11 @@ protected void doAssertLuceneQuery(SemanticQueryBuilder queryBuilder, Query quer
 
     private void assertSparseEmbeddingLuceneQuery(Query query) {
         Query innerQuery = assertOuterBooleanQuery(query);
-        assertThat(innerQuery, instanceOf(BooleanQuery.class));
+        assertThat(innerQuery, instanceOf(SparseVectorQueryWrapper.class));
+        var sparseQuery = (SparseVectorQueryWrapper) innerQuery;
+        assertThat(((SparseVectorQueryWrapper) innerQuery).getTermsQuery(), instanceOf(BooleanQuery.class));
 
-        BooleanQuery innerBooleanQuery = (BooleanQuery) innerQuery;
+        BooleanQuery innerBooleanQuery = (BooleanQuery) sparseQuery.getTermsQuery();
         assertThat(innerBooleanQuery.clauses().size(), equalTo(queryTokenCount));
         innerBooleanQuery.forEach(c -> {
             assertThat(c.occur(), equalTo(SHOULD));
diff --git a/x-pack/plugin/inference/src/test/resources/org/elasticsearch/xpack/inference/highlight/mappings.json b/x-pack/plugin/inference/src/test/resources/org/elasticsearch/xpack/inference/highlight/mappings.json
new file mode 100644
index 0000000000000..9841ee0aed6e2
--- /dev/null
+++ b/x-pack/plugin/inference/src/test/resources/org/elasticsearch/xpack/inference/highlight/mappings.json
@@ -0,0 +1,27 @@
+{
+  "_doc": {
+    "properties": {
+      "body": {
+        "type": "text",
+        "copy_to": ["body-elser", "body-e5"]
+      },
+      "body-e5": {
+        "type": "semantic_text",
+        "inference_id": ".multilingual-e5-small-elasticsearch",
+        "model_settings": {
+          "task_type": "text_embedding",
+          "dimensions": 384,
+          "similarity": "cosine",
+          "element_type": "float"
+        }
+      },
+      "body-elser": {
+        "type": "semantic_text",
+        "inference_id": ".elser-2-elasticsearch",
+        "model_settings": {
+          "task_type": "sparse_embedding"
+        }
+      }
+    }
+  }
+}
\ No newline at end of file
diff --git a/x-pack/plugin/inference/src/test/resources/org/elasticsearch/xpack/inference/highlight/queries.json b/x-pack/plugin/inference/src/test/resources/org/elasticsearch/xpack/inference/highlight/queries.json
new file mode 100644
index 0000000000000..6227f3f498854
--- /dev/null
+++ b/x-pack/plugin/inference/src/test/resources/org/elasticsearch/xpack/inference/highlight/queries.json
@@ -0,0 +1,467 @@
+{
+  "dense_vector_1": {
+    "embeddings": [
+      0.09475211,
+      0.044564713,
+      -0.04378501,
+      -0.07908551,
+      0.04332011,
+      -0.03891992,
+      -0.0062305215,
+      0.024245035,
+      -0.008976331,
+      0.032832284,
+      0.052760173,
+      0.008123907,
+      0.09049037,
+      -0.01637332,
+      -0.054353267,
+      0.00771307,
+      0.08545496,
+      -0.079716265,
+      -0.045666866,
+      -0.04369993,
+      0.009189822,
+      -0.013782891,
+      -0.07701858,
+      0.037278354,
+      0.049807206,
+      0.078036495,
+      -0.059533164,
+      0.051413406,
+      0.040234447,
+      -0.038139492,
+      -0.085189626,
+      -0.045546446,
+      0.0544375,
+      -0.05604156,
+      0.057408098,
+      0.041913517,
+      -0.037348013,
+      -0.025998272,
+      0.08486864,
+      -0.046678443,
+      0.0041820924,
+      0.007514462,
+      0.06424746,
+      0.044233218,
+      0.103267275,
+      0.014130771,
+      -0.049954403,
+      0.04226959,
+      -0.08346965,
+      -0.01639249,
+      -0.060537644,
+      0.04546336,
+      0.012866155,
+      0.05375096,
+      0.036775924,
+      -0.0762226,
+      -0.037304543,
+      -0.05692274,
+      -0.055807598,
+      0.0040082196,
+      0.059259634,
+      0.012022011,
+      -8.0863154E-4,
+      0.0070405705,
+      0.050255686,
+      0.06810016,
+      0.017190414,
+      0.051975194,
+      -0.051436286,
+      0.023408439,
+      -0.029802637,
+      0.034137156,
+      -0.004660689,
+      -0.0442122,
+      0.019065322,
+      0.030806554,
+      0.0064652697,
+      -0.066789865,
+      0.057111286,
+      0.009412479,
+      -0.041444767,
+      -0.06807582,
+      -0.085881524,
+      0.04901128,
+      -0.047871742,
+      0.06328623,
+      0.040418074,
+      -0.081432894,
+      0.058384005,
+      0.006206527,
+      0.045801315,
+      0.037274595,
+      -0.054337103,
+      -0.06755516,
+      -0.07396888,
+      -0.043732334,
+      -0.052053086,
+      0.03210978,
+      0.048101492,
+      -0.083828256,
+      0.05205026,
+      -0.048474856,
+      0.029116616,
+      -0.10924888,
+      0.003796487,
+      0.030567763,
+      0.026949523,
+      -0.052353345,
+      0.043198872,
+      -0.09456988,
+      -0.05711594,
+      -2.2292069E-4,
+      0.032972734,
+      0.054394923,
+      -0.0767535,
+      -0.02710579,
+      -0.032135617,
+      -0.01732382,
+      0.059442326,
+      -0.07686165,
+      0.07104082,
+      -0.03090021,
+      -0.05450075,
+      -0.038997203,
+      -0.07045443,
+      0.00483161,
+      0.010933604,
+      0.020874644,
+      0.037941266,
+      0.019729063,
+      0.06178368,
+      0.013503478,
+      -0.008584046,
+      0.045592044,
+      0.05528768,
+      0.11568184,
+      0.0041300594,
+      0.015404516,
+      -3.8067883E-4,
+      -0.06365399,
+      -0.07826643,
+      0.061575573,
+      -0.060548335,
+      0.05706082,
+      0.042301804,
+      0.052173313,
+      0.07193179,
+      -0.03839231,
+      0.0734415,
+      -0.045380164,
+      0.02832276,
+      0.003745178,
+      0.058844633,
+      0.04307504,
+      0.037800383,
+      -0.031050054,
+      -0.06856359,
+      -0.059114788,
+      -0.02148857,
+      0.07854358,
+      -0.03253363,
+      -0.04566468,
+      -0.019933948,
+      -0.057993464,
+      -0.08677458,
+      -0.06626883,
+      0.031657256,
+      0.101128764,
+      -0.08050056,
+      -0.050226066,
+      -0.014335166,
+      0.050344367,
+      -0.06851419,
+      0.008698909,
+      -0.011893435,
+      0.07741272,
+      -0.059579294,
+      0.03250109,
+      0.058700256,
+      0.046834726,
+      -0.035081457,
+      -0.0043140925,
+      -0.09764087,
+      -0.0034994273,
+      -0.034056358,
+      -0.019066337,
+      -0.034376107,
+      0.012964423,
+      0.029291175,
+      -0.012090671,
+      0.021585712,
+      0.028859599,
+      -0.04391145,
+      -0.071166754,
+      -0.031040335,
+      0.02808108,
+      -0.05621317,
+      0.06543945,
+      0.10094665,
+      0.041057374,
+      -0.03222324,
+      -0.063366964,
+      0.064944476,
+      0.023641933,
+      0.06806713,
+      0.06806097,
+      -0.08220105,
+      0.04148528,
+      -0.09254079,
+      0.044620737,
+      0.05526614,
+      -0.03849534,
+      -0.04722273,
+      0.0670776,
+      -0.024274077,
+      -0.016903497,
+      0.07584147,
+      0.04760533,
+      -0.038843267,
+      -0.028365409,
+      0.08022705,
+      -0.039916333,
+      0.049067073,
+      -0.030701574,
+      -0.057169467,
+      0.043025102,
+      0.07109674,
+      -0.047296863,
+      -0.047463104,
+      0.040868305,
+      -0.04409507,
+      -0.034977127,
+      -0.057109762,
+      -0.08616165,
+      -0.03486079,
+      -0.046201482,
+      0.025963873,
+      0.023392359,
+      0.09594902,
+      -0.007847159,
+      -0.021231368,
+      0.009007263,
+      0.0032713825,
+      -0.06876065,
+      0.03169641,
+      -7.2582875E-4,
+      -0.07049708,
+      0.03900843,
+      -0.0075472407,
+      0.05184822,
+      0.06452079,
+      -0.09832754,
+      -0.012775799,
+      -0.03925948,
+      -0.029761659,
+      0.0065437574,
+      0.0815465,
+      0.0411695,
+      -0.0702844,
+      -0.009533786,
+      0.07024532,
+      0.0098710675,
+      0.09915362,
+      0.0415453,
+      0.050641853,
+      0.047463298,
+      -0.058609713,
+      -0.029499197,
+      -0.05100956,
+      -0.03441709,
+      -0.06348122,
+      0.014784361,
+      0.056317374,
+      -0.10280704,
+      -0.04008354,
+      -0.018926824,
+      0.08832836,
+      0.124804,
+      -0.047645308,
+      -0.07122146,
+      -9.886527E-4,
+      0.03850324,
+      0.048501793,
+      0.07072816,
+      0.06566776,
+      -0.013678872,
+      0.010010848,
+      0.06483413,
+      -0.030036367,
+      -0.029748922,
+      -0.007482364,
+      -0.05180385,
+      0.03698522,
+      -0.045453787,
+      0.056604166,
+      0.029394176,
+      0.028589265,
+      -0.012185886,
+      -0.06919616,
+      0.0711641,
+      -0.034055933,
+      -0.053101335,
+      0.062319,
+      0.021600349,
+      -0.038718067,
+      0.060814686,
+      0.05087301,
+      -0.020297311,
+      0.016493896,
+      0.032162152,
+      0.046740912,
+      0.05461355,
+      -0.07024665,
+      0.025609337,
+      -0.02504801,
+      0.06765588,
+      -0.032994855,
+      -0.037897404,
+      -0.045783922,
+      -0.05689299,
+      -0.040437017,
+      -0.07904339,
+      -0.031415287,
+      -0.029216278,
+      0.017395392,
+      0.03449264,
+      -0.025653394,
+      -0.06283088,
+      0.049027324,
+      0.016229525,
+      -0.00985347,
+      -0.053974394,
+      -0.030257035,
+      0.04325515,
+      -0.012293731,
+      -0.002446129,
+      -0.05567076,
+      0.06374684,
+      -0.03153897,
+      -0.04475149,
+      0.018582936,
+      0.025716115,
+      -0.061778374,
+      0.04196277,
+      -0.04134671,
+      -0.07396272,
+      0.05846184,
+      0.006558759,
+      -0.09745666,
+      0.07587805,
+      0.0137483915,
+      -0.100933895,
+      0.032008193,
+      0.04293283,
+      0.017870268,
+      0.032806385,
+      -0.0635923,
+      -0.019672254,
+      0.022225974,
+      0.04304554,
+      -0.06043949,
+      -0.0285274,
+      0.050868835,
+      0.057003833,
+      0.05740866,
+      0.020068677,
+      -0.034312245,
+      -0.021671802,
+      0.014769731,
+      -0.07328285,
+      -0.009586734,
+      0.036420938,
+      -0.022188472,
+      -0.008200541,
+      -0.010765854,
+      -0.06949713,
+      -0.07555878,
+      0.045306854,
+      -0.05424466,
+      -0.03647476,
+      0.06266633,
+      0.08346125,
+      0.060288202,
+      0.0548457
+    ],
+    "expected_by_score": [
+      "The ancient oppidum that corresponds to the modern city of Paris was first mentioned in the mid-1st century BC by Julius Caesar as Luteciam Parisiorum ('Lutetia of the Parisii') and is later attested as Parision in the 5th century AD, then as Paris in 1265. During the Roman period, it was commonly known as Lutetia or Lutecia in Latin, and as Leukotekía in Greek, which is interpreted as either stemming from the Celtic root *lukot- ('mouse'), or from *luto- ('marsh, swamp').\n\n\nThe name Paris is derived from its early inhabitants, the Parisii, a Gallic tribe from the Iron Age and the Roman period. The meaning of the Gaulish ethnonym remains debated. According to Xavier Delamarre, it may derive from the Celtic root pario- ('cauldron'). Alfred Holder interpreted the name as 'the makers' or 'the commanders', by comparing it to the Welsh peryff ('lord, commander'), both possibly descending from a Proto-Celtic form reconstructed as *kwar-is-io-. Alternatively, Pierre-Yves Lambert proposed to translate Parisii as the 'spear people', by connecting the first element to the Old Irish carr ('spear'), derived from an earlier *kwar-sā. In any case, the city's name is not related to the Paris of Greek mythology.\n\n\nResidents of the city are known in English as Parisians and in French as Parisiens ( ⓘ). They are also pejoratively called Parigots ( ⓘ).\n\n\nHistory\n\nOrigins\n\n",
+      "After the marshland between the river Seine and its slower 'dead arm' to its north was filled in from around the 10th century, Paris's cultural centre began to move to the Right Bank. In 1137, a new city marketplace (today's Les Halles) replaced the two smaller ones on the Île de la Cité and Place de Grève (Place de l'Hôtel de Ville). The latter location housed the headquarters of Paris's river trade corporation, an organisation that later became, unofficially (although formally in later years), Paris's first municipal government.\n\n\nIn the late 12th century, Philip Augustus extended the Louvre fortress to defend the city against river invasions from the west, gave the city its first walls between 1190 and 1215, rebuilt its bridges to either side of its central island, and paved its main thoroughfares. In 1190, he transformed Paris's former cathedral school into a student-teacher corporation that would become the University of Paris and would draw students from all of Europe.\n\n\nWith 200,000 inhabitants in 1328, Paris, then already the capital of France, was the most populous city of Europe. By comparison, London in 1300 had 80,000 inhabitants. By the early fourteenth century, so much filth had collected inside urban Europe that French and Italian cities were naming streets after human waste. In medieval Paris, several street names were inspired by merde, the French word for \"shit\".\n\n\n",
+      "In March 2001, Bertrand Delanoë became the first socialist mayor. He was re-elected in March 2008. In 2007, in an effort to reduce car traffic, he introduced the Vélib', a system which rents bicycles. Bertrand Delanoë also transformed a section of the highway along the Left Bank of the Seine into an urban promenade and park, the Promenade des Berges de la Seine, which he inaugurated in June 2013.\n\n\nIn 2007, President Nicolas Sarkozy launched the Grand Paris project, to integrate Paris more closely with the towns in the region around it. After many modifications, the new area, named the Metropolis of Grand Paris, with a population of 6.7 million, was created on 1 January 2016. In 2011, the City of Paris and the national government approved the plans for the Grand Paris Express, totalling 205 km (127 mi) of automated metro lines to connect Paris, the innermost three departments around Paris, airports and high-speed rail (TGV) stations, at an estimated cost of €35 billion. The system is scheduled to be completed by 2030.\n\n\nIn January 2015, Al-Qaeda in the Arabian Peninsula claimed attacks across the Paris region. 1.5 million people marched in Paris in a show of solidarity against terrorism and in support of freedom of speech. In November of the same year, terrorist attacks, claimed by ISIL, killed 130 people and injured more than 350.\n\n\n",
+      "\nParis (.mw-parser-output .IPA-label-small{font-size:85%}.mw-parser-output .references .IPA-label-small,.mw-parser-output .infobox .IPA-label-small,.mw-parser-output .navbox .IPA-label-small{font-size:100%}French pronunciation:  ⓘ) is the capital and largest city of France. With an estimated population of 2,102,650 residents in January 2023 in an area of more than 105 km2 (41 sq mi), Paris is the fourth-largest city in the European Union and the 30th most densely populated city in the world in 2022. Since the 17th century, Paris has been one of the world's major centres of finance, diplomacy, commerce, culture, fashion, and gastronomy. Because of its leading role in the arts and sciences and its early adaptation of extensive street lighting, it became known as the City of Light in the 19th century.\n\n\nThe City of Paris is the centre of the Île-de-France region, or Paris Region, with an official estimated population of 12,271,794 inhabitants in January 2023, or about 19% of the population of France. The Paris Region had a nominal GDP of €765 billion (US$1.064 trillion when adjusted for PPP) in 2021, the highest in the European Union. According to the Economist Intelligence Unit Worldwide Cost of Living Survey, in 2022, Paris was the city with the ninth-highest cost of living in the world.\n\n\n",
+      "Bal-musette is a style of French music and dance that first became popular in Paris in the 1870s and 1880s; by 1880 Paris had some 150 dance halls. Patrons danced the bourrée to the accompaniment of the cabrette (a bellows-blown bagpipe locally called a \"musette\") and often the vielle à roue (hurdy-gurdy) in the cafés and bars of the city. Parisian and Italian musicians who played the accordion adopted the style and established themselves in Auvergnat bars, and Paris became a major centre for jazz and still attracts jazz musicians from all around the world to its clubs and cafés.\n\n\nParis is the spiritual home of gypsy jazz in particular, and many of the Parisian jazzmen who developed in the first half of the 20th century began by playing Bal-musette in the city. Django Reinhardt rose to fame in Paris, having moved to the 18th arrondissement in a caravan as a young boy, and performed with violinist Stéphane Grappelli and their Quintette du Hot Club de France in the 1930s and 1940s.\n\n\nImmediately after the War the Saint-Germain-des-Pres quarter and the nearby Saint-Michel quarter became home to many small jazz clubs, including the Caveau des Lorientais, the Club Saint-Germain, the Rose Rouge, the Vieux-Colombier, and the most famous, Le Tabou. They introduced Parisians to the music of Claude Luter, Boris Vian, Sydney Bechet, Mezz Mezzrow, and Henri Salvador. "
+    ],
+    "expected_by_offset": [
+      "\nParis (.mw-parser-output .IPA-label-small{font-size:85%}.mw-parser-output .references .IPA-label-small,.mw-parser-output .infobox .IPA-label-small,.mw-parser-output .navbox .IPA-label-small{font-size:100%}French pronunciation:  ⓘ) is the capital and largest city of France. With an estimated population of 2,102,650 residents in January 2023 in an area of more than 105 km2 (41 sq mi), Paris is the fourth-largest city in the European Union and the 30th most densely populated city in the world in 2022. Since the 17th century, Paris has been one of the world's major centres of finance, diplomacy, commerce, culture, fashion, and gastronomy. Because of its leading role in the arts and sciences and its early adaptation of extensive street lighting, it became known as the City of Light in the 19th century.\n\n\nThe City of Paris is the centre of the Île-de-France region, or Paris Region, with an official estimated population of 12,271,794 inhabitants in January 2023, or about 19% of the population of France. The Paris Region had a nominal GDP of €765 billion (US$1.064 trillion when adjusted for PPP) in 2021, the highest in the European Union. According to the Economist Intelligence Unit Worldwide Cost of Living Survey, in 2022, Paris was the city with the ninth-highest cost of living in the world.\n\n\n",
+      "The ancient oppidum that corresponds to the modern city of Paris was first mentioned in the mid-1st century BC by Julius Caesar as Luteciam Parisiorum ('Lutetia of the Parisii') and is later attested as Parision in the 5th century AD, then as Paris in 1265. During the Roman period, it was commonly known as Lutetia or Lutecia in Latin, and as Leukotekía in Greek, which is interpreted as either stemming from the Celtic root *lukot- ('mouse'), or from *luto- ('marsh, swamp').\n\n\nThe name Paris is derived from its early inhabitants, the Parisii, a Gallic tribe from the Iron Age and the Roman period. The meaning of the Gaulish ethnonym remains debated. According to Xavier Delamarre, it may derive from the Celtic root pario- ('cauldron'). Alfred Holder interpreted the name as 'the makers' or 'the commanders', by comparing it to the Welsh peryff ('lord, commander'), both possibly descending from a Proto-Celtic form reconstructed as *kwar-is-io-. Alternatively, Pierre-Yves Lambert proposed to translate Parisii as the 'spear people', by connecting the first element to the Old Irish carr ('spear'), derived from an earlier *kwar-sā. In any case, the city's name is not related to the Paris of Greek mythology.\n\n\nResidents of the city are known in English as Parisians and in French as Parisiens ( ⓘ). They are also pejoratively called Parigots ( ⓘ).\n\n\nHistory\n\nOrigins\n\n",
+      "After the marshland between the river Seine and its slower 'dead arm' to its north was filled in from around the 10th century, Paris's cultural centre began to move to the Right Bank. In 1137, a new city marketplace (today's Les Halles) replaced the two smaller ones on the Île de la Cité and Place de Grève (Place de l'Hôtel de Ville). The latter location housed the headquarters of Paris's river trade corporation, an organisation that later became, unofficially (although formally in later years), Paris's first municipal government.\n\n\nIn the late 12th century, Philip Augustus extended the Louvre fortress to defend the city against river invasions from the west, gave the city its first walls between 1190 and 1215, rebuilt its bridges to either side of its central island, and paved its main thoroughfares. In 1190, he transformed Paris's former cathedral school into a student-teacher corporation that would become the University of Paris and would draw students from all of Europe.\n\n\nWith 200,000 inhabitants in 1328, Paris, then already the capital of France, was the most populous city of Europe. By comparison, London in 1300 had 80,000 inhabitants. By the early fourteenth century, so much filth had collected inside urban Europe that French and Italian cities were naming streets after human waste. In medieval Paris, several street names were inspired by merde, the French word for \"shit\".\n\n\n",
+      "In March 2001, Bertrand Delanoë became the first socialist mayor. He was re-elected in March 2008. In 2007, in an effort to reduce car traffic, he introduced the Vélib', a system which rents bicycles. Bertrand Delanoë also transformed a section of the highway along the Left Bank of the Seine into an urban promenade and park, the Promenade des Berges de la Seine, which he inaugurated in June 2013.\n\n\nIn 2007, President Nicolas Sarkozy launched the Grand Paris project, to integrate Paris more closely with the towns in the region around it. After many modifications, the new area, named the Metropolis of Grand Paris, with a population of 6.7 million, was created on 1 January 2016. In 2011, the City of Paris and the national government approved the plans for the Grand Paris Express, totalling 205 km (127 mi) of automated metro lines to connect Paris, the innermost three departments around Paris, airports and high-speed rail (TGV) stations, at an estimated cost of €35 billion. The system is scheduled to be completed by 2030.\n\n\nIn January 2015, Al-Qaeda in the Arabian Peninsula claimed attacks across the Paris region. 1.5 million people marched in Paris in a show of solidarity against terrorism and in support of freedom of speech. In November of the same year, terrorist attacks, claimed by ISIL, killed 130 people and injured more than 350.\n\n\n",
+      "Bal-musette is a style of French music and dance that first became popular in Paris in the 1870s and 1880s; by 1880 Paris had some 150 dance halls. Patrons danced the bourrée to the accompaniment of the cabrette (a bellows-blown bagpipe locally called a \"musette\") and often the vielle à roue (hurdy-gurdy) in the cafés and bars of the city. Parisian and Italian musicians who played the accordion adopted the style and established themselves in Auvergnat bars, and Paris became a major centre for jazz and still attracts jazz musicians from all around the world to its clubs and cafés.\n\n\nParis is the spiritual home of gypsy jazz in particular, and many of the Parisian jazzmen who developed in the first half of the 20th century began by playing Bal-musette in the city. Django Reinhardt rose to fame in Paris, having moved to the 18th arrondissement in a caravan as a young boy, and performed with violinist Stéphane Grappelli and their Quintette du Hot Club de France in the 1930s and 1940s.\n\n\nImmediately after the War the Saint-Germain-des-Pres quarter and the nearby Saint-Michel quarter became home to many small jazz clubs, including the Caveau des Lorientais, the Club Saint-Germain, the Rose Rouge, the Vieux-Colombier, and the most famous, Le Tabou. They introduced Parisians to the music of Claude Luter, Boris Vian, Sydney Bechet, Mezz Mezzrow, and Henri Salvador. "
+    ]
+  },
+  "sparse_vector_1": {
+    "embeddings": {
+      "paris": 2.9709616,
+      "date": 2.1960778,
+      "founded": 2.0555024,
+      "foundation": 1.412623,
+      "early": 1.2162757,
+      "founder": 1.1271698,
+      "french": 0.9213378,
+      "france": 0.86253893,
+      "city": 0.82978916,
+      "founding": 0.79722786,
+      "established": 0.7967043,
+      "ancient": 0.7392465,
+      "when": 0.71705,
+      "built": 0.6977878,
+      "treaty": 0.6846069,
+      "created": 0.68127465,
+      "century": 0.58926934,
+      "for": 0.55019474,
+      "was": 0.52475905,
+      "origin": 0.48785052,
+      "expedition": 0.48757303,
+      "history": 0.47960007,
+      "mint": 0.47878903,
+      "historical": 0.4714338,
+      "capital": 0.42984143,
+      "timeline": 0.4222377,
+      "colony": 0.3876187,
+      "tower": 0.3474891,
+      "medieval": 0.3272666,
+      "geography": 0.32456368,
+      "colonial": 0.30613664,
+      "location": 0.29013386,
+      "francisco": 0.22840048,
+      "orleans": 0.21971667,
+      "earlier": 0.20318772,
+      "jackson": 0.18424438,
+      "exact": 0.17109296,
+      "rome": 0.16320735,
+      "civilization": 0.15931238,
+      "spanish": 0.12759624,
+      "museum": 0.113024555,
+      "latin": 0.11201205,
+      "european": 0.10277243,
+      "architect": 0.0796932,
+      "united": 0.031233707
+    },
+    "expected_by_score": [
+      "Clovis the Frank, the first king of the Merovingian dynasty, made the city his capital from 508. As the Frankish domination of Gaul began, there was a gradual immigration by the Franks to Paris and the Parisian Francien dialects were born. Fortification of the Île de la Cité failed to avert sacking by Vikings in 845, but Paris's strategic importance—with its bridges preventing ships from passing—was established by successful defence in the Siege of Paris (885–886), for which the then Count of Paris (comte de Paris), Odo of France, was elected king of West Francia. From the Capetian dynasty that began with the 987 election of Hugh Capet, Count of Paris and Duke of the Franks (duc des Francs), as king of a unified West Francia, Paris gradually became the largest and most prosperous city in France.\n\n\nHigh and Late Middle Ages to Louis XIV\n\nBy the end of the 12th century, Paris had become the political, economic, religious, and cultural capital of France. The Palais de la Cité, the royal residence, was located at the western end of the Île de la Cité. In 1163, during the reign of Louis VII, Maurice de Sully, bishop of Paris, undertook the construction of the Notre Dame Cathedral at its eastern extremity.\n\n\nAfter the marshland between the river Seine and its slower 'dead arm' to its north was filled in from around the 10th century, Paris's cultural centre began to move to the Right Bank. ",
+      "\nThe Parisii, a sub-tribe of the Celtic Senones, inhabited the Paris area from around the middle of the 3rd century BC. One of the area's major north–south trade routes crossed the Seine on the Île de la Cité, which gradually became an important trading centre. The Parisii traded with many river towns (some as far away as the Iberian Peninsula) and minted their own coins.\n\n\nThe Romans conquered the Paris Basin in 52 BC and began their settlement on Paris's Left Bank. The Roman town was originally called Lutetia (more fully, Lutetia Parisiorum, \"Lutetia of the Parisii\", modern French Lutèce). It became a prosperous city with a forum, baths, temples, theatres, and an amphitheatre.\n\n\nBy the end of the Western Roman Empire, the town was known as Parisius, a Latin name that would later become Paris in French. Christianity was introduced in the middle of the 3rd century AD by Saint Denis, the first Bishop of Paris: according to legend, when he refused to renounce his faith before the Roman occupiers, he was beheaded on the hill which became known as Mons Martyrum (Latin \"Hill of Martyrs\"), later \"Montmartre\", from where he walked headless to the north of the city; the place where he fell and was buried became an important religious shrine, the Basilica of Saint-Denis, and many French kings are buried there.\n\n\nClovis the Frank, the first king of the Merovingian dynasty, made the city his capital from 508. ",
+      "\nDuring the Hundred Years' War, Paris was occupied by England-friendly Burgundian forces from 1418, before being occupied outright by the English when Henry V of England entered the French capital in 1420; in spite of a 1429 effort by Joan of Arc to liberate the city, it would remain under English occupation until 1436.\n\n\nIn the late 16th-century French Wars of Religion, Paris was a stronghold of the Catholic League, the organisers of 24 August 1572 St. Bartholomew's Day massacre in which thousands of French Protestants were killed. The conflicts ended when pretender to the throne Henry IV, after converting to Catholicism to gain entry to the capital, entered the city in 1594 to claim the crown of France. This king made several improvements to the capital during his reign: he completed the construction of Paris's first uncovered, sidewalk-lined bridge, the Pont Neuf, built a Louvre extension connecting it to the Tuileries Palace, and created the first Paris residential square, the Place Royale, now Place des Vosges. In spite of Henry IV's efforts to improve city circulation, the narrowness of Paris's streets was a contributing factor in his assassination near Les Halles marketplace in 1610.\n\n\nDuring the 17th century, Cardinal Richelieu, chief minister of Louis XIII, was determined to make Paris the most beautiful city in Europe. He built five new bridges, a new chapel for the College of Sorbonne, and a palace for himself, the Palais-Cardinal. ",
+      "Diderot and D'Alembert published their Encyclopédie in 1751, before the Montgolfier Brothers launched the first manned flight in a hot air balloon on 21 November 1783. Paris was the financial capital of continental Europe, as well the primary European centre for book publishing, fashion and the manufacture of fine furniture and luxury goods. On 22 October 1797, Paris was also the site of the first parachute jump in history, by Garnerin.\n\n\nIn the summer of 1789, Paris became the centre stage of the French Revolution. On 14 July, a mob seized the arsenal at the Invalides, acquiring thousands of guns, with which it stormed the Bastille, a principal symbol of royal authority. The first independent Paris Commune, or city council, met in the Hôtel de Ville and elected a Mayor, the astronomer Jean Sylvain Bailly, on 15 July.\n\n\nLouis XVI and the royal family were brought to Paris and incarcerated in the Tuileries Palace. In 1793, as the revolution turned increasingly radical, the king, queen and mayor were beheaded by guillotine in the Reign of Terror, along with more than 16,000 others throughout France. The property of the aristocracy and the church was nationalised, and the city's churches were closed, sold or demolished. A succession of revolutionary factions ruled Paris until 9 November 1799 (coup d'état du 18 brumaire), when Napoleon Bonaparte seized power as First Consul.\n\n\n",
+      "After the marshland between the river Seine and its slower 'dead arm' to its north was filled in from around the 10th century, Paris's cultural centre began to move to the Right Bank. In 1137, a new city marketplace (today's Les Halles) replaced the two smaller ones on the Île de la Cité and Place de Grève (Place de l'Hôtel de Ville). The latter location housed the headquarters of Paris's river trade corporation, an organisation that later became, unofficially (although formally in later years), Paris's first municipal government.\n\n\nIn the late 12th century, Philip Augustus extended the Louvre fortress to defend the city against river invasions from the west, gave the city its first walls between 1190 and 1215, rebuilt its bridges to either side of its central island, and paved its main thoroughfares. In 1190, he transformed Paris's former cathedral school into a student-teacher corporation that would become the University of Paris and would draw students from all of Europe.\n\n\nWith 200,000 inhabitants in 1328, Paris, then already the capital of France, was the most populous city of Europe. By comparison, London in 1300 had 80,000 inhabitants. By the early fourteenth century, so much filth had collected inside urban Europe that French and Italian cities were naming streets after human waste. In medieval Paris, several street names were inspired by merde, the French word for \"shit\".\n\n\n"
+    ],
+    "expected_by_offset": [
+      "\nThe Parisii, a sub-tribe of the Celtic Senones, inhabited the Paris area from around the middle of the 3rd century BC. One of the area's major north–south trade routes crossed the Seine on the Île de la Cité, which gradually became an important trading centre. The Parisii traded with many river towns (some as far away as the Iberian Peninsula) and minted their own coins.\n\n\nThe Romans conquered the Paris Basin in 52 BC and began their settlement on Paris's Left Bank. The Roman town was originally called Lutetia (more fully, Lutetia Parisiorum, \"Lutetia of the Parisii\", modern French Lutèce). It became a prosperous city with a forum, baths, temples, theatres, and an amphitheatre.\n\n\nBy the end of the Western Roman Empire, the town was known as Parisius, a Latin name that would later become Paris in French. Christianity was introduced in the middle of the 3rd century AD by Saint Denis, the first Bishop of Paris: according to legend, when he refused to renounce his faith before the Roman occupiers, he was beheaded on the hill which became known as Mons Martyrum (Latin \"Hill of Martyrs\"), later \"Montmartre\", from where he walked headless to the north of the city; the place where he fell and was buried became an important religious shrine, the Basilica of Saint-Denis, and many French kings are buried there.\n\n\nClovis the Frank, the first king of the Merovingian dynasty, made the city his capital from 508. ",
+      "Clovis the Frank, the first king of the Merovingian dynasty, made the city his capital from 508. As the Frankish domination of Gaul began, there was a gradual immigration by the Franks to Paris and the Parisian Francien dialects were born. Fortification of the Île de la Cité failed to avert sacking by Vikings in 845, but Paris's strategic importance—with its bridges preventing ships from passing—was established by successful defence in the Siege of Paris (885–886), for which the then Count of Paris (comte de Paris), Odo of France, was elected king of West Francia. From the Capetian dynasty that began with the 987 election of Hugh Capet, Count of Paris and Duke of the Franks (duc des Francs), as king of a unified West Francia, Paris gradually became the largest and most prosperous city in France.\n\n\nHigh and Late Middle Ages to Louis XIV\n\nBy the end of the 12th century, Paris had become the political, economic, religious, and cultural capital of France. The Palais de la Cité, the royal residence, was located at the western end of the Île de la Cité. In 1163, during the reign of Louis VII, Maurice de Sully, bishop of Paris, undertook the construction of the Notre Dame Cathedral at its eastern extremity.\n\n\nAfter the marshland between the river Seine and its slower 'dead arm' to its north was filled in from around the 10th century, Paris's cultural centre began to move to the Right Bank. ",
+      "After the marshland between the river Seine and its slower 'dead arm' to its north was filled in from around the 10th century, Paris's cultural centre began to move to the Right Bank. In 1137, a new city marketplace (today's Les Halles) replaced the two smaller ones on the Île de la Cité and Place de Grève (Place de l'Hôtel de Ville). The latter location housed the headquarters of Paris's river trade corporation, an organisation that later became, unofficially (although formally in later years), Paris's first municipal government.\n\n\nIn the late 12th century, Philip Augustus extended the Louvre fortress to defend the city against river invasions from the west, gave the city its first walls between 1190 and 1215, rebuilt its bridges to either side of its central island, and paved its main thoroughfares. In 1190, he transformed Paris's former cathedral school into a student-teacher corporation that would become the University of Paris and would draw students from all of Europe.\n\n\nWith 200,000 inhabitants in 1328, Paris, then already the capital of France, was the most populous city of Europe. By comparison, London in 1300 had 80,000 inhabitants. By the early fourteenth century, so much filth had collected inside urban Europe that French and Italian cities were naming streets after human waste. In medieval Paris, several street names were inspired by merde, the French word for \"shit\".\n\n\n",
+      "\nDuring the Hundred Years' War, Paris was occupied by England-friendly Burgundian forces from 1418, before being occupied outright by the English when Henry V of England entered the French capital in 1420; in spite of a 1429 effort by Joan of Arc to liberate the city, it would remain under English occupation until 1436.\n\n\nIn the late 16th-century French Wars of Religion, Paris was a stronghold of the Catholic League, the organisers of 24 August 1572 St. Bartholomew's Day massacre in which thousands of French Protestants were killed. The conflicts ended when pretender to the throne Henry IV, after converting to Catholicism to gain entry to the capital, entered the city in 1594 to claim the crown of France. This king made several improvements to the capital during his reign: he completed the construction of Paris's first uncovered, sidewalk-lined bridge, the Pont Neuf, built a Louvre extension connecting it to the Tuileries Palace, and created the first Paris residential square, the Place Royale, now Place des Vosges. In spite of Henry IV's efforts to improve city circulation, the narrowness of Paris's streets was a contributing factor in his assassination near Les Halles marketplace in 1610.\n\n\nDuring the 17th century, Cardinal Richelieu, chief minister of Louis XIII, was determined to make Paris the most beautiful city in Europe. He built five new bridges, a new chapel for the College of Sorbonne, and a palace for himself, the Palais-Cardinal. ",
+      "Diderot and D'Alembert published their Encyclopédie in 1751, before the Montgolfier Brothers launched the first manned flight in a hot air balloon on 21 November 1783. Paris was the financial capital of continental Europe, as well the primary European centre for book publishing, fashion and the manufacture of fine furniture and luxury goods. On 22 October 1797, Paris was also the site of the first parachute jump in history, by Garnerin.\n\n\nIn the summer of 1789, Paris became the centre stage of the French Revolution. On 14 July, a mob seized the arsenal at the Invalides, acquiring thousands of guns, with which it stormed the Bastille, a principal symbol of royal authority. The first independent Paris Commune, or city council, met in the Hôtel de Ville and elected a Mayor, the astronomer Jean Sylvain Bailly, on 15 July.\n\n\nLouis XVI and the royal family were brought to Paris and incarcerated in the Tuileries Palace. In 1793, as the revolution turned increasingly radical, the king, queen and mayor were beheaded by guillotine in the Reign of Terror, along with more than 16,000 others throughout France. The property of the aristocracy and the church was nationalised, and the city's churches were closed, sold or demolished. A succession of revolutionary factions ruled Paris until 9 November 1799 (coup d'état du 18 brumaire), when Napoleon Bonaparte seized power as First Consul.\n\n\n"
+    ]
+  }
+}
\ No newline at end of file
diff --git a/x-pack/plugin/inference/src/test/resources/org/elasticsearch/xpack/inference/highlight/sample-doc.json.gz b/x-pack/plugin/inference/src/test/resources/org/elasticsearch/xpack/inference/highlight/sample-doc.json.gz
new file mode 100644
index 0000000000000000000000000000000000000000..881524e46e18639782402236d4aca01ffcfaf02b
GIT binary patch
literal 388098
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

literal 0
HcmV?d00001

diff --git a/x-pack/plugin/inference/src/yamlRestTest/resources/rest-api-spec/test/inference/90_semantic_text_highlighter.yml b/x-pack/plugin/inference/src/yamlRestTest/resources/rest-api-spec/test/inference/90_semantic_text_highlighter.yml
new file mode 100644
index 0000000000000..25cd1b5aec48a
--- /dev/null
+++ b/x-pack/plugin/inference/src/yamlRestTest/resources/rest-api-spec/test/inference/90_semantic_text_highlighter.yml
@@ -0,0 +1,242 @@
+setup:
+  - requires:
+      cluster_features: "semantic_text.highlighter"
+      reason: a new highlighter for semantic text field
+
+  - do:
+      inference.put:
+        task_type: sparse_embedding
+        inference_id: sparse-inference-id
+        body: >
+          {
+            "service": "test_service",
+            "service_settings": {
+              "model": "my_model",
+              "api_key": "abc64"
+            },
+            "task_settings": {
+            }
+          }
+
+  - do:
+      inference.put:
+        task_type: text_embedding
+        inference_id: dense-inference-id
+        body: >
+          {
+            "service": "text_embedding_test_service",
+            "service_settings": {
+              "model": "my_model",
+              "dimensions": 10,
+              "api_key": "abc64",
+              "similarity": "COSINE"
+            },
+            "task_settings": {
+            }
+          }
+
+  - do:
+      indices.create:
+        index: test-sparse-index
+        body:
+          mappings:
+            properties:
+              body:
+                type: semantic_text
+                inference_id: sparse-inference-id
+
+  - do:
+      indices.create:
+        index: test-dense-index
+        body:
+          mappings:
+            properties:
+              body:
+                type: semantic_text
+                inference_id: dense-inference-id
+
+---
+"Highlighting using a sparse embedding model":
+  - do:
+      index:
+        index: test-sparse-index
+        id: doc_1
+        body:
+          body: ["ElasticSearch is an open source, distributed, RESTful, search engine which is built on top of Lucene internally and enjoys all the features it provides.", "You Know, for Search!"]
+        refresh: true
+
+  - match: { result: created }
+
+  - do:
+      search:
+        index: test-sparse-index
+        body:
+          query:
+            semantic:
+              field: "body"
+              query: "What is Elasticsearch?"
+          highlight:
+            fields:
+              body:
+                type: "semantic"
+                number_of_fragments: 1
+
+  - match:  { hits.total.value: 1 }
+  - match:  { hits.hits.0._id: "doc_1" }
+  - length: { hits.hits.0.highlight.body: 1 }
+  - match:  { hits.hits.0.highlight.body.0: "ElasticSearch is an open source, distributed, RESTful, search engine which is built on top of Lucene internally and enjoys all the features it provides." }
+
+  - do:
+      search:
+        index: test-sparse-index
+        body:
+          query:
+            semantic:
+              field: "body"
+              query: "What is Elasticsearch?"
+          highlight:
+            fields:
+              body:
+                type: "semantic"
+                number_of_fragments: 2
+
+  - match:  { hits.total.value: 1 }
+  - match:  { hits.hits.0._id: "doc_1" }
+  - length: { hits.hits.0.highlight.body: 2 }
+  - match:  { hits.hits.0.highlight.body.0: "ElasticSearch is an open source, distributed, RESTful, search engine which is built on top of Lucene internally and enjoys all the features it provides." }
+  - match:  { hits.hits.0.highlight.body.1: "You Know, for Search!" }
+
+  - do:
+      search:
+        index: test-sparse-index
+        body:
+          query:
+            semantic:
+              field: "body"
+              query: "What is Elasticsearch?"
+          highlight:
+            fields:
+              body:
+                type: "semantic"
+                order: "score"
+                number_of_fragments: 1
+
+  - match:  { hits.total.value: 1 }
+  - match:  { hits.hits.0._id: "doc_1" }
+  - length: { hits.hits.0.highlight.body: 1 }
+  - match:  { hits.hits.0.highlight.body.0: "ElasticSearch is an open source, distributed, RESTful, search engine which is built on top of Lucene internally and enjoys all the features it provides." }
+
+  - do:
+      search:
+        index: test-sparse-index
+        body:
+          query:
+            semantic:
+              field: "body"
+              query: "What is Elasticsearch?"
+          highlight:
+            fields:
+              body:
+                type: "semantic"
+                order: "score"
+                number_of_fragments: 2
+
+  - match: { hits.total.value: 1 }
+  - match: { hits.hits.0._id: "doc_1" }
+  - length: { hits.hits.0.highlight.body: 2 }
+  - match: { hits.hits.0.highlight.body.0: "ElasticSearch is an open source, distributed, RESTful, search engine which is built on top of Lucene internally and enjoys all the features it provides." }
+  - match: { hits.hits.0.highlight.body.1: "You Know, for Search!" }
+
+---
+"Highlighting using a dense embedding model":
+  - do:
+      index:
+        index: test-dense-index
+        id: doc_1
+        body:
+          body: ["ElasticSearch is an open source, distributed, RESTful, search engine which is built on top of Lucene internally and enjoys all the features it provides.", "You Know, for Search!"]
+        refresh: true
+
+  - match: { result: created }
+
+  - do:
+      search:
+        index: test-dense-index
+        body:
+          query:
+            semantic:
+              field: "body"
+              query: "What is Elasticsearch?"
+          highlight:
+            fields:
+              body:
+                type: "semantic"
+                number_of_fragments: 1
+
+  - match:  { hits.total.value: 1 }
+  - match:  { hits.hits.0._id: "doc_1" }
+  - length: { hits.hits.0.highlight.body: 1 }
+  - match:  { hits.hits.0.highlight.body.0: "You Know, for Search!" }
+
+  - do:
+      search:
+        index: test-dense-index
+        body:
+          query:
+            semantic:
+              field: "body"
+              query: "What is Elasticsearch?"
+          highlight:
+            fields:
+              body:
+                type: "semantic"
+                number_of_fragments: 2
+
+  - match:  { hits.total.value: 1 }
+  - match:  { hits.hits.0._id: "doc_1" }
+  - length: { hits.hits.0.highlight.body: 2 }
+  - match:  { hits.hits.0.highlight.body.0: "ElasticSearch is an open source, distributed, RESTful, search engine which is built on top of Lucene internally and enjoys all the features it provides." }
+  - match:  { hits.hits.0.highlight.body.1: "You Know, for Search!" }
+
+  - do:
+      search:
+        index: test-dense-index
+        body:
+          query:
+            semantic:
+              field: "body"
+              query: "What is Elasticsearch?"
+          highlight:
+            fields:
+              body:
+                type: "semantic"
+                order: "score"
+                number_of_fragments: 1
+
+  - match:  { hits.total.value: 1 }
+  - match:  { hits.hits.0._id: "doc_1" }
+  - length: { hits.hits.0.highlight.body: 1 }
+  - match:  { hits.hits.0.highlight.body.0: "You Know, for Search!" }
+
+  - do:
+      search:
+        index: test-dense-index
+        body:
+          query:
+            semantic:
+              field: "body"
+              query: "What is Elasticsearch?"
+          highlight:
+            fields:
+              body:
+                type: "semantic"
+                order: "score"
+                number_of_fragments: 2
+
+  - match:  { hits.total.value: 1 }
+  - match:  { hits.hits.0._id: "doc_1" }
+  - length: { hits.hits.0.highlight.body: 2 }
+  - match:  { hits.hits.0.highlight.body.0: "You Know, for Search!" }
+  - match:  { hits.hits.0.highlight.body.1: "ElasticSearch is an open source, distributed, RESTful, search engine which is built on top of Lucene internally and enjoys all the features it provides." }
+
+

From a04d67180c552a549fbac644bacd209b4e0370a4 Mon Sep 17 00:00:00 2001
From: Nhat Nguyen <nhat.nguyen@elastic.co>
Date: Fri, 6 Dec 2024 12:01:36 -0800
Subject: [PATCH 092/119] Allow early termination of exchange source (#118129)

This change introduces the ability to gracefully terminate the exchange
source early by instructing all remote exchange sinks to stop their
computations.

1. When sufficient data has been accumulated (e.g., reaching the LIMIT),
the exchange source signals remote sinks to stop generating new pages,
allowing the query to finish sooner.

2. When users request immediate results, even if they are partial,
incomplete, or potentially inaccurate.
---
 .../operator/exchange/ExchangeService.java    | 31 ++++++++---
 .../exchange/ExchangeSourceHandler.java       | 32 ++++++++++-
 .../compute/operator/exchange/RemoteSink.java |  9 +--
 .../exchange/ExchangeServiceTests.java        | 55 ++++++++++++++++++-
 4 files changed, 111 insertions(+), 16 deletions(-)

diff --git a/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/exchange/ExchangeService.java b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/exchange/ExchangeService.java
index 00c68c4f48e86..62cc4daf5fde5 100644
--- a/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/exchange/ExchangeService.java
+++ b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/exchange/ExchangeService.java
@@ -14,6 +14,7 @@
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.ActionListenerResponseHandler;
 import org.elasticsearch.action.support.ChannelActionListener;
+import org.elasticsearch.action.support.SubscribableListener;
 import org.elasticsearch.common.component.AbstractLifecycleComponent;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
@@ -23,6 +24,7 @@
 import org.elasticsearch.common.util.concurrent.EsRejectedExecutionException;
 import org.elasticsearch.compute.data.BlockFactory;
 import org.elasticsearch.compute.data.BlockStreamInput;
+import org.elasticsearch.compute.data.Page;
 import org.elasticsearch.core.Nullable;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.tasks.CancellableTask;
@@ -40,10 +42,11 @@
 
 import java.io.IOException;
 import java.util.Map;
+import java.util.Objects;
 import java.util.Set;
 import java.util.concurrent.Executor;
-import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.concurrent.atomic.AtomicLong;
+import java.util.concurrent.atomic.AtomicReference;
 
 /**
  * {@link ExchangeService} is responsible for exchanging pages between exchange sinks and sources on the same or different nodes.
@@ -293,7 +296,7 @@ static final class TransportRemoteSink implements RemoteSink {
         final Executor responseExecutor;
 
         final AtomicLong estimatedPageSizeInBytes = new AtomicLong(0L);
-        final AtomicBoolean finished = new AtomicBoolean(false);
+        final AtomicReference<SubscribableListener<Void>> completionListenerRef = new AtomicReference<>(null);
 
         TransportRemoteSink(
             TransportService transportService,
@@ -318,13 +321,14 @@ public void fetchPageAsync(boolean allSourcesFinished, ActionListener<ExchangeRe
                 return;
             }
             // already finished
-            if (finished.get()) {
-                listener.onResponse(new ExchangeResponse(blockFactory, null, true));
+            SubscribableListener<Void> completionListener = completionListenerRef.get();
+            if (completionListener != null) {
+                completionListener.addListener(listener.map(unused -> new ExchangeResponse(blockFactory, null, true)));
                 return;
             }
             doFetchPageAsync(false, ActionListener.wrap(r -> {
                 if (r.finished()) {
-                    finished.set(true);
+                    completionListenerRef.compareAndSet(null, SubscribableListener.newSucceeded(null));
                 }
                 listener.onResponse(r);
             }, e -> close(ActionListener.running(() -> listener.onFailure(e)))));
@@ -356,10 +360,19 @@ private void doFetchPageAsync(boolean allSourcesFinished, ActionListener<Exchang
 
         @Override
         public void close(ActionListener<Void> listener) {
-            if (finished.compareAndSet(false, true)) {
-                doFetchPageAsync(true, listener.delegateFailure((l, unused) -> l.onResponse(null)));
-            } else {
-                listener.onResponse(null);
+            final SubscribableListener<Void> candidate = new SubscribableListener<>();
+            final SubscribableListener<Void> actual = completionListenerRef.updateAndGet(
+                curr -> Objects.requireNonNullElse(curr, candidate)
+            );
+            actual.addListener(listener);
+            if (candidate == actual) {
+                doFetchPageAsync(true, ActionListener.wrap(r -> {
+                    final Page page = r.takePage();
+                    if (page != null) {
+                        page.releaseBlocks();
+                    }
+                    candidate.onResponse(null);
+                }, e -> candidate.onResponse(null)));
             }
         }
     }
diff --git a/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/exchange/ExchangeSourceHandler.java b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/exchange/ExchangeSourceHandler.java
index b53ddea3da587..aa722695b841e 100644
--- a/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/exchange/ExchangeSourceHandler.java
+++ b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/exchange/ExchangeSourceHandler.java
@@ -12,6 +12,7 @@
 import org.elasticsearch.action.support.RefCountingRunnable;
 import org.elasticsearch.action.support.SubscribableListener;
 import org.elasticsearch.common.util.concurrent.AbstractRunnable;
+import org.elasticsearch.common.util.concurrent.ConcurrentCollections;
 import org.elasticsearch.compute.EsqlRefCountingListener;
 import org.elasticsearch.compute.data.Page;
 import org.elasticsearch.compute.operator.FailureCollector;
@@ -19,6 +20,7 @@
 import org.elasticsearch.core.Releasable;
 
 import java.util.List;
+import java.util.Map;
 import java.util.concurrent.Executor;
 import java.util.concurrent.atomic.AtomicInteger;
 
@@ -41,6 +43,9 @@ public final class ExchangeSourceHandler {
     // The final failure collected will be notified to callers via the {@code completionListener}.
     private final FailureCollector failure = new FailureCollector();
 
+    private final AtomicInteger nextSinkId = new AtomicInteger();
+    private final Map<Integer, RemoteSink> remoteSinks = ConcurrentCollections.newConcurrentMap();
+
     /**
      * Creates a new ExchangeSourceHandler.
      *
@@ -53,7 +58,9 @@ public ExchangeSourceHandler(int maxBufferSize, Executor fetchExecutor, ActionLi
         this.buffer = new ExchangeBuffer(maxBufferSize);
         this.fetchExecutor = fetchExecutor;
         this.outstandingSinks = new PendingInstances(() -> buffer.finish(false));
-        this.outstandingSources = new PendingInstances(() -> buffer.finish(true));
+        final PendingInstances closingSinks = new PendingInstances(() -> {});
+        closingSinks.trackNewInstance();
+        this.outstandingSources = new PendingInstances(() -> finishEarly(true, ActionListener.running(closingSinks::finishInstance)));
         buffer.addCompletionListener(ActionListener.running(() -> {
             final ActionListener<Void> listener = ActionListener.assertAtLeastOnce(completionListener);
             try (RefCountingRunnable refs = new RefCountingRunnable(() -> {
@@ -64,6 +71,7 @@ public ExchangeSourceHandler(int maxBufferSize, Executor fetchExecutor, ActionLi
                     listener.onResponse(null);
                 }
             })) {
+                closingSinks.completion.addListener(refs.acquireListener());
                 for (PendingInstances pending : List.of(outstandingSinks, outstandingSources)) {
                     // Create an outstanding instance and then finish to complete the completionListener
                     // if we haven't registered any instances of exchange sinks or exchange sources before.
@@ -257,7 +265,11 @@ void onSinkComplete() {
      * @see ExchangeSinkHandler#fetchPageAsync(boolean, ActionListener)
      */
     public void addRemoteSink(RemoteSink remoteSink, boolean failFast, int instances, ActionListener<Void> listener) {
-        final ActionListener<Void> sinkListener = ActionListener.assertAtLeastOnce(ActionListener.notifyOnce(listener));
+        final int sinkId = nextSinkId.incrementAndGet();
+        remoteSinks.put(sinkId, remoteSink);
+        final ActionListener<Void> sinkListener = ActionListener.assertAtLeastOnce(
+            ActionListener.notifyOnce(ActionListener.runBefore(listener, () -> remoteSinks.remove(sinkId)))
+        );
         fetchExecutor.execute(new AbstractRunnable() {
             @Override
             public void onFailure(Exception e) {
@@ -291,6 +303,22 @@ public Releasable addEmptySink() {
         return outstandingSinks::finishInstance;
     }
 
+    /**
+     * Gracefully terminates the exchange source early by instructing all remote exchange sinks to stop their computations.
+     * This can happen when the exchange source has accumulated enough data (e.g., reaching the LIMIT) or when users want to
+     * see the current result immediately.
+     *
+     * @param drainingPages whether to discard pages already fetched in the exchange
+     */
+    public void finishEarly(boolean drainingPages, ActionListener<Void> listener) {
+        buffer.finish(drainingPages);
+        try (EsqlRefCountingListener refs = new EsqlRefCountingListener(listener)) {
+            for (RemoteSink remoteSink : remoteSinks.values()) {
+                remoteSink.close(refs.acquire());
+            }
+        }
+    }
+
     private static class PendingInstances {
         private final AtomicInteger instances = new AtomicInteger();
         private final SubscribableListener<Void> completion = new SubscribableListener<>();
diff --git a/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/exchange/RemoteSink.java b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/exchange/RemoteSink.java
index aaa937ef17c0e..63b5d324ce851 100644
--- a/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/exchange/RemoteSink.java
+++ b/x-pack/plugin/esql/compute/src/main/java/org/elasticsearch/compute/operator/exchange/RemoteSink.java
@@ -8,6 +8,7 @@
 package org.elasticsearch.compute.operator.exchange;
 
 import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.compute.data.Page;
 
 public interface RemoteSink {
 
@@ -15,11 +16,11 @@ public interface RemoteSink {
 
     default void close(ActionListener<Void> listener) {
         fetchPageAsync(true, listener.delegateFailure((l, r) -> {
-            try {
-                r.close();
-            } finally {
-                l.onResponse(null);
+            final Page page = r.takePage();
+            if (page != null) {
+                page.releaseBlocks();
             }
+            l.onResponse(null);
         }));
     }
 }
diff --git a/x-pack/plugin/esql/compute/src/test/java/org/elasticsearch/compute/operator/exchange/ExchangeServiceTests.java b/x-pack/plugin/esql/compute/src/test/java/org/elasticsearch/compute/operator/exchange/ExchangeServiceTests.java
index fc6c850ba187b..8f7532b582bc2 100644
--- a/x-pack/plugin/esql/compute/src/test/java/org/elasticsearch/compute/operator/exchange/ExchangeServiceTests.java
+++ b/x-pack/plugin/esql/compute/src/test/java/org/elasticsearch/compute/operator/exchange/ExchangeServiceTests.java
@@ -55,7 +55,9 @@
 import java.util.ArrayList;
 import java.util.Collections;
 import java.util.List;
+import java.util.Queue;
 import java.util.Set;
+import java.util.concurrent.Semaphore;
 import java.util.concurrent.TimeUnit;
 import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.concurrent.atomic.AtomicInteger;
@@ -421,7 +423,7 @@ public void testExchangeSourceContinueOnFailure() {
         }
     }
 
-    public void testEarlyTerminate() {
+    public void testClosingSinks() {
         BlockFactory blockFactory = blockFactory();
         IntBlock block1 = blockFactory.newConstantIntBlockWith(1, 2);
         IntBlock block2 = blockFactory.newConstantIntBlockWith(1, 2);
@@ -441,6 +443,57 @@ public void testEarlyTerminate() {
         assertTrue(sink.isFinished());
     }
 
+    public void testFinishEarly() throws Exception {
+        ExchangeSourceHandler sourceHandler = new ExchangeSourceHandler(20, threadPool.generic(), ActionListener.noop());
+        Semaphore permits = new Semaphore(between(1, 5));
+        BlockFactory blockFactory = blockFactory();
+        Queue<Page> pages = ConcurrentCollections.newQueue();
+        ExchangeSource exchangeSource = sourceHandler.createExchangeSource();
+        AtomicBoolean sinkClosed = new AtomicBoolean();
+        PlainActionFuture<Void> sinkCompleted = new PlainActionFuture<>();
+        sourceHandler.addRemoteSink((allSourcesFinished, listener) -> {
+            if (allSourcesFinished) {
+                sinkClosed.set(true);
+                permits.release(10);
+                listener.onResponse(new ExchangeResponse(blockFactory, null, sinkClosed.get()));
+            } else {
+                try {
+                    if (permits.tryAcquire(between(0, 100), TimeUnit.MICROSECONDS)) {
+                        boolean closed = sinkClosed.get();
+                        final Page page;
+                        if (closed) {
+                            page = new Page(blockFactory.newConstantIntBlockWith(1, 1));
+                            pages.add(page);
+                        } else {
+                            page = null;
+                        }
+                        listener.onResponse(new ExchangeResponse(blockFactory, page, closed));
+                    } else {
+                        listener.onResponse(new ExchangeResponse(blockFactory, null, sinkClosed.get()));
+                    }
+                } catch (Exception e) {
+                    throw new AssertionError(e);
+                }
+            }
+        }, false, between(1, 3), sinkCompleted);
+        threadPool.schedule(
+            () -> sourceHandler.finishEarly(randomBoolean(), ActionListener.noop()),
+            TimeValue.timeValueMillis(between(0, 10)),
+            threadPool.generic()
+        );
+        sinkCompleted.actionGet();
+        Page p;
+        while ((p = exchangeSource.pollPage()) != null) {
+            assertSame(p, pages.poll());
+            p.releaseBlocks();
+        }
+        while ((p = pages.poll()) != null) {
+            p.releaseBlocks();
+        }
+        assertTrue(exchangeSource.isFinished());
+        exchangeSource.finish();
+    }
+
     public void testConcurrentWithTransportActions() {
         MockTransportService node0 = newTransportService();
         ExchangeService exchange0 = new ExchangeService(Settings.EMPTY, threadPool, ESQL_TEST_EXECUTOR, blockFactory());

From 11061713c51552fa04c16bdc74785454350159a4 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Fri, 6 Dec 2024 21:17:50 +0100
Subject: [PATCH 093/119] Unmute #108628 (#118152)

This should be fixed for a while now.

Closes #116249
---
 muted-tests.yml | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index 887b462fa122e..07072e9743c98 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -117,9 +117,6 @@ tests:
 - class: org.elasticsearch.xpack.deprecation.DeprecationHttpIT
   method: testDeprecatedSettingsReturnWarnings
   issue: https://github.com/elastic/elasticsearch/issues/108628
-- class: org.elasticsearch.action.search.SearchQueryThenFetchAsyncActionTests
-  method: testBottomFieldSort
-  issue: https://github.com/elastic/elasticsearch/issues/116249
 - class: org.elasticsearch.xpack.shutdown.NodeShutdownIT
   method: testAllocationPreventedForRemoval
   issue: https://github.com/elastic/elasticsearch/issues/116363

From 2619149bc677fec18376fb36c5a54aa3d260431d Mon Sep 17 00:00:00 2001
From: Luca Cavanna <javanna@apache.org>
Date: Fri, 6 Dec 2024 21:41:27 +0100
Subject: [PATCH 094/119] [TEST] Work around race condition when starting
 clusters in parallel (#118145)

With #117820 we are starting clusters in parallel in CCS related tests.

There is a race condition when calling RandomizedTest#isNightly, which
is called as part of `InternalTestCluster#beforeTest`.

See https://github.com/randomizedtesting/randomizedtesting/issues/311.
Until this is fixed upstream, we can simply call isNightly before
forking, which is going to trigger the lazy initialization of the inner
map that causes the race. From then on, all threads will have a
consistent view of it.

Closes #118124
---
 muted-tests.yml                                            | 3 ---
 .../elasticsearch/test/AbstractMultiClustersTestCase.java  | 7 +++++++
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/muted-tests.yml b/muted-tests.yml
index 07072e9743c98..a39265756599d 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -239,9 +239,6 @@ tests:
 - class: org.elasticsearch.packaging.test.ConfigurationTests
   method: test30SymlinkedDataPath
   issue: https://github.com/elastic/elasticsearch/issues/118111
-- class: org.elasticsearch.datastreams.ResolveClusterDataStreamIT
-  method: testClusterResolveWithDataStreamsUsingAlias
-  issue: https://github.com/elastic/elasticsearch/issues/118124
 - class: org.elasticsearch.packaging.test.KeystoreManagementTests
   method: test30KeystorePasswordFromFile
   issue: https://github.com/elastic/elasticsearch/issues/118123
diff --git a/test/framework/src/main/java/org/elasticsearch/test/AbstractMultiClustersTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/AbstractMultiClustersTestCase.java
index b4f91f68b8bb7..7cd7bce4db187 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/AbstractMultiClustersTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/AbstractMultiClustersTestCase.java
@@ -9,6 +9,8 @@
 
 package org.elasticsearch.test;
 
+import com.carrotsearch.randomizedtesting.RandomizedTest;
+
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
 import org.elasticsearch.action.admin.cluster.remote.RemoteInfoRequest;
@@ -108,6 +110,11 @@ public final void startClusters() throws Exception {
             MockTransportService.TestPlugin.class,
             getTestTransportPlugin()
         );
+        // We are going to initialize multiple clusters concurrently, but there is a race condition around the lazy initialization of test
+        // groups in GroupEvaluator across multiple threads. See https://github.com/randomizedtesting/randomizedtesting/issues/311.
+        // Calling isNightly before parallelizing is enough to work around that issue.
+        @SuppressWarnings("unused")
+        boolean nightly = RandomizedTest.isNightly();
         runInParallel(clusterAliases.size(), i -> {
             String clusterAlias = clusterAliases.get(i);
             final String clusterName = clusterAlias.equals(LOCAL_CLUSTER) ? "main-cluster" : clusterAlias;

From 467fdb879c6ed1ea084d02087a4afaa12babe7c6 Mon Sep 17 00:00:00 2001
From: Max Hniebergall <137079448+maxhniebergall@users.noreply.github.com>
Date: Fri, 6 Dec 2024 15:52:31 -0500
Subject: [PATCH 095/119] [Inference API] Add unified api for chat completions
 (#117589)

* Adding some shell classes

* modeling the request objects

* Writeable changes to schema

* Working parsing tests

* Creating a new action

* Add outbound request writing (WIP)

* Improvements to request serialization

* Adding separate transport classes

* separate out unified request and combine inputs

* Reworking unified inputs

* Adding unsupported operation calls

* Fixing parsing logic

* get the build working

* Update docs/changelog/117589.yaml

* Fixing injection issue

* Allowing model to be overridden but not working yet

* Fixing issues

* Switch field name for tool

* Add suport for toolCalls and refusal in streaming completion

* Working tool call response

* Separate unified and legacy code paths

* Updated the parser, but there are some class cast exceptions to fix

* Refactoring tests and request entities

* Parse response from OpenAI

* Removing unused request classes

* precommit

* Adding tests for UnifiedCompletionAction Request

* Refactoring stop to be a list of strings

* Testing for OpenAI response parsing

* Refactoring transport action tests to test unified validation code

* Fixing various tests

* Fixing license header

* Reformat streaming results

* Finalize response format

* remove debug logs

* remove changes for debugging

* Task type and base inference action tests

* Adding openai service tests

* Adding model tests

* tests for StreamingUnifiedChatCompletionResultsTests toXContentChunked

* Fixing change log and removing commented out code

* Switch usage to accept null

* Adding test for TestStreamingCompletionServiceExtension

* Avoid serializing empty lists + request entity tests

* Register named writeables from UnifiedCompletionRequest

* Removing commented code

* Clean up and add more of an explination

* remove duplicate test

* remove old todos

* Refactoring some duplication

* Adding javadoc

* Addressing feedback

---------

Co-authored-by: Jonathan Buttner <jonathan.buttner@elastic.co>
Co-authored-by: Jonathan Buttner <56361221+jonathan-buttner@users.noreply.github.com>
---
 docs/changelog/117589.yaml                    |   5 +
 .../xcontent/ChunkedToXContentHelper.java     |   9 +
 .../inference/InferenceService.java           |  17 +
 .../org/elasticsearch/inference/TaskType.java |   4 +
 .../inference/UnifiedCompletionRequest.java   | 425 +++++++++
 .../org/elasticsearch/test/ESTestCase.java    |  22 +-
 .../action/BaseInferenceActionRequest.java    |  31 +
 .../inference/action/InferenceAction.java     |   3 +-
 .../action/UnifiedCompletionAction.java       | 129 +++
 ...StreamingUnifiedChatCompletionResults.java | 329 +++++++
 .../action/InferenceActionRequestTests.java   |   3 +-
 .../UnifiedCompletionActionRequestTests.java  |  97 ++
 .../action/UnifiedCompletionRequestTests.java | 293 ++++++
 ...mingUnifiedChatCompletionResultsTests.java | 198 ++++
 .../authz/store/ReservedRolesStoreTests.java  |   1 +
 .../inference/InferenceBaseRestTest.java      |  32 +-
 .../xpack/inference/InferenceCrudIT.java      |  55 ++
 .../TestDenseInferenceServiceExtension.java   |  11 +
 .../mock/TestRerankingServiceExtension.java   |  11 +
 .../TestSparseInferenceServiceExtension.java  |  11 +
 ...stStreamingCompletionServiceExtension.java |  73 ++
 .../InferenceNamedWriteablesProvider.java     |   8 +
 .../xpack/inference/InferencePlugin.java      |  20 +-
 .../inference/UnifiedCompletionFeature.java   |  20 +
 .../action/BaseTransportInferenceAction.java  | 250 +++++
 .../action/TransportInferenceAction.java      | 219 +----
 ...sportUnifiedCompletionInferenceAction.java |  77 ++
 .../inference/common/DelegatingProcessor.java |  45 +-
 .../SingleInputSenderExecutableAction.java    |   9 +-
 .../action/openai/OpenAiActionCreator.java    |   2 +-
 ...baCloudSearchCompletionRequestManager.java |   2 +-
 ...onBedrockChatCompletionRequestManager.java |   8 +-
 .../AnthropicCompletionRequestManager.java    |   8 +-
 ...eAiStudioChatCompletionRequestManager.java |   8 +-
 .../AzureOpenAiCompletionRequestManager.java  |   8 +-
 .../http/sender/ChatCompletionInput.java      |  39 +
 .../CohereCompletionRequestManager.java       |   8 +-
 .../http/sender/DocumentsOnlyInput.java       |  10 +-
 ...oogleAiStudioCompletionRequestManager.java |   5 +-
 .../external/http/sender/InferenceInputs.java |  26 +-
 .../OpenAiCompletionRequestManager.java       |  12 +-
 ...OpenAiUnifiedCompletionRequestManager.java |  61 ++
 .../http/sender/QueryAndDocsInputs.java       |  11 +-
 .../http/sender/UnifiedChatInput.java         |  62 ++
 .../openai/OpenAiStreamingProcessor.java      |  18 +-
 ...iUnifiedChatCompletionResponseHandler.java |  34 +
 .../OpenAiUnifiedStreamingProcessor.java      | 287 ++++++
 .../GoogleAiStudioCompletionRequest.java      |   6 +-
 .../OpenAiChatCompletionRequestEntity.java    |  79 --
 ...> OpenAiUnifiedChatCompletionRequest.java} |  20 +-
 ...nAiUnifiedChatCompletionRequestEntity.java | 185 ++++
 .../inference/rest/BaseInferenceAction.java   |  32 +-
 .../xpack/inference/rest/Paths.java           |   6 +
 .../RestUnifiedCompletionInferenceAction.java |  49 +
 .../inference/services/SenderService.java     |  43 +-
 .../inference/services/ServiceUtils.java      |   4 +
 .../AlibabaCloudSearchService.java            |  14 +-
 .../amazonbedrock/AmazonBedrockService.java   |  12 +
 .../services/anthropic/AnthropicService.java  |  12 +
 .../azureaistudio/AzureAiStudioService.java   |  12 +
 .../azureopenai/AzureOpenAiService.java       |  12 +
 .../services/cohere/CohereService.java        |  12 +
 .../elastic/ElasticInferenceService.java      |  12 +
 .../ElasticsearchInternalService.java         |  12 +
 .../googleaistudio/GoogleAiStudioService.java |  15 +-
 .../googlevertexai/GoogleVertexAiService.java |  12 +
 .../huggingface/HuggingFaceService.java       |  13 +
 .../elser/HuggingFaceElserService.java        |  12 +
 .../ibmwatsonx/IbmWatsonxService.java         |  12 +
 .../services/mistral/MistralService.java      |  12 +
 .../services/openai/OpenAiService.java        |  27 +
 .../completion/OpenAiChatCompletionModel.java |  22 +
 ...enAiChatCompletionRequestTaskSettings.java |   1 -
 .../xpack/inference/TaskTypeTests.java        |  27 +
 .../elasticsearch/xpack/inference/Utils.java  |   3 +
 .../BaseTransportInferenceActionTestCase.java | 364 ++++++++
 .../action/TransportInferenceActionTests.java | 337 +------
 ...TransportUnifiedCompletionActionTests.java | 124 +++
 ...ingleInputSenderExecutableActionTests.java |  20 +-
 .../AmazonBedrockActionCreatorTests.java      |   5 +-
 .../AnthropicActionCreatorTests.java          |   7 +-
 .../AnthropicChatCompletionActionTests.java   |  12 +-
 .../AzureAiStudioActionAndCreatorTests.java   |   3 +-
 .../AzureOpenAiActionCreatorTests.java        |   7 +-
 .../AzureOpenAiCompletionActionTests.java     |  10 +-
 .../cohere/CohereActionCreatorTests.java      |   5 +-
 .../cohere/CohereCompletionActionTests.java   |  18 +-
 .../GoogleAiStudioCompletionActionTests.java  |  12 +-
 .../openai/OpenAiActionCreatorTests.java      |  21 +-
 .../OpenAiChatCompletionActionTests.java      |  19 +-
 .../AmazonBedrockMockRequestSender.java       |  12 +-
 .../AmazonBedrockRequestSenderTests.java      |   3 +-
 .../http/sender/InferenceInputsTests.java     |  40 +
 .../http/sender/UnifiedChatInputTests.java    |  46 +
 .../OpenAiUnifiedStreamingProcessorTests.java | 383 ++++++++
 .../GoogleAiStudioCompletionRequestTests.java |   6 +-
 ...penAiChatCompletionRequestEntityTests.java |  53 --
 ...ifiedChatCompletionRequestEntityTests.java | 856 ++++++++++++++++++
 ...nAiUnifiedChatCompletionRequestTests.java} |  59 +-
 .../rest/BaseInferenceActionTests.java        |  43 +
 ...UnifiedCompletionInferenceActionTests.java |  81 ++
 .../services/SenderServiceTests.java          |   9 +
 .../services/openai/OpenAiServiceTests.java   |  63 ++
 .../OpenAiChatCompletionModelTests.java       |  42 +-
 .../xpack/security/operator/Constants.java    |   1 +
 105 files changed, 5488 insertions(+), 867 deletions(-)
 create mode 100644 docs/changelog/117589.yaml
 create mode 100644 server/src/main/java/org/elasticsearch/inference/UnifiedCompletionRequest.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/BaseInferenceActionRequest.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/UnifiedCompletionAction.java
 create mode 100644 x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/results/StreamingUnifiedChatCompletionResults.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/action/UnifiedCompletionActionRequestTests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/action/UnifiedCompletionRequestTests.java
 create mode 100644 x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/results/StreamingUnifiedChatCompletionResultsTests.java
 create mode 100644 x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/UnifiedCompletionFeature.java
 create mode 100644 x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/action/BaseTransportInferenceAction.java
 create mode 100644 x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/action/TransportUnifiedCompletionInferenceAction.java
 create mode 100644 x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/ChatCompletionInput.java
 create mode 100644 x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/OpenAiUnifiedCompletionRequestManager.java
 create mode 100644 x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/UnifiedChatInput.java
 create mode 100644 x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/openai/OpenAiUnifiedChatCompletionResponseHandler.java
 create mode 100644 x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/openai/OpenAiUnifiedStreamingProcessor.java
 delete mode 100644 x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiChatCompletionRequestEntity.java
 rename x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/openai/{OpenAiChatCompletionRequest.java => OpenAiUnifiedChatCompletionRequest.java} (80%)
 create mode 100644 x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiUnifiedChatCompletionRequestEntity.java
 create mode 100644 x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rest/RestUnifiedCompletionInferenceAction.java
 create mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/TaskTypeTests.java
 create mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/action/BaseTransportInferenceActionTestCase.java
 create mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/action/TransportUnifiedCompletionActionTests.java
 create mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/http/sender/InferenceInputsTests.java
 create mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/http/sender/UnifiedChatInputTests.java
 create mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/openai/OpenAiUnifiedStreamingProcessorTests.java
 delete mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiChatCompletionRequestEntityTests.java
 create mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiUnifiedChatCompletionRequestEntityTests.java
 rename x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/openai/{OpenAiChatCompletionRequestTests.java => OpenAiUnifiedChatCompletionRequestTests.java} (75%)
 create mode 100644 x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rest/RestUnifiedCompletionInferenceActionTests.java

diff --git a/docs/changelog/117589.yaml b/docs/changelog/117589.yaml
new file mode 100644
index 0000000000000..e6880fd9477b5
--- /dev/null
+++ b/docs/changelog/117589.yaml
@@ -0,0 +1,5 @@
+pr: 117589
+summary: "Add Inference Unified API for chat completions for OpenAI"
+area: Machine Learning
+type: enhancement
+issues: []
diff --git a/server/src/main/java/org/elasticsearch/common/xcontent/ChunkedToXContentHelper.java b/server/src/main/java/org/elasticsearch/common/xcontent/ChunkedToXContentHelper.java
index 2e78cc6f516b1..6a5aa2943de92 100644
--- a/server/src/main/java/org/elasticsearch/common/xcontent/ChunkedToXContentHelper.java
+++ b/server/src/main/java/org/elasticsearch/common/xcontent/ChunkedToXContentHelper.java
@@ -12,6 +12,7 @@
 import org.elasticsearch.common.collect.Iterators;
 import org.elasticsearch.xcontent.ToXContent;
 
+import java.util.Collections;
 import java.util.Iterator;
 
 public enum ChunkedToXContentHelper {
@@ -53,6 +54,14 @@ public static Iterator<ToXContent> field(String name, String value) {
         return Iterators.single(((builder, params) -> builder.field(name, value)));
     }
 
+    public static Iterator<ToXContent> optionalField(String name, String value) {
+        if (value == null) {
+            return Collections.emptyIterator();
+        } else {
+            return field(name, value);
+        }
+    }
+
     /**
      * Creates an Iterator of a single ToXContent object that serializes the given object as a single chunk. Just wraps {@link
      * Iterators#single}, but still useful because it avoids any type ambiguity.
diff --git a/server/src/main/java/org/elasticsearch/inference/InferenceService.java b/server/src/main/java/org/elasticsearch/inference/InferenceService.java
index 4497254aad1f0..c2d690d8160ac 100644
--- a/server/src/main/java/org/elasticsearch/inference/InferenceService.java
+++ b/server/src/main/java/org/elasticsearch/inference/InferenceService.java
@@ -112,6 +112,23 @@ void infer(
     );
 
     /**
+     * Perform completion inference on the model using the unified schema.
+     *
+     * @param model        The model
+     * @param request Parameters for the request
+     * @param timeout      The timeout for the request
+     * @param listener     Inference result listener
+     */
+    void unifiedCompletionInfer(
+        Model model,
+        UnifiedCompletionRequest request,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    );
+
+    /**
+     * Chunk long text.
+     *
      * @param model           The model
      * @param query           Inference query, mainly for re-ranking
      * @param input           Inference input
diff --git a/server/src/main/java/org/elasticsearch/inference/TaskType.java b/server/src/main/java/org/elasticsearch/inference/TaskType.java
index b0e5bababbbc0..fcb8ea7213795 100644
--- a/server/src/main/java/org/elasticsearch/inference/TaskType.java
+++ b/server/src/main/java/org/elasticsearch/inference/TaskType.java
@@ -38,6 +38,10 @@ public static TaskType fromString(String name) {
     }
 
     public static TaskType fromStringOrStatusException(String name) {
+        if (name == null) {
+            throw new ElasticsearchStatusException("Task type must not be null", RestStatus.BAD_REQUEST);
+        }
+
         try {
             TaskType taskType = TaskType.fromString(name);
             return Objects.requireNonNull(taskType);
diff --git a/server/src/main/java/org/elasticsearch/inference/UnifiedCompletionRequest.java b/server/src/main/java/org/elasticsearch/inference/UnifiedCompletionRequest.java
new file mode 100644
index 0000000000000..e596be626b518
--- /dev/null
+++ b/server/src/main/java/org/elasticsearch/inference/UnifiedCompletionRequest.java
@@ -0,0 +1,425 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+package org.elasticsearch.inference;
+
+import org.elasticsearch.common.io.stream.NamedWriteable;
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.xcontent.XContentParserUtils;
+import org.elasticsearch.core.Nullable;
+import org.elasticsearch.xcontent.ConstructingObjectParser;
+import org.elasticsearch.xcontent.ObjectParser;
+import org.elasticsearch.xcontent.ParseField;
+import org.elasticsearch.xcontent.XContentParseException;
+import org.elasticsearch.xcontent.XContentParser;
+
+import java.io.IOException;
+import java.util.List;
+import java.util.Map;
+
+import static org.elasticsearch.xcontent.ConstructingObjectParser.constructorArg;
+import static org.elasticsearch.xcontent.ConstructingObjectParser.optionalConstructorArg;
+
+public record UnifiedCompletionRequest(
+    List<Message> messages,
+    @Nullable String model,
+    @Nullable Long maxCompletionTokens,
+    @Nullable List<String> stop,
+    @Nullable Float temperature,
+    @Nullable ToolChoice toolChoice,
+    @Nullable List<Tool> tools,
+    @Nullable Float topP
+) implements Writeable {
+
+    public sealed interface Content extends NamedWriteable permits ContentObjects, ContentString {}
+
+    @SuppressWarnings("unchecked")
+    public static final ConstructingObjectParser<UnifiedCompletionRequest, Void> PARSER = new ConstructingObjectParser<>(
+        UnifiedCompletionRequest.class.getSimpleName(),
+        args -> new UnifiedCompletionRequest(
+            (List<Message>) args[0],
+            (String) args[1],
+            (Long) args[2],
+            (List<String>) args[3],
+            (Float) args[4],
+            (ToolChoice) args[5],
+            (List<Tool>) args[6],
+            (Float) args[7]
+        )
+    );
+
+    static {
+        PARSER.declareObjectArray(constructorArg(), Message.PARSER::apply, new ParseField("messages"));
+        PARSER.declareString(optionalConstructorArg(), new ParseField("model"));
+        PARSER.declareLong(optionalConstructorArg(), new ParseField("max_completion_tokens"));
+        PARSER.declareStringArray(optionalConstructorArg(), new ParseField("stop"));
+        PARSER.declareFloat(optionalConstructorArg(), new ParseField("temperature"));
+        PARSER.declareField(
+            optionalConstructorArg(),
+            (p, c) -> parseToolChoice(p),
+            new ParseField("tool_choice"),
+            ObjectParser.ValueType.OBJECT_OR_STRING
+        );
+        PARSER.declareObjectArray(optionalConstructorArg(), Tool.PARSER::apply, new ParseField("tools"));
+        PARSER.declareFloat(optionalConstructorArg(), new ParseField("top_p"));
+    }
+
+    public static List<NamedWriteableRegistry.Entry> getNamedWriteables() {
+        return List.of(
+            new NamedWriteableRegistry.Entry(Content.class, ContentObjects.NAME, ContentObjects::new),
+            new NamedWriteableRegistry.Entry(Content.class, ContentString.NAME, ContentString::new),
+            new NamedWriteableRegistry.Entry(ToolChoice.class, ToolChoiceObject.NAME, ToolChoiceObject::new),
+            new NamedWriteableRegistry.Entry(ToolChoice.class, ToolChoiceString.NAME, ToolChoiceString::new)
+        );
+    }
+
+    public static UnifiedCompletionRequest of(List<Message> messages) {
+        return new UnifiedCompletionRequest(messages, null, null, null, null, null, null, null);
+    }
+
+    public UnifiedCompletionRequest(StreamInput in) throws IOException {
+        this(
+            in.readCollectionAsImmutableList(Message::new),
+            in.readOptionalString(),
+            in.readOptionalVLong(),
+            in.readOptionalStringCollectionAsList(),
+            in.readOptionalFloat(),
+            in.readOptionalNamedWriteable(ToolChoice.class),
+            in.readOptionalCollectionAsList(Tool::new),
+            in.readOptionalFloat()
+        );
+    }
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+        out.writeCollection(messages);
+        out.writeOptionalString(model);
+        out.writeOptionalVLong(maxCompletionTokens);
+        out.writeOptionalStringCollection(stop);
+        out.writeOptionalFloat(temperature);
+        out.writeOptionalNamedWriteable(toolChoice);
+        out.writeOptionalCollection(tools);
+        out.writeOptionalFloat(topP);
+    }
+
+    public record Message(Content content, String role, @Nullable String name, @Nullable String toolCallId, List<ToolCall> toolCalls)
+        implements
+            Writeable {
+
+        @SuppressWarnings("unchecked")
+        static final ConstructingObjectParser<Message, Void> PARSER = new ConstructingObjectParser<>(
+            Message.class.getSimpleName(),
+            args -> new Message((Content) args[0], (String) args[1], (String) args[2], (String) args[3], (List<ToolCall>) args[4])
+        );
+
+        static {
+            PARSER.declareField(constructorArg(), (p, c) -> parseContent(p), new ParseField("content"), ObjectParser.ValueType.VALUE_ARRAY);
+            PARSER.declareString(constructorArg(), new ParseField("role"));
+            PARSER.declareString(optionalConstructorArg(), new ParseField("name"));
+            PARSER.declareString(optionalConstructorArg(), new ParseField("tool_call_id"));
+            PARSER.declareObjectArray(optionalConstructorArg(), ToolCall.PARSER::apply, new ParseField("tool_calls"));
+        }
+
+        private static Content parseContent(XContentParser parser) throws IOException {
+            var token = parser.currentToken();
+            if (token == XContentParser.Token.START_ARRAY) {
+                var parsedContentObjects = XContentParserUtils.parseList(parser, (p) -> ContentObject.PARSER.apply(p, null));
+                return new ContentObjects(parsedContentObjects);
+            } else if (token == XContentParser.Token.VALUE_STRING) {
+                return ContentString.of(parser);
+            }
+
+            throw new XContentParseException("Expected an array start token or a value string token but found token [" + token + "]");
+        }
+
+        public Message(StreamInput in) throws IOException {
+            this(
+                in.readNamedWriteable(Content.class),
+                in.readString(),
+                in.readOptionalString(),
+                in.readOptionalString(),
+                in.readOptionalCollectionAsList(ToolCall::new)
+            );
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            out.writeNamedWriteable(content);
+            out.writeString(role);
+            out.writeOptionalString(name);
+            out.writeOptionalString(toolCallId);
+            out.writeOptionalCollection(toolCalls);
+        }
+    }
+
+    public record ContentObjects(List<ContentObject> contentObjects) implements Content, NamedWriteable {
+
+        public static final String NAME = "content_objects";
+
+        public ContentObjects(StreamInput in) throws IOException {
+            this(in.readCollectionAsImmutableList(ContentObject::new));
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            out.writeCollection(contentObjects);
+        }
+
+        @Override
+        public String getWriteableName() {
+            return NAME;
+        }
+    }
+
+    public record ContentObject(String text, String type) implements Writeable {
+        static final ConstructingObjectParser<ContentObject, Void> PARSER = new ConstructingObjectParser<>(
+            ContentObject.class.getSimpleName(),
+            args -> new ContentObject((String) args[0], (String) args[1])
+        );
+
+        static {
+            PARSER.declareString(constructorArg(), new ParseField("text"));
+            PARSER.declareString(constructorArg(), new ParseField("type"));
+        }
+
+        public ContentObject(StreamInput in) throws IOException {
+            this(in.readString(), in.readString());
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            out.writeString(text);
+            out.writeString(type);
+        }
+
+        public String toString() {
+            return text + ":" + type;
+        }
+
+    }
+
+    public record ContentString(String content) implements Content, NamedWriteable {
+        public static final String NAME = "content_string";
+
+        public static ContentString of(XContentParser parser) throws IOException {
+            var content = parser.text();
+            return new ContentString(content);
+        }
+
+        public ContentString(StreamInput in) throws IOException {
+            this(in.readString());
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            out.writeString(content);
+        }
+
+        @Override
+        public String getWriteableName() {
+            return NAME;
+        }
+
+        public String toString() {
+            return content;
+        }
+    }
+
+    public record ToolCall(String id, FunctionField function, String type) implements Writeable {
+
+        static final ConstructingObjectParser<ToolCall, Void> PARSER = new ConstructingObjectParser<>(
+            ToolCall.class.getSimpleName(),
+            args -> new ToolCall((String) args[0], (FunctionField) args[1], (String) args[2])
+        );
+
+        static {
+            PARSER.declareString(constructorArg(), new ParseField("id"));
+            PARSER.declareObject(constructorArg(), FunctionField.PARSER::apply, new ParseField("function"));
+            PARSER.declareString(constructorArg(), new ParseField("type"));
+        }
+
+        public ToolCall(StreamInput in) throws IOException {
+            this(in.readString(), new FunctionField(in), in.readString());
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            out.writeString(id);
+            function.writeTo(out);
+            out.writeString(type);
+        }
+
+        public record FunctionField(String arguments, String name) implements Writeable {
+            static final ConstructingObjectParser<FunctionField, Void> PARSER = new ConstructingObjectParser<>(
+                "tool_call_function_field",
+                args -> new FunctionField((String) args[0], (String) args[1])
+            );
+
+            static {
+                PARSER.declareString(constructorArg(), new ParseField("arguments"));
+                PARSER.declareString(constructorArg(), new ParseField("name"));
+            }
+
+            public FunctionField(StreamInput in) throws IOException {
+                this(in.readString(), in.readString());
+            }
+
+            @Override
+            public void writeTo(StreamOutput out) throws IOException {
+                out.writeString(arguments);
+                out.writeString(name);
+            }
+        }
+    }
+
+    private static ToolChoice parseToolChoice(XContentParser parser) throws IOException {
+        var token = parser.currentToken();
+        if (token == XContentParser.Token.START_OBJECT) {
+            return ToolChoiceObject.PARSER.apply(parser, null);
+        } else if (token == XContentParser.Token.VALUE_STRING) {
+            return ToolChoiceString.of(parser);
+        }
+
+        throw new XContentParseException("Unsupported token [" + token + "]");
+    }
+
+    public sealed interface ToolChoice extends NamedWriteable permits ToolChoiceObject, ToolChoiceString {}
+
+    public record ToolChoiceObject(String type, FunctionField function) implements ToolChoice, NamedWriteable {
+
+        public static final String NAME = "tool_choice_object";
+
+        static final ConstructingObjectParser<ToolChoiceObject, Void> PARSER = new ConstructingObjectParser<>(
+            ToolChoiceObject.class.getSimpleName(),
+            args -> new ToolChoiceObject((String) args[0], (FunctionField) args[1])
+        );
+
+        static {
+            PARSER.declareString(constructorArg(), new ParseField("type"));
+            PARSER.declareObject(constructorArg(), FunctionField.PARSER::apply, new ParseField("function"));
+        }
+
+        public ToolChoiceObject(StreamInput in) throws IOException {
+            this(in.readString(), new FunctionField(in));
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            out.writeString(type);
+            function.writeTo(out);
+        }
+
+        @Override
+        public String getWriteableName() {
+            return NAME;
+        }
+
+        public record FunctionField(String name) implements Writeable {
+            static final ConstructingObjectParser<FunctionField, Void> PARSER = new ConstructingObjectParser<>(
+                "tool_choice_function_field",
+                args -> new FunctionField((String) args[0])
+            );
+
+            static {
+                PARSER.declareString(constructorArg(), new ParseField("name"));
+            }
+
+            public FunctionField(StreamInput in) throws IOException {
+                this(in.readString());
+            }
+
+            @Override
+            public void writeTo(StreamOutput out) throws IOException {
+                out.writeString(name);
+            }
+        }
+    }
+
+    public record ToolChoiceString(String value) implements ToolChoice, NamedWriteable {
+        public static final String NAME = "tool_choice_string";
+
+        public static ToolChoiceString of(XContentParser parser) throws IOException {
+            var content = parser.text();
+            return new ToolChoiceString(content);
+        }
+
+        public ToolChoiceString(StreamInput in) throws IOException {
+            this(in.readString());
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            out.writeString(value);
+        }
+
+        @Override
+        public String getWriteableName() {
+            return NAME;
+        }
+    }
+
+    public record Tool(String type, FunctionField function) implements Writeable {
+
+        static final ConstructingObjectParser<Tool, Void> PARSER = new ConstructingObjectParser<>(
+            Tool.class.getSimpleName(),
+            args -> new Tool((String) args[0], (FunctionField) args[1])
+        );
+
+        static {
+            PARSER.declareString(constructorArg(), new ParseField("type"));
+            PARSER.declareObject(constructorArg(), FunctionField.PARSER::apply, new ParseField("function"));
+        }
+
+        public Tool(StreamInput in) throws IOException {
+            this(in.readString(), new FunctionField(in));
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            out.writeString(type);
+            function.writeTo(out);
+        }
+
+        public record FunctionField(
+            @Nullable String description,
+            String name,
+            @Nullable Map<String, Object> parameters,
+            @Nullable Boolean strict
+        ) implements Writeable {
+
+            @SuppressWarnings("unchecked")
+            static final ConstructingObjectParser<FunctionField, Void> PARSER = new ConstructingObjectParser<>(
+                "tool_function_field",
+                args -> new FunctionField((String) args[0], (String) args[1], (Map<String, Object>) args[2], (Boolean) args[3])
+            );
+
+            static {
+                PARSER.declareString(optionalConstructorArg(), new ParseField("description"));
+                PARSER.declareString(constructorArg(), new ParseField("name"));
+                PARSER.declareObject(optionalConstructorArg(), (p, c) -> p.mapOrdered(), new ParseField("parameters"));
+                PARSER.declareBoolean(optionalConstructorArg(), new ParseField("strict"));
+            }
+
+            public FunctionField(StreamInput in) throws IOException {
+                this(in.readOptionalString(), in.readString(), in.readGenericMap(), in.readOptionalBoolean());
+            }
+
+            @Override
+            public void writeTo(StreamOutput out) throws IOException {
+                out.writeOptionalString(description);
+                out.writeString(name);
+                out.writeGenericMap(parameters);
+                out.writeOptionalBoolean(strict);
+            }
+        }
+    }
+}
diff --git a/test/framework/src/main/java/org/elasticsearch/test/ESTestCase.java b/test/framework/src/main/java/org/elasticsearch/test/ESTestCase.java
index d983fc854bdfd..a71f61740e17b 100644
--- a/test/framework/src/main/java/org/elasticsearch/test/ESTestCase.java
+++ b/test/framework/src/main/java/org/elasticsearch/test/ESTestCase.java
@@ -1205,10 +1205,30 @@ public static SecureString randomSecureStringOfLength(int codeUnits) {
         return new SecureString(randomAlpha.toCharArray());
     }
 
-    public static String randomNullOrAlphaOfLength(int codeUnits) {
+    public static String randomAlphaOfLengthOrNull(int codeUnits) {
         return randomBoolean() ? null : randomAlphaOfLength(codeUnits);
     }
 
+    public static Long randomLongOrNull() {
+        return randomBoolean() ? null : randomLong();
+    }
+
+    public static Long randomPositiveLongOrNull() {
+        return randomBoolean() ? null : randomNonNegativeLong();
+    }
+
+    public static Integer randomIntOrNull() {
+        return randomBoolean() ? null : randomInt();
+    }
+
+    public static Integer randomPositiveIntOrNull() {
+        return randomBoolean() ? null : randomNonNegativeInt();
+    }
+
+    public static Float randomFloatOrNull() {
+        return randomBoolean() ? null : randomFloat();
+    }
+
     /**
      * Creates a valid random identifier such as node id or index name
      */
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/BaseInferenceActionRequest.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/BaseInferenceActionRequest.java
new file mode 100644
index 0000000000000..e426574c52ce6
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/BaseInferenceActionRequest.java
@@ -0,0 +1,31 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.core.inference.action;
+
+import org.elasticsearch.action.ActionRequest;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.inference.TaskType;
+
+import java.io.IOException;
+
+public abstract class BaseInferenceActionRequest extends ActionRequest {
+
+    public BaseInferenceActionRequest() {
+        super();
+    }
+
+    public BaseInferenceActionRequest(StreamInput in) throws IOException {
+        super(in);
+    }
+
+    public abstract boolean isStreaming();
+
+    public abstract TaskType getTaskType();
+
+    public abstract String getInferenceEntityId();
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/InferenceAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/InferenceAction.java
index a19edd5a08162..f88909ba4208e 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/InferenceAction.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/InferenceAction.java
@@ -10,7 +10,6 @@
 import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.TransportVersion;
 import org.elasticsearch.TransportVersions;
-import org.elasticsearch.action.ActionRequest;
 import org.elasticsearch.action.ActionRequestValidationException;
 import org.elasticsearch.action.ActionResponse;
 import org.elasticsearch.action.ActionType;
@@ -54,7 +53,7 @@ public InferenceAction() {
         super(NAME);
     }
 
-    public static class Request extends ActionRequest {
+    public static class Request extends BaseInferenceActionRequest {
 
         public static final TimeValue DEFAULT_TIMEOUT = TimeValue.timeValueSeconds(30);
         public static final ParseField INPUT = new ParseField("input");
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/UnifiedCompletionAction.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/UnifiedCompletionAction.java
new file mode 100644
index 0000000000000..8d121463fb465
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/action/UnifiedCompletionAction.java
@@ -0,0 +1,129 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.core.inference.action;
+
+import org.elasticsearch.action.ActionRequestValidationException;
+import org.elasticsearch.action.ActionType;
+import org.elasticsearch.common.io.stream.StreamInput;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.core.TimeValue;
+import org.elasticsearch.inference.TaskType;
+import org.elasticsearch.inference.UnifiedCompletionRequest;
+import org.elasticsearch.xcontent.XContentParser;
+
+import java.io.IOException;
+import java.util.Objects;
+
+public class UnifiedCompletionAction extends ActionType<InferenceAction.Response> {
+    public static final UnifiedCompletionAction INSTANCE = new UnifiedCompletionAction();
+    public static final String NAME = "cluster:monitor/xpack/inference/unified";
+
+    public UnifiedCompletionAction() {
+        super(NAME);
+    }
+
+    public static class Request extends BaseInferenceActionRequest {
+        public static Request parseRequest(String inferenceEntityId, TaskType taskType, TimeValue timeout, XContentParser parser)
+            throws IOException {
+            var unifiedRequest = UnifiedCompletionRequest.PARSER.apply(parser, null);
+            return new Request(inferenceEntityId, taskType, unifiedRequest, timeout);
+        }
+
+        private final String inferenceEntityId;
+        private final TaskType taskType;
+        private final UnifiedCompletionRequest unifiedCompletionRequest;
+        private final TimeValue timeout;
+
+        public Request(String inferenceEntityId, TaskType taskType, UnifiedCompletionRequest unifiedCompletionRequest, TimeValue timeout) {
+            this.inferenceEntityId = Objects.requireNonNull(inferenceEntityId);
+            this.taskType = Objects.requireNonNull(taskType);
+            this.unifiedCompletionRequest = Objects.requireNonNull(unifiedCompletionRequest);
+            this.timeout = Objects.requireNonNull(timeout);
+        }
+
+        public Request(StreamInput in) throws IOException {
+            super(in);
+            this.inferenceEntityId = in.readString();
+            this.taskType = TaskType.fromStream(in);
+            this.unifiedCompletionRequest = new UnifiedCompletionRequest(in);
+            this.timeout = in.readTimeValue();
+        }
+
+        public TaskType getTaskType() {
+            return taskType;
+        }
+
+        public String getInferenceEntityId() {
+            return inferenceEntityId;
+        }
+
+        public UnifiedCompletionRequest getUnifiedCompletionRequest() {
+            return unifiedCompletionRequest;
+        }
+
+        /**
+         * The Unified API only supports streaming so we always return true here.
+         * @return true
+         */
+        public boolean isStreaming() {
+            return true;
+        }
+
+        public TimeValue getTimeout() {
+            return timeout;
+        }
+
+        @Override
+        public ActionRequestValidationException validate() {
+            if (unifiedCompletionRequest == null || unifiedCompletionRequest.messages() == null) {
+                var e = new ActionRequestValidationException();
+                e.addValidationError("Field [messages] cannot be null");
+                return e;
+            }
+
+            if (unifiedCompletionRequest.messages().isEmpty()) {
+                var e = new ActionRequestValidationException();
+                e.addValidationError("Field [messages] cannot be an empty array");
+                return e;
+            }
+
+            if (taskType.isAnyOrSame(TaskType.COMPLETION) == false) {
+                var e = new ActionRequestValidationException();
+                e.addValidationError("Field [taskType] must be [completion]");
+                return e;
+            }
+
+            return null;
+        }
+
+        @Override
+        public void writeTo(StreamOutput out) throws IOException {
+            super.writeTo(out);
+            out.writeString(inferenceEntityId);
+            taskType.writeTo(out);
+            unifiedCompletionRequest.writeTo(out);
+            out.writeTimeValue(timeout);
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (o == null || getClass() != o.getClass()) return false;
+            Request request = (Request) o;
+            return Objects.equals(inferenceEntityId, request.inferenceEntityId)
+                && taskType == request.taskType
+                && Objects.equals(unifiedCompletionRequest, request.unifiedCompletionRequest)
+                && Objects.equals(timeout, request.timeout);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(inferenceEntityId, taskType, unifiedCompletionRequest, timeout);
+        }
+    }
+
+}
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/results/StreamingUnifiedChatCompletionResults.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/results/StreamingUnifiedChatCompletionResults.java
new file mode 100644
index 0000000000000..90038c67036c4
--- /dev/null
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/inference/results/StreamingUnifiedChatCompletionResults.java
@@ -0,0 +1,329 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.core.inference.results;
+
+import org.elasticsearch.common.collect.Iterators;
+import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.xcontent.ChunkedToXContent;
+import org.elasticsearch.common.xcontent.ChunkedToXContentHelper;
+import org.elasticsearch.inference.InferenceResults;
+import org.elasticsearch.inference.InferenceServiceResults;
+import org.elasticsearch.xcontent.ToXContent;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.Deque;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Map;
+import java.util.concurrent.Flow;
+
+/**
+ * Chat Completion results that only contain a Flow.Publisher.
+ */
+public record StreamingUnifiedChatCompletionResults(Flow.Publisher<? extends ChunkedToXContent> publisher)
+    implements
+        InferenceServiceResults {
+
+    public static final String NAME = "chat_completion_chunk";
+    public static final String MODEL_FIELD = "model";
+    public static final String OBJECT_FIELD = "object";
+    public static final String USAGE_FIELD = "usage";
+    public static final String INDEX_FIELD = "index";
+    public static final String ID_FIELD = "id";
+    public static final String FUNCTION_NAME_FIELD = "name";
+    public static final String FUNCTION_ARGUMENTS_FIELD = "arguments";
+    public static final String FUNCTION_FIELD = "function";
+    public static final String CHOICES_FIELD = "choices";
+    public static final String DELTA_FIELD = "delta";
+    public static final String CONTENT_FIELD = "content";
+    public static final String REFUSAL_FIELD = "refusal";
+    public static final String ROLE_FIELD = "role";
+    private static final String TOOL_CALLS_FIELD = "tool_calls";
+    public static final String FINISH_REASON_FIELD = "finish_reason";
+    public static final String COMPLETION_TOKENS_FIELD = "completion_tokens";
+    public static final String TOTAL_TOKENS_FIELD = "total_tokens";
+    public static final String PROMPT_TOKENS_FIELD = "prompt_tokens";
+    public static final String TYPE_FIELD = "type";
+
+    @Override
+    public boolean isStreaming() {
+        return true;
+    }
+
+    @Override
+    public List<? extends InferenceResults> transformToCoordinationFormat() {
+        throw new UnsupportedOperationException("Not implemented");
+    }
+
+    @Override
+    public List<? extends InferenceResults> transformToLegacyFormat() {
+        throw new UnsupportedOperationException("Not implemented");
+    }
+
+    @Override
+    public Map<String, Object> asMap() {
+        throw new UnsupportedOperationException("Not implemented");
+    }
+
+    @Override
+    public String getWriteableName() {
+        throw new UnsupportedOperationException("Not implemented");
+    }
+
+    @Override
+    public void writeTo(StreamOutput out) throws IOException {
+        throw new UnsupportedOperationException("Not implemented");
+    }
+
+    @Override
+    public Iterator<? extends ToXContent> toXContentChunked(ToXContent.Params params) {
+        throw new UnsupportedOperationException("Not implemented");
+    }
+
+    public record Results(Deque<ChatCompletionChunk> chunks) implements ChunkedToXContent {
+        @Override
+        public Iterator<? extends ToXContent> toXContentChunked(ToXContent.Params params) {
+            return Iterators.concat(Iterators.flatMap(chunks.iterator(), c -> c.toXContentChunked(params)));
+        }
+    }
+
+    public static class ChatCompletionChunk implements ChunkedToXContent {
+        private final String id;
+
+        public String getId() {
+            return id;
+        }
+
+        public List<Choice> getChoices() {
+            return choices;
+        }
+
+        public String getModel() {
+            return model;
+        }
+
+        public String getObject() {
+            return object;
+        }
+
+        public Usage getUsage() {
+            return usage;
+        }
+
+        private final List<Choice> choices;
+        private final String model;
+        private final String object;
+        private final ChatCompletionChunk.Usage usage;
+
+        public ChatCompletionChunk(String id, List<Choice> choices, String model, String object, ChatCompletionChunk.Usage usage) {
+            this.id = id;
+            this.choices = choices;
+            this.model = model;
+            this.object = object;
+            this.usage = usage;
+        }
+
+        @Override
+        public Iterator<? extends ToXContent> toXContentChunked(ToXContent.Params params) {
+
+            Iterator<? extends ToXContent> choicesIterator = Collections.emptyIterator();
+            if (choices != null) {
+                choicesIterator = Iterators.concat(
+                    ChunkedToXContentHelper.startArray(CHOICES_FIELD),
+                    Iterators.flatMap(choices.iterator(), c -> c.toXContentChunked(params)),
+                    ChunkedToXContentHelper.endArray()
+                );
+            }
+
+            Iterator<? extends ToXContent> usageIterator = Collections.emptyIterator();
+            if (usage != null) {
+                usageIterator = Iterators.concat(
+                    ChunkedToXContentHelper.startObject(USAGE_FIELD),
+                    ChunkedToXContentHelper.field(COMPLETION_TOKENS_FIELD, usage.completionTokens()),
+                    ChunkedToXContentHelper.field(PROMPT_TOKENS_FIELD, usage.promptTokens()),
+                    ChunkedToXContentHelper.field(TOTAL_TOKENS_FIELD, usage.totalTokens()),
+                    ChunkedToXContentHelper.endObject()
+                );
+            }
+
+            return Iterators.concat(
+                ChunkedToXContentHelper.startObject(),
+                ChunkedToXContentHelper.field(ID_FIELD, id),
+                choicesIterator,
+                ChunkedToXContentHelper.field(MODEL_FIELD, model),
+                ChunkedToXContentHelper.field(OBJECT_FIELD, object),
+                usageIterator,
+                ChunkedToXContentHelper.endObject()
+            );
+        }
+
+        public record Choice(ChatCompletionChunk.Choice.Delta delta, String finishReason, int index) {
+
+            /*
+              choices: Array<{
+                delta: { ... };
+                finish_reason: string | null;
+                index: number;
+              }>;
+             */
+            public Iterator<? extends ToXContent> toXContentChunked(ToXContent.Params params) {
+                return Iterators.concat(
+                    ChunkedToXContentHelper.startObject(),
+                    delta.toXContentChunked(params),
+                    ChunkedToXContentHelper.optionalField(FINISH_REASON_FIELD, finishReason),
+                    ChunkedToXContentHelper.field(INDEX_FIELD, index),
+                    ChunkedToXContentHelper.endObject()
+                );
+            }
+
+            public static class Delta {
+                private final String content;
+                private final String refusal;
+                private final String role;
+                private List<ToolCall> toolCalls;
+
+                public Delta(String content, String refusal, String role, List<ToolCall> toolCalls) {
+                    this.content = content;
+                    this.refusal = refusal;
+                    this.role = role;
+                    this.toolCalls = toolCalls;
+                }
+
+                /*
+                delta: {
+                    content?: string | null;
+                    refusal?: string | null;
+                    role?: 'system' | 'user' | 'assistant' | 'tool';
+                    tool_calls?: Array<{ ... }>;
+                };
+                */
+                public Iterator<? extends ToXContent> toXContentChunked(ToXContent.Params params) {
+                    var xContent = Iterators.concat(
+                        ChunkedToXContentHelper.startObject(DELTA_FIELD),
+                        ChunkedToXContentHelper.optionalField(CONTENT_FIELD, content),
+                        ChunkedToXContentHelper.optionalField(REFUSAL_FIELD, refusal),
+                        ChunkedToXContentHelper.optionalField(ROLE_FIELD, role)
+                    );
+
+                    if (toolCalls != null && toolCalls.isEmpty() == false) {
+                        xContent = Iterators.concat(
+                            xContent,
+                            ChunkedToXContentHelper.startArray(TOOL_CALLS_FIELD),
+                            Iterators.flatMap(toolCalls.iterator(), t -> t.toXContentChunked(params)),
+                            ChunkedToXContentHelper.endArray()
+                        );
+                    }
+                    xContent = Iterators.concat(xContent, ChunkedToXContentHelper.endObject());
+                    return xContent;
+
+                }
+
+                public String getContent() {
+                    return content;
+                }
+
+                public String getRefusal() {
+                    return refusal;
+                }
+
+                public String getRole() {
+                    return role;
+                }
+
+                public List<ToolCall> getToolCalls() {
+                    return toolCalls;
+                }
+
+                public static class ToolCall {
+                    private final int index;
+                    private final String id;
+                    public ChatCompletionChunk.Choice.Delta.ToolCall.Function function;
+                    private final String type;
+
+                    public ToolCall(int index, String id, ChatCompletionChunk.Choice.Delta.ToolCall.Function function, String type) {
+                        this.index = index;
+                        this.id = id;
+                        this.function = function;
+                        this.type = type;
+                    }
+
+                    public int getIndex() {
+                        return index;
+                    }
+
+                    public String getId() {
+                        return id;
+                    }
+
+                    public ChatCompletionChunk.Choice.Delta.ToolCall.Function getFunction() {
+                        return function;
+                    }
+
+                    public String getType() {
+                        return type;
+                    }
+
+                    /*
+                        index: number;
+                        id?: string;
+                        function?: {
+                          arguments?: string;
+                          name?: string;
+                        };
+                        type?: 'function';
+                     */
+                    public Iterator<? extends ToXContent> toXContentChunked(ToXContent.Params params) {
+                        var content = Iterators.concat(
+                            ChunkedToXContentHelper.startObject(),
+                            ChunkedToXContentHelper.field(INDEX_FIELD, index),
+                            ChunkedToXContentHelper.optionalField(ID_FIELD, id)
+                        );
+
+                        if (function != null) {
+                            content = Iterators.concat(
+                                content,
+                                ChunkedToXContentHelper.startObject(FUNCTION_FIELD),
+                                ChunkedToXContentHelper.optionalField(FUNCTION_ARGUMENTS_FIELD, function.getArguments()),
+                                ChunkedToXContentHelper.optionalField(FUNCTION_NAME_FIELD, function.getName()),
+                                ChunkedToXContentHelper.endObject()
+                            );
+                        }
+
+                        content = Iterators.concat(
+                            content,
+                            ChunkedToXContentHelper.field(TYPE_FIELD, type),
+                            ChunkedToXContentHelper.endObject()
+                        );
+                        return content;
+                    }
+
+                    public static class Function {
+                        private final String arguments;
+                        private final String name;
+
+                        public Function(String arguments, String name) {
+                            this.arguments = arguments;
+                            this.name = name;
+                        }
+
+                        public String getArguments() {
+                            return arguments;
+                        }
+
+                        public String getName() {
+                            return name;
+                        }
+                    }
+                }
+            }
+        }
+
+        public record Usage(int completionTokens, int promptTokens, int totalTokens) {}
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/action/InferenceActionRequestTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/action/InferenceActionRequestTests.java
index a9ca5e6da8720..01c0ff88be222 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/action/InferenceActionRequestTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/action/InferenceActionRequestTests.java
@@ -41,8 +41,7 @@ protected InferenceAction.Request createTestInstance() {
         return new InferenceAction.Request(
             randomFrom(TaskType.values()),
             randomAlphaOfLength(6),
-            // null,
-            randomNullOrAlphaOfLength(10),
+            randomAlphaOfLengthOrNull(10),
             randomList(1, 5, () -> randomAlphaOfLength(8)),
             randomMap(0, 3, () -> new Tuple<>(randomAlphaOfLength(4), randomAlphaOfLength(4))),
             randomFrom(InputType.values()),
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/action/UnifiedCompletionActionRequestTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/action/UnifiedCompletionActionRequestTests.java
new file mode 100644
index 0000000000000..1872ac3caa230
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/action/UnifiedCompletionActionRequestTests.java
@@ -0,0 +1,97 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.core.inference.action;
+
+import org.elasticsearch.TransportVersion;
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.core.TimeValue;
+import org.elasticsearch.inference.TaskType;
+import org.elasticsearch.inference.UnifiedCompletionRequest;
+import org.elasticsearch.xpack.core.ml.AbstractBWCWireSerializationTestCase;
+
+import java.io.IOException;
+import java.util.List;
+
+import static org.hamcrest.Matchers.is;
+
+public class UnifiedCompletionActionRequestTests extends AbstractBWCWireSerializationTestCase<UnifiedCompletionAction.Request> {
+
+    public void testValidation_ReturnsException_When_UnifiedCompletionRequestMessage_Is_Null() {
+        var request = new UnifiedCompletionAction.Request(
+            "inference_id",
+            TaskType.COMPLETION,
+            UnifiedCompletionRequest.of(null),
+            TimeValue.timeValueSeconds(10)
+        );
+        var exception = request.validate();
+        assertThat(exception.getMessage(), is("Validation Failed: 1: Field [messages] cannot be null;"));
+    }
+
+    public void testValidation_ReturnsException_When_UnifiedCompletionRequest_Is_EmptyArray() {
+        var request = new UnifiedCompletionAction.Request(
+            "inference_id",
+            TaskType.COMPLETION,
+            UnifiedCompletionRequest.of(List.of()),
+            TimeValue.timeValueSeconds(10)
+        );
+        var exception = request.validate();
+        assertThat(exception.getMessage(), is("Validation Failed: 1: Field [messages] cannot be an empty array;"));
+    }
+
+    public void testValidation_ReturnsException_When_TaskType_IsNot_Completion() {
+        var request = new UnifiedCompletionAction.Request(
+            "inference_id",
+            TaskType.SPARSE_EMBEDDING,
+            UnifiedCompletionRequest.of(List.of(UnifiedCompletionRequestTests.randomMessage())),
+            TimeValue.timeValueSeconds(10)
+        );
+        var exception = request.validate();
+        assertThat(exception.getMessage(), is("Validation Failed: 1: Field [taskType] must be [completion];"));
+    }
+
+    public void testValidation_ReturnsNull_When_TaskType_IsAny() {
+        var request = new UnifiedCompletionAction.Request(
+            "inference_id",
+            TaskType.ANY,
+            UnifiedCompletionRequest.of(List.of(UnifiedCompletionRequestTests.randomMessage())),
+            TimeValue.timeValueSeconds(10)
+        );
+        assertNull(request.validate());
+    }
+
+    @Override
+    protected UnifiedCompletionAction.Request mutateInstanceForVersion(UnifiedCompletionAction.Request instance, TransportVersion version) {
+        return instance;
+    }
+
+    @Override
+    protected Writeable.Reader<UnifiedCompletionAction.Request> instanceReader() {
+        return UnifiedCompletionAction.Request::new;
+    }
+
+    @Override
+    protected UnifiedCompletionAction.Request createTestInstance() {
+        return new UnifiedCompletionAction.Request(
+            randomAlphaOfLength(10),
+            randomFrom(TaskType.values()),
+            UnifiedCompletionRequestTests.randomUnifiedCompletionRequest(),
+            TimeValue.timeValueMillis(randomLongBetween(1, 2048))
+        );
+    }
+
+    @Override
+    protected UnifiedCompletionAction.Request mutateInstance(UnifiedCompletionAction.Request instance) throws IOException {
+        return randomValueOtherThan(instance, this::createTestInstance);
+    }
+
+    @Override
+    protected NamedWriteableRegistry getNamedWriteableRegistry() {
+        return new NamedWriteableRegistry(UnifiedCompletionRequest.getNamedWriteables());
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/action/UnifiedCompletionRequestTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/action/UnifiedCompletionRequestTests.java
new file mode 100644
index 0000000000000..47a0814a584b7
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/action/UnifiedCompletionRequestTests.java
@@ -0,0 +1,293 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.core.inference.action;
+
+import org.elasticsearch.TransportVersion;
+import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.inference.UnifiedCompletionRequest;
+import org.elasticsearch.xcontent.json.JsonXContent;
+import org.elasticsearch.xpack.core.ml.AbstractBWCWireSerializationTestCase;
+
+import java.io.IOException;
+import java.util.List;
+import java.util.Map;
+
+import static org.hamcrest.Matchers.is;
+
+public class UnifiedCompletionRequestTests extends AbstractBWCWireSerializationTestCase<UnifiedCompletionRequest> {
+
+    public void testParseAllFields() throws IOException {
+        String requestJson = """
+            {
+                "model": "gpt-4o",
+                "messages": [
+                  {
+                    "role": "user",
+                    "content": [
+                        {
+                          "text": "some text",
+                          "type": "string"
+                        }
+                    ],
+                    "name": "a name",
+                    "tool_call_id": "100",
+                    "tool_calls": [
+                        {
+                            "id": "call_62136354",
+                            "type": "function",
+                            "function": {
+                                "arguments": "{'order_id': 'order_12345'}",
+                                "name": "get_delivery_date"
+                            }
+                        }
+                    ]
+                  }
+                ],
+                "max_completion_tokens": 100,
+                "stop": ["stop"],
+                "temperature": 0.1,
+                "tools": [
+                  {
+                    "type": "function",
+                    "function": {
+                      "name": "get_current_weather",
+                      "description": "Get the current weather in a given location",
+                      "parameters": {
+                        "type": "object"
+                      }
+                    }
+                  }
+                ],
+                "tool_choice": {
+                  "type": "function",
+                  "function": {
+                    "name": "some function"
+                  }
+                },
+                "top_p": 0.2
+            }
+            """;
+
+        try (var parser = createParser(JsonXContent.jsonXContent, requestJson)) {
+            var request = UnifiedCompletionRequest.PARSER.apply(parser, null);
+            var expected = new UnifiedCompletionRequest(
+                List.of(
+                    new UnifiedCompletionRequest.Message(
+                        new UnifiedCompletionRequest.ContentObjects(
+                            List.of(new UnifiedCompletionRequest.ContentObject("some text", "string"))
+                        ),
+                        "user",
+                        "a name",
+                        "100",
+                        List.of(
+                            new UnifiedCompletionRequest.ToolCall(
+                                "call_62136354",
+                                new UnifiedCompletionRequest.ToolCall.FunctionField("{'order_id': 'order_12345'}", "get_delivery_date"),
+                                "function"
+                            )
+                        )
+                    )
+                ),
+                "gpt-4o",
+                100L,
+                List.of("stop"),
+                0.1F,
+                new UnifiedCompletionRequest.ToolChoiceObject(
+                    "function",
+                    new UnifiedCompletionRequest.ToolChoiceObject.FunctionField("some function")
+                ),
+                List.of(
+                    new UnifiedCompletionRequest.Tool(
+                        "function",
+                        new UnifiedCompletionRequest.Tool.FunctionField(
+                            "Get the current weather in a given location",
+                            "get_current_weather",
+                            Map.of("type", "object"),
+                            null
+                        )
+                    )
+                ),
+                0.2F
+            );
+
+            assertThat(request, is(expected));
+        }
+    }
+
+    public void testParsing() throws IOException {
+        String requestJson = """
+            {
+                "model": "gpt-4o",
+                "messages": [
+                  {
+                    "role": "user",
+                    "content": "What is the weather like in Boston today?"
+                  }
+                ],
+                "stop": "none",
+                "tools": [
+                  {
+                    "type": "function",
+                    "function": {
+                      "name": "get_current_weather",
+                      "description": "Get the current weather in a given location",
+                      "parameters": {
+                        "type": "object"
+                      }
+                    }
+                  }
+                ],
+                "tool_choice": "auto"
+            }
+            """;
+
+        try (var parser = createParser(JsonXContent.jsonXContent, requestJson)) {
+            var request = UnifiedCompletionRequest.PARSER.apply(parser, null);
+            var expected = new UnifiedCompletionRequest(
+                List.of(
+                    new UnifiedCompletionRequest.Message(
+                        new UnifiedCompletionRequest.ContentString("What is the weather like in Boston today?"),
+                        "user",
+                        null,
+                        null,
+                        null
+                    )
+                ),
+                "gpt-4o",
+                null,
+                List.of("none"),
+                null,
+                new UnifiedCompletionRequest.ToolChoiceString("auto"),
+                List.of(
+                    new UnifiedCompletionRequest.Tool(
+                        "function",
+                        new UnifiedCompletionRequest.Tool.FunctionField(
+                            "Get the current weather in a given location",
+                            "get_current_weather",
+                            Map.of("type", "object"),
+                            null
+                        )
+                    )
+                ),
+                null
+            );
+
+            assertThat(request, is(expected));
+        }
+    }
+
+    public static UnifiedCompletionRequest randomUnifiedCompletionRequest() {
+        return new UnifiedCompletionRequest(
+            randomList(5, UnifiedCompletionRequestTests::randomMessage),
+            randomAlphaOfLengthOrNull(10),
+            randomPositiveLongOrNull(),
+            randomStopOrNull(),
+            randomFloatOrNull(),
+            randomToolChoiceOrNull(),
+            randomToolListOrNull(),
+            randomFloatOrNull()
+        );
+    }
+
+    public static UnifiedCompletionRequest.Message randomMessage() {
+        return new UnifiedCompletionRequest.Message(
+            randomContent(),
+            randomAlphaOfLength(10),
+            randomAlphaOfLengthOrNull(10),
+            randomAlphaOfLengthOrNull(10),
+            randomToolCallListOrNull()
+        );
+    }
+
+    public static UnifiedCompletionRequest.Content randomContent() {
+        return randomBoolean()
+            ? new UnifiedCompletionRequest.ContentString(randomAlphaOfLength(10))
+            : new UnifiedCompletionRequest.ContentObjects(randomList(10, UnifiedCompletionRequestTests::randomContentObject));
+    }
+
+    public static UnifiedCompletionRequest.ContentObject randomContentObject() {
+        return new UnifiedCompletionRequest.ContentObject(randomAlphaOfLength(10), randomAlphaOfLength(10));
+    }
+
+    public static List<UnifiedCompletionRequest.ToolCall> randomToolCallListOrNull() {
+        return randomBoolean() ? randomList(10, UnifiedCompletionRequestTests::randomToolCall) : null;
+    }
+
+    public static UnifiedCompletionRequest.ToolCall randomToolCall() {
+        return new UnifiedCompletionRequest.ToolCall(randomAlphaOfLength(10), randomToolCallFunctionField(), randomAlphaOfLength(10));
+    }
+
+    public static UnifiedCompletionRequest.ToolCall.FunctionField randomToolCallFunctionField() {
+        return new UnifiedCompletionRequest.ToolCall.FunctionField(randomAlphaOfLength(10), randomAlphaOfLength(10));
+    }
+
+    public static List<String> randomStopOrNull() {
+        return randomBoolean() ? randomStop() : null;
+    }
+
+    public static List<String> randomStop() {
+        return randomList(5, () -> randomAlphaOfLength(10));
+    }
+
+    public static UnifiedCompletionRequest.ToolChoice randomToolChoiceOrNull() {
+        return randomBoolean() ? randomToolChoice() : null;
+    }
+
+    public static UnifiedCompletionRequest.ToolChoice randomToolChoice() {
+        return randomBoolean()
+            ? new UnifiedCompletionRequest.ToolChoiceString(randomAlphaOfLength(10))
+            : new UnifiedCompletionRequest.ToolChoiceObject(randomAlphaOfLength(10), randomToolChoiceObjectFunctionField());
+    }
+
+    public static UnifiedCompletionRequest.ToolChoiceObject.FunctionField randomToolChoiceObjectFunctionField() {
+        return new UnifiedCompletionRequest.ToolChoiceObject.FunctionField(randomAlphaOfLength(10));
+    }
+
+    public static List<UnifiedCompletionRequest.Tool> randomToolListOrNull() {
+        return randomBoolean() ? randomList(10, UnifiedCompletionRequestTests::randomTool) : null;
+    }
+
+    public static UnifiedCompletionRequest.Tool randomTool() {
+        return new UnifiedCompletionRequest.Tool(randomAlphaOfLength(10), randomToolFunctionField());
+    }
+
+    public static UnifiedCompletionRequest.Tool.FunctionField randomToolFunctionField() {
+        return new UnifiedCompletionRequest.Tool.FunctionField(
+            randomAlphaOfLengthOrNull(10),
+            randomAlphaOfLength(10),
+            null,
+            randomOptionalBoolean()
+        );
+    }
+
+    @Override
+    protected UnifiedCompletionRequest mutateInstanceForVersion(UnifiedCompletionRequest instance, TransportVersion version) {
+        return instance;
+    }
+
+    @Override
+    protected Writeable.Reader<UnifiedCompletionRequest> instanceReader() {
+        return UnifiedCompletionRequest::new;
+    }
+
+    @Override
+    protected UnifiedCompletionRequest createTestInstance() {
+        return randomUnifiedCompletionRequest();
+    }
+
+    @Override
+    protected UnifiedCompletionRequest mutateInstance(UnifiedCompletionRequest instance) throws IOException {
+        return randomValueOtherThan(instance, this::createTestInstance);
+    }
+
+    @Override
+    protected NamedWriteableRegistry getNamedWriteableRegistry() {
+        return new NamedWriteableRegistry(UnifiedCompletionRequest.getNamedWriteables());
+    }
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/results/StreamingUnifiedChatCompletionResultsTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/results/StreamingUnifiedChatCompletionResultsTests.java
new file mode 100644
index 0000000000000..a8f569dbef9d1
--- /dev/null
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/inference/results/StreamingUnifiedChatCompletionResultsTests.java
@@ -0,0 +1,198 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ *
+ * this file was contributed to by a generative AI
+ */
+
+package org.elasticsearch.xpack.core.inference.results;
+
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xcontent.XContentBuilder;
+import org.elasticsearch.xcontent.json.JsonXContent;
+
+import java.io.IOException;
+import java.util.ArrayDeque;
+import java.util.Deque;
+import java.util.List;
+
+public class StreamingUnifiedChatCompletionResultsTests extends ESTestCase {
+
+    public void testResults_toXContentChunked() throws IOException {
+        String expected = """
+                        {
+                          "id": "chunk1",
+                          "choices": [
+                            {
+                              "delta": {
+                                "content": "example_content",
+                                "refusal": "example_refusal",
+                                "role": "assistant",
+                                "tool_calls": [
+                                  {
+                                    "index": 1,
+                                    "id": "tool1",
+                                    "function": {
+                                      "arguments": "example_arguments",
+                                      "name": "example_function"
+                                    },
+                                    "type": "function"
+                                  }
+                                ]
+                              },
+                              "finish_reason": "example_reason",
+                              "index": 0
+                            }
+                          ],
+                          "model": "example_model",
+                          "object": "example_object",
+                          "usage": {
+                            "completion_tokens": 10,
+                            "prompt_tokens": 5,
+                            "total_tokens": 15
+                          }
+                        }
+            """;
+
+        StreamingUnifiedChatCompletionResults.ChatCompletionChunk chunk = new StreamingUnifiedChatCompletionResults.ChatCompletionChunk(
+            "chunk1",
+            List.of(
+                new StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice(
+                    new StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta(
+                        "example_content",
+                        "example_refusal",
+                        "assistant",
+                        List.of(
+                            new StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall(
+                                1,
+                                "tool1",
+                                new StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall.Function(
+                                    "example_arguments",
+                                    "example_function"
+                                ),
+                                "function"
+                            )
+                        )
+                    ),
+                    "example_reason",
+                    0
+                )
+            ),
+            "example_model",
+            "example_object",
+            new StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Usage(10, 5, 15)
+        );
+
+        Deque<StreamingUnifiedChatCompletionResults.ChatCompletionChunk> deque = new ArrayDeque<>();
+        deque.add(chunk);
+        StreamingUnifiedChatCompletionResults.Results results = new StreamingUnifiedChatCompletionResults.Results(deque);
+        XContentBuilder builder = JsonXContent.contentBuilder();
+        results.toXContentChunked(null).forEachRemaining(xContent -> {
+            try {
+                xContent.toXContent(builder, null);
+            } catch (IOException e) {
+                throw new RuntimeException(e);
+            }
+        });
+
+        assertEquals(expected.replaceAll("\\s+", ""), Strings.toString(builder.prettyPrint()).trim());
+    }
+
+    public void testChoiceToXContentChunked() throws IOException {
+        String expected = """
+            {
+              "delta": {
+                "content": "example_content",
+                "refusal": "example_refusal",
+                "role": "assistant",
+                "tool_calls": [
+                  {
+                    "index": 1,
+                    "id": "tool1",
+                    "function": {
+                      "arguments": "example_arguments",
+                      "name": "example_function"
+                    },
+                    "type": "function"
+                  }
+                ]
+              },
+              "finish_reason": "example_reason",
+              "index": 0
+            }
+            """;
+
+        StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice choice =
+            new StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice(
+                new StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta(
+                    "example_content",
+                    "example_refusal",
+                    "assistant",
+                    List.of(
+                        new StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall(
+                            1,
+                            "tool1",
+                            new StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall.Function(
+                                "example_arguments",
+                                "example_function"
+                            ),
+                            "function"
+                        )
+                    )
+                ),
+                "example_reason",
+                0
+            );
+
+        XContentBuilder builder = JsonXContent.contentBuilder();
+        choice.toXContentChunked(null).forEachRemaining(xContent -> {
+            try {
+                xContent.toXContent(builder, null);
+            } catch (IOException e) {
+                throw new RuntimeException(e);
+            }
+        });
+
+        assertEquals(expected.replaceAll("\\s+", ""), Strings.toString(builder.prettyPrint()).trim());
+    }
+
+    public void testToolCallToXContentChunked() throws IOException {
+        String expected = """
+            {
+              "index": 1,
+              "id": "tool1",
+              "function": {
+                "arguments": "example_arguments",
+                "name": "example_function"
+              },
+              "type": "function"
+            }
+            """;
+
+        StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall toolCall =
+            new StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall(
+                1,
+                "tool1",
+                new StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall.Function(
+                    "example_arguments",
+                    "example_function"
+                ),
+                "function"
+            );
+
+        XContentBuilder builder = JsonXContent.contentBuilder();
+        toolCall.toXContentChunked(null).forEachRemaining(xContent -> {
+            try {
+                xContent.toXContent(builder, null);
+            } catch (IOException e) {
+                throw new RuntimeException(e);
+            }
+        });
+
+        assertEquals(expected.replaceAll("\\s+", ""), Strings.toString(builder.prettyPrint()).trim());
+    }
+
+}
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
index 17579fd6368ce..eeffa1db54856 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
@@ -4175,6 +4175,7 @@ public void testInferenceUserRole() {
         assertTrue(role.cluster().check("cluster:monitor/xpack/inference", request, authentication));
         assertTrue(role.cluster().check("cluster:monitor/xpack/inference/get", request, authentication));
         assertFalse(role.cluster().check("cluster:admin/xpack/inference/put", request, authentication));
+        assertTrue(role.cluster().check("cluster:monitor/xpack/inference/unified", request, authentication));
         assertFalse(role.cluster().check("cluster:admin/xpack/inference/delete", request, authentication));
         assertTrue(role.cluster().check("cluster:monitor/xpack/ml/trained_models/deployment/infer", request, authentication));
         assertFalse(role.cluster().check("cluster:admin/xpack/ml/trained_models/deployment/start", request, authentication));
diff --git a/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceBaseRestTest.java b/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceBaseRestTest.java
index 86c0128a3e53c..1716057cdfe46 100644
--- a/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceBaseRestTest.java
+++ b/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceBaseRestTest.java
@@ -21,6 +21,9 @@
 import org.elasticsearch.test.cluster.ElasticsearchCluster;
 import org.elasticsearch.test.cluster.local.distribution.DistributionType;
 import org.elasticsearch.test.rest.ESRestTestCase;
+import org.elasticsearch.xcontent.XContentBuilder;
+import org.elasticsearch.xcontent.XContentFactory;
+import org.elasticsearch.xcontent.XContentType;
 import org.elasticsearch.xpack.inference.external.response.streaming.ServerSentEvent;
 import org.junit.ClassRule;
 
@@ -341,10 +344,21 @@ protected Deque<ServerSentEvent> streamInferOnMockService(String modelId, TaskTy
         return callAsync(endpoint, input);
     }
 
+    protected Deque<ServerSentEvent> unifiedCompletionInferOnMockService(String modelId, TaskType taskType, List<String> input)
+        throws Exception {
+        var endpoint = Strings.format("_inference/%s/%s/_unified", taskType, modelId);
+        return callAsyncUnified(endpoint, input, "user");
+    }
+
     private Deque<ServerSentEvent> callAsync(String endpoint, List<String> input) throws Exception {
-        var responseConsumer = new AsyncInferenceResponseConsumer();
         var request = new Request("POST", endpoint);
         request.setJsonEntity(jsonBody(input, null));
+
+        return execAsyncCall(request);
+    }
+
+    private Deque<ServerSentEvent> execAsyncCall(Request request) throws Exception {
+        var responseConsumer = new AsyncInferenceResponseConsumer();
         request.setOptions(RequestOptions.DEFAULT.toBuilder().setHttpAsyncResponseConsumerFactory(() -> responseConsumer).build());
         var latch = new CountDownLatch(1);
         client().performRequestAsync(request, new ResponseListener() {
@@ -362,6 +376,22 @@ public void onFailure(Exception exception) {
         return responseConsumer.events();
     }
 
+    private Deque<ServerSentEvent> callAsyncUnified(String endpoint, List<String> input, String role) throws Exception {
+        var request = new Request("POST", endpoint);
+
+        request.setJsonEntity(createUnifiedJsonBody(input, role));
+        return execAsyncCall(request);
+    }
+
+    private String createUnifiedJsonBody(List<String> input, String role) throws IOException {
+        var messages = input.stream().map(i -> Map.of("content", i, "role", role)).toList();
+        XContentBuilder builder = XContentFactory.contentBuilder(XContentType.JSON);
+        builder.startObject();
+        builder.field("messages", messages);
+        builder.endObject();
+        return org.elasticsearch.common.Strings.toString(builder);
+    }
+
     protected Map<String, Object> infer(String modelId, TaskType taskType, List<String> input) throws IOException {
         var endpoint = Strings.format("_inference/%s/%s", taskType, modelId);
         return inferInternal(endpoint, input, null, Map.of());
diff --git a/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceCrudIT.java b/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceCrudIT.java
index 604e1d4f553b2..2099ec8287a76 100644
--- a/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceCrudIT.java
+++ b/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceCrudIT.java
@@ -11,13 +11,18 @@
 
 import org.apache.http.util.EntityUtils;
 import org.elasticsearch.client.ResponseException;
+import org.elasticsearch.common.Strings;
 import org.elasticsearch.common.settings.Settings;
 import org.elasticsearch.inference.TaskType;
+import org.elasticsearch.xcontent.XContentBuilder;
+import org.elasticsearch.xcontent.XContentFactory;
+import org.elasticsearch.xcontent.XContentType;
 import org.elasticsearch.xpack.inference.services.elastic.ElasticInferenceServiceFeature;
 
 import java.io.IOException;
 import java.util.ArrayList;
 import java.util.Arrays;
+import java.util.Iterator;
 import java.util.List;
 import java.util.Map;
 import java.util.Objects;
@@ -481,6 +486,56 @@ public void testSupportedStream() throws Exception {
         }
     }
 
+    public void testUnifiedCompletionInference() throws Exception {
+        String modelId = "streaming";
+        putModel(modelId, mockCompletionServiceModelConfig(TaskType.COMPLETION));
+        var singleModel = getModel(modelId);
+        assertEquals(modelId, singleModel.get("inference_id"));
+        assertEquals(TaskType.COMPLETION.toString(), singleModel.get("task_type"));
+
+        var input = IntStream.range(1, 2 + randomInt(8)).mapToObj(i -> randomUUID()).toList();
+        try {
+            var events = unifiedCompletionInferOnMockService(modelId, TaskType.COMPLETION, input);
+            var expectedResponses = expectedResultsIterator(input);
+            assertThat(events.size(), equalTo((input.size() + 1) * 2));
+            events.forEach(event -> {
+                switch (event.name()) {
+                    case EVENT -> assertThat(event.value(), equalToIgnoringCase("message"));
+                    case DATA -> assertThat(event.value(), equalTo(expectedResponses.next()));
+                }
+            });
+        } finally {
+            deleteModel(modelId);
+        }
+    }
+
+    private static Iterator<String> expectedResultsIterator(List<String> input) {
+        return Stream.concat(input.stream().map(String::toUpperCase).map(InferenceCrudIT::expectedResult), Stream.of("[DONE]")).iterator();
+    }
+
+    private static String expectedResult(String input) {
+        try {
+            XContentBuilder builder = XContentFactory.contentBuilder(XContentType.JSON);
+            builder.startObject();
+            builder.field("id", "id");
+            builder.startArray("choices");
+            builder.startObject();
+            builder.startObject("delta");
+            builder.field("content", input);
+            builder.endObject();
+            builder.field("index", 0);
+            builder.endObject();
+            builder.endArray();
+            builder.field("model", "gpt-4o-2024-08-06");
+            builder.field("object", "chat.completion.chunk");
+            builder.endObject();
+
+            return Strings.toString(builder);
+        } catch (IOException e) {
+            throw new RuntimeException(e);
+        }
+    }
+
     public void testGetZeroModels() throws IOException {
         var models = getModels("_all", TaskType.COMPLETION);
         assertThat(models, empty());
diff --git a/x-pack/plugin/inference/qa/test-service-plugin/src/main/java/org/elasticsearch/xpack/inference/mock/TestDenseInferenceServiceExtension.java b/x-pack/plugin/inference/qa/test-service-plugin/src/main/java/org/elasticsearch/xpack/inference/mock/TestDenseInferenceServiceExtension.java
index ae11a02d312e2..f5f682b143a72 100644
--- a/x-pack/plugin/inference/qa/test-service-plugin/src/main/java/org/elasticsearch/xpack/inference/mock/TestDenseInferenceServiceExtension.java
+++ b/x-pack/plugin/inference/qa/test-service-plugin/src/main/java/org/elasticsearch/xpack/inference/mock/TestDenseInferenceServiceExtension.java
@@ -31,6 +31,7 @@
 import org.elasticsearch.inference.SimilarityMeasure;
 import org.elasticsearch.inference.TaskSettingsConfiguration;
 import org.elasticsearch.inference.TaskType;
+import org.elasticsearch.inference.UnifiedCompletionRequest;
 import org.elasticsearch.inference.configuration.SettingsConfigurationDisplayType;
 import org.elasticsearch.inference.configuration.SettingsConfigurationFieldType;
 import org.elasticsearch.rest.RestStatus;
@@ -132,6 +133,16 @@ public void infer(
             }
         }
 
+        @Override
+        public void unifiedCompletionInfer(
+            Model model,
+            UnifiedCompletionRequest request,
+            TimeValue timeout,
+            ActionListener<InferenceServiceResults> listener
+        ) {
+            listener.onFailure(new UnsupportedOperationException("unifiedCompletionInfer not supported"));
+        }
+
         @Override
         public void chunkedInfer(
             Model model,
diff --git a/x-pack/plugin/inference/qa/test-service-plugin/src/main/java/org/elasticsearch/xpack/inference/mock/TestRerankingServiceExtension.java b/x-pack/plugin/inference/qa/test-service-plugin/src/main/java/org/elasticsearch/xpack/inference/mock/TestRerankingServiceExtension.java
index 9320571572f0a..fa1e27005c287 100644
--- a/x-pack/plugin/inference/qa/test-service-plugin/src/main/java/org/elasticsearch/xpack/inference/mock/TestRerankingServiceExtension.java
+++ b/x-pack/plugin/inference/qa/test-service-plugin/src/main/java/org/elasticsearch/xpack/inference/mock/TestRerankingServiceExtension.java
@@ -29,6 +29,7 @@
 import org.elasticsearch.inference.SettingsConfiguration;
 import org.elasticsearch.inference.TaskSettingsConfiguration;
 import org.elasticsearch.inference.TaskType;
+import org.elasticsearch.inference.UnifiedCompletionRequest;
 import org.elasticsearch.inference.configuration.SettingsConfigurationDisplayType;
 import org.elasticsearch.inference.configuration.SettingsConfigurationFieldType;
 import org.elasticsearch.rest.RestStatus;
@@ -120,6 +121,16 @@ public void infer(
             }
         }
 
+        @Override
+        public void unifiedCompletionInfer(
+            Model model,
+            UnifiedCompletionRequest request,
+            TimeValue timeout,
+            ActionListener<InferenceServiceResults> listener
+        ) {
+            listener.onFailure(new UnsupportedOperationException("unifiedCompletionInfer not supported"));
+        }
+
         @Override
         public void chunkedInfer(
             Model model,
diff --git a/x-pack/plugin/inference/qa/test-service-plugin/src/main/java/org/elasticsearch/xpack/inference/mock/TestSparseInferenceServiceExtension.java b/x-pack/plugin/inference/qa/test-service-plugin/src/main/java/org/elasticsearch/xpack/inference/mock/TestSparseInferenceServiceExtension.java
index fe0223cce0323..64569fd8c5c6a 100644
--- a/x-pack/plugin/inference/qa/test-service-plugin/src/main/java/org/elasticsearch/xpack/inference/mock/TestSparseInferenceServiceExtension.java
+++ b/x-pack/plugin/inference/qa/test-service-plugin/src/main/java/org/elasticsearch/xpack/inference/mock/TestSparseInferenceServiceExtension.java
@@ -29,6 +29,7 @@
 import org.elasticsearch.inference.SettingsConfiguration;
 import org.elasticsearch.inference.TaskSettingsConfiguration;
 import org.elasticsearch.inference.TaskType;
+import org.elasticsearch.inference.UnifiedCompletionRequest;
 import org.elasticsearch.inference.configuration.SettingsConfigurationDisplayType;
 import org.elasticsearch.inference.configuration.SettingsConfigurationFieldType;
 import org.elasticsearch.rest.RestStatus;
@@ -123,6 +124,16 @@ public void infer(
             }
         }
 
+        @Override
+        public void unifiedCompletionInfer(
+            Model model,
+            UnifiedCompletionRequest request,
+            TimeValue timeout,
+            ActionListener<InferenceServiceResults> listener
+        ) {
+            throw new UnsupportedOperationException("unifiedCompletionInfer not supported");
+        }
+
         @Override
         public void chunkedInfer(
             Model model,
diff --git a/x-pack/plugin/inference/qa/test-service-plugin/src/main/java/org/elasticsearch/xpack/inference/mock/TestStreamingCompletionServiceExtension.java b/x-pack/plugin/inference/qa/test-service-plugin/src/main/java/org/elasticsearch/xpack/inference/mock/TestStreamingCompletionServiceExtension.java
index 6d7983bc8cb53..f7a05a27354ef 100644
--- a/x-pack/plugin/inference/qa/test-service-plugin/src/main/java/org/elasticsearch/xpack/inference/mock/TestStreamingCompletionServiceExtension.java
+++ b/x-pack/plugin/inference/qa/test-service-plugin/src/main/java/org/elasticsearch/xpack/inference/mock/TestStreamingCompletionServiceExtension.java
@@ -30,12 +30,14 @@
 import org.elasticsearch.inference.SettingsConfiguration;
 import org.elasticsearch.inference.TaskSettingsConfiguration;
 import org.elasticsearch.inference.TaskType;
+import org.elasticsearch.inference.UnifiedCompletionRequest;
 import org.elasticsearch.inference.configuration.SettingsConfigurationDisplayType;
 import org.elasticsearch.inference.configuration.SettingsConfigurationFieldType;
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.xcontent.ToXContentObject;
 import org.elasticsearch.xcontent.XContentBuilder;
 import org.elasticsearch.xpack.core.inference.results.StreamingChatCompletionResults;
+import org.elasticsearch.xpack.core.inference.results.StreamingUnifiedChatCompletionResults;
 
 import java.io.IOException;
 import java.util.EnumSet;
@@ -121,6 +123,24 @@ public void infer(
             }
         }
 
+        @Override
+        public void unifiedCompletionInfer(
+            Model model,
+            UnifiedCompletionRequest request,
+            TimeValue timeout,
+            ActionListener<InferenceServiceResults> listener
+        ) {
+            switch (model.getConfigurations().getTaskType()) {
+                case COMPLETION -> listener.onResponse(makeUnifiedResults(request));
+                default -> listener.onFailure(
+                    new ElasticsearchStatusException(
+                        TaskType.unsupportedTaskTypeErrorMsg(model.getConfigurations().getTaskType(), name()),
+                        RestStatus.BAD_REQUEST
+                    )
+                );
+            }
+        }
+
         private StreamingChatCompletionResults makeResults(List<String> input) {
             var responseIter = input.stream().map(String::toUpperCase).iterator();
             return new StreamingChatCompletionResults(subscriber -> {
@@ -152,6 +172,59 @@ private ChunkedToXContent completionChunk(String delta) {
             );
         }
 
+        private StreamingUnifiedChatCompletionResults makeUnifiedResults(UnifiedCompletionRequest request) {
+            var responseIter = request.messages().stream().map(message -> message.content().toString().toUpperCase()).iterator();
+            return new StreamingUnifiedChatCompletionResults(subscriber -> {
+                subscriber.onSubscribe(new Flow.Subscription() {
+                    @Override
+                    public void request(long n) {
+                        if (responseIter.hasNext()) {
+                            subscriber.onNext(unifiedCompletionChunk(responseIter.next()));
+                        } else {
+                            subscriber.onComplete();
+                        }
+                    }
+
+                    @Override
+                    public void cancel() {}
+                });
+            });
+        }
+
+        /*
+        The response format looks like this
+        {
+          "id": "chatcmpl-AarrzyuRflye7yzDF4lmVnenGmQCF",
+          "choices": [
+            {
+              "delta": {
+                "content": " information"
+              },
+              "index": 0
+            }
+          ],
+          "model": "gpt-4o-2024-08-06",
+          "object": "chat.completion.chunk"
+        }
+         */
+        private ChunkedToXContent unifiedCompletionChunk(String delta) {
+            return params -> Iterators.concat(
+                ChunkedToXContentHelper.startObject(),
+                ChunkedToXContentHelper.field("id", "id"),
+                ChunkedToXContentHelper.startArray("choices"),
+                ChunkedToXContentHelper.startObject(),
+                ChunkedToXContentHelper.startObject("delta"),
+                ChunkedToXContentHelper.field("content", delta),
+                ChunkedToXContentHelper.endObject(),
+                ChunkedToXContentHelper.field("index", 0),
+                ChunkedToXContentHelper.endObject(),
+                ChunkedToXContentHelper.endArray(),
+                ChunkedToXContentHelper.field("model", "gpt-4o-2024-08-06"),
+                ChunkedToXContentHelper.field("object", "chat.completion.chunk"),
+                ChunkedToXContentHelper.endObject()
+            );
+        }
+
         @Override
         public void chunkedInfer(
             Model model,
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceNamedWriteablesProvider.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceNamedWriteablesProvider.java
index 673b841317a3d..a4187f4c4fa90 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceNamedWriteablesProvider.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceNamedWriteablesProvider.java
@@ -16,6 +16,7 @@
 import org.elasticsearch.inference.SecretSettings;
 import org.elasticsearch.inference.ServiceSettings;
 import org.elasticsearch.inference.TaskSettings;
+import org.elasticsearch.inference.UnifiedCompletionRequest;
 import org.elasticsearch.xpack.core.inference.results.ChatCompletionResults;
 import org.elasticsearch.xpack.core.inference.results.ErrorChunkedInferenceResults;
 import org.elasticsearch.xpack.core.inference.results.InferenceChunkedSparseEmbeddingResults;
@@ -137,11 +138,18 @@ public static List<NamedWriteableRegistry.Entry> getNamedWriteables() {
         addEisNamedWriteables(namedWriteables);
         addAlibabaCloudSearchNamedWriteables(namedWriteables);
 
+        addUnifiedNamedWriteables(namedWriteables);
+
         namedWriteables.addAll(StreamingTaskManager.namedWriteables());
 
         return namedWriteables;
     }
 
+    private static void addUnifiedNamedWriteables(List<NamedWriteableRegistry.Entry> namedWriteables) {
+        var writeables = UnifiedCompletionRequest.getNamedWriteables();
+        namedWriteables.addAll(writeables);
+    }
+
     private static void addAmazonBedrockNamedWriteables(List<NamedWriteableRegistry.Entry> namedWriteables) {
         namedWriteables.add(
             new NamedWriteableRegistry.Entry(
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
index d7d623ab20143..148a784456361 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferencePlugin.java
@@ -51,6 +51,7 @@
 import org.elasticsearch.xpack.core.inference.action.GetInferenceServicesAction;
 import org.elasticsearch.xpack.core.inference.action.InferenceAction;
 import org.elasticsearch.xpack.core.inference.action.PutInferenceModelAction;
+import org.elasticsearch.xpack.core.inference.action.UnifiedCompletionAction;
 import org.elasticsearch.xpack.core.inference.action.UpdateInferenceModelAction;
 import org.elasticsearch.xpack.inference.action.TransportDeleteInferenceEndpointAction;
 import org.elasticsearch.xpack.inference.action.TransportGetInferenceDiagnosticsAction;
@@ -59,6 +60,7 @@
 import org.elasticsearch.xpack.inference.action.TransportInferenceAction;
 import org.elasticsearch.xpack.inference.action.TransportInferenceUsageAction;
 import org.elasticsearch.xpack.inference.action.TransportPutInferenceModelAction;
+import org.elasticsearch.xpack.inference.action.TransportUnifiedCompletionInferenceAction;
 import org.elasticsearch.xpack.inference.action.TransportUpdateInferenceModelAction;
 import org.elasticsearch.xpack.inference.action.filter.ShardBulkInferenceActionFilter;
 import org.elasticsearch.xpack.inference.common.Truncator;
@@ -86,6 +88,7 @@
 import org.elasticsearch.xpack.inference.rest.RestInferenceAction;
 import org.elasticsearch.xpack.inference.rest.RestPutInferenceModelAction;
 import org.elasticsearch.xpack.inference.rest.RestStreamInferenceAction;
+import org.elasticsearch.xpack.inference.rest.RestUnifiedCompletionInferenceAction;
 import org.elasticsearch.xpack.inference.rest.RestUpdateInferenceModelAction;
 import org.elasticsearch.xpack.inference.services.ServiceComponents;
 import org.elasticsearch.xpack.inference.services.alibabacloudsearch.AlibabaCloudSearchService;
@@ -159,8 +162,9 @@ public InferencePlugin(Settings settings) {
 
     @Override
     public List<ActionHandler<? extends ActionRequest, ? extends ActionResponse>> getActions() {
-        return List.of(
+        var availableActions = List.of(
             new ActionHandler<>(InferenceAction.INSTANCE, TransportInferenceAction.class),
+
             new ActionHandler<>(GetInferenceModelAction.INSTANCE, TransportGetInferenceModelAction.class),
             new ActionHandler<>(PutInferenceModelAction.INSTANCE, TransportPutInferenceModelAction.class),
             new ActionHandler<>(UpdateInferenceModelAction.INSTANCE, TransportUpdateInferenceModelAction.class),
@@ -169,6 +173,13 @@ public InferencePlugin(Settings settings) {
             new ActionHandler<>(GetInferenceDiagnosticsAction.INSTANCE, TransportGetInferenceDiagnosticsAction.class),
             new ActionHandler<>(GetInferenceServicesAction.INSTANCE, TransportGetInferenceServicesAction.class)
         );
+
+        List<ActionHandler<? extends ActionRequest, ? extends ActionResponse>> conditionalActions =
+            UnifiedCompletionFeature.UNIFIED_COMPLETION_FEATURE_FLAG.isEnabled()
+                ? List.of(new ActionHandler<>(UnifiedCompletionAction.INSTANCE, TransportUnifiedCompletionInferenceAction.class))
+                : List.of();
+
+        return Stream.concat(availableActions.stream(), conditionalActions.stream()).toList();
     }
 
     @Override
@@ -183,7 +194,7 @@ public List<RestHandler> getRestHandlers(
         Supplier<DiscoveryNodes> nodesInCluster,
         Predicate<NodeFeature> clusterSupportsFeature
     ) {
-        return List.of(
+        var availableRestActions = List.of(
             new RestInferenceAction(),
             new RestStreamInferenceAction(),
             new RestGetInferenceModelAction(),
@@ -193,6 +204,11 @@ public List<RestHandler> getRestHandlers(
             new RestGetInferenceDiagnosticsAction(),
             new RestGetInferenceServicesAction()
         );
+        List<RestHandler> conditionalRestActions = UnifiedCompletionFeature.UNIFIED_COMPLETION_FEATURE_FLAG.isEnabled()
+            ? List.of(new RestUnifiedCompletionInferenceAction())
+            : List.of();
+
+        return Stream.concat(availableRestActions.stream(), conditionalRestActions.stream()).toList();
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/UnifiedCompletionFeature.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/UnifiedCompletionFeature.java
new file mode 100644
index 0000000000000..3e13d0c1e39de
--- /dev/null
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/UnifiedCompletionFeature.java
@@ -0,0 +1,20 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference;
+
+import org.elasticsearch.common.util.FeatureFlag;
+
+/**
+ * Unified Completion feature flag. When the feature is complete, this flag will be removed.
+ * Enable feature via JVM option: `-Des.inference_unified_feature_flag_enabled=true`.
+ */
+public class UnifiedCompletionFeature {
+    public static final FeatureFlag UNIFIED_COMPLETION_FEATURE_FLAG = new FeatureFlag("inference_unified");
+
+    private UnifiedCompletionFeature() {}
+}
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/action/BaseTransportInferenceAction.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/action/BaseTransportInferenceAction.java
new file mode 100644
index 0000000000000..2a0e8e1775279
--- /dev/null
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/action/BaseTransportInferenceAction.java
@@ -0,0 +1,250 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.action;
+
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.elasticsearch.ElasticsearchStatusException;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.support.ActionFilters;
+import org.elasticsearch.action.support.HandledTransportAction;
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.common.util.concurrent.EsExecutors;
+import org.elasticsearch.common.xcontent.ChunkedToXContent;
+import org.elasticsearch.core.Nullable;
+import org.elasticsearch.inference.InferenceService;
+import org.elasticsearch.inference.InferenceServiceRegistry;
+import org.elasticsearch.inference.InferenceServiceResults;
+import org.elasticsearch.inference.Model;
+import org.elasticsearch.inference.TaskType;
+import org.elasticsearch.inference.UnparsedModel;
+import org.elasticsearch.rest.RestStatus;
+import org.elasticsearch.tasks.Task;
+import org.elasticsearch.transport.TransportService;
+import org.elasticsearch.xpack.core.inference.action.BaseInferenceActionRequest;
+import org.elasticsearch.xpack.core.inference.action.InferenceAction;
+import org.elasticsearch.xpack.inference.action.task.StreamingTaskManager;
+import org.elasticsearch.xpack.inference.common.DelegatingProcessor;
+import org.elasticsearch.xpack.inference.registry.ModelRegistry;
+import org.elasticsearch.xpack.inference.telemetry.InferenceStats;
+import org.elasticsearch.xpack.inference.telemetry.InferenceTimer;
+
+import java.util.function.Supplier;
+import java.util.stream.Collectors;
+
+import static org.elasticsearch.core.Strings.format;
+import static org.elasticsearch.xpack.inference.telemetry.InferenceStats.modelAttributes;
+import static org.elasticsearch.xpack.inference.telemetry.InferenceStats.responseAttributes;
+
+public abstract class BaseTransportInferenceAction<Request extends BaseInferenceActionRequest> extends HandledTransportAction<
+    Request,
+    InferenceAction.Response> {
+
+    private static final Logger log = LogManager.getLogger(BaseTransportInferenceAction.class);
+    private static final String STREAMING_INFERENCE_TASK_TYPE = "streaming_inference";
+    private static final String STREAMING_TASK_ACTION = "xpack/inference/streaming_inference[n]";
+    private final ModelRegistry modelRegistry;
+    private final InferenceServiceRegistry serviceRegistry;
+    private final InferenceStats inferenceStats;
+    private final StreamingTaskManager streamingTaskManager;
+
+    public BaseTransportInferenceAction(
+        String inferenceActionName,
+        TransportService transportService,
+        ActionFilters actionFilters,
+        ModelRegistry modelRegistry,
+        InferenceServiceRegistry serviceRegistry,
+        InferenceStats inferenceStats,
+        StreamingTaskManager streamingTaskManager,
+        Writeable.Reader<Request> requestReader
+    ) {
+        super(inferenceActionName, transportService, actionFilters, requestReader, EsExecutors.DIRECT_EXECUTOR_SERVICE);
+        this.modelRegistry = modelRegistry;
+        this.serviceRegistry = serviceRegistry;
+        this.inferenceStats = inferenceStats;
+        this.streamingTaskManager = streamingTaskManager;
+    }
+
+    @Override
+    protected void doExecute(Task task, Request request, ActionListener<InferenceAction.Response> listener) {
+        var timer = InferenceTimer.start();
+
+        var getModelListener = ActionListener.wrap((UnparsedModel unparsedModel) -> {
+            var service = serviceRegistry.getService(unparsedModel.service());
+            try {
+                validationHelper(service::isEmpty, () -> unknownServiceException(unparsedModel.service(), request.getInferenceEntityId()));
+                validationHelper(
+                    () -> request.getTaskType().isAnyOrSame(unparsedModel.taskType()) == false,
+                    () -> requestModelTaskTypeMismatchException(request.getTaskType(), unparsedModel.taskType())
+                );
+                validationHelper(
+                    () -> isInvalidTaskTypeForInferenceEndpoint(request, unparsedModel),
+                    () -> createInvalidTaskTypeException(request, unparsedModel)
+                );
+            } catch (Exception e) {
+                recordMetrics(unparsedModel, timer, e);
+                listener.onFailure(e);
+                return;
+            }
+
+            var model = service.get()
+                .parsePersistedConfigWithSecrets(
+                    unparsedModel.inferenceEntityId(),
+                    unparsedModel.taskType(),
+                    unparsedModel.settings(),
+                    unparsedModel.secrets()
+                );
+            inferOnServiceWithMetrics(model, request, service.get(), timer, listener);
+        }, e -> {
+            try {
+                inferenceStats.inferenceDuration().record(timer.elapsedMillis(), responseAttributes(e));
+            } catch (Exception metricsException) {
+                log.atDebug().withThrowable(metricsException).log("Failed to record metrics when the model is missing, dropping metrics");
+            }
+            listener.onFailure(e);
+        });
+
+        modelRegistry.getModelWithSecrets(request.getInferenceEntityId(), getModelListener);
+    }
+
+    private static void validationHelper(Supplier<Boolean> validationFailure, Supplier<ElasticsearchStatusException> exceptionCreator) {
+        if (validationFailure.get()) {
+            throw exceptionCreator.get();
+        }
+    }
+
+    protected abstract boolean isInvalidTaskTypeForInferenceEndpoint(Request request, UnparsedModel unparsedModel);
+
+    protected abstract ElasticsearchStatusException createInvalidTaskTypeException(Request request, UnparsedModel unparsedModel);
+
+    private void recordMetrics(UnparsedModel model, InferenceTimer timer, @Nullable Throwable t) {
+        try {
+            inferenceStats.inferenceDuration().record(timer.elapsedMillis(), responseAttributes(model, t));
+        } catch (Exception e) {
+            log.atDebug().withThrowable(e).log("Failed to record metrics with an unparsed model, dropping metrics");
+        }
+    }
+
+    private void inferOnServiceWithMetrics(
+        Model model,
+        Request request,
+        InferenceService service,
+        InferenceTimer timer,
+        ActionListener<InferenceAction.Response> listener
+    ) {
+        inferenceStats.requestCount().incrementBy(1, modelAttributes(model));
+        inferOnService(model, request, service, ActionListener.wrap(inferenceResults -> {
+            if (request.isStreaming()) {
+                var taskProcessor = streamingTaskManager.<ChunkedToXContent>create(STREAMING_INFERENCE_TASK_TYPE, STREAMING_TASK_ACTION);
+                inferenceResults.publisher().subscribe(taskProcessor);
+
+                var instrumentedStream = new PublisherWithMetrics(timer, model);
+                taskProcessor.subscribe(instrumentedStream);
+
+                listener.onResponse(new InferenceAction.Response(inferenceResults, instrumentedStream));
+            } else {
+                recordMetrics(model, timer, null);
+                listener.onResponse(new InferenceAction.Response(inferenceResults));
+            }
+        }, e -> {
+            recordMetrics(model, timer, e);
+            listener.onFailure(e);
+        }));
+    }
+
+    private void recordMetrics(Model model, InferenceTimer timer, @Nullable Throwable t) {
+        try {
+            inferenceStats.inferenceDuration().record(timer.elapsedMillis(), responseAttributes(model, t));
+        } catch (Exception e) {
+            log.atDebug().withThrowable(e).log("Failed to record metrics with a parsed model, dropping metrics");
+        }
+    }
+
+    private void inferOnService(Model model, Request request, InferenceService service, ActionListener<InferenceServiceResults> listener) {
+        if (request.isStreaming() == false || service.canStream(request.getTaskType())) {
+            doInference(model, request, service, listener);
+        } else {
+            listener.onFailure(unsupportedStreamingTaskException(request, service));
+        }
+    }
+
+    protected abstract void doInference(
+        Model model,
+        Request request,
+        InferenceService service,
+        ActionListener<InferenceServiceResults> listener
+    );
+
+    private ElasticsearchStatusException unsupportedStreamingTaskException(Request request, InferenceService service) {
+        var supportedTasks = service.supportedStreamingTasks();
+        if (supportedTasks.isEmpty()) {
+            return new ElasticsearchStatusException(
+                format("Streaming is not allowed for service [%s].", service.name()),
+                RestStatus.METHOD_NOT_ALLOWED
+            );
+        } else {
+            var validTasks = supportedTasks.stream().map(TaskType::toString).collect(Collectors.joining(","));
+            return new ElasticsearchStatusException(
+                format(
+                    "Streaming is not allowed for service [%s] and task [%s]. Supported tasks: [%s]",
+                    service.name(),
+                    request.getTaskType(),
+                    validTasks
+                ),
+                RestStatus.METHOD_NOT_ALLOWED
+            );
+        }
+    }
+
+    private static ElasticsearchStatusException unknownServiceException(String service, String inferenceId) {
+        return new ElasticsearchStatusException("Unknown service [{}] for model [{}]. ", RestStatus.BAD_REQUEST, service, inferenceId);
+    }
+
+    private static ElasticsearchStatusException requestModelTaskTypeMismatchException(TaskType requested, TaskType expected) {
+        return new ElasticsearchStatusException(
+            "Incompatible task_type, the requested type [{}] does not match the model type [{}]",
+            RestStatus.BAD_REQUEST,
+            requested,
+            expected
+        );
+    }
+
+    private class PublisherWithMetrics extends DelegatingProcessor<ChunkedToXContent, ChunkedToXContent> {
+
+        private final InferenceTimer timer;
+        private final Model model;
+
+        private PublisherWithMetrics(InferenceTimer timer, Model model) {
+            this.timer = timer;
+            this.model = model;
+        }
+
+        @Override
+        protected void next(ChunkedToXContent item) {
+            downstream().onNext(item);
+        }
+
+        @Override
+        public void onError(Throwable throwable) {
+            recordMetrics(model, timer, throwable);
+            super.onError(throwable);
+        }
+
+        @Override
+        protected void onCancel() {
+            recordMetrics(model, timer, null);
+            super.onCancel();
+        }
+
+        @Override
+        public void onComplete() {
+            recordMetrics(model, timer, null);
+            super.onComplete();
+        }
+    }
+}
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/action/TransportInferenceAction.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/action/TransportInferenceAction.java
index ba9ab3c133731..08e6d869a553d 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/action/TransportInferenceAction.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/action/TransportInferenceAction.java
@@ -7,47 +7,22 @@
 
 package org.elasticsearch.xpack.inference.action;
 
-import org.apache.logging.log4j.LogManager;
-import org.apache.logging.log4j.Logger;
 import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.support.ActionFilters;
-import org.elasticsearch.action.support.HandledTransportAction;
-import org.elasticsearch.common.util.concurrent.EsExecutors;
-import org.elasticsearch.common.xcontent.ChunkedToXContent;
-import org.elasticsearch.core.Nullable;
 import org.elasticsearch.inference.InferenceService;
 import org.elasticsearch.inference.InferenceServiceRegistry;
 import org.elasticsearch.inference.InferenceServiceResults;
 import org.elasticsearch.inference.Model;
-import org.elasticsearch.inference.TaskType;
 import org.elasticsearch.inference.UnparsedModel;
 import org.elasticsearch.injection.guice.Inject;
-import org.elasticsearch.rest.RestStatus;
-import org.elasticsearch.tasks.Task;
 import org.elasticsearch.transport.TransportService;
 import org.elasticsearch.xpack.core.inference.action.InferenceAction;
 import org.elasticsearch.xpack.inference.action.task.StreamingTaskManager;
-import org.elasticsearch.xpack.inference.common.DelegatingProcessor;
 import org.elasticsearch.xpack.inference.registry.ModelRegistry;
 import org.elasticsearch.xpack.inference.telemetry.InferenceStats;
-import org.elasticsearch.xpack.inference.telemetry.InferenceTimer;
 
-import java.util.stream.Collectors;
-
-import static org.elasticsearch.core.Strings.format;
-import static org.elasticsearch.xpack.inference.telemetry.InferenceStats.modelAttributes;
-import static org.elasticsearch.xpack.inference.telemetry.InferenceStats.responseAttributes;
-
-public class TransportInferenceAction extends HandledTransportAction<InferenceAction.Request, InferenceAction.Response> {
-    private static final Logger log = LogManager.getLogger(TransportInferenceAction.class);
-    private static final String STREAMING_INFERENCE_TASK_TYPE = "streaming_inference";
-    private static final String STREAMING_TASK_ACTION = "xpack/inference/streaming_inference[n]";
-
-    private final ModelRegistry modelRegistry;
-    private final InferenceServiceRegistry serviceRegistry;
-    private final InferenceStats inferenceStats;
-    private final StreamingTaskManager streamingTaskManager;
+public class TransportInferenceAction extends BaseTransportInferenceAction<InferenceAction.Request> {
 
     @Inject
     public TransportInferenceAction(
@@ -58,184 +33,44 @@ public TransportInferenceAction(
         InferenceStats inferenceStats,
         StreamingTaskManager streamingTaskManager
     ) {
-        super(InferenceAction.NAME, transportService, actionFilters, InferenceAction.Request::new, EsExecutors.DIRECT_EXECUTOR_SERVICE);
-        this.modelRegistry = modelRegistry;
-        this.serviceRegistry = serviceRegistry;
-        this.inferenceStats = inferenceStats;
-        this.streamingTaskManager = streamingTaskManager;
+        super(
+            InferenceAction.NAME,
+            transportService,
+            actionFilters,
+            modelRegistry,
+            serviceRegistry,
+            inferenceStats,
+            streamingTaskManager,
+            InferenceAction.Request::new
+        );
     }
 
     @Override
-    protected void doExecute(Task task, InferenceAction.Request request, ActionListener<InferenceAction.Response> listener) {
-        var timer = InferenceTimer.start();
-
-        var getModelListener = ActionListener.wrap((UnparsedModel unparsedModel) -> {
-            var service = serviceRegistry.getService(unparsedModel.service());
-            if (service.isEmpty()) {
-                var e = unknownServiceException(unparsedModel.service(), request.getInferenceEntityId());
-                recordMetrics(unparsedModel, timer, e);
-                listener.onFailure(e);
-                return;
-            }
-
-            if (request.getTaskType().isAnyOrSame(unparsedModel.taskType()) == false) {
-                // not the wildcard task type and not the model task type
-                var e = incompatibleTaskTypeException(request.getTaskType(), unparsedModel.taskType());
-                recordMetrics(unparsedModel, timer, e);
-                listener.onFailure(e);
-                return;
-            }
-
-            var model = service.get()
-                .parsePersistedConfigWithSecrets(
-                    unparsedModel.inferenceEntityId(),
-                    unparsedModel.taskType(),
-                    unparsedModel.settings(),
-                    unparsedModel.secrets()
-                );
-            inferOnServiceWithMetrics(model, request, service.get(), timer, listener);
-        }, e -> {
-            try {
-                inferenceStats.inferenceDuration().record(timer.elapsedMillis(), responseAttributes(e));
-            } catch (Exception metricsException) {
-                log.atDebug().withThrowable(metricsException).log("Failed to record metrics when the model is missing, dropping metrics");
-            }
-            listener.onFailure(e);
-        });
-
-        modelRegistry.getModelWithSecrets(request.getInferenceEntityId(), getModelListener);
-    }
-
-    private void recordMetrics(UnparsedModel model, InferenceTimer timer, @Nullable Throwable t) {
-        try {
-            inferenceStats.inferenceDuration().record(timer.elapsedMillis(), responseAttributes(model, t));
-        } catch (Exception e) {
-            log.atDebug().withThrowable(e).log("Failed to record metrics with an unparsed model, dropping metrics");
-        }
-    }
-
-    private void inferOnServiceWithMetrics(
-        Model model,
-        InferenceAction.Request request,
-        InferenceService service,
-        InferenceTimer timer,
-        ActionListener<InferenceAction.Response> listener
-    ) {
-        inferenceStats.requestCount().incrementBy(1, modelAttributes(model));
-        inferOnService(model, request, service, ActionListener.wrap(inferenceResults -> {
-            if (request.isStreaming()) {
-                var taskProcessor = streamingTaskManager.<ChunkedToXContent>create(STREAMING_INFERENCE_TASK_TYPE, STREAMING_TASK_ACTION);
-                inferenceResults.publisher().subscribe(taskProcessor);
-
-                var instrumentedStream = new PublisherWithMetrics(timer, model);
-                taskProcessor.subscribe(instrumentedStream);
-
-                listener.onResponse(new InferenceAction.Response(inferenceResults, instrumentedStream));
-            } else {
-                recordMetrics(model, timer, null);
-                listener.onResponse(new InferenceAction.Response(inferenceResults));
-            }
-        }, e -> {
-            recordMetrics(model, timer, e);
-            listener.onFailure(e);
-        }));
+    protected boolean isInvalidTaskTypeForInferenceEndpoint(InferenceAction.Request request, UnparsedModel unparsedModel) {
+        return false;
     }
 
-    private void recordMetrics(Model model, InferenceTimer timer, @Nullable Throwable t) {
-        try {
-            inferenceStats.inferenceDuration().record(timer.elapsedMillis(), responseAttributes(model, t));
-        } catch (Exception e) {
-            log.atDebug().withThrowable(e).log("Failed to record metrics with a parsed model, dropping metrics");
-        }
+    @Override
+    protected ElasticsearchStatusException createInvalidTaskTypeException(InferenceAction.Request request, UnparsedModel unparsedModel) {
+        return null;
     }
 
-    private void inferOnService(
+    @Override
+    protected void doInference(
         Model model,
         InferenceAction.Request request,
         InferenceService service,
         ActionListener<InferenceServiceResults> listener
     ) {
-        if (request.isStreaming() == false || service.canStream(request.getTaskType())) {
-            service.infer(
-                model,
-                request.getQuery(),
-                request.getInput(),
-                request.isStreaming(),
-                request.getTaskSettings(),
-                request.getInputType(),
-                request.getInferenceTimeout(),
-                listener
-            );
-        } else {
-            listener.onFailure(unsupportedStreamingTaskException(request, service));
-        }
-    }
-
-    private ElasticsearchStatusException unsupportedStreamingTaskException(InferenceAction.Request request, InferenceService service) {
-        var supportedTasks = service.supportedStreamingTasks();
-        if (supportedTasks.isEmpty()) {
-            return new ElasticsearchStatusException(
-                format("Streaming is not allowed for service [%s].", service.name()),
-                RestStatus.METHOD_NOT_ALLOWED
-            );
-        } else {
-            var validTasks = supportedTasks.stream().map(TaskType::toString).collect(Collectors.joining(","));
-            return new ElasticsearchStatusException(
-                format(
-                    "Streaming is not allowed for service [%s] and task [%s]. Supported tasks: [%s]",
-                    service.name(),
-                    request.getTaskType(),
-                    validTasks
-                ),
-                RestStatus.METHOD_NOT_ALLOWED
-            );
-        }
-    }
-
-    private static ElasticsearchStatusException unknownServiceException(String service, String inferenceId) {
-        return new ElasticsearchStatusException("Unknown service [{}] for model [{}]. ", RestStatus.BAD_REQUEST, service, inferenceId);
-    }
-
-    private static ElasticsearchStatusException incompatibleTaskTypeException(TaskType requested, TaskType expected) {
-        return new ElasticsearchStatusException(
-            "Incompatible task_type, the requested type [{}] does not match the model type [{}]",
-            RestStatus.BAD_REQUEST,
-            requested,
-            expected
+        service.infer(
+            model,
+            request.getQuery(),
+            request.getInput(),
+            request.isStreaming(),
+            request.getTaskSettings(),
+            request.getInputType(),
+            request.getInferenceTimeout(),
+            listener
         );
     }
-
-    private class PublisherWithMetrics extends DelegatingProcessor<ChunkedToXContent, ChunkedToXContent> {
-        private final InferenceTimer timer;
-        private final Model model;
-
-        private PublisherWithMetrics(InferenceTimer timer, Model model) {
-            this.timer = timer;
-            this.model = model;
-        }
-
-        @Override
-        protected void next(ChunkedToXContent item) {
-            downstream().onNext(item);
-        }
-
-        @Override
-        public void onError(Throwable throwable) {
-            recordMetrics(model, timer, throwable);
-            super.onError(throwable);
-        }
-
-        @Override
-        protected void onCancel() {
-            recordMetrics(model, timer, null);
-            super.onCancel();
-        }
-
-        @Override
-        public void onComplete() {
-            recordMetrics(model, timer, null);
-            super.onComplete();
-        }
-    }
-
 }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/action/TransportUnifiedCompletionInferenceAction.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/action/TransportUnifiedCompletionInferenceAction.java
new file mode 100644
index 0000000000000..f0906231d8f42
--- /dev/null
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/action/TransportUnifiedCompletionInferenceAction.java
@@ -0,0 +1,77 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.action;
+
+import org.elasticsearch.ElasticsearchStatusException;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.support.ActionFilters;
+import org.elasticsearch.inference.InferenceService;
+import org.elasticsearch.inference.InferenceServiceRegistry;
+import org.elasticsearch.inference.InferenceServiceResults;
+import org.elasticsearch.inference.Model;
+import org.elasticsearch.inference.TaskType;
+import org.elasticsearch.inference.UnparsedModel;
+import org.elasticsearch.injection.guice.Inject;
+import org.elasticsearch.rest.RestStatus;
+import org.elasticsearch.transport.TransportService;
+import org.elasticsearch.xpack.core.inference.action.UnifiedCompletionAction;
+import org.elasticsearch.xpack.inference.action.task.StreamingTaskManager;
+import org.elasticsearch.xpack.inference.registry.ModelRegistry;
+import org.elasticsearch.xpack.inference.telemetry.InferenceStats;
+
+public class TransportUnifiedCompletionInferenceAction extends BaseTransportInferenceAction<UnifiedCompletionAction.Request> {
+
+    @Inject
+    public TransportUnifiedCompletionInferenceAction(
+        TransportService transportService,
+        ActionFilters actionFilters,
+        ModelRegistry modelRegistry,
+        InferenceServiceRegistry serviceRegistry,
+        InferenceStats inferenceStats,
+        StreamingTaskManager streamingTaskManager
+    ) {
+        super(
+            UnifiedCompletionAction.NAME,
+            transportService,
+            actionFilters,
+            modelRegistry,
+            serviceRegistry,
+            inferenceStats,
+            streamingTaskManager,
+            UnifiedCompletionAction.Request::new
+        );
+    }
+
+    @Override
+    protected boolean isInvalidTaskTypeForInferenceEndpoint(UnifiedCompletionAction.Request request, UnparsedModel unparsedModel) {
+        return request.getTaskType().isAnyOrSame(TaskType.COMPLETION) == false || unparsedModel.taskType() != TaskType.COMPLETION;
+    }
+
+    @Override
+    protected ElasticsearchStatusException createInvalidTaskTypeException(
+        UnifiedCompletionAction.Request request,
+        UnparsedModel unparsedModel
+    ) {
+        return new ElasticsearchStatusException(
+            "Incompatible task_type for unified API, the requested type [{}] must be one of [{}]",
+            RestStatus.BAD_REQUEST,
+            request.getTaskType(),
+            TaskType.COMPLETION.toString()
+        );
+    }
+
+    @Override
+    protected void doInference(
+        Model model,
+        UnifiedCompletionAction.Request request,
+        InferenceService service,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+        service.unifiedCompletionInfer(model, request.getUnifiedCompletionRequest(), null, listener);
+    }
+}
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/common/DelegatingProcessor.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/common/DelegatingProcessor.java
index 03e794e42c3a2..eda3fc0f3bfdb 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/common/DelegatingProcessor.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/common/DelegatingProcessor.java
@@ -9,7 +9,14 @@
 
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
-
+import org.elasticsearch.xcontent.XContentParserConfiguration;
+import org.elasticsearch.xpack.inference.external.response.streaming.ServerSentEvent;
+import org.elasticsearch.xpack.inference.external.response.streaming.ServerSentEventField;
+
+import java.io.IOException;
+import java.util.ArrayDeque;
+import java.util.Deque;
+import java.util.Iterator;
 import java.util.concurrent.Flow;
 import java.util.concurrent.atomic.AtomicBoolean;
 import java.util.concurrent.atomic.AtomicLong;
@@ -25,6 +32,33 @@ public abstract class DelegatingProcessor<T, R> implements Flow.Processor<T, R>
     private Flow.Subscriber<? super R> downstream;
     private Flow.Subscription upstream;
 
+    public static <ParsedChunk> Deque<ParsedChunk> parseEvent(
+        Deque<ServerSentEvent> item,
+        ParseChunkFunction<ParsedChunk> parseFunction,
+        XContentParserConfiguration parserConfig,
+        Logger logger
+    ) throws Exception {
+        var results = new ArrayDeque<ParsedChunk>(item.size());
+        for (ServerSentEvent event : item) {
+            if (ServerSentEventField.DATA == event.name() && event.hasValue()) {
+                try {
+                    var delta = parseFunction.apply(parserConfig, event);
+                    delta.forEachRemaining(results::offer);
+                } catch (Exception e) {
+                    logger.warn("Failed to parse event from inference provider: {}", event);
+                    throw e;
+                }
+            }
+        }
+
+        return results;
+    }
+
+    @FunctionalInterface
+    public interface ParseChunkFunction<ParsedChunk> {
+        Iterator<ParsedChunk> apply(XContentParserConfiguration parserConfig, ServerSentEvent event) throws IOException;
+    }
+
     @Override
     public void subscribe(Flow.Subscriber<? super R> subscriber) {
         if (downstream != null) {
@@ -51,7 +85,7 @@ public void request(long n) {
                 if (isClosed.get()) {
                     downstream.onComplete();
                 } else if (upstream != null) {
-                    upstream.request(n);
+                    upstreamRequest(n);
                 } else {
                     pendingRequests.accumulateAndGet(n, Long::sum);
                 }
@@ -67,6 +101,13 @@ public void cancel() {
         };
     }
 
+    /**
+     * Guaranteed to be called when the upstream is set and this processor had not been closed.
+     */
+    protected void upstreamRequest(long n) {
+        upstream.request(n);
+    }
+
     protected void onCancel() {}
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/action/SingleInputSenderExecutableAction.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/action/SingleInputSenderExecutableAction.java
index 4e97554b56445..b43e5ab70e2f2 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/action/SingleInputSenderExecutableAction.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/action/SingleInputSenderExecutableAction.java
@@ -12,7 +12,6 @@
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.inference.InferenceServiceResults;
 import org.elasticsearch.rest.RestStatus;
-import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.InferenceInputs;
 import org.elasticsearch.xpack.inference.external.http.sender.RequestManager;
 import org.elasticsearch.xpack.inference.external.http.sender.Sender;
@@ -34,13 +33,7 @@ public SingleInputSenderExecutableAction(
 
     @Override
     public void execute(InferenceInputs inferenceInputs, TimeValue timeout, ActionListener<InferenceServiceResults> listener) {
-        if (inferenceInputs instanceof DocumentsOnlyInput == false) {
-            listener.onFailure(new ElasticsearchStatusException("Invalid inference input type", RestStatus.INTERNAL_SERVER_ERROR));
-            return;
-        }
-
-        var docsOnlyInput = (DocumentsOnlyInput) inferenceInputs;
-        if (docsOnlyInput.getInputs().size() > 1) {
+        if (inferenceInputs.inputSize() > 1) {
             listener.onFailure(
                 new ElasticsearchStatusException(requestTypeForInputValidationError + " only accepts 1 input", RestStatus.BAD_REQUEST)
             );
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/action/openai/OpenAiActionCreator.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/action/openai/OpenAiActionCreator.java
index 9c83264b5581f..bd5c53d589df0 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/action/openai/OpenAiActionCreator.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/action/openai/OpenAiActionCreator.java
@@ -26,7 +26,7 @@
  * Provides a way to construct an {@link ExecutableAction} using the visitor pattern based on the openai model type.
  */
 public class OpenAiActionCreator implements OpenAiActionVisitor {
-    private static final String COMPLETION_ERROR_PREFIX = "OpenAI chat completions";
+    public static final String COMPLETION_ERROR_PREFIX = "OpenAI chat completions";
     private final Sender sender;
     private final ServiceComponents serviceComponents;
 
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AlibabaCloudSearchCompletionRequestManager.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AlibabaCloudSearchCompletionRequestManager.java
index a0a44e62f9f73..e7a960f1316f2 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AlibabaCloudSearchCompletionRequestManager.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AlibabaCloudSearchCompletionRequestManager.java
@@ -69,7 +69,7 @@ public void execute(
         Supplier<Boolean> hasRequestCompletedFunction,
         ActionListener<InferenceServiceResults> listener
     ) {
-        List<String> input = DocumentsOnlyInput.of(inferenceInputs).getInputs();
+        List<String> input = inferenceInputs.castTo(ChatCompletionInput.class).getInputs();
         AlibabaCloudSearchCompletionRequest request = new AlibabaCloudSearchCompletionRequest(account, input, model);
         execute(new ExecutableInferenceRequest(requestSender, logger, request, HANDLER, hasRequestCompletedFunction, listener));
     }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AmazonBedrockChatCompletionRequestManager.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AmazonBedrockChatCompletionRequestManager.java
index 69a5c665feb86..3929585a0745d 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AmazonBedrockChatCompletionRequestManager.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AmazonBedrockChatCompletionRequestManager.java
@@ -44,10 +44,10 @@ public void execute(
         Supplier<Boolean> hasRequestCompletedFunction,
         ActionListener<InferenceServiceResults> listener
     ) {
-        var docsOnly = DocumentsOnlyInput.of(inferenceInputs);
-        var docsInput = docsOnly.getInputs();
-        var stream = docsOnly.stream();
-        var requestEntity = AmazonBedrockChatCompletionEntityFactory.createEntity(model, docsInput);
+        var chatCompletionInput = inferenceInputs.castTo(ChatCompletionInput.class);
+        var inputs = chatCompletionInput.getInputs();
+        var stream = chatCompletionInput.stream();
+        var requestEntity = AmazonBedrockChatCompletionEntityFactory.createEntity(model, inputs);
         var request = new AmazonBedrockChatCompletionRequest(model, requestEntity, timeout, stream);
         var responseHandler = new AmazonBedrockChatCompletionResponseHandler();
 
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AnthropicCompletionRequestManager.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AnthropicCompletionRequestManager.java
index 5418b3dd9840b..6d4aeb9e31bac 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AnthropicCompletionRequestManager.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AnthropicCompletionRequestManager.java
@@ -46,10 +46,10 @@ public void execute(
         Supplier<Boolean> hasRequestCompletedFunction,
         ActionListener<InferenceServiceResults> listener
     ) {
-        var docsOnly = DocumentsOnlyInput.of(inferenceInputs);
-        var docsInput = docsOnly.getInputs();
-        var stream = docsOnly.stream();
-        AnthropicChatCompletionRequest request = new AnthropicChatCompletionRequest(docsInput, model, stream);
+        var chatCompletionInput = inferenceInputs.castTo(ChatCompletionInput.class);
+        var inputs = chatCompletionInput.getInputs();
+        var stream = chatCompletionInput.stream();
+        AnthropicChatCompletionRequest request = new AnthropicChatCompletionRequest(inputs, model, stream);
 
         execute(new ExecutableInferenceRequest(requestSender, logger, request, HANDLER, hasRequestCompletedFunction, listener));
     }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AzureAiStudioChatCompletionRequestManager.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AzureAiStudioChatCompletionRequestManager.java
index 21cec68b14a49..affd2e3a7760e 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AzureAiStudioChatCompletionRequestManager.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AzureAiStudioChatCompletionRequestManager.java
@@ -41,10 +41,10 @@ public void execute(
         Supplier<Boolean> hasRequestCompletedFunction,
         ActionListener<InferenceServiceResults> listener
     ) {
-        var docsOnly = DocumentsOnlyInput.of(inferenceInputs);
-        var docsInput = docsOnly.getInputs();
-        var stream = docsOnly.stream();
-        AzureAiStudioChatCompletionRequest request = new AzureAiStudioChatCompletionRequest(model, docsInput, stream);
+        var chatCompletionInput = inferenceInputs.castTo(ChatCompletionInput.class);
+        var inputs = chatCompletionInput.getInputs();
+        var stream = chatCompletionInput.stream();
+        AzureAiStudioChatCompletionRequest request = new AzureAiStudioChatCompletionRequest(model, inputs, stream);
 
         execute(new ExecutableInferenceRequest(requestSender, logger, request, HANDLER, hasRequestCompletedFunction, listener));
     }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AzureOpenAiCompletionRequestManager.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AzureOpenAiCompletionRequestManager.java
index d036559ec3dcb..c2f5f3e9db5ed 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AzureOpenAiCompletionRequestManager.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/AzureOpenAiCompletionRequestManager.java
@@ -46,10 +46,10 @@ public void execute(
         Supplier<Boolean> hasRequestCompletedFunction,
         ActionListener<InferenceServiceResults> listener
     ) {
-        var docsOnly = DocumentsOnlyInput.of(inferenceInputs);
-        var docsInput = docsOnly.getInputs();
-        var stream = docsOnly.stream();
-        AzureOpenAiCompletionRequest request = new AzureOpenAiCompletionRequest(docsInput, model, stream);
+        var chatCompletionInput = inferenceInputs.castTo(ChatCompletionInput.class);
+        var inputs = chatCompletionInput.getInputs();
+        var stream = chatCompletionInput.stream();
+        AzureOpenAiCompletionRequest request = new AzureOpenAiCompletionRequest(inputs, model, stream);
         execute(new ExecutableInferenceRequest(requestSender, logger, request, HANDLER, hasRequestCompletedFunction, listener));
     }
 
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/ChatCompletionInput.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/ChatCompletionInput.java
new file mode 100644
index 0000000000000..928da95d9c2f0
--- /dev/null
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/ChatCompletionInput.java
@@ -0,0 +1,39 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.external.http.sender;
+
+import java.util.List;
+import java.util.Objects;
+
+/**
+ * This class encapsulates the input text passed by the request and indicates whether the response should be streamed.
+ * The main difference between this class and {@link UnifiedChatInput} is this should only be used for
+ * {@link org.elasticsearch.inference.TaskType#COMPLETION} originating through the
+ * {@link org.elasticsearch.inference.InferenceService#infer} code path. These are requests sent to the
+ * API without using the <code>_unified</code> route.
+ */
+public class ChatCompletionInput extends InferenceInputs {
+    private final List<String> input;
+
+    public ChatCompletionInput(List<String> input) {
+        this(input, false);
+    }
+
+    public ChatCompletionInput(List<String> input, boolean stream) {
+        super(stream);
+        this.input = Objects.requireNonNull(input);
+    }
+
+    public List<String> getInputs() {
+        return this.input;
+    }
+
+    public int inputSize() {
+        return input.size();
+    }
+}
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/CohereCompletionRequestManager.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/CohereCompletionRequestManager.java
index ae46fbe0fef87..40cd03c87664e 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/CohereCompletionRequestManager.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/CohereCompletionRequestManager.java
@@ -50,10 +50,10 @@ public void execute(
         Supplier<Boolean> hasRequestCompletedFunction,
         ActionListener<InferenceServiceResults> listener
     ) {
-        var docsOnly = DocumentsOnlyInput.of(inferenceInputs);
-        var docsInput = docsOnly.getInputs();
-        var stream = docsOnly.stream();
-        CohereCompletionRequest request = new CohereCompletionRequest(docsInput, model, stream);
+        var chatCompletionInput = inferenceInputs.castTo(ChatCompletionInput.class);
+        var inputs = chatCompletionInput.getInputs();
+        var stream = chatCompletionInput.stream();
+        CohereCompletionRequest request = new CohereCompletionRequest(inputs, model, stream);
 
         execute(new ExecutableInferenceRequest(requestSender, logger, request, HANDLER, hasRequestCompletedFunction, listener));
     }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/DocumentsOnlyInput.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/DocumentsOnlyInput.java
index 8cf411d84c932..3feb79d3de6cc 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/DocumentsOnlyInput.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/DocumentsOnlyInput.java
@@ -14,30 +14,28 @@ public class DocumentsOnlyInput extends InferenceInputs {
 
     public static DocumentsOnlyInput of(InferenceInputs inferenceInputs) {
         if (inferenceInputs instanceof DocumentsOnlyInput == false) {
-            throw createUnsupportedTypeException(inferenceInputs);
+            throw createUnsupportedTypeException(inferenceInputs, DocumentsOnlyInput.class);
         }
 
         return (DocumentsOnlyInput) inferenceInputs;
     }
 
     private final List<String> input;
-    private final boolean stream;
 
     public DocumentsOnlyInput(List<String> input) {
         this(input, false);
     }
 
     public DocumentsOnlyInput(List<String> input, boolean stream) {
-        super();
+        super(stream);
         this.input = Objects.requireNonNull(input);
-        this.stream = stream;
     }
 
     public List<String> getInputs() {
         return this.input;
     }
 
-    public boolean stream() {
-        return stream;
+    public int inputSize() {
+        return input.size();
     }
 }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/GoogleAiStudioCompletionRequestManager.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/GoogleAiStudioCompletionRequestManager.java
index abe50c6fae3f9..0097f9c08ea21 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/GoogleAiStudioCompletionRequestManager.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/GoogleAiStudioCompletionRequestManager.java
@@ -51,7 +51,10 @@ public void execute(
         Supplier<Boolean> hasRequestCompletedFunction,
         ActionListener<InferenceServiceResults> listener
     ) {
-        GoogleAiStudioCompletionRequest request = new GoogleAiStudioCompletionRequest(DocumentsOnlyInput.of(inferenceInputs), model);
+        GoogleAiStudioCompletionRequest request = new GoogleAiStudioCompletionRequest(
+            inferenceInputs.castTo(ChatCompletionInput.class),
+            model
+        );
         execute(new ExecutableInferenceRequest(requestSender, logger, request, HANDLER, hasRequestCompletedFunction, listener));
     }
 }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/InferenceInputs.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/InferenceInputs.java
index dd241857ef0c4..e85ea6f1d9b35 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/InferenceInputs.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/InferenceInputs.java
@@ -10,7 +10,29 @@
 import org.elasticsearch.common.Strings;
 
 public abstract class InferenceInputs {
-    public static IllegalArgumentException createUnsupportedTypeException(InferenceInputs inferenceInputs) {
-        return new IllegalArgumentException(Strings.format("Unsupported inference inputs type: [%s]", inferenceInputs.getClass()));
+    private final boolean stream;
+
+    public InferenceInputs(boolean stream) {
+        this.stream = stream;
+    }
+
+    public static IllegalArgumentException createUnsupportedTypeException(InferenceInputs inferenceInputs, Class<?> clazz) {
+        return new IllegalArgumentException(
+            Strings.format("Unable to convert inference inputs type: [%s] to [%s]", inferenceInputs.getClass(), clazz)
+        );
     }
+
+    public <T> T castTo(Class<T> clazz) {
+        if (clazz.isInstance(this) == false) {
+            throw createUnsupportedTypeException(this, clazz);
+        }
+
+        return clazz.cast(this);
+    }
+
+    public boolean stream() {
+        return stream;
+    }
+
+    public abstract int inputSize();
 }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/OpenAiCompletionRequestManager.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/OpenAiCompletionRequestManager.java
index cea89332e5bf0..4d730be6aa6bd 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/OpenAiCompletionRequestManager.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/OpenAiCompletionRequestManager.java
@@ -15,7 +15,7 @@
 import org.elasticsearch.xpack.inference.external.http.retry.RequestSender;
 import org.elasticsearch.xpack.inference.external.http.retry.ResponseHandler;
 import org.elasticsearch.xpack.inference.external.openai.OpenAiChatCompletionResponseHandler;
-import org.elasticsearch.xpack.inference.external.request.openai.OpenAiChatCompletionRequest;
+import org.elasticsearch.xpack.inference.external.request.openai.OpenAiUnifiedChatCompletionRequest;
 import org.elasticsearch.xpack.inference.external.response.openai.OpenAiChatCompletionResponseEntity;
 import org.elasticsearch.xpack.inference.services.openai.completion.OpenAiChatCompletionModel;
 
@@ -25,8 +25,8 @@
 public class OpenAiCompletionRequestManager extends OpenAiRequestManager {
 
     private static final Logger logger = LogManager.getLogger(OpenAiCompletionRequestManager.class);
-
     private static final ResponseHandler HANDLER = createCompletionHandler();
+    static final String USER_ROLE = "user";
 
     public static OpenAiCompletionRequestManager of(OpenAiChatCompletionModel model, ThreadPool threadPool) {
         return new OpenAiCompletionRequestManager(Objects.requireNonNull(model), Objects.requireNonNull(threadPool));
@@ -35,7 +35,7 @@ public static OpenAiCompletionRequestManager of(OpenAiChatCompletionModel model,
     private final OpenAiChatCompletionModel model;
 
     private OpenAiCompletionRequestManager(OpenAiChatCompletionModel model, ThreadPool threadPool) {
-        super(threadPool, model, OpenAiChatCompletionRequest::buildDefaultUri);
+        super(threadPool, model, OpenAiUnifiedChatCompletionRequest::buildDefaultUri);
         this.model = Objects.requireNonNull(model);
     }
 
@@ -46,10 +46,8 @@ public void execute(
         Supplier<Boolean> hasRequestCompletedFunction,
         ActionListener<InferenceServiceResults> listener
     ) {
-        var docsOnly = DocumentsOnlyInput.of(inferenceInputs);
-        var docsInput = docsOnly.getInputs();
-        var stream = docsOnly.stream();
-        OpenAiChatCompletionRequest request = new OpenAiChatCompletionRequest(docsInput, model, stream);
+        var chatCompletionInputs = inferenceInputs.castTo(ChatCompletionInput.class);
+        var request = new OpenAiUnifiedChatCompletionRequest(new UnifiedChatInput(chatCompletionInputs, USER_ROLE), model);
 
         execute(new ExecutableInferenceRequest(requestSender, logger, request, HANDLER, hasRequestCompletedFunction, listener));
     }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/OpenAiUnifiedCompletionRequestManager.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/OpenAiUnifiedCompletionRequestManager.java
new file mode 100644
index 0000000000000..3b0f770e3e061
--- /dev/null
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/OpenAiUnifiedCompletionRequestManager.java
@@ -0,0 +1,61 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.external.http.sender;
+
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.inference.InferenceServiceResults;
+import org.elasticsearch.threadpool.ThreadPool;
+import org.elasticsearch.xpack.inference.external.http.retry.RequestSender;
+import org.elasticsearch.xpack.inference.external.http.retry.ResponseHandler;
+import org.elasticsearch.xpack.inference.external.openai.OpenAiUnifiedChatCompletionResponseHandler;
+import org.elasticsearch.xpack.inference.external.request.openai.OpenAiUnifiedChatCompletionRequest;
+import org.elasticsearch.xpack.inference.external.response.openai.OpenAiChatCompletionResponseEntity;
+import org.elasticsearch.xpack.inference.services.openai.completion.OpenAiChatCompletionModel;
+
+import java.util.Objects;
+import java.util.function.Supplier;
+
+public class OpenAiUnifiedCompletionRequestManager extends OpenAiRequestManager {
+
+    private static final Logger logger = LogManager.getLogger(OpenAiUnifiedCompletionRequestManager.class);
+
+    private static final ResponseHandler HANDLER = createCompletionHandler();
+
+    public static OpenAiUnifiedCompletionRequestManager of(OpenAiChatCompletionModel model, ThreadPool threadPool) {
+        return new OpenAiUnifiedCompletionRequestManager(Objects.requireNonNull(model), Objects.requireNonNull(threadPool));
+    }
+
+    private final OpenAiChatCompletionModel model;
+
+    private OpenAiUnifiedCompletionRequestManager(OpenAiChatCompletionModel model, ThreadPool threadPool) {
+        super(threadPool, model, OpenAiUnifiedChatCompletionRequest::buildDefaultUri);
+        this.model = Objects.requireNonNull(model);
+    }
+
+    @Override
+    public void execute(
+        InferenceInputs inferenceInputs,
+        RequestSender requestSender,
+        Supplier<Boolean> hasRequestCompletedFunction,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+
+        OpenAiUnifiedChatCompletionRequest request = new OpenAiUnifiedChatCompletionRequest(
+            inferenceInputs.castTo(UnifiedChatInput.class),
+            model
+        );
+
+        execute(new ExecutableInferenceRequest(requestSender, logger, request, HANDLER, hasRequestCompletedFunction, listener));
+    }
+
+    private static ResponseHandler createCompletionHandler() {
+        return new OpenAiUnifiedChatCompletionResponseHandler("openai completion", OpenAiChatCompletionResponseEntity::fromResponse);
+    }
+}
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/QueryAndDocsInputs.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/QueryAndDocsInputs.java
index 50bb77b307db3..5af5245ac5b40 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/QueryAndDocsInputs.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/QueryAndDocsInputs.java
@@ -14,7 +14,7 @@ public class QueryAndDocsInputs extends InferenceInputs {
 
     public static QueryAndDocsInputs of(InferenceInputs inferenceInputs) {
         if (inferenceInputs instanceof QueryAndDocsInputs == false) {
-            throw createUnsupportedTypeException(inferenceInputs);
+            throw createUnsupportedTypeException(inferenceInputs, QueryAndDocsInputs.class);
         }
 
         return (QueryAndDocsInputs) inferenceInputs;
@@ -22,17 +22,15 @@ public static QueryAndDocsInputs of(InferenceInputs inferenceInputs) {
 
     private final String query;
     private final List<String> chunks;
-    private final boolean stream;
 
     public QueryAndDocsInputs(String query, List<String> chunks) {
         this(query, chunks, false);
     }
 
     public QueryAndDocsInputs(String query, List<String> chunks, boolean stream) {
-        super();
+        super(stream);
         this.query = Objects.requireNonNull(query);
         this.chunks = Objects.requireNonNull(chunks);
-        this.stream = stream;
     }
 
     public String getQuery() {
@@ -43,8 +41,7 @@ public List<String> getChunks() {
         return chunks;
     }
 
-    public boolean stream() {
-        return stream;
+    public int inputSize() {
+        return chunks.size();
     }
-
 }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/UnifiedChatInput.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/UnifiedChatInput.java
new file mode 100644
index 0000000000000..f89fa1ee37a6f
--- /dev/null
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/http/sender/UnifiedChatInput.java
@@ -0,0 +1,62 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.external.http.sender;
+
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.core.TimeValue;
+import org.elasticsearch.inference.Model;
+import org.elasticsearch.inference.UnifiedCompletionRequest;
+
+import java.util.List;
+import java.util.Objects;
+
+/**
+ * This class encapsulates the unified request.
+ * The main difference between this class and {@link ChatCompletionInput} is this should only be used for
+ * {@link org.elasticsearch.inference.TaskType#COMPLETION} originating through the
+ * {@link org.elasticsearch.inference.InferenceService#unifiedCompletionInfer(Model, UnifiedCompletionRequest, TimeValue, ActionListener)}
+ * code path. These are requests sent to the API with the <code>_unified</code> route.
+ */
+public class UnifiedChatInput extends InferenceInputs {
+    private final UnifiedCompletionRequest request;
+
+    public UnifiedChatInput(UnifiedCompletionRequest request, boolean stream) {
+        super(stream);
+        this.request = Objects.requireNonNull(request);
+    }
+
+    public UnifiedChatInput(ChatCompletionInput completionInput, String roleValue) {
+        this(completionInput.getInputs(), roleValue, completionInput.stream());
+    }
+
+    public UnifiedChatInput(List<String> inputs, String roleValue, boolean stream) {
+        this(UnifiedCompletionRequest.of(convertToMessages(inputs, roleValue)), stream);
+    }
+
+    private static List<UnifiedCompletionRequest.Message> convertToMessages(List<String> inputs, String roleValue) {
+        return inputs.stream()
+            .map(
+                value -> new UnifiedCompletionRequest.Message(
+                    new UnifiedCompletionRequest.ContentString(value),
+                    roleValue,
+                    null,
+                    null,
+                    null
+                )
+            )
+            .toList();
+    }
+
+    public UnifiedCompletionRequest getRequest() {
+        return request;
+    }
+
+    public int inputSize() {
+        return request.messages().size();
+    }
+}
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/openai/OpenAiStreamingProcessor.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/openai/OpenAiStreamingProcessor.java
index 6e006fe255956..48c8132035b50 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/openai/OpenAiStreamingProcessor.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/openai/OpenAiStreamingProcessor.java
@@ -18,10 +18,8 @@
 import org.elasticsearch.xpack.core.inference.results.StreamingChatCompletionResults;
 import org.elasticsearch.xpack.inference.common.DelegatingProcessor;
 import org.elasticsearch.xpack.inference.external.response.streaming.ServerSentEvent;
-import org.elasticsearch.xpack.inference.external.response.streaming.ServerSentEventField;
 
 import java.io.IOException;
-import java.util.ArrayDeque;
 import java.util.Collections;
 import java.util.Deque;
 import java.util.Iterator;
@@ -115,19 +113,7 @@ public class OpenAiStreamingProcessor extends DelegatingProcessor<Deque<ServerSe
     @Override
     protected void next(Deque<ServerSentEvent> item) throws Exception {
         var parserConfig = XContentParserConfiguration.EMPTY.withDeprecationHandler(LoggingDeprecationHandler.INSTANCE);
-
-        var results = new ArrayDeque<StreamingChatCompletionResults.Result>(item.size());
-        for (ServerSentEvent event : item) {
-            if (ServerSentEventField.DATA == event.name() && event.hasValue()) {
-                try {
-                    var delta = parse(parserConfig, event);
-                    delta.forEachRemaining(results::offer);
-                } catch (Exception e) {
-                    log.warn("Failed to parse event from inference provider: {}", event);
-                    throw e;
-                }
-            }
-        }
+        var results = parseEvent(item, OpenAiStreamingProcessor::parse, parserConfig, log);
 
         if (results.isEmpty()) {
             upstream().request(1);
@@ -136,7 +122,7 @@ protected void next(Deque<ServerSentEvent> item) throws Exception {
         }
     }
 
-    private Iterator<StreamingChatCompletionResults.Result> parse(XContentParserConfiguration parserConfig, ServerSentEvent event)
+    private static Iterator<StreamingChatCompletionResults.Result> parse(XContentParserConfiguration parserConfig, ServerSentEvent event)
         throws IOException {
         if (DONE_MESSAGE.equalsIgnoreCase(event.value())) {
             return Collections.emptyIterator();
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/openai/OpenAiUnifiedChatCompletionResponseHandler.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/openai/OpenAiUnifiedChatCompletionResponseHandler.java
new file mode 100644
index 0000000000000..fce2556efc5e0
--- /dev/null
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/openai/OpenAiUnifiedChatCompletionResponseHandler.java
@@ -0,0 +1,34 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.external.openai;
+
+import org.elasticsearch.inference.InferenceServiceResults;
+import org.elasticsearch.xpack.core.inference.results.StreamingUnifiedChatCompletionResults;
+import org.elasticsearch.xpack.inference.external.http.HttpResult;
+import org.elasticsearch.xpack.inference.external.http.retry.ResponseParser;
+import org.elasticsearch.xpack.inference.external.request.Request;
+import org.elasticsearch.xpack.inference.external.response.streaming.ServerSentEventParser;
+import org.elasticsearch.xpack.inference.external.response.streaming.ServerSentEventProcessor;
+
+import java.util.concurrent.Flow;
+
+public class OpenAiUnifiedChatCompletionResponseHandler extends OpenAiChatCompletionResponseHandler {
+    public OpenAiUnifiedChatCompletionResponseHandler(String requestType, ResponseParser parseFunction) {
+        super(requestType, parseFunction);
+    }
+
+    @Override
+    public InferenceServiceResults parseResult(Request request, Flow.Publisher<HttpResult> flow) {
+        var serverSentEventProcessor = new ServerSentEventProcessor(new ServerSentEventParser());
+        var openAiProcessor = new OpenAiUnifiedStreamingProcessor();
+
+        flow.subscribe(serverSentEventProcessor);
+        serverSentEventProcessor.subscribe(openAiProcessor);
+        return new StreamingUnifiedChatCompletionResults(openAiProcessor);
+    }
+}
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/openai/OpenAiUnifiedStreamingProcessor.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/openai/OpenAiUnifiedStreamingProcessor.java
new file mode 100644
index 0000000000000..599d71df3dcfa
--- /dev/null
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/openai/OpenAiUnifiedStreamingProcessor.java
@@ -0,0 +1,287 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.external.openai;
+
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import org.elasticsearch.common.xcontent.ChunkedToXContent;
+import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
+import org.elasticsearch.xcontent.ConstructingObjectParser;
+import org.elasticsearch.xcontent.ParseField;
+import org.elasticsearch.xcontent.XContentFactory;
+import org.elasticsearch.xcontent.XContentParser;
+import org.elasticsearch.xcontent.XContentParserConfiguration;
+import org.elasticsearch.xcontent.XContentType;
+import org.elasticsearch.xpack.core.inference.results.StreamingUnifiedChatCompletionResults;
+import org.elasticsearch.xpack.inference.common.DelegatingProcessor;
+import org.elasticsearch.xpack.inference.external.response.streaming.ServerSentEvent;
+
+import java.io.IOException;
+import java.util.ArrayDeque;
+import java.util.Collections;
+import java.util.Deque;
+import java.util.Iterator;
+import java.util.List;
+import java.util.concurrent.LinkedBlockingDeque;
+
+import static org.elasticsearch.common.xcontent.XContentParserUtils.ensureExpectedToken;
+import static org.elasticsearch.xpack.inference.external.response.XContentUtils.moveToFirstToken;
+
+public class OpenAiUnifiedStreamingProcessor extends DelegatingProcessor<Deque<ServerSentEvent>, ChunkedToXContent> {
+    public static final String FUNCTION_FIELD = "function";
+    private static final Logger logger = LogManager.getLogger(OpenAiUnifiedStreamingProcessor.class);
+
+    private static final String CHOICES_FIELD = "choices";
+    private static final String DELTA_FIELD = "delta";
+    private static final String CONTENT_FIELD = "content";
+    private static final String DONE_MESSAGE = "[done]";
+    private static final String REFUSAL_FIELD = "refusal";
+    private static final String TOOL_CALLS_FIELD = "tool_calls";
+    public static final String ROLE_FIELD = "role";
+    public static final String FINISH_REASON_FIELD = "finish_reason";
+    public static final String INDEX_FIELD = "index";
+    public static final String OBJECT_FIELD = "object";
+    public static final String MODEL_FIELD = "model";
+    public static final String ID_FIELD = "id";
+    public static final String CHOICE_FIELD = "choice";
+    public static final String USAGE_FIELD = "usage";
+    public static final String TYPE_FIELD = "type";
+    public static final String NAME_FIELD = "name";
+    public static final String ARGUMENTS_FIELD = "arguments";
+    public static final String COMPLETION_TOKENS_FIELD = "completion_tokens";
+    public static final String PROMPT_TOKENS_FIELD = "prompt_tokens";
+    public static final String TOTAL_TOKENS_FIELD = "total_tokens";
+
+    private final Deque<StreamingUnifiedChatCompletionResults.ChatCompletionChunk> buffer = new LinkedBlockingDeque<>();
+
+    @Override
+    protected void upstreamRequest(long n) {
+        if (buffer.isEmpty()) {
+            super.upstreamRequest(n);
+        } else {
+            downstream().onNext(new StreamingUnifiedChatCompletionResults.Results(singleItem(buffer.poll())));
+        }
+    }
+
+    @Override
+    protected void next(Deque<ServerSentEvent> item) throws Exception {
+        var parserConfig = XContentParserConfiguration.EMPTY.withDeprecationHandler(LoggingDeprecationHandler.INSTANCE);
+        var results = parseEvent(item, OpenAiUnifiedStreamingProcessor::parse, parserConfig, logger);
+
+        if (results.isEmpty()) {
+            upstream().request(1);
+        } else if (results.size() == 1) {
+            downstream().onNext(new StreamingUnifiedChatCompletionResults.Results(results));
+        } else {
+            // results > 1, but openai spec only wants 1 chunk per SSE event
+            var firstItem = singleItem(results.poll());
+            while (results.isEmpty() == false) {
+                buffer.offer(results.poll());
+            }
+            downstream().onNext(new StreamingUnifiedChatCompletionResults.Results(firstItem));
+        }
+    }
+
+    private static Iterator<StreamingUnifiedChatCompletionResults.ChatCompletionChunk> parse(
+        XContentParserConfiguration parserConfig,
+        ServerSentEvent event
+    ) throws IOException {
+        if (DONE_MESSAGE.equalsIgnoreCase(event.value())) {
+            return Collections.emptyIterator();
+        }
+
+        try (XContentParser jsonParser = XContentFactory.xContent(XContentType.JSON).createParser(parserConfig, event.value())) {
+            moveToFirstToken(jsonParser);
+
+            XContentParser.Token token = jsonParser.currentToken();
+            ensureExpectedToken(XContentParser.Token.START_OBJECT, token, jsonParser);
+
+            StreamingUnifiedChatCompletionResults.ChatCompletionChunk chunk = ChatCompletionChunkParser.parse(jsonParser);
+
+            return Collections.singleton(chunk).iterator();
+        }
+    }
+
+    public static class ChatCompletionChunkParser {
+        @SuppressWarnings("unchecked")
+        private static final ConstructingObjectParser<StreamingUnifiedChatCompletionResults.ChatCompletionChunk, Void> PARSER =
+            new ConstructingObjectParser<>(
+                "chat_completion_chunk",
+                true,
+                args -> new StreamingUnifiedChatCompletionResults.ChatCompletionChunk(
+                    (String) args[0],
+                    (List<StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice>) args[1],
+                    (String) args[2],
+                    (String) args[3],
+                    (StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Usage) args[4]
+                )
+            );
+
+        static {
+            PARSER.declareString(ConstructingObjectParser.constructorArg(), new ParseField(ID_FIELD));
+            PARSER.declareObjectArray(
+                ConstructingObjectParser.constructorArg(),
+                (p, c) -> ChatCompletionChunkParser.ChoiceParser.parse(p),
+                new ParseField(CHOICES_FIELD)
+            );
+            PARSER.declareString(ConstructingObjectParser.constructorArg(), new ParseField(MODEL_FIELD));
+            PARSER.declareString(ConstructingObjectParser.constructorArg(), new ParseField(OBJECT_FIELD));
+            PARSER.declareObjectOrNull(
+                ConstructingObjectParser.optionalConstructorArg(),
+                (p, c) -> ChatCompletionChunkParser.UsageParser.parse(p),
+                null,
+                new ParseField(USAGE_FIELD)
+            );
+        }
+
+        public static StreamingUnifiedChatCompletionResults.ChatCompletionChunk parse(XContentParser parser) throws IOException {
+            return PARSER.parse(parser, null);
+        }
+
+        private static class ChoiceParser {
+            private static final ConstructingObjectParser<StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice, Void> PARSER =
+                new ConstructingObjectParser<>(
+                    CHOICE_FIELD,
+                    true,
+                    args -> new StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice(
+                        (StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta) args[0],
+                        (String) args[1],
+                        (int) args[2]
+                    )
+                );
+
+            static {
+                PARSER.declareObject(
+                    ConstructingObjectParser.constructorArg(),
+                    (p, c) -> ChatCompletionChunkParser.DeltaParser.parse(p),
+                    new ParseField(DELTA_FIELD)
+                );
+                PARSER.declareStringOrNull(ConstructingObjectParser.optionalConstructorArg(), new ParseField(FINISH_REASON_FIELD));
+                PARSER.declareInt(ConstructingObjectParser.constructorArg(), new ParseField(INDEX_FIELD));
+            }
+
+            public static StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice parse(XContentParser parser) {
+                return PARSER.apply(parser, null);
+            }
+        }
+
+        private static class DeltaParser {
+            @SuppressWarnings("unchecked")
+            private static final ConstructingObjectParser<
+                StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta,
+                Void> PARSER = new ConstructingObjectParser<>(
+                    DELTA_FIELD,
+                    true,
+                    args -> new StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta(
+                        (String) args[0],
+                        (String) args[1],
+                        (String) args[2],
+                        (List<StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall>) args[3]
+                    )
+                );
+
+            static {
+                PARSER.declareStringOrNull(ConstructingObjectParser.optionalConstructorArg(), new ParseField(CONTENT_FIELD));
+                PARSER.declareStringOrNull(ConstructingObjectParser.optionalConstructorArg(), new ParseField(REFUSAL_FIELD));
+                PARSER.declareString(ConstructingObjectParser.optionalConstructorArg(), new ParseField(ROLE_FIELD));
+                PARSER.declareObjectArray(
+                    ConstructingObjectParser.optionalConstructorArg(),
+                    (p, c) -> ChatCompletionChunkParser.ToolCallParser.parse(p),
+                    new ParseField(TOOL_CALLS_FIELD)
+                );
+            }
+
+            public static StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta parse(XContentParser parser)
+                throws IOException {
+                return PARSER.parse(parser, null);
+            }
+        }
+
+        private static class ToolCallParser {
+            private static final ConstructingObjectParser<
+                StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall,
+                Void> PARSER = new ConstructingObjectParser<>(
+                    "tool_call",
+                    true,
+                    args -> new StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall(
+                        (int) args[0],
+                        (String) args[1],
+                        (StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall.Function) args[2],
+                        (String) args[3]
+                    )
+                );
+
+            static {
+                PARSER.declareInt(ConstructingObjectParser.constructorArg(), new ParseField(INDEX_FIELD));
+                PARSER.declareString(ConstructingObjectParser.optionalConstructorArg(), new ParseField(ID_FIELD));
+                PARSER.declareObject(
+                    ConstructingObjectParser.optionalConstructorArg(),
+                    (p, c) -> ChatCompletionChunkParser.FunctionParser.parse(p),
+                    new ParseField(FUNCTION_FIELD)
+                );
+                PARSER.declareString(ConstructingObjectParser.optionalConstructorArg(), new ParseField(TYPE_FIELD));
+            }
+
+            public static StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall parse(XContentParser parser)
+                throws IOException {
+                return PARSER.parse(parser, null);
+            }
+        }
+
+        private static class FunctionParser {
+            private static final ConstructingObjectParser<
+                StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall.Function,
+                Void> PARSER = new ConstructingObjectParser<>(
+                    FUNCTION_FIELD,
+                    true,
+                    args -> new StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall.Function(
+                        (String) args[0],
+                        (String) args[1]
+                    )
+                );
+
+            static {
+                PARSER.declareString(ConstructingObjectParser.optionalConstructorArg(), new ParseField(ARGUMENTS_FIELD));
+                PARSER.declareString(ConstructingObjectParser.optionalConstructorArg(), new ParseField(NAME_FIELD));
+            }
+
+            public static StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall.Function parse(
+                XContentParser parser
+            ) throws IOException {
+                return PARSER.parse(parser, null);
+            }
+        }
+
+        private static class UsageParser {
+            private static final ConstructingObjectParser<StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Usage, Void> PARSER =
+                new ConstructingObjectParser<>(
+                    USAGE_FIELD,
+                    true,
+                    args -> new StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Usage((int) args[0], (int) args[1], (int) args[2])
+                );
+
+            static {
+                PARSER.declareInt(ConstructingObjectParser.constructorArg(), new ParseField(COMPLETION_TOKENS_FIELD));
+                PARSER.declareInt(ConstructingObjectParser.constructorArg(), new ParseField(PROMPT_TOKENS_FIELD));
+                PARSER.declareInt(ConstructingObjectParser.constructorArg(), new ParseField(TOTAL_TOKENS_FIELD));
+            }
+
+            public static StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Usage parse(XContentParser parser) throws IOException {
+                return PARSER.parse(parser, null);
+            }
+        }
+    }
+
+    private Deque<StreamingUnifiedChatCompletionResults.ChatCompletionChunk> singleItem(
+        StreamingUnifiedChatCompletionResults.ChatCompletionChunk result
+    ) {
+        var deque = new ArrayDeque<StreamingUnifiedChatCompletionResults.ChatCompletionChunk>(1);
+        deque.offer(result);
+        return deque;
+    }
+}
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/googleaistudio/GoogleAiStudioCompletionRequest.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/googleaistudio/GoogleAiStudioCompletionRequest.java
index 80770d63ef139..b1af18d03dda4 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/googleaistudio/GoogleAiStudioCompletionRequest.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/googleaistudio/GoogleAiStudioCompletionRequest.java
@@ -14,7 +14,7 @@
 import org.elasticsearch.common.ValidationException;
 import org.elasticsearch.common.util.LazyInitializable;
 import org.elasticsearch.xcontent.XContentType;
-import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
+import org.elasticsearch.xpack.inference.external.http.sender.ChatCompletionInput;
 import org.elasticsearch.xpack.inference.external.request.HttpRequest;
 import org.elasticsearch.xpack.inference.external.request.Request;
 import org.elasticsearch.xpack.inference.services.googleaistudio.completion.GoogleAiStudioCompletionModel;
@@ -27,13 +27,13 @@ public class GoogleAiStudioCompletionRequest implements GoogleAiStudioRequest {
     private static final String ALT_PARAM = "alt";
     private static final String SSE_VALUE = "sse";
 
-    private final DocumentsOnlyInput input;
+    private final ChatCompletionInput input;
 
     private final LazyInitializable<URI, RuntimeException> uri;
 
     private final GoogleAiStudioCompletionModel model;
 
-    public GoogleAiStudioCompletionRequest(DocumentsOnlyInput input, GoogleAiStudioCompletionModel model) {
+    public GoogleAiStudioCompletionRequest(ChatCompletionInput input, GoogleAiStudioCompletionModel model) {
         this.input = Objects.requireNonNull(input);
         this.model = Objects.requireNonNull(model);
         this.uri = new LazyInitializable<>(() -> model.uri(input.stream()));
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiChatCompletionRequestEntity.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiChatCompletionRequestEntity.java
deleted file mode 100644
index 867a7ca80cbcb..0000000000000
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiChatCompletionRequestEntity.java
+++ /dev/null
@@ -1,79 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License
- * 2.0; you may not use this file except in compliance with the Elastic License
- * 2.0.
- */
-
-package org.elasticsearch.xpack.inference.external.request.openai;
-
-import org.elasticsearch.common.Strings;
-import org.elasticsearch.xcontent.ToXContentObject;
-import org.elasticsearch.xcontent.XContentBuilder;
-
-import java.io.IOException;
-import java.util.List;
-import java.util.Objects;
-
-public class OpenAiChatCompletionRequestEntity implements ToXContentObject {
-
-    private static final String MESSAGES_FIELD = "messages";
-    private static final String MODEL_FIELD = "model";
-
-    private static final String NUMBER_OF_RETURNED_CHOICES_FIELD = "n";
-
-    private static final String ROLE_FIELD = "role";
-    private static final String USER_FIELD = "user";
-    private static final String CONTENT_FIELD = "content";
-    private static final String STREAM_FIELD = "stream";
-
-    private final List<String> messages;
-    private final String model;
-
-    private final String user;
-    private final boolean stream;
-
-    public OpenAiChatCompletionRequestEntity(List<String> messages, String model, String user, boolean stream) {
-        Objects.requireNonNull(messages);
-        Objects.requireNonNull(model);
-
-        this.messages = messages;
-        this.model = model;
-        this.user = user;
-        this.stream = stream;
-    }
-
-    @Override
-    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
-        builder.startObject();
-        builder.startArray(MESSAGES_FIELD);
-        {
-            for (String message : messages) {
-                builder.startObject();
-
-                {
-                    builder.field(ROLE_FIELD, USER_FIELD);
-                    builder.field(CONTENT_FIELD, message);
-                }
-
-                builder.endObject();
-            }
-        }
-        builder.endArray();
-
-        builder.field(MODEL_FIELD, model);
-        builder.field(NUMBER_OF_RETURNED_CHOICES_FIELD, 1);
-
-        if (Strings.isNullOrEmpty(user) == false) {
-            builder.field(USER_FIELD, user);
-        }
-
-        if (stream) {
-            builder.field(STREAM_FIELD, true);
-        }
-
-        builder.endObject();
-
-        return builder;
-    }
-}
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiChatCompletionRequest.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiUnifiedChatCompletionRequest.java
similarity index 80%
rename from x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiChatCompletionRequest.java
rename to x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiUnifiedChatCompletionRequest.java
index 99a025e70d003..2e6bdb748fd33 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiChatCompletionRequest.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiUnifiedChatCompletionRequest.java
@@ -13,6 +13,7 @@
 import org.apache.http.entity.ByteArrayEntity;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.xcontent.XContentType;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 import org.elasticsearch.xpack.inference.external.openai.OpenAiAccount;
 import org.elasticsearch.xpack.inference.external.request.HttpRequest;
 import org.elasticsearch.xpack.inference.external.request.Request;
@@ -21,24 +22,21 @@
 import java.net.URI;
 import java.net.URISyntaxException;
 import java.nio.charset.StandardCharsets;
-import java.util.List;
 import java.util.Objects;
 
 import static org.elasticsearch.xpack.inference.external.request.RequestUtils.createAuthBearerHeader;
 import static org.elasticsearch.xpack.inference.external.request.openai.OpenAiUtils.createOrgHeader;
 
-public class OpenAiChatCompletionRequest implements OpenAiRequest {
+public class OpenAiUnifiedChatCompletionRequest implements OpenAiRequest {
 
     private final OpenAiAccount account;
-    private final List<String> input;
     private final OpenAiChatCompletionModel model;
-    private final boolean stream;
+    private final UnifiedChatInput unifiedChatInput;
 
-    public OpenAiChatCompletionRequest(List<String> input, OpenAiChatCompletionModel model, boolean stream) {
-        this.account = OpenAiAccount.of(model, OpenAiChatCompletionRequest::buildDefaultUri);
-        this.input = Objects.requireNonNull(input);
+    public OpenAiUnifiedChatCompletionRequest(UnifiedChatInput unifiedChatInput, OpenAiChatCompletionModel model) {
+        this.account = OpenAiAccount.of(model, OpenAiUnifiedChatCompletionRequest::buildDefaultUri);
+        this.unifiedChatInput = Objects.requireNonNull(unifiedChatInput);
         this.model = Objects.requireNonNull(model);
-        this.stream = stream;
     }
 
     @Override
@@ -46,9 +44,7 @@ public HttpRequest createHttpRequest() {
         HttpPost httpPost = new HttpPost(account.uri());
 
         ByteArrayEntity byteEntity = new ByteArrayEntity(
-            Strings.toString(
-                new OpenAiChatCompletionRequestEntity(input, model.getServiceSettings().modelId(), model.getTaskSettings().user(), stream)
-            ).getBytes(StandardCharsets.UTF_8)
+            Strings.toString(new OpenAiUnifiedChatCompletionRequestEntity(unifiedChatInput, model)).getBytes(StandardCharsets.UTF_8)
         );
         httpPost.setEntity(byteEntity);
 
@@ -87,7 +83,7 @@ public String getInferenceEntityId() {
 
     @Override
     public boolean isStreaming() {
-        return stream;
+        return unifiedChatInput.stream();
     }
 
     public static URI buildDefaultUri() throws URISyntaxException {
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiUnifiedChatCompletionRequestEntity.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiUnifiedChatCompletionRequestEntity.java
new file mode 100644
index 0000000000000..50339bf851f7d
--- /dev/null
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiUnifiedChatCompletionRequestEntity.java
@@ -0,0 +1,185 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.external.request.openai;
+
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.inference.UnifiedCompletionRequest;
+import org.elasticsearch.xcontent.ToXContentObject;
+import org.elasticsearch.xcontent.XContentBuilder;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
+import org.elasticsearch.xpack.inference.services.openai.completion.OpenAiChatCompletionModel;
+
+import java.io.IOException;
+import java.util.Objects;
+
+public class OpenAiUnifiedChatCompletionRequestEntity implements ToXContentObject {
+
+    public static final String NAME_FIELD = "name";
+    public static final String TOOL_CALL_ID_FIELD = "tool_call_id";
+    public static final String TOOL_CALLS_FIELD = "tool_calls";
+    public static final String ID_FIELD = "id";
+    public static final String FUNCTION_FIELD = "function";
+    public static final String ARGUMENTS_FIELD = "arguments";
+    public static final String DESCRIPTION_FIELD = "description";
+    public static final String PARAMETERS_FIELD = "parameters";
+    public static final String STRICT_FIELD = "strict";
+    public static final String TOP_P_FIELD = "top_p";
+    public static final String USER_FIELD = "user";
+    public static final String STREAM_FIELD = "stream";
+    private static final String NUMBER_OF_RETURNED_CHOICES_FIELD = "n";
+    private static final String MODEL_FIELD = "model";
+    public static final String MESSAGES_FIELD = "messages";
+    private static final String ROLE_FIELD = "role";
+    private static final String CONTENT_FIELD = "content";
+    private static final String MAX_COMPLETION_TOKENS_FIELD = "max_completion_tokens";
+    private static final String STOP_FIELD = "stop";
+    private static final String TEMPERATURE_FIELD = "temperature";
+    private static final String TOOL_CHOICE_FIELD = "tool_choice";
+    private static final String TOOL_FIELD = "tools";
+    private static final String TEXT_FIELD = "text";
+    private static final String TYPE_FIELD = "type";
+    private static final String STREAM_OPTIONS_FIELD = "stream_options";
+    private static final String INCLUDE_USAGE_FIELD = "include_usage";
+
+    private final UnifiedCompletionRequest unifiedRequest;
+    private final boolean stream;
+    private final OpenAiChatCompletionModel model;
+
+    public OpenAiUnifiedChatCompletionRequestEntity(UnifiedChatInput unifiedChatInput, OpenAiChatCompletionModel model) {
+        Objects.requireNonNull(unifiedChatInput);
+
+        this.unifiedRequest = unifiedChatInput.getRequest();
+        this.stream = unifiedChatInput.stream();
+        this.model = Objects.requireNonNull(model);
+    }
+
+    @Override
+    public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+        builder.startObject();
+        builder.startArray(MESSAGES_FIELD);
+        {
+            for (UnifiedCompletionRequest.Message message : unifiedRequest.messages()) {
+                builder.startObject();
+                {
+                    switch (message.content()) {
+                        case UnifiedCompletionRequest.ContentString contentString -> builder.field(CONTENT_FIELD, contentString.content());
+                        case UnifiedCompletionRequest.ContentObjects contentObjects -> {
+                            builder.startArray(CONTENT_FIELD);
+                            for (UnifiedCompletionRequest.ContentObject contentObject : contentObjects.contentObjects()) {
+                                builder.startObject();
+                                builder.field(TEXT_FIELD, contentObject.text());
+                                builder.field(TYPE_FIELD, contentObject.type());
+                                builder.endObject();
+                            }
+                            builder.endArray();
+                        }
+                    }
+
+                    builder.field(ROLE_FIELD, message.role());
+                    if (message.name() != null) {
+                        builder.field(NAME_FIELD, message.name());
+                    }
+                    if (message.toolCallId() != null) {
+                        builder.field(TOOL_CALL_ID_FIELD, message.toolCallId());
+                    }
+                    if (message.toolCalls() != null) {
+                        builder.startArray(TOOL_CALLS_FIELD);
+                        for (UnifiedCompletionRequest.ToolCall toolCall : message.toolCalls()) {
+                            builder.startObject();
+                            {
+                                builder.field(ID_FIELD, toolCall.id());
+                                builder.startObject(FUNCTION_FIELD);
+                                {
+                                    builder.field(ARGUMENTS_FIELD, toolCall.function().arguments());
+                                    builder.field(NAME_FIELD, toolCall.function().name());
+                                }
+                                builder.endObject();
+                                builder.field(TYPE_FIELD, toolCall.type());
+                            }
+                            builder.endObject();
+                        }
+                        builder.endArray();
+                    }
+                }
+                builder.endObject();
+            }
+        }
+        builder.endArray();
+
+        builder.field(MODEL_FIELD, model.getServiceSettings().modelId());
+        if (unifiedRequest.maxCompletionTokens() != null) {
+            builder.field(MAX_COMPLETION_TOKENS_FIELD, unifiedRequest.maxCompletionTokens());
+        }
+
+        builder.field(NUMBER_OF_RETURNED_CHOICES_FIELD, 1);
+
+        if (unifiedRequest.stop() != null && unifiedRequest.stop().isEmpty() == false) {
+            builder.field(STOP_FIELD, unifiedRequest.stop());
+        }
+        if (unifiedRequest.temperature() != null) {
+            builder.field(TEMPERATURE_FIELD, unifiedRequest.temperature());
+        }
+        if (unifiedRequest.toolChoice() != null) {
+            if (unifiedRequest.toolChoice() instanceof UnifiedCompletionRequest.ToolChoiceString) {
+                builder.field(TOOL_CHOICE_FIELD, ((UnifiedCompletionRequest.ToolChoiceString) unifiedRequest.toolChoice()).value());
+            } else if (unifiedRequest.toolChoice() instanceof UnifiedCompletionRequest.ToolChoiceObject) {
+                builder.startObject(TOOL_CHOICE_FIELD);
+                {
+                    builder.field(TYPE_FIELD, ((UnifiedCompletionRequest.ToolChoiceObject) unifiedRequest.toolChoice()).type());
+                    builder.startObject(FUNCTION_FIELD);
+                    {
+                        builder.field(
+                            NAME_FIELD,
+                            ((UnifiedCompletionRequest.ToolChoiceObject) unifiedRequest.toolChoice()).function().name()
+                        );
+                    }
+                    builder.endObject();
+                }
+                builder.endObject();
+            }
+        }
+        if (unifiedRequest.tools() != null && unifiedRequest.tools().isEmpty() == false) {
+            builder.startArray(TOOL_FIELD);
+            for (UnifiedCompletionRequest.Tool t : unifiedRequest.tools()) {
+                builder.startObject();
+                {
+                    builder.field(TYPE_FIELD, t.type());
+                    builder.startObject(FUNCTION_FIELD);
+                    {
+                        builder.field(DESCRIPTION_FIELD, t.function().description());
+                        builder.field(NAME_FIELD, t.function().name());
+                        builder.field(PARAMETERS_FIELD, t.function().parameters());
+                        if (t.function().strict() != null) {
+                            builder.field(STRICT_FIELD, t.function().strict());
+                        }
+                    }
+                    builder.endObject();
+                }
+                builder.endObject();
+            }
+            builder.endArray();
+        }
+        if (unifiedRequest.topP() != null) {
+            builder.field(TOP_P_FIELD, unifiedRequest.topP());
+        }
+
+        if (Strings.isNullOrEmpty(model.getTaskSettings().user()) == false) {
+            builder.field(USER_FIELD, model.getTaskSettings().user());
+        }
+
+        builder.field(STREAM_FIELD, stream);
+        if (stream) {
+            builder.startObject(STREAM_OPTIONS_FIELD);
+            builder.field(INCLUDE_USAGE_FIELD, true);
+            builder.endObject();
+        }
+        builder.endObject();
+
+        return builder;
+    }
+}
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rest/BaseInferenceAction.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rest/BaseInferenceAction.java
index e72e68052f648..d911158e82296 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rest/BaseInferenceAction.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rest/BaseInferenceAction.java
@@ -9,6 +9,7 @@
 
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.client.internal.node.NodeClient;
+import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.inference.TaskType;
 import org.elasticsearch.rest.BaseRestHandler;
 import org.elasticsearch.rest.RestChannel;
@@ -21,27 +22,32 @@
 import static org.elasticsearch.xpack.inference.rest.Paths.TASK_TYPE_OR_INFERENCE_ID;
 
 abstract class BaseInferenceAction extends BaseRestHandler {
-    @Override
-    protected RestChannelConsumer prepareRequest(RestRequest restRequest, NodeClient client) throws IOException {
-        String inferenceEntityId;
-        TaskType taskType;
+    static Params parseParams(RestRequest restRequest) {
         if (restRequest.hasParam(INFERENCE_ID)) {
-            inferenceEntityId = restRequest.param(INFERENCE_ID);
-            taskType = TaskType.fromStringOrStatusException(restRequest.param(TASK_TYPE_OR_INFERENCE_ID));
+            var inferenceEntityId = restRequest.param(INFERENCE_ID);
+            var taskType = TaskType.fromStringOrStatusException(restRequest.param(TASK_TYPE_OR_INFERENCE_ID));
+            return new Params(inferenceEntityId, taskType);
         } else {
-            inferenceEntityId = restRequest.param(TASK_TYPE_OR_INFERENCE_ID);
-            taskType = TaskType.ANY;
+            return new Params(restRequest.param(TASK_TYPE_OR_INFERENCE_ID), TaskType.ANY);
         }
+    }
+
+    record Params(String inferenceEntityId, TaskType taskType) {}
+
+    static TimeValue parseTimeout(RestRequest restRequest) {
+        return restRequest.paramAsTime(InferenceAction.Request.TIMEOUT.getPreferredName(), InferenceAction.Request.DEFAULT_TIMEOUT);
+    }
+
+    @Override
+    protected RestChannelConsumer prepareRequest(RestRequest restRequest, NodeClient client) throws IOException {
+        var params = parseParams(restRequest);
 
         InferenceAction.Request.Builder requestBuilder;
         try (var parser = restRequest.contentParser()) {
-            requestBuilder = InferenceAction.Request.parseRequest(inferenceEntityId, taskType, parser);
+            requestBuilder = InferenceAction.Request.parseRequest(params.inferenceEntityId(), params.taskType(), parser);
         }
 
-        var inferTimeout = restRequest.paramAsTime(
-            InferenceAction.Request.TIMEOUT.getPreferredName(),
-            InferenceAction.Request.DEFAULT_TIMEOUT
-        );
+        var inferTimeout = parseTimeout(restRequest);
         requestBuilder.setInferenceTimeout(inferTimeout);
         var request = prepareInferenceRequest(requestBuilder);
         return channel -> client.execute(InferenceAction.INSTANCE, request, listener(channel));
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rest/Paths.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rest/Paths.java
index 55d6443b43c03..c46f211bb26af 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rest/Paths.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rest/Paths.java
@@ -30,6 +30,12 @@ public final class Paths {
         + "}/{"
         + INFERENCE_ID
         + "}/_stream";
+    static final String UNIFIED_INFERENCE_ID_PATH = "_inference/{" + TASK_TYPE_OR_INFERENCE_ID + "}/_unified";
+    static final String UNIFIED_TASK_TYPE_INFERENCE_ID_PATH = "_inference/{"
+        + TASK_TYPE_OR_INFERENCE_ID
+        + "}/{"
+        + INFERENCE_ID
+        + "}/_unified";
 
     private Paths() {
 
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rest/RestUnifiedCompletionInferenceAction.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rest/RestUnifiedCompletionInferenceAction.java
new file mode 100644
index 0000000000000..5c71b560a6b9d
--- /dev/null
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/rest/RestUnifiedCompletionInferenceAction.java
@@ -0,0 +1,49 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.rest;
+
+import org.elasticsearch.client.internal.node.NodeClient;
+import org.elasticsearch.rest.BaseRestHandler;
+import org.elasticsearch.rest.RestRequest;
+import org.elasticsearch.rest.Scope;
+import org.elasticsearch.rest.ServerlessScope;
+import org.elasticsearch.xpack.core.inference.action.UnifiedCompletionAction;
+
+import java.io.IOException;
+import java.util.List;
+
+import static org.elasticsearch.rest.RestRequest.Method.POST;
+import static org.elasticsearch.xpack.inference.rest.Paths.UNIFIED_INFERENCE_ID_PATH;
+import static org.elasticsearch.xpack.inference.rest.Paths.UNIFIED_TASK_TYPE_INFERENCE_ID_PATH;
+
+@ServerlessScope(Scope.PUBLIC)
+public class RestUnifiedCompletionInferenceAction extends BaseRestHandler {
+    @Override
+    public String getName() {
+        return "unified_inference_action";
+    }
+
+    @Override
+    public List<Route> routes() {
+        return List.of(new Route(POST, UNIFIED_INFERENCE_ID_PATH), new Route(POST, UNIFIED_TASK_TYPE_INFERENCE_ID_PATH));
+    }
+
+    @Override
+    protected RestChannelConsumer prepareRequest(RestRequest restRequest, NodeClient client) throws IOException {
+        var params = BaseInferenceAction.parseParams(restRequest);
+
+        var inferTimeout = BaseInferenceAction.parseTimeout(restRequest);
+
+        UnifiedCompletionAction.Request request;
+        try (var parser = restRequest.contentParser()) {
+            request = UnifiedCompletionAction.Request.parseRequest(params.inferenceEntityId(), params.taskType(), inferTimeout, parser);
+        }
+
+        return channel -> client.execute(UnifiedCompletionAction.INSTANCE, request, new ServerSentEventsRestActionListener(channel));
+    }
+}
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/SenderService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/SenderService.java
index 8e2dac1ef9db2..e9b75e9ec7796 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/SenderService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/SenderService.java
@@ -7,9 +7,11 @@
 
 package org.elasticsearch.xpack.inference.services;
 
+import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.core.IOUtils;
 import org.elasticsearch.core.Nullable;
+import org.elasticsearch.core.Strings;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.inference.ChunkedInferenceServiceResults;
 import org.elasticsearch.inference.InferenceService;
@@ -17,11 +19,15 @@
 import org.elasticsearch.inference.InputType;
 import org.elasticsearch.inference.Model;
 import org.elasticsearch.inference.TaskType;
+import org.elasticsearch.inference.UnifiedCompletionRequest;
+import org.elasticsearch.rest.RestStatus;
+import org.elasticsearch.xpack.inference.external.http.sender.ChatCompletionInput;
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.InferenceInputs;
 import org.elasticsearch.xpack.inference.external.http.sender.QueryAndDocsInputs;
 import org.elasticsearch.xpack.inference.external.http.sender.Sender;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 
 import java.io.IOException;
 import java.util.EnumSet;
@@ -61,11 +67,31 @@ public void infer(
         ActionListener<InferenceServiceResults> listener
     ) {
         init();
-        if (query != null) {
-            doInfer(model, new QueryAndDocsInputs(query, input, stream), taskSettings, inputType, timeout, listener);
-        } else {
-            doInfer(model, new DocumentsOnlyInput(input, stream), taskSettings, inputType, timeout, listener);
-        }
+        var inferenceInput = createInput(model, input, query, stream);
+        doInfer(model, inferenceInput, taskSettings, inputType, timeout, listener);
+    }
+
+    private static InferenceInputs createInput(Model model, List<String> input, @Nullable String query, boolean stream) {
+        return switch (model.getTaskType()) {
+            case COMPLETION -> new ChatCompletionInput(input, stream);
+            case RERANK -> new QueryAndDocsInputs(query, input, stream);
+            case TEXT_EMBEDDING, SPARSE_EMBEDDING -> new DocumentsOnlyInput(input, stream);
+            default -> throw new ElasticsearchStatusException(
+                Strings.format("Invalid task type received when determining input type: [%s]", model.getTaskType().toString()),
+                RestStatus.BAD_REQUEST
+            );
+        };
+    }
+
+    @Override
+    public void unifiedCompletionInfer(
+        Model model,
+        UnifiedCompletionRequest request,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+        init();
+        doUnifiedCompletionInfer(model, new UnifiedChatInput(request, true), timeout, listener);
     }
 
     @Override
@@ -92,6 +118,13 @@ protected abstract void doInfer(
         ActionListener<InferenceServiceResults> listener
     );
 
+    protected abstract void doUnifiedCompletionInfer(
+        Model model,
+        UnifiedChatInput inputs,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    );
+
     protected abstract void doChunkedInfer(
         Model model,
         DocumentsOnlyInput inputs,
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/ServiceUtils.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/ServiceUtils.java
index ec4b8d9bb4d3d..7d05bac363fb1 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/ServiceUtils.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/ServiceUtils.java
@@ -776,5 +776,9 @@ public static <T> T nonNullOrDefault(@Nullable T requestValue, @Nullable T origi
         return requestValue == null ? originalSettingsValue : requestValue;
     }
 
+    public static void throwUnsupportedUnifiedCompletionOperation(String serviceName) {
+        throw new UnsupportedOperationException(Strings.format("The %s service does not support unified completion", serviceName));
+    }
+
     private ServiceUtils() {}
 }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/AlibabaCloudSearchService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/AlibabaCloudSearchService.java
index 5adc2a11b19d9..ffd26b9ac534d 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/AlibabaCloudSearchService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/alibabacloudsearch/AlibabaCloudSearchService.java
@@ -37,6 +37,7 @@
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.InferenceInputs;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 import org.elasticsearch.xpack.inference.external.request.alibabacloudsearch.AlibabaCloudSearchUtils;
 import org.elasticsearch.xpack.inference.services.ConfigurationParseContext;
 import org.elasticsearch.xpack.inference.services.SenderService;
@@ -57,14 +58,13 @@
 import java.util.Map;
 import java.util.stream.Stream;
 
-import static org.elasticsearch.inference.TaskType.SPARSE_EMBEDDING;
-import static org.elasticsearch.inference.TaskType.TEXT_EMBEDDING;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.createInvalidModelException;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.parsePersistedConfigErrorMsg;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMap;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrDefaultEmpty;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrThrowIfNull;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwIfNotEmptyMap;
+import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwUnsupportedUnifiedCompletionOperation;
 import static org.elasticsearch.xpack.inference.services.alibabacloudsearch.AlibabaCloudSearchServiceFields.EMBEDDING_MAX_BATCH_SIZE;
 import static org.elasticsearch.xpack.inference.services.alibabacloudsearch.AlibabaCloudSearchServiceSettings.HOST;
 import static org.elasticsearch.xpack.inference.services.alibabacloudsearch.AlibabaCloudSearchServiceSettings.HTTP_SCHEMA_NAME;
@@ -261,6 +261,16 @@ public AlibabaCloudSearchModel parsePersistedConfig(String inferenceEntityId, Ta
         );
     }
 
+    @Override
+    protected void doUnifiedCompletionInfer(
+        Model model,
+        UnifiedChatInput inputs,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+        throwUnsupportedUnifiedCompletionOperation(NAME);
+    }
+
     @Override
     public void doInfer(
         Model model,
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/amazonbedrock/AmazonBedrockService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/amazonbedrock/AmazonBedrockService.java
index 48b3c3df03e11..d224e50bb650d 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/amazonbedrock/AmazonBedrockService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/amazonbedrock/AmazonBedrockService.java
@@ -40,6 +40,7 @@
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.InferenceInputs;
 import org.elasticsearch.xpack.inference.external.http.sender.Sender;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 import org.elasticsearch.xpack.inference.services.ConfigurationParseContext;
 import org.elasticsearch.xpack.inference.services.SenderService;
 import org.elasticsearch.xpack.inference.services.ServiceComponents;
@@ -64,6 +65,7 @@
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrDefaultEmpty;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrThrowIfNull;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwIfNotEmptyMap;
+import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwUnsupportedUnifiedCompletionOperation;
 import static org.elasticsearch.xpack.inference.services.amazonbedrock.AmazonBedrockConstants.MODEL_FIELD;
 import static org.elasticsearch.xpack.inference.services.amazonbedrock.AmazonBedrockConstants.PROVIDER_FIELD;
 import static org.elasticsearch.xpack.inference.services.amazonbedrock.AmazonBedrockConstants.REGION_FIELD;
@@ -89,6 +91,16 @@ public AmazonBedrockService(
         this.amazonBedrockSender = amazonBedrockFactory.createSender();
     }
 
+    @Override
+    protected void doUnifiedCompletionInfer(
+        Model model,
+        UnifiedChatInput inputs,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+        throwUnsupportedUnifiedCompletionOperation(NAME);
+    }
+
     @Override
     protected void doInfer(
         Model model,
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/anthropic/AnthropicService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/anthropic/AnthropicService.java
index b3d503de8e3eb..f1840af18779f 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/anthropic/AnthropicService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/anthropic/AnthropicService.java
@@ -32,6 +32,7 @@
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.InferenceInputs;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 import org.elasticsearch.xpack.inference.services.ConfigurationParseContext;
 import org.elasticsearch.xpack.inference.services.SenderService;
 import org.elasticsearch.xpack.inference.services.ServiceComponents;
@@ -52,6 +53,7 @@
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrDefaultEmpty;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrThrowIfNull;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwIfNotEmptyMap;
+import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwUnsupportedUnifiedCompletionOperation;
 
 public class AnthropicService extends SenderService {
     public static final String NAME = "anthropic";
@@ -192,6 +194,16 @@ public EnumSet<TaskType> supportedTaskTypes() {
         return supportedTaskTypes;
     }
 
+    @Override
+    protected void doUnifiedCompletionInfer(
+        Model model,
+        UnifiedChatInput inputs,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+        throwUnsupportedUnifiedCompletionOperation(NAME);
+    }
+
     @Override
     public void doInfer(
         Model model,
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/azureaistudio/AzureAiStudioService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/azureaistudio/AzureAiStudioService.java
index bba331fc0b5df..f8ea11e4b15a5 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/azureaistudio/AzureAiStudioService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/azureaistudio/AzureAiStudioService.java
@@ -38,6 +38,7 @@
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.InferenceInputs;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 import org.elasticsearch.xpack.inference.services.ConfigurationParseContext;
 import org.elasticsearch.xpack.inference.services.SenderService;
 import org.elasticsearch.xpack.inference.services.ServiceComponents;
@@ -63,6 +64,7 @@
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrDefaultEmpty;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrThrowIfNull;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwIfNotEmptyMap;
+import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwUnsupportedUnifiedCompletionOperation;
 import static org.elasticsearch.xpack.inference.services.azureaistudio.AzureAiStudioConstants.ENDPOINT_TYPE_FIELD;
 import static org.elasticsearch.xpack.inference.services.azureaistudio.AzureAiStudioConstants.PROVIDER_FIELD;
 import static org.elasticsearch.xpack.inference.services.azureaistudio.AzureAiStudioConstants.TARGET_FIELD;
@@ -81,6 +83,16 @@ public AzureAiStudioService(HttpRequestSender.Factory factory, ServiceComponents
         super(factory, serviceComponents);
     }
 
+    @Override
+    protected void doUnifiedCompletionInfer(
+        Model model,
+        UnifiedChatInput inputs,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+        throwUnsupportedUnifiedCompletionOperation(NAME);
+    }
+
     @Override
     protected void doInfer(
         Model model,
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/azureopenai/AzureOpenAiService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/azureopenai/AzureOpenAiService.java
index 16c94dfa9ad94..a38c265d2613c 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/azureopenai/AzureOpenAiService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/azureopenai/AzureOpenAiService.java
@@ -36,6 +36,7 @@
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.InferenceInputs;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 import org.elasticsearch.xpack.inference.services.ConfigurationParseContext;
 import org.elasticsearch.xpack.inference.services.SenderService;
 import org.elasticsearch.xpack.inference.services.ServiceComponents;
@@ -58,6 +59,7 @@
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrDefaultEmpty;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrThrowIfNull;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwIfNotEmptyMap;
+import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwUnsupportedUnifiedCompletionOperation;
 import static org.elasticsearch.xpack.inference.services.azureopenai.AzureOpenAiServiceFields.API_VERSION;
 import static org.elasticsearch.xpack.inference.services.azureopenai.AzureOpenAiServiceFields.DEPLOYMENT_ID;
 import static org.elasticsearch.xpack.inference.services.azureopenai.AzureOpenAiServiceFields.RESOURCE_NAME;
@@ -233,6 +235,16 @@ public EnumSet<TaskType> supportedTaskTypes() {
         return supportedTaskTypes;
     }
 
+    @Override
+    protected void doUnifiedCompletionInfer(
+        Model model,
+        UnifiedChatInput inputs,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+        throwUnsupportedUnifiedCompletionOperation(NAME);
+    }
+
     @Override
     protected void doInfer(
         Model model,
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/cohere/CohereService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/cohere/CohereService.java
index b3d8b3b6efce3..ccb8d79dacd6c 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/cohere/CohereService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/cohere/CohereService.java
@@ -34,6 +34,7 @@
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.InferenceInputs;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 import org.elasticsearch.xpack.inference.services.ConfigurationParseContext;
 import org.elasticsearch.xpack.inference.services.SenderService;
 import org.elasticsearch.xpack.inference.services.ServiceComponents;
@@ -58,6 +59,7 @@
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrDefaultEmpty;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrThrowIfNull;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwIfNotEmptyMap;
+import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwUnsupportedUnifiedCompletionOperation;
 import static org.elasticsearch.xpack.inference.services.cohere.CohereServiceFields.EMBEDDING_MAX_BATCH_SIZE;
 
 public class CohereService extends SenderService {
@@ -232,6 +234,16 @@ public EnumSet<TaskType> supportedTaskTypes() {
         return supportedTaskTypes;
     }
 
+    @Override
+    protected void doUnifiedCompletionInfer(
+        Model model,
+        UnifiedChatInput inputs,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+        throwUnsupportedUnifiedCompletionOperation(NAME);
+    }
+
     @Override
     public void doInfer(
         Model model,
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceService.java
index b256861e7dd27..fe8ee52eb8816 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elastic/ElasticInferenceService.java
@@ -38,6 +38,7 @@
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.InferenceInputs;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 import org.elasticsearch.xpack.inference.services.ConfigurationParseContext;
 import org.elasticsearch.xpack.inference.services.SenderService;
 import org.elasticsearch.xpack.inference.services.ServiceComponents;
@@ -57,6 +58,7 @@
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrDefaultEmpty;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrThrowIfNull;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwIfNotEmptyMap;
+import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwUnsupportedUnifiedCompletionOperation;
 
 public class ElasticInferenceService extends SenderService {
 
@@ -76,6 +78,16 @@ public ElasticInferenceService(
         this.elasticInferenceServiceComponents = elasticInferenceServiceComponents;
     }
 
+    @Override
+    protected void doUnifiedCompletionInfer(
+        Model model,
+        UnifiedChatInput inputs,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+        throwUnsupportedUnifiedCompletionOperation(NAME);
+    }
+
     @Override
     protected void doInfer(
         Model model,
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalService.java
index 0e64842f873d3..5f613d6be5869 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalService.java
@@ -31,6 +31,7 @@
 import org.elasticsearch.inference.SettingsConfiguration;
 import org.elasticsearch.inference.TaskSettingsConfiguration;
 import org.elasticsearch.inference.TaskType;
+import org.elasticsearch.inference.UnifiedCompletionRequest;
 import org.elasticsearch.inference.configuration.SettingsConfigurationDisplayType;
 import org.elasticsearch.inference.configuration.SettingsConfigurationFieldType;
 import org.elasticsearch.inference.configuration.SettingsConfigurationSelectOption;
@@ -77,6 +78,7 @@
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrDefaultEmpty;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrThrowIfNull;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwIfNotEmptyMap;
+import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwUnsupportedUnifiedCompletionOperation;
 import static org.elasticsearch.xpack.inference.services.elasticsearch.ElasticsearchInternalServiceSettings.MODEL_ID;
 import static org.elasticsearch.xpack.inference.services.elasticsearch.ElasticsearchInternalServiceSettings.NUM_ALLOCATIONS;
 import static org.elasticsearch.xpack.inference.services.elasticsearch.ElasticsearchInternalServiceSettings.NUM_THREADS;
@@ -578,6 +580,16 @@ private static CustomElandEmbeddingModel updateModelWithEmbeddingDetails(CustomE
         );
     }
 
+    @Override
+    public void unifiedCompletionInfer(
+        Model model,
+        UnifiedCompletionRequest request,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+        throwUnsupportedUnifiedCompletionOperation(NAME);
+    }
+
     @Override
     public void infer(
         Model model,
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/googleaistudio/GoogleAiStudioService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/googleaistudio/GoogleAiStudioService.java
index 57a8a66a3f3a6..b681722a82136 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/googleaistudio/GoogleAiStudioService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/googleaistudio/GoogleAiStudioService.java
@@ -39,6 +39,7 @@
 import org.elasticsearch.xpack.inference.external.http.sender.GoogleAiStudioEmbeddingsRequestManager;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.InferenceInputs;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 import org.elasticsearch.xpack.inference.services.ConfigurationParseContext;
 import org.elasticsearch.xpack.inference.services.SenderService;
 import org.elasticsearch.xpack.inference.services.ServiceComponents;
@@ -64,6 +65,7 @@
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrDefaultEmpty;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrThrowIfNull;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwIfNotEmptyMap;
+import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwUnsupportedUnifiedCompletionOperation;
 import static org.elasticsearch.xpack.inference.services.googleaistudio.GoogleAiStudioServiceFields.EMBEDDING_MAX_BATCH_SIZE;
 
 public class GoogleAiStudioService extends SenderService {
@@ -282,9 +284,8 @@ protected void doInfer(
     ) {
         if (model instanceof GoogleAiStudioCompletionModel completionModel) {
             var requestManager = new GoogleAiStudioCompletionRequestManager(completionModel, getServiceComponents().threadPool());
-            var docsOnly = DocumentsOnlyInput.of(inputs);
             var failedToSendRequestErrorMessage = constructFailedToSendRequestMessage(
-                completionModel.uri(docsOnly.stream()),
+                completionModel.uri(inputs.stream()),
                 "Google AI Studio completion"
             );
             var action = new SingleInputSenderExecutableAction(
@@ -308,6 +309,16 @@ protected void doInfer(
         }
     }
 
+    @Override
+    protected void doUnifiedCompletionInfer(
+        Model model,
+        UnifiedChatInput inputs,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+        throwUnsupportedUnifiedCompletionOperation(NAME);
+    }
+
     @Override
     protected void doChunkedInfer(
         Model model,
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/googlevertexai/GoogleVertexAiService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/googlevertexai/GoogleVertexAiService.java
index 857d475499aae..87a2d98dca92c 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/googlevertexai/GoogleVertexAiService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/googlevertexai/GoogleVertexAiService.java
@@ -35,6 +35,7 @@
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.InferenceInputs;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 import org.elasticsearch.xpack.inference.services.ConfigurationParseContext;
 import org.elasticsearch.xpack.inference.services.SenderService;
 import org.elasticsearch.xpack.inference.services.ServiceComponents;
@@ -57,6 +58,7 @@
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrDefaultEmpty;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrThrowIfNull;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwIfNotEmptyMap;
+import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwUnsupportedUnifiedCompletionOperation;
 import static org.elasticsearch.xpack.inference.services.googlevertexai.GoogleVertexAiServiceFields.EMBEDDING_MAX_BATCH_SIZE;
 import static org.elasticsearch.xpack.inference.services.googlevertexai.GoogleVertexAiServiceFields.LOCATION;
 import static org.elasticsearch.xpack.inference.services.googlevertexai.GoogleVertexAiServiceFields.PROJECT_ID;
@@ -206,6 +208,16 @@ protected void doInfer(
         action.execute(inputs, timeout, listener);
     }
 
+    @Override
+    protected void doUnifiedCompletionInfer(
+        Model model,
+        UnifiedChatInput inputs,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+        throwUnsupportedUnifiedCompletionOperation(NAME);
+    }
+
     @Override
     protected void doChunkedInfer(
         Model model,
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/huggingface/HuggingFaceService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/huggingface/HuggingFaceService.java
index 51cca72f26054..b74ec01cd76e7 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/huggingface/HuggingFaceService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/huggingface/HuggingFaceService.java
@@ -18,6 +18,7 @@
 import org.elasticsearch.inference.ChunkingSettings;
 import org.elasticsearch.inference.EmptySettingsConfiguration;
 import org.elasticsearch.inference.InferenceServiceConfiguration;
+import org.elasticsearch.inference.InferenceServiceResults;
 import org.elasticsearch.inference.InputType;
 import org.elasticsearch.inference.Model;
 import org.elasticsearch.inference.SettingsConfiguration;
@@ -31,6 +32,7 @@
 import org.elasticsearch.xpack.inference.external.action.huggingface.HuggingFaceActionCreator;
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 import org.elasticsearch.xpack.inference.services.ConfigurationParseContext;
 import org.elasticsearch.xpack.inference.services.ServiceComponents;
 import org.elasticsearch.xpack.inference.services.ServiceUtils;
@@ -47,6 +49,7 @@
 
 import static org.elasticsearch.xpack.inference.services.ServiceFields.URL;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.createInvalidModelException;
+import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwUnsupportedUnifiedCompletionOperation;
 
 public class HuggingFaceService extends HuggingFaceBaseService {
     public static final String NAME = "hugging_face";
@@ -139,6 +142,16 @@ protected void doChunkedInfer(
         }
     }
 
+    @Override
+    protected void doUnifiedCompletionInfer(
+        Model model,
+        UnifiedChatInput inputs,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+        throwUnsupportedUnifiedCompletionOperation(NAME);
+    }
+
     @Override
     public InferenceServiceConfiguration getConfiguration() {
         return Configuration.get();
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/huggingface/elser/HuggingFaceElserService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/huggingface/elser/HuggingFaceElserService.java
index 75920efa251f2..5b038781b96af 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/huggingface/elser/HuggingFaceElserService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/huggingface/elser/HuggingFaceElserService.java
@@ -36,6 +36,7 @@
 import org.elasticsearch.xpack.core.ml.inference.results.ErrorInferenceResults;
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 import org.elasticsearch.xpack.inference.services.ConfigurationParseContext;
 import org.elasticsearch.xpack.inference.services.ServiceComponents;
 import org.elasticsearch.xpack.inference.services.huggingface.HuggingFaceBaseService;
@@ -49,6 +50,7 @@
 import java.util.Map;
 
 import static org.elasticsearch.xpack.core.inference.results.ResultUtils.createInvalidChunkedResultException;
+import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwUnsupportedUnifiedCompletionOperation;
 import static org.elasticsearch.xpack.inference.services.huggingface.elser.HuggingFaceElserServiceSettings.URL;
 
 public class HuggingFaceElserService extends HuggingFaceBaseService {
@@ -81,6 +83,16 @@ protected HuggingFaceModel createModel(
         };
     }
 
+    @Override
+    protected void doUnifiedCompletionInfer(
+        Model model,
+        UnifiedChatInput inputs,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+        throwUnsupportedUnifiedCompletionOperation(NAME);
+    }
+
     @Override
     protected void doChunkedInfer(
         Model model,
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/ibmwatsonx/IbmWatsonxService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/ibmwatsonx/IbmWatsonxService.java
index 981a3e95808ef..cc66d5fd7ee74 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/ibmwatsonx/IbmWatsonxService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/ibmwatsonx/IbmWatsonxService.java
@@ -37,6 +37,7 @@
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.InferenceInputs;
 import org.elasticsearch.xpack.inference.external.http.sender.Sender;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 import org.elasticsearch.xpack.inference.services.ConfigurationParseContext;
 import org.elasticsearch.xpack.inference.services.SenderService;
 import org.elasticsearch.xpack.inference.services.ServiceComponents;
@@ -57,6 +58,7 @@
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrDefaultEmpty;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrThrowIfNull;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwIfNotEmptyMap;
+import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwUnsupportedUnifiedCompletionOperation;
 import static org.elasticsearch.xpack.inference.services.huggingface.elser.HuggingFaceElserServiceSettings.URL;
 import static org.elasticsearch.xpack.inference.services.ibmwatsonx.IbmWatsonxServiceFields.API_VERSION;
 import static org.elasticsearch.xpack.inference.services.ibmwatsonx.IbmWatsonxServiceFields.EMBEDDING_MAX_BATCH_SIZE;
@@ -276,6 +278,16 @@ protected void doInfer(
         action.execute(input, timeout, listener);
     }
 
+    @Override
+    protected void doUnifiedCompletionInfer(
+        Model model,
+        UnifiedChatInput inputs,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+        throwUnsupportedUnifiedCompletionOperation(NAME);
+    }
+
     @Override
     protected void doChunkedInfer(
         Model model,
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/mistral/MistralService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/mistral/MistralService.java
index fe0edb851902b..881e7d36f2a21 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/mistral/MistralService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/mistral/MistralService.java
@@ -36,6 +36,7 @@
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.InferenceInputs;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 import org.elasticsearch.xpack.inference.services.ConfigurationParseContext;
 import org.elasticsearch.xpack.inference.services.SenderService;
 import org.elasticsearch.xpack.inference.services.ServiceComponents;
@@ -58,6 +59,7 @@
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrDefaultEmpty;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.removeFromMapOrThrowIfNull;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwIfNotEmptyMap;
+import static org.elasticsearch.xpack.inference.services.ServiceUtils.throwUnsupportedUnifiedCompletionOperation;
 import static org.elasticsearch.xpack.inference.services.mistral.MistralConstants.MODEL_FIELD;
 
 public class MistralService extends SenderService {
@@ -88,6 +90,16 @@ protected void doInfer(
         }
     }
 
+    @Override
+    protected void doUnifiedCompletionInfer(
+        Model model,
+        UnifiedChatInput inputs,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+        throwUnsupportedUnifiedCompletionOperation(NAME);
+    }
+
     @Override
     protected void doChunkedInfer(
         Model model,
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/openai/OpenAiService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/openai/OpenAiService.java
index 20ff1c617d21f..7b51b068708ca 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/openai/OpenAiService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/openai/OpenAiService.java
@@ -32,10 +32,13 @@
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.xpack.inference.chunking.ChunkingSettingsBuilder;
 import org.elasticsearch.xpack.inference.chunking.EmbeddingRequestChunker;
+import org.elasticsearch.xpack.inference.external.action.SenderExecutableAction;
 import org.elasticsearch.xpack.inference.external.action.openai.OpenAiActionCreator;
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.InferenceInputs;
+import org.elasticsearch.xpack.inference.external.http.sender.OpenAiUnifiedCompletionRequestManager;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 import org.elasticsearch.xpack.inference.services.ConfigurationParseContext;
 import org.elasticsearch.xpack.inference.services.SenderService;
 import org.elasticsearch.xpack.inference.services.ServiceComponents;
@@ -53,6 +56,8 @@
 import java.util.Map;
 import java.util.Set;
 
+import static org.elasticsearch.xpack.inference.external.action.ActionUtils.constructFailedToSendRequestMessage;
+import static org.elasticsearch.xpack.inference.external.action.openai.OpenAiActionCreator.COMPLETION_ERROR_PREFIX;
 import static org.elasticsearch.xpack.inference.services.ServiceFields.MODEL_ID;
 import static org.elasticsearch.xpack.inference.services.ServiceFields.URL;
 import static org.elasticsearch.xpack.inference.services.ServiceUtils.createInvalidModelException;
@@ -257,6 +262,28 @@ public void doInfer(
         action.execute(inputs, timeout, listener);
     }
 
+    @Override
+    public void doUnifiedCompletionInfer(
+        Model model,
+        UnifiedChatInput inputs,
+        TimeValue timeout,
+        ActionListener<InferenceServiceResults> listener
+    ) {
+        if (model instanceof OpenAiChatCompletionModel == false) {
+            listener.onFailure(createInvalidModelException(model));
+            return;
+        }
+
+        OpenAiChatCompletionModel openAiModel = (OpenAiChatCompletionModel) model;
+
+        var overriddenModel = OpenAiChatCompletionModel.of(openAiModel, inputs.getRequest());
+        var requestCreator = OpenAiUnifiedCompletionRequestManager.of(overriddenModel, getServiceComponents().threadPool());
+        var errorMessage = constructFailedToSendRequestMessage(overriddenModel.getServiceSettings().uri(), COMPLETION_ERROR_PREFIX);
+        var action = new SenderExecutableAction(getSender(), requestCreator, errorMessage);
+
+        action.execute(inputs, timeout, listener);
+    }
+
     @Override
     protected void doChunkedInfer(
         Model model,
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/openai/completion/OpenAiChatCompletionModel.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/openai/completion/OpenAiChatCompletionModel.java
index e721cd2955cf3..7d79d64b3a771 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/openai/completion/OpenAiChatCompletionModel.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/openai/completion/OpenAiChatCompletionModel.java
@@ -13,6 +13,7 @@
 import org.elasticsearch.inference.ModelSecrets;
 import org.elasticsearch.inference.SettingsConfiguration;
 import org.elasticsearch.inference.TaskType;
+import org.elasticsearch.inference.UnifiedCompletionRequest;
 import org.elasticsearch.inference.configuration.SettingsConfigurationDisplayType;
 import org.elasticsearch.inference.configuration.SettingsConfigurationFieldType;
 import org.elasticsearch.xpack.inference.external.action.ExecutableAction;
@@ -24,6 +25,7 @@
 import java.util.Collections;
 import java.util.HashMap;
 import java.util.Map;
+import java.util.Objects;
 
 import static org.elasticsearch.xpack.inference.services.openai.OpenAiServiceFields.USER;
 
@@ -38,6 +40,26 @@ public static OpenAiChatCompletionModel of(OpenAiChatCompletionModel model, Map<
         return new OpenAiChatCompletionModel(model, OpenAiChatCompletionTaskSettings.of(model.getTaskSettings(), requestTaskSettings));
     }
 
+    public static OpenAiChatCompletionModel of(OpenAiChatCompletionModel model, UnifiedCompletionRequest request) {
+        var originalModelServiceSettings = model.getServiceSettings();
+        var overriddenServiceSettings = new OpenAiChatCompletionServiceSettings(
+            Objects.requireNonNullElse(request.model(), originalModelServiceSettings.modelId()),
+            originalModelServiceSettings.uri(),
+            originalModelServiceSettings.organizationId(),
+            originalModelServiceSettings.maxInputTokens(),
+            originalModelServiceSettings.rateLimitSettings()
+        );
+
+        return new OpenAiChatCompletionModel(
+            model.getInferenceEntityId(),
+            model.getTaskType(),
+            model.getConfigurations().getService(),
+            overriddenServiceSettings,
+            model.getTaskSettings(),
+            model.getSecretSettings()
+        );
+    }
+
     public OpenAiChatCompletionModel(
         String inferenceEntityId,
         TaskType taskType,
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/openai/completion/OpenAiChatCompletionRequestTaskSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/openai/completion/OpenAiChatCompletionRequestTaskSettings.java
index 8029d8579baba..7ef7f85d71a6a 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/openai/completion/OpenAiChatCompletionRequestTaskSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/openai/completion/OpenAiChatCompletionRequestTaskSettings.java
@@ -48,5 +48,4 @@ public static OpenAiChatCompletionRequestTaskSettings fromMap(Map<String, Object
 
         return new OpenAiChatCompletionRequestTaskSettings(user);
     }
-
 }
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/TaskTypeTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/TaskTypeTests.java
new file mode 100644
index 0000000000000..f6c058bdbb79f
--- /dev/null
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/TaskTypeTests.java
@@ -0,0 +1,27 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference;
+
+import org.elasticsearch.ElasticsearchStatusException;
+import org.elasticsearch.inference.TaskType;
+import org.elasticsearch.test.ESTestCase;
+import org.hamcrest.Matchers;
+
+public class TaskTypeTests extends ESTestCase {
+
+    public void testFromStringOrStatusException() {
+        var exception = expectThrows(ElasticsearchStatusException.class, () -> TaskType.fromStringOrStatusException(null));
+        assertThat(exception.getMessage(), Matchers.is("Task type must not be null"));
+
+        exception = expectThrows(ElasticsearchStatusException.class, () -> TaskType.fromStringOrStatusException("blah"));
+        assertThat(exception.getMessage(), Matchers.is("Unknown task_type [blah]"));
+
+        assertThat(TaskType.fromStringOrStatusException("any"), Matchers.is(TaskType.ANY));
+    }
+
+}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/Utils.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/Utils.java
index 5abb9000f4d04..9395ae222e9ba 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/Utils.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/Utils.java
@@ -19,6 +19,7 @@
 import org.elasticsearch.inference.ModelConfigurations;
 import org.elasticsearch.inference.ModelSecrets;
 import org.elasticsearch.inference.SimilarityMeasure;
+import org.elasticsearch.inference.TaskType;
 import org.elasticsearch.threadpool.ScalingExecutorBuilder;
 import org.elasticsearch.xpack.core.inference.results.ChatCompletionResults;
 import org.elasticsearch.xpack.inference.common.Truncator;
@@ -160,9 +161,11 @@ public static Model getInvalidModel(String inferenceEntityId, String serviceName
         var mockConfigs = mock(ModelConfigurations.class);
         when(mockConfigs.getInferenceEntityId()).thenReturn(inferenceEntityId);
         when(mockConfigs.getService()).thenReturn(serviceName);
+        when(mockConfigs.getTaskType()).thenReturn(TaskType.TEXT_EMBEDDING);
 
         var mockModel = mock(Model.class);
         when(mockModel.getConfigurations()).thenReturn(mockConfigs);
+        when(mockModel.getTaskType()).thenReturn(TaskType.TEXT_EMBEDDING);
 
         return mockModel;
     }
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/action/BaseTransportInferenceActionTestCase.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/action/BaseTransportInferenceActionTestCase.java
new file mode 100644
index 0000000000000..47f3a0e0b57aa
--- /dev/null
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/action/BaseTransportInferenceActionTestCase.java
@@ -0,0 +1,364 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.action;
+
+import org.elasticsearch.ElasticsearchStatusException;
+import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.action.support.ActionFilters;
+import org.elasticsearch.common.xcontent.ChunkedToXContent;
+import org.elasticsearch.inference.InferenceService;
+import org.elasticsearch.inference.InferenceServiceRegistry;
+import org.elasticsearch.inference.InferenceServiceResults;
+import org.elasticsearch.inference.Model;
+import org.elasticsearch.inference.ModelConfigurations;
+import org.elasticsearch.inference.TaskType;
+import org.elasticsearch.inference.UnparsedModel;
+import org.elasticsearch.rest.RestStatus;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.transport.TransportService;
+import org.elasticsearch.xpack.core.inference.action.BaseInferenceActionRequest;
+import org.elasticsearch.xpack.core.inference.action.InferenceAction;
+import org.elasticsearch.xpack.inference.action.task.StreamingTaskManager;
+import org.elasticsearch.xpack.inference.registry.ModelRegistry;
+import org.elasticsearch.xpack.inference.telemetry.InferenceStats;
+import org.junit.Before;
+import org.mockito.ArgumentCaptor;
+
+import java.util.Map;
+import java.util.Optional;
+import java.util.Set;
+import java.util.concurrent.Flow;
+import java.util.function.Consumer;
+
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.isA;
+import static org.hamcrest.Matchers.nullValue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyBoolean;
+import static org.mockito.ArgumentMatchers.anyLong;
+import static org.mockito.ArgumentMatchers.assertArg;
+import static org.mockito.ArgumentMatchers.same;
+import static org.mockito.Mockito.doAnswer;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+public abstract class BaseTransportInferenceActionTestCase<Request extends BaseInferenceActionRequest> extends ESTestCase {
+    private ModelRegistry modelRegistry;
+    private StreamingTaskManager streamingTaskManager;
+    private BaseTransportInferenceAction<Request> action;
+
+    protected static final String serviceId = "serviceId";
+    protected static final TaskType taskType = TaskType.COMPLETION;
+    protected static final String inferenceId = "inferenceEntityId";
+    protected InferenceServiceRegistry serviceRegistry;
+    protected InferenceStats inferenceStats;
+
+    @Before
+    public void setUp() throws Exception {
+        super.setUp();
+        TransportService transportService = mock();
+        ActionFilters actionFilters = mock();
+        modelRegistry = mock();
+        serviceRegistry = mock();
+        inferenceStats = new InferenceStats(mock(), mock());
+        streamingTaskManager = mock();
+        action = createAction(transportService, actionFilters, modelRegistry, serviceRegistry, inferenceStats, streamingTaskManager);
+    }
+
+    protected abstract BaseTransportInferenceAction<Request> createAction(
+        TransportService transportService,
+        ActionFilters actionFilters,
+        ModelRegistry modelRegistry,
+        InferenceServiceRegistry serviceRegistry,
+        InferenceStats inferenceStats,
+        StreamingTaskManager streamingTaskManager
+    );
+
+    protected abstract Request createRequest();
+
+    public void testMetricsAfterModelRegistryError() {
+        var expectedException = new IllegalStateException("hello");
+        var expectedError = expectedException.getClass().getSimpleName();
+
+        doAnswer(ans -> {
+            ActionListener<?> listener = ans.getArgument(1);
+            listener.onFailure(expectedException);
+            return null;
+        }).when(modelRegistry).getModelWithSecrets(any(), any());
+
+        var listener = doExecute(taskType);
+        verify(listener).onFailure(same(expectedException));
+
+        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
+            assertThat(attributes.get("service"), nullValue());
+            assertThat(attributes.get("task_type"), nullValue());
+            assertThat(attributes.get("model_id"), nullValue());
+            assertThat(attributes.get("status_code"), nullValue());
+            assertThat(attributes.get("error.type"), is(expectedError));
+        }));
+    }
+
+    protected ActionListener<InferenceAction.Response> doExecute(TaskType taskType) {
+        return doExecute(taskType, false);
+    }
+
+    protected ActionListener<InferenceAction.Response> doExecute(TaskType taskType, boolean stream) {
+        Request request = createRequest();
+        when(request.getInferenceEntityId()).thenReturn(inferenceId);
+        when(request.getTaskType()).thenReturn(taskType);
+        when(request.isStreaming()).thenReturn(stream);
+        ActionListener<InferenceAction.Response> listener = mock();
+        action.doExecute(mock(), request, listener);
+        return listener;
+    }
+
+    public void testMetricsAfterMissingService() {
+        mockModelRegistry(taskType);
+
+        when(serviceRegistry.getService(any())).thenReturn(Optional.empty());
+
+        var listener = doExecute(taskType);
+
+        verify(listener).onFailure(assertArg(e -> {
+            assertThat(e, isA(ElasticsearchStatusException.class));
+            assertThat(e.getMessage(), is("Unknown service [" + serviceId + "] for model [" + inferenceId + "]. "));
+            assertThat(((ElasticsearchStatusException) e).status(), is(RestStatus.BAD_REQUEST));
+        }));
+        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
+            assertThat(attributes.get("service"), is(serviceId));
+            assertThat(attributes.get("task_type"), is(taskType.toString()));
+            assertThat(attributes.get("model_id"), nullValue());
+            assertThat(attributes.get("status_code"), is(RestStatus.BAD_REQUEST.getStatus()));
+            assertThat(attributes.get("error.type"), is(String.valueOf(RestStatus.BAD_REQUEST.getStatus())));
+        }));
+    }
+
+    protected void mockModelRegistry(TaskType expectedTaskType) {
+        var unparsedModel = new UnparsedModel(inferenceId, expectedTaskType, serviceId, Map.of(), Map.of());
+        doAnswer(ans -> {
+            ActionListener<UnparsedModel> listener = ans.getArgument(1);
+            listener.onResponse(unparsedModel);
+            return null;
+        }).when(modelRegistry).getModelWithSecrets(any(), any());
+    }
+
+    public void testMetricsAfterUnknownTaskType() {
+        var modelTaskType = TaskType.RERANK;
+        var requestTaskType = TaskType.SPARSE_EMBEDDING;
+        mockModelRegistry(modelTaskType);
+        when(serviceRegistry.getService(any())).thenReturn(Optional.of(mock()));
+
+        var listener = doExecute(requestTaskType);
+
+        verify(listener).onFailure(assertArg(e -> {
+            assertThat(e, isA(ElasticsearchStatusException.class));
+            assertThat(
+                e.getMessage(),
+                is(
+                    "Incompatible task_type, the requested type ["
+                        + requestTaskType
+                        + "] does not match the model type ["
+                        + modelTaskType
+                        + "]"
+                )
+            );
+            assertThat(((ElasticsearchStatusException) e).status(), is(RestStatus.BAD_REQUEST));
+        }));
+        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
+            assertThat(attributes.get("service"), is(serviceId));
+            assertThat(attributes.get("task_type"), is(modelTaskType.toString()));
+            assertThat(attributes.get("model_id"), nullValue());
+            assertThat(attributes.get("status_code"), is(RestStatus.BAD_REQUEST.getStatus()));
+            assertThat(attributes.get("error.type"), is(String.valueOf(RestStatus.BAD_REQUEST.getStatus())));
+        }));
+    }
+
+    public void testMetricsAfterInferError() {
+        var expectedException = new IllegalStateException("hello");
+        var expectedError = expectedException.getClass().getSimpleName();
+        mockService(listener -> listener.onFailure(expectedException));
+
+        var listener = doExecute(taskType);
+
+        verify(listener).onFailure(same(expectedException));
+        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
+            assertThat(attributes.get("service"), is(serviceId));
+            assertThat(attributes.get("task_type"), is(taskType.toString()));
+            assertThat(attributes.get("model_id"), nullValue());
+            assertThat(attributes.get("status_code"), nullValue());
+            assertThat(attributes.get("error.type"), is(expectedError));
+        }));
+    }
+
+    public void testMetricsAfterStreamUnsupported() {
+        var expectedStatus = RestStatus.METHOD_NOT_ALLOWED;
+        var expectedError = String.valueOf(expectedStatus.getStatus());
+        mockService(l -> {});
+
+        var listener = doExecute(taskType, true);
+
+        verify(listener).onFailure(assertArg(e -> {
+            assertThat(e, isA(ElasticsearchStatusException.class));
+            var ese = (ElasticsearchStatusException) e;
+            assertThat(ese.getMessage(), is("Streaming is not allowed for service [" + serviceId + "]."));
+            assertThat(ese.status(), is(expectedStatus));
+        }));
+        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
+            assertThat(attributes.get("service"), is(serviceId));
+            assertThat(attributes.get("task_type"), is(taskType.toString()));
+            assertThat(attributes.get("model_id"), nullValue());
+            assertThat(attributes.get("status_code"), is(expectedStatus.getStatus()));
+            assertThat(attributes.get("error.type"), is(expectedError));
+        }));
+    }
+
+    public void testMetricsAfterInferSuccess() {
+        mockService(listener -> listener.onResponse(mock()));
+
+        var listener = doExecute(taskType);
+
+        verify(listener).onResponse(any());
+        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
+            assertThat(attributes.get("service"), is(serviceId));
+            assertThat(attributes.get("task_type"), is(taskType.toString()));
+            assertThat(attributes.get("model_id"), nullValue());
+            assertThat(attributes.get("status_code"), is(200));
+            assertThat(attributes.get("error.type"), nullValue());
+        }));
+    }
+
+    public void testMetricsAfterStreamInferSuccess() {
+        mockStreamResponse(Flow.Subscriber::onComplete);
+        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
+            assertThat(attributes.get("service"), is(serviceId));
+            assertThat(attributes.get("task_type"), is(taskType.toString()));
+            assertThat(attributes.get("model_id"), nullValue());
+            assertThat(attributes.get("status_code"), is(200));
+            assertThat(attributes.get("error.type"), nullValue());
+        }));
+    }
+
+    public void testMetricsAfterStreamInferFailure() {
+        var expectedException = new IllegalStateException("hello");
+        var expectedError = expectedException.getClass().getSimpleName();
+        mockStreamResponse(subscriber -> {
+            subscriber.subscribe(mock());
+            subscriber.onError(expectedException);
+        });
+        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
+            assertThat(attributes.get("service"), is(serviceId));
+            assertThat(attributes.get("task_type"), is(taskType.toString()));
+            assertThat(attributes.get("model_id"), nullValue());
+            assertThat(attributes.get("status_code"), nullValue());
+            assertThat(attributes.get("error.type"), is(expectedError));
+        }));
+    }
+
+    public void testMetricsAfterStreamCancel() {
+        var response = mockStreamResponse(s -> s.onSubscribe(mock()));
+        response.subscribe(new Flow.Subscriber<>() {
+            @Override
+            public void onSubscribe(Flow.Subscription subscription) {
+                subscription.cancel();
+            }
+
+            @Override
+            public void onNext(ChunkedToXContent item) {
+
+            }
+
+            @Override
+            public void onError(Throwable throwable) {
+
+            }
+
+            @Override
+            public void onComplete() {
+
+            }
+        });
+
+        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
+            assertThat(attributes.get("service"), is(serviceId));
+            assertThat(attributes.get("task_type"), is(taskType.toString()));
+            assertThat(attributes.get("model_id"), nullValue());
+            assertThat(attributes.get("status_code"), is(200));
+            assertThat(attributes.get("error.type"), nullValue());
+        }));
+    }
+
+    protected Flow.Publisher<ChunkedToXContent> mockStreamResponse(Consumer<Flow.Processor<?, ?>> action) {
+        mockService(true, Set.of(), listener -> {
+            Flow.Processor<ChunkedToXContent, ChunkedToXContent> taskProcessor = mock();
+            doAnswer(innerAns -> {
+                action.accept(innerAns.getArgument(0));
+                return null;
+            }).when(taskProcessor).subscribe(any());
+            when(streamingTaskManager.<ChunkedToXContent>create(any(), any())).thenReturn(taskProcessor);
+            var inferenceServiceResults = mock(InferenceServiceResults.class);
+            when(inferenceServiceResults.publisher()).thenReturn(mock());
+            listener.onResponse(inferenceServiceResults);
+        });
+
+        var listener = doExecute(taskType, true);
+        var captor = ArgumentCaptor.forClass(InferenceAction.Response.class);
+        verify(listener).onResponse(captor.capture());
+        assertTrue(captor.getValue().isStreaming());
+        assertNotNull(captor.getValue().publisher());
+        return captor.getValue().publisher();
+    }
+
+    protected void mockService(Consumer<ActionListener<InferenceServiceResults>> listenerAction) {
+        mockService(false, Set.of(), listenerAction);
+    }
+
+    protected void mockService(
+        boolean stream,
+        Set<TaskType> supportedStreamingTasks,
+        Consumer<ActionListener<InferenceServiceResults>> listenerAction
+    ) {
+        InferenceService service = mock();
+        Model model = mockModel();
+        when(service.parsePersistedConfigWithSecrets(any(), any(), any(), any())).thenReturn(model);
+        when(service.name()).thenReturn(serviceId);
+
+        when(service.canStream(any())).thenReturn(stream);
+        when(service.supportedStreamingTasks()).thenReturn(supportedStreamingTasks);
+        doAnswer(ans -> {
+            listenerAction.accept(ans.getArgument(7));
+            return null;
+        }).when(service).infer(any(), any(), any(), anyBoolean(), any(), any(), any(), any());
+        doAnswer(ans -> {
+            listenerAction.accept(ans.getArgument(3));
+            return null;
+        }).when(service).unifiedCompletionInfer(any(), any(), any(), any());
+        mockModelAndServiceRegistry(service);
+    }
+
+    protected Model mockModel() {
+        Model model = mock();
+        ModelConfigurations modelConfigurations = mock();
+        when(modelConfigurations.getService()).thenReturn(serviceId);
+        when(model.getConfigurations()).thenReturn(modelConfigurations);
+        when(model.getTaskType()).thenReturn(taskType);
+        when(model.getServiceSettings()).thenReturn(mock());
+        return model;
+    }
+
+    protected void mockModelAndServiceRegistry(InferenceService service) {
+        var unparsedModel = new UnparsedModel(inferenceId, taskType, serviceId, Map.of(), Map.of());
+        doAnswer(ans -> {
+            ActionListener<UnparsedModel> listener = ans.getArgument(1);
+            listener.onResponse(unparsedModel);
+            return null;
+        }).when(modelRegistry).getModelWithSecrets(any(), any());
+
+        when(serviceRegistry.getService(any())).thenReturn(Optional.of(service));
+    }
+}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/action/TransportInferenceActionTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/action/TransportInferenceActionTests.java
index 0ed9cbf56b3fa..e54175cb27009 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/action/TransportInferenceActionTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/action/TransportInferenceActionTests.java
@@ -7,66 +7,28 @@
 
 package org.elasticsearch.xpack.inference.action;
 
-import org.elasticsearch.ElasticsearchStatusException;
-import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.action.support.ActionFilters;
-import org.elasticsearch.common.xcontent.ChunkedToXContent;
-import org.elasticsearch.inference.InferenceService;
 import org.elasticsearch.inference.InferenceServiceRegistry;
-import org.elasticsearch.inference.InferenceServiceResults;
-import org.elasticsearch.inference.Model;
-import org.elasticsearch.inference.ModelConfigurations;
-import org.elasticsearch.inference.TaskType;
-import org.elasticsearch.inference.UnparsedModel;
-import org.elasticsearch.rest.RestStatus;
-import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.transport.TransportService;
 import org.elasticsearch.xpack.core.inference.action.InferenceAction;
 import org.elasticsearch.xpack.inference.action.task.StreamingTaskManager;
 import org.elasticsearch.xpack.inference.registry.ModelRegistry;
 import org.elasticsearch.xpack.inference.telemetry.InferenceStats;
-import org.junit.Before;
-import org.mockito.ArgumentCaptor;
 
-import java.util.Map;
-import java.util.Optional;
-import java.util.Set;
-import java.util.concurrent.Flow;
-import java.util.function.Consumer;
-
-import static org.hamcrest.Matchers.is;
-import static org.hamcrest.Matchers.isA;
-import static org.hamcrest.Matchers.nullValue;
-import static org.mockito.ArgumentMatchers.any;
-import static org.mockito.ArgumentMatchers.anyBoolean;
-import static org.mockito.ArgumentMatchers.anyLong;
-import static org.mockito.ArgumentMatchers.assertArg;
-import static org.mockito.ArgumentMatchers.same;
-import static org.mockito.Mockito.doAnswer;
 import static org.mockito.Mockito.mock;
-import static org.mockito.Mockito.verify;
-import static org.mockito.Mockito.when;
 
-public class TransportInferenceActionTests extends ESTestCase {
-    private static final String serviceId = "serviceId";
-    private static final TaskType taskType = TaskType.COMPLETION;
-    private static final String inferenceId = "inferenceEntityId";
-    private ModelRegistry modelRegistry;
-    private InferenceServiceRegistry serviceRegistry;
-    private InferenceStats inferenceStats;
-    private StreamingTaskManager streamingTaskManager;
-    private TransportInferenceAction action;
+public class TransportInferenceActionTests extends BaseTransportInferenceActionTestCase<InferenceAction.Request> {
 
-    @Before
-    public void setUp() throws Exception {
-        super.setUp();
-        TransportService transportService = mock();
-        ActionFilters actionFilters = mock();
-        modelRegistry = mock();
-        serviceRegistry = mock();
-        inferenceStats = new InferenceStats(mock(), mock());
-        streamingTaskManager = mock();
-        action = new TransportInferenceAction(
+    @Override
+    protected BaseTransportInferenceAction<InferenceAction.Request> createAction(
+        TransportService transportService,
+        ActionFilters actionFilters,
+        ModelRegistry modelRegistry,
+        InferenceServiceRegistry serviceRegistry,
+        InferenceStats inferenceStats,
+        StreamingTaskManager streamingTaskManager
+    ) {
+        return new TransportInferenceAction(
             transportService,
             actionFilters,
             modelRegistry,
@@ -76,279 +38,8 @@ public void setUp() throws Exception {
         );
     }
 
-    public void testMetricsAfterModelRegistryError() {
-        var expectedException = new IllegalStateException("hello");
-        var expectedError = expectedException.getClass().getSimpleName();
-
-        doAnswer(ans -> {
-            ActionListener<?> listener = ans.getArgument(1);
-            listener.onFailure(expectedException);
-            return null;
-        }).when(modelRegistry).getModelWithSecrets(any(), any());
-
-        var listener = doExecute(taskType);
-        verify(listener).onFailure(same(expectedException));
-
-        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
-            assertThat(attributes.get("service"), nullValue());
-            assertThat(attributes.get("task_type"), nullValue());
-            assertThat(attributes.get("model_id"), nullValue());
-            assertThat(attributes.get("status_code"), nullValue());
-            assertThat(attributes.get("error.type"), is(expectedError));
-        }));
-    }
-
-    private ActionListener<InferenceAction.Response> doExecute(TaskType taskType) {
-        return doExecute(taskType, false);
-    }
-
-    private ActionListener<InferenceAction.Response> doExecute(TaskType taskType, boolean stream) {
-        InferenceAction.Request request = mock();
-        when(request.getInferenceEntityId()).thenReturn(inferenceId);
-        when(request.getTaskType()).thenReturn(taskType);
-        when(request.isStreaming()).thenReturn(stream);
-        ActionListener<InferenceAction.Response> listener = mock();
-        action.doExecute(mock(), request, listener);
-        return listener;
-    }
-
-    public void testMetricsAfterMissingService() {
-        mockModelRegistry(taskType);
-
-        when(serviceRegistry.getService(any())).thenReturn(Optional.empty());
-
-        var listener = doExecute(taskType);
-
-        verify(listener).onFailure(assertArg(e -> {
-            assertThat(e, isA(ElasticsearchStatusException.class));
-            assertThat(e.getMessage(), is("Unknown service [" + serviceId + "] for model [" + inferenceId + "]. "));
-            assertThat(((ElasticsearchStatusException) e).status(), is(RestStatus.BAD_REQUEST));
-        }));
-        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
-            assertThat(attributes.get("service"), is(serviceId));
-            assertThat(attributes.get("task_type"), is(taskType.toString()));
-            assertThat(attributes.get("model_id"), nullValue());
-            assertThat(attributes.get("status_code"), is(RestStatus.BAD_REQUEST.getStatus()));
-            assertThat(attributes.get("error.type"), is(String.valueOf(RestStatus.BAD_REQUEST.getStatus())));
-        }));
-    }
-
-    private void mockModelRegistry(TaskType expectedTaskType) {
-        var unparsedModel = new UnparsedModel(inferenceId, expectedTaskType, serviceId, Map.of(), Map.of());
-        doAnswer(ans -> {
-            ActionListener<UnparsedModel> listener = ans.getArgument(1);
-            listener.onResponse(unparsedModel);
-            return null;
-        }).when(modelRegistry).getModelWithSecrets(any(), any());
-    }
-
-    public void testMetricsAfterUnknownTaskType() {
-        var modelTaskType = TaskType.RERANK;
-        var requestTaskType = TaskType.SPARSE_EMBEDDING;
-        mockModelRegistry(modelTaskType);
-        when(serviceRegistry.getService(any())).thenReturn(Optional.of(mock()));
-
-        var listener = doExecute(requestTaskType);
-
-        verify(listener).onFailure(assertArg(e -> {
-            assertThat(e, isA(ElasticsearchStatusException.class));
-            assertThat(
-                e.getMessage(),
-                is(
-                    "Incompatible task_type, the requested type ["
-                        + requestTaskType
-                        + "] does not match the model type ["
-                        + modelTaskType
-                        + "]"
-                )
-            );
-            assertThat(((ElasticsearchStatusException) e).status(), is(RestStatus.BAD_REQUEST));
-        }));
-        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
-            assertThat(attributes.get("service"), is(serviceId));
-            assertThat(attributes.get("task_type"), is(modelTaskType.toString()));
-            assertThat(attributes.get("model_id"), nullValue());
-            assertThat(attributes.get("status_code"), is(RestStatus.BAD_REQUEST.getStatus()));
-            assertThat(attributes.get("error.type"), is(String.valueOf(RestStatus.BAD_REQUEST.getStatus())));
-        }));
-    }
-
-    public void testMetricsAfterInferError() {
-        var expectedException = new IllegalStateException("hello");
-        var expectedError = expectedException.getClass().getSimpleName();
-        mockService(listener -> listener.onFailure(expectedException));
-
-        var listener = doExecute(taskType);
-
-        verify(listener).onFailure(same(expectedException));
-        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
-            assertThat(attributes.get("service"), is(serviceId));
-            assertThat(attributes.get("task_type"), is(taskType.toString()));
-            assertThat(attributes.get("model_id"), nullValue());
-            assertThat(attributes.get("status_code"), nullValue());
-            assertThat(attributes.get("error.type"), is(expectedError));
-        }));
-    }
-
-    public void testMetricsAfterStreamUnsupported() {
-        var expectedStatus = RestStatus.METHOD_NOT_ALLOWED;
-        var expectedError = String.valueOf(expectedStatus.getStatus());
-        mockService(l -> {});
-
-        var listener = doExecute(taskType, true);
-
-        verify(listener).onFailure(assertArg(e -> {
-            assertThat(e, isA(ElasticsearchStatusException.class));
-            var ese = (ElasticsearchStatusException) e;
-            assertThat(ese.getMessage(), is("Streaming is not allowed for service [" + serviceId + "]."));
-            assertThat(ese.status(), is(expectedStatus));
-        }));
-        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
-            assertThat(attributes.get("service"), is(serviceId));
-            assertThat(attributes.get("task_type"), is(taskType.toString()));
-            assertThat(attributes.get("model_id"), nullValue());
-            assertThat(attributes.get("status_code"), is(expectedStatus.getStatus()));
-            assertThat(attributes.get("error.type"), is(expectedError));
-        }));
-    }
-
-    public void testMetricsAfterInferSuccess() {
-        mockService(listener -> listener.onResponse(mock()));
-
-        var listener = doExecute(taskType);
-
-        verify(listener).onResponse(any());
-        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
-            assertThat(attributes.get("service"), is(serviceId));
-            assertThat(attributes.get("task_type"), is(taskType.toString()));
-            assertThat(attributes.get("model_id"), nullValue());
-            assertThat(attributes.get("status_code"), is(200));
-            assertThat(attributes.get("error.type"), nullValue());
-        }));
-    }
-
-    public void testMetricsAfterStreamInferSuccess() {
-        mockStreamResponse(Flow.Subscriber::onComplete);
-        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
-            assertThat(attributes.get("service"), is(serviceId));
-            assertThat(attributes.get("task_type"), is(taskType.toString()));
-            assertThat(attributes.get("model_id"), nullValue());
-            assertThat(attributes.get("status_code"), is(200));
-            assertThat(attributes.get("error.type"), nullValue());
-        }));
-    }
-
-    public void testMetricsAfterStreamInferFailure() {
-        var expectedException = new IllegalStateException("hello");
-        var expectedError = expectedException.getClass().getSimpleName();
-        mockStreamResponse(subscriber -> {
-            subscriber.subscribe(mock());
-            subscriber.onError(expectedException);
-        });
-        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
-            assertThat(attributes.get("service"), is(serviceId));
-            assertThat(attributes.get("task_type"), is(taskType.toString()));
-            assertThat(attributes.get("model_id"), nullValue());
-            assertThat(attributes.get("status_code"), nullValue());
-            assertThat(attributes.get("error.type"), is(expectedError));
-        }));
-    }
-
-    public void testMetricsAfterStreamCancel() {
-        var response = mockStreamResponse(s -> s.onSubscribe(mock()));
-        response.subscribe(new Flow.Subscriber<>() {
-            @Override
-            public void onSubscribe(Flow.Subscription subscription) {
-                subscription.cancel();
-            }
-
-            @Override
-            public void onNext(ChunkedToXContent item) {
-
-            }
-
-            @Override
-            public void onError(Throwable throwable) {
-
-            }
-
-            @Override
-            public void onComplete() {
-
-            }
-        });
-
-        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
-            assertThat(attributes.get("service"), is(serviceId));
-            assertThat(attributes.get("task_type"), is(taskType.toString()));
-            assertThat(attributes.get("model_id"), nullValue());
-            assertThat(attributes.get("status_code"), is(200));
-            assertThat(attributes.get("error.type"), nullValue());
-        }));
-    }
-
-    private Flow.Publisher<ChunkedToXContent> mockStreamResponse(Consumer<Flow.Processor<?, ?>> action) {
-        mockService(true, Set.of(), listener -> {
-            Flow.Processor<ChunkedToXContent, ChunkedToXContent> taskProcessor = mock();
-            doAnswer(innerAns -> {
-                action.accept(innerAns.getArgument(0));
-                return null;
-            }).when(taskProcessor).subscribe(any());
-            when(streamingTaskManager.<ChunkedToXContent>create(any(), any())).thenReturn(taskProcessor);
-            var inferenceServiceResults = mock(InferenceServiceResults.class);
-            when(inferenceServiceResults.publisher()).thenReturn(mock());
-            listener.onResponse(inferenceServiceResults);
-        });
-
-        var listener = doExecute(taskType, true);
-        var captor = ArgumentCaptor.forClass(InferenceAction.Response.class);
-        verify(listener).onResponse(captor.capture());
-        assertTrue(captor.getValue().isStreaming());
-        assertNotNull(captor.getValue().publisher());
-        return captor.getValue().publisher();
-    }
-
-    private void mockService(Consumer<ActionListener<InferenceServiceResults>> listenerAction) {
-        mockService(false, Set.of(), listenerAction);
-    }
-
-    private void mockService(
-        boolean stream,
-        Set<TaskType> supportedStreamingTasks,
-        Consumer<ActionListener<InferenceServiceResults>> listenerAction
-    ) {
-        InferenceService service = mock();
-        Model model = mockModel();
-        when(service.parsePersistedConfigWithSecrets(any(), any(), any(), any())).thenReturn(model);
-        when(service.name()).thenReturn(serviceId);
-
-        when(service.canStream(any())).thenReturn(stream);
-        when(service.supportedStreamingTasks()).thenReturn(supportedStreamingTasks);
-        doAnswer(ans -> {
-            listenerAction.accept(ans.getArgument(7));
-            return null;
-        }).when(service).infer(any(), any(), any(), anyBoolean(), any(), any(), any(), any());
-        mockModelAndServiceRegistry(service);
-    }
-
-    private Model mockModel() {
-        Model model = mock();
-        ModelConfigurations modelConfigurations = mock();
-        when(modelConfigurations.getService()).thenReturn(serviceId);
-        when(model.getConfigurations()).thenReturn(modelConfigurations);
-        when(model.getTaskType()).thenReturn(taskType);
-        when(model.getServiceSettings()).thenReturn(mock());
-        return model;
-    }
-
-    private void mockModelAndServiceRegistry(InferenceService service) {
-        var unparsedModel = new UnparsedModel(inferenceId, taskType, serviceId, Map.of(), Map.of());
-        doAnswer(ans -> {
-            ActionListener<UnparsedModel> listener = ans.getArgument(1);
-            listener.onResponse(unparsedModel);
-            return null;
-        }).when(modelRegistry).getModelWithSecrets(any(), any());
-
-        when(serviceRegistry.getService(any())).thenReturn(Optional.of(service));
+    @Override
+    protected InferenceAction.Request createRequest() {
+        return mock();
     }
 }
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/action/TransportUnifiedCompletionActionTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/action/TransportUnifiedCompletionActionTests.java
new file mode 100644
index 0000000000000..4c943599ce523
--- /dev/null
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/action/TransportUnifiedCompletionActionTests.java
@@ -0,0 +1,124 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.action;
+
+import org.elasticsearch.ElasticsearchStatusException;
+import org.elasticsearch.action.support.ActionFilters;
+import org.elasticsearch.inference.InferenceServiceRegistry;
+import org.elasticsearch.inference.TaskType;
+import org.elasticsearch.rest.RestStatus;
+import org.elasticsearch.transport.TransportService;
+import org.elasticsearch.xpack.core.inference.action.UnifiedCompletionAction;
+import org.elasticsearch.xpack.inference.action.task.StreamingTaskManager;
+import org.elasticsearch.xpack.inference.registry.ModelRegistry;
+import org.elasticsearch.xpack.inference.telemetry.InferenceStats;
+
+import java.util.Optional;
+
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.isA;
+import static org.hamcrest.Matchers.nullValue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyLong;
+import static org.mockito.ArgumentMatchers.assertArg;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+public class TransportUnifiedCompletionActionTests extends BaseTransportInferenceActionTestCase<UnifiedCompletionAction.Request> {
+
+    @Override
+    protected BaseTransportInferenceAction<UnifiedCompletionAction.Request> createAction(
+        TransportService transportService,
+        ActionFilters actionFilters,
+        ModelRegistry modelRegistry,
+        InferenceServiceRegistry serviceRegistry,
+        InferenceStats inferenceStats,
+        StreamingTaskManager streamingTaskManager
+    ) {
+        return new TransportUnifiedCompletionInferenceAction(
+            transportService,
+            actionFilters,
+            modelRegistry,
+            serviceRegistry,
+            inferenceStats,
+            streamingTaskManager
+        );
+    }
+
+    @Override
+    protected UnifiedCompletionAction.Request createRequest() {
+        return mock();
+    }
+
+    public void testThrows_IncompatibleTaskTypeException_WhenUsingATextEmbeddingInferenceEndpoint() {
+        var modelTaskType = TaskType.TEXT_EMBEDDING;
+        var requestTaskType = TaskType.TEXT_EMBEDDING;
+        mockModelRegistry(modelTaskType);
+        when(serviceRegistry.getService(any())).thenReturn(Optional.of(mock()));
+
+        var listener = doExecute(requestTaskType);
+
+        verify(listener).onFailure(assertArg(e -> {
+            assertThat(e, isA(ElasticsearchStatusException.class));
+            assertThat(
+                e.getMessage(),
+                is("Incompatible task_type for unified API, the requested type [" + requestTaskType + "] must be one of [completion]")
+            );
+            assertThat(((ElasticsearchStatusException) e).status(), is(RestStatus.BAD_REQUEST));
+        }));
+        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
+            assertThat(attributes.get("service"), is(serviceId));
+            assertThat(attributes.get("task_type"), is(modelTaskType.toString()));
+            assertThat(attributes.get("model_id"), nullValue());
+            assertThat(attributes.get("status_code"), is(RestStatus.BAD_REQUEST.getStatus()));
+            assertThat(attributes.get("error.type"), is(String.valueOf(RestStatus.BAD_REQUEST.getStatus())));
+        }));
+    }
+
+    public void testThrows_IncompatibleTaskTypeException_WhenUsingRequestIsAny_ModelIsTextEmbedding() {
+        var modelTaskType = TaskType.ANY;
+        var requestTaskType = TaskType.TEXT_EMBEDDING;
+        mockModelRegistry(modelTaskType);
+        when(serviceRegistry.getService(any())).thenReturn(Optional.of(mock()));
+
+        var listener = doExecute(requestTaskType);
+
+        verify(listener).onFailure(assertArg(e -> {
+            assertThat(e, isA(ElasticsearchStatusException.class));
+            assertThat(
+                e.getMessage(),
+                is("Incompatible task_type for unified API, the requested type [" + requestTaskType + "] must be one of [completion]")
+            );
+            assertThat(((ElasticsearchStatusException) e).status(), is(RestStatus.BAD_REQUEST));
+        }));
+        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
+            assertThat(attributes.get("service"), is(serviceId));
+            assertThat(attributes.get("task_type"), is(modelTaskType.toString()));
+            assertThat(attributes.get("model_id"), nullValue());
+            assertThat(attributes.get("status_code"), is(RestStatus.BAD_REQUEST.getStatus()));
+            assertThat(attributes.get("error.type"), is(String.valueOf(RestStatus.BAD_REQUEST.getStatus())));
+        }));
+    }
+
+    public void testMetricsAfterUnifiedInferSuccess_WithRequestTaskTypeAny() {
+        mockModelRegistry(TaskType.COMPLETION);
+        mockService(listener -> listener.onResponse(mock()));
+
+        var listener = doExecute(TaskType.ANY);
+
+        verify(listener).onResponse(any());
+        verify(inferenceStats.inferenceDuration()).record(anyLong(), assertArg(attributes -> {
+            assertThat(attributes.get("service"), is(serviceId));
+            assertThat(attributes.get("task_type"), is(taskType.toString()));
+            assertThat(attributes.get("model_id"), nullValue());
+            assertThat(attributes.get("status_code"), is(200));
+            assertThat(attributes.get("error.type"), nullValue());
+        }));
+    }
+}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/SingleInputSenderExecutableActionTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/SingleInputSenderExecutableActionTests.java
index d4ab9b1f1e19a..9e7c58b0ca79e 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/SingleInputSenderExecutableActionTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/SingleInputSenderExecutableActionTests.java
@@ -61,25 +61,11 @@ public void testOneInputIsValid() {
         assertTrue("Test failed to call listener.", testRan.get());
     }
 
-    public void testInvalidInputType() {
-        var badInput = mock(InferenceInputs.class);
-        var actualException = new AtomicReference<Exception>();
-
-        executableAction.execute(
-            badInput,
-            mock(TimeValue.class),
-            ActionListener.wrap(shouldNotSucceed -> fail("Test failed."), actualException::set)
-        );
-
-        assertThat(actualException.get(), notNullValue());
-        assertThat(actualException.get().getMessage(), is("Invalid inference input type"));
-        assertThat(actualException.get(), instanceOf(ElasticsearchStatusException.class));
-        assertThat(((ElasticsearchStatusException) actualException.get()).status(), is(RestStatus.INTERNAL_SERVER_ERROR));
-    }
-
     public void testMoreThanOneInput() {
         var badInput = mock(DocumentsOnlyInput.class);
-        when(badInput.getInputs()).thenReturn(List.of("one", "two"));
+        var input = List.of("one", "two");
+        when(badInput.getInputs()).thenReturn(input);
+        when(badInput.inputSize()).thenReturn(input.size());
         var actualException = new AtomicReference<Exception>();
 
         executableAction.execute(
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/amazonbedrock/AmazonBedrockActionCreatorTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/amazonbedrock/AmazonBedrockActionCreatorTests.java
index 87d3a82b4aae6..e7543aa6ba9e5 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/amazonbedrock/AmazonBedrockActionCreatorTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/amazonbedrock/AmazonBedrockActionCreatorTests.java
@@ -17,6 +17,7 @@
 import org.elasticsearch.xpack.core.inference.results.ChatCompletionResults;
 import org.elasticsearch.xpack.core.inference.results.InferenceTextEmbeddingFloatResults;
 import org.elasticsearch.xpack.inference.external.amazonbedrock.AmazonBedrockMockRequestSender;
+import org.elasticsearch.xpack.inference.external.http.sender.ChatCompletionInput;
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.services.ServiceComponentsTests;
 import org.elasticsearch.xpack.inference.services.amazonbedrock.AmazonBedrockProvider;
@@ -130,7 +131,7 @@ public void testCompletionRequestAction() throws IOException {
             );
             var action = creator.create(model, Map.of());
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
             var result = listener.actionGet(TIMEOUT);
 
             assertThat(result.asMap(), is(buildExpectationCompletion(List.of("test input string"))));
@@ -163,7 +164,7 @@ public void testChatCompletionRequestAction_HandlesException() throws IOExceptio
             );
             var action = creator.create(model, Map.of());
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
             var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
             assertThat(sender.sendCount(), is(1));
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/anthropic/AnthropicActionCreatorTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/anthropic/AnthropicActionCreatorTests.java
index a3114300c5ddc..f0de37ceaaf98 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/anthropic/AnthropicActionCreatorTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/anthropic/AnthropicActionCreatorTests.java
@@ -20,7 +20,7 @@
 import org.elasticsearch.xcontent.XContentType;
 import org.elasticsearch.xpack.core.inference.action.InferenceAction;
 import org.elasticsearch.xpack.inference.external.http.HttpClientManager;
-import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
+import org.elasticsearch.xpack.inference.external.http.sender.ChatCompletionInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSenderTests;
 import org.elasticsearch.xpack.inference.external.request.anthropic.AnthropicRequestUtils;
 import org.elasticsearch.xpack.inference.logging.ThrottlerManager;
@@ -49,6 +49,7 @@
 import static org.mockito.Mockito.mock;
 
 public class AnthropicActionCreatorTests extends ESTestCase {
+
     private static final TimeValue TIMEOUT = new TimeValue(30, TimeUnit.SECONDS);
     private final MockWebServer webServer = new MockWebServer();
     private ThreadPool threadPool;
@@ -103,7 +104,7 @@ public void testCreate_ChatCompletionModel() throws IOException {
             var action = actionCreator.create(model, overriddenTaskSettings);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var result = listener.actionGet(TIMEOUT);
 
@@ -168,7 +169,7 @@ public void testCreate_ChatCompletionModel_FailsFromInvalidResponseFormat() thro
             var action = actionCreator.create(model, overriddenTaskSettings);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var thrownException = expectThrows(ElasticsearchStatusException.class, () -> listener.actionGet(TIMEOUT));
             assertThat(
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/anthropic/AnthropicChatCompletionActionTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/anthropic/AnthropicChatCompletionActionTests.java
index fca2e316af17f..2065a726b7589 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/anthropic/AnthropicChatCompletionActionTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/anthropic/AnthropicChatCompletionActionTests.java
@@ -27,7 +27,7 @@
 import org.elasticsearch.xpack.inference.external.action.SingleInputSenderExecutableAction;
 import org.elasticsearch.xpack.inference.external.http.HttpClientManager;
 import org.elasticsearch.xpack.inference.external.http.sender.AnthropicCompletionRequestManager;
-import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
+import org.elasticsearch.xpack.inference.external.http.sender.ChatCompletionInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSenderTests;
 import org.elasticsearch.xpack.inference.external.http.sender.Sender;
@@ -113,7 +113,7 @@ public void testExecute_ReturnsSuccessfulResponse() throws IOException {
             var action = createAction(getUrl(webServer), "secret", "model", 1, sender);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var result = listener.actionGet(TIMEOUT);
 
@@ -149,7 +149,7 @@ public void testExecute_ThrowsElasticsearchException() {
         var action = createAction(getUrl(webServer), "secret", "model", 1, sender);
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -170,7 +170,7 @@ public void testExecute_ThrowsElasticsearchException_WhenSenderOnFailureIsCalled
         var action = createAction(getUrl(webServer), "secret", "model", 1, sender);
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -187,7 +187,7 @@ public void testExecute_ThrowsException() {
         var action = createAction(getUrl(webServer), "secret", "model", 1, sender);
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -229,7 +229,7 @@ public void testExecute_ThrowsException_WhenInputIsGreaterThanOne() throws IOExc
             var action = createAction(getUrl(webServer), "secret", "model", 1, sender);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc", "def")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc", "def")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var thrownException = expectThrows(ElasticsearchStatusException.class, () -> listener.actionGet(TIMEOUT));
 
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/azureaistudio/AzureAiStudioActionAndCreatorTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/azureaistudio/AzureAiStudioActionAndCreatorTests.java
index 8792234102a94..210fab457de10 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/azureaistudio/AzureAiStudioActionAndCreatorTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/azureaistudio/AzureAiStudioActionAndCreatorTests.java
@@ -21,6 +21,7 @@
 import org.elasticsearch.xpack.core.inference.action.InferenceAction;
 import org.elasticsearch.xpack.inference.common.TruncatorTests;
 import org.elasticsearch.xpack.inference.external.http.HttpClientManager;
+import org.elasticsearch.xpack.inference.external.http.sender.ChatCompletionInput;
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSenderTests;
@@ -160,7 +161,7 @@ public void testChatCompletionRequestAction() throws IOException {
             var action = creator.create(model, Map.of());
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var result = listener.actionGet(TIMEOUT);
 
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/azureopenai/AzureOpenAiActionCreatorTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/azureopenai/AzureOpenAiActionCreatorTests.java
index 45a2fb0954c79..7e1e3e55caed8 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/azureopenai/AzureOpenAiActionCreatorTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/azureopenai/AzureOpenAiActionCreatorTests.java
@@ -24,6 +24,7 @@
 import org.elasticsearch.xpack.core.inference.action.InferenceAction;
 import org.elasticsearch.xpack.core.inference.results.ChatCompletionResults;
 import org.elasticsearch.xpack.inference.external.http.HttpClientManager;
+import org.elasticsearch.xpack.inference.external.http.sender.ChatCompletionInput;
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSenderTests;
 import org.elasticsearch.xpack.inference.external.request.azureopenai.AzureOpenAiUtils;
@@ -475,7 +476,7 @@ public void testInfer_AzureOpenAiCompletion_WithOverriddenUser() throws IOExcept
             var action = actionCreator.create(model, taskSettingsWithUserOverride);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of(completionInput)), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of(completionInput)), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var result = listener.actionGet(TIMEOUT);
 
@@ -531,7 +532,7 @@ public void testInfer_AzureOpenAiCompletionModel_WithoutUser() throws IOExceptio
             var action = actionCreator.create(model, requestTaskSettingsWithoutUser);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of(completionInput)), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of(completionInput)), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var result = listener.actionGet(TIMEOUT);
 
@@ -589,7 +590,7 @@ public void testInfer_AzureOpenAiCompletionModel_FailsFromInvalidResponseFormat(
             var action = actionCreator.create(model, requestTaskSettingsWithoutUser);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of(completionInput)), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of(completionInput)), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var thrownException = expectThrows(ElasticsearchStatusException.class, () -> listener.actionGet(TIMEOUT));
             assertThat(
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/azureopenai/AzureOpenAiCompletionActionTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/azureopenai/AzureOpenAiCompletionActionTests.java
index 4c7683c882816..dca12dfda9c98 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/azureopenai/AzureOpenAiCompletionActionTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/azureopenai/AzureOpenAiCompletionActionTests.java
@@ -26,7 +26,7 @@
 import org.elasticsearch.xpack.inference.external.action.SingleInputSenderExecutableAction;
 import org.elasticsearch.xpack.inference.external.http.HttpClientManager;
 import org.elasticsearch.xpack.inference.external.http.sender.AzureOpenAiCompletionRequestManager;
-import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
+import org.elasticsearch.xpack.inference.external.http.sender.ChatCompletionInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSenderTests;
 import org.elasticsearch.xpack.inference.external.http.sender.Sender;
 import org.elasticsearch.xpack.inference.external.request.azureopenai.AzureOpenAiUtils;
@@ -111,7 +111,7 @@ public void testExecute_ReturnsSuccessfulResponse() throws IOException {
             var action = createAction("resource", "deployment", "apiversion", user, apiKey, sender, "id");
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of(completionInput)), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of(completionInput)), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var result = listener.actionGet(TIMEOUT);
 
@@ -142,7 +142,7 @@ public void testExecute_ThrowsElasticsearchException() {
         var action = createAction("resource", "deployment", "apiVersion", "user", "apikey", sender, "id");
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -163,7 +163,7 @@ public void testExecute_ThrowsElasticsearchException_WhenSenderOnFailureIsCalled
         var action = createAction("resource", "deployment", "apiVersion", "user", "apikey", sender, "id");
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -177,7 +177,7 @@ public void testExecute_ThrowsException() {
         var action = createAction("resource", "deployment", "apiVersion", "user", "apikey", sender, "id");
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/cohere/CohereActionCreatorTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/cohere/CohereActionCreatorTests.java
index 9ec34e7d8e5c5..3a512de25a39c 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/cohere/CohereActionCreatorTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/cohere/CohereActionCreatorTests.java
@@ -20,6 +20,7 @@
 import org.elasticsearch.xcontent.XContentType;
 import org.elasticsearch.xpack.core.inference.action.InferenceAction;
 import org.elasticsearch.xpack.inference.external.http.HttpClientManager;
+import org.elasticsearch.xpack.inference.external.http.sender.ChatCompletionInput;
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSenderTests;
 import org.elasticsearch.xpack.inference.logging.ThrottlerManager;
@@ -197,7 +198,7 @@ public void testCreate_CohereCompletionModel_WithModelSpecified() throws IOExcep
             var action = actionCreator.create(model, Map.of());
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var result = listener.actionGet(TIMEOUT);
 
@@ -257,7 +258,7 @@ public void testCreate_CohereCompletionModel_WithoutModelSpecified() throws IOEx
             var action = actionCreator.create(model, Map.of());
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var result = listener.actionGet(TIMEOUT);
 
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/cohere/CohereCompletionActionTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/cohere/CohereCompletionActionTests.java
index ba839e0d7c5e9..c5871adb34864 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/cohere/CohereCompletionActionTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/cohere/CohereCompletionActionTests.java
@@ -26,8 +26,8 @@
 import org.elasticsearch.xpack.inference.external.action.ExecutableAction;
 import org.elasticsearch.xpack.inference.external.action.SingleInputSenderExecutableAction;
 import org.elasticsearch.xpack.inference.external.http.HttpClientManager;
+import org.elasticsearch.xpack.inference.external.http.sender.ChatCompletionInput;
 import org.elasticsearch.xpack.inference.external.http.sender.CohereCompletionRequestManager;
-import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSenderTests;
 import org.elasticsearch.xpack.inference.external.http.sender.Sender;
 import org.elasticsearch.xpack.inference.external.request.cohere.CohereUtils;
@@ -120,7 +120,7 @@ public void testExecute_ReturnsSuccessfulResponse_WithModelSpecified() throws IO
             var action = createAction(getUrl(webServer), "secret", "model", sender);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var result = listener.actionGet(TIMEOUT);
 
@@ -181,7 +181,7 @@ public void testExecute_ReturnsSuccessfulResponse_WithoutModelSpecified() throws
             var action = createAction(getUrl(webServer), "secret", null, sender);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var result = listener.actionGet(TIMEOUT);
 
@@ -214,7 +214,7 @@ public void testExecute_ThrowsElasticsearchException() {
         var action = createAction(getUrl(webServer), "secret", "model", sender);
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -235,7 +235,7 @@ public void testExecute_ThrowsElasticsearchException_WhenSenderOnFailureIsCalled
         var action = createAction(getUrl(webServer), "secret", "model", sender);
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -256,7 +256,7 @@ public void testExecute_ThrowsElasticsearchException_WhenSenderOnFailureIsCalled
         var action = createAction(null, "secret", "model", sender);
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -270,7 +270,7 @@ public void testExecute_ThrowsException() {
         var action = createAction(getUrl(webServer), "secret", "model", sender);
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -284,7 +284,7 @@ public void testExecute_ThrowsExceptionWithNullUrl() {
         var action = createAction(null, "secret", "model", sender);
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -334,7 +334,7 @@ public void testExecute_ThrowsException_WhenInputIsGreaterThanOne() throws IOExc
             var action = createAction(getUrl(webServer), "secret", "model", sender);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc", "def")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc", "def")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var thrownException = expectThrows(ElasticsearchStatusException.class, () -> listener.actionGet(TIMEOUT));
 
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/googleaistudio/GoogleAiStudioCompletionActionTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/googleaistudio/GoogleAiStudioCompletionActionTests.java
index 72b5ffa45a0dd..ff17bbf66e02a 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/googleaistudio/GoogleAiStudioCompletionActionTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/googleaistudio/GoogleAiStudioCompletionActionTests.java
@@ -25,7 +25,7 @@
 import org.elasticsearch.xpack.inference.external.action.ExecutableAction;
 import org.elasticsearch.xpack.inference.external.action.SingleInputSenderExecutableAction;
 import org.elasticsearch.xpack.inference.external.http.HttpClientManager;
-import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
+import org.elasticsearch.xpack.inference.external.http.sender.ChatCompletionInput;
 import org.elasticsearch.xpack.inference.external.http.sender.GoogleAiStudioCompletionRequestManager;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSenderTests;
 import org.elasticsearch.xpack.inference.external.http.sender.Sender;
@@ -128,7 +128,7 @@ public void testExecute_ReturnsSuccessfulResponse() throws IOException {
             var action = createAction(getUrl(webServer), "secret", "model", sender);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("input")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("input")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var result = listener.actionGet(TIMEOUT);
 
@@ -159,7 +159,7 @@ public void testExecute_ThrowsElasticsearchException() {
         var action = createAction(getUrl(webServer), "secret", "model", sender);
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -180,7 +180,7 @@ public void testExecute_ThrowsElasticsearchException_WhenSenderOnFailureIsCalled
         var action = createAction(getUrl(webServer), "secret", "model", sender);
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -197,7 +197,7 @@ public void testExecute_ThrowsException() {
         var action = createAction(getUrl(webServer), "secret", "model", sender);
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -260,7 +260,7 @@ public void testExecute_ThrowsException_WhenInputIsGreaterThanOne() throws IOExc
             var action = createAction(getUrl(webServer), "secret", "model", sender);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc", "def")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc", "def")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var thrownException = expectThrows(ElasticsearchStatusException.class, () -> listener.actionGet(TIMEOUT));
 
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/openai/OpenAiActionCreatorTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/openai/OpenAiActionCreatorTests.java
index b6d7eb673b7f0..fe076eb721ea2 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/openai/OpenAiActionCreatorTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/openai/OpenAiActionCreatorTests.java
@@ -21,6 +21,7 @@
 import org.elasticsearch.xcontent.XContentType;
 import org.elasticsearch.xpack.core.inference.action.InferenceAction;
 import org.elasticsearch.xpack.inference.external.http.HttpClientManager;
+import org.elasticsearch.xpack.inference.external.http.sender.ChatCompletionInput;
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSenderTests;
 import org.elasticsearch.xpack.inference.logging.ThrottlerManager;
@@ -330,7 +331,7 @@ public void testCreate_OpenAiChatCompletionModel() throws IOException {
             var action = actionCreator.create(model, overriddenTaskSettings);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var result = listener.actionGet(TIMEOUT);
 
@@ -345,11 +346,12 @@ public void testCreate_OpenAiChatCompletionModel() throws IOException {
             assertThat(request.getHeader(ORGANIZATION_HEADER), equalTo("org"));
 
             var requestMap = entityAsMap(webServer.requests().get(0).getBody());
-            assertThat(requestMap.size(), is(4));
+            assertThat(requestMap.size(), is(5));
             assertThat(requestMap.get("messages"), is(List.of(Map.of("role", "user", "content", "abc"))));
             assertThat(requestMap.get("model"), is("model"));
             assertThat(requestMap.get("user"), is("overridden_user"));
             assertThat(requestMap.get("n"), is(1));
+            assertThat(requestMap.get("stream"), is(false));
         }
     }
 
@@ -393,7 +395,7 @@ public void testCreate_OpenAiChatCompletionModel_WithoutUser() throws IOExceptio
             var action = actionCreator.create(model, overriddenTaskSettings);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var result = listener.actionGet(TIMEOUT);
 
@@ -408,10 +410,11 @@ public void testCreate_OpenAiChatCompletionModel_WithoutUser() throws IOExceptio
             assertThat(request.getHeader(ORGANIZATION_HEADER), equalTo("org"));
 
             var requestMap = entityAsMap(webServer.requests().get(0).getBody());
-            assertThat(requestMap.size(), is(3));
+            assertThat(requestMap.size(), is(4));
             assertThat(requestMap.get("messages"), is(List.of(Map.of("role", "user", "content", "abc"))));
             assertThat(requestMap.get("model"), is("model"));
             assertThat(requestMap.get("n"), is(1));
+            assertThat(requestMap.get("stream"), is(false));
         }
     }
 
@@ -455,7 +458,7 @@ public void testCreate_OpenAiChatCompletionModel_WithoutOrganization() throws IO
             var action = actionCreator.create(model, overriddenTaskSettings);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var result = listener.actionGet(TIMEOUT);
 
@@ -470,11 +473,12 @@ public void testCreate_OpenAiChatCompletionModel_WithoutOrganization() throws IO
             assertNull(request.getHeader(ORGANIZATION_HEADER));
 
             var requestMap = entityAsMap(webServer.requests().get(0).getBody());
-            assertThat(requestMap.size(), is(4));
+            assertThat(requestMap.size(), is(5));
             assertThat(requestMap.get("messages"), is(List.of(Map.of("role", "user", "content", "abc"))));
             assertThat(requestMap.get("model"), is("model"));
             assertThat(requestMap.get("user"), is("overridden_user"));
             assertThat(requestMap.get("n"), is(1));
+            assertThat(requestMap.get("stream"), is(false));
         }
     }
 
@@ -523,7 +527,7 @@ public void testCreate_OpenAiChatCompletionModel_FailsFromInvalidResponseFormat(
             var action = actionCreator.create(model, overriddenTaskSettings);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var thrownException = expectThrows(ElasticsearchStatusException.class, () -> listener.actionGet(TIMEOUT));
             assertThat(
@@ -542,11 +546,12 @@ public void testCreate_OpenAiChatCompletionModel_FailsFromInvalidResponseFormat(
             assertNull(webServer.requests().get(0).getHeader(ORGANIZATION_HEADER));
 
             var requestMap = entityAsMap(webServer.requests().get(0).getBody());
-            assertThat(requestMap.size(), is(4));
+            assertThat(requestMap.size(), is(5));
             assertThat(requestMap.get("messages"), is(List.of(Map.of("role", "user", "content", "abc"))));
             assertThat(requestMap.get("model"), is("model"));
             assertThat(requestMap.get("user"), is("overridden_user"));
             assertThat(requestMap.get("n"), is(1));
+            assertThat(requestMap.get("stream"), is(false));
         }
     }
 
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/openai/OpenAiChatCompletionActionTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/openai/OpenAiChatCompletionActionTests.java
index d84b2b5bb324a..ba74d2ab42c21 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/openai/OpenAiChatCompletionActionTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/action/openai/OpenAiChatCompletionActionTests.java
@@ -27,7 +27,7 @@
 import org.elasticsearch.xpack.inference.external.action.ExecutableAction;
 import org.elasticsearch.xpack.inference.external.action.SingleInputSenderExecutableAction;
 import org.elasticsearch.xpack.inference.external.http.HttpClientManager;
-import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
+import org.elasticsearch.xpack.inference.external.http.sender.ChatCompletionInput;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSenderTests;
 import org.elasticsearch.xpack.inference.external.http.sender.OpenAiCompletionRequestManager;
@@ -119,7 +119,7 @@ public void testExecute_ReturnsSuccessfulResponse() throws IOException {
             var action = createAction(getUrl(webServer), "org", "secret", "model", "user", sender);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var result = listener.actionGet(TIMEOUT);
 
@@ -134,11 +134,12 @@ public void testExecute_ReturnsSuccessfulResponse() throws IOException {
             assertThat(request.getHeader(ORGANIZATION_HEADER), equalTo("org"));
 
             var requestMap = entityAsMap(request.getBody());
-            assertThat(requestMap.size(), is(4));
+            assertThat(requestMap.size(), is(5));
             assertThat(requestMap.get("messages"), is(List.of(Map.of("role", "user", "content", "abc"))));
             assertThat(requestMap.get("model"), is("model"));
             assertThat(requestMap.get("user"), is("user"));
             assertThat(requestMap.get("n"), is(1));
+            assertThat(requestMap.get("stream"), is(false));
         }
     }
 
@@ -159,7 +160,7 @@ public void testExecute_ThrowsElasticsearchException() {
         var action = createAction(getUrl(webServer), "org", "secret", "model", "user", sender);
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -180,7 +181,7 @@ public void testExecute_ThrowsElasticsearchException_WhenSenderOnFailureIsCalled
         var action = createAction(getUrl(webServer), "org", "secret", "model", "user", sender);
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -201,7 +202,7 @@ public void testExecute_ThrowsElasticsearchException_WhenSenderOnFailureIsCalled
         var action = createAction(null, "org", "secret", "model", "user", sender);
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -215,7 +216,7 @@ public void testExecute_ThrowsException() {
         var action = createAction(getUrl(webServer), "org", "secret", "model", "user", sender);
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -229,7 +230,7 @@ public void testExecute_ThrowsExceptionWithNullUrl() {
         var action = createAction(null, "org", "secret", "model", "user", sender);
 
         PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-        action.execute(new DocumentsOnlyInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+        action.execute(new ChatCompletionInput(List.of("abc")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
         var thrownException = expectThrows(ElasticsearchException.class, () -> listener.actionGet(TIMEOUT));
 
@@ -273,7 +274,7 @@ public void testExecute_ThrowsException_WhenInputIsGreaterThanOne() throws IOExc
             var action = createAction(getUrl(webServer), "org", "secret", "model", "user", sender);
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
-            action.execute(new DocumentsOnlyInput(List.of("abc", "def")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
+            action.execute(new ChatCompletionInput(List.of("abc", "def")), InferenceAction.Request.DEFAULT_TIMEOUT, listener);
 
             var thrownException = expectThrows(ElasticsearchStatusException.class, () -> listener.actionGet(TIMEOUT));
 
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/amazonbedrock/AmazonBedrockMockRequestSender.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/amazonbedrock/AmazonBedrockMockRequestSender.java
index e68beaf4c1eb5..929aefeeef6b9 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/amazonbedrock/AmazonBedrockMockRequestSender.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/amazonbedrock/AmazonBedrockMockRequestSender.java
@@ -12,6 +12,7 @@
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.inference.InferenceServiceResults;
+import org.elasticsearch.xpack.inference.external.http.sender.ChatCompletionInput;
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.InferenceInputs;
 import org.elasticsearch.xpack.inference.external.http.sender.RequestManager;
@@ -67,8 +68,15 @@ public void send(
         ActionListener<InferenceServiceResults> listener
     ) {
         sendCounter++;
-        var docsInput = (DocumentsOnlyInput) inferenceInputs;
-        inputs.add(docsInput.getInputs());
+        if (inferenceInputs instanceof DocumentsOnlyInput docsInput) {
+            inputs.add(docsInput.getInputs());
+        } else if (inferenceInputs instanceof ChatCompletionInput chatCompletionInput) {
+            inputs.add(chatCompletionInput.getInputs());
+        } else {
+            throw new IllegalArgumentException(
+                "Invalid inference inputs received in mock sender: " + inferenceInputs.getClass().getSimpleName()
+            );
+        }
 
         if (results.isEmpty()) {
             listener.onFailure(new ElasticsearchException("No results found"));
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/amazonbedrock/AmazonBedrockRequestSenderTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/amazonbedrock/AmazonBedrockRequestSenderTests.java
index 7fa8a09d5bf12..a8f37aedcece3 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/amazonbedrock/AmazonBedrockRequestSenderTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/amazonbedrock/AmazonBedrockRequestSenderTests.java
@@ -15,6 +15,7 @@
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.xpack.inference.external.http.sender.AmazonBedrockChatCompletionRequestManager;
 import org.elasticsearch.xpack.inference.external.http.sender.AmazonBedrockEmbeddingsRequestManager;
+import org.elasticsearch.xpack.inference.external.http.sender.ChatCompletionInput;
 import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
 import org.elasticsearch.xpack.inference.external.http.sender.Sender;
 import org.elasticsearch.xpack.inference.logging.ThrottlerManager;
@@ -107,7 +108,7 @@ public void testCreateSender_SendsCompletionRequestAndReceivesResponse() throws
 
             PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
             var requestManager = new AmazonBedrockChatCompletionRequestManager(model, threadPool, new TimeValue(30, TimeUnit.SECONDS));
-            sender.send(requestManager, new DocumentsOnlyInput(List.of("abc")), null, listener);
+            sender.send(requestManager, new ChatCompletionInput(List.of("abc")), null, listener);
 
             var result = listener.actionGet(TIMEOUT);
             assertThat(result.asMap(), is(buildExpectationCompletion(List.of("test response text"))));
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/http/sender/InferenceInputsTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/http/sender/InferenceInputsTests.java
new file mode 100644
index 0000000000000..f0da67a982374
--- /dev/null
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/http/sender/InferenceInputsTests.java
@@ -0,0 +1,40 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.external.http.sender;
+
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.inference.UnifiedCompletionRequest;
+import org.elasticsearch.test.ESTestCase;
+import org.hamcrest.Matchers;
+
+import java.util.List;
+
+public class InferenceInputsTests extends ESTestCase {
+    public void testCastToSucceeds() {
+        InferenceInputs inputs = new DocumentsOnlyInput(List.of(), false);
+        assertThat(inputs.castTo(DocumentsOnlyInput.class), Matchers.instanceOf(DocumentsOnlyInput.class));
+
+        var emptyRequest = new UnifiedCompletionRequest(List.of(), null, null, null, null, null, null, null);
+        assertThat(new UnifiedChatInput(emptyRequest, false).castTo(UnifiedChatInput.class), Matchers.instanceOf(UnifiedChatInput.class));
+        assertThat(
+            new QueryAndDocsInputs("hello", List.of(), false).castTo(QueryAndDocsInputs.class),
+            Matchers.instanceOf(QueryAndDocsInputs.class)
+        );
+    }
+
+    public void testCastToFails() {
+        InferenceInputs inputs = new DocumentsOnlyInput(List.of(), false);
+        var exception = expectThrows(IllegalArgumentException.class, () -> inputs.castTo(QueryAndDocsInputs.class));
+        assertThat(
+            exception.getMessage(),
+            Matchers.containsString(
+                Strings.format("Unable to convert inference inputs type: [%s] to [%s]", DocumentsOnlyInput.class, QueryAndDocsInputs.class)
+            )
+        );
+    }
+}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/http/sender/UnifiedChatInputTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/http/sender/UnifiedChatInputTests.java
new file mode 100644
index 0000000000000..42e1b18168aec
--- /dev/null
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/http/sender/UnifiedChatInputTests.java
@@ -0,0 +1,46 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.external.http.sender;
+
+import org.elasticsearch.inference.UnifiedCompletionRequest;
+import org.elasticsearch.test.ESTestCase;
+import org.hamcrest.Matchers;
+
+import java.util.List;
+
+public class UnifiedChatInputTests extends ESTestCase {
+
+    public void testConvertsStringInputToMessages() {
+        var a = new UnifiedChatInput(List.of("hello", "awesome"), "a role", true);
+
+        assertThat(a.inputSize(), Matchers.is(2));
+        assertThat(
+            a.getRequest(),
+            Matchers.is(
+                UnifiedCompletionRequest.of(
+                    List.of(
+                        new UnifiedCompletionRequest.Message(
+                            new UnifiedCompletionRequest.ContentString("hello"),
+                            "a role",
+                            null,
+                            null,
+                            null
+                        ),
+                        new UnifiedCompletionRequest.Message(
+                            new UnifiedCompletionRequest.ContentString("awesome"),
+                            "a role",
+                            null,
+                            null,
+                            null
+                        )
+                    )
+                )
+            )
+        );
+    }
+}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/openai/OpenAiUnifiedStreamingProcessorTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/openai/OpenAiUnifiedStreamingProcessorTests.java
new file mode 100644
index 0000000000000..0f127998f9c54
--- /dev/null
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/openai/OpenAiUnifiedStreamingProcessorTests.java
@@ -0,0 +1,383 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.external.openai;
+
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.common.xcontent.LoggingDeprecationHandler;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xcontent.XContentFactory;
+import org.elasticsearch.xcontent.XContentParser;
+import org.elasticsearch.xcontent.XContentParserConfiguration;
+import org.elasticsearch.xcontent.XContentType;
+import org.elasticsearch.xpack.core.inference.results.StreamingUnifiedChatCompletionResults;
+
+import java.io.IOException;
+import java.util.List;
+
+public class OpenAiUnifiedStreamingProcessorTests extends ESTestCase {
+
+    public void testJsonLiteral() {
+        String json = """
+                {
+                  "id": "example_id",
+                  "choices": [
+                    {
+                      "delta": {
+                        "content": "example_content",
+                        "refusal": null,
+                        "role": "assistant",
+                        "tool_calls": [
+                          {
+                            "index": 1,
+                            "id": "tool_call_id",
+                            "function": {
+                              "arguments": "example_arguments",
+                              "name": "example_function_name"
+                            },
+                            "type": "function"
+                          }
+                        ]
+                      },
+                      "finish_reason": "stop",
+                      "index": 0
+                    }
+                  ],
+                  "model": "example_model",
+                  "object": "chat.completion.chunk",
+                  "usage": {
+                    "completion_tokens": 50,
+                    "prompt_tokens": 20,
+                    "total_tokens": 70
+                  }
+                }
+            """;
+        // Parse the JSON
+        XContentParserConfiguration parserConfig = XContentParserConfiguration.EMPTY.withDeprecationHandler(
+            LoggingDeprecationHandler.INSTANCE
+        );
+        try (XContentParser parser = XContentFactory.xContent(XContentType.JSON).createParser(parserConfig, json)) {
+            StreamingUnifiedChatCompletionResults.ChatCompletionChunk chunk = OpenAiUnifiedStreamingProcessor.ChatCompletionChunkParser
+                .parse(parser);
+
+            // Assertions to verify the parsed object
+            assertEquals("example_id", chunk.getId());
+            assertEquals("example_model", chunk.getModel());
+            assertEquals("chat.completion.chunk", chunk.getObject());
+            assertNotNull(chunk.getUsage());
+            assertEquals(50, chunk.getUsage().completionTokens());
+            assertEquals(20, chunk.getUsage().promptTokens());
+            assertEquals(70, chunk.getUsage().totalTokens());
+
+            List<StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice> choices = chunk.getChoices();
+            assertEquals(1, choices.size());
+            StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice choice = choices.get(0);
+            assertEquals("example_content", choice.delta().getContent());
+            assertNull(choice.delta().getRefusal());
+            assertEquals("assistant", choice.delta().getRole());
+            assertEquals("stop", choice.finishReason());
+            assertEquals(0, choice.index());
+
+            List<StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall> toolCalls = choice.delta().getToolCalls();
+            assertEquals(1, toolCalls.size());
+            StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall toolCall = toolCalls.get(0);
+            assertEquals(1, toolCall.getIndex());
+            assertEquals("tool_call_id", toolCall.getId());
+            assertEquals("example_function_name", toolCall.getFunction().getName());
+            assertEquals("example_arguments", toolCall.getFunction().getArguments());
+            assertEquals("function", toolCall.getType());
+        } catch (IOException e) {
+            fail();
+        }
+    }
+
+    public void testJsonLiteralCornerCases() {
+        String json = """
+                {
+                  "id": "example_id",
+                  "choices": [
+                    {
+                      "delta": {
+                        "content": null,
+                        "refusal": null,
+                        "role": "assistant",
+                        "tool_calls": []
+                      },
+                      "finish_reason": null,
+                      "index": 0
+                    },
+                    {
+                      "delta": {
+                        "content": "example_content",
+                        "refusal": "example_refusal",
+                        "role": "user",
+                        "tool_calls": [
+                          {
+                            "index": 1,
+                            "function": {
+                              "name": "example_function_name"
+                            },
+                            "type": "function"
+                          }
+                        ]
+                      },
+                      "finish_reason": "stop",
+                      "index": 1
+                    }
+                  ],
+                  "model": "example_model",
+                  "object": "chat.completion.chunk",
+                  "usage": null
+                }
+            """;
+        // Parse the JSON
+        XContentParserConfiguration parserConfig = XContentParserConfiguration.EMPTY.withDeprecationHandler(
+            LoggingDeprecationHandler.INSTANCE
+        );
+        try (XContentParser parser = XContentFactory.xContent(XContentType.JSON).createParser(parserConfig, json)) {
+            StreamingUnifiedChatCompletionResults.ChatCompletionChunk chunk = OpenAiUnifiedStreamingProcessor.ChatCompletionChunkParser
+                .parse(parser);
+
+            // Assertions to verify the parsed object
+            assertEquals("example_id", chunk.getId());
+            assertEquals("example_model", chunk.getModel());
+            assertEquals("chat.completion.chunk", chunk.getObject());
+            assertNull(chunk.getUsage());
+
+            List<StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice> choices = chunk.getChoices();
+            assertEquals(2, choices.size());
+
+            // First choice assertions
+            StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice firstChoice = choices.get(0);
+            assertNull(firstChoice.delta().getContent());
+            assertNull(firstChoice.delta().getRefusal());
+            assertEquals("assistant", firstChoice.delta().getRole());
+            assertTrue(firstChoice.delta().getToolCalls().isEmpty());
+            assertNull(firstChoice.finishReason());
+            assertEquals(0, firstChoice.index());
+
+            // Second choice assertions
+            StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice secondChoice = choices.get(1);
+            assertEquals("example_content", secondChoice.delta().getContent());
+            assertEquals("example_refusal", secondChoice.delta().getRefusal());
+            assertEquals("user", secondChoice.delta().getRole());
+            assertEquals("stop", secondChoice.finishReason());
+            assertEquals(1, secondChoice.index());
+
+            List<StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall> toolCalls = secondChoice.delta()
+                .getToolCalls();
+            assertEquals(1, toolCalls.size());
+            StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall toolCall = toolCalls.get(0);
+            assertEquals(1, toolCall.getIndex());
+            assertNull(toolCall.getId());
+            assertEquals("example_function_name", toolCall.getFunction().getName());
+            assertNull(toolCall.getFunction().getArguments());
+            assertEquals("function", toolCall.getType());
+        } catch (IOException e) {
+            fail();
+        }
+    }
+
+    public void testOpenAiUnifiedStreamingProcessorParsing() throws IOException {
+        // Generate random values for the JSON fields
+        int toolCallIndex = randomIntBetween(0, 10);
+        String toolCallId = randomAlphaOfLength(5);
+        String toolCallFunctionName = randomAlphaOfLength(8);
+        String toolCallFunctionArguments = randomAlphaOfLength(10);
+        String toolCallType = "function";
+        String toolCallJson = createToolCallJson(toolCallIndex, toolCallId, toolCallFunctionName, toolCallFunctionArguments, toolCallType);
+
+        String choiceContent = randomAlphaOfLength(10);
+        String choiceRole = randomFrom("system", "user", "assistant", "tool");
+        String choiceFinishReason = randomFrom("stop", "length", "tool_calls", "content_filter", "function_call", null);
+        int choiceIndex = randomIntBetween(0, 10);
+        String choiceJson = createChoiceJson(choiceContent, null, choiceRole, toolCallJson, choiceFinishReason, choiceIndex);
+
+        int usageCompletionTokens = randomIntBetween(1, 100);
+        int usagePromptTokens = randomIntBetween(1, 100);
+        int usageTotalTokens = randomIntBetween(1, 200);
+        String usageJson = createUsageJson(usageCompletionTokens, usagePromptTokens, usageTotalTokens);
+
+        String chatCompletionChunkId = randomAlphaOfLength(10);
+        String chatCompletionChunkModel = randomAlphaOfLength(5);
+        String chatCompletionChunkJson = createChatCompletionChunkJson(
+            chatCompletionChunkId,
+            choiceJson,
+            chatCompletionChunkModel,
+            "chat.completion.chunk",
+            usageJson
+        );
+
+        // Parse the JSON
+        XContentParserConfiguration parserConfig = XContentParserConfiguration.EMPTY.withDeprecationHandler(
+            LoggingDeprecationHandler.INSTANCE
+        );
+        try (XContentParser parser = XContentFactory.xContent(XContentType.JSON).createParser(parserConfig, chatCompletionChunkJson)) {
+            StreamingUnifiedChatCompletionResults.ChatCompletionChunk chunk = OpenAiUnifiedStreamingProcessor.ChatCompletionChunkParser
+                .parse(parser);
+
+            // Assertions to verify the parsed object
+            assertEquals(chatCompletionChunkId, chunk.getId());
+            assertEquals(chatCompletionChunkModel, chunk.getModel());
+            assertEquals("chat.completion.chunk", chunk.getObject());
+            assertNotNull(chunk.getUsage());
+            assertEquals(usageCompletionTokens, chunk.getUsage().completionTokens());
+            assertEquals(usagePromptTokens, chunk.getUsage().promptTokens());
+            assertEquals(usageTotalTokens, chunk.getUsage().totalTokens());
+
+            List<StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice> choices = chunk.getChoices();
+            assertEquals(1, choices.size());
+            StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice choice = choices.get(0);
+            assertEquals(choiceContent, choice.delta().getContent());
+            assertNull(choice.delta().getRefusal());
+            assertEquals(choiceRole, choice.delta().getRole());
+            assertEquals(choiceFinishReason, choice.finishReason());
+            assertEquals(choiceIndex, choice.index());
+
+            List<StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall> toolCalls = choice.delta().getToolCalls();
+            assertEquals(1, toolCalls.size());
+            StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice.Delta.ToolCall toolCall = toolCalls.get(0);
+            assertEquals(toolCallIndex, toolCall.getIndex());
+            assertEquals(toolCallId, toolCall.getId());
+            assertEquals(toolCallFunctionName, toolCall.getFunction().getName());
+            assertEquals(toolCallFunctionArguments, toolCall.getFunction().getArguments());
+            assertEquals(toolCallType, toolCall.getType());
+        }
+    }
+
+    public void testOpenAiUnifiedStreamingProcessorParsingWithNullFields() throws IOException {
+        // JSON with null fields
+        int choiceIndex = randomIntBetween(0, 10);
+        String choiceJson = createChoiceJson(null, null, null, "", null, choiceIndex);
+
+        String chatCompletionChunkId = randomAlphaOfLength(10);
+        String chatCompletionChunkModel = randomAlphaOfLength(5);
+        String chatCompletionChunkJson = createChatCompletionChunkJson(
+            chatCompletionChunkId,
+            choiceJson,
+            chatCompletionChunkModel,
+            "chat.completion.chunk",
+            null
+        );
+
+        // Parse the JSON
+        XContentParserConfiguration parserConfig = XContentParserConfiguration.EMPTY.withDeprecationHandler(
+            LoggingDeprecationHandler.INSTANCE
+        );
+        try (XContentParser parser = XContentFactory.xContent(XContentType.JSON).createParser(parserConfig, chatCompletionChunkJson)) {
+            StreamingUnifiedChatCompletionResults.ChatCompletionChunk chunk = OpenAiUnifiedStreamingProcessor.ChatCompletionChunkParser
+                .parse(parser);
+
+            // Assertions to verify the parsed object
+            assertEquals(chatCompletionChunkId, chunk.getId());
+            assertEquals(chatCompletionChunkModel, chunk.getModel());
+            assertEquals("chat.completion.chunk", chunk.getObject());
+            assertNull(chunk.getUsage());
+
+            List<StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice> choices = chunk.getChoices();
+            assertEquals(1, choices.size());
+            StreamingUnifiedChatCompletionResults.ChatCompletionChunk.Choice choice = choices.get(0);
+            assertNull(choice.delta().getContent());
+            assertNull(choice.delta().getRefusal());
+            assertNull(choice.delta().getRole());
+            assertNull(choice.finishReason());
+            assertEquals(choiceIndex, choice.index());
+            assertTrue(choice.delta().getToolCalls().isEmpty());
+        }
+    }
+
+    private String createToolCallJson(int index, String id, String functionName, String functionArguments, String type) {
+        return Strings.format("""
+            {
+                "index": %d,
+                "id": "%s",
+                "function": {
+                    "name": "%s",
+                    "arguments": "%s"
+                },
+                "type": "%s"
+            }
+            """, index, id, functionName, functionArguments, type);
+    }
+
+    private String createChoiceJson(String content, String refusal, String role, String toolCallsJson, String finishReason, int index) {
+        if (role == null) {
+            return Strings.format(
+                """
+                    {
+                        "delta": {
+                            "content": %s,
+                            "refusal": %s,
+                            "tool_calls": [%s]
+                        },
+                        "finish_reason": %s,
+                        "index": %d
+                    }
+                    """,
+                content != null ? "\"" + content + "\"" : "null",
+                refusal != null ? "\"" + refusal + "\"" : "null",
+                toolCallsJson,
+                finishReason != null ? "\"" + finishReason + "\"" : "null",
+                index
+            );
+        } else {
+            return Strings.format(
+                """
+                    {
+                        "delta": {
+                            "content": %s,
+                            "refusal": %s,
+                            "role": %s,
+                            "tool_calls": [%s]
+                        },
+                        "finish_reason": %s,
+                        "index": %d
+                    }
+                    """,
+                content != null ? "\"" + content + "\"" : "null",
+                refusal != null ? "\"" + refusal + "\"" : "null",
+                role != null ? "\"" + role + "\"" : "null",
+                toolCallsJson,
+                finishReason != null ? "\"" + finishReason + "\"" : "null",
+                index
+            );
+        }
+    }
+
+    private String createChatCompletionChunkJson(String id, String choicesJson, String model, String object, String usageJson) {
+        if (usageJson != null) {
+            return Strings.format("""
+                {
+                    "id": "%s",
+                    "choices": [%s],
+                    "model": "%s",
+                    "object": "%s",
+                    "usage": %s
+                }
+                """, id, choicesJson, model, object, usageJson);
+        } else {
+            return Strings.format("""
+                {
+                    "id": "%s",
+                    "choices": [%s],
+                    "model": "%s",
+                    "object": "%s"
+                }
+                """, id, choicesJson, model, object);
+        }
+    }
+
+    private String createUsageJson(int completionTokens, int promptTokens, int totalTokens) {
+        return Strings.format("""
+            {
+                "completion_tokens": %d,
+                "prompt_tokens": %d,
+                "total_tokens": %d
+            }
+            """, completionTokens, promptTokens, totalTokens);
+    }
+}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/googleaistudio/completion/GoogleAiStudioCompletionRequestTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/googleaistudio/completion/GoogleAiStudioCompletionRequestTests.java
index 7ffa8940ad6be..065dfee577a82 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/googleaistudio/completion/GoogleAiStudioCompletionRequestTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/googleaistudio/completion/GoogleAiStudioCompletionRequestTests.java
@@ -10,7 +10,7 @@
 import org.apache.http.client.methods.HttpPost;
 import org.elasticsearch.common.Strings;
 import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xpack.inference.external.http.sender.DocumentsOnlyInput;
+import org.elasticsearch.xpack.inference.external.http.sender.ChatCompletionInput;
 import org.elasticsearch.xpack.inference.external.request.googleaistudio.GoogleAiStudioCompletionRequest;
 import org.elasticsearch.xpack.inference.services.googleaistudio.completion.GoogleAiStudioCompletionModelTests;
 
@@ -72,7 +72,7 @@ public void testTruncationInfo_ReturnsNull() {
         assertNull(request.getTruncationInfo());
     }
 
-    private static DocumentsOnlyInput listOf(String... input) {
-        return new DocumentsOnlyInput(List.of(input));
+    private static ChatCompletionInput listOf(String... input) {
+        return new ChatCompletionInput(List.of(input));
     }
 }
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiChatCompletionRequestEntityTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiChatCompletionRequestEntityTests.java
deleted file mode 100644
index 9d5492f9e9516..0000000000000
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiChatCompletionRequestEntityTests.java
+++ /dev/null
@@ -1,53 +0,0 @@
-/*
- * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
- * or more contributor license agreements. Licensed under the Elastic License
- * 2.0; you may not use this file except in compliance with the Elastic License
- * 2.0.
- */
-
-package org.elasticsearch.xpack.inference.external.request.openai;
-
-import org.elasticsearch.common.Strings;
-import org.elasticsearch.test.ESTestCase;
-import org.elasticsearch.xcontent.XContentBuilder;
-import org.elasticsearch.xcontent.XContentFactory;
-import org.elasticsearch.xcontent.XContentType;
-
-import java.io.IOException;
-import java.util.List;
-
-import static org.hamcrest.CoreMatchers.is;
-
-public class OpenAiChatCompletionRequestEntityTests extends ESTestCase {
-
-    public void testXContent_WritesUserWhenDefined() throws IOException {
-        var entity = new OpenAiChatCompletionRequestEntity(List.of("abc"), "model", "user", false);
-
-        XContentBuilder builder = XContentFactory.contentBuilder(XContentType.JSON);
-        entity.toXContent(builder, null);
-        String xContentResult = Strings.toString(builder);
-
-        assertThat(xContentResult, is("""
-            {"messages":[{"role":"user","content":"abc"}],"model":"model","n":1,"user":"user"}"""));
-
-    }
-
-    public void testXContent_DoesNotWriteUserWhenItIsNull() throws IOException {
-        var entity = new OpenAiChatCompletionRequestEntity(List.of("abc"), "model", null, false);
-
-        XContentBuilder builder = XContentFactory.contentBuilder(XContentType.JSON);
-        entity.toXContent(builder, null);
-        String xContentResult = Strings.toString(builder);
-
-        assertThat(xContentResult, is("""
-            {"messages":[{"role":"user","content":"abc"}],"model":"model","n":1}"""));
-    }
-
-    public void testXContent_ThrowsIfModelIsNull() {
-        assertThrows(NullPointerException.class, () -> new OpenAiChatCompletionRequestEntity(List.of("abc"), null, "user", false));
-    }
-
-    public void testXContent_ThrowsIfMessagesAreNull() {
-        assertThrows(NullPointerException.class, () -> new OpenAiChatCompletionRequestEntity(null, "model", "user", false));
-    }
-}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiUnifiedChatCompletionRequestEntityTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiUnifiedChatCompletionRequestEntityTests.java
new file mode 100644
index 0000000000000..f945c154ea234
--- /dev/null
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiUnifiedChatCompletionRequestEntityTests.java
@@ -0,0 +1,856 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.external.request.openai;
+
+import org.elasticsearch.common.Randomness;
+import org.elasticsearch.common.Strings;
+import org.elasticsearch.inference.UnifiedCompletionRequest;
+import org.elasticsearch.test.ESTestCase;
+import org.elasticsearch.xcontent.ToXContent;
+import org.elasticsearch.xcontent.XContentBuilder;
+import org.elasticsearch.xcontent.json.JsonXContent;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
+import org.elasticsearch.xpack.inference.services.openai.completion.OpenAiChatCompletionModel;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Random;
+
+import static org.elasticsearch.xpack.inference.services.openai.completion.OpenAiChatCompletionModelTests.createChatCompletionModel;
+import static org.hamcrest.Matchers.equalTo;
+
+public class OpenAiUnifiedChatCompletionRequestEntityTests extends ESTestCase {
+
+    // 1. Basic Serialization
+    // Test with minimal required fields to ensure basic serialization works.
+    public void testBasicSerialization() throws IOException {
+        UnifiedCompletionRequest.Message message = new UnifiedCompletionRequest.Message(
+            new UnifiedCompletionRequest.ContentString("Hello, world!"),
+            OpenAiUnifiedChatCompletionRequestEntity.USER_FIELD,
+            null,
+            null,
+            null
+        );
+        var messageList = new ArrayList<UnifiedCompletionRequest.Message>();
+        messageList.add(message);
+        UnifiedCompletionRequest unifiedRequest = new UnifiedCompletionRequest(messageList, null, null, null, null, null, null, null);
+
+        UnifiedChatInput unifiedChatInput = new UnifiedChatInput(unifiedRequest, true);
+        OpenAiChatCompletionModel model = createChatCompletionModel("test-url", "organizationId", "api-key", "test-endpoint", null);
+
+        OpenAiUnifiedChatCompletionRequestEntity entity = new OpenAiUnifiedChatCompletionRequestEntity(unifiedChatInput, model);
+
+        XContentBuilder builder = JsonXContent.contentBuilder();
+        entity.toXContent(builder, ToXContent.EMPTY_PARAMS);
+
+        String jsonString = Strings.toString(builder);
+        String expectedJson = """
+            {
+                "messages": [
+                    {
+                        "content": "Hello, world!",
+                        "role": "user"
+                    }
+                ],
+                "model": "test-endpoint",
+                "n": 1,
+                "stream": true,
+                "stream_options": {
+                    "include_usage": true
+                }
+            }
+            """;
+        assertJsonEquals(jsonString, expectedJson);
+    }
+
+    // 2. Serialization with All Fields
+    // Test with all possible fields populated to ensure complete serialization.
+    public void testSerializationWithAllFields() throws IOException {
+        // Create a message with all fields populated
+        UnifiedCompletionRequest.Message message = new UnifiedCompletionRequest.Message(
+            new UnifiedCompletionRequest.ContentString("Hello, world!"),
+            OpenAiUnifiedChatCompletionRequestEntity.USER_FIELD,
+            "name",
+            "tool_call_id",
+            Collections.singletonList(
+                new UnifiedCompletionRequest.ToolCall(
+                    "id",
+                    new UnifiedCompletionRequest.ToolCall.FunctionField("arguments", "function_name"),
+                    "type"
+                )
+            )
+        );
+
+        // Create a tool with all fields populated
+        UnifiedCompletionRequest.Tool tool = new UnifiedCompletionRequest.Tool(
+            "type",
+            new UnifiedCompletionRequest.Tool.FunctionField(
+                "Fetches the weather in the given location",
+                "get_weather",
+                createParameters(),
+                true
+            )
+        );
+        var messageList = new ArrayList<UnifiedCompletionRequest.Message>();
+        messageList.add(message);
+        // Create the unified request with all fields populated
+        UnifiedCompletionRequest unifiedRequest = new UnifiedCompletionRequest(
+            messageList,
+            "model",
+            100L, // maxCompletionTokens
+            Collections.singletonList("stop"),
+            0.9f, // temperature
+            new UnifiedCompletionRequest.ToolChoiceString("tool_choice"),
+            Collections.singletonList(tool),
+            0.8f // topP
+        );
+
+        // Create the unified chat input
+        UnifiedChatInput unifiedChatInput = new UnifiedChatInput(unifiedRequest, true);
+
+        OpenAiChatCompletionModel model = createChatCompletionModel("test-endpoint", "organizationId", "api-key", "model-name", null);
+
+        // Create the entity
+        OpenAiUnifiedChatCompletionRequestEntity entity = new OpenAiUnifiedChatCompletionRequestEntity(unifiedChatInput, model);
+
+        // Serialize to XContent
+        XContentBuilder builder = JsonXContent.contentBuilder();
+        entity.toXContent(builder, ToXContent.EMPTY_PARAMS);
+
+        // Convert to string and verify
+        String jsonString = Strings.toString(builder);
+        String expectedJson = """
+            {
+                "messages": [
+                    {
+                        "content": "Hello, world!",
+                        "role": "user",
+                        "name": "name",
+                        "tool_call_id": "tool_call_id",
+                        "tool_calls": [
+                            {
+                                "id": "id",
+                                "function": {
+                                    "arguments": "arguments",
+                                    "name": "function_name"
+                                },
+                                "type": "type"
+                            }
+                        ]
+                    }
+                ],
+                "model": "model-name",
+                "max_completion_tokens": 100,
+                "n": 1,
+                "stop": ["stop"],
+                "temperature": 0.9,
+                "tool_choice": "tool_choice",
+                "tools": [
+                    {
+                        "type": "type",
+                        "function": {
+                            "description": "Fetches the weather in the given location",
+                            "name": "get_weather",
+                            "parameters": {
+                                "type": "object",
+                                "properties": {
+                                    "location": {
+                                        "description": "The location to get the weather for",
+                                        "type": "string"
+                                    },
+                                    "unit": {
+                                        "description": "The unit to return the temperature in",
+                                        "type": "string",
+                                        "enum": ["F", "C"]
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": ["location", "unit"]
+                            },
+                            "strict": true
+                        }
+                    }
+                ],
+                "top_p": 0.8,
+                "stream": true,
+                "stream_options": {
+                    "include_usage": true
+                }
+            }
+            """;
+        assertJsonEquals(jsonString, expectedJson);
+
+    }
+
+    // 3. Serialization with Null Optional Fields
+    // Test with optional fields set to null to ensure they are correctly omitted from the output.
+    public void testSerializationWithNullOptionalFields() throws IOException {
+        // Create a message with minimal required fields
+        UnifiedCompletionRequest.Message message = new UnifiedCompletionRequest.Message(
+            new UnifiedCompletionRequest.ContentString("Hello, world!"),
+            OpenAiUnifiedChatCompletionRequestEntity.USER_FIELD,
+            null,
+            null,
+            null
+        );
+        var messageList = new ArrayList<UnifiedCompletionRequest.Message>();
+        messageList.add(message);
+
+        // Create the unified request with optional fields set to null
+        UnifiedCompletionRequest unifiedRequest = new UnifiedCompletionRequest(
+            messageList,
+            null, // model
+            null, // maxCompletionTokens
+            null, // stop
+            null, // temperature
+            null, // toolChoice
+            null, // tools
+            null  // topP
+        );
+
+        // Create the unified chat input
+        UnifiedChatInput unifiedChatInput = new UnifiedChatInput(unifiedRequest, true);
+
+        OpenAiChatCompletionModel model = createChatCompletionModel("test-endpoint", "organizationId", "api-key", "model-name", null);
+
+        // Create the entity
+        OpenAiUnifiedChatCompletionRequestEntity entity = new OpenAiUnifiedChatCompletionRequestEntity(unifiedChatInput, model);
+
+        // Serialize to XContent
+        XContentBuilder builder = JsonXContent.contentBuilder();
+        entity.toXContent(builder, ToXContent.EMPTY_PARAMS);
+
+        // Convert to string and verify
+        String jsonString = Strings.toString(builder);
+        String expectedJson = """
+            {
+                "messages": [
+                    {
+                        "content": "Hello, world!",
+                        "role": "user"
+                    }
+                ],
+                "model": "model-name",
+                "n": 1,
+                "stream": true,
+                "stream_options": {
+                    "include_usage": true
+                }
+            }
+            """;
+        assertJsonEquals(jsonString, expectedJson);
+    }
+
+    // 4. Serialization with Empty Lists
+    // Test with fields that are lists set to empty lists to ensure they are correctly serialized.
+    public void testSerializationWithEmptyLists() throws IOException {
+        // Create a message with minimal required fields
+        UnifiedCompletionRequest.Message message = new UnifiedCompletionRequest.Message(
+            new UnifiedCompletionRequest.ContentString("Hello, world!"),
+            OpenAiUnifiedChatCompletionRequestEntity.USER_FIELD,
+            null,
+            null,
+            Collections.emptyList() // empty toolCalls list
+        );
+        var messageList = new ArrayList<UnifiedCompletionRequest.Message>();
+        messageList.add(message);
+        // Create the unified request with empty lists
+        UnifiedCompletionRequest unifiedRequest = new UnifiedCompletionRequest(
+            messageList,
+            null, // model
+            null, // maxCompletionTokens
+            Collections.emptyList(), // empty stop list
+            null, // temperature
+            null, // toolChoice
+            Collections.emptyList(), // empty tools list
+            null  // topP
+        );
+
+        // Create the unified chat input
+        UnifiedChatInput unifiedChatInput = new UnifiedChatInput(unifiedRequest, true);
+
+        OpenAiChatCompletionModel model = createChatCompletionModel("test-endpoint", "organizationId", "api-key", "model-name", null);
+
+        // Create the entity
+        OpenAiUnifiedChatCompletionRequestEntity entity = new OpenAiUnifiedChatCompletionRequestEntity(unifiedChatInput, model);
+
+        // Serialize to XContent
+        XContentBuilder builder = JsonXContent.contentBuilder();
+        entity.toXContent(builder, ToXContent.EMPTY_PARAMS);
+
+        // Convert to string and verify
+        String jsonString = Strings.toString(builder);
+        String expectedJson = """
+            {
+                "messages": [
+                    {
+                        "content": "Hello, world!",
+                        "role": "user",
+                        "tool_calls": []
+                    }
+                ],
+                "model": "model-name",
+                "n": 1,
+                "stream": true,
+                "stream_options": {
+                    "include_usage": true
+                }
+            }
+            """;
+        assertJsonEquals(jsonString, expectedJson);
+    }
+
+    // 5. Serialization with Nested Objects
+    // Test with nested objects (e.g., toolCalls, toolChoice, tool) to ensure they are correctly serialized.
+    public void testSerializationWithNestedObjects() throws IOException {
+        Random random = Randomness.get();
+
+        // Generate random values
+        String randomContent = "Hello, world! " + random.nextInt(1000);
+        String randomName = "name" + random.nextInt(1000);
+        String randomToolCallId = "tool_call_id" + random.nextInt(1000);
+        String randomArguments = "arguments" + random.nextInt(1000);
+        String randomFunctionName = "function_name" + random.nextInt(1000);
+        String randomType = "type" + random.nextInt(1000);
+        String randomModel = "model" + random.nextInt(1000);
+        String randomStop = "stop" + random.nextInt(1000);
+        float randomTemperature = (float) ((float) Math.round(0.5d + (double) random.nextFloat() * 0.5d * 100000d) / 100000d);
+        float randomTopP = (float) ((float) Math.round(0.5d + (double) random.nextFloat() * 0.5d * 100000d) / 100000d);
+
+        // Create a message with nested toolCalls
+        UnifiedCompletionRequest.Message message = new UnifiedCompletionRequest.Message(
+            new UnifiedCompletionRequest.ContentString(randomContent),
+            OpenAiUnifiedChatCompletionRequestEntity.USER_FIELD,
+            randomName,
+            randomToolCallId,
+            Collections.singletonList(
+                new UnifiedCompletionRequest.ToolCall(
+                    "id",
+                    new UnifiedCompletionRequest.ToolCall.FunctionField(randomArguments, randomFunctionName),
+                    randomType
+                )
+            )
+        );
+
+        // Create a tool with nested function fields
+        UnifiedCompletionRequest.Tool tool = new UnifiedCompletionRequest.Tool(
+            randomType,
+            new UnifiedCompletionRequest.Tool.FunctionField(
+                "Fetches the weather in the given location",
+                "get_weather",
+                createParameters(),
+                true
+            )
+        );
+        var messageList = new ArrayList<UnifiedCompletionRequest.Message>();
+        messageList.add(message);
+        // Create the unified request with nested objects
+        UnifiedCompletionRequest unifiedRequest = new UnifiedCompletionRequest(
+            messageList,
+            randomModel,
+            100L, // maxCompletionTokens
+            Collections.singletonList(randomStop),
+            randomTemperature, // temperature
+            new UnifiedCompletionRequest.ToolChoiceObject(
+                randomType,
+                new UnifiedCompletionRequest.ToolChoiceObject.FunctionField(randomFunctionName)
+            ),
+            Collections.singletonList(tool),
+            randomTopP // topP
+        );
+
+        // Create the unified chat input
+        UnifiedChatInput unifiedChatInput = new UnifiedChatInput(unifiedRequest, true);
+
+        OpenAiChatCompletionModel model = createChatCompletionModel("test-endpoint", "organizationId", "api-key", randomModel, null);
+
+        // Create the entity
+        OpenAiUnifiedChatCompletionRequestEntity entity = new OpenAiUnifiedChatCompletionRequestEntity(unifiedChatInput, model);
+
+        // Serialize to XContent
+        XContentBuilder builder = JsonXContent.contentBuilder();
+        entity.toXContent(builder, ToXContent.EMPTY_PARAMS);
+
+        // Convert to string and verify
+        String jsonString = Strings.toString(builder);
+        // Expected JSON should be dynamically generated based on random values
+        String expectedJson = String.format(
+            Locale.US,
+            """
+                {
+                    "messages": [
+                        {
+                            "content": "%s",
+                            "role": "user",
+                            "name": "%s",
+                            "tool_call_id": "%s",
+                            "tool_calls": [
+                                {
+                                    "id": "id",
+                                    "function": {
+                                        "arguments": "%s",
+                                        "name": "%s"
+                                    },
+                                    "type": "%s"
+                                }
+                            ]
+                        }
+                    ],
+                    "model": "%s",
+                    "max_completion_tokens": 100,
+                    "n": 1,
+                    "stop": ["%s"],
+                    "temperature": %.5f,
+                    "tool_choice": {
+                        "type": "%s",
+                        "function": {
+                            "name": "%s"
+                        }
+                    },
+                    "tools": [
+                        {
+                            "type": "%s",
+                            "function": {
+                                "description": "Fetches the weather in the given location",
+                                "name": "get_weather",
+                                "parameters": {
+                                    "type": "object",
+                                    "properties": {
+                                        "unit": {
+                                            "description": "The unit to return the temperature in",
+                                            "type": "string",
+                                            "enum": ["F", "C"]
+                                        },
+                                        "location": {
+                                            "description": "The location to get the weather for",
+                                            "type": "string"
+                                        }
+                                    },
+                                    "additionalProperties": false,
+                                    "required": ["location", "unit"]
+                                },
+                                "strict": true
+                            }
+                        }
+                    ],
+                    "top_p": %.5f,
+                    "stream": true,
+                    "stream_options": {
+                        "include_usage": true
+                    }
+                }
+                """,
+            randomContent,
+            randomName,
+            randomToolCallId,
+            randomArguments,
+            randomFunctionName,
+            randomType,
+            randomModel,
+            randomStop,
+            randomTemperature,
+            randomType,
+            randomFunctionName,
+            randomType,
+            randomTopP
+        );
+        assertJsonEquals(jsonString, expectedJson);
+    }
+
+    // 6. Serialization with Different Content Types
+    // Test with different content types in messages (e.g., ContentString, ContentObjects) to ensure they are correctly serialized.
+    public void testSerializationWithDifferentContentTypes() throws IOException {
+        Random random = Randomness.get();
+
+        // Generate random values for ContentString
+        String randomContentString = "Hello, world! " + random.nextInt(1000);
+
+        // Generate random values for ContentObjects
+        String randomText = "Random text " + random.nextInt(1000);
+        String randomType = "type" + random.nextInt(1000);
+        UnifiedCompletionRequest.ContentObject contentObject = new UnifiedCompletionRequest.ContentObject(randomText, randomType);
+
+        var contentObjectsList = new ArrayList<UnifiedCompletionRequest.ContentObject>();
+        contentObjectsList.add(contentObject);
+        UnifiedCompletionRequest.ContentObjects contentObjects = new UnifiedCompletionRequest.ContentObjects(contentObjectsList);
+
+        // Create messages with different content types
+        UnifiedCompletionRequest.Message messageWithString = new UnifiedCompletionRequest.Message(
+            new UnifiedCompletionRequest.ContentString(randomContentString),
+            OpenAiUnifiedChatCompletionRequestEntity.USER_FIELD,
+            null,
+            null,
+            null
+        );
+
+        UnifiedCompletionRequest.Message messageWithObjects = new UnifiedCompletionRequest.Message(
+            contentObjects,
+            OpenAiUnifiedChatCompletionRequestEntity.USER_FIELD,
+            null,
+            null,
+            null
+        );
+        var messageList = new ArrayList<UnifiedCompletionRequest.Message>();
+        messageList.add(messageWithString);
+        messageList.add(messageWithObjects);
+
+        // Create the unified request with both types of messages
+        UnifiedCompletionRequest unifiedRequest = UnifiedCompletionRequest.of(messageList);
+
+        // Create the unified chat input
+        UnifiedChatInput unifiedChatInput = new UnifiedChatInput(unifiedRequest, true);
+
+        OpenAiChatCompletionModel model = createChatCompletionModel("test-endpoint", "organizationId", "api-key", "model-name", null);
+
+        // Create the entity
+        OpenAiUnifiedChatCompletionRequestEntity entity = new OpenAiUnifiedChatCompletionRequestEntity(unifiedChatInput, model);
+
+        // Serialize to XContent
+        XContentBuilder builder = JsonXContent.contentBuilder();
+        entity.toXContent(builder, ToXContent.EMPTY_PARAMS);
+
+        // Convert to string and verify
+        String jsonString = Strings.toString(builder);
+        String expectedJson = String.format(Locale.US, """
+            {
+                "messages": [
+                    {
+                        "content": "%s",
+                        "role": "user"
+                    },
+                    {
+                        "content": [
+                            {
+                                "text": "%s",
+                                "type": "%s"
+                            }
+                        ],
+                        "role": "user"
+                    }
+                ],
+                "model": "model-name",
+                "n": 1,
+                "stream": true,
+                "stream_options": {
+                    "include_usage": true
+                }
+            }
+            """, randomContentString, randomText, randomType);
+        assertJsonEquals(jsonString, expectedJson);
+    }
+
+    // 7. Serialization with Special Characters
+    // Test with special characters in string fields to ensure they are correctly escaped and serialized.
+    public void testSerializationWithSpecialCharacters() throws IOException {
+        // Create a message with special characters
+        UnifiedCompletionRequest.Message message = new UnifiedCompletionRequest.Message(
+            new UnifiedCompletionRequest.ContentString("Hello, world! \n \"Special\" characters: \t \\ /"),
+            OpenAiUnifiedChatCompletionRequestEntity.USER_FIELD,
+            "name\nwith\nnewlines",
+            "tool_call_id\twith\ttabs",
+            Collections.singletonList(
+                new UnifiedCompletionRequest.ToolCall(
+                    "id\\with\\backslashes",
+                    new UnifiedCompletionRequest.ToolCall.FunctionField("arguments\"with\"quotes", "function_name/with/slashes"),
+                    "type"
+                )
+            )
+        );
+        var messageList = new ArrayList<UnifiedCompletionRequest.Message>();
+        messageList.add(message);
+        // Create the unified request
+        UnifiedCompletionRequest unifiedRequest = new UnifiedCompletionRequest(
+            messageList,
+            null, // model
+            null, // maxCompletionTokens
+            null, // stop
+            null, // temperature
+            null, // toolChoice
+            null, // tools
+            null  // topP
+        );
+
+        // Create the unified chat input
+        UnifiedChatInput unifiedChatInput = new UnifiedChatInput(unifiedRequest, true);
+
+        OpenAiChatCompletionModel model = createChatCompletionModel("test-endpoint", "organizationId", "api-key", "model-name", null);
+
+        // Create the entity
+        OpenAiUnifiedChatCompletionRequestEntity entity = new OpenAiUnifiedChatCompletionRequestEntity(unifiedChatInput, model);
+
+        // Serialize to XContent
+        XContentBuilder builder = JsonXContent.contentBuilder();
+        entity.toXContent(builder, ToXContent.EMPTY_PARAMS);
+
+        // Convert to string and verify
+        String jsonString = Strings.toString(builder);
+        String expectedJson = """
+            {
+                "messages": [
+                    {
+                        "content": "Hello, world! \\n \\"Special\\" characters: \\t \\\\ /",
+                        "role": "user",
+                        "name": "name\\nwith\\nnewlines",
+                        "tool_call_id": "tool_call_id\\twith\\ttabs",
+                        "tool_calls": [
+                            {
+                                "id": "id\\\\with\\\\backslashes",
+                                "function": {
+                                    "arguments": "arguments\\"with\\"quotes",
+                                    "name": "function_name/with/slashes"
+                                },
+                                "type": "type"
+                            }
+                        ]
+                    }
+                ],
+                "model": "model-name",
+                "n": 1,
+                "stream": true,
+                "stream_options": {
+                    "include_usage": true
+                }
+            }
+            """;
+        assertJsonEquals(jsonString, expectedJson);
+    }
+
+    // 8. Serialization with Boolean Fields
+    // Test with boolean fields (stream) set to both true and false to ensure they are correctly serialized.
+    public void testSerializationWithBooleanFields() throws IOException {
+        // Create a message with minimal required fields
+        UnifiedCompletionRequest.Message message = new UnifiedCompletionRequest.Message(
+            new UnifiedCompletionRequest.ContentString("Hello, world!"),
+            OpenAiUnifiedChatCompletionRequestEntity.USER_FIELD,
+            null,
+            null,
+            null
+        );
+        var messageList = new ArrayList<UnifiedCompletionRequest.Message>();
+        messageList.add(message);
+        // Create the unified request
+        UnifiedCompletionRequest unifiedRequest = new UnifiedCompletionRequest(
+            messageList,
+            null, // model
+            null, // maxCompletionTokens
+            null, // stop
+            null, // temperature
+            null, // toolChoice
+            null, // tools
+            null  // topP
+        );
+
+        OpenAiChatCompletionModel model = createChatCompletionModel("test-endpoint", "organizationId", "api-key", "model-name", null);
+
+        // Test with stream set to true
+        UnifiedChatInput unifiedChatInputTrue = new UnifiedChatInput(unifiedRequest, true);
+        OpenAiUnifiedChatCompletionRequestEntity entityTrue = new OpenAiUnifiedChatCompletionRequestEntity(unifiedChatInputTrue, model);
+
+        XContentBuilder builderTrue = JsonXContent.contentBuilder();
+        entityTrue.toXContent(builderTrue, ToXContent.EMPTY_PARAMS);
+
+        String jsonStringTrue = Strings.toString(builderTrue);
+        String expectedJsonTrue = """
+            {
+                "messages": [
+                    {
+                        "content": "Hello, world!",
+                        "role": "user"
+                    }
+                ],
+                "model": "model-name",
+                "n": 1,
+                "stream": true,
+                "stream_options": {
+                    "include_usage": true
+                }
+            }
+            """;
+        assertJsonEquals(expectedJsonTrue, jsonStringTrue);
+
+        // Test with stream set to false
+        UnifiedChatInput unifiedChatInputFalse = new UnifiedChatInput(unifiedRequest, false);
+        OpenAiUnifiedChatCompletionRequestEntity entityFalse = new OpenAiUnifiedChatCompletionRequestEntity(unifiedChatInputFalse, model);
+
+        XContentBuilder builderFalse = JsonXContent.contentBuilder();
+        entityFalse.toXContent(builderFalse, ToXContent.EMPTY_PARAMS);
+
+        String jsonStringFalse = Strings.toString(builderFalse);
+        String expectedJsonFalse = """
+            {
+                "messages": [
+                    {
+                        "content": "Hello, world!",
+                        "role": "user"
+                    }
+                ],
+                "model": "model-name",
+                "n": 1,
+                "stream": false
+            }
+            """;
+        assertJsonEquals(expectedJsonFalse, jsonStringFalse);
+    }
+
+    // 9. Serialization with Missing Required Fields
+    // Test with missing required fields to ensure appropriate exceptions are thrown.
+    public void testSerializationWithMissingRequiredFields() {
+        // Create a message with missing content (required field)
+        UnifiedCompletionRequest.Message message = new UnifiedCompletionRequest.Message(
+            null, // missing content
+            OpenAiUnifiedChatCompletionRequestEntity.USER_FIELD,
+            null,
+            null,
+            null
+        );
+        var messageList = new ArrayList<UnifiedCompletionRequest.Message>();
+        messageList.add(message);
+        // Create the unified request
+        UnifiedCompletionRequest unifiedRequest = new UnifiedCompletionRequest(
+            messageList,
+            null, // model
+            null, // maxCompletionTokens
+            null, // stop
+            null, // temperature
+            null, // toolChoice
+            null, // tools
+            null  // topP
+        );
+
+        // Create the unified chat input
+        UnifiedChatInput unifiedChatInput = new UnifiedChatInput(unifiedRequest, true);
+
+        OpenAiChatCompletionModel model = createChatCompletionModel("test-endpoint", "organizationId", "api-key", "model-name", null);
+
+        // Create the entity
+        OpenAiUnifiedChatCompletionRequestEntity entity = new OpenAiUnifiedChatCompletionRequestEntity(unifiedChatInput, model);
+
+        // Attempt to serialize to XContent and expect an exception
+        try {
+            XContentBuilder builder = JsonXContent.contentBuilder();
+            entity.toXContent(builder, ToXContent.EMPTY_PARAMS);
+            fail("Expected an exception due to missing required fields");
+        } catch (NullPointerException | IOException e) {
+            // Expected exception
+        }
+    }
+
+    // 10. Serialization with Mixed Valid and Invalid Data
+    // Test with a mix of valid and invalid data to ensure the serializer handles it gracefully.
+    public void testSerializationWithMixedValidAndInvalidData() throws IOException {
+        // Create a valid message
+        UnifiedCompletionRequest.Message validMessage = new UnifiedCompletionRequest.Message(
+            new UnifiedCompletionRequest.ContentString("Valid content"),
+            OpenAiUnifiedChatCompletionRequestEntity.USER_FIELD,
+            "validName",
+            "validToolCallId",
+            Collections.singletonList(
+                new UnifiedCompletionRequest.ToolCall(
+                    "validId",
+                    new UnifiedCompletionRequest.ToolCall.FunctionField("validArguments", "validFunctionName"),
+                    "validType"
+                )
+            )
+        );
+
+        // Create an invalid message with null content
+        UnifiedCompletionRequest.Message invalidMessage = new UnifiedCompletionRequest.Message(
+            null, // invalid content
+            OpenAiUnifiedChatCompletionRequestEntity.USER_FIELD,
+            "invalidName",
+            "invalidToolCallId",
+            Collections.singletonList(
+                new UnifiedCompletionRequest.ToolCall(
+                    "invalidId",
+                    new UnifiedCompletionRequest.ToolCall.FunctionField("invalidArguments", "invalidFunctionName"),
+                    "invalidType"
+                )
+            )
+        );
+        var messageList = new ArrayList<UnifiedCompletionRequest.Message>();
+        messageList.add(validMessage);
+        messageList.add(invalidMessage);
+        // Create the unified request with both valid and invalid messages
+        UnifiedCompletionRequest unifiedRequest = new UnifiedCompletionRequest(
+            messageList,
+            "model-name",
+            100L, // maxCompletionTokens
+            Collections.singletonList("stop"),
+            0.9f, // temperature
+            new UnifiedCompletionRequest.ToolChoiceString("tool_choice"),
+            Collections.singletonList(
+                new UnifiedCompletionRequest.Tool(
+                    "type",
+                    new UnifiedCompletionRequest.Tool.FunctionField(
+                        "Fetches the weather in the given location",
+                        "get_weather",
+                        createParameters(),
+                        true
+                    )
+                )
+            ),
+            0.8f // topP
+        );
+
+        // Create the unified chat input
+        UnifiedChatInput unifiedChatInput = new UnifiedChatInput(unifiedRequest, true);
+
+        OpenAiChatCompletionModel model = createChatCompletionModel("test-endpoint", "organizationId", "api-key", "model-name", null);
+
+        // Create the entity
+        OpenAiUnifiedChatCompletionRequestEntity entity = new OpenAiUnifiedChatCompletionRequestEntity(unifiedChatInput, model);
+
+        // Serialize to XContent and verify
+        try {
+            XContentBuilder builder = JsonXContent.contentBuilder();
+            entity.toXContent(builder, ToXContent.EMPTY_PARAMS);
+            fail("Expected an exception due to invalid data");
+        } catch (NullPointerException | IOException e) {
+            // Expected exception
+        }
+    }
+
+    public static Map<String, Object> createParameters() {
+        Map<String, Object> parameters = new LinkedHashMap<>();
+        parameters.put("type", "object");
+
+        Map<String, Object> properties = new HashMap<>();
+
+        Map<String, Object> location = new HashMap<>();
+        location.put("type", "string");
+        location.put("description", "The location to get the weather for");
+        properties.put("location", location);
+
+        Map<String, Object> unit = new HashMap<>();
+        unit.put("type", "string");
+        unit.put("description", "The unit to return the temperature in");
+        unit.put("enum", new String[] { "F", "C" });
+        properties.put("unit", unit);
+
+        parameters.put("properties", properties);
+        parameters.put("additionalProperties", false);
+        parameters.put("required", new String[] { "location", "unit" });
+
+        return parameters;
+    }
+
+    private void assertJsonEquals(String actual, String expected) throws IOException {
+        try (
+            var actualParser = createParser(JsonXContent.jsonXContent, actual);
+            var expectedParser = createParser(JsonXContent.jsonXContent, expected)
+        ) {
+            assertThat(actualParser.mapOrdered(), equalTo(expectedParser.mapOrdered()));
+        }
+    }
+
+}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiChatCompletionRequestTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiUnifiedChatCompletionRequestTests.java
similarity index 75%
rename from x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiChatCompletionRequestTests.java
rename to x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiUnifiedChatCompletionRequestTests.java
index b6ebfd02941f3..2be12c9b12e0b 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiChatCompletionRequestTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/external/request/openai/OpenAiUnifiedChatCompletionRequestTests.java
@@ -12,6 +12,7 @@
 import org.elasticsearch.core.Nullable;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.xcontent.XContentType;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 import org.elasticsearch.xpack.inference.services.openai.completion.OpenAiChatCompletionModelTests;
 
 import java.io.IOException;
@@ -20,16 +21,16 @@
 import java.util.Map;
 
 import static org.elasticsearch.xpack.inference.external.http.Utils.entityAsMap;
-import static org.elasticsearch.xpack.inference.external.request.openai.OpenAiChatCompletionRequest.buildDefaultUri;
+import static org.elasticsearch.xpack.inference.external.request.openai.OpenAiUnifiedChatCompletionRequest.buildDefaultUri;
 import static org.elasticsearch.xpack.inference.external.request.openai.OpenAiUtils.ORGANIZATION_HEADER;
 import static org.hamcrest.Matchers.aMapWithSize;
 import static org.hamcrest.Matchers.instanceOf;
 import static org.hamcrest.Matchers.is;
 
-public class OpenAiChatCompletionRequestTests extends ESTestCase {
+public class OpenAiUnifiedChatCompletionRequestTests extends ESTestCase {
 
     public void testCreateRequest_WithUrlOrganizationUserDefined() throws IOException {
-        var request = createRequest("www.google.com", "org", "secret", "abc", "model", "user");
+        var request = createRequest("www.google.com", "org", "secret", "abc", "model", "user", true);
         var httpRequest = request.createHttpRequest();
 
         assertThat(httpRequest.httpRequestBase(), instanceOf(HttpPost.class));
@@ -41,15 +42,27 @@ public void testCreateRequest_WithUrlOrganizationUserDefined() throws IOExceptio
         assertThat(httpPost.getLastHeader(ORGANIZATION_HEADER).getValue(), is("org"));
 
         var requestMap = entityAsMap(httpPost.getEntity().getContent());
-        assertThat(requestMap, aMapWithSize(4));
+        assertRequestMapWithUser(requestMap, "user");
+    }
+
+    private void assertRequestMapWithoutUser(Map<String, Object> requestMap) {
+        assertRequestMapWithUser(requestMap, null);
+    }
+
+    private void assertRequestMapWithUser(Map<String, Object> requestMap, @Nullable String user) {
+        assertThat(requestMap, aMapWithSize(user != null ? 6 : 5));
         assertThat(requestMap.get("messages"), is(List.of(Map.of("role", "user", "content", "abc"))));
         assertThat(requestMap.get("model"), is("model"));
-        assertThat(requestMap.get("user"), is("user"));
+        if (user != null) {
+            assertThat(requestMap.get("user"), is(user));
+        }
         assertThat(requestMap.get("n"), is(1));
+        assertTrue((Boolean) requestMap.get("stream"));
+        assertThat(requestMap.get("stream_options"), is(Map.of("include_usage", true)));
     }
 
     public void testCreateRequest_WithDefaultUrl() throws URISyntaxException, IOException {
-        var request = createRequest(null, "org", "secret", "abc", "model", "user");
+        var request = createRequest(null, "org", "secret", "abc", "model", "user", true);
         var httpRequest = request.createHttpRequest();
 
         assertThat(httpRequest.httpRequestBase(), instanceOf(HttpPost.class));
@@ -61,33 +74,27 @@ public void testCreateRequest_WithDefaultUrl() throws URISyntaxException, IOExce
         assertThat(httpPost.getLastHeader(ORGANIZATION_HEADER).getValue(), is("org"));
 
         var requestMap = entityAsMap(httpPost.getEntity().getContent());
-        assertThat(requestMap, aMapWithSize(4));
-        assertThat(requestMap.get("messages"), is(List.of(Map.of("role", "user", "content", "abc"))));
-        assertThat(requestMap.get("model"), is("model"));
-        assertThat(requestMap.get("user"), is("user"));
-        assertThat(requestMap.get("n"), is(1));
+        assertRequestMapWithUser(requestMap, "user");
+
     }
 
     public void testCreateRequest_WithDefaultUrlAndWithoutUserOrganization() throws URISyntaxException, IOException {
-        var request = createRequest(null, null, "secret", "abc", "model", null);
+        var request = createRequest(null, null, "secret", "abc", "model", null, true);
         var httpRequest = request.createHttpRequest();
 
         assertThat(httpRequest.httpRequestBase(), instanceOf(HttpPost.class));
         var httpPost = (HttpPost) httpRequest.httpRequestBase();
 
-        assertThat(httpPost.getURI().toString(), is(OpenAiChatCompletionRequest.buildDefaultUri().toString()));
+        assertThat(httpPost.getURI().toString(), is(OpenAiUnifiedChatCompletionRequest.buildDefaultUri().toString()));
         assertThat(httpPost.getLastHeader(HttpHeaders.CONTENT_TYPE).getValue(), is(XContentType.JSON.mediaType()));
         assertThat(httpPost.getLastHeader(HttpHeaders.AUTHORIZATION).getValue(), is("Bearer secret"));
         assertNull(httpPost.getLastHeader(ORGANIZATION_HEADER));
 
         var requestMap = entityAsMap(httpPost.getEntity().getContent());
-        assertThat(requestMap, aMapWithSize(3));
-        assertThat(requestMap.get("messages"), is(List.of(Map.of("role", "user", "content", "abc"))));
-        assertThat(requestMap.get("model"), is("model"));
-        assertThat(requestMap.get("n"), is(1));
+        assertRequestMapWithoutUser(requestMap);
     }
 
-    public void testCreateRequest_WithStreaming() throws URISyntaxException, IOException {
+    public void testCreateRequest_WithStreaming() throws IOException {
         var request = createRequest(null, null, "secret", "abc", "model", null, true);
         var httpRequest = request.createHttpRequest();
 
@@ -99,29 +106,31 @@ public void testCreateRequest_WithStreaming() throws URISyntaxException, IOExcep
     }
 
     public void testTruncate_DoesNotReduceInputTextSize() throws URISyntaxException, IOException {
-        var request = createRequest(null, null, "secret", "abcd", "model", null);
+        var request = createRequest(null, null, "secret", "abcd", "model", null, true);
         var truncatedRequest = request.truncate();
-        assertThat(request.getURI().toString(), is(OpenAiChatCompletionRequest.buildDefaultUri().toString()));
+        assertThat(request.getURI().toString(), is(OpenAiUnifiedChatCompletionRequest.buildDefaultUri().toString()));
 
         var httpRequest = truncatedRequest.createHttpRequest();
         assertThat(httpRequest.httpRequestBase(), instanceOf(HttpPost.class));
 
         var httpPost = (HttpPost) httpRequest.httpRequestBase();
         var requestMap = entityAsMap(httpPost.getEntity().getContent());
-        assertThat(requestMap, aMapWithSize(3));
+        assertThat(requestMap, aMapWithSize(5));
 
         // We do not truncate for OpenAi chat completions
         assertThat(requestMap.get("messages"), is(List.of(Map.of("role", "user", "content", "abcd"))));
         assertThat(requestMap.get("model"), is("model"));
         assertThat(requestMap.get("n"), is(1));
+        assertTrue((Boolean) requestMap.get("stream"));
+        assertThat(requestMap.get("stream_options"), is(Map.of("include_usage", true)));
     }
 
     public void testTruncationInfo_ReturnsNull() {
-        var request = createRequest(null, null, "secret", "abcd", "model", null);
+        var request = createRequest(null, null, "secret", "abcd", "model", null, true);
         assertNull(request.getTruncationInfo());
     }
 
-    public static OpenAiChatCompletionRequest createRequest(
+    public static OpenAiUnifiedChatCompletionRequest createRequest(
         @Nullable String url,
         @Nullable String org,
         String apiKey,
@@ -132,7 +141,7 @@ public static OpenAiChatCompletionRequest createRequest(
         return createRequest(url, org, apiKey, input, model, user, false);
     }
 
-    public static OpenAiChatCompletionRequest createRequest(
+    public static OpenAiUnifiedChatCompletionRequest createRequest(
         @Nullable String url,
         @Nullable String org,
         String apiKey,
@@ -142,7 +151,7 @@ public static OpenAiChatCompletionRequest createRequest(
         boolean stream
     ) {
         var chatCompletionModel = OpenAiChatCompletionModelTests.createChatCompletionModel(url, org, apiKey, model, user);
-        return new OpenAiChatCompletionRequest(List.of(input), chatCompletionModel, stream);
+        return new OpenAiUnifiedChatCompletionRequest(new UnifiedChatInput(List.of(input), "user", stream), chatCompletionModel);
     }
 
 }
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rest/BaseInferenceActionTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rest/BaseInferenceActionTests.java
index 05a8d52be5df4..5528c80066b0a 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rest/BaseInferenceActionTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rest/BaseInferenceActionTests.java
@@ -8,11 +8,14 @@
 package org.elasticsearch.xpack.inference.rest;
 
 import org.apache.lucene.util.SetOnce;
+import org.elasticsearch.ElasticsearchStatusException;
 import org.elasticsearch.action.ActionListener;
 import org.elasticsearch.common.bytes.BytesArray;
 import org.elasticsearch.core.TimeValue;
+import org.elasticsearch.inference.TaskType;
 import org.elasticsearch.rest.RestChannel;
 import org.elasticsearch.rest.RestRequest;
+import org.elasticsearch.rest.RestRequestTests;
 import org.elasticsearch.rest.action.RestChunkedToXContentListener;
 import org.elasticsearch.test.rest.FakeRestRequest;
 import org.elasticsearch.test.rest.RestActionTestCase;
@@ -26,6 +29,10 @@
 import java.util.Map;
 
 import static org.elasticsearch.rest.RestRequest.Method.POST;
+import static org.elasticsearch.xpack.inference.rest.BaseInferenceAction.parseParams;
+import static org.elasticsearch.xpack.inference.rest.BaseInferenceAction.parseTimeout;
+import static org.elasticsearch.xpack.inference.rest.Paths.INFERENCE_ID;
+import static org.elasticsearch.xpack.inference.rest.Paths.TASK_TYPE_OR_INFERENCE_ID;
 import static org.hamcrest.CoreMatchers.is;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.instanceOf;
@@ -56,6 +63,42 @@ private static String route(String param) {
         return "_route/" + param;
     }
 
+    public void testParseParams_ExtractsInferenceIdAndTaskType() {
+        var params = parseParams(
+            RestRequestTests.contentRestRequest("{}", Map.of(INFERENCE_ID, "id", TASK_TYPE_OR_INFERENCE_ID, TaskType.COMPLETION.toString()))
+        );
+        assertThat(params, is(new BaseInferenceAction.Params("id", TaskType.COMPLETION)));
+    }
+
+    public void testParseParams_DefaultsToTaskTypeAny_WhenInferenceId_IsMissing() {
+        var params = parseParams(
+            RestRequestTests.contentRestRequest("{}", Map.of(TASK_TYPE_OR_INFERENCE_ID, TaskType.COMPLETION.toString()))
+        );
+        assertThat(params, is(new BaseInferenceAction.Params("completion", TaskType.ANY)));
+    }
+
+    public void testParseParams_ThrowsStatusException_WhenTaskTypeIsMissing() {
+        var e = expectThrows(
+            ElasticsearchStatusException.class,
+            () -> parseParams(RestRequestTests.contentRestRequest("{}", Map.of(INFERENCE_ID, "id")))
+        );
+        assertThat(e.getMessage(), is("Task type must not be null"));
+    }
+
+    public void testParseTimeout_ReturnsTimeout() {
+        var timeout = parseTimeout(
+            RestRequestTests.contentRestRequest("{}", Map.of(InferenceAction.Request.TIMEOUT.getPreferredName(), "4s"))
+        );
+
+        assertThat(timeout, is(TimeValue.timeValueSeconds(4)));
+    }
+
+    public void testParseTimeout_ReturnsDefaultTimeout() {
+        var timeout = parseTimeout(RestRequestTests.contentRestRequest("{}", Map.of()));
+
+        assertThat(timeout, is(TimeValue.timeValueSeconds(30)));
+    }
+
     public void testUsesDefaultTimeout() {
         SetOnce<Boolean> executeCalled = new SetOnce<>();
         verifyingClient.setExecuteVerifier(((actionType, actionRequest) -> {
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rest/RestUnifiedCompletionInferenceActionTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rest/RestUnifiedCompletionInferenceActionTests.java
new file mode 100644
index 0000000000000..5acfe67b175df
--- /dev/null
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/rest/RestUnifiedCompletionInferenceActionTests.java
@@ -0,0 +1,81 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.inference.rest;
+
+import org.apache.lucene.util.SetOnce;
+import org.elasticsearch.common.bytes.BytesArray;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.util.concurrent.ThreadContext;
+import org.elasticsearch.rest.AbstractRestChannel;
+import org.elasticsearch.rest.RestChannel;
+import org.elasticsearch.rest.RestRequest;
+import org.elasticsearch.rest.RestResponse;
+import org.elasticsearch.test.rest.FakeRestRequest;
+import org.elasticsearch.test.rest.RestActionTestCase;
+import org.elasticsearch.xcontent.XContentType;
+import org.elasticsearch.xpack.core.inference.action.UnifiedCompletionAction;
+import org.junit.Before;
+
+import static org.elasticsearch.xpack.inference.rest.BaseInferenceActionTests.createResponse;
+import static org.hamcrest.CoreMatchers.is;
+import static org.hamcrest.Matchers.equalTo;
+import static org.hamcrest.Matchers.instanceOf;
+
+public class RestUnifiedCompletionInferenceActionTests extends RestActionTestCase {
+
+    @Before
+    public void setUpAction() {
+        controller().registerHandler(new RestUnifiedCompletionInferenceAction());
+    }
+
+    public void testStreamIsTrue() {
+        SetOnce<Boolean> executeCalled = new SetOnce<>();
+        verifyingClient.setExecuteVerifier(((actionType, actionRequest) -> {
+            assertThat(actionRequest, instanceOf(UnifiedCompletionAction.Request.class));
+
+            var request = (UnifiedCompletionAction.Request) actionRequest;
+            assertThat(request.isStreaming(), is(true));
+
+            executeCalled.set(true);
+            return createResponse();
+        }));
+
+        var requestBody = """
+            {
+              "messages": [
+                {
+                  "content": "abc",
+                  "role": "user"
+                }
+              ]
+            }
+            """;
+
+        RestRequest inferenceRequest = new FakeRestRequest.Builder(xContentRegistry()).withMethod(RestRequest.Method.POST)
+            .withPath("_inference/completion/test/_unified")
+            .withContent(new BytesArray(requestBody), XContentType.JSON)
+            .build();
+
+        final SetOnce<RestResponse> responseSetOnce = new SetOnce<>();
+        dispatchRequest(inferenceRequest, new AbstractRestChannel(inferenceRequest, true) {
+            @Override
+            public void sendResponse(RestResponse response) {
+                responseSetOnce.set(response);
+            }
+        });
+
+        // the response content will be null when there is no error
+        assertNull(responseSetOnce.get().content());
+        assertThat(executeCalled.get(), equalTo(true));
+    }
+
+    private void dispatchRequest(final RestRequest request, final RestChannel channel) {
+        ThreadContext threadContext = new ThreadContext(Settings.EMPTY);
+        controller().dispatchRequest(request, channel, threadContext);
+    }
+}
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/SenderServiceTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/SenderServiceTests.java
index 47a96bf78dda1..6768583598b2d 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/SenderServiceTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/SenderServiceTests.java
@@ -26,6 +26,7 @@
 import org.elasticsearch.xpack.inference.external.http.sender.HttpRequestSender;
 import org.elasticsearch.xpack.inference.external.http.sender.InferenceInputs;
 import org.elasticsearch.xpack.inference.external.http.sender.Sender;
+import org.elasticsearch.xpack.inference.external.http.sender.UnifiedChatInput;
 import org.junit.After;
 import org.junit.Before;
 
@@ -119,6 +120,14 @@ protected void doInfer(
 
         }
 
+        @Override
+        protected void doUnifiedCompletionInfer(
+            Model model,
+            UnifiedChatInput inputs,
+            TimeValue timeout,
+            ActionListener<InferenceServiceResults> listener
+        ) {}
+
         @Override
         protected void doChunkedInfer(
             Model model,
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/openai/OpenAiServiceTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/openai/OpenAiServiceTests.java
index 76b5d6fee2c59..159b77789482d 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/openai/OpenAiServiceTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/openai/OpenAiServiceTests.java
@@ -27,6 +27,7 @@
 import org.elasticsearch.inference.Model;
 import org.elasticsearch.inference.SimilarityMeasure;
 import org.elasticsearch.inference.TaskType;
+import org.elasticsearch.inference.UnifiedCompletionRequest;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.http.MockResponse;
 import org.elasticsearch.test.http.MockWebServer;
@@ -920,6 +921,68 @@ public void testInfer_SendsRequest() throws IOException {
         }
     }
 
+    public void testUnifiedCompletionInfer() throws Exception {
+        // The escapes are because the streaming response must be on a single line
+        String responseJson = """
+            data: {\
+                "id":"12345",\
+                "object":"chat.completion.chunk",\
+                "created":123456789,\
+                "model":"gpt-4o-mini",\
+                "system_fingerprint": "123456789",\
+                "choices":[\
+                    {\
+                        "index":0,\
+                        "delta":{\
+                            "content":"hello, world"\
+                        },\
+                        "logprobs":null,\
+                        "finish_reason":"stop"\
+                    }\
+                ],\
+                "usage":{\
+                    "prompt_tokens": 16,\
+                    "completion_tokens": 28,\
+                    "total_tokens": 44,\
+                    "prompt_tokens_details": {\
+                        "cached_tokens": 0,\
+                        "audio_tokens": 0\
+                    },\
+                    "completion_tokens_details": {\
+                        "reasoning_tokens": 0,\
+                        "audio_tokens": 0,\
+                        "accepted_prediction_tokens": 0,\
+                        "rejected_prediction_tokens": 0\
+                    }\
+                }\
+            }
+
+            """;
+        webServer.enqueue(new MockResponse().setResponseCode(200).setBody(responseJson));
+
+        var senderFactory = HttpRequestSenderTests.createSenderFactory(threadPool, clientManager);
+        try (var service = new OpenAiService(senderFactory, createWithEmptySettings(threadPool))) {
+            var model = OpenAiChatCompletionModelTests.createChatCompletionModel(getUrl(webServer), "org", "secret", "model", "user");
+            PlainActionFuture<InferenceServiceResults> listener = new PlainActionFuture<>();
+            service.unifiedCompletionInfer(
+                model,
+                UnifiedCompletionRequest.of(
+                    List.of(
+                        new UnifiedCompletionRequest.Message(new UnifiedCompletionRequest.ContentString("hello"), "user", null, null, null)
+                    )
+                ),
+                InferenceAction.Request.DEFAULT_TIMEOUT,
+                listener
+            );
+
+            var result = listener.actionGet(TIMEOUT);
+            InferenceEventsAssertion.assertThat(result).hasFinishedStream().hasNoErrors().hasEvent("""
+                {"id":"12345","choices":[{"delta":{"content":"hello, world"},"finish_reason":"stop","index":0}],""" + """
+                "model":"gpt-4o-mini","object":"chat.completion.chunk",""" + """
+                "usage":{"completion_tokens":28,"prompt_tokens":16,"total_tokens":44}}""");
+        }
+    }
+
     public void testInfer_StreamRequest() throws Exception {
         String responseJson = """
             data: {\
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/openai/completion/OpenAiChatCompletionModelTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/openai/completion/OpenAiChatCompletionModelTests.java
index ab1786f0a5843..e7ac4cf879e92 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/openai/completion/OpenAiChatCompletionModelTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/openai/completion/OpenAiChatCompletionModelTests.java
@@ -10,9 +10,11 @@
 import org.elasticsearch.common.settings.SecureString;
 import org.elasticsearch.core.Nullable;
 import org.elasticsearch.inference.TaskType;
+import org.elasticsearch.inference.UnifiedCompletionRequest;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.xpack.inference.services.settings.DefaultSecretSettings;
 
+import java.util.List;
 import java.util.Map;
 
 import static org.elasticsearch.xpack.inference.services.openai.completion.OpenAiChatCompletionRequestTaskSettingsTests.getChatCompletionRequestTaskSettingsMap;
@@ -42,10 +44,48 @@ public void testOverrideWith_EmptyMap() {
     public void testOverrideWith_NullMap() {
         var model = createChatCompletionModel("url", "org", "api_key", "model_name", null);
 
-        var overriddenModel = OpenAiChatCompletionModel.of(model, null);
+        var overriddenModel = OpenAiChatCompletionModel.of(model, (Map<String, Object>) null);
         assertThat(overriddenModel, sameInstance(model));
     }
 
+    public void testOverrideWith_UnifiedCompletionRequest_OverridesModelId() {
+        var model = createChatCompletionModel("url", "org", "api_key", "model_name", "user");
+        var request = new UnifiedCompletionRequest(
+            List.of(new UnifiedCompletionRequest.Message(new UnifiedCompletionRequest.ContentString("hello"), "role", null, null, null)),
+            "different_model",
+            null,
+            null,
+            null,
+            null,
+            null,
+            null
+        );
+
+        assertThat(
+            OpenAiChatCompletionModel.of(model, request),
+            is(createChatCompletionModel("url", "org", "api_key", "different_model", "user"))
+        );
+    }
+
+    public void testOverrideWith_UnifiedCompletionRequest_UsesModelFields_WhenRequestDoesNotOverride() {
+        var model = createChatCompletionModel("url", "org", "api_key", "model_name", "user");
+        var request = new UnifiedCompletionRequest(
+            List.of(new UnifiedCompletionRequest.Message(new UnifiedCompletionRequest.ContentString("hello"), "role", null, null, null)),
+            null, // not overriding model
+            null,
+            null,
+            null,
+            null,
+            null,
+            null
+        );
+
+        assertThat(
+            OpenAiChatCompletionModel.of(model, request),
+            is(createChatCompletionModel("url", "org", "api_key", "model_name", "user"))
+        );
+    }
+
     public static OpenAiChatCompletionModel createChatCompletionModel(
         String url,
         @Nullable String org,
diff --git a/x-pack/plugin/security/qa/operator-privileges-tests/src/javaRestTest/java/org/elasticsearch/xpack/security/operator/Constants.java b/x-pack/plugin/security/qa/operator-privileges-tests/src/javaRestTest/java/org/elasticsearch/xpack/security/operator/Constants.java
index 8df10037affdb..c91314716cf9e 100644
--- a/x-pack/plugin/security/qa/operator-privileges-tests/src/javaRestTest/java/org/elasticsearch/xpack/security/operator/Constants.java
+++ b/x-pack/plugin/security/qa/operator-privileges-tests/src/javaRestTest/java/org/elasticsearch/xpack/security/operator/Constants.java
@@ -386,6 +386,7 @@ public class Constants {
         "cluster:monitor/xpack/esql/stats/dist",
         "cluster:monitor/xpack/inference",
         "cluster:monitor/xpack/inference/get",
+        "cluster:monitor/xpack/inference/unified",
         "cluster:monitor/xpack/inference/diagnostics/get",
         "cluster:monitor/xpack/inference/services/get",
         "cluster:monitor/xpack/info",

From 4df28327efddc8864590d33eb68105146b8b7754 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Sat, 7 Dec 2024 07:55:27 +1100
Subject: [PATCH 096/119] Mute
 org.elasticsearch.xpack.esql.action.EsqlActionTaskIT
 testCancelRequestWhenFailingFetchingPages #118193

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index a39265756599d..4431d3661eb01 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -263,6 +263,9 @@ tests:
 - class: org.elasticsearch.xpack.inference.DefaultEndPointsIT
   method: testInferDeploysDefaultRerank
   issue: https://github.com/elastic/elasticsearch/issues/118184
+- class: org.elasticsearch.xpack.esql.action.EsqlActionTaskIT
+  method: testCancelRequestWhenFailingFetchingPages
+  issue: https://github.com/elastic/elasticsearch/issues/118193
 
 # Examples:
 #

From c9feb7690bfe880784406d4ad32ca7d1547d8cfe Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Sat, 7 Dec 2024 08:17:11 +1100
Subject: [PATCH 097/119] Mute
 org.elasticsearch.packaging.test.MemoryLockingTests
 test20MemoryLockingEnabled #118195

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 4431d3661eb01..22a53673dcb34 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -266,6 +266,9 @@ tests:
 - class: org.elasticsearch.xpack.esql.action.EsqlActionTaskIT
   method: testCancelRequestWhenFailingFetchingPages
   issue: https://github.com/elastic/elasticsearch/issues/118193
+- class: org.elasticsearch.packaging.test.MemoryLockingTests
+  method: test20MemoryLockingEnabled
+  issue: https://github.com/elastic/elasticsearch/issues/118195
 
 # Examples:
 #

From 287ed8a1c177a98e7397463e9a02794fed8b2761 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Sat, 7 Dec 2024 08:17:26 +1100
Subject: [PATCH 098/119] Mute org.elasticsearch.packaging.test.ArchiveTests
 test42AutoconfigurationNotTriggeredWhenNodeCannotBecomeMaster #118196

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 22a53673dcb34..7c5df966e6bd6 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -269,6 +269,9 @@ tests:
 - class: org.elasticsearch.packaging.test.MemoryLockingTests
   method: test20MemoryLockingEnabled
   issue: https://github.com/elastic/elasticsearch/issues/118195
+- class: org.elasticsearch.packaging.test.ArchiveTests
+  method: test42AutoconfigurationNotTriggeredWhenNodeCannotBecomeMaster
+  issue: https://github.com/elastic/elasticsearch/issues/118196
 
 # Examples:
 #

From 05eee61038693a11ed8fc8ea5c5a66d460d5c0cf Mon Sep 17 00:00:00 2001
From: Kazuma Arimura <k.arimura96@gmail.com>
Date: Sat, 7 Dec 2024 02:00:03 +0000
Subject: [PATCH 099/119] add documentation for kuromoji_completion (#117808)

---
 docs/plugins/analysis-kuromoji.asciidoc | 36 +++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/docs/plugins/analysis-kuromoji.asciidoc b/docs/plugins/analysis-kuromoji.asciidoc
index 0a167bf3f0240..217d88f361223 100644
--- a/docs/plugins/analysis-kuromoji.asciidoc
+++ b/docs/plugins/analysis-kuromoji.asciidoc
@@ -750,3 +750,39 @@ Which results in:
   ]
 }
 --------------------------------------------------
+
+[[analysis-kuromoji-completion]]
+==== `kuromoji_completion` token filter
+
+The `kuromoji_completion` token filter adds Japanese romanized tokens to the term attributes along with the original tokens (surface forms).
+
+[source,console]
+--------------------------------------------------
+GET _analyze
+{
+  "analyzer": "kuromoji_completion",
+  "text": "寿司" <1>
+}
+--------------------------------------------------
+
+<1> Returns `寿司`, `susi` (Kunrei-shiki) and `sushi` (Hepburn-shiki).
+
+The `kuromoji_completion` token filter accepts the following settings:
+
+`mode`::
++
+--
+
+The tokenization mode determines how the tokenizer handles compound and
+unknown words. It can be set to:
+
+`index`::
+
+    Simple romanization. Expected to be used when indexing.
+
+`query`::
+
+    Input Method aware romanization. Expected to be used when querying.
+
+Defaults to `index`.
+--

From 39c7e0bc2fa6345cde605257c80182a83c2cc951 Mon Sep 17 00:00:00 2001
From: Ryan Ernst <ryan@iernst.net>
Date: Fri, 6 Dec 2024 18:24:08 -0800
Subject: [PATCH 100/119] Always write unicast hosts file in tests (#118121)

This commit adds the ability to restart a node within a test cluster.
The newly started node uses the same configuration and directories.
Since we use ephemeral ports, the unicast hosts list is rewritten for
all nodes once the restarted node comes back up.
---
 .../test/cluster/local/DefaultLocalClusterHandle.java     | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/test/test-clusters/src/main/java/org/elasticsearch/test/cluster/local/DefaultLocalClusterHandle.java b/test/test-clusters/src/main/java/org/elasticsearch/test/cluster/local/DefaultLocalClusterHandle.java
index eb45aacda68da..13adde1da8a69 100644
--- a/test/test-clusters/src/main/java/org/elasticsearch/test/cluster/local/DefaultLocalClusterHandle.java
+++ b/test/test-clusters/src/main/java/org/elasticsearch/test/cluster/local/DefaultLocalClusterHandle.java
@@ -176,8 +176,9 @@ public long getPid(int index) {
         return nodes.get(index).getPid();
     }
 
+    @Override
     public void stopNode(int index, boolean forcibly) {
-        nodes.get(index).stop(false);
+        nodes.get(index).stop(forcibly);
     }
 
     @Override
@@ -252,9 +253,8 @@ private void writeUnicastHostsFile() {
         execute(() -> nodes.parallelStream().forEach(node -> {
             try {
                 Path hostsFile = node.getWorkingDir().resolve("config").resolve("unicast_hosts.txt");
-                if (Files.notExists(hostsFile)) {
-                    Files.writeString(hostsFile, transportUris);
-                }
+                LOGGER.info("Writing unicast hosts file {} for node {}", hostsFile, node.getName());
+                Files.writeString(hostsFile, transportUris);
             } catch (IOException e) {
                 throw new UncheckedIOException("Failed to write unicast_hosts for: " + node, e);
             }

From bc0b77e147e2baa84f9d920c1f9604211f6e3ab8 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Sat, 7 Dec 2024 16:17:38 +1100
Subject: [PATCH 101/119] Mute org.elasticsearch.packaging.test.ArchiveTests
 test43AutoconfigurationNotTriggeredWhenTlsAlreadyConfigured #118202

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 7c5df966e6bd6..05f6e0b57415d 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -272,6 +272,9 @@ tests:
 - class: org.elasticsearch.packaging.test.ArchiveTests
   method: test42AutoconfigurationNotTriggeredWhenNodeCannotBecomeMaster
   issue: https://github.com/elastic/elasticsearch/issues/118196
+- class: org.elasticsearch.packaging.test.ArchiveTests
+  method: test43AutoconfigurationNotTriggeredWhenTlsAlreadyConfigured
+  issue: https://github.com/elastic/elasticsearch/issues/118202
 
 # Examples:
 #

From 2005e2eec1f53c26b53fcafb58e312fe10b5aae4 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Sun, 8 Dec 2024 00:16:15 +1100
Subject: [PATCH 102/119] Mute org.elasticsearch.packaging.test.ArchiveTests
 test44AutoConfigurationNotTriggeredOnNotWriteableConfDir #118208

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 05f6e0b57415d..5914978cba076 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -275,6 +275,9 @@ tests:
 - class: org.elasticsearch.packaging.test.ArchiveTests
   method: test43AutoconfigurationNotTriggeredWhenTlsAlreadyConfigured
   issue: https://github.com/elastic/elasticsearch/issues/118202
+- class: org.elasticsearch.packaging.test.ArchiveTests
+  method: test44AutoConfigurationNotTriggeredOnNotWriteableConfDir
+  issue: https://github.com/elastic/elasticsearch/issues/118208
 
 # Examples:
 #

From eb0a21efd8946df04a3f6f0457bb0a1b73b50bf0 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Sat, 7 Dec 2024 15:13:56 +0100
Subject: [PATCH 103/119] Speedup OsStats initialization (#118141)

Similar to other OS/FS type stats we can optimize here. Found this
as a slowdown when profiling tests in a loop during test fixing.
This helps node startup and maybe more importantly test performance.
No need to initialize the stats eagerly when we can just get them
as we load them the first time.
---
 .../elasticsearch/monitor/os/OsService.java   | 28 +++++++++++++------
 1 file changed, 20 insertions(+), 8 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/monitor/os/OsService.java b/server/src/main/java/org/elasticsearch/monitor/os/OsService.java
index 7609cc14c6b3b..ceed2b0e41fc1 100644
--- a/server/src/main/java/org/elasticsearch/monitor/os/OsService.java
+++ b/server/src/main/java/org/elasticsearch/monitor/os/OsService.java
@@ -25,7 +25,6 @@ public class OsService implements ReportingService<OsInfo> {
 
     private static final Logger logger = LogManager.getLogger(OsService.class);
 
-    private final OsProbe probe;
     private final OsInfo info;
     private final SingleObjectCache<OsStats> osStatsCache;
 
@@ -37,10 +36,9 @@ public class OsService implements ReportingService<OsInfo> {
     );
 
     public OsService(Settings settings) throws IOException {
-        this.probe = OsProbe.getInstance();
         TimeValue refreshInterval = REFRESH_INTERVAL_SETTING.get(settings);
-        this.info = probe.osInfo(refreshInterval.millis(), EsExecutors.nodeProcessors(settings));
-        this.osStatsCache = new OsStatsCache(refreshInterval, probe.osStats());
+        this.info = OsProbe.getInstance().osInfo(refreshInterval.millis(), EsExecutors.nodeProcessors(settings));
+        this.osStatsCache = new OsStatsCache(refreshInterval);
         logger.debug("using refresh_interval [{}]", refreshInterval);
     }
 
@@ -53,14 +51,28 @@ public OsStats stats() {
         return osStatsCache.getOrRefresh();
     }
 
-    private class OsStatsCache extends SingleObjectCache<OsStats> {
-        OsStatsCache(TimeValue interval, OsStats initValue) {
-            super(interval, initValue);
+    private static class OsStatsCache extends SingleObjectCache<OsStats> {
+
+        private static final OsStats MISSING = new OsStats(
+            0L,
+            new OsStats.Cpu((short) 0, new double[0]),
+            new OsStats.Mem(0, 0, 0),
+            new OsStats.Swap(0, 0),
+            null
+        );
+
+        OsStatsCache(TimeValue interval) {
+            super(interval, MISSING);
         }
 
         @Override
         protected OsStats refresh() {
-            return probe.osStats();
+            return OsProbe.getInstance().osStats();
+        }
+
+        @Override
+        protected boolean needsRefresh() {
+            return getNoRefresh() == MISSING || super.needsRefresh();
         }
     }
 }

From 230b283beaff21c331c3da9c31d29211e6392d75 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Sun, 8 Dec 2024 08:15:30 +1100
Subject: [PATCH 104/119] Mute org.elasticsearch.packaging.test.ArchiveTests
 test51AutoConfigurationWithPasswordProtectedKeystore #118212

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 5914978cba076..273094134fa2b 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -278,6 +278,9 @@ tests:
 - class: org.elasticsearch.packaging.test.ArchiveTests
   method: test44AutoConfigurationNotTriggeredOnNotWriteableConfDir
   issue: https://github.com/elastic/elasticsearch/issues/118208
+- class: org.elasticsearch.packaging.test.ArchiveTests
+  method: test51AutoConfigurationWithPasswordProtectedKeystore
+  issue: https://github.com/elastic/elasticsearch/issues/118212
 
 # Examples:
 #

From 9071e80a923690dcb37369849450da6deb38f95f Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Sun, 8 Dec 2024 08:55:27 +1100
Subject: [PATCH 105/119] Mute
 org.elasticsearch.xpack.inference.InferenceCrudIT
 testUnifiedCompletionInference #118210

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 273094134fa2b..29621676fa836 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -281,6 +281,9 @@ tests:
 - class: org.elasticsearch.packaging.test.ArchiveTests
   method: test51AutoConfigurationWithPasswordProtectedKeystore
   issue: https://github.com/elastic/elasticsearch/issues/118212
+- class: org.elasticsearch.xpack.inference.InferenceCrudIT
+  method: testUnifiedCompletionInference
+  issue: https://github.com/elastic/elasticsearch/issues/118210
 
 # Examples:
 #

From 92e0f972fb1795fb8c7e96c0b60aa6f2f2405b83 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Sun, 8 Dec 2024 16:25:11 +1100
Subject: [PATCH 106/119] Mute
 org.elasticsearch.ingest.common.IngestCommonClientYamlTestSuiteIT
 org.elasticsearch.ingest.common.IngestCommonClientYamlTestSuiteIT #118215

---
 muted-tests.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 29621676fa836..e00bcb068ac26 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -284,6 +284,8 @@ tests:
 - class: org.elasticsearch.xpack.inference.InferenceCrudIT
   method: testUnifiedCompletionInference
   issue: https://github.com/elastic/elasticsearch/issues/118210
+- class: org.elasticsearch.ingest.common.IngestCommonClientYamlTestSuiteIT
+  issue: https://github.com/elastic/elasticsearch/issues/118215
 
 # Examples:
 #

From 2b0bf196be87bc2b10580f2d89b971b82927cdd6 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Sun, 8 Dec 2024 16:59:40 +1100
Subject: [PATCH 107/119] Mute
 org.elasticsearch.datastreams.DataStreamsClientYamlTestSuiteIT test
 {p0=data_stream/120_data_streams_stats/Multiple data stream} #118217

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index e00bcb068ac26..3977b63224f24 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -286,6 +286,9 @@ tests:
   issue: https://github.com/elastic/elasticsearch/issues/118210
 - class: org.elasticsearch.ingest.common.IngestCommonClientYamlTestSuiteIT
   issue: https://github.com/elastic/elasticsearch/issues/118215
+- class: org.elasticsearch.datastreams.DataStreamsClientYamlTestSuiteIT
+  method: test {p0=data_stream/120_data_streams_stats/Multiple data stream}
+  issue: https://github.com/elastic/elasticsearch/issues/118217
 
 # Examples:
 #

From 4a8a8a0bfe337aff50774c2c398060399a4d93e5 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Sun, 8 Dec 2024 18:18:14 +1100
Subject: [PATCH 108/119] Mute
 org.elasticsearch.xpack.security.operator.OperatorPrivilegesIT
 testEveryActionIsEitherOperatorOnlyOrNonOperator #118220

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index 3977b63224f24..bfcac3a02b163 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -289,6 +289,9 @@ tests:
 - class: org.elasticsearch.datastreams.DataStreamsClientYamlTestSuiteIT
   method: test {p0=data_stream/120_data_streams_stats/Multiple data stream}
   issue: https://github.com/elastic/elasticsearch/issues/118217
+- class: org.elasticsearch.xpack.security.operator.OperatorPrivilegesIT
+  method: testEveryActionIsEitherOperatorOnlyOrNonOperator
+  issue: https://github.com/elastic/elasticsearch/issues/118220
 
 # Examples:
 #

From c09c4f427709f2a4373372f42f74abb556273c57 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Mon, 9 Dec 2024 08:27:23 +1100
Subject: [PATCH 109/119] Mute
 org.elasticsearch.validation.DotPrefixClientYamlTestSuiteIT
 org.elasticsearch.validation.DotPrefixClientYamlTestSuiteIT #118224

---
 muted-tests.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index bfcac3a02b163..a367234691895 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -292,6 +292,8 @@ tests:
 - class: org.elasticsearch.xpack.security.operator.OperatorPrivilegesIT
   method: testEveryActionIsEitherOperatorOnlyOrNonOperator
   issue: https://github.com/elastic/elasticsearch/issues/118220
+- class: org.elasticsearch.validation.DotPrefixClientYamlTestSuiteIT
+  issue: https://github.com/elastic/elasticsearch/issues/118224
 
 # Examples:
 #

From 8107cc9e5e234447db9132068973c135fec2ff36 Mon Sep 17 00:00:00 2001
From: Keith Massey <keith.massey@elastic.co>
Date: Sun, 8 Dec 2024 17:56:09 -0600
Subject: [PATCH 110/119] Adding reindex data stream rest action (#118109)

* Adding a _migration/reindex endpoint

* Adding rest api spec and test

* Adding a feature flag for reindex data streams

* updating json spec

* fixing a typo

* Changing mode to an enum

* Moving ParseFields into public static finals

* Commenting out test that leaves task running, until we add a cancel API

* Removing persistent task id from output

* replacing a string with a variable
---
 .../rest-api-spec/api/migrate.reindex.json    |  29 +++++
 .../ReindexDataStreamTransportActionIT.java   |  10 +-
 .../xpack/migrate/MigratePlugin.java          | 102 +++++++++++++-----
 .../action/ReindexDataStreamAction.java       |  89 +++++++++++++--
 .../rest/RestMigrationReindexAction.java      |  64 +++++++++++
 .../action/ReindexDataStreamRequestTests.java |  39 +++++++
 .../ReindexDataStreamResponseTests.java       |   2 +-
 .../rest-api-spec/test/migrate/10_reindex.yml |  89 +++++++++++++++
 8 files changed, 387 insertions(+), 37 deletions(-)
 create mode 100644 rest-api-spec/src/main/resources/rest-api-spec/api/migrate.reindex.json
 create mode 100644 x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/rest/RestMigrationReindexAction.java
 create mode 100644 x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamRequestTests.java
 create mode 100644 x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/migrate/10_reindex.yml

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/migrate.reindex.json b/rest-api-spec/src/main/resources/rest-api-spec/api/migrate.reindex.json
new file mode 100644
index 0000000000000..149a90bc198b0
--- /dev/null
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/migrate.reindex.json
@@ -0,0 +1,29 @@
+{
+  "migrate.reindex":{
+    "documentation":{
+      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex.html",
+      "description":"This API reindexes all legacy backing indices for a data stream. It does this in a persistent task. The persistent task id is returned immediately, and the reindexing work is completed in that task"
+    },
+    "stability":"experimental",
+    "visibility":"private",
+    "headers":{
+      "accept": [ "application/json"],
+      "content_type": ["application/json"]
+    },
+    "url":{
+      "paths":[
+        {
+          "path":"/_migration/reindex",
+          "methods":[
+            "POST"
+          ]
+        }
+      ]
+    },
+    "body":{
+      "description":"The body contains the fields `mode` and `source.index, where the only mode currently supported is `upgrade`, and the `source.index` must be a data stream name",
+      "required":true
+    }
+  }
+}
+
diff --git a/x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamTransportActionIT.java b/x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamTransportActionIT.java
index 3b68fc9995b57..62716e11f1720 100644
--- a/x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamTransportActionIT.java
+++ b/x-pack/plugin/migrate/src/internalClusterTest/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamTransportActionIT.java
@@ -51,7 +51,10 @@ protected Collection<Class<? extends Plugin>> nodePlugins() {
 
     public void testNonExistentDataStream() {
         String nonExistentDataStreamName = randomAlphaOfLength(50);
-        ReindexDataStreamRequest reindexDataStreamRequest = new ReindexDataStreamRequest(nonExistentDataStreamName);
+        ReindexDataStreamRequest reindexDataStreamRequest = new ReindexDataStreamRequest(
+            ReindexDataStreamAction.Mode.UPGRADE,
+            nonExistentDataStreamName
+        );
         assertThrows(
             ResourceNotFoundException.class,
             () -> client().execute(new ActionType<ReindexDataStreamResponse>(ReindexDataStreamAction.NAME), reindexDataStreamRequest)
@@ -61,7 +64,10 @@ public void testNonExistentDataStream() {
 
     public void testAlreadyUpToDateDataStream() throws Exception {
         String dataStreamName = randomAlphaOfLength(50).toLowerCase(Locale.ROOT);
-        ReindexDataStreamRequest reindexDataStreamRequest = new ReindexDataStreamRequest(dataStreamName);
+        ReindexDataStreamRequest reindexDataStreamRequest = new ReindexDataStreamRequest(
+            ReindexDataStreamAction.Mode.UPGRADE,
+            dataStreamName
+        );
         createDataStream(dataStreamName);
         ReindexDataStreamResponse response = client().execute(
             new ActionType<ReindexDataStreamResponse>(ReindexDataStreamAction.NAME),
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/MigratePlugin.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/MigratePlugin.java
index 118cd69ece4d6..ac9e38da07421 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/MigratePlugin.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/MigratePlugin.java
@@ -11,21 +11,30 @@
 import org.elasticsearch.action.ActionResponse;
 import org.elasticsearch.client.internal.Client;
 import org.elasticsearch.cluster.metadata.IndexNameExpressionResolver;
+import org.elasticsearch.cluster.node.DiscoveryNodes;
 import org.elasticsearch.cluster.service.ClusterService;
 import org.elasticsearch.common.io.stream.NamedWriteableRegistry;
+import org.elasticsearch.common.settings.ClusterSettings;
+import org.elasticsearch.common.settings.IndexScopedSettings;
+import org.elasticsearch.common.settings.Settings;
+import org.elasticsearch.common.settings.SettingsFilter;
 import org.elasticsearch.common.settings.SettingsModule;
+import org.elasticsearch.features.NodeFeature;
 import org.elasticsearch.persistent.PersistentTaskParams;
 import org.elasticsearch.persistent.PersistentTaskState;
 import org.elasticsearch.persistent.PersistentTasksExecutor;
 import org.elasticsearch.plugins.ActionPlugin;
 import org.elasticsearch.plugins.PersistentTaskPlugin;
 import org.elasticsearch.plugins.Plugin;
+import org.elasticsearch.rest.RestController;
+import org.elasticsearch.rest.RestHandler;
 import org.elasticsearch.tasks.Task;
 import org.elasticsearch.threadpool.ThreadPool;
 import org.elasticsearch.xcontent.NamedXContentRegistry;
 import org.elasticsearch.xcontent.ParseField;
 import org.elasticsearch.xpack.migrate.action.ReindexDataStreamAction;
 import org.elasticsearch.xpack.migrate.action.ReindexDataStreamTransportAction;
+import org.elasticsearch.xpack.migrate.rest.RestMigrationReindexAction;
 import org.elasticsearch.xpack.migrate.task.ReindexDataStreamPersistentTaskExecutor;
 import org.elasticsearch.xpack.migrate.task.ReindexDataStreamPersistentTaskState;
 import org.elasticsearch.xpack.migrate.task.ReindexDataStreamStatus;
@@ -34,47 +43,80 @@
 
 import java.util.ArrayList;
 import java.util.List;
+import java.util.function.Predicate;
+import java.util.function.Supplier;
+
+import static org.elasticsearch.xpack.migrate.action.ReindexDataStreamAction.REINDEX_DATA_STREAM_FEATURE_FLAG;
 
 public class MigratePlugin extends Plugin implements ActionPlugin, PersistentTaskPlugin {
 
+    @Override
+    public List<RestHandler> getRestHandlers(
+        Settings unused,
+        NamedWriteableRegistry namedWriteableRegistry,
+        RestController restController,
+        ClusterSettings clusterSettings,
+        IndexScopedSettings indexScopedSettings,
+        SettingsFilter settingsFilter,
+        IndexNameExpressionResolver indexNameExpressionResolver,
+        Supplier<DiscoveryNodes> nodesInCluster,
+        Predicate<NodeFeature> clusterSupportsFeature
+    ) {
+        List<RestHandler> handlers = new ArrayList<>();
+        if (REINDEX_DATA_STREAM_FEATURE_FLAG.isEnabled()) {
+            handlers.add(new RestMigrationReindexAction());
+        }
+        return handlers;
+    }
+
     @Override
     public List<ActionHandler<? extends ActionRequest, ? extends ActionResponse>> getActions() {
         List<ActionHandler<? extends ActionRequest, ? extends ActionResponse>> actions = new ArrayList<>();
-        actions.add(new ActionHandler<>(ReindexDataStreamAction.INSTANCE, ReindexDataStreamTransportAction.class));
+        if (REINDEX_DATA_STREAM_FEATURE_FLAG.isEnabled()) {
+            actions.add(new ActionHandler<>(ReindexDataStreamAction.INSTANCE, ReindexDataStreamTransportAction.class));
+        }
         return actions;
     }
 
     @Override
     public List<NamedXContentRegistry.Entry> getNamedXContent() {
-        return List.of(
-            new NamedXContentRegistry.Entry(
-                PersistentTaskState.class,
-                new ParseField(ReindexDataStreamPersistentTaskState.NAME),
-                ReindexDataStreamPersistentTaskState::fromXContent
-            ),
-            new NamedXContentRegistry.Entry(
-                PersistentTaskParams.class,
-                new ParseField(ReindexDataStreamTaskParams.NAME),
-                ReindexDataStreamTaskParams::fromXContent
-            )
-        );
+        if (REINDEX_DATA_STREAM_FEATURE_FLAG.isEnabled()) {
+            return List.of(
+                new NamedXContentRegistry.Entry(
+                    PersistentTaskState.class,
+                    new ParseField(ReindexDataStreamPersistentTaskState.NAME),
+                    ReindexDataStreamPersistentTaskState::fromXContent
+                ),
+                new NamedXContentRegistry.Entry(
+                    PersistentTaskParams.class,
+                    new ParseField(ReindexDataStreamTaskParams.NAME),
+                    ReindexDataStreamTaskParams::fromXContent
+                )
+            );
+        } else {
+            return List.of();
+        }
     }
 
     @Override
     public List<NamedWriteableRegistry.Entry> getNamedWriteables() {
-        return List.of(
-            new NamedWriteableRegistry.Entry(
-                PersistentTaskState.class,
-                ReindexDataStreamPersistentTaskState.NAME,
-                ReindexDataStreamPersistentTaskState::new
-            ),
-            new NamedWriteableRegistry.Entry(
-                PersistentTaskParams.class,
-                ReindexDataStreamTaskParams.NAME,
-                ReindexDataStreamTaskParams::new
-            ),
-            new NamedWriteableRegistry.Entry(Task.Status.class, ReindexDataStreamStatus.NAME, ReindexDataStreamStatus::new)
-        );
+        if (REINDEX_DATA_STREAM_FEATURE_FLAG.isEnabled()) {
+            return List.of(
+                new NamedWriteableRegistry.Entry(
+                    PersistentTaskState.class,
+                    ReindexDataStreamPersistentTaskState.NAME,
+                    ReindexDataStreamPersistentTaskState::new
+                ),
+                new NamedWriteableRegistry.Entry(
+                    PersistentTaskParams.class,
+                    ReindexDataStreamTaskParams.NAME,
+                    ReindexDataStreamTaskParams::new
+                ),
+                new NamedWriteableRegistry.Entry(Task.Status.class, ReindexDataStreamStatus.NAME, ReindexDataStreamStatus::new)
+            );
+        } else {
+            return List.of();
+        }
     }
 
     @Override
@@ -85,6 +127,12 @@ public List<PersistentTasksExecutor<?>> getPersistentTasksExecutor(
         SettingsModule settingsModule,
         IndexNameExpressionResolver expressionResolver
     ) {
-        return List.of(new ReindexDataStreamPersistentTaskExecutor(client, clusterService, ReindexDataStreamTask.TASK_NAME, threadPool));
+        if (REINDEX_DATA_STREAM_FEATURE_FLAG.isEnabled()) {
+            return List.of(
+                new ReindexDataStreamPersistentTaskExecutor(client, clusterService, ReindexDataStreamTask.TASK_NAME, threadPool)
+            );
+        } else {
+            return List.of();
+        }
     }
 }
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamAction.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamAction.java
index 1785e6971f824..eb7a910df8c0c 100644
--- a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamAction.java
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamAction.java
@@ -11,23 +11,41 @@
 import org.elasticsearch.action.ActionRequestValidationException;
 import org.elasticsearch.action.ActionResponse;
 import org.elasticsearch.action.ActionType;
+import org.elasticsearch.action.IndicesRequest;
+import org.elasticsearch.action.support.IndicesOptions;
 import org.elasticsearch.common.io.stream.StreamInput;
 import org.elasticsearch.common.io.stream.StreamOutput;
+import org.elasticsearch.common.util.FeatureFlag;
+import org.elasticsearch.features.NodeFeature;
+import org.elasticsearch.xcontent.ConstructingObjectParser;
+import org.elasticsearch.xcontent.ParseField;
+import org.elasticsearch.xcontent.ToXContent;
 import org.elasticsearch.xcontent.ToXContentObject;
 import org.elasticsearch.xcontent.XContentBuilder;
+import org.elasticsearch.xcontent.XContentParser;
 
 import java.io.IOException;
+import java.util.Locale;
 import java.util.Objects;
+import java.util.function.Predicate;
 
 public class ReindexDataStreamAction extends ActionType<ReindexDataStreamAction.ReindexDataStreamResponse> {
+    public static final FeatureFlag REINDEX_DATA_STREAM_FEATURE_FLAG = new FeatureFlag("reindex_data_stream");
 
     public static final ReindexDataStreamAction INSTANCE = new ReindexDataStreamAction();
     public static final String NAME = "indices:admin/data_stream/reindex";
+    public static final ParseField MODE_FIELD = new ParseField("mode");
+    public static final ParseField SOURCE_FIELD = new ParseField("source");
+    public static final ParseField INDEX_FIELD = new ParseField("index");
 
     public ReindexDataStreamAction() {
         super(NAME);
     }
 
+    public enum Mode {
+        UPGRADE
+    }
+
     public static class ReindexDataStreamResponse extends ActionResponse implements ToXContentObject {
         private final String taskId;
 
@@ -49,7 +67,7 @@ public void writeTo(StreamOutput out) throws IOException {
         @Override
         public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
             builder.startObject();
-            builder.field("task", getTaskId());
+            builder.field("acknowledged", true);
             builder.endObject();
             return builder;
         }
@@ -70,22 +88,52 @@ public boolean equals(Object other) {
 
     }
 
-    public static class ReindexDataStreamRequest extends ActionRequest {
+    public static class ReindexDataStreamRequest extends ActionRequest implements IndicesRequest, ToXContent {
+        private final Mode mode;
         private final String sourceDataStream;
 
-        public ReindexDataStreamRequest(String sourceDataStream) {
-            super();
+        public ReindexDataStreamRequest(Mode mode, String sourceDataStream) {
+            this.mode = mode;
             this.sourceDataStream = sourceDataStream;
         }
 
         public ReindexDataStreamRequest(StreamInput in) throws IOException {
             super(in);
+            this.mode = Mode.valueOf(in.readString());
             this.sourceDataStream = in.readString();
         }
 
+        private static final ConstructingObjectParser<ReindexDataStreamRequest, Predicate<NodeFeature>> PARSER =
+            new ConstructingObjectParser<>("migration_reindex", objects -> {
+                Mode mode = Mode.valueOf(((String) objects[0]).toUpperCase(Locale.ROOT));
+                String source = (String) objects[1];
+                return new ReindexDataStreamRequest(mode, source);
+            });
+
+        private static final ConstructingObjectParser<String, Void> SOURCE_PARSER = new ConstructingObjectParser<>(
+            SOURCE_FIELD.getPreferredName(),
+            false,
+            (a, id) -> (String) a[0]
+        );
+
+        static {
+            SOURCE_PARSER.declareString(ConstructingObjectParser.constructorArg(), INDEX_FIELD);
+            PARSER.declareString(ConstructingObjectParser.constructorArg(), MODE_FIELD);
+            PARSER.declareObject(
+                ConstructingObjectParser.constructorArg(),
+                (parser, id) -> SOURCE_PARSER.apply(parser, null),
+                SOURCE_FIELD
+            );
+        }
+
+        public static ReindexDataStreamRequest fromXContent(XContentParser parser) {
+            return PARSER.apply(parser, null);
+        }
+
         @Override
         public void writeTo(StreamOutput out) throws IOException {
             super.writeTo(out);
+            out.writeString(mode.name());
             out.writeString(sourceDataStream);
         }
 
@@ -103,15 +151,42 @@ public String getSourceDataStream() {
             return sourceDataStream;
         }
 
+        public Mode getMode() {
+            return mode;
+        }
+
         @Override
         public int hashCode() {
-            return Objects.hashCode(sourceDataStream);
+            return Objects.hash(mode, sourceDataStream);
         }
 
         @Override
         public boolean equals(Object other) {
-            return other instanceof ReindexDataStreamRequest
-                && sourceDataStream.equals(((ReindexDataStreamRequest) other).sourceDataStream);
+            return other instanceof ReindexDataStreamRequest otherRequest
+                && mode.equals(otherRequest.mode)
+                && sourceDataStream.equals(otherRequest.sourceDataStream);
+        }
+
+        @Override
+        public String[] indices() {
+            return new String[] { sourceDataStream };
+        }
+
+        @Override
+        public IndicesOptions indicesOptions() {
+            return IndicesOptions.strictSingleIndexNoExpandForbidClosed();
+        }
+
+        /*
+         * This only exists for the sake of testing the xcontent parser
+         */
+        @Override
+        public XContentBuilder toXContent(XContentBuilder builder, Params params) throws IOException {
+            builder.field(MODE_FIELD.getPreferredName(), mode);
+            builder.startObject(SOURCE_FIELD.getPreferredName());
+            builder.field(INDEX_FIELD.getPreferredName(), sourceDataStream);
+            builder.endObject();
+            return builder;
         }
     }
 }
diff --git a/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/rest/RestMigrationReindexAction.java b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/rest/RestMigrationReindexAction.java
new file mode 100644
index 0000000000000..a7f630d68234d
--- /dev/null
+++ b/x-pack/plugin/migrate/src/main/java/org/elasticsearch/xpack/migrate/rest/RestMigrationReindexAction.java
@@ -0,0 +1,64 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.migrate.rest;
+
+import org.elasticsearch.client.internal.node.NodeClient;
+import org.elasticsearch.rest.BaseRestHandler;
+import org.elasticsearch.rest.RestChannel;
+import org.elasticsearch.rest.RestRequest;
+import org.elasticsearch.rest.RestResponse;
+import org.elasticsearch.rest.RestStatus;
+import org.elasticsearch.rest.action.RestBuilderListener;
+import org.elasticsearch.xcontent.XContentBuilder;
+import org.elasticsearch.xcontent.XContentParser;
+import org.elasticsearch.xpack.migrate.action.ReindexDataStreamAction;
+import org.elasticsearch.xpack.migrate.action.ReindexDataStreamAction.ReindexDataStreamResponse;
+
+import java.io.IOException;
+import java.util.List;
+
+import static org.elasticsearch.rest.RestRequest.Method.POST;
+
+public class RestMigrationReindexAction extends BaseRestHandler {
+
+    @Override
+    public String getName() {
+        return "migration_reindex";
+    }
+
+    @Override
+    public List<Route> routes() {
+        return List.of(new Route(POST, "/_migration/reindex"));
+    }
+
+    @Override
+    protected RestChannelConsumer prepareRequest(RestRequest request, NodeClient client) throws IOException {
+        ReindexDataStreamAction.ReindexDataStreamRequest reindexRequest;
+        try (XContentParser parser = request.contentParser()) {
+            reindexRequest = ReindexDataStreamAction.ReindexDataStreamRequest.fromXContent(parser);
+        }
+        return channel -> client.execute(
+            ReindexDataStreamAction.INSTANCE,
+            reindexRequest,
+            new ReindexDataStreamRestToXContentListener(channel)
+        );
+    }
+
+    static class ReindexDataStreamRestToXContentListener extends RestBuilderListener<ReindexDataStreamResponse> {
+
+        ReindexDataStreamRestToXContentListener(RestChannel channel) {
+            super(channel);
+        }
+
+        @Override
+        public RestResponse buildResponse(ReindexDataStreamResponse response, XContentBuilder builder) throws Exception {
+            response.toXContent(builder, channel.request());
+            return new RestResponse(RestStatus.OK, builder);
+        }
+    }
+}
diff --git a/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamRequestTests.java b/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamRequestTests.java
new file mode 100644
index 0000000000000..9c7bf87b6cff0
--- /dev/null
+++ b/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamRequestTests.java
@@ -0,0 +1,39 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+package org.elasticsearch.xpack.migrate.action;
+
+import org.elasticsearch.common.io.stream.Writeable;
+import org.elasticsearch.test.AbstractXContentSerializingTestCase;
+import org.elasticsearch.xcontent.XContentParser;
+import org.elasticsearch.xpack.migrate.action.ReindexDataStreamAction.ReindexDataStreamRequest;
+
+import java.io.IOException;
+
+public class ReindexDataStreamRequestTests extends AbstractXContentSerializingTestCase<ReindexDataStreamRequest> {
+
+    @Override
+    protected ReindexDataStreamRequest createTestInstance() {
+        return new ReindexDataStreamRequest(ReindexDataStreamAction.Mode.UPGRADE, randomAlphaOfLength(40));
+    }
+
+    @Override
+    protected ReindexDataStreamRequest mutateInstance(ReindexDataStreamRequest instance) {
+        // There is currently only one possible value for mode, so we can't change it
+        return new ReindexDataStreamRequest(instance.getMode(), randomAlphaOfLength(50));
+    }
+
+    @Override
+    protected ReindexDataStreamRequest doParseInstance(XContentParser parser) throws IOException {
+        return ReindexDataStreamRequest.fromXContent(parser);
+    }
+
+    @Override
+    protected Writeable.Reader<ReindexDataStreamRequest> instanceReader() {
+        return ReindexDataStreamRequest::new;
+    }
+}
diff --git a/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamResponseTests.java b/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamResponseTests.java
index 06844577c4e36..d886fc660d7a8 100644
--- a/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamResponseTests.java
+++ b/x-pack/plugin/migrate/src/test/java/org/elasticsearch/xpack/migrate/action/ReindexDataStreamResponseTests.java
@@ -43,7 +43,7 @@ public void testToXContent() throws IOException {
             builder.humanReadable(true);
             response.toXContent(builder, EMPTY_PARAMS);
             try (XContentParser parser = createParser(JsonXContent.jsonXContent, BytesReference.bytes(builder))) {
-                assertThat(parser.map(), equalTo(Map.of("task", response.getTaskId())));
+                assertThat(parser.map(), equalTo(Map.of("acknowledged", true)));
             }
         }
     }
diff --git a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/migrate/10_reindex.yml b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/migrate/10_reindex.yml
new file mode 100644
index 0000000000000..01a41b3aa8c94
--- /dev/null
+++ b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/migrate/10_reindex.yml
@@ -0,0 +1,89 @@
+---
+setup:
+  - do:
+      cluster.health:
+        wait_for_status: yellow
+
+---
+"Test Reindex With Unsupported Mode":
+  - do:
+      catch: /illegal_argument_exception/
+      migrate.reindex:
+        body: |
+          {
+            "mode": "unsupported_mode",
+            "source": {
+              "index": "my-data-stream"
+            }
+          }
+
+---
+"Test Reindex With Nonexistent Data Stream":
+  - do:
+      catch: /resource_not_found_exception/
+      migrate.reindex:
+        body: |
+          {
+            "mode": "upgrade",
+            "source": {
+              "index": "my-data-stream"
+            }
+          }
+
+  - do:
+      catch: /resource_not_found_exception/
+      migrate.reindex:
+        body: |
+          {
+            "mode": "upgrade",
+            "source": {
+              "index": "my-data-stream1,my-data-stream2"
+            }
+          }
+
+
+---
+"Test Reindex With Bad Data Stream Name":
+  - do:
+      catch: /illegal_argument_exception/
+      migrate.reindex:
+        body: |
+          {
+            "mode": "upgrade",
+            "source": {
+              "index": "my-data-stream*"
+            }
+          }
+
+---
+"Test Reindex With Existing Data Stream":
+  - do:
+      indices.put_index_template:
+        name: my-template1
+        body:
+          index_patterns: [my-data-stream*]
+          template:
+            mappings:
+              properties:
+                '@timestamp':
+                  type: date
+                'foo':
+                  type: keyword
+          data_stream: {}
+
+  - do:
+      indices.create_data_stream:
+        name: my-data-stream
+  - is_true: acknowledged
+
+# Uncomment once the cancel API is in place
+#  - do:
+#      migrate.reindex:
+#        body: |
+#          {
+#            "mode": "upgrade",
+#            "source": {
+#              "index": "my-data-stream"
+#            }
+#          }
+#  - match: { task: "reindex-data-stream-my-data-stream" }

From d411ad82daee10d298c2eb47d3fd900a83091baf Mon Sep 17 00:00:00 2001
From: Nick Tindall <nick.tindall@elastic.co>
Date: Mon, 9 Dec 2024 13:44:10 +1100
Subject: [PATCH 111/119] AbstractRepositoryS3RestTestCase: Parse response for
 assertion (#118230)

---
 .../s3/AbstractRepositoryS3RestTestCase.java  | 32 +++++++++----------
 1 file changed, 15 insertions(+), 17 deletions(-)

diff --git a/modules/repository-s3/src/javaRestTest/java/org/elasticsearch/repositories/s3/AbstractRepositoryS3RestTestCase.java b/modules/repository-s3/src/javaRestTest/java/org/elasticsearch/repositories/s3/AbstractRepositoryS3RestTestCase.java
index 2199a64521759..67ada622efeea 100644
--- a/modules/repository-s3/src/javaRestTest/java/org/elasticsearch/repositories/s3/AbstractRepositoryS3RestTestCase.java
+++ b/modules/repository-s3/src/javaRestTest/java/org/elasticsearch/repositories/s3/AbstractRepositoryS3RestTestCase.java
@@ -19,6 +19,7 @@
 import org.elasticsearch.rest.RestStatus;
 import org.elasticsearch.test.ESTestCase;
 import org.elasticsearch.test.rest.ESRestTestCase;
+import org.elasticsearch.test.rest.ObjectPath;
 
 import java.io.Closeable;
 import java.io.IOException;
@@ -27,7 +28,6 @@
 import java.util.function.UnaryOperator;
 import java.util.stream.Collectors;
 
-import static org.hamcrest.Matchers.allOf;
 import static org.hamcrest.Matchers.containsString;
 import static org.hamcrest.Matchers.equalTo;
 
@@ -152,10 +152,9 @@ private void testNonexistentBucket(Boolean readonly) throws Exception {
 
         final var responseException = expectThrows(ResponseException.class, () -> client().performRequest(registerRequest));
         assertEquals(RestStatus.INTERNAL_SERVER_ERROR.getStatus(), responseException.getResponse().getStatusLine().getStatusCode());
-        assertThat(
-            responseException.getMessage(),
-            allOf(containsString("repository_verification_exception"), containsString("is not accessible on master node"))
-        );
+        final var responseObjectPath = ObjectPath.createFromResponse(responseException.getResponse());
+        assertThat(responseObjectPath.evaluate("error.type"), equalTo("repository_verification_exception"));
+        assertThat(responseObjectPath.evaluate("error.reason"), containsString("is not accessible on master node"));
     }
 
     public void testNonexistentClient() throws Exception {
@@ -181,15 +180,11 @@ private void testNonexistentClient(Boolean readonly) throws Exception {
 
         final var responseException = expectThrows(ResponseException.class, () -> client().performRequest(registerRequest));
         assertEquals(RestStatus.INTERNAL_SERVER_ERROR.getStatus(), responseException.getResponse().getStatusLine().getStatusCode());
-        assertThat(
-            responseException.getMessage(),
-            allOf(
-                containsString("repository_verification_exception"),
-                containsString("is not accessible on master node"),
-                containsString("illegal_argument_exception"),
-                containsString("Unknown s3 client name")
-            )
-        );
+        final var responseObjectPath = ObjectPath.createFromResponse(responseException.getResponse());
+        assertThat(responseObjectPath.evaluate("error.type"), equalTo("repository_verification_exception"));
+        assertThat(responseObjectPath.evaluate("error.reason"), containsString("is not accessible on master node"));
+        assertThat(responseObjectPath.evaluate("error.caused_by.type"), equalTo("illegal_argument_exception"));
+        assertThat(responseObjectPath.evaluate("error.caused_by.reason"), containsString("Unknown s3 client name"));
     }
 
     public void testNonexistentSnapshot() throws Exception {
@@ -212,7 +207,8 @@ private void testNonexistentSnapshot(Boolean readonly) throws Exception {
             final var getSnapshotRequest = new Request("GET", "/_snapshot/" + repositoryName + "/" + randomIdentifier());
             final var getSnapshotException = expectThrows(ResponseException.class, () -> client().performRequest(getSnapshotRequest));
             assertEquals(RestStatus.NOT_FOUND.getStatus(), getSnapshotException.getResponse().getStatusLine().getStatusCode());
-            assertThat(getSnapshotException.getMessage(), containsString("snapshot_missing_exception"));
+            final var getResponseObjectPath = ObjectPath.createFromResponse(getSnapshotException.getResponse());
+            assertThat(getResponseObjectPath.evaluate("error.type"), equalTo("snapshot_missing_exception"));
 
             final var restoreRequest = new Request("POST", "/_snapshot/" + repositoryName + "/" + randomIdentifier() + "/_restore");
             if (randomBoolean()) {
@@ -220,13 +216,15 @@ private void testNonexistentSnapshot(Boolean readonly) throws Exception {
             }
             final var restoreException = expectThrows(ResponseException.class, () -> client().performRequest(restoreRequest));
             assertEquals(RestStatus.INTERNAL_SERVER_ERROR.getStatus(), restoreException.getResponse().getStatusLine().getStatusCode());
-            assertThat(restoreException.getMessage(), containsString("snapshot_restore_exception"));
+            final var restoreResponseObjectPath = ObjectPath.createFromResponse(restoreException.getResponse());
+            assertThat(restoreResponseObjectPath.evaluate("error.type"), equalTo("snapshot_restore_exception"));
 
             if (readonly != Boolean.TRUE) {
                 final var deleteRequest = new Request("DELETE", "/_snapshot/" + repositoryName + "/" + randomIdentifier());
                 final var deleteException = expectThrows(ResponseException.class, () -> client().performRequest(deleteRequest));
                 assertEquals(RestStatus.NOT_FOUND.getStatus(), deleteException.getResponse().getStatusLine().getStatusCode());
-                assertThat(deleteException.getMessage(), containsString("snapshot_missing_exception"));
+                final var deleteResponseObjectPath = ObjectPath.createFromResponse(deleteException.getResponse());
+                assertThat(deleteResponseObjectPath.evaluate("error.type"), equalTo("snapshot_missing_exception"));
             }
         }
     }

From d7a9c50cf24abe11c76a14da4c6e304480eea728 Mon Sep 17 00:00:00 2001
From: elasticsearchmachine
 <58790826+elasticsearchmachine@users.noreply.github.com>
Date: Mon, 9 Dec 2024 18:32:09 +1100
Subject: [PATCH 112/119] Mute org.elasticsearch.packaging.test.ArchiveTests
 test60StartAndStop #118216

---
 muted-tests.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/muted-tests.yml b/muted-tests.yml
index a367234691895..4523db7239be6 100644
--- a/muted-tests.yml
+++ b/muted-tests.yml
@@ -294,6 +294,9 @@ tests:
   issue: https://github.com/elastic/elasticsearch/issues/118220
 - class: org.elasticsearch.validation.DotPrefixClientYamlTestSuiteIT
   issue: https://github.com/elastic/elasticsearch/issues/118224
+- class: org.elasticsearch.packaging.test.ArchiveTests
+  method: test60StartAndStop
+  issue: https://github.com/elastic/elasticsearch/issues/118216
 
 # Examples:
 #

From b2b8e3f762753ac903f056a4238a204e993bb8d5 Mon Sep 17 00:00:00 2001
From: kosabogi <105062005+kosabogi@users.noreply.github.com>
Date: Mon, 9 Dec 2024 09:05:11 +0100
Subject: [PATCH 113/119] [DOCS] [8.17] Adds new default inference endpoint
 information (#117985)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Adds new default inference information

* Update docs/reference/mapping/types/semantic-text.asciidoc

Co-authored-by: István Zoltán Szabó <istvan.szabo@elastic.co>

* Update docs/reference/search/search-your-data/semantic-search-semantic-text.asciidoc

Co-authored-by: István Zoltán Szabó <istvan.szabo@elastic.co>

* Update docs/reference/mapping/types/semantic-text.asciidoc

Co-authored-by: David Kyle <david.kyle@elastic.co>

---------

Co-authored-by: István Zoltán Szabó <istvan.szabo@elastic.co>
Co-authored-by: David Kyle <david.kyle@elastic.co>
---
 .../mapping/types/semantic-text.asciidoc      | 19 +++----
 .../semantic-search-semantic-text.asciidoc    |  8 +--
 .../semantic-text-hybrid-search               | 51 +++----------------
 3 files changed, 21 insertions(+), 57 deletions(-)

diff --git a/docs/reference/mapping/types/semantic-text.asciidoc b/docs/reference/mapping/types/semantic-text.asciidoc
index b3e103ec6dbd9..96dc402e10c60 100644
--- a/docs/reference/mapping/types/semantic-text.asciidoc
+++ b/docs/reference/mapping/types/semantic-text.asciidoc
@@ -12,13 +12,14 @@ Long passages are <<auto-text-chunking, automatically chunked>> to smaller secti
 
 The `semantic_text` field type specifies an inference endpoint identifier that will be used to generate embeddings.
 You can create the inference endpoint by using the <<put-inference-api>>.
-This field type and the <<query-dsl-semantic-query,`semantic` query>> type make it simpler to perform semantic search on your data.
-If you don't specify an inference endpoint, the <<infer-service-elser,ELSER service>> is used by default.
+This field type and the <<query-dsl-semantic-query,`semantic` query>> type make it simpler to perform semantic search on your data. 
+
+If you don’t specify an inference endpoint, the `inference_id` field defaults to `.elser-2-elasticsearch`, a preconfigured endpoint for the elasticsearch service.
 
 Using `semantic_text`, you won't need to specify how to generate embeddings for your data, or how to index it.
 The {infer} endpoint automatically determines the embedding generation, indexing, and query to use.
 
-If you use the ELSER service, you can set up `semantic_text` with the following API request:
+If you use the preconfigured `.elser-2-elasticsearch` endpoint, you can set up `semantic_text` with the following API request:
 
 [source,console]
 ------------------------------------------------------------
@@ -34,7 +35,7 @@ PUT my-index-000001
 }
 ------------------------------------------------------------
 
-If you use a service other than ELSER, you must create an {infer} endpoint using the <<put-inference-api>> and reference it when setting up `semantic_text` as the following example demonstrates:
+To use a custom {infer} endpoint instead of the default `.elser-2-elasticsearch`, you must <<put-inference-api>> and specify its `inference_id` when setting up the `semantic_text` field type.
 
 [source,console]
 ------------------------------------------------------------
@@ -53,8 +54,7 @@ PUT my-index-000002
 // TEST[skip:Requires inference endpoint]
 <1> The `inference_id` of the {infer} endpoint to use to generate embeddings.
 
-
-The recommended way to use semantic_text is by having dedicated {infer} endpoints for ingestion and search.
+The recommended way to use `semantic_text` is by having dedicated {infer} endpoints for ingestion and search.
 This ensures that search speed remains unaffected by ingestion workloads, and vice versa.
 After creating dedicated {infer} endpoints for both, you can reference them using the `inference_id` and `search_inference_id` parameters when setting up the index mapping for an index that uses the `semantic_text` field.
 
@@ -82,10 +82,11 @@ PUT my-index-000003
 
 `inference_id`::
 (Required, string)
-{infer-cap} endpoint that will be used to generate the embeddings for the field.
+{infer-cap} endpoint that will be used to generate embeddings for the field.
+By default, `.elser-2-elasticsearch` is used.
 This parameter cannot be updated.
 Use the <<put-inference-api>> to create the endpoint.
-If `search_inference_id` is specified, the {infer} endpoint defined by `inference_id` will only be used at index time.
+If `search_inference_id` is specified, the {infer} endpoint will only be used at index time.
 
 `search_inference_id`::
 (Optional, string)
@@ -201,7 +202,7 @@ PUT test-index
         "properties": {
             "infer_field": {
                 "type": "semantic_text",
-                "inference_id": "my-elser-endpoint"
+                "inference_id": ".elser-2-elasticsearch"
             },
             "source_field": {
                 "type": "text",
diff --git a/docs/reference/search/search-your-data/semantic-search-semantic-text.asciidoc b/docs/reference/search/search-your-data/semantic-search-semantic-text.asciidoc
index ba9c81db21384..3448940b6fad7 100644
--- a/docs/reference/search/search-your-data/semantic-search-semantic-text.asciidoc
+++ b/docs/reference/search/search-your-data/semantic-search-semantic-text.asciidoc
@@ -14,15 +14,15 @@ You don't need to define model related settings and parameters, or create {infer
 The recommended way to use <<semantic-search,semantic search>> in the {stack} is following the `semantic_text` workflow.
 When you need more control over indexing and query settings, you can still use the complete {infer} workflow (refer to  <<semantic-search-inference,this tutorial>> to review the process).
 
-This tutorial uses the <<inference-example-elser,`elser` service>> for demonstration, but you can use any service and their supported models offered by the {infer-cap} API.
+This tutorial uses the <<infer-service-elasticsearch,`elasticsearch` service>> for demonstration, but you can use any service and their supported models offered by the {infer-cap} API.
 
 
 [discrete]
 [[semantic-text-requirements]]
 ==== Requirements
 
-This tutorial uses the <<infer-service-elser,ELSER service>> for demonstration, which is created automatically as needed. 
-To use the `semantic_text` field type with an {infer} service other than ELSER, you must create an inference endpoint using the <<put-inference-api>>.
+This tutorial uses the <<infer-service-elasticsearch,`elasticsearch` service>> for demonstration, which is created automatically as needed. 
+To use the `semantic_text` field type with an {infer} service other than `elasticsearch` service, you must create an inference endpoint using the <<put-inference-api>>.
 
 
 [discrete]
@@ -48,7 +48,7 @@ PUT semantic-embeddings
 // TEST[skip:TBD]
 <1> The name of the field to contain the generated embeddings.
 <2> The field to contain the embeddings is a `semantic_text` field.
-Since no `inference_id` is provided, the <<infer-service-elser,ELSER service>> is used by default.
+Since no `inference_id` is provided, the default endpoint `.elser-2-elasticsearch` for the <<infer-service-elasticsearch,`elasticsearch` service>> is used.
 To use a different {infer} service, you must create an {infer} endpoint first using the <<put-inference-api>> and then specify it in the `semantic_text` field mapping using the `inference_id` parameter.
 
 [NOTE]
diff --git a/docs/reference/search/search-your-data/semantic-text-hybrid-search b/docs/reference/search/search-your-data/semantic-text-hybrid-search
index c56b283434df5..4b49a7c3155db 100644
--- a/docs/reference/search/search-your-data/semantic-text-hybrid-search
+++ b/docs/reference/search/search-your-data/semantic-text-hybrid-search
@@ -8,47 +8,12 @@ This tutorial demonstrates how to perform hybrid search, combining semantic sear
 
 In hybrid search, semantic search retrieves results based on the meaning of the text, while full-text search focuses on exact word matches. By combining both methods, hybrid search delivers more relevant results, particularly in cases where relying on a single approach may not be sufficient.
 
-The recommended way to use hybrid search in the {stack} is following the `semantic_text` workflow. This tutorial uses the <<inference-example-elser,`elser` service>> for demonstration, but you can use any service and its supported models offered by the {infer-cap} API.
-
-[discrete]
-[[semantic-text-hybrid-infer-endpoint]]
-==== Create the {infer} endpoint
-
-Create an inference endpoint by using the <<put-inference-api>>:
-
-[source,console]
-------------------------------------------------------------
-PUT _inference/sparse_embedding/my-elser-endpoint <1>
-{
-  "service": "elser", <2>
-  "service_settings": {
-    "adaptive_allocations": { <3>
-      "enabled": true,
-      "min_number_of_allocations": 3,
-      "max_number_of_allocations": 10
-    },
-    "num_threads": 1
-  }
-}
-------------------------------------------------------------
-// TEST[skip:TBD]
-<1> The task type is `sparse_embedding` in the path as the `elser` service will
-be used and ELSER creates sparse vectors. The `inference_id` is
-`my-elser-endpoint`.
-<2> The `elser` service is used in this example.
-<3> This setting enables and configures adaptive allocations.
-Adaptive allocations make it possible for ELSER to automatically scale up or down resources based on the current load on the process.
-
-[NOTE]
-====
-You might see a 502 bad gateway error in the response when using the {kib} Console.
-This error usually just reflects a timeout, while the model downloads in the background.
-You can check the download progress in the {ml-app} UI.
-====
+The recommended way to use hybrid search in the {stack} is following the `semantic_text` workflow. 
+This tutorial uses the <<infer-service-elasticsearch,`elasticsearch` service>> for demonstration, but you can use any service and their supported models offered by the {infer-cap} API.
 
 [discrete]
 [[hybrid-search-create-index-mapping]]
-==== Create an index mapping for hybrid search
+==== Create an index mapping
 
 The destination index will contain both the embeddings for semantic search and the original text field for full-text search. This structure enables the combination of semantic search and full-text search.
 
@@ -60,11 +25,10 @@ PUT semantic-embeddings
     "properties": {
       "semantic_text": { <1>
         "type": "semantic_text", 
-        "inference_id": "my-elser-endpoint" <2>
       },
-      "content": { <3>
+      "content": { <2>
         "type": "text",
-        "copy_to": "semantic_text" <4>
+        "copy_to": "semantic_text" <3>
       }
     }
   }
@@ -72,9 +36,8 @@ PUT semantic-embeddings
 ------------------------------------------------------------
 // TEST[skip:TBD]
 <1> The name of the field to contain the generated embeddings for semantic search.
-<2> The identifier of the inference endpoint that generates the embeddings based on the input text.
-<3> The name of the field to contain the original text for lexical search.
-<4> The textual data stored in the `content` field will be copied to `semantic_text` and processed by the {infer} endpoint.
+<2> The name of the field to contain the original text for lexical search.
+<3> The textual data stored in the `content` field will be copied to `semantic_text` and processed by the {infer} endpoint.
 
 [NOTE]
 ====

From 7ffac3b3f3da18e46af023341f912b83899f0863 Mon Sep 17 00:00:00 2001
From: Armin Braun <me@obrown.io>
Date: Mon, 9 Dec 2024 09:08:01 +0100
Subject: [PATCH 114/119] Save O(1s) of CPU time in FieldSortIT (#118146)

I see this `toString` take ~2s of hot CPU time in some test runs which isn't entirely surprising.
Rather than optimize this in some form, just dropping the string here which aligns the thing with
other tests anyway.
---
 .../java/org/elasticsearch/search/sort/FieldSortIT.java          | 1 -
 1 file changed, 1 deletion(-)

diff --git a/server/src/internalClusterTest/java/org/elasticsearch/search/sort/FieldSortIT.java b/server/src/internalClusterTest/java/org/elasticsearch/search/sort/FieldSortIT.java
index 87665c3d784f1..bf7a315040caa 100644
--- a/server/src/internalClusterTest/java/org/elasticsearch/search/sort/FieldSortIT.java
+++ b/server/src/internalClusterTest/java/org/elasticsearch/search/sort/FieldSortIT.java
@@ -202,7 +202,6 @@ public void testIssue6614() throws InterruptedException {
                         response -> {
                             for (int j = 0; j < response.getHits().getHits().length; j++) {
                                 assertThat(
-                                    response.toString() + "\n vs. \n" + allDocsResponse.toString(),
                                     response.getHits().getHits()[j].getId(),
                                     equalTo(allDocsResponse.getHits().getHits()[j].getId())
                                 );

From 22e8f61db903473b462bff9a8919b399d742162d Mon Sep 17 00:00:00 2001
From: Luca Cavanna <javanna@apache.org>
Date: Mon, 9 Dec 2024 10:36:27 +0100
Subject: [PATCH 115/119] Unmute test around can match shards skipping against
 searchable snapshots (#118189)

This test has been muted for a long time. The failure may or may no longer be
relevant. This commit unmutes it. If it fails again, we'll get updated info
and look into it.

Closes #105339
---
 .../SearchableSnapshotsCanMatchOnCoordinatorIntegTests.java | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/x-pack/plugin/searchable-snapshots/src/internalClusterTest/java/org/elasticsearch/xpack/searchablesnapshots/SearchableSnapshotsCanMatchOnCoordinatorIntegTests.java b/x-pack/plugin/searchable-snapshots/src/internalClusterTest/java/org/elasticsearch/xpack/searchablesnapshots/SearchableSnapshotsCanMatchOnCoordinatorIntegTests.java
index d4bbd4495df26..23e414c0dc1bf 100644
--- a/x-pack/plugin/searchable-snapshots/src/internalClusterTest/java/org/elasticsearch/xpack/searchablesnapshots/SearchableSnapshotsCanMatchOnCoordinatorIntegTests.java
+++ b/x-pack/plugin/searchable-snapshots/src/internalClusterTest/java/org/elasticsearch/xpack/searchablesnapshots/SearchableSnapshotsCanMatchOnCoordinatorIntegTests.java
@@ -42,7 +42,6 @@
 import org.elasticsearch.snapshots.SnapshotId;
 import org.elasticsearch.test.ESIntegTestCase;
 import org.elasticsearch.test.NodeRoles;
-import org.elasticsearch.test.junit.annotations.TestIssueLogging;
 import org.elasticsearch.test.transport.MockTransportService;
 import org.elasticsearch.xcontent.XContentFactory;
 import org.elasticsearch.xpack.core.searchablesnapshots.MountSearchableSnapshotAction;
@@ -788,11 +787,6 @@ public void testQueryPhaseIsExecutedInAnAvailableNodeWhenAllShardsCanBeSkipped()
      * Can match against searchable snapshots is tested via both the Search API and the SearchShards (transport-only) API.
      * The latter is a way to do only a can-match rather than all search phases.
      */
-    @TestIssueLogging(
-        issueUrl = "https://github.com/elastic/elasticsearch/issues/97878",
-        value = "org.elasticsearch.snapshots:DEBUG,org.elasticsearch.indices.recovery:DEBUG,org.elasticsearch.action.search:DEBUG"
-    )
-    @AwaitsFix(bugUrl = "https://github.com/elastic/elasticsearch/issues/105339")
     public void testSearchableSnapshotShardsThatHaveMatchingDataAreNotSkippedOnTheCoordinatingNode() throws Exception {
         internalCluster().startMasterOnlyNode();
         internalCluster().startCoordinatingOnlyNode(Settings.EMPTY);

From 638e5b6de2daa785ba07548feb907ad9079a6c94 Mon Sep 17 00:00:00 2001
From: David Kyle <david.kyle@elastic.co>
Date: Mon, 9 Dec 2024 09:59:53 +0000
Subject: [PATCH 116/119] Revert "Adding default endpoint for Elastic Rerank
 (#117939)" (#118221)

This reverts commit 54c320ebc9b262e66ab92af660a8a155311059d4.
---
 docs/changelog/117939.yaml                    |  5 --
 .../xpack/inference/DefaultEndPointsIT.java   | 40 --------------
 .../inference/InferenceBaseRestTest.java      | 47 ++++------------
 .../xpack/inference/InferenceCrudIT.java      |  4 +-
 .../InferenceNamedWriteablesProvider.java     |  6 +-
 .../elasticsearch/CustomElandRerankModel.java |  4 +-
 ...ava => CustomElandRerankTaskSettings.java} | 25 +++++----
 .../elasticsearch/ElasticRerankerModel.java   |  5 +-
 .../ElasticsearchInternalService.java         | 55 ++++++-------------
 ...> CustomElandRerankTaskSettingsTests.java} | 48 ++++++++--------
 .../ElasticsearchInternalServiceTests.java    | 42 +++++++-------
 11 files changed, 96 insertions(+), 185 deletions(-)
 delete mode 100644 docs/changelog/117939.yaml
 rename x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/{RerankTaskSettings.java => CustomElandRerankTaskSettings.java} (79%)
 rename x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/{RerankTaskSettingsTests.java => CustomElandRerankTaskSettingsTests.java} (53%)

diff --git a/docs/changelog/117939.yaml b/docs/changelog/117939.yaml
deleted file mode 100644
index d41111f099f97..0000000000000
--- a/docs/changelog/117939.yaml
+++ /dev/null
@@ -1,5 +0,0 @@
-pr: 117939
-summary: Adding default endpoint for Elastic Rerank
-area: Machine Learning
-type: enhancement
-issues: []
diff --git a/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/DefaultEndPointsIT.java b/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/DefaultEndPointsIT.java
index 068b3e1f4ce04..ba3e48e11928d 100644
--- a/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/DefaultEndPointsIT.java
+++ b/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/DefaultEndPointsIT.java
@@ -57,9 +57,6 @@ public void testGet() throws IOException {
 
         var e5Model = getModel(ElasticsearchInternalService.DEFAULT_E5_ID);
         assertDefaultE5Config(e5Model);
-
-        var rerankModel = getModel(ElasticsearchInternalService.DEFAULT_RERANK_ID);
-        assertDefaultRerankConfig(rerankModel);
     }
 
     @SuppressWarnings("unchecked")
@@ -128,42 +125,6 @@ private static void assertDefaultE5Config(Map<String, Object> modelConfig) {
         assertDefaultChunkingSettings(modelConfig);
     }
 
-    @SuppressWarnings("unchecked")
-    public void testInferDeploysDefaultRerank() throws IOException {
-        var model = getModel(ElasticsearchInternalService.DEFAULT_RERANK_ID);
-        assertDefaultRerankConfig(model);
-
-        var inputs = List.of("Hello World", "Goodnight moon");
-        var query = "but why";
-        var queryParams = Map.of("timeout", "120s");
-        var results = infer(ElasticsearchInternalService.DEFAULT_RERANK_ID, TaskType.RERANK, inputs, query, queryParams);
-        var embeddings = (List<Map<String, Object>>) results.get("rerank");
-        assertThat(results.toString(), embeddings, hasSize(2));
-    }
-
-    @SuppressWarnings("unchecked")
-    private static void assertDefaultRerankConfig(Map<String, Object> modelConfig) {
-        assertEquals(modelConfig.toString(), ElasticsearchInternalService.DEFAULT_RERANK_ID, modelConfig.get("inference_id"));
-        assertEquals(modelConfig.toString(), ElasticsearchInternalService.NAME, modelConfig.get("service"));
-        assertEquals(modelConfig.toString(), TaskType.RERANK.toString(), modelConfig.get("task_type"));
-
-        var serviceSettings = (Map<String, Object>) modelConfig.get("service_settings");
-        assertThat(modelConfig.toString(), serviceSettings.get("model_id"), is(".rerank-v1"));
-        assertEquals(modelConfig.toString(), 1, serviceSettings.get("num_threads"));
-
-        var adaptiveAllocations = (Map<String, Object>) serviceSettings.get("adaptive_allocations");
-        assertThat(
-            modelConfig.toString(),
-            adaptiveAllocations,
-            Matchers.is(Map.of("enabled", true, "min_number_of_allocations", 0, "max_number_of_allocations", 32))
-        );
-
-        var chunkingSettings = (Map<String, Object>) modelConfig.get("chunking_settings");
-        assertNull(chunkingSettings);
-        var taskSettings = (Map<String, Object>) modelConfig.get("task_settings");
-        assertThat(modelConfig.toString(), taskSettings, Matchers.is(Map.of("return_documents", true)));
-    }
-
     @SuppressWarnings("unchecked")
     private static void assertDefaultChunkingSettings(Map<String, Object> modelConfig) {
         var chunkingSettings = (Map<String, Object>) modelConfig.get("chunking_settings");
@@ -198,7 +159,6 @@ public void onFailure(Exception exception) {
             var request = createInferenceRequest(
                 Strings.format("_inference/%s", ElasticsearchInternalService.DEFAULT_ELSER_ID),
                 inputs,
-                null,
                 queryParams
             );
             client().performRequestAsync(request, listener);
diff --git a/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceBaseRestTest.java b/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceBaseRestTest.java
index 1716057cdfe46..07ce2fe00642b 100644
--- a/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceBaseRestTest.java
+++ b/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceBaseRestTest.java
@@ -336,7 +336,7 @@ private List<Object> getInternalAsList(String endpoint) throws IOException {
 
     protected Map<String, Object> infer(String modelId, List<String> input) throws IOException {
         var endpoint = Strings.format("_inference/%s", modelId);
-        return inferInternal(endpoint, input, null, Map.of());
+        return inferInternal(endpoint, input, Map.of());
     }
 
     protected Deque<ServerSentEvent> streamInferOnMockService(String modelId, TaskType taskType, List<String> input) throws Exception {
@@ -352,7 +352,7 @@ protected Deque<ServerSentEvent> unifiedCompletionInferOnMockService(String mode
 
     private Deque<ServerSentEvent> callAsync(String endpoint, List<String> input) throws Exception {
         var request = new Request("POST", endpoint);
-        request.setJsonEntity(jsonBody(input, null));
+        request.setJsonEntity(jsonBody(input));
 
         return execAsyncCall(request);
     }
@@ -394,60 +394,33 @@ private String createUnifiedJsonBody(List<String> input, String role) throws IOE
 
     protected Map<String, Object> infer(String modelId, TaskType taskType, List<String> input) throws IOException {
         var endpoint = Strings.format("_inference/%s/%s", taskType, modelId);
-        return inferInternal(endpoint, input, null, Map.of());
+        return inferInternal(endpoint, input, Map.of());
     }
 
     protected Map<String, Object> infer(String modelId, TaskType taskType, List<String> input, Map<String, String> queryParameters)
         throws IOException {
         var endpoint = Strings.format("_inference/%s/%s?error_trace", taskType, modelId);
-        return inferInternal(endpoint, input, null, queryParameters);
+        return inferInternal(endpoint, input, queryParameters);
     }
 
-    protected Map<String, Object> infer(
-        String modelId,
-        TaskType taskType,
-        List<String> input,
-        String query,
-        Map<String, String> queryParameters
-    ) throws IOException {
-        var endpoint = Strings.format("_inference/%s/%s?error_trace", taskType, modelId);
-        return inferInternal(endpoint, input, query, queryParameters);
-    }
-
-    protected Request createInferenceRequest(
-        String endpoint,
-        List<String> input,
-        @Nullable String query,
-        Map<String, String> queryParameters
-    ) {
+    protected Request createInferenceRequest(String endpoint, List<String> input, Map<String, String> queryParameters) {
         var request = new Request("POST", endpoint);
-        request.setJsonEntity(jsonBody(input, query));
+        request.setJsonEntity(jsonBody(input));
         if (queryParameters.isEmpty() == false) {
             request.addParameters(queryParameters);
         }
         return request;
     }
 
-    private Map<String, Object> inferInternal(
-        String endpoint,
-        List<String> input,
-        @Nullable String query,
-        Map<String, String> queryParameters
-    ) throws IOException {
-        var request = createInferenceRequest(endpoint, input, query, queryParameters);
+    private Map<String, Object> inferInternal(String endpoint, List<String> input, Map<String, String> queryParameters) throws IOException {
+        var request = createInferenceRequest(endpoint, input, queryParameters);
         var response = client().performRequest(request);
         assertOkOrCreated(response);
         return entityAsMap(response);
     }
 
-    private String jsonBody(List<String> input, @Nullable String query) {
-        final StringBuilder bodyBuilder = new StringBuilder("{");
-
-        if (query != null) {
-            bodyBuilder.append("\"query\":\"").append(query).append("\",");
-        }
-
-        bodyBuilder.append("\"input\": [");
+    private String jsonBody(List<String> input) {
+        var bodyBuilder = new StringBuilder("{\"input\": [");
         for (var in : input) {
             bodyBuilder.append('"').append(in).append('"').append(',');
         }
diff --git a/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceCrudIT.java b/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceCrudIT.java
index 2099ec8287a76..1e19491aeaa60 100644
--- a/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceCrudIT.java
+++ b/x-pack/plugin/inference/qa/inference-service-tests/src/javaRestTest/java/org/elasticsearch/xpack/inference/InferenceCrudIT.java
@@ -49,7 +49,7 @@ public void testCRUD() throws IOException {
         }
 
         var getAllModels = getAllModels();
-        int numModels = 12;
+        int numModels = 11;
         assertThat(getAllModels, hasSize(numModels));
 
         var getSparseModels = getModels("_all", TaskType.SPARSE_EMBEDDING);
@@ -537,7 +537,7 @@ private static String expectedResult(String input) {
     }
 
     public void testGetZeroModels() throws IOException {
-        var models = getModels("_all", TaskType.COMPLETION);
+        var models = getModels("_all", TaskType.RERANK);
         assertThat(models, empty());
     }
 }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceNamedWriteablesProvider.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceNamedWriteablesProvider.java
index a4187f4c4fa90..b83c098ca808c 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceNamedWriteablesProvider.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/InferenceNamedWriteablesProvider.java
@@ -63,12 +63,12 @@
 import org.elasticsearch.xpack.inference.services.elastic.ElasticInferenceServiceSparseEmbeddingsServiceSettings;
 import org.elasticsearch.xpack.inference.services.elasticsearch.CustomElandInternalServiceSettings;
 import org.elasticsearch.xpack.inference.services.elasticsearch.CustomElandInternalTextEmbeddingServiceSettings;
+import org.elasticsearch.xpack.inference.services.elasticsearch.CustomElandRerankTaskSettings;
 import org.elasticsearch.xpack.inference.services.elasticsearch.ElasticRerankerServiceSettings;
 import org.elasticsearch.xpack.inference.services.elasticsearch.ElasticsearchInternalServiceSettings;
 import org.elasticsearch.xpack.inference.services.elasticsearch.ElserInternalServiceSettings;
 import org.elasticsearch.xpack.inference.services.elasticsearch.ElserMlNodeTaskSettings;
 import org.elasticsearch.xpack.inference.services.elasticsearch.MultilingualE5SmallInternalServiceSettings;
-import org.elasticsearch.xpack.inference.services.elasticsearch.RerankTaskSettings;
 import org.elasticsearch.xpack.inference.services.googleaistudio.completion.GoogleAiStudioCompletionServiceSettings;
 import org.elasticsearch.xpack.inference.services.googleaistudio.embeddings.GoogleAiStudioEmbeddingsServiceSettings;
 import org.elasticsearch.xpack.inference.services.googlevertexai.GoogleVertexAiSecretSettings;
@@ -518,7 +518,9 @@ private static void addCustomElandWriteables(final List<NamedWriteableRegistry.E
                 CustomElandInternalTextEmbeddingServiceSettings::new
             )
         );
-        namedWriteables.add(new NamedWriteableRegistry.Entry(TaskSettings.class, RerankTaskSettings.NAME, RerankTaskSettings::new));
+        namedWriteables.add(
+            new NamedWriteableRegistry.Entry(TaskSettings.class, CustomElandRerankTaskSettings.NAME, CustomElandRerankTaskSettings::new)
+        );
     }
 
     private static void addAnthropicNamedWritables(List<NamedWriteableRegistry.Entry> namedWriteables) {
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankModel.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankModel.java
index 6388bb33bb78d..f620b15680c8d 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankModel.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankModel.java
@@ -17,7 +17,7 @@
 import java.util.HashMap;
 import java.util.Map;
 
-import static org.elasticsearch.xpack.inference.services.elasticsearch.RerankTaskSettings.RETURN_DOCUMENTS;
+import static org.elasticsearch.xpack.inference.services.elasticsearch.CustomElandRerankTaskSettings.RETURN_DOCUMENTS;
 
 public class CustomElandRerankModel extends CustomElandModel {
 
@@ -26,7 +26,7 @@ public CustomElandRerankModel(
         TaskType taskType,
         String service,
         CustomElandInternalServiceSettings serviceSettings,
-        RerankTaskSettings taskSettings
+        CustomElandRerankTaskSettings taskSettings
     ) {
         super(inferenceEntityId, taskType, service, serviceSettings, taskSettings);
     }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/RerankTaskSettings.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankTaskSettings.java
similarity index 79%
rename from x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/RerankTaskSettings.java
rename to x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankTaskSettings.java
index 3c25f7a6a9016..a0be1661b860d 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/RerankTaskSettings.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankTaskSettings.java
@@ -26,14 +26,14 @@
 /**
  * Defines the task settings for internal rerank service.
  */
-public class RerankTaskSettings implements TaskSettings {
+public class CustomElandRerankTaskSettings implements TaskSettings {
 
     public static final String NAME = "custom_eland_rerank_task_settings";
     public static final String RETURN_DOCUMENTS = "return_documents";
 
-    static final RerankTaskSettings DEFAULT_SETTINGS = new RerankTaskSettings(Boolean.TRUE);
+    static final CustomElandRerankTaskSettings DEFAULT_SETTINGS = new CustomElandRerankTaskSettings(Boolean.TRUE);
 
-    public static RerankTaskSettings defaultsFromMap(Map<String, Object> map) {
+    public static CustomElandRerankTaskSettings defaultsFromMap(Map<String, Object> map) {
         ValidationException validationException = new ValidationException();
 
         if (map == null || map.isEmpty()) {
@@ -49,7 +49,7 @@ public static RerankTaskSettings defaultsFromMap(Map<String, Object> map) {
             returnDocuments = true;
         }
 
-        return new RerankTaskSettings(returnDocuments);
+        return new CustomElandRerankTaskSettings(returnDocuments);
     }
 
     /**
@@ -57,13 +57,13 @@ public static RerankTaskSettings defaultsFromMap(Map<String, Object> map) {
      * @param map source map
      * @return Task settings
      */
-    public static RerankTaskSettings fromMap(Map<String, Object> map) {
+    public static CustomElandRerankTaskSettings fromMap(Map<String, Object> map) {
         if (map == null || map.isEmpty()) {
             return DEFAULT_SETTINGS;
         }
 
         Boolean returnDocuments = extractOptionalBoolean(map, RETURN_DOCUMENTS, new ValidationException());
-        return new RerankTaskSettings(returnDocuments);
+        return new CustomElandRerankTaskSettings(returnDocuments);
     }
 
     /**
@@ -74,17 +74,20 @@ public static RerankTaskSettings fromMap(Map<String, Object> map) {
      * @param requestTaskSettings the settings passed in within the task_settings field of the request
      * @return Either {@code originalSettings} or {@code requestTaskSettings}
      */
-    public static RerankTaskSettings of(RerankTaskSettings originalSettings, RerankTaskSettings requestTaskSettings) {
+    public static CustomElandRerankTaskSettings of(
+        CustomElandRerankTaskSettings originalSettings,
+        CustomElandRerankTaskSettings requestTaskSettings
+    ) {
         return requestTaskSettings.returnDocuments() != null ? requestTaskSettings : originalSettings;
     }
 
     private final Boolean returnDocuments;
 
-    public RerankTaskSettings(StreamInput in) throws IOException {
+    public CustomElandRerankTaskSettings(StreamInput in) throws IOException {
         this(in.readOptionalBoolean());
     }
 
-    public RerankTaskSettings(@Nullable Boolean doReturnDocuments) {
+    public CustomElandRerankTaskSettings(@Nullable Boolean doReturnDocuments) {
         if (doReturnDocuments == null) {
             this.returnDocuments = true;
         } else {
@@ -130,7 +133,7 @@ public Boolean returnDocuments() {
     public boolean equals(Object o) {
         if (this == o) return true;
         if (o == null || getClass() != o.getClass()) return false;
-        RerankTaskSettings that = (RerankTaskSettings) o;
+        CustomElandRerankTaskSettings that = (CustomElandRerankTaskSettings) o;
         return Objects.equals(returnDocuments, that.returnDocuments);
     }
 
@@ -141,7 +144,7 @@ public int hashCode() {
 
     @Override
     public TaskSettings updatedTaskSettings(Map<String, Object> newSettings) {
-        RerankTaskSettings updatedSettings = RerankTaskSettings.fromMap(new HashMap<>(newSettings));
+        CustomElandRerankTaskSettings updatedSettings = CustomElandRerankTaskSettings.fromMap(new HashMap<>(newSettings));
         return of(this, updatedSettings);
     }
 }
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticRerankerModel.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticRerankerModel.java
index 276bce6dbe8f8..115cc9f05599a 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticRerankerModel.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticRerankerModel.java
@@ -9,6 +9,7 @@
 
 import org.elasticsearch.ResourceNotFoundException;
 import org.elasticsearch.action.ActionListener;
+import org.elasticsearch.inference.ChunkingSettings;
 import org.elasticsearch.inference.Model;
 import org.elasticsearch.inference.TaskType;
 import org.elasticsearch.xpack.core.ml.action.CreateTrainedModelAssignmentAction;
@@ -21,9 +22,9 @@ public ElasticRerankerModel(
         TaskType taskType,
         String service,
         ElasticRerankerServiceSettings serviceSettings,
-        RerankTaskSettings taskSettings
+        ChunkingSettings chunkingSettings
     ) {
-        super(inferenceEntityId, taskType, service, serviceSettings, taskSettings);
+        super(inferenceEntityId, taskType, service, serviceSettings, chunkingSettings);
     }
 
     @Override
diff --git a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalService.java b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalService.java
index 5f613d6be5869..8cb91782e238e 100644
--- a/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalService.java
+++ b/x-pack/plugin/inference/src/main/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalService.java
@@ -103,7 +103,6 @@ public class ElasticsearchInternalService extends BaseElasticsearchInternalServi
     public static final int EMBEDDING_MAX_BATCH_SIZE = 10;
     public static final String DEFAULT_ELSER_ID = ".elser-2-elasticsearch";
     public static final String DEFAULT_E5_ID = ".multilingual-e5-small-elasticsearch";
-    public static final String DEFAULT_RERANK_ID = ".rerank-v1-elasticsearch";
 
     private static final EnumSet<TaskType> supportedTaskTypes = EnumSet.of(
         TaskType.RERANK,
@@ -228,7 +227,7 @@ public void parseRequestConfig(
                     )
                 );
             } else if (RERANKER_ID.equals(modelId)) {
-                rerankerCase(inferenceEntityId, taskType, config, serviceSettingsMap, taskSettingsMap, modelListener);
+                rerankerCase(inferenceEntityId, taskType, config, serviceSettingsMap, chunkingSettings, modelListener);
             } else {
                 customElandCase(inferenceEntityId, taskType, serviceSettingsMap, taskSettingsMap, chunkingSettings, modelListener);
             }
@@ -311,7 +310,7 @@ private static CustomElandModel createCustomElandModel(
                 taskType,
                 NAME,
                 elandServiceSettings(serviceSettings, context),
-                RerankTaskSettings.fromMap(taskSettings)
+                CustomElandRerankTaskSettings.fromMap(taskSettings)
             );
             default -> throw new ElasticsearchStatusException(TaskType.unsupportedTaskTypeErrorMsg(taskType, NAME), RestStatus.BAD_REQUEST);
         };
@@ -334,7 +333,7 @@ private void rerankerCase(
         TaskType taskType,
         Map<String, Object> config,
         Map<String, Object> serviceSettingsMap,
-        Map<String, Object> taskSettingsMap,
+        ChunkingSettings chunkingSettings,
         ActionListener<Model> modelListener
     ) {
 
@@ -349,7 +348,7 @@ private void rerankerCase(
                 taskType,
                 NAME,
                 new ElasticRerankerServiceSettings(esServiceSettingsBuilder.build()),
-                RerankTaskSettings.fromMap(taskSettingsMap)
+                chunkingSettings
             )
         );
     }
@@ -515,14 +514,6 @@ public Model parsePersistedConfig(String inferenceEntityId, TaskType taskType, M
                 ElserMlNodeTaskSettings.DEFAULT,
                 chunkingSettings
             );
-        } else if (modelId.equals(RERANKER_ID)) {
-            return new ElasticRerankerModel(
-                inferenceEntityId,
-                taskType,
-                NAME,
-                new ElasticRerankerServiceSettings(ElasticsearchInternalServiceSettings.fromPersistedMap(serviceSettingsMap)),
-                RerankTaskSettings.fromMap(taskSettingsMap)
-            );
         } else {
             return createCustomElandModel(
                 inferenceEntityId,
@@ -674,23 +665,21 @@ public void inferRerank(
     ) {
         var request = buildInferenceRequest(model.mlNodeDeploymentId(), new TextSimilarityConfigUpdate(query), inputs, inputType, timeout);
 
-        var returnDocs = Boolean.TRUE;
-        if (model.getTaskSettings() instanceof RerankTaskSettings modelSettings) {
-            var requestSettings = RerankTaskSettings.fromMap(requestTaskSettings);
-            returnDocs = RerankTaskSettings.of(modelSettings, requestSettings).returnDocuments();
-        }
+        var modelSettings = (CustomElandRerankTaskSettings) model.getTaskSettings();
+        var requestSettings = CustomElandRerankTaskSettings.fromMap(requestTaskSettings);
+        Boolean returnDocs = CustomElandRerankTaskSettings.of(modelSettings, requestSettings).returnDocuments();
 
         Function<Integer, String> inputSupplier = returnDocs == Boolean.TRUE ? inputs::get : i -> null;
 
-        ActionListener<InferModelAction.Response> mlResultsListener = listener.delegateFailureAndWrap(
-            (l, inferenceResult) -> l.onResponse(textSimilarityResultsToRankedDocs(inferenceResult.getInferenceResults(), inputSupplier))
-        );
-
-        var maybeDeployListener = mlResultsListener.delegateResponse(
-            (l, exception) -> maybeStartDeployment(model, exception, request, mlResultsListener)
+        client.execute(
+            InferModelAction.INSTANCE,
+            request,
+            listener.delegateFailureAndWrap(
+                (l, inferenceResult) -> l.onResponse(
+                    textSimilarityResultsToRankedDocs(inferenceResult.getInferenceResults(), inputSupplier)
+                )
+            )
         );
-
-        client.execute(InferModelAction.INSTANCE, request, maybeDeployListener);
     }
 
     public void chunkedInfer(
@@ -834,8 +823,7 @@ private RankedDocsResults textSimilarityResultsToRankedDocs(
     public List<DefaultConfigId> defaultConfigIds() {
         return List.of(
             new DefaultConfigId(DEFAULT_ELSER_ID, TaskType.SPARSE_EMBEDDING, this),
-            new DefaultConfigId(DEFAULT_E5_ID, TaskType.TEXT_EMBEDDING, this),
-            new DefaultConfigId(DEFAULT_RERANK_ID, TaskType.RERANK, this)
+            new DefaultConfigId(DEFAULT_E5_ID, TaskType.TEXT_EMBEDDING, this)
         );
     }
 
@@ -928,19 +916,12 @@ private List<Model> defaultConfigs(boolean useLinuxOptimizedModel) {
             ),
             ChunkingSettingsBuilder.DEFAULT_SETTINGS
         );
-        var defaultRerank = new ElasticRerankerModel(
-            DEFAULT_RERANK_ID,
-            TaskType.RERANK,
-            NAME,
-            new ElasticRerankerServiceSettings(null, 1, RERANKER_ID, new AdaptiveAllocationsSettings(Boolean.TRUE, 0, 32)),
-            RerankTaskSettings.DEFAULT_SETTINGS
-        );
-        return List.of(defaultElser, defaultE5, defaultRerank);
+        return List.of(defaultElser, defaultE5);
     }
 
     @Override
     boolean isDefaultId(String inferenceId) {
-        return DEFAULT_ELSER_ID.equals(inferenceId) || DEFAULT_E5_ID.equals(inferenceId) || DEFAULT_RERANK_ID.equals(inferenceId);
+        return DEFAULT_ELSER_ID.equals(inferenceId) || DEFAULT_E5_ID.equals(inferenceId);
     }
 
     static EmbeddingRequestChunker.EmbeddingType embeddingTypeFromTaskTypeAndSettings(
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/RerankTaskSettingsTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankTaskSettingsTests.java
similarity index 53%
rename from x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/RerankTaskSettingsTests.java
rename to x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankTaskSettingsTests.java
index 255454a1ed62b..4207896fc54f3 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/RerankTaskSettingsTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/CustomElandRerankTaskSettingsTests.java
@@ -22,7 +22,7 @@
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.sameInstance;
 
-public class RerankTaskSettingsTests extends AbstractWireSerializingTestCase<RerankTaskSettings> {
+public class CustomElandRerankTaskSettingsTests extends AbstractWireSerializingTestCase<CustomElandRerankTaskSettings> {
 
     public void testIsEmpty() {
         var randomSettings = createRandom();
@@ -35,9 +35,9 @@ public void testUpdatedTaskSettings() {
         var newSettings = createRandom();
         Map<String, Object> newSettingsMap = new HashMap<>();
         if (newSettings.returnDocuments() != null) {
-            newSettingsMap.put(RerankTaskSettings.RETURN_DOCUMENTS, newSettings.returnDocuments());
+            newSettingsMap.put(CustomElandRerankTaskSettings.RETURN_DOCUMENTS, newSettings.returnDocuments());
         }
-        RerankTaskSettings updatedSettings = (RerankTaskSettings) initialSettings.updatedTaskSettings(
+        CustomElandRerankTaskSettings updatedSettings = (CustomElandRerankTaskSettings) initialSettings.updatedTaskSettings(
             Collections.unmodifiableMap(newSettingsMap)
         );
         if (newSettings.returnDocuments() == null) {
@@ -48,37 +48,37 @@ public void testUpdatedTaskSettings() {
     }
 
     public void testDefaultsFromMap_MapIsNull_ReturnsDefaultSettings() {
-        var rerankTaskSettings = RerankTaskSettings.defaultsFromMap(null);
+        var customElandRerankTaskSettings = CustomElandRerankTaskSettings.defaultsFromMap(null);
 
-        assertThat(rerankTaskSettings, sameInstance(RerankTaskSettings.DEFAULT_SETTINGS));
+        assertThat(customElandRerankTaskSettings, sameInstance(CustomElandRerankTaskSettings.DEFAULT_SETTINGS));
     }
 
     public void testDefaultsFromMap_MapIsEmpty_ReturnsDefaultSettings() {
-        var rerankTaskSettings = RerankTaskSettings.defaultsFromMap(new HashMap<>());
+        var customElandRerankTaskSettings = CustomElandRerankTaskSettings.defaultsFromMap(new HashMap<>());
 
-        assertThat(rerankTaskSettings, sameInstance(RerankTaskSettings.DEFAULT_SETTINGS));
+        assertThat(customElandRerankTaskSettings, sameInstance(CustomElandRerankTaskSettings.DEFAULT_SETTINGS));
     }
 
     public void testDefaultsFromMap_ExtractedReturnDocumentsNull_SetsReturnDocumentToTrue() {
-        var rerankTaskSettings = RerankTaskSettings.defaultsFromMap(new HashMap<>());
+        var customElandRerankTaskSettings = CustomElandRerankTaskSettings.defaultsFromMap(new HashMap<>());
 
-        assertThat(rerankTaskSettings.returnDocuments(), is(Boolean.TRUE));
+        assertThat(customElandRerankTaskSettings.returnDocuments(), is(Boolean.TRUE));
     }
 
     public void testFromMap_MapIsNull_ReturnsDefaultSettings() {
-        var rerankTaskSettings = RerankTaskSettings.fromMap(null);
+        var customElandRerankTaskSettings = CustomElandRerankTaskSettings.fromMap(null);
 
-        assertThat(rerankTaskSettings, sameInstance(RerankTaskSettings.DEFAULT_SETTINGS));
+        assertThat(customElandRerankTaskSettings, sameInstance(CustomElandRerankTaskSettings.DEFAULT_SETTINGS));
     }
 
     public void testFromMap_MapIsEmpty_ReturnsDefaultSettings() {
-        var rerankTaskSettings = RerankTaskSettings.fromMap(new HashMap<>());
+        var customElandRerankTaskSettings = CustomElandRerankTaskSettings.fromMap(new HashMap<>());
 
-        assertThat(rerankTaskSettings, sameInstance(RerankTaskSettings.DEFAULT_SETTINGS));
+        assertThat(customElandRerankTaskSettings, sameInstance(CustomElandRerankTaskSettings.DEFAULT_SETTINGS));
     }
 
     public void testToXContent_WritesAllValues() throws IOException {
-        var serviceSettings = new RerankTaskSettings(Boolean.TRUE);
+        var serviceSettings = new CustomElandRerankTaskSettings(Boolean.TRUE);
 
         XContentBuilder builder = XContentFactory.contentBuilder(XContentType.JSON);
         serviceSettings.toXContent(builder, null);
@@ -89,30 +89,30 @@ public void testToXContent_WritesAllValues() throws IOException {
     }
 
     public void testOf_PrefersNonNullRequestTaskSettings() {
-        var originalSettings = new RerankTaskSettings(Boolean.FALSE);
-        var requestTaskSettings = new RerankTaskSettings(Boolean.TRUE);
+        var originalSettings = new CustomElandRerankTaskSettings(Boolean.FALSE);
+        var requestTaskSettings = new CustomElandRerankTaskSettings(Boolean.TRUE);
 
-        var taskSettings = RerankTaskSettings.of(originalSettings, requestTaskSettings);
+        var taskSettings = CustomElandRerankTaskSettings.of(originalSettings, requestTaskSettings);
 
         assertThat(taskSettings, sameInstance(requestTaskSettings));
     }
 
-    private static RerankTaskSettings createRandom() {
-        return new RerankTaskSettings(randomOptionalBoolean());
+    private static CustomElandRerankTaskSettings createRandom() {
+        return new CustomElandRerankTaskSettings(randomOptionalBoolean());
     }
 
     @Override
-    protected Writeable.Reader<RerankTaskSettings> instanceReader() {
-        return RerankTaskSettings::new;
+    protected Writeable.Reader<CustomElandRerankTaskSettings> instanceReader() {
+        return CustomElandRerankTaskSettings::new;
     }
 
     @Override
-    protected RerankTaskSettings createTestInstance() {
+    protected CustomElandRerankTaskSettings createTestInstance() {
         return createRandom();
     }
 
     @Override
-    protected RerankTaskSettings mutateInstance(RerankTaskSettings instance) throws IOException {
-        return randomValueOtherThan(instance, RerankTaskSettingsTests::createRandom);
+    protected CustomElandRerankTaskSettings mutateInstance(CustomElandRerankTaskSettings instance) throws IOException {
+        return randomValueOtherThan(instance, CustomElandRerankTaskSettingsTests::createRandom);
     }
 }
diff --git a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalServiceTests.java b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalServiceTests.java
index 17e6583f11c8f..306509ea60cfc 100644
--- a/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalServiceTests.java
+++ b/x-pack/plugin/inference/src/test/java/org/elasticsearch/xpack/inference/services/elasticsearch/ElasticsearchInternalServiceTests.java
@@ -534,13 +534,16 @@ public void testParseRequestConfig_Rerank() {
                 )
             );
             var returnDocs = randomBoolean();
-            settings.put(ModelConfigurations.TASK_SETTINGS, new HashMap<>(Map.of(RerankTaskSettings.RETURN_DOCUMENTS, returnDocs)));
+            settings.put(
+                ModelConfigurations.TASK_SETTINGS,
+                new HashMap<>(Map.of(CustomElandRerankTaskSettings.RETURN_DOCUMENTS, returnDocs))
+            );
 
             ActionListener<Model> modelListener = ActionListener.<Model>wrap(model -> {
                 assertThat(model, instanceOf(CustomElandRerankModel.class));
-                assertThat(model.getTaskSettings(), instanceOf(RerankTaskSettings.class));
+                assertThat(model.getTaskSettings(), instanceOf(CustomElandRerankTaskSettings.class));
                 assertThat(model.getServiceSettings(), instanceOf(CustomElandInternalServiceSettings.class));
-                assertEquals(returnDocs, ((RerankTaskSettings) model.getTaskSettings()).returnDocuments());
+                assertEquals(returnDocs, ((CustomElandRerankTaskSettings) model.getTaskSettings()).returnDocuments());
             }, e -> { fail("Model parsing failed " + e.getMessage()); });
 
             service.parseRequestConfig(randomInferenceEntityId, TaskType.RERANK, settings, modelListener);
@@ -580,9 +583,9 @@ public void testParseRequestConfig_Rerank_DefaultTaskSettings() {
 
             ActionListener<Model> modelListener = ActionListener.<Model>wrap(model -> {
                 assertThat(model, instanceOf(CustomElandRerankModel.class));
-                assertThat(model.getTaskSettings(), instanceOf(RerankTaskSettings.class));
+                assertThat(model.getTaskSettings(), instanceOf(CustomElandRerankTaskSettings.class));
                 assertThat(model.getServiceSettings(), instanceOf(CustomElandInternalServiceSettings.class));
-                assertEquals(Boolean.TRUE, ((RerankTaskSettings) model.getTaskSettings()).returnDocuments());
+                assertEquals(Boolean.TRUE, ((CustomElandRerankTaskSettings) model.getTaskSettings()).returnDocuments());
             }, e -> { fail("Model parsing failed " + e.getMessage()); });
 
             service.parseRequestConfig(randomInferenceEntityId, TaskType.RERANK, settings, modelListener);
@@ -1246,11 +1249,14 @@ public void testParsePersistedConfig_Rerank() {
             );
             settings.put(ElasticsearchInternalServiceSettings.MODEL_ID, "foo");
             var returnDocs = randomBoolean();
-            settings.put(ModelConfigurations.TASK_SETTINGS, new HashMap<>(Map.of(RerankTaskSettings.RETURN_DOCUMENTS, returnDocs)));
+            settings.put(
+                ModelConfigurations.TASK_SETTINGS,
+                new HashMap<>(Map.of(CustomElandRerankTaskSettings.RETURN_DOCUMENTS, returnDocs))
+            );
 
             var model = service.parsePersistedConfig(randomInferenceEntityId, TaskType.RERANK, settings);
-            assertThat(model.getTaskSettings(), instanceOf(RerankTaskSettings.class));
-            assertEquals(returnDocs, ((RerankTaskSettings) model.getTaskSettings()).returnDocuments());
+            assertThat(model.getTaskSettings(), instanceOf(CustomElandRerankTaskSettings.class));
+            assertEquals(returnDocs, ((CustomElandRerankTaskSettings) model.getTaskSettings()).returnDocuments());
         }
 
         // without task settings
@@ -1273,8 +1279,8 @@ public void testParsePersistedConfig_Rerank() {
             settings.put(ElasticsearchInternalServiceSettings.MODEL_ID, "foo");
 
             var model = service.parsePersistedConfig(randomInferenceEntityId, TaskType.RERANK, settings);
-            assertThat(model.getTaskSettings(), instanceOf(RerankTaskSettings.class));
-            assertTrue(((RerankTaskSettings) model.getTaskSettings()).returnDocuments());
+            assertThat(model.getTaskSettings(), instanceOf(CustomElandRerankTaskSettings.class));
+            assertTrue(((CustomElandRerankTaskSettings) model.getTaskSettings()).returnDocuments());
         }
     }
 
@@ -1329,7 +1335,7 @@ private CustomElandModel getCustomElandModel(TaskType taskType) {
                 taskType,
                 ElasticsearchInternalService.NAME,
                 new CustomElandInternalServiceSettings(1, 4, "custom-model", null),
-                RerankTaskSettings.DEFAULT_SETTINGS
+                CustomElandRerankTaskSettings.DEFAULT_SETTINGS
             );
         } else if (taskType == TaskType.TEXT_EMBEDDING) {
             var serviceSettings = new CustomElandInternalTextEmbeddingServiceSettings(1, 4, "custom-model", null);
@@ -1522,30 +1528,20 @@ public void testEmbeddingTypeFromTaskTypeAndSettings() {
             )
         );
 
-        var e1 = expectThrows(
+        var e = expectThrows(
             ElasticsearchStatusException.class,
             () -> ElasticsearchInternalService.embeddingTypeFromTaskTypeAndSettings(
                 TaskType.COMPLETION,
                 new ElasticsearchInternalServiceSettings(1, 1, "foo", null)
             )
         );
-        assertThat(e1.getMessage(), containsString("Chunking is not supported for task type [completion]"));
-
-        var e2 = expectThrows(
-            ElasticsearchStatusException.class,
-            () -> ElasticsearchInternalService.embeddingTypeFromTaskTypeAndSettings(
-                TaskType.RERANK,
-                new ElasticsearchInternalServiceSettings(1, 1, "foo", null)
-            )
-        );
-        assertThat(e2.getMessage(), containsString("Chunking is not supported for task type [rerank]"));
+        assertThat(e.getMessage(), containsString("Chunking is not supported for task type [completion]"));
     }
 
     public void testIsDefaultId() {
         var service = createService(mock(Client.class));
         assertTrue(service.isDefaultId(".elser-2-elasticsearch"));
         assertTrue(service.isDefaultId(".multilingual-e5-small-elasticsearch"));
-        assertTrue(service.isDefaultId(".rerank-v1-elasticsearch"));
         assertFalse(service.isDefaultId("foo"));
     }
 

From ec66857ca13e2f5e7f9088a30aa48ea5ddab17fa Mon Sep 17 00:00:00 2001
From: Simon Cooper <simon.cooper@elastic.co>
Date: Mon, 9 Dec 2024 10:03:14 +0000
Subject: [PATCH 117/119] Remove pre-7.2 token serialization support (#118057)

---
 .../org/elasticsearch/TransportVersions.java  |   2 -
 .../security/SecurityFeatureSetUsage.java     |  12 +-
 .../support/TokensInvalidationResult.java     |   6 -
 .../security/authc/TokenAuthIntegTests.java   |  37 ++-
 .../xpack/security/authc/TokenService.java    | 236 +++++------------
 .../security/authc/TokenServiceTests.java     | 241 +-----------------
 6 files changed, 88 insertions(+), 446 deletions(-)

diff --git a/server/src/main/java/org/elasticsearch/TransportVersions.java b/server/src/main/java/org/elasticsearch/TransportVersions.java
index 1a1219825bbbe..40a209c5f0f14 100644
--- a/server/src/main/java/org/elasticsearch/TransportVersions.java
+++ b/server/src/main/java/org/elasticsearch/TransportVersions.java
@@ -54,11 +54,9 @@ static TransportVersion def(int id) {
     public static final TransportVersion ZERO = def(0);
     public static final TransportVersion V_7_0_0 = def(7_00_00_99);
     public static final TransportVersion V_7_0_1 = def(7_00_01_99);
-    public static final TransportVersion V_7_1_0 = def(7_01_00_99);
     public static final TransportVersion V_7_2_0 = def(7_02_00_99);
     public static final TransportVersion V_7_2_1 = def(7_02_01_99);
     public static final TransportVersion V_7_3_0 = def(7_03_00_99);
-    public static final TransportVersion V_7_3_2 = def(7_03_02_99);
     public static final TransportVersion V_7_4_0 = def(7_04_00_99);
     public static final TransportVersion V_7_5_0 = def(7_05_00_99);
     public static final TransportVersion V_7_6_0 = def(7_06_00_99);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/SecurityFeatureSetUsage.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/SecurityFeatureSetUsage.java
index 2793ddea3bd06..33f1a9a469b69 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/SecurityFeatureSetUsage.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/SecurityFeatureSetUsage.java
@@ -55,10 +55,8 @@ public SecurityFeatureSetUsage(StreamInput in) throws IOException {
         realmsUsage = in.readGenericMap();
         rolesStoreUsage = in.readGenericMap();
         sslUsage = in.readGenericMap();
-        if (in.getTransportVersion().onOrAfter(TransportVersions.V_7_2_0)) {
-            tokenServiceUsage = in.readGenericMap();
-            apiKeyServiceUsage = in.readGenericMap();
-        }
+        tokenServiceUsage = in.readGenericMap();
+        apiKeyServiceUsage = in.readGenericMap();
         auditUsage = in.readGenericMap();
         ipFilterUsage = in.readGenericMap();
         anonymousUsage = in.readGenericMap();
@@ -125,10 +123,8 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeGenericMap(realmsUsage);
         out.writeGenericMap(rolesStoreUsage);
         out.writeGenericMap(sslUsage);
-        if (out.getTransportVersion().onOrAfter(TransportVersions.V_7_2_0)) {
-            out.writeGenericMap(tokenServiceUsage);
-            out.writeGenericMap(apiKeyServiceUsage);
-        }
+        out.writeGenericMap(tokenServiceUsage);
+        out.writeGenericMap(apiKeyServiceUsage);
         out.writeGenericMap(auditUsage);
         out.writeGenericMap(ipFilterUsage);
         out.writeGenericMap(anonymousUsage);
diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/TokensInvalidationResult.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/TokensInvalidationResult.java
index 8fe018a825468..59c16fc8a7a72 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/TokensInvalidationResult.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authc/support/TokensInvalidationResult.java
@@ -59,9 +59,6 @@ public TokensInvalidationResult(StreamInput in) throws IOException {
         this.invalidatedTokens = in.readStringCollectionAsList();
         this.previouslyInvalidatedTokens = in.readStringCollectionAsList();
         this.errors = in.readCollectionAsList(StreamInput::readException);
-        if (in.getTransportVersion().before(TransportVersions.V_7_2_0)) {
-            in.readVInt();
-        }
         if (in.getTransportVersion().onOrAfter(TransportVersions.V_8_0_0)) {
             this.restStatus = RestStatus.readFrom(in);
         }
@@ -111,9 +108,6 @@ public void writeTo(StreamOutput out) throws IOException {
         out.writeStringCollection(invalidatedTokens);
         out.writeStringCollection(previouslyInvalidatedTokens);
         out.writeCollection(errors, StreamOutput::writeException);
-        if (out.getTransportVersion().before(TransportVersions.V_7_2_0)) {
-            out.writeVInt(5);
-        }
         if (out.getTransportVersion().onOrAfter(TransportVersions.V_8_0_0)) {
             RestStatus.writeTo(out, restStatus);
         }
diff --git a/x-pack/plugin/security/src/internalClusterTest/java/org/elasticsearch/xpack/security/authc/TokenAuthIntegTests.java b/x-pack/plugin/security/src/internalClusterTest/java/org/elasticsearch/xpack/security/authc/TokenAuthIntegTests.java
index fef1a98ca67e9..b56ea7ae3e456 100644
--- a/x-pack/plugin/security/src/internalClusterTest/java/org/elasticsearch/xpack/security/authc/TokenAuthIntegTests.java
+++ b/x-pack/plugin/security/src/internalClusterTest/java/org/elasticsearch/xpack/security/authc/TokenAuthIntegTests.java
@@ -327,8 +327,8 @@ public void testInvalidateNotValidAccessTokens() throws Exception {
             ResponseException.class,
             () -> invalidateAccessToken(
                 tokenService.prependVersionAndEncodeAccessToken(
-                    TransportVersions.V_7_3_2,
-                    tokenService.getRandomTokenBytes(TransportVersions.V_7_3_2, randomBoolean()).v1()
+                    TransportVersions.MINIMUM_COMPATIBLE,
+                    tokenService.getRandomTokenBytes(TransportVersions.MINIMUM_COMPATIBLE, randomBoolean()).v1()
                 )
             )
         );
@@ -347,7 +347,7 @@ public void testInvalidateNotValidAccessTokens() throws Exception {
         byte[] longerAccessToken = new byte[randomIntBetween(17, 24)];
         random().nextBytes(longerAccessToken);
         invalidateResponse = invalidateAccessToken(
-            tokenService.prependVersionAndEncodeAccessToken(TransportVersions.V_7_3_2, longerAccessToken)
+            tokenService.prependVersionAndEncodeAccessToken(TransportVersions.MINIMUM_COMPATIBLE, longerAccessToken)
         );
         assertThat(invalidateResponse.invalidated(), equalTo(0));
         assertThat(invalidateResponse.previouslyInvalidated(), equalTo(0));
@@ -365,7 +365,7 @@ public void testInvalidateNotValidAccessTokens() throws Exception {
         byte[] shorterAccessToken = new byte[randomIntBetween(12, 15)];
         random().nextBytes(shorterAccessToken);
         invalidateResponse = invalidateAccessToken(
-            tokenService.prependVersionAndEncodeAccessToken(TransportVersions.V_7_3_2, shorterAccessToken)
+            tokenService.prependVersionAndEncodeAccessToken(TransportVersions.MINIMUM_COMPATIBLE, shorterAccessToken)
         );
         assertThat(invalidateResponse.invalidated(), equalTo(0));
         assertThat(invalidateResponse.previouslyInvalidated(), equalTo(0));
@@ -394,8 +394,8 @@ public void testInvalidateNotValidAccessTokens() throws Exception {
 
         invalidateResponse = invalidateAccessToken(
             tokenService.prependVersionAndEncodeAccessToken(
-                TransportVersions.V_7_3_2,
-                tokenService.getRandomTokenBytes(TransportVersions.V_7_3_2, randomBoolean()).v1()
+                TransportVersions.MINIMUM_COMPATIBLE,
+                tokenService.getRandomTokenBytes(TransportVersions.MINIMUM_COMPATIBLE, randomBoolean()).v1()
             )
         );
         assertThat(invalidateResponse.invalidated(), equalTo(0));
@@ -420,8 +420,8 @@ public void testInvalidateNotValidRefreshTokens() throws Exception {
             ResponseException.class,
             () -> invalidateRefreshToken(
                 TokenService.prependVersionAndEncodeRefreshToken(
-                    TransportVersions.V_7_3_2,
-                    tokenService.getRandomTokenBytes(TransportVersions.V_7_3_2, true).v2()
+                    TransportVersions.MINIMUM_COMPATIBLE,
+                    tokenService.getRandomTokenBytes(TransportVersions.MINIMUM_COMPATIBLE, true).v2()
                 )
             )
         );
@@ -441,7 +441,7 @@ public void testInvalidateNotValidRefreshTokens() throws Exception {
         byte[] longerRefreshToken = new byte[randomIntBetween(17, 24)];
         random().nextBytes(longerRefreshToken);
         invalidateResponse = invalidateRefreshToken(
-            TokenService.prependVersionAndEncodeRefreshToken(TransportVersions.V_7_3_2, longerRefreshToken)
+            TokenService.prependVersionAndEncodeRefreshToken(TransportVersions.MINIMUM_COMPATIBLE, longerRefreshToken)
         );
         assertThat(invalidateResponse.invalidated(), equalTo(0));
         assertThat(invalidateResponse.previouslyInvalidated(), equalTo(0));
@@ -459,7 +459,7 @@ public void testInvalidateNotValidRefreshTokens() throws Exception {
         byte[] shorterRefreshToken = new byte[randomIntBetween(12, 15)];
         random().nextBytes(shorterRefreshToken);
         invalidateResponse = invalidateRefreshToken(
-            TokenService.prependVersionAndEncodeRefreshToken(TransportVersions.V_7_3_2, shorterRefreshToken)
+            TokenService.prependVersionAndEncodeRefreshToken(TransportVersions.MINIMUM_COMPATIBLE, shorterRefreshToken)
         );
         assertThat(invalidateResponse.invalidated(), equalTo(0));
         assertThat(invalidateResponse.previouslyInvalidated(), equalTo(0));
@@ -488,8 +488,8 @@ public void testInvalidateNotValidRefreshTokens() throws Exception {
 
         invalidateResponse = invalidateRefreshToken(
             TokenService.prependVersionAndEncodeRefreshToken(
-                TransportVersions.V_7_3_2,
-                tokenService.getRandomTokenBytes(TransportVersions.V_7_3_2, true).v2()
+                TransportVersions.MINIMUM_COMPATIBLE,
+                tokenService.getRandomTokenBytes(TransportVersions.MINIMUM_COMPATIBLE, true).v2()
             )
         );
         assertThat(invalidateResponse.invalidated(), equalTo(0));
@@ -758,18 +758,11 @@ public void testAuthenticateWithWrongToken() throws Exception {
         assertAuthenticateWithToken(response.accessToken(), TEST_USER_NAME);
         // Now attempt to authenticate with an invalid access token string
         assertUnauthorizedToken(randomAlphaOfLengthBetween(0, 128));
-        // Now attempt to authenticate with an invalid access token with valid structure (pre 7.2)
+        // Now attempt to authenticate with an invalid access token with valid structure (after 8.0 pre 8.10)
         assertUnauthorizedToken(
             tokenService.prependVersionAndEncodeAccessToken(
-                TransportVersions.V_7_1_0,
-                tokenService.getRandomTokenBytes(TransportVersions.V_7_1_0, randomBoolean()).v1()
-            )
-        );
-        // Now attempt to authenticate with an invalid access token with valid structure (after 7.2 pre 8.10)
-        assertUnauthorizedToken(
-            tokenService.prependVersionAndEncodeAccessToken(
-                TransportVersions.V_7_4_0,
-                tokenService.getRandomTokenBytes(TransportVersions.V_7_4_0, randomBoolean()).v1()
+                TransportVersions.V_8_0_0,
+                tokenService.getRandomTokenBytes(TransportVersions.V_8_0_0, randomBoolean()).v1()
             )
         );
         // Now attempt to authenticate with an invalid access token with valid structure (current version)
diff --git a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/TokenService.java b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/TokenService.java
index 4f7ba7808b823..900436a1fd874 100644
--- a/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/TokenService.java
+++ b/x-pack/plugin/security/src/main/java/org/elasticsearch/xpack/security/authc/TokenService.java
@@ -48,9 +48,7 @@
 import org.elasticsearch.common.cache.CacheBuilder;
 import org.elasticsearch.common.io.stream.BytesStreamOutput;
 import org.elasticsearch.common.io.stream.InputStreamStreamInput;
-import org.elasticsearch.common.io.stream.OutputStreamStreamOutput;
 import org.elasticsearch.common.io.stream.StreamInput;
-import org.elasticsearch.common.io.stream.StreamOutput;
 import org.elasticsearch.common.settings.SecureString;
 import org.elasticsearch.common.settings.Setting;
 import org.elasticsearch.common.settings.Setting.Property;
@@ -59,7 +57,6 @@
 import org.elasticsearch.common.util.concurrent.AbstractRunnable;
 import org.elasticsearch.common.util.concurrent.ThreadContext;
 import org.elasticsearch.core.Nullable;
-import org.elasticsearch.core.Streams;
 import org.elasticsearch.core.SuppressForbidden;
 import org.elasticsearch.core.TimeValue;
 import org.elasticsearch.core.Tuple;
@@ -93,10 +90,8 @@
 import org.elasticsearch.xpack.security.support.SecurityIndexManager;
 
 import java.io.ByteArrayInputStream;
-import java.io.ByteArrayOutputStream;
 import java.io.Closeable;
 import java.io.IOException;
-import java.io.OutputStream;
 import java.io.UncheckedIOException;
 import java.nio.ByteBuffer;
 import java.nio.charset.StandardCharsets;
@@ -132,7 +127,6 @@
 
 import javax.crypto.Cipher;
 import javax.crypto.CipherInputStream;
-import javax.crypto.CipherOutputStream;
 import javax.crypto.NoSuchPaddingException;
 import javax.crypto.SecretKey;
 import javax.crypto.SecretKeyFactory;
@@ -201,14 +195,8 @@ public class TokenService {
     // UUIDs are 16 bytes encoded base64 without padding, therefore the length is (16 / 3) * 4 + ((16 % 3) * 8 + 5) / 6 chars
     private static final int TOKEN_LENGTH = 22;
     private static final String TOKEN_DOC_ID_PREFIX = TOKEN_DOC_TYPE + "_";
-    static final int LEGACY_MINIMUM_BYTES = VERSION_BYTES + SALT_BYTES + IV_BYTES + 1;
     static final int MINIMUM_BYTES = VERSION_BYTES + TOKEN_LENGTH + 1;
-    static final int LEGACY_MINIMUM_BASE64_BYTES = Double.valueOf(Math.ceil((4 * LEGACY_MINIMUM_BYTES) / 3)).intValue();
     public static final int MINIMUM_BASE64_BYTES = Double.valueOf(Math.ceil((4 * MINIMUM_BYTES) / 3)).intValue();
-    static final TransportVersion VERSION_HASHED_TOKENS = TransportVersions.V_7_2_0;
-    static final TransportVersion VERSION_TOKENS_INDEX_INTRODUCED = TransportVersions.V_7_2_0;
-    static final TransportVersion VERSION_ACCESS_TOKENS_AS_UUIDS = TransportVersions.V_7_2_0;
-    static final TransportVersion VERSION_MULTIPLE_CONCURRENT_REFRESHES = TransportVersions.V_7_2_0;
     static final TransportVersion VERSION_CLIENT_AUTH_FOR_REFRESH = TransportVersions.V_8_2_0;
     static final TransportVersion VERSION_GET_TOKEN_DOC_FOR_REFRESH = TransportVersions.V_8_10_X;
 
@@ -273,8 +261,7 @@ public TokenService(
 
     /**
      * Creates an access token and optionally a refresh token as well, based on the provided authentication and metadata with
-     * auto-generated values. The created tokens are stored in the security index for versions up to
-     * {@link #VERSION_TOKENS_INDEX_INTRODUCED} and to a specific security tokens index for later versions.
+     * auto-generated values. The created tokens are stored a specific security tokens index.
      */
     public void createOAuth2Tokens(
         Authentication authentication,
@@ -291,8 +278,7 @@ public void createOAuth2Tokens(
 
     /**
      * Creates an access token and optionally a refresh token as well from predefined values, based on the provided authentication and
-     * metadata. The created tokens are stored in the security index for versions up to {@link #VERSION_TOKENS_INDEX_INTRODUCED} and to a
-     * specific security tokens index for later versions.
+     * metadata. The created tokens are stored in a specific security tokens index.
      */
     // public for testing
     public void createOAuth2Tokens(
@@ -314,21 +300,15 @@ public void createOAuth2Tokens(
      *
      * @param accessTokenBytes      The predefined seed value for the access token. This will then be
      *                              <ul>
-     *                                <li> Encrypted before stored for versions before {@link #VERSION_TOKENS_INDEX_INTRODUCED} </li>
-     *                                <li> Hashed before stored for versions after {@link #VERSION_TOKENS_INDEX_INTRODUCED} </li>
-     *                                <li> Stored in the security index for versions up to {@link #VERSION_TOKENS_INDEX_INTRODUCED}</li>
-     *                                <li> Stored in a specific security tokens index for versions after
-     *                                {@link #VERSION_TOKENS_INDEX_INTRODUCED}</li>
+     *                                <li> Hashed before stored </li>
+     *                                <li> Stored in a specific security tokens index </li>
      *                                <li> Prepended with a version ID and Base64 encoded before returned to the caller of the APIs</li>
      *                              </ul>
      * @param refreshTokenBytes     The predefined seed value for the access token. This will then be
      *                              <ul>
-     *                                <li> Hashed before stored for versions after {@link #VERSION_TOKENS_INDEX_INTRODUCED} </li>
-     *                                <li> Stored in the security index for versions up to {@link #VERSION_TOKENS_INDEX_INTRODUCED}</li>
-     *                                <li> Stored in a specific security tokens index for versions after
-     *                                {@link #VERSION_TOKENS_INDEX_INTRODUCED}</li>
-     *                                <li> Prepended with a version ID and encoded with Base64 before returned to the caller of the APIs
-     *                                for versions after {@link #VERSION_TOKENS_INDEX_INTRODUCED}</li>
+     *                                <li> Hashed before stored </li>
+     *                                <li> Stored in a specific security tokens index </li>
+     *                                <li> Prepended with a version ID and Base64 encoded before returned to the caller of the APIs </li>
      *                              </ul>
      * @param tokenVersion          The version of the nodes with which these tokens will be compatible.
      * @param authentication        The authentication object representing the user for which the tokens are created
@@ -384,7 +364,7 @@ private void createOAuth2Tokens(
                     } else {
                         refreshTokenToStore = refreshTokenToReturn = null;
                     }
-                } else if (tokenVersion.onOrAfter(VERSION_HASHED_TOKENS)) {
+                } else {
                     assert accessTokenBytes.length == RAW_TOKEN_BYTES_LENGTH;
                     userTokenId = hashTokenString(Strings.BASE_64_NO_PADDING_URL_ENCODER.encodeToString(accessTokenBytes));
                     accessTokenToStore = null;
@@ -395,18 +375,6 @@ private void createOAuth2Tokens(
                     } else {
                         refreshTokenToStore = refreshTokenToReturn = null;
                     }
-                } else {
-                    assert accessTokenBytes.length == RAW_TOKEN_BYTES_LENGTH;
-                    userTokenId = Strings.BASE_64_NO_PADDING_URL_ENCODER.encodeToString(accessTokenBytes);
-                    accessTokenToStore = null;
-                    if (refreshTokenBytes != null) {
-                        assert refreshTokenBytes.length == RAW_TOKEN_BYTES_LENGTH;
-                        refreshTokenToStore = refreshTokenToReturn = Strings.BASE_64_NO_PADDING_URL_ENCODER.encodeToString(
-                            refreshTokenBytes
-                        );
-                    } else {
-                        refreshTokenToStore = refreshTokenToReturn = null;
-                    }
                 }
                 UserToken userToken = new UserToken(userTokenId, tokenVersion, tokenAuth, getExpirationTime(), metadata);
                 tokenDocument = createTokenDocument(userToken, accessTokenToStore, refreshTokenToStore, originatingClientAuth);
@@ -419,23 +387,22 @@ private void createOAuth2Tokens(
             final RefreshPolicy tokenCreationRefreshPolicy = tokenVersion.onOrAfter(VERSION_GET_TOKEN_DOC_FOR_REFRESH)
                 ? RefreshPolicy.NONE
                 : RefreshPolicy.WAIT_UNTIL;
-            final SecurityIndexManager tokensIndex = getTokensIndexForVersion(tokenVersion);
             logger.debug(
                 () -> format(
                     "Using refresh policy [%s] when creating token doc [%s] in the security index [%s]",
                     tokenCreationRefreshPolicy,
                     documentId,
-                    tokensIndex.aliasName()
+                    securityTokensIndex.aliasName()
                 )
             );
-            final IndexRequest indexTokenRequest = client.prepareIndex(tokensIndex.aliasName())
+            final IndexRequest indexTokenRequest = client.prepareIndex(securityTokensIndex.aliasName())
                 .setId(documentId)
                 .setOpType(OpType.CREATE)
                 .setSource(tokenDocument, XContentType.JSON)
                 .setRefreshPolicy(tokenCreationRefreshPolicy)
                 .request();
-            tokensIndex.prepareIndexIfNeededThenExecute(
-                ex -> listener.onFailure(traceLog("prepare tokens index [" + tokensIndex.aliasName() + "]", documentId, ex)),
+            securityTokensIndex.prepareIndexIfNeededThenExecute(
+                ex -> listener.onFailure(traceLog("prepare tokens index [" + securityTokensIndex.aliasName() + "]", documentId, ex)),
                 () -> executeAsyncWithOrigin(
                     client,
                     SECURITY_ORIGIN,
@@ -554,17 +521,16 @@ private void getTokenDocById(
         @Nullable String storedRefreshToken,
         ActionListener<Doc> listener
     ) {
-        final SecurityIndexManager tokensIndex = getTokensIndexForVersion(tokenVersion);
-        final SecurityIndexManager frozenTokensIndex = tokensIndex.defensiveCopy();
+        final SecurityIndexManager frozenTokensIndex = securityTokensIndex.defensiveCopy();
         if (frozenTokensIndex.isAvailable(PRIMARY_SHARDS) == false) {
-            logger.warn("failed to get access token [{}] because index [{}] is not available", tokenId, tokensIndex.aliasName());
+            logger.warn("failed to get access token [{}] because index [{}] is not available", tokenId, securityTokensIndex.aliasName());
             listener.onFailure(frozenTokensIndex.getUnavailableReason(PRIMARY_SHARDS));
             return;
         }
-        final GetRequest getRequest = client.prepareGet(tokensIndex.aliasName(), getTokenDocumentId(tokenId)).request();
+        final GetRequest getRequest = client.prepareGet(securityTokensIndex.aliasName(), getTokenDocumentId(tokenId)).request();
         final Consumer<Exception> onFailure = ex -> listener.onFailure(traceLog("get token from id", tokenId, ex));
-        tokensIndex.checkIndexVersionThenExecute(
-            ex -> listener.onFailure(traceLog("prepare tokens index [" + tokensIndex.aliasName() + "]", tokenId, ex)),
+        securityTokensIndex.checkIndexVersionThenExecute(
+            ex -> listener.onFailure(traceLog("prepare tokens index [" + securityTokensIndex.aliasName() + "]", tokenId, ex)),
             () -> executeAsyncWithOrigin(
                 client.threadPool().getThreadContext(),
                 SECURITY_ORIGIN,
@@ -610,7 +576,11 @@ private void getTokenDocById(
                     // if the index or the shard is not there / available we assume that
                     // the token is not valid
                     if (isShardNotAvailableException(e)) {
-                        logger.warn("failed to get token doc [{}] because index [{}] is not available", tokenId, tokensIndex.aliasName());
+                        logger.warn(
+                            "failed to get token doc [{}] because index [{}] is not available",
+                            tokenId,
+                            securityTokensIndex.aliasName()
+                        );
                     } else {
                         logger.error(() -> "failed to get token doc [" + tokenId + "]", e);
                     }
@@ -650,7 +620,7 @@ void decodeToken(String token, boolean validateUserToken, ActionListener<UserTok
                 final String userTokenId = Strings.BASE_64_NO_PADDING_URL_ENCODER.encodeToString(userTokenIdDigest.digest());
                 final String storedAccessToken = Strings.BASE_64_NO_PADDING_URL_ENCODER.encodeToString(sha256().digest(accessTokenBytes));
                 getAndValidateUserToken(userTokenId, version, storedAccessToken, validateUserToken, listener);
-            } else if (version.onOrAfter(VERSION_ACCESS_TOKENS_AS_UUIDS)) {
+            } else {
                 // The token was created in a > VERSION_ACCESS_TOKENS_UUIDS cluster
                 if (in.available() < MINIMUM_BYTES) {
                     logger.debug("invalid token, smaller than [{}] bytes", MINIMUM_BYTES);
@@ -660,41 +630,6 @@ void decodeToken(String token, boolean validateUserToken, ActionListener<UserTok
                 final String accessToken = in.readString();
                 final String userTokenId = hashTokenString(accessToken);
                 getAndValidateUserToken(userTokenId, version, null, validateUserToken, listener);
-            } else {
-                // The token was created in a < VERSION_ACCESS_TOKENS_UUIDS cluster so we need to decrypt it to get the tokenId
-                if (in.available() < LEGACY_MINIMUM_BYTES) {
-                    logger.debug("invalid token, smaller than [{}] bytes", LEGACY_MINIMUM_BYTES);
-                    listener.onResponse(null);
-                    return;
-                }
-                final BytesKey decodedSalt = new BytesKey(in.readByteArray());
-                final BytesKey passphraseHash = new BytesKey(in.readByteArray());
-                final byte[] iv = in.readByteArray();
-                final BytesStreamOutput out = new BytesStreamOutput();
-                Streams.copy(in, out);
-                final byte[] encryptedTokenId = BytesReference.toBytes(out.bytes());
-                final KeyAndCache keyAndCache = keyCache.get(passphraseHash);
-                if (keyAndCache != null) {
-                    getKeyAsync(decodedSalt, keyAndCache, ActionListener.wrap(decodeKey -> {
-                        if (decodeKey != null) {
-                            try {
-                                final Cipher cipher = getDecryptionCipher(iv, decodeKey, version, decodedSalt);
-                                final String tokenId = decryptTokenId(encryptedTokenId, cipher, version);
-                                getAndValidateUserToken(tokenId, version, null, validateUserToken, listener);
-                            } catch (IOException | GeneralSecurityException e) {
-                                // could happen with a token that is not ours
-                                logger.warn("invalid token", e);
-                                listener.onResponse(null);
-                            }
-                        } else {
-                            // could happen with a token that is not ours
-                            listener.onResponse(null);
-                        }
-                    }, listener::onFailure));
-                } else {
-                    logger.debug(() -> format("invalid key %s key: %s", passphraseHash, keyCache.cache.keySet()));
-                    listener.onResponse(null);
-                }
             }
         } catch (Exception e) {
             // could happen with a token that is not ours
@@ -852,11 +787,7 @@ private void indexInvalidation(
         final Set<String> idsOfOlderTokens = new HashSet<>();
         boolean anyOlderTokensBeforeRefreshViaGet = false;
         for (UserToken userToken : userTokens) {
-            if (userToken.getTransportVersion().onOrAfter(VERSION_TOKENS_INDEX_INTRODUCED)) {
-                idsOfRecentTokens.add(userToken.getId());
-            } else {
-                idsOfOlderTokens.add(userToken.getId());
-            }
+            idsOfRecentTokens.add(userToken.getId());
             anyOlderTokensBeforeRefreshViaGet |= userToken.getTransportVersion().before(VERSION_GET_TOKEN_DOC_FOR_REFRESH);
         }
         final RefreshPolicy tokensInvalidationRefreshPolicy = anyOlderTokensBeforeRefreshViaGet
@@ -1124,7 +1055,7 @@ private void findTokenFromRefreshToken(String refreshToken, Iterator<TimeValue>
                         );
                         getTokenDocById(userTokenId, version, null, storedRefreshToken, listener);
                     }
-                } else if (version.onOrAfter(VERSION_HASHED_TOKENS)) {
+                } else {
                     final String unencodedRefreshToken = in.readString();
                     if (unencodedRefreshToken.length() != TOKEN_LENGTH) {
                         logger.debug("Decoded refresh token [{}] with version [{}] is invalid.", unencodedRefreshToken, version);
@@ -1133,9 +1064,6 @@ private void findTokenFromRefreshToken(String refreshToken, Iterator<TimeValue>
                         final String hashedRefreshToken = hashTokenString(unencodedRefreshToken);
                         findTokenFromRefreshToken(hashedRefreshToken, securityTokensIndex, backoff, listener);
                     }
-                } else {
-                    logger.debug("Unrecognized refresh token version [{}].", version);
-                    listener.onResponse(null);
                 }
             } catch (IOException e) {
                 logger.debug(() -> "Could not decode refresh token [" + refreshToken + "].", e);
@@ -1250,7 +1178,6 @@ private void innerRefresh(
             return;
         }
         final RefreshTokenStatus refreshTokenStatus = checkRefreshResult.v1();
-        final SecurityIndexManager refreshedTokenIndex = getTokensIndexForVersion(refreshTokenStatus.getTransportVersion());
         if (refreshTokenStatus.isRefreshed()) {
             logger.debug(
                 "Token document [{}] was recently refreshed, when a new token document was generated. Reusing that result.",
@@ -1258,31 +1185,29 @@ private void innerRefresh(
             );
             final Tuple<UserToken, String> parsedTokens = parseTokensFromDocument(tokenDoc.sourceAsMap(), null);
             Authentication authentication = parsedTokens.v1().getAuthentication();
-            decryptAndReturnSupersedingTokens(refreshToken, refreshTokenStatus, refreshedTokenIndex, authentication, listener);
+            decryptAndReturnSupersedingTokens(refreshToken, refreshTokenStatus, securityTokensIndex, authentication, listener);
         } else {
             final TransportVersion newTokenVersion = getTokenVersionCompatibility();
             final Tuple<byte[], byte[]> newTokenBytes = getRandomTokenBytes(newTokenVersion, true);
             final Map<String, Object> updateMap = new HashMap<>();
             updateMap.put("refreshed", true);
-            if (newTokenVersion.onOrAfter(VERSION_MULTIPLE_CONCURRENT_REFRESHES)) {
-                updateMap.put("refresh_time", clock.instant().toEpochMilli());
-                try {
-                    final byte[] iv = getRandomBytes(IV_BYTES);
-                    final byte[] salt = getRandomBytes(SALT_BYTES);
-                    String encryptedAccessAndRefreshToken = encryptSupersedingTokens(
-                        newTokenBytes.v1(),
-                        newTokenBytes.v2(),
-                        refreshToken,
-                        iv,
-                        salt
-                    );
-                    updateMap.put("superseding.encrypted_tokens", encryptedAccessAndRefreshToken);
-                    updateMap.put("superseding.encryption_iv", Base64.getEncoder().encodeToString(iv));
-                    updateMap.put("superseding.encryption_salt", Base64.getEncoder().encodeToString(salt));
-                } catch (GeneralSecurityException e) {
-                    logger.warn("could not encrypt access token and refresh token string", e);
-                    onFailure.accept(invalidGrantException("could not refresh the requested token"));
-                }
+            updateMap.put("refresh_time", clock.instant().toEpochMilli());
+            try {
+                final byte[] iv = getRandomBytes(IV_BYTES);
+                final byte[] salt = getRandomBytes(SALT_BYTES);
+                String encryptedAccessAndRefreshToken = encryptSupersedingTokens(
+                    newTokenBytes.v1(),
+                    newTokenBytes.v2(),
+                    refreshToken,
+                    iv,
+                    salt
+                );
+                updateMap.put("superseding.encrypted_tokens", encryptedAccessAndRefreshToken);
+                updateMap.put("superseding.encryption_iv", Base64.getEncoder().encodeToString(iv));
+                updateMap.put("superseding.encryption_salt", Base64.getEncoder().encodeToString(salt));
+            } catch (GeneralSecurityException e) {
+                logger.warn("could not encrypt access token and refresh token string", e);
+                onFailure.accept(invalidGrantException("could not refresh the requested token"));
             }
             assert tokenDoc.seqNo() != SequenceNumbers.UNASSIGNED_SEQ_NO : "expected an assigned sequence number";
             assert tokenDoc.primaryTerm() != SequenceNumbers.UNASSIGNED_PRIMARY_TERM : "expected an assigned primary term";
@@ -1293,17 +1218,17 @@ private void innerRefresh(
                     "Using refresh policy [%s] when updating token doc [%s] for refresh in the security index [%s]",
                     tokenRefreshUpdateRefreshPolicy,
                     tokenDoc.id(),
-                    refreshedTokenIndex.aliasName()
+                    securityTokensIndex.aliasName()
                 )
             );
-            final UpdateRequestBuilder updateRequest = client.prepareUpdate(refreshedTokenIndex.aliasName(), tokenDoc.id())
+            final UpdateRequestBuilder updateRequest = client.prepareUpdate(securityTokensIndex.aliasName(), tokenDoc.id())
                 .setDoc("refresh_token", updateMap)
                 .setFetchSource(logger.isDebugEnabled())
                 .setRefreshPolicy(tokenRefreshUpdateRefreshPolicy)
                 .setIfSeqNo(tokenDoc.seqNo())
                 .setIfPrimaryTerm(tokenDoc.primaryTerm());
-            refreshedTokenIndex.prepareIndexIfNeededThenExecute(
-                ex -> listener.onFailure(traceLog("prepare index [" + refreshedTokenIndex.aliasName() + "]", ex)),
+            securityTokensIndex.prepareIndexIfNeededThenExecute(
+                ex -> listener.onFailure(traceLog("prepare index [" + securityTokensIndex.aliasName() + "]", ex)),
                 () -> executeAsyncWithOrigin(
                     client.threadPool().getThreadContext(),
                     SECURITY_ORIGIN,
@@ -1349,7 +1274,7 @@ private void innerRefresh(
                         if (cause instanceof VersionConflictEngineException) {
                             // The document has been updated by another thread, get it again.
                             logger.debug("version conflict while updating document [{}], attempting to get it again", tokenDoc.id());
-                            getTokenDocAsync(tokenDoc.id(), refreshedTokenIndex, true, new ActionListener<>() {
+                            getTokenDocAsync(tokenDoc.id(), securityTokensIndex, true, new ActionListener<>() {
                                 @Override
                                 public void onResponse(GetResponse response) {
                                     if (response.isExists()) {
@@ -1368,7 +1293,7 @@ public void onFailure(Exception e) {
                                             logger.info("could not get token document [{}] for refresh, retrying", tokenDoc.id());
                                             client.threadPool()
                                                 .schedule(
-                                                    () -> getTokenDocAsync(tokenDoc.id(), refreshedTokenIndex, true, this),
+                                                    () -> getTokenDocAsync(tokenDoc.id(), securityTokensIndex, true, this),
                                                     backoff.next(),
                                                     client.threadPool().generic()
                                                 );
@@ -1689,17 +1614,13 @@ private static Optional<ElasticsearchSecurityException> checkMultipleRefreshes(
         RefreshTokenStatus refreshTokenStatus
     ) {
         if (refreshTokenStatus.isRefreshed()) {
-            if (refreshTokenStatus.getTransportVersion().onOrAfter(VERSION_MULTIPLE_CONCURRENT_REFRESHES)) {
-                if (refreshRequested.isAfter(refreshTokenStatus.getRefreshInstant().plus(30L, ChronoUnit.SECONDS))) {
-                    return Optional.of(invalidGrantException("token has already been refreshed more than 30 seconds in the past"));
-                }
-                if (refreshRequested.isBefore(refreshTokenStatus.getRefreshInstant().minus(30L, ChronoUnit.SECONDS))) {
-                    return Optional.of(
-                        invalidGrantException("token has been refreshed more than 30 seconds in the future, clock skew too great")
-                    );
-                }
-            } else {
-                return Optional.of(invalidGrantException("token has already been refreshed"));
+            if (refreshRequested.isAfter(refreshTokenStatus.getRefreshInstant().plus(30L, ChronoUnit.SECONDS))) {
+                return Optional.of(invalidGrantException("token has already been refreshed more than 30 seconds in the past"));
+            }
+            if (refreshRequested.isBefore(refreshTokenStatus.getRefreshInstant().minus(30L, ChronoUnit.SECONDS))) {
+                return Optional.of(
+                    invalidGrantException("token has been refreshed more than 30 seconds in the future, clock skew too great")
+                );
             }
         }
         return Optional.empty();
@@ -1979,21 +1900,6 @@ private void ensureEnabled() {
         }
     }
 
-    /**
-     * In version {@code #VERSION_TOKENS_INDEX_INTRODUCED} security tokens were moved into a separate index, away from the other entities in
-     * the main security index, due to their ephemeral nature. They moved "seamlessly" - without manual user intervention. In this way, new
-     * tokens are created in the new index, while the existing ones were left in place - to be accessed from the old index - and due to be
-     * removed automatically by the {@code ExpiredTokenRemover} periodic job. Therefore, in general, when searching for a token we need to
-     * consider both the new and the old indices.
-     */
-    private SecurityIndexManager getTokensIndexForVersion(TransportVersion version) {
-        if (version.onOrAfter(VERSION_TOKENS_INDEX_INTRODUCED)) {
-            return securityTokensIndex;
-        } else {
-            return securityMainIndex;
-        }
-    }
-
     public TimeValue getExpirationDelay() {
         return expirationDelay;
     }
@@ -2022,41 +1928,13 @@ public String prependVersionAndEncodeAccessToken(TransportVersion version, byte[
                 out.writeByteArray(accessTokenBytes);
                 return Base64.getEncoder().encodeToString(out.bytes().toBytesRef().bytes);
             }
-        } else if (version.onOrAfter(VERSION_ACCESS_TOKENS_AS_UUIDS)) {
+        } else {
             try (BytesStreamOutput out = new BytesStreamOutput(MINIMUM_BASE64_BYTES)) {
                 out.setTransportVersion(version);
                 TransportVersion.writeVersion(version, out);
                 out.writeString(Strings.BASE_64_NO_PADDING_URL_ENCODER.encodeToString(accessTokenBytes));
                 return Base64.getEncoder().encodeToString(out.bytes().toBytesRef().bytes);
             }
-        } else {
-            // we know that the minimum length is larger than the default of the ByteArrayOutputStream so set the size to this explicitly
-            try (
-                ByteArrayOutputStream os = new ByteArrayOutputStream(LEGACY_MINIMUM_BASE64_BYTES);
-                OutputStream base64 = Base64.getEncoder().wrap(os);
-                StreamOutput out = new OutputStreamStreamOutput(base64)
-            ) {
-                out.setTransportVersion(version);
-                KeyAndCache keyAndCache = keyCache.activeKeyCache;
-                TransportVersion.writeVersion(version, out);
-                out.writeByteArray(keyAndCache.getSalt().bytes);
-                out.writeByteArray(keyAndCache.getKeyHash().bytes);
-                final byte[] initializationVector = getRandomBytes(IV_BYTES);
-                out.writeByteArray(initializationVector);
-                try (
-                    CipherOutputStream encryptedOutput = new CipherOutputStream(
-                        out,
-                        getEncryptionCipher(initializationVector, keyAndCache, version)
-                    );
-                    StreamOutput encryptedStreamOutput = new OutputStreamStreamOutput(encryptedOutput)
-                ) {
-                    encryptedStreamOutput.setTransportVersion(version);
-                    encryptedStreamOutput.writeString(Strings.BASE_64_NO_PADDING_URL_ENCODER.encodeToString(accessTokenBytes));
-                    // StreamOutput needs to be closed explicitly because it wraps CipherOutputStream
-                    encryptedStreamOutput.close();
-                    return new String(os.toByteArray(), StandardCharsets.UTF_8);
-                }
-            }
         }
     }
 
diff --git a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java
index 75c2507a1dc5f..702af75141093 100644
--- a/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java
+++ b/x-pack/plugin/security/src/test/java/org/elasticsearch/xpack/security/authc/TokenServiceTests.java
@@ -126,7 +126,6 @@
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.hasSize;
 import static org.hamcrest.Matchers.instanceOf;
-import static org.hamcrest.Matchers.notNullValue;
 import static org.hamcrest.Matchers.nullValue;
 import static org.mockito.ArgumentMatchers.any;
 import static org.mockito.ArgumentMatchers.anyString;
@@ -148,7 +147,6 @@ public class TokenServiceTests extends ESTestCase {
     private SecurityIndexManager securityMainIndex;
     private SecurityIndexManager securityTokensIndex;
     private ClusterService clusterService;
-    private DiscoveryNode pre72OldNode;
     private DiscoveryNode pre8500040OldNode;
     private Settings tokenServiceEnabledSettings = Settings.builder()
         .put(XPackSettings.TOKEN_SERVICE_ENABLED_SETTING.getKey(), true)
@@ -228,31 +226,12 @@ public void setupClient() {
         licenseState = mock(MockLicenseState.class);
         when(licenseState.isAllowed(Security.TOKEN_SERVICE_FEATURE)).thenReturn(true);
 
-        if (randomBoolean()) {
-            // version 7.2 was an "inflection" point in the Token Service development (access_tokens as UUIDS, multiple concurrent
-            // refreshes,
-            // tokens docs on a separate index)
-            pre72OldNode = addAnother7071DataNode(this.clusterService);
-        }
         if (randomBoolean()) {
             // before refresh tokens used GET, i.e. TokenService#VERSION_GET_TOKEN_DOC_FOR_REFRESH
             pre8500040OldNode = addAnotherPre8500DataNode(this.clusterService);
         }
     }
 
-    private static DiscoveryNode addAnother7071DataNode(ClusterService clusterService) {
-        Version version;
-        TransportVersion transportVersion;
-        if (randomBoolean()) {
-            version = Version.V_7_0_0;
-            transportVersion = TransportVersions.V_7_0_0;
-        } else {
-            version = Version.V_7_1_0;
-            transportVersion = TransportVersions.V_7_1_0;
-        }
-        return addAnotherDataNodeWithVersion(clusterService, version, transportVersion);
-    }
-
     private static DiscoveryNode addAnotherPre8500DataNode(ClusterService clusterService) {
         Version version;
         TransportVersion transportVersion;
@@ -301,53 +280,6 @@ public static void shutdownThreadpool() {
         threadPool = null;
     }
 
-    public void testAttachAndGetToken() throws Exception {
-        TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
-        // This test only makes sense in mixed clusters with pre v7.2.0 nodes where the Token Service Key is used (to encrypt tokens)
-        if (null == pre72OldNode) {
-            pre72OldNode = addAnother7071DataNode(this.clusterService);
-        }
-        Authentication authentication = AuthenticationTestHelper.builder()
-            .user(new User("joe", "admin"))
-            .realmRef(new RealmRef("native_realm", "native", "node1"))
-            .build(false);
-        PlainActionFuture<TokenService.CreateTokenResult> tokenFuture = new PlainActionFuture<>();
-        Tuple<byte[], byte[]> newTokenBytes = tokenService.getRandomTokenBytes(randomBoolean());
-        tokenService.createOAuth2Tokens(
-            newTokenBytes.v1(),
-            newTokenBytes.v2(),
-            authentication,
-            authentication,
-            Collections.emptyMap(),
-            tokenFuture
-        );
-        final String accessToken = tokenFuture.get().getAccessToken();
-        assertNotNull(accessToken);
-        mockGetTokenFromAccessTokenBytes(tokenService, newTokenBytes.v1(), authentication, false, null);
-
-        ThreadContext requestContext = new ThreadContext(Settings.EMPTY);
-        requestContext.putHeader("Authorization", randomFrom("Bearer ", "BEARER ", "bearer ") + accessToken);
-
-        try (ThreadContext.StoredContext ignore = requestContext.newStoredContextPreservingResponseHeaders()) {
-            PlainActionFuture<UserToken> future = new PlainActionFuture<>();
-            final SecureString bearerToken = Authenticator.extractBearerTokenFromHeader(requestContext);
-            tokenService.tryAuthenticateToken(bearerToken, future);
-            UserToken serialized = future.get();
-            assertAuthentication(authentication, serialized.getAuthentication());
-        }
-
-        try (ThreadContext.StoredContext ignore = requestContext.newStoredContextPreservingResponseHeaders()) {
-            // verify a second separate token service with its own salt can also verify
-            TokenService anotherService = createTokenService(tokenServiceEnabledSettings, systemUTC());
-            anotherService.refreshMetadata(tokenService.getTokenMetadata());
-            PlainActionFuture<UserToken> future = new PlainActionFuture<>();
-            final SecureString bearerToken = Authenticator.extractBearerTokenFromHeader(requestContext);
-            anotherService.tryAuthenticateToken(bearerToken, future);
-            UserToken fromOtherService = future.get();
-            assertAuthentication(authentication, fromOtherService.getAuthentication());
-        }
-    }
-
     public void testInvalidAuthorizationHeader() throws Exception {
         TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
         ThreadContext requestContext = new ThreadContext(Settings.EMPTY);
@@ -364,89 +296,6 @@ public void testInvalidAuthorizationHeader() throws Exception {
         }
     }
 
-    public void testPassphraseWorks() throws Exception {
-        TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
-        // This test only makes sense in mixed clusters with pre v7.1.0 nodes where the Key is actually used
-        if (null == pre72OldNode) {
-            pre72OldNode = addAnother7071DataNode(this.clusterService);
-        }
-        Authentication authentication = AuthenticationTestHelper.builder()
-            .user(new User("joe", "admin"))
-            .realmRef(new RealmRef("native_realm", "native", "node1"))
-            .build(false);
-        PlainActionFuture<TokenService.CreateTokenResult> tokenFuture = new PlainActionFuture<>();
-        Tuple<byte[], byte[]> newTokenBytes = tokenService.getRandomTokenBytes(randomBoolean());
-        tokenService.createOAuth2Tokens(
-            newTokenBytes.v1(),
-            newTokenBytes.v2(),
-            authentication,
-            authentication,
-            Collections.emptyMap(),
-            tokenFuture
-        );
-        final String accessToken = tokenFuture.get().getAccessToken();
-        assertNotNull(accessToken);
-        mockGetTokenFromAccessTokenBytes(tokenService, newTokenBytes.v1(), authentication, false, null);
-
-        ThreadContext requestContext = new ThreadContext(Settings.EMPTY);
-        storeTokenHeader(requestContext, accessToken);
-
-        try (ThreadContext.StoredContext ignore = requestContext.newStoredContextPreservingResponseHeaders()) {
-            PlainActionFuture<UserToken> future = new PlainActionFuture<>();
-            final SecureString bearerToken = Authenticator.extractBearerTokenFromHeader(requestContext);
-            tokenService.tryAuthenticateToken(bearerToken, future);
-            UserToken serialized = future.get();
-            assertAuthentication(authentication, serialized.getAuthentication());
-        }
-
-        try (ThreadContext.StoredContext ignore = requestContext.newStoredContextPreservingResponseHeaders()) {
-            // verify a second separate token service with its own passphrase cannot verify
-            TokenService anotherService = createTokenService(tokenServiceEnabledSettings, systemUTC());
-            PlainActionFuture<UserToken> future = new PlainActionFuture<>();
-            final SecureString bearerToken = Authenticator.extractBearerTokenFromHeader(requestContext);
-            anotherService.tryAuthenticateToken(bearerToken, future);
-            assertNull(future.get());
-        }
-    }
-
-    public void testGetTokenWhenKeyCacheHasExpired() throws Exception {
-        TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
-        // This test only makes sense in mixed clusters with pre v7.1.0 nodes where the Key is actually used
-        if (null == pre72OldNode) {
-            pre72OldNode = addAnother7071DataNode(this.clusterService);
-        }
-        Authentication authentication = AuthenticationTestHelper.builder()
-            .user(new User("joe", "admin"))
-            .realmRef(new RealmRef("native_realm", "native", "node1"))
-            .build(false);
-
-        PlainActionFuture<TokenService.CreateTokenResult> tokenFuture = new PlainActionFuture<>();
-        Tuple<byte[], byte[]> newTokenBytes = tokenService.getRandomTokenBytes(randomBoolean());
-        tokenService.createOAuth2Tokens(
-            newTokenBytes.v1(),
-            newTokenBytes.v2(),
-            authentication,
-            authentication,
-            Collections.emptyMap(),
-            tokenFuture
-        );
-        String accessToken = tokenFuture.get().getAccessToken();
-        assertThat(accessToken, notNullValue());
-
-        tokenService.clearActiveKeyCache();
-
-        tokenService.createOAuth2Tokens(
-            newTokenBytes.v1(),
-            newTokenBytes.v2(),
-            authentication,
-            authentication,
-            Collections.emptyMap(),
-            tokenFuture
-        );
-        accessToken = tokenFuture.get().getAccessToken();
-        assertThat(accessToken, notNullValue());
-    }
-
     public void testAuthnWithInvalidatedToken() throws Exception {
         when(securityMainIndex.indexExists()).thenReturn(true);
         TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
@@ -820,57 +669,6 @@ public void testMalformedRefreshTokens() throws Exception {
         }
     }
 
-    public void testNonExistingPre72Token() throws Exception {
-        TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
-        // mock another random token so that we don't find a token in TokenService#getUserTokenFromId
-        Authentication authentication = AuthenticationTestHelper.builder()
-            .user(new User("joe", "admin"))
-            .realmRef(new RealmRef("native_realm", "native", "node1"))
-            .build(false);
-        mockGetTokenFromAccessTokenBytes(tokenService, tokenService.getRandomTokenBytes(randomBoolean()).v1(), authentication, false, null);
-        ThreadContext requestContext = new ThreadContext(Settings.EMPTY);
-        storeTokenHeader(
-            requestContext,
-            tokenService.prependVersionAndEncodeAccessToken(
-                TransportVersions.V_7_1_0,
-                tokenService.getRandomTokenBytes(TransportVersions.V_7_1_0, randomBoolean()).v1()
-            )
-        );
-
-        try (ThreadContext.StoredContext ignore = requestContext.newStoredContextPreservingResponseHeaders()) {
-            PlainActionFuture<UserToken> future = new PlainActionFuture<>();
-            final SecureString bearerToken = Authenticator.extractBearerTokenFromHeader(requestContext);
-            tokenService.tryAuthenticateToken(bearerToken, future);
-            assertNull(future.get());
-        }
-    }
-
-    public void testNonExistingUUIDToken() throws Exception {
-        TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
-        // mock another random token so that we don't find a token in TokenService#getUserTokenFromId
-        Authentication authentication = AuthenticationTestHelper.builder()
-            .user(new User("joe", "admin"))
-            .realmRef(new RealmRef("native_realm", "native", "node1"))
-            .build(false);
-        mockGetTokenFromAccessTokenBytes(tokenService, tokenService.getRandomTokenBytes(randomBoolean()).v1(), authentication, false, null);
-        ThreadContext requestContext = new ThreadContext(Settings.EMPTY);
-        TransportVersion uuidTokenVersion = randomFrom(TransportVersions.V_7_2_0, TransportVersions.V_7_3_2);
-        storeTokenHeader(
-            requestContext,
-            tokenService.prependVersionAndEncodeAccessToken(
-                uuidTokenVersion,
-                tokenService.getRandomTokenBytes(uuidTokenVersion, randomBoolean()).v1()
-            )
-        );
-
-        try (ThreadContext.StoredContext ignore = requestContext.newStoredContextPreservingResponseHeaders()) {
-            PlainActionFuture<UserToken> future = new PlainActionFuture<>();
-            final SecureString bearerToken = Authenticator.extractBearerTokenFromHeader(requestContext);
-            tokenService.tryAuthenticateToken(bearerToken, future);
-            assertNull(future.get());
-        }
-    }
-
     public void testNonExistingLatestTokenVersion() throws Exception {
         TokenService tokenService = createTokenService(tokenServiceEnabledSettings, systemUTC());
         // mock another random token so that we don't find a token in TokenService#getUserTokenFromId
@@ -925,18 +723,11 @@ public void testIndexNotAvailable() throws Exception {
             return Void.TYPE;
         }).when(client).get(any(GetRequest.class), anyActionListener());
 
-        final SecurityIndexManager tokensIndex;
-        if (pre72OldNode != null) {
-            tokensIndex = securityMainIndex;
-            when(securityTokensIndex.isAvailable(SecurityIndexManager.Availability.PRIMARY_SHARDS)).thenReturn(false);
-            when(securityTokensIndex.indexExists()).thenReturn(false);
-            when(securityTokensIndex.defensiveCopy()).thenReturn(securityTokensIndex);
-        } else {
-            tokensIndex = securityTokensIndex;
-            when(securityMainIndex.isAvailable(SecurityIndexManager.Availability.PRIMARY_SHARDS)).thenReturn(false);
-            when(securityMainIndex.indexExists()).thenReturn(false);
-            when(securityMainIndex.defensiveCopy()).thenReturn(securityMainIndex);
-        }
+        final SecurityIndexManager tokensIndex = securityTokensIndex;
+        when(securityMainIndex.isAvailable(SecurityIndexManager.Availability.PRIMARY_SHARDS)).thenReturn(false);
+        when(securityMainIndex.indexExists()).thenReturn(false);
+        when(securityMainIndex.defensiveCopy()).thenReturn(securityMainIndex);
+
         try (ThreadContext.StoredContext ignore = requestContext.newStoredContextPreservingResponseHeaders()) {
             PlainActionFuture<UserToken> future = new PlainActionFuture<>();
             final SecureString bearerToken3 = Authenticator.extractBearerTokenFromHeader(requestContext);
@@ -988,7 +779,6 @@ public void testGetAuthenticationWorksWithExpiredUserToken() throws Exception {
     }
 
     public void testSupersedingTokenEncryption() throws Exception {
-        assumeTrue("Superseding tokens are only created in post 7.2 clusters", pre72OldNode == null);
         TokenService tokenService = createTokenService(tokenServiceEnabledSettings, Clock.systemUTC());
         Authentication authentication = AuthenticationTests.randomAuthentication(null, null);
         PlainActionFuture<TokenService.CreateTokenResult> tokenFuture = new PlainActionFuture<>();
@@ -1023,13 +813,11 @@ public void testSupersedingTokenEncryption() throws Exception {
             authentication,
             tokenFuture
         );
-        if (version.onOrAfter(TokenService.VERSION_ACCESS_TOKENS_AS_UUIDS)) {
-            // previous versions serialized the access token encrypted and the cipher text was different each time (due to different IVs)
-            assertThat(
-                tokenService.prependVersionAndEncodeAccessToken(version, newTokenBytes.v1()),
-                equalTo(tokenFuture.get().getAccessToken())
-            );
-        }
+
+        assertThat(
+            tokenService.prependVersionAndEncodeAccessToken(version, newTokenBytes.v1()),
+            equalTo(tokenFuture.get().getAccessToken())
+        );
         assertThat(
             TokenService.prependVersionAndEncodeRefreshToken(version, newTokenBytes.v2()),
             equalTo(tokenFuture.get().getRefreshToken())
@@ -1158,10 +946,8 @@ public static String tokenDocIdFromAccessTokenBytes(byte[] accessTokenBytes, Tra
             MessageDigest userTokenIdDigest = sha256();
             userTokenIdDigest.update(accessTokenBytes, RAW_TOKEN_BYTES_LENGTH, RAW_TOKEN_DOC_ID_BYTES_LENGTH);
             return Base64.getUrlEncoder().withoutPadding().encodeToString(userTokenIdDigest.digest());
-        } else if (tokenVersion.onOrAfter(TokenService.VERSION_ACCESS_TOKENS_AS_UUIDS)) {
-            return TokenService.hashTokenString(Base64.getUrlEncoder().withoutPadding().encodeToString(accessTokenBytes));
         } else {
-            return Base64.getUrlEncoder().withoutPadding().encodeToString(accessTokenBytes);
+            return TokenService.hashTokenString(Base64.getUrlEncoder().withoutPadding().encodeToString(accessTokenBytes));
         }
     }
 
@@ -1178,12 +964,9 @@ private void mockTokenForRefreshToken(
         if (userToken.getTransportVersion().onOrAfter(VERSION_GET_TOKEN_DOC_FOR_REFRESH)) {
             storedAccessToken = Base64.getUrlEncoder().withoutPadding().encodeToString(sha256().digest(accessTokenBytes));
             storedRefreshToken = Base64.getUrlEncoder().withoutPadding().encodeToString(sha256().digest(refreshTokenBytes));
-        } else if (userToken.getTransportVersion().onOrAfter(TokenService.VERSION_HASHED_TOKENS)) {
-            storedAccessToken = null;
-            storedRefreshToken = TokenService.hashTokenString(Base64.getUrlEncoder().withoutPadding().encodeToString(refreshTokenBytes));
         } else {
             storedAccessToken = null;
-            storedRefreshToken = Base64.getUrlEncoder().withoutPadding().encodeToString(refreshTokenBytes);
+            storedRefreshToken = TokenService.hashTokenString(Base64.getUrlEncoder().withoutPadding().encodeToString(refreshTokenBytes));
         }
         final RealmRef realmRef = new RealmRef(
             refreshTokenStatus == null ? randomAlphaOfLength(6) : refreshTokenStatus.getAssociatedRealm(),

From 2e9ff9ae66bff80df6e8a2149fdef818a6efe573 Mon Sep 17 00:00:00 2001
From: Lola <omolola.akinleye@elastic.co>
Date: Mon, 9 Dec 2024 05:06:46 -0500
Subject: [PATCH 118/119] [Cloud Security]Fix Cloud Security Package indices'
 deletion step error for ilm policy (#116982)

* add ilm deletion step permission for the findings index

* add back logs-endpoint index

* fix tests for reserved role

* fix linting issue
---
 .../store/KibanaOwnedReservedRoleDescriptors.java  |  2 ++
 .../authz/store/ReservedRolesStoreTests.java       | 14 ++++++--------
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/KibanaOwnedReservedRoleDescriptors.java b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/KibanaOwnedReservedRoleDescriptors.java
index cc589b53eaa1a..5e19b26b8f4de 100644
--- a/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/KibanaOwnedReservedRoleDescriptors.java
+++ b/x-pack/plugin/core/src/main/java/org/elasticsearch/xpack/core/security/authz/store/KibanaOwnedReservedRoleDescriptors.java
@@ -331,6 +331,8 @@ static RoleDescriptor kibanaSystem(String name) {
                         ".logs-endpoint.diagnostic.collection-*",
                         "logs-apm-*",
                         "logs-apm.*-*",
+                        "logs-cloud_security_posture.findings-*",
+                        "logs-cloud_security_posture.vulnerabilities-*",
                         "metrics-apm-*",
                         "metrics-apm.*-*",
                         "traces-apm-*",
diff --git a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
index eeffa1db54856..b69b0ece89960 100644
--- a/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
+++ b/x-pack/plugin/core/src/test/java/org/elasticsearch/xpack/core/security/authz/store/ReservedRolesStoreTests.java
@@ -1586,10 +1586,8 @@ public void testKibanaSystemRole() {
             final IndexAbstraction indexAbstraction = mockIndexAbstraction(cspIndex);
             assertThat(kibanaRole.indices().allowedIndicesMatcher("indices:foo").test(indexAbstraction), is(false));
             assertThat(kibanaRole.indices().allowedIndicesMatcher("indices:bar").test(indexAbstraction), is(false));
-            assertThat(
-                kibanaRole.indices().allowedIndicesMatcher(TransportDeleteIndexAction.TYPE.name()).test(indexAbstraction),
-                is(false)
-            );
+            // Ensure privileges necessary for ILM policies in Cloud Security Posture Package
+            assertThat(kibanaRole.indices().allowedIndicesMatcher(TransportDeleteIndexAction.TYPE.name()).test(indexAbstraction), is(true));
             assertThat(kibanaRole.indices().allowedIndicesMatcher(GetIndexAction.NAME).test(indexAbstraction), is(true));
             assertThat(
                 kibanaRole.indices().allowedIndicesMatcher(TransportCreateIndexAction.TYPE.name()).test(indexAbstraction),
@@ -1613,10 +1611,9 @@ public void testKibanaSystemRole() {
             final IndexAbstraction indexAbstraction = mockIndexAbstraction(cspIndex);
             assertThat(kibanaRole.indices().allowedIndicesMatcher("indices:foo").test(indexAbstraction), is(false));
             assertThat(kibanaRole.indices().allowedIndicesMatcher("indices:bar").test(indexAbstraction), is(false));
-            assertThat(
-                kibanaRole.indices().allowedIndicesMatcher(TransportDeleteIndexAction.TYPE.name()).test(indexAbstraction),
-                is(false)
-            );
+            // Ensure privileges necessary for ILM policies in Cloud Security Posture Package
+            assertThat(kibanaRole.indices().allowedIndicesMatcher(TransportDeleteIndexAction.TYPE.name()).test(indexAbstraction), is(true));
+            assertThat(kibanaRole.indices().allowedIndicesMatcher(TransportDeleteIndexAction.TYPE.name()).test(indexAbstraction), is(true));
             assertThat(kibanaRole.indices().allowedIndicesMatcher(GetIndexAction.NAME).test(indexAbstraction), is(true));
             assertThat(
                 kibanaRole.indices().allowedIndicesMatcher(TransportCreateIndexAction.TYPE.name()).test(indexAbstraction),
@@ -1710,6 +1707,7 @@ public void testKibanaSystemRole() {
                 kibanaRole.indices().allowedIndicesMatcher("indices:monitor/" + randomAlphaOfLengthBetween(3, 8)).test(indexAbstraction),
                 is(true)
             );
+
         });
 
         // cloud_defend

From 6bb0799893f4ee4e6afa7094346fbc51d5203538 Mon Sep 17 00:00:00 2001
From: kosabogi <105062005+kosabogi@users.noreply.github.com>
Date: Mon, 9 Dec 2024 11:37:41 +0100
Subject: [PATCH 119/119] Updates h7 and h8 formatting (#118132)

---
 .../connector/docs/connectors-box.asciidoc    | 12 +++----
 .../connectors-content-extraction.asciidoc    |  4 +--
 .../docs/connectors-dropbox.asciidoc          | 16 +++++-----
 .../connector/docs/connectors-github.asciidoc | 20 ++++++------
 .../connector/docs/connectors-ms-sql.asciidoc | 12 +++----
 .../docs/connectors-network-drive.asciidoc    | 16 +++++-----
 .../connector/docs/connectors-notion.asciidoc | 32 +++++++++----------
 .../docs/connectors-onedrive.asciidoc         | 24 +++++++-------
 .../docs/connectors-postgresql.asciidoc       | 24 +++++++-------
 .../connector/docs/connectors-s3.asciidoc     |  4 +--
 .../docs/connectors-salesforce.asciidoc       | 12 +++----
 .../docs/connectors-servicenow.asciidoc       | 12 +++----
 .../connectors-sharepoint-online.asciidoc     | 16 +++++-----
 13 files changed, 102 insertions(+), 102 deletions(-)

diff --git a/docs/reference/connector/docs/connectors-box.asciidoc b/docs/reference/connector/docs/connectors-box.asciidoc
index 07e4308d67c20..3e95f15d16ccd 100644
--- a/docs/reference/connector/docs/connectors-box.asciidoc
+++ b/docs/reference/connector/docs/connectors-box.asciidoc
@@ -54,7 +54,7 @@ For additional operations, see <<es-connectors-usage>>.
 ====== Box Free Account
 
 [discrete#es-connectors-box-create-oauth-custom-app]
-======= Create Box User Authentication (OAuth 2.0) Custom App
+*Create Box User Authentication (OAuth 2.0) Custom App*
 
 You'll need to create an OAuth app in the Box developer console by following these steps:
 
@@ -64,7 +64,7 @@ You'll need to create an OAuth app in the Box developer console by following the
 4. Once the app is created, *Client ID* and *Client secret* values are available in the configuration tab. Keep these handy.
 
 [discrete#es-connectors-box-connector-generate-a-refresh-token]
-======= Generate a refresh Token
+*Generate a refresh Token*
 
 To generate a refresh token, follow these steps:
 
@@ -97,7 +97,7 @@ Save the refresh token from the response. You'll need this for the connector con
 ====== Box Enterprise Account
 
 [discrete#es-connectors-box-connector-create-box-server-authentication-client-credentials-grant-custom-app]
-======= Create Box Server Authentication (Client Credentials Grant) Custom App
+*Create Box Server Authentication (Client Credentials Grant) Custom App*
 
 1. Register a new app in the https://app.box.com/developers/console[Box dev console] with custom App and select Server Authentication (Client Credentials Grant).
 2. Check following permissions:
@@ -224,7 +224,7 @@ For additional operations, see <<es-connectors-usage>>.
 ====== Box Free Account
 
 [discrete#es-connectors-box-client-create-oauth-custom-app]
-======= Create Box User Authentication (OAuth 2.0) Custom App
+*Create Box User Authentication (OAuth 2.0) Custom App*
 
 You'll need to create an OAuth app in the Box developer console by following these steps:
 
@@ -234,7 +234,7 @@ You'll need to create an OAuth app in the Box developer console by following the
 4. Once the app is created, *Client ID* and *Client secret* values are available in the configuration tab. Keep these handy.
 
 [discrete#es-connectors-box-client-connector-generate-a-refresh-token]
-======= Generate a refresh Token
+*Generate a refresh Token*
 
 To generate a refresh token, follow these steps:
 
@@ -267,7 +267,7 @@ Save the refresh token from the response. You'll need this for the connector con
 ====== Box Enterprise Account
 
 [discrete#es-connectors-box-client-connector-create-box-server-authentication-client-credentials-grant-custom-app]
-======= Create Box Server Authentication (Client Credentials Grant) Custom App
+*Create Box Server Authentication (Client Credentials Grant) Custom App*
 
 1. Register a new app in the https://app.box.com/developers/console[Box dev console] with custom App and select Server Authentication (Client Credentials Grant).
 2. Check following permissions:
diff --git a/docs/reference/connector/docs/connectors-content-extraction.asciidoc b/docs/reference/connector/docs/connectors-content-extraction.asciidoc
index 5d2a9550a7c3c..a87d38c9bf531 100644
--- a/docs/reference/connector/docs/connectors-content-extraction.asciidoc
+++ b/docs/reference/connector/docs/connectors-content-extraction.asciidoc
@@ -183,7 +183,7 @@ Be aware that the self-managed connector will download files with randomized fil
 For that reason, we recommend using a dedicated directory for self-hosted extraction.
 
 [discrete#es-connectors-content-extraction-data-extraction-service-file-pointers-configuration-example]
-======= Example
+*Example*
 
 1. For this example, we will be using `/app/files` as both our local directory and our container directory.
 When you run the extraction service docker container, you can mount the directory as a volume using the command-line option `-v /app/files:/app/files`.
@@ -228,7 +228,7 @@ When using self-hosted extraction from a dockerized self-managed connector, ther
 * The self-managed connector and the extraction service will also need to share a volume. You can decide what directory inside these docker containers the volume will be mounted onto, but the directory must be the same for both docker containers.
 
 [discrete#es-connectors-content-extraction-data-extraction-service-file-pointers-configuration-dockerized-example]
-======= Example
+*Example*
 
 1. First, set up a volume for the two docker containers to share.
 This will be where files are downloaded into and then extracted from.
diff --git a/docs/reference/connector/docs/connectors-dropbox.asciidoc b/docs/reference/connector/docs/connectors-dropbox.asciidoc
index 1f80a0ab4e952..295b7e2936625 100644
--- a/docs/reference/connector/docs/connectors-dropbox.asciidoc
+++ b/docs/reference/connector/docs/connectors-dropbox.asciidoc
@@ -190,7 +190,7 @@ When both are provided, priority is given to `file_categories`.
 We have some examples below for illustration.
 
 [discrete#es-connectors-dropbox-sync-rules-advanced-example-1]
-======= Example: Query only
+*Example: Query only*
 
 [source,js]
 ----
@@ -206,7 +206,7 @@ We have some examples below for illustration.
 // NOTCONSOLE
 
 [discrete#es-connectors-dropbox-sync-rules-advanced-example-2]
-======= Example: Query with file extension filter
+*Example: Query with file extension filter*
 
 [source,js]
 ----
@@ -225,7 +225,7 @@ We have some examples below for illustration.
 // NOTCONSOLE
 
 [discrete#es-connectors-dropbox-sync-rules-advanced-example-3]
-======= Example: Query with file category filter
+*Example: Query with file category filter*
 
 [source,js]
 ----
@@ -248,7 +248,7 @@ We have some examples below for illustration.
 // NOTCONSOLE
 
 [discrete#es-connectors-dropbox-sync-rules-advanced-limitations]
-======= Limitations
+*Limitations*
 
 * Content extraction is not supported for Dropbox *Paper* files when advanced sync rules are enabled.
 
@@ -474,7 +474,7 @@ When both are provided, priority is given to `file_categories`.
 We have some examples below for illustration.
 
 [discrete#es-connectors-dropbox-client-sync-rules-advanced-example-1]
-======= Example: Query only
+*Example: Query only*
 
 [source,js]
 ----
@@ -490,7 +490,7 @@ We have some examples below for illustration.
 // NOTCONSOLE
 
 [discrete#es-connectors-dropbox-client-sync-rules-advanced-example-2]
-======= Example: Query with file extension filter
+*Example: Query with file extension filter*
 
 [source,js]
 ----
@@ -509,7 +509,7 @@ We have some examples below for illustration.
 // NOTCONSOLE
 
 [discrete#es-connectors-dropbox-client-sync-rules-advanced-example-3]
-======= Example: Query with file category filter
+*Example: Query with file category filter*
 
 [source,js]
 ----
@@ -532,7 +532,7 @@ We have some examples below for illustration.
 // NOTCONSOLE
 
 [discrete#es-connectors-dropbox-client-sync-rules-advanced-limitations]
-======= Limitations
+*Limitations*
 
 * Content extraction is not supported for Dropbox *Paper* files when advanced sync rules are enabled.
 
diff --git a/docs/reference/connector/docs/connectors-github.asciidoc b/docs/reference/connector/docs/connectors-github.asciidoc
index aa683e4bb0829..df577d83e8121 100644
--- a/docs/reference/connector/docs/connectors-github.asciidoc
+++ b/docs/reference/connector/docs/connectors-github.asciidoc
@@ -210,7 +210,7 @@ Advanced sync rules are defined through a source-specific DSL JSON snippet.
 The following sections provide examples of advanced sync rules for this connector.
 
 [discrete#es-connectors-github-sync-rules-advanced-branch]
-======= Indexing document and files based on branch name configured via branch key
+*Indexing document and files based on branch name configured via branch key*
 
 [source,js]
 ----
@@ -226,7 +226,7 @@ The following sections provide examples of advanced sync rules for this connecto
 // NOTCONSOLE
 
 [discrete#es-connectors-github-sync-rules-advanced-issue-key]
-======= Indexing document based on issue query related to bugs via issue key
+*Indexing document based on issue query related to bugs via issue key*
 
 [source,js]
 ----
@@ -242,7 +242,7 @@ The following sections provide examples of advanced sync rules for this connecto
 // NOTCONSOLE
 
 [discrete#es-connectors-github-sync-rules-advanced-pr-key]
-======= Indexing document based on PR query related to open PR's via PR key
+*Indexing document based on PR query related to open PR's via PR key*
 
 [source,js]
 ----
@@ -258,7 +258,7 @@ The following sections provide examples of advanced sync rules for this connecto
 // NOTCONSOLE
 
 [discrete#es-connectors-github-sync-rules-advanced-issue-query-branch-name]
-======= Indexing document and files based on queries and branch name
+*Indexing document and files based on queries and branch name*
 
 [source,js]
 ----
@@ -283,7 +283,7 @@ Check the Elasticsearch index for the actual document count.
 ====
 
 [discrete#es-connectors-github-sync-rules-advanced-overlapping]
-======= Advanced rules for overlapping
+*Advanced rules for overlapping*
 
 [source,js]
 ----
@@ -550,7 +550,7 @@ Advanced sync rules are defined through a source-specific DSL JSON snippet.
 The following sections provide examples of advanced sync rules for this connector.
 
 [discrete#es-connectors-github-client-sync-rules-advanced-branch]
-======= Indexing document and files based on branch name configured via branch key
+*Indexing document and files based on branch name configured via branch key*
 
 [source,js]
 ----
@@ -566,7 +566,7 @@ The following sections provide examples of advanced sync rules for this connecto
 // NOTCONSOLE
 
 [discrete#es-connectors-github-client-sync-rules-advanced-issue-key]
-======= Indexing document based on issue query related to bugs via issue key
+*Indexing document based on issue query related to bugs via issue key*
 
 [source,js]
 ----
@@ -582,7 +582,7 @@ The following sections provide examples of advanced sync rules for this connecto
 // NOTCONSOLE
 
 [discrete#es-connectors-github-client-sync-rules-advanced-pr-key]
-======= Indexing document based on PR query related to open PR's via PR key
+*Indexing document based on PR query related to open PR's via PR key*
 
 [source,js]
 ----
@@ -598,7 +598,7 @@ The following sections provide examples of advanced sync rules for this connecto
 // NOTCONSOLE
 
 [discrete#es-connectors-github-client-sync-rules-advanced-issue-query-branch-name]
-======= Indexing document and files based on queries and branch name
+*Indexing document and files based on queries and branch name*
 
 [source,js]
 ----
@@ -623,7 +623,7 @@ Check the Elasticsearch index for the actual document count.
 ====
 
 [discrete#es-connectors-github-client-sync-rules-advanced-overlapping]
-======= Advanced rules for overlapping
+*Advanced rules for overlapping*
 
 [source,js]
 ----
diff --git a/docs/reference/connector/docs/connectors-ms-sql.asciidoc b/docs/reference/connector/docs/connectors-ms-sql.asciidoc
index 47fb282b16877..d706af8ca8043 100644
--- a/docs/reference/connector/docs/connectors-ms-sql.asciidoc
+++ b/docs/reference/connector/docs/connectors-ms-sql.asciidoc
@@ -196,7 +196,7 @@ Here are a few examples of advanced sync rules for this connector.
 ====
 
 [discrete#es-connectors-ms-sql-sync-rules-advanced-queries]
-======= Example: Two queries
+*Example: Two queries*
 
 These rules fetch all records from both the `employee` and `customer` tables. The data from these tables will be synced separately to Elasticsearch.
 
@@ -220,7 +220,7 @@ These rules fetch all records from both the `employee` and `customer` tables. Th
 // NOTCONSOLE
 
 [discrete#es-connectors-ms-sql-sync-rules-example-one-where]
-======= Example: One WHERE query
+*Example: One WHERE query*
 
 This rule fetches only the records from the `employee` table where the `emp_id` is greater than 5. Only these filtered records will be synced to Elasticsearch.
 
@@ -236,7 +236,7 @@ This rule fetches only the records from the `employee` table where the `emp_id`
 // NOTCONSOLE
 
 [discrete#es-connectors-ms-sql-sync-rules-example-one-join]
-======= Example: One JOIN query
+*Example: One JOIN query*
 
 This rule fetches records by performing an INNER JOIN between the `employee` and `customer` tables on the condition that the `emp_id` in `employee` matches the `c_id` in `customer`. The result of this combined data will be synced to Elasticsearch.
 
@@ -484,7 +484,7 @@ Here are a few examples of advanced sync rules for this connector.
 ====
 
 [discrete#es-connectors-ms-sql-client-sync-rules-advanced-queries]
-======= Example: Two queries
+*Example: Two queries*
 
 These rules fetch all records from both the `employee` and `customer` tables. The data from these tables will be synced separately to Elasticsearch.
 
@@ -508,7 +508,7 @@ These rules fetch all records from both the `employee` and `customer` tables. Th
 // NOTCONSOLE
 
 [discrete#es-connectors-ms-sql-client-sync-rules-example-one-where]
-======= Example: One WHERE query
+*Example: One WHERE query*
 
 This rule fetches only the records from the `employee` table where the `emp_id` is greater than 5. Only these filtered records will be synced to Elasticsearch.
 
@@ -524,7 +524,7 @@ This rule fetches only the records from the `employee` table where the `emp_id`
 // NOTCONSOLE
 
 [discrete#es-connectors-ms-sql-client-sync-rules-example-one-join]
-======= Example: One JOIN query
+*Example: One JOIN query*
 
 This rule fetches records by performing an INNER JOIN between the `employee` and `customer` tables on the condition that the `emp_id` in `employee` matches the `c_id` in `customer`. The result of this combined data will be synced to Elasticsearch.
 
diff --git a/docs/reference/connector/docs/connectors-network-drive.asciidoc b/docs/reference/connector/docs/connectors-network-drive.asciidoc
index 91c9d3b28c385..909e3440c9f02 100644
--- a/docs/reference/connector/docs/connectors-network-drive.asciidoc
+++ b/docs/reference/connector/docs/connectors-network-drive.asciidoc
@@ -174,7 +174,7 @@ Advanced sync rules for this connector use *glob patterns*.
 The following sections provide examples of advanced sync rules for this connector.
 
 [discrete#es-connectors-network-drive-indexing-files-and-folders-recursively-within-folders]
-======= Indexing files and folders recursively within folders
+*Indexing files and folders recursively within folders*
 
 [source,js]
 ----
@@ -190,7 +190,7 @@ The following sections provide examples of advanced sync rules for this connecto
 // NOTCONSOLE
 
 [discrete#es-connectors-network-drive-indexing-files-and-folders-directly-inside-folder]
-======= Indexing files and folders directly inside folder
+*Indexing files and folders directly inside folder*
 
 [source,js]
 ----
@@ -203,7 +203,7 @@ The following sections provide examples of advanced sync rules for this connecto
 // NOTCONSOLE
 
 [discrete#es-connectors-network-drive-indexing-files-and-folders-directly-inside-a-set-of-folders]
-======= Indexing files and folders directly inside a set of folders
+*Indexing files and folders directly inside a set of folders*
 
 [source,js]
 ----
@@ -216,7 +216,7 @@ The following sections provide examples of advanced sync rules for this connecto
 // NOTCONSOLE
 
 [discrete#es-connectors-network-drive-excluding-files-and-folders-that-match-a-pattern]
-======= Excluding files and folders that match a pattern
+*Excluding files and folders that match a pattern*
 
 [source,js]
 ----
@@ -432,7 +432,7 @@ Advanced sync rules for this connector use *glob patterns*.
 The following sections provide examples of advanced sync rules for this connector.
 
 [discrete#es-connectors-network-drive-client-indexing-files-and-folders-recursively-within-folders]
-======= Indexing files and folders recursively within folders
+*Indexing files and folders recursively within folders*
 
 [source,js]
 ----
@@ -448,7 +448,7 @@ The following sections provide examples of advanced sync rules for this connecto
 // NOTCONSOLE
 
 [discrete#es-connectors-network-drive-client-indexing-files-and-folders-directly-inside-folder]
-======= Indexing files and folders directly inside folder
+*Indexing files and folders directly inside folder*
 
 [source,js]
 ----
@@ -461,7 +461,7 @@ The following sections provide examples of advanced sync rules for this connecto
 // NOTCONSOLE
 
 [discrete#es-connectors-network-drive-client-indexing-files-and-folders-directly-inside-a-set-of-folders]
-======= Indexing files and folders directly inside a set of folders
+*Indexing files and folders directly inside a set of folders*
 
 [source,js]
 ----
@@ -474,7 +474,7 @@ The following sections provide examples of advanced sync rules for this connecto
 // NOTCONSOLE
 
 [discrete#es-connectors-network-drive-client-excluding-files-and-folders-that-match-a-pattern]
-======= Excluding files and folders that match a pattern
+*Excluding files and folders that match a pattern*
 
 [source,js]
 ----
diff --git a/docs/reference/connector/docs/connectors-notion.asciidoc b/docs/reference/connector/docs/connectors-notion.asciidoc
index 2d7a71bff20de..7c08c5d81e032 100644
--- a/docs/reference/connector/docs/connectors-notion.asciidoc
+++ b/docs/reference/connector/docs/connectors-notion.asciidoc
@@ -140,7 +140,7 @@ Advanced sync rules for Notion take the following parameters:
 ====== Examples
 
 [discrete]
-======= Example 1
+*Example 1*
 
 Indexing every page where the title contains `Demo Page`:
 
@@ -160,7 +160,7 @@ Indexing every page where the title contains `Demo Page`:
 // NOTCONSOLE
 
 [discrete]
-======= Example 2
+*Example 2*
 
 Indexing every database where the title contains `Demo Database`:
 
@@ -180,7 +180,7 @@ Indexing every database where the title contains `Demo Database`:
 // NOTCONSOLE
 
 [discrete]
-======= Example 3
+*Example 3*
 
 Indexing every database where the title contains `Demo Database` and every page where the title contains `Demo Page`:
 
@@ -206,7 +206,7 @@ Indexing every database where the title contains `Demo Database` and every page
 // NOTCONSOLE
 
 [discrete]
-======= Example 4
+*Example 4*
 
 Indexing all pages in the workspace:
 
@@ -226,7 +226,7 @@ Indexing all pages in the workspace:
 // NOTCONSOLE
 
 [discrete]
-======= Example 5
+*Example 5*
 
 Indexing all the pages and databases connected to the workspace:
 
@@ -243,7 +243,7 @@ Indexing all the pages and databases connected to the workspace:
 // NOTCONSOLE
 
 [discrete]
-======= Example 6
+*Example 6*
 
 Indexing all the rows of a database where the record is `true` for the column `Task completed` and its property(datatype) is a checkbox:
 
@@ -266,7 +266,7 @@ Indexing all the rows of a database where the record is `true` for the column `T
 // NOTCONSOLE
 
 [discrete]
-======= Example 7
+*Example 7*
 
 Indexing all rows of a specific database:
 
@@ -283,7 +283,7 @@ Indexing all rows of a specific database:
 // NOTCONSOLE
 
 [discrete]
-======= Example 8
+*Example 8*
 
 Indexing all blocks defined in `searches` and `database_query_filters`:
 
@@ -498,7 +498,7 @@ Advanced sync rules for Notion take the following parameters:
 ====== Examples
 
 [discrete]
-======= Example 1
+*Example 1*
 
 Indexing every page where the title contains `Demo Page`:
 
@@ -518,7 +518,7 @@ Indexing every page where the title contains `Demo Page`:
 // NOTCONSOLE
 
 [discrete]
-======= Example 2
+*Example 2*
 
 Indexing every database where the title contains `Demo Database`:
 
@@ -538,7 +538,7 @@ Indexing every database where the title contains `Demo Database`:
 // NOTCONSOLE
 
 [discrete]
-======= Example 3
+*Example 3*
 
 Indexing every database where the title contains `Demo Database` and every page where the title contains `Demo Page`:
 
@@ -564,7 +564,7 @@ Indexing every database where the title contains `Demo Database` and every page
 // NOTCONSOLE
 
 [discrete]
-======= Example 4
+*Example 4*
 
 Indexing all pages in the workspace:
 
@@ -584,7 +584,7 @@ Indexing all pages in the workspace:
 // NOTCONSOLE
 
 [discrete]
-======= Example 5
+*Example 5*
 
 Indexing all the pages and databases connected to the workspace:
 
@@ -601,7 +601,7 @@ Indexing all the pages and databases connected to the workspace:
 // NOTCONSOLE
 
 [discrete]
-======= Example 6
+*Example 6*
 
 Indexing all the rows of a database where the record is `true` for the column `Task completed` and its property(datatype) is a checkbox:
 
@@ -624,7 +624,7 @@ Indexing all the rows of a database where the record is `true` for the column `T
 // NOTCONSOLE
 
 [discrete]
-======= Example 7
+*Example 7*
 
 Indexing all rows of a specific database:
 
@@ -641,7 +641,7 @@ Indexing all rows of a specific database:
 // NOTCONSOLE
 
 [discrete]
-======= Example 8
+*Example 8*
 
 Indexing all blocks defined in `searches` and `database_query_filters`:
 
diff --git a/docs/reference/connector/docs/connectors-onedrive.asciidoc b/docs/reference/connector/docs/connectors-onedrive.asciidoc
index 7d1a21aeb78db..44ac96e2ad99d 100644
--- a/docs/reference/connector/docs/connectors-onedrive.asciidoc
+++ b/docs/reference/connector/docs/connectors-onedrive.asciidoc
@@ -160,7 +160,7 @@ A <<es-connectors-sync-types-full, full sync>> is required for advanced sync rul
 Here are a few examples of advanced sync rules for this connector.
 
 [discrete#es-connectors-onedrive-sync-rules-advanced-examples-1]
-======= Example 1
+*Example 1*
 
 This rule skips indexing for files with `.xlsx` and `.docx` extensions.
 All other files and folders will be indexed.
@@ -176,7 +176,7 @@ All other files and folders will be indexed.
 // NOTCONSOLE
 
 [discrete#es-connectors-onedrive-sync-rules-advanced-examples-2]
-======= Example 2
+*Example 2*
 
 This rule focuses on indexing files and folders owned by `user1-domain@onmicrosoft.com` and `user2-domain@onmicrosoft.com` but excludes files with `.py` extension.
 
@@ -192,7 +192,7 @@ This rule focuses on indexing files and folders owned by `user1-domain@onmicroso
 // NOTCONSOLE
 
 [discrete#es-connectors-onedrive-sync-rules-advanced-examples-3]
-======= Example 3
+*Example 3*
 
 This rule indexes only the files and folders directly inside the root folder, excluding any `.md` files.
 
@@ -208,7 +208,7 @@ This rule indexes only the files and folders directly inside the root folder, ex
 // NOTCONSOLE
 
 [discrete#es-connectors-onedrive-sync-rules-advanced-examples-4]
-======= Example 4
+*Example 4*
 
 This rule indexes files and folders owned by `user1-domain@onmicrosoft.com` and `user3-domain@onmicrosoft.com` that are directly inside the `abc` folder, which is a subfolder of any folder under the `hello` directory in the root. Files with extensions `.pdf` and `.py` are excluded.
 
@@ -225,7 +225,7 @@ This rule indexes files and folders owned by `user1-domain@onmicrosoft.com` and
 // NOTCONSOLE
 
 [discrete#es-connectors-onedrive-sync-rules-advanced-examples-5]
-======= Example 5
+*Example 5*
 
 This example contains two rules.
 The first rule indexes all files and folders owned by `user1-domain@onmicrosoft.com` and `user2-domain@onmicrosoft.com`.
@@ -245,7 +245,7 @@ The second rule indexes files for all other users, but skips files with a `.py`
 // NOTCONSOLE
 
 [discrete#es-connectors-onedrive-sync-rules-advanced-examples-6]
-======= Example 6
+*Example 6*
 
 This example contains two rules.
 The first rule indexes all files owned by `user1-domain@onmicrosoft.com` and `user2-domain@onmicrosoft.com`, excluding `.md` files.
@@ -449,7 +449,7 @@ A <<es-connectors-sync-types-full, full sync>> is required for advanced sync rul
 Here are a few examples of advanced sync rules for this connector.
 
 [discrete#es-connectors-onedrive-client-sync-rules-advanced-examples-1]
-======= Example 1
+*Example 1*
 
 This rule skips indexing for files with `.xlsx` and `.docx` extensions.
 All other files and folders will be indexed.
@@ -465,7 +465,7 @@ All other files and folders will be indexed.
 // NOTCONSOLE
 
 [discrete#es-connectors-onedrive-client-sync-rules-advanced-examples-2]
-======= Example 2
+*Example 2*
 
 This rule focuses on indexing files and folders owned by `user1-domain@onmicrosoft.com` and `user2-domain@onmicrosoft.com` but excludes files with `.py` extension.
 
@@ -481,7 +481,7 @@ This rule focuses on indexing files and folders owned by `user1-domain@onmicroso
 // NOTCONSOLE
 
 [discrete#es-connectors-onedrive-client-sync-rules-advanced-examples-3]
-======= Example 3
+*Example 3*
 
 This rule indexes only the files and folders directly inside the root folder, excluding any `.md` files.
 
@@ -497,7 +497,7 @@ This rule indexes only the files and folders directly inside the root folder, ex
 // NOTCONSOLE
 
 [discrete#es-connectors-onedrive-client-sync-rules-advanced-examples-4]
-======= Example 4
+*Example 4*
 
 This rule indexes files and folders owned by `user1-domain@onmicrosoft.com` and `user3-domain@onmicrosoft.com` that are directly inside the `abc` folder, which is a subfolder of any folder under the `hello` directory in the root. Files with extensions `.pdf` and `.py` are excluded.
 
@@ -514,7 +514,7 @@ This rule indexes files and folders owned by `user1-domain@onmicrosoft.com` and
 // NOTCONSOLE
 
 [discrete#es-connectors-onedrive-client-sync-rules-advanced-examples-5]
-======= Example 5
+*Example 5*
 
 This example contains two rules.
 The first rule indexes all files and folders owned by `user1-domain@onmicrosoft.com` and `user2-domain@onmicrosoft.com`.
@@ -534,7 +534,7 @@ The second rule indexes files for all other users, but skips files with a `.py`
 // NOTCONSOLE
 
 [discrete#es-connectors-onedrive-client-sync-rules-advanced-examples-6]
-======= Example 6
+*Example 6*
 
 This example contains two rules.
 The first rule indexes all files owned by `user1-domain@onmicrosoft.com` and `user2-domain@onmicrosoft.com`, excluding `.md` files.
diff --git a/docs/reference/connector/docs/connectors-postgresql.asciidoc b/docs/reference/connector/docs/connectors-postgresql.asciidoc
index 1fe28f867337c..aa6cb7f29e633 100644
--- a/docs/reference/connector/docs/connectors-postgresql.asciidoc
+++ b/docs/reference/connector/docs/connectors-postgresql.asciidoc
@@ -188,7 +188,7 @@ Advanced sync rules are defined through a source-specific DSL JSON snippet.
 Here is some example data that will be used in the following examples.
 
 [discrete#connectors-postgresql-sync-rules-advanced-example-data-1]
-======= `employee` table
+*`employee` table*
 
 [cols="3*", options="header"]
 |===
@@ -199,7 +199,7 @@ Here is some example data that will be used in the following examples.
 |===
 
 [discrete#connectors-postgresql-sync-rules-advanced-example-2]
-======= `customer` table
+*`customer` table*
 
 [cols="3*", options="header"]
 |===
@@ -213,7 +213,7 @@ Here is some example data that will be used in the following examples.
 ====== Advanced sync rules examples
 
 [discrete#connectors-postgresql-sync-rules-advanced-examples-1]
-======= Multiple table queries
+*Multiple table queries*
 
 [source,js]
 ----
@@ -235,7 +235,7 @@ Here is some example data that will be used in the following examples.
 // NOTCONSOLE
 
 [discrete#connectors-postgresql-sync-rules-advanced-examples-1-id-columns]
-======= Multiple table queries with `id_columns`
+*Multiple table queries with `id_columns`*
 
 In 8.15.0, we added a new optional `id_columns` field in our advanced sync rules for the PostgreSQL connector.
 Use the `id_columns` field to ingest tables which do not have a primary key. Include the names of unique fields so that the connector can use them to generate unique IDs for documents.
@@ -264,7 +264,7 @@ Use the `id_columns` field to ingest tables which do not have a primary key. Inc
 This example uses the `id_columns` field to specify the unique fields `emp_id` and `c_id` for the `employee` and `customer` tables, respectively.
 
 [discrete#connectors-postgresql-sync-rules-advanced-examples-2]
-======= Filtering data with `WHERE` clause
+*Filtering data with `WHERE` clause*
 
 [source,js]
 ----
@@ -278,7 +278,7 @@ This example uses the `id_columns` field to specify the unique fields `emp_id` a
 // NOTCONSOLE
 
 [discrete#connectors-postgresql-sync-rules-advanced-examples-3]
-======= `JOIN` operations
+*`JOIN` operations*
 
 [source,js]
 ----
@@ -494,7 +494,7 @@ Advanced sync rules are defined through a source-specific DSL JSON snippet.
 Here is some example data that will be used in the following examples.
 
 [discrete#es-connectors-postgresql-client-sync-rules-advanced-example-data-1]
-======= `employee` table
+*`employee` table*
 
 [cols="3*", options="header"]
 |===
@@ -505,7 +505,7 @@ Here is some example data that will be used in the following examples.
 |===
 
 [discrete#es-connectors-postgresql-client-sync-rules-advanced-example-2]
-======= `customer` table
+*`customer` table*
 
 [cols="3*", options="header"]
 |===
@@ -519,7 +519,7 @@ Here is some example data that will be used in the following examples.
 ====== Advanced sync rules examples
 
 [discrete#es-connectors-postgresql-client-sync-rules-advanced-examples-1]
-======== Multiple table queries
+*Multiple table queries*
 
 [source,js]
 ----
@@ -541,7 +541,7 @@ Here is some example data that will be used in the following examples.
 // NOTCONSOLE
 
 [discrete#es-connectors-postgresql-client-sync-rules-advanced-examples-1-id-columns]
-======== Multiple table queries with `id_columns`
+*Multiple table queries with `id_columns`*
 
 In 8.15.0, we added a new optional `id_columns` field in our advanced sync rules for the PostgreSQL connector.
 Use the `id_columns` field to ingest tables which do not have a primary key. Include the names of unique fields so that the connector can use them to generate unique IDs for documents.
@@ -570,7 +570,7 @@ Use the `id_columns` field to ingest tables which do not have a primary key. Inc
 This example uses the `id_columns` field to specify the unique fields `emp_id` and `c_id` for the `employee` and `customer` tables, respectively.
 
 [discrete#es-connectors-postgresql-client-sync-rules-advanced-examples-2]
-======== Filtering data with `WHERE` clause
+*Filtering data with `WHERE` clause*
 
 [source,js]
 ----
@@ -584,7 +584,7 @@ This example uses the `id_columns` field to specify the unique fields `emp_id` a
 // NOTCONSOLE
 
 [discrete#es-connectors-postgresql-client-sync-rules-advanced-examples-3]
-======== `JOIN` operations
+*`JOIN` operations*
 
 [source,js]
 ----
diff --git a/docs/reference/connector/docs/connectors-s3.asciidoc b/docs/reference/connector/docs/connectors-s3.asciidoc
index b4d08d3884631..90c070f7b8044 100644
--- a/docs/reference/connector/docs/connectors-s3.asciidoc
+++ b/docs/reference/connector/docs/connectors-s3.asciidoc
@@ -118,7 +118,7 @@ The connector will fetch file and folder data that matches the string.
 Defaults to `""` (syncs all bucket objects).
 
 [discrete#es-connectors-s3-sync-rules-advanced-examples]
-======= Advanced sync rules examples
+*Advanced sync rules examples*
 
 *Fetching files and folders recursively by prefix*
 
@@ -336,7 +336,7 @@ The connector will fetch file and folder data that matches the string.
 Defaults to `""` (syncs all bucket objects).
 
 [discrete#es-connectors-s3-client-sync-rules-advanced-examples]
-======= Advanced sync rules examples
+*Advanced sync rules examples*
 
 *Fetching files and folders recursively by prefix*
 
diff --git a/docs/reference/connector/docs/connectors-salesforce.asciidoc b/docs/reference/connector/docs/connectors-salesforce.asciidoc
index 3676f7663089c..c640751de92c0 100644
--- a/docs/reference/connector/docs/connectors-salesforce.asciidoc
+++ b/docs/reference/connector/docs/connectors-salesforce.asciidoc
@@ -227,7 +227,7 @@ They take the following parameters:
 Allowed values are *SOQL* and *SOSL*.
 
 [discrete#es-connectors-salesforce-sync-rules-advanced-fetch-query-language]
-======= Fetch documents based on the query and language specified
+*Fetch documents based on the query and language specified*
 
 **Example**: Fetch documents using SOQL query
 
@@ -256,7 +256,7 @@ Allowed values are *SOQL* and *SOSL*.
 // NOTCONSOLE
 
 [discrete#es-connectors-salesforce-sync-rules-advanced-fetch-objects]
-======= Fetch standard and custom objects using SOQL and SOSL queries
+*Fetch standard and custom objects using SOQL and SOSL queries*
 
 **Example**: Fetch documents for standard objects via SOQL and SOSL query.
 
@@ -293,7 +293,7 @@ Allowed values are *SOQL* and *SOSL*.
 // NOTCONSOLE
 
 [discrete#es-connectors-salesforce-sync-rules-advanced-fetch-standard-custom-fields]
-======= Fetch documents with standard and custom fields
+*Fetch documents with standard and custom fields*
 
 **Example**: Fetch documents with all standard and custom fields for Account object.
 
@@ -626,7 +626,7 @@ They take the following parameters:
 Allowed values are *SOQL* and *SOSL*.
 
 [discrete#es-connectors-salesforce-client-sync-rules-advanced-fetch-query-language]
-======= Fetch documents based on the query and language specified
+*Fetch documents based on the query and language specified*
 
 **Example**: Fetch documents using SOQL query
 
@@ -655,7 +655,7 @@ Allowed values are *SOQL* and *SOSL*.
 // NOTCONSOLE
 
 [discrete#es-connectors-salesforce-client-sync-rules-advanced-fetch-objects]
-======= Fetch standard and custom objects using SOQL and SOSL queries
+*Fetch standard and custom objects using SOQL and SOSL queries*
 
 **Example**: Fetch documents for standard objects via SOQL and SOSL query.
 
@@ -692,7 +692,7 @@ Allowed values are *SOQL* and *SOSL*.
 // NOTCONSOLE
 
 [discrete#es-connectors-salesforce-client-sync-rules-advanced-fetch-standard-custom-fields]
-======= Fetch documents with standard and custom fields
+*Fetch documents with standard and custom fields*
 
 **Example**: Fetch documents with all standard and custom fields for Account object.
 
diff --git a/docs/reference/connector/docs/connectors-servicenow.asciidoc b/docs/reference/connector/docs/connectors-servicenow.asciidoc
index a02c418f11d74..3dc98ed9a44c9 100644
--- a/docs/reference/connector/docs/connectors-servicenow.asciidoc
+++ b/docs/reference/connector/docs/connectors-servicenow.asciidoc
@@ -167,7 +167,7 @@ Advanced sync rules are defined through a source-specific DSL JSON snippet.
 The following sections provide examples of advanced sync rules for this connector.
 
 [discrete#es-connectors-servicenow-sync-rules-number-incident-service]
-======= Indexing document based on incident number for Incident service
+*Indexing document based on incident number for Incident service*
 
 [source,js]
 ----
@@ -181,7 +181,7 @@ The following sections provide examples of advanced sync rules for this connecto
 // NOTCONSOLE
 
 [discrete#es-connectors-servicenow-sync-rules-active-false-user-service]
-======= Indexing document based on user activity state for User service
+*Indexing document based on user activity state for User service*
 
 [source,js]
 ----
@@ -195,7 +195,7 @@ The following sections provide examples of advanced sync rules for this connecto
 // NOTCONSOLE
 
 [discrete#es-connectors-servicenow-sync-rules-author-administrator-knowledge-service]
-======= Indexing document based on author name for Knowledge service
+*Indexing document based on author name for Knowledge service*
 
 [source,js]
 ----
@@ -407,7 +407,7 @@ Advanced sync rules are defined through a source-specific DSL JSON snippet.
 The following sections provide examples of advanced sync rules for this connector.
 
 [discrete#es-connectors-servicenow-client-sync-rules-number-incident-service]
-======= Indexing document based on incident number for Incident service
+*Indexing document based on incident number for Incident service*
 
 [source,js]
 ----
@@ -421,7 +421,7 @@ The following sections provide examples of advanced sync rules for this connecto
 // NOTCONSOLE
 
 [discrete#es-connectors-servicenow-client-sync-rules-active-false-user-service]
-======= Indexing document based on user activity state for User service
+*Indexing document based on user activity state for User service*
 
 [source,js]
 ----
@@ -435,7 +435,7 @@ The following sections provide examples of advanced sync rules for this connecto
 // NOTCONSOLE
 
 [discrete#es-connectors-servicenow-client-sync-rules-author-administrator-knowledge-service]
-======= Indexing document based on author name for Knowledge service
+*Indexing document based on author name for Knowledge service*
 
 [source,js]
 ----
diff --git a/docs/reference/connector/docs/connectors-sharepoint-online.asciidoc b/docs/reference/connector/docs/connectors-sharepoint-online.asciidoc
index 21d0890e436c5..02f598c16f63c 100644
--- a/docs/reference/connector/docs/connectors-sharepoint-online.asciidoc
+++ b/docs/reference/connector/docs/connectors-sharepoint-online.asciidoc
@@ -277,7 +277,7 @@ Example:
 This rule will not extract content of any drive items (files in document libraries) that haven't been modified for 60 days or more.
 
 [discrete#es-connectors-sharepoint-online-sync-rules-limitations]
-======= Limitations of sync rules with incremental syncs
+*Limitations of sync rules with incremental syncs*
 
 Changing sync rules after Sharepoint Online content has already been indexed can bring unexpected results, when using <<es-connectors-sync-types-incremental,incremental syncs>>.
 
@@ -288,7 +288,7 @@ Incremental syncs ensure _updates_ from 3rd-party system, but do not modify exis
 Let's take a look at several examples where incremental syncs might lead to inconsistent data on your index.
 
 [discrete#es-connectors-sharepoint-online-sync-rules-limitations-restrictive-added]
-======== Example: Restrictive basic sync rule added after a full sync
+*Example: Restrictive basic sync rule added after a full sync*
 
 Imagine your Sharepoint Online drive contains the following drive items:
 
@@ -322,7 +322,7 @@ If no files were changed, incremental sync will not receive information about ch
 After a *full sync*, the index will be updated and files that are excluded by sync rules will be removed.
 
 [discrete#es-connectors-sharepoint-online-sync-rules-limitations-restrictive-removed]
-======== Example: Restrictive basic sync rules removed after a full sync
+*Example: Restrictive basic sync rules removed after a full sync*
 
 Imagine that Sharepoint Online drive has the following drive items:
 
@@ -354,7 +354,7 @@ Afterwards, we can remove the filtering rule and run an incremental sync. If no
 Only a *full sync* will include the items previously ignored by the sync rule.
 
 [discrete#es-connectors-sharepoint-online-sync-rules-limitations-restrictive-changed]
-======== Example: Advanced sync rules edge case
+*Example: Advanced sync rules edge case*
 
 Advanced sync rules can be applied to limit which documents will have content extracted.
 For example, it's possible to set a rule so that documents older than 180 days won't have content extracted.
@@ -763,7 +763,7 @@ Example:
 This rule will not extract content of any drive items (files in document libraries) that haven't been modified for 60 days or more.
 
 [discrete#es-connectors-sharepoint-online-client-sync-rules-limitations]
-======= Limitations of sync rules with incremental syncs
+*Limitations of sync rules with incremental syncs*
 
 Changing sync rules after Sharepoint Online content has already been indexed can bring unexpected results, when using <<es-connectors-sync-types-incremental,incremental syncs>>.
 
@@ -774,7 +774,7 @@ Incremental syncs ensure _updates_ from 3rd-party system, but do not modify exis
 Let's take a look at several examples where incremental syncs might lead to inconsistent data on your index.
 
 [discrete#es-connectors-sharepoint-online-client-sync-rules-limitations-restrictive-added]
-======== Example: Restrictive basic sync rule added after a full sync
+*Example: Restrictive basic sync rule added after a full sync*
 
 Imagine your Sharepoint Online drive contains the following drive items:
 
@@ -808,7 +808,7 @@ If no files were changed, incremental sync will not receive information about ch
 After a *full sync*, the index will be updated and files that are excluded by sync rules will be removed.
 
 [discrete#es-connectors-sharepoint-online-client-sync-rules-limitations-restrictive-removed]
-======== Example: Restrictive basic sync rules removed after a full sync
+*Example: Restrictive basic sync rules removed after a full sync*
 
 Imagine that Sharepoint Online drive has the following drive items:
 
@@ -840,7 +840,7 @@ Afterwards, we can remove the filtering rule and run an incremental sync. If no
 Only a *full sync* will include the items previously ignored by the sync rule.
 
 [discrete#es-connectors-sharepoint-online-client-sync-rules-limitations-restrictive-changed]
-======== Example: Advanced sync rules edge case
+*Example: Advanced sync rules edge case*
 
 Advanced sync rules can be applied to limit which documents will have content extracted.
 For example, it's possible to set a rule so that documents older than 180 days won't have content extracted.