nexus-agents 4.5.1 → 4.7.0

package/dist/cli.js

@@ -13,13 +13,13 @@ import {
   generateSummary,
   parseFindings,
   sumFindings
-} from "./chunk-YY67CP2U.js";
-import "./chunk-HBGA62JG.js";
+} from "./chunk-HCGUPBE3.js";
+import "./chunk-YMGPOFK3.js";
 import {
   setupCommandAsync,
   verifyCommand
-} from "./chunk-QNT5WS7E.js";
-import "./chunk-YLESXBB3.js";
+} from "./chunk-LPPAXDV6.js";
+import "./chunk-ND3KSSGU.js";
 import {
   AuthHandler,
   DEFAULT_EXPERTS,
@@ -139,8 +139,8 @@ import {
   validateCommand,
   validateWorkflow,
   wrapInMarkdownFence
-} from "./chunk-CGJPW5BI.js";
-import "./chunk-C6SAPXUV.js";
+} from "./chunk-H44SVOTG.js";
+import "./chunk-HHRASHK4.js";
 import "./chunk-HFOQKCD2.js";
 import "./chunk-RSMG2DPB.js";
 import {
@@ -166,14 +166,14 @@ import {
   loadConfig,
   runDoctor,
   validateNexusEnv
-} from "./chunk-EPD5MGPB.js";
+} from "./chunk-PBSANZII.js";
 import {
   buildOpenAICompatAdapters,
   readOpenAICompatEnv
-} from "./chunk-BLY3DXM2.js";
+} from "./chunk-7MPLZ73P.js";
 import {
   shutdownExpertBridge
-} from "./chunk-VRJAJUUR.js";
+} from "./chunk-Y6C2VF2R.js";
 import {
   ConsensusVoteInputSchema,
   DEFAULT_VOTE_TIMEOUT_MS,
@@ -183,29 +183,29 @@ import {
   executeVoting,
   mapOutcomeToDecision,
   registerConsensusVoteTool
-} from "./chunk-75K4TN5H.js";
+} from "./chunk-HGN5BYOW.js";
 import {
   loadUsageEvents,
   rollupByModel
-} from "./chunk-7Y7UFVQ5.js";
+} from "./chunk-AOW5WVTT.js";
 import {
   allOf,
   anyOf
 } from "./chunk-OQB3XC5O.js";
 import {
   synthesizeResearch
-} from "./chunk-O32DMSG5.js";
+} from "./chunk-BYEBHNRS.js";
 import {
   classifyTrust,
   createFullGitHubProvider,
   evaluatePolicy,
   parsePRUrl
-} from "./chunk-LVE7MN2F.js";
-import "./chunk-6HSDJ5H6.js";
+} from "./chunk-GRWQU4XB.js";
+import "./chunk-V7EMWUUM.js";
 import {
   ReputationCache,
   sanitizeInput
-} from "./chunk-XCUO5YUJ.js";
+} from "./chunk-6KPEN5OE.js";
 import {
   ImprovementReviewInputSchema,
   calculateFitnessScore,
@@ -219,15 +219,15 @@ import {
   registerImprovementReviewTool,
   runImprovementReview,
   scanForSecrets
-} from "./chunk-34UKF4FB.js";
+} from "./chunk-7M566K5K.js";
 import {
   createDefaultPolicyFirewall
-} from "./chunk-ARTRA6YC.js";
-import "./chunk-EYZIMY6I.js";
+} from "./chunk-RHQNFMUW.js";
+import "./chunk-RQ3F7KRP.js";
 import {
   createUnifiedRegistry,
   getGlobalRegistry
-} from "./chunk-BAWVMEXA.js";
+} from "./chunk-FOBKXJMS.js";
 import {
   CodebaseIndexSchema,
   PaperStatusSchema,
@@ -253,25 +253,25 @@ import {
   loadSourcesRegistry,
   rankDiscoveredItems,
   saveSourcesRegistry
-} from "./chunk-ANTZOHQ6.js";
+} from "./chunk-RFXPWYM5.js";
 import {
   loadPapersRegistry,
   loadTechniquesRegistry,
   savePapersRegistry
-} from "./chunk-KMUOL3AL.js";
+} from "./chunk-YAB5NYKM.js";
 import "./chunk-NUBSJGQZ.js";
 import {
   resolveToken
-} from "./chunk-SWUYPFXS.js";
+} from "./chunk-ZTQ4CHPG.js";
 import {
   MemoryError,
   shutdownToolMemory
-} from "./chunk-B6DNL7LG.js";
+} from "./chunk-YNWIXCPW.js";
 import {
   capitalize,
   capitalizeKebab
 } from "./chunk-6T3EPABN.js";
