nexus-agents 3.9.2 → 3.9.4

package/dist/{chunk-7GA5V4L2.js → chunk-XMNMIMR6.js}

@@ -2,7 +2,7 @@ import {
   CACHE_TIMEOUTS,
   createLogger,
   getTimeProvider
-} from "./chunk-65WAPYJ6.js";
+} from "./chunk-6VUIQQ3O.js";
 
 // src/security/trust-types.ts
 import { z } from "zod";
@@ -560,4 +560,4 @@ export {
   resolveReputationGatingMode,
   gateWithReputation
 };
-//# sourceMappingURL=chunk-7GA5V4L2.js.map
+//# sourceMappingURL=chunk-XMNMIMR6.js.map

package/dist/{chunk-3ZGYVPN3.js → chunk-ZVZHNAQH.js}

@@ -1,6 +1,6 @@
 import {
   getTimeProvider
-} from "./chunk-65WAPYJ6.js";
+} from "./chunk-6VUIQQ3O.js";
 
 // src/security/audit-trail.ts
 var MAX_EVENTS = 1e4;
@@ -205,4 +205,4 @@ export {
   createGraphAuditBridge,
   createAuditTrail
 };
-//# sourceMappingURL=chunk-3ZGYVPN3.js.map
+//# sourceMappingURL=chunk-ZVZHNAQH.js.map

package/dist/{cli-circuit-breaker-M5JY42QE.js → cli-circuit-breaker-JWCKCVDX.js}

@@ -3,8 +3,8 @@ import {
   createCliCircuitBreakerIntegration,
   getCliCircuitBreakerSnapshot,
   getDefaultCliCircuitBreakerRegistry
-} from "./chunk-R43Y6TXS.js";
-import "./chunk-65WAPYJ6.js";
+} from "./chunk-KLMXZRDK.js";
+import "./chunk-6VUIQQ3O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -14,4 +14,4 @@ export {
   getCliCircuitBreakerSnapshot,
   getDefaultCliCircuitBreakerRegistry
 };
-//# sourceMappingURL=cli-circuit-breaker-M5JY42QE.js.map
+//# sourceMappingURL=cli-circuit-breaker-JWCKCVDX.js.map

package/dist/cli.js

