@adcp/client 4.23.0 → 4.24.0

package/storyboards/media_buy_guaranteed_approval.yaml

@@ -16,7 +16,7 @@ narrative: |
 
   The buyer either polls get_media_buys or configures a push_notification_config webhook to
   receive a callback when the IO is signed. Once approved, the media buy transitions from
-  pending_approval to confirmed/active and the buyer can sync creatives and monitor delivery.
+  pending_approval to active and the buyer can sync creatives and monitor delivery.
 
   This storyboard isolates the guaranteed approval path — the async handshake between agent
   automation and human decision-making that makes guaranteed buys work in practice.
@@ -264,15 +264,15 @@ phases:
     narrative: |
       The human has reviewed the IO and signed it through the setup URL. The buyer
       polls get_media_buys again (or received a webhook notification) and sees that the
-      media buy has transitioned from pending_approval to confirmed or active. The buy
+      media buy has transitioned from pending_approval to active. The buy
       is now live.
 
     steps:
-      - id: get_media_buys_confirmed
-        title: "Check media buy status (confirmed/active)"
+      - id: get_media_buys_active
+        title: "Check media buy status (active)"
         narrative: |
           After the human signs the IO, the buyer checks the media buy status again.
-          Your platform returns confirmed or active, indicating the buy is approved
+          Your platform returns active, indicating the buy is approved
           and inventory is reserved.
         task: get_media_buys
         schema_ref: "media-buy/get-media-buys-request.json"
@@ -281,12 +281,12 @@ phases:
         comply_scenario: media_buy_lifecycle
         stateful: true
         expected: |
-          Return the media buy in confirmed or active status:
+          Return the media buy in active status:
           - media_buy_id: matches the buy created earlier
-          - status: confirmed or active (IO has been signed)
+          - status: active (IO has been signed)
           - confirmed_at: timestamp when the IO was signed
-          - packages: line items now confirmed with reserved inventory
-          - valid_actions: updated for confirmed state (creative sync, pause, etc.)
+          - packages: line items with reserved inventory
+          - valid_actions: updated for active state (creative sync, pause, etc.)
 
         sample_request:
           account:
@@ -301,15 +301,15 @@ phases:
             description: "Response matches get-media-buys-response.json schema"
           - check: field_present
             path: "media_buys[0].status"
-            description: "Media buy status is confirmed or active"
+            description: "Media buy status is active"
           - check: field_present
             path: "media_buys[0].confirmed_at"
-            description: "Confirmed buy includes a confirmed_at timestamp"
+            description: "Active buy includes a confirmed_at timestamp"
 
   - id: creative_sync
     title: "Creative sync"
     narrative: |
-      With the IO signed and the media buy confirmed, the buyer syncs creative assets
+      With the IO signed and the media buy active, the buyer syncs creative assets
       to your platform. Each package has creative format requirements that the buyer
       discovered during product discovery.
 
@@ -352,7 +352,7 @@ phases:
           - check: response_schema
             description: "Response matches sync-creatives-response.json schema"
           - check: field_present
-            path: "results[0].action"
+            path: "creatives[0].action"
             description: "Each creative has an action (created/updated)"
 
   - id: delivery_monitoring
@@ -394,5 +394,5 @@ phases:
           - check: response_schema
             description: "Response matches get-media-buy-delivery-response.json schema"
           - check: field_present
-            path: "media_buys"
+            path: "media_buy_deliveries"
             description: "Response contains media buy delivery data"

package/storyboards/media_buy_non_guaranteed.yaml

@@ -124,7 +124,7 @@ phases:
         expected: |
           Return the media buy in completed status:
           - media_buy_id: your platform's identifier
-          - status: confirmed or active (no async approval needed)
+          - status: active (no async approval needed)
           - confirmed_at: timestamp
           - packages: confirmed line items with bid prices acknowledged
           - valid_actions: pause, update_bid, get_delivery
@@ -285,5 +285,5 @@ phases:
           - check: response_schema
             description: "Response matches get-media-buy-delivery-response.json schema"
           - check: field_present
-            path: "media_buys"
+            path: "media_buy_deliveries"
             description: "Response contains media buy delivery data"

