nexus-agents 9.4.0 → 10.0.0

package/dist/{chunk-Q7RFJSR5.js → chunk-BJLP4E6Q.js}

@@ -1,9 +1,9 @@
 import {
   loadPapersRegistry
-} from "./chunk-HESQ746B.js";
+} from "./chunk-YHY7GMAL.js";
 import {
   getErrorMessage
-} from "./chunk-7XJZTSHW.js";
+} from "./chunk-WI73OZAU.js";
 
 // src/cli/research-helpers-synthesize.ts
 import { z } from "zod";
@@ -876,4 +876,4 @@ export {
   AttributedInsightSchema,
   synthesizeResearch
 };
-//# sourceMappingURL=chunk-Q7RFJSR5.js.map
+//# sourceMappingURL=chunk-BJLP4E6Q.js.map

package/dist/{chunk-Q5F4OBOK.js → chunk-BK6Q3VQK.js}

@@ -1,13 +1,12 @@
 import {
   CUSTOM_API_ALLOW_PRIVATE_ENV,
   ConfigError,
-  DEPRECATED_GATEWAY_ENV_ALIASES,
   OPENAI_COMPAT_KEY_ENV,
   OPENAI_COMPAT_URL_ENV,
   createLogger,
   err,
   ok
-} from "./chunk-7XJZTSHW.js";
+} from "./chunk-WI73OZAU.js";
 
 // src/adapters/gateway-redaction.ts
 var GATEWAY_REDACTED = "<redacted>";
@@ -22,46 +21,13 @@ function readTrimmed(env, name) {
   return value === void 0 || value === "" ? void 0 : value;
 }
 function resolveGatewayEnv(env = process.env) {
-  const deprecated = [];
-  for (const alias of DEPRECATED_GATEWAY_ENV_ALIASES) {
-    if (readTrimmed(env, alias.deprecated) === void 0) continue;
-    deprecated.push({
-      name: alias.deprecated,
-      replacement: alias.replacement,
-      shadowed: readTrimmed(env, alias.replacement) !== void 0
-    });
-  }
   return {
-    baseUrl: readWithAlias(env, OPENAI_COMPAT_URL_ENV),
-    apiKey: readWithAlias(env, OPENAI_COMPAT_KEY_ENV),
-    deprecated
+    baseUrl: readTrimmed(env, OPENAI_COMPAT_URL_ENV),
+    apiKey: readTrimmed(env, OPENAI_COMPAT_KEY_ENV)
   };
 }
