@astrasyncai/verification-gateway 5.19.0 → 5.21.0

package/dist/index.mjs

@@ -30,7 +30,7 @@ function getTrustLevel(score) {
 }
 
 // src/version.ts
-var SDK_VERSION = "5.19.0";
+var SDK_VERSION = "5.21.0";
 
 // src/http.ts
 var SDK_USER_AGENT = `astrasync-sdk/${SDK_VERSION}`;
@@ -312,6 +312,7 @@ function cacheResult(request, result, configuredTtl, counterpartyId) {
 }
 function clearCache() {
   verificationCache.clear();
+  inflightVerifies.clear();
 }
 function extractCredentials(headers, query) {
   const credentials = {};
@@ -485,6 +486,9 @@ async function callVerifyAccessAPI(config, request) {
   if (requestData.enableRuntimeChallenge)
     body.enableRuntimeChallenge = requestData.enableRuntimeChallenge;
   if (requestData.routePolicy) body.routePolicy = requestData.routePolicy;
+  if (config.actingProof?.connectorToken) {
+    body.actingProof = { connectorToken: config.actingProof.connectorToken };
+  }
   if (requestData.approvalHeldByRoute) body.approvalHeldByRoute = true;
   if (requestData.createSession) body.createSession = requestData.createSession;
   if (requestData.durationRequired) body.durationRequired = requestData.durationRequired;
@@ -652,22 +656,46 @@ async function verify(config, request, options) {
       "[VerificationGateway] minTrustScore / minTrustScoreForFull are deprecated in v2.3.0 and have no effect. Server is now the single source of truth for access decisions (verified ID + runtime challenge + PDLSS + trust score). To gate access to an endpoint, configure the endpoint's trust_score_requirement server-side."
     );
   }
-  const uncacheable = Boolean(request.commerceArtifacts);
+  const uncacheable = Boolean(request.commerceArtifacts) || Boolean(mergedConfig.actingProof);
   if (mergedConfig.cacheTtl !== 0 && !options?.bypassCache && !uncacheable) {
     const cached = getCachedResult(request, mergedConfig.counterpartyId);
     if (cached) {
       if (mergedConfig.debug) {
         console.log("[VerificationGateway] Returning cached result");
       }
-      const hit = { ...cached };
-      if (request.attemptId) {
-        hit.attemptId = request.attemptId;
-      } else {
-        delete hit.attemptId;
-      }
-      return hit;
+      return sharedVerdict(cached, request);
+    }
+  }
+  if (mergedConfig.cacheTtl !== 0 && !options?.bypassCache && !uncacheable) {
+    const key = getCacheKey(request, mergedConfig.counterpartyId);
+    const pending = inflightVerifies.get(key);
+    if (pending) return sharedVerdict(await pending, request);
+    const flight = verifyViaApi(mergedConfig, request, urls, uncacheable);
+    inflightVerifies.set(key, flight);
+    try {
+      return await flight;
+    } finally {
+      inflightVerifies.delete(key);
     }
   }
+  return verifyViaApi(mergedConfig, request, urls, uncacheable);
+}
+var inflightVerifies = /* @__PURE__ */ new Map();
+var sharedVerdicts = /* @__PURE__ */ new WeakSet();
+function isSharedVerdict(result) {
+  return sharedVerdicts.has(result);
+}
+function sharedVerdict(source, request) {
+  const hit = { ...source };
+  if (request.attemptId) {
+    hit.attemptId = request.attemptId;
+  } else {
+    delete hit.attemptId;
+  }
+  sharedVerdicts.add(hit);
+  return hit;
+}
+async function verifyViaApi(mergedConfig, request, urls, uncacheable) {
   const enrichedRequest = { ...request };
   if (!enrichedRequest.counterpartyUrl && mergedConfig.counterpartyUrl) {
     enrichedRequest.counterpartyUrl = mergedConfig.counterpartyUrl;
@@ -746,7 +774,9 @@ async function verify(config, request, options) {
       fulfilment: apiResponse.fulfilment,
       mandates: apiResponse.mandates,
       kyaToken: apiResponse.kyaToken,
-      aep: apiResponse.aep
+      aep: apiResponse.aep,
+      // 5.20.0 (round 29.1): non-fatal integration warnings (e.g. events_url_missing).
+      warnings: apiResponse.warnings
     };
     return result2;
   }
@@ -814,7 +844,9 @@ async function verify(config, request, options) {
     // 5.15.0: merchant-lane AP2 mandates + KYAPay identity token.
     mandates: apiResponse.mandates,
     kyaToken: apiResponse.kyaToken,
-    aep: apiResponse.aep
+    aep: apiResponse.aep,
+    // 5.20.0 (round 29.1): non-fatal integration warnings (e.g. events_url_missing).
+    warnings: apiResponse.warnings
   };
   if (result.recommendation === "deny") {
     result.policyAllowed = false;
@@ -840,8 +872,24 @@ async function verify(config, request, options) {
       cacheResult(request, result, mergedConfig.cacheTtl, mergedConfig.counterpartyId);
     }
   }
+  notifyVerificationListeners(request, result);
   return result;
 }
