@adcp/sdk 14.0.0-rc.38 → 14.0.0-rc.39

package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/governance_conditions.yaml

@@ -1,199 +0,0 @@
-id: media_buy_seller/governance_conditions
-version: "1.0.0"
-title: "Seller attaches conditions when governance approves with conditions"
-category: media_buy_seller
-summary: "Verifies that the seller attaches governance conditions to the buy when governance approves with conditions."
-track: media_buy
-required_tools:
-  - sync_governance
-  - get_products
-  - create_media_buy
-
-narrative: |
-  This is a multi-agent test. The test harness sets up a governance plan on a governance
-  agent with custom policies that trigger conditions (e.g., "CTV buys require weekly
-  delivery reporting"). The buyer creates a CTV buy within budget but matching a policy.
-
-  When the seller calls check_governance, the governance agent approves with conditions.
-  The seller must create the buy and include the governance conditions and context token
-  in its response.
-
-  By default, the governance agent is the training agent at test-agent.adcontextprotocol.org.
-  Override by supplying a different `governance_agent_url` in the run's initial context
-  (e.g., via `--context` on `adcp storyboard run` once the CLI supports it).
-
-context:
-  governance_agent_url: "https://test-agent.adcontextprotocol.org"
-
-agent:
-  interaction_model: media_buy_seller
-  capabilities:
-    - sells_media
-    - governance_aware
-  examples:
-    - "Any media buy seller with governance support"
-
-caller:
-  role: buyer_agent
-  example: "Pinnacle Agency (buyer)"
-
-prerequisites:
-  description: |
-    A governance agent that supports sync_plans and check_governance.
-  test_kit: "test-kits/acme-outdoor.yaml"
-
-phases:
-  - id: governance_plan_setup
-    title: "Set up conditional governance plan"
-    narrative: |
-      Create a governance plan on the governance agent with custom policies that
-      trigger conditions. The plan has sufficient budget but policies that require
-      conditions on CTV buys.
-
-    steps:
-      - id: sync_plans
-        title: "Create conditional governance plan"
-        task: sync_plans
-        schema_ref: "governance/sync-plans-request.json"
-        response_schema_ref: "governance/sync-plans-response.json"
-        doc_ref: "/governance/campaign/tasks/sync_plans"
-        stateful: true
-        expected: |
-          The governance agent acknowledges the plan with a plan_id.
-        sample_request:
-          idempotency_key: "$generate:uuid_v4#governance_conditions_sync_plans"
-          plans:
-            - plan_id: "comply-gov-conditions-plan"
-              brand:
-                domain: "acmeoutdoor.example"
-              objectives: "Q2 CTV campaign with reporting requirements"
-              budget:
-                total: 100000
-                currency: "USD"
-                reallocation_threshold: 100000
-              flight:
-                start: "2026-04-01T00:00:00Z"
-                end: "2026-06-30T23:59:59Z"
-              countries: ["US", "CA"]
-              custom_policies:
-                - policy_id: "ctv_weekly_reporting"
-                  enforcement: "must"
-                  policy: "CTV buys require weekly delivery reporting."
-                - policy_id: "ugc_brand_safety"
-                  enforcement: "must"
-                  policy: "UGC placements require brand safety review before activation."
-        validations:
-          - check: response_schema
-            description: "Response matches sync-plans-response.json schema"
-
-  - id: seller_setup
-    title: "Account and governance registration on seller"
-    steps:
-      - id: sync_accounts
-        title: "Establish account with seller"
-        task: sync_accounts
-        schema_ref: "account/sync-accounts-request.json"
-        response_schema_ref: "account/sync-accounts-response.json"
-        doc_ref: "/accounts/tasks/sync_accounts"
-        stateful: true
-        expected: |
-          Return the account with account_id and status active.
-        sample_request:
-          accounts:
-            - brand:
-                domain: "acmeoutdoor.example"
-              operator: "pinnacle-agency.example"
-              billing: "operator"
-              payment_terms: "net_30"
-          idempotency_key: "$generate:uuid_v4#media_buy_seller_governance_conditions_seller_setup_sync_accounts"
-        validations:
-          - check: response_schema
-            description: "Response matches sync-accounts-response.json schema"
-          - check: field_present
-            path: "accounts[0].account_id"
-            description: "Account has a platform-assigned ID"
-
-      - id: sync_governance
-        title: "Register governance agent with seller"
-        task: sync_governance
-        schema_ref: "account/sync-governance-request.json"
-        response_schema_ref: "account/sync-governance-response.json"
-        doc_ref: "/accounts/tasks/sync_governance"
-        stateful: true
-        expected: |
-          Acknowledge the governance agent registration.
-        sample_request:
-          accounts:
-            - account:
-                brand:
-                  domain: "acmeoutdoor.example"
-                operator: "pinnacle-agency.example"
-              governance_agents:
-                - url: "$context.governance_agent_url"
-                  authentication:
-                    schemes: ["Bearer"]
-                    credentials: "gov-token-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
-          idempotency_key: "$generate:uuid_v4#media_buy_seller_governance_conditions_seller_setup_sync_governance"
-        validations:
-          - check: response_schema
-            description: "Response matches sync-governance-response.json schema"
-
-  - id: buy_with_conditions
-    title: "Create CTV buy triggering governance conditions"
-    steps:
-      - id: get_products_brief
-        title: "Discover CTV products"
-        task: get_products
-        schema_ref: "media-buy/get-products-request.json"
-        response_schema_ref: "media-buy/get-products-response.json"
-        doc_ref: "/media-buy/task-reference/get_products"
-        comply_scenario: full_sales_flow
-        stateful: false
-        expected: |
-          Return CTV/video products matching the brief.
-        sample_request:
-          buying_mode: "brief"
-          brief: "CTV and connected TV inventory on outdoor lifestyle content. Q2 flight, $25K budget. Adults 25-54, US."
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-        validations:
-          - check: response_schema
-            description: "Response matches get-products-response.json schema"
-          - check: field_present
-            path: "products"
-            description: "Response contains products"
-
-      - id: create_media_buy_conditions
-        title: "Create CTV buy (governance approves with conditions)"
-        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: create_media_buy
-        stateful: true
-        expected: |
-          The buy succeeds with governance conditions attached:
-          - media_buy_id: present
-          - media_buy_status: active, pending_start, or pending_creatives (deprecated top-level status may mirror this during the 3.1 migration window)
-          - governance_context: token from the governance agent
-          - conditions visible to the buyer
-        sample_request:
-          brand:
-            domain: "acmeoutdoor.example"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            sandbox: true
-          start_time: "2026-04-01T00:00:00Z"
-          end_time: "2026-06-30T23:59:59Z"
-          packages:
-            - product_id: "outdoor_ctv_q2"
-              budget: 25000
-              pricing_option_id: "cpm_standard"
-          idempotency_key: "$generate:uuid_v4#media_buy_seller_governance_conditions_buy_with_conditions_create_media_buy_conditions"
-        validations:
-          - check: response_schema
-            description: "Response matches create-media-buy-response.json schema"

package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/governance_denied.yaml

@@ -1,204 +0,0 @@
-id: media_buy_seller/governance_denied
-version: "1.0.0"
-title: "Seller rejects buy when governance denies"
-category: media_buy_seller
-summary: "Verifies that the seller rejects a media buy and propagates the denial when governance denies the transaction."
-track: media_buy
-required_tools:
-  - sync_governance
-  - get_products
-  - create_media_buy
-
-narrative: |
-  This is a multi-agent test. The test harness sets up a governance plan on a governance
-  agent with a strict $10K budget, then registers that agent with the seller. The buyer
-  attempts a $50K media buy which exceeds the plan's budget.
-
-  When the seller calls check_governance, the governance agent denies because the
-  requested budget exceeds the plan total. The seller must reject the buy and propagate
-  the denial back to the buyer.
-
-  By default, the governance agent is the training agent at test-agent.adcontextprotocol.org.
-  Override by supplying a different `governance_agent_url` in the run's initial context
-  (e.g., via `--context` on `adcp storyboard run` once the CLI supports it).
-
-context:
-  governance_agent_url: "https://test-agent.adcontextprotocol.org"
-
-agent:
-  interaction_model: media_buy_seller
-  capabilities:
-    - sells_media
-    - governance_aware
-  examples:
-    - "Any media buy seller with governance support"
-
-caller:
-  role: buyer_agent
-  example: "Pinnacle Agency (buyer)"
-
-prerequisites:
-  description: |
-    A governance agent that supports sync_plans and check_governance.
-  test_kit: "test-kits/acme-outdoor.yaml"
-
-phases:
-  - id: governance_plan_setup
-    title: "Set up strict governance plan"
-    narrative: |
-      Create a governance plan on the governance agent with a strict $10K budget
-      and agent_limited authority. The subsequent $50K buy will exceed the plan
-      budget and should be denied.
-
-    steps:
-      - id: sync_plans
-        title: "Create strict governance plan"
-        task: sync_plans
-        schema_ref: "governance/sync-plans-request.json"
-        response_schema_ref: "governance/sync-plans-response.json"
-        doc_ref: "/governance/campaign/tasks/sync_plans"
-        stateful: true
-        expected: |
-          The governance agent acknowledges the plan with a plan_id.
-        sample_request:
-          idempotency_key: "$generate:uuid_v4#governance_denied_sync_plans"
-          plans:
-            - plan_id: "comply-gov-denied-plan"
-              brand:
-                domain: "acmeoutdoor.example"
-              objectives: "Small test campaign — limited budget authority"
-              budget:
-                total: 10000
-                currency: "USD"
-                reallocation_threshold: 5000
-              flight:
-                start: "2026-04-01T00:00:00Z"
-                end: "2026-06-30T23:59:59Z"
-              countries: ["US"]
-        validations:
-          - check: response_schema
-            description: "Response matches sync-plans-response.json schema"
-
-  - id: seller_setup
-    title: "Account and governance registration on seller"
-    steps:
-      - id: sync_accounts
-        title: "Establish account with seller"
-        task: sync_accounts
-        schema_ref: "account/sync-accounts-request.json"
-        response_schema_ref: "account/sync-accounts-response.json"
-        doc_ref: "/accounts/tasks/sync_accounts"
-        stateful: true
-        expected: |
-          Return the account with account_id and status active.
-        sample_request:
-          accounts:
-            - brand:
-                domain: "acmeoutdoor.example"
-              operator: "pinnacle-agency.example"
-              billing: "operator"
-              payment_terms: "net_30"
-          idempotency_key: "$generate:uuid_v4#media_buy_seller_governance_denied_seller_setup_sync_accounts"
-        validations:
-          - check: response_schema
-            description: "Response matches sync-accounts-response.json schema"
-          - check: field_present
-            path: "accounts[0].account_id"
-            description: "Account has a platform-assigned ID"
-
-      - id: sync_governance
-        title: "Register governance agent with seller"
-        task: sync_governance
-        schema_ref: "account/sync-governance-request.json"
-        response_schema_ref: "account/sync-governance-response.json"
-        doc_ref: "/accounts/tasks/sync_governance"
-        stateful: true
-        expected: |
-          Acknowledge the governance agent registration.
-        sample_request:
-          accounts:
-            - account:
-                brand:
-                  domain: "acmeoutdoor.example"
-                operator: "pinnacle-agency.example"
-              governance_agents:
-                - url: "$context.governance_agent_url"
-                  authentication:
-                    schemes: ["Bearer"]
-                    credentials: "gov-token-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
-          idempotency_key: "$generate:uuid_v4#media_buy_seller_governance_denied_seller_setup_sync_governance"
-        validations:
-          - check: response_schema
-            description: "Response matches sync-governance-response.json schema"
-
-  - id: buy_denied
-    title: "Create buy exceeding governance limits"
-    steps:
-      - id: get_products_brief
-        title: "Discover products"
-        task: get_products
-        schema_ref: "media-buy/get-products-request.json"
-        response_schema_ref: "media-buy/get-products-response.json"
-        doc_ref: "/media-buy/task-reference/get_products"
-        comply_scenario: full_sales_flow
-        stateful: false
-        expected: |
-          Return products matching the brief.
-        sample_request:
-          buying_mode: "brief"
-          brief: "Premium video and display on outdoor lifestyle. Q2 flight, $50K budget. Adults 25-54, US."
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-        validations:
-          - check: response_schema
-            description: "Response matches get-products-response.json schema"
-          - check: field_present
-            path: "products"
-            description: "Response contains products"
-
-      - id: create_media_buy_denied
-        title: "Create buy (governance denies — should fail)"
-        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: create_media_buy
-        stateful: true
-        expect_error: true
-        negative_path: payload_well_formed
-        expected: |
-          The buy is rejected because governance denied — the $50K buy exceeds
-          the plan's $10K budget. The seller propagates the denial with findings.
-
-          Wire placement (Case-2 of the GOVERNANCE_DENIED rule). `create_media_buy`
-          has no structured rejection arm (its `oneOf` covers Success / Error /
-          Submitted only), so the seller populates `errors[].code: GOVERNANCE_DENIED`
-          in the payload AND `adcp_error.code: GOVERNANCE_DENIED` on the envelope per
-          the two-layer model, AND flips transport-level failure markers (HTTP 4xx /
-          MCP `isError: true` / A2A `failed`). Compare with `brand_rights/governance_denied`,
-          which exercises Case-1 (rejection arm is the canonical denial shape; no
-          error code on the wire; transport markers stay green).
-        sample_request:
-          brand:
-            domain: "acmeoutdoor.example"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-            sandbox: true
-          idempotency_key: "$generate:uuid_v4#governance_denied_create_media_buy"
-          start_time: "2026-04-01T00:00:00Z"
-          end_time: "2026-06-30T23:59:59Z"
-          packages:
-            - product_id: "outdoor_display_q2"
-              budget: 30000
-              pricing_option_id: "cpm_standard"
-            - product_id: "outdoor_video_q2"
-              budget: 20000
-              pricing_option_id: "cpm_standard"
-        validations:
-          - check: error_code
-            value: "GOVERNANCE_DENIED"
-            description: "Error code indicates governance denial — Case-2 wire placement: create_media_buy has no rejection arm, so GOVERNANCE_DENIED surfaces via errors[].code or adcp_error.code (per the two-layer model in error-handling.mdx)"

package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/governance_denied_recovery.yaml

@@ -1,252 +0,0 @@
-id: media_buy_seller/governance_denied_recovery
-version: "1.0.0"
-title: "Seller accepts corrected buy after governance denial"
-category: media_buy_seller
-summary: "Verifies that a buyer can recover from GOVERNANCE_DENIED by shrinking the buy to within plan limits and retrying."
-track: media_buy
-required_tools:
-  - sync_governance
-  - get_products
-  - create_media_buy
-
-narrative: |
-  GOVERNANCE_DENIED is a correctable error, not a dead end. The buyer must be able to
-  read the denial findings, adjust the media buy, and retry. This scenario exercises the
-  full loop: strict governance plan ($10K), failed $50K buy that is denied, then a
-  corrected $8K buy that fits within the plan and is approved.
-
-  The seller must propagate the governance findings unchanged so the buyer can identify
-  exactly which constraint was violated (budget authority, brand policy, etc.) and
-  correct it.
-
-  By default, the governance agent is the training agent at test-agent.adcontextprotocol.org.
-  Override by supplying a different `governance_agent_url` in the run's initial context
-  (e.g., via `--context` on `adcp storyboard run` once the CLI supports it).
-
-context:
-  governance_agent_url: "https://test-agent.adcontextprotocol.org"
-
-agent:
-  interaction_model: media_buy_seller
-  capabilities:
-    - sells_media
-    - governance_aware
-  examples:
-    - "Any media buy seller with governance support"
-
-caller:
-  role: buyer_agent
-  example: "Pinnacle Agency (buyer)"
-
-prerequisites:
-  description: |
-    A governance agent that supports sync_plans and check_governance.
-  test_kit: "test-kits/acme-outdoor.yaml"
-
-phases:
-  - id: governance_plan_setup
-    title: "Set up strict governance plan"
-    narrative: |
-      Create a governance plan with a $10K budget. The initial $50K buy will exceed this
-      limit; the retry at $8K will fit.
-
-    steps:
-      - id: sync_plans
-        title: "Create strict governance plan"
-        task: sync_plans
-        schema_ref: "governance/sync-plans-request.json"
-        response_schema_ref: "governance/sync-plans-response.json"
-        doc_ref: "/governance/campaign/tasks/sync_plans"
-        stateful: true
-        expected: |
-          The governance agent acknowledges the plan.
-        sample_request:
-          idempotency_key: "$generate:uuid_v4#governance_denied_recovery_sync_plans"
-          plans:
-            - plan_id: "comply-gov-recovery-plan"
-              brand:
-                domain: "acmeoutdoor.example"
-              objectives: "Strict-budget plan for denial + recovery validation"
-              budget:
-                total: 10000
-                currency: "USD"
-                reallocation_threshold: 5000
-              flight:
-                start: "2026-04-01T00:00:00Z"
-                end: "2026-06-30T23:59:59Z"
-              countries: ["US"]
-        validations:
-          - check: response_schema
-            description: "Response matches sync-plans-response.json schema"
-
-  - id: seller_setup
-    title: "Account and governance registration on seller"
-    steps:
-      - id: sync_accounts
-        title: "Establish account with seller"
-        task: sync_accounts
-        schema_ref: "account/sync-accounts-request.json"
-        response_schema_ref: "account/sync-accounts-response.json"
-        doc_ref: "/accounts/tasks/sync_accounts"
-        stateful: true
-        expected: |
-          Return the account with account_id active.
-        sample_request:
-          accounts:
-            - brand:
-                domain: "acmeoutdoor.example"
-              operator: "pinnacle-agency.example"
-              billing: "operator"
-              payment_terms: "net_30"
-          idempotency_key: "$generate:uuid_v4#media_buy_seller_governance_denied_recovery_seller_setup_sync_accounts"
-        validations:
-          - check: response_schema
-            description: "Response matches sync-accounts-response.json schema"
-          - check: field_present
-            path: "accounts[0].account_id"
-            description: "Account has a platform-assigned ID"
-
-      - id: sync_governance
-        title: "Register governance agent with seller"
-        task: sync_governance
-        schema_ref: "account/sync-governance-request.json"
-        response_schema_ref: "account/sync-governance-response.json"
-        doc_ref: "/accounts/tasks/sync_governance"
-        stateful: true
-        expected: |
-          Acknowledge the governance agent registration.
-        sample_request:
-          accounts:
-            - account:
-                brand:
-                  domain: "acmeoutdoor.example"
-                operator: "pinnacle-agency.example"
-              governance_agents:
-                - url: "$context.governance_agent_url"
-                  authentication:
-                    schemes: ["Bearer"]
-                    credentials: "gov-token-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
-          idempotency_key: "$generate:uuid_v4#media_buy_seller_governance_denied_recovery_seller_setup_sync_governance"
-        validations:
-          - check: response_schema
-            description: "Response matches sync-governance-response.json schema"
-
-  - id: buy_denied
-    title: "Initial buy exceeds plan — governance denies"
-    steps:
-      - id: get_products_brief
-        title: "Discover products"
-        task: get_products
-        schema_ref: "media-buy/get-products-request.json"
-        response_schema_ref: "media-buy/get-products-response.json"
-        doc_ref: "/media-buy/task-reference/get_products"
-        comply_scenario: full_sales_flow
-        stateful: false
-        expected: |
-          Return products matching the brief.
-        sample_request:
-          buying_mode: "brief"
-          brief: "Display inventory on outdoor lifestyle content. Q2 flight."
-          filters:
-            is_fixed_price: true
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-        context_outputs:
-          - path: "products[0].product_id"
-            key: "product_id"
-          - path: "products[0].pricing_options[0].pricing_option_id"
-            key: "pricing_option_id"
-        validations:
-          - check: response_schema
-            description: "Response matches get-products-response.json schema"
-          - check: field_present
-            path: "products"
-            description: "Response contains products"
-          - check: field_present
-            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: create_media_buy_denied
-        title: "Attempt $50K buy — denied"
-        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: create_media_buy
-        expect_error: true
-        negative_path: payload_well_formed
-        stateful: true
-        expected: |
-          The buy is rejected with GOVERNANCE_DENIED. The response includes findings
-          from the governance agent explaining which constraint was exceeded.
-
-        sample_request:
-          brand:
-            domain: "acmeoutdoor.example"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          idempotency_key: "$generate:uuid_v4#governance_denied_recovery_create_media_buy_denied"
-          start_time: "2026-04-01T00:00:00Z"
-          end_time: "2026-06-30T23:59:59Z"
-          packages:
-            - product_id: "$context.product_id"
-              budget: 50000
-              pricing_option_id: "$context.pricing_option_id"
-          context:
-            correlation_id: "governance_denied_recovery--create_media_buy_denied"
-        validations:
-          - check: error_code
-            value: "GOVERNANCE_DENIED"
-            description: "Error code is GOVERNANCE_DENIED"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "governance_denied_recovery--create_media_buy_denied"
-            description: "Response echoes context.correlation_id verbatim on error responses (echo contract applies to both success and failure)"
-
-  - id: buy_retried
-    title: "Corrected buy within plan — governance approves"
-    narrative: |
-      The buyer reads the denial findings, shrinks the budget to $8K (within the $10K
-      plan), and retries with a fresh idempotency_key. The seller consults governance
-      again, which now approves.
-
-    steps:
-      - id: create_media_buy_retry
-        title: "Retry with $8K — approved"
-        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: create_media_buy
-        stateful: true
-        expected: |
-          The buy succeeds. Governance approves because $8K fits within the $10K plan
-          budget. The seller returns a media_buy_id.
-
-        sample_request:
-          brand:
-            domain: "acmeoutdoor.example"
-          account:
-            brand:
-              domain: "acmeoutdoor.example"
-            operator: "pinnacle-agency.example"
-          idempotency_key: "$generate:uuid_v4#governance_denied_recovery_create_media_buy_retry"
-          start_time: "2026-04-01T00:00:00Z"
-          end_time: "2026-06-30T23:59:59Z"
-          packages:
-            - product_id: "$context.product_id"
-              budget: 8000
-              pricing_option_id: "$context.pricing_option_id"
-        context_outputs:
-          - name: media_buy_id
-            path: "media_buy_id"
-        validations:
-          - check: response_schema
-            description: "Response matches create-media-buy-response.json schema"
-          - check: field_present
-            path: "media_buy_id"
-            description: "Seller returns a media_buy_id after governance approves"