nexus-agents 4.4.0 → 4.6.0

package/dist/{cli-circuit-breaker-3CH36TPE.js → cli-circuit-breaker-TJVDSJU5.js}

@@ -3,8 +3,8 @@ import {
   createCliCircuitBreakerIntegration,
   getCliCircuitBreakerSnapshot,
   getDefaultCliCircuitBreakerRegistry
-} from "./chunk-4OSPP2KN.js";
-import "./chunk-U4LM5Q2L.js";
+} from "./chunk-NMX7AYYB.js";
+import "./chunk-NH3O2D5O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -14,4 +14,4 @@ export {
   getCliCircuitBreakerSnapshot,
   getDefaultCliCircuitBreakerRegistry
 };
-//# sourceMappingURL=cli-circuit-breaker-3CH36TPE.js.map
+//# sourceMappingURL=cli-circuit-breaker-TJVDSJU5.js.map

package/dist/cli.js

@@ -13,13 +13,13 @@ import {
   generateSummary,
   parseFindings,
   sumFindings
-} from "./chunk-NKTANKWH.js";
-import "./chunk-TKFWYFBD.js";
+} from "./chunk-YY67CP2U.js";
+import "./chunk-HBGA62JG.js";
 import {
   setupCommandAsync,
   verifyCommand
-} from "./chunk-FLCUFTXF.js";
-import "./chunk-YIV4GQHK.js";
+} from "./chunk-EKS3ECXS.js";
+import "./chunk-YLESXBB3.js";
 import {
   AuthHandler,
   DEFAULT_EXPERTS,
@@ -139,8 +139,8 @@ import {
   validateCommand,
   validateWorkflow,
   wrapInMarkdownFence
-} from "./chunk-YBGX57DL.js";
-import "./chunk-SHG3MYMD.js";
+} from "./chunk-ZZED3BWY.js";
+import "./chunk-C6SAPXUV.js";
 import "./chunk-HFOQKCD2.js";
 import "./chunk-RSMG2DPB.js";
 import {
@@ -166,14 +166,14 @@ import {
   loadConfig,
   runDoctor,
   validateNexusEnv
-} from "./chunk-4KDZ4Q6B.js";
+} from "./chunk-RWI6YQXG.js";
 import {
   buildOpenAICompatAdapters,
   readOpenAICompatEnv
-} from "./chunk-SSPEB62Y.js";
+} from "./chunk-BLY3DXM2.js";
 import {
   shutdownExpertBridge
-} from "./chunk-QTP4AIVR.js";
+} from "./chunk-VRJAJUUR.js";
 import {
   ConsensusVoteInputSchema,
   DEFAULT_VOTE_TIMEOUT_MS,
@@ -183,29 +183,29 @@ import {
   executeVoting,
   mapOutcomeToDecision,
   registerConsensusVoteTool
-} from "./chunk-CFEZ2DG6.js";
+} from "./chunk-75K4TN5H.js";
 import {
   loadUsageEvents,
   rollupByModel
-} from "./chunk-Y3UJ3VLA.js";
+} from "./chunk-7Y7UFVQ5.js";
 import {
   allOf,
   anyOf
 } from "./chunk-OQB3XC5O.js";
 import {
   synthesizeResearch
-} from "./chunk-ZQWCL7YB.js";
+} from "./chunk-O32DMSG5.js";
 import {
   classifyTrust,
   createFullGitHubProvider,
   evaluatePolicy,
   parsePRUrl
-} from "./chunk-AVB5GOSW.js";
-import "./chunk-LPUJG7C6.js";
+} from "./chunk-LVE7MN2F.js";
+import "./chunk-6HSDJ5H6.js";
 import {
   ReputationCache,
   sanitizeInput
-} from "./chunk-EJLOD53Z.js";
+} from "./chunk-XCUO5YUJ.js";
 import {
   ImprovementReviewInputSchema,
   calculateFitnessScore,
@@ -219,15 +219,15 @@ import {
   registerImprovementReviewTool,
   runImprovementReview,
   scanForSecrets
-} from "./chunk-IXMTCWMN.js";
+} from "./chunk-34UKF4FB.js";
 import {
   createDefaultPolicyFirewall
-} from "./chunk-K2ZYZZNZ.js";
-import "./chunk-DFCJUKGD.js";
+} from "./chunk-ARTRA6YC.js";
+import "./chunk-EYZIMY6I.js";
 import {
   createUnifiedRegistry,
   getGlobalRegistry
-} from "./chunk-E6ET2WJI.js";
+} from "./chunk-BAWVMEXA.js";
 import {
   CodebaseIndexSchema,
   PaperStatusSchema,
@@ -253,25 +253,25 @@ import {
   loadSourcesRegistry,
   rankDiscoveredItems,
   saveSourcesRegistry
-} from "./chunk-XJORRLQT.js";
+} from "./chunk-ANTZOHQ6.js";
 import {
   loadPapersRegistry,
   loadTechniquesRegistry,
   savePapersRegistry
-} from "./chunk-VWXQHGQ2.js";
+} from "./chunk-KMUOL3AL.js";
 import "./chunk-NUBSJGQZ.js";
 import {
   resolveToken
-} from "./chunk-UI3WYJSZ.js";
+} from "./chunk-SWUYPFXS.js";
 import {
   MemoryError,
   shutdownToolMemory
-} from "./chunk-UH4MK2N7.js";
+} from "./chunk-B6DNL7LG.js";
 import {
   capitalize,
   capitalizeKebab
 } from "./chunk-6T3EPABN.js";
