nexus-agents 3.1.0 → 3.2.0

package/dist/{chunk-4UN4M4NI.js → chunk-5NRFPUNP.js}

@@ -4321,12 +4321,14 @@ function getDefaultErrorPolicy(strategy) {
   return "reduce_denominator";
 }
 var ConsensusVoteInputSchema = z6.object({
-  proposal: z6.string().min(1).max(MAX_PROPOSAL_LENGTH).describe("Proposal text to vote on"),
+  proposal: z6.string().min(1).max(MAX_PROPOSAL_LENGTH).describe(
+    "Proposal text to vote on. IMPORTANT (#4452): the tally records approve/reject/abstain ONLY. If your proposal asks voters to choose among named options (A/B/C), every voter who engages returns `approve`, so the result records as unanimous even when the panel disagreed about WHICH option \u2014 a 6-1 split persists as 7-0, 100%. Threshold semantics invert too: `unanimous` becomes trivially easy to clear, because everyone approves while choosing different things. Prefer a single yes/no question; if you must offer options, read each voter's `reasoning` to recover the real split and do NOT report the recorded percentage as agreement."
+  ),
   threshold: VoteThresholdSchema.optional().describe(
     "Voting threshold (legacy): majority, supermajority, unanimous. Use strategy instead."
   ),
   strategy: VotingStrategySchema.optional().describe(
-    "Voting strategy: simple_majority (default), supermajority, unanimous, proof_of_learning, or higher_order (Bayesian-optimal)"
+    "Voting strategy: simple_majority (default), supermajority, unanimous, proof_of_learning, or higher_order (Bayesian-optimal). NOTE (#4452): thresholds are evaluated over approve/reject/abstain, not over which option a voter chose. On a multi-option proposal even `unanimous` clears trivially \u2014 see the `proposal` field description."
   ),
   errorPolicy: ErrorPolicySchema.optional().describe(
     "How to treat voters that errored or timed out (#2630). Default: fail_closed for unanimous only; reduce_denominator for all other strategies incl. higher_order/opinion_wise (#3138 \u2014 a single infra timeout should not void an otherwise-unanimous vote). Opt-in absolute_quorum (#4132): an errored voter \u2014 especially the contrarian (catfish) \u2014 degrades the verdict to no_quorum (recoverable re-run) instead of being dropped from the denominator; never manufactures approved/rejected from an induced error. Regardless of policy, errors > 50% always fails."
@@ -4589,6 +4591,12 @@ var VoteRecordCountsSchema = z7.object({
   abstain: z7.number().int().nonnegative(),
   total: z7.number().int().nonnegative()
 }).strict();
+var VoteRecordOptionCountSchema = z7.object({
+  /** The option label as declared in the proposal (e.g. 'A'). */
+  option: z7.string().min(1),
+  /** How many voters selected it. */
+  count: z7.number().int().nonnegative()
+}).strict();
 var VoteRecordSchema = z7.object({
   /**
    * Schema version. '1.1' marked the chain→record-set+sequence model (#3927);
@@ -4597,7 +4605,7 @@ var VoteRecordSchema = z7.object({
    * `ratifies` is folded into the self-hash ONLY when present (see
    * {@link computeVoteRecordHash}).
    */
-  version: z7.enum(["1.1", "1.2"]),
+  version: z7.enum(["1.1", "1.2", "1.3"]),
   /** Unique record id (also usable as a `ratificationVoteRef`). */
   id: z7.string().min(1),
   /**
@@ -4637,6 +4645,20 @@ var VoteRecordSchema = z7.object({
   voters: z7.array(VoterSummarySchema),
   /** Optional correlation/decision id linking to the cost rollup / trace. */
   correlationId: z7.string().min(1).optional(),
+  /**
+   * Per-option distribution for a multi-option proposal (#4452, schema 1.3).
+   *
+   * Present only when the vote declared `options`. Absent on an ordinary
+   * yes/no vote, and absent on every 1.1/1.2 record — which is why it is
+   * folded into the self-hash ONLY when present (see
+   * {@link computeVoteRecordHash}), exactly as `ratifies` was.
+   *
+   * Without this, a 6-1 or 5-2 option split is recorded as `approve: 7` and
+   * reads as unanimous. Threshold semantics invert too: `unanimous` becomes
+   * the EASIEST bar to clear, because every engaged voter approves while
+   * choosing different things.
+   */
+  optionTally: z7.array(VoteRecordOptionCountSchema).min(1).optional(),
   /**
    * The loop/strategy subject this vote RATIFIES (#3927 item 1). Present only on
    * a ratification vote; set at vote time and bound into the self-hash (so it is
@@ -4682,8 +4704,12 @@ function computeVoteRecordHash(payload) {
     })),
     correlationId: payload.correlationId ?? null
   };
+  const withTally = payload.optionTally !== void 0 ? {
+    ...base,
+    optionTally: payload.optionTally.map((o) => ({ option: o.option, count: o.count }))
+  } : base;
   const canonical = JSON.stringify(
-    payload.ratifies !== void 0 ? { ...base, ratifies: payload.ratifies } : base
+    payload.ratifies !== void 0 ? { ...withTally, ratifies: payload.ratifies } : withTally
   );
   return crypto.createHash("sha256").update(canonical).digest("hex");
 }
@@ -4715,10 +4741,20 @@ function toVoterSummaries(votes) {
   }
   return summaries;
 }
+function tallySelectedOptions(votes) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const v of votes) {
+    if (v.selectedOption === void 0) continue;
+    counts.set(v.selectedOption, (counts.get(v.selectedOption) ?? 0) + 1);
+  }
+  if (counts.size === 0) return void 0;
+  return [...counts.entries()].map(([option, count]) => ({ option, count })).sort((a, b) => b.count !== a.count ? b.count - a.count : a.option.localeCompare(b.option));
+}
 function buildVoteRecord(input) {
   const proposalTruncated = input.proposal.length > MAX_PROPOSAL_RECORD_CHARS ? input.proposal.slice(0, MAX_PROPOSAL_RECORD_CHARS) + "..." : input.proposal;
+  const optionTally = tallySelectedOptions(input.votes);
   const payload = {
-    version: "1.2",
+    version: optionTally !== void 0 ? "1.3" : "1.2",
     id: input.id,
     sequence: input.sequence ?? 0,
     recordedAt: input.recordedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
@@ -4736,6 +4772,7 @@ function buildVoteRecord(input) {
     voters: toVoterSummaries(input.votes),
     ...input.correlationId !== void 0 ? { correlationId: input.correlationId } : {},
     ...input.ratifies !== void 0 ? { ratifies: input.ratifies } : {},
+    ...optionTally !== void 0 ? { optionTally } : {},
     ...input.previousHash !== void 0 ? { previousHash: input.previousHash } : {}
   };
   return { ...payload, hash: computeVoteRecordHash(payload) };
@@ -6359,7 +6396,7 @@ var CONSENSUS_VOTE_TOOL_SCHEMA = {
     "Authority-tier ratification subject (#4004) \u2014 the loop/strategy id this vote ratifies for an authority-ladder promotion. Bound into the authentic vote record so the promotion gate can verify it. Omit for ordinary votes."
   )
 };
-var CONSENSUS_VOTE_DESCRIPTION = "Execute multi-model consensus voting on a proposal. Uses 7 roles by default (architect, security, devex, ai_ml, pm, catfish, scope_steward) or 3 with quickMode (architect, security, scope_steward), voting with configurable strategies. Supports higher_order strategy for Bayesian-optimal aggregation with correlation awareness (Issue #514). Supports async mode (mode: 'async') \u2014 returns a jobId to poll via get_job_result. Pass ratifies=<subject> to bind an authority-ladder ratification vote into its authentic record.";
+var CONSENSUS_VOTE_DESCRIPTION = "Execute multi-model consensus voting on a proposal. Uses 7 roles by default (architect, security, devex, ai_ml, pm, catfish, scope_steward) or 3 with quickMode (architect, security, scope_steward), voting with configurable strategies. Supports higher_order strategy for Bayesian-optimal aggregation with correlation awareness (Issue #514). Supports async mode (mode: 'async') \u2014 returns a jobId to poll via get_job_result. Pass ratifies=<subject> to bind an authority-ladder ratification vote into its authentic record. CAVEAT (#4452): the tally is approve/reject/abstain only. A proposal that asks voters to pick among named options records as unanimous even when they picked DIFFERENT options \u2014 recover the real split from each voter's reasoning, and do not report the percentage as agreement.";
 function registerConsensusVoteTool(server, deps) {
   const logger10 = deps.logger ?? createLogger({ tool: "consensus_vote" });
   const notifier = deps.notifier ?? createMcpNotifier(server);
@@ -6466,4 +6503,4 @@ export {
   CONSENSUS_VOTE_OUTPUT_SCHEMA,
   registerConsensusVoteTool
 };
-//# sourceMappingURL=chunk-4UN4M4NI.js.map
+//# sourceMappingURL=chunk-5NRFPUNP.js.map