@adcp/sdk 9.6.1 → 9.7.0

package/compliance/cache/3.1.1/universal/get-products-pagination-integrity.yaml

@@ -0,0 +1,290 @@
+id: get_products_pagination_integrity
+version: "1.0.0"
+title: "get_products wholesale pagination cursor integrity"
+category: schema_validation
+summary: "Validates get_products wholesale-mode pagination by walking a seeded product feed from continuation to terminal, while documenting that brief/refine pagination caps returned products in curated results."
+track: media_buy
+requires_capability:
+  path: media_buy.buying_modes
+  contains: "wholesale"
+
+required_tools:
+  - get_products
+
+requires:
+  - controller
+
+narrative: |
+  `get_products` accepts the standard cursor pagination envelope in all
+  buying modes, but those modes do not mean the same thing. In `brief` mode,
+  pagination bounds the seller's curated answer to the brief. In `refine`
+  mode, pagination bounds the refined result set implied by `refine[]` and
+  filters. Neither mode turns the result into an exhaustive catalog feed.
+
+  `wholesale` mode is the catalog-feed surface. This storyboard seeds two
+  products that share a unique compliance-test format, queries wholesale mode
+  with that format filter and `max_results: 1`, then follows the returned
+  cursor. Page 1 MUST be non-terminal (`has_more=true` with a cursor) and
+  capped to one row. Page 2 MUST be terminal (`has_more=false` with no stale
+  cursor) because the other seeded product is the only remaining item in the
+  filtered feed.
+
+  This storyboard grades the deterministic wholesale feed behavior only.
+  `brief` and `refine` calls may legitimately return async Submitted
+  envelopes when curation requires more time, so this universal runtime check
+  does not force those modes through a synchronous product-response arm just
+  to observe a cap. Their pagination semantics remain defined by the
+  get_products request/response schemas and task reference: pagination bounds
+  the curated/refined products but does not create an exhaustive catalog walk.
+
+agent:
+  interaction_model: media_buy_seller
+  capabilities:
+    - sells_media
+    - exposes_wholesale_feed
+  examples:
+    - "Any media-buy seller that exposes get_products with compliance-test seeding"
+
+caller:
+  role: buyer_agent
+  example: "Compliance test harness"
+
+prerequisites:
+  description: |
+    The runner seeds two products under a unique format identifier so
+    wholesale pagination can be exercised against a deterministic filtered
+    feed.
+  test_kit: "test-kits/acme-outdoor.yaml"
+  controller_seeding: true
+
+fixtures:
+  products:
+    - product_id: "get_products_pagination_product_1"
+      name: "Get Products Pagination Test Product 1"
+      description: "Compliance fixture for get_products pagination integrity."
+      delivery_type: "non_guaranteed"
+      channels: ["display"]
+      publisher_properties:
+        - publisher_domain: "acmeoutdoor.example"
+      format_ids:
+        - agent_url: "https://compliance.adcontextprotocol.org"
+          id: "get_products_pagination_integrity_display"
+    - product_id: "get_products_pagination_product_2"
+      name: "Get Products Pagination Test Product 2"
+      description: "Compliance fixture for get_products pagination integrity."
+      delivery_type: "non_guaranteed"
+      channels: ["display"]
+      publisher_properties:
+        - publisher_domain: "acmeoutdoor.example"
+      format_ids:
+        - agent_url: "https://compliance.adcontextprotocol.org"
+          id: "get_products_pagination_integrity_display"
+  pricing_options:
+    - product_id: "get_products_pagination_product_1"
+      pricing_option_id: "get_products_pagination_pricing_1"
+      pricing_model: "cpm"
+      currency: "USD"
+      floor_price: 1.0
+    - product_id: "get_products_pagination_product_2"
+      pricing_option_id: "get_products_pagination_pricing_2"
+      pricing_model: "cpm"
+      currency: "USD"
+      floor_price: 1.0
+
+phases:
+  - id: capability_discovery
+    title: "Capability discovery"
+    narrative: |
+      Confirm the agent supports media buying before exercising get_products.
+    steps:
+      - id: get_capabilities
+        title: "Check agent capabilities"
+        narrative: |
+          Verify that the agent declares media_buy in supported_protocols
+          before driving get_products pagination.
+        task: get_adcp_capabilities
+        schema_ref: "protocol/get-adcp-capabilities-request.json"
+        response_schema_ref: "protocol/get-adcp-capabilities-response.json"
+        doc_ref: "/protocol/get_adcp_capabilities"
+        comply_scenario: capability_discovery
+        stateful: false
+        expected: |
+          Return capabilities declaring media_buy in supported_protocols.
+
+        sample_request:
+          context:
+            correlation_id: "get_products_pagination_integrity--get_capabilities"
+        validations:
+          - check: response_schema
+            description: "Response matches get-adcp-capabilities-response.json schema"
+          - check: field_present
+            path: "supported_protocols"
+            description: "Agent declares supported protocols"
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "get_products_pagination_integrity--get_capabilities"
+            description: "Context correlation_id returned unchanged"
+
+  - id: wholesale_pagination_walk
+    title: "Walk wholesale pages"
+    narrative: |
+      With two products seeded under the unique test format and
+      `max_results: 1`, the first wholesale call MUST return a continuation
+      page. The runner captures the cursor and follows it using the same
+      result-defining request context, adding only the cursor.
+
+    steps:
+      - id: wholesale_first_page
+        title: "Request the first wholesale page"
+        narrative: |
+          The buyer asks for up to one wholesale-feed product matching the
+          unique test format. Two fixtures match, so the response must be
+          non-terminal and capped to one product.
+        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: get_products_pagination_integrity
+        stateful: true
+        context_outputs:
+          - name: products_next_cursor
+            path: "pagination.cursor"
+        expected: |
+          Return one product matching the requested format with:
+          - pagination.has_more = true
+          - pagination.cursor present
+
+        sample_request:
+          buying_mode: "wholesale"
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          filters:
+            format_ids:
+              - agent_url: "https://compliance.adcontextprotocol.org"
+                id: "get_products_pagination_integrity_display"
+          pagination:
+            max_results: 1
+
+          context:
+            correlation_id: "get_products_pagination_integrity--wholesale_first_page"
+        validations:
+          - check: response_schema
+            description: "Response matches get-products-response.json schema"
+          - check: field_present
+            path: "products[0].product_id"
+            description: "A seeded product is present"
+          - check: field_value
+            path: "products[0].product_id"
+            allowed_values:
+              - "get_products_pagination_product_1"
+              - "get_products_pagination_product_2"
+            description: "The returned product is one of the seeded pagination fixtures"
+          - check: field_contains
+            path: "products[0].format_ids[*]"
+            value:
+              agent_url: "https://compliance.adcontextprotocol.org"
+              id: "get_products_pagination_integrity_display"
+            description: "The returned product satisfies the requested test format filter"
+          - check: field_absent
+            path: "products[1].product_id"
+            description: "max_results=1 caps the first page to one product"
+          - check: field_value
+            path: "pagination.has_more"
+            value: true
+            description: "Two fixtures seeded with max_results=1 means the first page is non-terminal"
+          - check: field_present
+            path: "pagination.cursor"
+            description: "has_more=true requires a cursor so the caller can continue"
+          - check: field_value_or_absent
+            path: "pagination.total_count"
+            allowed_values: [2]
+            description: "If volunteered, total_count must equal the seeded filtered set size"
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "get_products_pagination_integrity--wholesale_first_page"
+            description: "Context correlation_id returned unchanged"
+
+      - id: wholesale_terminal_page
+        title: "Follow the wholesale cursor"
+        narrative: |
+          The buyer follows the captured cursor with the same result-defining
+          wholesale request context. One seeded product remains, so the
+          response must be terminal and must not carry a stale cursor.
+        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: get_products_pagination_integrity
+        stateful: true
+        expected: |
+          Return the remaining product with:
+          - pagination.has_more = false
+          - pagination.cursor absent or null
+
+        sample_request:
+          buying_mode: "wholesale"
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          filters:
+            format_ids:
+              - agent_url: "https://compliance.adcontextprotocol.org"
+                id: "get_products_pagination_integrity_display"
+          pagination:
+            cursor: "$context.products_next_cursor"
+            max_results: 1
+
+          context:
+            correlation_id: "get_products_pagination_integrity--wholesale_terminal_page"
+        validations:
+          - check: response_schema
+            description: "Response matches get-products-response.json schema"
+          - check: field_present
+            path: "products[0].product_id"
+            description: "The remaining seeded product is present"
+          - check: field_value
+            path: "products[0].product_id"
+            allowed_values:
+              - "get_products_pagination_product_1"
+              - "get_products_pagination_product_2"
+            description: "The terminal-page product is one of the seeded pagination fixtures"
+          - check: field_contains
+            path: "products[0].format_ids[*]"
+            value:
+              agent_url: "https://compliance.adcontextprotocol.org"
+              id: "get_products_pagination_integrity_display"
+            description: "The terminal-page product satisfies the requested test format filter"
+          - check: field_absent
+            path: "products[1].product_id"
+            description: "Only one seeded product remains after the first page"
+          - check: field_value
+            path: "pagination.has_more"
+            value: false
+            description: "The seeded filtered set is exhausted after following the cursor"
+          - check: field_value_or_absent
+            path: "pagination.cursor"
+            allowed_values: [null]
+            description: "Terminal page must omit cursor; null is accepted for clients that explicitly clear it"
+          - check: field_value_or_absent
+            path: "pagination.total_count"
+            allowed_values: [2]
+            description: "If volunteered, total_count must stay stable across pages"
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "get_products_pagination_integrity--wholesale_terminal_page"
+            description: "Context correlation_id returned unchanged"

