@link-assistant/hive-mind 1.22.6 → 1.23.1

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @link-assistant/hive-mind
 
+## 1.23.1
+
+### Patch Changes
+
+- 5c635fc: Fix agent tool error handling: upload failure logs to PR even when sessionId is not available
+  - Remove overly strict sessionId requirement for failure log upload in solve.mjs
+  - Add FreeUsageLimitError pattern detection for Agent/OpenCode Zen rate limits
+  - Improve rate limit detection by checking multiple sources (lastMessage, errorMatch, fullOutput)
+  - Add comprehensive case study documentation for issue #1287
+  - Add tests for FreeUsageLimitError detection
+
+## 1.23.0
+
+### Minor Changes
+
+- 7a74bc6: Add Kilo Gateway free models support for --tool agent
+
+  This release adds support for 6 free models from Kilo Gateway:
+  - `kilo/glm-5-free` - Z.AI flagship model (free for limited time)
+  - `kilo/glm-4.7-free` - Z.AI agent-centric model
+  - `kilo/kimi-k2.5-free` - MoonshotAI agentic model
+  - `kilo/minimax-m2.1-free` - MiniMax general-purpose model
+  - `kilo/giga-potato-free` - Evaluation model
+  - `kilo/trinity-large-preview` - Arcee AI preview model
+
+  Short aliases are also supported (e.g., `glm-5-free`, `kilo-glm-4.7-free`).
+
+  Usage:
+
+  ```bash
+  solve https://github.com/owner/repo/issues/123 --tool agent --model kilo/glm-5-free
+  /solve https://github.com/owner/repo/issues/123 --tool agent --model glm-5-free
+  ```
+
+  See docs/FREE_MODELS.md for comprehensive documentation.
+
+  Fixes #1282
+
 ## 1.22.6
 
 ### Patch Changes

package/README.md

@@ -481,9 +481,14 @@ Free Models (with --tool agent):
 /solve https://github.com/owner/repo/issues/123 --tool agent --model gpt-5-nano
 /solve https://github.com/owner/repo/issues/123 --tool agent --model glm-4.7-free
 /solve https://github.com/owner/repo/issues/123 --tool agent --model big-pickle
