@adcp/sdk 17.0.0-beta.7 → 17.0.0-beta.9

package/dist/lib/schemas-data/3.1/sponsored-intelligence/si-get-offering-response.json

@@ -1,15 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/sponsored-intelligence/si-get-offering-response.json",
+  "$id": "/schemas/3.1.31/sponsored-intelligence/si-get-offering-response.json",
   "title": "SI Get Offering Response",
   "description": "Offering details, availability status, and optionally matching products. Use the offering_token in si_initiate_session for correlation.",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.29/core/version-envelope.json"
+      "$ref": "/schemas/3.1.31/core/version-envelope.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/protocol-envelope.json"
+      "$ref": "/schemas/3.1.31/core/protocol-envelope.json"
     }
   ],
   "x-status": "experimental",
@@ -59,7 +59,7 @@
           "description": "When this offering expires"
         },
         "availability_status": {
-          "$ref": "/schemas/3.1.29/enums/offering-availability-status.json",
+          "$ref": "/schemas/3.1.31/enums/offering-availability-status.json",
           "description": "Machine-readable availability state for the offering. Optional; when omitted, derive availability from the top-level 'available' boolean and 'unavailable_reason'."
         },
         "price_hint": {
@@ -112,7 +112,7 @@
             "description": "Brief availability info (e.g., 'In stock', 'Size 14 available', '3 left')"
           },
           "availability_status": {
-            "$ref": "/schemas/3.1.29/enums/offering-availability-status.json",
+            "$ref": "/schemas/3.1.31/enums/offering-availability-status.json",
             "description": "Machine-readable availability state for this product. Structured counterpart to availability_summary."
           },
           "url": {
@@ -129,7 +129,7 @@
       }
     },
     "sponsored_context": {
-      "$ref": "/schemas/3.1.29/sponsored-intelligence/si-sponsored-context.json",
+      "$ref": "/schemas/3.1.31/sponsored-intelligence/si-sponsored-context.json",
       "description": "Declaration for the sponsored context carried by this offering response. When present, it applies to the returned offering and matching_products package as a whole unless a future extension narrows the declaration to individual items. Hosts MUST either honor the declared context_use and disclosure_obligation or reject the context before using it."
     },
     "total_matching": {
@@ -152,15 +152,15 @@
     "errors": {
       "type": "array",
       "items": {
-        "$ref": "/schemas/3.1.29/core/error.json"
+        "$ref": "/schemas/3.1.31/core/error.json"
       },
       "description": "Errors during offering lookup"
     },
     "context": {
-      "$ref": "/schemas/3.1.29/core/context.json"
+      "$ref": "/schemas/3.1.31/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.29/core/ext.json"
+      "$ref": "/schemas/3.1.31/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/sponsored-intelligence/si-identity.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/sponsored-intelligence/si-identity.json",
+  "$id": "/schemas/3.1.31/sponsored-intelligence/si-identity.json",
   "title": "SI Identity",
   "description": "User identity shared with brand agent (with explicit consent)",
   "x-status": "experimental",

package/dist/lib/schemas-data/3.1/sponsored-intelligence/si-initiate-session-request.json

@@ -1,12 +1,12 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/sponsored-intelligence/si-initiate-session-request.json",
+  "$id": "/schemas/3.1.31/sponsored-intelligence/si-initiate-session-request.json",
   "title": "SI Initiate Session Request",
   "description": "Host initiates a session with a brand agent",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.29/core/version-envelope.json"
+      "$ref": "/schemas/3.1.31/core/version-envelope.json"
     }
   ],
   "x-status": "experimental",