-import "./chunk-PG563EVI.js";
+import "./chunk-D7X2AMEB.js";
 import "./chunk-YPNQPT2F.js";
 import "./chunk-XIIUIBSX.js";
 import "./chunk-KSQSWEFH.js";
@@ -282,19 +282,19 @@ import {
   isRecord,
   probeAllClis,
   readSubprocessDepth
-} from "./chunk-RUN6KRCP.js";
-import "./chunk-QGXA25PQ.js";
+} from "./chunk-7BMK5VEO.js";
+import "./chunk-TI65NJOM.js";
 import {
   DEFAULTS
-} from "./chunk-65DZ7WHY.js";
-import "./chunk-OPH5S776.js";
+} from "./chunk-5JRYCJ37.js";
+import "./chunk-JDUTA6FI.js";
 import {
   nexusMkdtempSync
 } from "./chunk-SNJNRDKZ.js";
-import "./chunk-SPZOZGBS.js";
+import "./chunk-TD6I5UHY.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-PZSPL5KN.js";
-import "./chunk-4OSPP2KN.js";
+import "./chunk-BT6ONNFH.js";
+import "./chunk-NMX7AYYB.js";
 import {
   API_TIMEOUTS,
   AgentCapability,
@@ -368,7 +368,7 @@ import {
   validateTimeout,
   writeEmptyLine,
   writeLine
-} from "./chunk-U4LM5Q2L.js";
+} from "./chunk-NH3O2D5O.js";
 import "./chunk-2HUC6NZN.js";
 import {
   applyPortableMode,
@@ -4126,7 +4126,7 @@ ${file.patch}
         violations: policyResult.violations
       });
     }
