nexus-agents 4.2.1 → 4.3.1

package/dist/{composite-router-TSPOS57H.js → composite-router-X5QU6XNZ.js}

@@ -4,7 +4,7 @@ import {
   CompositeRoutingError,
   DEFAULT_COMPOSITE_CONFIG,
   createCompositeRouter
-} from "./chunk-TN7HF2SQ.js";
+} from "./chunk-TMYLHKLJ.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -15,4 +15,4 @@ export {
   DEFAULT_COMPOSITE_CONFIG,
   createCompositeRouter
 };
-//# sourceMappingURL=composite-router-TSPOS57H.js.map
+//# sourceMappingURL=composite-router-X5QU6XNZ.js.map

package/dist/{consensus-vote-ULN3XOCN.js → consensus-vote-3IHQNBNY.js}

@@ -11,27 +11,27 @@ import {
   resetCorrelationTracker,
   runConsensusForGoal,
   unwrapVoteOrThrow
-} from "./chunk-PAGVGHWL.js";
-import "./chunk-BYDUN7A5.js";
+} from "./chunk-LWB4RR47.js";
+import "./chunk-3P6N3XZF.js";
 import "./chunk-OQB3XC5O.js";
-import "./chunk-5DED5UHM.js";
-import "./chunk-ADIMVMAB.js";
-import "./chunk-VKLMXCI2.js";
-import "./chunk-KVHA4AEF.js";
+import "./chunk-WX5TASVN.js";
+import "./chunk-5GUP54YH.js";
+import "./chunk-B6JICUQ6.js";
+import "./chunk-2QYJ7IE2.js";
 import "./chunk-6T3EPABN.js";
-import "./chunk-JRU5G6VW.js";
+import "./chunk-3K3VGOY4.js";
 import "./chunk-DVKS77O5.js";
 import "./chunk-KSQSWEFH.js";
-import "./chunk-AMEVOGE7.js";
-import "./chunk-KLN7TJLT.js";
-import "./chunk-HNC2G7AS.js";
-import "./chunk-2HCONJES.js";
+import "./chunk-MPCBYY4J.js";
+import "./chunk-MLR4PF64.js";
+import "./chunk-DL5RN53R.js";
+import "./chunk-X57EI3U6.js";
 import "./chunk-SNJNRDKZ.js";
-import "./chunk-S645LGB6.js";
+import "./chunk-TKA6653I.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-FRTNZUUF.js";
-import "./chunk-4O7TU6R3.js";
-import "./chunk-TN7HF2SQ.js";
+import "./chunk-CYCXJNPA.js";
+import "./chunk-4JKO5B7A.js";
+import "./chunk-TMYLHKLJ.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -49,4 +49,4 @@ export {
   runConsensusForGoal,
   unwrapVoteOrThrow
 };
-//# sourceMappingURL=consensus-vote-ULN3XOCN.js.map
+//# sourceMappingURL=consensus-vote-3IHQNBNY.js.map

package/dist/{context-retriever-SGJTQUCI.js → context-retriever-CIFLPUJA.js}

@@ -6,18 +6,18 @@ import {
   inferTaskCategory,
   selectRelevantResearch,
   summarizeContextForPrompt
-} from "./chunk-CNB4PA7Q.js";
-import "./chunk-UM376MEM.js";
+} from "./chunk-LGTY3B3Q.js";
+import "./chunk-Y3WYSLFZ.js";
 import "./chunk-NUBSJGQZ.js";
-import "./chunk-3OM2W7H7.js";
-import "./chunk-KVHA4AEF.js";
+import "./chunk-XABDFFQV.js";
+import "./chunk-2QYJ7IE2.js";
 import "./chunk-6T3EPABN.js";
-import "./chunk-JRU5G6VW.js";
+import "./chunk-3K3VGOY4.js";
 import "./chunk-DVKS77O5.js";
 import "./chunk-KSQSWEFH.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-FRTNZUUF.js";
-import "./chunk-TN7HF2SQ.js";
+import "./chunk-CYCXJNPA.js";
+import "./chunk-TMYLHKLJ.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -30,4 +30,4 @@ export {
   selectRelevantResearch,
   summarizeContextForPrompt
 };
-//# sourceMappingURL=context-retriever-SGJTQUCI.js.map
+//# sourceMappingURL=context-retriever-CIFLPUJA.js.map

package/dist/{doctor-deep-33C5GGB3.js → doctor-deep-FZGNQXDZ.js}

