@agent-score/commerce 2.4.0 → 2.6.0

package/dist/identity/hono.mjs

@@ -44,7 +44,7 @@ var IDENTITY_VERIFICATION_REQUIRED_FALLBACK_INSTRUCTIONS = JSON.stringify({
 var API_ERROR_INSTRUCTIONS = JSON.stringify({
   action: "retry_with_backoff",
   steps: [
-    "Verification is temporarily unavailable. Retry the request after 5\u201330 seconds with exponential backoff.",
+    "Verification is temporarily unavailable. Retry the request after 5-30 seconds with exponential backoff.",
     "This is NOT a compliance denial \u2014 the user does not need to re-verify their identity. Send the same identity headers (X-Wallet-Address or X-Operator-Token) on retry.",
     "If the request continues to fail after 3+ retries (~60 seconds total), surface the error to the user with the merchant's support contact."
   ],
@@ -131,7 +131,605 @@ function denialReasonToBody(reason) {
   return body;
 }
 
+// src/aip/verify.ts
+import { decodeJwt, decodeProtectedHeader, importJWK as importJWK2, jwtVerify } from "jose";
+
+// src/aip/http-signature.ts
+import { calculateJwkThumbprint, importJWK } from "jose";
+var { subtle } = globalThis.crypto;
+var b64ToBytes = (b64) => {
+  const bin = atob(b64);
+  const out = new Uint8Array(bin.length);
+  for (let i = 0; i < bin.length; i++) {
+    out[i] = bin.charCodeAt(i);
+  }
+  return out;
+};
+var AIP_COVERED_COMPONENTS = ["@method", "@authority", "@path", "agent-identity"];
+var AIP_SIGNATURE_TAG = "agent-identity";
+var DEFAULT_MAX_SKEW_SECONDS = 60;
+var MAX_POP_WINDOW_SECONDS = 120;
+var normalizeAuthority = (authority) => {
+  const lower = authority.trim().toLowerCase();
+  const colon = lower.lastIndexOf(":");
+  if (colon === -1) {
+    return lower;
+  }
+  if (lower.includes("]") && colon < lower.indexOf("]")) {
+    return lower;
+  }
+  const host = lower.slice(0, colon);
+  const port = lower.slice(colon + 1);
+  if (port === "80" || port === "443") {
+    return host;
+  }
+  return lower;
+};
+var componentValue = (name, input) => {
+  switch (name) {
+    case "@method":
+      return input.method.toUpperCase();
+    case "@authority":
+      return normalizeAuthority(input.authority);
+    case "@path":
+      return input.path;
+    case "agent-identity":
+      return input.agentIdentity.trim();
+    default:
+      return input.extra?.[name] ?? null;
+  }
+};
+var serializeComponentList = (components) => `(${components.map((c) => `"${c}"`).join(" ")})`;
+var serializeParams = (p) => {
+  const parts = [];
+  if (p.created !== void 0) {
+    parts.push(`created=${p.created}`);
+  }
+  if (p.expires !== void 0) {
+    parts.push(`expires=${p.expires}`);
+  }
+  if (p.keyid !== void 0) {
+    parts.push(`keyid="${p.keyid}"`);
+  }
+  if (p.alg !== void 0) {
+    parts.push(`alg="${p.alg}"`);
+  }
+  if (p.tag !== void 0) {
+    parts.push(`tag="${p.tag}"`);
+  }
+  return parts.map((s) => `;${s}`).join("");
+};
+var buildSignatureBase = (params, input, rawSignatureParams) => {
+  const lines = [];
+  for (const name of params.components) {
+    const value = componentValue(name, input);
+    if (value === null) {
+      throw new MissingComponentError(name);
+    }
+    lines.push(`"${name}": ${value}`);
+  }
+  const paramsValue = rawSignatureParams ?? serializeComponentList(params.components) + serializeParams(params);
+  lines.push(`"@signature-params": ${paramsValue}`);
+  return lines.join("\n");
+};
+var MissingComponentError = class extends Error {
+  constructor(component) {
+    super(`signature base missing covered component: ${component}`);
+    this.component = component;
+    this.name = "MissingComponentError";
+  }
+  component;
+};
+var parseSignatureInput = (header, tag = AIP_SIGNATURE_TAG) => {
+  const members = splitDictionary(header);
+  if (members.length === 0) {
+    return null;
+  }
+  const parsed = members.map((m) => {
+    const params = parseInnerListMember(m.value);
+    return params ? { label: m.label, params, rawParams: m.value } : null;
+  }).filter((x) => x !== null);
+  if (parsed.length === 0) {
+    return null;
+  }
+  return parsed.find((p) => p.params.tag === tag) ?? null;
+};
+var parseSignatureValue = (header, label) => {
+  const members = splitDictionary(header);
+  const member = members.find((m) => m.label === label);
+  if (!member) {
+    return null;
+  }
+  const v = member.value.trim();
+  if (!v.startsWith(":") || !v.endsWith(":") || v.length < 2) {
+    return null;
+  }
+  const b64 = v.slice(1, -1);
+  try {
+    return b64ToBytes(b64);
+  } catch {
+    return null;
+  }
+};
+var splitDictionary = (header) => {
+  const out = [];
+  let depth = 0;
+  let inBytes = false;
+  let inString = false;
+  let current = "";
+  for (let i = 0; i < header.length; i++) {
+    const ch = header[i];
+    if (inString) {
+      current += ch;
+      if (ch === '"' && header[i - 1] !== "\\") {
+        inString = false;
+      }
+      continue;
+    }
+    if (ch === '"') {
+      inString = true;
+      current += ch;
+      continue;
+    }
+    if (ch === ":") {
+      inBytes = !inBytes;
+      current += ch;
+      continue;
+    }
+    if (!inBytes && ch === "(") {
+      depth++;
+      current += ch;
+      continue;
+    }
+    if (!inBytes && ch === ")") {
+      depth = Math.max(0, depth - 1);
+      current += ch;
+      continue;
+    }
+    if (!inBytes && depth === 0 && ch === ",") {
+      pushMember(out, current);
+      current = "";
+      continue;
+    }
+    current += ch;
+  }
+  pushMember(out, current);
+  return out;
+};
+var pushMember = (out, raw) => {
+  const trimmed = raw.trim();
+  if (!trimmed) {
+    return;
+  }
+  const eq = trimmed.indexOf("=");
+  if (eq === -1) {
+    return;
+  }
+  const label = trimmed.slice(0, eq).trim();
+  const value = trimmed.slice(eq + 1).trim();
+  if (label) {
+    out.push({ label, value });
+  }
+};
+var parseInnerListMember = (value) => {
+  const open = value.indexOf("(");
+  const close = value.indexOf(")", open + 1);
+  if (open === -1 || close === -1) {
+    return null;
+  }
+  const listBody = value.slice(open + 1, close).trim();
+  const components = listBody.length === 0 ? [] : (listBody.match(/"[^"]*"/g) ?? []).map((s) => s.slice(1, -1));
+  const params = { components };
+  const paramStr = value.slice(close + 1);
+  const re = /;\s*([a-zA-Z][a-zA-Z0-9_-]*)\s*=\s*("(?:[^"\\]|\\.)*"|-?\d+)/g;
+  let match;
+  while ((match = re.exec(paramStr)) !== null) {
+    const key = match[1];
+    const raw = match[2];
+    const val = raw.startsWith('"') ? raw.slice(1, -1) : Number(raw);
+    if (key === "created") {
+      params.created = val;
+    } else if (key === "expires") {
+      params.expires = val;
+    } else if (key === "keyid") {
+      params.keyid = val;
+    } else if (key === "tag") {
+      params.tag = val;
+    } else if (key === "alg") {
+      params.alg = val;
+    }
+  }
+  return params;
+};
+var verifyMessageSignature = async (input) => {
+  const selected = parseSignatureInput(input.signatureInput);
+  if (!selected) {
+    return { ok: false, reason: "no_aip_signature" };
+  }
+  const { label, params, rawParams } = selected;
+  if (params.alg !== void 0 && !["ed25519", "eddsa"].includes(params.alg.toLowerCase())) {
+    return { ok: false, reason: "unsupported_alg" };
+  }
+  for (const required of AIP_COVERED_COMPONENTS) {
+    if (!params.components.includes(required)) {
+      return { ok: false, reason: "missing_covered_component" };
+    }
+  }
+  if (params.created === void 0) {
+    return { ok: false, reason: "created_missing" };
+  }
+  if (params.expires === void 0) {
+    return { ok: false, reason: "expires_missing" };
+  }
+  if (params.expires < params.created || params.expires - params.created > MAX_POP_WINDOW_SECONDS) {
+    return { ok: false, reason: "pop_window_too_long" };
+  }
+  const now = input.now ?? Math.floor(Date.now() / 1e3);
+  const skew = input.maxSkewSeconds ?? DEFAULT_MAX_SKEW_SECONDS;
+  if (params.created > now + skew) {
+    return { ok: false, reason: "created_in_future" };
+  }
+  if (params.expires < now - skew) {
+    return { ok: false, reason: "expired" };
+  }
+  if (!params.keyid) {
+    return { ok: false, reason: "missing_keyid" };
+  }
+  const cnf = input.cnfJwk;
+  if (cnf.kty !== "OKP" || cnf.crv !== "Ed25519" || typeof cnf.x !== "string" || cnf.x.length === 0) {
+    return { ok: false, reason: "unsupported_cnf_key" };
+  }
+  let thumbprint;
+  try {
+    thumbprint = await calculateJwkThumbprint(input.cnfJwk, "sha256");
+  } catch {
+    return { ok: false, reason: "unsupported_cnf_key" };
+  }
+  if (params.keyid !== thumbprint) {
+    return { ok: false, reason: "keyid_mismatch" };
+  }
+  const sig = parseSignatureValue(input.signature, label);
+  if (!sig) {
+    return { ok: false, reason: "malformed_signature" };
+  }
+  let base;
+  try {
+    base = buildSignatureBase(params, {
+      method: input.method,
+      authority: input.authority,
+      path: input.path,
+      agentIdentity: input.agentIdentity,
+      extra: input.extraComponents
+    }, rawParams);
+  } catch (err) {
+    if (err instanceof MissingComponentError) {
+      return { ok: false, reason: "missing_covered_component" };
+    }
+    throw err;
+  }
+  let valid;
+  try {
+    const key = await importJWK(input.cnfJwk, "EdDSA");
+    if (!(key instanceof CryptoKey)) {
+      return { ok: false, reason: "signature_invalid" };
+    }
+    valid = await subtle.verify(
+      { name: "Ed25519" },
+      key,
+      sig,
+      new TextEncoder().encode(base)
+    );
+  } catch {
+    return { ok: false, reason: "signature_invalid" };
+  }
+  return valid ? { ok: true, params } : { ok: false, reason: "signature_invalid" };
+};
+
+// src/aip/types.ts
+var isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isNonEmptyString = (v) => typeof v === "string" && v.length > 0;
+var isAitShape = (payload) => isObject(payload) && isObject(payload.cnf) && isObject(payload.agent);
+var validateAitPayload = (payload) => {
+  if (!isObject(payload)) {
+    return { ok: false, reason: "not_an_object" };
+  }
+  if (!isNonEmptyString(payload.aip_version)) {
+    return { ok: false, reason: "missing_aip_version" };
+  }
+  if (!isNonEmptyString(payload.iss)) {
+    return { ok: false, reason: "missing_iss" };
+  }
+  if (!isNonEmptyString(payload.sub)) {
+    return { ok: false, reason: "missing_sub" };
+  }
+  if (typeof payload.iat !== "number") {
+    return { ok: false, reason: "missing_iat" };
+  }
+  if (typeof payload.exp !== "number") {
+    return { ok: false, reason: "missing_exp" };
+  }
+  if (!isObject(payload.cnf) || !isObject(payload.cnf.jwk)) {
+    return { ok: false, reason: "missing_cnf" };
+  }
+  if (!isObject(payload.agent) || !isNonEmptyString(payload.agent.provider)) {
+    return { ok: false, reason: "missing_agent_provider" };
+  }
+  if (payload.trust_level === "human_confirmed") {
+    const auth = payload.auth;
+    const amr = isObject(auth) ? auth.amr : void 0;
+    if (!Array.isArray(amr) || amr.length === 0) {
+      return { ok: false, reason: "human_confirmed_without_amr" };
+    }
+  }
+  return { ok: true, payload };
+};
+
+// src/aip/verify.ts
+var AGENT_IDENTITY_HEADER = "agent-identity";
+var verifyAit = async (ctx, opts) => {
+  if (ctx.agentIdentityHeaders.length === 0) {
+    return { ok: false, reason: "no_token" };
+  }
+  if (!ctx.signatureInput || !ctx.signature) {
+    return { ok: false, reason: "pop_signature_missing" };
+  }
+  const signatureInput = ctx.signatureInput;
+  const signature = ctx.signature;
+  let lastFailure = "malformed_token";
+  for (const raw of ctx.agentIdentityHeaders) {
+    const token = stripBearer(raw);
+    let header;
+    let payload;
+    try {
+      header = decodeProtectedHeader(token);
+      payload = decodeJwt(token);
+    } catch {
+      lastFailure = "malformed_token";
+      continue;
+    }
+    if (header.alg === void 0 || header.alg.toLowerCase() === "none") {
+      lastFailure = "malformed_token";
+      continue;
+    }
+    if (!isAitShape(payload)) {
+      lastFailure = "malformed_token";
+      continue;
+    }
+    const validated = validateAitPayload(payload);
+    if (!validated.ok) {
+      lastFailure = "invalid_claims";
+      continue;
+    }
+    const claims = validated.payload;
+    const keyLookup = await opts.jwks.getKey(claims.iss, header.kid);
+    if (!keyLookup.ok) {
+      lastFailure = keyLookup.reason === "untrusted_issuer" || keyLookup.reason === "insecure_issuer" ? "untrusted_issuer" : "key_unavailable";
+      continue;
+    }
+    const jwtClockTolerance = opts.maxSkewSeconds ?? 60;
+    try {
+      const idpKey = await importJWK2(keyLookup.key, normalizeAlg(header.alg));
+      await jwtVerify(token, idpKey, {
+        // Pin the signature algorithm allowlist (RFC 8725 §3.1) — also rejects `alg:none`. Without
+        // this, jose accepts whatever alg the resolved JWK supports, so a trusted IdP publishing a
+        // non-Ed25519 (e.g. RSA/EC) `use:sig` key would let an attacker present an RS256/ES256
+        // token that verifies. Matches the server-side allowlist in the AgentScore API verifier.
+        algorithms: AIT_SIGNING_ALGS,
+        clockTolerance: jwtClockTolerance,
+        currentDate: opts.now !== void 0 ? new Date(opts.now * 1e3) : void 0
+      });
+    } catch (err) {
+      lastFailure = isExpiry(err) ? "expired_token" : "idp_signature_invalid";
+      continue;
+    }
+    const nowSec = opts.now ?? Math.floor(Date.now() / 1e3);
+    if (claims.iat > nowSec + jwtClockTolerance) {
+      lastFailure = "expired_token";
+      continue;
+    }
+    if (claims.exp - claims.iat > (opts.maxLifetimeSeconds ?? 300)) {
+      lastFailure = "expired_token";
+      continue;
+    }
+    const popResult = await verifyMessageSignature({
+      method: ctx.method,
+      authority: ctx.authority,
+      path: ctx.path,
+      // The agent-identity covered component is the BARE AIT (a Bearer prefix, if present, is
+      // transport that `stripBearer` removed above). Verify over `token`, not `raw`, so the edge and
+      // the API — which verifies over the forwarded bare aip_token — reconstruct the identical base.
+      agentIdentity: token,
+      signatureInput,
+      signature,
+      cnfJwk: claims.cnf.jwk,
+      now: opts.now,
+      maxSkewSeconds: opts.maxSkewSeconds
+    });
+    if (!popResult.ok) {
+      lastFailure = "pop_signature_invalid";
+      continue;
+    }
+    return {
+      ok: true,
+      ait: {
+        payload: claims,
+        iss: claims.iss,
+        cnfJwk: claims.cnf.jwk,
+        token,
+        signatureMaterial: {
+          method: ctx.method,
+          authority: ctx.authority,
+          path: ctx.path,
+          signature_input: signatureInput,
+          signature
+        }
+      }
+    };
+  }
+  return { ok: false, reason: lastFailure };
+};
+var stripBearer = (value) => {
+  const trimmed = value.trim();
+  return /^bearer\s+/i.test(trimmed) ? trimmed.replace(/^bearer\s+/i, "") : trimmed;
+};
+var AIT_SIGNING_ALGS = ["EdDSA", "ES256"];
+var normalizeAlg = (alg) => alg.toLowerCase() === "eddsa" ? "EdDSA" : alg;
+var isExpiry = (err) => typeof err === "object" && err !== null && err.code === "ERR_JWT_EXPIRED";
+
+// src/aip/request.ts
+var readAgentIdentityHeaders = (headers) => {
+  const raw = headers.get(AGENT_IDENTITY_HEADER);
+  if (!raw) {
+    return [];
+  }
+  return raw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+};
+var deriveAuthority = (req, url) => req.headers.get("host") ?? url.host;
+var buildVerifyContextFromRequest = (req, authority) => {
+  const url = new URL(req.url);
+  return {
+    method: req.method,
+    authority: authority ?? deriveAuthority(req, url),
+    path: url.pathname,
+    agentIdentityHeaders: readAgentIdentityHeaders(req.headers),
+    signatureInput: req.headers.get("signature-input"),
+    signature: req.headers.get("signature")
+  };
+};
+var hasAgentIdentityHeader = (req) => readAgentIdentityHeaders(req.headers).length > 0;
+
+// src/aip/gate.ts
+var aipErrorCode = (failure) => {
+  switch (failure) {
+    case "no_token":
+    case "pop_signature_missing":
+      return "agent_identity_required";
+    case "untrusted_issuer":
+      return "untrusted_issuer";
+    case "expired_token":
+      return "expired_token";
+    case "invalid_claims":
+      return "insufficient_claims";
+    case "key_unavailable":
+      return "idp_unavailable";
+    case "malformed_token":
+    case "idp_signature_invalid":
+    case "pop_signature_invalid":
+      return "invalid_signature";
+    default:
+      return "invalid_signature";
+  }
+};
+var aipErrorStatus = (failure) => {
+  switch (failure) {
+    case "key_unavailable":
+      return 503;
+    case "untrusted_issuer":
+    case "invalid_claims":
+      return 403;
+    default:
+      return 401;
+  }
+};
+var aipErrorDetail = (failure) => {
+  switch (failure) {
+    case "no_token":
+      return "No Agent-Identity token was presented.";
+    case "pop_signature_missing":
+      return "The request is missing the RFC 9421 HTTP Message Signature that proves possession of the token-bound key.";
+    case "untrusted_issuer":
+      return "The token's issuer is not in this service's trusted-issuer list.";
+    case "expired_token":
+      return "The Agent Identity Token has expired.";
+    case "invalid_claims":
+      return "The token is missing required claims for this endpoint.";
+    case "malformed_token":
+      return "The Agent-Identity header could not be parsed as an Agent Identity Token.";
+    case "idp_signature_invalid":
+      return "The identity provider's signature on the token failed verification.";
+    case "pop_signature_invalid":
+      return "The request signature did not match the key bound to the token.";
+    case "key_unavailable":
+      return "The identity provider's signing key could not be resolved.";
+    default:
+      return "Token verification failed.";
+  }
+};
+var buildAipErrorBody = (failure, requirements) => {
+  const code = aipErrorCode(failure);
+  const body = {
+    type: `urn:aip:error:${code}`,
+    title: code.replace(/_/g, " "),
+    status: aipErrorStatus(failure),
+    detail: aipErrorDetail(failure)
+  };
+  if (requirements) {
+    if (code === "untrusted_issuer" && requirements.trustedIssuers?.length) {
+      body.trusted_issuers = requirements.trustedIssuers;
+    }
+    if (code === "insufficient_claims") {
+      if (requirements.requiredClaims?.length) body.required_claims = requirements.requiredClaims;
+      if (requirements.requiredTrustLevel !== void 0) body.required_trust_level = requirements.requiredTrustLevel;
+      if (requirements.requiredAmr?.length) body.required_amr = requirements.requiredAmr;
+    }
+  }
+  return body;
+};
+var TRUST_RANK = { autonomous: 0, human_present: 1, human_confirmed: 2 };
+var checkTrustRequirements = (payload, requiredTrustLevel, requiredAmr) => {
+  if (requiredTrustLevel !== void 0) {
+    const have = TRUST_RANK[payload.trust_level ?? "autonomous"] ?? 0;
+    const need = TRUST_RANK[requiredTrustLevel] ?? 0;
+    if (have < need) {
+      return `This endpoint requires trust_level '${requiredTrustLevel}'; the token asserts '${payload.trust_level ?? "autonomous"}'. Re-mint an AIT at the required trust level (human confirmation).`;
+    }
+  }
+  if (requiredAmr !== void 0 && requiredAmr.length > 0) {
+    const amr = Array.isArray(payload.auth?.amr) ? payload.auth.amr : [];
+    if (!amr.some((m) => requiredAmr.includes(m))) {
+      return `This endpoint requires an authentication method in [${requiredAmr.join(", ")}]; the token carries [${amr.join(", ") || "none"}].`;
+    }
+  }
+  return null;
+};
+var buildAipWeakAuthBody = (opts) => ({
+  type: "urn:aip:error:weak_auth",
+  title: "weak auth",
+  status: 403,
+  detail: opts.detail,
+  ...opts.requiredTrustLevel !== void 0 && { required_trust_level: opts.requiredTrustLevel },
+  ...opts.requiredAmr !== void 0 && opts.requiredAmr.length > 0 && { required_amr: opts.requiredAmr },
+  ...opts.trustedIssuers !== void 0 && opts.trustedIssuers.length > 0 && { trusted_issuers: opts.trustedIssuers }
+});
+var requirementsFromOptions = (opts) => ({
+  ...opts.trustedIssuers !== void 0 && { trustedIssuers: opts.trustedIssuers },
+  ...opts.requiredClaims !== void 0 && { requiredClaims: opts.requiredClaims },
+  ...opts.requireTrustLevel !== void 0 && { requiredTrustLevel: opts.requireTrustLevel },
+  ...opts.requireAmr !== void 0 && { requiredAmr: opts.requireAmr }
+});
+var evaluateFromContext = async (ctx, opts) => {
+  const result = await verifyAit(ctx, { jwks: opts.jwks, now: opts.now, maxSkewSeconds: opts.maxSkewSeconds });
+  if (!result.ok) {
+    return { ok: false, body: buildAipErrorBody(result.reason, requirementsFromOptions(opts)) };
+  }
+  const weak = checkTrustRequirements(result.ait.payload, opts.requireTrustLevel, opts.requireAmr);
+  if (weak !== null) {
+    return {
+      ok: false,
+      body: buildAipWeakAuthBody({
+        detail: weak,
+        ...opts.requireTrustLevel !== void 0 && { requiredTrustLevel: opts.requireTrustLevel },
+        ...opts.requireAmr !== void 0 && { requiredAmr: opts.requireAmr },
+        ...opts.trustedIssuers !== void 0 && { trustedIssuers: opts.trustedIssuers }
+      })
+    };
+  }
+  return { ok: true, ait: result.ait };
+};
+var evaluateAipRequest = (req, opts) => evaluateFromContext(buildVerifyContextFromRequest(req, opts.authority), opts);
+
 // src/core.ts
+import { createHash } from "crypto";
 import {
   AgentScore,
   InvalidCredentialError,
@@ -207,7 +805,7 @@ function stripTrailingSlashes(s) {
   while (end > 0 && s.charCodeAt(end - 1) === 47) end--;
   return end === s.length ? s : s.slice(0, end);
 }
-var CANONICAL_AGENTSCORE_API = "https://api.agentscore.sh";
+var CANONICAL_AGENTSCORE_API = "https://api.agentscore.com";
 var WALLET_SIGNER_MISMATCH_INSTRUCTIONS = JSON.stringify({
   action: "resign_or_switch_to_operator_token",
   steps: [
@@ -233,17 +831,22 @@ var INVALID_CREDENTIAL_INSTRUCTIONS = JSON.stringify({
   ],
   user_message: "The operator_token is not recognized. Use a different stored token, or restart the verification session flow to mint a new one."
 });
-function buildAgentMemoryHint() {
+function buildAgentMemoryHint(aipTrustedIssuers) {
   const api = CANONICAL_AGENTSCORE_API;
+  const acceptsAip = aipTrustedIssuers !== void 0 && aipTrustedIssuers.length > 0;
   return {
     save_for_future_agentscore_gates: true,
     pattern_summary: "AgentScore is a cross-merchant identity substrate for agent commerce. Any endpoint that returns 403 missing_identity / identity_verification_required or 402 challenges referencing AgentScore uses the same identity system. One KYC works across all AgentScore merchants \u2014 no re-verification per site. Save this pattern (and the endpoints below) to persistent memory so future AgentScore encounters skip the cold-start session flow.",
-    quickstart: "https://docs.agentscore.sh/guides/agent-identity",
+    quickstart: "https://docs.agentscore.com/guides/agent-identity",
     identity_check_endpoint: `${api}/v1/credentials`,
     identity_paths: {
       wallet: "If paying from a crypto wallet you have used before on any AgentScore merchant, send `X-Wallet-Address: 0x...`. Shortest path; no token lifecycle to manage.",
-      operator_token: "For any rail (Stripe SPT, card, or a wallet you have not linked yet), send `X-Operator-Token: opc_...`. Reusable across merchants until the token expires."
+      operator_token: "For any rail (Stripe SPT, card, or a wallet you have not linked yet), send `X-Operator-Token: opc_...`. Reusable across merchants until the token expires.",
+      ...acceptsAip && {
+        agent_identity: 'If you hold an AIP Agent Identity Token from a trusted issuer (see aip_trusted_issuers), present it: send the JWT in an `Agent-Identity` header plus an RFC 9421 HTTP Message Signature (Signature-Input + Signature over @method @authority @path agent-identity, tag="agent-identity") signed with the token-bound cnf key. The merchant verifies it and applies its policy \u2014 no separate AgentScore credential needed.'
+      }
     },
+    ...acceptsAip && { aip_trusted_issuers: aipTrustedIssuers },
     bootstrap: "If you have neither a linked wallet nor a valid operator_token, follow the session/verify flow in the per-request `agent_instructions` block. This happens at most once per agent identity \u2014 after first verification, the operator_token and any subsequently used wallet are reusable everywhere.",
     do_not_persist_in_memory: ["operator_token", "poll_secret"],
     persist_in_credential_store: ["operator_token"]
@@ -251,7 +854,7 @@ function buildAgentMemoryHint() {
 }
 function createAgentScoreCore(options) {
   if (!options.apiKey) {
-    throw new Error("AgentScore API key is required. Get one at https://agentscore.sh/sign-up");
+    throw new Error("AgentScore API key is required. Get one at https://www.agentscore.com/sign-up");
   }
   const {
     apiKey,
@@ -262,14 +865,15 @@ function createAgentScoreCore(options) {
     allowedJurisdictions,
     failOpen = false,
     cacheSeconds = 300,
-    baseUrl: rawBaseUrl = "https://api.agentscore.sh",
+    baseUrl: rawBaseUrl = "https://api.agentscore.com",
     chain: gateChain,
     userAgent,
-    createSessionOnMissing
+    createSessionOnMissing,
+    aipTrustedIssuers
   } = options;
   const baseUrl = stripTrailingSlashes(rawBaseUrl);
-  const agentMemoryHint = buildAgentMemoryHint();
-  const defaultUa = `@agent-score/commerce@${"2.4.0"}`;
+  const agentMemoryHint = buildAgentMemoryHint(aipTrustedIssuers);
+  const defaultUa = `@agent-score/commerce@${"2.6.0"}`;
   const userAgentHeader = userAgent ? `${userAgent} (${defaultUa})` : defaultUa;
   const sdk = new AgentScore({ apiKey, baseUrl, userAgent: userAgentHeader });
   const sessionSdkCache = /* @__PURE__ */ new Map();
@@ -344,16 +948,21 @@ function createAgentScoreCore(options) {
     }
   }
   async function evaluate(identity, ctx, signer) {
-    if (!identity || !identity.address && !identity.operatorToken) {
+    if (!identity || !identity.address?.trim() && !identity.operatorToken?.trim() && !identity.aipToken?.trim()) {
       if (failOpen) return { kind: "allow" };
       const sessionReason = await tryMintSessionDenial(ctx);
       if (sessionReason) return { kind: "deny", reason: sessionReason };
+      const acceptsAip = aipTrustedIssuers !== void 0 && aipTrustedIssuers.length > 0;
+      const aipStep = acceptsAip ? [
+        `If you hold an AIP Agent Identity Token from a trusted issuer (${aipTrustedIssuers.join(", ")}): present it \u2014 send the JWT in an Agent-Identity header plus an RFC 9421 HTTP Message Signature (Signature-Input + Signature over @method @authority @path agent-identity, tag="agent-identity") signed with the token-bound cnf key. This satisfies identity in one round trip without an AgentScore credential.`
+      ] : [];
       const missingIdentityInstructions = JSON.stringify({
         action: "probe_identity_then_session",
         steps: [
+          ...aipStep,
           "If you have a wallet AND this merchant accepts a wallet-signing rail (Tempo MPP or x402 \u2014 see openapi.json x-payment-info): send X-Wallet-Address and retry. If the wallet is already linked to an AgentScore operator (via prior SIWE claim or prior captureWallet), this passes in one round trip. If the wallet is unlinked or the account has no KYC, the 403 will include a verify_url \u2014 share it with the user to claim the wallet + complete KYC, then retry.",
           "If step 1 is denied or you already have a stored operator_token (valid + not expired): send X-Operator-Token: opc_... and retry.",
-          "If neither applies: retry with NO identity header. Merchants that auto-create verification sessions (most AgentScore merchants do) return verify_url + session_id + poll_secret in the 403 body \u2014 share verify_url with the user, then poll poll_url every 5s with the X-Poll-Secret header until status=verified (the poll returns a one-time operator_token). If the retry returns the same bare 403, this merchant does not support self-service session bootstrapping \u2014 direct the user to https://agentscore.sh/sign-up to create an AgentScore identity and mint an operator_token from their dashboard (https://agentscore.sh/dashboard/verify). The user hands the opc_... to you, and you retry with X-Operator-Token."
+          "If neither applies: retry with NO identity header. Merchants that auto-create verification sessions (most AgentScore merchants do) return verify_url + session_id + poll_secret in the 403 body \u2014 share verify_url with the user, then poll poll_url every 5s with the X-Poll-Secret header until status=verified (the poll returns a one-time operator_token). If the retry returns the same bare 403, this merchant does not support self-service session bootstrapping \u2014 direct the user to https://www.agentscore.com/sign-up to create an AgentScore identity and mint an operator_token from their dashboard (https://www.agentscore.com/dashboard/verify). The user hands the opc_... to you, and you retry with X-Operator-Token."
         ],
         user_message: "Try X-Wallet-Address first if you have a wallet and the merchant accepts Tempo/x402; fall back to a stored X-Operator-Token, then to the session/verify flow described in agent_memory.bootstrap."
       });
@@ -366,21 +975,26 @@ function createAgentScoreCore(options) {
         }
       };
     }
-    const cacheKey = identity.operatorToken?.toLowerCase() ?? (identity.address ? normalizeAddress(identity.address) : "");
+    const identityKey = identity.aipToken ? `aip:${createHash("sha256").update(identity.aipToken).digest("hex")}` : identity.operatorToken?.toLowerCase() ?? (identity.address ? normalizeAddress(identity.address) : "");
+    const cacheKey = signer ? JSON.stringify([identityKey, signer.network, normalizeAddress(signer.address)]) : JSON.stringify([identityKey]);
     const cached = cache.get(cacheKey);
     if (cached) {
+      const cachedVerdict = cached.raw ? buildSignerVerdict(identity, cached.raw) : void 0;
       if (cached.allow) {
         const cachedRaw = cached.raw;
         const cachedQuota = cachedRaw?.quota;
         return {
           kind: "allow",
           data: cachedRaw,
-          ...cachedQuota !== void 0 && { quota: cachedQuota }
+          ...cachedQuota !== void 0 && { quota: cachedQuota },
+          ...cachedVerdict !== void 0 && { signerVerdict: cachedVerdict }
         };
       }
       if (isFixableDenial(cached.reasons)) {
         const sessionReason = await tryMintSessionDenial(ctx);
-        if (sessionReason) return { kind: "deny", reason: sessionReason };
+        if (sessionReason) {
+          return { kind: "deny", reason: sessionReason, ...cachedVerdict !== void 0 && { signerVerdict: cachedVerdict } };
+        }
       }
       return {
         kind: "deny",
@@ -390,7 +1004,8 @@ function createAgentScoreCore(options) {
           reasons: cached.reasons,
           verify_url: cached.raw?.verify_url,
           data: cached.raw
-        }
+        },
+        ...cachedVerdict !== void 0 && { signerVerdict: cachedVerdict }
       };
     }
     const policy = {};
@@ -411,7 +1026,10 @@ function createAgentScoreCore(options) {
         // regardless of policy.require_sanctions_clear (which gates the separate NAME screen).
         ...signer && { signer: { address: signer.address, network: signer.network } }
       };
-      const result = identity.address ? await sdk.assess(identity.address, { ...opts, operatorToken: identity.operatorToken }) : await sdk.assess(null, { ...opts, operatorToken: identity.operatorToken });
+      if (identity.aipToken !== void 0 && identity.aipSignature === void 0) {
+        throw new Error("AgentScoreCore.evaluate: aipToken requires aipSignature (RFC 9421 proof-of-possession material).");
+      }
+      const result = identity.aipToken !== void 0 && identity.aipSignature !== void 0 ? await sdk.assess(null, { ...opts, aipToken: identity.aipToken, aipSignature: identity.aipSignature }) : identity.address ? await sdk.assess(identity.address, { ...opts, operatorToken: identity.operatorToken }) : await sdk.assess(null, { ...opts, operatorToken: identity.operatorToken });
       data = result;
     } catch (err) {
       if (err instanceof PaymentRequiredError) {
@@ -482,17 +1100,21 @@ function createAgentScoreCore(options) {
     const decisionReasons = data.decision_reasons ?? [];
     const allow = decision === "allow" || decision == null;
     cache.set(cacheKey, { allow, decision: decision ?? void 0, reasons: decisionReasons, raw: data });
+    const signerVerdict = buildSignerVerdict(identity, data);
     if (allow) {
       const quota = data.quota;
       return {
         kind: "allow",
         data,
-        ...quota !== void 0 && { quota }
+        ...quota !== void 0 && { quota },
+        ...signerVerdict !== void 0 && { signerVerdict }
       };
     }
     if (isFixableDenial(decisionReasons)) {
       const sessionReason = await tryMintSessionDenial(ctx);
-      if (sessionReason) return { kind: "deny", reason: sessionReason };
+      if (sessionReason) {
+        return { kind: "deny", reason: sessionReason, ...signerVerdict !== void 0 && { signerVerdict } };
+      }
     }
     return {
       kind: "deny",
@@ -502,7 +1124,8 @@ function createAgentScoreCore(options) {
         reasons: decisionReasons,
         verify_url: data.verify_url,
         data
-      }
+      },
+      ...signerVerdict !== void 0 && { signerVerdict }
     };
   }
   async function captureWallet2(options2) {
@@ -544,22 +1167,21 @@ function createAgentScoreCore(options) {
       agentInstructions: sm.agent_instructions ?? WALLET_SIGNER_MISMATCH_INSTRUCTIONS
     };
   }
-  function getSignerVerdict2(claimedAddress) {
-    const claimedNorm = normalizeAddress(claimedAddress);
-    const cached = cache.get(claimedNorm);
-    if (!cached) return void 0;
-    const raw = cached.raw;
-    if (!raw) return void 0;
+  function buildSignerVerdict(identity, raw) {
+    if (identity.address === void 0 || identity.operatorToken !== void 0 || identity.aipToken !== void 0) {
+      return void 0;
+    }
     const rawMatch = raw.signer_match;
     const rawSanctions = raw.signer_sanctions;
     if (!rawMatch && !rawSanctions) return void 0;
+    const claimedNorm = normalizeAddress(identity.address);
     const signerNorm = rawMatch?.actual_signer ?? claimedNorm;
     return {
       signer_match: rawMatch ? projectSignerMatch(rawMatch, claimedNorm, signerNorm) : null,
       signer_sanctions: rawSanctions ?? null
     };
   }
-  return { evaluate, captureWallet: captureWallet2, getSignerVerdict: getSignerVerdict2 };
+  return { evaluate, captureWallet: captureWallet2 };
 }
 
 // src/payment/payment_header.ts
@@ -691,18 +1313,23 @@ function agentscoreGate(options) {
     const signer = await extractPaymentSigner(c.req.raw, readX402PaymentHeader(c.req.raw));
     const outcome = await core.evaluate(identity, c, signer);
     if (outcome.kind === "allow") {
-      if (outcome.degraded || outcome.quota) {
+      if (outcome.degraded || outcome.quota || outcome.signerVerdict) {
         const prev = c.get(GATE_STATE_KEY);
         c.set(GATE_STATE_KEY, {
           ...prev,
           ...outcome.degraded && { degraded: true, infraReason: outcome.infraReason },
-          ...outcome.quota && { quota: outcome.quota }
+          ...outcome.quota && { quota: outcome.quota },
+          ...outcome.signerVerdict && { signerVerdict: outcome.signerVerdict }
         });
       }
       if (outcome.data) c.set(CONTEXT_KEY, outcome.data);
       await next();
       return;
     }
+    if (outcome.signerVerdict) {
+      const prev = c.get(GATE_STATE_KEY);
+      c.set(GATE_STATE_KEY, { ...prev, signerVerdict: outcome.signerVerdict });
+    }
     return onDenied(c, outcome.reason);
   };
 }
@@ -729,8 +1356,7 @@ async function captureWallet(c, options) {
 }
 function getSignerVerdict(c) {
   const state = c.get(GATE_STATE_KEY);
-  if (!state?.walletAddress) return void 0;
-  return state.core.getSignerVerdict(state.walletAddress);
+  return state?.signerVerdict;
 }
 function conditionalAgentscoreGate(options) {
   const gate = agentscoreGate(options);
@@ -742,13 +1368,47 @@ function conditionalAgentscoreGate(options) {
     return gate(c, next);
   };
 }
+var AIT_CONTEXT_KEY = "__agentscoreAit";
+function defaultAipOnDenied(_c, body) {
+  return new Response(JSON.stringify(body), {
+    status: body.status,
+    headers: { "content-type": "application/problem+json" }
+  });
+}
+function aipGate(options) {
+  const { onDenied = defaultAipOnDenied, ...gateOpts } = options;
+  return async (c, next) => {
+    const result = await evaluateAipRequest(c.req.raw, gateOpts);
+    if (!result.ok) {
+      return onDenied(c, result.body);
+    }
+    c.set(AIT_CONTEXT_KEY, result.ait);
+    await next();
+  };
+}
+function conditionalAipGate(options) {
+  const gate = aipGate(options);
+  return async (c, next) => {
+    if (!hasAgentIdentityHeader(c.req.raw)) {
+      await next();
+      return;
+    }
+    return gate(c, next);
+  };
+}
+function getVerifiedAit(c) {
+  return c.get(AIT_CONTEXT_KEY);
+}
 export {
   agentscoreGate,
+  aipGate,
   captureWallet,
   conditionalAgentscoreGate,
+  conditionalAipGate,
   getAgentScoreData,
   getGateDegradedState,
   getGateQuotaInfo,
-  getSignerVerdict
+  getSignerVerdict,
+  getVerifiedAit
 };
 //# sourceMappingURL=hono.mjs.map