package/storyboards/media_buy_proposal_mode.yaml

@@ -197,7 +197,7 @@ phases:
       The buyer is satisfied with the refined proposal and accepts it by creating a
       media buy with the proposal_id. Instead of specifying individual packages, the
       buyer passes the proposal_id and total_budget. Your platform converts the proposal
-      into a confirmed media buy with the exact product selections and budget allocations
+      into an active media buy with the exact product selections and budget allocations
       from the proposal.
 
     steps:
@@ -217,9 +217,9 @@ phases:
         comply_scenario: create_media_buy
         stateful: true
         expected: |
-          Convert the proposal into a confirmed media buy:
+          Convert the proposal into an active media buy:
           - media_buy_id: your platform's identifier
-          - status: confirmed or active
+          - status: active
           - confirmed_at: timestamp
           - packages: line items derived from the proposal's budget allocations
           - proposal_id: echoed back to confirm which proposal was accepted
@@ -324,7 +324,7 @@ phases:
           - check: response_schema
             description: "Response matches sync-creatives-response.json schema"
           - check: field_present
-            path: "results[0].action"
+            path: "creatives[0].action"
             description: "Each creative has an action (created/updated)"
 
   - id: delivery
@@ -366,5 +366,5 @@ phases:
           - check: response_schema
             description: "Response matches get-media-buy-delivery-response.json schema"
           - check: field_present
-            path: "media_buys"
+            path: "media_buy_deliveries"
             description: "Response contains media buy delivery data"

package/storyboards/media_buy_seller.yaml

@@ -303,7 +303,7 @@ phases:
           - Proposal: buyer passes a proposal_id from get_products to execute a proposal
 
           The response status tells the buyer what happens next:
-          - completed: buy is confirmed and live
+          - completed: buy is active and live
           - working: your platform is processing (poll or wait for webhook)
           - submitted: long-running async — approval workflow, IO signing, etc.
           - input-required: need more information (budget clarification, approval)
@@ -318,8 +318,8 @@ phases:
 
           Synchronous (completed):
           - media_buy_id: your platform's identifier
-          - status: confirmed or pending_creatives
-          - packages: confirmed line items with pricing
+          - status: active or pending_creatives
+          - packages: line items with pricing
           - confirmed_at: timestamp
           - valid_actions: what the buyer can do next
 
@@ -368,7 +368,7 @@ phases:
         narrative: |
           If create_media_buy returned working or submitted, the buyer polls for status
           updates. Your platform returns the current state of the media buy — whether
-          it's still processing, awaiting approval, or confirmed.
+          it's still processing, awaiting approval, or active.
 
           This is also how the buyer checks for pending_approval status. If your platform
           requires IO signing or human authorization, the buy sits at pending_approval
@@ -383,13 +383,13 @@ phases:
         expected: |
           Return the current state of the media buy:
           - media_buy_id: matches what was returned from create_media_buy
-          - status: draft, pending_approval, confirmed, active, paused, completed, canceled
+          - status: pending_creatives, pending_start, active, paused, completed, rejected, canceled
           - packages: line items with current delivery status
           - valid_actions: what operations are available in this state
 
-          If pending_approval:
-          - Include setup URL where the human completes approval
-          - Include message explaining what's needed
+          If pending_creatives:
+          - Include message explaining what creatives are needed
+          - valid_actions should include sync_creatives
 
         sample_request:
           account:
@@ -495,7 +495,7 @@ phases:
           - check: response_schema
             description: "Response matches sync-creatives-response.json schema"
           - check: field_present
-            path: "results[0].action"
+            path: "creatives[0].action"
             description: "Each creative has an action (created/updated)"
 
   - id: delivery_monitoring
@@ -544,5 +544,5 @@ phases:
           - check: response_schema
             description: "Response matches get-media-buy-delivery-response.json schema"
           - check: field_present
-            path: "media_buys"
+            path: "media_buy_deliveries"
             description: "Response contains media buy delivery data"

package/storyboards/media_buy_state_machine.yaml

@@ -9,8 +9,8 @@ required_tools:
   - update_media_buy
 
 narrative: |
