@adcp/sdk 15.9.7 → 15.9.8

package/compliance/cache/{3.2.5/protocols → 3.2.8/domains}/media-buy/scenarios/total_budget_redistribution.yaml

@@ -16,6 +16,19 @@ required_tools:
 invariants:
   - status.monotonic
 
+narrative: |
+  This scenario grades total_budget redistribution, not currency selection —
+  that is graded by media_buy_seller/pricing_currency_filter. A media buy
+  carries a single currency, and update_media_buy cannot redenominate it, so
+  every total_budget this scenario sends must repeat the currency the buy was
+  committed in.
+
+  The buyer therefore reads the committed buy back before updating it and
+  reuses media_buys[0].currency, which get_media_buys requires. Reading the
+  currency off the buy instead of restating the seeded rate card keeps the
+  grading on the redistribution arithmetic whichever currency the seller
+  committed in.
+
 agent:
   interaction_model: media_buy_seller
   capabilities:
@@ -27,7 +40,11 @@ caller:
   example: "Pinnacle Agency (buyer)"
 
 prerequisites:
-  description: "The controller seeds two fixed-budget products in one currency."
+  description: |
+    The controller seeds two fixed-budget products in one currency, so the buy
+    below commits in exactly one. The scenario then asserts against the currency
+    the seller reports on the committed buy rather than against the seeded rate
+    card; it does not grade which currency that is.
   test_kit: "test-kits/acme-outdoor.yaml"
   controller_seeding: true
 
@@ -57,7 +74,7 @@ fixtures:
 
 phases:
   - id: setup
-    title: "Create a fixed-allocation buy"
+    title: "Create a fixed-allocation buy and read its committed state"
     steps:
       - id: sync_account
         title: "Establish the buyer account"
@@ -103,7 +120,9 @@ phases:
         context_outputs:
           - name: media_buy_id
             path: "media_buy_id"
-          - name: revision
+          # Not `revision`: get_media_buys writes that key by convention, and the
+          # read below would overwrite the revision create_media_buy returned.
+          - name: created_revision
             path: "revision"
           - name: first_package_id
             path: "packages[0].package_id"
@@ -113,6 +132,25 @@ phases:
             path: "total_budget"
             value: 100000
 
+      - id: read_committed_currency
+        title: "Read the committed buy's currency"
+        task: get_media_buys
+        schema_ref: "media-buy/get-media-buys-request.json"
+        response_schema_ref: "media-buy/get-media-buys-response.json"
+        stateful: true
+        sample_request:
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          media_buy_ids:
+            - "$context.media_buy_id"
+        context_outputs:
+          - name: media_buy_currency
+            path: "media_buys[0].currency"
+        validations:
+          - check: response_schema
+
   - id: redistribute
     title: "Apply a media-buy-level total atomically"
     steps:
@@ -128,10 +166,10 @@ phases:
               domain: "acmeoutdoor.example"
             operator: "pinnacle-agency.example"
           media_buy_id: "$context.media_buy_id"
-          revision: "$context.revision"
+          revision: "$context.created_revision"
           total_budget:
             amount: 50000
-            currency: "USD"
+            currency: "$context.media_buy_currency"
           idempotency_key: "$generate:uuid_v4#total_budget_redistribution_update"
         validations:
           - check: response_schema
@@ -160,6 +198,10 @@ phases:
             - "$context.media_buy_id"
         validations:
           - check: response_schema
+          - check: field_value
+            path: "media_buys[0].currency"
+            value: "$context.media_buy_currency"
+            description: "Redistribution rescales the buy without redenominating it"
           - check: field_value
             path: "media_buys[0].total_budget"
             value: 50000
@@ -172,13 +214,15 @@ phases:
 
   - id: reject_ambiguous_update
     title: "Reject an inconsistent total_budget assertion"
+    depends_on:
+      - setup
     steps:
       - id: reject_total_with_packages
         title: "Reject total_budget that does not match the explicit package sum"
         task: update_media_buy
         schema_ref: "media-buy/update-media-buy-request.json"
         response_schema_ref: "media-buy/update-media-buy-response.json"
-        stateful: false
+        stateful: true
         expect_error: true
         sample_request:
           account:
@@ -188,7 +232,7 @@ phases:
           media_buy_id: "$context.media_buy_id"
           total_budget:
             amount: 60000
-            currency: "USD"
+            currency: "$context.media_buy_currency"
           packages:
             - package_id: "$context.first_package_id"
               budget: 99999

package/compliance/cache/{3.2.5 → 3.2.8}/domains/media-buy/scenarios/typed_proposal_negotiation.yaml

@@ -600,6 +600,11 @@ phases:
             description: "Replay preserves the original hold expiry"
 
   - id: accept_committed
+    # Negotiation can be supported without compact acceptance. The accepted
+    # descendants depend on this phase; finalize-only probes remain applicable.
+    requires_capability:
+      path: media_buy.lifecycle_tools
+      contains: accept_proposal
     title: "Accept committed proposal to create MediaBuy"
     depends_on: [finalize_proposal]
     narrative: |