+
+Free Models via Kilo Gateway (with --tool agent):
+/solve https://github.com/owner/repo/issues/123 --tool agent --model kilo/glm-5-free
+/solve https://github.com/owner/repo/issues/123 --tool agent --model kilo/glm-4.7-free
+/solve https://github.com/owner/repo/issues/123 --tool agent --model kilo/kimi-k2.5-free
 ```
 
-> **📖 Free Models Guide**: See [docs/FREE_MODELS.md](./docs/FREE_MODELS.md) for comprehensive information about all free models.
+> **📖 Free Models Guide**: See [docs/FREE_MODELS.md](./docs/FREE_MODELS.md) for comprehensive information about all free models including OpenCode Zen and Kilo Gateway providers.
 
 #### `/hive` - Run Hive Orchestration
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/hive-mind",
-  "version": "1.22.6",
+  "version": "1.23.1",
   "description": "AI-powered issue solver and hive mind for collaborative problem solving",
   "main": "src/hive.mjs",
   "type": "module",

package/src/agent.lib.mjs

@@ -848,7 +848,18 @@ export const executeAgentCommand = async params => {
         };
 
         // Check for usage limit errors first (more specific)
-        const limitInfo = detectUsageLimit(lastMessage);
+        // Issue #1287: Check multiple sources for usage limit detection:
+        // 1. lastMessage (the last chunk of output)
+        // 2. errorMatch (the extracted error message from JSON output)
+        // 3. fullOutput (complete output - fallback)
+        let limitInfo = detectUsageLimit(lastMessage);
+        if (!limitInfo.isUsageLimit && outputError.match) {
+          limitInfo = detectUsageLimit(outputError.match);
+        }
+        if (!limitInfo.isUsageLimit) {
+          // Fallback: scan fullOutput for usage limit patterns
+          limitInfo = detectUsageLimit(fullOutput);
+        }
         if (limitInfo.isUsageLimit) {
           limitReached = true;
           limitResetTime = limitInfo.resetTime;

package/src/model-mapping.lib.mjs

@@ -25,8 +25,9 @@ export const claudeModels = {
   'claude-haiku-4-5': 'claude-haiku-4-5-20251001', // Haiku 4.5
 };
 
-// Agent models (OpenCode API via agent CLI)
+// Agent models (OpenCode API and Kilo Gateway via agent CLI)
 export const agentModels = {
+  // OpenCode Zen free models
   grok: 'opencode/grok-code',
   'grok-code': 'opencode/grok-code',
   'grok-code-fast-1': 'opencode/grok-code',
@@ -35,6 +36,14 @@ export const agentModels = {
   'glm-4.7-free': 'opencode/glm-4.7-free',
   'minimax-m2.1-free': 'opencode/minimax-m2.1-free',
   'kimi-k2.5-free': 'opencode/kimi-k2.5-free',
+  // Kilo Gateway free models (Issue #1282)
+  'kilo/glm-5-free': 'kilo/glm-5-free',
+  'kilo/glm-4.7-free': 'kilo/glm-4.7-free',
+  'kilo/kimi-k2.5-free': 'kilo/kimi-k2.5-free',
+  'kilo/minimax-m2.1-free': 'kilo/minimax-m2.1-free',
+  'kilo/giga-potato-free': 'kilo/giga-potato-free',
+  'kilo/trinity-large-preview': 'kilo/trinity-large-preview',
+  // Premium models
   sonnet: 'anthropic/claude-3-5-sonnet',
   haiku: 'anthropic/claude-3-5-haiku',
   opus: 'anthropic/claude-3-opus',

package/src/model-validation.lib.mjs

@@ -102,18 +102,28 @@ export const AGENT_MODELS = {
   'glm-4.7-free': 'opencode/glm-4.7-free',
   'minimax-m2.1-free': 'opencode/minimax-m2.1-free',
   'kimi-k2.5-free': 'opencode/kimi-k2.5-free',
+  // Free models (via Kilo Gateway)
+  // Issue #1282: Kilo provider adds access to 500+ models including free tier
+  // See: https://kilo.ai/docs/advanced-usage/free-and-budget-models
+  'kilo/glm-5-free': 'kilo/glm-5-free', // Z.AI flagship model (free limited time)
+  'kilo/glm-4.7-free': 'kilo/glm-4.7-free', // Z.AI agent-centric model
+  'kilo/kimi-k2.5-free': 'kilo/kimi-k2.5-free', // MoonshotAI agentic model
+  'kilo/minimax-m2.1-free': 'kilo/minimax-m2.1-free', // MiniMax general-purpose
+  'kilo/giga-potato-free': 'kilo/giga-potato-free', // Evaluation model
+  'kilo/trinity-large-preview': 'kilo/trinity-large-preview', // Arcee AI preview
   // Premium models (requires OpenCode Zen subscription)
   sonnet: 'anthropic/claude-3-5-sonnet',
   haiku: 'anthropic/claude-3-5-haiku',
   opus: 'anthropic/claude-3-opus',
   'gemini-3-pro': 'google/gemini-3-pro',
-  // Full model IDs with provider prefix
+  // Full model IDs with provider prefix (OpenCode Zen)
   'opencode/grok-code': 'opencode/grok-code',
   'opencode/big-pickle': 'opencode/big-pickle',
   'opencode/gpt-5-nano': 'opencode/gpt-5-nano',
   'opencode/glm-4.7-free': 'opencode/glm-4.7-free',
   'opencode/minimax-m2.1-free': 'opencode/minimax-m2.1-free',
   'opencode/kimi-k2.5-free': 'opencode/kimi-k2.5-free',
+  // Premium models with provider prefix
   'anthropic/claude-3-5-sonnet': 'anthropic/claude-3-5-sonnet',
   'anthropic/claude-3-5-haiku': 'anthropic/claude-3-5-haiku',
   'anthropic/claude-3-opus': 'anthropic/claude-3-opus',

package/src/solve.mjs

@@ -1112,7 +1112,9 @@ try {
     }
 
     // If --attach-logs is enabled and we have a PR, attach failure logs before exiting
-    if (shouldAttachLogs && sessionId && global.createdPR && global.createdPR.number) {
+    // Note: sessionId is not required - logs should be uploaded even if agent failed before establishing a session
+    // This aligns with the pattern in handleFailure() in solve.error-handlers.lib.mjs
+    if (shouldAttachLogs && global.createdPR && global.createdPR.number) {
       await log('\n📄 Attaching failure logs to Pull Request...');
       try {
         // Build Claude CLI resume command

package/src/usage-limit.lib.mjs

@@ -44,7 +44,7 @@ export function isUsageLimitError(message) {
     'rate limit exceeded',
     'limit reached',
     'limit has been reached',
-    // Provider-specific phrasings we’ve seen in the wild
+    // Provider-specific phrasings we've seen in the wild
     'session limit reached', // Claude
     'weekly limit reached', // Claude
     'daily limit reached',
@@ -52,7 +52,9 @@ export function isUsageLimitError(message) {
     'billing hard limit',
     'please try again at', // Codex/OpenCode style
     'available again at',
-    'resets', // Claude shows: “∙ resets 5am”
+    'resets', // Claude shows: "∙ resets 5am"
+    // Agent/OpenCode Zen specific - issue #1287
+    'freeusagelimiterror', // Agent JSON error type
   ];
 
   return patterns.some(pattern => lowerMessage.includes(pattern));