package/compliance/cache/{3.1.0 → 3.1.1}/universal/storyboard-schema.yaml

@@ -140,7 +140,7 @@
 #   different topologies.)
 #
 # requires: string[] (optional — storyboard-level runtime requirement gate.
-#   Known values: controller | seeded_state | real_wire | webhook_receiver (forward-compat:
+#   Known values: controller | seeded_state | real_wire | 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.
@@ -227,6 +227,19 @@
 #                    as webhook-emission; runners may also infer it from
 #                    webhook URL substitutions in sample_request payloads.
 #
+#     multi_agent  — gate on the runner being configured with every logical
+#                    agent key required by this storyboard's `default_agent`
+#                    and step-level `agent:` declarations. Available when the
+#                    runner receives an `agents` map containing at least two
+#                    logical agents and all authored route keys used by the
+#                    storyboard resolve against that map. When unmet, the
+#                    runner MUST emit skip_result.reason: requirement_unmet
+#                    with detail naming "multi_agent" rather than failing a
+#                    routed step with default_agent_unresolved or unrouted_step.
+#                    Storyboards SHOULD declare this when the scenario's setup
+#                    and execution require distinct logical tenants, such as a
+#                    seller agent plus a governance agent.
+#
 #   Forward compatibility: runners encountering a requires value they do not
 #   recognize MUST emit skip_result.reason: requirement_unmet (not fail-load)
 #   and MUST name the unrecognized value in skip_result.detail so dashboards