package/compliance/cache/{3.2.5 → 3.2.8}/domains/media-buy/scenarios/vendor_metric_accountability.yaml

@@ -1,5 +1,5 @@
 id: media_buy_seller/vendor_metric_accountability
-version: "1.0.1"
+version: "1.0.2"
 title: "End-to-end vendor-metric accountability: declaration → commitment → delivery audit"
 category: media_buy_seller
 summary: "Buyer commits vendor metrics on two packages, then verifies one clean package, one overdue gap, and one not-yet-measurable omission."
@@ -196,6 +196,8 @@ phases:
       Package 0 commits attention plus a post-flight metric; package 1 commits
       the same attention metric. The seller stamps both package contracts with
       `committed_at`, allowing the report to prove package-scoped isolation.
+      A read-back then settles the normative day-1 equality
+      `committed_at == confirmed_at` against the persisted buy.
     steps:
       - id: create_media_buy
         title: "Create media buy"
@@ -244,6 +246,12 @@ phases:
             key: "media_buy_id"
           - path: "confirmed_at"
             key: "confirmed_at"
+          - path: "packages[0].committed_metrics[0].committed_at"
+            key: "day_one_committed_at_pkg0_attention"
+          - path: "packages[0].committed_metrics[1].committed_at"
+            key: "day_one_committed_at_pkg0_brand_lift"
+          - path: "packages[1].committed_metrics[0].committed_at"
+            key: "day_one_committed_at_pkg1_attention"
         validations:
           - check: response_schema
             description: "Response matches create-media-buy-response.json schema"
@@ -261,15 +269,70 @@ phases:
           - check: field_present
             path: "packages[0].committed_metrics[0].committed_at"
             description: "Seller stamps the commitment time used by delivery reconciliation"
-          - check: field_value
-            path: "packages[0].committed_metrics[0].committed_at"
-            value: "$context.confirmed_at"
-            description: "Day-1 commitment time equals the media buy confirmed_at timestamp"
           - check: field_value
             path: "packages[1].committed_metrics[0].metric_id"
             value: "attention_units"
             description: "Breach package commits the same metric, proving values are package-scoped"
 
+      # `each such entry's committed_at MUST equal confirmed_at` for the day-1
+      # set (/media-buy/task-reference/create_media_buy, core/package.json)
+      # cannot be asserted on the create step itself: the runner resolves a
+      # validation comparand from the context as it stood *before* the step,
+      # and that step's own context_outputs land after its validations run, so
+      # both operands would still be unresolved `$context.` tokens (#8328).
+      # Every day-1 committed_at is captured on create and settled here against
+      # the persisted confirmed_at, which `confirmed_at` is normatively stable
+      # for ("Once populated, remains stable", get-media-buys-response.json).
+      #
+      # `get_media_buys` stays a step-level `requires_tool` rather than joining
+      # the storyboard's `required_tools`: that list is an any-of gate
+      # (hasAnyRequiredTool), so adding a tool to it widens selection instead of
+      # tightening it. A seller that does not advertise get_media_buys skips
+      # this step; the equality is then ungraded, which is a property of the
+      # runner's skip-is-not-a-failure model rather than of this assertion.
+      - id: read_back_commitment_timestamps
+        title: "Read the buy back and settle committed_at = confirmed_at"
+        task: get_media_buys
+        requires_tool: get_media_buys
+        schema_ref: "media-buy/get-media-buys-request.json"
+        response_schema_ref: "media-buy/get-media-buys-response.json"
+        doc_ref: "/media-buy/task-reference/get_media_buys"
+        stateful: true
+        expected: |
+          Return the buy under test, echoing the confirmed_at the create
+          response returned. That timestamp is the one the seller stamped on
+          every day-1 committed_metrics entry, on both packages.
+        sample_request:
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          media_buy_ids:
+            - "$context.media_buy_id"
+        validations:
+          - check: response_schema
+            description: "Response matches get-media-buys-response.json schema"
+          - check: field_equals_context
+            path: "media_buys[0].media_buy_id"
+            context_key: "media_buy_id"
+            description: "Read-back returns the buy under test, not another buy"
+          - check: field_equals_context
+            path: "media_buys[0].confirmed_at"
+            context_key: "confirmed_at"
+            description: "Persisted confirmed_at is the one create_media_buy returned"
+          - check: field_equals_context
+            path: "media_buys[0].confirmed_at"
+            context_key: "day_one_committed_at_pkg0_attention"
+            description: "Package 0 attention commitment time equals the media buy confirmed_at timestamp"
+          - check: field_equals_context
+            path: "media_buys[0].confirmed_at"
+            context_key: "day_one_committed_at_pkg0_brand_lift"
+            description: "Package 0 brand-lift commitment time equals the media buy confirmed_at timestamp"
+          - check: field_equals_context
+            path: "media_buys[0].confirmed_at"
+            context_key: "day_one_committed_at_pkg1_attention"
+            description: "Package 1 attention commitment time equals the media buy confirmed_at timestamp"
+
   - id: simulate_and_validate_vendor_metrics
     title: "Simulate delivery with vendor-metric values and validate emission"
     narrative: |

