nexus-agents 8.102.2 → 8.103.0

package/dist/{ast-rule-runner-WWUOS722.js → ast-rule-runner-MG5CSPWM.js}

@@ -9,8 +9,8 @@ import {
   getBuiltInAstRulesPath,
   loadRules,
   runAstQaRules
-} from "./chunk-XROOAW6C.js";
-import "./chunk-ZR5JWLC5.js";
+} from "./chunk-PKWOB6SS.js";
+import "./chunk-SZGVILVS.js";
 import "./chunk-UE7A2XHM.js";
 import "./chunk-LWOX65CP.js";
 import "./chunk-PX6F3LHL.js";
@@ -26,4 +26,4 @@ export {
   loadRules,
   runAstQaRules
 };
-//# sourceMappingURL=ast-rule-runner-WWUOS722.js.map
+//# sourceMappingURL=ast-rule-runner-MG5CSPWM.js.map

package/dist/{child-mcp-config-U3I7K7BT.js → child-mcp-config-WPCDGWFE.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-OITVVSWO.js";
 import {
   createLogger
-} from "./chunk-ZR5JWLC5.js";
+} from "./chunk-SZGVILVS.js";
 import "./chunk-UE7A2XHM.js";
 import "./chunk-LWOX65CP.js";
 import "./chunk-PX6F3LHL.js";
@@ -56,4 +56,4 @@ async function generateMcpConfig(options) {
 export {
   generateMcpConfig
 };
-//# sourceMappingURL=child-mcp-config-U3I7K7BT.js.map
+//# sourceMappingURL=child-mcp-config-WPCDGWFE.js.map

package/dist/{chunk-QHMUW6G7.js → chunk-2DOH7LES.js}

@@ -7,12 +7,12 @@ import {
   readGatewayTransport,
   requireApiKey,
   validateApiKeyPresence
-} from "./chunk-D5EDP3EQ.js";
+} from "./chunk-S7GEUHK6.js";
 import {
   assertCustomApiHostResolvesPublic,
   hostnameOf,
   redactApiKey
-} from "./chunk-YKC7ICXJ.js";
+} from "./chunk-KG7QNWWR.js";
 import {
   sanitizeErrorDetails
 } from "./chunk-2NDA4DHW.js";
@@ -40,7 +40,7 @@ import {
   readModelAllowlist,
   recordUsageEvent,
   refineGatewayCatalog
-} from "./chunk-ZR5JWLC5.js";
+} from "./chunk-SZGVILVS.js";
 
 // src/adapters/openai-compat-adapter.ts
 import OpenAI2 from "openai";
@@ -1014,4 +1014,4 @@ export {
   createOpenAICompatAdapter,
   buildOpenAICompatAdapters
 };
-//# sourceMappingURL=chunk-QHMUW6G7.js.map
+//# sourceMappingURL=chunk-2DOH7LES.js.map

package/dist/{chunk-PAICM2DX.js → chunk-3KQJ54R6.js}

@@ -5,7 +5,7 @@ import {
 } from "./chunk-7LP6VJRP.js";
 import {
   SessionMemory
-} from "./chunk-NCQGSHEH.js";
+} from "./chunk-N22A5RSA.js";
 import {
   StatsOnlyAdapter,
   ensureSharedMemoryRegistry
@@ -15,7 +15,7 @@ import {
 } from "./chunk-MUJCGBZW.js";
 import {
   generateId
-} from "./chunk-7YPSWDOV.js";
+} from "./chunk-Z7L5C35G.js";
 import {
   ErrorCode,
   NexusError,
@@ -29,7 +29,7 @@ import {
   ok,
   openSqliteDatabase,
   setSharedMobiMemDbPathResolver
-} from "./chunk-ZR5JWLC5.js";
+} from "./chunk-SZGVILVS.js";
 import {
   nexusDataPath
 } from "./chunk-LWOX65CP.js";
@@ -5768,4 +5768,4 @@ export {
   shutdownToolMemory,
   ToolMemoryManager
 };
-//# sourceMappingURL=chunk-PAICM2DX.js.map
+//# sourceMappingURL=chunk-3KQJ54R6.js.map

package/dist/{chunk-LKMB7ZPK.js → chunk-45HAQ44K.js}

@@ -1,9 +1,9 @@
 import {
   loadPapersRegistry
-} from "./chunk-NACTU45C.js";
+} from "./chunk-ZVNEWTHP.js";
 import {
   getErrorMessage
-} from "./chunk-ZR5JWLC5.js";
+} from "./chunk-SZGVILVS.js";
 
 // src/cli/research-helpers-synthesize.ts
 import { z } from "zod";
@@ -876,4 +876,4 @@ export {
   AttributedInsightSchema,
   synthesizeResearch
 };
-//# sourceMappingURL=chunk-LKMB7ZPK.js.map
+//# sourceMappingURL=chunk-45HAQ44K.js.map

package/dist/{chunk-6NYFFN42.js → chunk-55VTUHIR.js}

@@ -1,10 +1,10 @@
 import {
   createAutoAdapter
-} from "./chunk-C4T7UI2R.js";
+} from "./chunk-SFKQIPPE.js";
 import {
   getDefaultCliCircuitBreakerRegistry,
   mapModelErrorToCategory
-} from "./chunk-AWUTGAQN.js";
+} from "./chunk-OJQNSD2R.js";
 import {
   CircularBuffer,
   ConfigError,
@@ -30,7 +30,7 @@ import {
   resolveModelIdentitySync,
   toRateLimitError,
   warnIfGatewayCostUndeclared
-} from "./chunk-ZR5JWLC5.js";
+} from "./chunk-SZGVILVS.js";
 
 // src/config/model-equivalence.ts
 var VARIANT_QUIRKS = /* @__PURE__ */ new Set(["small", "image"]);
@@ -1050,4 +1050,4 @@ export {
   getGlobalRegistry,
   resetGlobalRegistry
 };
-//# sourceMappingURL=chunk-6NYFFN42.js.map
+//# sourceMappingURL=chunk-55VTUHIR.js.map

package/dist/{chunk-CDCEDAEO.js → chunk-7IU7HDDO.js}

@@ -8,7 +8,7 @@ import {
   getAdaptiveBonus,
   getOutcomeStore,
   hasMeasuredCategory
-} from "./chunk-ZR5JWLC5.js";
+} from "./chunk-SZGVILVS.js";
 
 // src/cli/doctor-deep.ts
 var CLI_NAMES = ["claude", "gemini", "codex", "opencode"];
