@adcp/sdk 13.0.0-rc.6 → 13.0.0-rc.8

package/ADCP_VERSION

@@ -1 +1 @@
-3.1.8
+3.1.11

package/bin/adcp.js

@@ -2658,6 +2658,7 @@ async function handleStoryboardRun(args) {
     // Human-readable output
     console.log(`\n${storyboard.title} (${storyboard.id})`);
     console.log('═'.repeat(50));
+    printFixtureResolution(result.fixture_resolutions, result.coverage_gaps);
     for (const phase of result.phases) {
       console.log(`\n── Phase: ${phase.phase_title} ──────────────────────────────`);
       const SKIP_ICONS = {
@@ -3583,6 +3584,32 @@ function printStrictSummary(summary) {
   console.log(`${icon} strict: ${passed}/${checked} passed${tail}`);
 }
 
+/** Render bindings without dumping the (potentially large) discovery evidence. */
+function printFixtureResolution(records, coverageGaps) {
+  if (!Array.isArray(records) || records.length === 0) return;
+  console.log('\nFixture resolution:');
+  for (const record of records) {
+    const scope = record.product_handle ? `${record.product_handle}/` : '';
+    if (record.status === 'resolved') {
+      const ids = record.seller_ids || {};
+      const sellerId = ids.pricing_option_id || ids.product_id || '?';
+      console.log(`  ✅ ${record.fixture_type} ${scope}${record.handle} → ${sellerId} (${record.strategy})`);
+    } else if (record.status === 'unsatisfied') {
+      continue;
+    } else {
+      const failedEvidence = Array.isArray(record.strategies_attempted)
+        ? [...record.strategies_attempted].reverse().find(item => item?.disposition === 'failed')
+        : undefined;
+      const detail = failedEvidence?.detail ? `: ${String(failedEvidence.detail).slice(0, 240)}` : '';
+      console.log(`  ❌ ${record.fixture_type} ${scope}${record.handle} — resolution failed${detail}`);
+    }
+  }
+  const fixtureGap = Array.isArray(coverageGaps)
+    ? coverageGaps.find(gap => gap?.reason === 'fixture_unsatisfied')
+    : undefined;
+  if (fixtureGap) console.log(`  ⏭️  ${fixtureGap.detail}`);
+}
+
 /**
  * Render the `notices` advisory surface (adcp-client#1704) in the
  * default text output. Notices are decoupled from overall_passed —
@@ -3896,6 +3923,7 @@ async function handleMultiInstanceStoryboardRun(args, opts, urls) {
     for (const result of results) {
       console.log(`\n${result.storyboard_title} (${result.storyboard_id})`);
       console.log('═'.repeat(50));
+      printFixtureResolution(result.fixture_resolutions, result.coverage_gaps);
       for (const phase of result.phases) {
         console.log(`\n── Phase: ${phase.phase_title} ──────────────────────────────`);
         for (const step of phase.steps) {
@@ -4180,6 +4208,7 @@ async function handleAgentsRoutedStoryboardRun(args, opts, routing) {
     for (const result of results) {
       console.log(`\n${result.storyboard_title} (${result.storyboard_id})`);
       console.log('═'.repeat(50));
+      printFixtureResolution(result.fixture_resolutions, result.coverage_gaps);
       for (const phase of result.phases) {
         console.log(`\n── Phase: ${phase.phase_title} ──────────────────────────────`);
         for (const step of phase.steps) {

package/compliance/cache/{3.1.8 → 3.1.11}/domains/media-buy/index.yaml

@@ -21,6 +21,7 @@ requires_scenarios:
   - media_buy_seller/inline_creatives_without_sync
   - media_buy_seller/create_media_buy_async
   - media_buy_seller/dependency_impairment
+  - media_buy_seller/dependency_impairment_audience
   - media_buy_seller/dependency_impairment_cardinality
 
 narrative: |

package/compliance/cache/{3.1.8.previous/protocols → 3.1.11/domains}/media-buy/scenarios/creative_fate_after_cancellation.yaml

@@ -6,6 +6,7 @@ summary: "Validates that canceling a media buy releases package-creative assignm
 track: media_buy
 required_tools:
   - get_products
+  - list_creative_formats
   - create_media_buy
   - update_media_buy
   - sync_creatives
@@ -87,10 +88,8 @@ phases:
             key: "product_id"
           - path: "products[0].pricing_options[0].pricing_option_id"
             key: "pricing_option_id"
-          - path: "products[0].format_ids[0].agent_url"
-            key: "format_agent_url"
-          - path: "products[0].format_ids[0].id"
-            key: "format_id"
+          - path: "products[0].format_ids[0]"
+            key: "format_ref"
         validations:
           - check: response_schema
             description: "Response matches get-products-response.json schema"
@@ -101,6 +100,41 @@ phases:
             path: "products[0].pricing_options[0].fixed_price"
             description: "The captured pricing option is fixed-price; fixed-price storyboards do not send bid_price"
 
+      - id: list_selected_format
+        title: "Resolve the selected product format"
+        task: list_creative_formats
+        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 the format definition referenced by the selected product, including
+          every required asset slot the buyer must provide to sync_creatives.
+        sample_request:
+          format_ids:
+            - "$context.format_ref"
+          context:
+            correlation_id: "creative_fate--list_selected_format"
+        # Older SDK request builders discard list_creative_formats filters. Inject
+        # after request construction so the selected FormatId reaches the seller.
+        context_inputs:
+          - key: format_ref
+            inject_at: "format_ids[0]"
+        context_outputs:
+          - path: "formats"
+            key: "formats"
+        validations:
+          - check: response_schema
+            description: "Response matches list-creative-formats-response.json schema"
+          - check: field_present
+            path: "formats[0]"
+            description: "The product's selected format resolves to a seller-declared format"
+          - check: field_value
+            path: "formats[0].format_id"
+            value: "$context.format_ref"
+            description: "The returned format matches the product's selected format_id"
+
       - id: create_buy
         title: "Create the initial media buy"
         task: create_media_buy
@@ -167,16 +201,9 @@ phases:
           creatives:
             - creative_id: "acme_reuse_banner_001"
               name: "Acme Outdoor reuse banner"
-              format_id:
-                agent_url: "$context.format_agent_url"
-                id: "$context.format_id"
+              format_id: "$context.format_ref"
               assets:
-                image:
-                  asset_type: "image"
-                  url: "https://cdn.pinnacle-agency.example/acme-reuse-banner.png"
-                  width: 300
-                  height: 250
-                  mime_type: "image/png"
+                $build_assets_from_format: "$context.format_ref"
           assignments:
             - creative_id: "acme_reuse_banner_001"
               package_id: "$context.package_id"
@@ -372,9 +399,10 @@ phases:
       - id: reassign_creative
         title: "Assign the original creative_id to the new package"
         narrative: |
-          Reference the original creative by creative_id only (no assets, no re-upload)
-          and assign it to the new package. The seller resolves the creative_id from
-          the library; if the creative was evaporated on cancel, this call fails.
+          Reference the original creative by creative_id and resubmit the source assets
+          required by the selected product format, then assign it to the new package.
+          The seller resolves the creative_id from the library; if the creative was
+          evaporated on cancel, this call fails.
         task: sync_creatives
         schema_ref: "creative/sync-creatives-request.json"
         response_schema_ref: "creative/sync-creatives-response.json"
@@ -399,15 +427,9 @@ phases:
             # leaving `creatives: undefined` which fails pre-flight zod.
             - creative_id: "acme_reuse_banner_001"
               name: "Reassigned creative"
-              format_id:
-                agent_url: "https://your-platform.example.com"
-                id: "display_300x250"
+              format_id: "$context.format_ref"
               assets:
-                image:
-                  asset_type: "image"
-                  url: "https://test-assets.adcontextprotocol.org/acme-outdoor/banner_300x250.jpg"
-                  width: 300
-                  height: 250
+                $build_assets_from_format: "$context.format_ref"
           assignments:
             - creative_id: "acme_reuse_banner_001"
               package_id: "$context.second_package_id"

package/compliance/cache/3.1.11/domains/media-buy/scenarios/dependency_impairment_audience.yaml

@@ -0,0 +1,317 @@
+id: media_buy_seller/dependency_impairment_audience
+version: "1.0.0"
+title: "Audience dependency impairment — suspension propagates to media buy health"
+category: media_buy_seller
+summary: "Syncs an audience, targets it from a package, forces ready → suspended, verifies an audience impairment, then restores ready and verifies recovery."
+track: media_buy
+
+required_tools:
+  - sync_audiences
+  - create_media_buy
+  - get_media_buys
+  - comply_test_controller
+
+requires_capability:
+  path: media_buy.propagation_surfaces
+  contains: "snapshot"
+
+narrative: |
+  Audience status is a serving dependency, not catalog decoration. When a
+  seller suspends an audience targeted by a non-terminal media buy, every
+  affected package must surface an audience impairment and the buy's health
+  must become impaired. When the audience returns to a serviceable state, the
+  impairment must clear.
+
+  This is the audience sibling of dependency_impairment. It is additive and
+  capability-gated: sellers without audience_targeting, snapshot propagation,
+  sync_audiences, or the force_audience_status controller adapter grade the
+  unsupported path not-applicable rather than inheriting a new wire contract.
+
+agent:
+  interaction_model: media_buy_seller
+  capabilities:
+    - sells_media
+    - audience_targeting
+
+caller:
+  role: buyer_agent
+  example: "Pinnacle Agency (buyer)"
+
+prerequisites:
+  description: |
+    Seller advertises media_buy.audience_targeting, snapshot propagation, and
+    a sandbox comply_test_controller with force_audience_status.
+  test_kit: "test-kits/acme-outdoor.yaml"
+  controller_seeding: true
+
+fixtures:
+  products:
+    - product_id: "audience_impairment_display"
+      delivery_type: "non_guaranteed"
+      channels: ["display"]
+      format_ids:
+        - id: "display_300x250"
+  pricing_options:
+    - product_id: "audience_impairment_display"
+      pricing_option_id: "audience_impairment_cpm"
+      pricing_model: "cpm"
+      currency: "USD"
+      floor_price: 2.00
+
+phases:
+  - id: setup
+    title: "Sync an audience and target it from a media buy"
+    requires_capability:
+      path: media_buy.audience_targeting
+      present: true
+    steps:
+      - id: sync_audience
+        title: "Register the audience"
+        task: sync_audiences
+        schema_ref: "media-buy/sync-audiences-request.json"
+        response_schema_ref: "media-buy/sync-audiences-response.json"
+        doc_ref: "/media-buy/task-reference/sync_audiences"
+        stateful: true
+        sample_request:
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          audiences:
+            - audience_id: "acme_impairment_audience"
+              name: "Acme impairment audience"
+              audience_type: "crm"
+              add:
+                - external_id: "acme-impairment-001"
+                  hashed_email: "a000000000000000000000000000000000000000000000000000000000000101"
+                - external_id: "acme-impairment-002"
+                  hashed_email: "a000000000000000000000000000000000000000000000000000000000000102"
+          idempotency_key: "$generate:uuid_v4#dependency_impairment_audience_sync"
+        validations:
+          - check: response_schema
+            description: "Response matches sync-audiences-response.json"
+          - check: field_value
+            path: "audiences[0].audience_id"
+            value: "acme_impairment_audience"
+            description: "Seller echoes the registered audience ID"
+
+      - id: force_audience_ready_baseline
+        title: "Establish a serviceable audience baseline"
+        task: comply_test_controller
+        requires_tool: comply_test_controller
+        stateful: true
+        sample_request:
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+            sandbox: true
+          scenario: "force_audience_status"
+          params:
+            audience_id: "acme_impairment_audience"
+            status: "ready"
+        validations:
+          - check: field_value
+            path: "success"
+            allowed_values: [true]
+            description: "Controller establishes the ready baseline"
+          - check: field_value
+            path: "current_state"
+            allowed_values: ["ready"]
+            description: "Audience is ready before the buy is created"
+
+      - id: create_audience_buy
+        title: "Create a buy targeting the synced audience"
+        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"
+        stateful: true
+        sample_request:
+          brand:
+            domain: "acmeoutdoor.example"
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          start_time: "asap"
+          end_time: "2099-11-30T23:59:59Z"
+          packages:
+            - product_id: "audience_impairment_display"
+              budget: 5000
+              pricing_option_id: "audience_impairment_cpm"
+              targeting_overlay:
+                audience_include:
+                  - "acme_impairment_audience"
+          idempotency_key: "$generate:uuid_v4#dependency_impairment_audience_create"
+        context_outputs:
+          - path: "media_buy_id"
+            key: "media_buy_id"
+          - path: "packages[0].package_id"
+            key: "package_id"
+        validations:
+          - check: response_schema
+            description: "Response matches create-media-buy-response.json"
+          - check: field_present
+            path: "media_buy_id"
+            description: "Seller creates the audience-targeted buy"
+
+  - id: baseline_healthy
+    title: "Establish the healthy baseline"
+    requires_capability:
+      path: media_buy.audience_targeting
+      present: true
+    steps:
+      - id: get_buy_healthy
+        title: "Read the healthy buy"
+        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"
+        stateful: true
+        sample_request:
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          media_buy_ids:
+            - "$context.media_buy_id"
+        validations:
+          - check: response_schema
+            description: "Response matches get-media-buys-response.json"
+          - check: field_value
+            path: "media_buys[0].health"
+            allowed_values: ["ok"]
+            description: "Buy starts healthy while the audience is serviceable"
+          - check: field_value_or_absent
+            path: "media_buys[0].impairments"
+            value: []
+            description: "No impairment is open at baseline"
+
+  - id: suspend_audience
+    title: "Suspend the targeted audience"
+    requires_capability:
+      path: media_buy.audience_targeting
+      present: true
+    steps:
+      - id: force_audience_suspended
+        title: "Force the audience offline"
+        task: comply_test_controller
+        requires_tool: comply_test_controller
+        stateful: true
+        sample_request:
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+            sandbox: true
+          scenario: "force_audience_status"
+          params:
+            audience_id: "acme_impairment_audience"
+            status: "suspended"
+            reason: "consent_expired"
+        validations:
+          - check: field_value
+            path: "success"
+            allowed_values: [true]
+            description: "Controller applies the audience suspension"
+          - check: field_value
+            path: "current_state"
+            allowed_values: ["suspended"]
+            description: "Audience is now suspended"
+
+  - id: verify_impaired
+    title: "Verify audience impairment propagation"
+    requires_capability:
+      path: media_buy.audience_targeting
+      present: true
+    steps:
+      - id: get_buy_impaired
+        title: "Read the impaired buy"
+        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"
+        stateful: true
+        sample_request:
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          media_buy_ids:
+            - "$context.media_buy_id"
+        validations:
+          - check: response_schema
+            description: "Response matches get-media-buys-response.json"
+          - check: field_value
+            path: "media_buys[0].health"
+            allowed_values: ["impaired"]
+            description: "Buy health becomes impaired"
+          - check: field_contains
+            path: "media_buys[0].impairments[*]"
+            value:
+              resource_type: "audience"
+              resource_id: "acme_impairment_audience"
+              package_ids:
+                - "$context.package_id"
+              transition:
+                to: "suspended"
+              reason_code: "consent_expired"
+            description: "Impairment identifies the suspended audience and affected package"
+
+  - id: recover_audience
+    title: "Restore the audience and verify recovery"
+    requires_capability:
+      path: media_buy.audience_targeting
+      present: true
+    steps:
+      - id: force_audience_ready
+        title: "Return the audience to ready"
+        task: comply_test_controller
+        requires_tool: comply_test_controller
+        stateful: true
+        sample_request:
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+            sandbox: true
+          scenario: "force_audience_status"
+          params:
+            audience_id: "acme_impairment_audience"
+            status: "ready"
+        validations:
+          - check: field_value
+            path: "success"
+            allowed_values: [true]
+            description: "Controller restores the audience"
+          - check: field_value
+            path: "current_state"
+            allowed_values: ["ready"]
+            description: "Audience is serviceable again"
+
+      - id: get_buy_recovered
+        title: "Read the recovered buy"
+        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"
+        stateful: true
+        sample_request:
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          media_buy_ids:
+            - "$context.media_buy_id"
+        validations:
+          - check: response_schema
+            description: "Response matches get-media-buys-response.json"
+          - check: field_value
+            path: "media_buys[0].health"
+            allowed_values: ["ok"]
+            description: "Buy health returns to ok"
+          - check: field_value_or_absent
+            path: "media_buys[0].impairments"
+            value: []
+            description: "Audience impairment is cleared"

package/compliance/cache/{3.1.8 → 3.1.11}/index.json

@@ -1,7 +1,7 @@
 {
-  "published_version": "3.1.8",
-  "adcp_version": "3.1.8",
-  "generated_at": "2026-07-28T13:04:13.458Z",
+  "published_version": "3.1.11",
+  "adcp_version": "3.1.11",
+  "generated_at": "2026-08-07T04:42:01.239Z",
   "universal": [
     "billing-gate-dispatch",
     "canonical-format-validate-input",

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

@@ -21,6 +21,7 @@ requires_scenarios:
   - media_buy_seller/inline_creatives_without_sync
   - media_buy_seller/create_media_buy_async
   - media_buy_seller/dependency_impairment
+  - media_buy_seller/dependency_impairment_audience
   - media_buy_seller/dependency_impairment_cardinality
 
 narrative: |

package/compliance/cache/{3.1.8 → 3.1.11}/protocols/media-buy/scenarios/creative_fate_after_cancellation.yaml

@@ -6,6 +6,7 @@ summary: "Validates that canceling a media buy releases package-creative assignm
 track: media_buy
 required_tools:
   - get_products
+  - list_creative_formats
   - create_media_buy
   - update_media_buy
   - sync_creatives
@@ -87,10 +88,8 @@ phases:
             key: "product_id"
           - path: "products[0].pricing_options[0].pricing_option_id"
             key: "pricing_option_id"
-          - path: "products[0].format_ids[0].agent_url"
-            key: "format_agent_url"
-          - path: "products[0].format_ids[0].id"
-            key: "format_id"
+          - path: "products[0].format_ids[0]"
+            key: "format_ref"
         validations:
           - check: response_schema
             description: "Response matches get-products-response.json schema"
@@ -101,6 +100,41 @@ phases:
             path: "products[0].pricing_options[0].fixed_price"
             description: "The captured pricing option is fixed-price; fixed-price storyboards do not send bid_price"
 
+      - id: list_selected_format
+        title: "Resolve the selected product format"
+        task: list_creative_formats
+        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 the format definition referenced by the selected product, including
+          every required asset slot the buyer must provide to sync_creatives.
+        sample_request:
+          format_ids:
+            - "$context.format_ref"
+          context:
+            correlation_id: "creative_fate--list_selected_format"
+        # Older SDK request builders discard list_creative_formats filters. Inject
+        # after request construction so the selected FormatId reaches the seller.
+        context_inputs:
+          - key: format_ref
+            inject_at: "format_ids[0]"
+        context_outputs:
+          - path: "formats"
+            key: "formats"
+        validations:
+          - check: response_schema
+            description: "Response matches list-creative-formats-response.json schema"
+          - check: field_present
+            path: "formats[0]"
+            description: "The product's selected format resolves to a seller-declared format"
+          - check: field_value
+            path: "formats[0].format_id"
+            value: "$context.format_ref"
+            description: "The returned format matches the product's selected format_id"
+
       - id: create_buy
         title: "Create the initial media buy"
         task: create_media_buy
@@ -167,16 +201,9 @@ phases:
           creatives:
             - creative_id: "acme_reuse_banner_001"
               name: "Acme Outdoor reuse banner"
-              format_id:
-                agent_url: "$context.format_agent_url"
-                id: "$context.format_id"
+              format_id: "$context.format_ref"
               assets:
-                image:
-                  asset_type: "image"
-                  url: "https://cdn.pinnacle-agency.example/acme-reuse-banner.png"
-                  width: 300
-                  height: 250
-                  mime_type: "image/png"
+                $build_assets_from_format: "$context.format_ref"
           assignments:
             - creative_id: "acme_reuse_banner_001"
               package_id: "$context.package_id"
@@ -372,9 +399,10 @@ phases:
       - id: reassign_creative
         title: "Assign the original creative_id to the new package"
         narrative: |
-          Reference the original creative by creative_id only (no assets, no re-upload)
-          and assign it to the new package. The seller resolves the creative_id from
-          the library; if the creative was evaporated on cancel, this call fails.
+          Reference the original creative by creative_id and resubmit the source assets
+          required by the selected product format, then assign it to the new package.
+          The seller resolves the creative_id from the library; if the creative was
+          evaporated on cancel, this call fails.
         task: sync_creatives
         schema_ref: "creative/sync-creatives-request.json"
         response_schema_ref: "creative/sync-creatives-response.json"
@@ -399,15 +427,9 @@ phases:
             # leaving `creatives: undefined` which fails pre-flight zod.
             - creative_id: "acme_reuse_banner_001"
               name: "Reassigned creative"
-              format_id:
-                agent_url: "https://your-platform.example.com"
-                id: "display_300x250"
+              format_id: "$context.format_ref"
               assets:
-                image:
-                  asset_type: "image"
-                  url: "https://test-assets.adcontextprotocol.org/acme-outdoor/banner_300x250.jpg"
-                  width: 300
-                  height: 250
+                $build_assets_from_format: "$context.format_ref"
           assignments:
             - creative_id: "acme_reuse_banner_001"
               package_id: "$context.second_package_id"