-  A media buy has a well-defined state machine: draft, pending_approval, confirmed, active,
-  paused, completed, canceled. Transitions between states must follow the spec — you cannot
+  A media buy has a well-defined state machine: pending_creatives, pending_start, active,
+  paused, completed, rejected, canceled. Transitions between states must follow the spec — you cannot
   resume a canceled buy or pause a completed one.
 
   This storyboard creates a media buy, walks it through pause/resume/cancel transitions, then
@@ -87,9 +87,9 @@ phases:
         comply_scenario: create_media_buy
         stateful: true
         expected: |
-          Return a confirmed media buy with:
+          Return an active media buy with:
           - media_buy_id
-          - status: confirmed or active
+          - status: active
 
         sample_request:
           brand:

package/storyboards/schema.yaml

@@ -13,7 +13,7 @@
 # id: string (unique identifier, e.g., "creative_template")
 # version: string (semver, e.g., "1.0.0")
 # title: string (human-readable title)
-# category: enum (capability_discovery | schema_validation | behavioral_analysis | error_compliance | creative_template | creative_ad_server | creative_sales_agent | creative_generative | creative_lifecycle | media_buy_seller | media_buy_guaranteed_approval | media_buy_non_guaranteed | media_buy_proposal_mode | media_buy_governance_escalation | media_buy_catalog_creative | media_buy_state_machine | campaign_governance_denied | campaign_governance_conditions | campaign_governance_delivery | signal_marketplace | signal_owned | social_platform | si_session | brand_rights | property_governance | content_standards)
+# category: enum (capability_discovery | schema_validation | behavioral_analysis | error_compliance | creative_template | creative_ad_server | creative_sales_agent | creative_generative | creative_lifecycle | media_buy_seller | media_buy_generative_seller | media_buy_guaranteed_approval | media_buy_non_guaranteed | media_buy_proposal_mode | media_buy_governance_escalation | media_buy_catalog_creative | media_buy_state_machine | campaign_governance_denied | campaign_governance_conditions | campaign_governance_delivery | signal_marketplace | signal_owned | social_platform | si_session | brand_rights | property_governance | content_standards | audience_sync)
 # summary: string (one-line description for listings)
 # narrative: string (paragraph explaining the overall flow)
 #
@@ -62,4 +62,5 @@
 #
 # check: string (what to validate: "response_schema", "field_present", "field_value", "status_code")
 # path: string (JSON path to the field, e.g., "formats[0].format_id")
+# value: any (expected value — string, number, or boolean; required when check is "field_value")
 # description: string (human-readable description of validation)

package/storyboards/signal_marketplace.yaml

@@ -173,6 +173,7 @@ phases:
         validations:
           - check: field_value
             path: "signals[0].signal_id.source"
+            value: "catalog"
             description: "Signal source is 'catalog' (verifiable via adagents.json)"
           - check: field_present
             path: "signals[0].signal_id.data_provider_domain"
@@ -228,6 +229,7 @@ phases:
             description: "Deployment includes type"
           - check: field_value
             path: "deployments[0].type"
+            value: "platform"
             description: "Deployment type is 'platform'"
 
   - id: agent_activation
@@ -281,4 +283,5 @@ phases:
             description: "Deployment includes activation key"
           - check: field_value
             path: "deployments[0].type"
+            value: "agent"
             description: "Deployment type is 'agent'"

package/storyboards/signal_owned.yaml

@@ -208,4 +208,5 @@ phases:
             description: "Deployment includes activation key"
           - check: field_value
             path: "deployments[0].type"
+            value: "agent"
             description: "Deployment type is 'agent'"

package/storyboards/test-kits/acme-outdoor.yaml