@@ -148,4 +148,4 @@ export {
   runDeepDiagnostics,
   formatDeepDiagnostics
 };
-//# sourceMappingURL=chunk-CDCEDAEO.js.map
+//# sourceMappingURL=chunk-7IU7HDDO.js.map

package/dist/{chunk-JASILDK4.js → chunk-AJMJPUPR.js}

@@ -7,7 +7,7 @@ import {
   toolStructuredError,
   toolSuccessStructured,
   wrapToolWithTimeout
-} from "./chunk-TBTXBJ7T.js";
+} from "./chunk-XYUNU7UD.js";
 import {
   JsonlStore,
   SECURITY_KEYWORDS,
@@ -21,7 +21,7 @@ import {
   hasMeasuredCategory,
   isDeclaredNeverDeprecate,
   isRegisteredToolName
-} from "./chunk-ZR5JWLC5.js";
+} from "./chunk-SZGVILVS.js";
 import {
   getNexusDataDir,
   nexusDataPath
@@ -2284,4 +2284,4 @@ export {
   runImprovementReview,
   registerImprovementReviewTool
 };
-//# sourceMappingURL=chunk-JASILDK4.js.map
+//# sourceMappingURL=chunk-AJMJPUPR.js.map

package/dist/{chunk-GVSSUYBR.js → chunk-BD4GXOQB.js}

@@ -1,7 +1,7 @@
 import {
   GitHubProvider,
   ScmError
-} from "./chunk-ODLIA33L.js";
+} from "./chunk-XXHO52MZ.js";
 import {
   ROLE_DEFAULT_TRUST,
   ReputationCache,
@@ -12,10 +12,10 @@ import {
   resolveEnvMode,
   resolveReputationGatingMode,
   sanitizeInput
-} from "./chunk-BY5SXMN5.js";
+} from "./chunk-TEKDGJ7T.js";
 import {
   hasToken
-} from "./chunk-KMY3NA44.js";
+} from "./chunk-JGZHI37B.js";
 import {
   CLI_SUBPROCESS_TIMEOUTS,
   createLogger,
@@ -23,7 +23,7 @@ import {
   getErrorMessage,
   getTimeProvider,
   ok
-} from "./chunk-ZR5JWLC5.js";
+} from "./chunk-SZGVILVS.js";
 
 // src/security/firewall/firewall-policy-mode.ts
 import { z } from "zod";
@@ -2650,4 +2650,4 @@ export {
   IssueTriage,
   createIssueTriage
 };
-//# sourceMappingURL=chunk-GVSSUYBR.js.map
+//# sourceMappingURL=chunk-BD4GXOQB.js.map

package/dist/{chunk-UA3TQ773.js → chunk-CP6NEDAC.js}

@@ -3,7 +3,7 @@ import {
   MODEL_IDS,
   getTimeProvider,
   resolveModelIdentitySync
-} from "./chunk-ZR5JWLC5.js";
+} from "./chunk-SZGVILVS.js";
 
 // src/config/model-availability.ts
 var DEFAULT_TTL_MS = 6e4;
@@ -150,4 +150,4 @@ export {
   resetAvailabilityCache,
   filterAvailableModels
 };
-//# sourceMappingURL=chunk-UA3TQ773.js.map
+//# sourceMappingURL=chunk-CP6NEDAC.js.map

package/dist/{chunk-L265O6SP.js → chunk-CPFKM4K7.js}

@@ -3,10 +3,10 @@ import {
   createOpenAICompatAdapter,
   discoverGatewayCatalog,
   readOpenAICompatEnv
-} from "./chunk-QHMUW6G7.js";
+} from "./chunk-2DOH7LES.js";
 import {
   gatewayProxyUrl
-} from "./chunk-D5EDP3EQ.js";
+} from "./chunk-S7GEUHK6.js";
 import {
   DEFAULT_OPENAI_COMPAT_ENDPOINT,
   GATEWAY_COST_ENV,
@@ -22,7 +22,7 @@ import {
   getTimeProvider,
   symbols,
   writeLine
-} from "./chunk-ZR5JWLC5.js";
+} from "./chunk-SZGVILVS.js";
 
 // src/cli/doctor-gateway.ts
 var PROBE_FAMILIES = ["anthropic", "openai", "google"];
@@ -319,4 +319,4 @@ export {
   formatGatewayReport,
   formatGatewaySlotWarnings
 };
-//# sourceMappingURL=chunk-L265O6SP.js.map
+//# sourceMappingURL=chunk-CPFKM4K7.js.map

package/dist/{chunk-5ML3THNH.js → chunk-FADEMLNQ.js}

