docs: fix ollama4j API examples and clean gradle snippets

Author: GhostTypes

ai_docs/ollama/README.md

@@ -90,16 +90,17 @@ dependencies {
 ### 4. Basic Java Code
 ```java
 import io.github.ollama4j.Ollama;
+import io.github.ollama4j.models.chat.OllamaChatMessageRole;
 import io.github.ollama4j.models.chat.OllamaChatRequest;
 
 Ollama api = new Ollama("http://localhost:11434");
 
 OllamaChatRequest request = OllamaChatRequest.builder()
-    .model("llama3.1")
-    .message("user", "Hello!")
+    .withModel("llama3.1")
+    .withMessage(OllamaChatMessageRole.USER, "Hello!")
     .build();
 
-String response = api.chat(request).getMessage().getContent();
+String response = api.chat(request, token -> {}).getResponseModel().getMessage().getResponse();
 System.out.println(response);
 ```
 
@@ -148,7 +149,7 @@ For **meteor-mcp-addon**, follow this approach:
 ### Phase 1: Add Dependency
 ```kotlin
 // build.gradle.kts
-include(implementation("io.github.ollama4j:ollama4j:1.1.4")!!)
+implementation("io.github.ollama4j:ollama4j:1.1.4")
 ```
 
 ### Phase 2: Create Config System

ai_docs/ollama/integration-recommendations.md

@@ -181,10 +181,10 @@ MCPServerConnection.callTool()
 ```kotlin
 dependencies {
     // Existing dependencies
-    include(implementation("com.google.genai:google-genai:1.23.0")!!)
+    implementation("com.google.genai:google-genai:1.23.0")
 
     // Add Ollama4j
-    include(implementation("io.github.ollama4j:ollama4j:1.1.4")!!)
+    implementation("io.github.ollama4j:ollama4j:1.1.4")
 
     // ... rest of dependencies
 }
@@ -233,11 +233,11 @@ public class OllamaExecutor {
     // Simple prompt (no tools)
     public String execute(String model, String prompt) {
         OllamaChatRequest request = OllamaChatRequest.builder()
-            .model(model)
-            .message("user", prompt)
+            .withModel(model)
+            .withMessage(OllamaChatMessageRole.USER, prompt)
             .build();
 
-        return api.chat(request).getMessage().getContent();
+        return api.chat(request, token -> {}).getResponseModel().getMessage().getResponse();
     }
 
     // MCP-enhanced loop (with tool calling)
@@ -249,20 +249,21 @@ public class OllamaExecutor {
 
         // Chat with tools enabled
         OllamaChatRequest request = OllamaChatRequest.builder()
-            .model(model)
-            .message("user", prompt)
-            .withTools()
+            .withModel(model)
+            .withMessage(OllamaChatMessageRole.USER, prompt)
+            .withUseTools(true)
             .build();
 
-        OllamaChatResult result = api.chat(request);
+        OllamaChatResult result = api.chat(request, token -> {});
 
         // Manual function calling loop
-        while (result.getMessage().hasToolCalls()) {
+        while (result.getResponseModel().getMessage().getToolCalls() != null
+            && !result.getResponseModel().getMessage().getToolCalls().isEmpty()) {
             // Execute tool calls
-            List<ToolCall> toolCalls = result.getMessage().getToolCalls();
+            List<OllamaChatToolCalls> toolCalls = result.getResponseModel().getMessage().getToolCalls();
             List<String> toolResults = new ArrayList<>();
 
-            for (ToolCall call : toolCalls) {
+            for (OllamaChatToolCalls call : toolCalls) {
                 String serverName = extractServerName(call.getFunction().getName());
                 String toolName = extractToolName(call.getFunction().getName());
                 Map<String, Object> args = call.getFunction().getArguments();
@@ -277,7 +278,7 @@ public class OllamaExecutor {
             // ... (similar to GeminiExecutor pattern)
         }
 
-        return result.getMessage().getContent();
+        return result.getResponseModel().getMessage().getResponse();
     }
 
     private void registerServerTools(MCPServerConnection server) {
@@ -691,7 +692,7 @@ public class OllamaClientManager {
 **Solution:** Add connection check in GUI, show clear error message
 
 ### Issue 2: Model Not Installed
-**Solution:** Detect ModelNotFoundException, suggest `ollama pull <model>`
+**Solution:** Detect the "model not found" error text from `OllamaException` and suggest `ollama pull <model>`
 
 ### Issue 3: Slow Response Times
 **Solution:** Use streaming, show "Thinking..." indicator

ai_docs/ollama/ollama-java-integration.md

@@ -410,6 +410,7 @@ Streaming responses are JSON objects separated by newlines (NDJSON format).
 
 ```java
 import io.github.ollama4j.Ollama;
+import io.github.ollama4j.models.chat.OllamaChatMessageRole;
 import io.github.ollama4j.models.chat.OllamaChatRequest;
 import io.github.ollama4j.models.chat.OllamaChatResult;
 
@@ -418,12 +419,12 @@ public class OllamaChatExample {
         Ollama ollama = new Ollama("http://localhost:11434");
 
         OllamaChatRequest request = OllamaChatRequest.builder()
-            .model("llama3.1")
-            .message("user", "What is the capital of France?")
+            .withModel("llama3.1")
+            .withMessage(OllamaChatMessageRole.USER, "What is the capital of France?")
             .build();
 
-        OllamaChatResult result = ollama.chat(request);
-        System.out.println(result.getMessage().getContent());
+        OllamaChatResult result = ollama.chat(request, token -> {});
+        System.out.println(result.getResponseModel().getMessage().getResponse());
     }
 }
 ```
@@ -459,12 +460,12 @@ api.registerTool(weatherSpec, weatherTool::getCurrentWeather);
 
 // Use with chat
 OllamaChatRequest request = OllamaChatRequest.builder()
-    .model("mistral")
-    .message("user", "What's the weather in Tokyo?")
-    .withTools()  // Enable tool calling
+    .withModel("mistral")
+    .withMessage(OllamaChatMessageRole.USER, "What's the weather in Tokyo?")
+    .withUseTools(true)  // Enable tool calling
     .build();
 
-OllamaChatResult result = api.chat(request);
+OllamaChatResult result = api.chat(request, token -> {});
 ```
 
 ### Example 3: Annotation-Based Tool Registration

