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

package/compliance/cache/{3.1.29 → 3.1.31}/universal/stale-response-advisory.yaml

@@ -30,7 +30,7 @@ narrative: |
 
   The stale-cache forcing phases require comply_test_controller with the
   force_upstream_unavailable scenario. Steps requiring the controller grade not_applicable for
-  agents that do not advertise it. The non-emission guard (Phase 3) runs for all agents.
+  agents that do not advertise it. The healthy non-emission guard runs before outage forcing.
 
 agent:
   interaction_model: media_buy_seller
@@ -45,8 +45,8 @@ caller:
 
 prerequisites:
   description: |
-    Phase 2 (stale-cache forcing) requires comply_test_controller with
-    force_upstream_unavailable support. Phase 3 (non-emission guard) runs for all agents.
+    The stale-cache forcing phase requires comply_test_controller with
+    force_upstream_unavailable support. The healthy non-emission guard runs before outage forcing.
   test_kit: "test-kits/acme-outdoor.yaml"
 
 phases:
@@ -87,7 +87,67 @@ phases:
             value: "stale_response_advisory--get_capabilities"
             description: "Context correlation_id returned unchanged"
 
+  - id: non_emission_guard
+    title: "No STALE_RESPONSE on healthy upstream response"
+    narrative: |
+      STALE_RESPONSE MUST NOT be emitted when the upstream is healthy. Per the normative
+      error-code description, sellers MUST NOT emit STALE_RESPONSE when the cache hit is
+      within freshness target or when no cached payload exists — the correct code for a
+      completely unavailable upstream with no cache is SERVICE_UNAVAILABLE.
+
+      Run this healthy request before forcing any outage. It also warms the cache for
+      the same brief and account used by the subsequent stale-cache probe.
+
+    steps:
+      - id: no_stale_on_healthy_upstream
+        title: "STALE_RESPONSE absent on healthy upstream response"
+        narrative: |
+          A normal get_products request against a healthy upstream MUST NOT emit
+          STALE_RESPONSE. Sellers that unconditionally emit STALE_RESPONSE on every
+          get_products response are non-conformant — the code is only valid when a
+          specific cache-fallback condition is active.
+
+          NOTE: No machine-enforced absence check for STALE_RESPONSE exists today — the
+          `field_absent` primitive rejects errors[] entirely, but other error codes are
+          valid. The schema and correlation_id checks below prove conformance for
+          non-STALE_RESPONSE flows; a dedicated `error_code_absent` check kind would
+          close this gap. TODO: add check primitive when runner contract supports it.
+        task: get_products
+        schema_ref: "media-buy/get-products-request.json"
+        response_schema_ref: "media-buy/get-products-response.json"
+        doc_ref: "/media-buy/task-reference/get_products"
+        comply_scenario: stale_response_non_emission
+        stateful: false
+        expected: |
+          Return products normally. errors[] may be absent or present with codes other
+          than STALE_RESPONSE. STALE_RESPONSE MUST NOT appear unless the seller is
+          actively serving from a stale cache entry past its freshness target.
+
+        sample_request:
+          buying_mode: "brief"
+          brief: "Display advertising"
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+            sandbox: true
+          context:
+            correlation_id: "stale_response_advisory--no_stale_on_healthy"
+        validations:
+          - check: response_schema
+            description: "Response matches get-products-response.json schema on healthy upstream"
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "stale_response_advisory--no_stale_on_healthy"
+            description: "Context correlation_id returned unchanged"
+
   - id: stale_response_forcing
+    requires_capability:
+      path: compliance_testing.scenarios
+      contains: force_upstream_unavailable
     title: "Force stale-cache condition and verify advisory-success wire placement"
     narrative: |
       The test controller forces an upstream dependency unavailable while a stale cache entry
@@ -127,6 +187,9 @@ phases:
             tool: "get_products"
             upstream_name: "inventory-service"
           account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
             sandbox: true
           context:
             correlation_id: "stale_response_advisory--force_upstream_unavailable"
@@ -184,6 +247,7 @@ phases:
             brand:
               domain: "acmeoutdoor.example"
             operator: "pinnacle-agency.example"
+            sandbox: true
           context:
             correlation_id: "stale_response_advisory--stale_response_wire_placement"
         validations:
@@ -191,105 +255,49 @@ phases:
             description: "Response matches get-products-response.json schema even under stale cache"
             severity: advisory
             permanent_advisory:
