nexus-agents 3.4.7 → 3.5.0

package/dist/{chunk-DXORNOYR.js → chunk-Z5HKO4TN.js}

@@ -4,7 +4,7 @@ import {
   getErrorMessage,
   getTimeProvider,
   ok
-} from "./chunk-FBTBH65X.js";
+} from "./chunk-YFY64CCU.js";
 
 // src/context/session-memory.ts
 import * as fs from "fs";
@@ -352,4 +352,4 @@ export {
   SessionMemory,
   createSessionMemory
 };
-//# sourceMappingURL=chunk-DXORNOYR.js.map
+//# sourceMappingURL=chunk-Z5HKO4TN.js.map

package/dist/{cli-circuit-breaker-PETQMWAX.js → cli-circuit-breaker-BKCDXF7A.js}

@@ -3,8 +3,8 @@ import {
   createCliCircuitBreakerIntegration,
   getCliCircuitBreakerSnapshot,
   getDefaultCliCircuitBreakerRegistry
-} from "./chunk-7BBHGO7A.js";
-import "./chunk-FBTBH65X.js";
+} from "./chunk-D3KHLA3D.js";
+import "./chunk-YFY64CCU.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -14,4 +14,4 @@ export {
   getCliCircuitBreakerSnapshot,
   getDefaultCliCircuitBreakerRegistry
 };
-//# sourceMappingURL=cli-circuit-breaker-PETQMWAX.js.map
+//# sourceMappingURL=cli-circuit-breaker-BKCDXF7A.js.map

package/dist/cli.js

@@ -13,13 +13,13 @@ import {
   generateSummary,
   parseFindings,
   sumFindings
-} from "./chunk-5542NZXG.js";
-import "./chunk-F4SOZWM5.js";
+} from "./chunk-GWLBIDS6.js";
+import "./chunk-4ZVNCOZH.js";
 import {
   setupCommandAsync,
   verifyCommand
-} from "./chunk-WEQNCK5F.js";
-import "./chunk-FTH6XZFA.js";
+} from "./chunk-NWTACWXE.js";
+import "./chunk-QDUZSOOU.js";
 import {
   AuthHandler,
   DEFAULT_EXPERTS,
@@ -139,8 +139,8 @@ import {
   validateCommand,
   validateWorkflow,
   wrapInMarkdownFence
-} from "./chunk-SLLUTZHU.js";
-import "./chunk-WGBVREBV.js";
+} from "./chunk-DDY7JDTZ.js";
+import "./chunk-XKAUANYB.js";
 import "./chunk-HFOQKCD2.js";
 import "./chunk-YF35FKKD.js";
 import {
@@ -166,14 +166,14 @@ import {
   loadConfig,
   runDoctor,
   validateNexusEnv
-} from "./chunk-J34IF7WA.js";
+} from "./chunk-3EIACKNR.js";
 import {
   buildOpenAICompatAdapters,
   readOpenAICompatEnv
-} from "./chunk-CG5TS6GJ.js";
+} from "./chunk-XOWOOBY7.js";
 import {
   shutdownExpertBridge
-} from "./chunk-JHIKOTSP.js";
+} from "./chunk-GVLDWGSK.js";
 import {
   ConsensusVoteInputSchema,
   DEFAULT_VOTE_TIMEOUT_MS,
@@ -183,25 +183,25 @@ import {
   executeVoting,
   mapOutcomeToDecision,
   registerConsensusVoteTool
-} from "./chunk-QITBS6CA.js";
+} from "./chunk-6DIGIJIY.js";
 import {
   loadUsageEvents,
   rollupByModel
-} from "./chunk-TU25EPBM.js";
+} from "./chunk-HPAYIX7E.js";
 import {
   synthesizeResearch
-} from "./chunk-YHSWBCZJ.js";
+} from "./chunk-XKGEKKKQ.js";
 import {
   classifyTrust,
   createFullGitHubProvider,
   evaluatePolicy,
   parsePRUrl
-} from "./chunk-OR2CJF3R.js";
-import "./chunk-KJ2M2L6J.js";
+} from "./chunk-IK45M7J3.js";
+import "./chunk-U76AVHIW.js";
 import {
   ReputationCache,
   sanitizeInput
-} from "./chunk-Z53SVS5A.js";
+} from "./chunk-KBVU2GGV.js";
 import {
   ImprovementReviewInputSchema,
   calculateFitnessScore,
@@ -215,15 +215,15 @@ import {
   registerImprovementReviewTool,
   runImprovementReview,
   scanForSecrets
-} from "./chunk-SC522IDR.js";
+} from "./chunk-UKIFG26L.js";
 import {
   createDefaultPolicyFirewall
-} from "./chunk-UOG5ANHL.js";
-import "./chunk-W4GN7VPG.js";
+} from "./chunk-HKX7HKDV.js";
+import "./chunk-L4J7AXP3.js";
 import {
   createUnifiedRegistry,
   getGlobalRegistry
-} from "./chunk-H5BWZMLU.js";
+} from "./chunk-UFJDYK22.js";
 import {
   CodebaseIndexSchema,
   PaperStatusSchema,
@@ -249,25 +249,25 @@ import {
   loadSourcesRegistry,
   rankDiscoveredItems,
   saveSourcesRegistry
-} from "./chunk-RGAC3SAM.js";
+} from "./chunk-EKASN4MV.js";
 import {
   resolveToken
-} from "./chunk-6DDKUQFD.js";
+} from "./chunk-TPKK4ANS.js";
 import {
   loadPapersRegistry,
   loadTechniquesRegistry,
   savePapersRegistry
-} from "./chunk-YO2OXOPU.js";
+} from "./chunk-QDH2SQKE.js";
 import "./chunk-NUBSJGQZ.js";
 import {
   MemoryError,
   shutdownToolMemory
-} from "./chunk-RSUQCA2E.js";
+} from "./chunk-ROIGF7ZF.js";
 import {
   capitalize,
   capitalizeKebab
 } from "./chunk-6T3EPABN.js";
