@link-assistant/hive-mind 1.35.9 → 1.35.10

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @link-assistant/hive-mind
 
+## 1.35.10
+
+### Patch Changes
+
+- 21e1f5e: fix: fix model recognition logic and update free models docs (Issue #1473)
+  - Consolidate `model-info.lib.mjs`, `model-mapping.lib.mjs`, and `model-validation.lib.mjs` into single `src/models/index.mjs`
+  - Fix `resolveModelId()` to use `mapModelForTool()` as single source of truth instead of duplicated hardcoded maps that were missing agent free model mappings
+  - Fix false warning "Main model does not match requested model" for agent free models (e.g., `kimi-k2.5-free` → `opencode/kimi-k2.5-free`)
+  - Add missing base model pricing mappings for `minimax-m2.5-free`, `glm-5-free`, `glm-4.5-air-free`, `deepseek-r1-free`, `giga-potato-free` in `getBaseModelForPricing()`
+  - Update `validateAgentConnection()` default model to `minimax-m2.5-free`
+  - Update `docs/FREE_MODELS.md` to sync with upstream [Agent CLI FREE_MODELS.md](https://github.com/link-assistant/agent/blob/main/FREE_MODELS.md)
+  - Update README.md examples to use `minimax-m2.5-free` instead of deprecated `kimi-k2.5-free`
+
 ## 1.35.9
 
 ### Patch Changes

package/README.md

@@ -445,8 +445,8 @@ Examples:
 /solve https://github.com/owner/repo/issues/123 --model opus --think max
 
 Free Models (with --tool agent):
-/solve https://github.com/owner/repo/issues/123 --tool agent --model kimi-k2.5-free
 /solve https://github.com/owner/repo/issues/123 --tool agent --model minimax-m2.5-free
+/solve https://github.com/owner/repo/issues/123 --tool agent --model opencode/minimax-m2.5-free
 /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 big-pickle
 

package/package.json

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

package/src/agent.lib.mjs

@@ -18,6 +18,7 @@ import { reportError } from './sentry.lib.mjs';
 import { timeouts } from './config.lib.mjs';
 import { detectUsageLimit, formatUsageLimitMessage } from './usage-limit.lib.mjs';
 import { sanitizeObjectStrings } from './unicode-sanitization.lib.mjs';
+import { agentModels, defaultModels, freeToBaseModelMap } from './models/index.mjs';
 
 // Import pricing functions from claude.lib.mjs
 // We reuse fetchModelInfo and checkModelVisionCapability to get data from models.dev API
@@ -112,20 +113,12 @@ const getOriginalProviderName = providerId => {
  *   - isFreeVariant: Whether this is a free variant
  */
 const getBaseModelForPricing = modelName => {
-  // Known mappings for free models to their base paid versions
-  const freeToBaseMap = {
-    'kimi-k2.5-free': 'kimi-k2.5',
-    'glm-4.7-free': 'glm-4.7',
-    'minimax-m2.1-free': 'minimax-m2.1',
-    'trinity-large-preview-free': 'trinity-large-preview',
-    // Grok models don't have a paid equivalent with same name
-    // These are kept as-is since they're truly free
-  };
+  // Issue #1473: Use centralized freeToBaseModelMap from models/index.mjs
 
   // Check if there's a direct mapping
-  if (freeToBaseMap[modelName]) {
+  if (freeToBaseModelMap[modelName]) {
     return {
-      baseModelName: freeToBaseMap[modelName],
+      baseModelName: freeToBaseModelMap[modelName],
       isFreeVariant: true,
     };
   }
@@ -283,46 +276,13 @@ export const calculateAgentPricing = async (modelId, tokenUsage) => {
 };
 
 // Model mapping to translate aliases to full model IDs for Agent
-// Agent uses OpenCode Zen's JSON interface and models
-// Issue #1185: Free models use opencode/ prefix (not openai/)
-// Issue #1300: Updated mappings - use opencode/ and kilo/ prefixes only,
-// short names for Kilo-exclusive models map to kilo/ prefix
+// Issue #1473: Uses centralized agentModels from models/index.mjs (single source of truth)
 export const mapModelToId = model => {
-  const modelMap = {
-    // OpenCode Zen free models
-    grok: 'opencode/grok-code',
-    'grok-code': 'opencode/grok-code',
-    'grok-code-fast-1': 'opencode/grok-code',
-    'big-pickle': 'opencode/big-pickle',
-    'gpt-5-nano': 'opencode/gpt-5-nano',
-    'minimax-m2.5-free': 'opencode/minimax-m2.5-free',
-    // Kilo Gateway free models - short names for Kilo-exclusive models (Issue #1300)
-    'glm-5-free': 'kilo/glm-5-free',
-    'glm-4.5-air-free': 'kilo/glm-4.5-air-free',
-    'deepseek-r1-free': 'kilo/deepseek-r1-free',
-    'giga-potato-free': 'kilo/giga-potato-free',
-    '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',
-    'gemini-3-pro': 'google/gemini-3-pro',
-    'gpt-4o-mini': 'openai/gpt-4o-mini',
-    'gpt-4o': 'openai/gpt-4o',
-    'claude-3.5-haiku': 'anthropic/claude-3.5-haiku',
-    'claude-3.5-sonnet': 'anthropic/claude-3.5-sonnet',
-    // Deprecated free models (backward compatibility)
-    'kimi-k2.5-free': 'opencode/kimi-k2.5-free', // Deprecated: not supported by OpenCode Zen (Issue #1391)
-    'glm-4.7-free': 'opencode/glm-4.7-free',
-    'minimax-m2.1-free': 'opencode/minimax-m2.1-free',
-  };
-
-  // Return mapped model ID if it's an alias, otherwise return as-is
-  return modelMap[model] || model;
+  return agentModels[model] || model;
 };
 
 // Function to validate Agent connection
-export const validateAgentConnection = async (model = 'grok-code-fast-1') => {
+export const validateAgentConnection = async (model = defaultModels.agent) => {
   // Map model alias to full ID
   const mappedModel = mapModelToId(model);
 

package/src/claude.lib.mjs

@@ -16,7 +16,7 @@ import { sanitizeObjectStrings } from './unicode-sanitization.lib.mjs';
 import { displayBudgetStats } from './claude.budget-stats.lib.mjs';
 import { buildClaudeResumeCommand } from './claude.command-builder.lib.mjs';
 import { handleClaudeRuntimeSwitch } from './claude.runtime-switch.lib.mjs'; // see issue #1141
-import { CLAUDE_MODELS as availableModels } from './model-validation.lib.mjs'; // Issue #1221
+import { CLAUDE_MODELS as availableModels } from './models/index.mjs'; // Issue #1221
 export { availableModels }; // Re-export for backward compatibility
 // Helper to display resume command at end of session
 const showResumeCommand = async (sessionId, tempDir, claudePath, model, log) => {
@@ -48,7 +48,7 @@ export const mapModelToId = model => {
   return availableModels[model] || model;
 };
 // Function to validate Claude CLI connection with retry logic
-export const validateClaudeConnection = async (model = 'haiku-3') => {
+export const validateClaudeConnection = async (model = 'haiku') => {
   // Map model alias to full ID
   const mappedModel = mapModelToId(model);
   // Retry configuration for API overload errors

package/src/claude.prompts.lib.mjs

@@ -5,6 +5,7 @@
 
 import { getArchitectureCareSubPrompt } from './architecture-care.prompts.lib.mjs';
 import { getExperimentsExamplesSubPrompt } from './experiments-examples.prompts.lib.mjs';
+import { primaryModelNames } from './models/index.mjs';
 
 /**
  * Build the user prompt for Claude
@@ -309,7 +310,7 @@ Agent Commander usage (unified subagent delegation).
       --tool <name>: Agent to use (claude, opencode, codex, agent)
       --working-directory <path>: Execution directory (use current directory for context)
       --prompt <text>: The task to delegate
-      --model <name>: Model to use (sonnet, opus, haiku, grok, etc.)
+      --model <name>: Model to use (${[...new Set(Object.values(primaryModelNames).flat())].slice(0, 5).join(', ')}, etc.)
       --isolation <mode>: Execution context (none, screen, docker)
       --detached: Run in background mode
    - Examples:

package/src/github.lib.mjs

@@ -11,7 +11,7 @@ export { isSafeToken, isHexInSafeContext, getGitHubTokensFromFiles, getGitHubTok
 import { uploadLogWithGhUploadLog } from './log-upload.lib.mjs';
 import { formatResetTimeWithRelative } from './usage-limit.lib.mjs'; // See: https://github.com/link-assistant/hive-mind/issues/1236
 // Import model info helpers (Issue #1225)
-import { getToolDisplayName, getModelInfoForComment } from './model-info.lib.mjs';
+import { getToolDisplayName, getModelInfoForComment } from './models/index.mjs';
 // Re-export for use by other modules
 export { getToolDisplayName };
 

package/src/hive.config.lib.mjs

@@ -4,6 +4,7 @@
 // This module has no heavy dependencies to allow fast loading for --help
 
 import { SOLVE_OPTION_DEFINITIONS } from './solve.config.lib.mjs';
+import { buildModelOptionDescription } from './models/index.mjs';
 
 // Hive-only options that are NOT solve options (hive-specific functionality).
 // These are excluded when auto-registering solve-passthrough options.
@@ -19,7 +20,7 @@ const SOLVE_ONLY_OPTION_NAMES = new Set(['resume', 'working-directory', 'only-pr
 const HIVE_CUSTOM_SOLVE_OPTIONS = {
   model: {
     type: 'string',
-    description: 'Model to use for solve (opus, sonnet, haiku, haiku-3-5, haiku-3, or any model ID supported by the tool)',
+    description: `${buildModelOptionDescription()}, or any model ID supported by the tool`,
     alias: 'm',
     default: 'sonnet',
   },

package/src/hive.mjs

@@ -101,7 +101,7 @@ if (isDirectExecution) {
     const claudeLib = await import('./claude.lib.mjs');
     const { validateClaudeConnection } = claudeLib;
     // Import model validation library
-    const modelValidation = await import('./model-validation.lib.mjs');
+    const modelValidation = await import('./models/index.mjs');
     const { validateAndExitOnInvalidModel } = modelValidation;
     const githubLib = await import('./github.lib.mjs');
     const { checkGitHubPermissions, fetchAllIssuesWithPagination, fetchProjectIssues, isRateLimitError, batchCheckPullRequestsForIssues, parseGitHubUrl, batchCheckArchivedRepositories } = githubLib;