-    const { formatReviewComment: formatReviewComment2 } = await import("./pr-reviewer-helpers-UOP4JVHI.js");
+    const { formatReviewComment: formatReviewComment2 } = await import("./pr-reviewer-helpers-KRKXKZIA.js");
     const body = formatReviewComment2(result);
     const postResult = await provider.createReview(pr.prNumber, body, result.decision);
     if (!postResult.ok) {
@@ -17598,7 +17598,7 @@ function startImprovementReviewScheduler(options) {
   let running = false;
   const runOnce = async () => {
     try {
-      const { runImprovementReview: runImprovementReview2, ImprovementReviewInputSchema: ImprovementReviewInputSchema2 } = await import("./improvement-review-I4WFQK25.js");
+      const { runImprovementReview: runImprovementReview2, ImprovementReviewInputSchema: ImprovementReviewInputSchema2 } = await import("./improvement-review-XN2GZX3V.js");
       const input = ImprovementReviewInputSchema2.parse({ fileIssues });
       const result = await runImprovementReview2(input, { logger: logger19 });
       logger19.info("Scheduled improvement_review complete", {
@@ -19655,7 +19655,7 @@ function adaptConfigToLibrary(config) {
 }
 function createBeliefPromoter() {
   return async (event) => {
-    const { getToolMemory } = await import("./tool-memory-MHP37ASX.js");
+    const { getToolMemory } = await import("./tool-memory-ACUOYCYG.js");
     const tm = getToolMemory();
     await tm.recordBelief(
       `skill:${event.name}`,
@@ -20842,7 +20842,7 @@ async function handleResearchCommand(args) {
   }
 }
 async function handleRegistryCommand(args) {
-  const { registryCommand, isValidRegistrySubcommand, formatRegistryUsage } = await import("./registry-command-EPG2X2ZI.js");
+  const { registryCommand, isValidRegistrySubcommand, formatRegistryUsage } = await import("./registry-command-2SCTKLEO.js");
   const subcommand = args.subcommand;
   if (!isValidRegistrySubcommand(subcommand)) {
     process.stdout.write(`${formatRegistryUsage()}
@@ -20890,12 +20890,12 @@ async function handleVerifyCommand(args) {
 async function handleDoctorCommand(args) {
   const exitCode = await doctorCommand({ fix: args.options.fix });
   if (args.options.deep) {
-    const { runDeepDiagnostics: runDeepDiagnostics2, formatDeepDiagnostics: formatDeepDiagnostics2 } = await import("./doctor-deep-UHFL3AE4.js");
+    const { runDeepDiagnostics: runDeepDiagnostics2, formatDeepDiagnostics: formatDeepDiagnostics2 } = await import("./doctor-deep-WI2ZC7Z3.js");
     const diag = runDeepDiagnostics2();
     process.stdout.write(formatDeepDiagnostics2(diag) + "\n");
   }
   if (args.options.live) {
-    const { runLiveReadiness, formatLiveReadiness } = await import("./doctor-live-2CGAFGFG.js");
+    const { runLiveReadiness, formatLiveReadiness } = await import("./doctor-live-W2KY3OIA.js");
     const report = await runLiveReadiness();
     process.stdout.write(formatLiveReadiness(report) + "\n");
     if (report.some((r) => r.levels.serves.status === "failed")) {
@@ -20948,7 +20948,7 @@ async function runInitPortableFlow(args) {
   return cliExit(result.success ? EXIT_CODES.SUCCESS : EXIT_CODES.SERVER_START_FAILED);
 }
 async function runInitOpencodeFlow(args) {
-  const { runInitOpencode } = await import("./init-opencode-HTSSQOLE.js");
+  const { runInitOpencode } = await import("./init-opencode-UPA3R362.js");
   const opencodePath = args.options.opencode;
   if (opencodePath === void 0 || opencodePath === "") {
     process.stderr.write("Error: --opencode requires a path argument.\n");
@@ -20974,7 +20974,7 @@ async function runInitOpencodeFlow(args) {
   return cliExit(EXIT_CODES.SUCCESS);
 }
 async function renderOpencodeValidate(opencodePath) {
-  const { runOpencodeValidate } = await import("./init-opencode-HTSSQOLE.js");
+  const { runOpencodeValidate } = await import("./init-opencode-UPA3R362.js");
   const result = await runOpencodeValidate(opencodePath);
   if (!result.ok) {
     process.stderr.write(`init --opencode --validate: ${result.reason ?? "failed"}
@@ -21013,7 +21013,7 @@ async function handleSetupCommandAsync(args) {
   return cliExitFromStatus(exitCode);
 }
 async function runCustomApiSetup(args) {
-  const { configureCustomApi } = await import("./setup-custom-api-GXF5MFBG.js");
+  const { configureCustomApi } = await import("./setup-custom-api-5TTLIPV3.js");
   const baseUrl = args.options.customApi;
   if (baseUrl === void 0) return EXIT_CODES.SERVER_START_FAILED;
   const input = {

package/dist/{composite-router-QK4OPVDX.js → composite-router-CIC4BU6A.js}

@@ -4,7 +4,7 @@ import {
   CompositeRoutingError,
   DEFAULT_COMPOSITE_CONFIG,
   createCompositeRouter
-} from "./chunk-U4LM5Q2L.js";
+} from "./chunk-NH3O2D5O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -15,4 +15,4 @@ export {
   DEFAULT_COMPOSITE_CONFIG,
   createCompositeRouter
 };
-//# sourceMappingURL=composite-router-QK4OPVDX.js.map
+//# sourceMappingURL=composite-router-CIC4BU6A.js.map

package/dist/{consensus-vote-DL4XNR7M.js → consensus-vote-77UCSVGM.js}

@@ -11,27 +11,27 @@ import {
   resetCorrelationTracker,
   runConsensusForGoal,
   unwrapVoteOrThrow
-} from "./chunk-CFEZ2DG6.js";
-import "./chunk-Y3UJ3VLA.js";
+} from "./chunk-75K4TN5H.js";
+import "./chunk-7Y7UFVQ5.js";
 import "./chunk-OQB3XC5O.js";
-import "./chunk-K2ZYZZNZ.js";
-import "./chunk-DFCJUKGD.js";
-import "./chunk-E6ET2WJI.js";
-import "./chunk-UH4MK2N7.js";
+import "./chunk-ARTRA6YC.js";
+import "./chunk-EYZIMY6I.js";
+import "./chunk-BAWVMEXA.js";
+import "./chunk-B6DNL7LG.js";
 import "./chunk-6T3EPABN.js";
-import "./chunk-PG563EVI.js";
+import "./chunk-D7X2AMEB.js";
 import "./chunk-XIIUIBSX.js";
 import "./chunk-KSQSWEFH.js";
-import "./chunk-RUN6KRCP.js";
-import "./chunk-QGXA25PQ.js";
-import "./chunk-65DZ7WHY.js";
-import "./chunk-OPH5S776.js";
+import "./chunk-7BMK5VEO.js";
+import "./chunk-TI65NJOM.js";
+import "./chunk-5JRYCJ37.js";
+import "./chunk-JDUTA6FI.js";
 import "./chunk-SNJNRDKZ.js";
-import "./chunk-SPZOZGBS.js";
+import "./chunk-TD6I5UHY.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-PZSPL5KN.js";
-import "./chunk-4OSPP2KN.js";
-import "./chunk-U4LM5Q2L.js";
+import "./chunk-BT6ONNFH.js";
+import "./chunk-NMX7AYYB.js";
+import "./chunk-NH3O2D5O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -49,4 +49,4 @@ export {
   runConsensusForGoal,
   unwrapVoteOrThrow
 };
-//# sourceMappingURL=consensus-vote-DL4XNR7M.js.map
+//# sourceMappingURL=consensus-vote-77UCSVGM.js.map

package/dist/{context-retriever-UPHWSEXA.js → context-retriever-CP72SNYZ.js}

@@ -6,18 +6,18 @@ import {
   inferTaskCategory,
   selectRelevantResearch,
   summarizeContextForPrompt
-} from "./chunk-XJORRLQT.js";
-import "./chunk-VWXQHGQ2.js";
+} from "./chunk-ANTZOHQ6.js";
+import "./chunk-KMUOL3AL.js";
 import "./chunk-NUBSJGQZ.js";
-import "./chunk-UI3WYJSZ.js";
-import "./chunk-UH4MK2N7.js";
+import "./chunk-SWUYPFXS.js";
+import "./chunk-B6DNL7LG.js";
 import "./chunk-6T3EPABN.js";
-import "./chunk-PG563EVI.js";
+import "./chunk-D7X2AMEB.js";
 import "./chunk-XIIUIBSX.js";
 import "./chunk-KSQSWEFH.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-PZSPL5KN.js";
-import "./chunk-U4LM5Q2L.js";
+import "./chunk-BT6ONNFH.js";
+import "./chunk-NH3O2D5O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -30,4 +30,4 @@ export {
   selectRelevantResearch,
   summarizeContextForPrompt
 };
-//# sourceMappingURL=context-retriever-UPHWSEXA.js.map
+//# sourceMappingURL=context-retriever-CP72SNYZ.js.map

package/dist/{doctor-deep-UHFL3AE4.js → doctor-deep-WI2ZC7Z3.js}

@@ -1,8 +1,8 @@
 import {
   formatDeepDiagnostics,
   runDeepDiagnostics
-} from "./chunk-TKFWYFBD.js";
-import "./chunk-U4LM5Q2L.js";
+} from "./chunk-HBGA62JG.js";
+import "./chunk-NH3O2D5O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -10,4 +10,4 @@ export {
   formatDeepDiagnostics,
   runDeepDiagnostics
 };
-//# sourceMappingURL=doctor-deep-UHFL3AE4.js.map
+//# sourceMappingURL=doctor-deep-WI2ZC7Z3.js.map

package/dist/{doctor-live-2CGAFGFG.js → doctor-live-W2KY3OIA.js}

@@ -1,18 +1,18 @@
 import {
   createAllAdapters,
   probeAllClis
-} from "./chunk-RUN6KRCP.js";
-import "./chunk-QGXA25PQ.js";
-import "./chunk-65DZ7WHY.js";
-import "./chunk-OPH5S776.js";
+} from "./chunk-7BMK5VEO.js";
+import "./chunk-TI65NJOM.js";
+import "./chunk-5JRYCJ37.js";
+import "./chunk-JDUTA6FI.js";
 import "./chunk-SNJNRDKZ.js";
-import "./chunk-SPZOZGBS.js";
+import "./chunk-TD6I5UHY.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-PZSPL5KN.js";
-import "./chunk-4OSPP2KN.js";
+import "./chunk-BT6ONNFH.js";
+import "./chunk-NMX7AYYB.js";
 import {
   resolveClassGuardMs
-} from "./chunk-U4LM5Q2L.js";
+} from "./chunk-NH3O2D5O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -146,4 +146,4 @@ export {
   formatLiveReadiness,
   runLiveReadiness
 };
-//# sourceMappingURL=doctor-live-2CGAFGFG.js.map
+//# sourceMappingURL=doctor-live-W2KY3OIA.js.map

package/dist/{expert-bridge-KTKJTMMO.js → expert-bridge-HGBVHVJI.js}

@@ -3,9 +3,9 @@ import {
   shutdownExpertBridge,
   tokenSplitFromUsage,
   totalTokensFromUsage
-} from "./chunk-QTP4AIVR.js";
-import "./chunk-SPZOZGBS.js";
-import "./chunk-U4LM5Q2L.js";
+} from "./chunk-VRJAJUUR.js";
+import "./chunk-TD6I5UHY.js";
+import "./chunk-NH3O2D5O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -15,4 +15,4 @@ export {
   tokenSplitFromUsage,
   totalTokensFromUsage
 };
