save work

Author: tvallin

docs/src/main/asciidoc/includes/openapi/openapi-generator.adoc

@@ -38,7 +38,7 @@ In the vocabulary of the tool, there are two _generators_ for Helidon:
 Each of these generators supports two _libraries_:
 
 * `mp` - for Helidon MP code generation
-* `se` - for Helidon SE code generation
+* `imperative` - for Helidon SE code generation
 
 Use the Helidon _client_ generator and its `{flavor-lc}` library to create a
 ifdef::mp-flavor[]
@@ -220,7 +220,7 @@ You must specify the following options:
 | `<library>`
 |Library you want to use
 |`mp` +
-`se`
+`imperative`
 |===
 
 === Recommended Settings for the OpenAPI Generator

docs/src/main/asciidoc/se/config/hierarchical-features.adoc

@@ -219,7 +219,7 @@ and has a single value.
 | `traverse()` +
 `traverse(Predicate<Config>)` | Returns a `Stream<Config>` as an iterative
 deepening depth-first traversal of the subtree
-|`type()` |Returns the `Type` enum value for the node: `OBJECT`, `LIST`, `VALUE`,
+|`type()` |Returns the `CompletionType` enum value for the node: `OBJECT`, `LIST`, `VALUE`,
 or `MISSING`
 |===
 

integrations/mcp/codegen/src/main/java/io/helidon/integrations/mcp/codegen/McpCodegenProvider.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright (c) 2025 Oracle and/or its affiliates.
+ *
+ * Licensed 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 io.helidon.integrations.mcp.codegen;
 
 import java.util.Set;

integrations/mcp/codegen/src/main/java/io/helidon/integrations/mcp/codegen/McpTypes.java

@@ -1,3 +1,19 @@
+/*
+ * Copyright (c) 2025 Oracle and/or its affiliates.
+ *
+ * Licensed 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 io.helidon.integrations.mcp.codegen;
 
 import io.helidon.common.types.TypeName;

integrations/mcp/server/src/main/java/io/helidon/integrations/mcp/server/Capability.java

@@ -47,5 +47,17 @@ enum Capability {
     /**
      * Enable pagination capability.
      */
-    PAGINATION
+    PAGINATION,
+    /**
+     * Sampling client capability.
+     */
+    SAMPLING,
+    /**
+     * Root client capability
+     */
+    ROOT,
+    /**
+     * Progress capability
+     */
+    PROGRESS
 }

integrations/mcp/server/src/main/java/io/helidon/integrations/mcp/server/Completion.java

@@ -25,45 +25,54 @@
  */
 @RuntimeType.PrototypedBy(CompletionConfig.class)
 public interface Completion extends RuntimeType.Api<CompletionConfig> {
+    /**
+     * Create a {@link Completion} instance from its configuration.
+     *
+     * @param config completion configuration
+     * @return completion instance
+     */
     static Completion create(CompletionConfig config) {
-        return new CompletionImpl(config.uri(), config.name(), config.completion());
+        return new CompletionImpl(config.reference(), config.completion());
     }
 
+    /**
+     * Create a {@link Completion} instance from its configuration builder.
+     *
+     * @param consumer configuration builder
+     * @return completion instance
+     */
     static Completion create(Consumer<CompletionConfig.Builder> consumer) {
         return CompletionConfig.builder()
                 .update(consumer)
                 .build();
     }
 
-    static CompletionConfig.Builder builder() {
-        return CompletionConfig.builder();
-    }
-
     /**
-     * Resource completion uri.
+     * Get completion builder.
      *
-     * @return uri
+     * @return builder
      */
-    String uri();
+    static CompletionConfig.Builder builder() {
+        return CompletionConfig.builder();
+    }
 
     /**
-     * Prompt completion name.
+     * Completion reference must be a {@link Prompt} name or a {@link Resource} uri template.
      *
-     * @return name
+     * @return completion reference
      */
-    String name();
+    String reference();
 
     /**
      * Completion content.
      *
      * @return content
      */
-    CompletionContent complete(McpParameters parameters);
+    CompletionContent complete(McpParameters parameters, McpFeatures features);
 
     default CompletionConfig prototype() {
         return CompletionConfig.builder()
-                .name(name())
-                .uri(uri())
+                .reference(reference())
                 .completion(this::complete)
                 .buildPrototype();
     }

integrations/mcp/server/src/main/java/io/helidon/integrations/mcp/server/CompletionConfigBlueprint.java

@@ -1,29 +1,39 @@
+/*
+ * Copyright (c) 2025 Oracle and/or its affiliates.
+ *
+ * Licensed 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 io.helidon.integrations.mcp.server;
 
+import java.util.function.BiFunction;
 import java.util.function.Function;
 
 import io.helidon.builder.api.Prototype;
 
 @Prototype.Blueprint
 interface CompletionConfigBlueprint extends Prototype.Factory<Completion>{
     /**
-     * Resource completion uri
-     *
-     * @return uri
-     */
-    String uri();
-
-    /**
-     * Prompt completion name.
+     * Completion reference must be a {@link Prompt} name or a {@link Resource} uri template.
      *
-     * @return name
+     * @return completion reference
      */
-    String name();
+    String reference();
 
     /**
      * Completion content.
      *
      * @return content
      */
-    Function<McpParameters, CompletionContent> completion();
+    BiFunction<McpParameters, McpFeatures, CompletionContent> completion();
 }

