nexus-agents 2.173.1 → 2.173.3

package/dist/index.d.ts

@@ -12444,6 +12444,13 @@ declare class FailureDetector {
  *  3. behavioral archetype (arxiv:2512.07497)            → per-strategy action
  *  4. otherwise                                          → PERMANENT (fail closed)
  *
+ * PRIMARY shipped behavior is transport retry (step 2): the common recoverable
+ * case is a transient 429/5xx/network blip. The archetype path (step 3) is a
+ * SECONDARY guidance channel that only fires when the error cause-chain TEXT
+ * carries ≥2 independent indicator families (see
+ * {@link EXPERT_ERROR_TEXT_CONFIDENCE_THRESHOLD}); a lone one-family signal
+ * (e.g. a 401 "Invalid API key") stays permanent and fails closed.
+ *
  * The retry loop, backoff, and jitter are NOT reimplemented here — they are the
  * shared `withRetry`/`isRetryableError` primitives (adapters/retry.ts:9-19
  * forbids a third retry loop). Delay/attempt knobs default to
@@ -12453,10 +12460,14 @@ declare class FailureDetector {
 /**
  * Opt-in recovery policy attached to an expert at creation time. All fields are
  * optional and fall through to {@link DEFAULT_RETRY_CONFIG} (retry knobs) and
- * {@link DEFAULT_DETECTOR_CONFIG} (detector).
+ * this module's detector defaults.
  */
 interface ExpertRecoveryPolicy {
-    /** Maximum retries (attempts = maxRetries + 1). Default: DEFAULT_RETRY_CONFIG. */
+    /**
+     * Maximum retries (attempts = maxRetries + 1). Default:
+     * {@link EXPERT_RECOVERY_DEFAULT_MAX_RETRIES} (1 → 2 attempts), NOT
+     * DEFAULT_RETRY_CONFIG.maxRetries (3).
+     */
     maxRetries?: number;
     /** Base backoff delay (ms). Default: DEFAULT_RETRY_CONFIG. */
     baseDelayMs?: number;
@@ -12500,6 +12511,13 @@ declare class RecoverableExpert extends Expert {
     execute(task: Task$1, options?: {
         signal?: AbortSignal;
     }): Promise<Result<TaskResult, AgentError$1>>;
+    /**
+     * Builds the annotated failure returned when recovery is exhausted. withRetry
+     * skips isRetryable on the final attempt, so the per-attempt `lastClassification`
+     * can be stale (or undefined for maxRetries:0). Re-classify the actual `lastError`
+     * so the recovery trace labels the failure that was truly returned.
+     */
+    private annotateExhausted;
     /** Appends archetype recovery guidance to a mutable copy of the task. */
     private injectRecoveryGuidance;
     /** Recovers the DetectedFailure for an archetype (re-detect, else synthesize). */

package/dist/index.js

@@ -541,7 +541,7 @@ import {
   withLogging,
   withRetry,
   withRetryWrapper
-} from "./chunk-CC3H5XJR.js";
+} from "./chunk-GNZ2ZIT3.js";
 import {
   FALLBACK_SCANNER_DATA,
   buildPlanFromAnalysis,
@@ -575,7 +575,7 @@ import {
   getKnownNexusVarNames,
   startStdioServer,
   validateNexusEnv
-} from "./chunk-OKZ72FVJ.js";
+} from "./chunk-WJHTVYP6.js";
 import {
   OPENAI_MODELS,
   OPENAI_MODEL_ALIASES,

package/dist/{setup-command-JVQTBFUD.js → setup-command-EGDBEPM5.js}

@@ -8,9 +8,9 @@ import {
   runWizard,
   setupCommand,
   setupCommandAsync
-} from "./chunk-A7RTXDXK.js";
+} from "./chunk-QZLISECU.js";
 import "./chunk-4KURMOBY.js";
-import "./chunk-OKZ72FVJ.js";
+import "./chunk-WJHTVYP6.js";
 import "./chunk-3DYABC5Y.js";
 import "./chunk-5IDFZ2PC.js";
 import "./chunk-NUBSJGQZ.js";
@@ -38,4 +38,4 @@ export {
   setupCommand,
   setupCommandAsync
 };
-//# sourceMappingURL=setup-command-JVQTBFUD.js.map
+//# sourceMappingURL=setup-command-EGDBEPM5.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-agents",
-  "version": "2.173.1",
+  "version": "2.173.3",
   "description": "Governance substrate for AI coding agents — adversarial PR review, drift-detected rules, tamper-evident audit, and closed-loop outcome routing for Claude, Codex, Gemini, and OpenCode",
   "mcpName": "io.github.nexus-substrate/nexus-agents",
   "license": "MIT",