@adcp/sdk 16.4.0 → 16.5.0

package/compliance/cache/{3.2.5 → 3.2.7}/protocols/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.7}/protocols/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.7}/protocols/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.7}/specialisms/audience-sync/index.yaml

@@ -216,6 +216,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-audience_sync-05028b55"
+            sandbox: true
 
           idempotency_key: "$generate:uuid_v4#audience_sync_audience_sync_discover_audiences"
           context:
@@ -259,6 +260,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-audience_sync-05028b55"
+            sandbox: true
           audiences:
             - audience_id: "adcp-test-audience-001"
               name: "AdCP test audience"
@@ -323,6 +325,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-audience_sync-05028b55"
+            sandbox: true
           audiences:
             - audience_id: "adcp-test-audience-001"
               delete: true

package/compliance/cache/{3.2.5 → 3.2.7}/specialisms/brand-rights/index.yaml

@@ -287,6 +287,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-brand_rights-cb7142f1"
+            sandbox: true
           rights_id: "$context.rights_id"
           pricing_option_id: "$context.pricing_option_id"
           buyer:
@@ -352,6 +353,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-brand_rights-cb7142f1"
+            sandbox: true
           rights_id: "$context.rights_grant_id"
           paused: true
           idempotency_key: "$generate:uuid_v4#brand_rights_rights_update"
@@ -413,6 +415,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-brand_rights-cb7142f1"
+            sandbox: true
           rights_id: "$context.rights_id"
           pricing_option_id: "$context.pricing_option_id"
           buyer:

package/compliance/cache/{3.2.5 → 3.2.7}/specialisms/buyer-monitoring/index.yaml

@@ -10,6 +10,14 @@ required_tools:
   - get_media_buys
   - get_media_buy_delivery
 
+# The fixture publisher serves the buy declared in
+# fixtures.fixture_publisher.active_buy; no step in this storyboard creates
+# one, so the id the delivery polls address has to be seeded here. Without it
+# `$context.media_buy_id` has no writer and the reads can only ever skip with
+# `prerequisite_failed`.
+context:
+  media_buy_id: "mb_monitoring_001"
+
 narrative: |
   You are a buyer agent monitoring an active media buy. After activation,
   you track delivery progress via polling (get_media_buy_delivery) and

package/compliance/cache/{3.2.5 → 3.2.7}/specialisms/collection-lists/index.yaml

@@ -162,6 +162,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-collection_lists-90c10f16"
+            sandbox: true
           brand:
             domain: "novamotors.example"
           name: "Nova Motors approved programs"
@@ -231,6 +232,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-collection_lists-90c10f16"
+            sandbox: true
           name_contains: "Nova Motors"
 
           context:
@@ -276,6 +278,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-collection_lists-90c10f16"
+            sandbox: true
 
           context:
             correlation_id: "collection_lists--get_collection_list"
@@ -332,6 +335,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-collection_lists-90c10f16"
+            sandbox: true
           base_collections:
             - selection_type: "distribution_ids"
               identifiers:
@@ -392,6 +396,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-collection_lists-90c10f16"
+            sandbox: true
 
           idempotency_key: "$generate:uuid_v4#collection_lists_delete_list_delete_collection_list"
           context:

package/compliance/cache/{3.2.5 → 3.2.7}/specialisms/content-standards/index.yaml

@@ -157,6 +157,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-content_standards-5c6128f1"
+            sandbox: true
           scope:
             languages_any: ["en"]
             description: "Acme Outdoor creative quality standards"
@@ -222,6 +223,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-content_standards-5c6128f1"
+            sandbox: true
 
           context:
             correlation_id: "content_standards--list_content_standards"
@@ -263,6 +265,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-content_standards-5c6128f1"
+            sandbox: true
           standards_id: "$context.content_standards_id"
 
           context:
@@ -311,6 +314,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-content_standards-5c6128f1"
+            sandbox: true
           standards_id: "$context.content_standards_id"
           policies:
             - policy_id: no_violent_imagery