@@ -17,10 +17,10 @@
       "description": "Natural language description of user intent — the conversation handoff from the host describing what the user needs from the brand agent"
     },
     "context": {
-      "$ref": "/schemas/3.1.29/core/context.json"
+      "$ref": "/schemas/3.1.31/core/context.json"
     },
     "identity": {
-      "$ref": "/schemas/3.1.29/sponsored-intelligence/si-identity.json"
+      "$ref": "/schemas/3.1.31/sponsored-intelligence/si-identity.json"
     },
     "media_buy_id": {
       "type": "string",
@@ -37,7 +37,7 @@
       "x-entity": "offering"
     },
     "supported_capabilities": {
-      "$ref": "/schemas/3.1.29/sponsored-intelligence/si-capabilities.json",
+      "$ref": "/schemas/3.1.31/sponsored-intelligence/si-capabilities.json",
       "description": "What capabilities the host supports"
     },
     "offering_token": {
@@ -45,7 +45,7 @@
       "description": "Token from si_get_offering response for session continuity. Brand uses this to recall what products were shown to the user, enabling natural references like 'the second one' or 'that blue shoe'."
     },
     "sponsored_context_receipt": {
-      "$ref": "/schemas/3.1.29/sponsored-intelligence/si-sponsored-context-receipt.json",
+      "$ref": "/schemas/3.1.31/sponsored-intelligence/si-sponsored-context-receipt.json",
       "description": "Host receipt for sponsored context accepted from a prior si_get_offering response or other pre-session context package. This records the accepted context_use, disclosure commitment, paying_principal, and host receipt for audit."
     },
     "idempotency_key": {
@@ -56,7 +56,7 @@
       "pattern": "^[A-Za-z0-9_.:-]{16,255}$"
     },
     "ext": {
-      "$ref": "/schemas/3.1.29/core/ext.json"
+      "$ref": "/schemas/3.1.31/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/sponsored-intelligence/si-initiate-session-response.json

@@ -1,15 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/sponsored-intelligence/si-initiate-session-response.json",
+  "$id": "/schemas/3.1.31/sponsored-intelligence/si-initiate-session-response.json",
   "title": "SI Initiate Session Response",
   "description": "Brand agent's response to session initiation",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.29/core/version-envelope.json"
+      "$ref": "/schemas/3.1.31/core/version-envelope.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/protocol-envelope.json"
+      "$ref": "/schemas/3.1.31/core/protocol-envelope.json"
     }
   ],
   "x-status": "experimental",
@@ -30,7 +30,7 @@
         "ui_elements": {
           "type": "array",
           "items": {
-            "$ref": "/schemas/3.1.29/sponsored-intelligence/si-ui-element.json"
+            "$ref": "/schemas/3.1.31/sponsored-intelligence/si-ui-element.json"
           },
           "description": "Visual components to render"
         }
@@ -38,15 +38,15 @@
       "additionalProperties": true
     },
     "negotiated_capabilities": {
-      "$ref": "/schemas/3.1.29/sponsored-intelligence/si-capabilities.json",
+      "$ref": "/schemas/3.1.31/sponsored-intelligence/si-capabilities.json",
       "description": "Intersection of brand and host capabilities for this session"
     },
     "sponsored_context": {
-      "$ref": "/schemas/3.1.29/sponsored-intelligence/si-sponsored-context.json",
+      "$ref": "/schemas/3.1.31/sponsored-intelligence/si-sponsored-context.json",
       "description": "Declaration for sponsored context carried by the initial brand-agent response. Hosts MUST either honor the declared context_use and disclosure_obligation or reject the context before presenting, comparing, or otherwise using it."
     },
     "session_status": {
-      "$ref": "/schemas/3.1.29/enums/si-session-status.json",
+      "$ref": "/schemas/3.1.31/enums/si-session-status.json",
       "description": "Current session lifecycle state. Returned in initiation, message, and termination responses."
     },
     "session_ttl_seconds": {
@@ -57,15 +57,15 @@
     "errors": {
       "type": "array",
       "items": {
-        "$ref": "/schemas/3.1.29/core/error.json"
+        "$ref": "/schemas/3.1.31/core/error.json"
       },
       "description": "Errors during session initiation"
     },
     "context": {
-      "$ref": "/schemas/3.1.29/core/context.json"
+      "$ref": "/schemas/3.1.31/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.29/core/ext.json"
+      "$ref": "/schemas/3.1.31/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/sponsored-intelligence/si-send-message-request.json

@@ -1,12 +1,12 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/sponsored-intelligence/si-send-message-request.json",
+  "$id": "/schemas/3.1.31/sponsored-intelligence/si-send-message-request.json",
   "title": "SI Send Message Request",
   "description": "Send a message to the brand agent within an active session",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.29/core/version-envelope.json"
+      "$ref": "/schemas/3.1.31/core/version-envelope.json"
     }
   ],
   "x-status": "experimental",
