@adcp/client 4.21.0 → 4.22.1

package/storyboards/deterministic_testing.yaml

@@ -0,0 +1,925 @@
+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
+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.
+  test_kit: "test-kits/acme-outdoor.yaml"
+
+phases:
+  - 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:
+          scenario: "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"
+
+      - 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
+        expected: |
+          Return an error response with:
+          - success: false
+          - error: UNKNOWN_SCENARIO
+
+        sample_request:
+          scenario: "nonexistent_scenario"
+          params: {}
+
+        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"
+
+      - 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 error code.
+        task: comply_test_controller
+        comply_scenario: controller_validation
+        stateful: false
+        expected: |
+          Return an error response with:
+          - success: false
+          - error: INVALID_PARAMS
+
+        sample_request:
+          scenario: "force_creative_status"
+          params: {}
+
+        validations:
+          - check: field_value
+            path: "success"
+            allowed_values:
+              - false
+            description: "Missing params fails"
+          - check: field_value
+            path: "error"
+            allowed_values:
+              - "INVALID_PARAMS"
+            description: "Error code is INVALID_PARAMS"
+
+      - 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 error code.
+        task: comply_test_controller
+        comply_scenario: controller_validation
+        stateful: false
+        expected: |
+          Return an error response with:
+          - success: false
+          - error: NOT_FOUND
+
+        sample_request:
+          scenario: "force_creative_status"
+          params:
+            creative_id: "comply-test-nonexistent-000000000000"
+            status: "approved"
+
+        validations:
+          - check: field_value
+            path: "success"
+            allowed_values:
+              - false
+            description: "Nonexistent entity fails"
+          - check: field_value
+            path: "error"
+            allowed_values:
+              - "NOT_FOUND"
+            description: "Error code is NOT_FOUND"
+
+  - 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.
+
+    steps:
+      - 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: {}
+
+        validations:
+          - check: field_present
+            path: "accounts[0].account_id"
+            description: "At least one account exists"
+
+      - 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:
+          scenario: "force_account_status"
+          params:
+            account_id: "{{account_id}}"
+            status: "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"
+
+      - 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:
+          scenario: "force_account_status"
+          params:
+            account_id: "{{account_id}}"
+            status: "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"
+
+      - 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:
+          scenario: "force_account_status"
+          params:
+            account_id: "{{account_id}}"
+            status: "payment_required"
+
+        validations:
+          - check: field_value
+            path: "success"
+            allowed_values:
+              - true
+            description: "Transition to payment_required succeeds"
+
+      - 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:
+          scenario: "force_account_status"
+          params:
+            account_id: "{{account_id}}"
+            status: "active"
+
+        validations:
+          - check: field_value
+            path: "success"
+            allowed_values:
+              - true
+            description: "Account restored to active"
+
+  - 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.
+
+    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.com"
+            operator: "pinnacle-agency.com"
+          brand:
+            domain: "acmeoutdoor.com"
+          start_time: "2026-04-01T00:00:00Z"
+          end_time: "2026-06-30T23:59:59Z"
+          packages:
+            - product_id: "test-product"
+              budget: 5000
+              pricing_option_id: "test-pricing"
+
+        validations:
+          - check: response_schema
+            description: "Response matches create-media-buy-response.json schema"
+
+      - 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:
+          scenario: "force_media_buy_status"
+          params:
+            media_buy_id: "{{media_buy_id}}"
+            status: "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"
+
+      - 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.com"
+            operator: "pinnacle-agency.com"
+          media_buy_ids:
+            - "{{media_buy_id}}"
+
+        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"
+
+      - 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:
+          scenario: "force_media_buy_status"
+          params:
+            media_buy_id: "{{media_buy_id}}"
+            status: "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"
+
+      - 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
+        expected: |
+          Return an error response:
+          - success: false
+          - error: INVALID_TRANSITION
+
+        sample_request:
+          scenario: "force_media_buy_status"
+          params:
+            media_buy_id: "{{media_buy_id}}"
+            status: "active"
+
+        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"
+
+  - 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.
+
+    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: "results[0].creative_id"
+        expected: |
+          Accept the creative and return a creative_id for state machine testing.
+
+        sample_request:
+          account:
+            brand:
+              domain: "acmeoutdoor.com"
+            operator: "pinnacle-agency.com"
+          creatives:
+            - creative_id: "comply-state-test-creative"
+              name: "Comply State Test Creative"
+              format_id:
+                agent_url: "https://your-platform.example.com"
+                id: "display_300x250"
+              assets:
+                - asset_id: "image"
+                  asset_type: "image"
+                  url: "https://via.placeholder.com/300x250"
+                  mime_type: "image/png"
+
+        validations:
+          - check: response_schema
+            description: "Response matches sync-creatives-response.json schema"
+
+      - 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:
+          scenario: "force_creative_status"
+          params:
+            creative_id: "{{creative_id}}"
+            status: "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"
+
+      - 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:
+          scenario: "force_creative_status"
+          params:
+            creative_id: "{{creative_id}}"
+            status: "archived"
+
+        validations:
+          - check: field_value
+            path: "success"
+            allowed_values:
+              - true
+            description: "Transition to archived succeeds"
+
+      - 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
+        expected: |
+          Return error with INVALID_TRANSITION.
+
+        sample_request:
+          scenario: "force_creative_status"
+          params:
+            creative_id: "{{creative_id}}"
+            status: "processing"
+
+        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"
+
+      - id: force_creative_rejected
+        title: "Force fresh creative to rejected with reason"
+        requires_tool: comply_test_controller
+        narrative: |
+          Sync a fresh creative, force it to pending_review, then reject it with a
+          reason string. Verifies the controller supports rejection reasons.
+        task: comply_test_controller
+        comply_scenario: deterministic_creative
+        stateful: true
+        expected: |
+          Successful transition to rejected with reason preserved.
+
+        sample_request:
+          scenario: "force_creative_status"
+          params:
+            creative_id: "{{creative_id}}"
+            status: "rejected"
+            rejection_reason: "Brand safety policy violation (comply test)"
+
+        validations:
+          - check: field_value
+            path: "success"
+            allowed_values:
+              - true
+            description: "Creative rejection succeeds"
+
+  - 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.
+
+    steps:
+      - id: initiate_session
+        title: "Initiate SI session"
+        requires_tool: comply_test_controller
+        narrative: |
+          Create an SI session via si_initiate_session. The session_id is captured
+          for controller-driven termination.
+        task: si_initiate_session
+        comply_scenario: deterministic_session
+        stateful: true
+        context_outputs:
+          - name: session_id
+            path: "session_id"
+        expected: |
+          Return a session with a session_id.
+
+        sample_request:
+          identity:
+            user_type: "consumer"
+          supported_capabilities:
+            response_formats:
+              - "text"
+
+        validations:
+          - check: field_present
+            path: "session_id"
+            description: "Session has a session_id"
+
+      - id: force_session_terminated
+        title: "Force session timeout"
+        requires_tool: comply_test_controller
+        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:
+          scenario: "force_session_status"
+          params:
+            session_id: "{{session_id}}"
+            status: "terminated"
+            termination_reason: "session_timeout"
+
+        validations:
+          - check: field_value
+            path: "success"
+            allowed_values:
+              - true
+            description: "Session termination succeeds"
+
+      - id: verify_terminated_session
+        title: "Verify messaging fails on terminated session"
+        requires_tool: comply_test_controller
+        narrative: |
+          Attempt to send a message on the terminated session. The agent should
+          return an error or terminated status.
+        task: si_send_message
+        comply_scenario: deterministic_session
+        stateful: true
+        expected: |
+          The request should fail or return session_status: terminated. The agent
+          must not accept messages on a terminated session.
+
+        sample_request:
+          session_id: "{{session_id}}"
+          message: "comply test — session should be terminated"
+
+        validations:
+          - check: field_value
+            path: "success"
+            allowed_values:
+              - false
+            description: "Message on terminated session fails"
+
+  - 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.
+
+    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.com"
+            operator: "pinnacle-agency.com"
+          brand:
+            domain: "acmeoutdoor.com"
+          start_time: "2026-04-01T00:00:00Z"
+          end_time: "2026-06-30T23:59:59Z"
+          packages:
+            - product_id: "test-product"
+              budget: 5000
+              pricing_option_id: "test-pricing"
+
+        validations:
+          - check: response_schema
+            description: "Response matches create-media-buy-response.json schema"
+
+      - 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:
+          scenario: "simulate_delivery"
+          params:
+            media_buy_id: "{{delivery_media_buy_id}}"
+            impressions: 10000
+            clicks: 150
+            reported_spend:
+              amount: 150.00
+              currency: "USD"
+
+        validations:
+          - check: field_value
+            path: "success"
+            allowed_values:
+              - true
+            description: "Delivery simulation succeeds"
+
+      - 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.com"
+            operator: "pinnacle-agency.com"
+          media_buy_ids:
+            - "{{delivery_media_buy_id}}"
+
+        validations:
+          - check: response_schema
+            description: "Response matches get-media-buy-delivery-response.json schema"
+          - check: field_present
+            path: "media_buys"
+            description: "Response contains delivery data"
+
+  - 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.
+
+    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.com"
+            operator: "pinnacle-agency.com"
+          brand:
+            domain: "acmeoutdoor.com"
+          start_time: "2026-04-01T00:00:00Z"
+          end_time: "2026-06-30T23:59:59Z"
+          packages:
+            - product_id: "test-product"
+              budget: 10000
+              pricing_option_id: "test-pricing"
+
+        validations:
+          - check: response_schema
+            description: "Response matches create-media-buy-response.json schema"
+
+      - 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:
+          scenario: "simulate_budget_spend"
+          params:
+            media_buy_id: "{{budget_media_buy_id}}"
+            spend_percentage: 95
+
+        validations:
+          - check: field_value
+            path: "success"
+            allowed_values:
+              - true
+            description: "95% budget simulation succeeds"
+
+      - 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:
+          scenario: "simulate_budget_spend"
+          params:
+            media_buy_id: "{{budget_media_buy_id}}"
+            spend_percentage: 100
+
+        validations:
+          - check: field_value
+            path: "success"
+            allowed_values:
+              - true
+            description: "100% budget depletion simulation succeeds"