@@ -13,13 +13,13 @@ import {
   generateSummary,
   parseFindings,
   sumFindings
-} from "./chunk-2CN7DD4C.js";
-import "./chunk-YP25ZDI2.js";
+} from "./chunk-JPMXFYKW.js";
+import "./chunk-TU4FRZWU.js";
 import {
   setupCommandAsync,
   verifyCommand
-} from "./chunk-DXL625N6.js";
-import "./chunk-OM5VAEYP.js";
+} from "./chunk-IAEZN2N4.js";
+import "./chunk-VF4ZV4KG.js";
 import {
   AuthHandler,
   DEFAULT_EXPERTS,
@@ -139,8 +139,8 @@ import {
   validateCommand,
   validateWorkflow,
   wrapInMarkdownFence
-} from "./chunk-ZGAML4CX.js";
-import "./chunk-WVN62JSE.js";
+} from "./chunk-XBEED5SG.js";
+import "./chunk-MXJEMYC7.js";
 import "./chunk-HFOQKCD2.js";
 import "./chunk-RSMG2DPB.js";
 import {
@@ -166,14 +166,14 @@ import {
   loadConfig,
   runDoctor,
   validateNexusEnv
-} from "./chunk-CQAO35WX.js";
+} from "./chunk-KBX4JSBE.js";
 import {
   buildOpenAICompatAdapters,
   readOpenAICompatEnv
-} from "./chunk-AENOTEID.js";
+} from "./chunk-7FJFN74H.js";
 import {
   shutdownExpertBridge
-} from "./chunk-EGUKCGGM.js";
+} from "./chunk-KPYPJGSD.js";
 import {
   ConsensusVoteInputSchema,
   DEFAULT_VOTE_TIMEOUT_MS,
@@ -183,29 +183,29 @@ import {
   executeVoting,
   mapOutcomeToDecision,
   registerConsensusVoteTool
-} from "./chunk-VCNOCG2J.js";
+} from "./chunk-DMKV7ANB.js";
 import {
   loadUsageEvents,
   rollupByModel
-} from "./chunk-AQBM5CAX.js";
+} from "./chunk-M3HKW5HF.js";
 import {
   allOf,
   anyOf
 } from "./chunk-OQB3XC5O.js";
 import {
   synthesizeResearch
-} from "./chunk-SXWUCWLR.js";
+} from "./chunk-JBSL2HKV.js";
 import {
   classifyTrust,
   createFullGitHubProvider,
   evaluatePolicy,
   parsePRUrl
-} from "./chunk-3MUJKEAQ.js";
-import "./chunk-EZXYOWCX.js";
+} from "./chunk-ABV3XE7D.js";
+import "./chunk-3WWE26PG.js";
 import {
   ReputationCache,
   sanitizeInput
-} from "./chunk-7GA5V4L2.js";
+} from "./chunk-XMNMIMR6.js";
 import {
   ImprovementReviewInputSchema,
   calculateFitnessScore,
@@ -219,15 +219,15 @@ import {
   registerImprovementReviewTool,
   runImprovementReview,
   scanForSecrets
-} from "./chunk-SMBJQBEC.js";
+} from "./chunk-JJZF37X2.js";
 import {
   createDefaultPolicyFirewall
-} from "./chunk-DSP6PMDI.js";
-import "./chunk-3ZGYVPN3.js";
+} from "./chunk-K3TRG2CD.js";
+import "./chunk-ZVZHNAQH.js";
 import {
   createUnifiedRegistry,
   getGlobalRegistry
-} from "./chunk-6YEAUZBF.js";
+} from "./chunk-SOCKDRK6.js";
 import {
   CodebaseIndexSchema,
   PaperStatusSchema,
@@ -253,25 +253,25 @@ import {
   loadSourcesRegistry,
   rankDiscoveredItems,
   saveSourcesRegistry
-} from "./chunk-YAZW2ANJ.js";
+} from "./chunk-JBLM3UZA.js";
 import {
   resolveToken
-} from "./chunk-XYVYKPIB.js";
+} from "./chunk-G6AVXG6F.js";
 import {
   loadPapersRegistry,
   loadTechniquesRegistry,
   savePapersRegistry
-} from "./chunk-ACWU2RRK.js";
+} from "./chunk-MAP3BVCT.js";
 import "./chunk-NUBSJGQZ.js";
 import {
   MemoryError,
   shutdownToolMemory
-} from "./chunk-FZ5YJSM6.js";
+} from "./chunk-QUOCOEDQ.js";
 import {
   capitalize,
   capitalizeKebab
 } from "./chunk-6T3EPABN.js";
-import "./chunk-MUBJ4ROO.js";
+import "./chunk-OL6TRWBA.js";
 import "./chunk-YPNQPT2F.js";
 import "./chunk-DVKS77O5.js";
 import "./chunk-KSQSWEFH.js";
@@ -282,19 +282,19 @@ import {
   isRecord,
   probeAllClis,
   readSubprocessDepth
-} from "./chunk-PBD5LS4B.js";
-import "./chunk-OJCIP6W5.js";
+} from "./chunk-M7566JRS.js";
+import "./chunk-32AWWH4F.js";
 import {
   DEFAULTS
-} from "./chunk-7PBXPMKW.js";
-import "./chunk-KIE4R424.js";
+} from "./chunk-G5GOWK5T.js";
+import "./chunk-ERCCVO4N.js";
 import {
   nexusMkdtempSync
 } from "./chunk-SNJNRDKZ.js";
-import "./chunk-Q2UUVPVY.js";
+import "./chunk-TJ6UFU3I.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-NZCBB4SP.js";
-import "./chunk-R43Y6TXS.js";
+import "./chunk-N62DDWV3.js";
+import "./chunk-KLMXZRDK.js";
 import {
   API_TIMEOUTS,
   AgentCapability,
@@ -368,7 +368,7 @@ import {
   validateTimeout,
   writeEmptyLine,
   writeLine
-} from "./chunk-65WAPYJ6.js";
+} from "./chunk-6VUIQQ3O.js";
 import "./chunk-2HUC6NZN.js";
 import {
   applyPortableMode,
@@ -4080,7 +4080,7 @@ ${file.patch}
         violations: policyResult.violations
       });
     }
