nexus-agents 2.79.3 → 2.80.0

package/dist/{chunk-KT5FIBWS.js → chunk-HBKZ2DJK.js}

@@ -1,6 +1,6 @@
 import {
   createLogger
-} from "./chunk-WDYCIJWN.js";
+} from "./chunk-YMT6H2HQ.js";
 
 // src/config/available-models-cache.ts
 var logger = createLogger({ component: "available-models-cache" });
@@ -150,4 +150,4 @@ export {
   getDefaultAvailableModelsCache,
   setDefaultAvailableModelsCache
 };
-//# sourceMappingURL=chunk-KT5FIBWS.js.map
+//# sourceMappingURL=chunk-HBKZ2DJK.js.map

package/dist/{chunk-2YPG6PDG.js → chunk-J5XEJHIQ.js}

@@ -2,14 +2,14 @@ import {
   CircuitBreakerRegistry,
   CircuitError,
   mapCliErrorToCategory
-} from "./chunk-DLXT23AC.js";
+} from "./chunk-JXDDSNEK.js";
 import {
   createLogger,
   err,
   getFallbackChainForCategory,
   getTimeProvider,
   ok
-} from "./chunk-WDYCIJWN.js";
+} from "./chunk-YMT6H2HQ.js";
 
 // src/cli-adapters/cli-circuit-breaker.ts
 var CATEGORY_TO_FALLBACK = {
@@ -152,4 +152,4 @@ export {
   CliCircuitBreakerIntegration,
   createCliCircuitBreakerIntegration
 };
-//# sourceMappingURL=chunk-2YPG6PDG.js.map
+//# sourceMappingURL=chunk-J5XEJHIQ.js.map

package/dist/{chunk-ZVCED4Z4.js → chunk-JLWKHYIU.js}

@@ -2,7 +2,7 @@ import {
   ConfigError,
   err,
   ok
-} from "./chunk-WDYCIJWN.js";
+} from "./chunk-YMT6H2HQ.js";
 
 // src/adapters/sdk/types.ts
 var PROVIDER_ENV_KEYS = {
@@ -117,4 +117,4 @@ export {
   CUSTOM_API_ALLOW_PRIVATE_ENV,
   validateCustomApiBaseUrl
 };
-//# sourceMappingURL=chunk-ZVCED4Z4.js.map
+//# sourceMappingURL=chunk-JLWKHYIU.js.map

package/dist/{chunk-DLXT23AC.js → chunk-JXDDSNEK.js}

@@ -5,7 +5,7 @@ import {
   getErrorMessage,
   getTimeProvider,
   ok
-} from "./chunk-WDYCIJWN.js";
+} from "./chunk-YMT6H2HQ.js";
 
 // src/cli-adapters/circuit-breaker-types.ts
 var CircuitErrorCode = {
@@ -353,4 +353,4 @@ export {
   CircuitBreakerRegistry,
   mapCliErrorToCategory
 };
-//# sourceMappingURL=chunk-DLXT23AC.js.map
+//# sourceMappingURL=chunk-JXDDSNEK.js.map

package/dist/{chunk-Q5CFPIJ5.js → chunk-OO6MTUDS.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-PQHVC4BD.js";
 import {
   SessionMemory
-} from "./chunk-3NIPH6UP.js";
+} from "./chunk-AYZ6P7CK.js";
 import {
   ErrorCode,
   NexusError,
@@ -22,10 +22,10 @@ import {
   getTimeProvider,
   ok,
   setSharedMobiMemDbPathResolver
-} from "./chunk-WDYCIJWN.js";
+} from "./chunk-YMT6H2HQ.js";
 import {
   nexusDataPath
-} from "./chunk-7BMOZJYS.js";
+} from "./chunk-2JQXC3CK.js";
 
 // src/mcp/tools/tool-memory.ts
 import * as fs3 from "fs";
@@ -5578,4 +5578,4 @@ export {
   reinitializeMemoryBackends,
   ToolMemoryManager
 };
-//# sourceMappingURL=chunk-Q5CFPIJ5.js.map
+//# sourceMappingURL=chunk-OO6MTUDS.js.map

package/dist/chunk-Q2U6SFN2.js