-import "./chunk-DXORNOYR.js";
+import "./chunk-Z5HKO4TN.js";
 import "./chunk-YPNQPT2F.js";
 import "./chunk-DVKS77O5.js";
 import "./chunk-KSQSWEFH.js";
@@ -278,19 +278,19 @@ import {
   isRecord,
   probeAllClis,
   readSubprocessDepth
-} from "./chunk-ZFLZL6JL.js";
-import "./chunk-PHEB64A5.js";
+} from "./chunk-45IB3F6G.js";
+import "./chunk-7GFMCMLF.js";
 import {
   DEFAULTS
-} from "./chunk-2KOTMA3Y.js";
-import "./chunk-XND2FD6I.js";
+} from "./chunk-3FSBTAEC.js";
+import "./chunk-UOA23X5A.js";
 import {
   nexusMkdtempSync
 } from "./chunk-SNJNRDKZ.js";
-import "./chunk-SC7OLO76.js";
+import "./chunk-LMGXSMC6.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-UAPIH3ZX.js";
-import "./chunk-7BBHGO7A.js";
+import "./chunk-5MRYWJVK.js";
+import "./chunk-D3KHLA3D.js";
 import {
   API_TIMEOUTS,
   AgentCapability,
@@ -364,7 +364,7 @@ import {
   validateTimeout,
   writeEmptyLine,
   writeLine
-} from "./chunk-FBTBH65X.js";
+} from "./chunk-YFY64CCU.js";
 import "./chunk-2HUC6NZN.js";
 import {
   applyPortableMode,
@@ -4071,7 +4071,7 @@ ${file.patch}
         violations: policyResult.violations
       });
     }