@@ -1,8 +1,8 @@
 import {
   formatDeepDiagnostics,
   runDeepDiagnostics
-} from "./chunk-EXX6WINJ.js";
-import "./chunk-TN7HF2SQ.js";
+} from "./chunk-JV5HRP3S.js";
+import "./chunk-TMYLHKLJ.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -10,4 +10,4 @@ export {
   formatDeepDiagnostics,
   runDeepDiagnostics
 };
-//# sourceMappingURL=doctor-deep-33C5GGB3.js.map
+//# sourceMappingURL=doctor-deep-FZGNQXDZ.js.map

package/dist/{doctor-live-XRIVOJLP.js → doctor-live-KGQWMYJY.js}

@@ -1,18 +1,18 @@
 import {
   createAllAdapters,
   probeAllClis
-} from "./chunk-AMEVOGE7.js";
-import "./chunk-KLN7TJLT.js";
-import "./chunk-HNC2G7AS.js";
-import "./chunk-2HCONJES.js";
+} from "./chunk-MPCBYY4J.js";
+import "./chunk-MLR4PF64.js";
+import "./chunk-DL5RN53R.js";
+import "./chunk-X57EI3U6.js";
 import "./chunk-SNJNRDKZ.js";
-import "./chunk-S645LGB6.js";
+import "./chunk-TKA6653I.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-FRTNZUUF.js";
-import "./chunk-4O7TU6R3.js";
+import "./chunk-CYCXJNPA.js";
+import "./chunk-4JKO5B7A.js";
 import {
   resolveClassGuardMs
-} from "./chunk-TN7HF2SQ.js";
+} from "./chunk-TMYLHKLJ.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -146,4 +146,4 @@ export {
   formatLiveReadiness,
   runLiveReadiness
 };
-//# sourceMappingURL=doctor-live-XRIVOJLP.js.map
+//# sourceMappingURL=doctor-live-KGQWMYJY.js.map

package/dist/{expert-bridge-UH44L5CN.js → expert-bridge-B6ZTEZNH.js}

@@ -3,9 +3,9 @@ import {
   shutdownExpertBridge,
   tokenSplitFromUsage,
   totalTokensFromUsage
-} from "./chunk-4Z2Z52C7.js";
-import "./chunk-S645LGB6.js";
-import "./chunk-TN7HF2SQ.js";
+} from "./chunk-OYNZ6FCZ.js";
+import "./chunk-TKA6653I.js";
+import "./chunk-TMYLHKLJ.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -15,4 +15,4 @@ export {
   tokenSplitFromUsage,
   totalTokensFromUsage
 };
-//# sourceMappingURL=expert-bridge-UH44L5CN.js.map
+//# sourceMappingURL=expert-bridge-B6ZTEZNH.js.map

package/dist/{factory-GUDAJED7.js → factory-5BEGXJVB.js}

@@ -3,16 +3,16 @@ import {
   createCliAdapter,
   getAvailableClis,
   isCliAvailable
-} from "./chunk-AMEVOGE7.js";
-import "./chunk-KLN7TJLT.js";
-import "./chunk-HNC2G7AS.js";
-import "./chunk-2HCONJES.js";
+} from "./chunk-MPCBYY4J.js";
+import "./chunk-MLR4PF64.js";
+import "./chunk-DL5RN53R.js";
+import "./chunk-X57EI3U6.js";
 import "./chunk-SNJNRDKZ.js";
-import "./chunk-S645LGB6.js";
+import "./chunk-TKA6653I.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-FRTNZUUF.js";
-import "./chunk-4O7TU6R3.js";
-import "./chunk-TN7HF2SQ.js";
+import "./chunk-CYCXJNPA.js";
+import "./chunk-4JKO5B7A.js";
+import "./chunk-TMYLHKLJ.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -22,4 +22,4 @@ export {
   getAvailableClis,
   isCliAvailable
 };
-//# sourceMappingURL=factory-GUDAJED7.js.map
+//# sourceMappingURL=factory-5BEGXJVB.js.map

package/dist/{factory-HYFTOF35.js → factory-RLGGFLYD.js}

@@ -1,10 +1,10 @@
 import {
   createGitHubProvider,
   createScmProvider
-} from "./chunk-C3KZXEBR.js";
-import "./chunk-JJEOBIOI.js";
-import "./chunk-3OM2W7H7.js";
-import "./chunk-TN7HF2SQ.js";
+} from "./chunk-KIWPXWL7.js";
+import "./chunk-55XLIDEN.js";
+import "./chunk-XABDFFQV.js";
+import "./chunk-TMYLHKLJ.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -12,4 +12,4 @@ export {
   createGitHubProvider,
   createScmProvider
 };