@@ -0,0 +1,136 @@
+import {
+  DEFAULT_MODEL_PER_CLI,
+  getTimeProvider
+} from "./chunk-YMT6H2HQ.js";
+
+// src/config/model-availability.ts
+var DEFAULT_TTL_MS = 6e4;
+var DEFAULT_MAX_ENTRIES = 50;
+var AvailabilityCache = class {
+  cache = /* @__PURE__ */ new Map();
+  ttlMs;
+  maxEntries;
+  constructor(config = {}) {
+    this.ttlMs = config.ttlMs ?? DEFAULT_TTL_MS;
+    this.maxEntries = config.maxEntries ?? DEFAULT_MAX_ENTRIES;
+  }
+  /** Get a cached probe result, or undefined if expired/missing. */
+  get(modelId) {
+    const entry = this.cache.get(modelId);
+    if (entry === void 0) return void 0;
+    if (getTimeProvider().now() - entry.checkedAt > this.ttlMs) {
+      this.cache.delete(modelId);
+      return void 0;
+    }
+    return entry;
+  }
+  /** Store a probe result, evicting oldest if at capacity. */
+  set(result) {
+    if (this.cache.size >= this.maxEntries && !this.cache.has(result.modelId)) {
+      const oldest = this.cache.keys().next();
+      if (oldest.done !== true) {
+        this.cache.delete(oldest.value);
+      }
+    }
+    this.cache.set(result.modelId, result);
+  }
+  /** Mark a model as unavailable without a full probe. */
+  markUnavailable(modelId, error) {
+    this.set({
+      modelId,
+      available: false,
+      latencyMs: 0,
+      checkedAt: getTimeProvider().now(),
+      error
+    });
+  }
+  /** Mark a model as available. */
+  markAvailable(modelId, latencyMs) {
+    this.set({
+      modelId,
+      available: true,
+      latencyMs,
+      checkedAt: getTimeProvider().now()
+    });
+  }
+  /** Check if a model is known-unavailable (cached and not expired). */
+  isKnownUnavailable(modelId) {
+    const entry = this.get(modelId);
+    return entry !== void 0 && !entry.available;
+  }
+  /** Get all cached entries (for diagnostics). */
+  entries() {
+    return [...this.cache.values()];
+  }
+  /** Number of cached entries. */
+  get size() {
+    return this.cache.size;
+  }
+  /** Clear all cached entries. */
+  clear() {
+    this.cache.clear();
+  }
+};
+var FALLBACK_CHAINS = {
+  claude: ["claude-opus", "claude-sonnet", "claude-haiku"],
+  gemini: ["gemini-3-pro", "gemini-pro", "gemini-3-flash", "gemini-flash"],
+  codex: ["codex-5.3", "codex-5.2", "codex-5.1-mini"],
+  opencode: ["opencode-custom-opus", "opencode-custom-sonnet", "opencode-default"]
+};
+function resolveFallback(modelId, cache) {
+  const cli = getCliForModelId(modelId);
+  if (cli === void 0) return null;
+  const chain = FALLBACK_CHAINS[cli];
+  for (const candidate of chain) {
+    if (candidate === modelId) continue;
+    if (!cache.isKnownUnavailable(candidate)) {
+      return {
+        modelId: candidate,
+        reason: `Fallback from ${modelId} (unavailable) to ${candidate}`
+      };
+    }
+  }
+  return null;
+}
+function getFallbackChain(cli) {
+  return FALLBACK_CHAINS[cli];
+}
+function getCliForModelId(modelId) {
+  for (const [cli, defaultModel] of Object.entries(DEFAULT_MODEL_PER_CLI)) {
+    const chain = FALLBACK_CHAINS[cli];
+    if (chain.includes(modelId)) return cli;
+    if (defaultModel === modelId) return cli;
+  }
+  return void 0;
+}
+var globalCache;
+function getAvailabilityCache() {
+  globalCache ??= new AvailabilityCache();
+  return globalCache;
+}
+function resetAvailabilityCache() {
+  globalCache = void 0;
+}
+function filterAvailableModels(modelIds, cache) {
+  const available = [];
+  const removed = [];
+  for (const id of modelIds) {
+    if (cache.isKnownUnavailable(id)) {
+      removed.push(id);
+    } else {
+      available.push(id);
+    }
+  }
+  return { available, removed };
+}
+
+export {
+  AvailabilityCache,
+  resolveFallback,
+  getFallbackChain,
+  getCliForModelId,
+  getAvailabilityCache,
+  resetAvailabilityCache,
+  filterAvailableModels
+};
+//# sourceMappingURL=chunk-Q2U6SFN2.js.map