+var verificationListeners = /* @__PURE__ */ new Set();
+function onVerificationResult(listener) {
+  verificationListeners.add(listener);
+  return () => {
+    verificationListeners.delete(listener);
+  };
+}
+function notifyVerificationListeners(request, result) {
+  for (const listener of verificationListeners) {
+    try {
+      listener(result, request);
+    } catch {
+    }
+  }
+}
 async function recordDecision(config, sessionId, decision, reason) {
   const headers = { "Content-Type": "application/json" };
   if (config.apiKey) {
@@ -906,6 +954,7 @@ async function fetchRoutes(config, counterpartyId, options = {}) {
     headers["X-API-Key"] = config.apiKey;
   }
   try {
+    headers["X-AstraSync-SDK-Version"] = SDK_VERSION;
     const response = await sdkFetch(
       `${config.apiBaseUrl}/endpoints/${encodeURIComponent(counterpartyId)}/routes` + (options.codeGates?.length ? `?codeGates=${options.codeGates.map(encodeURIComponent).join(",")}` : ""),
       { method: "GET", headers }
@@ -920,6 +969,13 @@ async function fetchRoutes(config, counterpartyId, options = {}) {
       return null;
     }
     const body = await response.json();
+    const type2 = body.data?.counterpartyType;
+    if (typeof type2 === "string" && options.onEndpointType) {
+      try {
+        options.onEndpointType(type2);
+      } catch {
+      }
+    }
     return body.data?.routes ?? [];
   } catch {
     return null;
@@ -2843,14 +2899,14 @@ function createMiddleware(options) {
           res.setHeader("X-Astra-Gateway-Mode", "enforced");
           res.setHeader("X-Astra-Gateway-Reason", "evaluated-not-enforced");
         }
-        if (shouldRecordDecisions && sessionId) {
+        if (shouldRecordDecisions && sessionId && !isSharedVerdict(result)) {
           recordDecision(config, sessionId, "granted").catch(() => {
           });
         }
         return next();
       }
       if (!result.policyAllowed) {
-        if (shouldRecordDecisions && sessionId) {
+        if (shouldRecordDecisions && sessionId && !isSharedVerdict(result)) {
           recordDecision(config, sessionId, "denied", result.denialReasons?.[0]).catch(() => {
           });
         }
@@ -2863,7 +2919,7 @@ function createMiddleware(options) {
       }
       if (requiresHumanApproval(result)) {
         annotateApprovalRequired(result);
-        if (shouldRecordDecisions && sessionId) {
+        if (shouldRecordDecisions && sessionId && !isSharedVerdict(result)) {
           recordDecision(config, sessionId, "denied", result.denialReasons?.[0]).catch(() => {
           });
         }
@@ -2888,7 +2944,7 @@ function createMiddleware(options) {
               documentationUrl: wellKnownUrls.documentationUrl
             };
           }
-          if (shouldRecordDecisions && sessionId) {
+          if (shouldRecordDecisions && sessionId && !isSharedVerdict(result)) {
             recordDecision(config, sessionId, "denied", trustFailure.message).catch(() => {
             });
           }
@@ -2897,7 +2953,7 @@ function createMiddleware(options) {
           return;
         }
       }
-      if (shouldRecordDecisions && sessionId) {
+      if (shouldRecordDecisions && sessionId && !isSharedVerdict(result)) {
         recordDecision(config, sessionId, "granted").catch(() => {
         });
       }
@@ -3745,6 +3801,66 @@ var VerificationGatewayClient = class {
     }
     return json4.data;
   }
+  /**
+   * 5.20.0 (round 29.1): ask AstraSync to send ONE signed step-up event to the
+   * endpoint's Events URL now — `POST /api/endpoints/:id/events/test`.
+   * Delivered synchronously, outside the event outbox (random `eventId`, no
+   * retries), signed with the endpoint's webhook secret like a real event.
+   * The payload is synthetic (`approvalId: "test_…"`); a kit acknowledges and
+   * ignores it.
+   *
+   * 5.21.0 (shops' item 48): synthetic only. Sending a real held approval's
+   * payload (which releases or re-drives that checkout) is dashboard-only, so
+   * a leaked API key can't do it.
+   *
+   * Resolves even when your endpoint refused the event (`delivered: false`,
+   * with `responseCode` / `error`).
+   */
+  async sendTestEvent(endpointId, options) {
+    return this.endpointCall("POST", endpointId, "/events/test", { type: options.type });
+  }
+  async endpointCall(method, endpointId, suffix, body) {
+    const id = endpointId ?? this.config.counterpartyId;
+    if (!id) {
+      throw new AstraSyncError(
+        "An endpoint id (ASTRAE-\u2026) is required: pass it, or set counterpartyId on the client",
+        400,
+        "VALIDATION"
+      );
+    }
+    if (!this.config.apiKey) {
+      throw new AstraSyncError("This call needs the client apiKey", 401, "AUTH_REQUIRED");
+    }
+    const base = this.config.apiBaseUrl.replace(/\/+$/, "");
+    const url = `${base}/endpoints/${encodeURIComponent(id)}${suffix}`;
+    let res;
+    try {
+      res = await sdkFetch(url, {
+        method,
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.config.apiKey}`,
+          "X-API-Key": this.config.apiKey
+        },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(Math.max(this.timeout, 15e3))
+      });
+    } catch (err) {
+      throw new AstraSyncError(
+        `${method} ${suffix || "/endpoints/:id"} failed: ${err instanceof Error ? err.message : String(err)}`,
+        0,
+        "network_error"
+      );
+    }
+    const json4 = await res.json().catch(() => ({}));
+    if (!res.ok || json4.success === false || json4.data === void 0) {
+      const errObj = typeof json4.error === "object" ? json4.error : void 0;
+      const code = json4.code ?? errObj?.code ?? (typeof json4.error === "string" ? json4.error : "unknown_error");
+      const message = json4.message ?? errObj?.message ?? `HTTP ${res.status}`;
+      throw new AstraSyncError(`${message} (${code})`, res.status, code);
+    }
+    return json4.data;
+  }
   /**
    * Quick verification — checks credentials and policy in one call.
    *
@@ -6709,16 +6825,30 @@ function createMcpMiddleware(options) {
     failOnError = "closed",
     toolGatePrecedence = "code",
     routesRefreshMs,
+    skipEvaluation,
     ...config
   } = options;
+  const skipTools = new Set(skipEvaluation?.tools ?? []);
+  const skipMethods = new Set(skipEvaluation?.methods ?? []);
   if (config.apiBaseUrl) {
     prefetchWellKnown(config.apiBaseUrl).catch(() => {
     });
   }
   const codeGatedTools = Object.entries(toolGates ?? {}).filter(([, g]) => g !== "observe").map(([name]) => name);
+  let warnedEndpointType = false;
+  const onEndpointType = (counterpartyType) => {
+    if (counterpartyType === "mcp_server" || warnedEndpointType) return;
+    warnedEndpointType = true;
+    console.warn(
+      `[VerificationGateway/MCP] counterpartyId ${config.counterpartyId} is a '${counterpartyType}' endpoint, not an 'mcp_server' endpoint. Dashboard tool rules are read from an mcp_server endpoint only: register a separate MCP endpoint for this server (same owner) and use its id here. See https://astrasync.ai/docs/mcp-integration#tool-rules.`
+    );
+  };
   const rulesCache = config.apiKey && config.counterpartyId ? createRoutesCache(config, {
     ...routesRefreshMs !== void 0 && { refreshMs: routesRefreshMs },
-    ...codeGatedTools.length && { fetchOptions: { codeGates: codeGatedTools } }
+    fetchOptions: {
+      ...codeGatedTools.length && { codeGates: codeGatedTools },
+      onEndpointType
+    }
   }) : void 0;
   return async (req, res, next) => {
     try {
@@ -6768,6 +6898,9 @@ function createMcpMiddleware(options) {
           return next();
         }
       }
+      if (!parsed.toolName && skipMethods.has(parsed.method) && methodGates?.[parsed.method] === void 0) {
+        return next();
+      }
       const dashboardRules = rulesCache ? dashboardToolRules(await rulesCache.current()) : void 0;
       const gateDecision = resolveGate(parsed, {
         toolGates,
@@ -6775,6 +6908,9 @@ function createMcpMiddleware(options) {
         dashboardRules,
         toolGatePrecedence
       });
+      if (!gateDecision.enforce && (parsed.toolName && skipTools.has(parsed.toolName) || !parsed.toolName && skipMethods.has(parsed.method))) {
+        return next();
+      }
       const credentials = extractCredentials(
         req.headers,
         req.query
@@ -6831,8 +6967,14 @@ function createMcpMiddleware(options) {
       const forwardedFor = req.headers["x-forwarded-for"];
       const forwardedForStr = Array.isArray(forwardedFor) ? forwardedFor.join(", ") : forwardedFor;
       const sourceIp = req.ip ?? (forwardedForStr ? forwardedForStr.split(",")[0].trim() : void 0);
+      const attemptRaw = readSingleHeader(req.headers["x-astra-attempt-id"]);
+      const metaAttempt = req.body?.params?._meta?.astrasync?.attemptId;
+      const attemptId = [attemptRaw, metaAttempt].find(
+        (v) => typeof v === "string" && /^att_[0-9a-f]{32}$/.test(v)
+      );
       const verificationRequest = {
         credentials,
+        ...attemptId && { attemptId },
         purpose: pdlss.purpose,
         action: pdlss.action,
         resource: pdlss.resource,
@@ -6894,14 +7036,14 @@ function createMcpMiddleware(options) {
           res.setHeader("X-Astra-Gateway-Mode", "enforced");
           res.setHeader("X-Astra-Gateway-Reason", "evaluated-not-enforced");
         }
-        if (shouldRecordDecisions && sessionId) {
+        if (shouldRecordDecisions && sessionId && !isSharedVerdict(result)) {
           recordDecision(config, sessionId, "granted").catch(() => {
           });
         }
         return next();
       }
       if (!result.policyAllowed) {
-        if (shouldRecordDecisions && sessionId) {
+        if (shouldRecordDecisions && sessionId && !isSharedVerdict(result)) {
           recordDecision(config, sessionId, "denied", result.denialReasons?.[0]).catch(() => {
           });
         }
@@ -6911,7 +7053,7 @@ function createMcpMiddleware(options) {
       }
       if (requiresHumanApproval(result)) {
         annotateApprovalRequired(result);
-        if (shouldRecordDecisions && sessionId) {
+        if (shouldRecordDecisions && sessionId && !isSharedVerdict(result)) {
           recordDecision(config, sessionId, "denied", result.denialReasons?.[0]).catch(() => {
           });
         }
@@ -6929,7 +7071,7 @@ function createMcpMiddleware(options) {
           })
         );
       }
-      if (shouldRecordDecisions && sessionId) {
+      if (shouldRecordDecisions && sessionId && !isSharedVerdict(result)) {
         recordDecision(config, sessionId, "granted").catch(() => {
         });
       }
@@ -8869,13 +9011,13 @@ function requireLoader() {
         throwError(state, "ill-formed argument of the YAML directive");
       }
       const major = parseInt(match[1], 10);
-      const minor = parseInt(match[2], 10);
+      const minor2 = parseInt(match[2], 10);
       if (major !== 1) {
         throwError(state, "unacceptable YAML version of the document");
       }
       state.version = args[0];
-      state.checkLineBreaks = minor < 2;
-      if (minor !== 1 && minor !== 2) {
+      state.checkLineBreaks = minor2 < 2;
+      if (minor2 !== 1 && minor2 !== 2) {
         throwWarning(state, "unsupported YAML version of the document");
       }
     },
@@ -10938,6 +11080,16 @@ function checkUcpAgentBinding(header, identities) {
 
 // src/ucp/profile.ts
 var UCP_VERSION = "2026-08-25";
+function ucpProfileKeys(profile) {
+  const out = [];
+  for (const list of [profile?.keys, profile?.signing_keys]) {
+    if (!Array.isArray(list)) continue;
+    for (const k of list) {
+      if (k && typeof k === "object" && k.use !== "enc") out.push(k);
+    }
+  }
+  return out;
+}
 var SPEC = `https://ucp.dev/${UCP_VERSION}/specification`;
 var SCHEMAS = `https://ucp.dev/${UCP_VERSION}/schemas`;
 function astrasyncPaymentHandlers(handlers, specBase = "https://astrasync.ai/ucp/handlers") {
@@ -11361,6 +11513,228 @@ async function sendUcpWebhook(opts) {
   return { ok: false, status: last, attempts };
 }
 
+// src/ucp/agent-commerce.ts
+var ISSUER_PROGRAM_HEADER = "X-Astra-Issuer-Program";
+function issuerOfferPrice(priceMinor, percentOff) {
+  if (!percentOff) return priceMinor;
+  const pct = Math.min(100, Math.max(0, percentOff));
+  return Math.max(0, Math.round(priceMinor * (1 - pct / 100)));
+}
+function priceForAgent(rules, sku, basePriceMinor, ctx) {
+  const rule = rules?.products?.[sku];
+  let price = rule?.priceMinor ?? basePriceMinor;
+  if (ctx.verified && rules?.verifiedPercentOff) {
+    price = issuerOfferPrice(price, rules.verifiedPercentOff);
+  }
+  const offer = ctx.verified && ctx.issuerProgram && rule?.issuerEligible !== false ? rules?.offers?.find((o) => o.program === ctx.issuerProgram) : void 0;
+  if (offer?.pricePercentOff) {
+    return {
+      priceMinor: issuerOfferPrice(price, offer.pricePercentOff),
+      regularMinor: price,
+      issuerProgram: offer.program
+    };
+  }
+  return { priceMinor: price };
+}
+function visibleToAgent(rules, sku, ctx) {
+  if (!ctx.verified && rules?.hideFromUnverified) return false;
+  return rules?.products?.[sku]?.visible !== false;
+}
+function createAgentCommerce(opts) {
+  const f = opts.fetch ?? sdkFetch;
+  let current = null;
+  let kitReport;
+  const refreshMs = opts.refreshMs ?? 5 * 6e4;
+  async function refresh() {
+    try {
+      const headers = {
+        Accept: "application/json",
+        Authorization: `Bearer ${opts.apiKey}`,
+        "X-AstraSync-SDK-Version": SDK_VERSION
+      };
+      if (kitReport) {
+        headers["X-AstraSync-Kit-Report"] = Buffer.from(JSON.stringify(kitReport)).toString(
+          "base64url"
+        );
+      }
+      const res = await f(
+        `${opts.apiBaseUrl.replace(/\/+$/, "")}/endpoints/${encodeURIComponent(
+          opts.counterpartyId
+        )}/agent-commerce`,
+        { method: "GET", headers }
+      );
+      if (!res.ok) return;
+      const body = await res.json();
+      if (body.data && typeof body.data.version === "number") current = body.data;
+    } catch {
+    }
+  }
+  const timer = refreshMs > 0 ? setInterval(() => {
+    void refresh();
+  }, refreshMs) : null;
+  timer?.unref?.();
+  void refresh();
+  return {
+    rules: () => current,
+    refresh,
+    price: (sku, base, ctx) => priceForAgent(current, sku, base, ctx),
+    visible: (sku, ctx) => visibleToAgent(current, sku, ctx),
+    report: (r) => {
+      kitReport = { ...kitReport, ...r };
+    },
+    stop: () => {
+      if (timer) clearInterval(timer);
+    }
+  };
+}
+function pricingContextFrom(headers) {
+  const astraId = headers.get("x-astra-id");
+  const hop = parseVerifiedHop(headers.get(MCP_VERIFIED_HOP_HEADER.toLowerCase()));
+  const verified = !!astraId && (!hop || hop.astraId === astraId && Date.now() - hop.checkedAt <= MCP_VERIFIED_HOP_MAX_AGE_MS);
+  const program = headers.get(ISSUER_PROGRAM_HEADER.toLowerCase());
+  return {
+    verified,
+    ...verified && program && /^[a-z0-9-]{2,40}$/.test(program) && { issuerProgram: program }
+  };
+}
+function minor(value) {
+  const n = typeof value === "number" ? value : Number(String(value ?? "").replace(/[^\d.]/g, ""));
+  return Number.isFinite(n) && n >= 0 ? Math.round(n * 100) : null;
+}
+function fromFeed(url, options = {}) {
+  const f = options.fetch ?? fetch;
+  let cache4 = null;
+  return async () => {
+    if (cache4 && Date.now() - cache4.at < 6e4) return cache4.products;
+    const res = await f(url, {
+      headers: { Accept: "application/json, application/xml, text/csv" }
+    });
+    if (!res.ok) throw new Error(`Product feed ${url} answered ${res.status}`);
+    const text = await res.text();
+    const products = parseFeed(text, options.currency ?? "AUD");
+    cache4 = { at: Date.now(), products };
+    return products;
+  };
+}
+function parseFeed(text, currency) {
+  const trimmed = text.trimStart();
+  if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+    const json4 = JSON.parse(trimmed);
+    const list = Array.isArray(json4) ? json4 : json4.products ?? json4.items ?? [];
+    return list.flatMap((p) => {
+      const variant = p.variants?.[0];
+      const price = minor(variant?.price ?? p.price);
+      const sku = String(variant?.sku || p.sku || p.id || "");
+      if (!sku || price === null) return [];
+      const images = Array.isArray(p.images) ? p.images.map(
+        (i) => typeof i === "string" ? i : i.src ?? ""
+      ) : [p.image_url, p.image].filter((x) => typeof x === "string");
+      return [
+        {
+          sku,
+          name: String(p.title ?? p.name ?? sku),
+          priceMinor: price,
+          currency: String(p.currency ?? currency),
+          ...typeof p.description === "string" && { description: p.description },
+          imageUrls: images.filter((u) => /^https:\/\//.test(u)),
+          inStock: variant ? variant.available !== false : p.in_stock !== false
+        }
+      ];
+    });
+  }
+  if (trimmed.startsWith("<")) {
+    const items = trimmed.split(/<item[\s>]|<entry[\s>]/).slice(1);
+    return items.flatMap((chunk) => {
+      const tag = (name) => {
+        const m = new RegExp(`<(?:g:)?${name}[^>]*>([\\s\\S]*?)</(?:g:)?${name}>`).exec(chunk);
+        return m ? m[1].replace(/<!\[CDATA\[|\]\]>/g, "").trim() : void 0;
+      };
+      const sku = tag("id");
+      const price = minor(tag("price"));
+      if (!sku || price === null) return [];
+      const extra = [...chunk.matchAll(/<g:additional_image_link>([^<]+)</g)].map(
+        (m) => m[1].trim()
+      );
+      return [
+        {
+          sku,
+          name: tag("title") ?? sku,
+          priceMinor: price,
+          currency: /[A-Z]{3}/.exec(tag("price") ?? "")?.[0] ?? currency,
+          imageUrls: [tag("image_link"), ...extra].filter(
+            (u) => !!u && /^https:\/\//.test(u)
+          ),
+          inStock: (tag("availability") ?? "in stock").replace(/_/g, " ") !== "out of stock"
+        }
+      ];
+    });
+  }
+  const [head, ...rows] = trimmed.split(/\r?\n/).filter(Boolean);
+  const cols = head.split(",").map((c) => c.trim().toLowerCase());
+  const at = (r, ...names) => {
+    const i = cols.findIndex((c) => names.includes(c));
+    return i >= 0 ? r[i]?.trim() : void 0;
+  };
+  return rows.flatMap((line) => {
+    const r = line.split(",");
+    const sku = at(r, "id", "sku");
+    const price = minor(at(r, "price"));
+    if (!sku || price === null) return [];
+    const image = at(r, "image_link", "image_url", "image");
+    return [
+      {
+        sku,
+        name: at(r, "title", "name") ?? sku,
+        priceMinor: price,
+        currency,
+        imageUrls: image && /^https:\/\//.test(image) ? [image] : [],
+        inStock: (at(r, "availability", "in_stock") ?? "in stock") !== "out of stock"
+      }
+    ];
+  });
+}
+function serveAgentCatalog(opts) {
+  return async (req, res) => {
+    const ctx = pricingContextFrom({
+      get: (name) => {
+        const v = req.headers[name.toLowerCase()];
+        return Array.isArray(v) ? v[0] ?? null : v ?? null;
+      }
+    });
+    let products;
+    try {
+      products = await opts.products();
+    } catch {
+      res.status(503).json({ error: "catalog_unavailable" });
+      return;
+    }
+    const rules = opts.commerce.rules();
+    res.setHeader?.("Cache-Control", ctx.verified ? "private, no-store" : "public, max-age=60");
+    res.json({
+      products: products.filter((p) => opts.commerce.visible(p.sku, ctx)).map((p) => {
+        const priced = opts.commerce.price(p.sku, p.priceMinor, ctx);
+        const image = rules?.products?.[p.sku]?.imageUrl ?? p.imageUrls?.[0];
+        return {
+          sku: p.sku,
+          name: p.name,
+          ...p.description && { description: p.description },
+          price: priced.priceMinor / 100,
+          currency: p.currency,
+          ...image && { image_url: image },
+          in_stock: p.inStock !== false,
+          ...p.url && { url: p.url },
+          ...priced.issuerProgram && {
+            issuer_offer: {
+              program: priced.issuerProgram,
+              regular_price: (priced.regularMinor ?? p.priceMinor) / 100
+            }
+          }
+        };
+      })
+    });
+  };
+}
+
 // src/ucp/checkout-kit.ts
 import { createHash as createHash10, randomUUID as randomUUID2 } from "crypto";
 import { CompactSign as CompactSign2 } from "jose";
@@ -12102,6 +12476,19 @@ var resumeResult = (outcome, session) => ({
 });
 
 // src/ucp/checkout-kit.ts
+function withValidImageUrl(item) {
+  if (item.image_url === void 0) return item;
+  let ok = false;
+  try {
+    const u = new URL(item.image_url);
+    ok = u.protocol === "https:" || u.protocol === "http:";
+  } catch {
+    ok = false;
+  }
+  if (ok) return item;
+  const { image_url: _drop, ...rest } = item;
+  return rest;
+}
 var MemoryCheckoutStore = class {
   constructor() {
     this.m = /* @__PURE__ */ new Map();
@@ -12171,6 +12558,7 @@ var clone = (v) => JSON.parse(JSON.stringify(v));
 var inFlight = (st) => st === "complete_in_progress" || st === "finishing";
 function createUcpCheckoutKit(opts) {
   const profile = buildUcpProfile(opts.profile);
+  opts.agentCommerce?.report({ checkoutUrl: opts.profile.endpoint, protocols: ["ucp"] });
   const store = opts.store ?? new MemoryCheckoutStore();
   const idem = {
     store: opts.idempotencyStore ?? new MemoryIdempotencyStore(),
@@ -12344,9 +12732,7 @@ function createUcpCheckoutKit(opts) {
     delete s._approvalId;
     if (settled.status === "failed") {
       s.status = "ready_for_complete";
-      s.messages = [
-        ucpError("payment_failed", "The payment did not go through.", "recoverable")
-      ];
+      s.messages = [ucpError("payment_failed", "The payment did not go through.", "recoverable")];
       await save(s);
       return;
     }
@@ -12380,12 +12766,14 @@ function createUcpCheckoutKit(opts) {
     const b = checkUcpAgentBinding(req.headers.get("ucp-agent"), identities);
     return b.ok ? null : b;
   }
-  async function priceLines(lines) {
+  async function priceLines(lines, pricing = { verified: false }) {
     const out = [];
     const messages = [];
+    let issuerProgram;
     for (const [i, l] of lines.entries()) {
       const q = Math.max(1, Math.floor(l.quantity ?? 1));
-      const item = l.item?.id ? await opts.catalog(l.item.id, q) : null;
+      const found = l.item?.id ? await opts.catalog(l.item.id, q) : null;
+      const item = found && withValidImageUrl(found);
       if (!item) {
         messages.push(
           ucpError(
@@ -12397,6 +12785,22 @@ function createUcpCheckoutKit(opts) {
         );
         continue;
       }
+      if (opts.agentCommerce) {
+        if (!opts.agentCommerce.visible(item.id, pricing)) {
+          messages.push(
+            ucpError(
+              "item_unavailable",
+              `Item ${item.id} is unavailable.`,
+              "recoverable",
+              `$.line_items[${i}]`
+            )
+          );
+          continue;
+        }
+        const priced = opts.agentCommerce.price(item.id, item.price, pricing);
+        item.price = priced.priceMinor;
+        if (priced.issuerProgram) issuerProgram = priced.issuerProgram;
+      }
       const amount = item.price * q;
       out.push({
         id: `li_${i + 1}`,
@@ -12412,6 +12816,7 @@ function createUcpCheckoutKit(opts) {
     return {
       lines: out,
       messages,
+      issuerProgram,
       totals: [
         { type: "subtotal", amount: sum },
         { type: "total", amount: sum }
@@ -12474,7 +12879,7 @@ function createUcpCheckoutKit(opts) {
         { method: req.method, url: req.url, headers, body: body || void 0 },
         async (fresh) => {
           const pp = fresh ? await fetchProfile(profileUrl, true) : plat;
-          return "keys" in pp && pp.keys ? pp.keys : [];
+          return "ucp" in pp ? ucpProfileKeys(pp) : [];
         }
       );
       if (!sig.ok) return { error: json2(sig.status, { code: sig.code, content: sig.content }) };
@@ -12581,7 +12986,11 @@ function createUcpCheckoutKit(opts) {
         ...checkoutJwt && { checkoutJwt },
         valueMajor: total(s) / 100,
         agentArtifacts,
-        metadata: { kitSessionId: s.id, protocol: "ucp" }
+        metadata: {
+          kitSessionId: s.id,
+          protocol: "ucp",
+          ...s._issuerProgram && { issuerProgram: s._issuerProgram }
+        }
       });
       const binding2 = await bindAgent(req, result);
       if (binding2) {
@@ -12720,7 +13129,11 @@ function createUcpCheckoutKit(opts) {
         attemptId: s._attemptId,
         ...checkoutJwt && { checkoutJwt },
         valueMajor: total(s) / 100,
-        metadata: { kitSessionId: s.id, protocol: "ucp" },
+        metadata: {
+          kitSessionId: s.id,
+          protocol: "ucp",
+          ...s._issuerProgram && { issuerProgram: s._issuerProgram }
+        },
         resumed: { ...s._approvalId && { approvalId: s._approvalId } }
       });
       if (isHeld(result)) {
@@ -12770,7 +13183,7 @@ function createUcpCheckoutKit(opts) {
       ucpError(
         `approval_${reason}`,
         reason === "denied" ? "The buyer declined this purchase." : "The approval for this purchase is no longer valid. Complete the checkout again to request a new one.",
-        "requires_buyer_review"
+        "recoverable"
       )
     ];
     await store.put(s);
@@ -12805,7 +13218,7 @@ function createUcpCheckoutKit(opts) {
       });
       if (status === "approved" || status === "consumed") {
         out.push({ sessionId: s.id, outcome: (await resumeApproved(s.id)).outcome });
-      } else if (status === "denied" || status === "expired") {
+      } else if (status === "denied" || status === "expired" || status === "lapsed") {
         out.push({ sessionId: s.id, outcome: (await resumeDeclined(s.id, status)).outcome });
       } else {
         out.push({ sessionId: s.id, outcome: "pending" });
@@ -12835,7 +13248,10 @@ function createUcpCheckoutKit(opts) {
     const caller = await resolveCallerScope(req, reqCtx, opts.resolveCallerId) ?? fallbackScope("ucp-profile", ctx.profileUrl);
     if (req.method === "POST" && path === "/checkout-sessions") {
       return withIdempotency2(req, body, path, caller, async () => {
-        const priced = await priceLines(parsed.line_items ?? []);
+        const priced = await priceLines(
+          parsed.line_items ?? [],
+          pricingContextFrom(req.headers)
+        );
         const webhookUrl = ctx.plat.ucp.capabilities?.[UCP_ORDER_CAPABILITY]?.[0]?.config?.webhook_url;
         const s2 = {
           id: `chk_${randomUUID2().replace(/-/g, "")}`,
@@ -12848,11 +13264,12 @@ function createUcpCheckoutKit(opts) {
           _caller: caller,
           _platformProfile: ctx.profileUrl,
           _ap2: ctx.ap2,
-          _platformKeys: ctx.plat.keys ?? [],
+          _platformKeys: ucpProfileKeys(ctx.plat),
           ...typeof webhookUrl === "string" && /^https:\/\//.test(webhookUrl) && { _webhookUrl: webhookUrl },
           ...req.headers.get("x-astra-checkout-session") && {
             _astraCheckoutSessionId: req.headers.get("x-astra-checkout-session").slice(0, 64)
-          }
+          },
+          ...priced.issuerProgram && { _issuerProgram: priced.issuerProgram }
         };
         if (!priced.lines.length) {
           return json2(
@@ -12897,8 +13314,13 @@ function createUcpCheckoutKit(opts) {
         if (inFlight(s.status)) return busy(s);
         if (s.status === "requires_escalation") return heldNoEdit(s);
         if (parsed.line_items) {
-          const priced = await priceLines(parsed.line_items);
+          const priced = await priceLines(
+            parsed.line_items,
+            pricingContextFrom(req.headers)
+          );
           s.line_items = priced.lines;
+          if (priced.issuerProgram) s._issuerProgram = priced.issuerProgram;
+          else delete s._issuerProgram;
           s.totals = priced.totals;
           s.messages = priced.messages;
           s.status = priced.lines.length && !priced.messages.length ? "ready_for_complete" : "incomplete";
@@ -13540,7 +13962,12 @@ var ACP_CODES = /* @__PURE__ */ new Set([
   "out_of_stock",
   "payment_declined",
   "requires_sign_in",
-  "requires_3ds"
+  "requires_3ds",
+  // 5.20.0: the owner-approval codes the kit itself emits.
+  "approval_required",
+  "approval_denied",
+  "approval_expired",
+  "approval_lapsed"
 ]);
 function heldBody2(text) {
   try {
@@ -13550,6 +13977,7 @@ function heldBody2(text) {
   }
 }
 function createAcpCheckoutKit(opts) {
+  opts.agentCommerce?.report({ protocols: ["acp"] });
   const mem = /* @__PURE__ */ new Map();
   const store = opts.store ?? {
     get: async (id) => mem.get(id) ?? null,
@@ -13602,12 +14030,14 @@ function createAcpCheckoutKit(opts) {
       ...s.order && { order: s.order }
     };
   }
-  async function price(items) {
+  async function price(items, pricing = { verified: false }) {
     const lines = [];
     const messages = [];
+    let issuerProgram;
     for (const [i, it] of items.entries()) {
       const q = Math.max(1, Math.floor(it.quantity ?? 1));
-      const c = it.id ? await opts.catalog(it.id, q) : null;
+      const found = it.id ? await opts.catalog(it.id, q) : null;
+      const c = found && withValidImageUrl(found);
       if (!c) {
         messages.push({
           type: "error",
@@ -13618,10 +14048,31 @@ function createAcpCheckoutKit(opts) {
         });
         continue;
       }
+      if (opts.agentCommerce) {
+        if (!opts.agentCommerce.visible(c.id, pricing)) {
+          messages.push({
+            type: "error",
+            code: "not_found",
+            content: `Item ${c.id} not found.`,
+            resolution: "recoverable",
+            param: `$.line_items[${i}]`
+          });
+          continue;
+        }
+        const priced = opts.agentCommerce.price(c.id, c.price, pricing);
+        c.price = priced.priceMinor;
+        if (priced.issuerProgram) issuerProgram = priced.issuerProgram;
+      }
       const amount = c.price * q;
       lines.push({
         id: `li_${i + 1}`,
-        item: { id: c.id, name: c.title, unit_amount: c.price },
+        item: {
+          id: c.id,
+          name: c.title,
+          unit_amount: c.price,
+          ...c.image_url && { image_url: c.image_url },
+          ...typeof c.description === "string" && { description: c.description }
+        },
         quantity: q,
         name: c.title,
         unit_amount: c.price,
@@ -13635,6 +14086,7 @@ function createAcpCheckoutKit(opts) {
     return {
       lines,
       messages,
+      issuerProgram,
       totals: [
         { type: "subtotal", amount: sum },
         { type: "total", amount: sum }
@@ -13786,7 +14238,11 @@ function createAcpCheckoutKit(opts) {
         attemptId,
         valueMajor: total2(s) / 100,
         agentArtifacts,
-        metadata: { kitSessionId: s.id, protocol: "acp" }
+        metadata: {
+          kitSessionId: s.id,
+          protocol: "acp",
+          ...s._issuerProgram && { issuerProgram: s._issuerProgram }
+        }
       });
       if (isHeld(result)) {
         s.status = "pending_approval";
@@ -13923,7 +14379,11 @@ function createAcpCheckoutKit(opts) {
         astraId: s._astraId,
         attemptId: s._attemptId,
         valueMajor: total2(s) / 100,
-        metadata: { kitSessionId: s.id, protocol: "acp" },
+        metadata: {
+          kitSessionId: s.id,
+          protocol: "acp",
+          ...s._issuerProgram && { issuerProgram: s._issuerProgram }
+        },
         resumed: { ...s._approvalId && { approvalId: s._approvalId } }
       });
       if (isHeld(result)) {
@@ -13968,7 +14428,7 @@ function createAcpCheckoutKit(opts) {
         code: `approval_${reason}`,
         content: reason === "denied" ? "The buyer declined this purchase." : "The approval for this purchase is no longer valid. Complete the session again to request a new one.",
         severity: "medium",
-        resolution: "requires_buyer_review"
+        resolution: "recoverable"
       }
     ];
     await store.put(s);
@@ -14003,7 +14463,7 @@ function createAcpCheckoutKit(opts) {
       });
       if (status === "approved" || status === "consumed") {
         out.push({ sessionId: s.id, outcome: (await resumeApproved(s.id)).outcome });
-      } else if (status === "denied" || status === "expired") {
+      } else if (status === "denied" || status === "expired" || status === "lapsed") {
         out.push({ sessionId: s.id, outcome: (await resumeDeclined(s.id, status)).outcome });
       } else {
         out.push({ sessionId: s.id, outcome: "pending" });
@@ -14041,7 +14501,7 @@ function createAcpCheckoutKit(opts) {
         const items = parsed.line_items ?? parsed.items;
         if (!items?.length)
           return apiError(400, "missing", "line_items is required.", "$.line_items");
-        const p = await price(items);
+        const p = await price(items, pricingContextFrom(req.headers));
         const s2 = {
           id: `cs_${randomUUID3().replace(/-/g, "")}`,
           status: p.lines.length && !p.messages.length ? "ready_for_payment" : "not_ready_for_payment",
@@ -14052,7 +14512,8 @@ function createAcpCheckoutKit(opts) {
           _caller: caller,
           ...req.headers.get("x-astra-checkout-session") && {
             _astraCheckoutSessionId: req.headers.get("x-astra-checkout-session").slice(0, 64)
-          }
+          },
+          ...p.issuerProgram && { _issuerProgram: p.issuerProgram }
         };
         if (s2.status === "ready_for_payment") {
           const v = await validate(s2);
@@ -14081,7 +14542,9 @@ function createAcpCheckoutKit(opts) {
           );
         const items = parsed.line_items ?? parsed.items;
         if (items) {
-          const p = await price(items);
+          const p = await price(items, pricingContextFrom(req.headers));
+          if (p.issuerProgram) s._issuerProgram = p.issuerProgram;
+          else delete s._issuerProgram;
           Object.assign(s, {
             line_items: p.lines,
             totals: p.totals,
@@ -14231,6 +14694,7 @@ export {
   DECLARED_SOURCE_MAX,
   DEFAULT_EDGE_CONFIG,
   DEFAULT_IDEMPOTENCY_TTL_MS,
+  ISSUER_PROGRAM_HEADER,
   KYDRequiredError,
   MAX_HEADERS,
   MAX_HEADER_VALUE_BYTES,
@@ -14289,6 +14753,7 @@ export {
   closedPaymentMandate,
   contentDigest,
   createAcpCheckoutKit,
+  createAgentCommerce,
   createKbHop,
   createMcpMiddleware,
   createUcpCheckoutKit,
@@ -14310,6 +14775,7 @@ export {
   fetchRoutes,
   fetchUcpProfile,
   finishIdempotent,
+  fromFeed,
   getCachedWellKnownUrls,
   getEdgeConfig,
   getTrustLevel,
@@ -14320,10 +14786,12 @@ export {
   isEdgeConfig,
   isRejectedIdentityClaim,
   isRetryableSettlementError,
+  isSharedVerdict,
   isSpecialUseIp,
   isVerificationUnavailable,
   isVerifiedHopValidFor,
   issueDelegateSdJwt,
+  issuerOfferPrice,
   matchEdgePathRule,
   matchPlatformSignature,
   matchRoutePattern,
@@ -14331,8 +14799,10 @@ export {
   negotiateUcp,
   nextjs_exports as nextjs,
   normalizeDeclaredSource,
+  onVerificationResult,
   openCheckoutMandate,
   openPaymentMandate,
+  parseFeed,
   parseYaml as parseLocalPolicyYaml,
   parseMppCredential,
   parseUcpAgentHeader,
@@ -14341,6 +14811,7 @@ export {
   parseX402Payment,
   pollStepUpStatus,
   prefetchWellKnown,
+  priceForAgent,
   quickVerify,
   recordDecision2 as recordDecision,
   reportAttempt,
@@ -14354,6 +14825,7 @@ export {
   sdkFetch,
   sendUcpWebhook,
   serializeVerifiedHop,
+  serveAgentCatalog,
   setMcpMeta,
   signHttpRequest,
   signRootMandate,
@@ -14364,6 +14836,7 @@ export {
   ucpEscalation,
   ucpFailure,
   ucpProfileHandler,
+  ucpProfileKeys,
   ucpRequiredComponents,
   unavailableRetryAfterSeconds,
   validatePolicy as validateLocalPolicy,