nexus-agents 2.174.1 → 2.174.2

package/dist/{chunk-4TULFLTP.js → chunk-KAL22DYO.js}

@@ -2,7 +2,7 @@ import {
   CACHE_TIMEOUTS,
   createLogger,
   getTimeProvider
-} from "./chunk-KPM6FF6T.js";
+} from "./chunk-Y5JA7XEO.js";
 
 // src/security/trust-types.ts
 import { z } from "zod";
@@ -560,4 +560,4 @@ export {
   resolveReputationGatingMode,
   gateWithReputation
 };
-//# sourceMappingURL=chunk-4TULFLTP.js.map
+//# sourceMappingURL=chunk-KAL22DYO.js.map

package/dist/{chunk-JF4Y6CBM.js → chunk-KU2HPCJG.js}

@@ -1,14 +1,14 @@
 import {
   GitHubProvider,
   ScmError
-} from "./chunk-VLSXX6KA.js";
+} from "./chunk-E35RUETV.js";
 import {
   resolveToken
-} from "./chunk-DU2YW5DH.js";
+} from "./chunk-HUYP2XXH.js";
 import {
   err,
   ok
-} from "./chunk-KPM6FF6T.js";
+} from "./chunk-Y5JA7XEO.js";
 
 // src/scm/factory.ts
 async function createScmProvider(config) {
@@ -41,4 +41,4 @@ export {
   createScmProvider,
   createGitHubProvider
 };
-//# sourceMappingURL=chunk-JF4Y6CBM.js.map
+//# sourceMappingURL=chunk-KU2HPCJG.js.map

package/dist/{chunk-TL4CD7XY.js → chunk-KWKGX7LC.js}

@@ -1,7 +1,7 @@
 import {
   GitHubProvider,
   ScmError
-} from "./chunk-VLSXX6KA.js";
+} from "./chunk-E35RUETV.js";
 import {
   ROLE_DEFAULT_TRUST,
   ReputationCache,
@@ -11,17 +11,17 @@ import {
   gateWithReputation,
   resolveReputationGatingMode,
   sanitizeInput
-} from "./chunk-4TULFLTP.js";
+} from "./chunk-KAL22DYO.js";
 import {
   emitPolicyEvent
-} from "./chunk-LRGCUZZX.js";
+} from "./chunk-VSETLO4Q.js";
 import {
   CLI_SUBPROCESS_TIMEOUTS,
   createLogger,
   err,
   getTimeProvider,
   ok
-} from "./chunk-KPM6FF6T.js";
+} from "./chunk-Y5JA7XEO.js";
 
 // src/security/trust-classifier.ts
 function mapAuthorAssociation(association) {
@@ -1211,4 +1211,4 @@ export {
   IssueTriage,
   createIssueTriage
 };
-//# sourceMappingURL=chunk-TL4CD7XY.js.map
+//# sourceMappingURL=chunk-KWKGX7LC.js.map

package/dist/{chunk-RYGZPL4A.js → chunk-KYF4YAZO.js}

@@ -7,7 +7,7 @@ import {
   toolStructuredError,
   toolSuccessStructured,
   wrapToolWithTimeout
-} from "./chunk-H2HZSKLO.js";
+} from "./chunk-5QVJCBM4.js";
 import {
   JsonlStore,
   SECURITY_KEYWORDS,
@@ -19,7 +19,7 @@ import {
   getPipelineEventBus,
   getTimeProvider,
   isDeclaredNeverDeprecate
-} from "./chunk-KPM6FF6T.js";
+} from "./chunk-Y5JA7XEO.js";
 import {
   getNexusDataDir,
   nexusDataPath
@@ -2132,4 +2132,4 @@ export {
   runImprovementReview,
   registerImprovementReviewTool
 };
-//# sourceMappingURL=chunk-RYGZPL4A.js.map
+//# sourceMappingURL=chunk-KYF4YAZO.js.map

package/dist/{chunk-YQL4WYSM.js → chunk-MRRKFMYJ.js}

@@ -1,9 +1,9 @@
 import {
   createAutoAdapter
-} from "./chunk-6RIQEBF5.js";
+} from "./chunk-K6NXLBHG.js";
 import {
   mapModelErrorToCategory
-} from "./chunk-VXWN5FFG.js";
+} from "./chunk-Z77MIV3C.js";
 import {
   CLI_NAMES,
   CircularBuffer,
@@ -24,7 +24,7 @@ import {
   ok,
   recordRateLimitEvent,
   toRateLimitError
-} from "./chunk-KPM6FF6T.js";
+} from "./chunk-Y5JA7XEO.js";
 
 // src/agents/collaboration/event-bus-helpers.ts
 import { randomUUID } from "crypto";
