Refine LongCat support: update API key format, links, default model, and reorder provider lists

Author: LeaderOnePro

README.md

@@ -27,7 +27,7 @@ The agents aren't following predefined scripts. They're operating off natural la
 **You need:**
 - Minecraft 1.20.1 with Forge
 - Java 17
-- An LLM API key (OpenAI GPT-5, Gemini 3, Groq, or DeepSeek)
+- An LLM API key (LongCat, DeepSeek, OpenAI GPT-5, Gemini 3, or Groq)
 
 **Installation:**
 1. Download the JAR from releases
@@ -39,13 +39,13 @@ The agents aren't following predefined scripts. They're operating off natural la
 **Config example (`config/steve-common.toml`):**
 ```toml
 [ai]
-provider = "groq"
+provider = "longcat"
 maxTokens = 8000
 temperature = 0.7
 
-[groq]
-apiKey = "your-groq-api-key-here"
-model = "llama-3.1-8b-instant"
+[longcat]
+apiKey = "ak_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+model = "LongCat-Flash-Thinking-2601"
 ```
 
 Then spawn a Steve with `/steve spawn Bob` and press K to start giving commands.
@@ -83,7 +83,7 @@ Each Steve runs an autonomous agent loop that processes natural language command
 ### Core Components
 
 **LLM Integration** (`com.steve.ai.llm`)
-- **Multi-Provider Support**: Pluggable clients for OpenAI, Groq, Gemini, and DeepSeek.
+- **Multi-Provider Support**: Pluggable clients for LongCat, DeepSeek, OpenAI, Gemini, and Groq.
 - **Resilient Clients**: Async implementations with caching, retries, and circuit breaker patterns.
 - **TaskPlanner**: Orchestrates LLM calls with context (conversation history, world state, Steve capabilities)
 - **PromptBuilder**: Constructs prompts with available actions, examples, and formatting instructions
@@ -236,31 +236,36 @@ Edit `config/steve-common.toml`. Each provider now has its own section for bette
 
 ```toml
 [ai]
-provider = "groq"  # Options: openai, groq, gemini, deepseek
+provider = "longcat"  # Options: longcat, deepseek, openai, gemini, groq
 maxTokens = 8000
 temperature = 0.7
 
+[longcat]
+apiKey = "ak_..."
+model = "LongCat-Flash-Thinking-2601"
+
+[deepseek]
+apiKey = "sk-..."
+model = "deepseek-chat"
+
 [openai]
 apiKey = "sk-..."
 model = "gpt-5-mini-2025-08-07"
 
-[groq]
-apiKey = "gsk_..."
-model = "llama-3.1-8b-instant"
-
 [gemini]
 apiKey = "AIza..."
 model = "gemini-3-flash-preview"
 
-[deepseek]
-apiKey = "sk-..."
-model = "deepseek-chat"
+[groq]
+apiKey = "gsk_..."
+model = "llama-3.1-8b-instant"
 ```
 
 **Performance Tips:**
-- **Groq**: Fastest inference, best for smooth real-time reactions.
-- **Gemini 3 / GPT-5**: Excellent for complex multi-step planning.
+- **LongCat**: OpenAI-compatible, great for flash-chat thinking speed.
 - **DeepSeek**: Great balance of quality and cost-efficiency.
+- **Gemini 3 / GPT-5**: Excellent for complex multi-step planning.
+- **Groq**: Fastest inference, best for smooth real-time reactions.
 - **Temperature**: Recommended 0.5-0.7 for consistent task execution.
 
 ## Known Issues

config/steve-common.toml.example

@@ -1,22 +1,22 @@
 # AI Provider Configuration
 [ai]
-    # AI provider to use: 'groq' (FASTEST, FREE), 'openai', 'gemini', or 'deepseek'
-    provider = "groq"
+    # AI provider to use: 'longcat', 'deepseek', 'openai', 'gemini', or 'groq'
+    provider = "longcat"
 
     # Maximum tokens per API request (applies to all LLM providers)
     maxTokens = 8000
 
     # Temperature for AI responses (0.0-2.0, lower is more deterministic)
     temperature = 0.7
 