-function readWithAlias(env, replacement) {
-  const current = readTrimmed(env, replacement);
-  if (current !== void 0) return current;
-  const alias = DEPRECATED_GATEWAY_ENV_ALIASES.find((a) => a.replacement === replacement);
-  return alias === void 0 ? void 0 : readTrimmed(env, alias.deprecated);
-}
-var defaultLogger = createLogger({ component: "gateway-env" });
-var deprecationWarned = false;
-function warnDeprecatedGatewayEnvOnce(env = process.env, logger2 = defaultLogger) {
-  if (deprecationWarned) return;
-  const { deprecated } = resolveGatewayEnv(env);
-  if (deprecated.length === 0) return;
-  deprecationWarned = true;
-  logger2.warn(formatDeprecationWarning(deprecated));
-}
-function formatDeprecationWarning(deprecated) {
-  const uses = deprecated.map(
-    (d) => d.shadowed ? `${d.name} (ignored: ${d.replacement} is set)` : `${d.name} (honoured; rename to ${d.replacement})`
-  ).join("; ");
-  return `Deprecated gateway environment variable(s) set (#4392): ${uses}. These names configure only the single-model custom-openai path and stay aliases until the next major (#6291). Rename to NEXUS_OPENAI_COMPAT_* to opt into the gateway path (model discovery, in-process voter transport, api:<endpoint> arm).`;
-}
-function readGatewayEnv(env = process.env, logger2 = defaultLogger) {
-  const resolved = resolveGatewayEnv(env);
-  if (resolved.deprecated.length > 0) warnDeprecatedGatewayEnvOnce(env, logger2);
-  return resolved;
+function readGatewayEnv(env = process.env) {
+  return resolveGatewayEnv(env);
 }
 var CUSTOM_API_SURFACE_ENV = "NEXUS_CUSTOM_API_SURFACE";
 function readCustomApiSurface(env = process.env) {
@@ -331,8 +297,6 @@ function classifyIPv6(ip) {
 
 export {
   redactGatewaySecrets,
-  resolveGatewayEnv,
-  warnDeprecatedGatewayEnvOnce,
   readGatewayEnv,
   readCustomApiSurface,
   readDirectOpenAiSurface,
@@ -341,4 +305,4 @@ export {
   validateCustomApiBaseUrl,
   assertCustomApiHostResolvesPublic
 };
-//# sourceMappingURL=chunk-Q5F4OBOK.js.map
+//# sourceMappingURL=chunk-BK6Q3VQK.js.map

package/dist/chunk-BK6Q3VQK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/gateway-redaction.ts","../src/adapters/sdk/gateway-env.ts","../src/adapters/sdk/custom-api-validation.ts"],"sourcesContent":["/**\n * Redaction of gateway credentials from error text.\n *\n * A gateway request carries the key (in `Authorization: Bearer` or in the\n * header `NEXUS_OPENAI_COMPAT_AUTH_HEADER` names) and every static header\n * from `NEXUS_OPENAI_COMPAT_EXTRA_HEADERS`. A gateway's error body may echo\n * any of them, and none has a vendor shape the pattern sanitizer knows, so\n * each is removed by exact match. One helper, so the discovery path, the\n * per-model adapter and `doctor --gateway` cannot disagree on what is secret.\n *\n * @module adapters/gateway-redaction\n */\n\n/** Replacement text for a redacted gateway credential. */\nconst GATEWAY_REDACTED = '<redacted>';\n\n/** The credentials one gateway call site sends. */\nexport interface GatewaySecretSource {\n  /** The gateway key — also the auth-header value when a custom header carries it. */\n  readonly apiKey?: string | undefined;\n  /**\n   * Headers sent on every request. EVERY value is treated as secret; a\n   * `null` value removes a default header and carries nothing.\n   */\n  readonly headers?: Readonly<Record<string, string | null>> | undefined;\n}\n\n/**\n * `message` with the key and every header value replaced by `placeholder`.\n * Blank values are skipped (`replaceAll('')` would interleave the marker\n * between every character). Longer values are replaced first, so a value\n * that contains another is removed whole rather than leaving its remainder.\n */\nexport function redactGatewaySecrets(\n  message: string,\n  source: GatewaySecretSource,\n  placeholder: string = GATEWAY_REDACTED\n): string {\n  const secrets = [source.apiKey, ...Object.values(source.headers ?? {})]\n    .filter((s): s is string => typeof s === 'string' && s.trim() !== '')\n    .sort((a, b) => b.length - a.length);\n  return secrets.reduce((text, secret) => text.replaceAll(secret, placeholder), message);\n}\n","/**\n * Canonical env resolver for the single-model `custom-openai` gateway path.\n *\n * The SDK path (`api:custom-openai`) and discovery path (`api:<endpoint>`)\n * both read `NEXUS_OPENAI_COMPAT_URL` / `NEXUS_OPENAI_COMPAT_KEY`.\n *\n * @module adapters/sdk/gateway-env\n */\n\nimport { ConfigError } from '../../core/index.js';\nimport { OPENAI_COMPAT_KEY_ENV, OPENAI_COMPAT_URL_ENV } from './types.js';\nimport { redactGatewaySecrets } from '../gateway-redaction.js';\n\n/** The resolved mechanism-A gateway pair. */\nexport interface GatewayEnv {\n  /** `NEXUS_OPENAI_COMPAT_URL`, trimmed; empty is unset. */\n  readonly baseUrl: string | undefined;\n  /** `NEXUS_OPENAI_COMPAT_KEY`, trimmed; empty is unset. */\n  readonly apiKey: string | undefined;\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/** Resolve the canonical mechanism-A gateway pair without logging. */\nexport function resolveGatewayEnv(env: NodeJS.ProcessEnv = process.env): GatewayEnv {\n  return {\n    baseUrl: readTrimmed(env, OPENAI_COMPAT_URL_ENV),\n    apiKey: readTrimmed(env, OPENAI_COMPAT_KEY_ENV),\n  };\n}\n\n/** The production reader for the canonical mechanism-A gateway pair. */\nexport function readGatewayEnv(env: NodeJS.ProcessEnv = process.env): GatewayEnv {\n  return resolveGatewayEnv(env);\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. A blank key\n * matches nothing. The key-only case of {@link redactGatewaySecrets}.\n */\nexport function redactApiKey(message: string, apiKey: string | undefined): string {\n  return redactGatewaySecrets(message, { apiKey });\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":";;;;;;;;;;;AAcA,IAAM,mBAAmB;AAmBlB,SAAS,qBACd,SACA,QACA,cAAsB,kBACd;AACR,QAAM,UAAU,CAAC,OAAO,QAAQ,GAAG,OAAO,OAAO,OAAO,WAAW,CAAC,CAAC,CAAC,EACnE,OAAO,CAAC,MAAmB,OAAO,MAAM,YAAY,EAAE,KAAK,MAAM,EAAE,EACnE,KAAK,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM;AACrC,SAAO,QAAQ,OAAO,CAAC,MAAM,WAAW,KAAK,WAAW,QAAQ,WAAW,GAAG,OAAO;AACvF;;;ACpBA,SAAS,YAAY,KAAwB,MAAkC;AAC7E,QAAM,QAAQ,IAAI,IAAI,GAAG,KAAK;AAC9B,SAAO,UAAU,UAAa,UAAU,KAAK,SAAY;AAC3D;AAGO,SAAS,kBAAkB,MAAyB,QAAQ,KAAiB;AAClF,SAAO;AAAA,IACL,SAAS,YAAY,KAAK,qBAAqB;AAAA,IAC/C,QAAQ,YAAY,KAAK,qBAAqB;AAAA,EAChD;AACF;AAGO,SAAS,eAAe,MAAyB,QAAQ,KAAiB;AAC/E,SAAO,kBAAkB,GAAG;AAC9B;AAQA,IAAM,yBAAyB;AAQxB,SAAS,qBAAqB,MAAyB,QAAQ,KAAuB;AAC3F,QAAM,MAAM,IAAI,sBAAsB,GAAG,KAAK,EAAE,YAAY,KAAK;AACjE,MAAI,QAAQ,MAAM,QAAQ,OAAQ,QAAO;AACzC,MAAI,QAAQ,YAAa,QAAO;AAChC,QAAM,IAAI;AAAA,IACR,GAAG,sBAAsB;AAAA,EAC3B;AACF;AAGA,IAAM,sBAAsB;AAC5B,IAAM,kBAAkB;AAUjB,SAAS,wBACd,MAAyB,QAAQ,KACH;AAC9B,QAAM,UAAU,IAAI,mBAAmB,GAAG,KAAK,KAAK;AACpD,MAAI,YAAY,MAAM,WAAW,OAAO,MAAM,gBAAiB,QAAO;AACtE,SAAO,qBAAqB,GAAG;AACjC;AAUO,SAAS,WAAW,SAAyB;AAClD,MAAI;AACF,UAAM,OAAO,IAAI,IAAI,OAAO,EAAE;AAC9B,WAAO,SAAS,KAAK,cAAc;AAAA,EACrC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAQO,SAAS,aAAa,SAAiB,QAAoC;AAChF,SAAO,qBAAqB,SAAS,EAAE,OAAO,CAAC;AACjD;;;AC7FA,SAAS,QAAQ,cAAc;AAC/B,SAAS,UAAU,iBAAiB;AAIpC,IAAM,SAAS,aAAa,EAAE,QAAQ,wBAAwB,CAAC;AA6BxD,SAAS,yBACd,KACA,OAA4C,CAAC,GACnB;AAC1B,MAAI,QAAQ,UAAa,IAAI,KAAK,MAAM,IAAI;AAC1C,WAAO;AAAA,MACL,IAAI;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,MAAI;AACJ,MAAI;AACF,UAAM,IAAI,IAAI,GAAG;AAAA,EACnB,QAAQ;AAGN,WAAO,IAAI,IAAI,YAAY,wCAAwC,CAAC;AAAA,EACtE;AAEA,MAAI,IAAI,aAAa,WAAW,IAAI,aAAa,UAAU;AACzD,WAAO;AAAA,MACL,IAAI,YAAY,oDAAoD,IAAI,QAAQ,GAAG;AAAA,IACrF;AAAA,EACF;AAEA,QAAM,eAAe,KAAK,iBAAiB,QAAQ,2BAA2B;AAC9E,MAAI,CAAC,cAAc;AACjB,UAAM,YAAY,oBAAoB,IAAI,QAAQ;AAClD,QAAI,cAAc,MAAM;AACtB,aAAO;AAAA,QACL,IAAI;AAAA,UACF,qDAAqD,UAAU,MAAM,OAAO,UAAU,OAAO,SACpF,4BAA4B;AAAA,QACvC;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO,GAAG,GAAG;AACf;AAEA,SAAS,6BAAsC;AAI7C,QAAM,IAAI,QAAQ,IAAI,4BAA4B;AAClD,SAAO,MAAM,OAAO,MAAM;AAC5B;AAYA,SAAS,oBAAoB,UAA0C;AACrE,QAAM,aAAa,cAAc,QAAQ;AAGzC,QAAM,UAAU,kBAAkB,UAAU;AAC5C,MAAI,YAAY,aAAa;AAC3B,WAAO;AAAA,EACT;AAGA,MACE,eAAe,eACf,WAAW,SAAS,YAAY,KAChC,WAAW,SAAS,QAAQ,GAC5B;AACA,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,SAAS,aAAa,QAAQ;AAAA,IAChC;AAAA,EACF;AAEA,SAAO;AACT;AAOA,SAAS,cAAc,UAA0B;AAC/C,QAAM,WACJ,SAAS,WAAW,GAAG,KAAK,SAAS,SAAS,GAAG,IAAI,SAAS,MAAM,GAAG,EAAE,IAAI;AAC/E,SAAO,SAAS,YAAY;AAC9B;AAcA,SAAS,kBAAkB,YAA0D;AACnF,MAAI,OAAO,UAAU,GAAG;AACtB,WAAO,aAAa,UAAU;AAAA,EAChC;AACA,MAAI,OAAO,UAAU,GAAG;AACtB,WAAO,aAAa,UAAU;AAAA,EAChC;AACA,SAAO;AACT;AAGA,SAAS,gBAAgB,UAAkB,YAA+C;AACxF,QAAM,UAAU,kBAAkB,UAAU;AAC5C,MAAI,YAAY,QAAQ,YAAY,YAAa,QAAO,GAAG,MAAS;AACpE,SAAO;AAAA,IACL,IAAI;AAAA,MACF,oBAAoB,QAAQ,UAAU,QAAQ,MAAM,aAAa,QAAQ,OAAO;AAAA,IAClF;AAAA,EACF;AACF;AA8BA,eAAsB,kCACpB,UACA,OAA4C,CAAC,GACT;AACpC,QAAM,eAAe,KAAK,iBAAiB,QAAQ,2BAA2B;AAC9E,MAAI,cAAc;AAChB,WAAO,GAAG,MAAS;AAAA,EACrB;AAEA,QAAM,aAAa,cAAc,QAAQ;AASzC,MAAI,OAAO,UAAU,KAAK,OAAO,UAAU,GAAG;AAC5C,WAAO,gBAAgB,UAAU,UAAU;AAAA,EAC7C;AAKA,MAAI;AACJ,MAAI;AACF,gBAAY,MAAM,UAAU,UAAU,EAAE,KAAK,KAAK,CAAC;AAAA,EACrD,SAAS,OAAO;AAGd,WAAO,MAAM,0EAA0E;AAAA,MACrF;AAAA,MACA,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,IAC9D,CAAC;AACD,WAAO,GAAG,MAAS;AAAA,EACrB;AAEA,QAAM,YAAY,oBAAoB,SAAS;AAC/C,MAAI,cAAc,MAAM;AACtB,WAAO;AAAA,MACL,IAAI;AAAA,QACF,6DAA6D,UAAU,MAAM,iBAC9D,QAAQ,iBAAiB,UAAU,OAAO,SAChD,4BAA4B;AAAA,MACvC;AAAA,IACF;AAAA,EACF;AAEA,SAAO,GAAG,MAAS;AACrB;AAOA,SAAS,oBACP,WACwB;AACxB,aAAW,EAAE,QAAQ,KAAK,WAAW;AACnC,UAAM,YAAY,kBAAkB,QAAQ,YAAY,CAAC;AACzD,QAAI,cAAc,QAAQ,cAAc,aAAa;AACnD,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAWA,IAAM,aAID;AAAA,EACH,EAAE,OAAO,CAAC,MAAM,MAAM,KAAK,QAAQ,YAAY,OAAO,gBAAgB;AAAA,EACtE,EAAE,OAAO,CAAC,MAAM,MAAM,IAAI,QAAQ,iBAAiB,OAAO,sBAAsB;AAAA,EAChF;AAAA,IACE,OAAO,CAAC,GAAG,MAAM,MAAM,OAAO,KAAK,MAAM,KAAK;AAAA,IAC9C,QAAQ;AAAA,IACR,OAAO;AAAA,EACT;AAAA,EACA;AAAA,IACE,OAAO,CAAC,GAAG,MAAM,MAAM,OAAO,MAAM;AAAA,IACpC,QAAQ;AAAA,IACR,OAAO;AAAA,EACT;AAAA,EACA;AAAA,IACE,OAAO,CAAC,GAAG,MAAM,MAAM,OAAO,MAAM;AAAA,IACpC,QAAQ;AAAA,IACR,OAAO;AAAA,EACT;AAAA,EACA,EAAE,OAAO,CAAC,MAAM,MAAM,GAAG,QAAQ,YAAY,OAAO,sBAAsB;AAAA,EAC1E;AAAA,IACE,OAAO,CAAC,GAAG,MAAM,MAAM,OAAO,KAAK,MAAM,KAAK;AAAA,IAC9C,QAAQ;AAAA,IACR,OAAO;AAAA,EACT;AAAA,EACA;AAAA,IACE,OAAO,CAAC,GAAG,GAAG,MAAM,MAAM,OAAO,MAAM,KAAK,MAAM;AAAA,IAClD,QAAQ;AAAA,IACR,OAAO;AAAA,EACT;AAAA,EACA;AAAA,IACE,OAAO,CAAC,GAAG,MAAM,MAAM,QAAQ,MAAM,MAAM,MAAM;AAAA,IACjD,QAAQ;AAAA,IACR,OAAO;AAAA,EACT;AAAA,EACA,EAAE,OAAO,CAAC,MAAM,KAAK,OAAO,KAAK,KAAK,QAAQ,YAAY,OAAO,yBAAyB;AAAA,EAC1F;AAAA,IACE,OAAO,CAAC,MAAM,KAAK;AAAA,IACnB,QAAQ;AAAA,IACR,OAAO;AAAA,EACT;AACF;AAEA,SAAS,aAAa,IAAoC;AACxD,QAAM,QAAQ,GAAG,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,OAAO,SAAS,GAAG,EAAE,CAAC;AAC7D,MAAI,MAAM,WAAW,KAAK,MAAM,KAAK,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC,EAAG,QAAO;AACrE,QAAM,CAAC,GAAG,GAAG,CAAC,IAAI;AAClB,aAAW,QAAQ,YAAY;AAC7B,QAAI,KAAK,MAAM,GAAG,GAAG,CAAC,GAAG;AACvB,aAAO,EAAE,QAAQ,KAAK,QAAQ,SAAS,GAAG,KAAK,KAAK,KAAK,EAAE,IAAI;AAAA,IACjE;AAAA,EACF;AACA,SAAO;AACT;AAQA,SAAS,iBAAiB,GAA0B;AAClD,QAAM,SAAS,oCAAoC,KAAK,CAAC;AACzD,MAAI,SAAS,CAAC,MAAM,OAAW,QAAO;AACtC,QAAM,IAAI,OAAO,CAAC,EAAE,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,OAAO,SAAS,GAAG,EAAE,CAAC;AAChE,MAAI,EAAE,WAAW,KAAK,EAAE,KAAK,CAAC,MAAM,OAAO,MAAM,CAAC,KAAK,IAAI,KAAK,IAAI,GAAG,EAAG,QAAO;AACjF,QAAM,OAAQ,EAAE,CAAC,KAAK,MAAM,KAAM,EAAE,CAAC,KAAK,IAAI,SAAS,EAAE;AACzD,QAAM,OAAQ,EAAE,CAAC,KAAK,MAAM,KAAM,EAAE,CAAC,KAAK,IAAI,SAAS,EAAE;AACzD,SAAO,GAAG,EAAE,MAAM,GAAG,EAAE,SAAS,OAAO,CAAC,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE;AAC9D;AAEA,SAAS,UAAU,IAA6B;AAC9C,QAAM,IAAI,iBAAiB,GAAG,YAAY,CAAC;AAC3C,MAAI,MAAM,KAAM,QAAO;AACvB,QAAM,SAAS,EAAE,MAAM,IAAI;AAC3B,MAAI,OAAO,SAAS,EAAG,QAAO;AAC9B,QAAM,OAAO,OAAO,CAAC,MAAM,MAAM,OAAO,CAAC,MAAM,SAAY,CAAC,IAAI,OAAO,CAAC,EAAE,MAAM,GAAG;AACnF,QAAM,OAAO,OAAO,CAAC,MAAM,MAAM,OAAO,CAAC,MAAM,SAAY,CAAC,IAAI,OAAO,CAAC,EAAE,MAAM,GAAG;AACnF,QAAM,SACJ,OAAO,WAAW,IACd,OACA,CAAC,GAAG,MAAM,GAAG,MAAc,IAAI,KAAK,SAAS,KAAK,MAAM,EAAE,KAAK,GAAG,GAAG,GAAG,IAAI;AAClF,MAAI,OAAO,WAAW,EAAG,QAAO;AAChC,QAAM,MAAM,OAAO,IAAI,CAAC,MAAM,OAAO,SAAS,MAAM,KAAK,MAAM,GAAG,EAAE,CAAC;AACrE,SAAO,IAAI,KAAK,CAAC,MAAM,OAAO,MAAM,CAAC,KAAK,IAAI,KAAK,IAAI,KAAM,IAAI,OAAO;AAC1E;AAWA,SAAS,aAAa,GAAqC;AAGzD,MAAI,EAAE,CAAC,MAAM,KAAQ,QAAO,mBAAmB,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC;AACnE,QAAM,MAAM,EAAE,MAAM,GAAG,CAAC;AACxB,QAAM,WAA6C;AAAA,IACjD,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,KAAM;AAAA;AAAA,IACtB,CAAC,GAAG,GAAG,GAAG,GAAG,OAAQ,CAAC;AAAA;AAAA,IACtB,CAAC,KAAM,OAAQ,GAAG,GAAG,GAAG,CAAC;AAAA;AAAA,IACzB,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAAA;AAAA,EACnB;AACA,QAAM,UAAU,SAAS,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC;AACpE,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,KAAK,EAAE,CAAC,KAAK;AACnB,QAAM,KAAK,EAAE,CAAC,KAAK;AAEnB,MAAI,IAAI,MAAM,CAAC,MAAM,MAAM,CAAC,KAAK,OAAO,KAAK,MAAM,EAAG,QAAO;AAC7D,SAAO,mBAAmB,IAAI,EAAE;AAClC;AAGA,SAAS,mBAAmB,IAAY,IAAoB;AAC1D,SAAO,CAAE,MAAM,IAAK,KAAK,KAAK,KAAM,MAAM,IAAK,KAAK,KAAK,GAAG,EAAE,KAAK,GAAG;AACxE;AAUA,SAAS,mBAAmB,OAAe,IAAoC;AAC7E,MAAI,SAAS,SAAU,SAAS,OAAQ;AACtC,WAAO,EAAE,QAAQ,iBAAiB,SAAS,sBAAsB,EAAE,cAAc;AAAA,EACnF;AACA,MAAI,SAAS,SAAU,SAAS,OAAQ;AACtC,WAAO,EAAE,QAAQ,cAAc,SAAS,oBAAoB,EAAE,eAAe;AAAA,EAC/E;AACA,MAAI,SAAS,SAAU,SAAS,OAAQ;AACtC,WAAO,EAAE,QAAQ,iBAAiB,SAAS,oBAAoB,EAAE,eAAe;AAAA,EAClF;AACA,SAAO;AACT;AAEA,SAAS,aAAa,IAAoC;AACxD,QAAM,QAAQ,GAAG,YAAY;AAC7B,MAAI,UAAU,MAAO,QAAO,EAAE,QAAQ,YAAY,SAAS,kBAAkB,EAAE,IAAI;AAEnF,QAAM,SAAS,UAAU,KAAK;AAC9B,MAAI,WAAW,KAAM,QAAO;AAE5B,QAAM,eAAe,mBAAmB,OAAO,CAAC,KAAK,GAAG,EAAE;AAC1D,MAAI,iBAAiB,KAAM,QAAO;AAElC,MAAI,OAAO,MAAM,CAAC,MAAM,MAAM,CAAC,GAAG;AAChC,WAAO,EAAE,QAAQ,YAAY,SAAS,qBAAqB,EAAE,+BAA0B;AAAA,EACzF;AAOA,QAAM,KAAK,aAAa,MAAM;AAC9B,MAAI,OAAO,KAAM,QAAO;AACxB,QAAM,SAAS,aAAa,EAAE;AAC9B,SAAO,WAAW,OACd,OACA,EAAE,QAAQ,OAAO,QAAQ,SAAS,GAAG,OAAO,OAAO,cAAc,EAAE,IAAI;AAC7E;","names":[]}

package/dist/{chunk-ETGNAHY3.js → chunk-CYROSFMW.js}

@@ -5,14 +5,14 @@ import {
   getCurrentRequestContext,
   runWithRequestContext,
   serverCallerInfo
-} from "./chunk-LWLFWWA7.js";
+} from "./chunk-TQZSPGAZ.js";
 import {
   DEFAULT_EXECUTION_MODE
-} from "./chunk-ECJ52NSK.js";
+} from "./chunk-TYLE7Z2S.js";
 import {
   sanitizeErrorDetails,
   sanitizeStringLeaves
-} from "./chunk-2AW2VHMK.js";
+} from "./chunk-IRFKJ2KR.js";
 import {
   SecurityError,
   TOOL_MANIFEST,
@@ -26,7 +26,7 @@ import {
   getTimeProvider,
   ok,
   resolveInsideRoot
-} from "./chunk-7XJZTSHW.js";
+} from "./chunk-WI73OZAU.js";
 import {
   getNexusDataDir,
   parseBoolValue
@@ -2343,4 +2343,4 @@ export {
   DEFAULT_CONSENSUS_CONFIG,
   ConsensusMetricsSchema
 };
-//# sourceMappingURL=chunk-ETGNAHY3.js.map
+//# sourceMappingURL=chunk-CYROSFMW.js.map

package/dist/{chunk-FWSAYHGV.js → chunk-EGUISJBB.js}

@@ -1,14 +1,14 @@
 import {
   IN_FAMILY_FALLBACK_OPTION
-} from "./chunk-TMHCN5EY.js";
+} from "./chunk-NUXSGWDS.js";
 import {
   sanitizeErrorDetails
-} from "./chunk-2AW2VHMK.js";
+} from "./chunk-IRFKJ2KR.js";
 import {
   classifyExtractedError,
   getTimeProvider,
   isTimeoutText
-} from "./chunk-7XJZTSHW.js";
+} from "./chunk-WI73OZAU.js";
 import {
   resolveClassGuardMs
 } from "./chunk-4PN3UVZV.js";
@@ -156,4 +156,4 @@ export {
   SERVES_PROBE_PROMPT,
   probeServes
 };
-//# sourceMappingURL=chunk-FWSAYHGV.js.map
+//# sourceMappingURL=chunk-EGUISJBB.js.map

package/dist/{chunk-ONWH4UGD.js → chunk-HBJ3CVDB.js}

@@ -21,24 +21,24 @@ import {
   toolSuccess,
   withProgressHeartbeat,
   wrapToolWithTimeout
-} from "./chunk-ETGNAHY3.js";
+} from "./chunk-CYROSFMW.js";
 import {
   getToolMemory
-} from "./chunk-2AN5NGCQ.js";
+} from "./chunk-VGCRYAEH.js";
 import {
   allOf
 } from "./chunk-EZNIYU5T.js";
 import {
   VERSION
-} from "./chunk-LWLFWWA7.js";
+} from "./chunk-TQZSPGAZ.js";
 import {
   isGatewayModelAdapter
-} from "./chunk-C5WECFBR.js";
+} from "./chunk-XQMQGUJT.js";
 import {
   ModelBoundAdapter,
   createEvent,
   getGlobalRegistry
-} from "./chunk-TFQMVUWQ.js";
+} from "./chunk-V5FGXVSX.js";
 import {
   UNVERIFIABLE_STDERR_RE,
   classifyUnverifiable,
@@ -46,25 +46,25 @@ import {
   getAvailableClis,
   isAbsentSeat,
   markUnverifiable
-} from "./chunk-ONYCBTOH.js";
+} from "./chunk-O3VPGING.js";
 import {
   ensureGatewayDiscovered
-} from "./chunk-VQGHQVD2.js";
+} from "./chunk-QPU7QKPT.js";
 import {
   CLI_TO_MODELSDEV_VENDOR,
   delay,
   getAbortObservation,
   sleep,
   withTimeout
-} from "./chunk-TMHCN5EY.js";
+} from "./chunk-NUXSGWDS.js";
 import {
   getDefaultCliCircuitBreakerRegistry
-} from "./chunk-AYBOQE2Y.js";
+} from "./chunk-VHOOJ4FG.js";
 import {
   sanitizeErrorDetails,
   sanitizeOutput,
   sanitizeStringLeaves
-} from "./chunk-2AW2VHMK.js";
+} from "./chunk-IRFKJ2KR.js";
 import {
   AgentError,
   DecisionCostStore,
@@ -123,7 +123,7 @@ import {
   servedCostDetail,
   stepBus,
   voteRecordWriteFailedMessage
-} from "./chunk-7XJZTSHW.js";
+} from "./chunk-WI73OZAU.js";
 import {
   ensureLearningDir,
   getOutcomesFile
@@ -6658,7 +6658,7 @@ function logPartialProposal(bounded, log) {
 }
 async function runContrarianCheck(proposal, options, log, opts) {
   try {
-    const { executeExpert } = await import("./expert-bridge-CXHYMQRL.js");
+    const { executeExpert } = await import("./expert-bridge-5A4ADUBO.js");
     const bounded = boundArtifactForReview(proposal, CONTRARIAN_PROPOSAL_BUDGET, "proposal");
     logPartialProposal(bounded, log);
     const result = await executeExpert(
@@ -7631,11 +7631,20 @@ async function attachPartialsOnCancel(jobId, toolName, body) {
 }
 
 // src/orchestration/outcomes/outcome-store-persistence.ts
-import { appendFileSync as appendFileSync2, readFileSync as readFileSync6, writeFileSync as writeFileSync3, existsSync as existsSync5 } from "node:fs";
+import {
+  appendFileSync as appendFileSync2,
+  readFileSync as readFileSync6,
+  writeFileSync as writeFileSync3,
+  existsSync as existsSync5,
+  renameSync,
+  rmSync
+} from "node:fs";
 var PersistedOutcomeSchema = TaskOutcomeSchema.loose();
 var PersistentOutcomeStore = class extends OutcomeStore {
   filePath;
   logger;
+  /** Raw unreadable segments, including their original line terminators. */
+  unreadableLines = [];
   constructor(config, logger12) {
     super(config);
     this.filePath = config?.filePath ?? getOutcomesFile();
@@ -7691,7 +7700,7 @@ var PersistentOutcomeStore = class extends OutcomeStore {
     }
     try {
       const content = readFileSync6(this.filePath, "utf-8");
-      const lines = content.split("\n").filter((line) => line.trim().length > 0);
+      const lines = content.split(/(?<=\n)/).filter((line) => line.trim().length > 0);
       let loaded = 0;
       let skipped = 0;
       for (const line of lines) {
@@ -7702,16 +7711,23 @@ var PersistentOutcomeStore = class extends OutcomeStore {
             super.append(result.data);
             loaded++;
           } else {
+            this.unreadableLines.push(line);
             skipped++;
           }
-        } catch (parseErr) {
-          this.logger.debug("Skipping malformed outcome line during hydration", {
-            error: getErrorMessage(parseErr),
-            linePreview: line.slice(0, 80)
-          });
+        } catch {
+          this.unreadableLines.push(line);
           skipped++;
         }
       }
+      if (skipped > 0) {
+        this.logger.warn(
+          "Skipped unreadable outcome lines during hydration; preserving them on rewrite",
+          {
+            skipped,
+            path: this.filePath
+          }
+        );
+      }
       this.logger.info("Hydrated outcomes from disk", {
         loaded,
         skipped,
@@ -7719,25 +7735,38 @@ var PersistentOutcomeStore = class extends OutcomeStore {
         path: this.filePath
       });
     } catch (error) {
-      const msg = getErrorMessage(error);
       this.logger.warn("Failed to hydrate outcomes from disk", {
-        error: msg,
+        error: getErrorMessage(error),
         path: this.filePath
       });
     }
   }
-  /** Rewrite the JSONL file from in-memory state after reclassification. */
+  /**
+   * Atomically rewrite readable records, then append unreadable segments verbatim.
+   * Their relative order is preserved; their positions among readable records may
+   * change after reclassification, purge or FIFO eviction (#7146).
+   */
   rewriteFile() {
+    const tmpPath = `${this.filePath}.tmp.${String(process.pid)}`;
     try {
       const entries = this.query();
-      const content = entries.map((e) => JSON.stringify(e)).join("\n") + "\n";
-      writeFileSync3(this.filePath, content, "utf-8");
+      const content = entries.map((e) => JSON.stringify(e) + "\n").join("") + this.unreadableLines.join("");
+      writeFileSync3(tmpPath, content, "utf-8");
+      renameSync(tmpPath, this.filePath);
     } catch (error) {
       const msg = getErrorMessage(error);
       this.logger.warn("Failed to rewrite outcomes file after reclassification", {
         error: msg,
         path: this.filePath
       });
+      try {
+        rmSync(tmpPath, { force: true });
+      } catch (cleanupError) {
+        this.logger.debug("Failed to clean up temporary outcomes file", {
+          error: getErrorMessage(cleanupError),
+          path: tmpPath
+        });
+      }
     }
   }
   persistLine(outcome) {
@@ -9841,4 +9870,4 @@ export {
   CONSENSUS_VOTE_TOOL_SCHEMA,
   registerConsensusVoteTool
 };
-//# sourceMappingURL=chunk-ONWH4UGD.js.map
+//# sourceMappingURL=chunk-HBJ3CVDB.js.map