@@ -0,0 +1,118 @@
+# Acme Outdoor — Sample Advertiser Test Kit
+#
+# Provides the "ingredients" needed to test creative agent storyboards:
+# a brand identity, sample assets at common dimensions, and sample text.
+#
+# Acme Outdoor is a fictional outdoor gear brand from the AdCP character bible.
+# Use this test kit with any storyboard that requires an advertiser brand.
+
+id: acme_outdoor
+name: "Acme Outdoor"
+description: "Fictional outdoor gear brand for storyboard testing"
+
+brand:
+  house:
+    domain: "acme-outdoor.example.com"
+    name: "Acme Outdoor"
+  brand_id: "acme_outdoor"
+  names:
+    - en: "Acme Outdoor"
+  description: "Premium outdoor gear for every adventure. From trail to summit, we make gear that performs."
+  industry: "retail"
+  keller_type: "master"
+  logos:
+    - url: "https://test-assets.adcontextprotocol.org/acme-outdoor/logo-primary.png"
+      orientation: "horizontal"
+      background: "light-bg"
+      variant: "primary"
+      width: 400
+      height: 100
+    - url: "https://test-assets.adcontextprotocol.org/acme-outdoor/logo-icon.png"
+      orientation: "square"
+      background: "transparent-bg"
+      variant: "icon"
+      width: 200
+      height: 200
+  colors:
+    primary: "#1B5E20"
+    secondary: "#FF6F00"
+    accent: "#FDD835"
+    background: "#FAFAFA"
+    text: "#212121"
+  fonts:
+    heading:
+      family: "Montserrat"
+      weight: 700
+      url: "https://fonts.googleapis.com/css2?family=Montserrat:wght@700"
+    body:
+      family: "Open Sans"
+      weight: 400
+      url: "https://fonts.googleapis.com/css2?family=Open+Sans"
+  tone:
+    voice: "Confident and adventurous, but never pretentious. We talk to people who do things, not people who buy things."
+    attributes:
+      - "active"
+      - "direct"
+      - "warm"
+    dos:
+      - "Use action verbs"
+      - "Reference real outdoor activities"
+      - "Keep it short"
+    donts:
+      - "Use superlatives without evidence"
+      - "Talk down to the reader"
+      - "Use corporate jargon"
+
+# Sample assets at common ad dimensions.
+# These are placeholder URLs — in production, these would point to actual hosted test images.
+assets:
+  images:
+    - id: "hero_300x250"
+      url: "https://test-assets.adcontextprotocol.org/acme-outdoor/hero-300x250.jpg"
+      width: 300
+      height: 250
+      mime_type: "image/jpeg"
+      description: "Medium rectangle hero — hiker on mountain trail"
+
+    - id: "hero_728x90"
+      url: "https://test-assets.adcontextprotocol.org/acme-outdoor/hero-728x90.jpg"
+      width: 728
+      height: 90
+      mime_type: "image/jpeg"
+      description: "Leaderboard hero — panoramic mountain vista"
+
+    - id: "hero_320x50"
+      url: "https://test-assets.adcontextprotocol.org/acme-outdoor/hero-320x50.jpg"
+      width: 320
+      height: 50
+      mime_type: "image/jpeg"
+      description: "Mobile banner hero — trail gear close-up"
+
+    - id: "hero_160x600"
+      url: "https://test-assets.adcontextprotocol.org/acme-outdoor/hero-160x600.jpg"
+      width: 160
+      height: 600
+      mime_type: "image/jpeg"
+      description: "Wide skyscraper hero — vertical trail scene"
+
+    - id: "hero_master"
+      url: "https://test-assets.adcontextprotocol.org/acme-outdoor/hero-master.jpg"
+      width: 1200
+      height: 628
+      mime_type: "image/jpeg"
+      description: "Master hero image — high-res source for any size"
+
+  text:
+    headlines:
+      - "Summer Sale — 40% Off All Gear"
+      - "Built for the Trail"
+      - "Adventure Starts Here"
+    descriptions:
+      - "Premium outdoor gear tested on the world's toughest trails. Shop the summer collection."
+      - "From daypacks to expedition tents, gear that performs when it matters."
+    cta:
+      - "Shop Now"
+      - "Explore the Collection"
+      - "Find Your Gear"
+
+  click_url: "https://acme-outdoor.example.com/summer-sale"

package/storyboards/test-kits/nova-motors.yaml

