@adcp/client 4.22.0 → 4.23.0

package/storyboards/media_buy_catalog_creative.yaml

@@ -3,13 +3,11 @@ version: "1.0.0"
 title: "Catalog-driven creative and conversion tracking"
 category: media_buy_catalog_creative
 summary: "Seller that renders dynamic ads from product catalogs, tracks conversions, and optimizes delivery based on performance feedback."
-platform_types:
-  - retail_media
-
 track: media_buy
 required_tools:
+  - get_products
   - create_media_buy
-  - sync_creatives
+
 narrative: |
   You run a platform that supports catalog-driven advertising — think Snap Dynamic Ads,
   Meta Product Catalogs, or retail media product listing ads. The buyer pushes a product
@@ -112,6 +110,7 @@ phases:
         schema_ref: "creative/list-creative-formats-request.json"
         response_schema_ref: "creative/list-creative-formats-response.json"
         doc_ref: "/creative/task-reference/list_creative_formats"
+        comply_scenario: creative_lifecycle
         stateful: false
         expected: |
           Return creative formats that accept catalog assets. Look for formats with
@@ -219,6 +218,7 @@ phases:
         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: full_sales_flow
         stateful: false
         expected: |
           Return products that support catalog-driven creative. Products should indicate
@@ -255,6 +255,7 @@ phases:
         schema_ref: "media-buy/create-media-buy-request.json"
         response_schema_ref: "media-buy/create-media-buy-response.json"
         doc_ref: "/media-buy/task-reference/create_media_buy"
+        comply_scenario: create_media_buy
         stateful: true
         expected: |
           Create the media buy with catalog-driven packages. Return:
@@ -438,6 +439,7 @@ phases:
         schema_ref: "media-buy/get-media-buy-delivery-request.json"
         response_schema_ref: "media-buy/get-media-buy-delivery-response.json"
         doc_ref: "/media-buy/task-reference/get_media_buy_delivery"
+        comply_scenario: reporting_flow
         stateful: true
         expected: |
           Return delivery metrics including impressions, clicks, spend, and

package/storyboards/media_buy_governance_escalation.yaml

@@ -3,14 +3,11 @@ version: "1.0.0"
 title: "Governance denial and human escalation"
 category: media_buy_governance_escalation
 summary: "Buyer's governance agent denies a media buy that exceeds spending authority, escalates to a human who approves with conditions."
-platform_types:
-  - dsp
-  - ai_ad_network
-  - generative_dsp
-
 track: campaign_governance
 required_tools:
   - sync_plans
+  - check_governance
+
 narrative: |
   The buyer's governance agent denies a media buy because it exceeds the agent's spending
   authority. The governance check escalates to a human reviewer who approves with conditions.
@@ -137,6 +134,7 @@ phases:
         schema_ref: "governance/sync-plans-request.json"
         response_schema_ref: "governance/sync-plans-response.json"
         doc_ref: "/governance/campaign/tasks/sync_plans"
+        comply_scenario: campaign_governance
         stateful: true
         expected: |
           Acknowledge the governance plan:
@@ -179,6 +177,7 @@ phases:
         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: full_sales_flow
         stateful: false
         expected: |
           Return products matching the brief with pricing that totals above $20K:
@@ -224,6 +223,7 @@ phases:
         schema_ref: "governance/check-governance-request.json"
         response_schema_ref: "governance/check-governance-response.json"
         doc_ref: "/governance/campaign/tasks/check_governance"
+        comply_scenario: campaign_governance_denied
         stateful: true
         expected: |
           Return a denied governance decision:
@@ -282,6 +282,7 @@ phases:
         schema_ref: "governance/check-governance-request.json"
         response_schema_ref: "governance/check-governance-response.json"
         doc_ref: "/governance/campaign/tasks/check_governance"
+        comply_scenario: campaign_governance_conditions
         stateful: true
         expected: |
           Return an approved governance decision with conditions:
@@ -344,6 +345,7 @@ phases:
         schema_ref: "media-buy/create-media-buy-request.json"
         response_schema_ref: "media-buy/create-media-buy-response.json"
         doc_ref: "/media-buy/task-reference/create_media_buy"
