@link-assistant/hive-mind 1.15.2 → 1.16.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @link-assistant/hive-mind
 
+## 1.16.0
+
+### Minor Changes
+
+- 5f78253: Add Claude Opus 4.6 model support with [1m] suffix
+  - `opus` alias now defaults to `claude-opus-4-6` (latest and most capable Opus model)
+  - Added shorter version aliases: `opus-4-6`, `opus-4-5`, `sonnet-4-5`, `haiku-4-5`
+  - Added `claude-haiku-4-5` alias for consistency
+  - `[1m]` suffix enables 1 million token context window for supported models
+  - Opus 4.6 gets 128K max output tokens and 64K thinking budget
+  - Backward compatibility: `claude-opus-4-5` maps to `claude-opus-4-5-20251101`
+
 ## 1.15.2
 
 ### Patch Changes

package/package.json

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

package/src/claude.lib.mjs

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
-// Claude CLI-related utility functions
-// If not, fetch it (when running standalone)
+// Claude CLI-related utility functions. Fetch use-m if not available.
 if (typeof globalThis.use === 'undefined') {
   globalThis.use = (await eval(await (await fetch('https://unpkg.com/use-m/use.js')).text())).use;
 }
@@ -10,14 +9,14 @@ const path = (await use('path')).default;
 // Import log from general lib
 import { log } from './lib.mjs';
 import { reportError } from './sentry.lib.mjs';
-import { timeouts, retryLimits, claudeCode, getClaudeEnv, getThinkingLevelToTokens, getTokensToThinkingLevel, supportsThinkingBudget, DEFAULT_MAX_THINKING_BUDGET } from './config.lib.mjs';
+import { timeouts, retryLimits, claudeCode, getClaudeEnv, getThinkingLevelToTokens, getTokensToThinkingLevel, supportsThinkingBudget, DEFAULT_MAX_THINKING_BUDGET, getMaxOutputTokensForModel } from './config.lib.mjs';
 import { detectUsageLimit, formatUsageLimitMessage } from './usage-limit.lib.mjs';
 import { createInteractiveHandler } from './interactive-mode.lib.mjs';
 import { displayBudgetStats } from './claude.budget-stats.lib.mjs';
-// Import Claude command builder for generating resume commands
 import { buildClaudeResumeCommand } from './claude.command-builder.lib.mjs';
-// Import runtime switch module (extracted to maintain file line limits, see issue #1141)
-import { handleClaudeRuntimeSwitch } from './claude.runtime-switch.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
+export { availableModels }; // Re-export for backward compatibility
 
 // Helper to display resume command at end of session
 const showResumeCommand = async (sessionId, tempDir, claudePath, model, log) => {
@@ -36,16 +35,21 @@ export const formatNumber = num => {
   const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, ' ');
   return decimalPart !== undefined ? `${formattedInteger}.${decimalPart}` : formattedInteger;
 };
-// Available model configurations
-export const availableModels = {
-  sonnet: 'claude-sonnet-4-5-20250929', // Sonnet 4.5
-  opus: 'claude-opus-4-5-20251101', // Opus 4.5
-  haiku: 'claude-haiku-4-5-20251001', // Haiku 4.5
-  'haiku-3-5': 'claude-3-5-haiku-20241022', // Haiku 3.5
-  'haiku-3': 'claude-3-haiku-20240307', // Haiku 3
-};
 // Model mapping to translate aliases to full model IDs
+// Supports [1m] suffix for 1 million token context (Issue #1221)
 export const mapModelToId = model => {
+  if (!model || typeof model !== 'string') {
+    return model;
+  }
+
+  // Check for [1m] suffix (case-insensitive)
+  const match = model.match(/^(.+?)\[1m\]$/i);
+  if (match) {
+    const baseModel = match[1];
+    const mappedBase = availableModels[baseModel] || baseModel;
+    return `${mappedBase}[1m]`;
+  }
+
   return availableModels[model] || model;
 };
 // Function to validate Claude CLI connection with retry logic
@@ -218,9 +222,7 @@ export const validateClaudeConnection = async (model = 'haiku-3') => {
   // Start the validation with retry logic
   return await attemptValidation();
 };