package/compliance/cache/{3.2.5 → 3.2.8}/domains/media-buy/state-machine.yaml

@@ -210,6 +210,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-media_buy_state_machine-f9152bb7"
+            sandbox: true
           creatives:
             - creative_id: "state_machine_display_creative"
               name: "Acme Outdoor State Machine Creative"
@@ -262,6 +263,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-media_buy_state_machine-f9152bb7"
+            sandbox: true
           brand:
             domain: "acmeoutdoor.example"
           start_time: "asap"
@@ -329,6 +331,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-media_buy_state_machine-f9152bb7"
+            sandbox: true
           media_buy_id: "$context.media_buy_id"
           paused: true
 
@@ -367,6 +370,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-media_buy_state_machine-f9152bb7"
+            sandbox: true
           media_buy_id: "$context.media_buy_id"
           paused: false
 
@@ -406,6 +410,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-media_buy_state_machine-f9152bb7"
+            sandbox: true
           media_buy_id: "$context.media_buy_id"
           canceled: true
 
@@ -458,6 +463,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-media_buy_state_machine-f9152bb7"
+            sandbox: true
           media_buy_id: "$context.media_buy_id"
           paused: true
           idempotency_key: "$generate:uuid_v4#pause_canceled_buy"
@@ -499,6 +505,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-media_buy_state_machine-f9152bb7"
+            sandbox: true
           media_buy_id: "$context.media_buy_id"
           paused: false
           idempotency_key: "$generate:uuid_v4#resume_canceled_buy"
@@ -548,6 +555,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-media_buy_state_machine-f9152bb7"
+            sandbox: true
           media_buy_id: "$context.media_buy_id"
           canceled: true
 

package/compliance/cache/{3.2.5 → 3.2.8}/domains/signals/index.yaml

@@ -147,6 +147,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-signals_baseline-2778ce3f"
+            sandbox: true
           signal_spec: "Adults interested in electric vehicles"
           context:
             correlation_id: "signals_baseline--search_signals"

package/compliance/cache/{3.2.5 → 3.2.8}/index.json

@@ -1,7 +1,7 @@
 {
-  "published_version": "3.2.5",
-  "adcp_version": "3.2.5",
-  "generated_at": "2026-10-16T16:46:24.874Z",
+  "published_version": "3.2.8",
+  "adcp_version": "3.2.8",
+  "generated_at": "2026-10-28T17:46:35.979Z",
   "universal": [
     "account-identity-reconciliation",
     "agent-notification-configs",
@@ -48,6 +48,7 @@
     "storyboard-schema",
     "trusted-match-publisher-authentication",
     "v3-envelope-integrity",
+    "v4-compatibility",
     "version-negotiation",
     "webhook-emission",
     "webhook-receiver-envelope",
@@ -376,6 +377,7 @@
       "required_tools": [
         "sync_creatives",
         "list_products",
+        "get_products",
         "create_media_buy",
         "get_media_buy_delivery"
       ],

package/compliance/cache/{3.2.5 → 3.2.8}/protocols/creative/scenarios/billing_out_of_band.yaml

@@ -143,6 +143,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_billing_out_of_band-07c4ce40"
+            sandbox: true
           idempotency_key: "$generate:uuid_v4#creative_billing_out_of_band_report_usage"
           reporting_period:
             start: "2099-07-01T00:00:00Z"

package/compliance/cache/{3.2.5 → 3.2.8}/protocols/creative/scenarios/canonical_supported_formats.yaml

@@ -151,6 +151,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_canonical_supported_formats-5b23e65e"
+            sandbox: true
           brand:
             domain: "acmeoutdoor.example"
           quality: "draft"
@@ -209,6 +210,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_canonical_supported_formats-5b23e65e"
+            sandbox: true
           brand:
             domain: "acmeoutdoor.example"
           quality: "draft"

package/compliance/cache/{3.2.5 → 3.2.8}/protocols/creative/scenarios/creative_lifecycle_webhooks.yaml

@@ -409,11 +409,13 @@ phases:
       - id: expect_status_changed_webhook
         title: "Assert suspended → rejected webhook payload"
         task: expect_webhook
+        triggered_by: force_creative_rejected
         filter:
           body:
             notification_type: "creative.status_changed"
             creative_id: "acme_lifecycle_banner_001"
             subscriber_id: "buyer-primary"
+            transition.to: "rejected"
         timeout_seconds: 30
         expect_idempotency_key: true
         webhook_payload_schema_ref: "creative/creative-status-changed-webhook.json"