-    const { formatReviewComment: formatReviewComment2 } = await import("./pr-reviewer-helpers-545VXQVR.js");
+    const { formatReviewComment: formatReviewComment2 } = await import("./pr-reviewer-helpers-RN35E43S.js");
     const body = formatReviewComment2(result);
     const postResult = await provider.createReview(pr.prNumber, body, result.decision);
     if (!postResult.ok) {
@@ -17483,7 +17483,7 @@ function startImprovementReviewScheduler(options) {
   let running = false;
   const runOnce = async () => {
     try {
-      const { runImprovementReview: runImprovementReview2, ImprovementReviewInputSchema: ImprovementReviewInputSchema2 } = await import("./improvement-review-J6TNYY37.js");
+      const { runImprovementReview: runImprovementReview2, ImprovementReviewInputSchema: ImprovementReviewInputSchema2 } = await import("./improvement-review-E2PK2AEA.js");
       const input = ImprovementReviewInputSchema2.parse({ fileIssues });
       const result = await runImprovementReview2(input, { logger: logger19 });
       logger19.info("Scheduled improvement_review complete", {
@@ -19540,7 +19540,7 @@ function adaptConfigToLibrary(config) {
 }
 function createBeliefPromoter() {
   return async (event) => {
-    const { getToolMemory } = await import("./tool-memory-HEHBDQDP.js");
+    const { getToolMemory } = await import("./tool-memory-YYEWKSC4.js");
     const tm = getToolMemory();
     await tm.recordBelief(
       `skill:${event.name}`,
@@ -20727,7 +20727,7 @@ async function handleResearchCommand(args) {
   }
 }
 async function handleRegistryCommand(args) {
-  const { registryCommand, isValidRegistrySubcommand, formatRegistryUsage } = await import("./registry-command-7YZHWM5F.js");
+  const { registryCommand, isValidRegistrySubcommand, formatRegistryUsage } = await import("./registry-command-J2FV4BT2.js");
   const subcommand = args.subcommand;
   if (!isValidRegistrySubcommand(subcommand)) {
     process.stdout.write(`${formatRegistryUsage()}
@@ -20775,12 +20775,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-CSIYPBWB.js");
+    const { runDeepDiagnostics: runDeepDiagnostics2, formatDeepDiagnostics: formatDeepDiagnostics2 } = await import("./doctor-deep-IZAAFLBC.js");
     const diag = runDeepDiagnostics2();
     process.stdout.write(formatDeepDiagnostics2(diag) + "\n");
   }
   if (args.options.live) {
-    const { runLiveReadiness, formatLiveReadiness } = await import("./doctor-live-Z3EUWDEM.js");
+    const { runLiveReadiness, formatLiveReadiness } = await import("./doctor-live-Z5IP2TWY.js");
     const report = await runLiveReadiness();
     process.stdout.write(formatLiveReadiness(report) + "\n");
     if (report.some((r) => r.levels.serves.status === "failed")) {
@@ -20833,7 +20833,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-EY7LKRNG.js");
+  const { runInitOpencode } = await import("./init-opencode-BQHWMUOD.js");
   const opencodePath = args.options.opencode;
   if (opencodePath === void 0 || opencodePath === "") {
     process.stderr.write("Error: --opencode requires a path argument.\n");
@@ -20859,7 +20859,7 @@ async function runInitOpencodeFlow(args) {
   return cliExit(EXIT_CODES.SUCCESS);
 }
 async function renderOpencodeValidate(opencodePath) {
-  const { runOpencodeValidate } = await import("./init-opencode-EY7LKRNG.js");
+  const { runOpencodeValidate } = await import("./init-opencode-BQHWMUOD.js");
   const result = await runOpencodeValidate(opencodePath);
   if (!result.ok) {
     process.stderr.write(`init --opencode --validate: ${result.reason ?? "failed"}
@@ -20898,7 +20898,7 @@ async function handleSetupCommandAsync(args) {
   return cliExitFromStatus(exitCode);
 }
 async function runCustomApiSetup(args) {
-  const { configureCustomApi } = await import("./setup-custom-api-XT23L2NX.js");
+  const { configureCustomApi } = await import("./setup-custom-api-UZV66PZA.js");
   const baseUrl = args.options.customApi;
   if (baseUrl === void 0) return EXIT_CODES.SERVER_START_FAILED;
   const input = {

package/dist/{composite-router-AU7QAE3Z.js → composite-router-5OCKHBR3.js}

@@ -4,7 +4,7 @@ import {
   CompositeRoutingError,
   DEFAULT_COMPOSITE_CONFIG,
   createCompositeRouter
-} from "./chunk-65WAPYJ6.js";
+} from "./chunk-6VUIQQ3O.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-AU7QAE3Z.js.map
+//# sourceMappingURL=composite-router-5OCKHBR3.js.map

package/dist/{consensus-vote-FUQNZAHI.js → consensus-vote-HG5BE56Y.js}

@@ -11,27 +11,27 @@ import {
   resetCorrelationTracker,
   runConsensusForGoal,
   unwrapVoteOrThrow
-} from "./chunk-VCNOCG2J.js";
-import "./chunk-AQBM5CAX.js";
+} from "./chunk-DMKV7ANB.js";
+import "./chunk-M3HKW5HF.js";
 import "./chunk-OQB3XC5O.js";
-import "./chunk-DSP6PMDI.js";
-import "./chunk-3ZGYVPN3.js";
-import "./chunk-6YEAUZBF.js";
-import "./chunk-FZ5YJSM6.js";
+import "./chunk-K3TRG2CD.js";
+import "./chunk-ZVZHNAQH.js";
+import "./chunk-SOCKDRK6.js";
+import "./chunk-QUOCOEDQ.js";
 import "./chunk-6T3EPABN.js";
-import "./chunk-MUBJ4ROO.js";
+import "./chunk-OL6TRWBA.js";
 import "./chunk-DVKS77O5.js";
 import "./chunk-KSQSWEFH.js";
-import "./chunk-PBD5LS4B.js";
-import "./chunk-OJCIP6W5.js";
-import "./chunk-7PBXPMKW.js";
-import "./chunk-KIE4R424.js";
+import "./chunk-M7566JRS.js";
+import "./chunk-32AWWH4F.js";
+import "./chunk-G5GOWK5T.js";
+import "./chunk-ERCCVO4N.js";
 import "./chunk-SNJNRDKZ.js";
-import "./chunk-Q2UUVPVY.js";
+import "./chunk-TJ6UFU3I.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-NZCBB4SP.js";
-import "./chunk-R43Y6TXS.js";
-import "./chunk-65WAPYJ6.js";
+import "./chunk-N62DDWV3.js";
+import "./chunk-KLMXZRDK.js";
+import "./chunk-6VUIQQ3O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -49,4 +49,4 @@ export {
   runConsensusForGoal,
   unwrapVoteOrThrow
 };
-//# sourceMappingURL=consensus-vote-FUQNZAHI.js.map
+//# sourceMappingURL=consensus-vote-HG5BE56Y.js.map

package/dist/{context-retriever-BJL3MZTY.js → context-retriever-JNXUAPWJ.js}

@@ -6,18 +6,18 @@ import {
   inferTaskCategory,
   selectRelevantResearch,
   summarizeContextForPrompt
-} from "./chunk-YAZW2ANJ.js";
-import "./chunk-XYVYKPIB.js";
-import "./chunk-ACWU2RRK.js";
+} from "./chunk-JBLM3UZA.js";
+import "./chunk-G6AVXG6F.js";
+import "./chunk-MAP3BVCT.js";
 import "./chunk-NUBSJGQZ.js";
-import "./chunk-FZ5YJSM6.js";
+import "./chunk-QUOCOEDQ.js";
 import "./chunk-6T3EPABN.js";
-import "./chunk-MUBJ4ROO.js";
+import "./chunk-OL6TRWBA.js";
 import "./chunk-DVKS77O5.js";
 import "./chunk-KSQSWEFH.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-NZCBB4SP.js";
-import "./chunk-65WAPYJ6.js";
+import "./chunk-N62DDWV3.js";
+import "./chunk-6VUIQQ3O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -30,4 +30,4 @@ export {
   selectRelevantResearch,
   summarizeContextForPrompt
 };
-//# sourceMappingURL=context-retriever-BJL3MZTY.js.map
+//# sourceMappingURL=context-retriever-JNXUAPWJ.js.map

package/dist/{doctor-deep-CSIYPBWB.js → doctor-deep-IZAAFLBC.js}

@@ -1,8 +1,8 @@
 import {
   formatDeepDiagnostics,
   runDeepDiagnostics
-} from "./chunk-YP25ZDI2.js";
-import "./chunk-65WAPYJ6.js";
+} from "./chunk-TU4FRZWU.js";
+import "./chunk-6VUIQQ3O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -10,4 +10,4 @@ export {
   formatDeepDiagnostics,
   runDeepDiagnostics
 };
-//# sourceMappingURL=doctor-deep-CSIYPBWB.js.map
+//# sourceMappingURL=doctor-deep-IZAAFLBC.js.map

package/dist/{doctor-live-Z3EUWDEM.js → doctor-live-Z5IP2TWY.js}

@@ -1,18 +1,18 @@
 import {
   createAllAdapters,
   probeAllClis
-} from "./chunk-PBD5LS4B.js";
-import "./chunk-OJCIP6W5.js";
-import "./chunk-7PBXPMKW.js";
-import "./chunk-KIE4R424.js";
+} from "./chunk-M7566JRS.js";
+import "./chunk-32AWWH4F.js";
+import "./chunk-G5GOWK5T.js";
+import "./chunk-ERCCVO4N.js";
 import "./chunk-SNJNRDKZ.js";
-import "./chunk-Q2UUVPVY.js";
+import "./chunk-TJ6UFU3I.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-NZCBB4SP.js";
-import "./chunk-R43Y6TXS.js";
+import "./chunk-N62DDWV3.js";
+import "./chunk-KLMXZRDK.js";
 import {
   resolveClassGuardMs
-} from "./chunk-65WAPYJ6.js";
+} from "./chunk-6VUIQQ3O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -146,4 +146,4 @@ export {
   formatLiveReadiness,
   runLiveReadiness
 };
-//# sourceMappingURL=doctor-live-Z3EUWDEM.js.map
+//# sourceMappingURL=doctor-live-Z5IP2TWY.js.map

package/dist/{expert-bridge-NI3ZJASZ.js → expert-bridge-XI4BNDI7.js}

@@ -3,9 +3,9 @@ import {
   shutdownExpertBridge,
   tokenSplitFromUsage,
   totalTokensFromUsage
-} from "./chunk-EGUKCGGM.js";
-import "./chunk-Q2UUVPVY.js";
-import "./chunk-65WAPYJ6.js";
+} from "./chunk-KPYPJGSD.js";
+import "./chunk-TJ6UFU3I.js";
+import "./chunk-6VUIQQ3O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -15,4 +15,4 @@ export {
   tokenSplitFromUsage,
   totalTokensFromUsage
 };
-//# sourceMappingURL=expert-bridge-NI3ZJASZ.js.map
+//# sourceMappingURL=expert-bridge-XI4BNDI7.js.map

package/dist/{factory-663E66YC.js → factory-QAH46LJX.js}

@@ -3,16 +3,16 @@ import {
   createCliAdapter,
   getAvailableClis,
   isCliAvailable
-} from "./chunk-PBD5LS4B.js";
-import "./chunk-OJCIP6W5.js";
-import "./chunk-7PBXPMKW.js";
-import "./chunk-KIE4R424.js";
+} from "./chunk-M7566JRS.js";
+import "./chunk-32AWWH4F.js";
+import "./chunk-G5GOWK5T.js";
+import "./chunk-ERCCVO4N.js";
 import "./chunk-SNJNRDKZ.js";