@@ -378,6 +382,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-content_standards-5c6128f1"
+            sandbox: true
           standards_id: "$context.content_standards_id"
           artifact:
             property_rid: "test-publisher.example"
@@ -431,6 +436,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-content_standards-5c6128f1"
+            sandbox: true
           standards_id: "$context.content_standards_id"
           artifact:
             property_rid: "test-publisher.example"
@@ -483,6 +489,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-content_standards-5c6128f1"
+            sandbox: true
           standards_id: "$context.content_standards_id"
           policies:
             - policy_id: no_violent_imagery
@@ -536,6 +543,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-content_standards-5c6128f1"
+            sandbox: true
           standards_id: "$context.content_standards_id"
           artifact:
             property_rid: "test-publisher.example"
@@ -598,6 +606,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-content_standards-5c6128f1"
+            sandbox: true
           standards_id: "$context.content_standards_id"
           records:
             - record_id: "delivery_display_001"

package/compliance/cache/{3.2.5 → 3.2.7}/specialisms/creative-generative/index.yaml

@@ -182,6 +182,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_generative-91bf69ab"
+            sandbox: true
           quality: "draft"
           include_preview: true
 
@@ -252,6 +253,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_generative-91bf69ab"
+            sandbox: true
           quality: "draft"
           include_preview: true
 
@@ -329,6 +331,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_generative-91bf69ab"
+            sandbox: true
           quality: "production"
 
           idempotency_key: "$generate:uuid_v4#creative_generative_multi_format_build_multi_format"
@@ -397,6 +400,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_generative-91bf69ab"
+            sandbox: true
           quality: "production"
           include_preview: true
 
@@ -459,6 +463,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_generative-91bf69ab"
+            sandbox: true
           catalogs:
             - catalog_id: "acme_generative_source"
               type: "product"
@@ -522,6 +527,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_generative-91bf69ab"
+            sandbox: true
           quality: "draft"
           include_preview: true
 
@@ -610,6 +616,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_generative-91bf69ab"
+            sandbox: true
           catalogs:
             - catalog_id: "creative_generative_substitution_probe_v1"
               type: "product"
@@ -693,6 +700,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_generative-91bf69ab"
+            sandbox: true
           quality: "draft"
           include_preview: true
 

package/compliance/cache/{3.2.5 → 3.2.7}/specialisms/creative-template/index.yaml

@@ -177,6 +177,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_template-1543a3c3"
+            sandbox: true
           request_type: "single"
           creative_manifest:
             format_kind: "image"
@@ -272,6 +273,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_template-1543a3c3"
+            sandbox: true
 
           idempotency_key: "$generate:uuid_v4#creative_template_build_build_creative"
           context:
@@ -338,6 +340,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_template-1543a3c3"
+            sandbox: true
 
           idempotency_key: "$generate:uuid_v4#creative_template_build_build_multi_format"
           context:
@@ -417,6 +420,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_template-1543a3c3"
+            sandbox: true
 
           idempotency_key: "$generate:uuid_v4#creative_template_audio_build_build_audio_creative"
           context:

package/compliance/cache/{3.2.5 → 3.2.7}/specialisms/creative-transformers/index.yaml

@@ -174,6 +174,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_transformers-b0b59ff3"
+            sandbox: true
           context:
             correlation_id: "creative_transformers--list_transformers"
         context_outputs:
@@ -233,6 +234,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_transformers-b0b59ff3"
+            sandbox: true
           context:
             correlation_id: "creative_transformers--list_transformers_expand"
         validations:
@@ -287,6 +289,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_transformers-b0b59ff3"
+            sandbox: true
           idempotency_key: "$generate:uuid_v4#creative_transformers_build_with_transformer_build_transformer"
           context:
             correlation_id: "creative_transformers--build_transformer"