@@ -44,14 +44,14 @@
       "additionalProperties": true
     },
     "sponsored_context_receipt": {
-      "$ref": "/schemas/3.1.29/sponsored-intelligence/si-sponsored-context-receipt.json",
+      "$ref": "/schemas/3.1.31/sponsored-intelligence/si-sponsored-context-receipt.json",
       "description": "Host receipt for sponsored context accepted from a prior SI response in this session. This gives the brand/seller an audit-visible record of the host's accepted use mode and disclosure commitment for that context."
     },
     "context": {
-      "$ref": "/schemas/3.1.29/core/context.json"
+      "$ref": "/schemas/3.1.31/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.29/core/ext.json"
+      "$ref": "/schemas/3.1.31/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/sponsored-intelligence/si-send-message-response.json

@@ -1,15 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/sponsored-intelligence/si-send-message-response.json",
+  "$id": "/schemas/3.1.31/sponsored-intelligence/si-send-message-response.json",
   "title": "SI Send Message Response",
   "description": "Brand agent's response to a user message",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.29/core/version-envelope.json"
+      "$ref": "/schemas/3.1.31/core/version-envelope.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/protocol-envelope.json"
+      "$ref": "/schemas/3.1.31/core/protocol-envelope.json"
     }
   ],
   "x-status": "experimental",