@@ -0,0 +1,134 @@
+id: nova_motors
+name: "Nova Motors"
+description: |
+  Signal-focused test kit for the Nova Motors Volta EV launch campaign.
+  Provides sample signal definitions, pricing options, and destination
+  configurations for testing signal agent storyboards.
+
+campaign:
+  brand: "Nova Motors"
+  product: "Volta EV"
+  brief: "Reach in-market EV buyers with high purchase propensity, near dealerships, who haven't bought a Nova vehicle before."
+  budget: 250000
+  currency: "USD"
+  markets: ["US"]
+
+signals:
+  marketplace:
+    - signal_agent_segment_id: "trident_likely_ev_buyers"
+      name: "Likely EV Buyers"
+      data_provider_domain: "tridentauto.example"
+      signal_id: "likely_ev_buyers"
+      value_type: "binary"
+      signal_type: "marketplace"
+      coverage_percentage: 8
+      pricing:
+        - pricing_option_id: "po_trident_ev_cpm"
+          model: "cpm"
+          cpm: 3.50
+          currency: "USD"
+
+    - signal_agent_segment_id: "trident_purchase_propensity"
+      name: "Purchase Propensity"
+      data_provider_domain: "tridentauto.example"
+      signal_id: "purchase_propensity"
+      value_type: "numeric"
+      signal_type: "marketplace"
+      range:
+        min: 0
+        max: 1
+      coverage_percentage: 55
+      pricing:
+        - pricing_option_id: "po_trident_propensity_cpm"
+          model: "cpm"
+          cpm: 4.00
+          currency: "USD"
+
+    - signal_agent_segment_id: "meridian_competitor_visitors"
+      name: "Competitor Visitors"
+      data_provider_domain: "meridiangeo.example"
+      signal_id: "competitor_visitors"
+      value_type: "binary"
+      signal_type: "marketplace"
+      coverage_percentage: 6
+      pricing:
+        - pricing_option_id: "po_meridian_visitors_cpm"
+          model: "cpm"
+          cpm: 5.00
+          currency: "USD"
+
+    - signal_agent_segment_id: "shopgrid_new_to_brand"
+      name: "New to Brand"
+      data_provider_domain: "shopgrid.example"
+      signal_id: "new_to_brand"
+      value_type: "binary"
+      signal_type: "marketplace"
+      coverage_percentage: 25
+      pricing:
+        - pricing_option_id: "po_shopgrid_retail_cpm"
+          model: "cpm"
+          cpm: 3.50
+          currency: "USD"
+
+  owned:
+    - signal_agent_segment_id: "prism_high_ltv"
+      name: "High LTV Customers"
+      value_type: "binary"
+      signal_type: "owned"
+      coverage_percentage: 12
+      pricing:
+        - pricing_option_id: "po_prism_flat_monthly"
+          model: "flat_fee"
+          amount: 5000
+          period: "monthly"
+          currency: "USD"
+
+    - signal_agent_segment_id: "prism_cart_abandoner"
+      name: "Cart Abandoners"
+      value_type: "binary"
+      signal_type: "owned"
+      coverage_percentage: 18
+      pricing:
+        - pricing_option_id: "po_prism_abandoner_cpm"
+          model: "cpm"
+          cpm: 8.00
+          currency: "USD"
+
+    - signal_agent_segment_id: "prism_engagement_score"
+      name: "Engagement Score"
+      value_type: "numeric"
+      signal_type: "owned"
+      range:
+        min: 0
+        max: 100
+      coverage_percentage: 65
+      pricing:
+        - pricing_option_id: "po_prism_engagement_cpm"
+          model: "cpm"
+          cpm: 2.50
+          currency: "USD"
+
+    - signal_agent_segment_id: "prism_churn_risk"
+      name: "Churn Risk"
+      value_type: "categorical"
+      signal_type: "owned"
+      categories: ["low_risk", "medium_risk", "high_risk", "churned"]
+      coverage_percentage: 70
+      pricing:
+        - pricing_option_id: "po_prism_churn_pom"
+          model: "percent_of_media"
+          percent: 12
+          max_cpm: 3.00
+          currency: "USD"
+
+destinations:
+  platforms:
+    - type: "platform"
+      platform: "the-trade-desk"
+      account: "agency-123-ttd"
+    - type: "platform"
+      platform: "streamhaus"
+      account: "agency-ctv-seat-456"
+  agents:
+    - type: "agent"
+      agent_url: "https://wonderstruck.salesagents.example"