integrations/mcp/server/src/main/java/io/helidon/integrations/mcp/server/CompletionPrompt.java renamed to integrations/mcp/server/src/main/java/io/helidon/integrations/mcp/server/CompletionContentImpl.java

@@ -18,13 +18,11 @@
 
 import java.util.List;
 
-class CompletionPrompt implements CompletionContent {
+class CompletionContentImpl implements CompletionContent {
     private final List<String> values;
-    private final String name;
 
-    CompletionPrompt(String name, List<String> values) {
+    CompletionContentImpl(List<String> values) {
         this.values = values;
-        this.name = name;
     }
 
     @Override

integrations/mcp/server/src/main/java/io/helidon/integrations/mcp/server/CompletionContents.java

@@ -26,22 +26,12 @@ private CompletionContents() {
     }
 
     /**
-     * Create {@link Resource} completion content.
+     * Create a completion content.
      *
      * @param values completion values
      * @return completion content
      */
-    public static CompletionContent createResourceCompletion(String uri, List<String> values) {
-        return new CompletionResource(uri, values);
-    }
-
-    /**
-     * Create {@link Prompt} completion content.
-     *
-     * @param values completion values
-     * @return completion content
-     */
-    public static CompletionContent createPromptCompletion(String name, List<String> values) {
-        return new CompletionPrompt(name, values);
+    public static CompletionContent completion(List<String> values) {
+        return new CompletionContentImpl(values);
     }
 }

integrations/mcp/server/src/main/java/io/helidon/integrations/mcp/server/CompletionImpl.java

@@ -1,30 +1,39 @@
+/*
+ * Copyright (c) 2025 Oracle and/or its affiliates.
+ *
+ * Licensed 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 io.helidon.integrations.mcp.server;
 
-import java.util.function.Function;
+import java.util.function.BiFunction;
 
 class CompletionImpl implements Completion {
-    private final Function<McpParameters, CompletionContent> complete;
-    private final String uri;
-    private final String name;
+    private final String reference;
+    private final BiFunction<McpParameters, McpFeatures, CompletionContent> complete;
 
-    public CompletionImpl(String uri, String name, Function<McpParameters, CompletionContent> complete) {
-        this.uri = uri;
-        this.name = name;
+    public CompletionImpl(String reference, BiFunction<McpParameters, McpFeatures, CompletionContent> complete) {
+        this.reference = reference;
         this.complete = complete;
     }
 
     @Override
-    public String uri() {
-        return uri;
-    }
-
-    @Override
-    public String name() {
-        return name;
+    public String reference() {
+        return reference;
     }
 
     @Override
-    public CompletionContent complete(McpParameters parameters) {
-        return complete.apply(parameters);
+    public CompletionContent complete(McpParameters parameters, McpFeatures features) {
+        return complete.apply(parameters, features);
     }
 }