@@ -28,13 +28,13 @@
           "description": "Conversational message from brand agent"
         },
         "surface": {
-          "$ref": "/schemas/3.1.29/a2ui/surface.json",
+          "$ref": "/schemas/3.1.31/a2ui/surface.json",
           "description": "A2UI surface with interactive components"
         },
         "ui_elements": {
           "type": "array",
           "items": {
-            "$ref": "/schemas/3.1.29/sponsored-intelligence/si-ui-element.json"
+            "$ref": "/schemas/3.1.31/sponsored-intelligence/si-ui-element.json"
           },
           "description": "Visual components to render (DEPRECATED: use surface instead)",
           "deprecated": true
@@ -47,11 +47,11 @@
       "description": "MCP resource URI for hosts with MCP Apps support (e.g., ui://si/session-abc123)"
     },
     "sponsored_context": {
-      "$ref": "/schemas/3.1.29/sponsored-intelligence/si-sponsored-context.json",
+      "$ref": "/schemas/3.1.31/sponsored-intelligence/si-sponsored-context.json",
       "description": "Declaration for sponsored context carried by this brand-agent response. Hosts MUST either honor the declared context_use and disclosure_obligation or reject the context before presenting, comparing, or otherwise using it."
     },
     "session_status": {
-      "$ref": "/schemas/3.1.29/enums/si-session-status.json",
+      "$ref": "/schemas/3.1.31/enums/si-session-status.json",
       "description": "Current session status. On a successful response, one of: active, pending_handoff, or complete. Terminated sessions return error codes (SESSION_NOT_FOUND or SESSION_TERMINATED) instead of a success response."
     },
     "handoff": {
@@ -117,14 +117,14 @@
     "errors": {
       "type": "array",
       "items": {
-        "$ref": "/schemas/3.1.29/core/error.json"
+        "$ref": "/schemas/3.1.31/core/error.json"
       }
     },
     "context": {
-      "$ref": "/schemas/3.1.29/core/context.json"
+      "$ref": "/schemas/3.1.31/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.29/core/ext.json"
+      "$ref": "/schemas/3.1.31/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/sponsored-intelligence/si-sponsored-context-receipt.json

@@ -1,13 +1,13 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/sponsored-intelligence/si-sponsored-context-receipt.json",
+  "$id": "/schemas/3.1.31/sponsored-intelligence/si-sponsored-context-receipt.json",
   "title": "SI Sponsored Context Receipt",
   "description": "Host receipt for sponsored context previously delivered into an SI host boundary. The receipt records what use mode the host accepted and what disclosure commitment it made; it does not claim that AdCP inspected hidden model reasoning.",
   "x-status": "experimental",
   "type": "object",
   "properties": {
     "sponsored_context": {
-      "$ref": "/schemas/3.1.29/sponsored-intelligence/si-sponsored-context.json",
+      "$ref": "/schemas/3.1.31/sponsored-intelligence/si-sponsored-context.json",
       "description": "The sponsored-context declaration the host received and is accepting or rejecting."
     },
     "host_receipt": {
@@ -23,7 +23,7 @@
           ]
         },
         "accepted_context_use": {
-          "$ref": "/schemas/3.1.29/sponsored-intelligence/si-context-use.json",
+          "$ref": "/schemas/3.1.31/sponsored-intelligence/si-context-use.json",
           "description": "Use mode the host accepted. When host_receipt.status is accepted, this MUST match the declaration's context_use; a host that cannot honor the declared use mode rejects the sponsored context instead of down-scoping it."
         },
         "received_at": {
@@ -121,7 +121,7 @@
       ]
     },
     "ext": {
-      "$ref": "/schemas/3.1.29/core/ext.json"
+      "$ref": "/schemas/3.1.31/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/sponsored-intelligence/si-sponsored-context.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/sponsored-intelligence/si-sponsored-context.json",
+  "$id": "/schemas/3.1.31/sponsored-intelligence/si-sponsored-context.json",
   "title": "SI Sponsored Context",
   "description": "Declaration attached to sponsored context delivered into an SI host boundary. Separates the economic accountability fact (`paying_principal`) from the host's receipt/acceptance record, which is carried separately by si-sponsored-context-receipt.json.",
   "x-status": "experimental",
@@ -11,7 +11,7 @@
       "description": "Economic accountability fact: the brand that funded or sponsored this context, with optional account/operator context. This identifies who paid for the sponsored context; it is distinct from the host's later receipt and use commitment.",
       "properties": {
         "brand": {
-          "$ref": "/schemas/3.1.29/core/brand-ref.json",
+          "$ref": "/schemas/3.1.31/core/brand-ref.json",
           "description": "Brand economically accountable for the sponsored context."
         },
         "account": {
@@ -46,7 +46,7 @@
       "additionalProperties": true
     },
     "context_use": {
-      "$ref": "/schemas/3.1.29/sponsored-intelligence/si-context-use.json",
+      "$ref": "/schemas/3.1.31/sponsored-intelligence/si-context-use.json",
       "description": "Declared host-side use mode for this sponsored context."
     },
     "disclosure_obligation": {
@@ -154,7 +154,7 @@
       "additionalProperties": true
     },
     "ext": {
-      "$ref": "/schemas/3.1.29/core/ext.json"
+      "$ref": "/schemas/3.1.31/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/sponsored-intelligence/si-terminate-session-request.json

@@ -1,12 +1,12 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/sponsored-intelligence/si-terminate-session-request.json",
+  "$id": "/schemas/3.1.31/sponsored-intelligence/si-terminate-session-request.json",
   "title": "SI Terminate Session Request",
   "description": "Request to terminate an SI session. Naturally idempotent — `session_id` is the dedup boundary, and terminating an already-terminated session is a no-op that returns the same terminal state. No `idempotency_key` is needed on this request.",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.29/core/version-envelope.json"
+      "$ref": "/schemas/3.1.31/core/version-envelope.json"
     }
   ],
   "x-status": "experimental",
@@ -62,10 +62,10 @@
       "additionalProperties": true
     },
     "context": {
-      "$ref": "/schemas/3.1.29/core/context.json"
+      "$ref": "/schemas/3.1.31/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.29/core/ext.json"
+      "$ref": "/schemas/3.1.31/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/sponsored-intelligence/si-terminate-session-response.json

@@ -1,15 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/sponsored-intelligence/si-terminate-session-response.json",
+  "$id": "/schemas/3.1.31/sponsored-intelligence/si-terminate-session-response.json",
   "title": "SI Terminate Session Response",
   "description": "Confirmation of session termination",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.29/core/version-envelope.json"
+      "$ref": "/schemas/3.1.31/core/version-envelope.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/protocol-envelope.json"
+      "$ref": "/schemas/3.1.31/core/protocol-envelope.json"
     }
   ],
   "x-status": "experimental",
