@adcp/sdk 7.11.0 → 7.11.1

package/compliance/cache/3.1.0-rc.2/index.json

@@ -0,0 +1,356 @@
+{
+  "published_version": "3.1.0-rc.2",
+  "adcp_version": "3.1.0-rc.2",
+  "generated_at": "2026-05-29T21:35:47.317Z",
+  "universal": [
+    "billing-gate-dispatch",
+    "canonical-format-validate-input",
+    "capability-discovery",
+    "collection-lists-pagination-integrity",
+    "comply-controller-mode-gate",
+    "content-standards-pagination-integrity",
+    "deterministic-testing",
+    "error-compliance",
+    "error-compliance-signals",
+    "fictional-entities",
+    "get-media-buys-pagination-integrity",
+    "get-signals-pagination-integrity",
+    "idempotency",
+    "notification-config-event-scope",
+    "notification-config-lifecycle",
+    "notification-config-rejections",
+    "pagination-integrity",
+    "pagination-integrity-creative-formats",
+    "pagination-integrity-list-accounts",
+    "property-lists-pagination-integrity",
+    "read-tool-idempotency",
+    "runner-output-contract",
+    "schema-validation",
+    "schema-validation-signals",
+    "security",
+    "signed-requests",
+    "stale-response-advisory",
+    "storyboard-schema",
+    "v3-envelope-integrity",
+    "version-negotiation",
+    "webhook-emission",
+    "wholesale-feed-bulk-webhooks",
+    "wholesale-feed-product-webhooks",
+    "wholesale-feed-products",
+    "wholesale-feed-signal-webhooks",
+    "wholesale-feed-signals"
+  ],
+  "protocols": [
+    {
+      "id": "brand",
+      "title": "Brand baseline",
+      "has_baseline": true,
+      "path": "protocols/brand/"
+    },
+    {
+      "id": "creative",
+      "title": "Creative lifecycle",
+      "has_baseline": true,
+      "path": "protocols/creative/"
+    },
+    {
+      "id": "governance",
+      "title": "Governance denial and human escalation",
+      "has_baseline": true,
+      "path": "protocols/governance/"
+    },
+    {
+      "id": "media-buy",
+      "title": "Media buy seller agent",
+      "has_baseline": true,
+      "path": "protocols/media-buy/"
+    },
+    {
+      "id": "signals",
+      "title": "Signals baseline",
+      "has_baseline": true,
+      "path": "protocols/signals/"
+    },
+    {
+      "id": "sponsored-intelligence",
+      "title": "Sponsored intelligence baseline",
+      "has_baseline": true,
+      "path": "protocols/sponsored-intelligence/"
+    }
+  ],
+  "domains": [
+    {
+      "id": "brand",
+      "title": "Brand baseline",
+      "has_baseline": true,
+      "path": "domains/brand/"
+    },
+    {
+      "id": "creative",
+      "title": "Creative lifecycle",
+      "has_baseline": true,
+      "path": "domains/creative/"
+    },
+    {
+      "id": "governance",
+      "title": "Governance denial and human escalation",
+      "has_baseline": true,
+      "path": "domains/governance/"
+    },
+    {
+      "id": "media-buy",
+      "title": "Media buy seller agent",
+      "has_baseline": true,
+      "path": "domains/media-buy/"
+    },
+    {
+      "id": "signals",
+      "title": "Signals baseline",
+      "has_baseline": true,
+      "path": "domains/signals/"
+    },
+    {
+      "id": "sponsored-intelligence",
+      "title": "Sponsored intelligence baseline",
+      "has_baseline": true,
+      "path": "domains/sponsored-intelligence/"
+    }
+  ],
+  "specialisms": [
+    {
+      "id": "audience-sync",
+      "protocol": "media-buy",
+      "domain": "media-buy",
+      "title": "Audience sync",
+      "status": "stable",
+      "required_tools": [
+        "list_accounts",
+        "sync_audiences"
+      ],
+      "path": "specialisms/audience-sync/"
+    },
+    {
+      "id": "brand-rights",
+      "protocol": "brand",
+      "domain": "brand",
+      "title": "Brand identity and rights licensing",
+      "status": "stable",
+      "required_tools": [
+        "get_brand_identity"
+      ],
+      "path": "specialisms/brand-rights/"
+    },
+    {
+      "id": "collection-lists",
+      "protocol": "governance",
+      "domain": "governance",
+      "title": "Collection lists",
+      "status": "stable",
+      "required_tools": [
+        "create_collection_list"
+      ],
+      "path": "specialisms/collection-lists/"
+    },
+    {
+      "id": "content-standards",
+      "protocol": "governance",
+      "domain": "governance",
+      "title": "Content standards",
+      "status": "stable",
+      "required_tools": [
+        "list_content_standards"
+      ],
+      "path": "specialisms/content-standards/"
+    },
+    {
+      "id": "creative-ad-server",
+      "protocol": "creative",
+      "domain": "creative",
+      "title": "Creative ad server",
+      "status": "stable",
+      "required_tools": [
+        "build_creative"
+      ],
+      "path": "specialisms/creative-ad-server/"
+    },
+    {
+      "id": "creative-generative",
+      "protocol": "creative",
+      "domain": "creative",
+      "title": "Generative creative agent",
+      "status": "stable",
+      "required_tools": [
+        "build_creative"
+      ],
+      "path": "specialisms/creative-generative/"
+    },
+    {
+      "id": "creative-template",
+      "protocol": "creative",
+      "domain": "creative",
+      "title": "Creative template and transformation agent",
+      "status": "stable",
+      "required_tools": [
+        "build_creative"
+      ],
+      "path": "specialisms/creative-template/"
+    },
+    {
+      "id": "governance-aware-seller",
+      "protocol": "media-buy",
+      "domain": "media-buy",
+      "title": "Governance-aware seller",
+      "status": "stable",
+      "required_tools": [
+        "sync_governance",
+        "create_media_buy"
+      ],
+      "path": "specialisms/governance-aware-seller/"
+    },
+    {
+      "id": "governance-delivery-monitor",
+      "protocol": "governance",
+      "domain": "governance",
+      "title": "Campaign governance — delivery monitoring with drift detection",
+      "status": "stable",
+      "required_tools": [
+        "check_governance"
+      ],
+      "path": "specialisms/governance-delivery-monitor/"
+    },
+    {
+      "id": "governance-spend-authority",
+      "protocol": "governance",
+      "domain": "governance",
+      "title": "Campaign governance — conditional approval",
+      "status": "stable",
+      "required_tools": [
+        "sync_plans",
+        "check_governance"
+      ],
+      "path": "specialisms/governance-spend-authority/"
+    },
+    {
+      "id": "property-lists",
+      "protocol": "governance",
+      "domain": "governance",
+      "title": "Property lists",
+      "status": "stable",
+      "required_tools": [
+        "create_property_list"
+      ],
+      "path": "specialisms/property-lists/"
+    },
+    {
+      "id": "sales-broadcast-tv",
+      "protocol": "media-buy",
+      "domain": "media-buy",
+      "title": "Broadcast linear TV seller agent",
+      "status": "stable",
+      "required_tools": [
+        "sync_governance",
+        "get_products",
+        "create_media_buy"
+      ],
+      "path": "specialisms/sales-broadcast-tv/"
+    },
+    {
+      "id": "sales-catalog-driven",
+      "protocol": "media-buy",
+      "domain": "media-buy",
+      "title": "Catalog-driven creative and conversion tracking",
+      "status": "stable",
+      "required_tools": [
+        "sync_governance",
+        "get_products",
+        "create_media_buy"
+      ],
+      "path": "specialisms/sales-catalog-driven/"
+    },
+    {
+      "id": "sales-guaranteed",
+      "protocol": "media-buy",
+      "domain": "media-buy",
+      "title": "Guaranteed media buy with human IO approval",
+      "status": "stable",
+      "required_tools": [
+        "sync_governance",
+        "get_products",
+        "create_media_buy"
+      ],
+      "path": "specialisms/sales-guaranteed/"
+    },
+    {
+      "id": "sales-non-guaranteed",
+      "protocol": "media-buy",
+      "domain": "media-buy",
+      "title": "Non-guaranteed auction-based media buy",
+      "status": "stable",
+      "required_tools": [
+        "sync_governance",
+        "get_products",
+        "create_media_buy"
+      ],
+      "path": "specialisms/sales-non-guaranteed/"
+    },
+    {
+      "id": "sales-proposal-mode",
+      "protocol": "media-buy",
+      "domain": "media-buy",
+      "title": "Media buy via proposal acceptance",
+      "status": "stable",
+      "required_tools": [
+        "get_products",
+        "create_media_buy"
+      ],
+      "path": "specialisms/sales-proposal-mode/"
+    },
+    {
+      "id": "sales-social",
+      "protocol": "media-buy",
+      "domain": "media-buy",
+      "title": "Social platform",
+      "status": "stable",
+      "required_tools": [
+        "sync_governance",
+        "sync_audiences",
+        "sync_catalogs",
+        "sync_creatives",
+        "sync_event_sources",
+        "preview_creative"
+      ],
+      "path": "specialisms/sales-social/"
+    },
+    {
+      "id": "signal-marketplace",
+      "protocol": "signals",
+      "domain": "signals",
+      "title": "Marketplace signal agent",
+      "status": "stable",
+      "required_tools": [
+        "get_signals"
+      ],
+      "path": "specialisms/signal-marketplace/"
+    },
+    {
+      "id": "signal-owned",
+      "protocol": "signals",
+      "domain": "signals",
+      "title": "Owned signal agent",
+      "status": "stable",
+      "required_tools": [
+        "get_signals"
+      ],
+      "path": "specialisms/signal-owned/"
+    },
+    {
+      "id": "sponsored-intelligence",
+      "protocol": "sponsored-intelligence",
+      "domain": "sponsored-intelligence",
+      "title": "Sponsored intelligence",
+      "status": "preview",
+      "required_tools": [],
+      "path": "specialisms/sponsored-intelligence/"
+    }
+  ]
+}