-              reason: "Gated on force_upstream_unavailable runner support. Promote to required when widely adopted — remove permanent_advisory and severity fields. See issue #4934."
+              reason: "Gated on force_upstream_unavailable being advertised in the seller's comply_test_controller scenarios. Promote to required when widely adopted — remove permanent_advisory and severity fields. See issue #4934."
           - check: field_present
             path: "errors"
             description: "errors[] is present on a stale-cache response"
             severity: advisory
             permanent_advisory:
-              reason: "Gated on force_upstream_unavailable runner support. Promote to required when widely adopted. See issue #4934."
+              reason: "Gated on force_upstream_unavailable being advertised in the seller's comply_test_controller scenarios. Promote to required when widely adopted. See issue #4934."
           - check: field_value
             path: "errors[0].code"
             value: "STALE_RESPONSE"
             description: "First errors[] entry carries STALE_RESPONSE code"
             severity: advisory
             permanent_advisory:
-              reason: "Gated on force_upstream_unavailable runner support. Promote to required when widely adopted. See issue #4934."
+              reason: "Gated on force_upstream_unavailable being advertised in the seller's comply_test_controller scenarios. Promote to required when widely adopted. See issue #4934."
           - check: field_value
             path: "errors[0].details.served_from_cache"
             value: true
             description: "details.served_from_cache is true per error-details/stale-response.json"
             severity: advisory
             permanent_advisory:
-              reason: "Gated on force_upstream_unavailable runner support. Promote to required when widely adopted. See issue #4934."
+              reason: "Gated on force_upstream_unavailable being advertised in the seller's comply_test_controller scenarios. Promote to required when widely adopted. See issue #4934."
           - check: field_present
             path: "errors[0].details.cache_age_seconds"
             description: "details.cache_age_seconds is present (required details field)"
             severity: advisory
             permanent_advisory:
-              reason: "Gated on force_upstream_unavailable runner support. Promote to required when widely adopted. See issue #4934."
+              reason: "Gated on force_upstream_unavailable being advertised in the seller's comply_test_controller scenarios. Promote to required when widely adopted. See issue #4934."
           - check: field_present
             path: "context"
             description: "Response echoes back the context object on stale-cache advisory"
             severity: advisory
             permanent_advisory:
-              reason: "Gated on force_upstream_unavailable runner support. Promote to required when widely adopted. See issue #4934."
+              reason: "Gated on force_upstream_unavailable being advertised in the seller's comply_test_controller scenarios. Promote to required when widely adopted. See issue #4934."
           - check: field_value
             path: "context.correlation_id"
             value: "stale_response_advisory--stale_response_wire_placement"
             description: "Context correlation_id returned unchanged"
             severity: advisory
             permanent_advisory:
-              reason: "Gated on force_upstream_unavailable runner support. Promote to required when widely adopted. See issue #4934."
+              reason: "Gated on force_upstream_unavailable being advertised in the seller's comply_test_controller scenarios. Promote to required when widely adopted. See issue #4934."
           - check: field_present
             path: "products[0]"
             description: "Response payload is non-empty (products[] has at least one entry from stale cache)"
             severity: advisory
             permanent_advisory:
-              reason: "Gated on force_upstream_unavailable runner support. Promote to required when widely adopted. See issue #4934."
-
-  - id: non_emission_guard
-    title: "No STALE_RESPONSE on healthy upstream response"
-    narrative: |
-      STALE_RESPONSE MUST NOT be emitted when the upstream is healthy. Per the normative
-      error-code description, sellers MUST NOT emit STALE_RESPONSE when the cache hit is
-      within freshness target or when no cached payload exists — the correct code for a
-      completely unavailable upstream with no cache is SERVICE_UNAVAILABLE.
-
-      This phase sends a normal get_products request and verifies no STALE_RESPONSE appears.
-      Runs for all agents — no controller required.
-
-    steps:
-      - id: no_stale_on_healthy_upstream
-        title: "STALE_RESPONSE absent on healthy upstream response"
-        narrative: |
-          A normal get_products request against a healthy upstream MUST NOT emit
-          STALE_RESPONSE. Sellers that unconditionally emit STALE_RESPONSE on every
-          get_products response are non-conformant — the code is only valid when a
-          specific cache-fallback condition is active.
-
-          NOTE: No machine-enforced absence check for STALE_RESPONSE exists today — the
-          `field_absent` primitive rejects errors[] entirely, but other error codes are
-          valid. The schema and correlation_id checks below prove conformance for
-          non-STALE_RESPONSE flows; a dedicated `error_code_absent` check kind would
-          close this gap. TODO: add check primitive when runner contract supports it.
-        task: get_products
-        schema_ref: "media-buy/get-products-request.json"
-        response_schema_ref: "media-buy/get-products-response.json"
-        doc_ref: "/media-buy/task-reference/get_products"
-        comply_scenario: stale_response_non_emission
-        stateful: false
-        expected: |
-          Return products normally. errors[] may be absent or present with codes other
-          than STALE_RESPONSE. STALE_RESPONSE MUST NOT appear unless the seller is
-          actively serving from a stale cache entry past its freshness target.
-
-        sample_request:
-          buying_mode: "brief"
-          brief: "Display advertising for outdoor lifestyle campaign"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          context:
-            correlation_id: "stale_response_advisory--no_stale_on_healthy"
-        validations:
-          - check: response_schema
-            description: "Response matches get-products-response.json schema on healthy upstream"
-          - check: field_present
-            path: "context"
-            description: "Response echoes back the context object"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "stale_response_advisory--no_stale_on_healthy"
-            description: "Context correlation_id returned unchanged"
+              reason: "Gated on force_upstream_unavailable being advertised in the seller's comply_test_controller scenarios. Promote to required when widely adopted. See issue #4934."

