[ES|QL] s/autocompleteHint/hint

Author: afoucret

docs/reference/query-languages/esql/kibana/definition/functions/text_embedding.json

@@ -611,23 +611,23 @@ public static String normalizeName(String name) {
 
     public static class ArgSignature {
 
-        public record AutocompleteHint(String entityType, Map<String, String> constraints) {}
+        public record Hint(String entityType, Map<String, String> constraints) {}
 
         protected final String name;
         protected final String[] type;
         protected final String description;
         protected final boolean optional;
         protected final boolean variadic;
         protected final DataType targetDataType;
-        protected final AutocompleteHint autocompleteHint;
+        protected final Hint hint;
 
         public ArgSignature(
             String name,
             String[] type,
             String description,
             boolean optional,
             boolean variadic,
-            AutocompleteHint autocompleteHint,
+            Hint hint,
             DataType targetDataType
         ) {
             this.name = name;
@@ -636,18 +636,18 @@ public ArgSignature(
             this.optional = optional;
             this.variadic = variadic;
             this.targetDataType = targetDataType;
-            this.autocompleteHint = autocompleteHint;
+            this.hint = hint;
         }
 
         public ArgSignature(
             String name,
             String[] type,
             String description,
             boolean optional,
-            AutocompleteHint autocompleteHint,
+            Hint hint,
             boolean variadic
         ) {
-            this(name, type, description, optional, variadic, autocompleteHint, UNSUPPORTED);
+            this(name, type, description, optional, variadic, hint, UNSUPPORTED);
         }
 
         public ArgSignature(String name, String[] type, String description, boolean optional, boolean variadic, DataType targetDataType) {
@@ -838,12 +838,11 @@ public static ArgSignature param(Param param, boolean variadic) {
         String[] type = removeUnderConstruction(param.type());
         String desc = param.description().replace('\n', ' ');
         DataType targetDataType = getTargetType(type);
-        ArgSignature.AutocompleteHint autocompleteHint = null;
-        if (param.autocompleteHint() != null && param.autocompleteHint().entityType() != Param.AutocompleteHint.ENTITY_TYPE.NONE) {
-            Map<String, String> constraints = Arrays.stream(param.autocompleteHint().constraints())
-                .collect(Collectors.toMap(Param.AutocompleteHint.Constraint::name, Param.AutocompleteHint.Constraint::value));
-            autocompleteHint = new ArgSignature.AutocompleteHint(
-                param.autocompleteHint().entityType().name().toLowerCase(Locale.ROOT),
+        ArgSignature.Hint hint = null;
+        if (param.hint() != null && param.hint().entityType() != Param.Hint.ENTITY_TYPE.NONE) {
+            Map<String, String> constraints = Arrays.stream(param.hint().constraints())
+                .collect(Collectors.toMap(Param.Hint.Constraint::name, Param.Hint.Constraint::value));
+            hint = new ArgSignature.Hint(param.hint().entityType().name().toLowerCase(Locale.ROOT),
                 constraints
             );
         }
@@ -854,7 +853,7 @@ public static ArgSignature param(Param param, boolean variadic) {
             desc,
             param.optional(),
             variadic,
-            autocompleteHint,
+            hint,
             targetDataType
         );
     }

x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/EsqlFunctionRegistry.java

@@ -29,11 +29,11 @@
     boolean optional() default false;
 
     @Nullable
-    AutocompleteHint autocompleteHint() default @AutocompleteHint(entityType = AutocompleteHint.ENTITY_TYPE.NONE);
+    Hint hint() default @Hint(entityType = Hint.ENTITY_TYPE.NONE);
 
     @Retention(RetentionPolicy.RUNTIME)
     @Target(ElementType.PARAMETER)
-    @interface AutocompleteHint {
+    @interface Hint {
         enum ENTITY_TYPE {
             NONE,
             INFERENCE_ENDPOINT,

x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/Param.java

@@ -66,9 +66,9 @@ public TextEmbedding(
             description = "Identifier of an existing inference endpoint the that will generate the embeddings. "
                 + "The inference endpoint must have the `text_embedding` task type and should use the same model "
                 + "that was used to embed your indexed data.",
-            autocompleteHint = @Param.AutocompleteHint(
-                entityType = Param.AutocompleteHint.ENTITY_TYPE.INFERENCE_ENDPOINT,
-                constraints = { @Param.AutocompleteHint.Constraint(name = "task_type", value = "text_embedding") }
+            hint = @Param.Hint(
+                entityType = Param.Hint.ENTITY_TYPE.INFERENCE_ENDPOINT,
+                constraints = { @Param.Hint.Constraint(name = "task_type", value = "text_embedding") }
             )
         ) Expression inferenceId
     ) {

x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/expression/function/inference/TextEmbedding.java

@@ -1383,12 +1383,12 @@ void renderKibanaFunctionDefinition(
                         builder.field("optional", arg.optional());
                         String cleanedParamDesc = removeAppliesToBlocks(arg.description());
                         builder.field("description", cleanedParamDesc);
-                        if (arg.autocompleteHint != null) {
-                            builder.startObject("autocompleteHint");
-                            builder.field("entityType", arg.autocompleteHint.entityType());
-                            if (arg.autocompleteHint.constraints() != null && arg.autocompleteHint.constraints().size() > 0) {
+                        if (arg.hint != null) {
+                            builder.startObject("hint");
+                            builder.field("entityType", arg.hint.entityType());
+                            if (arg.hint.constraints() != null && arg.hint.constraints().size() > 0) {
                                 builder.startObject("constraints");
-                                for (Map.Entry<String, String> constraint : arg.autocompleteHint.constraints().entrySet()) {
+                                for (Map.Entry<String, String> constraint : arg.hint.constraints().entrySet()) {
                                     builder.field(constraint.getKey(), constraint.getValue());
                                 }
                                 builder.endObject();