+        comply_scenario: create_media_buy
         stateful: true
         expected: |
           Confirm the media buy with governance approval:
@@ -398,6 +400,7 @@ phases:
         schema_ref: "governance/report-plan-outcome-request.json"
         response_schema_ref: "governance/report-plan-outcome-response.json"
         doc_ref: "/governance/campaign/tasks/report_plan_outcome"
+        comply_scenario: campaign_governance
         stateful: true
         expected: |
           Acknowledge the outcome report:
@@ -443,6 +446,7 @@ phases:
         schema_ref: "governance/get-plan-audit-logs-request.json"
         response_schema_ref: "governance/get-plan-audit-logs-response.json"
         doc_ref: "/governance/campaign/tasks/get_plan_audit_logs"
+        comply_scenario: campaign_governance
         stateful: false
         expected: |
           Return the complete audit trail for the governance plan:

package/storyboards/media_buy_guaranteed_approval.yaml

@@ -3,15 +3,11 @@ version: "1.0.0"
 title: "Guaranteed media buy with human IO approval"
 category: media_buy_guaranteed_approval
 summary: "Seller agent that requires human-in-the-loop IO signing before guaranteed media buys go live."
-platform_types:
-  - display_ad_server
-  - video_ad_server
-  - audio_platform
-  - linear_tv_platform
-
 track: media_buy
 required_tools:
+  - get_products
   - create_media_buy
+
 narrative: |
   You run a sell-side platform that requires human approval before guaranteed media buys go
   live. When a buyer creates a guaranteed buy, your platform returns a submitted status with
@@ -114,6 +110,7 @@ phases:
         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: full_sales_flow
         stateful: false
         expected: |
           Return guaranteed products matching the brief. Each product should include:
@@ -172,6 +169,7 @@ phases:
         schema_ref: "media-buy/create-media-buy-request.json"
         response_schema_ref: "media-buy/create-media-buy-response.json"
         doc_ref: "/media-buy/task-reference/create_media_buy"
+        comply_scenario: create_media_buy
         stateful: true
         expected: |
           Return the media buy in submitted status:
@@ -229,6 +227,7 @@ phases:
         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"
+        comply_scenario: media_buy_lifecycle
         stateful: true
         expected: |
           Return the media buy in pending_approval status:
@@ -279,6 +278,7 @@ phases:
         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"
+        comply_scenario: media_buy_lifecycle
         stateful: true
         expected: |
           Return the media buy in confirmed or active status:
@@ -323,6 +323,7 @@ phases:
         schema_ref: "creative/sync-creatives-request.json"
         response_schema_ref: "creative/sync-creatives-response.json"
         doc_ref: "/creative/task-reference/sync_creatives"
+        comply_scenario: creative_sync
         stateful: true
         expected: |
           Accept and validate creatives:
@@ -351,7 +352,7 @@ phases:
           - check: response_schema
             description: "Response matches sync-creatives-response.json schema"
           - check: field_present
-            path: "creatives[0].action"
+            path: "results[0].action"
             description: "Each creative has an action (created/updated)"
 
   - id: delivery_monitoring
@@ -371,6 +372,7 @@ phases:
         schema_ref: "media-buy/get-media-buy-delivery-request.json"
         response_schema_ref: "media-buy/get-media-buy-delivery-response.json"
         doc_ref: "/media-buy/task-reference/get_media_buy_delivery"
+        comply_scenario: reporting_flow
         stateful: true
         expected: |
           Return delivery metrics for the guaranteed media buy:

package/storyboards/media_buy_non_guaranteed.yaml

@@ -3,15 +3,11 @@ version: "1.0.0"
 title: "Non-guaranteed auction-based media buy"
 category: media_buy_non_guaranteed
 summary: "Seller agent for auction-based, non-guaranteed buying where the buyer sets bid prices and budgets."
-platform_types:
-  - social_platform
-  - dsp
-  - pmax_platform
-  - generative_dsp
-
 track: media_buy
 required_tools:
+  - get_products
   - create_media_buy
+
 narrative: |
   You run a sell-side platform with auction-based inventory. Non-guaranteed buys don't
   require IOs or human approval — the buyer sets a bid price and budget, and your platform