package/compliance/cache/3.1.0-rc.2/protocols/brand/index.yaml

@@ -0,0 +1,160 @@
+id: brand_baseline
+version: "1.0.0"
+title: "Brand baseline"
+protocol: brand
+category: brand_baseline
+summary: "Baseline protocol storyboard — every brand agent must declare the brand protocol in capabilities and return a schema-valid brand identity."
+track: brand
+required_tools:
+  - get_brand_identity
+
+narrative: |
+  Brand protocol agents are the identity layer of AdCP. Their job is to hold
+  brand identity data (names, logos, colors, fonts, tone) and expose it to
+  other agents — buyer agents, creative agents, DSPs — that need to render
+  on-brand creative or verify who a campaign is for.
+
+  The baseline tests the minimum contract that every brand agent honors,
+  regardless of what additional capabilities (rights licensing, creative
+  approval) it layers on top:
+
+    1. Declare `brand` in `supported_protocols` on `get_adcp_capabilities`.
+    2. Respond to `get_brand_identity` with a schema-valid identity manifest.
+    3. Reject unknown `brand_id` values with a structured error.
+
+  Rights licensing (`get_rights`, `acquire_rights`, `update_rights`,
+  `creative_approval`) ships experimentally in 3.0 and is covered by the
+  `brand-rights` specialism storyboard, not this baseline.
+
+agent:
+  interaction_model: brand_agent
+  capabilities: []
+  examples:
+    - "Any brand agent (simple identity host or full rights platform)"
+    - "Brand-owned agents (Acme Outdoor)"
+    - "Third-party brand identity platforms"
+    - "Agency-hosted brand agents"
+
+caller:
+  role: buyer_agent
+  example: "Any buyer, creative agent, or DSP needing brand identity"
+
+prerequisites:
+  description: |
+    The test kit provides a sample brand (Nova Motors) that any brand agent
+    can serve identity for.
+  test_kit: "test-kits/nova-motors.yaml"
+
+phases:
+  - id: capability_discovery
+    title: "Capability discovery"
+    narrative: |
+      The buyer calls `get_adcp_capabilities` to confirm the agent declares
+      the brand protocol before issuing any brand-identity call.
+
+    steps:
+      - id: get_capabilities
+        title: "Check agent capabilities"
+        narrative: |
+          Verify that the agent declares `brand` in `supported_protocols`.
+          Without this claim the buyer MUST NOT send `get_brand_identity`.
+        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 `brand` in `supported_protocols`.
+
+        sample_request:
+          context:
+            correlation_id: "brand_baseline--get_capabilities"
+        validations:
+          - check: response_schema
+            description: "Response matches get-adcp-capabilities-response.json schema"
+          - check: field_present
+            path: "supported_protocols"
+            description: "Response declares supported_protocols"
+
+  - id: brand_identity_retrieval
+    title: "Brand identity retrieval"
+    narrative: |
+      The buyer calls `get_brand_identity` to retrieve the brand's identity
+      manifest. The minimum contract is a schema-valid response that echoes
+      the requested `brand_id` and carries at least one name.
+
+    steps:
+      - id: get_brand_identity
+        title: "Retrieve brand identity"
+        narrative: |
+          The buyer calls `get_brand_identity` with a known `brand_id`. The
+          response MUST match the brand-identity schema and echo the
+          requested `brand_id`. Rich fields (logos, colors, fonts, tone,
+          visual_guidelines) are optional at the baseline level — the
+          minimum bar is that identity resolution works and is schema-valid.
+        task: get_brand_identity
+        schema_ref: "brand/get-brand-identity-request.json"
+        response_schema_ref: "brand/get-brand-identity-response.json"
+        doc_ref: "/brand-protocol/tasks/get_brand_identity"
+        stateful: false
+        expected: |
+          Return a schema-valid brand identity that echoes the requested
+          brand_id and includes at least one name.
+
+        sample_request:
+          brand_id: "nova_motors"
+          context:
+            correlation_id: "brand_baseline--get_brand_identity"
+        context_outputs:
+          - path: "brand_id"
+            key: "brand_id"
+
+        validations:
+          - check: response_schema
+            description: "Response matches get-brand-identity-response.json schema"
+          - check: field_present
+            path: "brand_id"
+            description: "Response includes brand_id"
+          - check: field_value
+            path: "brand_id"
+            value: "nova_motors"
+            description: "Returned brand_id echoes the requested brand"
+          - check: field_present
+            path: "names"
+            description: "Response includes brand names"
+
+  - id: unknown_brand_rejection
+    title: "Unknown brand rejection"
+    narrative: |
+      Agents MUST reject unknown `brand_id` values with a structured
+      AdCP error rather than returning an empty or fabricated manifest.
+
+    steps:
+      - id: get_brand_identity_unknown
+        title: "Reject unknown brand ID"
+        narrative: |
+          The buyer calls `get_brand_identity` with a `brand_id` the agent
+          does not serve. The response MUST be a structured error with a
+          recovery classification — not a success response with empty
+          fields.
+        task: get_brand_identity
+        schema_ref: "brand/get-brand-identity-request.json"
+        response_schema_ref: "brand/get-brand-identity-response.json"
+        doc_ref: "/brand-protocol/tasks/get_brand_identity"
+        stateful: false
+        expected: |
+          Return an AdCP error response indicating the brand is not known
+          to this agent.
+
+        sample_request:
+          brand_id: "brand_that_does_not_exist_12345"
+          context:
+            correlation_id: "brand_baseline--get_brand_identity_unknown"
+
+        expect_error: true
+        negative_path: payload_well_formed
+        validations:
+          - check: error_code
+            value: "REFERENCE_NOT_FOUND"
+            description: "Error code indicates brand-not-found. REFERENCE_NOT_FOUND is the canonical fallback per error-handling.mdx (brands lack a dedicated *_NOT_FOUND code)."