ai_docs/ollama/ollama4j-1.1.4-api-reference.md

@@ -39,7 +39,7 @@ OllamaChatRequest request = OllamaChatRequest.builder()
     .withMessage(OllamaChatMessageRole.USER, "Hello!")
     .withOptions(options)
     .withKeepAlive("5m")
-    .build();  // NO build() method needed - returns OllamaChatRequest directly
+    .build();  // Optional convenience call; returns the same OllamaChatRequest instance
 ```
 
 **Key Methods**:
@@ -390,7 +390,7 @@ public class OllamaExample {
 1. **Wrong main class**: Use `Ollama`
 2. **Wrong builder method**: Use `.withModel()`, NOT `.model()`
 3. **Wrong response accessor**: Use `result.getResponseModel().getMessage().getResponse()`, NOT `result.getMessage()`
-4. **Calling build()**: Builder methods return `OllamaChatRequest` directly, no `.build()` needed
+4. **Calling build()**: `.build()` exists, but it is optional and returns the same request instance
 5. **Wrong message field**: `OllamaChatMessage` has `getResponse()`, NOT `getContent()` or `getMessage()`
 6. **Tool classes**: Import from `io.github.ollama4j.tools.Tools.*`, NOT separate top-level classes
 
@@ -410,7 +410,7 @@ String response = result.getMessage();  // Wrong accessor
 Ollama ollama = new Ollama("http://localhost:11434");
 OllamaChatRequest request = OllamaChatRequest.builder()
     .withModel("llama3.2")  // Correct method
-    // Returns OllamaChatRequest directly, no .build()
+    // build() is optional and returns the same instance
 String response = result.getResponseModel().getMessage().getResponse();
 ```