@adcp/sdk 13.0.0-rc.7 → 13.0.0-rc.9

package/ADCP_VERSION

@@ -1 +1 @@
-3.1.10
+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.10.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.10 → 3.1.11}/index.json

@@ -1,7 +1,7 @@
 {
-  "published_version": "3.1.10",
-  "adcp_version": "3.1.10",
-  "generated_at": "2026-08-04T05:40:04.745Z",
+  "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.10 → 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"

package/compliance/cache/{3.1.10 → 3.1.11}/universal/storyboard-schema.yaml

@@ -639,6 +639,20 @@
 #   case where the SDK's per-task request builder discards a body field
 #   from `sample_request`, use `context_inputs:` (above) as the
 #   post-builder injection path.
+#
+#   Creative asset expansion: an `assets` object MAY contain the reserved
+#   `$build_assets_from_format` key with a `$context.<name>` value. The context
+#   value MUST be either canonical `FormatOption.params` captured from
+#   `get_products` or a legacy `FormatId` resolved against formats captured from
+#   `list_creative_formats`. Before request-schema validation or transport, the
+#   runner MUST replace the entire directive-bearing `assets` object with an
+#   asset map keyed by each required slot's canonical `asset_group_id` or legacy
+#   `asset_id`. Values come from the storyboard's test kit and MUST satisfy the
+#   slot contract. Image slots use an `assets.images[]` fixture satisfying the
+#   declared dimensions; URL slots use `assets.click_url`. If any required slot
+#   cannot be populated, the runner MUST fail the step before transport with
+#   `unresolved_substitution` rather than sending the directive or an incomplete
+#   manifest.
 # sample_response: object (optional — example expected response; also surfaces in published docs)
 #
 # auth: "none" | object (optional — overrides the transport's default credentials for this step)
@@ -2296,11 +2310,10 @@
 # --- Unresolved substitution behavior ---
 #
 # When a storyboard references a substitution variable the runner cannot
-# resolve — most commonly {{runner.webhook_base}} or {{runner.webhook_url:<id>}}
-# on a run with no webhook receiver configured — the runner MUST NOT ship the
-# literal `{{...}}` token to the agent under test. Shipping unresolved
-# substitutions is a conformance bug on the runner side, not a grading signal
-# about the agent.
+# resolve — whether a `$context.*` token or a `{{...}}` token, including tokens
+# nested in object properties or array elements — the runner MUST NOT ship the
+# literal token to the agent under test. Shipping unresolved substitutions is a
+# conformance bug on the runner side, not a grading signal about the agent.
 #
 # Runners MUST resolve substitutions at one of two preflight points:
 #   1. Before the storyboard run starts — if any step references an unresolvable
@@ -2311,4 +2324,4 @@
 #      (e.g., {{prior_step.<id>.task_id}}) fails to resolve, grade the
 #      step as failed with `unresolved_substitution`.
 #
-# Neither path may ship a literal `{{...}}` token on the wire.
+# Neither path may ship a literal `$context.*` or `{{...}}` token on the wire.

package/compliance/cache/{3.1.10.previous → 3.1.11.previous}/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.10.previous → 3.1.11.previous}/index.json

@@ -1,7 +1,7 @@
 {
-  "published_version": "3.1.10",
-  "adcp_version": "3.1.10",
-  "generated_at": "2026-08-04T05:40:04.745Z",
+  "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.10/domains → 3.1.11.previous/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"

package/compliance/cache/{3.1.10.previous → 3.1.11.previous}/universal/storyboard-schema.yaml

@@ -639,6 +639,20 @@
 #   case where the SDK's per-task request builder discards a body field
 #   from `sample_request`, use `context_inputs:` (above) as the
 #   post-builder injection path.
+#
+#   Creative asset expansion: an `assets` object MAY contain the reserved
+#   `$build_assets_from_format` key with a `$context.<name>` value. The context
+#   value MUST be either canonical `FormatOption.params` captured from
+#   `get_products` or a legacy `FormatId` resolved against formats captured from
+#   `list_creative_formats`. Before request-schema validation or transport, the
+#   runner MUST replace the entire directive-bearing `assets` object with an
+#   asset map keyed by each required slot's canonical `asset_group_id` or legacy
+#   `asset_id`. Values come from the storyboard's test kit and MUST satisfy the
+#   slot contract. Image slots use an `assets.images[]` fixture satisfying the
+#   declared dimensions; URL slots use `assets.click_url`. If any required slot
+#   cannot be populated, the runner MUST fail the step before transport with
+#   `unresolved_substitution` rather than sending the directive or an incomplete
+#   manifest.
 # sample_response: object (optional — example expected response; also surfaces in published docs)
 #
 # auth: "none" | object (optional — overrides the transport's default credentials for this step)
@@ -2296,11 +2310,10 @@
 # --- Unresolved substitution behavior ---
 #
 # When a storyboard references a substitution variable the runner cannot
-# resolve — most commonly {{runner.webhook_base}} or {{runner.webhook_url:<id>}}
-# on a run with no webhook receiver configured — the runner MUST NOT ship the
-# literal `{{...}}` token to the agent under test. Shipping unresolved
-# substitutions is a conformance bug on the runner side, not a grading signal
-# about the agent.
+# resolve — whether a `$context.*` token or a `{{...}}` token, including tokens
+# nested in object properties or array elements — the runner MUST NOT ship the
+# literal token to the agent under test. Shipping unresolved substitutions is a
+# conformance bug on the runner side, not a grading signal about the agent.
 #
 # Runners MUST resolve substitutions at one of two preflight points:
 #   1. Before the storyboard run starts — if any step references an unresolvable
@@ -2311,4 +2324,4 @@
 #      (e.g., {{prior_step.<id>.task_id}}) fails to resolve, grade the
 #      step as failed with `unresolved_substitution`.
 #
-# Neither path may ship a literal `{{...}}` token on the wire.
+# Neither path may ship a literal `$context.*` or `{{...}}` token on the wire.