@astrasyncai/verification-gateway 3.12.0 → 4.1.0

package/dist/index.mjs

@@ -126,7 +126,7 @@ function getCapabilities(accessLevel) {
 }
 
 // src/version.ts
-var SDK_VERSION = "3.12.0";
+var SDK_VERSION = "4.1.0";
 
 // src/well-known.ts
 var CACHE_TTL_MS = 60 * 60 * 1e3;
@@ -204,7 +204,7 @@ var DEFAULT_CONFIG = {
 };
 var initCheckPerformed = false;
 var deprecationWarningShown = false;
-async function performInitCheck(apiBaseUrl, debug, strictInit) {
+async function performInitCheck(apiBaseUrl, debug, strictInit, apiKey) {
   initCheckPerformed = true;
   try {
     const probeUrl = `${apiBaseUrl}/agents/verify-access`;
@@ -221,6 +221,28 @@ async function performInitCheck(apiBaseUrl, debug, strictInit) {
         `[VerificationGateway] init check passed for ${apiBaseUrl} (content-type: ${contentType})`
       );
     }
+    if (apiKey) {
+      const selfCheck = await fetch(`${apiBaseUrl}/agents/verify-access/self-check`, {
+        headers: { Authorization: `Bearer ${apiKey}` }
+      });
+      if (selfCheck.status === 401) {
+        const body = await selfCheck.json().catch(() => ({}));
+        const message = `[VerificationGateway] the configured AstraSync API key was REJECTED at startup (${body.code ?? "api_key_invalid"}: ${body.message ?? "invalid key"}). Every inbound agent will be turned away until the key is rotated` + (body.remediation?.manageUrl ? ` at ${body.remediation.manageUrl}` : "") + `.`;
+        if (strictInit) {
+          throw new Error(`${message} (strictInit=true)`);
+        }
+        console.error(message);
+      } else if (selfCheck.ok) {
+        const body = await selfCheck.json().catch(() => ({}));
+        if (typeof body.daysToExpiry === "number" && body.daysToExpiry <= 7) {
+          console.warn(
+            `[VerificationGateway] the configured AstraSync API key expires in ${body.daysToExpiry} day(s) \u2014 rotate it at Settings \u2192 Developer Tools before integrations start failing.`
+          );
+        } else if (debug) {
+          console.log("[VerificationGateway] API key self-check passed");
+        }
+      }
+    }
   } catch (err) {
     if (strictInit) {
       throw err;
@@ -338,8 +360,17 @@ function hasCredentials(credentials) {
 function createGuidanceResponse(_config, reason, options = {}) {
   const source = options.source ?? "no_credentials";
   const isApiError = source === "api_error";
+  const isMisconfig = source === "merchant_misconfig";
   const urls = options.urls;
-  const guidance = isApiError ? {
+  const guidance = isMisconfig ? {
+    message: "This site's AstraSync integration is misconfigured (its API key was revoked, expired, or rotated). Your identity and the AstraSync platform are fine \u2014 contact the site operator. Retrying will not help.",
+    registrationUrl: urls?.registrationUrl ?? "",
+    documentationUrl: options.remediation?.docsUrl ?? urls?.documentationUrl ?? "",
+    steps: [
+      "Report the failure to the site operator \u2014 their AstraSync API key needs rotating",
+      "Do not retry: the failure is deterministic until the operator updates their key"
+    ]
+  } : isApiError ? {
     message: "Verification is temporarily unavailable. Retry with exponential backoff; if the issue persists, contact support with the correlationId.",
     registrationUrl: urls?.registrationUrl ?? "",
     documentationUrl: urls?.documentationUrl ?? "",
@@ -377,13 +408,22 @@ function createGuidanceResponse(_config, reason, options = {}) {
     // partners (and their custom onDenied handlers) can branch on
     // dimension. Without this, the synthesised stub was indistinguishable
     // from a real policy deny.
-    failures: isApiError ? [
+    failures: isMisconfig ? [
+      {
+        dimension: "verify_access.merchant_misconfigured",
+        message: reason ?? "The integration API key was rejected by AstraSync",
+        guidance: guidance.message
+      }
+    ] : isApiError ? [
       {
         dimension: "verify_access.api_error",
         message: reason ?? "Verification temporarily unavailable",
         guidance: guidance.message
       }
     ] : void 0,
+    // 4.0.0: typed marker so adapters render the misconfig envelope (503 +
+    // MERCHANT_VERIFICATION_MISCONFIGURED) without string-matching.
+    ...isMisconfig && { misconfigured: true },
     correlationId: options.correlationId,
     attemptId: options.attemptId,
     verifiedAt: /* @__PURE__ */ new Date()
@@ -438,7 +478,8 @@ async function callVerifyAccessAPI(config, request) {
     const response = await fetch(`${config.apiBaseUrl}/agents/verify-access`, {
       method: "POST",
       headers,
-      body: JSON.stringify(body)
+      body: JSON.stringify(body),
+      signal: AbortSignal.timeout(config.verifyTimeoutMs ?? 1e4)
     });
     const data = await response.json();
     if (response.status === 410) {
@@ -462,6 +503,17 @@ async function callVerifyAccessAPI(config, request) {
       };
     }
     if (!response.ok) {
+      if (response.status === 401) {
+        return {
+          success: false,
+          error: data.message || data.error || "Integration API key rejected",
+          misconfig: true,
+          misconfigCode: typeof data?.code === "string" ? data.code : void 0,
+          remediation: data?.remediation && typeof data.remediation === "object" ? data.remediation : void 0,
+          correlationId: typeof data?.correlationId === "string" ? data.correlationId : void 0,
+          attemptId: typeof data?.attemptId === "string" ? data.attemptId : void 0
+        };
+      }
       return {
         success: false,
         error: data.message || data.error || `API returned ${response.status}`,
@@ -483,9 +535,19 @@ async function verify(config, request, options) {
   const urls = mergedConfig.apiBaseUrl ? getCachedWellKnownUrls(mergedConfig.apiBaseUrl) : void 0;
   if (!initCheckPerformed && !mergedConfig.disableInitChecks && mergedConfig.apiBaseUrl) {
     if (mergedConfig.strictInit) {
-      await performInitCheck(mergedConfig.apiBaseUrl, mergedConfig.debug, true);
+      await performInitCheck(
+        mergedConfig.apiBaseUrl,
+        mergedConfig.debug,
+        true,
+        mergedConfig.apiKey
+      );
     } else {
-      void performInitCheck(mergedConfig.apiBaseUrl, mergedConfig.debug, false);
+      void performInitCheck(
+        mergedConfig.apiBaseUrl,
+        mergedConfig.debug,
+        false,
+        mergedConfig.apiKey
+      );
     }
   }
   if (!deprecationWarningShown && (config.minTrustScore !== void 0 || config.minTrustScoreForFull !== void 0)) {
@@ -524,9 +586,10 @@ async function verify(config, request, options) {
   const serverDenialReasons = Array.isArray(rawServerDenialReasons) && rawServerDenialReasons.length > 0 ? rawServerDenialReasons : void 0;
   if (!apiResponse.success) {
     return createGuidanceResponse(mergedConfig, apiResponse.error, {
-      source: "api_error",
+      source: apiResponse.misconfig ? "merchant_misconfig" : "api_error",
       correlationId: apiResponse.correlationId,
       attemptId: apiResponse.attemptId,
+      remediation: apiResponse.remediation,
       urls
     });
   }
@@ -1061,6 +1124,7 @@ function performCounterpartyPreCheck(routeConfig, astraCreds, purpose) {
 }
 
 // src/metadata-capture.ts
+var CAPTURE_SCHEMA_VERSION = 1;
 var SECRET_HEADER_NAMES = /* @__PURE__ */ new Set([
   "cookie",
   "set-cookie",
@@ -1205,6 +1269,373 @@ function extractPlatformHeaders(sanitized) {
   }
   return out;
 }
+var CONNECTION_HEADER_SOURCES = [
+  ["ip", ["cf-connecting-ip", "fastly-client-ip", "true-client-ip", "x-real-ip"]],
+  [
+    "country",
+    ["cf-ipcountry", "x-vercel-ip-country", "cloudfront-viewer-country", "fastly-geo-country"]
+  ],
+  ["region", ["x-vercel-ip-country-region", "cloudfront-viewer-country-region"]],
+  ["city", ["x-vercel-ip-city", "cloudfront-viewer-city"]],
+  ["asn", ["cloudfront-viewer-asn"]],
+  ["tlsVersion", ["cloudfront-viewer-tls"]],
+  ["httpVersion", ["cloudfront-viewer-http-version"]],
+  // TLS fingerprints can only be computed where TLS terminates. When a CDN
+  // terminates TLS in front of the merchant, its fingerprint headers ARE the
+  // connection-layer truth — normalising them here is the permanent design.
+  ["tlsFingerprint", ["cf-ja3-hash"]],
+  ["ja4", ["cf-ja4"]]
+];
+function deriveConnectionFromHeaders(headers) {
+  if (!headers) return void 0;
+  const lower = {};
+  for (const name of Object.keys(headers)) {
+    const value = headers[name];
+    if (typeof value === "string" && value.length > 0) lower[name.toLowerCase()] = value;
+  }
+  const connection = {};
+  for (const [key, sources] of CONNECTION_HEADER_SOURCES) {
+    for (const source of sources) {
+      const value = lower[source]?.trim();
+      if (value) {
+        connection[key] = value;
+        break;
+      }
+    }
+  }
+  if (!connection.ip) {
+    const xff = lower["x-forwarded-for"];
+    const client = xff?.split(",")[0]?.trim();
+    if (client) connection.ip = client;
+  }
+  return Object.keys(connection).length > 0 ? connection : void 0;
+}
+function buildSdkObservedMetadata(rawHeaders) {
+  const { headers, apiKeyFormat, platformHeaders } = sanitizeHeaders(rawHeaders);
+  const flat = {};
+  if (rawHeaders) {
+    for (const name of Object.keys(rawHeaders)) {
+      const value = rawHeaders[name];
+      if (value === void 0) continue;
+      flat[name.toLowerCase()] = Array.isArray(value) ? value.join(", ") : String(value);
+    }
+  }
+  const connection = deriveConnectionFromHeaders(flat);
+  return {
+    headers,
+    ...apiKeyFormat && { apiKeyFormat },
+    ...platformHeaders && { platformHeaders },
+    ...connection && { connection },
+    schemaVersion: CAPTURE_SCHEMA_VERSION
+  };
+}
+
+// src/edge-config.ts
+var DEFAULT_EDGE_CONFIG = Object.freeze({
+  version: 1,
+  mode: "observe",
+  depth: "classify",
+  pathRules: [],
+  sampling: Object.freeze({ anonymousBeaconRate: 0.1 }),
+  failurePosture: "open"
+});
+var EDGE_MODES = ["observe", "enforce"];
+var EDGE_DEPTHS = ["classify", "authenticate", "authorize"];
+function isEdgeConfig(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const v = value;
+  if (v.version !== 1) return false;
+  if (!EDGE_MODES.includes(v.mode)) return false;
+  if (!EDGE_DEPTHS.includes(v.depth)) return false;
+  if (!Array.isArray(v.pathRules)) return false;
+  for (const rule of v.pathRules) {
+    if (typeof rule !== "object" || rule === null) return false;
+    const r = rule;
+    if (typeof r.pattern !== "string" || r.pattern.length === 0) return false;
+    if (r.mode !== void 0 && !EDGE_MODES.includes(r.mode)) return false;
+    if (r.depth !== void 0 && !EDGE_DEPTHS.includes(r.depth)) return false;
+  }
+  const sampling = v.sampling;
+  if (typeof sampling !== "object" || sampling === null || typeof sampling.anonymousBeaconRate !== "number" || sampling.anonymousBeaconRate < 0 || sampling.anonymousBeaconRate > 1) {
+    return false;
+  }
+  return v.failurePosture === "open";
+}
+async function fetchEdgeConfig(config, counterpartyId, opts) {
+  if (!counterpartyId) return null;
+  const headers = { Accept: "application/json" };
+  if (config.apiKey) {
+    headers["Authorization"] = `Bearer ${config.apiKey}`;
+    headers["X-API-Key"] = config.apiKey;
+  }
+  if (opts?.etag) headers["If-None-Match"] = opts.etag;
+  try {
+    const response = await fetch(
+      `${config.apiBaseUrl}/endpoints/${encodeURIComponent(counterpartyId)}/edge-config`,
+      { method: "GET", headers, signal: AbortSignal.timeout(opts?.timeoutMs ?? 5e3) }
+    );
+    if (response.status === 304) return { notModified: true };
+    if (!response.ok) return null;
+    const body = await response.json();
+    const edgeConfig = body.data?.edgeConfig;
+    if (!isEdgeConfig(edgeConfig)) return null;
+    return { edgeConfig, etag: response.headers.get("etag") ?? void 0 };
+  } catch {
+    return null;
+  }
+}
+var DEFAULT_TTL_MS = 60 * 1e3;
+var DEFAULT_MAX_STALE_MS = 24 * 60 * 60 * 1e3;
+var cache2 = /* @__PURE__ */ new Map();
+var inflight2 = /* @__PURE__ */ new Map();
+function cacheKey(apiBaseUrl, counterpartyId) {
+  return `${apiBaseUrl}|${counterpartyId}`;
+}
+function degradeToObserve(config) {
+  if (config.mode !== "enforce" && !config.pathRules.some((r) => r.mode === "enforce")) {
+    return config;
+  }
+  return {
+    ...config,
+    mode: "observe",
+    pathRules: config.pathRules.map((r) => r.mode === "enforce" ? { ...r, mode: "observe" } : r)
+  };
+}
+async function revalidate(config, counterpartyId) {
+  const key = cacheKey(config.apiBaseUrl, counterpartyId);
+  const existing = inflight2.get(key);
+  if (existing) return existing;
+  const promise = fetchEdgeConfig(config, counterpartyId, { etag: cache2.get(key)?.etag }).then((result) => {
+    if (result === null) return;
+    const now = Date.now();
+    if ("notModified" in result) {
+      const entry = cache2.get(key);
+      if (entry) entry.lastSuccessAt = now;
+      return;
+    }
+    cache2.set(key, { config: result.edgeConfig, etag: result.etag, lastSuccessAt: now });
+  }).finally(() => {
+    inflight2.delete(key);
+  });
+  inflight2.set(key, promise);
+  return promise;
+}
+async function getEdgeConfig(config, counterpartyId, opts) {
+  const ttlMs = opts?.ttlMs ?? DEFAULT_TTL_MS;
+  const maxStaleMs = opts?.maxStaleMs ?? DEFAULT_MAX_STALE_MS;
+  const key = cacheKey(config.apiBaseUrl, counterpartyId);
+  const entry = cache2.get(key);
+  if (entry) {
+    const age = Date.now() - entry.lastSuccessAt;
+    if (age > ttlMs) {
+      revalidate(config, counterpartyId).catch(() => {
+      });
+    }
+    return age > maxStaleMs ? degradeToObserve(entry.config) : entry.config;
+  }
+  await revalidate(config, counterpartyId).catch(() => {
+  });
+  return cache2.get(key)?.config ?? DEFAULT_EDGE_CONFIG;
+}
+function matchEdgePathRule(rules, path) {
+  for (const rule of rules) {
+    if (globToRegExp(rule.pattern).test(path)) return rule;
+  }
+  return void 0;
+}
+function globToRegExp(pattern) {
+  const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
+  return new RegExp(`^${escaped}$`, "i");
+}
+function _resetEdgeConfigCache() {
+  cache2.clear();
+  inflight2.clear();
+}
+
+// src/platform-signatures.ts
+var PLATFORM_AGENT_SIGNATURES = [
+  {
+    vendor: "claude",
+    displayName: "Anthropic Claude",
+    uaPatterns: [/claude/i, /anthropic/i],
+    agentCardPatterns: [/anthropic\.com/i, /claude\.ai/i],
+    apiKeyFormatPatterns: [/^sk-ant/i],
+    headerPatterns: [/^anthropic-version/i, /^anthropic-beta/i, /^x-anthropic-/i]
+  },
+  {
+    vendor: "chatgpt",
+    displayName: "OpenAI ChatGPT",
+    uaPatterns: [/chatgpt/i, /openai/i, /gpt-?\d/i],
+    agentCardPatterns: [/openai\.com/i, /chatgpt\.com/i],
+    apiKeyFormatPatterns: [/^sk-proj/i, /^sk-svcacct/i],
+    headerPatterns: [/^openai-organization/i, /^openai-project/i, /^openai-version/i]
+  },
+  {
+    vendor: "gemini",
+    displayName: "Google Gemini",
+    uaPatterns: [/gemini/i, /google-gemini/i, /bard/i],
+    agentCardPatterns: [/gemini\.google\.com/i, /ai\.google\.dev/i],
+    apiKeyFormatPatterns: [/^aiza/i],
+    headerPatterns: [/^x-goog-user-project/i, /^x-goog-api-client/i]
+  },
+  {
+    vendor: "cursor",
+    displayName: "Cursor",
+    uaPatterns: [/cursor/i],
+    agentCardPatterns: [/cursor\.sh/i, /cursor\.com/i]
+  },
+  {
+    vendor: "goose",
+    displayName: "Block Goose",
+    uaPatterns: [/goose/i, /block-goose/i],
+    agentCardPatterns: [/block\.xyz\/goose/i, /goose\.tools/i]
+  },
+  {
+    vendor: "perplexity",
+    displayName: "Perplexity",
+    uaPatterns: [/perplexity/i],
+    agentCardPatterns: [/perplexity\.ai/i],
+    apiKeyFormatPatterns: [/^pplx-/i]
+  }
+];
+function matchPlatformSignature(signatures, input) {
+  const ua = input.userAgent ?? "";
+  const cardUrl = input.agentCardUrl ?? "";
+  const apiKeyFormat = input.apiKeyFormat ?? "";
+  const headerLines = [];
+  if (input.platformHeaders) {
+    for (const [name, value] of Object.entries(input.platformHeaders)) {
+      headerLines.push(name, `${name}: ${value}`);
+    }
+  }
+  for (const sig of signatures) {
+    const uaMatch = sig.uaPatterns?.some((p) => p.test(ua));
+    const cardMatch = sig.agentCardPatterns?.some((p) => p.test(cardUrl));
+    const keyMatch = apiKeyFormat.length > 0 && sig.apiKeyFormatPatterns?.some((p) => p.test(apiKeyFormat));
+    const headerMatch = headerLines.length > 0 && sig.headerPatterns?.some((p) => headerLines.some((line) => p.test(line)));
+    if (uaMatch || cardMatch || keyMatch || headerMatch) {
+      const uaBase = ua.split(/[\s/]/)[0]?.toLowerCase() ?? "";
+      const cardHost = (() => {
+        try {
+          return cardUrl ? new URL(cardUrl).host : "";
+        } catch {
+          return "";
+        }
+      })();
+      const keyBasis = uaBase || cardHost || apiKeyFormat || "unknown";
+      return {
+        vendor: sig.vendor,
+        fingerprintKey: `${sig.vendor}:${keyBasis}`,
+        displayName: sig.displayName
+      };
+    }
+  }
+  return void 0;
+}
+function detectPlatformFingerprint(input) {
+  return matchPlatformSignature(PLATFORM_AGENT_SIGNATURES, input);
+}
+
+// src/edge-core/classify.ts
+var STATIC_EXTENSIONS = /\.(css|js|mjs|map|png|jpe?g|gif|webp|avif|svg|ico|woff2?|ttf|otf|eot|mp4|webm|pdf|txt|xml)$/i;
+var BOT_UA_PATTERN = /curl|wget|python-requests|python-urllib|node-fetch|axios|got|okhttp|go-http-client|libwww|httpie|java\/|ruby|php|scrapy|headless|phantomjs|selenium|playwright|puppeteer|bot|crawler|spider|slurp/i;
+var BROWSER_UA_PATTERN = /mozilla\/\d/i;
+var _patterns = { STATIC_EXTENSIONS, BOT_UA_PATTERN, BROWSER_UA_PATTERN };
+
+// src/edge-core/events.ts
+function sampled(rate, random = Math.random) {
+  if (rate <= 0) return false;
+  if (rate >= 1) return true;
+  return random() < rate;
+}
+
+// src/adapters/anonymous-beacon.ts
+function readHeader(raw, name) {
+  const value = raw[name];
+  if (typeof value === "string") return value;
+  if (Array.isArray(value)) return value[0];
+  return void 0;
+}
+function classifyPassThroughTraffic(path, rawHeaders) {
+  if (_patterns.STATIC_EXTENSIONS.test(path)) return { kind: "never" };
+  const credentials = extractCredentials(rawHeaders, {});
+  if (credentials.astraId || credentials.apiKey || credentials.jwt) {
+    return { kind: "never" };
+  }
+  const userAgent = readHeader(rawHeaders, "user-agent") ?? "";
+  const { apiKeyFormat, platformHeaders } = sanitizeHeaders(rawHeaders);
+  const fingerprint = detectPlatformFingerprint({ userAgent, apiKeyFormat, platformHeaders });
+  if (fingerprint) {
+    return {
+      kind: "platform",
+      protocol: "platform-ua",
+      evidence: { vendor: fingerprint.vendor, userAgent: userAgent || "(none)" }
+    };
+  }
+  if (!userAgent || _patterns.BOT_UA_PATTERN.test(userAgent) || !_patterns.BROWSER_UA_PATTERN.test(userAgent)) {
+    return {
+      kind: "anonymous-bot",
+      protocol: "ua-heuristic",
+      evidence: { userAgent: userAgent || "(none)" }
+    };
+  }
+  if (!readHeader(rawHeaders, "sec-fetch-mode") && !readHeader(rawHeaders, "accept-language")) {
+    return {
+      kind: "anonymous-bot",
+      protocol: "ua-heuristic",
+      evidence: { userAgent, spoofedBrowser: true }
+    };
+  }
+  return { kind: "never" };
+}
+function createAnonymousBeacon(config, options) {
+  const counterpartyId = config.counterpartyId;
+  if (!counterpartyId) return () => {
+  };
+  const random = options?.random ?? Math.random;
+  let edgeConfig;
+  let refreshing = false;
+  const refreshConfig = () => {
+    if (refreshing) return;
+    refreshing = true;
+    getEdgeConfig(config, counterpartyId).then((cfg) => {
+      edgeConfig = cfg;
+    }).catch(() => {
+    }).finally(() => {
+      refreshing = false;
+    });
+  };
+  refreshConfig();
+  return (input) => {
+    try {
+      refreshConfig();
+      const cfg = edgeConfig;
+      if (!cfg) return;
+      const traffic = classifyPassThroughTraffic(input.requestPath, input.rawHeaders);
+      if (traffic.kind === "never") return;
+      if (traffic.kind === "anonymous-bot" && !sampled(cfg.sampling.anonymousBeaconRate, random)) {
+        return;
+      }
+      const userAgent = readHeader(input.rawHeaders, "user-agent");
+      const xff = input.rawHeaders["x-forwarded-for"];
+      const xffStr = Array.isArray(xff) ? xff.join(", ") : xff;
+      const sourceIp = input.sourceIp ?? xffStr?.split(",")[0]?.trim();
+      reportUnregisteredAttempt(config, {
+        ...input.counterpartyUrl && { counterpartyUrl: input.counterpartyUrl },
+        counterpartyType: options?.counterpartyType ?? config.counterpartyType ?? "api",
+        ...sourceIp && { sourceIp },
+        ...userAgent && { userAgent },
+        requestPath: input.requestPath,
+        requestMethod: input.requestMethod,
+        ...traffic.protocol && { protocol: traffic.protocol },
+        ...traffic.evidence && { evidence: traffic.evidence },
+        observedMetadata: buildSdkObservedMetadata(input.rawHeaders)
+      }).catch(() => {
+      });
+    } catch {
+    }
+  };
+}
 
 // src/adapters/express.ts
 function defaultExtractCredentials(req) {
@@ -1216,7 +1647,7 @@ function defaultExtractCredentials(req) {
 function extractAstraSyncCredentials(req) {
   return extractHttpCredentials(req.headers);
 }
-function headerValue(value) {
+function headerValue2(value) {
   if (typeof value === "string") return value;
   if (Array.isArray(value)) return value[0];
   return void 0;
@@ -1224,9 +1655,9 @@ function headerValue(value) {
 function resolveRequestPdlss(req, routeConfig, customExtractPurpose, customExtractAction) {
   return resolveHttpPdlss({
     method: req.method,
-    astraPurpose: headerValue(req.headers["x-astra-purpose"]),
-    astraAction: headerValue(req.headers["x-astra-action"]),
-    legacyPurpose: headerValue(req.headers["x-purpose"] ?? req.headers["X-Purpose"]),
+    astraPurpose: headerValue2(req.headers["x-astra-purpose"]),
+    astraAction: headerValue2(req.headers["x-astra-action"]),
+    legacyPurpose: headerValue2(req.headers["x-purpose"] ?? req.headers["X-Purpose"]),
     queryPurpose: typeof req.query.purpose === "string" ? req.query.purpose : void 0,
     routePurpose: routeConfig?.purpose,
     routeAction: routeConfig?.action,
@@ -1274,6 +1705,20 @@ function dedupeFailures(result) {
   }
 }
 function defaultOnDenied(result, _req, res) {
+  if (result.misconfigured) {
+    res.setHeader("X-Astra-Gateway-Mode", "enforced");
+    res.status(503).json({
+      success: false,
+      error: {
+        code: "MERCHANT_VERIFICATION_MISCONFIGURED",
+        message: result.denialReasons?.[0] || "This site's AstraSync integration is misconfigured",
+        guidance: result.guidance,
+        failures: result.failures,
+        correlationId: result.correlationId
+      }
+    });
+    return;
+  }
   const statusCode = !result.identityVerified ? 401 : 403;
   res.setHeader("X-Astra-Gateway-Mode", "enforced");
   res.status(statusCode).json({
@@ -1295,6 +1740,11 @@ function defaultOnDenied(result, _req, res) {
 }
 var DEFAULT_ROUTES_REFRESH_MS = 5 * 60 * 1e3;
 function createMiddleware(options) {
+  if ("routes" in options) {
+    console.warn(
+      "[VerificationGateway] `routes` is dashboard-managed since v2.9.7; this option is ignored \u2014 configure route policy in your AstraSync dashboard."
+    );
+  }
   const {
     extractCredentials: customExtractCredentials,
     extractPurpose: customExtractPurpose,
@@ -1306,12 +1756,25 @@ function createMiddleware(options) {
     routesRefreshMs = DEFAULT_ROUTES_REFRESH_MS,
     failOnError = "open",
     caseInsensitiveRouteMatch = false,
+    anonymousBeacon = true,
     ...config
   } = options;
   if (config.apiBaseUrl) {
     prefetchWellKnown(config.apiBaseUrl).catch(() => {
     });
   }
+  const emitAnonymousBeacon = anonymousBeacon ? createAnonymousBeacon(config, { counterpartyType: config.counterpartyType ?? "api" }) : void 0;
+  const beaconPassThrough = emitAnonymousBeacon ? (req) => {
+    const xff = req.headers["x-forwarded-for"];
+    const xffStr = Array.isArray(xff) ? xff.join(", ") : xff;
+    emitAnonymousBeacon({
+      requestPath: req.path,
+      requestMethod: req.method,
+      counterpartyUrl: config.counterpartyUrl || `${req.protocol}://${req.get("host")}`,
+      sourceIp: req.ip ?? (xffStr ? xffStr.split(",")[0].trim() : void 0),
+      rawHeaders: req.headers
+    });
+  } : void 0;
   let cachedRoutes = [];
   let lastFetchAt = 0;
   let refreshing = null;
@@ -1372,6 +1835,7 @@ function createMiddleware(options) {
             cachedRoutes.length === 0 ? "no-policy" : "no-match"
           );
         }
+        beaconPassThrough?.(req);
         return next();
       }
       const wellKnownUrls = config.apiBaseUrl ? await getWellKnownUrls(config.apiBaseUrl).catch(() => void 0) : void 0;
@@ -1382,6 +1846,7 @@ function createMiddleware(options) {
           res.setHeader("X-Astra-Gateway-Mode", "unenforced");
           res.setHeader("X-Astra-Gateway-Reason", "route-none");
         }
+        beaconPassThrough?.(req);
         return next();
       }
       const pdlssPair = resolveRequestPdlss(
@@ -1474,16 +1939,10 @@ function createMiddleware(options) {
           forwardedFor: forwardedForStr,
           agentCardUrl,
           // Workstream D — capture EVERY inbound header (SDK-only merchants
-          // have no edge to do it upstream). Local string work, secrets
-          // stripped; out of the verify cache key so it doesn't defeat caching.
-          observedMetadata: (() => {
-            const { headers, apiKeyFormat, platformHeaders } = sanitizeHeaders(req.headers);
-            return {
-              headers,
-              ...apiKeyFormat && { apiKeyFormat },
-              ...platformHeaders && { platformHeaders }
-            };
-          })()
+          // have no edge to do it upstream) plus the CDN-derived connection
+          // block. Local string work, secrets stripped; out of the verify
+          // cache key so it doesn't defeat caching.
+          observedMetadata: buildSdkObservedMetadata(req.headers)
         }
       };
       let result = await verify(config, verificationRequest);
@@ -1677,7 +2136,7 @@ function resolveNextPdlss(request, routeConfig) {
     routeAction: routeConfig?.action
   });
 }
-function generateCommerceShieldHtml(result, options) {
+function generateInterstitialHtml(result, options) {
   const title = escapeHtml(options.commerceShield?.title || "AstraSync Agent Verification");
   const message = escapeHtml(
     options.commerceShield?.message || result.guidance?.message || "This site verifies AI agents before granting access. We noticed you're visiting without AstraSync credentials."
@@ -1833,13 +2292,31 @@ function generateCommerceShieldHtml(result, options) {
 }
 var DEFAULT_ROUTES_REFRESH_MS2 = 5 * 60 * 1e3;
 function createMiddleware2(options) {
+  if ("routes" in options) {
+    console.warn(
+      "[VerificationGateway/Next.js] `routes` is dashboard-managed since v2.9.7; this option is ignored \u2014 configure route policy in your AstraSync dashboard."
+    );
+  }
   const {
     skipPaths = [],
-    showCommerceShield = true,
+    showInterstitial,
+    showCommerceShield,
     enableRuntimeChallenge = true,
     routesRefreshMs = DEFAULT_ROUTES_REFRESH_MS2,
+    anonymousBeacon = true,
     ...config
   } = options;
+  const interstitialEnabled = showInterstitial ?? showCommerceShield ?? true;
+  const emitAnonymousBeacon = anonymousBeacon ? createAnonymousBeacon(config, { counterpartyType: config.counterpartyType ?? "website" }) : void 0;
+  const beaconPassThrough = emitAnonymousBeacon ? (request, pathname) => {
+    emitAnonymousBeacon({
+      requestPath: pathname,
+      requestMethod: request.method,
+      counterpartyUrl: config.counterpartyUrl || request.nextUrl.origin,
+      sourceIp: request.headers.get("x-forwarded-for")?.split(",")[0]?.trim() || void 0,
+      rawHeaders: Object.fromEntries(request.headers.entries())
+    });
+  } : void 0;
   let cachedRoutes = [];
   let lastFetchAt = 0;
   let refreshing = null;
@@ -1881,9 +2358,11 @@ function createMiddleware2(options) {
     }
     const routeConfig = findRouteConfig2(cachedRoutes, pathname, request.method);
     if (!routeConfig) {
+      beaconPassThrough?.(request, pathname);
       return NextResponse.next();
     }
     if (routeConfig.minAccessLevel === "none") {
+      beaconPassThrough?.(request, pathname);
       return NextResponse.next();
     }
     const credentials = extractCredentialsFromNextRequest(request);
@@ -1935,8 +2414,8 @@ function createMiddleware2(options) {
           { status: 403 }
         );
       }
-      if (showCommerceShield) {
-        return new NextResponse(generateCommerceShieldHtml(preCheckResult, options), {
+      if (interstitialEnabled) {
+        return new NextResponse(generateInterstitialHtml(preCheckResult, options), {
           status: 200,
           headers: {
             "Content-Type": "text/html",
@@ -1964,17 +2443,9 @@ function createMiddleware2(options) {
         host: request.headers.get("host") || void 0,
         forwardedFor,
         agentCardUrl: request.headers.get("x-astrasync-agent-card") || void 0,
-        // Workstream D — full sanitised header capture (Web Headers → plain map).
-        observedMetadata: (() => {
-          const { headers, apiKeyFormat, platformHeaders } = sanitizeHeaders(
-            Object.fromEntries(request.headers.entries())
-          );
-          return {
-            headers,
-            ...apiKeyFormat && { apiKeyFormat },
-            ...platformHeaders && { platformHeaders }
-          };
-        })()
+        // Workstream D — full sanitised header capture + CDN-derived
+        // connection block (Web Headers → plain map).
+        observedMetadata: buildSdkObservedMetadata(Object.fromEntries(request.headers.entries()))
       }
     };
     let result = await verify(config, verificationRequest);
@@ -1990,6 +2461,21 @@ function createMiddleware2(options) {
     const approvalRequired = result.identityVerified && result.policyAllowed && requiresHumanApproval(result);
     if (approvalRequired) annotateApprovalRequired(result);
     if (!result.identityVerified || !result.policyAllowed || approvalRequired) {
+      if (result.misconfigured && pathname.startsWith("/api/")) {
+        return NextResponse.json(
+          {
+            success: false,
+            error: {
+              code: "MERCHANT_VERIFICATION_MISCONFIGURED",
+              message: result.denialReasons?.[0] || "This site's AstraSync integration is misconfigured",
+              guidance: result.guidance,
+              failures: result.failures,
+              correlationId: result.correlationId
+            }
+          },
+          { status: 503 }
+        );
+      }
       if (pathname.startsWith("/api/")) {
         return NextResponse.json(
           {
@@ -2014,8 +2500,8 @@ function createMiddleware2(options) {
           }
         );
       }
-      if (showCommerceShield) {
-        return new NextResponse(generateCommerceShieldHtml(result, options), {
+      if (interstitialEnabled) {
+        return new NextResponse(generateInterstitialHtml(result, options), {
           status: 200,
           headers: {
             "Content-Type": "text/html",
@@ -2103,7 +2589,7 @@ var VerificationGatewayClient = class {
   /**
    * Quick verification — checks credentials and policy in one call.
    *
-   * Round-18 G4: return shape mirrors `VerificationResult`'s identity/policy
+   * The return shape mirrors `VerificationResult`'s identity/policy
    * split. Map to HTTP status the same way: `!identityVerified` → 401,
    * `identityVerified && !policyAllowed` → 403.
    */
@@ -2533,8 +3019,8 @@ function extractX402TransactionValue(req) {
 // src/transport/rfc9421.ts
 import { parseDictionary } from "structured-headers";
 function parseRFC9421(headers) {
-  const sigInput = readHeader(headers, "signature-input");
-  const sig = readHeader(headers, "signature");
+  const sigInput = readHeader2(headers, "signature-input");
+  const sig = readHeader2(headers, "signature");
   if (!sigInput || !sig) return null;
   let inputDict;
   let sigDict;
@@ -2578,7 +3064,7 @@ function parseRFC9421(headers) {
   if (signatures.length === 0) return null;
   return { signatures };
 }
-function readHeader(headers, name) {
+function readHeader2(headers, name) {
   for (const key of Object.keys(headers)) {
     if (key.toLowerCase() === name) {
       const raw = headers[key];
@@ -2896,11 +3382,11 @@ function extractACPContext(request) {
   const purpose = mapACPRequestToPurpose(method, path);
   const sessionId = extractSessionId2(path);
   const headers = request.headers ?? {};
-  const signatureHeader = readHeader2(headers, "signature");
-  const timestampHeader = readHeader2(headers, "timestamp");
-  const idempotencyKey = readHeader2(headers, "idempotency-key");
-  const apiVersion = readHeader2(headers, "api-version");
-  const bearer = extractBearer(readHeader2(headers, "authorization"));
+  const signatureHeader = readHeader3(headers, "signature");
+  const timestampHeader = readHeader3(headers, "timestamp");
+  const idempotencyKey = readHeader3(headers, "idempotency-key");
+  const apiVersion = readHeader3(headers, "api-version");
+  const bearer = extractBearer(readHeader3(headers, "authorization"));
   const body = request.body ?? {};
   const merchantId = coerceString3(body.merchant_id ?? body.merchantId);
   const totals = Array.isArray(body.totals) ? body.totals : void 0;
@@ -2968,7 +3454,7 @@ function extractFulfillmentOption(body) {
   }
   return void 0;
 }
-function readHeader2(headers, name) {
+function readHeader3(headers, name) {
   for (const key of Object.keys(headers)) {
     if (key.toLowerCase() === name) {
       const raw = headers[key];
@@ -3762,9 +4248,9 @@ function toBuf(bytes) {
   new Uint8Array(out).set(bytes);
   return out;
 }
-function checkTimestamp(headerValue2, toleranceSec, nowFn) {
-  if (!headerValue2) return { ok: false, error: "missing Timestamp header" };
-  const ts = parseTimestamp(headerValue2);
+function checkTimestamp(headerValue3, toleranceSec, nowFn) {
+  if (!headerValue3) return { ok: false, error: "missing Timestamp header" };
+  const ts = parseTimestamp(headerValue3);
   if (ts === null) return { ok: false, error: "unparseable Timestamp header" };
   const now = nowFn ? nowFn() : Math.floor(Date.now() / 1e3);
   if (Math.abs(now - ts) > toleranceSec) {
@@ -3808,7 +4294,7 @@ async function getSubtle() {
 // src/transport/mpp.ts
 import { Challenge, Credential, Receipt } from "mppx";
 function extractMPPFromRequest(request) {
-  const auth = readHeader3(request.headers, "authorization");
+  const auth = readHeader4(request.headers, "authorization");
   if (!auth || !/^\s*Payment\s+/i.test(auth)) return null;
   try {
     const credential = Credential.deserialize(auth);
@@ -3836,7 +4322,7 @@ function extractMPPFromResponse(response) {
       offeredMethods: methods
     };
   }
-  const receiptHeader = readHeader3(response.headers, "payment-receipt");
+  const receiptHeader = readHeader4(response.headers, "payment-receipt");
   if (receiptHeader) {
     try {
       const parsed = Receipt.deserialize(receiptHeader);
@@ -3856,7 +4342,7 @@ function extractMPPFromResponse(response) {
       return { kind: "error", error: { type: "invalid-receipt-encoding" } };
     }
   }
-  const contentType = readHeader3(response.headers, "content-type");
+  const contentType = readHeader4(response.headers, "content-type");
   if (contentType && /application\/problem\+json/i.test(contentType)) {
     const body = typeof response.body === "object" && response.body !== null ? response.body : {};
     return {
@@ -3879,7 +4365,7 @@ function extractMPPContext(message) {
   return extractMPPFromRequest(message);
 }
 function collectChallenges(response) {
-  const wwwAuth = readHeader3(response.headers, "www-authenticate");
+  const wwwAuth = readHeader4(response.headers, "www-authenticate");
   if (!wwwAuth) return [];
   const headers = new Headers();
   headers.set("www-authenticate", wwwAuth);
@@ -3907,7 +4393,7 @@ function summarizeChallenge(ch) {
     opaque: raw.opaque
   };
 }
-function readHeader3(headers, name) {
+function readHeader4(headers, name) {
   for (const key of Object.keys(headers)) {
     if (key.toLowerCase() === name) {
       const raw = headers[key];
@@ -3999,14 +4485,14 @@ import {
 } from "@x402/core/schemas";
 import { safeBase64Decode } from "@x402/core/utils";
 function extractX402FromRequest(request) {
-  const headerValue2 = readHeader4(request.headers, "x-payment");
+  const headerValue3 = readHeader5(request.headers, "x-payment");
   if (request.body && typeof request.body === "object") {
     const parsed = tryParsePayload(request.body);
     if (parsed) return buildPayloadContext(parsed, "body");
   }
-  if (headerValue2) {
+  if (headerValue3) {
     try {
-      const decoded = safeBase64Decode(headerValue2);
+      const decoded = safeBase64Decode(headerValue3);
       if (decoded) {
         const json = JSON.parse(decoded);
         const parsed = tryParsePayload(json);
@@ -4029,10 +4515,10 @@ function extractX402FromResponse(response) {
     const parsed = tryParseRequired(response.body);
     if (parsed) return buildRequiredContext(parsed, "body");
   }
-  const headerValue2 = readHeader4(response.headers, "x-payment-required");
-  if (headerValue2) {
+  const headerValue3 = readHeader5(response.headers, "x-payment-required");
+  if (headerValue3) {
     try {
-      const decoded = safeBase64Decode(headerValue2);
+      const decoded = safeBase64Decode(headerValue3);
       if (decoded) {
         const json = JSON.parse(decoded);
         const parsed = tryParseRequired(json);
@@ -4129,7 +4615,7 @@ function coerceVersion(v) {
   if (v === 1 || v === 2) return v;
   return null;
 }
-function readHeader4(headers, name) {
+function readHeader5(headers, name) {
   if (!headers) return void 0;
   for (const key of Object.keys(headers)) {
     if (key.toLowerCase() === name) {
@@ -4877,8 +5363,11 @@ function mcpToPdlss(parsed, requestPath, headerPurpose, headerAction, toolGate)
   } else if (parsed.actionFromBody && parsed.actionSourceFromBody) {
     action = parsed.actionFromBody;
     actionSource = parsed.actionSourceFromBody;
+  } else if (parsed.method === "tools/call") {
+    action = void 0;
+    actionSource = void 0;
   } else {
-    action = parsed.toolName ? parsed.method === "tools/call" ? parsed.toolName : `${parsed.method}:${parsed.toolName}` : parsed.method;
+    action = parsed.toolName ? `${parsed.method}:${parsed.toolName}` : parsed.method;
     actionSource = "transport_layer";
   }
   return { purpose, action, resource, purposeSource, actionSource };
@@ -4916,6 +5405,24 @@ function dedupeFailures2(result) {
 }
 function defaultMcpDenied(result, req, res) {
   const id = req.body?.id ?? null;
+  if (result.misconfigured) {
+    res.setHeader("X-Astra-Gateway-Mode", "enforced");
+    res.status(503).json({
+      jsonrpc: "2.0",
+      id,
+      error: {
+        // -32002 → merchant verification misconfigured (see -32000/-32001 below)
+        code: -32002,
+        message: result.denialReasons?.[0] ?? "This server's AstraSync integration is misconfigured",
+        data: {
+          guidance: result.guidance,
+          failures: result.failures,
+          correlationId: result.correlationId
+        }
+      }
+    });
+    return;
+  }
   const status = !result.identityVerified ? 401 : 403;
   res.setHeader("X-Astra-Gateway-Mode", "enforced");
   res.status(status).json({
@@ -4925,6 +5432,7 @@ function defaultMcpDenied(result, req, res) {
       // JSON-RPC error codes:
       //   -32000 → unauthorized (no identity resolved)
       //   -32001 → insufficient access (identity OK, policy denied)
+      //   -32002 → merchant verification misconfigured (handled above)
       code: !result.identityVerified ? -32e3 : -32001,
       message: result.denialReasons?.[0] ?? "Access denied",
       data: {
@@ -4974,6 +5482,15 @@ function createMcpMiddleware(options) {
     prefetchWellKnown(config.apiBaseUrl).catch(() => {
     });
   }
+  if (toolGates) {
+    for (const [toolName, gate] of Object.entries(toolGates)) {
+      if (typeof gate === "string") {
+        console.warn(
+          `[VerificationGateway/MCP] toolGates['${toolName}'] uses the bare-string shorthand ('${gate}'). Gated tools need a PDLSS purpose (else PDLSS_PURPOSE_REQUIRED 400) and evaluate purpose-only without a declared action. Use the object form instead: { minAccessLevel: '${gate}', purpose: '...', action: '...' }.`
+        );
+      }
+    }
+  }
   return async (req, res, next) => {
     try {
       if (skip) return next();
@@ -5093,7 +5610,13 @@ function createMcpMiddleware(options) {
         callerMetadata: {
           sourceIp: req.ip,
           userAgent: req.headers["user-agent"],
-          host: req.headers.host
+          host: req.headers.host,
+          // Capture EVERY inbound header (parity with the express adapter —
+          // MCP-only merchants have no edge to do it upstream) plus the
+          // CDN-derived connection block. Local string work, secrets
+          // stripped; out of the verify cache key so it doesn't defeat
+          // caching.
+          observedMetadata: buildSdkObservedMetadata(req.headers)
         }
       };
       let result = await verify(config, verificationRequest);
@@ -5878,212 +6401,6 @@ async function recordDecision2(config, params) {
     blockchainTxHash: result.blockchainTxHash
   };
 }
-
-// src/edge-config.ts
-var DEFAULT_EDGE_CONFIG = Object.freeze({
-  version: 1,
-  mode: "observe",
-  depth: "classify",
-  pathRules: [],
-  sampling: Object.freeze({ anonymousBeaconRate: 0.1 }),
-  failurePosture: "open"
-});
-var EDGE_MODES = ["observe", "enforce"];
-var EDGE_DEPTHS = ["classify", "authenticate", "authorize"];
-function isEdgeConfig(value) {
-  if (typeof value !== "object" || value === null) return false;
-  const v = value;
-  if (v.version !== 1) return false;
-  if (!EDGE_MODES.includes(v.mode)) return false;
-  if (!EDGE_DEPTHS.includes(v.depth)) return false;
-  if (!Array.isArray(v.pathRules)) return false;
-  for (const rule of v.pathRules) {
-    if (typeof rule !== "object" || rule === null) return false;
-    const r = rule;
-    if (typeof r.pattern !== "string" || r.pattern.length === 0) return false;
-    if (r.mode !== void 0 && !EDGE_MODES.includes(r.mode)) return false;
-    if (r.depth !== void 0 && !EDGE_DEPTHS.includes(r.depth)) return false;
-  }
-  const sampling = v.sampling;
-  if (typeof sampling !== "object" || sampling === null || typeof sampling.anonymousBeaconRate !== "number" || sampling.anonymousBeaconRate < 0 || sampling.anonymousBeaconRate > 1) {
-    return false;
-  }
-  return v.failurePosture === "open";
-}
-async function fetchEdgeConfig(config, counterpartyId, opts) {
-  if (!counterpartyId) return null;
-  const headers = { Accept: "application/json" };
-  if (config.apiKey) {
-    headers["Authorization"] = `Bearer ${config.apiKey}`;
-    headers["X-API-Key"] = config.apiKey;
-  }
-  if (opts?.etag) headers["If-None-Match"] = opts.etag;
-  try {
-    const response = await fetch(
-      `${config.apiBaseUrl}/endpoints/${encodeURIComponent(counterpartyId)}/edge-config`,
-      { method: "GET", headers, signal: AbortSignal.timeout(opts?.timeoutMs ?? 5e3) }
-    );
-    if (response.status === 304) return { notModified: true };
-    if (!response.ok) return null;
-    const body = await response.json();
-    const edgeConfig = body.data?.edgeConfig;
-    if (!isEdgeConfig(edgeConfig)) return null;
-    return { edgeConfig, etag: response.headers.get("etag") ?? void 0 };
-  } catch {
-    return null;
-  }
-}
-var DEFAULT_TTL_MS = 60 * 1e3;
-var DEFAULT_MAX_STALE_MS = 24 * 60 * 60 * 1e3;
-var cache2 = /* @__PURE__ */ new Map();
-var inflight2 = /* @__PURE__ */ new Map();
-function cacheKey(apiBaseUrl, counterpartyId) {
-  return `${apiBaseUrl}|${counterpartyId}`;
-}
-function degradeToObserve(config) {
-  if (config.mode !== "enforce" && !config.pathRules.some((r) => r.mode === "enforce")) {
-    return config;
-  }
-  return {
-    ...config,
-    mode: "observe",
-    pathRules: config.pathRules.map((r) => r.mode === "enforce" ? { ...r, mode: "observe" } : r)
-  };
-}
-async function revalidate(config, counterpartyId) {
-  const key = cacheKey(config.apiBaseUrl, counterpartyId);
-  const existing = inflight2.get(key);
-  if (existing) return existing;
-  const promise = fetchEdgeConfig(config, counterpartyId, { etag: cache2.get(key)?.etag }).then((result) => {
-    if (result === null) return;
-    const now = Date.now();
-    if ("notModified" in result) {
-      const entry = cache2.get(key);
-      if (entry) entry.lastSuccessAt = now;
-      return;
-    }
-    cache2.set(key, { config: result.edgeConfig, etag: result.etag, lastSuccessAt: now });
-  }).finally(() => {
-    inflight2.delete(key);
-  });
-  inflight2.set(key, promise);
-  return promise;
-}
-async function getEdgeConfig(config, counterpartyId, opts) {
-  const ttlMs = opts?.ttlMs ?? DEFAULT_TTL_MS;
-  const maxStaleMs = opts?.maxStaleMs ?? DEFAULT_MAX_STALE_MS;
-  const key = cacheKey(config.apiBaseUrl, counterpartyId);
-  const entry = cache2.get(key);
-  if (entry) {
-    const age = Date.now() - entry.lastSuccessAt;
-    if (age > ttlMs) {
-      revalidate(config, counterpartyId).catch(() => {
-      });
-    }
-    return age > maxStaleMs ? degradeToObserve(entry.config) : entry.config;
-  }
-  await revalidate(config, counterpartyId).catch(() => {
-  });
-  return cache2.get(key)?.config ?? DEFAULT_EDGE_CONFIG;
-}
-function matchEdgePathRule(rules, path) {
-  for (const rule of rules) {
-    if (globToRegExp(rule.pattern).test(path)) return rule;
-  }
-  return void 0;
-}
-function globToRegExp(pattern) {
-  const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
-  return new RegExp(`^${escaped}$`, "i");
-}
-function _resetEdgeConfigCache() {
-  cache2.clear();
-  inflight2.clear();
-}
-
-// src/platform-signatures.ts
-var PLATFORM_AGENT_SIGNATURES = [
-  {
-    vendor: "claude",
-    displayName: "Anthropic Claude",
-    uaPatterns: [/claude/i, /anthropic/i],
-    agentCardPatterns: [/anthropic\.com/i, /claude\.ai/i],
-    apiKeyFormatPatterns: [/^sk-ant/i],
-    headerPatterns: [/^anthropic-version/i, /^anthropic-beta/i, /^x-anthropic-/i]
-  },
-  {
-    vendor: "chatgpt",
-    displayName: "OpenAI ChatGPT",
-    uaPatterns: [/chatgpt/i, /openai/i, /gpt-?\d/i],
-    agentCardPatterns: [/openai\.com/i, /chatgpt\.com/i],
-    apiKeyFormatPatterns: [/^sk-proj/i, /^sk-svcacct/i],
-    headerPatterns: [/^openai-organization/i, /^openai-project/i, /^openai-version/i]
-  },
-  {
-    vendor: "gemini",
-    displayName: "Google Gemini",
-    uaPatterns: [/gemini/i, /google-gemini/i, /bard/i],
-    agentCardPatterns: [/gemini\.google\.com/i, /ai\.google\.dev/i],
-    apiKeyFormatPatterns: [/^aiza/i],
-    headerPatterns: [/^x-goog-user-project/i, /^x-goog-api-client/i]
-  },
-  {
-    vendor: "cursor",
-    displayName: "Cursor",
-    uaPatterns: [/cursor/i],
-    agentCardPatterns: [/cursor\.sh/i, /cursor\.com/i]
-  },
-  {
-    vendor: "goose",
-    displayName: "Block Goose",
-    uaPatterns: [/goose/i, /block-goose/i],
-    agentCardPatterns: [/block\.xyz\/goose/i, /goose\.tools/i]
-  },
-  {
-    vendor: "perplexity",
-    displayName: "Perplexity",
-    uaPatterns: [/perplexity/i],
-    agentCardPatterns: [/perplexity\.ai/i],
-    apiKeyFormatPatterns: [/^pplx-/i]
-  }
-];
-function matchPlatformSignature(signatures, input) {
-  const ua = input.userAgent ?? "";
-  const cardUrl = input.agentCardUrl ?? "";
-  const apiKeyFormat = input.apiKeyFormat ?? "";
-  const headerLines = [];
-  if (input.platformHeaders) {
-    for (const [name, value] of Object.entries(input.platformHeaders)) {
-      headerLines.push(name, `${name}: ${value}`);
-    }
-  }
-  for (const sig of signatures) {
-    const uaMatch = sig.uaPatterns?.some((p) => p.test(ua));
-    const cardMatch = sig.agentCardPatterns?.some((p) => p.test(cardUrl));
-    const keyMatch = apiKeyFormat.length > 0 && sig.apiKeyFormatPatterns?.some((p) => p.test(apiKeyFormat));
-    const headerMatch = headerLines.length > 0 && sig.headerPatterns?.some((p) => headerLines.some((line) => p.test(line)));
-    if (uaMatch || cardMatch || keyMatch || headerMatch) {
-      const uaBase = ua.split(/[\s/]/)[0]?.toLowerCase() ?? "";
-      const cardHost = (() => {
-        try {
-          return cardUrl ? new URL(cardUrl).host : "";
-        } catch {
-          return "";
-        }
-      })();
-      const keyBasis = uaBase || cardHost || apiKeyFormat || "unknown";
-      return {
-        vendor: sig.vendor,
-        fingerprintKey: `${sig.vendor}:${keyBasis}`,
-        displayName: sig.displayName
-      };
-    }
-  }
-  return void 0;
-}
-function detectPlatformFingerprint(input) {
-  return matchPlatformSignature(PLATFORM_AGENT_SIGNATURES, input);
-}
 export {
   ACCESS_LEVEL_DESCRIPTIONS,
   ACCESS_LEVEL_HIERARCHY,
@@ -6091,6 +6408,7 @@ export {
   AstraSync,
   AstraSyncError,
   AuthenticationError,
+  CAPTURE_SCHEMA_VERSION,
   ChallengeHandler,
   DEFAULT_EDGE_CONFIG,
   DEFAULT_TRUST_THRESHOLDS,
@@ -6109,9 +6427,11 @@ export {
   authorizeSettlement,
   awaitStepUpApproval,
   buildGuidance,
+  buildSdkObservedMetadata,
   clearCache,
   createMcpMiddleware,
   degradeToObserve,
+  deriveConnectionFromHeaders,
   detectPlatformFingerprint,
   determineAccessLevel,
   express_exports as express,