package/compliance/cache/{3.1.29 → 3.1.31}/universal/storyboard-schema.yaml

@@ -148,7 +148,7 @@
 #   coverage totals of agents that never claimed the capability.
 #
 # requires: string[] (optional — storyboard-level runtime requirement gate.
-#   Known values: controller | seeded_state | real_wire | webhook_receiver | multi_agent (forward-compat:
+#   Known values: controller | seeded_state | real_wire | collect_product_pages_runner | webhook_receiver | multi_agent (forward-compat:
 #   unrecognized values are NOT schema violations — runners emit
 #   requirement_unmet at runtime; see Forward compatibility below).
 #   Default when absent: [real_wire] — untagged storyboards run unchanged.
@@ -159,6 +159,12 @@
 #
 #   Values and availability:
 #
+#     collect_product_pages_runner — intrinsic support for the opt-in wholesale
+#                    product-page collector. No operator configuration is needed.
+#                    A storyboard using collect_product_pages MUST declare this
+#                    requirement so older runners report requirement_unmet before
+#                    fixture mutation instead of silently checking only one page.
+#
 #     controller   — gate on agent advertising comply_test_controller.
 #                    Available when the agent's get_adcp_capabilities response
 #                    includes comply_test_controller in its tool list. When
@@ -567,9 +573,9 @@
 #     2. THIS field (storyboard-root `context:` block, fixed at run start)
 #     3. Test-kit substitutions where explicitly scoped into context
 #
-#   Values MUST be scalars (strings, numbers, booleans — JSON scalar types).
-#   Object and array values are not supported here — capture structured values
-#   from step responses via `context_outputs:` instead.
+#   Values MAY be JSON scalars, objects, or arrays. Step context_outputs can
+#   replace defaults with response-derived structured values. Domain objects
+#   placed here are runner defaults, not additional protocol request fields.
 #
 #   See "Context accumulator and substitution" below for the full precedence
 #   contract, runner substitution rules, and unresolved-substitution grading.)
@@ -922,6 +928,13 @@
 #   Omitting `negative_path` when `expect_error: true` behaves as `schema_invalid`
 #   (backwards-compatible default).
 #
+# enrich_request: true (optional — only with expect_error: true and
+#   negative_path: payload_well_formed). Opt this semantic rejection probe into
+#   the normal per-task request enricher, including discovered auction bids.
+#   The default for negative probes preserves the authored request exactly;
+#   intentionally malformed requests MUST NOT set this flag. Explicit fixture
+#   values still win, and governance-authorized payloads remain unmodified.
+#
 # sample_request_skip_schema: boolean (optional — explicit opt-out of schema
 #   validation for a step regardless of `expect_error` / `negative_path`. Use
 #   sparingly; prefer `negative_path: schema_invalid` for intentionally malformed
@@ -2353,3 +2366,58 @@
 #      step as failed with `unresolved_substitution`.
 #
 # Neither path may ship a literal `$context.*` or `{{...}}` token on the wire.