package/dist/chunk-Q2U6SFN2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/model-availability.ts"],"sourcesContent":["/**\n * nexus-agents/config - Model Availability Probes & Fallback Chains\n *\n * Runtime availability tracking for model APIs. Maintains a bounded\n * TTL cache of probe results and provides fallback chain resolution\n * when a model is unavailable.\n *\n * @module config/model-availability\n * (Source: Issue #869)\n */\n\nimport { getTimeProvider } from '../core/index.js';\nimport type { ModelId, CliNameLiteral } from './model-capabilities-types.js';\nimport { DEFAULT_MODEL_PER_CLI } from './in-tree-data.js';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Status of a model probe. */\nexport interface ProbeResult {\n  readonly modelId: ModelId;\n  readonly available: boolean;\n  readonly latencyMs: number;\n  readonly checkedAt: number;\n  readonly error?: string;\n}\n\n/** Configuration for the availability cache. */\nexport interface AvailabilityCacheConfig {\n  /** Time-to-live in ms for probe results. Default: 60_000 (1 min). */\n  readonly ttlMs?: number;\n  /** Maximum entries in the cache. Default: 50. */\n  readonly maxEntries?: number;\n}\n\n/** A function that probes whether a model is reachable. */\nexport type ProbeFn = (modelId: ModelId) => Promise<ProbeResult>;\n\n/** Fallback chain entry with model and reason for fallback. */\nexport interface FallbackEntry {\n  readonly modelId: ModelId;\n  readonly reason: string;\n}\n\n// ---------------------------------------------------------------------------\n// Availability Cache\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_TTL_MS = 60_000;\nconst DEFAULT_MAX_ENTRIES = 50;\n\n/**\n * Bounded TTL cache for model availability probe results.\n * Thread-safe for single-threaded Node.js; no locks needed.\n */\nexport class AvailabilityCache {\n  private readonly cache = new Map<ModelId, ProbeResult>();\n  private readonly ttlMs: number;\n  private readonly maxEntries: number;\n\n  constructor(config: AvailabilityCacheConfig = {}) {\n    this.ttlMs = config.ttlMs ?? DEFAULT_TTL_MS;\n    this.maxEntries = config.maxEntries ?? DEFAULT_MAX_ENTRIES;\n  }\n\n  /** Get a cached probe result, or undefined if expired/missing. */\n  get(modelId: ModelId): ProbeResult | undefined {\n    const entry = this.cache.get(modelId);\n    if (entry === undefined) return undefined;\n    if (getTimeProvider().now() - entry.checkedAt > this.ttlMs) {\n      this.cache.delete(modelId);\n      return undefined;\n    }\n    return entry;\n  }\n\n  /** Store a probe result, evicting oldest if at capacity. */\n  set(result: ProbeResult): void {\n    if (this.cache.size >= this.maxEntries && !this.cache.has(result.modelId)) {\n      const oldest = this.cache.keys().next();\n      if (oldest.done !== true) {\n        this.cache.delete(oldest.value);\n      }\n    }\n    this.cache.set(result.modelId, result);\n  }\n\n  /** Mark a model as unavailable without a full probe. */\n  markUnavailable(modelId: ModelId, error: string): void {\n    this.set({\n      modelId,\n      available: false,\n      latencyMs: 0,\n      checkedAt: getTimeProvider().now(),\n      error,\n    });\n  }\n\n  /** Mark a model as available. */\n  markAvailable(modelId: ModelId, latencyMs: number): void {\n    this.set({\n      modelId,\n      available: true,\n      latencyMs,\n      checkedAt: getTimeProvider().now(),\n    });\n  }\n\n  /** Check if a model is known-unavailable (cached and not expired). */\n  isKnownUnavailable(modelId: ModelId): boolean {\n    const entry = this.get(modelId);\n    return entry !== undefined && !entry.available;\n  }\n\n  /** Get all cached entries (for diagnostics). */\n  entries(): ReadonlyArray<ProbeResult> {\n    return [...this.cache.values()];\n  }\n\n  /** Number of cached entries. */\n  get size(): number {\n    return this.cache.size;\n  }\n\n  /** Clear all cached entries. */\n  clear(): void {\n    this.cache.clear();\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Fallback Chain Resolution\n// ---------------------------------------------------------------------------\n\n/** Default fallback order per CLI (strongest → weakest). */\nconst FALLBACK_CHAINS: Readonly<Record<CliNameLiteral, readonly ModelId[]>> = {\n  claude: ['claude-opus', 'claude-sonnet', 'claude-haiku'],\n  gemini: ['gemini-3-pro', 'gemini-pro', 'gemini-3-flash', 'gemini-flash'],\n  codex: ['codex-5.3', 'codex-5.2', 'codex-5.1-mini'],\n  opencode: ['opencode-custom-opus', 'opencode-custom-sonnet', 'opencode-default'],\n};\n\n/**\n * Resolves a fallback chain for a given model.\n * Returns the first available model in the chain, skipping known-unavailable ones.\n */\nexport function resolveFallback(modelId: ModelId, cache: AvailabilityCache): FallbackEntry | null {\n  const cli = getCliForModelId(modelId);\n  if (cli === undefined) return null;\n\n  const chain = FALLBACK_CHAINS[cli];\n  for (const candidate of chain) {\n    if (candidate === modelId) continue;\n    if (!cache.isKnownUnavailable(candidate)) {\n      return {\n        modelId: candidate,\n        reason: `Fallback from ${modelId} (unavailable) to ${candidate}`,\n      };\n    }\n  }\n  return null;\n}\n\n/**\n * Get the fallback chain for a CLI tool.\n */\nexport function getFallbackChain(cli: CliNameLiteral): readonly ModelId[] {\n  return FALLBACK_CHAINS[cli];\n}\n\n/**\n * Get the CLI name for a model ID.\n */\nexport function getCliForModelId(modelId: ModelId): CliNameLiteral | undefined {\n  for (const [cli, defaultModel] of Object.entries(DEFAULT_MODEL_PER_CLI)) {\n    const chain = FALLBACK_CHAINS[cli as CliNameLiteral];\n    if (chain.includes(modelId)) return cli as CliNameLiteral;\n    if (defaultModel === modelId) return cli as CliNameLiteral;\n  }\n  return undefined;\n}\n\n// ---------------------------------------------------------------------------\n// Singleton Cache (shared across the process)\n// ---------------------------------------------------------------------------\n\nlet globalCache: AvailabilityCache | undefined;\n\n/** Get the shared availability cache (lazy-init). */\nexport function getAvailabilityCache(): AvailabilityCache {\n  globalCache ??= new AvailabilityCache();\n  return globalCache;\n}\n\n/** Reset the global cache (for testing). */\nexport function resetAvailabilityCache(): void {\n  globalCache = undefined;\n}\n\n// ---------------------------------------------------------------------------\n// Filter Integration\n// ---------------------------------------------------------------------------\n\n/**\n * Filters out known-unavailable models from a set of model IDs.\n * Returns the filtered set, or null if no models were removed.\n * Used by scoreAllModels() to skip unavailable models.\n */\nexport function filterAvailableModels(\n  modelIds: readonly string[],\n  cache: AvailabilityCache\n): { available: string[]; removed: string[] } {\n  const available: string[] = [];\n  const removed: string[] = [];\n  for (const id of modelIds) {\n    if (cache.isKnownUnavailable(id as ModelId)) {\n      removed.push(id);\n    } else {\n      available.push(id);\n    }\n  }\n  return { available, removed };\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-6TFTVW77.js → chunk-QVHXEQFM.js}