-import "./chunk-Q2UUVPVY.js";
+import "./chunk-TJ6UFU3I.js";
 import "./chunk-QZUG667L.js";
-import "./chunk-NZCBB4SP.js";
-import "./chunk-R43Y6TXS.js";
-import "./chunk-65WAPYJ6.js";
+import "./chunk-N62DDWV3.js";
+import "./chunk-KLMXZRDK.js";
+import "./chunk-6VUIQQ3O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -22,4 +22,4 @@ export {
   getAvailableClis,
   isCliAvailable
 };
-//# sourceMappingURL=factory-663E66YC.js.map
+//# sourceMappingURL=factory-QAH46LJX.js.map

package/dist/{factory-BQAVRQGT.js → factory-WU2VY6QI.js}

@@ -1,10 +1,10 @@
 import {
   createGitHubProvider,
   createScmProvider
-} from "./chunk-P5WOAEDY.js";
-import "./chunk-EZXYOWCX.js";
-import "./chunk-XYVYKPIB.js";
-import "./chunk-65WAPYJ6.js";
+} from "./chunk-FJKMNLTU.js";
+import "./chunk-3WWE26PG.js";
+import "./chunk-G6AVXG6F.js";
+import "./chunk-6VUIQQ3O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -12,4 +12,4 @@ export {
   createGitHubProvider,
   createScmProvider
 };