-//# sourceMappingURL=expert-bridge-KTKJTMMO.js.map
+//# sourceMappingURL=expert-bridge-HGBVHVJI.js.map

package/dist/{factory-SC3N2RMX.js → factory-GEBBVQHZ.js}

@@ -3,16 +3,16 @@ import {
   createCliAdapter,
   getAvailableClis,
   isCliAvailable
-} from "./chunk-RUN6KRCP.js";
-import "./chunk-QGXA25PQ.js";
-import "./chunk-65DZ7WHY.js";
-import "./chunk-OPH5S776.js";
+} from "./chunk-7BMK5VEO.js";
+import "./chunk-TI65NJOM.js";
+import "./chunk-5JRYCJ37.js";
+import "./chunk-JDUTA6FI.js";
 import "./chunk-SNJNRDKZ.js";
-import "./chunk-SPZOZGBS.js";
+import "./chunk-TD6I5UHY.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-PZSPL5KN.js";
-import "./chunk-4OSPP2KN.js";
-import "./chunk-U4LM5Q2L.js";
+import "./chunk-BT6ONNFH.js";
+import "./chunk-NMX7AYYB.js";
+import "./chunk-NH3O2D5O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -22,4 +22,4 @@ export {
   getAvailableClis,
   isCliAvailable
 };