@@ -1041,4 +1041,4 @@ export {
   getGlobalRegistry,
   resetGlobalRegistry
 };
-//# sourceMappingURL=chunk-YQL4WYSM.js.map
+//# sourceMappingURL=chunk-MRRKFMYJ.js.map

package/dist/{chunk-S3HKSR6E.js → chunk-OCTNNEXT.js}

@@ -1,6 +1,6 @@
 import {
   computeCostDetail
-} from "./chunk-BS43TZVD.js";
+} from "./chunk-H5KLPUAL.js";
 import {
   DEFAULT_CONSENSUS_CONFIG,
   DEFAULT_INCREMENTAL_QUORUM_CONFIG,
@@ -18,20 +18,20 @@ import {
   toolSuccess,
   withProgressHeartbeat,
   wrapToolWithTimeout
-} from "./chunk-H2HZSKLO.js";
+} from "./chunk-5QVJCBM4.js";
 import {
   createEvent,
   getGlobalRegistry
-} from "./chunk-YQL4WYSM.js";
+} from "./chunk-MRRKFMYJ.js";
 import {
   getToolMemory
-} from "./chunk-LV3UNCC6.js";
+} from "./chunk-EDWON3X5.js";
 import {
   authRemediation,
   delay,
   getAvailableClis,
   withTimeout
-} from "./chunk-6RIQEBF5.js";
+} from "./chunk-K6NXLBHG.js";
 import {
   AgentError,
   CLI_NAMES,
@@ -60,7 +60,7 @@ import {
   resolveClassGuardMs,
   resolveModelIdentitySync,
   resolveVoteTimeout
-} from "./chunk-KPM6FF6T.js";
+} from "./chunk-Y5JA7XEO.js";
 import {
   ensureLearningDir,
   getOutcomesFile
@@ -5926,7 +5926,7 @@ async function processVotesWithCascade(engineVotes, opts) {
 var CONTRARIAN_ESCALATION_THRESHOLD = 0.8;
 async function runContrarianCheck(proposal, log) {
   try {
-    const { executeExpert } = await import("./expert-bridge-OQDZJ2VV.js");
+    const { executeExpert } = await import("./expert-bridge-2W2JMFQW.js");
     const prompt = [
       "You are a contrarian analyst. Your job is to find reasons this proposal should be REJECTED.",
       "Look for: YAGNI (not needed), MISALIGNED (wrong tech/architecture), SECURITY_RISK, SCOPE_CREEP.",
@@ -6453,4 +6453,4 @@ export {
   CONSENSUS_VOTE_OUTPUT_SCHEMA,
   registerConsensusVoteTool
 };
-//# sourceMappingURL=chunk-S3HKSR6E.js.map
+//# sourceMappingURL=chunk-OCTNNEXT.js.map

package/dist/{chunk-GPWRQY5I.js → chunk-OGR5Q6QO.js}

@@ -1,19 +1,19 @@
 import {
   resolveToken
-} from "./chunk-DU2YW5DH.js";
+} from "./chunk-HUYP2XXH.js";
 import {
   REGISTRY_PATH,
   getProjectRoot,
   loadPapersRegistry,
   loadTechniquesRegistry,
   savePapersRegistry
-} from "./chunk-KS4EN2WR.js";
+} from "./chunk-DJZGCMNU.js";
 import {
   resolveInsideRoot
 } from "./chunk-NUBSJGQZ.js";
 import {
   getToolMemory
-} from "./chunk-LV3UNCC6.js";
+} from "./chunk-EDWON3X5.js";
 import {
   capitalizeWords,
   truncateSentence
@@ -38,7 +38,7 @@ import {
   getTimeProvider,
   ok,
   registerPersistentDistillerFactory
-} from "./chunk-KPM6FF6T.js";
+} from "./chunk-Y5JA7XEO.js";
 import {
   ensureLearningDir,
   getRulesFile
@@ -4090,4 +4090,4 @@ export {
   DEFAULT_CONTEXT_BUDGET_TOKENS,
   getContextPromptPrefix
 };
-//# sourceMappingURL=chunk-GPWRQY5I.js.map
+//# sourceMappingURL=chunk-OGR5Q6QO.js.map

package/dist/chunk-OM2VVQKB.js

@@ -0,0 +1,172 @@
+import {
+  ConfigError,
+  createLogger,
+  err,
+  ok
+} from "./chunk-Y5JA7XEO.js";
+
+// src/adapters/sdk/types.ts
+var PROVIDER_ENV_KEYS = {
+  anthropic: "ANTHROPIC_API_KEY",
+  openai: "OPENAI_API_KEY",
+  google: "GOOGLE_AI_API_KEY",
+  "custom-openai": "NEXUS_CUSTOM_API_KEY"
+};
+var CUSTOM_API_BASE_URL_ENV = "NEXUS_CUSTOM_API_BASE_URL";
+var CUSTOM_API_ALLOW_PRIVATE_ENV = "NEXUS_CUSTOM_API_ALLOW_PRIVATE";
+
+// src/adapters/sdk/custom-api-validation.ts
+import { isIPv4, isIPv6 } from "net";
+import { lookup as dnsLookup } from "dns/promises";
+var logger = createLogger({ module: "custom-api-validation" });
+function validateCustomApiBaseUrl(raw, opts = {}) {
+  if (raw === void 0 || raw.trim() === "") {
+    return err(
+      new ConfigError(
+        "Custom API base URL is required but missing. Set NEXUS_CUSTOM_API_BASE_URL or pass `baseUrl` in config."
+      )
+    );
+  }
+  let url;
+  try {
+    url = new URL(raw);
+  } catch {
+    return err(new ConfigError(`Custom API base URL is not a valid URL: ${raw}`));
+  }
+  if (url.protocol !== "http:" && url.protocol !== "https:") {
+    return err(
+      new ConfigError(`Custom API base URL must use http or https, got "${url.protocol}" in ${raw}`)
+    );
+  }
+  const allowPrivate = opts.allowPrivate === true || resolveAllowPrivateFromEnv();
+  if (!allowPrivate) {
+    const rejection = classifyPrivateHost(url.hostname);
+    if (rejection !== null) {
+      return err(
+        new ConfigError(
+          `Custom API base URL rejected (SSRF guard, reason="${rejection.reason}"): ${rejection.message}. Set ${CUSTOM_API_ALLOW_PRIVATE_ENV}=1 to bypass if the gateway runs on a trusted internal host.`
+        )
+      );
+    }
+  }
+  return ok(url);
+}
+function resolveAllowPrivateFromEnv() {
+  const v = process.env[CUSTOM_API_ALLOW_PRIVATE_ENV];
+  return v === "1" || v === "true";
+}
+function classifyPrivateHost(hostname) {
+  const normalized = normalizeHost(hostname);
+  const literal = classifyIpAddress(normalized);
+  if (literal !== "not_an_ip") {
+    return literal;
+  }
+  if (normalized === "localhost" || normalized.endsWith(".localhost") || normalized.endsWith(".local")) {
+    return {
+      reason: "loopback",
+      message: `hostname "${hostname}" resolves to loopback/mDNS`
+    };
+  }
+  return null;
+}
+function normalizeHost(hostname) {
+  const stripped = hostname.startsWith("[") && hostname.endsWith("]") ? hostname.slice(1, -1) : hostname;
+  return stripped.toLowerCase();
+}
+function classifyIpAddress(normalized) {
+  if (isIPv4(normalized)) {
+    return classifyIPv4(normalized);
+  }
+  if (isIPv6(normalized)) {
+    return classifyIPv6(normalized);
+  }
+  return "not_an_ip";
+}
+async function assertCustomApiHostResolvesPublic(hostname, opts = {}) {
+  const allowPrivate = opts.allowPrivate === true || resolveAllowPrivateFromEnv();
+  if (allowPrivate) {
+    return ok(void 0);
+  }
+  const normalized = normalizeHost(hostname);
+  if (isIPv4(normalized) || isIPv6(normalized)) {
+    return ok(void 0);
+  }
+  let addresses;
+  try {
+    addresses = await dnsLookup(hostname, { all: true });
+  } catch (error) {
+    logger.debug("custom-api SSRF resolve check: DNS lookup failed, skipping (fail-open)", {
+      hostname,
+      error: error instanceof Error ? error.message : String(error)
+    });
+    return ok(void 0);
+  }
+  const rejection = firstPrivateAddress(addresses);
+  if (rejection !== null) {
+    return err(
+      new ConfigError(
+        `Custom API base URL rejected (SSRF resolve guard, reason="${rejection.reason}"): hostname "${hostname}" resolved to ${rejection.message}. Set ${CUSTOM_API_ALLOW_PRIVATE_ENV}=1 to bypass if the gateway runs on a trusted internal host.`
+      )
+    );
+  }
+  return ok(void 0);
+}
+function firstPrivateAddress(addresses) {
+  for (const { address } of addresses) {
+    const rejection = classifyIpAddress(address.toLowerCase());
+    if (rejection !== null && rejection !== "not_an_ip") {
+      return rejection;
+    }
+  }
+  return null;
+}
+var IPV4_RULES = [
+  { match: (a) => a === 127, reason: "loopback", label: "IPv4 loopback" },
+  { match: (a) => a === 10, reason: "private_range", label: "IPv4 private (10/8)" },
+  {
+    match: (a, b) => a === 172 && b >= 16 && b <= 31,
+    reason: "private_range",
+    label: "IPv4 private (172.16/12)"
+  },
+  {
+    match: (a, b) => a === 192 && b === 168,
+    reason: "private_range",
+    label: "IPv4 private (192.168/16)"
+  },
+  {
+    match: (a, b) => a === 169 && b === 254,
+    reason: "link_local",
+    label: "IPv4 link-local (169.254/16 \u2014 AWS IMDS)"
+  },
+  { match: (a) => a === 0, reason: "reserved", label: "IPv4 reserved (0/8)" }
+];
+function classifyIPv4(ip) {
+  const parts = ip.split(".").map((p) => Number.parseInt(p, 10));
+  if (parts.length !== 4 || parts.some((n) => Number.isNaN(n))) return null;
+  const [a, b] = parts;
+  for (const rule of IPV4_RULES) {
+    if (rule.match(a, b)) {
+      return { reason: rule.reason, message: `${rule.label} (${ip})` };
+    }
+  }
+  return null;
+}
+function classifyIPv6(ip) {
+  const lower = ip.toLowerCase();
+  if (lower === "::1") return { reason: "loopback", message: `IPv6 loopback (${ip})` };
+  if (lower.startsWith("fe80:"))
+    return { reason: "link_local", message: `IPv6 link-local (${ip})` };
+  if (/^fc|^fd/.test(lower)) {
+    return { reason: "private_range", message: `IPv6 unique-local (${ip}, fc00::/7)` };
+  }
+  return null;
+}
+
+export {
+  PROVIDER_ENV_KEYS,
+  CUSTOM_API_BASE_URL_ENV,
+  CUSTOM_API_ALLOW_PRIVATE_ENV,
+  validateCustomApiBaseUrl,
+  assertCustomApiHostResolvesPublic
+};
+//# sourceMappingURL=chunk-OM2VVQKB.js.map

package/dist/chunk-OM2VVQKB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/sdk/types.ts","../src/adapters/sdk/custom-api-validation.ts"],"sourcesContent":["/**\n * nexus-agents/adapters/sdk - Shared Types\n *\n * Type definitions for AI SDK adapter layer.\n *\n * @module adapters/sdk/types\n * (Source: Issue #1123 — AI SDK provider layer)\n */\n\n/**\n * Supported AI SDK provider identifiers.\n *\n * `custom-openai` is for OpenAI-compatible gateways (multi-vendor proxies,\n * self-hosted LLM servers, corporate model gateways) — uses the same\n * @ai-sdk/openai package but with a configurable `baseURL`.\n */\nexport type SdkProviderId = 'anthropic' | 'openai' | 'google' | 'custom-openai';\n\n/**\n * Configuration for creating an AI SDK adapter.\n */\nexport interface SdkAdapterConfig {\n  /** Provider identifier */\n  providerId: SdkProviderId;\n  /** Model to use (e.g., 'claude-sonnet-4-6', 'gpt-4o') */\n  modelId: string;\n  /** API key (falls back to environment variable) */\n  apiKey?: string;\n  /**\n   * Base URL for OpenAI-compatible gateways. Required when\n   * `providerId === 'custom-openai'`, ignored otherwise. Falls back to\n   * the `NEXUS_CUSTOM_API_BASE_URL` environment variable.\n   */\n  baseUrl?: string;\n  /** Request timeout in milliseconds */\n  timeout?: number;\n  /** Maximum retries on transient failures */\n  maxRetries?: number;\n}\n\n/**\n * Maps provider IDs to their environment variable names.\n */\nexport const PROVIDER_ENV_KEYS: Record<SdkProviderId, string> = {\n  anthropic: 'ANTHROPIC_API_KEY',\n  openai: 'OPENAI_API_KEY',\n  google: 'GOOGLE_AI_API_KEY',\n  'custom-openai': 'NEXUS_CUSTOM_API_KEY',\n};\n\n/**\n * Environment variable name for the custom gateway base URL.\n * Keep in sync with `SdkAdapterConfig.baseUrl`.\n */\nexport const CUSTOM_API_BASE_URL_ENV = 'NEXUS_CUSTOM_API_BASE_URL';\n\n/**\n * Escape hatch: set to `1`/`true` to allow the custom gateway base URL to\n * resolve to a loopback or RFC 1918 private address. Default is DENY —\n * SSRF defense. Only disable this when you know the gateway runs on a\n * trusted internal host and you accept the risk.\n */\nexport const CUSTOM_API_ALLOW_PRIVATE_ENV = 'NEXUS_CUSTOM_API_ALLOW_PRIVATE';\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_CUSTOM_API_BASE_URL or pass `baseUrl` in config.'\n      )\n    );\n  }\n\n  let url: URL;\n  try {\n    url = new URL(raw);\n  } catch {\n    return err(new ConfigError(`Custom API base URL is not a valid URL: ${raw}`));\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}\" in ${raw}`)\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/**\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  // IP literals are already handled by the sync guard at construction; no DNS.\n  if (isIPv4(normalized) || isIPv6(normalized)) {\n    return ok(undefined);\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/** IPv4 ranges the SSRF guard rejects, in order of specificity. */\nconst IPV4_RULES: ReadonlyArray<{\n  readonly match: (a: number, b: 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\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] = parts as [number, number, number, number];\n  for (const rule of IPV4_RULES) {\n    if (rule.match(a, b)) {\n      return { reason: rule.reason, message: `${rule.label} (${ip})` };\n    }\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  if (lower.startsWith('fe80:'))\n    return { reason: 'link_local', message: `IPv6 link-local (${ip})` };\n  // Unique-local: fc00::/7 → first byte has high bit set and second-high bit set\n  if (/^fc|^fd/.test(lower)) {\n    return { reason: 'private_range', message: `IPv6 unique-local (${ip}, fc00::/7)` };\n  }\n  return null;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-AVMNKTWJ.js → chunk-PN43VH6Z.js}

@@ -1,11 +1,11 @@
 import {
   resolveCliSlot
-} from "./chunk-WJKHJSU2.js";
+} from "./chunk-RAIFOYRM.js";
 import {
   createLogger,
   getTimeProvider,
   isRateLimitText
-} from "./chunk-KPM6FF6T.js";
+} from "./chunk-Y5JA7XEO.js";
 
 // src/pipeline/expert-bridge.ts
 function resolveCliFromModelString(model) {
@@ -21,7 +21,7 @@ async function getMcpConfigPath() {
   if (cachedMcpConfigPath !== null) return cachedMcpConfigPath;
   mcpConfigInitPromise ??= (async () => {
     try {
-      const { generateMcpConfig } = await import("./child-mcp-config-EYDYXTEN.js");
+      const { generateMcpConfig } = await import("./child-mcp-config-GWB7JLIS.js");
       const config = await generateMcpConfig();
       cachedMcpConfigPath = config.configPath;
       cachedMcpConfigCleanup = config.cleanup;
@@ -93,8 +93,8 @@ var routerInitPromise = null;
 async function getRouter() {
   if (cachedRouter !== null) return cachedRouter;
   routerInitPromise ??= (async () => {
-    const { createAllAdapters } = await import("./factory-DYFK43AX.js");
-    const { createCompositeRouter } = await import("./composite-router-OU47H54C.js");
+    const { createAllAdapters } = await import("./factory-7UFJ6LXW.js");
+    const { createCompositeRouter } = await import("./composite-router-CUJAG7O4.js");
     const adapters = createAllAdapters();
     if (adapters.size === 0) {
       routerInitPromise = null;
@@ -102,7 +102,7 @@ async function getRouter() {
     }
     cachedRouter = adaptCompositeRouter(createCompositeRouter(adapters));
     try {
-      const { createCliCircuitBreakerIntegration } = await import("./cli-circuit-breaker-MIH22DC4.js");
+      const { createCliCircuitBreakerIntegration } = await import("./cli-circuit-breaker-EINPV2CX.js");
       cachedCircuitBreaker = createCliCircuitBreakerIntegration([...adapters.values()]);
     } catch (error) {
       const msg = error instanceof Error ? error.message : String(error);
@@ -213,4 +213,4 @@ export {
   tokenSplitFromUsage,
   executeExpert
 };
-//# sourceMappingURL=chunk-AVMNKTWJ.js.map
+//# sourceMappingURL=chunk-PN43VH6Z.js.map

package/dist/{chunk-WJKHJSU2.js → chunk-RAIFOYRM.js}

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

package/dist/{chunk-TWAUWJET.js → chunk-SGIWJYLJ.js}

@@ -1,7 +1,7 @@
 import {
   getRandomProvider,
   getTimeProvider
-} from "./chunk-KPM6FF6T.js";
+} from "./chunk-Y5JA7XEO.js";
 
 // src/utils/id-utils.ts
 import { randomUUID } from "crypto";
@@ -24,4 +24,4 @@ export {
   generateHyphenId,
   generateUUID
 };
-//# sourceMappingURL=chunk-TWAUWJET.js.map
+//# sourceMappingURL=chunk-SGIWJYLJ.js.map

package/dist/{chunk-KNBV3J5O.js → chunk-UB6APBIY.js}

@@ -4,7 +4,7 @@ import {
 import {
   createLogger,
   getTimeProvider
-} from "./chunk-KPM6FF6T.js";
+} from "./chunk-Y5JA7XEO.js";
 
 // src/mcp/tools/scanner-registry-fetcher.ts
 import { z } from "zod";
@@ -721,4 +721,4 @@ export {
   generateSecurityPlan,
   buildPlanFromAnalysis
 };
-//# sourceMappingURL=chunk-KNBV3J5O.js.map
+//# sourceMappingURL=chunk-UB6APBIY.js.map

package/dist/{chunk-LRGCUZZX.js → chunk-VSETLO4Q.js}

@@ -1,6 +1,6 @@
 import {
   getTimeProvider
-} from "./chunk-KPM6FF6T.js";
+} from "./chunk-Y5JA7XEO.js";
 
 // src/security/audit-trail.ts
 var MAX_EVENTS = 1e4;
@@ -205,4 +205,4 @@ export {
   createGraphAuditBridge,
   createAuditTrail
 };
-//# sourceMappingURL=chunk-LRGCUZZX.js.map
+//# sourceMappingURL=chunk-VSETLO4Q.js.map