-import "./chunk-D7X2AMEB.js";
+import "./chunk-3QC3IWRP.js";
 import "./chunk-YPNQPT2F.js";
 import "./chunk-XIIUIBSX.js";
 import "./chunk-KSQSWEFH.js";
@@ -282,19 +282,19 @@ import {
   isRecord,
   probeAllClis,
   readSubprocessDepth
-} from "./chunk-7BMK5VEO.js";
-import "./chunk-TI65NJOM.js";
+} from "./chunk-7U5E7DJV.js";
+import "./chunk-2ZO74IO7.js";
 import {
   DEFAULTS
-} from "./chunk-5JRYCJ37.js";
-import "./chunk-JDUTA6FI.js";
+} from "./chunk-M5QKVRNH.js";
+import "./chunk-S2BYGZIM.js";
 import {
   nexusMkdtempSync
 } from "./chunk-SNJNRDKZ.js";
-import "./chunk-TD6I5UHY.js";
+import "./chunk-2MIG56ZD.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-BT6ONNFH.js";
-import "./chunk-NMX7AYYB.js";
+import "./chunk-SWRXPVUQ.js";
+import "./chunk-GBIL6A6D.js";
 import {
   API_TIMEOUTS,
   AgentCapability,
@@ -368,7 +368,7 @@ import {
   validateTimeout,
   writeEmptyLine,
   writeLine
-} from "./chunk-NH3O2D5O.js";
+} from "./chunk-C2DQXCIZ.js";
 import "./chunk-2HUC6NZN.js";
 import {
   applyPortableMode,
@@ -4126,7 +4126,7 @@ ${file.patch}
         violations: policyResult.violations
       });
     }
-    const { formatReviewComment: formatReviewComment2 } = await import("./pr-reviewer-helpers-KRKXKZIA.js");
+    const { formatReviewComment: formatReviewComment2 } = await import("./pr-reviewer-helpers-ISHVOYNB.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-XN2GZX3V.js");
+      const { runImprovementReview: runImprovementReview2, ImprovementReviewInputSchema: ImprovementReviewInputSchema2 } = await import("./improvement-review-LTOEMHMZ.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-ACUOYCYG.js");
+    const { getToolMemory } = await import("./tool-memory-7NB5XYL3.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-2SCTKLEO.js");
+  const { registryCommand, isValidRegistrySubcommand, formatRegistryUsage } = await import("./registry-command-ULIA5J5H.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-WI2ZC7Z3.js");
+    const { runDeepDiagnostics: runDeepDiagnostics2, formatDeepDiagnostics: formatDeepDiagnostics2 } = await import("./doctor-deep-YB52D552.js");
     const diag = runDeepDiagnostics2();
     process.stdout.write(formatDeepDiagnostics2(diag) + "\n");
   }
   if (args.options.live) {
-    const { runLiveReadiness, formatLiveReadiness } = await import("./doctor-live-W2KY3OIA.js");
+    const { runLiveReadiness, formatLiveReadiness } = await import("./doctor-live-YCCSYF5X.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-UPA3R362.js");
+  const { runInitOpencode } = await import("./init-opencode-ITKHZXYC.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-UPA3R362.js");
+  const { runOpencodeValidate } = await import("./init-opencode-ITKHZXYC.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-5TTLIPV3.js");
+  const { configureCustomApi } = await import("./setup-custom-api-WTUJWZK7.js");
   const baseUrl = args.options.customApi;
   if (baseUrl === void 0) return EXIT_CODES.SERVER_START_FAILED;
   const input = {

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

@@ -4,7 +4,7 @@ import {
   CompositeRoutingError,
   DEFAULT_COMPOSITE_CONFIG,
   createCompositeRouter
-} from "./chunk-NH3O2D5O.js";
+} from "./chunk-C2DQXCIZ.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-CIC4BU6A.js.map
+//# sourceMappingURL=composite-router-WBT2V32V.js.map

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

@@ -11,27 +11,27 @@ import {
   resetCorrelationTracker,
   runConsensusForGoal,
   unwrapVoteOrThrow
-} from "./chunk-75K4TN5H.js";
-import "./chunk-7Y7UFVQ5.js";
+} from "./chunk-HGN5BYOW.js";
+import "./chunk-AOW5WVTT.js";
 import "./chunk-OQB3XC5O.js";