+
+# Discover-before-seed fixture applicability (maintenance harness addition)
+# ---------------------------------------------------------------------
+# These additive harness declarations never change 3.1 task schemas. Runners
+# must support discover-before-seed fixture resolution and the intrinsic
+# collect_product_pages_runner requirement. This maintenance line tests them
+# with SDK 17.0.0-beta.7 using the immutable 3.1 schemas and wire compatibility.
+#
+# requires_all_capabilities: two or more capability predicates AND-composed
+# before runtime requirements and fixture setup. Predicates use the existing
+# path + exactly one equals/contains/present matcher. Missing capabilities
+# cannot be inferred from tool advertisement. A failed predicate selects no
+# execution and is reported not_applicable rather than a seller failure.
+#
+# fixture_resolution.products: an array of {handle, strategies, match} entries.
+# handle names a fixtures.products product_id. strategies: [discover] selects
+# a native product through fully paginated wholesale discovery in the resolved
+# sandbox account. Match clauses use JSON Pointers and equals, present,
+# contains_all, or any_match (the latter has nested where clauses).
+# A valid no-match is a fixture_unsatisfied coverage gap, never proof of general
+# nonsupport or a conformance pass. Malformed, rejected, failed, or incomplete
+# discovery remains a failure. Only after native support resolves do phases
+# manually seed the optional feature. Unresolved feature fixtures must not be
+# seeded as a fallback. The resolved handle is independent of synthetic IDs.
+#
+# all_fields_in_context_array validates each terminal value of a wildcard
+# response path against a context array captured by a prior step. Empty results
+# are valid for filters. A missing context comparand is an explicit unavailable
+# observation; authors must validate/capture the comparand in a prerequisite
+# step to establish coverage. Scope the capture to each independent phase so
+# absent optional modes never suppress supported sibling coverage.
+
+# collect_product_pages: true (optional; omit to read one page). Only valid for a
+#   get_products step with sample_request.buying_mode: wholesale and the
+#   storyboard requirement collect_product_pages_runner. The runner walks the
+#   complete, stable enumeration using the actual authored account, filters,
+#   fields, credentials, context, and page size. Every physical response must
+#   satisfy the Product schema, including its required fields when fields is
+#   supplied; collection does not relax validation for fields projections.
+#   Collected reads MUST omit idempotency_key: each cursor changes the request
+#   body and must execute a fresh read rather than replay a prior page.
+#   The initial request MUST NOT
+#   contain a cursor or if_wholesale_feed_version/if_pricing_version token.
+#   Negative-auth, parallel-dispatch, and response-applicability probe paths
+#   cannot be combined with collection.
+#
+#   Each physical page is schema-validated and observed by the step's enabled
+#   invariants, including pages later discarded after a feed restart or omitted
+#   from bounded receipt retention. Broken cursors, rejected/malformed pages,
+#   duplicate identities, unstable feeds, and exhausted budgets never yield a
+#   partial successful catalog. Authored field checks and context captures use
+#   the separately labelled logical_response only after enumeration completes.
+#   Actual wire receipts remain actual pages; see runner-output-contract.yaml >
+#   product_page_collection_output for evidence and JSON Pointer requirements.
+#

package/dist/lib/schemas-data/3.1/a2ui/bound-value.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/a2ui/bound-value.json",
+  "$id": "/schemas/3.1.31/a2ui/bound-value.json",
   "title": "A2UI Bound Value",
   "description": "A value that can be a literal or bound to a path in the data model",
   "oneOf": [

package/dist/lib/schemas-data/3.1/a2ui/component.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/a2ui/component.json",
+  "$id": "/schemas/3.1.31/a2ui/component.json",
   "title": "A2UI Component",
   "description": "A component in an A2UI surface",
   "type": "object",

package/dist/lib/schemas-data/3.1/a2ui/si-catalog.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/a2ui/si-catalog.json",
+  "$id": "/schemas/3.1.31/a2ui/si-catalog.json",
   "title": "SI Component Catalog",
   "description": "A2UI component catalog for Sponsored Intelligence",
   "definitions": {
@@ -9,7 +9,7 @@
       "description": "Text display component",
       "properties": {
         "text": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Text content to display"
         },
         "variant": {
@@ -32,7 +32,7 @@
       "description": "Interactive button component",
       "properties": {
         "label": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Button label text"
         },
         "action": {
@@ -47,7 +47,7 @@
               "type": "object",
               "description": "Context data to include with action",
               "additionalProperties": {
-                "$ref": "/schemas/3.1.29/a2ui/bound-value.json"
+                "$ref": "/schemas/3.1.31/a2ui/bound-value.json"
               }
             }
           },
@@ -65,7 +65,7 @@
           "default": "primary"
         },
         "disabled": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json"
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json"
         }
       },
       "required": [
@@ -78,11 +78,11 @@
       "description": "Hyperlink component",
       "properties": {
         "label": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Link text"
         },
         "url": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "URL to navigate to"
         },
         "external": {
@@ -101,11 +101,11 @@
       "description": "Image display component",
       "properties": {
         "src": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Image source URL"
         },
         "alt": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Alt text for accessibility"
         },
         "width": {
@@ -127,19 +127,19 @@
       "description": "Card container for grouped content",
       "properties": {
         "title": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Card title"
         },
         "subtitle": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Card subtitle"
         },
         "image": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Card image URL"
         },
         "badge": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Badge text (e.g., 'New', 'Sale')"
         },
         "action": {
@@ -152,7 +152,7 @@
             "context": {
               "type": "object",
               "additionalProperties": {
-                "$ref": "/schemas/3.1.29/a2ui/bound-value.json"
+                "$ref": "/schemas/3.1.31/a2ui/bound-value.json"
               }
             }
           },
