@adcp/sdk 16.0.0-beta.5 → 16.0.0-beta.7

package/compliance/cache/3.1.24/domains/media-buy/scenarios/inline_creatives_without_sync.yaml

@@ -1,556 +0,0 @@
-id: media_buy_seller/inline_creatives_without_sync
-version: "1.0.0"
-title: "Inline media-buy creatives without sync_creatives"
-category: media_buy_seller
-summary: "Verifies that a seller advertising inline_creative_management accepts package creatives on create_media_buy and update_media_buy without requiring the Creative Protocol or sync_creatives."
-track: media_buy
-
-# Gate: scenario runs only when the seller declares inline creative handling on
-# the media-buy feature surface. Sellers that do not advertise the flag grade
-# not_applicable. The scenario intentionally does not call sync_creatives; that
-# keeps inline-only media-buy sellers from being forced into the creative
-# library surface.
-requires_capability:
-  path: media_buy.features.inline_creative_management
-  equals: true
-
-required_tools:
-  - get_products
-  - create_media_buy
-  - update_media_buy
-  - get_media_buys
-
-narrative: |
-  Some sales agents do not expose the Creative Protocol or a reusable creative
-  library. They still accept creative bodies inline on media-buy operations. For
-  those sellers, the buyer should not call sync_creatives; it should put
-  CreativeAsset objects in packages[].creatives on create_media_buy and
-  update_media_buy.
-
-  This scenario walks that path end-to-end:
-
-  1. Discover that inline_creative_management is true.
-  2. Create a media buy with packages[].creatives populated.
-  3. Replace the package's inline creative through update_media_buy.
-  4. Read the media buy back and confirm the replacement approval state is visible.
-
-  The scenario exercises both product format representations when the seller
-  dual-emits them. The first path uses the 3.1+ format_options[] path with a
-  product-local format_option_ref; the second uses the legacy format_ids[] path.
-  Each path creates its own media buy so the readback checks prove both
-  replacements persisted independently.
-
-agent:
-  interaction_model: media_buy_seller
-  capabilities:
-    - sells_media
-    - accepts_inline_creatives
-  examples:
-    - "Media-buy sellers that attach creatives directly to buys"
-
-caller:
-  role: buyer_agent
-  example: "Pinnacle Agency (buyer)"
-
-prerequisites:
-  description: |
-    Seller advertises media_buy.features.inline_creative_management: true and
-    accepts package-scoped CreativeAsset objects on create_media_buy and
-    update_media_buy. The seller does not need to implement sync_creatives.
-  test_kit: "test-kits/acme-outdoor.yaml"
-
-phases:
-  - id: capability_discovery
-    title: "Discover inline creative support"
-    narrative: |
-      The buyer confirms the seller accepts inline package creatives before
-      exercising either accepted product-format path.
-
-    steps:
-      - id: get_capabilities
-        title: "Check inline creative feature"
-        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 support and
-          media_buy.features.inline_creative_management: true.
-        sample_request:
-          context:
-            correlation_id: "inline_creatives_without_sync--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_value
-            path: "media_buy.features.inline_creative_management"
-            value: true
-            description: "Seller advertises inline creative handling on media-buy operations"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "inline_creatives_without_sync--get_capabilities"
-            description: "Context correlation_id returned unchanged"
-
-  - id: canonical_format_inline_path
-    title: "Inline creative path using format_options"
-    narrative: |
-      A 3.1+ seller may publish products through format_options[]. This path
-      selects the product's format option with format_option_refs[] and submits
-      the inline creative with the matching canonical format_kind.
-
-    steps:
-      - id: get_products_canonical_format
-        title: "Discover a product with format_options"
-        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: full_sales_flow
-        stateful: false
-        expected: |
-          Return at least one fixed-price product with a pricing option and a
-          format_options[] declaration that can be used by the inline CreativeAsset.
-        sample_request:
-          buying_mode: "brief"
-          brief: "Display inventory on outdoor lifestyle content. Q3 flight with buyer-supplied inline creative."
-          filters:
-            is_fixed_price: true
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          context:
-            correlation_id: "inline_creatives_without_sync--get_products_canonical"
-        context_outputs:
-          - path: "products[0].product_id"
-            key: "canonical_product_id"
-          - path: "products[0].pricing_options[0].pricing_option_id"
-            key: "canonical_pricing_option_id"
-          - path: "products[0].format_options[0].format_option_id"
-            key: "canonical_format_option_id"
-          - path: "products[0].format_options[0].format_kind"
-            key: "canonical_format_kind"
-        validations:
-          - check: response_schema
-            description: "Response matches get-products-response.json schema"
-          - check: field_present
-            path: "products[0].format_options[0].format_kind"
-            description: "Product declares a canonical format option for inline creative validation"
-          - check: field_present
-            path: "products[0].format_options[0].format_option_id"
-            description: "Product publishes a selectable product-local format option id"
-          - check: field_present
-            path: "products[0].pricing_options[0].fixed_price"
-            description: "The captured pricing option is fixed-price; fixed-price storyboards do not send bid_price"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "inline_creatives_without_sync--get_products_canonical"
-            description: "Context correlation_id returned unchanged"
-
-      - id: create_buy_with_canonical_inline_creative
-        title: "Create media buy with canonical inline creative"
-        task: create_media_buy
-        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: |
-          Accept the media buy and attach the inline creative to the package.
-          The response should include the package and preserve package context.
-        sample_request:
-          brand:
-            domain: "acmeoutdoor.example"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          idempotency_key: "$generate:uuid_v4#inline_creatives_without_sync_create_canonical"
-          start_time: "asap"
-          end_time: "2099-09-30T23:59:59Z"
-          packages:
-            - product_id: "$context.canonical_product_id"
-              budget: 7500
-              pricing_option_id: "$context.canonical_pricing_option_id"
-              format_option_refs:
-                - scope: "product"
-                  format_option_id: "$context.canonical_format_option_id"
-              context:
-                buyer_ref: "inline-creative-canonical-line-001"
-              creatives:
-                - creative_id: "acme-inline-canonical-display-v1"
-                  name: "Acme Outdoor inline canonical display v1"
-                  format_kind: "$context.canonical_format_kind"
-                  assets:
-                    image:
-                      asset_type: "image"
-                      url: "https://test-assets.adcontextprotocol.org/acme-outdoor/hero-master.jpg"
-                      width: 300
-                      height: 250
-                      mime_type: "image/jpeg"
-                    click_url:
-                      asset_type: "url"
-                      url: "https://acmeoutdoor.example/q3"
-          context:
-            correlation_id: "inline_creatives_without_sync--create_canonical"
-        context_outputs:
-          - path: "media_buy_id"
-            key: "canonical_media_buy_id"
-          - path: "packages[0].package_id"
-            key: "canonical_package_id"
-        validations:
-          - check: response_schema
-            description: "Response matches create-media-buy-response.json schema"
-          - check: field_present
-            path: "media_buy_id"
-            description: "Seller assigns a media_buy_id"
-          - check: field_present
-            path: "packages[0].package_id"
-            description: "Seller assigns a package_id"
-          - check: field_value
-            path: "packages[0].context.buyer_ref"
-            value: "inline-creative-canonical-line-001"
-            description: "Created package echoes package-level context for correlation"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "inline_creatives_without_sync--create_canonical"
-            description: "Context correlation_id returned unchanged"
-
-      - id: update_buy_with_replacement_canonical_inline_creative
-        title: "Replace canonical inline creative"
-        task: update_media_buy
-        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: |
-          Replace the package's inline creative body with the new creative_id and
-          return the affected package. The replacement creative is verified on
-          the standardized creative_approvals readback surface below.
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          media_buy_id: "$context.canonical_media_buy_id"
-          packages:
-            - package_id: "$context.canonical_package_id"
-              creatives:
-                - creative_id: "acme-inline-canonical-display-v2"
-                  name: "Acme Outdoor inline canonical display v2"
-                  format_kind: "$context.canonical_format_kind"
-                  assets:
-                    image:
-                      asset_type: "image"
-                      url: "https://test-assets.adcontextprotocol.org/acme-outdoor/hero-alt.jpg"
-                      width: 300
-                      height: 250
-                      mime_type: "image/jpeg"
-                    click_url:
-                      asset_type: "url"
-                      url: "https://acmeoutdoor.example/q3-refresh"
-          idempotency_key: "$generate:uuid_v4#inline_creatives_without_sync_update_canonical"
-          context:
-            correlation_id: "inline_creatives_without_sync--update_canonical"
-        validations:
-          - check: response_schema
-            description: "Response matches update-media-buy-response.json schema"
-          - check: field_equals_context
-            path: "media_buy_id"
-            context_key: "canonical_media_buy_id"
-            description: "Update response references the same media buy"
-          - check: field_equals_context
-            path: "affected_packages[0].package_id"
-            context_key: "canonical_package_id"
-            description: "Update response includes the affected package"
-          - check: field_contains
-            path: "affected_packages[*]"
-            value:
-              package_id: "$context.canonical_package_id"
-              product_id: "$context.canonical_product_id"
-              pricing_option_id: "$context.canonical_pricing_option_id"
-              budget: 7500
-              context:
-                buyer_ref: "inline-creative-canonical-line-001"
-            description: "Affected package includes complete post-update package state for the canonical inline creative line"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "inline_creatives_without_sync--update_canonical"
-            description: "Context correlation_id returned unchanged"
-
-  - id: legacy_format_inline_path
-    title: "Inline creative path using format_ids"
-    narrative: |
-      A seller may still publish products through legacy format_ids[]. This
-      path submits the inline creative with the product's legacy format_id and
-      verifies create/update acceptance separately from the canonical path.
-
-    steps:
-      - id: get_products_legacy_format
-        title: "Discover a product with format_ids"
-        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: full_sales_flow
-        stateful: false
-        expected: |
-          Return at least one fixed-price product with a pricing option and a
-          concrete format_id that can be used by the inline CreativeAsset.
-        sample_request:
-          buying_mode: "brief"
-          brief: "Display inventory on outdoor lifestyle content. Q3 flight with buyer-supplied inline creative."
-          filters:
-            is_fixed_price: true
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          context:
-            correlation_id: "inline_creatives_without_sync--get_products_legacy"
-        context_outputs:
-          - path: "products[0].product_id"
-            key: "legacy_product_id"
-          - path: "products[0].pricing_options[0].pricing_option_id"
-            key: "legacy_pricing_option_id"
-          - path: "products[0].format_ids[0]"
-            key: "legacy_format_id"
-        validations:
-          - check: response_schema
-            description: "Response matches get-products-response.json schema"
-          - check: field_present
-            path: "products[0].format_ids[0].id"
-            description: "Product declares a format_id for inline creative validation"
-          - check: field_present
-            path: "products[0].pricing_options[0].fixed_price"
-            description: "The captured pricing option is fixed-price; fixed-price storyboards do not send bid_price"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "inline_creatives_without_sync--get_products_legacy"
-            description: "Context correlation_id returned unchanged"
-
-      - id: create_buy_with_legacy_inline_creative
-        title: "Create media buy with legacy inline creative"
-        task: create_media_buy
-        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: |
-          Accept the media buy and attach the inline creative to the package.
-          The response should include the package and preserve package context.
-        sample_request:
-          brand:
-            domain: "acmeoutdoor.example"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          idempotency_key: "$generate:uuid_v4#inline_creatives_without_sync_create_legacy"
-          start_time: "asap"
-          end_time: "2099-09-30T23:59:59Z"
-          packages:
-            - product_id: "$context.legacy_product_id"
-              budget: 7500
-              pricing_option_id: "$context.legacy_pricing_option_id"
-              context:
-                buyer_ref: "inline-creative-legacy-line-001"
-              creatives:
-                - creative_id: "acme-inline-legacy-display-v1"
-                  name: "Acme Outdoor inline legacy display v1"
-                  format_id: "$context.legacy_format_id"
-                  assets:
-                    image:
-                      asset_type: "image"
-                      url: "https://test-assets.adcontextprotocol.org/acme-outdoor/hero-master.jpg"
-                      width: 300
-                      height: 250
-                      mime_type: "image/jpeg"
-                    click_url:
-                      asset_type: "url"
-                      url: "https://acmeoutdoor.example/q3"
-          context:
-            correlation_id: "inline_creatives_without_sync--create_legacy"
-        context_outputs:
-          - path: "media_buy_id"
-            key: "legacy_media_buy_id"
-          - path: "packages[0].package_id"
-            key: "legacy_package_id"
-        validations:
-          - check: response_schema
-            description: "Response matches create-media-buy-response.json schema"
-          - check: field_present
-            path: "media_buy_id"
-            description: "Seller assigns a media_buy_id"
-          - check: field_present
-            path: "packages[0].package_id"
-            description: "Seller assigns a package_id"
-          - check: field_value
-            path: "packages[0].context.buyer_ref"
-            value: "inline-creative-legacy-line-001"
-            description: "Created package echoes package-level context for correlation"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "inline_creatives_without_sync--create_legacy"
-            description: "Context correlation_id returned unchanged"
-
-      - id: update_buy_with_replacement_legacy_inline_creative
-        title: "Replace legacy inline creative"
-        task: update_media_buy
-        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: |
-          Replace the package's inline creative body with the new creative_id and
-          return the affected package. The replacement creative is verified on
-          the standardized creative_approvals readback surface below.
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          media_buy_id: "$context.legacy_media_buy_id"
-          packages:
-            - package_id: "$context.legacy_package_id"
-              creatives:
-                - creative_id: "acme-inline-legacy-display-v2"
-                  name: "Acme Outdoor inline legacy display v2"
-                  format_id: "$context.legacy_format_id"
-                  assets:
-                    image:
-                      asset_type: "image"
-                      url: "https://test-assets.adcontextprotocol.org/acme-outdoor/hero-alt.jpg"
-                      width: 300
-                      height: 250
-                      mime_type: "image/jpeg"
-                    click_url:
-                      asset_type: "url"
-                      url: "https://acmeoutdoor.example/q3-refresh"
-          idempotency_key: "$generate:uuid_v4#inline_creatives_without_sync_update_legacy"
-          context:
-            correlation_id: "inline_creatives_without_sync--update_legacy"
-        validations:
-          - check: response_schema
-            description: "Response matches update-media-buy-response.json schema"
-          - check: field_equals_context
-            path: "media_buy_id"
-            context_key: "legacy_media_buy_id"
-            description: "Update response references the same media buy"
-          - check: field_equals_context
-            path: "affected_packages[0].package_id"
-            context_key: "legacy_package_id"
-            description: "Update response includes the affected package"
-          - check: field_contains
-            path: "affected_packages[*]"
-            value:
-              package_id: "$context.legacy_package_id"
-              product_id: "$context.legacy_product_id"
-              pricing_option_id: "$context.legacy_pricing_option_id"
-              budget: 7500
-              context:
-                buyer_ref: "inline-creative-legacy-line-001"
-            description: "Affected package includes complete post-update package state for the legacy inline creative line"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "inline_creatives_without_sync--update_legacy"
-            description: "Context correlation_id returned unchanged"
-
-  - id: verify_replacement
-    title: "Verify inline creative replacements persisted"
-    narrative: |
-      The buyer reads both media buys and confirms each package approval state
-      reflects the replacement inline creative for its format path.
-
-    steps:
-      - id: get_canonical_media_buy_after_inline_replacement
-        title: "Read canonical media buy after inline replacement"
-        task: 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"
-        comply_scenario: media_buy_lifecycle
-        stateful: true
-        expected: |
-          Return the canonical-path media buy with package approval state for
-          the replacement inline creative. The full CreativeAsset body is not
-          required on this read surface.
-
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          media_buy_ids:
-            - "$context.canonical_media_buy_id"
-          context:
-            correlation_id: "inline_creatives_without_sync--get_canonical_media_buy"
-        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: "canonical_media_buy_id"
-            description: "Read response returns the created canonical media buy"
-          - check: field_equals_context
-            path: "media_buys[0].packages[0].package_id"
-            context_key: "canonical_package_id"
-            description: "Read response returns the created canonical package"
-          - check: field_value
-            path: "media_buys[0].packages[0].creative_approvals[0].creative_id"
-            value: "acme-inline-canonical-display-v2"
-            description: "Read response reflects the canonical replacement inline creative on the package approval-state surface"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "inline_creatives_without_sync--get_canonical_media_buy"
-            description: "Context correlation_id returned unchanged"
-
-      - id: get_legacy_media_buy_after_inline_replacement
-        title: "Read legacy media buy after inline replacement"
-        task: 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"
-        comply_scenario: media_buy_lifecycle
-        stateful: true
-        expected: |
-          Return the legacy-path media buy with package approval state for the
-          replacement inline creative. The full CreativeAsset body is not
-          required on this read surface.
-
-        sample_request:
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          media_buy_ids:
-            - "$context.legacy_media_buy_id"
-          context:
-            correlation_id: "inline_creatives_without_sync--get_legacy_media_buy"
-        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: "legacy_media_buy_id"
-            description: "Read response returns the created legacy media buy"
-          - check: field_equals_context
-            path: "media_buys[0].packages[0].package_id"
-            context_key: "legacy_package_id"
-            description: "Read response returns the created legacy package"
-          - check: field_value
-            path: "media_buys[0].packages[0].creative_approvals[0].creative_id"
-            value: "acme-inline-legacy-display-v2"
-            description: "Read response reflects the legacy replacement inline creative on the package approval-state surface"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "inline_creatives_without_sync--get_legacy_media_buy"
-            description: "Context correlation_id returned unchanged"