package/compliance/cache/{3.1.0/protocols → 3.1.1.previous/domains}/media-buy/index.yaml

@@ -64,29 +64,37 @@ prerequisites:
   test_kit: "test-kits/acme-outdoor.yaml"
   controller_seeding: true
 
+# The base media-buy lifecycle exercises the universal NON-GUARANTEED
+# (auction-based) path so that every media-buy seller can run it — including
+# sellers that declare only `specialisms: ["sales-non-guaranteed"]`. A
+# non-guaranteed-only seller correctly rejects a guaranteed buy with
+# DELIVERY_MODE_NOT_SUPPORTED, so guaranteed-only fixtures here failed the whole
+# base flow (create_buy + the dependent steps) for that entire seller class. The
+# guaranteed lifecycle (human IO approval, proposal_finalize) is covered by the
+# `sales-guaranteed` specialism bundle, which carries its own guaranteed fixtures.
 fixtures:
   products:
     - product_id: "sports_preroll_q2"
-      delivery_type: "guaranteed"
+      delivery_type: "non_guaranteed"
       channels: ["video"]
       format_ids:
         - id: "video_30s"
     - product_id: "lifestyle_display_q2"
-      delivery_type: "guaranteed"
+      delivery_type: "non_guaranteed"
       channels: ["display"]
       format_ids:
         - id: "display_300x250"
   pricing_options:
     - product_id: "sports_preroll_q2"
-      pricing_option_id: "cpm_guaranteed"
+      pricing_option_id: "cpm_non_guaranteed"
       pricing_model: "cpm"
       currency: "USD"
-      fixed_price: 22.0
+      floor_price: 22.0
     - product_id: "lifestyle_display_q2"
       pricing_option_id: "cpm_standard"
       pricing_model: "cpm"
       currency: "USD"