@@ -66,6 +62,7 @@ phases:
         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: full_sales_flow
         stateful: false
         expected: |
           Return non-guaranteed products matching the brief. Each product should include:
@@ -122,6 +119,7 @@ phases:
         schema_ref: "media-buy/create-media-buy-request.json"
         response_schema_ref: "media-buy/create-media-buy-response.json"
         doc_ref: "/media-buy/task-reference/create_media_buy"
+        comply_scenario: create_media_buy
         stateful: true
         expected: |
           Return the media buy in completed status:
@@ -178,6 +176,7 @@ phases:
         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"
+        comply_scenario: media_buy_lifecycle
         stateful: true
         expected: |
           Return the media buy with pacing data:
@@ -219,6 +218,7 @@ phases:
         schema_ref: "media-buy/update-media-buy-request.json"
         response_schema_ref: "media-buy/update-media-buy-response.json"
         doc_ref: "/media-buy/task-reference/update_media_buy"
+        comply_scenario: media_buy_lifecycle
         stateful: true
         expected: |
           Apply the updates and return the modified media buy:
@@ -262,6 +262,7 @@ phases:
         schema_ref: "media-buy/get-media-buy-delivery-request.json"
         response_schema_ref: "media-buy/get-media-buy-delivery-response.json"
         doc_ref: "/media-buy/task-reference/get_media_buy_delivery"
+        comply_scenario: reporting_flow
         stateful: true
         expected: |
           Return delivery metrics for the non-guaranteed media buy:

package/storyboards/media_buy_proposal_mode.yaml

@@ -3,16 +3,11 @@ version: "1.0.0"
 title: "Media buy via proposal acceptance"
 category: media_buy_proposal_mode
 summary: "Seller agent that generates curated media plan proposals the buyer can review, refine, and accept."
-platform_types:
-  - dsp
-  - retail_media
-  - pmax_platform
-  - generative_dsp
-
 track: media_buy
 required_tools:
-  - create_media_buy
   - get_products
+  - create_media_buy
+
 narrative: |
   Your seller generates curated media plan proposals. The buyer sends a brief, your platform
   returns products alongside proposals — curated bundles with budget allocations and rationale
@@ -110,6 +105,7 @@ phases:
         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: full_sales_flow
         stateful: false
         expected: |
           Return products and proposals matching the brief:
@@ -164,6 +160,7 @@ phases:
         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: full_sales_flow
         stateful: true
         expected: |
           Return the refined proposal:
@@ -217,6 +214,7 @@ phases:
         schema_ref: "media-buy/create-media-buy-request.json"
         response_schema_ref: "media-buy/create-media-buy-response.json"
         doc_ref: "/media-buy/task-reference/create_media_buy"
+        comply_scenario: create_media_buy
         stateful: true
         expected: |
           Convert the proposal into a confirmed media buy:
@@ -260,6 +258,7 @@ phases:
         schema_ref: "creative/list-creative-formats-request.json"
         response_schema_ref: "creative/list-creative-formats-response.json"
         doc_ref: "/creative/task-reference/list_creative_formats"
+        comply_scenario: creative_lifecycle
         stateful: false
         expected: |
           Return creative formats your platform accepts. Each format should define:
@@ -286,6 +285,7 @@ phases:
         schema_ref: "creative/sync-creatives-request.json"
         response_schema_ref: "creative/sync-creatives-response.json"
         doc_ref: "/creative/task-reference/sync_creatives"
+        comply_scenario: creative_sync
         stateful: true
         expected: |
           Accept and validate creatives:
@@ -324,7 +324,7 @@ phases:
           - check: response_schema
             description: "Response matches sync-creatives-response.json schema"
           - check: field_present
-            path: "creatives[0].action"
+            path: "results[0].action"
             description: "Each creative has an action (created/updated)"
 
   - id: delivery
@@ -344,6 +344,7 @@ phases:
         schema_ref: "media-buy/get-media-buy-delivery-request.json"
         response_schema_ref: "media-buy/get-media-buy-delivery-response.json"
         doc_ref: "/media-buy/task-reference/get_media_buy_delivery"
+        comply_scenario: reporting_flow
         stateful: true
         expected: |
           Return delivery metrics for the media buy: