@adcp/sdk 7.11.0 → 7.11.1

package/compliance/cache/3.1.0-rc.2/universal/wholesale-feed-bulk-webhooks.yaml

@@ -0,0 +1,82 @@
+id: wholesale_feed_bulk_webhooks
+version: "1.0.0"
+title: "Wholesale feed bulk-change webhook registration"
+category: account_lifecycle
+summary: "Validates account-level notification_configs[] registration for agents that advertise wholesale_feed.bulk_change webhook events."
+track: core
+introduced_in: "3.1"
+
+requires_capability:
+  path: wholesale_feed_webhooks.event_types
+  contains: "wholesale_feed.bulk_change"
+
+required_tools:
+  - sync_accounts
+
+narrative: |
+  Agents that advertise the bulk-change wholesale feed webhook event must accept
+  that account-level event type through `sync_accounts.accounts[].notification_configs[]`.
+  The event tells consumers to repair by re-reading the affected wholesale feed.
+
+agent:
+  interaction_model: marketplace_catalog
+  capabilities:
+    - wholesale_feed_webhooks
+
+caller:
+  role: buyer_agent
+  example: "Compliance test harness"
+
+prerequisites:
+  description: |
+    The agent advertises `wholesale_feed.bulk_change` in
+    `wholesale_feed_webhooks.event_types`.
+  test_kit: "test-kits/acme-outdoor.yaml"
+
+phases:
+  - id: register
+    title: "Register bulk-change webhook"
+    steps:
+      - id: register_bulk_change_webhook
+        title: "Register wholesale_feed.bulk_change subscriber"
+        task: sync_accounts
+        schema_ref: "account/sync-accounts-request.json"
+        response_schema_ref: "account/sync-accounts-response.json"
+        doc_ref: "/accounts/tasks/sync_accounts"
+        stateful: true
+        sample_request:
+          accounts:
+            - brand:
+                domain: "acmeoutdoor.example"
+              operator: "pinnacle-agency.example"
+              billing: "operator"
+              payment_terms: "net_60"
+              sandbox: true
+              notification_configs:
+                - subscriber_id: "bulk-feed-sync"
+                  url: "https://example.com/webhooks/adcp/bulk-feed"
+                  event_types:
+                    - "wholesale_feed.bulk_change"
+                  active: false
+          idempotency_key: "$generate:uuid_v4#wholesale_feed_bulk_webhooks"
+          context:
+            correlation_id: "wholesale_feed_bulk_webhooks--register"
+        validations:
+          - check: response_schema
+            description: "Response matches sync-accounts-response.json schema"
+          - check: field_value
+            path: "accounts[0].notification_configs[0].subscriber_id"
+            value: "bulk-feed-sync"
+            description: "Subscriber key is echoed"
+          - check: field_value
+            path: "accounts[0].notification_configs[0].event_types[0]"
+            value: "wholesale_feed.bulk_change"
+            description: "Bulk-change event is persisted"
+          - check: field_value
+            path: "accounts[0].notification_configs[0].active"
+            value: false
+            description: "Paused subscriber can be persisted without activation proof"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "wholesale_feed_bulk_webhooks--register"
+            description: "Context correlation_id returned unchanged"

package/compliance/cache/3.1.0-rc.2/universal/wholesale-feed-product-webhooks.yaml

@@ -0,0 +1,83 @@
+id: wholesale_feed_product_webhooks
+version: "1.0.0"
+title: "Wholesale product feed webhook registration"
+category: account_lifecycle
+summary: "Validates account-level notification_configs[] registration for agents that advertise product wholesale feed webhook events."
+track: media_buy
+introduced_in: "3.1"
+
+requires_capability:
+  path: wholesale_feed_webhooks.event_types
+  contains: "product.priced"
+
+required_tools:
+  - sync_accounts
+
+narrative: |
+  Agents that advertise product wholesale feed webhook events must accept those
+  account-level event types through `sync_accounts.accounts[].notification_configs[]`.
+  Delivery semantics are covered by webhook-emission; this storyboard checks the
+  durable registration surface.
+
+agent:
+  interaction_model: media_buy_seller
+  capabilities:
+    - wholesale_feed_webhooks
+
+caller:
+  role: buyer_agent
+  example: "Compliance test harness"
+
+prerequisites:
+  description: |
+    The agent advertises `product.priced` in
+    `wholesale_feed_webhooks.event_types`.
+  test_kit: "test-kits/acme-outdoor.yaml"
+
+phases:
+  - id: register
+    title: "Register product feed webhook"
+    steps:
+      - id: register_product_pricing_webhook
+        title: "Register product.priced subscriber"
+        task: sync_accounts
+        schema_ref: "account/sync-accounts-request.json"
+        response_schema_ref: "account/sync-accounts-response.json"
+        doc_ref: "/accounts/tasks/sync_accounts"
+        stateful: true
+        sample_request:
+          accounts:
+            - brand:
+                domain: "acmeoutdoor.example"
+              operator: "pinnacle-agency.example"
+              billing: "operator"
+              payment_terms: "net_60"
+              sandbox: true
+              notification_configs:
+                - subscriber_id: "product-feed-sync"
+                  url: "https://example.com/webhooks/adcp/product-feed"
+                  event_types:
+                    - "product.priced"
+                  active: false
+          idempotency_key: "$generate:uuid_v4#wholesale_feed_product_webhooks"
+          context:
+            correlation_id: "wholesale_feed_product_webhooks--register"
+        validations:
+          - check: response_schema
+            description: "Response matches sync-accounts-response.json schema"
+          - check: field_value
+            path: "accounts[0].notification_configs[0].subscriber_id"
+            value: "product-feed-sync"
+            description: "Subscriber key is echoed"
+          - check: field_value
+            path: "accounts[0].notification_configs[0].event_types[0]"
+            value: "product.priced"
+            description: "Product pricing event is persisted"
+          - check: field_value
+            path: "accounts[0].notification_configs[0].active"
+            value: false
+            description: "Paused subscriber can be persisted without activation proof"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "wholesale_feed_product_webhooks--register"
+            description: "Context correlation_id returned unchanged"

package/compliance/cache/3.1.0-rc.2/universal/wholesale-feed-products.yaml

@@ -0,0 +1,151 @@
+id: wholesale_feed_products
+version: "1.0.0"
+title: "Wholesale product feed versioning"
+category: marketplace_catalog
+summary: "Validates get_products wholesale feed versioning: bootstrap responses carry wholesale_feed_version/cache_scope and matching if_wholesale_feed_version probes return unchanged without product rows."
+track: media_buy
+introduced_in: "3.1"
+
+requires_capability:
+  path: wholesale_feed_versioning.supported
+  equals: true
+
+required_tools:
+  - get_products
+
+narrative: |
+  Sellers that advertise wholesale feed versioning and expose `get_products`
+  must support the beta.4 conditional-fetch shape for wholesale product mirrors:
+  `wholesale_feed_version`, `if_wholesale_feed_version`, `cache_scope`, and
+  `unchanged: true`. This storyboard does not require the optional separate
+  `pricing_version` layer or account-specific cache overlays.
+
+agent:
+  interaction_model: media_buy_seller
+  capabilities:
+    - wholesale_feed_versioning
+  examples:
+    - "Sales agents with a wholesale product feed"
+
+caller:
+  role: buyer_agent
+  example: "Compliance test harness"
+
+prerequisites:
+  description: |
+    The agent advertises `wholesale_feed_versioning.supported: true` and exposes
+    `get_products`.
+  test_kit: "test-kits/acme-outdoor.yaml"
+  controller_seeding: false
+
+phases:
+  - id: conditional_fetch
+    title: "Bootstrap and probe product feed"
+    steps:
+      - id: bootstrap_products
+        title: "Bootstrap product feed"
+        task: get_products
+        schema_ref: "media-buy/get-products-request.json"
+        response_schema_ref: "media-buy/get-products-response.json"
+        doc_ref: "/media-buy/tasks/get_products"
+        stateful: true
+        context_outputs:
+          - name: product_wholesale_feed_version
+            path: "wholesale_feed_version"
+        expected: |
+          Return product rows with wholesale feed metadata.
+        sample_request:
+          buying_mode: "wholesale"
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          context:
+            correlation_id: "wholesale_feed_products--bootstrap"
+        validations:
+          - check: response_schema
+            description: "Response matches get-products-response.json schema"
+          - check: field_present
+            path: "products[0].product_id"
+            description: "Bootstrap returns product rows"
+          - check: field_present
+            path: "wholesale_feed_version"
+            description: "Bootstrap returns an opaque feed token"
+          - check: field_value
+            path: "cache_scope"
+            value: "public"
+            description: "Ordinary account reads may use the public cache layer"
+          - check: field_absent
+            path: "proposals[0].proposal_id"
+            description: "Wholesale mode returns raw feed rows, not curated proposals"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "wholesale_feed_products--bootstrap"
+            description: "Context correlation_id returned unchanged"
+
+      - id: unchanged_probe
+        title: "Probe unchanged product feed"
+        task: get_products
+        schema_ref: "media-buy/get-products-request.json"
+        response_schema_ref: "media-buy/get-products-response.json"
+        doc_ref: "/media-buy/tasks/get_products"
+        stateful: true
+        expected: |
+          Return unchanged without resending product rows when the feed token matches.
+        sample_request:
+          buying_mode: "wholesale"
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          if_wholesale_feed_version: "$context.product_wholesale_feed_version"
+          context:
+            correlation_id: "wholesale_feed_products--unchanged"
+        validations:
+          - check: response_schema
+            description: "Response matches get-products-response.json schema"
+          - check: field_value
+            path: "unchanged"
+            value: true
+            description: "Matching token produces the cheap unchanged response"
+          - check: field_equals_context
+            path: "wholesale_feed_version"
+            context_key: "product_wholesale_feed_version"
+            description: "Unchanged response echoes the current product feed token"
+          - check: field_value
+            path: "cache_scope"
+            value: "public"
+            description: "Unchanged response carries cache scope"
+          - check: field_absent
+            path: "products[0].product_id"
+            description: "Unchanged response omits product rows"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "wholesale_feed_products--unchanged"
+            description: "Context correlation_id returned unchanged"
+
+      - id: standalone_pricing_token_rejected
+        title: "Reject standalone product pricing token"
+        task: get_products
+        schema_ref: "media-buy/get-products-request.json"
+        response_schema_ref: "media-buy/get-products-response.json"
+        doc_ref: "/media-buy/tasks/get_products"
+        expect_error: true
+        negative_path: payload_well_formed
+        sample_request_skip_schema: true
+        stateful: true
+        expected: |
+          Reject if_pricing_version when if_wholesale_feed_version is absent.
+        sample_request:
+          buying_mode: "wholesale"
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          if_pricing_version: "stale-pricing-token"
+          context:
+            correlation_id: "wholesale_feed_products--standalone_pricing"
+        validations:
+          - check: error_code
+            value: "INVALID_REQUEST"
+            description: "Standalone if_pricing_version is rejected"

package/compliance/cache/3.1.0-rc.2/universal/wholesale-feed-signal-webhooks.yaml

@@ -0,0 +1,83 @@
+id: wholesale_feed_signal_webhooks
+version: "1.0.0"
+title: "Wholesale signals feed webhook registration"
+category: account_lifecycle
+summary: "Validates account-level notification_configs[] registration for agents that advertise signal wholesale feed webhook events."
+track: signals
+introduced_in: "3.1"
+
+requires_capability:
+  path: wholesale_feed_webhooks.event_types
+  contains: "signal.priced"
+
+required_tools:
+  - sync_accounts
+
+narrative: |
+  Agents that advertise signal wholesale feed webhook events must accept those
+  account-level event types through `sync_accounts.accounts[].notification_configs[]`.
+  Delivery semantics are covered by webhook-emission; this storyboard checks the
+  durable registration surface.
+
+agent:
+  interaction_model: signals_agent
+  capabilities:
+    - wholesale_feed_webhooks
+
+caller:
+  role: buyer_agent
+  example: "Compliance test harness"
+
+prerequisites:
+  description: |
+    The agent advertises `signal.priced` in
+    `wholesale_feed_webhooks.event_types`.
+  test_kit: "test-kits/acme-outdoor.yaml"
+
+phases:
+  - id: register
+    title: "Register signals feed webhook"
+    steps:
+      - id: register_signal_pricing_webhook
+        title: "Register signal.priced subscriber"
+        task: sync_accounts
+        schema_ref: "account/sync-accounts-request.json"
+        response_schema_ref: "account/sync-accounts-response.json"
+        doc_ref: "/accounts/tasks/sync_accounts"
+        stateful: true
+        sample_request:
+          accounts:
+            - brand:
+                domain: "acmeoutdoor.example"
+              operator: "pinnacle-agency.example"
+              billing: "operator"
+              payment_terms: "net_60"
+              sandbox: true
+              notification_configs:
+                - subscriber_id: "signal-feed-sync"
+                  url: "https://example.com/webhooks/adcp/signal-feed"
+                  event_types:
+                    - "signal.priced"
+                  active: false
+          idempotency_key: "$generate:uuid_v4#wholesale_feed_signal_webhooks"
+          context:
+            correlation_id: "wholesale_feed_signal_webhooks--register"
+        validations:
+          - check: response_schema
+            description: "Response matches sync-accounts-response.json schema"
+          - check: field_value
+            path: "accounts[0].notification_configs[0].subscriber_id"
+            value: "signal-feed-sync"
+            description: "Subscriber key is echoed"
+          - check: field_value
+            path: "accounts[0].notification_configs[0].event_types[0]"
+            value: "signal.priced"
+            description: "Signal pricing event is persisted"
+          - check: field_value
+            path: "accounts[0].notification_configs[0].active"
+            value: false
+            description: "Paused subscriber can be persisted without activation proof"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "wholesale_feed_signal_webhooks--register"
+            description: "Context correlation_id returned unchanged"

package/compliance/cache/3.1.0-rc.2/universal/wholesale-feed-signals.yaml

@@ -0,0 +1,149 @@
+id: wholesale_feed_signals
+version: "1.0.0"
+title: "Wholesale signals feed versioning"
+category: marketplace_catalog
+summary: "Validates get_signals wholesale feed versioning: bootstrap responses carry wholesale_feed_version/cache_scope and matching if_wholesale_feed_version probes return unchanged without signal rows."
+track: signals
+introduced_in: "3.1"
+
+requires_capability:
+  path: wholesale_feed_versioning.supported
+  equals: true
+
+required_tools:
+  - get_signals
+
+narrative: |
+  Signals agents that advertise wholesale feed versioning and expose
+  `get_signals` must support the beta.4 conditional-fetch shape for wholesale
+  signal mirrors:
+  `discovery_mode: wholesale`, `wholesale_feed_version`,
+  `if_wholesale_feed_version`, `cache_scope`, and `unchanged: true`. This
+  storyboard does not require the optional separate `pricing_version` layer.
+
+agent:
+  interaction_model: signals_agent
+  capabilities:
+    - wholesale_feed_versioning
+  examples:
+    - "Signals agents with a wholesale signals feed"
+
+caller:
+  role: buyer_agent
+  example: "Compliance test harness"
+
+prerequisites:
+  description: |
+    The agent advertises `wholesale_feed_versioning.supported: true` and exposes
+    `get_signals`.
+  test_kit: "test-kits/acme-outdoor.yaml"
+  controller_seeding: false
+
+phases:
+  - id: conditional_fetch
+    title: "Bootstrap and probe signals feed"
+    steps:
+      - id: bootstrap_signals
+        title: "Bootstrap signals feed"
+        task: get_signals
+        schema_ref: "signals/get-signals-request.json"
+        response_schema_ref: "signals/get-signals-response.json"
+        doc_ref: "/signals/tasks/get_signals"
+        stateful: true
+        context_outputs:
+          - name: signal_wholesale_feed_version
+            path: "wholesale_feed_version"
+        expected: |
+          Return signal rows with wholesale feed metadata.
+        sample_request:
+          discovery_mode: "wholesale"
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          context:
+            correlation_id: "wholesale_feed_signals--bootstrap"
+        validations:
+          - check: response_schema
+            description: "Response matches get-signals-response.json schema"
+          - check: field_present
+            path: "signals[0].signal_agent_segment_id"
+            description: "Bootstrap returns signal rows"
+          - check: field_present
+            path: "wholesale_feed_version"
+            description: "Bootstrap returns an opaque feed token"
+          - check: field_value
+            path: "cache_scope"
+            value: "public"
+            description: "Ordinary account reads may use the public cache layer"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "wholesale_feed_signals--bootstrap"
+            description: "Context correlation_id returned unchanged"
+
+      - id: unchanged_probe
+        title: "Probe unchanged signals feed"
+        task: get_signals
+        schema_ref: "signals/get-signals-request.json"
+        response_schema_ref: "signals/get-signals-response.json"
+        doc_ref: "/signals/tasks/get_signals"
+        stateful: true
+        expected: |
+          Return unchanged without resending signal rows when the feed token matches.
+        sample_request:
+          discovery_mode: "wholesale"
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          if_wholesale_feed_version: "$context.signal_wholesale_feed_version"
+          context:
+            correlation_id: "wholesale_feed_signals--unchanged"
+        validations:
+          - check: response_schema
+            description: "Response matches get-signals-response.json schema"
+          - check: field_value
+            path: "unchanged"
+            value: true
+            description: "Matching token produces the cheap unchanged response"
+          - check: field_equals_context
+            path: "wholesale_feed_version"
+            context_key: "signal_wholesale_feed_version"
+            description: "Unchanged response echoes the current signal feed token"
+          - check: field_value
+            path: "cache_scope"
+            value: "public"
+            description: "Unchanged response carries cache scope"
+          - check: field_absent
+            path: "signals[0].signal_agent_segment_id"
+            description: "Unchanged response omits signal rows"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "wholesale_feed_signals--unchanged"
+            description: "Context correlation_id returned unchanged"
+
+      - id: standalone_pricing_token_rejected
+        title: "Reject standalone signal pricing token"
+        task: get_signals
+        schema_ref: "signals/get-signals-request.json"
+        response_schema_ref: "signals/get-signals-response.json"
+        doc_ref: "/signals/tasks/get_signals"
+        expect_error: true
+        negative_path: payload_well_formed
+        sample_request_skip_schema: true
+        stateful: true
+        expected: |
+          Reject if_pricing_version when if_wholesale_feed_version is absent.
+        sample_request:
+          discovery_mode: "wholesale"
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          if_pricing_version: "stale-pricing-token"
+          context:
+            correlation_id: "wholesale_feed_signals--standalone_pricing"
+        validations:
+          - check: error_code
+            value: "INVALID_REQUEST"
+            description: "Standalone if_pricing_version is rejected"

package/dist/lib/schemas-data/v2.5/_provenance.json

@@ -4,5 +4,5 @@
   "source_sha": "4e553ad955f83b49c7d221ab5c3ff78237ad02e3",
   "source_tarball_sha256": "580656d6466ef9f0d1119985e6726c2efea718dc671e2ad30957fcb2fd54af0f",
   "upstream_adcp_version": "2.5.3",
-  "synced_at": "2026-05-22T10:06:03.117Z"
+  "synced_at": "2026-05-30T09:42:42.445Z"
 }

package/dist/lib/testing/storyboard/default-invariants.js

@@ -132,6 +132,8 @@ registerOnce('context.no_secret_echo', {
         for (const s of optAny.secrets ?? [])
             addIfSecret(secrets, s);
         addIfSecret(secrets, optAny.test_kit?.auth?.api_key);
+        for (const s of extractBasicSecrets(optAny.test_kit?.auth?.basic))
+            addIfSecret(secrets, s);
         ctx.state.secrets = secrets;
     },
     onStep: (ctx, stepResult) => {
@@ -502,6 +504,27 @@ function extractAuthSecrets(auth) {
     }
     return out;
 }
+function extractBasicSecrets(basic) {
+    if (!basic || typeof basic !== 'object')
+        return [];
+    const b = basic;
+    const out = [];
+    if (typeof b.credentials === 'string' && b.credentials) {
+        const colonIndex = b.credentials.indexOf(':');
+        if (colonIndex > 0 && colonIndex < b.credentials.length - 1) {
+            out.push(b.credentials.slice(colonIndex + 1));
+            out.push(Buffer.from(b.credentials, 'utf8').toString('base64'));
+        }
+        return out;
+    }
+    if (typeof b.password === 'string' && b.password) {
+        out.push(b.password);
+        if (typeof b.username === 'string' && b.username) {
+            out.push(Buffer.from(`${b.username}:${b.password}`, 'utf8').toString('base64'));
+        }
+    }
+    return out;
+}
 const SCHEMA_URL_BASE = 'https://adcontextprotocol.org';
 function buildEnumSchemaUrl(enumFile) {
     return `${SCHEMA_URL_BASE}/schemas/${version_1.ADCP_VERSION}/enums/${enumFile}`;