-# OpenAI API Configuration
-[openai]
-    # Your OpenAI API key
-    # Get your API key from: https://platform.openai.com/api-keys
-    apiKey = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+# LongCat API Configuration
+[longcat]
+    # Your LongCat API key
+    # Get your API key from: https://longcat.chat/platform/api_keys
+    apiKey = "ak_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
 
-    # OpenAI model to use (gpt-5.2, gpt-5.2-codex, gpt-5-mini-2025-08-07, gpt-5-nano-2025-08-07)
-    model = "gpt-5-mini-2025-08-07"
+    # LongCat model to use (LongCat-Flash-Chat, LongCat-Flash-Thinking, LongCat-Flash-Thinking-2601)
+    model = "LongCat-Flash-Thinking-2601"
 
 # DeepSeek API Configuration
 [deepseek]
@@ -27,14 +27,14 @@
     # DeepSeek model to use (deepseek-chat, deepseek-reasoner)
     model = "deepseek-chat"
 
-# Groq API Configuration (FASTEST, FREE tier available)
-[groq]
-    # Your Groq API key
-    # Get your API key from: https://console.groq.com/keys
-    apiKey = "gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+# OpenAI API Configuration
+[openai]
+    # Your OpenAI API key
+    # Get your API key from: https://platform.openai.com/api-keys
+    apiKey = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
 
-    # Groq model to use (llama-3.1-8b-instant, llama-3.1-70b-versatile, mixtral-8x7b-32768)
-    model = "llama-3.1-8b-instant"
+    # OpenAI model to use (gpt-5.2, gpt-5.2-codex, gpt-5-mini-2025-08-07, gpt-5-nano-2025-08-07)
+    model = "gpt-5-mini-2025-08-07"
 
 # Google Gemini API Configuration
 [gemini]
@@ -45,6 +45,15 @@
     # Gemini model to use (gemini-3-pro-preview, gemini-3-flash-preview, gemini-flash-lite-latest)
     model = "gemini-3-flash-preview"
 
+# Groq API Configuration (FASTEST, FREE tier available)
+[groq]
+    # Your Groq API key
+    # Get your API key from: https://console.groq.com/keys
+    apiKey = "gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+    
+    # Groq model to use (llama-3.1-8b-instant, llama-3.1-70b-versatile, mixtral-8x7b-32768)
+    model = "llama-3.1-8b-instant"
+
 # Steve Behavior Configuration
 [behavior]
     # Ticks between action checks (20 ticks = 1 second)

src/main/java/com/steve/ai/config/SteveConfig.java

