@link-assistant/hive-mind 1.74.10 → 1.74.12

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @link-assistant/hive-mind
 
+## 1.74.12
+
+### Patch Changes
+
+- e921b34: fix(retry): treat "socket connection was closed unexpectedly" as a transient, retryable error (#1881)
+
+  The Claude/Codex CLI surfaces transient network disconnects (the Anthropic SDK's
+  underlying `fetch()` socket dropping mid-stream) as a synthetic error:
+  `API Error: The socket connection was closed unexpectedly.` Previously
+  `classifyRetryableError()` did not recognise this family of errors, so a single
+  dropped socket aborted the entire solve session (exit code 1, zero retries) and
+  discarded all in-progress work. These socket/connection drops
+  (`socket connection was closed unexpectedly`, `socket hang up`, `ECONNRESET`,
+  `connection reset`, `Connection error`, `fetch failed`, `network connection lost`)
+  are now classified as retryable, so the session is retried with `--resume`
+  (context preserved) via the existing exponential-backoff path. Because
+  `classifyRetryableError` is the shared classifier, the fix covers the Claude,
+  Codex and Agent execution loops at once.
+
+## 1.74.11
+
+### Patch Changes
+
+- faa10c5: Add support for Claude Fable 5 (`claude-fable-5`) and its un-classified sibling Claude Mythos 5 (`claude-mythos-5`) as selectable models for `--tool claude` (Issue #1875). New aliases `fable`, `fable-5`, `claude-fable-5`, `mythos-5`, and `claude-mythos-5` resolve in the centralized model registry, support the `[1m]` 1M-context suffix, the full effort ladder including `xhigh` and `max` (default `high`), and 128K max output tokens. Both models are adaptive-thinking-only, so `getClaudeEnv` removes `MAX_THINKING_TOKENS` for them (the API rejects disabled thinking), mirroring Opus 4.7/4.8. Documented default fallbacks are registered (`claude-fable-5 -> opus` reflecting Fable 5's safety-classifier hand-off to Opus 4.8; `claude-mythos-5 -> fable`). Existing defaults (`opus`, `sonnet`, `haiku`, `opusplan`) are unchanged — this adds Fable 5 as an option without altering current behavior. `fable` is surfaced in `--model` help. Includes `tests/test-fable-5-model-support.mjs` (127 tests) and a full case study under `docs/case-studies/issue-1875/`.
+
 ## 1.74.10
 
 ### Patch Changes

package/package.json

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

package/src/config.lib.mjs

@@ -270,6 +270,48 @@ const isMythosPreview = model => {
   return model.toLowerCase().includes('mythos');
 };
 
+/**
+ * Check if a model is Claude Fable 5 (Issue #1875)
+ * Fable 5 (`claude-fable-5`) is Anthropic's most capable widely released model
+ * (generally available June 9, 2026). It is a Mythos-class model wrapped in safety
+ * classifiers that can refuse high-risk requests (returning stop_reason "refusal")
+ * and fall back to Claude Opus 4.8.
+ * @param {string} model - The model name or ID
+ * @returns {boolean} True if the model is Claude Fable 5
+ */
+export const isFable5 = model => {
+  if (!model) return false;
+  const m = model.toLowerCase();
+  return m === 'fable' || m === 'fable-5' || m.includes('fable-5') || m.includes('fable5');
+};
+
+/**
+ * Check if a model is Claude Mythos 5 (Issue #1875)
+ * Mythos 5 (`claude-mythos-5`) shares Fable 5's capabilities without the safety
+ * classifiers and is offered in limited availability via Project Glasswing.
+ * Distinct from Claude Mythos Preview (see isMythosPreview): Mythos 5 additionally
+ * supports the `xhigh` effort level.
+ * @param {string} model - The model name or ID
+ * @returns {boolean} True if the model is Claude Mythos 5
+ */
+export const isMythos5 = model => {
+  if (!model) return false;
+  const m = model.toLowerCase();
+  return m === 'mythos-5' || m.includes('mythos-5') || m.includes('mythos5');
+};
+
+/**
+ * Check if a model is Claude Fable 5 or Claude Mythos 5 (Issue #1875)
+ * Both share the same Messages API constraints: the effort parameter is supported
+ * across low/medium/high/xhigh/max (default high), adaptive thinking is always on
+ * (extended/manual thinking is unavailable and `thinking: {type: "disabled"}` is
+ * rejected), the context window is 1M tokens, and max output is 128k tokens.
+ * See: https://platform.claude.com/docs/en/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5
+ * @param {string} model - The model name or ID
+ * @returns {boolean} True if the model is Claude Fable 5 or Claude Mythos 5
+ */
+export const isFable5OrMythos5 = model => isFable5(model) || isMythos5(model);
+
 /**
  * Check if a model supports CLAUDE_CODE_EFFORT_LEVEL (Issue #1238, Issue #1620)
  * Official effort support: Claude Mythos Preview, Opus 4.7, Opus 4.6, Sonnet 4.6, and Opus 4.5.
@@ -279,32 +321,36 @@ const isMythosPreview = model => {
  */
 export const supportsEffortLevel = model => {
   if (!model) return false;
-  return isMythosPreview(model) || isOpus47OrLater(model) || isOpus46(model) || isSonnet46OrLater(model) || isOpus45(model);
+  return isFable5OrMythos5(model) || isMythosPreview(model) || isOpus47OrLater(model) || isOpus46(model) || isSonnet46OrLater(model) || isOpus45(model);
 };
 
 /**
  * Check if a model supports the xhigh effort level.
- * Official docs list xhigh for Claude Opus 4.7 and Opus 4.8 (Issue #1832).
+ * Official docs list xhigh for Claude Fable 5, Claude Mythos 5, Claude Opus 4.7,
+ * and Opus 4.8 (Issue #1832, Issue #1875).
  * @param {string} model - The model name or ID
  * @returns {boolean} True if the model supports xhigh effort
  */
-export const supportsXHighEffortLevel = model => isOpus47(model);
+export const supportsXHighEffortLevel = model => isFable5OrMythos5(model) || isOpus47(model);
 
 /**
  * Check if a model supports the max effort level.
- * Official docs list max for Claude Mythos Preview, Opus 4.7, Opus 4.6, and Sonnet 4.6.
+ * Official docs list max for Claude Fable 5, Claude Mythos 5, Claude Mythos Preview,
+ * Opus 4.7, Opus 4.6, and Sonnet 4.6 (Issue #1875).
  * @param {string} model - The model name or ID
  * @returns {boolean} True if the model supports max effort
  */
-export const supportsMaxEffortLevel = model => isMythosPreview(model) || isOpus47OrLater(model) || isOpus46(model) || isSonnet46OrLater(model);
+export const supportsMaxEffortLevel = model => isFable5OrMythos5(model) || isMythosPreview(model) || isOpus47OrLater(model) || isOpus46(model) || isSonnet46OrLater(model);
 
 /**
- * Get the max output tokens for a specific model (Issue #1221)
+ * Get the max output tokens for a specific model (Issue #1221, Issue #1875)
+ * Claude Fable 5 and Claude Mythos 5 support up to 128k output tokens, matching
+ * the Opus 4.6+ ceiling.
  * @param {string} model - The model name or ID
  * @returns {number} The max output tokens for the model
  */
 export const getMaxOutputTokensForModel = model => {
-  if (isOpus46OrLater(model)) {
+  if (isOpus46OrLater(model) || isFable5OrMythos5(model)) {
     return claudeCode.maxOutputTokensOpus46;
   }
   return claudeCode.maxOutputTokens;
@@ -479,11 +525,14 @@ export const getClaudeEnv = (options = {}) => {
 
   // Opus 4.7+ always uses adaptive thinking — MAX_THINKING_TOKENS has no effect (Issue #1620, Issue #1832)
   // Opus 4.8 inherits this constraint: adaptive thinking is the only thinking mode.
+  // Claude Fable 5 and Claude Mythos 5 are adaptive-thinking-only too: extended/manual
+  // thinking is unavailable and `thinking: {type: "disabled"}` is rejected, so a
+  // MAX_THINKING_TOKENS=0 would be invalid for them (Issue #1875).
   // For Opus 4.6 and earlier, MAX_THINKING_TOKENS controls extended thinking (Claude Code >= 2.1.12)
   // Default is 0 (thinking disabled) per Issue #1238.
-  const opus47 = options.model && isOpus47OrLater(options.model);
-  if (opus47) {
-    // Remove any inherited MAX_THINKING_TOKENS from process.env — Opus 4.7+ ignores it
+  const adaptiveThinkingOnly = options.model && (isOpus47OrLater(options.model) || isFable5OrMythos5(options.model));
+  if (adaptiveThinkingOnly) {
+    // Remove any inherited MAX_THINKING_TOKENS from process.env — these models ignore it
     delete env.MAX_THINKING_TOKENS;
   } else {
     env.MAX_THINKING_TOKENS = String(options.thinkingBudget ?? 0);

package/src/models/index.mjs

@@ -28,7 +28,8 @@ const execFileAsync = promisify(execFile);
 // ─── MODEL DATA ──────────────────────────────────────────────────────────────
 
 // Claude models (Anthropic API)
-// Updated for Opus 4.5/4.6/4.7/4.8 and Sonnet 4.6 support (Issue #1221, Issue #1238, Issue #1329, Issue #1433, Issue #1620, Issue #1832)
+// Updated for Opus 4.5/4.6/4.7/4.8, Sonnet 4.6, and Fable 5 / Mythos 5 support
+// (Issue #1221, Issue #1238, Issue #1329, Issue #1433, Issue #1620, Issue #1832, Issue #1875)
 export const claudeModels = {
   sonnet: 'claude-sonnet-4-6', // Sonnet 4.6 (default, Issue #1329)
   opus: 'claude-opus-4-8', // Opus 4.8 (Issue #1832)
@@ -36,6 +37,13 @@ export const claudeModels = {
   'haiku-3-5': 'claude-3-5-haiku-20241022', // Haiku 3.5
   'haiku-3': 'claude-3-haiku-20240307', // Haiku 3
   opusplan: 'opusplan', // Special mode: Opus for planning, Sonnet for execution (Issue #1223)
+  // Claude Fable 5 — Anthropic's most capable widely released (Mythos-class) model, GA 2026-06-09 (Issue #1875)
+  fable: 'claude-fable-5', // Fable 5 alias
+  'fable-5': 'claude-fable-5', // Fable 5 short alias
+  'claude-fable-5': 'claude-fable-5', // Fable 5 full ID
+  // Claude Mythos 5 — shares Fable 5's capabilities without safety classifiers; limited availability (Project Glasswing) (Issue #1875)
+  'mythos-5': 'claude-mythos-5', // Mythos 5 short alias
+  'claude-mythos-5': 'claude-mythos-5', // Mythos 5 full ID
   // Shorter version aliases (Issue #1221, Issue #1329 - PR comment feedback)
   'sonnet-4-6': 'claude-sonnet-4-6', // Sonnet 4.6 short alias (Issue #1329)
   'opus-4-8': 'claude-opus-4-8', // Opus 4.8 short alias (Issue #1832)
@@ -180,6 +188,11 @@ export const defaultModels = {
 // Models that support 1M token context window via [1m] suffix (Issue #1221, Issue #1238, Issue #1329, Issue #1832)
 // See: https://code.claude.com/docs/en/model-config
 export const MODELS_SUPPORTING_1M_CONTEXT = [
+  'claude-fable-5', // Fable 5 — 1M context by default (Issue #1875)
+  'claude-mythos-5', // Mythos 5 — 1M context by default (Issue #1875)
+  'fable', // Fable 5 alias (Issue #1875)
+  'fable-5', // Fable 5 short alias (Issue #1875)
+  'mythos-5', // Mythos 5 short alias (Issue #1875)
   'claude-opus-4-8', // Opus 4.8 (Issue #1832)
   'claude-opus-4-7', // Opus 4.7 (Issue #1620)
   'claude-opus-4-6',
@@ -220,6 +233,8 @@ export const freeToBaseModelMap = {
 
 export const CLAUDE_MODELS = {
   ...claudeModels,
+  'claude-fable-5': 'claude-fable-5', // Fable 5 full ID (Issue #1875)
+  'claude-mythos-5': 'claude-mythos-5', // Mythos 5 full ID (Issue #1875)
   'claude-opus-4-8': 'claude-opus-4-8', // Opus 4.8 full ID (Issue #1832)
   'claude-opus-4-7': 'claude-opus-4-7', // Opus 4.7 full ID (Issue #1620)
   'claude-sonnet-4-5-20250929': 'claude-sonnet-4-5-20250929',
@@ -450,7 +465,7 @@ export const getValidModelsForTool = tool => {
 // Primary (non-alias, non-deprecated) short names shown in CLI help descriptions
 // These are the recommended model names users should see in --model help text
 export const primaryModelNames = {
-  claude: ['opus', 'sonnet', 'haiku', 'opusplan'],
+  claude: ['opus', 'sonnet', 'haiku', 'opusplan', 'fable'],
   opencode: ['grok', 'gpt4o'],
   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'],
@@ -994,6 +1009,13 @@ export const resolveModelId = (requestedModel, tool) => {
 
 export const defaultFallbackModels = {
   claude: {
+    // Claude Fable 5's safety classifiers can refuse high-risk requests and hand them
+    // off to Claude Opus 4.8; mirror that documented fallback here (Issue #1875).
+    // See: https://platform.claude.com/docs/en/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5
+    'claude-fable-5': 'opus',
+    // Claude Mythos 5 (limited availability) falls back to the generally available
+    // Mythos-class model, Claude Fable 5 (Issue #1875).
+    'claude-mythos-5': 'fable',
     'claude-opus-4-8': 'opus-4-7',
     'claude-opus-4-7': 'opus-4-6',
   },

package/src/solve.config.lib.mjs

@@ -285,7 +285,7 @@ export const SOLVE_OPTION_DEFINITIONS = {
   },
   think: {
     type: 'string',
-    description: 'Thinking level hint. For Claude, translated to --thinking-budget for Claude Code >= 2.1.12 (off=0, low=~8000, medium=~16000, high=~24000, xhigh/max=31999) and to CLAUDE_CODE_EFFORT_LEVEL when supported. Opus 4.8/4.7 support xhigh and max; Opus 4.6/Sonnet 4.6/Mythos support max; Opus 4.5 uses high for xhigh/max. For Codex, mapped to reasoning effort (off=none, low=low, medium=medium, high=high, xhigh/max=xhigh).',
+    description: 'Thinking level hint. For Claude, translated to --thinking-budget for Claude Code >= 2.1.12 (off=0, low=~8000, medium=~16000, high=~24000, xhigh/max=31999) and to CLAUDE_CODE_EFFORT_LEVEL when supported. Fable 5/Mythos 5/Opus 4.8/4.7 support xhigh and max; Opus 4.6/Sonnet 4.6/Mythos Preview support max; Opus 4.5 uses high for xhigh/max. For Codex, mapped to reasoning effort (off=none, low=low, medium=medium, high=high, xhigh/max=xhigh).',
     choices: ['off', 'low', 'medium', 'high', 'xhigh', 'max'],
     default: undefined,
   },
@@ -316,7 +316,7 @@ export const SOLVE_OPTION_DEFINITIONS = {
   },
   'fallback-model': {
     type: 'string',
-    description: 'Fallback model to switch to on model capacity/overload errors. When supported, retries resume the same session with this model. Defaults: claude opus/opus-4-8 -> opus-4-7; claude opus-4-7 -> opus-4-6; codex gpt-5.5 -> gpt-5.4; all others unset.',
+    description: 'Fallback model to switch to on model capacity/overload errors (and, for Fable 5, on safety-classifier refusals). When supported, retries resume the same session with this model. Defaults: claude fable/claude-fable-5 -> opus (Opus 4.8); claude mythos-5/claude-mythos-5 -> fable; claude opus/opus-4-8 -> opus-4-7; claude opus-4-7 -> opus-4-6; codex gpt-5.5 -> gpt-5.4; all others unset.',
     default: undefined,
   },
   'show-thinking-content': {

package/src/tool-retry.lib.mjs

@@ -43,6 +43,20 @@ export const classifyRetryableError = value => {
     return { message, isRetryable: true, isCapacity: false, label: 'Stream disconnected before completion' };
   }
 
+  // Issue #1881: Transient socket / network disconnects from the SDK's underlying fetch.
+  // When the HTTP(S)/streaming socket drops mid-request, the Claude/Codex CLI surfaces a
+  // synthetic assistant message such as:
+  //   "API Error: The socket connection was closed unexpectedly. For more information,
+  //    pass `verbose: true` in the second argument to fetch()"
+  // These are network-level failures (QUIC/TCP resets, idle-socket teardown, proxy/VPN
+  // interruptions, undici socket hang-ups), not request-content errors, so they are safe
+  // to retry with the session preserved (--resume). Without this branch the whole solve
+  // session aborts on a single dropped socket.
+  // Upstream: anthropics/claude-code#48837, #51107, #54287, #60133.
+  if (lower.includes('socket connection was closed unexpectedly') || lower.includes('socket hang up') || lower.includes('econnreset') || lower.includes('connection reset') || lower.includes('network connection lost') || lower.includes('connection error') || lower.includes('fetch failed')) {
+    return { message, isRetryable: true, isCapacity: false, label: 'Socket/connection closed unexpectedly' };
+  }
+
   // Issue #1834: Corrupted extended-thinking blocks. When extended thinking is combined with tool
   // use, Claude Code can persist a thinking block to the session transcript with the `thinking`
   // text emptied to "" while retaining the original `signature`. On resume/continue the block is