-      fixed_price: 8.0
+      floor_price: 8.0
 
 phases:
   - id: capability_discovery
@@ -485,7 +493,7 @@ phases:
           packages:
             - product_id: "sports_preroll_q2"
               budget: 25000
-              pricing_option_id: "cpm_guaranteed"
+              pricing_option_id: "cpm_non_guaranteed"
               creative_assignments:
                 - creative_id: "video_30s_trail_pro"
             - product_id: "lifestyle_display_q2"

package/compliance/cache/{3.1.0 → 3.1.1.previous}/domains/media-buy/scenarios/create_media_buy_async.yaml

@@ -125,6 +125,9 @@ phases:
 
         sample_request:
           account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
             sandbox: true
           scenario: "force_create_media_buy_arm"
           params:

package/compliance/cache/{3.1.0 → 3.1.1.previous}/domains/media-buy/scenarios/dependency_impairment.yaml

@@ -9,9 +9,24 @@ required_tools:
   - create_media_buy
   - get_media_buys
   - sync_creatives
+  - list_creatives
   - update_media_buy
   - comply_test_controller
 
+# Capability gate: this scenario grades the snapshot-coherence surface, so it
+# runs only for sellers that declare media_buy.propagation_surfaces including
+# "snapshot". Webhook-only or out_of_band sellers grade not_applicable instead
+# of false-failing on a contract that does not apply to them — the opt-out the
+# propagation_surfaces schema already documents (get-adcp-capabilities-response.json)
+# but that was never wired into this scenario. Requires the `contains:` matcher
+# (@adcp/sdk >= 7.70). Sellers that OMIT propagation_surfaces inherit the
+# ["snapshot"] default and are graded here only on @adcp/sdk >= 9.2.0, which
+# materializes capability-gate schema defaults; earlier runners skip them as
+# not_applicable (adcp-client#2278).
+requires_capability:
+  path: media_buy.propagation_surfaces
+  contains: "snapshot"
+
 narrative: |
   Per the dependency-impairment surface ([adcp#2855](https://github.com/adcontextprotocol/adcp/issues/2855)
   and `core/impairment.json`), sellers MUST propagate resource-state transitions
@@ -417,6 +432,48 @@ phases:
       invariant grades the cross-resource match.
 
     steps:
+      - id: reread_creative_rejected
+        title: "Re-read the creative — runner observes rejected (closes impairment.coherence)"
+        narrative: |
+          The impairment.coherence invariant ledgers each resource's last status
+          OBSERVED ON THE WIRE (sync_creatives / list_creatives), not the
+          comply_test_controller force directive (the runner has no observation
+          hook for the forced transition). Without this re-read the creative's
+          last observed status stays its pre-rejection value (e.g. pending_review
+          from the sync step), so the next get_media_buys — which correctly
+          reports health: impaired — trips coherence because impairments[]
+          references a creative the ledger still considers online. This re-read
+          surfaces the rejected status so the ledger and the buy agree.
+        task: list_creatives
+        schema_ref: "creative/list-creatives-request.json"
+        response_schema_ref: "creative/list-creatives-response.json"
+        doc_ref: "/creative/task-reference/list_creatives"
+        comply_scenario: creative_library
+        stateful: true
+        expected: |
+          The rejected creative is returned with status: rejected.
+        sample_request:
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          filters:
+            creative_ids:
+              - "acme_dep_banner_001"
+          context:
+            correlation_id: "dependency_impairment--reread_creative_rejected"
+        validations:
+          - check: response_schema
+            description: "Response matches list-creatives-response.json schema"
+          - check: field_value
+            path: "creatives[0].creative_id"
+            value: "acme_dep_banner_001"
+            description: "Filter returned the rejected creative specifically — the status assertion below is grounded on this creative, not another library entry"
+          - check: field_value
+            path: "creatives[0].status"
+            value: "rejected"
+            description: "Creative observed as rejected on the wire — closes the impairment.coherence ledger for the impaired read that follows"
+
       - id: get_buy_impaired
         title: "Read the buy — health: impaired, impairment entry present"
         task: get_media_buys

package/compliance/cache/{3.1.0 → 3.1.1.previous}/domains/media-buy/scenarios/dependency_impairment_cardinality.yaml

@@ -9,9 +9,24 @@ required_tools:
   - create_media_buy
   - get_media_buys
   - sync_creatives
+  - list_creatives
   - update_media_buy
   - comply_test_controller
 
+# Capability gate: this scenario grades the snapshot-coherence surface, so it
+# runs only for sellers that declare media_buy.propagation_surfaces including
+# "snapshot". Webhook-only or out_of_band sellers grade not_applicable instead
+# of false-failing on a contract that does not apply to them — the opt-out the
+# propagation_surfaces schema already documents (get-adcp-capabilities-response.json)
+# but that was never wired into this scenario. Requires the `contains:` matcher
+# (@adcp/sdk >= 7.70). Sellers that OMIT propagation_surfaces inherit the
+# ["snapshot"] default and are graded here only on @adcp/sdk >= 9.2.0, which
+# materializes capability-gate schema defaults; earlier runners skip them as
+# not_applicable (adcp-client#2278).
+requires_capability:
+  path: media_buy.propagation_surfaces
+  contains: "snapshot"
+
 narrative: |
   The base dependency_impairment scenario tests forward + inverse + health-iff
   with one creative on one package — a malicious or buggy seller can pass the
@@ -417,6 +432,48 @@ phases:
             allowed_values: [true]
             description: "Controller acknowledged the rejection directive"
 
+      - id: reread_a_rejected
+        title: "Re-read creative A — runner observes rejected"
+        narrative: |
+          The impairment.coherence invariant ledgers each resource's last status
+          OBSERVED ON THE WIRE (sync_creatives / list_creatives), not the
+          comply_test_controller force directive (the runner has no observation
+          hook for the forced transition). Without this re-read the creative's
+          last observed status stays its pre-rejection value (e.g. pending_review
+          from the sync step), so the next get_media_buys — which correctly
+          reports health: impaired — trips coherence because impairments[]
+          references a creative the ledger still considers online. This re-read
+          surfaces the rejected status so the ledger and the buy agree.
+        task: list_creatives
+        schema_ref: "creative/list-creatives-request.json"
+        response_schema_ref: "creative/list-creatives-response.json"
+        doc_ref: "/creative/task-reference/list_creatives"
+        comply_scenario: creative_library
+        stateful: true
+        expected: |
+          The rejected creative is returned with status: rejected.
+        sample_request:
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          filters:
+            creative_ids:
+              - "acme_card_banner_a"
+          context:
+            correlation_id: "dependency_impairment_cardinality--reread_a_rejected"
+        validations:
+          - check: response_schema
+            description: "Response matches list-creatives-response.json schema"
+          - check: field_value
+            path: "creatives[0].creative_id"
+            value: "acme_card_banner_a"
+            description: "Filter returned creative A specifically — proves the rejected status below is A's, not creative B (also rejected by the cardinality-2 point)"
+          - check: field_value
+            path: "creatives[0].status"
+            value: "rejected"
+            description: "Creative observed as rejected on the wire — closes the impairment.coherence ledger for the impaired read that follows"
+
       - id: verify_cardinality_one
         title: "Read the buy — exactly one impairment, scoped to package_a"
         task: get_media_buys
@@ -504,6 +561,48 @@ phases:
             allowed_values: [true]
             description: "Controller acknowledged the rejection directive"
 
+      - id: reread_b_rejected
+        title: "Re-read creative B — runner observes rejected"
+        narrative: |
+          The impairment.coherence invariant ledgers each resource's last status
+          OBSERVED ON THE WIRE (sync_creatives / list_creatives), not the
+          comply_test_controller force directive (the runner has no observation
+          hook for the forced transition). Without this re-read the creative's
+          last observed status stays its pre-rejection value (e.g. pending_review
+          from the sync step), so the next get_media_buys — which correctly
+          reports health: impaired — trips coherence because impairments[]
+          references a creative the ledger still considers online. This re-read
+          surfaces the rejected status so the ledger and the buy agree.
+        task: list_creatives
+        schema_ref: "creative/list-creatives-request.json"
+        response_schema_ref: "creative/list-creatives-response.json"
+        doc_ref: "/creative/task-reference/list_creatives"
+        comply_scenario: creative_library
+        stateful: true
+        expected: |
+          The rejected creative is returned with status: rejected.
+        sample_request:
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          filters:
+            creative_ids:
+              - "acme_card_banner_b"
+          context:
+            correlation_id: "dependency_impairment_cardinality--reread_b_rejected"
+        validations:
+          - check: response_schema
+            description: "Response matches list-creatives-response.json schema"
+          - check: field_value
+            path: "creatives[0].creative_id"
+            value: "acme_card_banner_b"
+            description: "Filter returned creative B specifically — proves the rejected status below is B's, not creative A (also rejected at this point)"
+          - check: field_value
+            path: "creatives[0].status"
+            value: "rejected"
+            description: "Creative observed as rejected on the wire — closes the impairment.coherence ledger for the impaired read that follows"
+
       - id: verify_cardinality_two
         title: "Read the buy — exactly two impairments, one per creative"
         task: get_media_buys

package/compliance/cache/{3.1.0.previous → 3.1.1.previous}/domains/media-buy/scenarios/governance_denied.yaml

@@ -4,11 +4,23 @@ title: "Seller rejects buy when governance denies"
 category: media_buy_seller
 summary: "Verifies that the seller rejects a media buy and propagates the denial when governance denies the transaction."
 track: media_buy
+requires:
+  - multi_agent
+default_agent: sales
 required_tools:
   - sync_governance
   - get_products
   - create_media_buy
 
+# Capability gate: this scenario asserts the seller produces GOVERNANCE_DENIED
+# after consulting a registered governance agent, so it runs only for sellers
+# that declare media_buy.governance_aware: true. Sellers without outbound
+# governance consultation grade not_applicable rather than false-failing on a
+# denial they have no mechanism to produce.
+requires_capability:
+  path: media_buy.governance_aware
+  equals: true
+
 narrative: |
   This is a multi-agent test. The test harness sets up a governance plan on a governance
   agent with a strict $10K budget, then registers that agent with the seller. The buyer
@@ -18,6 +30,13 @@ narrative: |
   requested budget exceeds the plan total. The seller must reject the buy and propagate
   the denial back to the buyer.
 
+  This scenario requires a runner that can route calls to at least two logical
+  agents: `sales` for the seller under test and `governance` for the governance
+  plan setup. Single-agent runners should only include this storyboard when the
+  endpoint under test deliberately combines seller and governance behavior in
+  one tenant; otherwise it belongs in the governance-aware-seller multi-agent
+  suite.
+
   By default, the governance agent is the training agent at test-agent.adcontextprotocol.org.
   Override by supplying a different `governance_agent_url` in the run's initial context
   (e.g., via `--context` on `adcp storyboard run` once the CLI supports it).
@@ -39,7 +58,9 @@ caller:
 
 prerequisites:
   description: |
-    A governance agent that supports sync_plans and check_governance.
+    A multi-agent runner with `sales` and `governance` agents. The governance
+    agent supports sync_plans and check_governance; the sales agent supports
+    sync_governance and create_media_buy.
   test_kit: "test-kits/acme-outdoor.yaml"
 
 phases:
@@ -53,6 +74,7 @@ phases:
     steps:
       - id: sync_plans
         title: "Create strict governance plan"
+        agent: governance
         task: sync_plans
         schema_ref: "governance/sync-plans-request.json"
         response_schema_ref: "governance/sync-plans-response.json"
@@ -84,6 +106,7 @@ phases:
     steps:
       - id: sync_accounts
         title: "Establish account with seller"
+        agent: sales
         task: sync_accounts
         schema_ref: "account/sync-accounts-request.json"
         response_schema_ref: "account/sync-accounts-response.json"
@@ -108,6 +131,7 @@ phases:
 
       - id: sync_governance
         title: "Register governance agent with seller"
+        agent: sales
         task: sync_governance
         schema_ref: "account/sync-governance-request.json"
         response_schema_ref: "account/sync-governance-response.json"
@@ -136,6 +160,7 @@ phases:
     steps:
       - id: get_products_brief
         title: "Discover products"
+        agent: sales
         task: get_products
         schema_ref: "media-buy/get-products-request.json"
         response_schema_ref: "media-buy/get-products-response.json"
@@ -169,6 +194,7 @@ phases:
 
       - id: create_media_buy_denied
         title: "Create buy (governance denies — should fail)"
+        agent: sales
         task: create_media_buy
         schema_ref: "media-buy/create-media-buy-request.json"
         response_schema_ref: "media-buy/create-media-buy-response.json"