-//# sourceMappingURL=factory-BQAVRQGT.js.map
+//# sourceMappingURL=factory-WU2VY6QI.js.map

package/dist/{improvement-review-J6TNYY37.js → improvement-review-E2PK2AEA.js}

@@ -11,10 +11,10 @@ import {
   loadSelfEvalSignals,
   registerImprovementReviewTool,
   runImprovementReview
-} from "./chunk-SMBJQBEC.js";
-import "./chunk-DSP6PMDI.js";
-import "./chunk-3ZGYVPN3.js";
-import "./chunk-65WAPYJ6.js";
+} from "./chunk-JJZF37X2.js";
+import "./chunk-K3TRG2CD.js";
+import "./chunk-ZVZHNAQH.js";
+import "./chunk-6VUIQQ3O.js";
 import "./chunk-2HUC6NZN.js";
 import "./chunk-OQLFRJCW.js";
 import "./chunk-ZPWHCABL.js";
@@ -32,4 +32,4 @@ export {
   registerImprovementReviewTool,
   runImprovementReview
 };
-//# sourceMappingURL=improvement-review-J6TNYY37.js.map
+//# sourceMappingURL=improvement-review-E2PK2AEA.js.map

package/dist/index.d.ts

@@ -753,11 +753,38 @@ interface AvailableCapabilities {
     readonly tools: readonly string[];
     readonly experts: readonly string[];
 }