-//# sourceMappingURL=factory-HYFTOF35.js.map
+//# sourceMappingURL=factory-RLGGFLYD.js.map

package/dist/{improvement-review-HU7P73SL.js → improvement-review-52J36YLJ.js}

@@ -11,10 +11,10 @@ import {
   loadSelfEvalSignals,
   registerImprovementReviewTool,
   runImprovementReview
-} from "./chunk-CIQJIBGF.js";
-import "./chunk-5DED5UHM.js";
-import "./chunk-ADIMVMAB.js";
-import "./chunk-TN7HF2SQ.js";
+} from "./chunk-MPEQHP4D.js";
+import "./chunk-WX5TASVN.js";
+import "./chunk-5GUP54YH.js";
+import "./chunk-TMYLHKLJ.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -32,4 +32,4 @@ export {
   registerImprovementReviewTool,
   runImprovementReview
 };
-//# sourceMappingURL=improvement-review-HU7P73SL.js.map
+//# sourceMappingURL=improvement-review-52J36YLJ.js.map

package/dist/index.d.ts

@@ -2909,8 +2909,8 @@ declare const OutcomeFailureCategorySchema: z.ZodEnum<{
     rate_limit: "rate_limit";
     unknown: "unknown";
     validation: "validation";
-    authentication: "authentication";
     crash: "crash";
+    authentication: "authentication";
     adapter_unavailable: "adapter_unavailable";
     generic: "generic";
 }>;
@@ -2953,8 +2953,8 @@ declare const TaskOutcomeSchema$1: z.ZodObject<{
         rate_limit: "rate_limit";
         unknown: "unknown";
         validation: "validation";
-        authentication: "authentication";
         crash: "crash";
+        authentication: "authentication";
         adapter_unavailable: "adapter_unavailable";
         generic: "generic";
     }>>;
@@ -3014,8 +3014,8 @@ declare const OutcomeQuerySchema: z.ZodObject<{
         rate_limit: "rate_limit";
         unknown: "unknown";
         validation: "validation";
-        authentication: "authentication";
         crash: "crash";
+        authentication: "authentication";
         adapter_unavailable: "adapter_unavailable";
         generic: "generic";
     }>>;
@@ -4791,8 +4791,8 @@ declare const CompositeRouterConfigSchema: z.ZodObject<{
     }, z.core.$strip>>;
     linucbAlpha: z.ZodDefault<z.ZodNumber>;
     billingMode: z.ZodDefault<z.ZodEnum<{
-        plan: "plan";
         api: "api";
+        plan: "plan";
     }>>;
     enableCapacityBalancing: z.ZodDefault<z.ZodBoolean>;
     maxDecisionTimeMs: z.ZodDefault<z.ZodNumber>;
@@ -7571,43 +7571,6 @@ declare class CliDetectionCache implements ICliDetectionCache {
  */
 declare function createCliDetectionCache(config?: Partial<CliDetectionCacheConfig>): ICliDetectionCache;
 
-/**
- * Health states for the adapter.
- * - healthy: adapter detected and operational
- * - degraded: adapter operational but experienced recent failures
- * - unavailable: no adapter could be detected
- */
-type AdapterHealthState = 'healthy' | 'degraded' | 'unavailable';
-/**
- * Health information for the current adapter.
- */
-interface AdapterHealthInfo {
-    readonly source: CliName | 'api';
-    readonly state: AdapterHealthState;
-    readonly selectedAt: Date;
-    readonly failoverCount: number;
-    readonly lastError?: string;
-}
-/**
- * Extension of IModelAdapter with health monitoring and failover.
- *
- * Consumers that only need IModelAdapter continue to work unchanged.
- * Dashboard/monitoring consumers can cast to IResilientAdapter for
- * health and failover APIs.
- */
-interface IResilientAdapter extends IModelAdapter {
-    /** Current health info (undefined if not yet initialized) */
-    getHealth(): AdapterHealthInfo | undefined;
-    /** Force re-detection of adapters */
-    refresh(): Promise<void>;
-    /** Override preferred CLI */
-    setPreferredCli(cli: CliName | undefined): void;
-    /** Register failover callback */
-    onFailover(cb: (info: AdapterHealthInfo) => void): () => void;
-    /** Cleanup listeners and timers */
-    dispose(): void;
-}
-
 /**
  * Circuit breaker states.
  */
@@ -7730,6 +7693,120 @@ declare class CircuitError extends NexusError {
     });
 }
 