@@ -1,14 +1,14 @@
 import {
   GitHubProvider,
   ScmError
-} from "./chunk-SD76JZBG.js";
+} from "./chunk-UVALD724.js";
 import {
   CACHE_TIMEOUTS,
   createLogger,
   err,
   getTimeProvider,
   ok
-} from "./chunk-WDYCIJWN.js";
+} from "./chunk-YMT6H2HQ.js";
 
 // src/security/trust-types.ts
 import { z } from "zod";
@@ -1656,4 +1656,4 @@ export {
   IssueTriage,
   createIssueTriage
 };
-//# sourceMappingURL=chunk-6TFTVW77.js.map
+//# sourceMappingURL=chunk-QVHXEQFM.js.map

package/dist/{chunk-FJWWSVWB.js → chunk-RIUUFBX4.js}

@@ -4,7 +4,7 @@ import {
 import {
   createLogger,
   getTimeProvider
-} from "./chunk-WDYCIJWN.js";
+} from "./chunk-YMT6H2HQ.js";
 
 // src/mcp/tools/scanner-registry-fetcher.ts
 import { z } from "zod";
@@ -721,4 +721,4 @@ export {
   generateSecurityPlan,
   buildPlanFromAnalysis
 };
-//# sourceMappingURL=chunk-FJWWSVWB.js.map
+//# sourceMappingURL=chunk-RIUUFBX4.js.map

package/dist/{chunk-DNO2INX5.js → chunk-SHVGZK4A.js}

@@ -1,17 +1,17 @@
 import {
   getToolMemory
-} from "./chunk-Q5CFPIJ5.js";
+} from "./chunk-OO6MTUDS.js";
 import {
   CLI_NAMES,
   StrategyDistiller,
   createLogger,
   getOutcomeStore,
   registerPersistentDistillerFactory
-} from "./chunk-WDYCIJWN.js";
+} from "./chunk-YMT6H2HQ.js";
 import {
   ensureLearningDir,
   getRulesFile
-} from "./chunk-7BMOZJYS.js";
+} from "./chunk-2JQXC3CK.js";
 
 // src/learning/strategy-distiller-persistence.ts
 import { writeFileSync, readFileSync, renameSync, unlinkSync, existsSync } from "fs";
@@ -273,4 +273,4 @@ export {
   inferTaskCategory,
   summarizeContextForPrompt
 };
-//# sourceMappingURL=chunk-DNO2INX5.js.map
+//# sourceMappingURL=chunk-SHVGZK4A.js.map