-// handleClaudeRuntimeSwitch is imported from ./claude.runtime-switch.lib.mjs (see issue #1141)
-// Re-export it for backwards compatibility
-export { handleClaudeRuntimeSwitch };
+export { handleClaudeRuntimeSwitch }; // Re-export from ./claude.runtime-switch.lib.mjs
 
 // Store Claude Code version globally (set during validation)
 let detectedClaudeVersion = null;
@@ -913,8 +915,10 @@ export const executeClaudeCommand = async params => {
 
       // Set CLAUDE_CODE_MAX_OUTPUT_TOKENS (see issue #1076), MAX_THINKING_TOKENS (see issue #1146),
       // and MCP timeout configurations (see issue #1066)
-      const claudeEnv = getClaudeEnv({ thinkingBudget: resolvedThinkingBudget });
-      if (argv.verbose) await log(`📊 CLAUDE_CODE_MAX_OUTPUT_TOKENS: ${claudeCode.maxOutputTokens}`, { verbose: true });
+      // Pass model for model-specific max output tokens (Issue #1221)
+      const claudeEnv = getClaudeEnv({ thinkingBudget: resolvedThinkingBudget, model: mappedModel });
+      const modelMaxOutputTokens = getMaxOutputTokensForModel(mappedModel);
+      if (argv.verbose) await log(`📊 CLAUDE_CODE_MAX_OUTPUT_TOKENS: ${modelMaxOutputTokens}`, { verbose: true });
       if (argv.verbose) await log(`📊 MCP_TIMEOUT: ${claudeCode.mcpTimeout}ms (server startup)`, { verbose: true });
       if (argv.verbose) await log(`📊 MCP_TOOL_TIMEOUT: ${claudeCode.mcpToolTimeout}ms (tool execution)`, { verbose: true });
       if (resolvedThinkingBudget !== undefined) {

package/src/config.lib.mjs

@@ -91,13 +91,18 @@ export const retryLimits = {
 
 // Claude Code CLI configurations
 // See: https://github.com/link-assistant/hive-mind/issues/1076
-// Claude models support up to 64K output tokens, but Claude Code CLI defaults to 32K
+// Claude models support different max output tokens:
+// - Opus 4.6: 128K tokens (Issue #1221)
+// - Sonnet 4.5, Opus 4.5, Haiku 4.5: 64K tokens
 // Setting a higher limit allows Claude to generate longer responses without hitting the limit
 export const claudeCode = {
   // Maximum output tokens for Claude Code CLI responses
   // Default: 64000 (matches Claude Sonnet/Opus/Haiku 4.5 model capabilities)
   // Set via CLAUDE_CODE_MAX_OUTPUT_TOKENS or HIVE_MIND_CLAUDE_CODE_MAX_OUTPUT_TOKENS
   maxOutputTokens: parseIntWithDefault('CLAUDE_CODE_MAX_OUTPUT_TOKENS', parseIntWithDefault('HIVE_MIND_CLAUDE_CODE_MAX_OUTPUT_TOKENS', 64000)),
+  // Maximum output tokens for Opus 4.6 (Issue #1221)
+  // See: https://platform.claude.com/docs/en/about-claude/models/overview
+  maxOutputTokensOpus46: parseIntWithDefault('CLAUDE_CODE_MAX_OUTPUT_TOKENS_OPUS_46', parseIntWithDefault('HIVE_MIND_CLAUDE_CODE_MAX_OUTPUT_TOKENS_OPUS_46', 128000)),
   // MCP (Model Context Protocol) timeout configurations
   // See: https://github.com/link-assistant/hive-mind/issues/1066
   // See: https://code.claude.com/docs/en/settings#environment-variables
@@ -114,6 +119,47 @@ export const claudeCode = {
 // Can be overridden via --max-thinking-budget option
 export const DEFAULT_MAX_THINKING_BUDGET = 31999;
 
+// Default max thinking budget for Opus 4.6 (Issue #1221)
+// Opus 4.6 supports higher thinking budgets due to 128K max output tokens
+// Can be overridden via --max-thinking-budget option or HIVE_MIND_MAX_THINKING_BUDGET_OPUS_46
+export const DEFAULT_MAX_THINKING_BUDGET_OPUS_46 = parseIntWithDefault('HIVE_MIND_MAX_THINKING_BUDGET_OPUS_46', 64000);
+
+/**
+ * Check if a model is Opus 4.6 or later (Issue #1221)
+ * @param {string} model - The model name or ID
+ * @returns {boolean} True if the model is Opus 4.6 or later
+ */
+export const isOpus46OrLater = model => {
+  if (!model) return false;
+  const normalizedModel = model.toLowerCase();
+  // Check for opus alias (which maps to 4.6) or explicit opus-4-6
+  return normalizedModel === 'opus' || normalizedModel.includes('opus-4-6') || normalizedModel.includes('opus-4-7') || normalizedModel.includes('opus-5');
+};
+
+/**
+ * Get the max output tokens for a specific model (Issue #1221)
+ * @param {string} model - The model name or ID
+ * @returns {number} The max output tokens for the model
+ */
+export const getMaxOutputTokensForModel = model => {
+  if (isOpus46OrLater(model)) {
+    return claudeCode.maxOutputTokensOpus46;
+  }
+  return claudeCode.maxOutputTokens;
+};
+
+/**
+ * Get the default max thinking budget for a specific model (Issue #1221)
+ * @param {string} model - The model name or ID
+ * @returns {number} The default max thinking budget for the model
+ */
+export const getDefaultMaxThinkingBudgetForModel = model => {
+  if (isOpus46OrLater(model)) {
+    return DEFAULT_MAX_THINKING_BUDGET_OPUS_46;
+  }
+  return DEFAULT_MAX_THINKING_BUDGET;
+};
+
 /**
  * Get thinking level token values calculated from max budget
  * Values are evenly distributed: off=0, low=max/4, medium=max/2, high=max*3/4, max=max
@@ -174,10 +220,14 @@ export const supportsThinkingBudget = (version, minVersion = '2.1.12') => {
 // Helper function to get Claude CLI environment with CLAUDE_CODE_MAX_OUTPUT_TOKENS set
 // Optionally sets MAX_THINKING_TOKENS when thinkingBudget is provided (see issue #1146)
 // Also sets MCP_TIMEOUT and MCP_TOOL_TIMEOUT for MCP tool execution (see issue #1066)
+// Supports model-specific max output tokens for Opus 4.6 (Issue #1221)
 export const getClaudeEnv = (options = {}) => {
+  // Get max output tokens based on model (Issue #1221)
+  const maxOutputTokens = options.model ? getMaxOutputTokensForModel(options.model) : claudeCode.maxOutputTokens;
+
   const env = {
     ...process.env,
-    CLAUDE_CODE_MAX_OUTPUT_TOKENS: String(claudeCode.maxOutputTokens),
+    CLAUDE_CODE_MAX_OUTPUT_TOKENS: String(maxOutputTokens),
     // MCP timeout configurations to prevent tool calls from hanging indefinitely
     // See: https://github.com/link-assistant/hive-mind/issues/1066
     // MCP_TIMEOUT: Timeout for MCP server startup
@@ -187,7 +237,7 @@ export const getClaudeEnv = (options = {}) => {
   };
   // Set MAX_THINKING_TOKENS if thinkingBudget is provided
   // This controls Claude Code's extended thinking feature (Claude Code >= 2.1.12)
-  // Default is 31999, set to 0 to disable thinking, max is 63999 for 64K output models
+  // Default is 31999 (or 64000 for Opus 4.6), set to 0 to disable thinking
   if (options.thinkingBudget !== undefined) {
     env.MAX_THINKING_TOKENS = String(options.thinkingBudget);
   }

package/src/model-mapping.lib.mjs

@@ -6,12 +6,23 @@
  */
 
 // Claude models (Anthropic API)
+// Updated for Opus 4.6 support (Issue #1221)
 export const claudeModels = {
   sonnet: 'claude-sonnet-4-5-20250929', // Sonnet 4.5
-  opus: 'claude-opus-4-5-20251101', // Opus 4.5
+  opus: 'claude-opus-4-6', // Opus 4.6 (latest)
   haiku: 'claude-haiku-4-5-20251001', // Haiku 4.5
   'haiku-3-5': 'claude-3-5-haiku-20241022', // Haiku 3.5
   'haiku-3': 'claude-3-haiku-20240307', // Haiku 3
+  // Shorter version aliases (Issue #1221 - PR comment feedback)
+  'opus-4-6': 'claude-opus-4-6', // Opus 4.6 short alias
+  'opus-4-5': 'claude-opus-4-5-20251101', // Opus 4.5 short alias
+  'sonnet-4-5': 'claude-sonnet-4-5-20250929', // Sonnet 4.5 short alias
+  'haiku-4-5': 'claude-haiku-4-5-20251001', // Haiku 4.5 short alias
+  // Version aliases for backward compatibility (Issue #1221)
+  'claude-opus-4-6': 'claude-opus-4-6', // Opus 4.6
+  'claude-opus-4-5': 'claude-opus-4-5-20251101', // Opus 4.5
+  'claude-sonnet-4-5': 'claude-sonnet-4-5-20250929', // Sonnet 4.5
+  'claude-haiku-4-5': 'claude-haiku-4-5-20251001', // Haiku 4.5
 };
 
 // Agent models (OpenCode API via agent CLI)

package/src/model-validation.lib.mjs

@@ -13,12 +13,24 @@ import { log } from './lib.mjs';
 // Available models for each tool
 // These are the "known good" model names that we accept
 export const CLAUDE_MODELS = {
-  // Short aliases
+  // Short aliases (single word)
   sonnet: 'claude-sonnet-4-5-20250929',
-  opus: 'claude-opus-4-5-20251101',
+  opus: 'claude-opus-4-6', // Updated to Opus 4.6 (Issue #1221)
   haiku: 'claude-haiku-4-5-20251001',
   'haiku-3-5': 'claude-3-5-haiku-20241022',
   'haiku-3': 'claude-3-haiku-20240307',
+  // Shorter version aliases (Issue #1221 - PR comment feedback)
+  'opus-4-6': 'claude-opus-4-6', // Opus 4.6 short alias
+  'opus-4-5': 'claude-opus-4-5-20251101', // Opus 4.5 short alias
+  'sonnet-4-5': 'claude-sonnet-4-5-20250929', // Sonnet 4.5 short alias
+  'haiku-4-5': 'claude-haiku-4-5-20251001', // Haiku 4.5 short alias
+  // Opus version aliases (Issue #1221)
+  'claude-opus-4-6': 'claude-opus-4-6', // Latest Opus
+  'claude-opus-4-5': 'claude-opus-4-5-20251101', // Backward compatibility alias
+  // Sonnet version aliases
+  'claude-sonnet-4-5': 'claude-sonnet-4-5-20250929',
+  // Haiku version aliases
+  'claude-haiku-4-5': 'claude-haiku-4-5-20251001',
   // Full model IDs (also valid inputs)
   'claude-sonnet-4-5-20250929': 'claude-sonnet-4-5-20250929',
   'claude-opus-4-5-20251101': 'claude-opus-4-5-20251101',
@@ -27,6 +39,18 @@ export const CLAUDE_MODELS = {
   'claude-3-haiku-20240307': 'claude-3-haiku-20240307',
 };
 
+// Models that support 1M token context window via [1m] suffix (Issue #1221)
+// See: https://code.claude.com/docs/en/model-config
+export const MODELS_SUPPORTING_1M_CONTEXT = [
+  'claude-opus-4-6',
+  'claude-sonnet-4-5-20250929',
+  'claude-sonnet-4-5',
+  'sonnet',
+  'opus',
+  'opus-4-6', // Short alias (Issue #1221 - PR comment feedback)
+  'sonnet-4-5', // Short alias (Issue #1221 - PR comment feedback)
+];
+
 export const OPENCODE_MODELS = {
   gpt4: 'openai/gpt-4',
   gpt4o: 'openai/gpt-4o',
@@ -196,11 +220,66 @@ export const findSimilarModels = (input, validModels, maxSuggestions = 3, maxDis
   return suggestions;
 };
 
+/**
+ * Parse model name to extract base model and optional [1m] suffix
+ * @param {string} model - The model name (e.g., "opus[1m]", "claude-opus-4-6[1m]")
+ * @returns {{ baseModel: string, has1mSuffix: boolean }}
+ */
+export const parseModelWith1mSuffix = model => {
+  if (!model || typeof model !== 'string') {
+    return { baseModel: model, has1mSuffix: false };
+  }
+
+  // Check for [1m] suffix (case-insensitive)
+  const match = model.match(/^(.+?)\[1m\]$/i);
+  if (match) {
+    return { baseModel: match[1], has1mSuffix: true };
+  }
+
+  return { baseModel: model, has1mSuffix: false };
+};
+
+/**
+ * Check if a model supports the [1m] context window
+ * @param {string} model - The base model name (without [1m] suffix)
+ * @param {string} tool - The tool name
+ * @returns {boolean} True if the model supports 1M context
+ */
+export const supports1mContext = (model, tool = 'claude') => {
+  if (tool !== 'claude') {
+    return false;
+  }
+
+  const normalizedModel = model.toLowerCase();
+
+  // Check if the model or its mapped version supports 1M context
+  for (const supportedModel of MODELS_SUPPORTING_1M_CONTEXT) {
+    if (supportedModel.toLowerCase() === normalizedModel) {
+      return true;
+    }
+  }
+
+  // Also check if the mapped model supports 1M context
+  const modelMap = getModelMapForTool(tool);
+  const matchedKey = Object.keys(modelMap).find(key => key.toLowerCase() === normalizedModel);
+  if (matchedKey) {
+    const mappedModel = modelMap[matchedKey];
+    for (const supportedModel of MODELS_SUPPORTING_1M_CONTEXT) {
+      if (supportedModel.toLowerCase() === mappedModel.toLowerCase()) {
+        return true;
+      }
+    }
+  }
+
+  return false;
+};
+
 /**
  * Validate a model name against the available models for a tool
- * @param {string} model - The model name to validate
+ * Supports [1m] suffix for 1 million token context (Issue #1221)
+ * @param {string} model - The model name to validate (e.g., "opus", "opus[1m]", "claude-opus-4-6[1m]")
  * @param {string} tool - The tool name ('claude', 'opencode', 'codex')
- * @returns {{ valid: boolean, message?: string, suggestions?: string[] }}
+ * @returns {{ valid: boolean, message?: string, suggestions?: string[], mappedModel?: string, has1mSuffix?: boolean }}
  */
 export const validateModelName = (model, tool = 'claude') => {
   if (!model || typeof model !== 'string') {
@@ -211,23 +290,47 @@ export const validateModelName = (model, tool = 'claude') => {
     };
   }
 
+  // Parse [1m] suffix (Issue #1221)
+  const { baseModel, has1mSuffix } = parseModelWith1mSuffix(model);
+
   const modelMap = getModelMapForTool(tool);
   const availableNames = Object.keys(modelMap);
 
   // Case-insensitive exact match
-  const normalizedModel = model.toLowerCase();
+  const normalizedModel = baseModel.toLowerCase();
   const matchedKey = availableNames.find(key => key.toLowerCase() === normalizedModel);
 
   if (matchedKey) {
+    const mappedModel = modelMap[matchedKey];
+
+    // If [1m] suffix is present, validate it's supported
+    if (has1mSuffix) {
+      if (!supports1mContext(baseModel, tool)) {
+        const supportedModels = MODELS_SUPPORTING_1M_CONTEXT.filter(m => !m.includes('-')).join(', ');
+        return {
+          valid: false,
+          message: `Model "${baseModel}" does not support [1m] context window.\n   Models supporting 1M context: ${supportedModels}`,
+          suggestions: [],
+        };
+      }
+      // Return the mapped model with [1m] suffix appended
+      return {
+        valid: true,
+        mappedModel: `${mappedModel}[1m]`,
+        has1mSuffix: true,
+      };
+    }
+
     return {
       valid: true,
-      mappedModel: modelMap[matchedKey],
+      mappedModel,
+      has1mSuffix: false,
     };
   }
 
   // Model not found - provide helpful error with suggestions
   const shortNames = getAvailableModelNames(tool);
-  const suggestions = findSimilarModels(model, shortNames);
+  const suggestions = findSimilarModels(baseModel, shortNames);
 
   let message = `Unrecognized model: "${model}"`;
 
@@ -237,6 +340,11 @@ export const validateModelName = (model, tool = 'claude') => {
 
   message += `\n   Available models for ${tool}: ${shortNames.join(', ')}`;
 
+  // Add hint about [1m] suffix if available
+  if (tool === 'claude') {
+    message += `\n   Tip: Use [1m] suffix for 1M context (e.g., opus[1m], sonnet[1m])`;
+  }
+
   return {
     valid: false,
     message,