nexus-agents 2.63.1 → 2.63.2

package/dist/{chunk-RIMON2SA.js → chunk-PEDEZRPR.js}

@@ -8082,7 +8082,9 @@ var ConsensusVoteInputSchema = z8.object({
     "Voting strategy: simple_majority (default), supermajority, unanimous, proof_of_learning, or higher_order (Bayesian-optimal)"
   ),
   quickMode: z8.boolean().optional().default(false).describe("Use 3 agents instead of 5 for faster execution"),
-  simulateVotes: z8.boolean().optional().default(false).describe("Use simulated votes instead of LLM execution")
+  simulateVotes: z8.boolean().optional().default(false).describe(
+    "TESTS ONLY \u2014 when true, voters return random decisions. Output must not be used for real decisions. (#2319)"
+  )
 });
 function toAgentVoteSummary(result) {
   const roleName = VOTER_ROLES[result.role].split(" - ")[0] ?? result.role;
@@ -12638,6 +12640,11 @@ function emitTrendDetected(bus, detail) {
 // src/mcp/tools/consensus-vote-recording.ts
 var logger10 = createLogger({ tool: "consensus-vote" });
 function recordVoteSuccess(proposal, strategy, outcome, duration, votes) {
+  const allSimulated = votes !== void 0 && votes.length > 0 && votes.every((v) => v.source === "simulation");
+  if (allSimulated) {
+    logger10.debug("Skipping memory + outcome recording \u2014 all votes simulated");
+    return;
+  }
   try {
     const memory = getToolMemory();
     memory.recordTask({
@@ -12701,6 +12708,20 @@ function recordVoteOutcomes(votes) {
   }
 }
 
+// src/mcp/tools/simulation-guard.ts
+var WARNED = /* @__PURE__ */ new Set();
+function isTestRunner() {
+  return process.env.VITEST === "true" || process.env.NODE_ENV === "test";
+}
+function warnIfSimulatedOutsideTests(toolName, logger11) {
+  if (isTestRunner()) return;
+  if (WARNED.has(toolName)) return;
+  WARNED.add(toolName);
+  logger11.warn(
+    `[${toolName}] simulateVotes=true: output is RANDOM and reserved for tests/demos. Do not treat the result as a real decision.`
+  );
+}
+
 // src/mcp/tools/consensus-vote.ts
 var persistentCorrelationTracker;
 function getOrCreateCorrelationTracker() {
@@ -12933,6 +12954,7 @@ async function executeVoting(input, logger11) {
 }
 async function handleConsensusVote(deps, args) {
   const logger11 = deps.logger ?? createLogger({ tool: "consensus_vote" });
+  if (args.simulateVotes) warnIfSimulatedOutsideTests("consensus_vote", logger11);
   try {
     const result = await executeVoting(args, logger11);
     const strategy = args.strategy ?? "simple_majority";
@@ -13065,7 +13087,7 @@ function registerConsensusVoteTool(server, deps) {
       "Voting strategy: simple_majority (default), supermajority, unanimous, proof_of_learning, or higher_order"
     ),
     quickMode: z19.boolean().optional().default(false).describe("Use 3 agents instead of 7"),
-    simulateVotes: z19.boolean().optional().default(false).describe("Use simulated votes")
+    simulateVotes: z19.boolean().optional().default(false).describe("TESTS ONLY \u2014 random output, must not be used for real decisions (#2319)")
   };
   const description = "Execute multi-model consensus voting on a proposal. Uses 7 specialized agent roles (architect, security, devex, ai_ml, pm, catfish, scope_steward) to vote on proposals with configurable strategies. Supports higher_order strategy for Bayesian-optimal aggregation with correlation awareness (Issue #514).";
   const secureHandler = createSecureHandler(createConsensusVoteHandler(depsWithNotifier), {
@@ -13224,9 +13246,10 @@ export {
   createCorrelationTracker,
   VotingStrategySchema,
   ConsensusVoteInputSchema,
+  warnIfSimulatedOutsideTests,
   resetCorrelationTracker,
   executeVoting,
   CONSENSUS_VOTE_OUTPUT_SCHEMA,
   registerConsensusVoteTool
 };
-//# sourceMappingURL=chunk-RIMON2SA.js.map
+//# sourceMappingURL=chunk-PEDEZRPR.js.map