@link-assistant/hive-mind 1.56.2 → 1.56.3

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @link-assistant/hive-mind
 
+## 1.56.3
+
+### Patch Changes
+
+- 86da037: Support `gpt-5.5` for the Codex tool, prefer it as the default model, accept forward-compatible `gpt-5.5-mini` and `gpt-5.5-nano` aliases, and document per-tool model and reasoning defaults.
+
 ## 1.56.2
 
 ### Patch Changes

package/README.hi.md

@@ -452,7 +452,7 @@ Aliases:
 /agent /solve --tool agent के बराबर है
 
 Tool alias examples:
-/codex https://github.com/owner/repo/issues/123 --model gpt-5.4
+/codex https://github.com/owner/repo/issues/123 --model gpt-5.5
 /opencode https://github.com/owner/repo/issues/123 --model grok-code-fast-1
 /agent https://github.com/owner/repo/issues/123 --model nemotron-3-super-free
 

package/README.md

@@ -461,7 +461,7 @@ Aliases:
 /agent is equivalent to /solve --tool agent
 
 Tool alias examples:
-/codex https://github.com/owner/repo/issues/123 --model gpt-5.4
+/codex https://github.com/owner/repo/issues/123 --model gpt-5.5
 /opencode https://github.com/owner/repo/issues/123 --model grok-code-fast-1
 /agent https://github.com/owner/repo/issues/123 --model nemotron-3-super-free
 