@@ -346,6 +349,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_transformers-b0b59ff3"
+            sandbox: true
           idempotency_key: "$generate:uuid_v4#creative_transformers_variant_fanout_build_variants"
           context:
             correlation_id: "creative_transformers--build_variants"
@@ -406,6 +410,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_transformers-b0b59ff3"
+            sandbox: true
           idempotency_key: "$generate:uuid_v4#creative_transformers_refinement_lineage_refine_variant"
           context:
             correlation_id: "creative_transformers--refine_variant"
@@ -466,6 +471,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-creative_transformers-b0b59ff3"
+            sandbox: true
           idempotency_key: "$generate:uuid_v4#creative_transformers_config_strict_rejection_reject_out_of_range_config"
           context:
             correlation_id: "creative_transformers--reject_out_of_range_config"

package/compliance/cache/{3.2.5 → 3.2.7}/specialisms/governance-delivery-monitor/index.yaml

@@ -286,6 +286,7 @@ phases:
               operator: "pinnacle-agency.example"
               operator_unit:
                 id: "compliance-governance_delivery_monitor-5475949b"
+              sandbox: true
             ext:
               governance_policy_acknowledgements:
                 - "drift_reevaluation"
@@ -350,6 +351,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-governance_delivery_monitor-5475949b"
+            sandbox: true
           brand:
             domain: "acmeoutdoor.example"
           governance_context: "$context.governance_context"
@@ -483,6 +485,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-governance_delivery_monitor-5475949b"
+            sandbox: true
           media_buy_ids:
             - "$context.media_buy_id"
           include_package_daily_breakdown: true

package/compliance/cache/{3.2.5 → 3.2.7}/specialisms/governance-spend-authority/index.yaml

@@ -291,6 +291,7 @@ phases:
               operator: "pinnacle-agency.example"
               operator_unit:
                 id: "compliance-governance_spend_authority-6163432e"
+              sandbox: true
             brand:
               domain: "acmeoutdoor.example"
             total_budget:
@@ -374,6 +375,7 @@ phases:
               operator: "pinnacle-agency.example"
               operator_unit:
                 id: "compliance-governance_spend_authority-6163432e"
+              sandbox: true
             brand:
               domain: "acmeoutdoor.example"
             total_budget:
@@ -448,6 +450,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-governance_spend_authority-6163432e"
+            sandbox: true
           brand:
             domain: "acmeoutdoor.example"
           governance_context: "$context.governance_context"

package/compliance/cache/{3.2.5 → 3.2.7}/specialisms/property-lists/index.yaml

@@ -158,6 +158,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-property_lists-017bea48"
+            sandbox: true
           brand:
             domain: "acmeoutdoor.example"
           name: "Acme Outdoor approved properties"
@@ -222,6 +223,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-property_lists-017bea48"
+            sandbox: true
           name_contains: "Acme Outdoor"
 
           context:
@@ -265,6 +267,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-property_lists-017bea48"
+            sandbox: true
 
           context:
             correlation_id: "property_lists--get_property_list"
@@ -313,6 +316,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-property_lists-017bea48"
+            sandbox: true
           base_properties:
             - selection_type: "identifiers"
               identifiers:
@@ -371,6 +375,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-property_lists-017bea48"
+            sandbox: true
           list_id: "$context.property_list_id"
           records:
             - record_id: "delivery_outdoor_001"
@@ -434,6 +439,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-property_lists-017bea48"
+            sandbox: true
           list_id: "$context.property_list_id"
           records:
             - record_id: "delivery_outdoor_001"
@@ -480,6 +486,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-property_lists-017bea48"
+            sandbox: true
           list_id: "$context.property_list_id"
           records:
             - record_id: "delivery_random_001"
@@ -527,6 +534,7 @@ phases:
             operator: "pinnacle-agency.example"
             operator_unit:
               id: "compliance-property_lists-017bea48"
+            sandbox: true
 
           idempotency_key: "$generate:uuid_v4#property_lists_delete_list_delete_property_list"
           context: