Introducing ChatClient api.

Author: Raman Kumar

.gitignore

@@ -23,7 +23,7 @@
 hs_err_pid*
 replay_pid*
 
-.idea
+.idea/
 /ai-swagger-spring-boot-starter/.mvn/
 /ai-swagger-spring-boot-starter/mvnw
 /ai-swagger-spring-boot-starter/mvnw.cmd
@@ -33,4 +33,3 @@ replay_pid*
 /ai-swagger-helper-starter/.mvn/
 /ai-swagger-helper-starter/ai-swagger-helper-starter.iml
 /ai-swagger-helper-starter/mvnw.cmd
-/.idea/

README.md

@@ -0,0 +1,95 @@
+# 🚀 AI Dev Tools for Spring Boot
+
+A collection of **AI-powered Spring Boot starters** focused on **enhancing developer experience (DX)** during local development and testing.
+
+This repository contains production-grade tooling ideas that integrate deeply with the Spring ecosystem to help developers:
+- Fix APIs faster
+- Reduce repetitive work
+- Improve development experience during local runs
+
+> 🎯 **Goal**: Build AI-assisted developer tooling, not end-user applications.
+
+---
+
+## 📦 Repository Structure
+
+This is a **multi-module Maven project** with a shared parent POM.
+```
+ai-dev-tools
+├── .github/workflows
+├── LICENCE
+├── pom.xml # Parent POM
+├── ai-swagger-helper-starter # Swagger/OpenAPI DX tools
+├── demo-app # Usage example for all starters
+└── README.md
+```
+
+
+Each module:
+- Is a **Spring Boot starter**
+- Is independently usable
+- Focuses on a specific developer pain point
+
+---
+
+## 🧠 Why AI + Spring Boot Starters?
+
+Traditional developer tools provide **raw data** (logs, specs, stack traces).  
+These starters use AI to convert that data into **actionable insights**.
+
+Examples:
+- Explaining *why* an API change is breaking
+- Generating realistic request payloads from OpenAPI
+- Summarizing errors instead of dumping stack traces
+- Reducing cognitive load during development
+
+AI is used **only where reasoning or summarization adds value**, not as a gimmick.
+
+---
+
+## 🧩 Available Starters
+
+### 1️⃣ AI Swagger Helper Starter
+📁 `ai-swagger-helper-starter`
+
+Enhancements for Swagger / OpenAPI during development.
+
+**Features**
+- Adds a Swagger UI extension
+- Generates realistic, real-world request bodies
+- Helps developers test APIs faster without manually crafting payloads
+
+**Use case**
+- Local development
+- API testing
+
+---
+
+## 🛠 Planned / In-Progress Starters
+
+- **AI Exception Explainer Starter**  
+  Converts Spring stack traces into human-readable explanations.
+
+- **AI Exception Handler**
+
+(Each starter will live in its own module with independent documentation.)*
+
+---
+
+
+## 🧰 Tech Stack
+
+- Java 21+
+- Spring Boot 4
+- Spring Auto-Configuration
+- OpenAPI / Swagger
+- Maven (multi-module)
+- OpenRouter LLM integration (pluggable)
+
+---
+
+## 📌 Who Is This For?
+
+- Backend developers working with Spring Boot
+- Engineers interested in platform / tooling work
+- Developers exploring AI-assisted development workflows

ai-swagger-helper-starter/README.md

@@ -0,0 +1,77 @@
+# DevTools AI – Swagger Helper Starter
+
+A Spring Boot starter that improves **Swagger / OpenAPI developer experience** by automatically generating request bodies during development.
+
+The starter supports both **local random generation** and **optional AI-powered generation** (via Spring AI), with safe fallbacks and zero impact on application startup.
+
+AI is treated as an **optional enhancement**, not a requirement.
+
+---
+
+## 🎯 Problem
+
+During backend development, generating request bodies for APIs is:
+
+- repetitive  
+- time-consuming  
+- error-prone  
+- especially painful for complex schemas  
+
+Swagger UI shows schemas, but developers still have to manually craft payloads.
+
+This starter removes that friction.
+
+---
+
+## ✨ Features
+
+- Swagger UI extension with **Generate Request Body** action  
+- Local random request body generation (default)  
+- Optional AI-powered request body generation  
+- Automatic fallback to random generation on AI failure  
+- Fully configurable via properties
+
+---
+
+## 📦 Installation
+
+### Maven
+
+```xml
+<dependency>
+    <groupId>io.github.rexrk</groupId>
+    <artifactId>ai-swagger-helper-starter</artifactId>
+    <version>0.0.1-SNAPSHOT</version>
+</dependency>
+```
+
+---
+
+## ⚙️ Configuration
+
+Configure Spring AI (example with OpenAI):
+```yaml
+spring:
+  ai:
+    openai:
+      api-key: YOUR_API_KEY
+```
+
+
+```yaml
+devtools:
+  ai:
+    swagger:
+      enabled: true
+      mode: random
+```
+
+## 🔁 Generation Modes
+
+| Mode | Behavior |
+|-----|----------|
+| random | Always use local random generation |
+| ai | Use AI if available, fallback to random |
+| auto | Use AI when configured, otherwise random |
+
+---

ai-swagger-helper-starter/pom.xml

@@ -41,7 +41,7 @@
 
         <dependency>
             <groupId>org.springframework.ai</groupId>
-            <artifactId>spring-ai-openai</artifactId>
+            <artifactId>spring-ai-starter-model-openai</artifactId>
         </dependency>
 
         <dependency>

ai-swagger-helper-starter/src/main/java/io/github/rexrk/AiSwaggerHelperAutoConfiguration.java

@@ -14,9 +14,7 @@
 import org.springdoc.webmvc.ui.SwaggerIndexPageTransformer;
 import org.springdoc.webmvc.ui.SwaggerIndexTransformer;
 import org.springdoc.webmvc.ui.SwaggerWelcomeCommon;
-import org.springframework.ai.openai.OpenAiChatModel;
-import org.springframework.ai.openai.OpenAiChatOptions;
-import org.springframework.ai.openai.api.OpenAiApi;
+import org.springframework.ai.chat.client.ChatClient;
 import org.springframework.beans.factory.ObjectProvider;
 import org.springframework.boot.autoconfigure.AutoConfiguration;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
@@ -44,7 +42,7 @@
         jakarta.servlet.http.HttpServletRequest.class,
 })
 @ConditionalOnProperty(
-        prefix = "ai.swagger.helper",
+        prefix = AiSwaggerHelperProperties.prefix,
         name = "enabled",
         havingValue = BooleanUtils.TRUE,
         matchIfMissing = true
@@ -70,34 +68,10 @@ public ObjectMapper objectMapper() {
     /**
      * 1️⃣ Spring-Ai configuration
      */
-
-    @Bean
-    @ConditionalOnMissingBean(OpenAiApi.class)
-    @ConditionalOnProperty(prefix = "ai.swagger.helper", name = "api-key")
-    public OpenAiApi openAiApi(AiSwaggerHelperProperties properties) {
-        return OpenAiApi.builder()
-                .apiKey(properties.getApiKey())
-                .baseUrl(properties.getBaseUrl())
-                .build();
-
-    }
-
     @Bean
     @ConditionalOnMissingBean
-    @ConditionalOnProperty(prefix = "ai.swagger.helper", name = "api-key")
-    public OpenAiChatModel openAiChatModel(
-            AiSwaggerHelperProperties properties,
-            OpenAiApi openAiApi) {
-        OpenAiChatOptions options = OpenAiChatOptions.builder()
-                .model(properties.getModelName())
-                .temperature(properties.getTemperature())
-                .extraBody(properties.getOptions())
-                .build();
-
-        return OpenAiChatModel.builder()
-                .openAiApi(openAiApi)
-                .defaultOptions(options)
-                .build();
+    public ChatClient chatClient(ChatClient.Builder chatClientBuilder) {
+        return chatClientBuilder.build();
     }
 
     /**
@@ -106,10 +80,14 @@ public OpenAiChatModel openAiChatModel(
 
     @Bean
     public AiRequestBodyGeneratorService aiRequestBodyGeneratorService(
-            ObjectProvider<OpenAiChatModel> chatModel,
+            ObjectProvider<ChatClient> chatClientObjectProvider,
             ObjectMapper objectMapper
     ) {
-        return new AiRequestBodyGeneratorService(chatModel.getIfAvailable(), objectMapper);
+        return new AiRequestBodyGeneratorService(
+                chatClientObjectProvider.getIfAvailable(),
+                objectMapper,
+                properties.getMode()
+        );
 
     }
 
@@ -218,6 +196,6 @@ public Resource transform(HttpServletRequest request, Resource resource,
 
     @PostConstruct
     void logProps() {
-        if (properties.isEnabled()) log.info("AI Swagger Helper enabled");
+        if (properties.isEnabled()) log.info("AI Swagger Helper enabled. Mode: {}", properties.getMode());
     }
 }

ai-swagger-helper-starter/src/main/java/io/github/rexrk/AiSwaggerHelperProperties.java

@@ -2,42 +2,16 @@
 
 import org.springframework.boot.context.properties.ConfigurationProperties;
 
-import java.util.HashMap;
-import java.util.Map;
-
-@ConfigurationProperties(prefix = "ai.swagger.helper")
+@ConfigurationProperties(prefix = AiSwaggerHelperProperties.prefix)
 public class AiSwaggerHelperProperties {
+    public static final String prefix = "devtools.ai.swagger";
+    private boolean enabled = true;
+    private Mode mode = Mode.AUTO;
 
-    private boolean enabled = true; // Enable/disable AI generation feature
-    private String baseUrl = "https://openrouter.ai/api";
-    private String apiKey;
-    private String modelName = "openai/gpt-oss-20b:free";
-    private double temperature = 0.7;
-    private Map<String, Object> options = new HashMap<>();
-
-    // Getters and Setters
-    public String getApiKey() {
-        return apiKey;
-    }
-
-    public void setApiKey(String apiKey) {
-        this.apiKey = apiKey;
-    }
-
-    public String getModelName() {
-        return modelName;
-    }
-
-    public void setModelName(String modelName) {
-        this.modelName = modelName;
-    }
-
-    public double getTemperature() {
-        return temperature;
-    }
-
-    public void setTemperature(float temperature) {
-        this.temperature = temperature;
+    public enum Mode {
+        AI,
+        RANDOM,
+        AUTO
     }
 
     public boolean isEnabled() {
@@ -48,19 +22,11 @@ public void setEnabled(boolean enabled) {
         this.enabled = enabled;
     }
 
-    public Map<String, Object> getOptions() {
-        return options;
-    }
-
-    public void setOptions(Map<String, Object> options) {
-        this.options = options;
-    }
-
-    public String getBaseUrl() {
-        return baseUrl;
+    public Mode getMode() {
+        return mode;
     }
 
-    public void setBaseUrl(String baseUrl) {
-        this.baseUrl = baseUrl;
+    public void setMode(Mode mode) {
+        this.mode = mode;
     }
 }