@adcp/sdk 15.8.1 → 16.0.0-beta.1

package/compliance/cache/3.2.4/universal/deterministic-testing.yaml

@@ -0,0 +1,1471 @@
+id: deterministic_testing
+version: '1.0.0'
+title: 'Deterministic testing'
+category: core
+summary: 'Uses comply_test_controller to force state transitions and simulate delivery/budget, verifying state machines and reporting.'
+track: core
+requires:
+  - controller
+
+required_tools:
+  - comply_test_controller
+platform_types:
+  - display_ad_server
+  - video_ad_server
+  - social_platform
+  - retail_media
+  - search_platform
+  - audio_platform
+  - linear_tv_platform
+  - dsp
+  - pmax_platform
+  - ai_ad_network
+  - ai_platform
+  - generative_dsp
+
+narrative: |
+  Sellers that implement the comply_test_controller tool enable deterministic compliance
+  testing. The controller forces server-side state transitions without relying on real
+  async workflows, letting the test harness verify state machine behavior, operation
+  gating, and reporting accuracy.
+
+  This storyboard covers the full controller surface: scenario listing, account state
+  machines, media buy lifecycle, creative status transitions, SI session management,
+  delivery simulation, and budget spend simulation.
+
+agent:
+  interaction_model: media_buy_seller
+  capabilities:
+    - sells_media
+    - supports_test_controller
+  examples:
+    - 'Any seller with comply_test_controller'
+
+caller:
+  role: buyer_agent
+  example: 'Comply test harness'
+
+prerequisites:
+  description: |
+    The seller must expose the comply_test_controller tool. The controller is detected
+    via list_scenarios before any state transitions are attempted. Phases that require
+    specific scenarios are skipped if the controller does not support them. The runner
+    also seeds the product and pricing option referenced by the media-buy phases so
+    those phases validate lifecycle behavior rather than catalog availability.
+  test_kit: 'test-kits/acme-outdoor.yaml'
+  controller_seeding: true
+
+fixtures:
+  products:
+    - product_id: 'test-product'
+      delivery_type: 'non_guaranteed'
+      channels: ['display']
+      format_options:
+        - format_option_id: 'display_300x250'
+          format_kind: 'image'
+          params:
+            width: 300
+            height: 250
+  pricing_options:
+    - product_id: 'test-product'
+      pricing_option_id: 'test-pricing'
+      pricing_model: 'cpm'
+      currency: 'USD'
+      floor_price: 1.0
+
+phases:
+  - id: capability_discovery
+    title: "Capability discovery"
+    narrative: |
+      The buyer calls get_adcp_capabilities to confirm the agent supports media buying before running deterministic test scenarios.
+
+    steps:
+      - id: get_capabilities
+        title: "Check agent capabilities"
+        narrative: |
+          Verify that the agent declares the expected protocol support before
+          proceeding with domain-specific operations.
+        task: get_adcp_capabilities
+        schema_ref: "protocol/get-adcp-capabilities-request.json"
+        response_schema_ref: "protocol/get-adcp-capabilities-response.json"
+        doc_ref: "/protocol/get_adcp_capabilities"
+        comply_scenario: capability_discovery
+        stateful: false
+        expected: |
+          Return capabilities declaring media_buy in supported_protocols, confirming the agent sells media.
+        sample_request:
+          context:
+            correlation_id: "deterministic_testing--get_capabilities"
+        validations:
+          - check: response_schema
+            description: "Response matches get-adcp-capabilities-response.json schema"
+          - check: field_present
+            path: "supported_protocols"
+            description: "Agent declares supported protocols"
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--get_capabilities"
+            description: "Context correlation_id returned unchanged"
+  - id: controller_validation
+    title: 'Controller validation'
+    narrative: |
+      Validates that the comply_test_controller is functional and responds correctly
+      to scenario discovery, unknown scenarios, missing parameters, and nonexistent
+      entity references.
+
+    steps:
+      - id: list_scenarios
+        title: 'List supported scenarios'
+        requires_tool: comply_test_controller
+        narrative: |
+          Call the controller with scenario: list_scenarios to discover which
+          force_* and simulate_* scenarios the seller supports.
+        task: comply_test_controller
+        comply_scenario: controller_validation
+        stateful: false
+        context_outputs:
+          - name: supported_scenarios
+            path: 'scenarios'
+        expected: |
+          Return a list of supported scenarios. The response should include:
+          - success: true
+          - scenarios: array or object of scenario names
+
+        sample_request:
+          account:
+            sandbox: true
+          scenario: 'list_scenarios'
+
+          context:
+            correlation_id: "deterministic_testing--list_scenarios"
+        validations:
+          - check: field_present
+            path: 'scenarios'
+            description: 'Controller returns supported scenarios'
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - true
+            description: 'list_scenarios succeeds'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--list_scenarios"
+            description: "Context correlation_id returned unchanged"
+      - id: unknown_scenario
+        title: 'Unknown scenario returns error'
+        requires_tool: comply_test_controller
+        narrative: |
+          Send a nonexistent scenario name. The controller should return
+          UNKNOWN_SCENARIO error code.
+        task: comply_test_controller
+        comply_scenario: controller_validation
+        stateful: false
+        expect_error: true
+        negative_path: schema_invalid
+        expected: |
+          Return an error response with:
+          - success: false
+          - error: UNKNOWN_SCENARIO
+
+        sample_request:
+          account:
+            sandbox: true
+          scenario: 'nonexistent_scenario'
+          params: {}
+
+          context:
+            correlation_id: "deterministic_testing--unknown_scenario"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - false
+            description: 'Unknown scenario fails'
+          - check: field_value
+            path: 'error'
+            allowed_values:
+              - 'UNKNOWN_SCENARIO'
+            description: 'Error code is UNKNOWN_SCENARIO'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--unknown_scenario"
+            description: "Context correlation_id returned unchanged"
+      - id: missing_params
+        title: 'Missing params returns error'
+        requires_tool: comply_test_controller
+        narrative: |
+          Call force_creative_status with empty params. The controller should
+          return INVALID_PARAMS when it implements the scenario, or
+          UNKNOWN_SCENARIO when it doesn't (per-tenant scenario registration
+          is up to the seller — universal storyboards accept either response
+          as valid because both signal "controller validated input and refused
+          gracefully," which is the load-bearing test intent).
+        task: comply_test_controller
+        comply_scenario: controller_validation
+        stateful: false
+        expect_error: true
+        negative_path: schema_invalid
+        expected: |
+          Return an error response with:
+          - success: false
+          - error: INVALID_PARAMS (when scenario implemented) OR
+                   UNKNOWN_SCENARIO (when scenario not on this tenant)
+
+        sample_request:
+          account:
+            sandbox: true
+          scenario: 'force_creative_status'
+          params: {}
+
+          context:
+            correlation_id: "deterministic_testing--missing_params"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - false
+            description: 'Missing params fails'
+          - check: field_value
+            path: 'error'
+            allowed_values:
+              - 'INVALID_PARAMS'
+              - 'UNKNOWN_SCENARIO'
+            description: 'Error code is INVALID_PARAMS or UNKNOWN_SCENARIO (tenant-conditional — per-tenant scenario registration)'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--missing_params"
+            description: "Context correlation_id returned unchanged"
+      - id: not_found_entity
+        title: 'Nonexistent entity returns NOT_FOUND'
+        requires_tool: comply_test_controller
+        narrative: |
+          Call force_creative_status with a nonexistent creative_id. The
+          controller should return NOT_FOUND when it implements the scenario,
+          or UNKNOWN_SCENARIO when it doesn't. Both are valid graceful-refusal
+          shapes; the storyboard accepts either since per-tenant scenario
+          registration is up to the seller.
+        task: comply_test_controller
+        comply_scenario: controller_validation
+        stateful: false
+        expect_error: true
+        negative_path: payload_well_formed
+        expected: |
+          Return an error response with:
+          - success: false
+          - error: NOT_FOUND (when scenario implemented) OR
+                   UNKNOWN_SCENARIO (when scenario not on this tenant)
+
+        sample_request:
+          account:
+            sandbox: true
+          scenario: 'force_creative_status'
+          params:
+            creative_id: 'comply-test-nonexistent-000000000000'
+            status: 'approved'
+
+          context:
+            correlation_id: "deterministic_testing--not_found_entity"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - false
+            description: 'Nonexistent entity fails'
+          - check: field_value
+            path: 'error'
+            allowed_values:
+              - 'NOT_FOUND'
+              - 'UNKNOWN_SCENARIO'
+            description: 'Error code is NOT_FOUND or UNKNOWN_SCENARIO (tenant-conditional — per-tenant scenario registration)'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--not_found_entity"
+            description: "Context correlation_id returned unchanged"
+  - id: deterministic_account
+    title: 'Deterministic account state machine'
+    narrative: |
+      Forces account status transitions via the controller and verifies them through
+      list_accounts. Tests suspension gating (operations blocked when suspended),
+      payment_required state, and reactivation.
+
+    # Phase creates its own sandbox account via sync_accounts and only consumes
+    # context produced within the phase. Explicit empty depends_on prevents the
+    # runner's default "depend on all prior phases" from cascade-skipping when
+    # an unrelated upstream phase trips on missing_tool.
+    depends_on: []
+    requires_capability:
+      path: supported_protocols
+      contains: media_buy
+
+    steps:
+      - id: sync_accounts_for_state
+        title: 'Create sandbox account for state machine test'
+        requires_tool: comply_test_controller
+        narrative: |
+          Sync a sandbox account so the state machine has an entity to
+          force transitions on.
+        task: sync_accounts
+        schema_ref: 'account/sync-accounts-request.json'
+        response_schema_ref: 'account/sync-accounts-response.json'
+        comply_scenario: deterministic_account
+        stateful: true
+
+        sample_request:
+          accounts:
+            - brand:
+                domain: 'test.example'
+              operator: 'test.example'
+              billing: 'operator'
+              sandbox: true
+
+          idempotency_key: "$generate:uuid_v4#deterministic_testing_deterministic_account_sync_accounts_for_state"
+          context:
+            correlation_id: "deterministic_testing--sync_accounts_for_state"
+        validations:
+          - check: field_present
+            path: 'accounts[0].account_id'
+            description: 'Account sync returns account_id'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--sync_accounts_for_state"
+            description: "Context correlation_id returned unchanged"
+      - id: list_accounts_for_state
+        title: 'Find account for state machine test'
+        requires_tool: comply_test_controller
+        narrative: |
+          List accounts to find an active account for state transitions.
+        task: list_accounts
+        comply_scenario: deterministic_account
+        stateful: false
+        context_outputs:
+          - name: account_id
+            path: 'accounts[0].account_id'
+        expected: |
+          Return at least one account with an account_id.
+
+        sample_request:
+          context:
+            correlation_id: "deterministic_testing--list_accounts_for_state"
+
+        validations:
+          - check: field_present
+            path: 'accounts[0].account_id'
+            description: 'At least one account exists'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--list_accounts_for_state"
+            description: "Context correlation_id returned unchanged"
+      - id: force_account_suspended
+        title: 'Force account to suspended'
+        requires_tool: comply_test_controller
+        narrative: |
+          Use the controller to force the account into suspended state. Operations
+          like create_media_buy should be blocked while the account is suspended.
+        task: comply_test_controller
+        comply_scenario: deterministic_account
+        stateful: true
+        expected: |
+          Return a successful state transition:
+          - success: true
+          - previous_state: the account's prior status
+          - current_state: suspended
+
+        sample_request:
+          account:
+            sandbox: true
+          scenario: 'force_account_status'
+          params:
+            account_id: '$context.account_id'
+            status: 'suspended'
+
+          context:
+            correlation_id: "deterministic_testing--force_account_suspended"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - true
+            description: 'Account suspension succeeds'
+          - check: field_value
+            path: 'current_state'
+            allowed_values:
+              - 'suspended'
+            description: 'Account is now suspended'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--force_account_suspended"
+            description: "Context correlation_id returned unchanged"
+      - id: force_account_active
+        title: 'Reactivate account'
+        requires_tool: comply_test_controller
+        narrative: |
+          Restore the account to active state. Verify the transition from suspended
+          back to active succeeds.
+        task: comply_test_controller
+        comply_scenario: deterministic_account
+        stateful: true
+        expected: |
+          Return a successful state transition:
+          - success: true
+          - previous_state: suspended
+          - current_state: active
+
+        sample_request:
+          account:
+            sandbox: true
+          scenario: 'force_account_status'
+          params:
+            account_id: '$context.account_id'
+            status: 'active'
+
+          context:
+            correlation_id: "deterministic_testing--force_account_active"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - true
+            description: 'Account reactivation succeeds'
+          - check: field_value
+            path: 'current_state'
+            allowed_values:
+              - 'active'
+            description: 'Account is now active'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--force_account_active"
+            description: "Context correlation_id returned unchanged"
+      - id: force_account_payment_required
+        title: 'Force account to payment_required'
+        requires_tool: comply_test_controller
+        narrative: |
+          Force the account into payment_required state. This tests a distinct
+          non-terminal blocked state.
+        task: comply_test_controller
+        comply_scenario: deterministic_account
+        stateful: true
+        expected: |
+          Return a successful state transition to payment_required.
+
+        sample_request:
+          account:
+            sandbox: true
+          scenario: 'force_account_status'
+          params:
+            account_id: '$context.account_id'
+            status: 'payment_required'
+
+          context:
+            correlation_id: "deterministic_testing--force_account_payment_required"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - true
+            description: 'Transition to payment_required succeeds'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--force_account_payment_required"
+            description: "Context correlation_id returned unchanged"
+      - id: restore_account_active
+        title: 'Restore account to active'
+        requires_tool: comply_test_controller
+        narrative: |
+          Restore the account to active state after the payment_required test.
+        task: comply_test_controller
+        comply_scenario: deterministic_account
+        stateful: true
+        expected: |
+          Account restored to active state.
+
+        sample_request:
+          account:
+            sandbox: true
+          scenario: 'force_account_status'
+          params:
+            account_id: '$context.account_id'
+            status: 'active'
+
+          context:
+            correlation_id: "deterministic_testing--restore_account_active"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - true
+            description: 'Account restored to active'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--restore_account_active"
+            description: "Context correlation_id returned unchanged"
+  - id: deterministic_media_buy
+    title: 'Deterministic media buy state machine'
+    narrative: |
+      Creates a media buy through the normal flow, then uses the controller to force
+      it through status transitions: active, completed (terminal). Verifies that
+      terminal states reject further transitions.
+
+    # Phase creates its own media buy via create_media_buy and only consumes
+    # context produced within the phase. Explicit empty depends_on prevents the
+    # runner's default "depend on all prior phases" from cascade-skipping when
+    # an unrelated upstream phase trips on missing_tool.
+    depends_on: []
+    requires_capability:
+      path: supported_protocols
+      contains: media_buy
+
+    steps:
+      - id: create_media_buy
+        title: 'Create media buy for state machine test'
+        requires_tool: comply_test_controller
+        narrative: |
+          Create a media buy through the standard create_media_buy task. The resulting
+          media_buy_id is used for controller-driven state transitions.
+        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: deterministic_media_buy
+        stateful: true
+        context_outputs:
+          - name: media_buy_id
+            path: 'media_buy_id'
+        expected: |
+          Create a media buy and return a media_buy_id for state machine testing.
+
+        sample_request:
+          account:
+            brand:
+              domain: 'acmeoutdoor.example'
+            operator: 'pinnacle-agency.example'
+          brand:
+            domain: 'acmeoutdoor.example'
+          start_time: 'asap'
+          end_time: '2099-06-30T23:59:59Z'
+          packages:
+            - product_id: 'test-product'
+              budget: 5000
+              pricing_option_id: 'test-pricing'
+
+          idempotency_key: "$generate:uuid_v4#deterministic_testing_deterministic_media_buy_create_media_buy"
+          context:
+            correlation_id: "deterministic_testing--create_media_buy"
+        validations:
+          - check: response_schema
+            description: 'Response matches create-media-buy-response.json schema'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--create_media_buy"
+            description: "Context correlation_id returned unchanged"
+      - id: force_media_buy_active
+        title: 'Force media buy to active'
+        requires_tool: comply_test_controller
+        narrative: |
+          Use the controller to force the media buy into active state.
+        task: comply_test_controller
+        comply_scenario: deterministic_media_buy
+        stateful: true
+        expected: |
+          Return a successful state transition to active.
+
+        sample_request:
+          account:
+            sandbox: true
+          brand:
+            domain: 'acmeoutdoor.example'
+          scenario: 'force_media_buy_status'
+          params:
+            media_buy_id: '$context.media_buy_id'
+            status: 'active'
+
+          context:
+            correlation_id: "deterministic_testing--force_media_buy_active"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - true
+            description: 'Media buy activation succeeds'
+          - check: field_value
+            path: 'current_state'
+            allowed_values:
+              - 'active'
+            description: 'Media buy is now active'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--force_media_buy_active"
+            description: "Context correlation_id returned unchanged"
+      - id: verify_media_buy_active
+        title: 'Verify media buy status via get_media_buys'
+        requires_tool: comply_test_controller
+        narrative: |
+          Call get_media_buys to confirm the controller-forced status is reflected
+          in the standard API.
+        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: deterministic_media_buy
+        stateful: true
+        expected: |
+          Return the media buy with status: active.
+
+        sample_request:
+          account:
+            brand:
+              domain: 'acmeoutdoor.example'
+            operator: 'pinnacle-agency.example'
+          media_buy_ids:
+            - '$context.media_buy_id'
+
+          context:
+            correlation_id: "deterministic_testing--verify_media_buy_active"
+        validations:
+          - check: response_schema
+            description: 'Response matches get-media-buys-response.json schema'
+          - check: field_present
+            path: 'media_buys[0].status'
+            description: 'Media buy has a status field'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--verify_media_buy_active"
+            description: "Context correlation_id returned unchanged"
+      - id: force_media_buy_completed
+        title: 'Force media buy to completed (terminal)'
+        requires_tool: comply_test_controller
+        narrative: |
+          Force the media buy to completed, a terminal state. No further transitions
+          should be allowed.
+        task: comply_test_controller
+        comply_scenario: deterministic_media_buy
+        stateful: true
+        expected: |
+          Return a successful transition to completed.
+
+        sample_request:
+          account:
+            sandbox: true
+          brand:
+            domain: 'acmeoutdoor.example'
+          scenario: 'force_media_buy_status'
+          params:
+            media_buy_id: '$context.media_buy_id'
+            status: 'completed'
+
+          context:
+            correlation_id: "deterministic_testing--force_media_buy_completed"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - true
+            description: 'Transition to completed succeeds'
+          - check: field_value
+            path: 'current_state'
+            allowed_values:
+              - 'completed'
+            description: 'Media buy is now completed'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--force_media_buy_completed"
+            description: "Context correlation_id returned unchanged"
+      - id: invalid_transition_from_terminal
+        title: 'Reject transition from terminal state'
+        requires_tool: comply_test_controller
+        narrative: |
+          Attempt to force the completed media buy back to active. The controller
+          should reject this with INVALID_TRANSITION.
+        task: comply_test_controller
+        comply_scenario: deterministic_media_buy
+        stateful: true
+        expect_error: true
+        negative_path: payload_well_formed
+        expected: |
+          Return an error response:
+          - success: false
+          - error: INVALID_TRANSITION
+
+        sample_request:
+          account:
+            sandbox: true
+          brand:
+            domain: 'acmeoutdoor.example'
+          scenario: 'force_media_buy_status'
+          params:
+            media_buy_id: '$context.media_buy_id'
+            status: 'active'
+
+          context:
+            correlation_id: "deterministic_testing--invalid_transition_from_terminal"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - false
+            description: 'Terminal state rejects transition'
+          - check: field_value
+            path: 'error'
+            allowed_values:
+              - 'INVALID_TRANSITION'
+            description: 'Error code is INVALID_TRANSITION'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--invalid_transition_from_terminal"
+            description: "Context correlation_id returned unchanged"
+  - id: deterministic_creative
+    title: 'Deterministic creative state machine'
+    narrative: |
+      Syncs a creative, then uses the controller to force it through status
+      transitions: approved, archived (terminal). Verifies terminal state rejection
+      and rejection with reason.
+
+    # Phase syncs its own creative via sync_creatives and only consumes context
+    # produced within the phase. Explicit empty depends_on prevents the runner's
+    # default "depend on all prior phases" from cascade-skipping when an
+    # unrelated upstream phase trips on missing_tool.
+    depends_on: []
+    requires_capability:
+      path: supported_protocols
+      contains: creative
+
+    steps:
+      - id: sync_creative_for_state
+        title: 'Sync creative for state machine test'
+        requires_tool: comply_test_controller
+        narrative: |
+          Push a test creative via sync_creatives. The creative_id is captured
+          for controller-driven transitions.
+        task: sync_creatives
+        schema_ref: 'creative/sync-creatives-request.json'
+        response_schema_ref: 'creative/sync-creatives-response.json'
+        doc_ref: '/creative/task-reference/sync_creatives'
+        comply_scenario: deterministic_creative
+        stateful: true
+        context_outputs:
+          - name: creative_id
+            path: 'creatives[0].creative_id'
+        expected: |
+          Accept the creative and return a creative_id for state machine testing.
+
+        sample_request:
+          account:
+            brand:
+              domain: 'acmeoutdoor.example'
+            operator: 'pinnacle-agency.example'
+          creatives:
+            - creative_id: 'comply-state-test-creative'
+              name: 'Comply State Test Creative'
+              format_kind: 'image'
+              assets:
+                image:
+                  asset_type: 'image'
+                  url: 'https://via.placeholder.com/300x250'
+                  width: 300
+                  height: 250
+                  mime_type: 'image/png'
+
+          idempotency_key: "$generate:uuid_v4#deterministic_testing_deterministic_creative_sync_creative_for_state"
+          context:
+            correlation_id: "deterministic_testing--sync_creative_for_state"
+        validations:
+          - check: response_schema
+            description: 'Response matches sync-creatives-response.json schema'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--sync_creative_for_state"
+            description: "Context correlation_id returned unchanged"
+      - id: force_creative_approved
+        title: 'Force creative to approved'
+        requires_tool: comply_test_controller
+        narrative: |
+          Use the controller to force the creative into approved state.
+        task: comply_test_controller
+        comply_scenario: deterministic_creative
+        stateful: true
+        expected: |
+          Successful transition to approved.
+
+        sample_request:
+          account:
+            sandbox: true
+          brand:
+            domain: 'acmeoutdoor.example'
+          scenario: 'force_creative_status'
+          params:
+            creative_id: '$context.creative_id'
+            status: 'approved'
+
+          context:
+            correlation_id: "deterministic_testing--force_creative_approved"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - true
+            description: 'Creative approval succeeds'
+          - check: field_value
+            path: 'current_state'
+            allowed_values:
+              - 'approved'
+            description: 'Creative is now approved'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--force_creative_approved"
+            description: "Context correlation_id returned unchanged"
+      - id: force_creative_archived
+        title: 'Force creative to archived (terminal)'
+        requires_tool: comply_test_controller
+        narrative: |
+          Force the creative to archived, a terminal state.
+        task: comply_test_controller
+        comply_scenario: deterministic_creative
+        stateful: true
+        expected: |
+          Successful transition to archived.
+
+        sample_request:
+          account:
+            sandbox: true
+          brand:
+            domain: 'acmeoutdoor.example'
+          scenario: 'force_creative_status'
+          params:
+            creative_id: '$context.creative_id'
+            status: 'archived'
+
+          context:
+            correlation_id: "deterministic_testing--force_creative_archived"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - true
+            description: 'Transition to archived succeeds'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--force_creative_archived"
+            description: "Context correlation_id returned unchanged"
+      - id: invalid_creative_transition
+        title: 'Reject archived to processing'
+        requires_tool: comply_test_controller
+        narrative: |
+          Attempt to force the archived creative back to processing. The controller
+          should reject this with INVALID_TRANSITION.
+        task: comply_test_controller
+        comply_scenario: deterministic_creative
+        stateful: true
+        expect_error: true
+        negative_path: payload_well_formed
+        expected: |
+          Return error with INVALID_TRANSITION.
+
+        sample_request:
+          account:
+            sandbox: true
+          brand:
+            domain: 'acmeoutdoor.example'
+          scenario: 'force_creative_status'
+          params:
+            creative_id: '$context.creative_id'
+            status: 'processing'
+
+          context:
+            correlation_id: "deterministic_testing--invalid_creative_transition"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - false
+            description: 'Terminal state rejects transition'
+          - check: field_value
+            path: 'error'
+            allowed_values:
+              - 'INVALID_TRANSITION'
+            description: 'Error code is INVALID_TRANSITION'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--invalid_creative_transition"
+            description: "Context correlation_id returned unchanged"
+      - id: sync_fresh_creative_for_rejection
+        title: 'Sync a fresh creative to exercise rejection'
+        requires_tool: sync_creatives
+        narrative: |
+          The preceding phase archived the first creative — a terminal state
+          that cannot transition to rejected. Sync a second, fresh creative so
+          the rejection path starts from processing rather than archived.
+        task: sync_creatives
+        schema_ref: "creative/sync-creatives-request.json"
+        response_schema_ref: "creative/sync-creatives-response.json"
+        doc_ref: "/media-buy/task-reference/sync_creatives"
+        comply_scenario: deterministic_creative
+        stateful: true
+        expected: |
+          A new creative with a distinct creative_id, reusable by downstream
+          force_creative_status calls.
+
+        sample_request:
+          account:
+            brand:
+              domain: "acmeoutdoor.example"
+            operator: "pinnacle-agency.example"
+          creatives:
+            - creative_id: "deterministic-rejection-probe"
+              name: "Creative for rejection probe"
+              format_kind: "image"
+              assets:
+                image:
+                  asset_type: "image"
+                  url: "https://test-assets.adcontextprotocol.org/acme-outdoor/banner_300x250.jpg"
+                  width: 300
+                  height: 250
+          idempotency_key: "$generate:uuid_v4#deterministic_testing_sync_fresh_creative_for_rejection"
+          context:
+            correlation_id: "deterministic_testing--sync_fresh_creative_for_rejection"
+        context_outputs:
+          - path: "creatives[0].creative_id"
+            name: "fresh_creative_id"
+        validations:
+          - check: response_schema
+            description: "Response matches sync-creatives-response.json schema"
+          - check: field_present
+            path: "creatives[0].creative_id"
+            description: "Response includes the seller's creative_id for the fresh creative"
+
+      - id: force_creative_rejected
+        title: 'Force fresh creative to rejected with reason'
+        requires_tool: comply_test_controller
+        narrative: |
+          Reject the fresh creative (captured as $context.fresh_creative_id)
+          with a reason string. Verifies the controller supports rejection
+          reasons. Uses the fresh id — NOT the archived one from the prior
+          phase, since archived→rejected is not a valid creative-state
+          transition.
+        task: comply_test_controller
+        comply_scenario: deterministic_creative
+        stateful: true
+        expected: |
+          Successful transition to rejected with reason preserved.
+
+        sample_request:
+          account:
+            sandbox: true
+          brand:
+            domain: 'acmeoutdoor.example'
+          scenario: 'force_creative_status'
+          params:
+            creative_id: '$context.fresh_creative_id'
+            status: 'rejected'
+            rejection_reason: 'Brand safety policy violation (comply test)'
+
+          context:
+            correlation_id: "deterministic_testing--force_creative_rejected"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - true
+            description: 'Creative rejection succeeds'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--force_creative_rejected"
+            description: "Context correlation_id returned unchanged"
+  - id: deterministic_session
+    title: 'Deterministic SI session state machine'
+    narrative: |
+      Initiates an SI session, then uses the controller to force session timeout.
+      Verifies that messaging on a terminated session fails appropriately.
+
+    # Phase establishes its own session via initiate_session; doesn't consume
+    # state from earlier deterministic_* phases. Explicit empty depends_on
+    # prevents the runner's default "depend on all prior phases" from
+    # cascade-skipping this phase when an unrelated upstream phase trips.
+    depends_on: []
+    requires_capability:
+      path: supported_protocols
+      contains: sponsored_intelligence
+
+    steps:
+      - id: initiate_session
+        title: 'Initiate SI session'
+        requires_tool: si_initiate_session
+        narrative: |
+          Create an SI session via si_initiate_session. The session_id is captured
+          for controller-driven termination.
+        task: si_initiate_session
+        schema_ref: 'sponsored-intelligence/si-initiate-session-request.json'
+        response_schema_ref: 'sponsored-intelligence/si-initiate-session-response.json'
+        comply_scenario: deterministic_session
+        stateful: true
+        context_outputs:
+          - name: session_id
+            path: 'session_id'
+        expected: |
+          Return a session with a session_id.
+
+        sample_request:
+          intent: "comply test — initiate deterministic SI session"
+          identity:
+            consent_granted: true
+            user_type: 'consumer'
+          supported_capabilities:
+            response_formats:
+              - 'text'
+
+          idempotency_key: "$generate:uuid_v4#deterministic_testing_deterministic_session_initiate_session"
+          context:
+            correlation_id: "deterministic_testing--initiate_session"
+        validations:
+          - check: field_present
+            path: 'session_id'
+            description: 'Session has a session_id'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--initiate_session"
+            description: "Context correlation_id returned unchanged"
+      # Keep both follow-up steps gated on the phase's anchor tool. Older
+      # runners that miss phase-level capability gates still cascade-skip them
+      # when si_initiate_session is unavailable.
+      - id: force_session_terminated
+        title: 'Force session timeout'
+        requires_tool: si_initiate_session
+        narrative: |
+          Use the controller to force the session into terminated state with
+          termination_reason: session_timeout.
+        task: comply_test_controller
+        comply_scenario: deterministic_session
+        stateful: true
+        expected: |
+          Successful transition to terminated.
+
+        sample_request:
+          account:
+            sandbox: true
+          scenario: 'force_session_status'
+          params:
+            session_id: '$context.session_id'
+            status: 'terminated'
+            termination_reason: 'session_timeout'
+
+          context:
+            correlation_id: "deterministic_testing--force_session_terminated"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - true
+            description: 'Session termination succeeds'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--force_session_terminated"
+            description: "Context correlation_id returned unchanged"
+      - id: verify_terminated_session
+        title: 'Verify messaging fails on terminated session'
+        requires_tool: si_initiate_session
+        narrative: |
+          Attempt to send a message on the terminated session. The agent must
+          reject with SESSION_TERMINATED — per si-send-message-response.json,
+          terminated sessions return error codes (SESSION_NOT_FOUND or
+          SESSION_TERMINATED) rather than a success response.
+        task: si_send_message
+        schema_ref: 'sponsored-intelligence/si-send-message-request.json'
+        response_schema_ref: 'sponsored-intelligence/si-send-message-response.json'
+        comply_scenario: deterministic_session
+        stateful: true
+        expect_error: true
+        negative_path: payload_well_formed
+        expected: |
+          The request must fail with error code SESSION_TERMINATED. The agent
+          must not accept messages on a terminated session.
+
+        sample_request:
+          session_id: '$context.session_id'
+          message: 'comply test — session should be terminated'
+
+          idempotency_key: "$generate:uuid_v4#deterministic_testing_deterministic_session_verify_terminated_session"
+          context:
+            correlation_id: "deterministic_testing--verify_terminated_session"
+        validations:
+          - check: error_code
+            value: 'SESSION_TERMINATED'
+            description: 'Message on terminated session fails with SESSION_TERMINATED'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object even on errors"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--verify_terminated_session"
+            description: "Context correlation_id returned unchanged"
+  - id: deterministic_delivery
+    title: 'Deterministic delivery simulation'
+    narrative: |
+      Creates a media buy, simulates delivery data via the controller, then verifies
+      the simulated metrics are reflected in get_media_buy_delivery.
+
+    # Phase creates its own media buy via create_media_buy_for_delivery; doesn't
+    # consume state from earlier deterministic_* phases. In particular, must not
+    # cascade-skip when deterministic_session skips for missing si_initiate_session
+    # on non-SI sellers (adcp-client#1711 follow-up).
+    depends_on: []
+    requires_capability:
+      path: supported_protocols
+      contains: media_buy
+
+    steps:
+      - id: create_media_buy_for_delivery
+        title: 'Create media buy for delivery test'
+        requires_tool: comply_test_controller
+        narrative: |
+          Create a media buy to receive simulated delivery data.
+        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: deterministic_delivery
+        stateful: true
+        context_outputs:
+          - name: delivery_media_buy_id
+            path: 'media_buy_id'
+        expected: |
+          Create a media buy and return a media_buy_id.
+
+        sample_request:
+          account:
+            brand:
+              domain: 'acmeoutdoor.example'
+            operator: 'pinnacle-agency.example'
+          brand:
+            domain: 'acmeoutdoor.example'
+          start_time: 'asap'
+          end_time: '2099-06-30T23:59:59Z'
+          packages:
+            - product_id: 'test-product'
+              budget: 5000
+              pricing_option_id: 'test-pricing'
+
+          idempotency_key: "$generate:uuid_v4#deterministic_testing_deterministic_delivery_create_media_buy_for_delivery"
+          context:
+            correlation_id: "deterministic_testing--create_media_buy_for_delivery"
+        validations:
+          - check: response_schema
+            description: 'Response matches create-media-buy-response.json schema'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--create_media_buy_for_delivery"
+            description: "Context correlation_id returned unchanged"
+      - id: simulate_delivery
+        title: 'Simulate delivery data'
+        requires_tool: comply_test_controller
+        narrative: |
+          Inject simulated delivery metrics (impressions, clicks, spend) into the
+          media buy via the controller.
+        task: comply_test_controller
+        comply_scenario: deterministic_delivery
+        stateful: true
+        expected: |
+          Return success with simulated delivery metrics acknowledged.
+
+        sample_request:
+          account:
+            sandbox: true
+          brand:
+            domain: 'acmeoutdoor.example'
+          scenario: 'simulate_delivery'
+          params:
+            media_buy_id: '$context.delivery_media_buy_id'
+            impressions: 10000
+            clicks: 150
+            reported_spend:
+              amount: 150.00
+              currency: 'USD'
+
+          context:
+            correlation_id: "deterministic_testing--simulate_delivery"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - true
+            description: 'Delivery simulation succeeds'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--simulate_delivery"
+            description: "Context correlation_id returned unchanged"
+      - id: verify_delivery
+        title: 'Verify delivery via get_media_buy_delivery'
+        requires_tool: comply_test_controller
+        narrative: |
+          Call get_media_buy_delivery and verify the simulated metrics are reflected
+          in the response. Expect at least 10000 impressions.
+        task: get_media_buy_delivery
+        schema_ref: 'media-buy/get-media-buy-delivery-request.json'
+        response_schema_ref: 'media-buy/get-media-buy-delivery-response.json'
+        doc_ref: '/media-buy/task-reference/get_media_buy_delivery'
+        comply_scenario: deterministic_delivery
+        stateful: true
+        expected: |
+          Return delivery metrics reflecting the simulated data:
+          - impressions >= 10000
+          - clicks and spend data present
+
+        sample_request:
+          account:
+            brand:
+              domain: 'acmeoutdoor.example'
+            operator: 'pinnacle-agency.example'
+          media_buy_ids:
+            - '$context.delivery_media_buy_id'
+
+          context:
+            correlation_id: "deterministic_testing--verify_delivery"
+        validations:
+          - check: response_schema
+            description: 'Response matches get-media-buy-delivery-response.json schema'
+          - check: field_present
+            path: 'media_buy_deliveries'
+            description: 'Response contains delivery data'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--verify_delivery"
+            description: "Context correlation_id returned unchanged"
+  - id: deterministic_budget
+    title: 'Deterministic budget simulation'
+    narrative: |
+      Creates a media buy, then uses the controller to simulate budget spend at 95%
+      and 100%. Verifies the agent handles near-depletion and full depletion.
+
+    # Phase creates its own media buy via create_media_buy_for_budget; doesn't
+    # consume state from earlier deterministic_* phases. In particular, must not
+    # cascade-skip when deterministic_session skips for missing si_initiate_session
+    # on non-SI sellers (adcp-client#1711 follow-up).
+    depends_on: []
+    requires_capability:
+      path: supported_protocols
+      contains: media_buy
+
+    steps:
+      - id: create_media_buy_for_budget
+        title: 'Create media buy for budget test'
+        requires_tool: comply_test_controller
+        narrative: |
+          Create a media buy with a known budget for spend simulation.
+        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: deterministic_budget
+        stateful: true
+        context_outputs:
+          - name: budget_media_buy_id
+            path: 'media_buy_id'
+        expected: |
+          Create a media buy and return a media_buy_id.
+
+        sample_request:
+          account:
+            brand:
+              domain: 'acmeoutdoor.example'
+            operator: 'pinnacle-agency.example'
+          brand:
+            domain: 'acmeoutdoor.example'
+          start_time: 'asap'
+          end_time: '2099-06-30T23:59:59Z'
+          packages:
+            - product_id: 'test-product'
+              budget: 10000
+              pricing_option_id: 'test-pricing'
+
+          idempotency_key: "$generate:uuid_v4#deterministic_testing_deterministic_budget_create_media_buy_for_budget"
+          context:
+            correlation_id: "deterministic_testing--create_media_buy_for_budget"
+        validations:
+          - check: response_schema
+            description: 'Response matches create-media-buy-response.json schema'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--create_media_buy_for_budget"
+            description: "Context correlation_id returned unchanged"
+      - id: simulate_budget_95
+        title: 'Simulate 95% budget spend'
+        requires_tool: comply_test_controller
+        narrative: |
+          Simulate 95% of the media buy budget being spent. The agent should
+          handle near-depletion state.
+        task: comply_test_controller
+        comply_scenario: deterministic_budget
+        stateful: true
+        expected: |
+          Return success with budget spend simulated to 95%.
+
+        sample_request:
+          account:
+            sandbox: true
+          brand:
+            domain: 'acmeoutdoor.example'
+          scenario: 'simulate_budget_spend'
+          params:
+            media_buy_id: '$context.budget_media_buy_id'
+            spend_percentage: 95
+
+          context:
+            correlation_id: "deterministic_testing--simulate_budget_95"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - true
+            description: '95% budget simulation succeeds'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--simulate_budget_95"
+            description: "Context correlation_id returned unchanged"
+      - id: simulate_budget_100
+        title: 'Simulate 100% budget depletion'
+        requires_tool: comply_test_controller
+        narrative: |
+          Simulate complete budget depletion. The agent should handle the fully
+          spent state.
+        task: comply_test_controller
+        comply_scenario: deterministic_budget
+        stateful: true
+        expected: |
+          Return success with budget fully depleted.
+
+        sample_request:
+          account:
+            sandbox: true
+          brand:
+            domain: 'acmeoutdoor.example'
+          scenario: 'simulate_budget_spend'
+          params:
+            media_buy_id: '$context.budget_media_buy_id'
+            spend_percentage: 100
+
+          context:
+            correlation_id: "deterministic_testing--simulate_budget_100"
+        validations:
+          - check: field_value
+            path: 'success'
+            allowed_values:
+              - true
+            description: '100% budget depletion simulation succeeds'
+
+          - check: field_present
+            path: "context"
+            description: "Response echoes back the context object"
+          - check: field_value
+            path: "context.correlation_id"
+            value: "deterministic_testing--simulate_budget_100"
+            description: "Context correlation_id returned unchanged"