+/**
+ * Every kind of capability gap, as runtime data.
+ *
+ * The array is the single source and {@link CapabilityGapType} derives from it,
+ * so a validator that needs to check a type at runtime cannot drift from the
+ * union. It did: the persistence layer hardcoded `'tool' | 'expert'`, so every
+ * persisted `tool_refusal` was discarded as malformed on load — the producer
+ * wrote three entries and the next process read zero (#4651).
+ */
+declare const CAPABILITY_GAP_TYPES: readonly ["tool", "expert", "tool_refusal"];
+/** What kind of capability gap this is. Derived from {@link CAPABILITY_GAP_TYPES}. */
+type CapabilityGapType = (typeof CAPABILITY_GAP_TYPES)[number];
 /**
  * A single capability gap with suggestion.
  */
 interface CapabilityGap {
-    readonly type: 'tool' | 'expert';
+    /**
+     * What kind of gap this is.
+     *
+     * `tool` and `expert` are *registry* gaps — a task required something the
+     * registry does not contain. They are produced by {@link detectCapabilityGaps},
+     * which is currently unable to emit one: `requiredCapabilities` is drawn from
+     * static lookup tables whose every entry is already available, so the required
+     * set is a subset of the available set by construction (#4651).
+     *
+     * `tool_refusal` is a *capability* gap of a different kind — a tool that
+     * exists, ran, and declined the work for a reason it can name. It is not
+     * derived from the registry diff; producers record it directly at the point
+     * of refusal. Added by the #4651 panel decision (option C, unanimous among
+     * approvers) because the registry diff could not represent it.
+     */
+    readonly type: CapabilityGapType;
     readonly name: string;
     readonly suggestion: string;
 }