+/**
+ * nexus-agents/cli-adapters - Circuit Breaker Implementation
+ *
+ * Implements the circuit breaker pattern to handle CLI failures gracefully
+ * and prevent cascade failures in the multi-CLI mesh.
+ *
+ * (Source: Issue #81 - Circuit breaker for CLI failures)
+ * (Source: Martin Fowler's Circuit Breaker pattern)
+ */
+
+/**
+ * Circuit breaker implementation for CLI adapters.
+ *
+ * Provides protection against cascading failures by:
+ * 1. Tracking failure counts
+ * 2. Opening circuit when threshold exceeded
+ * 3. Allowing gradual recovery through half-open state
+ */
+declare class CliCircuitBreaker implements ICircuitBreaker {
+    private readonly cliName;
+    private readonly config;
+    private state;
+    private failureCount;
+    private successCount;
+    private lastFailureTime;
+    private lastStateChange;
+    private halfOpenRequests;
+    private readonly listeners;
+    constructor(cliName: CliName, config?: CircuitBreakerConfig);
+    /**
+     * Executes a function with circuit breaker protection.
+     */
+    execute<T>(fn: () => Promise<T>): Promise<Result<T, CircuitError>>;
+    getState(): CircuitState;
+    getSnapshot(): CircuitBreakerSnapshot;
+    reset(): void;
+    recordFailure(category: FailureCategory): void;
+    recordSuccess(): void;
+    addStateChangeListener(listener: CircuitStateChangeListener): void;
+    removeStateChangeListener(listener: CircuitStateChangeListener): void;
+    private canExecute;
+    private checkStateTransition;
+    private onSuccess;
+    private onFailure;
+    private transitionTo;
+    private emitStateChange;
+    private shouldCountFailure;
+    private createExecutionError;
+}
+/**
+ * Registry for managing per-CLI circuit breakers.
+ */
+declare class CircuitBreakerRegistry {
+    private readonly defaultConfig;
+    private readonly breakers;
+    private readonly globalListeners;
+    constructor(defaultConfig?: Partial<CircuitBreakerConfig>);
+    getBreaker(cliName: CliName, config?: Partial<CircuitBreakerConfig>): CliCircuitBreaker;
+    isOpen(cliName: CliName): boolean;
+    getAllSnapshots(): Map<CliName, CircuitBreakerSnapshot>;
+    resetAll(): void;
+    reset(cliName: CliName): void;
+    addGlobalStateChangeListener(listener: CircuitStateChangeListener): void;
+    removeGlobalStateChangeListener(listener: CircuitStateChangeListener): void;
+    getHealthyClis(): CliName[];
+    getUnhealthyClis(): CliName[];
+}
+
+/**
+ * Health states for the adapter.
+ * - healthy: adapter detected and operational
+ * - degraded: adapter operational but experienced recent failures
+ * - unavailable: no adapter could be detected
+ */
+type AdapterHealthState = 'healthy' | 'degraded' | 'unavailable';
+/**
+ * Health information for the current adapter.
+ */
+interface AdapterHealthInfo {
+    readonly source: CliName | 'api';
+    readonly state: AdapterHealthState;
+    readonly selectedAt: Date;
+    readonly failoverCount: number;
+    readonly lastError?: string;
+}
+/**
+ * Extension of IModelAdapter with health monitoring and failover.
+ *
+ * Consumers that only need IModelAdapter continue to work unchanged.
+ * Dashboard/monitoring consumers can cast to IResilientAdapter for
+ * health and failover APIs.
+ */
+interface IResilientAdapter extends IModelAdapter {
+    /** Current health info (undefined if not yet initialized) */
+    getHealth(): AdapterHealthInfo | undefined;
+    /** Force re-detection of adapters */
+    refresh(): Promise<void>;
+    /** Override preferred CLI */
+    setPreferredCli(cli: CliName | undefined): void;
+    /** Register failover callback */
+    onFailover(cb: (info: AdapterHealthInfo) => void): () => void;
+    /**
+     * The registry arming this adapter's failover, or `undefined` if none (#4659).
+     *
+     * Read-only on purpose: exposing `attach` here would re-create the "someone
+     * must remember to call it" shape that left the breaker disarmed. Supply it
+     * via {@link ResilientAdapterConfig.circuitBreakerRegistry} instead. This
+     * accessor exists so a caller can VERIFY the adapter is armed.
+     */
+    getCircuitBreakerRegistry?(): CircuitBreakerRegistry | undefined;
+    /** Cleanup listeners and timers */
+    dispose(): void;
+}
+
 /**
  * Unified Adapter Registry — single entry point for all model adapter access.
  *
@@ -9111,8 +9188,8 @@ interface IEventBus$1 {
  * Zod schema for CollaborationPattern.
  */
 declare const CollaborationPatternSchema: z.ZodEnum<{
-    consensus: "consensus";
     review: "review";
+    consensus: "consensus";
     sequential: "sequential";
     parallel: "parallel";
     reflexion: "reflexion";
@@ -9147,8 +9224,8 @@ declare const VoteDecisionSchema: z.ZodEnum<{
 declare const CollaborationConfigSchema: z.ZodObject<{
     sessionId: z.ZodString;
     pattern: z.ZodEnum<{
-        consensus: "consensus";
         review: "review";
+        consensus: "consensus";
         sequential: "sequential";
         parallel: "parallel";
         reflexion: "reflexion";
@@ -19847,8 +19924,8 @@ declare const DecisionCostRecordSchema: z.ZodObject<{
     timestamp: z.ZodString;
     summary: z.ZodObject<{
         billingMode: z.ZodEnum<{
-            plan: "plan";
             api: "api";
+            plan: "plan";
         }>;
         voterCount: z.ZodNumber;
         measuredVoters: z.ZodNumber;
@@ -22230,8 +22307,8 @@ declare const DelegateInputSchema: z.ZodObject<{
     }>>;
     model_hint: z.ZodOptional<z.ZodString>;
     billing_mode: z.ZodOptional<z.ZodEnum<{
-        plan: "plan";
         api: "api";
+        plan: "plan";
     }>>;
 }, z.core.$strip>;
 type DelegateInput = z.infer<typeof DelegateInputSchema>;
@@ -22333,8 +22410,8 @@ declare function selectModel(input: DelegateInput, requirements: TaskRequirement
  * - consensus: Final vote on recommendations (Round 3)
  */
 declare const VotingRoundPhaseSchema: z.ZodEnum<{
-    consensus: "consensus";
     analysis: "analysis";
+    consensus: "consensus";
     deliberation: "deliberation";
 }>;
 type VotingRoundPhase = z.infer<typeof VotingRoundPhaseSchema>;
@@ -22357,8 +22434,8 @@ declare const AgentFindingSchema: z.ZodObject<{
     category: z.ZodEnum<{
         security: "security";
         documentation: "documentation";
-        design: "design";
         performance: "performance";
+        design: "design";
         other: "other";
         bug: "bug";
         style: "style";
@@ -31280,8 +31357,8 @@ declare function parseSpec(markdown: string): Result<ParsedSpec, SpecParseError>
  */
 declare const SubtaskTypeSchema: z.ZodEnum<{
     code: "code";
-    test: "test";
     refactor: "refactor";
+    test: "test";
     docs: "docs";
     config: "config";
 }>;
@@ -31304,8 +31381,8 @@ declare const SubtaskNodeSchema: z.ZodObject<{
     description: z.ZodString;
     type: z.ZodEnum<{
         code: "code";
-        test: "test";
         refactor: "refactor";
+        test: "test";
         docs: "docs";
         config: "config";
     }>;
@@ -31337,8 +31414,8 @@ declare const TaskDagSchema: z.ZodObject<{
         description: z.ZodString;
         type: z.ZodEnum<{
             code: "code";
-            test: "test";
             refactor: "refactor";
+            test: "test";
             docs: "docs";
             config: "config";
         }>;
@@ -33143,12 +33220,12 @@ declare const ArtifactRefSchema: z.ZodObject<{
     id: z.ZodString;
     type: z.ZodEnum<{
         code: "code";
-        plan: "plan";
-        test: "test";
         analysis: "analysis";
+        test: "test";
         spec: "spec";
         review: "review";
         report: "report";
+        plan: "plan";
         vote: "vote";
     }>;
 }, z.core.$strip>;
@@ -33193,12 +33270,12 @@ declare const TaskContractSchema: z.ZodObject<{
         id: z.ZodString;
         type: z.ZodEnum<{
             code: "code";
-            plan: "plan";
-            test: "test";
             analysis: "analysis";
+            test: "test";
             spec: "spec";
             review: "review";
             report: "report";
+            plan: "plan";
             vote: "vote";
         }>;
     }, z.core.$strip>>;
@@ -33340,12 +33417,12 @@ declare const StageResultSchema: z.ZodObject<{
         id: z.ZodString;
         type: z.ZodEnum<{
             code: "code";
-            plan: "plan";
-            test: "test";
             analysis: "analysis";
+            test: "test";
             spec: "spec";
             review: "review";
             report: "report";
+            plan: "plan";
             vote: "vote";
         }>;
     }, z.core.$strip>>;