@@ -24,7 +24,7 @@
       "description": "Whether session was successfully terminated"
     },
     "session_status": {
-      "$ref": "/schemas/3.1.29/enums/si-session-status.json",
+      "$ref": "/schemas/3.1.31/enums/si-session-status.json",
       "description": "Resulting session state. 'complete' for handoff_transaction/handoff_complete, 'terminated' for user_exit/session_timeout/host_terminated."
     },
     "acp_handoff": {
@@ -76,14 +76,14 @@
     "errors": {
       "type": "array",
       "items": {
-        "$ref": "/schemas/3.1.29/core/error.json"
+        "$ref": "/schemas/3.1.31/core/error.json"
       }
     },
     "context": {
-      "$ref": "/schemas/3.1.29/core/context.json"
+      "$ref": "/schemas/3.1.31/core/context.json"
     },
     "ext": {
-      "$ref": "/schemas/3.1.29/core/ext.json"
+      "$ref": "/schemas/3.1.31/core/ext.json"
     }
   },
   "required": [

package/dist/lib/schemas-data/3.1/sponsored-intelligence/si-ui-element.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/sponsored-intelligence/si-ui-element.json",
+  "$id": "/schemas/3.1.31/sponsored-intelligence/si-ui-element.json",
   "title": "SI UI Element",
   "description": "Standard visual component that brand returns and host renders",
   "x-status": "experimental",

package/dist/lib/schemas-data/3.1/trusted-match/available-package.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/trusted-match/available-package.json",
+  "$id": "/schemas/3.1.31/trusted-match/available-package.json",
   "title": "Available Package",
   "description": "A package available for contextual matching. Synced to providers at media buy creation time — not sent per request. Providers cache this metadata and use it when evaluating context match requests for the placement. The `seller_agent` field binds the package to the originating seller agent; providers MUST use this binding rather than re-deriving seller identity from media_buy_id.",
   "x-status": "experimental",
@@ -15,21 +15,21 @@
       "description": "Media buy that this package belongs to"
     },
     "seller_agent": {
-      "$ref": "/schemas/3.1.29/core/seller-agent-ref.json",
+      "$ref": "/schemas/3.1.31/core/seller-agent-ref.json",
       "description": "The seller agent that owns this package. `agent_url` MUST match one of `authorized_agents[].url` in the publisher's adagents.json authoritative for every property this package may serve. Providers SHOULD validate at sync time and reject mismatches with `seller_not_authorized`. Cached alongside the package and used for offer attribution, per-seller observability, and dispute resolution — not for request-time filtering."
     },
     "format_ids": {
       "type": "array",
       "description": "Creative format identifiers eligible for this package. Uses the standard AdCP format-id object with agent_url and id for unambiguous format resolution across namespaces.",
       "items": {
-        "$ref": "/schemas/3.1.29/core/format-id.json"
+        "$ref": "/schemas/3.1.31/core/format-id.json"
       }
     },
     "catalogs": {
       "type": "array",
       "description": "The buyer's catalogs attached to this package, with selectors (ids, gtins, tags, category, query) scoping which items are in play. References synced catalogs by catalog_id. The provider resolves items from its cached copy.",
       "items": {
-        "$ref": "/schemas/3.1.29/core/catalog.json"
+        "$ref": "/schemas/3.1.31/core/catalog.json"
       }
     }
   },

package/dist/lib/schemas-data/3.1/trusted-match/context-match-request.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/trusted-match/context-match-request.json",
+  "$id": "/schemas/3.1.31/trusted-match/context-match-request.json",
   "title": "Context Match Request",
   "description": "Sent by publisher to router or provider to evaluate packages against contextual signals. The provider uses its synced package set for the placement. MUST NOT contain user identity. The request_id MUST NOT correlate with any identity match request_id. Extension fields (ext, context) are intentionally omitted — extension data in the context path could inadvertently carry or correlate user identity signals.",
   "type": "object",
