nexus-agents 2.131.0 → 2.132.0

package/dist/{codebase-search-ZFJUVMVR.js → codebase-search-PWMWLU7O.js}

@@ -1,8 +1,8 @@
 import {
   CodebaseIndex
 } from "./chunk-3ACDP4E6.js";
-import "./chunk-PR4QN5HX.js";
+import "./chunk-ZPWHCABL.js";
 export {
   CodebaseIndex
 };
-//# sourceMappingURL=codebase-search-ZFJUVMVR.js.map
+//# sourceMappingURL=codebase-search-PWMWLU7O.js.map

package/dist/{composite-router-V36PBE7B.js → composite-router-HQUSCJO4.js}

@@ -4,9 +4,9 @@ import {
   CompositeRoutingError,
   DEFAULT_COMPOSITE_CONFIG,
   createCompositeRouter
-} from "./chunk-VY5WEC2D.js";
-import "./chunk-ZGLIHPGJ.js";
-import "./chunk-PR4QN5HX.js";
+} from "./chunk-QJIHSQZX.js";
+import "./chunk-RUSP5PJR.js";
+import "./chunk-ZPWHCABL.js";
 export {
   CompositeRouter,
   CompositeRouterConfigSchema,
@@ -14,4 +14,4 @@ export {
   DEFAULT_COMPOSITE_CONFIG,
   createCompositeRouter
 };
-//# sourceMappingURL=composite-router-V36PBE7B.js.map
+//# sourceMappingURL=composite-router-HQUSCJO4.js.map

package/dist/consensus-vote-E2WJFEIJ.js

@@ -0,0 +1,37 @@
+import {
+  CONSENSUS_VOTE_OUTPUT_SCHEMA,
+  ConsensusVoteInputSchema,
+  VotingStrategySchema,
+  createPolicyFailedResult,
+  executeVoting,
+  registerConsensusVoteTool,
+  resetCorrelationTracker,
+  runConsensusForGoal
+} from "./chunk-I2SW34K6.js";
+import "./chunk-TGGR6ST5.js";
+import "./chunk-4CLBJ2NA.js";
+import "./chunk-GYDO2WOR.js";
+import "./chunk-NZGNOXXW.js";
+import "./chunk-6T3EPABN.js";
+import "./chunk-PQHVC4BD.js";
+import "./chunk-XIFOAZ5B.js";
+import "./chunk-VZCQRLXT.js";
+import "./chunk-WHZD2W6Q.js";
+import "./chunk-ECDJM6UB.js";
+import "./chunk-ZTRBMKXK.js";
+import "./chunk-7BONPRR2.js";
+import "./chunk-E4IYX7LD.js";
+import "./chunk-QJIHSQZX.js";
+import "./chunk-RUSP5PJR.js";
+import "./chunk-ZPWHCABL.js";
+export {
+  CONSENSUS_VOTE_OUTPUT_SCHEMA,
+  ConsensusVoteInputSchema,
+  VotingStrategySchema,
+  createPolicyFailedResult,
+  executeVoting,
+  registerConsensusVoteTool,
+  resetCorrelationTracker,
+  runConsensusForGoal
+};
+//# sourceMappingURL=consensus-vote-E2WJFEIJ.js.map

package/dist/{consensus-vote-types-DdruG9-X.d.ts → consensus-vote-types-CYBHW8vY.d.ts}

@@ -64,6 +64,96 @@ declare const PricingSchema: z.ZodObject<{
 }, z.core.$strip>;
 type Pricing = z.infer<typeof PricingSchema>;
 
+/**
+ * decision-cost — per-DECISION cost aggregation over a governed panel's voters.
+ *
+ * Source: Issue #3855 (epic #3854 child, M4).
+ *
+ * A governed decision — a `consensus_vote` or `pr_review` run — fans out to N
+ * voter calls; each voter is one LLM call. Per-CALL usage telemetry already
+ * exists ({@link module:learning/usage-log} — token + cost per model call,
+ * PR #2479/#2480 era). This module is the AGGREGATION layer that rolls those
+ * per-call numbers UP into a single per-decision answer: "what did this
+ * governed decision cost?".
+ *
+ * It is a PURE rollup (no I/O, no clock, no env reads at the math layer):
+ * {@link rollupDecisionCost} takes the per-voter cost inputs + the billing mode
+ * and returns a {@link DecisionCostSummary} — total tokens, total USD, a
+ * per-voter breakdown, and a per-model breakdown. Persistence + the live
+ * `process.env` billing-mode read live in the callers (the store + the tools),
+ * mirroring the usage-log split between `computeCostUSD` (pure) and
+ * `recordUsageEvent` (I/O).
+ *
+ * Design decisions that the fixture tests pin (#3855 acceptance criteria):
+ *
+ *  - **Missing cost is UNMEASURED, not zero.** A voter with no token counts
+ *    (e.g. a CLI-subscription adapter that doesn't report usage, or an error
+ *    vote that never reached the model) is counted in `unmeasuredVoters` and
+ *    contributes 0 to the totals — but the summary records that the total is a
+ *    floor, not an exact figure (`measured` < `voterCount`). Treating unmeasured
+ *    as a true $0 would silently understate spend; this keeps the honesty.
+ *  - **Plan mode records 0-cost but keeps tokens.** Under `NEXUS_BILLING_MODE=plan`
+ *    the spend is pre-covered by a subscription, so cost is recorded as $0 while
+ *    token counts are preserved (so the operator can still see consumption and
+ *    a later `api`-mode reprice is possible). This mirrors how plan mode zeroes
+ *    cost in routing/scoring without dropping the token signal.
+ *
+ * @module observability/decision-cost
+ */
+/** Billing mode in effect for a decision. Mirrors `NEXUS_BILLING_MODE`. */
+type DecisionBillingMode = 'plan' | 'api';
+/** Per-voter line in the decision rollup. */
+interface VoterCostBreakdown {
+    readonly role: string;
+    readonly model: string;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly totalTokens: number;
+    /** Effective cost after billing-mode application (0 in plan mode). */
+    readonly costUsd: number;
+    /**
+     * True when this voter reported NO usage at all (no tokens, no cost). Its
+     * zeros are placeholders, not a measured $0 / 0-token call.
+     */
+    readonly unmeasured: boolean;
+}
+/** Per-model rollup line within a single decision. */
+interface ModelCostBreakdown {
+    readonly model: string;
+    readonly voterCount: number;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly totalTokens: number;
+    readonly costUsd: number;
+}
+/**
+ * The per-decision cost rollup. Totals are a FLOOR when `unmeasuredVoters > 0`
+ * — read alongside `measuredVoters` / `voterCount` for the confidence.
+ */
+interface DecisionCostSummary {
+    /** Billing mode applied to produce `totalCostUsd` (and per-line `costUsd`). */
+    readonly billingMode: DecisionBillingMode;
+    /** Total voters folded into this decision. */
+    readonly voterCount: number;
+    /** Voters that reported usage (tokens and/or cost). */
+    readonly measuredVoters: number;
+    /** Voters that reported no usage at all (counted, not zeroed-as-fact). */
+    readonly unmeasuredVoters: number;
+    readonly totalInputTokens: number;
+    readonly totalOutputTokens: number;
+    readonly totalTokens: number;
+    /**
+     * Total cost in USD. 0 under `plan` mode by construction. A FLOOR when
+     * `unmeasuredVoters > 0` (unmeasured voters contribute 0, not their unknown
+     * real cost).
+     */
+    readonly totalCostUsd: number;
+    /** Per-voter breakdown, in input order. */
+    readonly perVoter: readonly VoterCostBreakdown[];
+    /** Per-model breakdown, sorted by total cost desc then total tokens desc. */
+    readonly perModel: readonly ModelCostBreakdown[];
+}
+
 /**
  * Types, schemas, and response helpers for the consensus_vote MCP tool.
  * Extracted from consensus-vote.ts for file size compliance (Issue #708).
@@ -133,12 +223,12 @@ declare const ConsensusVoteInputSchema: z.ZodObject<{
         majority: "majority";
     }>>;
     strategy: z.ZodOptional<z.ZodEnum<{
+        higher_order: "higher_order";
         simple_majority: "simple_majority";
         supermajority: "supermajority";
         unanimous: "unanimous";
         proof_of_learning: "proof_of_learning";
         opinion_wise: "opinion_wise";
-        higher_order: "higher_order";
     }>>;
     errorPolicy: z.ZodOptional<z.ZodEnum<{
         reduce_denominator: "reduce_denominator";
@@ -208,6 +298,13 @@ interface ConsensusVoteResponse {
      * Absent when every requested voter returned a real vote.
      */
     panelWarning?: string;
+    /**
+     * Per-decision cost rollup (#3855): per-voter / per-model token + USD totals
+     * for this governed decision. Rides the existing response — no new MCP tool.
+     * Totals are a floor when `costSummary.unmeasuredVoters > 0` (voters whose
+     * adapter reported no usage are counted as unmeasured, not a measured $0).
+     */
+    costSummary?: DecisionCostSummary;
 }
 