@@ -177,27 +177,27 @@
       "description": "Product display card (SI-specific)",
       "properties": {
         "title": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Product name"
         },
         "price": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Price display string"
         },
         "image": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Product image URL"
         },
         "description": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Product description"
         },
         "badge": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Badge text (e.g., 'Best Seller')"
         },
         "ctaLabel": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "CTA button label"
         },
         "action": {
@@ -209,7 +209,7 @@
             "context": {
               "type": "object",
               "additionalProperties": {
-                "$ref": "/schemas/3.1.29/a2ui/bound-value.json"
+                "$ref": "/schemas/3.1.31/a2ui/bound-value.json"
               }
             }
           },
@@ -228,7 +228,7 @@
       "description": "Data-bound list component",
       "properties": {
         "items": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Path to array in data model"
         },
         "template": {
@@ -245,7 +245,7 @@
           ]
         },
         "emptyMessage": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Message to show when list is empty"
         },
         "layout": {
@@ -349,11 +349,11 @@
           "description": "Integration type"
         },
         "label": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Button label"
         },
         "url": {
-          "$ref": "/schemas/3.1.29/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.31/a2ui/bound-value.json",
           "description": "Integration endpoint URL"
         },
         "highlighted": {

package/dist/lib/schemas-data/3.1/a2ui/surface.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/a2ui/surface.json",
+  "$id": "/schemas/3.1.31/a2ui/surface.json",
   "title": "A2UI Surface",
   "description": "A contiguous UI region containing components",
   "type": "object",
@@ -18,7 +18,7 @@
       "type": "array",
       "description": "Flat list of components (adjacency list structure)",
       "items": {
-        "$ref": "/schemas/3.1.29/a2ui/component.json"
+        "$ref": "/schemas/3.1.31/a2ui/component.json"
       }
     },
     "rootId": {

package/dist/lib/schemas-data/3.1/a2ui/user-action.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/a2ui/user-action.json",
+  "$id": "/schemas/3.1.31/a2ui/user-action.json",
   "title": "A2UI User Action",
   "description": "User interaction event sent from client to agent",
   "type": "object",

package/dist/lib/schemas-data/3.1/aao/agent-publishers.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/aao/agent-publishers.json",
+  "$id": "/schemas/3.1.31/aao/agent-publishers.json",
   "title": "AAO Directory: Agent → Publishers Inverse Lookup Response",
   "description": "Response envelope for `GET /v1/agents/{agent_url}/publishers` against an AAO-compatible directory. Returns the set of publishers whose adagents.json authorizes the given agent_url, with provenance (discovery_method, manager_domain), per-publisher property counts, and lifecycle status. The publisher's own adagents.json remains the trust root; this endpoint is discovery, not authorization. Each `publisher_domain` row tells the operator which publishers to verify directly via the SDK's per-domain primitives.",
   "type": "object",

package/dist/lib/schemas-data/3.1/account/get-account-financials-request.json

@@ -1,28 +1,28 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.29/account/get-account-financials-request.json",
+  "$id": "/schemas/3.1.31/account/get-account-financials-request.json",
   "title": "Get Account Financials Request",
   "description": "Request financial status for an operator-billed account. Returns spend summary, credit/balance status, and invoice history. Only applicable when the seller declares account_financials capability.",
   "type": "object",
   "allOf": [
     {
-      "$ref": "/schemas/3.1.29/core/version-envelope.json"
+      "$ref": "/schemas/3.1.31/core/version-envelope.json"
     }
   ],
   "properties": {
     "account": {
-      "$ref": "/schemas/3.1.29/core/account-ref.json",
+      "$ref": "/schemas/3.1.31/core/account-ref.json",
       "description": "Account to query financials for. Must be an operator-billed account."
     },
     "period": {
-      "$ref": "/schemas/3.1.29/core/date-range.json",
+      "$ref": "/schemas/3.1.31/core/date-range.json",
       "description": "Date range for the spend summary. Defaults to the current billing cycle if omitted."
     },
     "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": [