Enable feature configuration

pom.xml

@@ -3,7 +3,7 @@
 
     <groupId>io.openliberty.tools</groupId>
     <artifactId>ci.common</artifactId>
-    <version>1.8.41-SNAPSHOT</version>
+    <version>2.0.0-AI-SNAPSHOT</version>
     <packaging>jar</packaging>
 
     <name>ci.common</name>
@@ -65,8 +65,8 @@
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
-        <maven.compiler.source>8</maven.compiler.source>
-        <maven.compiler.target>8</maven.compiler.target>
+        <maven.compiler.source>17</maven.compiler.source>
+        <maven.compiler.target>17</maven.compiler.target>
         <maven.javadoc.failOnError>false</maven.javadoc.failOnError>
     </properties>
 
@@ -98,6 +98,82 @@
             <artifactId>jackson-core</artifactId>
             <version>2.19.2</version>
         </dependency>
+        <!-- AI dependencies -->
+        <dependency>
+            <groupId>dev.langchain4j</groupId>
+            <artifactId>langchain4j</artifactId>
+            <version>1.7.1</version>
+        </dependency>
+        <dependency>
+            <groupId>dev.langchain4j</groupId>
+            <artifactId>langchain4j-github-models</artifactId>
+            <version>1.7.1-beta14</version>
+        </dependency>
+        <dependency>
+            <groupId>dev.langchain4j</groupId>
+            <artifactId>langchain4j-google-ai-gemini</artifactId>
+            <version>1.7.1</version>
+        </dependency>
+        <dependency>
+            <groupId>dev.langchain4j</groupId>
+            <artifactId>langchain4j-mistral-ai</artifactId>
+            <version>1.7.1</version>
+        </dependency>
+        <dependency>
+            <groupId>dev.langchain4j</groupId>
+            <artifactId>langchain4j-ollama</artifactId>
+            <version>1.7.1</version>
+        </dependency>
+        <dependency>
+            <groupId>dev.langchain4j</groupId>
+            <artifactId>langchain4j-agentic</artifactId>
+            <version>1.7.1-beta14</version>
+        </dependency>
+        <dependency>
+            <groupId>com.github.javaparser</groupId>
+            <artifactId>javaparser-core</artifactId>
+            <version>3.27.0</version>
+        </dependency>
+        <dependency>
+            <groupId>io.github.ollama4j</groupId>
+            <artifactId>ollama4j</artifactId>
+            <version>1.1.1</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.logging.log4j</groupId>
+            <artifactId>log4j-api</artifactId>
+            <version>2.25.1</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.logging.log4j</groupId>
+            <artifactId>log4j-core</artifactId>
+            <version>2.25.1</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.logging.log4j</groupId>
+            <artifactId>log4j-slf4j2-impl</artifactId>
+            <version>2.25.1</version>
+        </dependency>
+        <dependency>
+            <groupId>org.commonmark</groupId>
+            <artifactId>commonmark</artifactId>
+            <version>0.25.1</version>
+        </dependency>
+        <dependency>
+            <groupId>org.jboss.resteasy</groupId>
+            <artifactId>resteasy-json-binding-provider</artifactId>
+            <version>6.2.12.Final</version>
+        </dependency>
+        <dependency>
+            <groupId>org.fusesource.jansi</groupId>
+            <artifactId>jansi</artifactId>
+            <version>2.4.2</version>
+        </dependency>
+        <dependency>
+            <groupId>org.jline</groupId>
+            <artifactId>jline</artifactId>
+            <version>3.30.5</version>
+        </dependency>
     </dependencies>
 
     <build>

src/main/java/io/openliberty/tools/common/ai/ChatAgent.java