-export { type AgentVoteSummary as A, type CliNameLiteral as C, type ErrorPolicy as E, type InputModality as I, type ModelId as M, type OutputModality as O, type Pricing as P, type QualityScores as Q, type SpecialFeature as S, type ToolCapability as T, type VotingStrategy as V, type ConsensusVoteInput as a, ConsensusVoteInputSchema as b, type ConsensusVoteResponse as c, type VoteDecisionStatus as d, type VoteThreshold as e };
+export { type AgentVoteSummary as A, type CliNameLiteral as C, type DecisionCostSummary as D, type ErrorPolicy as E, type InputModality as I, type ModelId as M, type OutputModality as O, type Pricing as P, type QualityScores as Q, type SpecialFeature as S, type ToolCapability as T, type VotingStrategy as V, type ConsensusVoteInput as a, ConsensusVoteInputSchema as b, type ConsensusVoteResponse as c, type VoteDecisionStatus as d, type VoteThreshold as e };

package/dist/{context-retriever-KCSSXI6X.js → context-retriever-5OVRAWNZ.js}

@@ -5,18 +5,18 @@ import {
   inferTaskCategory,
   selectRelevantResearch,
   summarizeContextForPrompt
-} from "./chunk-YEK3ZHO6.js";
-import "./chunk-YHBVFTRG.js";
-import "./chunk-VTTPYENR.js";
-import "./chunk-PM4MZHQK.js";
-import "./chunk-FDY6YOFG.js";
+} from "./chunk-S4U3Z6ZS.js";
+import "./chunk-ZQEQVCIU.js";
+import "./chunk-2CLFX73Y.js";
+import "./chunk-GYDO2WOR.js";
+import "./chunk-NZGNOXXW.js";
 import "./chunk-NUBSJGQZ.js";
 import "./chunk-6T3EPABN.js";
 import "./chunk-PQHVC4BD.js";
-import "./chunk-E4LAXVQE.js";
-import "./chunk-VY5WEC2D.js";
-import "./chunk-ZGLIHPGJ.js";
-import "./chunk-PR4QN5HX.js";
+import "./chunk-E4IYX7LD.js";
+import "./chunk-QJIHSQZX.js";
+import "./chunk-RUSP5PJR.js";
+import "./chunk-ZPWHCABL.js";
 export {
   getContextForTask,
   getContextPromptPrefix,
@@ -25,4 +25,4 @@ export {
   selectRelevantResearch,
   summarizeContextForPrompt
 };
-//# sourceMappingURL=context-retriever-KCSSXI6X.js.map
+//# sourceMappingURL=context-retriever-5OVRAWNZ.js.map