@@ -42,11 +42,11 @@
       "description": "Property catalog UUID (UUID v7). Globally unique, stable identifier assigned by the property catalog. The primary key for TMP matching and property list targeting."
     },
     "property_id": {
-      "$ref": "/schemas/3.1.29/core/property-id.json",
+      "$ref": "/schemas/3.1.31/core/property-id.json",
       "description": "Publisher's human-readable property slug (e.g., 'cnn_homepage'). Optional when property_rid is present. Useful for logging and debugging."
     },
     "property_type": {
-      "$ref": "/schemas/3.1.29/enums/property-type.json",
+      "$ref": "/schemas/3.1.31/enums/property-type.json",
       "description": "Type of the publisher property"
     },
     "placement_id": {
@@ -59,7 +59,7 @@
       "description": "API endpoint URL of the seller agent issuing this request. The provider uses this to resolve the active package set it has synced for this seller; when `package_ids` is omitted, evaluation occurs against that full set. If `seller_agent_url` does not match any seller the provider has synced packages for, the provider MUST return an empty offer set — it MUST NOT fall back to another seller's active set. The value identifies the asking seller, is identical for every user on a given placement, and carries no user identity, so it neither varies the request per user nor weakens the context/identity decorrelation boundary. Compared using the AdCP URL canonicalization rules, not byte-equality — see docs/reference/url-canonicalization. Consistent with `seller_agent_url` on the identity match request, `seller_agent.agent_url` on `AvailablePackage`, and `agent_url` in `adagents.json`."
     },
     "artifact": {
-      "$ref": "/schemas/3.1.29/content-standards/artifact.json",
+      "$ref": "/schemas/3.1.31/content-standards/artifact.json",
       "description": "Full content artifact adjacent to this ad opportunity. Same schema used for content standards evaluation. The publisher sends the artifact when they want the buyer to evaluate the full content. Contractual protections govern buyer use. TEE deployment upgrades contractual trust to cryptographic verification. Publishers MUST NOT include asset access credentials (bearer tokens, service accounts) — the router fans out to multiple buyer agents. For secured assets, use signed URLs with short expiry. Routers MUST strip access fields from artifacts before forwarding."
     },
     "artifact_refs": {
@@ -116,7 +116,7 @@
           "description": "Metro area, using the same classification systems as AdCP targeting.",
           "properties": {
             "system": {
-              "$ref": "/schemas/3.1.29/enums/metro-system.json",
+              "$ref": "/schemas/3.1.31/enums/metro-system.json",
               "description": "Metro area classification system (e.g., 'nielsen_dma', 'uk_itl2')."
             },
             "value": {

package/dist/lib/schemas-data/3.1/trusted-match/context-match-response.json

@@ -1,15 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/trusted-match/context-match-response.json",
+  "$id": "/schemas/3.1.31/trusted-match/context-match-response.json",
   "title": "Context Match Response",
   "description": "Response from router or provider with offers for matched packages. An empty offers array means no packages matched. For simple GAM integration, package_id flows as a macro via signals. For rich integrations, the offer includes brand, price, summary, and optionally an inline creative manifest. Extension fields (ext, context) are intentionally omitted — extension data in the context path could inadvertently carry or correlate user identity signals.",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.29/core/version-envelope.json"
+      "$ref": "/schemas/3.1.31/core/version-envelope.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/protocol-envelope.json"
+      "$ref": "/schemas/3.1.31/core/protocol-envelope.json"
     }
   ],
   "x-status": "experimental",
@@ -27,7 +27,7 @@
       "type": "array",
       "description": "Offers from the buyer, one per activated package. An empty array means no packages matched. For simple activation, each offer has just package_id. For richer responses, offers include brand, price, summary, and creative manifest.",
       "items": {
-        "$ref": "/schemas/3.1.29/trusted-match/offer.json"
+        "$ref": "/schemas/3.1.31/trusted-match/offer.json"
       }
     },
     "cache_ttl": {

package/dist/lib/schemas-data/3.1/trusted-match/error.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/trusted-match/error.json",
+  "$id": "/schemas/3.1.31/trusted-match/error.json",
   "title": "TMP Error",
   "description": "Error response from a TMP provider or router. Returned instead of a normal response when the provider cannot process the request. Distinguishes errors from empty results (an empty offers array is a valid response meaning no matches, not an error).",
   "x-status": "experimental",

package/dist/lib/schemas-data/3.1/trusted-match/identity-match-request.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/trusted-match/identity-match-request.json",
+  "$id": "/schemas/3.1.31/trusted-match/identity-match-request.json",
   "title": "Identity Match Request",
   "description": "Sent by publisher to evaluate user eligibility for packages using an opaque identity token. MUST NOT contain page context. The request_id MUST NOT correlate with any context match request_id. The buyer resolves the active package set for this seller from `seller_agent_url`; if `package_ids` is provided, its composition MUST be independent of the current placement (e.g., all-active or fuzzed; see field description) to prevent set-correlation attacks. Extension fields (ext, context) are intentionally omitted to prevent data leakage across the identity privacy boundary. The optional `attestation` (per identity) and `sealed_credentials` (top-level) fields carry verifiable proof ABOUT the identity — on the identity side of that boundary, not page context — so they are a deliberate, reviewed widening of this otherwise-closed schema, not a leak.",
   "type": "object",
@@ -52,7 +52,7 @@
             "description": "Opaque token from an identity provider (ID5, LiveRamp, UID2) or publisher-generated. Buyer may map to internal identity graph but cannot reverse to PII."
           },
           "uid_type": {
-            "$ref": "/schemas/3.1.29/enums/uid-type.json",
+            "$ref": "/schemas/3.1.31/enums/uid-type.json",
             "description": "Type of the user identifier. Tells the buyer which identity graph to resolve against, avoiding trial-and-error matching."
           },
           "attestation": {
@@ -60,7 +60,7 @@
             "description": "Optional verifiable proof ABOUT this identity (e.g. World ID proof-of-personhood and/or age). The receiver MUST verify it (see conformance) and MUST treat an absent-or-unverifiable attestation as 'no attestation' — never as an asserted-true claim. Issuer-agnostic: World ID is the first scheme; mDL / VC-style issuers use the same shape. Receivers MUST bound attestation size to prevent DoS.",
             "properties": {
               "issuer": {
-                "$ref": "/schemas/3.1.29/core/brand-ref.json",
+                "$ref": "/schemas/3.1.31/core/brand-ref.json",
                 "description": "Attestation authority / identity issuer, referenced as a vendor BrandRef (e.g. {\"domain\": \"world.org\"}) — the same vendor-reference shape AdCP uses for measurement and signals vendors. The issuer's canonical domain is the anchor; brand.json hosting is optional. `scheme` selects the verifier version within the issuer."
               },
               "scheme": {
@@ -80,7 +80,7 @@
                 "type": "array",
                 "description": "Claims this attestation establishes. Closed, issuer-agnostic set.",
                 "items": {
-                  "$ref": "/schemas/3.1.29/enums/attestation-claim.json"
+                  "$ref": "/schemas/3.1.31/enums/attestation-claim.json"
                 },
                 "minItems": 1,
                 "uniqueItems": true,

package/dist/lib/schemas-data/3.1/trusted-match/identity-match-response.json

@@ -1,15 +1,15 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/trusted-match/identity-match-response.json",
+  "$id": "/schemas/3.1.31/trusted-match/identity-match-response.json",
   "title": "Identity Match Response (Router → Publisher)",
   "description": "Router-to-publisher shape of the Identity Match response. The router collects each identity agent's ordered TMPX chunks (see provider-identity-match-response.json) and forwards them under the emitting `provider_id`, preserving provider attribution and chunk order. Each chunk is a provider-declared `{slot_id, value}` pair; the publisher's deployment configuration (see publisher-tmpx-config.json) maps `(provider_id, slot_id)` to the local ad-server macro name, targeting key, VAST substitution, or play-log field. The provider→router boundary never carries a publisher-local destination name, so no cross-provider name-hijack surface exists. Provider-hop fields (`tmpx_chunks` at the root) MUST NOT appear on this shape — a router that leaks them alongside `tmpx_providers` corrupts per-provider accounting. Envelope extension fields (`context`, `ext`) are intentionally omitted to prevent data leakage across the identity privacy boundary; they are forbidden by this schema. The serve_window_sec field defines a per-package single-shot fcap: after serving the user one impression on each eligible package, the publisher MUST re-query Identity Match before serving from those packages again.",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.29/core/version-envelope.json"
+      "$ref": "/schemas/3.1.31/core/version-envelope.json"
     },
     {
-      "$ref": "/schemas/3.1.29/core/protocol-envelope.json"
+      "$ref": "/schemas/3.1.31/core/protocol-envelope.json"
     }
   ],
   "x-status": "experimental",
@@ -56,7 +56,7 @@
             "type": "array",
             "description": "Ordered TMPX chunks for this provider. Each entry is a `{slot_id, value}` pair copied verbatim from the provider's `tmpx_chunks`. Ordered-prefix invariant: the sequence of `slot_id`s MUST equal an ordered prefix of the provider's registered `tmpx_slots` — publishers MAY reject responses whose slot_ids or ordering diverge. Cap of 2 chunks in v1; the cap MAY rise without a shape change.",
             "items": {
-              "$ref": "/schemas/3.1.29/trusted-match/tmpx-chunk.json"
+              "$ref": "/schemas/3.1.31/trusted-match/tmpx-chunk.json"
             },
             "minItems": 1,
             "maxItems": 2