-//# sourceMappingURL=factory-SC3N2RMX.js.map
+//# sourceMappingURL=factory-GEBBVQHZ.js.map

package/dist/{factory-QQKY3UW4.js → factory-LEYEWZ4Y.js}

@@ -1,10 +1,10 @@
 import {
   createGitHubProvider,
   createScmProvider
-} from "./chunk-6DLKK5R2.js";
-import "./chunk-LPUJG7C6.js";
-import "./chunk-UI3WYJSZ.js";
-import "./chunk-U4LM5Q2L.js";
+} from "./chunk-ESWY4Y7S.js";
+import "./chunk-6HSDJ5H6.js";
+import "./chunk-SWUYPFXS.js";
+import "./chunk-NH3O2D5O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -12,4 +12,4 @@ export {
   createGitHubProvider,
   createScmProvider
 };
-//# sourceMappingURL=factory-QQKY3UW4.js.map
+//# sourceMappingURL=factory-LEYEWZ4Y.js.map

package/dist/{improvement-review-I4WFQK25.js → improvement-review-XN2GZX3V.js}

@@ -11,10 +11,10 @@ import {
   loadSelfEvalSignals,
   registerImprovementReviewTool,
   runImprovementReview
-} from "./chunk-IXMTCWMN.js";
-import "./chunk-K2ZYZZNZ.js";
-import "./chunk-DFCJUKGD.js";
-import "./chunk-U4LM5Q2L.js";
+} from "./chunk-34UKF4FB.js";
+import "./chunk-ARTRA6YC.js";
+import "./chunk-EYZIMY6I.js";
+import "./chunk-NH3O2D5O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -32,4 +32,4 @@ export {
   registerImprovementReviewTool,
   runImprovementReview
 };
-//# sourceMappingURL=improvement-review-I4WFQK25.js.map
+//# sourceMappingURL=improvement-review-XN2GZX3V.js.map

