nexus-agents 8.30.0 → 8.31.0

package/dist/{chunk-ILBCNOV6.js → chunk-3ZVZXXRY.js}

@@ -23,10 +23,10 @@ import {
   toolSuccessStructured,
   withProgressHeartbeat,
   wrapToolWithTimeout
-} from "./chunk-GG6OKZY4.js";
+} from "./chunk-42LDWYPF.js";
 import {
   VERSION
-} from "./chunk-ZON73IQM.js";
+} from "./chunk-PF452UB3.js";
 import {
   assessPanelIndependence,
   countDistinctModels,
@@ -5129,10 +5129,33 @@ var VoteRecordPanelCoverageSchema = z7.object({
   /** The roles behind `errored`, in panel order. */
   erroredRoles: z7.array(z7.string().min(1).max(100))
 }).strict();
+var MAX_VOTER_REASONING_CHARS = 2e4;
 var VoterSummarySchema = z7.object({
   role: z7.string().min(1).max(100),
   decision: z7.enum(["approve", "reject", "abstain"]),
-  confidence: z7.number().min(0).max(1)
+  confidence: z7.number().min(0).max(1),
+  /**
+   * The voter's stated grounds (#5373, schema 1.6).
+   *
+   * `generateVoteHash` already hashed `{role, decision, reasoning}` and then
+   * discarded the text, so the chain attested to a value it did not store and
+   * nobody could re-verify the hash without re-obtaining the reasoning. On
+   * #5228 a contrarian rejection was clipped mid-sentence in the terminal, the
+   * grounds were unrecoverable, and the same defect resurfaced a round later —
+   * one round of a 7-voter panel is 7-13 minutes of model time, and the
+   * objection was right both times.
+   *
+   * Stored whole rather than sampled. Warn-mode near-misses are emitted per
+   * TOOL CALL, thousands a day; votes are emitted per PANEL, dozens a day at
+   * most, so ~17 KB per vote is not the same growth problem.
+   *
+   * Absence is not an empty argument: an errored voter has no entry in
+   * `voters` at all (see `panelCoverage`), so `reasoning: ''` means a live
+   * voter returned nothing, which is itself a signal.
+   */
+  reasoning: z7.string().max(MAX_VOTER_REASONING_CHARS).optional(),
+  /** True when `reasoning` was clipped to {@link MAX_VOTER_REASONING_CHARS}. */
+  reasoningTruncated: z7.literal(true).optional()
 }).strict();
 var VoteRecordCountsSchema = z7.object({
   approve: z7.number().int().nonnegative(),
@@ -5154,7 +5177,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", "1.3", "1.4", "1.5"]),
+  version: z7.enum(["1.1", "1.2", "1.3", "1.4", "1.5", "1.6"]),
   /** Unique record id (also usable as a `ratificationVoteRef`). */
   id: z7.string().min(1),
   /**
@@ -5286,10 +5309,17 @@ function computeVoteRecordHash(payload) {
       abstain: payload.voteCounts.abstain,
       total: payload.voteCounts.total
     },
+    // `reasoning` / `reasoningTruncated` (#5373, schema 1.6) are appended per
+    // entry ONLY when present, on the same rule as the record-level optional
+    // fields: a pre-1.6 voter entry re-hashes byte-identical, so every
+    // historical record still verifies, while editing or removing a stored
+    // reasoning flips the hash.
     voters: payload.voters.map((v) => ({
       role: v.role,
       decision: v.decision,
-      confidence: v.confidence
+      confidence: v.confidence,
+      ...v.reasoning !== void 0 ? { reasoning: v.reasoning } : {},
+      ...v.reasoningTruncated === true ? { reasoningTruncated: true } : {}
     })),
     correlationId: payload.correlationId ?? null
   };
@@ -5321,10 +5351,22 @@ function toVoterSummaries(votes) {
   for (const v of votes) {
     if (v.source === "error") continue;
     const vote = v.vote;
-    summaries.push({ role: v.role, decision: vote.decision, confidence: vote.confidence });
+    summaries.push({
+      role: v.role,
+      decision: vote.decision,
+      confidence: vote.confidence,
+      ...reasoningFields(vote.reasoning)
+    });
   }
   return summaries;
 }
+function reasoningFields(reasoning) {
+  if (reasoning.length <= MAX_VOTER_REASONING_CHARS) return { reasoning };
+  return {
+    reasoning: reasoning.slice(0, MAX_VOTER_REASONING_CHARS),
+    reasoningTruncated: true
+  };
+}
 function recordDecisionFor(input) {
   return input.resolvedDecision ?? outcomeToDecision(input.result, input.votes, input.errorVoided ?? false);
 }
@@ -5335,7 +5377,8 @@ function deriveOptionFields(votes) {
     optionCoverage: optionTally === void 0 ? void 0 : coverageOf(votes)
   };
 }
-function recordVersion(optionTally, optionCoverage, panelCoverage) {
+function recordVersion(optionTally, optionCoverage, panelCoverage, voters) {
+  if (voters.some((v) => v.reasoning !== void 0)) return "1.6";
   if (panelCoverage !== void 0) return "1.5";
   if (optionCoverage !== void 0) return "1.4";
   return optionTally !== void 0 ? "1.3" : "1.2";
@@ -5373,8 +5416,9 @@ function buildVoteRecord(input) {
   const proposalTruncated = input.proposal.length > MAX_PROPOSAL_RECORD_CHARS ? input.proposal.slice(0, MAX_PROPOSAL_RECORD_CHARS) + "..." : input.proposal;
   const { optionTally, optionCoverage } = deriveOptionFields(input.votes);
   const panelCoverage = panelCoverageOf(input.votes);
+  const voters = toVoterSummaries(input.votes);
   const payload = {
-    version: recordVersion(optionTally, optionCoverage, panelCoverage),
+    version: recordVersion(optionTally, optionCoverage, panelCoverage, voters),
     id: input.id,
     sequence: input.sequence ?? 0,
     recordedAt: input.recordedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
@@ -5389,7 +5433,7 @@ function buildVoteRecord(input) {
       abstain: input.result.voteCounts.abstain,
       total: input.result.voteCounts.total
     },
-    voters: toVoterSummaries(input.votes),
+    voters,
     ...input.correlationId !== void 0 ? { correlationId: input.correlationId } : {},
     ...input.ratifies !== void 0 ? { ratifies: input.ratifies } : {},
     ...optionTally !== void 0 ? { optionTally } : {},
@@ -7762,4 +7806,4 @@ export {
   CONSENSUS_VOTE_TOOL_SCHEMA,
   registerConsensusVoteTool
 };
-//# sourceMappingURL=chunk-ILBCNOV6.js.map
+//# sourceMappingURL=chunk-3ZVZXXRY.js.map