-    const { formatReviewComment: formatReviewComment2 } = await import("./pr-reviewer-helpers-GAXKDXOB.js");
+    const { formatReviewComment: formatReviewComment2 } = await import("./pr-reviewer-helpers-T33G7ACC.js");
     const body = formatReviewComment2(result);
     const postResult = await provider.createReview(pr.prNumber, body, result.decision);
     if (!postResult.ok) {
@@ -17461,7 +17461,7 @@ function startImprovementReviewScheduler(options) {
   let running = false;
   const runOnce = async () => {
     try {
-      const { runImprovementReview: runImprovementReview2, ImprovementReviewInputSchema: ImprovementReviewInputSchema2 } = await import("./improvement-review-5SWVO5KR.js");
+      const { runImprovementReview: runImprovementReview2, ImprovementReviewInputSchema: ImprovementReviewInputSchema2 } = await import("./improvement-review-P5OTBXCR.js");
       const input = ImprovementReviewInputSchema2.parse({ fileIssues });
       const result = await runImprovementReview2(input, { logger: logger19 });
       logger19.info("Scheduled improvement_review complete", {
@@ -19518,7 +19518,7 @@ function adaptConfigToLibrary(config) {
 }
 function createBeliefPromoter() {
   return async (event) => {
-    const { getToolMemory } = await import("./tool-memory-HDV46HBY.js");
+    const { getToolMemory } = await import("./tool-memory-IALII4YE.js");
     const tm = getToolMemory();
     await tm.recordBelief(
       `skill:${event.name}`,
@@ -20694,7 +20694,7 @@ async function handleResearchCommand(args) {
   }
 }
 async function handleRegistryCommand(args) {
-  const { registryCommand, isValidRegistrySubcommand, formatRegistryUsage } = await import("./registry-command-AUHXXQMZ.js");
+  const { registryCommand, isValidRegistrySubcommand, formatRegistryUsage } = await import("./registry-command-PW7PXQDH.js");
   const subcommand = args.subcommand;
   if (!isValidRegistrySubcommand(subcommand)) {
     process.stdout.write(`${formatRegistryUsage()}
@@ -20742,7 +20742,7 @@ 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-KCBA7PRP.js");
+    const { runDeepDiagnostics: runDeepDiagnostics2, formatDeepDiagnostics: formatDeepDiagnostics2 } = await import("./doctor-deep-XEIFQH2B.js");
     const diag = runDeepDiagnostics2();
     process.stdout.write(formatDeepDiagnostics2(diag) + "\n");
   }
@@ -20792,7 +20792,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-Q6YEYFJK.js");
+  const { runInitOpencode } = await import("./init-opencode-ZYRLCXUF.js");
   const opencodePath = args.options.opencode;
   if (opencodePath === void 0 || opencodePath === "") {
     process.stderr.write("Error: --opencode requires a path argument.\n");
@@ -20818,7 +20818,7 @@ async function runInitOpencodeFlow(args) {
   return cliExit(EXIT_CODES.SUCCESS);
 }
 async function renderOpencodeValidate(opencodePath) {
-  const { runOpencodeValidate } = await import("./init-opencode-Q6YEYFJK.js");
+  const { runOpencodeValidate } = await import("./init-opencode-ZYRLCXUF.js");
   const result = await runOpencodeValidate(opencodePath);
   if (!result.ok) {
     process.stderr.write(`init --opencode --validate: ${result.reason ?? "failed"}
@@ -20857,7 +20857,7 @@ async function handleSetupCommandAsync(args) {
   return cliExitFromStatus(exitCode);
 }
 async function runCustomApiSetup(args) {
-  const { configureCustomApi } = await import("./setup-custom-api-7FACD7AZ.js");
+  const { configureCustomApi } = await import("./setup-custom-api-V4K6SQQN.js");
   const baseUrl = args.options.customApi;
   if (baseUrl === void 0) return EXIT_CODES.SERVER_START_FAILED;
   const input = {

package/dist/{composite-router-D36RXDEN.js → composite-router-7ZQW5X6M.js}

@@ -4,7 +4,7 @@ import {
   CompositeRoutingError,
   DEFAULT_COMPOSITE_CONFIG,
   createCompositeRouter
-} from "./chunk-FBTBH65X.js";
+} from "./chunk-YFY64CCU.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-D36RXDEN.js.map
+//# sourceMappingURL=composite-router-7ZQW5X6M.js.map

package/dist/{consensus-vote-CVXD54KV.js → consensus-vote-JAQXK6NR.js}

@@ -10,26 +10,26 @@ import {
   resetCorrelationTracker,
   runConsensusForGoal,
   unwrapVoteOrThrow
-} from "./chunk-QITBS6CA.js";
-import "./chunk-TU25EPBM.js";
-import "./chunk-UOG5ANHL.js";
-import "./chunk-W4GN7VPG.js";
-import "./chunk-H5BWZMLU.js";
-import "./chunk-RSUQCA2E.js";
+} from "./chunk-6DIGIJIY.js";
+import "./chunk-HPAYIX7E.js";
+import "./chunk-HKX7HKDV.js";
+import "./chunk-L4J7AXP3.js";
+import "./chunk-UFJDYK22.js";
+import "./chunk-ROIGF7ZF.js";
 import "./chunk-6T3EPABN.js";
-import "./chunk-DXORNOYR.js";
+import "./chunk-Z5HKO4TN.js";
 import "./chunk-DVKS77O5.js";
 import "./chunk-KSQSWEFH.js";
-import "./chunk-ZFLZL6JL.js";
-import "./chunk-PHEB64A5.js";
-import "./chunk-2KOTMA3Y.js";
-import "./chunk-XND2FD6I.js";
+import "./chunk-45IB3F6G.js";
+import "./chunk-7GFMCMLF.js";
+import "./chunk-3FSBTAEC.js";
+import "./chunk-UOA23X5A.js";
 import "./chunk-SNJNRDKZ.js";
-import "./chunk-SC7OLO76.js";
+import "./chunk-LMGXSMC6.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-UAPIH3ZX.js";
-import "./chunk-7BBHGO7A.js";
-import "./chunk-FBTBH65X.js";
+import "./chunk-5MRYWJVK.js";
+import "./chunk-D3KHLA3D.js";
+import "./chunk-YFY64CCU.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -46,4 +46,4 @@ export {
   runConsensusForGoal,
   unwrapVoteOrThrow
 };
-//# sourceMappingURL=consensus-vote-CVXD54KV.js.map
+//# sourceMappingURL=consensus-vote-JAQXK6NR.js.map

package/dist/{context-retriever-TCS3ZCHM.js → context-retriever-4BWVW6Z3.js}

@@ -6,18 +6,18 @@ import {
   inferTaskCategory,
   selectRelevantResearch,
   summarizeContextForPrompt
-} from "./chunk-RGAC3SAM.js";
-import "./chunk-6DDKUQFD.js";
-import "./chunk-YO2OXOPU.js";
+} from "./chunk-EKASN4MV.js";
+import "./chunk-TPKK4ANS.js";
+import "./chunk-QDH2SQKE.js";
 import "./chunk-NUBSJGQZ.js";
-import "./chunk-RSUQCA2E.js";
+import "./chunk-ROIGF7ZF.js";
 import "./chunk-6T3EPABN.js";
-import "./chunk-DXORNOYR.js";
+import "./chunk-Z5HKO4TN.js";
 import "./chunk-DVKS77O5.js";
 import "./chunk-KSQSWEFH.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-UAPIH3ZX.js";
-import "./chunk-FBTBH65X.js";
+import "./chunk-5MRYWJVK.js";
+import "./chunk-YFY64CCU.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -30,4 +30,4 @@ export {
   selectRelevantResearch,
   summarizeContextForPrompt
 };
-//# sourceMappingURL=context-retriever-TCS3ZCHM.js.map
+//# sourceMappingURL=context-retriever-4BWVW6Z3.js.map

package/dist/{doctor-deep-KCBA7PRP.js → doctor-deep-XEIFQH2B.js}

@@ -1,8 +1,8 @@
 import {
   formatDeepDiagnostics,
   runDeepDiagnostics
-} from "./chunk-F4SOZWM5.js";
-import "./chunk-FBTBH65X.js";
+} from "./chunk-4ZVNCOZH.js";
+import "./chunk-YFY64CCU.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -10,4 +10,4 @@ export {
   formatDeepDiagnostics,
   runDeepDiagnostics
 };
-//# sourceMappingURL=doctor-deep-KCBA7PRP.js.map
+//# sourceMappingURL=doctor-deep-XEIFQH2B.js.map

package/dist/{expert-bridge-4N5Q5T6J.js → expert-bridge-KXXOPEZF.js}

@@ -3,9 +3,9 @@ import {
   shutdownExpertBridge,
   tokenSplitFromUsage,
   totalTokensFromUsage
-} from "./chunk-JHIKOTSP.js";
-import "./chunk-SC7OLO76.js";
-import "./chunk-FBTBH65X.js";
+} from "./chunk-GVLDWGSK.js";
+import "./chunk-LMGXSMC6.js";
+import "./chunk-YFY64CCU.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -15,4 +15,4 @@ export {
   tokenSplitFromUsage,
   totalTokensFromUsage
 };
-//# sourceMappingURL=expert-bridge-4N5Q5T6J.js.map
+//# sourceMappingURL=expert-bridge-KXXOPEZF.js.map

package/dist/{factory-KDJP6PLO.js → factory-DFOM4HM5.js}

@@ -1,10 +1,10 @@
 import {
   createGitHubProvider,
   createScmProvider
-} from "./chunk-GMJGQ2XO.js";
-import "./chunk-KJ2M2L6J.js";
-import "./chunk-6DDKUQFD.js";
-import "./chunk-FBTBH65X.js";
+} from "./chunk-C25JA3SI.js";
+import "./chunk-U76AVHIW.js";
+import "./chunk-TPKK4ANS.js";
+import "./chunk-YFY64CCU.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -12,4 +12,4 @@ export {
   createGitHubProvider,
   createScmProvider
 };
-//# sourceMappingURL=factory-KDJP6PLO.js.map
+//# sourceMappingURL=factory-DFOM4HM5.js.map

package/dist/{factory-ASP7H2N6.js → factory-L74ZN3ZO.js}

@@ -3,16 +3,16 @@ import {
   createCliAdapter,
   getAvailableClis,
   isCliAvailable
-} from "./chunk-ZFLZL6JL.js";
-import "./chunk-PHEB64A5.js";
-import "./chunk-2KOTMA3Y.js";
-import "./chunk-XND2FD6I.js";
+} from "./chunk-45IB3F6G.js";
+import "./chunk-7GFMCMLF.js";
+import "./chunk-3FSBTAEC.js";
+import "./chunk-UOA23X5A.js";
 import "./chunk-SNJNRDKZ.js";
-import "./chunk-SC7OLO76.js";
+import "./chunk-LMGXSMC6.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-UAPIH3ZX.js";
-import "./chunk-7BBHGO7A.js";
-import "./chunk-FBTBH65X.js";
+import "./chunk-5MRYWJVK.js";
+import "./chunk-D3KHLA3D.js";
+import "./chunk-YFY64CCU.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -22,4 +22,4 @@ export {
   getAvailableClis,
   isCliAvailable
 };