-import "./chunk-ARTRA6YC.js";
-import "./chunk-EYZIMY6I.js";
-import "./chunk-BAWVMEXA.js";
-import "./chunk-B6DNL7LG.js";
+import "./chunk-RHQNFMUW.js";
+import "./chunk-RQ3F7KRP.js";
+import "./chunk-FOBKXJMS.js";
+import "./chunk-YNWIXCPW.js";
 import "./chunk-6T3EPABN.js";
-import "./chunk-D7X2AMEB.js";
+import "./chunk-3QC3IWRP.js";
 import "./chunk-XIIUIBSX.js";
 import "./chunk-KSQSWEFH.js";
-import "./chunk-7BMK5VEO.js";
-import "./chunk-TI65NJOM.js";
-import "./chunk-5JRYCJ37.js";
-import "./chunk-JDUTA6FI.js";
+import "./chunk-7U5E7DJV.js";
+import "./chunk-2ZO74IO7.js";
+import "./chunk-M5QKVRNH.js";
+import "./chunk-S2BYGZIM.js";
 import "./chunk-SNJNRDKZ.js";
-import "./chunk-TD6I5UHY.js";
+import "./chunk-2MIG56ZD.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-BT6ONNFH.js";
-import "./chunk-NMX7AYYB.js";
-import "./chunk-NH3O2D5O.js";
+import "./chunk-SWRXPVUQ.js";
+import "./chunk-GBIL6A6D.js";
+import "./chunk-C2DQXCIZ.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -49,4 +49,4 @@ export {
   runConsensusForGoal,
   unwrapVoteOrThrow
 };
-//# sourceMappingURL=consensus-vote-77UCSVGM.js.map
+//# sourceMappingURL=consensus-vote-H6EIMQ7M.js.map

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

@@ -6,18 +6,18 @@ import {
   inferTaskCategory,
   selectRelevantResearch,
   summarizeContextForPrompt
-} from "./chunk-ANTZOHQ6.js";
-import "./chunk-KMUOL3AL.js";
+} from "./chunk-RFXPWYM5.js";
+import "./chunk-YAB5NYKM.js";
 import "./chunk-NUBSJGQZ.js";
-import "./chunk-SWUYPFXS.js";
-import "./chunk-B6DNL7LG.js";
+import "./chunk-ZTQ4CHPG.js";
+import "./chunk-YNWIXCPW.js";
 import "./chunk-6T3EPABN.js";
-import "./chunk-D7X2AMEB.js";
+import "./chunk-3QC3IWRP.js";
 import "./chunk-XIIUIBSX.js";
 import "./chunk-KSQSWEFH.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-BT6ONNFH.js";
-import "./chunk-NH3O2D5O.js";
+import "./chunk-SWRXPVUQ.js";
+import "./chunk-C2DQXCIZ.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -30,4 +30,4 @@ export {
   selectRelevantResearch,
   summarizeContextForPrompt
 };
-//# sourceMappingURL=context-retriever-CP72SNYZ.js.map
+//# sourceMappingURL=context-retriever-MON4VAVO.js.map

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

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

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

@@ -1,18 +1,18 @@
 import {
   createAllAdapters,
   probeAllClis
-} from "./chunk-7BMK5VEO.js";
-import "./chunk-TI65NJOM.js";
-import "./chunk-5JRYCJ37.js";
-import "./chunk-JDUTA6FI.js";
+} from "./chunk-7U5E7DJV.js";
+import "./chunk-2ZO74IO7.js";
+import "./chunk-M5QKVRNH.js";
+import "./chunk-S2BYGZIM.js";
 import "./chunk-SNJNRDKZ.js";
-import "./chunk-TD6I5UHY.js";
+import "./chunk-2MIG56ZD.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-BT6ONNFH.js";
-import "./chunk-NMX7AYYB.js";
+import "./chunk-SWRXPVUQ.js";
+import "./chunk-GBIL6A6D.js";
 import {
   resolveClassGuardMs
-} from "./chunk-NH3O2D5O.js";
+} from "./chunk-C2DQXCIZ.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -146,4 +146,4 @@ export {
   formatLiveReadiness,
   runLiveReadiness
 };
-//# sourceMappingURL=doctor-live-W2KY3OIA.js.map
+//# sourceMappingURL=doctor-live-YCCSYF5X.js.map

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

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

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

@@ -1,10 +1,10 @@
 import {
   createGitHubProvider,
   createScmProvider
-} from "./chunk-ESWY4Y7S.js";
-import "./chunk-6HSDJ5H6.js";
-import "./chunk-SWUYPFXS.js";
-import "./chunk-NH3O2D5O.js";
+} from "./chunk-I5377PAC.js";
+import "./chunk-V7EMWUUM.js";
+import "./chunk-ZTQ4CHPG.js";
+import "./chunk-C2DQXCIZ.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -12,4 +12,4 @@ export {
   createGitHubProvider,
   createScmProvider
 };