@@ -0,0 +1,146 @@
+/**
+ * (C) Copyright IBM Corporation 2025
+ *
+ * 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.openliberty.tools.common.ai;
+
+import dev.langchain4j.data.message.ToolExecutionResultMessage;
+import dev.langchain4j.exception.InvalidRequestException;
+import dev.langchain4j.memory.chat.MessageWindowChatMemory;
+import dev.langchain4j.rag.RetrievalAugmentor;
+import dev.langchain4j.service.AiServices;
+import io.openliberty.tools.common.ai.tools.CodingTools;
+import io.openliberty.tools.common.ai.tools.OpenLibertyTools;
+import io.openliberty.tools.common.ai.tools.StackOverFlowTools;
+import io.openliberty.tools.common.ai.util.Assistant;
+import io.openliberty.tools.common.ai.util.MarkdownConsoleFormatter;
+import io.openliberty.tools.common.ai.util.ModelBuilder;
+import io.openliberty.tools.common.ai.util.RagCreator;
+import io.openliberty.tools.common.ai.util.Utils;
+
+public class ChatAgent {
+    private ModelBuilder modelBuilder = new ModelBuilder();
+
+    private CodingTools codingTools;
+    private StackOverFlowTools stackOverFlowTools = new StackOverFlowTools();
+    private OpenLibertyTools openLibertyTools = new OpenLibertyTools();
+
+    private MarkdownConsoleFormatter mdFormatter = new MarkdownConsoleFormatter();
+
+    private Assistant assistant = null;
+
+    private int memoryId;
+
+    private boolean toolsEnabled = false;
+
+    public ChatAgent(int memoryId) throws Exception {
+        this(memoryId, new CodingTools());
+    }
+
+    public ChatAgent(int memoryId, CodingTools codingTools) throws Exception {
+        this.memoryId = memoryId;
+        this.codingTools = codingTools;
+        getAssistant();
+    }
+
+    public Assistant getAssistant() throws Exception {
+        if (assistant == null) {
+            AiServices<Assistant> builder =
+                AiServices.builder(Assistant.class)
+                    .chatModel(modelBuilder.getChatModel())
+                    .tools(stackOverFlowTools, codingTools, openLibertyTools)
+                    .hallucinatedToolNameStrategy(
+                        toolExecutionRequest -> ToolExecutionResultMessage.from(toolExecutionRequest,
+                            "Error: there is no tool with the following parameters called "
+                            + toolExecutionRequest.name()))
+                    .chatMemoryProvider(
+                         sessionId -> MessageWindowChatMemory.withMaxMessages(modelBuilder.getMaxMessages()));
+            RagCreator creator = new RagCreator();
+            RetrievalAugmentor retrivalAugmentator = creator.getRetrievalAugmentor(modelBuilder.getEmbeddingModel());
+            if (retrivalAugmentator == null) {
+                System.out.println("[WARNING] RAG is not set up successfully. Continuing without RAG.");
+            } else {
+                builder.retrievalAugmentor(retrivalAugmentator);
+            }
+            assistant = builder.build();
+
+            try {
+                assistant.chat(memoryId, "test");
+                toolsEnabled = true;
+            } catch (InvalidRequestException e) {
+                toolsEnabled = false;
+                if (e.getMessage().contains("does not support tools")) {
+                    System.out.println("WARNING: AI model " +
+                        modelBuilder.getModelName() + " does not support tools");
+                    builder = AiServices.builder(Assistant.class)
+                        .chatModel(modelBuilder.getChatModel())
+                        .chatMemoryProvider(
+                            sessionId -> MessageWindowChatMemory.withMaxMessages(modelBuilder.getMaxMessages()));
+                    if (retrivalAugmentator != null) {
+                        builder.retrievalAugmentor(retrivalAugmentator);
+                    }
+                    assistant = builder.build();
+                } else {
+                    throw new Exception(e);
+                }
+            } finally {
+                resetChat();
+            }
+        }
+        return assistant;
+    }
+
+    public String chat(String message) throws Exception {
+        if (message.equalsIgnoreCase("reset")) {
+            resetChat();
+            return "The current chat session is reset.\n";
+        } else {
+            String response = getAssistant().chat(memoryId, message).content();
+            if (response == null || response.isBlank()) {
+                return "AI reponsonded with nothing. Try your message again or a new message.\n";
+            }
+            return mdFormatter.rerender(response.trim());
+        }
+    }
+
+    public void resetChat() {
+        assistant.evictChatMemory(memoryId);
+        Utils.clearPermissions();
+    }
+
+    public String getModelName() {
+        return modelBuilder.getModelName();
+    }
+
+    public String getProvider() {
+        return modelBuilder.getProvider();
+    }
+
+    public String getToolsEnabled() {
+        return toolsEnabled ? "enabled" : "unavailable";
+    }
+
+    public Integer getTimeOut() {
+        return modelBuilder.getTimeOut();
+    }
+
+    public Integer getMaxNewToken() {
+        return modelBuilder.getMaxNewToken();
+    }
+
+    public Double getTemperature() {
+        return modelBuilder.getTemperature();
+    }
+
+}

src/main/java/io/openliberty/tools/common/ai/agents/ConfigureServerXmlAgent.java

@@ -0,0 +1,40 @@
+/**
+ * (C) Copyright IBM Corporation 2025
+ *
+ * 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.openliberty.tools.common.ai.agents;
+
+import dev.langchain4j.agentic.Agent;
+import dev.langchain4j.service.SystemMessage;
+import dev.langchain4j.service.UserMessage;
+import dev.langchain4j.service.V;
+
+public interface ConfigureServerXmlAgent {
+
+    @Agent("Construct a Liberty configuration definition in xml format")
+    @SystemMessage("""
+        You construct the configuration xml element of the Liberty feature {{configurationName}} 
+        for the user provided server.xml content,
+        simply use the xml from the following Liberty configuration document without adding any comment
+        and include the explanation of the attributes
+        by using the following Liberty configuration document:
+        {{configurationDoc}}
+        """)
+    @UserMessage("""
+        Here is the content of my server.xml:
+        {{fileContent}}
+        """)
+    public String addConfiguration(@V("configurationName") String configurationName, @V("configurationDoc") String configurationDoc, @V("fileContent") String fileContent);
+
+}

src/main/java/io/openliberty/tools/common/ai/agents/ReadConfigrationDocAgent.java

@@ -0,0 +1,49 @@
+/**
+ * (C) Copyright IBM Corporation 2025
+ *
+ * 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.openliberty.tools.common.ai.agents;
+
+import java.io.BufferedReader;
+import java.io.InputStreamReader;
+import java.net.URI;
+import java.net.URL;
+
+import dev.langchain4j.agentic.Agent;
+import dev.langchain4j.service.V;
+
+public class ReadConfigrationDocAgent {
+
+    @Agent(description = "Read Liberty configuration document", outputName = "configurationDoc")
+    public String readConfigrationDoc(@V("configurationName") String configurationName) {
+        try {
+            if (configurationName.contains("-")) {
+                configurationName = configurationName.substring(0, configurationName.indexOf("-"));
+            }
+            URI configurationUri = new URI("https://raw.githubusercontent.com/OpenLiberty/docs-generated/refs/heads/vNext/modules/reference/pages/config/" + configurationName + ".adoc");
+            URL url = configurationUri.toURL();
+            BufferedReader reader = new BufferedReader(new InputStreamReader(url.openStream()));
+            StringBuffer sb = new StringBuffer();
+            String line;
+            while ((line = reader.readLine()) != null) {
+                sb.append(line).append("\n");
+            }
+            return sb.toString();
+		} catch (Exception e) {
+            System.err.println("ReadConfigrationDocAgent exception: " + e.getMessage());
+			return "";
+		}
+    }
+
+}

src/main/java/io/openliberty/tools/common/ai/agents/ReadConfigrationTemplateAgent.java

@@ -0,0 +1,35 @@
+/**
+ * (C) Copyright IBM Corporation 2025
+ *
+ * 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.openliberty.tools.common.ai.agents;
+
+import dev.langchain4j.agentic.Agent;
+import dev.langchain4j.service.V;
+import io.openliberty.tools.common.ai.util.LibertyServerConfigurationUtil;
+
+public class ReadConfigrationTemplateAgent {
+
+    @Agent(description = "Read Liberty configuration document", outputName = "configurationDoc")
+    public String readConfigrationDoc(@V("configurationName") String configurationName) {
+        if (configurationName.contains("-")) {
+            configurationName = configurationName.substring(0, configurationName.indexOf("-"));
+        }
+        StringBuffer sb = new StringBuffer();
+        sb.append(LibertyServerConfigurationUtil.getConfigurationTemplate(configurationName))
+          .append(LibertyServerConfigurationUtil.getConfigurationAttributes(configurationName));
+        return sb.toString();
+    }
+
+}