@@ -477,6 +477,17 @@ Free Models via Kilo Gateway (with --tool agent):
 /solve https://github.com/owner/repo/issues/123 --tool agent --model kilo/deepseek-r1-free
 ```
 
+Current tool defaults in Hive Mind:
+
+| Tool       | Default model                                               | Default reasoning behavior                                                               |
+| ---------- | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| `claude`   | `sonnet`                                                    | No extra thinking is requested unless you pass `--think` or `--thinking-budget`          |
+| `codex`    | `gpt-5.5` preferred, with runtime fallback to local catalog | Codex runs with `reasoning_effort=none` unless you pass `--think` or `--thinking-budget` |
+| `opencode` | `grok-code-fast-1`                                          | No extra thinking prompt is added for the default model                                  |
+| `agent`    | `nemotron-3-super-free`                                     | No extra thinking prompt is added for the default model                                  |
+
+See [docs/CONFIGURATION.md](./docs/CONFIGURATION.md) for the full per-tool defaults and reasoning mappings.
+
 > **📖 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/README.ru.md

@@ -452,7 +452,7 @@ Aliases:
 /agent эквивалентна /solve --tool agent
 
 Tool alias examples:
-/codex https://github.com/owner/repo/issues/123 --model gpt-5.4
+/codex https://github.com/owner/repo/issues/123 --model gpt-5.5
 /opencode https://github.com/owner/repo/issues/123 --model grok-code-fast-1
 /agent https://github.com/owner/repo/issues/123 --model nemotron-3-super-free
 

package/README.zh.md

@@ -452,7 +452,7 @@ Aliases:
 /agent 等同于 /solve --tool agent
 
 Tool alias examples:
-/codex https://github.com/owner/repo/issues/123 --model gpt-5.4
+/codex https://github.com/owner/repo/issues/123 --model gpt-5.5
 /opencode https://github.com/owner/repo/issues/123 --model grok-code-fast-1
 /agent https://github.com/owner/repo/issues/123 --model nemotron-3-super-free
 

package/package.json

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

package/src/codex.lib.mjs

@@ -23,6 +23,7 @@ import { createInteractiveHandler } from './interactive-mode.lib.mjs';
 import { initProgressMonitoring } from './solve.progress-monitoring.lib.mjs';
 import { getCodexPlaywrightMcpDisableConfigArgs } from './playwright-mcp.lib.mjs';
 import { fetchModelInfo } from './model-info.lib.mjs';
+import { defaultModels } from './models/index.mjs';
 import Decimal from 'decimal.js-light';
 
 const CODEX_USAGE_FIELD_NAMES = ['input_tokens', 'cached_input_tokens', 'output_tokens', 'cache_write_tokens', 'cache_creation_input_tokens', 'reasoning_tokens', 'input_tokens_details.cached_tokens', 'input_tokens_details.cache_read_tokens', 'input_tokens_details.cache_write_tokens', 'input_tokens_details.cache_creation_tokens', 'input_tokens_details.cache_creation_input_tokens', 'output_tokens_details.reasoning_tokens'];
@@ -408,7 +409,7 @@ export const calculateCodexPricing = async (modelId, tokenUsage) => {
 };
 
 // Function to validate Codex CLI connection
-export const validateCodexConnection = async (model = 'gpt-5.4', verbose = false) => {
+export const validateCodexConnection = async (model = defaultModels.codex, verbose = false) => {
   // Map model alias to full ID
   const mappedModel = mapModelToId(model);
 

package/src/hive.mjs

@@ -86,7 +86,7 @@ if (isRunningDirectly) {
     const { validateClaudeConnection } = claudeLib;
     // Import model validation library
     const modelValidation = await import('./models/index.mjs');
-    const { validateAndExitOnInvalidModel, defaultModels } = modelValidation;
+    const { validateAndExitOnInvalidModel, defaultModels, resolveRuntimeDefaultModel } = modelValidation;
     const githubLib = await import('./github.lib.mjs');
     const { checkGitHubPermissions, fetchAllIssuesWithPagination, fetchProjectIssues, isRateLimitError, batchCheckPullRequestsForIssues, parseGitHubUrl, batchCheckArchivedRepositories } = githubLib;
     // Import YouTrack-related functions
@@ -458,7 +458,7 @@ if (isRunningDirectly) {
 
     const modelExplicitlyProvided = rawArgs.includes('--model') || rawArgs.includes('-m') || rawArgs.includes('--worker-model');
     if (argv.tool && !modelExplicitlyProvided && defaultModels[argv.tool]) {
-      argv.model = defaultModels[argv.tool];
+      argv.model = await resolveRuntimeDefaultModel(argv.tool);
     }
 
     // Validate model names EARLY (simple string check, always runs)

package/src/models/index.mjs

@@ -12,6 +12,9 @@
  * @see https://github.com/link-assistant/hive-mind/issues/1473
  */
 
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+
 // Check if use is already defined (when imported from solve.mjs)
 // If not, fetch it (when running standalone)
 if (typeof globalThis.use === 'undefined') {
@@ -20,6 +23,8 @@ if (typeof globalThis.use === 'undefined') {
 
 import { log } from '../lib.mjs';
 
+const execFileAsync = promisify(execFile);
+
 // ─── MODEL DATA ──────────────────────────────────────────────────────────────
 
 // Claude models (Anthropic API)
@@ -106,9 +111,13 @@ export const opencodeModels = {
 export const codexModels = {
   gpt5: 'gpt-5',
   'gpt-5': 'gpt-5',
+  'gpt-5.5': 'gpt-5.5',
+  'gpt-5.5-mini': 'gpt-5.5-mini',
+  'gpt-5.5-nano': 'gpt-5.5-nano',
   'gpt-5.4': 'gpt-5.4',
   'gpt-5.4-mini': 'gpt-5.4-mini',
   'gpt-5.4-nano': 'gpt-5.4-nano',
+  'gpt-5.2': 'gpt-5.2',
   'gpt-5.2-codex': 'gpt-5.2-codex',
   'gpt-5.3-codex': 'gpt-5.3-codex',
   'gpt-5.3-codex-spark': 'gpt-5.3-codex-spark',
@@ -125,7 +134,7 @@ export const defaultModels = {
   claude: 'sonnet',
   agent: 'nemotron-3-super-free', // Issue #1563: changed from qwen3.6-plus-free (free promotion ended) per agent PR #243
   opencode: 'grok-code-fast-1',
-  codex: 'gpt-5.4',
+  codex: 'gpt-5.5',
 };
 
 // Models that support 1M token context window via [1m] suffix (Issue #1221, Issue #1238, Issue #1329)
@@ -190,9 +199,13 @@ export const OPENCODE_MODELS = {
 export const CODEX_MODELS = {
   ...codexModels,
   'gpt-5': 'gpt-5',
+  'gpt-5.5': 'gpt-5.5',
+  'gpt-5.5-mini': 'gpt-5.5-mini',
+  'gpt-5.5-nano': 'gpt-5.5-nano',
   'gpt-5.4': 'gpt-5.4',
   'gpt-5.4-mini': 'gpt-5.4-mini',
   'gpt-5.4-nano': 'gpt-5.4-nano',
+  'gpt-5.2': 'gpt-5.2',
   'gpt-5.2-codex': 'gpt-5.2-codex',
   'gpt-5.3-codex': 'gpt-5.3-codex',
   'gpt-5.3-codex-spark': 'gpt-5.3-codex-spark',
@@ -249,6 +262,50 @@ export const getDefaultModelForTool = tool => {
   return defaultModels[tool] || defaultModels.claude;
 };
 
+let cachedInstalledCodexModelsPromise = null;
+const CODEX_DEFAULT_FALLBACK_CHAIN = ['gpt-5.4', 'gpt-5.5-mini', 'gpt-5.4-mini', 'gpt-5.3-codex', 'gpt-5.3-codex-spark', 'gpt-5.2', 'gpt-5.2-codex', 'gpt-5.5-nano', 'gpt-5.4-nano'];
+
+export const getInstalledCodexModels = async () => {
+  if (!cachedInstalledCodexModelsPromise) {
+    cachedInstalledCodexModelsPromise = (async () => {
+      try {
+        const { stdout } = await execFileAsync('codex', ['debug', 'models'], {
+          encoding: 'utf8',
+          maxBuffer: 10 * 1024 * 1024,
+        });
+        const parsed = JSON.parse(stdout);
+        const modelSlugs = parsed?.models?.map(model => model?.slug).filter(Boolean);
+        return Array.isArray(modelSlugs) ? [...new Set(modelSlugs)] : null;
+      } catch {
+        return null;
+      }
+    })();
+  }
+
+  return cachedInstalledCodexModelsPromise;
+};
+
+export const resolveRuntimeDefaultModel = async (tool, options = {}) => {
+  const toolName = (tool || 'claude').toString().toLowerCase();
+  const preferredDefault = defaultModels[toolName] || defaultModels.claude;
+
+  if (toolName !== 'codex') {
+    return preferredDefault;
+  }
+
+  const availableCodexModels = options.availableCodexModels === undefined ? await getInstalledCodexModels() : options.availableCodexModels;
+
+  if (!Array.isArray(availableCodexModels) || availableCodexModels.length === 0) {
+    return preferredDefault;
+  }
+
+  if (availableCodexModels.includes(preferredDefault)) {
+    return preferredDefault;
+  }
+
+  return CODEX_DEFAULT_FALLBACK_CHAIN.find(model => availableCodexModels.includes(model)) || preferredDefault;
+};
+
 /**
  * Map model name to full model ID for a specific tool
  * @param {string} tool - The tool name (claude, agent, opencode, codex)
@@ -318,7 +375,7 @@ export const getValidModelsForTool = tool => {
 export const primaryModelNames = {
   claude: ['opus', 'sonnet', 'haiku', 'opusplan'],
   opencode: ['grok', 'gpt4o'],
-  codex: ['gpt-5.4', 'gpt-5.4-mini', 'gpt-5.3-codex', 'gpt-5.3-codex-spark', 'gpt-5.2-codex'],
+  codex: ['gpt-5.5', 'gpt-5.4', 'gpt-5.4-mini', 'gpt-5.3-codex', 'gpt-5.3-codex-spark'],
   agent: ['nemotron-3-super-free', 'minimax-m2.5-free', 'big-pickle', 'gpt-5-nano', 'glm-5-free', 'deepseek-r1-free'],
 };
 

package/src/solve.config.lib.mjs

@@ -8,7 +8,7 @@
 // This approach was adopted per issue #482 feedback to minimize custom code maintenance
 
 import { enhanceErrorMessage, detectMalformedFlags } from './option-suggestions.lib.mjs';
-import { defaultModels, buildModelOptionDescription } from './models/index.mjs';
+import { defaultModels, buildModelOptionDescription, resolveRuntimeDefaultModel } from './models/index.mjs';
 import { validateBranchName } from './solve.branch.lib.mjs';
 
 // Re-export for use by telegram-bot.mjs (avoids extra import lines there)
@@ -678,7 +678,7 @@ export const parseArguments = async (yargs, hideBin) => {
   if (argv.tool && !modelExplicitlyProvided && defaultModels[argv.tool]) {
     // User did not explicitly provide --model, so use the correct default for the tool
     // (Issue #1473: centralized in models/index.mjs)
-    argv.model = defaultModels[argv.tool];
+    argv.model = await resolveRuntimeDefaultModel(argv.tool);
   }
 
   // Validate mutual exclusivity of --claude-file and --gitkeep-file