@@ -1,11 +1,11 @@
 import {
   resolveCliSlot
-} from "./chunk-UA3TQ773.js";
+} from "./chunk-CP6NEDAC.js";
 import {
   createLogger,
   getTimeProvider,
   isRateLimitText
-} from "./chunk-ZR5JWLC5.js";
+} from "./chunk-SZGVILVS.js";
 
 // src/pipeline/expert-bridge.ts
 function resolveCliFromModelString(model) {
@@ -30,7 +30,7 @@ async function getMcpConfigPath() {
   if (cachedMcpConfigPath !== null) return cachedMcpConfigPath;
   mcpConfigInitPromise ??= (async () => {
     try {
-      const { generateMcpConfig } = await import("./child-mcp-config-U3I7K7BT.js");
+      const { generateMcpConfig } = await import("./child-mcp-config-WPCDGWFE.js");
       const config = await generateMcpConfig();
       cachedMcpConfigPath = config.configPath;
       cachedMcpConfigCleanup = config.cleanup;
@@ -110,8 +110,8 @@ var routerInitPromise = null;
 async function getRouter() {
   if (cachedRouter !== null) return cachedRouter;
   routerInitPromise ??= (async () => {
-    const { createAllAdapters } = await import("./factory-ZPHF32DK.js");
-    const { createCompositeRouter } = await import("./composite-router-RX3JZYIE.js");
+    const { createAllAdapters } = await import("./factory-M4I2H672.js");
+    const { createCompositeRouter } = await import("./composite-router-OTSHVAIF.js");
     const adapters = createAllAdapters();
     if (adapters.size === 0) {
       routerInitPromise = null;
@@ -119,7 +119,7 @@ async function getRouter() {
     }
     cachedRouter = adaptCompositeRouter(createCompositeRouter(adapters));
     try {
-      const { createCliCircuitBreakerIntegration } = await import("./cli-circuit-breaker-V2BTK5ZW.js");
+      const { createCliCircuitBreakerIntegration } = await import("./cli-circuit-breaker-FDVTKR3W.js");
       cachedCircuitBreaker = createCliCircuitBreakerIntegration([...adapters.values()]);
     } catch (error) {
       const msg = error instanceof Error ? error.message : String(error);
@@ -252,4 +252,4 @@ export {
   tokenSplitFromUsage,
   executeExpert
 };
-//# sourceMappingURL=chunk-5ML3THNH.js.map
+//# sourceMappingURL=chunk-FADEMLNQ.js.map

package/dist/{chunk-XWMT6ZSS.js → chunk-G47QXLHM.js}

@@ -1,28 +1,28 @@
 import {
   SERVES_PROBE_PROMPT
-} from "./chunk-BYRIEU5S.js";
+} from "./chunk-VFT7OHAD.js";
 import {
   checkGatewayHealth,
   cliFailsVerdict,
   formatGatewaySlotWarnings,
   gatewayVerdict,
   printVoterTransportCheck
-} from "./chunk-L265O6SP.js";
+} from "./chunk-CPFKM4K7.js";
 import {
   NODE_ENGINE_RANGE,
   VERSION,
   isNodeVersionSupported
-} from "./chunk-YSLHLLRK.js";
+} from "./chunk-THCAUXID.js";
 import {
   allOf
 } from "./chunk-EZNIYU5T.js";
 import {
   readOpenAICompatEndpoint,
   readOpenAICompatEnv
-} from "./chunk-QHMUW6G7.js";
+} from "./chunk-2DOH7LES.js";
 import {
   claimGlobalRegistry
-} from "./chunk-6NYFFN42.js";
+} from "./chunk-55VTUHIR.js";
 import {
   capitalize
 } from "./chunk-7LP6VJRP.js";
@@ -34,10 +34,10 @@ import {
   createAllAdapters,
   isCliDisabled,
   probeCli
-} from "./chunk-C4T7UI2R.js";
+} from "./chunk-SFKQIPPE.js";
 import {
   resolveGatewayEnv
-} from "./chunk-YKC7ICXJ.js";
+} from "./chunk-KG7QNWWR.js";
 import {
   getNexusTmpDir
 } from "./chunk-OITVVSWO.js";
@@ -61,7 +61,7 @@ import {
   resolveGatewayCostDeclaration,
   symbols,
   writeLine
-} from "./chunk-ZR5JWLC5.js";
+} from "./chunk-SZGVILVS.js";
 import {
   getLearningDir,
   getOutcomesFile,
@@ -1368,7 +1368,7 @@ async function doctorCommand(options = {}) {
   const result = await runDoctor({ gatewayProbe: options.probe === true });
   printDoctorResults(result);
   if (options.gateway === true || options.probe === true) {
-    const { formatGatewayReport } = await import("./doctor-gateway-report-MRSOR4TR.js");
+    const { formatGatewayReport } = await import("./doctor-gateway-report-ZPZQLULX.js");
     for (const line of formatGatewayReport(result.gateway)) process.stdout.write(line + "\n");
   }
   if (options.fix === true) {
@@ -1385,13 +1385,13 @@ async function runDoctorFix(result) {
   writeLine2("\u2500".repeat(40));
   let fixCount = 0;
   if (!result.dataDirectory.rootExists || result.dataDirectory.subdirectories.some((d) => !d.exists || !d.writable)) {
-    const { initDataDirectories: initDataDirectories2, describeDataDirFix: describeDataDirFix2 } = await import("./setup-data-dir-2EVIVSKU.js");
+    const { initDataDirectories: initDataDirectories2, describeDataDirFix: describeDataDirFix2 } = await import("./setup-data-dir-ZF4KKISC.js");
     const outcome = describeDataDirFix2(initDataDirectories2());
     writeLine2(outcome.line);
     if (outcome.counted) fixCount++;
   }
   if (!result.configFile.found) {
-    const { runConfigInitSync } = await import("./setup-config-EZ5SSK6U.js");
+    const { runConfigInitSync } = await import("./setup-config-IP75P4NY.js");
     const configResult = runConfigInitSync(process.cwd(), false, false);
     if (configResult.success && configResult.created) {
       writeLine2(`\u2713 Generated config: ${configResult.path}`);
@@ -1487,4 +1487,4 @@ export {
   startStdioServer,
   closeServer
 };
-//# sourceMappingURL=chunk-XWMT6ZSS.js.map
+//# sourceMappingURL=chunk-G47QXLHM.js.map

package/dist/{chunk-KMY3NA44.js → chunk-JGZHI37B.js}

@@ -2,7 +2,7 @@ import {
   createLogger,
   err,
   ok
-} from "./chunk-ZR5JWLC5.js";
+} from "./chunk-SZGVILVS.js";
 
 // src/scm/token-resolver.ts
 import { execFile } from "node:child_process";
@@ -87,4 +87,4 @@ export {
   hasToken,
   getTokenEnvVars
 };
-//# sourceMappingURL=chunk-KMY3NA44.js.map
+//# sourceMappingURL=chunk-JGZHI37B.js.map

package/dist/{chunk-YKC7ICXJ.js → chunk-KG7QNWWR.js}

@@ -7,7 +7,7 @@ import {
   createLogger,
   err,
   ok
-} from "./chunk-ZR5JWLC5.js";
+} from "./chunk-SZGVILVS.js";
 
 // src/adapters/sdk/gateway-env.ts
 function readTrimmed(env, name) {
@@ -65,6 +65,13 @@ function readCustomApiSurface(env = process.env) {
     `${CUSTOM_API_SURFACE_ENV} must be one of: responses, chat (default chat); got an unrecognised value`
   );
 }
+var OPENAI_BASE_URL_ENV = "OPENAI_BASE_URL";
+var OPENAI_API_HOST = "api.openai.com";
+function readDirectOpenAiSurface(env = process.env) {
+  const baseUrl = env[OPENAI_BASE_URL_ENV]?.trim() ?? "";
+  if (baseUrl === "" || hostnameOf(baseUrl) === OPENAI_API_HOST) return void 0;
+  return readCustomApiSurface(env);
+}
 function hostnameOf(baseUrl) {
   try {
     const host = new URL(baseUrl).hostname;
@@ -320,9 +327,10 @@ export {
   warnDeprecatedGatewayEnvOnce,
   readGatewayEnv,
   readCustomApiSurface,
+  readDirectOpenAiSurface,
   hostnameOf,
   redactApiKey,
   validateCustomApiBaseUrl,
   assertCustomApiHostResolvesPublic
 };
-//# sourceMappingURL=chunk-YKC7ICXJ.js.map
+//# sourceMappingURL=chunk-KG7QNWWR.js.map

package/dist/chunk-KG7QNWWR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/sdk/gateway-env.ts","../src/adapters/sdk/custom-api-validation.ts"],"sourcesContent":["/**\n * Env resolver for the single-model `custom-openai` gateway path (#4392\n * increment 3).\n *\n * Two mechanisms read an OpenAI-compatible gateway from the environment:\n *\n *   A. the single-model SDK path — `SdkAdapter({ providerId: 'custom-openai' })`\n *      via `auto-adapter.ts`, which mints the `api:custom-openai` routing arm\n *      under `NEXUS_BILLING_MODE=api`;\n *   B. the discovery path — `openai-compat-adapter.ts`, which lists the\n *      gateway's models, serves voters in-process and registers ONE\n *      `api:<endpoint>` arm.\n *\n * Both take a base URL and a key. Mechanism A historically read\n * `NEXUS_CUSTOM_API_BASE_URL` / `NEXUS_CUSTOM_API_KEY`; mechanism B reads\n * `NEXUS_OPENAI_COMPAT_URL` / `NEXUS_OPENAI_COMPAT_KEY`. This module makes the\n * old pair a deprecated ALIAS of the new pair for mechanism A only — a pure\n * rename shim, resolution `new ?? old` per variable (panel\n * vote-1789558437481-yup142p runoff, option C). Mechanism B is deliberately\n * NOT fed from the alias: renaming to the new names is what opts an operator\n * into the gateway path, and the deprecation warn says so. The aliases are\n * dropped in the next major (#6291).\n *\n * @module adapters/sdk/gateway-env\n */\n\nimport type { ILogger } from '../../core/index.js';\nimport { ConfigError, createLogger } from '../../core/index.js';\nimport {\n  DEPRECATED_GATEWAY_ENV_ALIASES,\n  OPENAI_COMPAT_KEY_ENV,\n  OPENAI_COMPAT_URL_ENV,\n} from './types.js';\n\n/** One deprecated gateway env name found set in the environment. */\nexport interface DeprecatedGatewayEnvUse {\n  readonly name: string;\n  readonly replacement: string;\n  /** True when the replacement is also set, so this alias is ignored. */\n  readonly shadowed: boolean;\n}\n\n/** The resolved mechanism-A gateway pair plus every deprecated name in use. */\nexport interface GatewayEnv {\n  /** `NEXUS_OPENAI_COMPAT_URL ?? NEXUS_CUSTOM_API_BASE_URL`, trimmed; empty is unset. */\n  readonly baseUrl: string | undefined;\n  /** `NEXUS_OPENAI_COMPAT_KEY ?? NEXUS_CUSTOM_API_KEY`, trimmed; empty is unset. */\n  readonly apiKey: string | undefined;\n  /** Deprecated names that are set, in table order — empty when none is. */\n  readonly deprecated: readonly DeprecatedGatewayEnvUse[];\n}\n\n/** A set env value, trimmed; `undefined` for unset, empty, or whitespace-only. */\nfunction readTrimmed(env: NodeJS.ProcessEnv, name: string): string | undefined {\n  const value = env[name]?.trim();\n  return value === undefined || value === '' ? undefined : value;\n}\n\n/**\n * Resolve the mechanism-A gateway pair from `env` (default `process.env`).\n * Pure: no logging, no once-guard. `readGatewayEnv` is the production entry;\n * this one serves the report surfaces (env-schema, doctor) that must not warn.\n */\nexport function resolveGatewayEnv(env: NodeJS.ProcessEnv = process.env): GatewayEnv {\n  const deprecated: DeprecatedGatewayEnvUse[] = [];\n  for (const alias of DEPRECATED_GATEWAY_ENV_ALIASES) {\n    if (readTrimmed(env, alias.deprecated) === undefined) continue;\n    deprecated.push({\n      name: alias.deprecated,\n      replacement: alias.replacement,\n      shadowed: readTrimmed(env, alias.replacement) !== undefined,\n    });\n  }\n  return {\n    baseUrl: readWithAlias(env, OPENAI_COMPAT_URL_ENV),\n    apiKey: readWithAlias(env, OPENAI_COMPAT_KEY_ENV),\n    deprecated,\n  };\n}\n\n/** `new ?? old` for one variable, the old spelling taken from the alias table. */\nfunction readWithAlias(env: NodeJS.ProcessEnv, replacement: string): string | undefined {\n  const current = readTrimmed(env, replacement);\n  if (current !== undefined) return current;\n  const alias = DEPRECATED_GATEWAY_ENV_ALIASES.find((a) => a.replacement === replacement);\n  return alias === undefined ? undefined : readTrimmed(env, alias.deprecated);\n}\n\nconst defaultLogger = createLogger({ component: 'gateway-env' });\n\n/**\n * Once per process: a deprecated name is set, so the operator hears about it\n * exactly once, from whichever reader gets there first (or from server\n * startup). Names only — never a value.\n */\nlet deprecationWarned = false;\n\n/** Test-only: re-arm the once-guard. */\nexport function _resetDeprecatedGatewayEnvWarning(): void {\n  deprecationWarned = false;\n}\n\n/**\n * Emit the one deprecation warn if any deprecated gateway name is set and it\n * has not been emitted yet in this process. Safe to call from every reader;\n * the gateway bootstrap (`cli-server-gateway.ts` `tryWireGatewayAdapters`)\n * calls it at server startup so the line appears even when no reader of the\n * alias is reached (plan billing with a CLI available never consults\n * mechanism A).\n */\nexport function warnDeprecatedGatewayEnvOnce(\n  env: NodeJS.ProcessEnv = process.env,\n  logger: ILogger = defaultLogger\n): void {\n  if (deprecationWarned) return;\n  const { deprecated } = resolveGatewayEnv(env);\n  if (deprecated.length === 0) return;\n  deprecationWarned = true;\n  logger.warn(formatDeprecationWarning(deprecated));\n}\n\n/**\n * The warn line. Each name says whether it is honoured or ignored (shadowed\n * by its replacement), then the option-C consequence: these names configure\n * only the single-model `custom-openai` path, and the rename is the opt-in\n * to the gateway path. No value is ever interpolated — a URL can carry\n * userinfo and the key is the key.\n */\nfunction formatDeprecationWarning(deprecated: readonly DeprecatedGatewayEnvUse[]): string {\n  const uses = deprecated\n    .map((d) =>\n      d.shadowed\n        ? `${d.name} (ignored: ${d.replacement} is set)`\n        : `${d.name} (honoured; rename to ${d.replacement})`\n    )\n    .join('; ');\n  return (\n    `Deprecated gateway environment variable(s) set (#4392): ${uses}. ` +\n    'These names configure only the single-model custom-openai path and stay aliases ' +\n    'until the next major (#6291). Rename to NEXUS_OPENAI_COMPAT_* to opt into the ' +\n    'gateway path (model discovery, in-process voter transport, api:<endpoint> arm).'\n  );\n}\n\n/**\n * The production reader for mechanism A: resolve the pair and emit the\n * once-per-process deprecation warn when a deprecated name is set.\n */\nexport function readGatewayEnv(\n  env: NodeJS.ProcessEnv = process.env,\n  logger: ILogger = defaultLogger\n): GatewayEnv {\n  const resolved = resolveGatewayEnv(env);\n  if (resolved.deprecated.length > 0) warnDeprecatedGatewayEnvOnce(env, logger);\n  return resolved;\n}\n\n/**\n * The OpenAI API surface the single-model `custom-openai` path calls (#6645):\n * `chat` is `POST <base>/chat/completions`, `responses` is `POST <base>/responses`.\n */\ntype CustomApiSurface = 'chat' | 'responses';\n\nconst CUSTOM_API_SURFACE_ENV = 'NEXUS_CUSTOM_API_SURFACE';\n\n/**\n * Read `NEXUS_CUSTOM_API_SURFACE` (#6645). Unset or empty means `chat`: the\n * AI SDK's default is the Responses API, but OpenAI-spec gateways commonly\n * serve `/chat/completions` only, so `responses` is the opt-in. Any other\n * value throws a `ConfigError` rather than guessing a surface.\n */\nexport function readCustomApiSurface(env: NodeJS.ProcessEnv = process.env): CustomApiSurface {\n  const raw = env[CUSTOM_API_SURFACE_ENV]?.trim().toLowerCase() ?? '';\n  if (raw === '' || raw === 'chat') return 'chat';\n  if (raw === 'responses') return 'responses';\n  throw new ConfigError(\n    `${CUSTOM_API_SURFACE_ENV} must be one of: responses, chat (default chat); got an unrecognised value`\n  );\n}\n\n/** Read by `@ai-sdk/openai` itself; the direct OpenAI adapter never passes a baseURL. */\nconst OPENAI_BASE_URL_ENV = 'OPENAI_BASE_URL';\nconst OPENAI_API_HOST = 'api.openai.com';\n\n/**\n * The surface the direct OpenAI adapter (`OPENAI_API_KEY`) calls (#6654).\n * `undefined` means the provider's own default (the Responses API), exactly\n * as before: `OPENAI_BASE_URL` unset, blank, or naming `api.openai.com`, and\n * `NEXUS_CUSTOM_API_SURFACE` is then not read at all. Any other host is an\n * OpenAI-compatible gateway, so it gets {@link readCustomApiSurface}'s answer:\n * chat completions unless `NEXUS_CUSTOM_API_SURFACE=responses`.\n */\nexport function readDirectOpenAiSurface(\n  env: NodeJS.ProcessEnv = process.env\n): CustomApiSurface | undefined {\n  const baseUrl = env[OPENAI_BASE_URL_ENV]?.trim() ?? '';\n  if (baseUrl === '' || hostnameOf(baseUrl) === OPENAI_API_HOST) return undefined;\n  return readCustomApiSurface(env);\n}\n\n/**\n * The host of a gateway base URL, for log lines and error messages. A base\n * URL can carry userinfo (`https://user:key@host/v1`), so the full string\n * must never reach a log. Two failure shapes, both replaced rather than\n * echoed: a string that does not parse at all, and a scheme-less paste such\n * as `key@host/v1`, which WHATWG parses with `key:` as the SCHEME and an\n * empty hostname (measured: `new URL('u:pw@host/v1').hostname === ''`).\n */\nexport function hostnameOf(baseUrl: string): string {\n  try {\n    const host = new URL(baseUrl).hostname;\n    return host === '' ? '<no host>' : host;\n  } catch {\n    return '<unparseable url>';\n  }\n}\n\n/**\n * Every exact occurrence of `apiKey` in `message` replaced with `<redacted>`.\n * The pattern-based sanitizer only knows vendor key shapes; a gateway key can\n * be any string, and a 401 body may echo the one it rejected. An empty key\n * matches nothing (`replaceAll('')` would interleave the marker).\n */\nexport function redactApiKey(message: string, apiKey: string | undefined): string {\n  return apiKey === undefined || apiKey === '' ? message : message.replaceAll(apiKey, '<redacted>');\n}\n","/**\n * Validation for the `custom-openai` SDK adapter's gateway URL.\n *\n * The base URL is user-provided, so without validation the adapter becomes\n * an SSRF vector: a malicious prompt that reshaped env vars, or a typo in\n * the config, could point nexus-agents at `http://169.254.169.254/` (AWS\n * metadata) or `http://localhost:5432/` (internal services). This module\n * rejects such URLs unless the user explicitly opts in via\n * `NEXUS_CUSTOM_API_ALLOW_PRIVATE=1`.\n *\n * Called out in the #2119 consensus vote by the Security Engineer role.\n *\n * @module adapters/sdk/custom-api-validation\n */\n\nimport { isIPv4, isIPv6 } from 'node:net';\nimport { lookup as dnsLookup } from 'node:dns/promises';\nimport { ConfigError, ok, err, createLogger, type Result } from '../../core/index.js';\nimport { CUSTOM_API_ALLOW_PRIVATE_ENV } from './types.js';\n\nconst logger = createLogger({ module: 'custom-api-validation' });\n\n/**\n * Why a given URL was rejected. Machine-readable so error messages can\n * distinguish root causes in downstream tooling.\n */\nexport type BaseUrlRejectionReason =\n  | 'empty'\n  | 'not_a_url'\n  | 'not_http_https'\n  | 'loopback'\n  | 'link_local'\n  | 'private_range'\n  | 'reserved';\n\ninterface RejectionDetail {\n  readonly reason: BaseUrlRejectionReason;\n  readonly message: string;\n}\n\n/**\n * Validates a user-provided custom-gateway base URL. Returns the URL as an\n * `ok` Result if it passes, or a `ConfigError` with a machine-readable\n * reason if it fails.\n *\n * Pass `{ allowPrivate: true }` (or set the env var) to bypass the SSRF\n * checks — use this only when the gateway is on a trusted internal host\n * and you accept the risk.\n */\nexport function validateCustomApiBaseUrl(\n  raw: string | undefined,\n  opts: { readonly allowPrivate?: boolean } = {}\n): Result<URL, ConfigError> {\n  if (raw === undefined || raw.trim() === '') {\n    return err(\n      new ConfigError(\n        'Custom API base URL is required but missing. Set NEXUS_OPENAI_COMPAT_URL or pass `baseUrl` in config.'\n      )\n    );\n  }\n\n  let url: URL;\n  try {\n    url = new URL(raw);\n  } catch {\n    // Not echoed: these messages reach the resilient-adapter warn line, and\n    // the raw string can carry userinfo (#4392 inc 3).\n    return err(new ConfigError('Custom API base URL is not a valid URL'));\n  }\n\n  if (url.protocol !== 'http:' && url.protocol !== 'https:') {\n    return err(\n      new ConfigError(`Custom API base URL must use http or https, got \"${url.protocol}\"`)\n    );\n  }\n\n  const allowPrivate = opts.allowPrivate === true || resolveAllowPrivateFromEnv();\n  if (!allowPrivate) {\n    const rejection = classifyPrivateHost(url.hostname);\n    if (rejection !== null) {\n      return err(\n        new ConfigError(\n          `Custom API base URL rejected (SSRF guard, reason=\"${rejection.reason}\"): ${rejection.message}. ` +\n            `Set ${CUSTOM_API_ALLOW_PRIVATE_ENV}=1 to bypass if the gateway runs on a trusted internal host.`\n        )\n      );\n    }\n  }\n\n  return ok(url);\n}\n\nfunction resolveAllowPrivateFromEnv(): boolean {\n  // Deliberately strict (case-sensitive, not parseBoolEnv): this disables an\n  // SSRF guard, so we don't want extra case variants (e.g. `TRUE`) to loosen\n  // the control. Fail-closed on anything but exact `1`/`true` (#3297).\n  const v = process.env[CUSTOM_API_ALLOW_PRIVATE_ENV];\n  return v === '1' || v === 'true';\n}\n\n/**\n * Returns a rejection reason if the hostname resolves (by string form) to\n * a loopback, link-local, or RFC 1918 private address; `null` otherwise.\n *\n * Note: this is a string-level check. It does NOT perform DNS resolution,\n * so a public DNS name that secretly resolves to a private IP will pass.\n * For that level of defense, callers should additionally run\n * {@link assertCustomApiHostResolvesPublic}, which performs a DNS lookup\n * and classifies each resolved address with the same range tables below.\n */\nfunction classifyPrivateHost(hostname: string): RejectionDetail | null {\n  const normalized = normalizeHost(hostname);\n\n  // Literal IP addresses — classify directly against the range tables.\n  const literal = classifyIpAddress(normalized);\n  if (literal !== 'not_an_ip') {\n    return literal;\n  }\n\n  // Hostname literals that resolve to loopback without needing DNS\n  if (\n    normalized === 'localhost' ||\n    normalized.endsWith('.localhost') ||\n    normalized.endsWith('.local') // mDNS\n  ) {\n    return {\n      reason: 'loopback',\n      message: `hostname \"${hostname}\" resolves to loopback/mDNS`,\n    };\n  }\n\n  return null;\n}\n\n/**\n * Strips IPv6 bracket wrapping (URL.hostname yields \"[::1]\") and lowercases,\n * giving the bare form the `node:net` checks expect. Shared by the sync and\n * async guards so the normalization rule lives in one place.\n */\nfunction normalizeHost(hostname: string): string {\n  const stripped =\n    hostname.startsWith('[') && hostname.endsWith(']') ? hostname.slice(1, -1) : hostname;\n  return stripped.toLowerCase();\n}\n\n/**\n * Classifies a single (already normalized, bracket-stripped) address string.\n * Returns:\n *  - a {@link RejectionDetail} if it is a private/loopback/link-local/reserved IP,\n *  - `null` if it is a public IP literal (safe),\n *  - the sentinel `'not_an_ip'` if the string is not an IP literal at all.\n *\n * This is the shared per-address classifier reused by both the sync\n * string-level guard ({@link classifyPrivateHost}) and the async\n * DNS-resolve-time guard ({@link assertCustomApiHostResolvesPublic}), so the\n * IPv4/IPv6 range tables live in exactly one place.\n */\nfunction classifyIpAddress(normalized: string): RejectionDetail | null | 'not_an_ip' {\n  if (isIPv4(normalized)) {\n    return classifyIPv4(normalized);\n  }\n  if (isIPv6(normalized)) {\n    return classifyIPv6(normalized);\n  }\n  return 'not_an_ip';\n}\n\n/** Verdict for a host that is already an IP literal — no DNS required. */\nfunction classifyLiteral(hostname: string, normalized: string): Result<void, ConfigError> {\n  const literal = classifyIpAddress(normalized);\n  if (literal === null || literal === 'not_an_ip') return ok(undefined);\n  return err(\n    new ConfigError(\n      `Custom API host '${hostname}' is a ${literal.reason} address: ${literal.message}`\n    )\n  );\n}\n\n/**\n * DNS-resolve-time SSRF guard for the custom-openai gateway.\n *\n * The sync {@link validateCustomApiBaseUrl} only inspects the hostname as a\n * string, so a PUBLIC DNS name that resolves to a PRIVATE/loopback/link-local\n * IP (e.g. an attacker-controlled `gateway.evil.test` pointing at\n * `169.254.169.254`) slips past it. This function closes that gap: it resolves\n * the hostname and runs the EXISTING IP classification against every returned\n * address, failing closed if ANY of them is private.\n *\n * Behaviour:\n *  - `allowPrivate` (opt or env) → bypass, returns `ok` (matches the sync guard).\n *  - hostname is already an IP literal → no DNS needed; the sync guard already\n *    classified literals at construction, so return `ok`.\n *  - otherwise `dns.lookup(hostname, { all: true })` and classify each address.\n *    If ANY resolves private → `err(ConfigError)`.\n *  - on a `dns.lookup` THROW (transient/NXDOMAIN/network error) → log debug and\n *    return `ok`. Failing closed here is too aggressive: it would break legit\n *    gateways on a flaky resolver, and this is additive defense-in-depth layered\n *    on top of the sync string guard that already ran at construction. We only\n *    REJECT on a SUCCESSFUL resolution to a private address.\n *\n * Residual risk (TOCTOU): this is RESOLVE-time, not socket-connect-time. A name\n * that passes here could rebind to a private IP before the actual connect\n * (DNS rebinding). A full fix needs a custom `fetch` `lookup` hook validating\n * the peer address at the socket layer — out of scope for this LOW\n * defense-in-depth pass (#3426).\n */\nexport async function assertCustomApiHostResolvesPublic(\n  hostname: string,\n  opts: { readonly allowPrivate?: boolean } = {}\n): Promise<Result<void, ConfigError>> {\n  const allowPrivate = opts.allowPrivate === true || resolveAllowPrivateFromEnv();\n  if (allowPrivate) {\n    return ok(undefined);\n  }\n\n  const normalized = normalizeHost(hostname);\n\n  // A literal needs no DNS, but it is still classified HERE rather than\n  // assumed handled elsewhere. This used to return ok for any literal on the\n  // grounds that the sync guard had classified it at construction — but\n  // `discoverModels` calls only this guard, never the sync one, so on that\n  // path each deferred to the other and neither ran. `http://169.254.169.254/`\n  // reached IMDS, from a base URL that can come from a file rather than from\n  // operator intent.\n  if (isIPv4(normalized) || isIPv6(normalized)) {\n    return classifyLiteral(hostname, normalized);\n  }\n\n  // Only `address` is read; the resolver's `family` is intentionally NOT\n  // trusted — `classifyIpAddress` re-derives v4/v6 from the address string, so\n  // a mislabeled family in the lookup result cannot let a private IP slip past.\n  let addresses: ReadonlyArray<{ readonly address: string }>;\n  try {\n    addresses = await dnsLookup(hostname, { all: true });\n  } catch (error) {\n    // Fail OPEN: transient/NXDOMAIN/network errors must not break legit\n    // gateways. The sync string guard already ran; this is additive only.\n    logger.debug('custom-api SSRF resolve check: DNS lookup failed, skipping (fail-open)', {\n      hostname,\n      error: error instanceof Error ? error.message : String(error),\n    });\n    return ok(undefined);\n  }\n\n  const rejection = firstPrivateAddress(addresses);\n  if (rejection !== null) {\n    return err(\n      new ConfigError(\n        `Custom API base URL rejected (SSRF resolve guard, reason=\"${rejection.reason}\"): ` +\n          `hostname \"${hostname}\" resolved to ${rejection.message}. ` +\n          `Set ${CUSTOM_API_ALLOW_PRIVATE_ENV}=1 to bypass if the gateway runs on a trusted internal host.`\n      )\n    );\n  }\n\n  return ok(undefined);\n}\n\n/**\n * Returns the {@link RejectionDetail} for the first resolved address that\n * classifies as private/loopback/link-local/reserved, or `null` if every\n * address is public. Fail-closed: any single private hit trips the guard.\n */\nfunction firstPrivateAddress(\n  addresses: ReadonlyArray<{ readonly address: string }>\n): RejectionDetail | null {\n  for (const { address } of addresses) {\n    const rejection = classifyIpAddress(address.toLowerCase());\n    if (rejection !== null && rejection !== 'not_an_ip') {\n      return rejection;\n    }\n  }\n  return null;\n}\n\n/**\n * IPv4 ranges the SSRF guard rejects, in order of specificity.\n *\n * \"Not RFC1918\" is not the same as \"public\". The blocks below RFC1918 are\n * here because each is reachable from a host and serves something: 100.64/10\n * carries Alibaba Cloud's metadata endpoint, 192.0.0/24 carries a legacy\n * Oracle Cloud one, and multicast/reserved/broadcast reach the local segment\n * rather than the internet (second pass over #4884).\n */\nconst IPV4_RULES: ReadonlyArray<{\n  readonly match: (a: number, b: number, c: number) => boolean;\n  readonly reason: BaseUrlRejectionReason;\n  readonly label: string;\n}> = [\n  { match: (a) => a === 127, reason: 'loopback', label: 'IPv4 loopback' },\n  { match: (a) => a === 10, reason: 'private_range', label: 'IPv4 private (10/8)' },\n  {\n    match: (a, b) => a === 172 && b >= 16 && b <= 31,\n    reason: 'private_range',\n    label: 'IPv4 private (172.16/12)',\n  },\n  {\n    match: (a, b) => a === 192 && b === 168,\n    reason: 'private_range',\n    label: 'IPv4 private (192.168/16)',\n  },\n  {\n    match: (a, b) => a === 169 && b === 254,\n    reason: 'link_local',\n    label: 'IPv4 link-local (169.254/16 — AWS IMDS)',\n  },\n  { match: (a) => a === 0, reason: 'reserved', label: 'IPv4 reserved (0/8)' },\n  {\n    match: (a, b) => a === 100 && b >= 64 && b <= 127,\n    reason: 'private_range',\n    label: 'IPv4 shared address space (100.64/10 — CGNAT, Alibaba metadata)',\n  },\n  {\n    match: (a, b, c) => a === 192 && b === 0 && c === 0,\n    reason: 'reserved',\n    label: 'IPv4 IETF protocol assignments (192.0.0/24 — legacy Oracle metadata)',\n  },\n  {\n    match: (a, b) => a === 198 && (b === 18 || b === 19),\n    reason: 'reserved',\n    label: 'IPv4 benchmarking (198.18/15)',\n  },\n  { match: (a) => a >= 224 && a <= 239, reason: 'reserved', label: 'IPv4 multicast (224/4)' },\n  {\n    match: (a) => a >= 240,\n    reason: 'reserved',\n    label: 'IPv4 reserved (240/4, includes 255.255.255.255 broadcast)',\n  },\n];\n\nfunction classifyIPv4(ip: string): RejectionDetail | null {\n  const parts = ip.split('.').map((p) => Number.parseInt(p, 10));\n  if (parts.length !== 4 || parts.some((n) => Number.isNaN(n))) return null;\n  const [a, b, c] = parts as [number, number, number, number];\n  for (const rule of IPV4_RULES) {\n    if (rule.match(a, b, c)) {\n      return { reason: rule.reason, message: `${rule.label} (${ip})` };\n    }\n  }\n  return null;\n}\n\n/**\n * Expand an IPv6 literal to its eight 16-bit groups, or null if unparseable.\n *\n * A trailing dotted quad (`::ffff:1.2.3.4`) is folded into two groups first,\n * so callers see one representation regardless of spelling.\n */\nfunction foldTrailingQuad(s: string): string | null {\n  const dotted = /(?:^|:)((?:\\d{1,3}\\.){3}\\d{1,3})$/.exec(s);\n  if (dotted?.[1] === undefined) return s;\n  const q = dotted[1].split('.').map((n) => Number.parseInt(n, 10));\n  if (q.length !== 4 || q.some((n) => Number.isNaN(n) || n < 0 || n > 255)) return null;\n  const hi = (((q[0] ?? 0) << 8) | (q[1] ?? 0)).toString(16);\n  const lo = (((q[2] ?? 0) << 8) | (q[3] ?? 0)).toString(16);\n  return `${s.slice(0, s.length - dotted[1].length)}${hi}:${lo}`;\n}\n\nfunction toHextets(ip: string): number[] | null {\n  const s = foldTrailingQuad(ip.toLowerCase());\n  if (s === null) return null;\n  const halves = s.split('::');\n  if (halves.length > 2) return null;\n  const head = halves[0] === '' || halves[0] === undefined ? [] : halves[0].split(':');\n  const tail = halves[1] === '' || halves[1] === undefined ? [] : halves[1].split(':');\n  const groups =\n    halves.length === 1\n      ? head\n      : [...head, ...Array<string>(8 - head.length - tail.length).fill('0'), ...tail];\n  if (groups.length !== 8) return null;\n  const out = groups.map((g) => Number.parseInt(g === '' ? '0' : g, 16));\n  return out.some((n) => Number.isNaN(n) || n < 0 || n > 0xffff) ? null : out;\n}\n\n/**\n * The IPv4 address embedded in an IPv6 literal, in dotted form, or null.\n *\n * Covers every prefix that carries a routable IPv4 payload: IPv4-mapped\n * (`::ffff:0:0/96`), IPv4-translated (`::ffff:0:0:0/96`), the NAT64\n * well-known prefix (`64:ff9b::/96`), 6to4 (`2002::/16`), and the deprecated\n * IPv4-compatible form (`::a.b.c.d`). Each is the same destination under a\n * different spelling, and the IPv4 rules must apply to all of them.\n */\nfunction embeddedIPv4(g: readonly number[]): string | null {\n  // 6to4 is the odd one out: the payload sits in hextets 1-2, not 6-7, so it\n  // cannot share the trailing-quad extraction below.\n  if (g[0] === 0x2002) return hextetPairToDotted(g[1] ?? 0, g[2] ?? 0);\n  const top = g.slice(0, 6);\n  const prefixes: ReadonlyArray<readonly number[]> = [\n    [0, 0, 0, 0, 0, 0xffff], // ::ffff:0:0/96    — IPv4-mapped\n    [0, 0, 0, 0, 0xffff, 0], // ::ffff:0:0:0/96  — IPv4-translated\n    [0x64, 0xff9b, 0, 0, 0, 0], // 64:ff9b::/96  — NAT64 well-known\n    [0, 0, 0, 0, 0, 0], // ::a.b.c.d           — deprecated IPv4-compatible\n  ];\n  const matched = prefixes.some((p) => p.every((v, i) => top[i] === v));\n  if (!matched) return null;\n  const g6 = g[6] ?? 0;\n  const g7 = g[7] ?? 0;\n  // `::` and `::1` are their own addresses, not embedded IPv4.\n  if (top.every((v) => v === 0) && g6 === 0 && g7 <= 1) return null;\n  return hextetPairToDotted(g6, g7);\n}\n\n/** The dotted IPv4 address carried by two consecutive 16-bit hextets. */\nfunction hextetPairToDotted(hi: number, lo: number): string {\n  return [(hi >> 8) & 255, hi & 255, (lo >> 8) & 255, lo & 255].join('.');\n}\n\n/**\n * Classify an IPv6 address by its first hextet, or null if it is not in a\n * non-global prefix.\n *\n * Numeric rather than a string prefix test. The previous `startsWith('fe80:')`\n * covered 1/64th of fe80::/10 — `febf::1` is equally link-local and was\n * allowed — and site-local fec0::/10 had no check at all (second pass over #4884).\n */\nfunction classifyIPv6Prefix(first: number, ip: string): RejectionDetail | null {\n  if (first >= 0xfc00 && first <= 0xfdff) {\n    return { reason: 'private_range', message: `IPv6 unique-local (${ip}, fc00::/7)` };\n  }\n  if (first >= 0xfe80 && first <= 0xfebf) {\n    return { reason: 'link_local', message: `IPv6 link-local (${ip}, fe80::/10)` };\n  }\n  if (first >= 0xfec0 && first <= 0xfeff) {\n    return { reason: 'private_range', message: `IPv6 site-local (${ip}, fec0::/10)` };\n  }\n  return null;\n}\n\nfunction classifyIPv6(ip: string): RejectionDetail | null {\n  const lower = ip.toLowerCase();\n  if (lower === '::1') return { reason: 'loopback', message: `IPv6 loopback (${ip})` };\n\n  const groups = toHextets(lower);\n  if (groups === null) return null;\n\n  const prefixDetail = classifyIPv6Prefix(groups[0] ?? 0, ip);\n  if (prefixDetail !== null) return prefixDetail;\n\n  if (groups.every((n) => n === 0)) {\n    return { reason: 'reserved', message: `IPv6 unspecified (${ip}) — routes to localhost` };\n  }\n\n  // An IPv4 address written in IPv6 form is still that IPv4 address, and\n  // `isIPv6` is true for it so it never reached the IPv4 rules — IMDS,\n  // loopback and RFC1918 were all reachable this way. Note the URL parser\n  // normalises the dotted spelling to hex, so the hex form is the one that\n  // actually arrives.\n  const v4 = embeddedIPv4(groups);\n  if (v4 === null) return null;\n  const detail = classifyIPv4(v4);\n  return detail === null\n    ? null\n    : { reason: detail.reason, message: `${detail.message} via IPv6 (${ip})` };\n}\n"],"mappings":"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","names":["logger"]}