package/dist/index.d.ts

@@ -9550,6 +9550,20 @@ interface AggregationMetadata {
      * not zero.
      */
     unmeasuredResults?: number;
+    /**
+     * Whether `averageConfidence` is a measurement (#4831).
+     *
+     * `false` means no contributor carried a confidence signal, so
+     * `averageConfidence` is a placeholder `0` and NOT a score — a session whose
+     * confidence was never assessed must not read as a confident one. The
+     * collaboration-session builder is in that position: `TaskResult` has no
+     * confidence field, while the `ResultAggregator` path computes the value
+     * from `ExpertResult.confidence`.
+     *
+     * Absent means the producer predates the distinction — unknown, not
+     * measured. Mirrors `ResultMetadata.tokensMeasured` (#4734).
+     */
+    confidenceMeasured?: boolean;
     aggregatedAt: string;
 }
 /**
@@ -11169,15 +11183,44 @@ interface AdaptiveProtocolConfig {
  * Selection result with metadata.
  */
 interface SelectionResult$2 {
-    /** Selected protocol pattern */
+    /**
+     * The pattern that will be used.
+     *
+     * This is always `config.pattern`. `CollaborationPattern` has no `auto`
+     * member, so a caller cannot ask for adaptive selection and adaptation can
+     * never win — see {@link adaptivePattern} for what it would have chosen
+     * (#4833).
+     */
     readonly pattern: CollaborationPattern;
-    /** Classification that led to selection */
+    /**
+     * The pattern adaptation would choose from the task classification (#4833).
+     *
+     * Advisory. Previously computed and discarded, which left the caller unable
+     * to see the one thing this class exists to produce.
+     */
+    readonly adaptivePattern: CollaborationPattern;
+    /** Classification that led to {@link adaptivePattern}. */
     readonly classification: ClassificationResult;
-    /** Whether an explicit override was applied */
+    /**
+     * Whether the caller's pattern differs from {@link adaptivePattern}.
+     *
+     * A comparison, NOT evidence that a selection was applied and then
+     * overridden — nothing is applied. It was logged as though a live decision
+     * had been made and reversed (#4833).
+     */
     readonly wasOverridden: boolean;
 }
 /**
- * Adaptive protocol selector that chooses protocols based on task type.
+ * Adaptive protocol selector that classifies tasks and recommends protocols.
+ *
+ * Advisory: `selectProtocol` cannot change the protocol in use, because
+ * `CollaborationPattern` has no `auto` member and so a caller has no way to
+ * defer to adaptation. `getRecommendation` reports what adaptation would
+ * choose; acting on it is the caller's decision.
+ *
+ * Whether to add that sentinel so adaptation can win is #4833. Its named
+ * consumer is `TechLeadCollaboration.executeCollaboration`, which currently
+ * declines the recommendation on purpose.
  */
 declare class AdaptiveProtocolSelector {
     private readonly factory;
@@ -11186,10 +11229,14 @@ declare class AdaptiveProtocolSelector {
     private readonly log;
     constructor(config?: AdaptiveProtocolConfig);
     /**
-     * Select the optimal protocol for a task.
+     * Classify a task and report which protocol adaptation would choose.
+     *
+     * The returned `pattern` is always `config.pattern`: `CollaborationPattern`
+     * has no `auto` member, so there is no way for a caller to defer to
+     * adaptation. `adaptivePattern` carries the advisory choice (#4833).
      *
-     * @param config - Collaboration config (pattern may be overridden)
-     * @returns Selection result with chosen pattern and reasoning
+     * @param config - Collaboration config; its `pattern` is always honoured
+     * @returns The pattern in use, the advisory choice, and the classification
      */
     selectProtocol(config: CollaborationConfig): SelectionResult$2;
     /**
@@ -11204,9 +11251,11 @@ declare class AdaptiveProtocolSelector {
      */
     execute(config: CollaborationConfig, agents: Map<string, IAgent>): Promise<Result<CollaborationResult, AgentError$1>>;
     /**
-     * Get recommended protocol for a task without executing.
+     * Get the recommended protocol for a task without executing.
      *
-     * Useful for preview/explanation of what protocol would be selected.
+     * Returns the *adaptive* choice. It previously returned `selection.pattern`
+     * — the caller's own input — so the "recommendation" echoed the question
+     * back with reasoning attached that read as an answer (#4833).
      */
     getRecommendation(config: CollaborationConfig): {
         recommendedPattern: CollaborationPattern;