-//# sourceMappingURL=factory-ASP7H2N6.js.map
+//# sourceMappingURL=factory-L74ZN3ZO.js.map

package/dist/{improvement-review-5SWVO5KR.js → improvement-review-P5OTBXCR.js}

@@ -11,10 +11,10 @@ import {
   loadSelfEvalSignals,
   registerImprovementReviewTool,
   runImprovementReview
-} from "./chunk-SC522IDR.js";
-import "./chunk-UOG5ANHL.js";
-import "./chunk-W4GN7VPG.js";
-import "./chunk-FBTBH65X.js";
+} from "./chunk-UKIFG26L.js";
+import "./chunk-HKX7HKDV.js";
+import "./chunk-L4J7AXP3.js";
+import "./chunk-YFY64CCU.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -32,4 +32,4 @@ export {
   registerImprovementReviewTool,
   runImprovementReview
 };
-//# sourceMappingURL=improvement-review-5SWVO5KR.js.map
+//# sourceMappingURL=improvement-review-P5OTBXCR.js.map

package/dist/index.d.ts

@@ -1057,8 +1057,49 @@ interface CapacityStatus {
     readonly resetTime: Date;
     /** Current utilization percentage (0-100) */
     readonly utilizationPercent: number;
-    /** Whether capacity is exhausted */
+    /**
+     * Whether this process's rolling rate window is used up (#4456).
+     *
+     * Local arithmetic only: this process's own spend over the last
+     * {@link RATE_LIMIT_WINDOW_MS}, measured against a per-CLI constant the
+     * source calls a conservative estimate. It self-clears within the window,
+     * and an ordinary burst (a 7-voter panel, a subagent fan-out) sets it while
+     * plenty of provider quota remains.
+     *
+     * This is a throttling hint, NOT evidence that the account is out of
+     * capacity. Do not exclude a candidate on it — see {@link quotaExhausted}.
+     */
+    readonly rateLimited: boolean;
+    /**
+     * @deprecated Since #4456 — renamed to {@link rateLimited}, which says what
+     * it actually measures. The name `exhausted` promised an account/plan
+     * capacity signal while reporting a 60-second local rate heuristic, so every
+     * reader inherited a claim the value could not support. Identical value;
+     * scheduled for removal in the next major.
+     */
     readonly exhausted: boolean;
+    /**
+     * Whether a PROVIDER asserted that durable quota is gone (#4456).
+     *
+     * Set only from provider-asserted evidence — a rate-limit error whose
+     * `retry-after` exceeds the local window, which is the provider itself
+     * saying the wait is longer than a per-minute throttle. Never inferred from
+     * local counting.
+     *
+     * `false` means "no provider has asserted exhaustion to THIS process". It is
+     * NOT a measurement that quota remains: a weekly quota burned by another
+     * process is invisible here. Read it with {@link observed}; absence of
+     * evidence must not be presented as capacity.
+     */
+    readonly quotaExhausted: boolean;
+    /**
+     * When the provider said the quota window clears, from `retry-after`.
+     *
+     * Present only alongside `quotaExhausted: true`. Absent means the provider
+     * asserted exhaustion without a horizon, which is a weaker signal, not a
+     * shorter one.
+     */
+    readonly quotaResetAt?: Date;
     /**
      * Whether this process has observed any usage of the adapter (#4374).
      *
@@ -26979,6 +27020,11 @@ declare class CapacityTracker {
      * from an idle healthy one, and both report full remaining capacity.
      */
     private hasObserved;
+    /**
+     * Provider-asserted quota exhaustion (#4456), with the horizon the provider
+     * gave. Null until a provider says so — never inferred from local counting.
+     */
+    private quotaExhaustedUntil;
     constructor(config: CapacityTrackerConfig);
     /**
      * Records token usage from a completed request.
@@ -26988,6 +27034,23 @@ declare class CapacityTracker {
      * Gets current capacity status based on tracked usage.
      */
     getCapacity(): CapacityStatus;
+    /**
+     * Record a PROVIDER's assertion that durable quota is exhausted (#4456).
+     *
+     * Only a `retryAfterMs` longer than the local window counts. A shorter one
+     * is an ordinary per-minute throttle, which {@link CapacityStatus.rateLimited}
+     * already covers — treating it as quota exhaustion would empty the candidate
+     * pool for a condition that clears in under a minute, the failure mode that
+     * kept #4373's enforcement stage switched off.
+     *
+     * Without a `retryAfterMs` the provider gave no horizon, so nothing is
+     * asserted: an exhaustion with no end is not distinguishable here from a
+     * transient error, and inventing a horizon would manufacture a measurement.
+     *
+     * @param retryAfterMs - The provider's stated wait, from `retry-after`.
+     * @returns true when the assertion was durable enough to record.
+     */
+    recordProviderQuotaExhaustion(retryAfterMs: number | undefined): boolean;
     /**
      * Gets time until the rate limit window resets.
      */
@@ -27100,6 +27163,17 @@ declare abstract class BaseCliAdapter implements ICliAdapter {
      * Executes task with retry logic via shared retry loop.
      */
     private executeWithRetry;
+    /**
+     * Feed a provider's own rate-limit assertion into capacity tracking (#4456).
+     *
+     * A `retry-after` the provider stated is far stronger evidence than local
+     * counting: the tracker otherwise sees only this process's spend and cannot
+     * observe a plan quota burned gradually or burned elsewhere, which is the
+     * incident #4351 reported. Only RATE_LIMITED carries that assertion; the
+     * tracker itself decides whether the stated wait is long enough to mean
+     * durable quota rather than a per-minute throttle.
+     */
+    protected recordQuotaSignal(error: CliError): void;
     /**
      * Performs a health check.
      */