nexus-agents 8.29.0 → 8.31.0

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

@@ -23,10 +23,10 @@ import {
   toolSuccessStructured,
   withProgressHeartbeat,
   wrapToolWithTimeout
-} from "./chunk-MEN32VJC.js";
+} from "./chunk-42LDWYPF.js";
 import {
   VERSION
-} from "./chunk-JW5IATB3.js";
+} from "./chunk-PF452UB3.js";
 import {
   assessPanelIndependence,
   countDistinctModels,
@@ -40,6 +40,7 @@ import {
   authRemediation,
   delay,
   getAvailableClis,
+  sleep,
   withTimeout
 } from "./chunk-K6PI22W5.js";
 import {
@@ -196,6 +197,66 @@ function reportPanelModelIndependence(modelIds, roleCount, phase, logger11) {
   );
 }
 
+// src/cli/voter-retry.ts
+var DEFAULT_ERRORED_ROLE_BACKOFF_MS = 3e3;
+async function retryErroredRoles(first, relaunch, logger11, backoffMs) {
+  const erroredRoles = first.filter((v) => v.source === "error").map((v) => v.role);
+  if (erroredRoles.length === 0) return first;
+  logger11.warn("Retrying errored voter roles before aggregating (#5578)", {
+    erroredRoles,
+    of: first.length
+  });
+  if (backoffMs > 0) await sleep(backoffMs);
+  const retriedResults = await relaunch(erroredRoles);
+  const recovered = /* @__PURE__ */ new Map();
+  for (const r of retriedResults) {
+    if (r.source === "error") continue;
+    recovered.set(r.role, { ...r, retried: true });
+  }
+  if (recovered.size === 0) {
+    logger11.warn("Per-role retry recovered no voter \u2014 the panel stays degraded", { erroredRoles });
+    return first;
+  }
+  logger11.info("Per-role retry recovered voters", {
+    recoveredRoles: [...recovered.keys()],
+    stillErrored: erroredRoles.filter((r) => !recovered.has(r))
+  });
+  return first.map((v) => recovered.get(v.role) ?? v);
+}
+
+// src/cli/voter-adapter-resolve.ts
+var NoAdapterError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "NoAdapterError";
+  }
+};
+function resolveAdapter(options, logger11) {
+  try {
+    if (options.adapter !== void 0) return { adapter: options.adapter };
+    const gateway = options.gatewayAdapters;
+    if (gateway !== void 0 && gateway.length > 0 && gateway[0] !== void 0) {
+      return { adapter: gateway[0] };
+    }
+    const registry = getGlobalRegistry({ logger: logger11 });
+    return { adapter: registry.getDefault() };
+  } catch (error) {
+    return { error: getErrorMessage(error) };
+  }
+}
+function resolveAdapterOrFail(options, logger11, allowSimulation) {
+  const resolved = resolveAdapter(options, logger11);
+  if (!("error" in resolved)) return resolved;
+  logger11.error("No adapter available for voting", void 0, { error: resolved.error });
+  if (allowSimulation) {
+    logger11.warn("Falling back to simulation (allowSimulation=true)");
+    return { simulated: true };
+  }
+  throw new NoAdapterError(
+    `No adapter available for voting: ${resolved.error}. Install a CLI (claude/gemini/codex) or set ANTHROPIC_API_KEY.`
+  );
+}
+
 // src/cli/voter-prompts.ts
 var DEFAULT_PROJECT = "nexus-agents";
 function prReviewModeAddendum() {
@@ -1193,25 +1254,6 @@ async function executeAgentVote(role, proposal, adapter, logger11, options) {
 ${remediation}`;
   return createErrorVoteResult(role, errorText, processingTimeMs, adapter.providerId);
 }
-var NoAdapterError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "NoAdapterError";
-  }
-};
-function resolveAdapter(options, logger11) {
-  try {
-    if (options.adapter !== void 0) return { adapter: options.adapter };
-    const gateway = options.gatewayAdapters;
-    if (gateway !== void 0 && gateway.length > 0 && gateway[0] !== void 0) {
-      return { adapter: gateway[0] };
-    }
-    const registry = getGlobalRegistry({ logger: logger11 });
-    return { adapter: registry.getDefault() };
-  } catch (error) {
-    return { error: getErrorMessage(error) };
-  }
-}
 function warnIfCodexConcurrencyExceeded(roleAdapters, logger11) {
   const codexBound = [...roleAdapters.values()].filter(
     (a) => a.name === "codex"
@@ -1343,17 +1385,8 @@ async function collectRealVotes(options) {
     logger11.info("Using simulation mode (explicitly requested)");
     return createSimulatedVotes(roles, proposal);
   }
-  const adapterResult = resolveAdapter(options, logger11);
-  if ("error" in adapterResult) {
-    logger11.error("No adapter available for voting", void 0, { error: adapterResult.error });
-    if (allowSimulation === true) {
-      logger11.warn("Falling back to simulation (allowSimulation=true)");
-      return createSimulatedVotes(roles, proposal, "No adapter available");
-    }
-    throw new NoAdapterError(
-      `No adapter available for voting: ${adapterResult.error}. Install a CLI (claude/gemini/codex) or set ANTHROPIC_API_KEY.`
-    );
-  }
+  const adapterResult = resolveAdapterOrFail(options, logger11, allowSimulation === true);
+  if ("simulated" in adapterResult) return createSimulatedVotes(roles, proposal, "No adapter available");
   const roleAdapters = options.adapter !== void 0 ? assignUniformAdapter(roles, adapterResult.adapter) : await resolveDiverseAdapters(roles, logger11, adapterResult.adapter, options.gatewayAdapters);
   warnIfCodexConcurrencyExceeded(roleAdapters, logger11);
   const voteOptions = {
@@ -1365,7 +1398,7 @@ async function collectRealVotes(options) {
     declaredOptions: options.declaredOptions
   };
   const interDelay = options.interAgentDelayMs ?? DEFAULT_INTER_AGENT_DELAY_MS;
-  const results = await launchStaggeredVotes({
+  const launchInput = {
     roles,
     proposal,
     roleAdapters,
@@ -1374,7 +1407,14 @@ async function collectRealVotes(options) {
     voteOptions,
     interDelay,
     signal: options.signal
-  });
+  };
+  const firstPass = await launchStaggeredVotes(launchInput);
+  const results = await retryErroredRoles(
+    firstPass,
+    (retryRoles) => launchStaggeredVotes({ ...launchInput, roles: retryRoles }),
+    logger11,
+    options.erroredRoleBackoffMs ?? DEFAULT_ERRORED_ROLE_BACKOFF_MS
+  );
   reportVoteIndependence(results, logger11);
   return results;
 }
@@ -5089,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(),
@@ -5114,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),
   /**
@@ -5246,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
   };
@@ -5281,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);
 }
@@ -5295,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";
@@ -5333,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(),
@@ -5349,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 } : {},
@@ -7722,4 +7806,4 @@ export {
   CONSENSUS_VOTE_TOOL_SCHEMA,
   registerConsensusVoteTool
 };
-//# sourceMappingURL=chunk-6RNUX5RK.js.map
+//# sourceMappingURL=chunk-3ZVZXXRY.js.map