-//# sourceMappingURL=factory-LEYEWZ4Y.js.map
+//# sourceMappingURL=factory-BOSRE2JV.js.map

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

@@ -3,16 +3,16 @@ import {
   createCliAdapter,
   getAvailableClis,
   isCliAvailable
-} from "./chunk-7BMK5VEO.js";
-import "./chunk-TI65NJOM.js";
-import "./chunk-5JRYCJ37.js";
-import "./chunk-JDUTA6FI.js";
+} from "./chunk-7U5E7DJV.js";
+import "./chunk-2ZO74IO7.js";
+import "./chunk-M5QKVRNH.js";
+import "./chunk-S2BYGZIM.js";
 import "./chunk-SNJNRDKZ.js";
-import "./chunk-TD6I5UHY.js";
+import "./chunk-2MIG56ZD.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-BT6ONNFH.js";
-import "./chunk-NMX7AYYB.js";
-import "./chunk-NH3O2D5O.js";
+import "./chunk-SWRXPVUQ.js";
+import "./chunk-GBIL6A6D.js";
+import "./chunk-C2DQXCIZ.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -22,4 +22,4 @@ export {
   getAvailableClis,
   isCliAvailable
 };
-//# sourceMappingURL=factory-GEBBVQHZ.js.map
+//# sourceMappingURL=factory-YRLWFERP.js.map

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

@@ -11,10 +11,10 @@ import {
   loadSelfEvalSignals,
   registerImprovementReviewTool,
   runImprovementReview
-} from "./chunk-34UKF4FB.js";
-import "./chunk-ARTRA6YC.js";
-import "./chunk-EYZIMY6I.js";
-import "./chunk-NH3O2D5O.js";
+} from "./chunk-7M566K5K.js";
+import "./chunk-RHQNFMUW.js";
+import "./chunk-RQ3F7KRP.js";
+import "./chunk-C2DQXCIZ.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -32,4 +32,4 @@ export {
   registerImprovementReviewTool,
   runImprovementReview
 };
-//# sourceMappingURL=improvement-review-XN2GZX3V.js.map
+//# sourceMappingURL=improvement-review-LTOEMHMZ.js.map

package/dist/index.d.ts

@@ -5402,8 +5402,17 @@ interface OrchestratorStep {
     output: unknown;
     /** Duration in ms */
     durationMs: number;
-    /** Tokens used in this step */
+    /** Tokens used in this step. Meaningful only when {@link OrchestratorStep.tokensMeasured} is not `false`. */
     tokensUsed: number;
+    /**
+     * Whether `tokensUsed` is a measurement (#4829).
+     *
+     * `false` means no usage was reported for this step, so `tokensUsed` is a
+     * placeholder `0` and NOT a count. Absent means the producer predates the
+     * distinction — unknown, not measured. Mirrors `ResultMetadata.tokensMeasured`
+     * (#4734).
+     */
+    tokensMeasured?: boolean;
     /** Status */
     status: 'success' | 'failed' | 'skipped';
     /** Error if failed */
@@ -5423,8 +5432,16 @@ interface OrchestratorResult {
     output: unknown;
     /** Total execution time in ms */
     totalDurationMs: number;
-    /** Total tokens consumed */
+    /** Total tokens consumed. Meaningful only when {@link OrchestratorResult.tokensMeasured} is not `false`. */
     totalTokensUsed: number;
+    /**
+     * Whether `totalTokensUsed` is a measurement (#4829).
+     *
+     * `false` means no step reported usage, so the total is a placeholder `0`
+     * and NOT a count — for anything cap-shaped, reading it as a count
+     * under-counts in the dangerous direction.
+     */
+    tokensMeasured?: boolean;
     /** Agents involved */
     agentsUsed: string[];
 }
@@ -11183,15 +11200,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;
@@ -11200,10 +11246,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;
     /**
@@ -11218,9 +11268,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;
@@ -21292,6 +21344,7 @@ declare const OrchestrateOutputSchema: z.ZodObject<{
     metadata: z.ZodObject<{
         durationMs: z.ZodNumber;
         tokensUsed: z.ZodNumber;
+        tokensMeasured: z.ZodOptional<z.ZodBoolean>;
         expertsUsed: z.ZodArray<z.ZodString>;
         timeoutReason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;