@@ -10,21 +10,25 @@ public class SteveConfig {
     public static final ForgeConfigSpec.IntValue MAX_TOKENS;
     public static final ForgeConfigSpec.DoubleValue TEMPERATURE;
 
-    // OpenAI
-    public static final ForgeConfigSpec.ConfigValue<String> OPENAI_API_KEY;
-    public static final ForgeConfigSpec.ConfigValue<String> OPENAI_MODEL;
-    
+    // LongCat
+    public static final ForgeConfigSpec.ConfigValue<String> LONGCAT_API_KEY;
+    public static final ForgeConfigSpec.ConfigValue<String> LONGCAT_MODEL;
+
     // DeepSeek
     public static final ForgeConfigSpec.ConfigValue<String> DEEPSEEK_API_KEY;
     public static final ForgeConfigSpec.ConfigValue<String> DEEPSEEK_MODEL;
-    
-    // Groq
-    public static final ForgeConfigSpec.ConfigValue<String> GROQ_API_KEY;
-    public static final ForgeConfigSpec.ConfigValue<String> GROQ_MODEL;
-    
+
+    // OpenAI
+    public static final ForgeConfigSpec.ConfigValue<String> OPENAI_API_KEY;
+    public static final ForgeConfigSpec.ConfigValue<String> OPENAI_MODEL;
+
     // Gemini
     public static final ForgeConfigSpec.ConfigValue<String> GEMINI_API_KEY;
     public static final ForgeConfigSpec.ConfigValue<String> GEMINI_MODEL;
+
+    // Groq
+    public static final ForgeConfigSpec.ConfigValue<String> GROQ_API_KEY;
+    public static final ForgeConfigSpec.ConfigValue<String> GROQ_MODEL;
 
     // Behavior
     public static final ForgeConfigSpec.IntValue ACTION_TICK_DELAY;
@@ -37,8 +41,8 @@ public class SteveConfig {
         builder.comment("AI API Configuration").push("ai");
 
         AI_PROVIDER = builder
-            .comment("AI provider to use: 'groq' (FASTEST, FREE), 'openai', 'gemini', or 'deepseek'")
-            .define("provider", "groq");
+            .comment("AI provider to use: 'longcat', 'deepseek', 'openai', 'gemini', or 'groq' (FASTEST, FREE)")
+            .define("provider", "longcat");
 
         MAX_TOKENS = builder
             .comment("Maximum tokens per API request (applies to all LLM providers)")
@@ -50,15 +54,15 @@ public class SteveConfig {
 
         builder.pop();
 
-        builder.comment("OpenAI API Configuration").push("openai");
+        builder.comment("LongCat API Configuration").push("longcat");
 
-        OPENAI_API_KEY = builder
-            .comment("Your OpenAI API key (get from: https://platform.openai.com/api-keys)")
+        LONGCAT_API_KEY = builder
+            .comment("Your LongCat API key (get from: https://longcat.chat/platform/api_keys)")
             .define("apiKey", "");
 
-        OPENAI_MODEL = builder
-            .comment("OpenAI model to use (gpt-5.2, gpt-5.2-codex, gpt-5-mini-2025-08-07, gpt-5-nano-2025-08-07)")
-            .define("model", "gpt-5-mini-2025-08-07");
+        LONGCAT_MODEL = builder
+            .comment("LongCat model to use (LongCat-Flash-Chat, LongCat-Flash-Thinking, LongCat-Flash-Thinking-2601)")
+            .define("model", "LongCat-Flash-Thinking-2601");
 
         builder.pop();
 
@@ -74,15 +78,15 @@ public class SteveConfig {
 
         builder.pop();
 
-        builder.comment("Groq API Configuration (FASTEST, FREE tier available)").push("groq");
+        builder.comment("OpenAI API Configuration").push("openai");
 
-        GROQ_API_KEY = builder
-            .comment("Your Groq API key (get from: https://console.groq.com/keys)")
+        OPENAI_API_KEY = builder
+            .comment("Your OpenAI API key (get from: https://platform.openai.com/api-keys)")
             .define("apiKey", "");
 
-        GROQ_MODEL = builder
-            .comment("Groq model to use (llama-3.1-8b-instant, llama-3.1-70b-versatile, mixtral-8x7b-32768)")
-            .define("model", "llama-3.1-8b-instant");
+        OPENAI_MODEL = builder
+            .comment("OpenAI model to use (gpt-5.2, gpt-5.2-codex, gpt-5-mini-2025-08-07, gpt-5-nano-2025-08-07)")
+            .define("model", "gpt-5-mini-2025-08-07");
 
         builder.pop();
 
@@ -98,6 +102,18 @@ public class SteveConfig {
 
         builder.pop();
 
+        builder.comment("Groq API Configuration (FASTEST, FREE tier available)").push("groq");
+        
+        GROQ_API_KEY = builder
+            .comment("Your Groq API key (get from: https://console.groq.com/keys)")
+            .define("apiKey", "");
+        
+        GROQ_MODEL = builder
+            .comment("Groq model to use (llama-3.1-8b-instant, llama-3.1-70b-versatile, mixtral-8x7b-32768)")
+            .define("model", "llama-3.1-8b-instant");
+        
+        builder.pop();
+
         builder.comment("Steve Behavior Configuration").push("behavior");
 
         ACTION_TICK_DELAY = builder

src/main/java/com/steve/ai/llm/LongCatClient.java

@@ -0,0 +1,113 @@
+package com.steve.ai.llm;
+
+import com.google.gson.JsonArray;
+import com.google.gson.JsonObject;
+import com.google.gson.JsonParser;
+import com.steve.ai.SteveMod;
+import com.steve.ai.config.SteveConfig;
+
+import java.net.URI;
+import java.net.http.HttpClient;
+import java.net.http.HttpRequest;
+import java.net.http.HttpResponse;
+import java.time.Duration;
+
+/**
+ * Client for LongCat API - OpenAI-compatible
+ * Endpoint: https://api.longcat.chat/openai/v1/chat/completions
+ * API Keys: https://longcat.chat/platform/api_keys
+ */
+public class LongCatClient {
+    private static final String LONGCAT_API_URL = "https://api.longcat.chat/openai/v1/chat/completions";
+    private static final int MAX_RETRIES = 3;
+    private static final int INITIAL_RETRY_DELAY_MS = 1000;
+
+    private final HttpClient client;
+    private final String apiKey;
+
+    public LongCatClient() {
+        this.apiKey = SteveConfig.LONGCAT_API_KEY.get();
+        this.client = HttpClient.newBuilder()
+            .connectTimeout(Duration.ofSeconds(30))
+            .build();
+    }
+
+    public String sendRequest(String systemPrompt, String userPrompt) {
+        if (apiKey == null || apiKey.isEmpty()) {
+            SteveMod.LOGGER.error("LongCat API key not configured!");
+            return null;
+        }
+
+        JsonObject requestBody = buildRequestBody(systemPrompt, userPrompt);
+
+        HttpRequest request = HttpRequest.newBuilder()
+            .uri(URI.create(LONGCAT_API_URL))
+            .header("Authorization", "Bearer " + apiKey)
+            .header("Content-Type", "application/json")
+            .timeout(Duration.ofSeconds(60))
+            .POST(HttpRequest.BodyPublishers.ofString(requestBody.toString()))
+            .build();
+
+        for (int attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            try {
+                HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
+
+                if (response.statusCode() == 200) {
+                    return parseResponse(response.body());
+                }
+
+                if (response.statusCode() == 429 || response.statusCode() >= 500) {
+                    if (attempt < MAX_RETRIES - 1) {
+                        int delayMs = INITIAL_RETRY_DELAY_MS * (int) Math.pow(2, attempt);
+                        SteveMod.LOGGER.warn("LongCat API failed ({}), retrying in {}ms", response.statusCode(), delayMs);
+                        Thread.sleep(delayMs);
+                        continue;
+                    }
+                }
+
+                SteveMod.LOGGER.error("LongCat API request failed: {}", response.statusCode());
+                return null;
+            } catch (Exception e) {
+                if (attempt < MAX_RETRIES - 1) {
+                    try { Thread.sleep(INITIAL_RETRY_DELAY_MS * (int) Math.pow(2, attempt)); } catch (Exception ignored) {}
+                } else {
+                    SteveMod.LOGGER.error("Error communicating with LongCat API", e);
+                    return null;
+                }
+            }
+        }
+        return null;
+    }
+
+    private JsonObject buildRequestBody(String systemPrompt, String userPrompt) {
+        JsonObject body = new JsonObject();
+        body.addProperty("model", SteveConfig.LONGCAT_MODEL.get());
+        body.addProperty("temperature", SteveConfig.TEMPERATURE.get());
+        body.addProperty("max_tokens", SteveConfig.MAX_TOKENS.get());
+
+        JsonArray messages = new JsonArray();
+        JsonObject systemMessage = new JsonObject();
+        systemMessage.addProperty("role", "system");
+        systemMessage.addProperty("content", systemPrompt);
+        messages.add(systemMessage);
+
+        JsonObject userMessage = new JsonObject();
+        userMessage.addProperty("role", "user");
+        userMessage.addProperty("content", userPrompt);
+        messages.add(userMessage);
+
+        body.add("messages", messages);
+        return body;
+    }
+
+    private String parseResponse(String responseBody) {
+        try {
+            JsonObject json = JsonParser.parseString(responseBody).getAsJsonObject();
+            return json.getAsJsonArray("choices").get(0).getAsJsonObject()
+                .getAsJsonObject("message").get("content").getAsString();
+        } catch (Exception e) {
+            SteveMod.LOGGER.error("Error parsing LongCat response", e);
+            return null;
+        }
+    }
+}