@adcp/sdk 5.23.0

package/dist/lib/schemas-data/3.0.1/bundled/content-standards/get-media-buy-artifacts-response.json

@@ -0,0 +1,1880 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/3.0.1/bundled/content-standards/get-media-buy-artifacts-response.json",
+  "title": "Get Media Buy Artifacts Response",
+  "description": "Response containing content artifacts from a media buy for validation",
+  "type": "object",
+  "oneOf": [
+    {
+      "type": "object",
+      "description": "Success response with artifacts",
+      "properties": {
+        "media_buy_id": {
+          "type": "string",
+          "description": "Media buy these artifacts belong to"
+        },
+        "artifacts": {
+          "type": "array",
+          "description": "Delivery records with full artifact content",
+          "items": {
+            "type": "object",
+            "properties": {
+              "record_id": {
+                "type": "string",
+                "description": "Unique identifier for this delivery record"
+              },
+              "timestamp": {
+                "type": "string",
+                "format": "date-time",
+                "description": "When the delivery occurred"
+              },
+              "package_id": {
+                "type": "string",
+                "description": "Which package this delivery belongs to"
+              },
+              "artifact": {
+                "title": "Artifact",
+                "description": "Full artifact with content assets",
+                "type": "object",
+                "properties": {
+                  "property_rid": {
+                    "type": "string",
+                    "description": "Stable property identifier from the property catalog. Globally unique across the ecosystem."
+                  },
+                  "artifact_id": {
+                    "type": "string",
+                    "description": "Identifier for this artifact within the property. The property owner defines the scheme (e.g., 'article_12345', 'episode_42_segment_3', 'post_abc123')."
+                  },
+                  "variant_id": {
+                    "type": "string",
+                    "description": "Identifies a specific variant of this artifact. Use for A/B tests, translations, or temporal versions. Examples: 'en', 'es-MX', 'v2', 'headline_test_b'. The combination of artifact_id + variant_id must be unique."
+                  },
+                  "format_id": {
+                    "title": "Format Reference (Structured Object)",
+                    "description": "Always a structured object {agent_url, id} — never a plain string. Optional reference to a format definition. Uses the same format registry as creative formats.",
+                    "x-entity": "creative_format",
+                    "type": "object",
+                    "properties": {
+                      "agent_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "description": "URL of the agent that defines this format (e.g., 'https://creative.adcontextprotocol.org' for standard formats, or 'https://publisher.com/.well-known/adcp/sales' for custom formats). Callers comparing two `format-id` values MUST canonicalize `agent_url` per the AdCP URL canonicalization rules before treating two formats as the same. See docs/reference/url-canonicalization."
+                      },
+                      "id": {
+                        "type": "string",
+                        "pattern": "^[a-zA-Z0-9_-]+$",
+                        "description": "Format identifier within the agent's namespace (e.g., 'display_static', 'video_hosted', 'audio_standard'). When used alone, references a template format. When combined with dimension/duration fields, creates a parameterized format ID for a specific variant."
+                      },
+                      "width": {
+                        "type": "integer",
+                        "minimum": 1,
+                        "description": "Width in pixels for visual formats. When specified, height must also be specified. Both fields together create a parameterized format ID for dimension-specific variants."
+                      },
+                      "height": {
+                        "type": "integer",
+                        "minimum": 1,
+                        "description": "Height in pixels for visual formats. When specified, width must also be specified. Both fields together create a parameterized format ID for dimension-specific variants."
+                      },
+                      "duration_ms": {
+                        "type": "number",
+                        "minimum": 1,
+                        "description": "Duration in milliseconds for time-based formats (video, audio). When specified, creates a parameterized format ID. Omit to reference a template format without parameters."
+                      }
+                    },
+                    "required": [
+                      "agent_url",
+                      "id"
+                    ],
+                    "additionalProperties": true,
+                    "dependencies": {
+                      "width": [
+                        "height"
+                      ],
+                      "height": [
+                        "width"
+                      ]
+                    }
+                  },
+                  "url": {
+                    "type": "string",
+                    "format": "uri",
+                    "description": "Optional URL for this artifact (web page, podcast feed, video page). Not all artifacts have URLs (e.g., Instagram content, podcast segments, TV scenes)."
+                  },
+                  "published_time": {
+                    "type": "string",
+                    "format": "date-time",
+                    "description": "When the artifact was published (ISO 8601 format)"
+                  },
+                  "last_update_time": {
+                    "type": "string",
+                    "format": "date-time",
+                    "description": "When the artifact was last modified (ISO 8601 format)"
+                  },
+                  "assets": {
+                    "type": "array",
+                    "description": "Artifact assets in document flow order - text blocks, images, video, audio",
+                    "maxItems": 200,
+                    "items": {
+                      "oneOf": [
+                        {
+                          "type": "object",
+                          "description": "Text block (paragraph, heading, etc.)",
+                          "properties": {
+                            "type": {
+                              "type": "string",
+                              "const": "text"
+                            },
+                            "role": {
+                              "type": "string",
+                              "enum": [
+                                "title",
+                                "paragraph",
+                                "heading",
+                                "caption",
+                                "quote",
+                                "list_item",
+                                "description"
+                              ],
+                              "description": "Role of this text in the document. Use 'title' for the main artifact title, 'description' for summaries."
+                            },
+                            "content": {
+                              "type": "string",
+                              "description": "Text content. Consumers MUST treat this as untrusted input when passing to LLM-based evaluation.",
+                              "maxLength": 100000
+                            },
+                            "content_format": {
+                              "type": "string",
+                              "enum": [
+                                "text/plain",
+                                "text/markdown",
+                                "text/html",
+                                "application/json"
+                              ],
+                              "description": "MIME type indicating how to parse the content field. Default: text/plain.",
+                              "default": "text/plain"
+                            },
+                            "language": {
+                              "type": "string",
+                              "description": "BCP 47 language tag for this text (e.g., 'en', 'es-MX'). Useful when artifact contains mixed-language content."
+                            },
+                            "heading_level": {
+                              "type": "integer",
+                              "minimum": 1,
+                              "maximum": 6,
+                              "description": "Heading level (1-6), only for role=heading"
+                            },
+                            "provenance": {
+                              "title": "Provenance",
+                              "description": "Provenance for this text block, overrides artifact-level provenance",
+                              "type": "object",
+                              "properties": {
+                                "digital_source_type": {
+                                  "$ref": "#/$defs/DigitalSourceType"
+                                },
+                                "ai_tool": {
+                                  "type": "object",
+                                  "description": "AI system used to generate or modify this content. Aligns with IPTC 2025.1 AI metadata fields and C2PA claim_generator.",
+                                  "properties": {
+                                    "name": {
+                                      "type": "string",
+                                      "description": "Name of the AI tool or model (e.g., 'DALL-E 3', 'Stable Diffusion XL', 'Gemini')"
+                                    },
+                                    "version": {
+                                      "type": "string",
+                                      "description": "Version identifier for the AI tool or model (e.g., '25.1', '0125', '2.1'). For generative models, use the model version rather than the API version."
+                                    },
+                                    "provider": {
+                                      "type": "string",
+                                      "description": "Organization that provides the AI tool (e.g., 'OpenAI', 'Stability AI', 'Google')"
+                                    }
+                                  },
+                                  "required": [
+                                    "name"
+                                  ],
+                                  "additionalProperties": true
+                                },
+                                "human_oversight": {
+                                  "type": "string",
+                                  "description": "Level of human involvement in the AI-assisted creation process",
+                                  "enum": [
+                                    "none",
+                                    "prompt_only",
+                                    "selected",
+                                    "edited",
+                                    "directed"
+                                  ],
+                                  "enumDescriptions": {
+                                    "none": "Fully automated with no human involvement in generation",
+                                    "prompt_only": "Human provided the prompt or instructions but did not review outputs",
+                                    "selected": "Human selected from multiple AI-generated candidates",
+                                    "edited": "Human edited or refined AI-generated output",
+                                    "directed": "Human directed the creative process with AI as an assistive tool"
+                                  }
+                                },
+                                "declared_by": {
+                                  "type": "object",
+                                  "description": "Party declaring this provenance. Identifies who attached the provenance claim, enabling receiving parties to assess trust.",
+                                  "properties": {
+                                    "agent_url": {
+                                      "type": "string",
+                                      "format": "uri",
+                                      "description": "URL of the agent or service that declared this provenance"
+                                    },
+                                    "role": {
+                                      "type": "string",
+                                      "enum": [
+                                        "creator",
+                                        "advertiser",
+                                        "agency",
+                                        "platform",
+                                        "tool"
+                                      ],
+                                      "description": "Role of the declaring party in the supply chain",
+                                      "enumDescriptions": {
+                                        "creator": "The party that created or generated the content",
+                                        "advertiser": "The brand or advertiser that owns the content",
+                                        "agency": "Agency acting on behalf of the advertiser",
+                                        "platform": "Ad platform or publisher that processed the content",
+                                        "tool": "Automated tool or service that attached provenance metadata"
+                                      }
+                                    }
+                                  },
+                                  "required": [
+                                    "role"
+                                  ],
+                                  "additionalProperties": true
+                                },
+                                "declared_at": {
+                                  "type": "string",
+                                  "format": "date-time",
+                                  "description": "When this provenance claim was made (ISO 8601). Distinct from created_time, which records when the content itself was produced. A provenance claim may be attached well after content creation, for example when retroactively declaring AI involvement for regulatory compliance."
+                                },
+                                "created_time": {
+                                  "type": "string",
+                                  "format": "date-time",
+                                  "description": "When this content was created or generated (ISO 8601)"
+                                },
+                                "c2pa": {
+                                  "type": "object",
+                                  "description": "C2PA Content Credentials reference. Links to the cryptographic provenance manifest for this content. Because file-level C2PA bindings break during ad-tech transcoding, this URL reference preserves the chain of provenance through the supply chain.",
+                                  "properties": {
+                                    "manifest_url": {
+                                      "type": "string",
+                                      "format": "uri",
+                                      "description": "URL to the C2PA manifest store for this content"
+                                    }
+                                  },
+                                  "required": [
+                                    "manifest_url"
+                                  ],
+                                  "additionalProperties": true
+                                },
+                                "disclosure": {
+                                  "type": "object",
+                                  "description": "Regulatory disclosure requirements for this content. Indicates whether AI disclosure is required and under which jurisdictions.",
+                                  "properties": {
+                                    "required": {
+                                      "type": "boolean",
+                                      "description": "Whether AI disclosure is required for this content based on applicable regulations"
+                                    },
+                                    "jurisdictions": {
+                                      "type": "array",
+                                      "description": "Jurisdictions where disclosure obligations apply",
+                                      "items": {
+                                        "type": "object",
+                                        "properties": {
+                                          "country": {
+                                            "type": "string",
+                                            "description": "ISO 3166-1 alpha-2 country code (e.g., 'US', 'DE', 'CN')"
+                                          },
+                                          "region": {
+                                            "type": "string",
+                                            "description": "Sub-national region code (e.g., 'CA' for California, 'BY' for Bavaria)"
+                                          },
+                                          "regulation": {
+                                            "type": "string",
+                                            "description": "Regulation identifier (e.g., 'eu_ai_act_article_50', 'ca_sb_942', 'cn_deep_synthesis')"
+                                          },
+                                          "label_text": {
+                                            "type": "string",
+                                            "description": "Required disclosure label text for this jurisdiction, in the local language"
+                                          },
+                                          "render_guidance": {
+                                            "type": "object",
+                                            "description": "How the disclosure should be rendered for this jurisdiction. Expresses the declaring party's intent for persistence and position based on regulatory requirements. Publishers control actual rendering but governance agents can audit whether guidance was followed.",
+                                            "minProperties": 1,
+                                            "properties": {
+                                              "persistence": {
+                                                "$ref": "#/$defs/DisclosurePersistence"
+                                              },
+                                              "min_duration_ms": {
+                                                "type": "integer",
+                                                "minimum": 1,
+                                                "description": "Minimum display duration in milliseconds for initial persistence. Recommended when persistence is initial — without it, the duration is at the publisher's discretion. At serve time the publisher reads this from provenance since the brief is not available."
+                                              },
+                                              "positions": {
+                                                "type": "array",
+                                                "description": "Preferred disclosure positions in priority order. The first position a format supports should be used.",
+                                                "items": {
+                                                  "$ref": "#/$defs/DisclosurePosition"
+                                                },
+                                                "minItems": 1,
+                                                "uniqueItems": true
+                                              },
+                                              "ext": {
+                                                "title": "Extension Object",
+                                                "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+                                                "type": "object",
+                                                "additionalProperties": true
+                                              }
+                                            },
+                                            "additionalProperties": true
+                                          }
+                                        },
+                                        "required": [
+                                          "country",
+                                          "regulation"
+                                        ],
+                                        "additionalProperties": true
+                                      },
+                                      "minItems": 1
+                                    }
+                                  },
+                                  "required": [
+                                    "required"
+                                  ],
+                                  "additionalProperties": true
+                                },
+                                "verification": {
+                                  "type": "array",
+                                  "description": "Third-party verification or detection results for this content. Multiple services may independently evaluate the same content. Provenance is a claim — verification results attached by the declaring party are supplementary. The enforcing party (e.g., seller/publisher) should run its own verification via get_creative_features or calibrate_content.",
+                                  "minItems": 1,
+                                  "items": {
+                                    "type": "object",
+                                    "properties": {
+                                      "verified_by": {
+                                        "type": "string",
+                                        "description": "Name of the verification service (e.g., 'DoubleVerify', 'Hive Moderation', 'Reality Defender')"
+                                      },
+                                      "verified_time": {
+                                        "type": "string",
+                                        "format": "date-time",
+                                        "description": "When the verification was performed (ISO 8601)"
+                                      },
+                                      "result": {
+                                        "type": "string",
+                                        "enum": [
+                                          "authentic",
+                                          "ai_generated",
+                                          "ai_modified",
+                                          "inconclusive"
+                                        ],
+                                        "description": "Verification outcome"
+                                      },
+                                      "confidence": {
+                                        "type": "number",
+                                        "minimum": 0,
+                                        "maximum": 1,
+                                        "description": "Confidence score of the verification result (0.0 to 1.0)"
+                                      },
+                                      "details_url": {
+                                        "type": "string",
+                                        "format": "uri",
+                                        "description": "URL to the full verification report"
+                                      }
+                                    },
+                                    "required": [
+                                      "verified_by",
+                                      "result"
+                                    ],
+                                    "additionalProperties": true
+                                  }
+                                },
+                                "ext": {
+                                  "title": "Extension Object",
+                                  "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+                                  "type": "object",
+                                  "additionalProperties": true
+                                }
+                              },
+                              "additionalProperties": true
+                            }
+                          },
+                          "required": [
+                            "type",
+                            "content"
+                          ]
+                        },
+                        {
+                          "type": "object",
+                          "description": "Image asset",
+                          "properties": {
+                            "type": {
+                              "type": "string",
+                              "const": "image"
+                            },
+                            "url": {
+                              "type": "string",
+                              "format": "uri",
+                              "description": "Image URL"
+                            },
+                            "access": {
+                              "$ref": "#/$defs/asset_access",
+                              "description": "Authentication for secured URLs"
+                            },
+                            "alt_text": {
+                              "type": "string",
+                              "description": "Alt text or image description"
+                            },
+                            "caption": {
+                              "type": "string",
+                              "description": "Image caption"
+                            },
+                            "width": {
+                              "type": "integer",
+                              "description": "Image width in pixels"
+                            },
+                            "height": {
+                              "type": "integer",
+                              "description": "Image height in pixels"
+                            },
+                            "provenance": {
+                              "title": "Provenance",
+                              "description": "Provenance for this image, overrides artifact-level provenance",
+                              "type": "object",
+                              "properties": {
+                                "digital_source_type": {
+                                  "$ref": "#/$defs/DigitalSourceType"
+                                },
+                                "ai_tool": {
+                                  "type": "object",
+                                  "description": "AI system used to generate or modify this content. Aligns with IPTC 2025.1 AI metadata fields and C2PA claim_generator.",
+                                  "properties": {
+                                    "name": {
+                                      "type": "string",
+                                      "description": "Name of the AI tool or model (e.g., 'DALL-E 3', 'Stable Diffusion XL', 'Gemini')"
+                                    },
+                                    "version": {
+                                      "type": "string",
+                                      "description": "Version identifier for the AI tool or model (e.g., '25.1', '0125', '2.1'). For generative models, use the model version rather than the API version."
+                                    },
+                                    "provider": {
+                                      "type": "string",
+                                      "description": "Organization that provides the AI tool (e.g., 'OpenAI', 'Stability AI', 'Google')"
+                                    }
+                                  },
+                                  "required": [
+                                    "name"
+                                  ],
+                                  "additionalProperties": true
+                                },
+                                "human_oversight": {
+                                  "type": "string",
+                                  "description": "Level of human involvement in the AI-assisted creation process",
+                                  "enum": [
+                                    "none",
+                                    "prompt_only",
+                                    "selected",
+                                    "edited",
+                                    "directed"
+                                  ],
+                                  "enumDescriptions": {
+                                    "none": "Fully automated with no human involvement in generation",
+                                    "prompt_only": "Human provided the prompt or instructions but did not review outputs",
+                                    "selected": "Human selected from multiple AI-generated candidates",
+                                    "edited": "Human edited or refined AI-generated output",
+                                    "directed": "Human directed the creative process with AI as an assistive tool"
+                                  }
+                                },
+                                "declared_by": {
+                                  "type": "object",
+                                  "description": "Party declaring this provenance. Identifies who attached the provenance claim, enabling receiving parties to assess trust.",
+                                  "properties": {
+                                    "agent_url": {
+                                      "type": "string",
+                                      "format": "uri",
+                                      "description": "URL of the agent or service that declared this provenance"
+                                    },
+                                    "role": {
+                                      "type": "string",
+                                      "enum": [
+                                        "creator",
+                                        "advertiser",
+                                        "agency",
+                                        "platform",
+                                        "tool"
+                                      ],
+                                      "description": "Role of the declaring party in the supply chain",
+                                      "enumDescriptions": {
+                                        "creator": "The party that created or generated the content",
+                                        "advertiser": "The brand or advertiser that owns the content",
+                                        "agency": "Agency acting on behalf of the advertiser",
+                                        "platform": "Ad platform or publisher that processed the content",
+                                        "tool": "Automated tool or service that attached provenance metadata"
+                                      }
+                                    }
+                                  },
+                                  "required": [
+                                    "role"
+                                  ],
+                                  "additionalProperties": true
+                                },
+                                "declared_at": {
+                                  "type": "string",
+                                  "format": "date-time",
+                                  "description": "When this provenance claim was made (ISO 8601). Distinct from created_time, which records when the content itself was produced. A provenance claim may be attached well after content creation, for example when retroactively declaring AI involvement for regulatory compliance."
+                                },
+                                "created_time": {
+                                  "type": "string",
+                                  "format": "date-time",
+                                  "description": "When this content was created or generated (ISO 8601)"
+                                },
+                                "c2pa": {
+                                  "type": "object",
+                                  "description": "C2PA Content Credentials reference. Links to the cryptographic provenance manifest for this content. Because file-level C2PA bindings break during ad-tech transcoding, this URL reference preserves the chain of provenance through the supply chain.",
+                                  "properties": {
+                                    "manifest_url": {
+                                      "type": "string",
+                                      "format": "uri",
+                                      "description": "URL to the C2PA manifest store for this content"
+                                    }
+                                  },
+                                  "required": [
+                                    "manifest_url"
+                                  ],
+                                  "additionalProperties": true
+                                },
+                                "disclosure": {
+                                  "type": "object",
+                                  "description": "Regulatory disclosure requirements for this content. Indicates whether AI disclosure is required and under which jurisdictions.",
+                                  "properties": {
+                                    "required": {
+                                      "type": "boolean",
+                                      "description": "Whether AI disclosure is required for this content based on applicable regulations"
+                                    },
+                                    "jurisdictions": {
+                                      "type": "array",
+                                      "description": "Jurisdictions where disclosure obligations apply",
+                                      "items": {
+                                        "type": "object",
+                                        "properties": {
+                                          "country": {
+                                            "type": "string",
+                                            "description": "ISO 3166-1 alpha-2 country code (e.g., 'US', 'DE', 'CN')"
+                                          },
+                                          "region": {
+                                            "type": "string",
+                                            "description": "Sub-national region code (e.g., 'CA' for California, 'BY' for Bavaria)"
+                                          },
+                                          "regulation": {
+                                            "type": "string",
+                                            "description": "Regulation identifier (e.g., 'eu_ai_act_article_50', 'ca_sb_942', 'cn_deep_synthesis')"
+                                          },
+                                          "label_text": {
+                                            "type": "string",
+                                            "description": "Required disclosure label text for this jurisdiction, in the local language"
+                                          },
+                                          "render_guidance": {
+                                            "type": "object",
+                                            "description": "How the disclosure should be rendered for this jurisdiction. Expresses the declaring party's intent for persistence and position based on regulatory requirements. Publishers control actual rendering but governance agents can audit whether guidance was followed.",
+                                            "minProperties": 1,
+                                            "properties": {
+                                              "persistence": {
+                                                "$ref": "#/$defs/DisclosurePersistence"
+                                              },
+                                              "min_duration_ms": {
+                                                "type": "integer",
+                                                "minimum": 1,
+                                                "description": "Minimum display duration in milliseconds for initial persistence. Recommended when persistence is initial — without it, the duration is at the publisher's discretion. At serve time the publisher reads this from provenance since the brief is not available."
+                                              },
+                                              "positions": {
+                                                "type": "array",
+                                                "description": "Preferred disclosure positions in priority order. The first position a format supports should be used.",
+                                                "items": {
+                                                  "$ref": "#/$defs/DisclosurePosition"
+                                                },
+                                                "minItems": 1,
+                                                "uniqueItems": true
+                                              },
+                                              "ext": {
+                                                "title": "Extension Object",
+                                                "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+                                                "type": "object",
+                                                "additionalProperties": true
+                                              }
+                                            },
+                                            "additionalProperties": true
+                                          }
+                                        },
+                                        "required": [
+                                          "country",
+                                          "regulation"
+                                        ],
+                                        "additionalProperties": true
+                                      },
+                                      "minItems": 1
+                                    }
+                                  },
+                                  "required": [
+                                    "required"
+                                  ],
+                                  "additionalProperties": true
+                                },
+                                "verification": {
+                                  "type": "array",
+                                  "description": "Third-party verification or detection results for this content. Multiple services may independently evaluate the same content. Provenance is a claim — verification results attached by the declaring party are supplementary. The enforcing party (e.g., seller/publisher) should run its own verification via get_creative_features or calibrate_content.",
+                                  "minItems": 1,
+                                  "items": {
+                                    "type": "object",
+                                    "properties": {
+                                      "verified_by": {
+                                        "type": "string",
+                                        "description": "Name of the verification service (e.g., 'DoubleVerify', 'Hive Moderation', 'Reality Defender')"
+                                      },
+                                      "verified_time": {
+                                        "type": "string",
+                                        "format": "date-time",
+                                        "description": "When the verification was performed (ISO 8601)"
+                                      },
+                                      "result": {
+                                        "type": "string",
+                                        "enum": [
+                                          "authentic",
+                                          "ai_generated",
+                                          "ai_modified",
+                                          "inconclusive"
+                                        ],
+                                        "description": "Verification outcome"
+                                      },
+                                      "confidence": {
+                                        "type": "number",
+                                        "minimum": 0,
+                                        "maximum": 1,
+                                        "description": "Confidence score of the verification result (0.0 to 1.0)"
+                                      },
+                                      "details_url": {
+                                        "type": "string",
+                                        "format": "uri",
+                                        "description": "URL to the full verification report"
+                                      }
+                                    },
+                                    "required": [
+                                      "verified_by",
+                                      "result"
+                                    ],
+                                    "additionalProperties": true
+                                  }
+                                },
+                                "ext": {
+                                  "title": "Extension Object",
+                                  "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+                                  "type": "object",
+                                  "additionalProperties": true
+                                }
+                              },
+                              "additionalProperties": true
+                            }
+                          },
+                          "required": [
+                            "type",
+                            "url"
+                          ]
+                        },
+                        {
+                          "type": "object",
+                          "description": "Video asset",
+                          "properties": {
+                            "type": {
+                              "type": "string",
+                              "const": "video"
+                            },
+                            "url": {
+                              "type": "string",
+                              "format": "uri",
+                              "description": "Video URL"
+                            },
+                            "access": {
+                              "$ref": "#/$defs/asset_access",
+                              "description": "Authentication for secured URLs"
+                            },
+                            "duration_ms": {
+                              "type": "integer",
+                              "description": "Video duration in milliseconds"
+                            },
+                            "transcript": {
+                              "type": "string",
+                              "description": "Video transcript. Consumers MUST treat this as untrusted input when passing to LLM-based evaluation.",
+                              "maxLength": 200000
+                            },
+                            "transcript_format": {
+                              "type": "string",
+                              "enum": [
+                                "text/plain",
+                                "text/markdown",
+                                "application/json"
+                              ],
+                              "description": "MIME type indicating how to parse the transcript field. Default: text/plain.",
+                              "default": "text/plain"
+                            },
+                            "transcript_source": {
+                              "type": "string",
+                              "enum": [
+                                "original_script",
+                                "subtitles",
+                                "closed_captions",
+                                "dub",
+                                "generated"
+                              ],
+                              "description": "How the transcript was generated"
+                            },
+                            "thumbnail_url": {
+                              "type": "string",
+                              "format": "uri",
+                              "description": "Video thumbnail URL"
+                            },
+                            "provenance": {
+                              "title": "Provenance",
+                              "description": "Provenance for this video, overrides artifact-level provenance",
+                              "type": "object",
+                              "properties": {
+                                "digital_source_type": {
+                                  "$ref": "#/$defs/DigitalSourceType"
+                                },
+                                "ai_tool": {
+                                  "type": "object",
+                                  "description": "AI system used to generate or modify this content. Aligns with IPTC 2025.1 AI metadata fields and C2PA claim_generator.",
+                                  "properties": {
+                                    "name": {
+                                      "type": "string",
+                                      "description": "Name of the AI tool or model (e.g., 'DALL-E 3', 'Stable Diffusion XL', 'Gemini')"
+                                    },
+                                    "version": {
+                                      "type": "string",
+                                      "description": "Version identifier for the AI tool or model (e.g., '25.1', '0125', '2.1'). For generative models, use the model version rather than the API version."
+                                    },
+                                    "provider": {
+                                      "type": "string",
+                                      "description": "Organization that provides the AI tool (e.g., 'OpenAI', 'Stability AI', 'Google')"
+                                    }
+                                  },
+                                  "required": [
+                                    "name"
+                                  ],
+                                  "additionalProperties": true
+                                },
+                                "human_oversight": {
+                                  "type": "string",
+                                  "description": "Level of human involvement in the AI-assisted creation process",
+                                  "enum": [
+                                    "none",
+                                    "prompt_only",
+                                    "selected",
+                                    "edited",
+                                    "directed"
+                                  ],
+                                  "enumDescriptions": {
+                                    "none": "Fully automated with no human involvement in generation",
+                                    "prompt_only": "Human provided the prompt or instructions but did not review outputs",
+                                    "selected": "Human selected from multiple AI-generated candidates",
+                                    "edited": "Human edited or refined AI-generated output",
+                                    "directed": "Human directed the creative process with AI as an assistive tool"
+                                  }
+                                },
+                                "declared_by": {
+                                  "type": "object",
+                                  "description": "Party declaring this provenance. Identifies who attached the provenance claim, enabling receiving parties to assess trust.",
+                                  "properties": {
+                                    "agent_url": {
+                                      "type": "string",
+                                      "format": "uri",
+                                      "description": "URL of the agent or service that declared this provenance"
+                                    },
+                                    "role": {
+                                      "type": "string",
+                                      "enum": [
+                                        "creator",
+                                        "advertiser",
+                                        "agency",
+                                        "platform",
+                                        "tool"
+                                      ],
+                                      "description": "Role of the declaring party in the supply chain",
+                                      "enumDescriptions": {
+                                        "creator": "The party that created or generated the content",
+                                        "advertiser": "The brand or advertiser that owns the content",
+                                        "agency": "Agency acting on behalf of the advertiser",
+                                        "platform": "Ad platform or publisher that processed the content",
+                                        "tool": "Automated tool or service that attached provenance metadata"
+                                      }
+                                    }
+                                  },
+                                  "required": [
+                                    "role"
+                                  ],
+                                  "additionalProperties": true
+                                },
+                                "declared_at": {
+                                  "type": "string",
+                                  "format": "date-time",
+                                  "description": "When this provenance claim was made (ISO 8601). Distinct from created_time, which records when the content itself was produced. A provenance claim may be attached well after content creation, for example when retroactively declaring AI involvement for regulatory compliance."
+                                },
+                                "created_time": {
+                                  "type": "string",
+                                  "format": "date-time",
+                                  "description": "When this content was created or generated (ISO 8601)"
+                                },
+                                "c2pa": {
+                                  "type": "object",
+                                  "description": "C2PA Content Credentials reference. Links to the cryptographic provenance manifest for this content. Because file-level C2PA bindings break during ad-tech transcoding, this URL reference preserves the chain of provenance through the supply chain.",
+                                  "properties": {
+                                    "manifest_url": {
+                                      "type": "string",
+                                      "format": "uri",
+                                      "description": "URL to the C2PA manifest store for this content"
+                                    }
+                                  },
+                                  "required": [
+                                    "manifest_url"
+                                  ],
+                                  "additionalProperties": true
+                                },
+                                "disclosure": {
+                                  "type": "object",
+                                  "description": "Regulatory disclosure requirements for this content. Indicates whether AI disclosure is required and under which jurisdictions.",
+                                  "properties": {
+                                    "required": {
+                                      "type": "boolean",
+                                      "description": "Whether AI disclosure is required for this content based on applicable regulations"
+                                    },
+                                    "jurisdictions": {
+                                      "type": "array",
+                                      "description": "Jurisdictions where disclosure obligations apply",
+                                      "items": {
+                                        "type": "object",
+                                        "properties": {
+                                          "country": {
+                                            "type": "string",
+                                            "description": "ISO 3166-1 alpha-2 country code (e.g., 'US', 'DE', 'CN')"
+                                          },
+                                          "region": {
+                                            "type": "string",
+                                            "description": "Sub-national region code (e.g., 'CA' for California, 'BY' for Bavaria)"
+                                          },
+                                          "regulation": {
+                                            "type": "string",
+                                            "description": "Regulation identifier (e.g., 'eu_ai_act_article_50', 'ca_sb_942', 'cn_deep_synthesis')"
+                                          },
+                                          "label_text": {
+                                            "type": "string",
+                                            "description": "Required disclosure label text for this jurisdiction, in the local language"
+                                          },
+                                          "render_guidance": {
+                                            "type": "object",
+                                            "description": "How the disclosure should be rendered for this jurisdiction. Expresses the declaring party's intent for persistence and position based on regulatory requirements. Publishers control actual rendering but governance agents can audit whether guidance was followed.",
+                                            "minProperties": 1,
+                                            "properties": {
+                                              "persistence": {
+                                                "$ref": "#/$defs/DisclosurePersistence"
+                                              },
+                                              "min_duration_ms": {
+                                                "type": "integer",
+                                                "minimum": 1,
+                                                "description": "Minimum display duration in milliseconds for initial persistence. Recommended when persistence is initial — without it, the duration is at the publisher's discretion. At serve time the publisher reads this from provenance since the brief is not available."
+                                              },
+                                              "positions": {
+                                                "type": "array",
+                                                "description": "Preferred disclosure positions in priority order. The first position a format supports should be used.",
+                                                "items": {
+                                                  "$ref": "#/$defs/DisclosurePosition"
+                                                },
+                                                "minItems": 1,
+                                                "uniqueItems": true
+                                              },
+                                              "ext": {
+                                                "title": "Extension Object",
+                                                "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+                                                "type": "object",
+                                                "additionalProperties": true
+                                              }
+                                            },
+                                            "additionalProperties": true
+                                          }
+                                        },
+                                        "required": [
+                                          "country",
+                                          "regulation"
+                                        ],
+                                        "additionalProperties": true
+                                      },
+                                      "minItems": 1
+                                    }
+                                  },
+                                  "required": [
+                                    "required"
+                                  ],
+                                  "additionalProperties": true
+                                },
+                                "verification": {
+                                  "type": "array",
+                                  "description": "Third-party verification or detection results for this content. Multiple services may independently evaluate the same content. Provenance is a claim — verification results attached by the declaring party are supplementary. The enforcing party (e.g., seller/publisher) should run its own verification via get_creative_features or calibrate_content.",
+                                  "minItems": 1,
+                                  "items": {
+                                    "type": "object",
+                                    "properties": {
+                                      "verified_by": {
+                                        "type": "string",
+                                        "description": "Name of the verification service (e.g., 'DoubleVerify', 'Hive Moderation', 'Reality Defender')"
+                                      },
+                                      "verified_time": {
+                                        "type": "string",
+                                        "format": "date-time",
+                                        "description": "When the verification was performed (ISO 8601)"
+                                      },
+                                      "result": {
+                                        "type": "string",
+                                        "enum": [
+                                          "authentic",
+                                          "ai_generated",
+                                          "ai_modified",
+                                          "inconclusive"
+                                        ],
+                                        "description": "Verification outcome"
+                                      },
+                                      "confidence": {
+                                        "type": "number",
+                                        "minimum": 0,
+                                        "maximum": 1,
+                                        "description": "Confidence score of the verification result (0.0 to 1.0)"
+                                      },
+                                      "details_url": {
+                                        "type": "string",
+                                        "format": "uri",
+                                        "description": "URL to the full verification report"
+                                      }
+                                    },
+                                    "required": [
+                                      "verified_by",
+                                      "result"
+                                    ],
+                                    "additionalProperties": true
+                                  }
+                                },
+                                "ext": {
+                                  "title": "Extension Object",
+                                  "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+                                  "type": "object",
+                                  "additionalProperties": true
+                                }
+                              },
+                              "additionalProperties": true
+                            }
+                          },
+                          "required": [
+                            "type",
+                            "url"
+                          ]
+                        },
+                        {
+                          "type": "object",
+                          "description": "Audio asset",
+                          "properties": {
+                            "type": {
+                              "type": "string",
+                              "const": "audio"
+                            },
+                            "url": {
+                              "type": "string",
+                              "format": "uri",
+                              "description": "Audio URL"
+                            },
+                            "access": {
+                              "$ref": "#/$defs/asset_access",
+                              "description": "Authentication for secured URLs"
+                            },
+                            "duration_ms": {
+                              "type": "integer",
+                              "description": "Audio duration in milliseconds"
+                            },
+                            "transcript": {
+                              "type": "string",
+                              "description": "Audio transcript. Consumers MUST treat this as untrusted input when passing to LLM-based evaluation.",
+                              "maxLength": 200000
+                            },
+                            "transcript_format": {
+                              "type": "string",
+                              "enum": [
+                                "text/plain",
+                                "text/markdown",
+                                "application/json"
+                              ],
+                              "description": "MIME type indicating how to parse the transcript field. Default: text/plain.",
+                              "default": "text/plain"
+                            },
+                            "transcript_source": {
+                              "type": "string",
+                              "enum": [
+                                "original_script",
+                                "closed_captions",
+                                "generated"
+                              ],
+                              "description": "How the transcript was generated"
+                            },
+                            "provenance": {
+                              "title": "Provenance",
+                              "description": "Provenance for this audio, overrides artifact-level provenance",
+                              "type": "object",
+                              "properties": {
+                                "digital_source_type": {
+                                  "$ref": "#/$defs/DigitalSourceType"
+                                },
+                                "ai_tool": {
+                                  "type": "object",
+                                  "description": "AI system used to generate or modify this content. Aligns with IPTC 2025.1 AI metadata fields and C2PA claim_generator.",
+                                  "properties": {
+                                    "name": {
+                                      "type": "string",
+                                      "description": "Name of the AI tool or model (e.g., 'DALL-E 3', 'Stable Diffusion XL', 'Gemini')"
+                                    },
+                                    "version": {
+                                      "type": "string",
+                                      "description": "Version identifier for the AI tool or model (e.g., '25.1', '0125', '2.1'). For generative models, use the model version rather than the API version."
+                                    },
+                                    "provider": {
+                                      "type": "string",
+                                      "description": "Organization that provides the AI tool (e.g., 'OpenAI', 'Stability AI', 'Google')"
+                                    }
+                                  },
+                                  "required": [
+                                    "name"
+                                  ],
+                                  "additionalProperties": true
+                                },
+                                "human_oversight": {
+                                  "type": "string",
+                                  "description": "Level of human involvement in the AI-assisted creation process",
+                                  "enum": [
+                                    "none",
+                                    "prompt_only",
+                                    "selected",
+                                    "edited",
+                                    "directed"
+                                  ],
+                                  "enumDescriptions": {
+                                    "none": "Fully automated with no human involvement in generation",
+                                    "prompt_only": "Human provided the prompt or instructions but did not review outputs",
+                                    "selected": "Human selected from multiple AI-generated candidates",
+                                    "edited": "Human edited or refined AI-generated output",
+                                    "directed": "Human directed the creative process with AI as an assistive tool"
+                                  }
+                                },
+                                "declared_by": {
+                                  "type": "object",
+                                  "description": "Party declaring this provenance. Identifies who attached the provenance claim, enabling receiving parties to assess trust.",
+                                  "properties": {
+                                    "agent_url": {
+                                      "type": "string",
+                                      "format": "uri",
+                                      "description": "URL of the agent or service that declared this provenance"
+                                    },
+                                    "role": {
+                                      "type": "string",
+                                      "enum": [
+                                        "creator",
+                                        "advertiser",
+                                        "agency",
+                                        "platform",
+                                        "tool"
+                                      ],
+                                      "description": "Role of the declaring party in the supply chain",
+                                      "enumDescriptions": {
+                                        "creator": "The party that created or generated the content",
+                                        "advertiser": "The brand or advertiser that owns the content",
+                                        "agency": "Agency acting on behalf of the advertiser",
+                                        "platform": "Ad platform or publisher that processed the content",
+                                        "tool": "Automated tool or service that attached provenance metadata"
+                                      }
+                                    }
+                                  },
+                                  "required": [
+                                    "role"
+                                  ],
+                                  "additionalProperties": true
+                                },
+                                "declared_at": {
+                                  "type": "string",
+                                  "format": "date-time",
+                                  "description": "When this provenance claim was made (ISO 8601). Distinct from created_time, which records when the content itself was produced. A provenance claim may be attached well after content creation, for example when retroactively declaring AI involvement for regulatory compliance."
+                                },
+                                "created_time": {
+                                  "type": "string",
+                                  "format": "date-time",
+                                  "description": "When this content was created or generated (ISO 8601)"
+                                },
+                                "c2pa": {
+                                  "type": "object",
+                                  "description": "C2PA Content Credentials reference. Links to the cryptographic provenance manifest for this content. Because file-level C2PA bindings break during ad-tech transcoding, this URL reference preserves the chain of provenance through the supply chain.",
+                                  "properties": {
+                                    "manifest_url": {
+                                      "type": "string",
+                                      "format": "uri",
+                                      "description": "URL to the C2PA manifest store for this content"
+                                    }
+                                  },
+                                  "required": [
+                                    "manifest_url"
+                                  ],
+                                  "additionalProperties": true
+                                },
+                                "disclosure": {
+                                  "type": "object",
+                                  "description": "Regulatory disclosure requirements for this content. Indicates whether AI disclosure is required and under which jurisdictions.",
+                                  "properties": {
+                                    "required": {
+                                      "type": "boolean",
+                                      "description": "Whether AI disclosure is required for this content based on applicable regulations"
+                                    },
+                                    "jurisdictions": {
+                                      "type": "array",
+                                      "description": "Jurisdictions where disclosure obligations apply",
+                                      "items": {
+                                        "type": "object",
+                                        "properties": {
+                                          "country": {
+                                            "type": "string",
+                                            "description": "ISO 3166-1 alpha-2 country code (e.g., 'US', 'DE', 'CN')"
+                                          },
+                                          "region": {
+                                            "type": "string",
+                                            "description": "Sub-national region code (e.g., 'CA' for California, 'BY' for Bavaria)"
+                                          },
+                                          "regulation": {
+                                            "type": "string",
+                                            "description": "Regulation identifier (e.g., 'eu_ai_act_article_50', 'ca_sb_942', 'cn_deep_synthesis')"
+                                          },
+                                          "label_text": {
+                                            "type": "string",
+                                            "description": "Required disclosure label text for this jurisdiction, in the local language"
+                                          },
+                                          "render_guidance": {
+                                            "type": "object",
+                                            "description": "How the disclosure should be rendered for this jurisdiction. Expresses the declaring party's intent for persistence and position based on regulatory requirements. Publishers control actual rendering but governance agents can audit whether guidance was followed.",
+                                            "minProperties": 1,
+                                            "properties": {
+                                              "persistence": {
+                                                "$ref": "#/$defs/DisclosurePersistence"
+                                              },
+                                              "min_duration_ms": {
+                                                "type": "integer",
+                                                "minimum": 1,
+                                                "description": "Minimum display duration in milliseconds for initial persistence. Recommended when persistence is initial — without it, the duration is at the publisher's discretion. At serve time the publisher reads this from provenance since the brief is not available."
+                                              },
+                                              "positions": {
+                                                "type": "array",
+                                                "description": "Preferred disclosure positions in priority order. The first position a format supports should be used.",
+                                                "items": {
+                                                  "$ref": "#/$defs/DisclosurePosition"
+                                                },
+                                                "minItems": 1,
+                                                "uniqueItems": true
+                                              },
+                                              "ext": {
+                                                "title": "Extension Object",
+                                                "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+                                                "type": "object",
+                                                "additionalProperties": true
+                                              }
+                                            },
+                                            "additionalProperties": true
+                                          }
+                                        },
+                                        "required": [
+                                          "country",
+                                          "regulation"
+                                        ],
+                                        "additionalProperties": true
+                                      },
+                                      "minItems": 1
+                                    }
+                                  },
+                                  "required": [
+                                    "required"
+                                  ],
+                                  "additionalProperties": true
+                                },
+                                "verification": {
+                                  "type": "array",
+                                  "description": "Third-party verification or detection results for this content. Multiple services may independently evaluate the same content. Provenance is a claim — verification results attached by the declaring party are supplementary. The enforcing party (e.g., seller/publisher) should run its own verification via get_creative_features or calibrate_content.",
+                                  "minItems": 1,
+                                  "items": {
+                                    "type": "object",
+                                    "properties": {
+                                      "verified_by": {
+                                        "type": "string",
+                                        "description": "Name of the verification service (e.g., 'DoubleVerify', 'Hive Moderation', 'Reality Defender')"
+                                      },
+                                      "verified_time": {
+                                        "type": "string",
+                                        "format": "date-time",
+                                        "description": "When the verification was performed (ISO 8601)"
+                                      },
+                                      "result": {
+                                        "type": "string",
+                                        "enum": [
+                                          "authentic",
+                                          "ai_generated",
+                                          "ai_modified",
+                                          "inconclusive"
+                                        ],
+                                        "description": "Verification outcome"
+                                      },
+                                      "confidence": {
+                                        "type": "number",
+                                        "minimum": 0,
+                                        "maximum": 1,
+                                        "description": "Confidence score of the verification result (0.0 to 1.0)"
+                                      },
+                                      "details_url": {
+                                        "type": "string",
+                                        "format": "uri",
+                                        "description": "URL to the full verification report"
+                                      }
+                                    },
+                                    "required": [
+                                      "verified_by",
+                                      "result"
+                                    ],
+                                    "additionalProperties": true
+                                  }
+                                },
+                                "ext": {
+                                  "title": "Extension Object",
+                                  "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+                                  "type": "object",
+                                  "additionalProperties": true
+                                }
+                              },
+                              "additionalProperties": true
+                            }
+                          },
+                          "required": [
+                            "type",
+                            "url"
+                          ]
+                        }
+                      ]
+                    }
+                  },
+                  "metadata": {
+                    "type": "object",
+                    "description": "Rich metadata extracted from the artifact",
+                    "properties": {
+                      "canonical": {
+                        "type": "string",
+                        "format": "uri",
+                        "description": "Canonical URL"
+                      },
+                      "author": {
+                        "type": "string",
+                        "description": "Artifact author name"
+                      },
+                      "keywords": {
+                        "type": "string",
+                        "description": "Artifact keywords"
+                      },
+                      "open_graph": {
+                        "type": "object",
+                        "description": "Open Graph protocol metadata",
+                        "additionalProperties": true
+                      },
+                      "twitter_card": {
+                        "type": "object",
+                        "description": "Twitter Card metadata",
+                        "additionalProperties": true
+                      },
+                      "json_ld": {
+                        "type": "array",
+                        "description": "JSON-LD structured data (schema.org)",
+                        "items": {
+                          "type": "object"
+                        }
+                      }
+                    },
+                    "additionalProperties": true
+                  },
+                  "provenance": {
+                    "title": "Provenance",
+                    "description": "Provenance metadata for this artifact. Serves as the default provenance for all assets within this artifact — individual assets can override with their own provenance.",
+                    "type": "object",
+                    "properties": {
+                      "digital_source_type": {
+                        "$ref": "#/$defs/DigitalSourceType"
+                      },
+                      "ai_tool": {
+                        "type": "object",
+                        "description": "AI system used to generate or modify this content. Aligns with IPTC 2025.1 AI metadata fields and C2PA claim_generator.",
+                        "properties": {
+                          "name": {
+                            "type": "string",
+                            "description": "Name of the AI tool or model (e.g., 'DALL-E 3', 'Stable Diffusion XL', 'Gemini')"
+                          },
+                          "version": {
+                            "type": "string",
+                            "description": "Version identifier for the AI tool or model (e.g., '25.1', '0125', '2.1'). For generative models, use the model version rather than the API version."
+                          },
+                          "provider": {
+                            "type": "string",
+                            "description": "Organization that provides the AI tool (e.g., 'OpenAI', 'Stability AI', 'Google')"
+                          }
+                        },
+                        "required": [
+                          "name"
+                        ],
+                        "additionalProperties": true
+                      },
+                      "human_oversight": {
+                        "type": "string",
+                        "description": "Level of human involvement in the AI-assisted creation process",
+                        "enum": [
+                          "none",
+                          "prompt_only",
+                          "selected",
+                          "edited",
+                          "directed"
+                        ],
+                        "enumDescriptions": {
+                          "none": "Fully automated with no human involvement in generation",
+                          "prompt_only": "Human provided the prompt or instructions but did not review outputs",
+                          "selected": "Human selected from multiple AI-generated candidates",
+                          "edited": "Human edited or refined AI-generated output",
+                          "directed": "Human directed the creative process with AI as an assistive tool"
+                        }
+                      },
+                      "declared_by": {
+                        "type": "object",
+                        "description": "Party declaring this provenance. Identifies who attached the provenance claim, enabling receiving parties to assess trust.",
+                        "properties": {
+                          "agent_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "description": "URL of the agent or service that declared this provenance"
+                          },
+                          "role": {
+                            "type": "string",
+                            "enum": [
+                              "creator",
+                              "advertiser",
+                              "agency",
+                              "platform",
+                              "tool"
+                            ],
+                            "description": "Role of the declaring party in the supply chain",
+                            "enumDescriptions": {
+                              "creator": "The party that created or generated the content",
+                              "advertiser": "The brand or advertiser that owns the content",
+                              "agency": "Agency acting on behalf of the advertiser",
+                              "platform": "Ad platform or publisher that processed the content",
+                              "tool": "Automated tool or service that attached provenance metadata"
+                            }
+                          }
+                        },
+                        "required": [
+                          "role"
+                        ],
+                        "additionalProperties": true
+                      },
+                      "declared_at": {
+                        "type": "string",
+                        "format": "date-time",
+                        "description": "When this provenance claim was made (ISO 8601). Distinct from created_time, which records when the content itself was produced. A provenance claim may be attached well after content creation, for example when retroactively declaring AI involvement for regulatory compliance."
+                      },
+                      "created_time": {
+                        "type": "string",
+                        "format": "date-time",
+                        "description": "When this content was created or generated (ISO 8601)"
+                      },
+                      "c2pa": {
+                        "type": "object",
+                        "description": "C2PA Content Credentials reference. Links to the cryptographic provenance manifest for this content. Because file-level C2PA bindings break during ad-tech transcoding, this URL reference preserves the chain of provenance through the supply chain.",
+                        "properties": {
+                          "manifest_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "description": "URL to the C2PA manifest store for this content"
+                          }
+                        },
+                        "required": [
+                          "manifest_url"
+                        ],
+                        "additionalProperties": true
+                      },
+                      "disclosure": {
+                        "type": "object",
+                        "description": "Regulatory disclosure requirements for this content. Indicates whether AI disclosure is required and under which jurisdictions.",
+                        "properties": {
+                          "required": {
+                            "type": "boolean",
+                            "description": "Whether AI disclosure is required for this content based on applicable regulations"
+                          },
+                          "jurisdictions": {
+                            "type": "array",
+                            "description": "Jurisdictions where disclosure obligations apply",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "country": {
+                                  "type": "string",
+                                  "description": "ISO 3166-1 alpha-2 country code (e.g., 'US', 'DE', 'CN')"
+                                },
+                                "region": {
+                                  "type": "string",
+                                  "description": "Sub-national region code (e.g., 'CA' for California, 'BY' for Bavaria)"
+                                },
+                                "regulation": {
+                                  "type": "string",
+                                  "description": "Regulation identifier (e.g., 'eu_ai_act_article_50', 'ca_sb_942', 'cn_deep_synthesis')"
+                                },
+                                "label_text": {
+                                  "type": "string",
+                                  "description": "Required disclosure label text for this jurisdiction, in the local language"
+                                },
+                                "render_guidance": {
+                                  "type": "object",
+                                  "description": "How the disclosure should be rendered for this jurisdiction. Expresses the declaring party's intent for persistence and position based on regulatory requirements. Publishers control actual rendering but governance agents can audit whether guidance was followed.",
+                                  "minProperties": 1,
+                                  "properties": {
+                                    "persistence": {
+                                      "$ref": "#/$defs/DisclosurePersistence"
+                                    },
+                                    "min_duration_ms": {
+                                      "type": "integer",
+                                      "minimum": 1,
+                                      "description": "Minimum display duration in milliseconds for initial persistence. Recommended when persistence is initial — without it, the duration is at the publisher's discretion. At serve time the publisher reads this from provenance since the brief is not available."
+                                    },
+                                    "positions": {
+                                      "type": "array",
+                                      "description": "Preferred disclosure positions in priority order. The first position a format supports should be used.",
+                                      "items": {
+                                        "$ref": "#/$defs/DisclosurePosition"
+                                      },
+                                      "minItems": 1,
+                                      "uniqueItems": true
+                                    },
+                                    "ext": {
+                                      "title": "Extension Object",
+                                      "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+                                      "type": "object",
+                                      "additionalProperties": true
+                                    }
+                                  },
+                                  "additionalProperties": true
+                                }
+                              },
+                              "required": [
+                                "country",
+                                "regulation"
+                              ],
+                              "additionalProperties": true
+                            },
+                            "minItems": 1
+                          }
+                        },
+                        "required": [
+                          "required"
+                        ],
+                        "additionalProperties": true
+                      },
+                      "verification": {
+                        "type": "array",
+                        "description": "Third-party verification or detection results for this content. Multiple services may independently evaluate the same content. Provenance is a claim — verification results attached by the declaring party are supplementary. The enforcing party (e.g., seller/publisher) should run its own verification via get_creative_features or calibrate_content.",
+                        "minItems": 1,
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "verified_by": {
+                              "type": "string",
+                              "description": "Name of the verification service (e.g., 'DoubleVerify', 'Hive Moderation', 'Reality Defender')"
+                            },
+                            "verified_time": {
+                              "type": "string",
+                              "format": "date-time",
+                              "description": "When the verification was performed (ISO 8601)"
+                            },
+                            "result": {
+                              "type": "string",
+                              "enum": [
+                                "authentic",
+                                "ai_generated",
+                                "ai_modified",
+                                "inconclusive"
+                              ],
+                              "description": "Verification outcome"
+                            },
+                            "confidence": {
+                              "type": "number",
+                              "minimum": 0,
+                              "maximum": 1,
+                              "description": "Confidence score of the verification result (0.0 to 1.0)"
+                            },
+                            "details_url": {
+                              "type": "string",
+                              "format": "uri",
+                              "description": "URL to the full verification report"
+                            }
+                          },
+                          "required": [
+                            "verified_by",
+                            "result"
+                          ],
+                          "additionalProperties": true
+                        }
+                      },
+                      "ext": {
+                        "title": "Extension Object",
+                        "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+                        "type": "object",
+                        "additionalProperties": true
+                      }
+                    },
+                    "additionalProperties": true
+                  },
+                  "identifiers": {
+                    "type": "object",
+                    "description": "Platform-specific identifiers for this artifact",
+                    "properties": {
+                      "apple_podcast_id": {
+                        "type": "string",
+                        "description": "Apple Podcasts ID"
+                      },
+                      "spotify_collection_id": {
+                        "type": "string",
+                        "description": "Spotify collection ID"
+                      },
+                      "podcast_guid": {
+                        "type": "string",
+                        "description": "Podcast GUID (from RSS feed)"
+                      },
+                      "youtube_video_id": {
+                        "type": "string",
+                        "description": "YouTube video ID"
+                      },
+                      "rss_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "description": "RSS feed URL"
+                      }
+                    },
+                    "additionalProperties": true
+                  }
+                },
+                "required": [
+                  "property_rid",
+                  "artifact_id",
+                  "assets"
+                ],
+                "additionalProperties": true
+              },
+              "country": {
+                "type": "string",
+                "description": "ISO 3166-1 alpha-2 country code where delivery occurred"
+              },
+              "channel": {
+                "type": "string",
+                "description": "Channel type (e.g., display, video, audio, social)"
+              },
+              "brand_context": {
+                "type": "object",
+                "description": "Brand information for policy evaluation. Schema TBD - placeholder for brand identifiers.",
+                "properties": {
+                  "brand_id": {
+                    "type": "string",
+                    "description": "Brand identifier"
+                  },
+                  "sku_id": {
+                    "type": "string",
+                    "description": "Product/SKU identifier if applicable"
+                  }
+                }
+              },
+              "local_verdict": {
+                "type": "string",
+                "enum": [
+                  "pass",
+                  "fail",
+                  "unevaluated"
+                ],
+                "description": "Seller's local model verdict for this artifact"
+              }
+            },
+            "required": [
+              "record_id",
+              "artifact"
+            ]
+          }
+        },
+        "collection_info": {
+          "type": "object",
+          "description": "Information about artifact collection for this media buy. Sampling is configured at buy creation time — this reports what was actually collected.",
+          "properties": {
+            "total_deliveries": {
+              "type": "integer",
+              "description": "Total deliveries in the requested time range"
+            },
+            "total_collected": {
+              "type": "integer",
+              "description": "Total artifacts collected (per the buy's sampling configuration)"
+            },
+            "returned_count": {
+              "type": "integer",
+              "description": "Number of artifacts in this response (may be less than total_collected due to pagination or filters)"
+            },
+            "effective_rate": {
+              "type": "number",
+              "description": "Actual collection rate achieved (total_collected / total_deliveries)"
+            }
+          }
+        },
+        "pagination": {
+          "title": "Pagination Response",
+          "description": "Standard cursor-based pagination metadata for list responses",
+          "type": "object",
+          "properties": {
+            "has_more": {
+              "type": "boolean",
+              "description": "Whether more results are available beyond this page"
+            },
+            "cursor": {
+              "type": "string",
+              "description": "Opaque cursor to pass in the next request to fetch the next page. Only present when has_more is true."
+            },
+            "total_count": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Total number of items matching the query across all pages. Optional because not all backends can efficiently compute this."
+            }
+          },
+          "required": [
+            "has_more"
+          ],
+          "additionalProperties": false
+        },
+        "context": {
+          "title": "Context Object",
+          "description": "Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.",
+          "type": "object",
+          "additionalProperties": true
+        },
+        "ext": {
+          "title": "Extension Object",
+          "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+          "type": "object",
+          "additionalProperties": true
+        }
+      },
+      "required": [
+        "media_buy_id",
+        "artifacts"
+      ]
+    },
+    {
+      "type": "object",
+      "description": "Error response",
+      "properties": {
+        "errors": {
+          "type": "array",
+          "items": {
+            "title": "Error",
+            "description": "Standard error structure for task-specific errors and warnings",
+            "type": "object",
+            "properties": {
+              "code": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 64,
+                "description": "Error code for programmatic handling. Standard codes are defined in error-code.json and enable autonomous agent recovery. Sellers MAY use codes not in the standard vocabulary for platform-specific errors; agents MUST handle unknown codes gracefully by falling back to the recovery classification."
+              },
+              "message": {
+                "type": "string",
+                "description": "Human-readable error message"
+              },
+              "field": {
+                "type": "string",
+                "description": "Field path associated with the error (e.g., 'packages[0].targeting')"
+              },
+              "suggestion": {
+                "type": "string",
+                "description": "Suggested fix for the error"
+              },
+              "retry_after": {
+                "type": "number",
+                "description": "Seconds to wait before retrying the operation. Sellers MUST return values between 1 and 3600. Clients MUST clamp values outside this range.",
+                "minimum": 1,
+                "maximum": 3600
+              },
+              "details": {
+                "type": "object",
+                "description": "Additional task-specific error details",
+                "additionalProperties": true
+              },
+              "recovery": {
+                "type": "string",
+                "enum": [
+                  "transient",
+                  "correctable",
+                  "terminal"
+                ],
+                "description": "Agent recovery classification. transient: retry after delay (rate limit, service unavailable, timeout). correctable: fix the request and resend (invalid field, budget too low, creative rejected). terminal: requires human action (account suspended, payment required, account not found)."
+              }
+            },
+            "required": [
+              "code",
+              "message"
+            ],
+            "additionalProperties": true
+          }
+        },
+        "context": {
+          "title": "Context Object",
+          "description": "Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.",
+          "type": "object",
+          "additionalProperties": true
+        },
+        "ext": {
+          "title": "Extension Object",
+          "description": "Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.",
+          "type": "object",
+          "additionalProperties": true
+        }
+      },
+      "required": [
+        "errors"
+      ]
+    }
+  ],
+  "$defs": {
+    "asset_access": {
+      "type": "object",
+      "description": "Authentication for accessing secured asset URLs",
+      "oneOf": [
+        {
+          "type": "object",
+          "description": "Bearer token authentication",
+          "properties": {
+            "method": {
+              "type": "string",
+              "const": "bearer_token"
+            },
+            "token": {
+              "type": "string",
+              "description": "OAuth2 bearer token for Authorization header"
+            }
+          },
+          "required": [
+            "method",
+            "token"
+          ]
+        },
+        {
+          "type": "object",
+          "description": "Service account authentication (GCP, AWS)",
+          "properties": {
+            "method": {
+              "type": "string",
+              "const": "service_account"
+            },
+            "provider": {
+              "type": "string",
+              "enum": [
+                "gcp",
+                "aws"
+              ],
+              "description": "Cloud provider"
+            },
+            "credentials": {
+              "type": "object",
+              "description": "Service account credentials",
+              "additionalProperties": true
+            }
+          },
+          "required": [
+            "method",
+            "provider"
+          ]
+        },
+        {
+          "type": "object",
+          "description": "Pre-signed URL (credentials embedded in URL)",
+          "properties": {
+            "method": {
+              "type": "string",
+              "const": "signed_url"
+            }
+          },
+          "required": [
+            "method"
+          ]
+        }
+      ]
+    },
+    "DigitalSourceType": {
+      "title": "Digital Source Type",
+      "description": "IPTC-aligned classification of AI involvement in producing this content",
+      "type": "string",
+      "enum": [
+        "digital_capture",
+        "digital_creation",
+        "trained_algorithmic_media",
+        "composite_with_trained_algorithmic_media",
+        "algorithmic_media",
+        "composite_capture",
+        "composite_synthetic",
+        "human_edits",
+        "data_driven_media"
+      ],
+      "enumDescriptions": {
+        "digital_capture": "Captured by a digital device (camera, scanner, screen recording) with no AI involvement",
+        "digital_creation": "Created by a human using digital tools (Photoshop, Illustrator, After Effects) without AI generation",
+        "trained_algorithmic_media": "Generated entirely by a trained AI model (DALL-E, Midjourney, Stable Diffusion, Sora)",
+        "composite_with_trained_algorithmic_media": "Human-created content combined with AI-generated elements (e.g., photo with AI background)",
+        "algorithmic_media": "Produced by deterministic algorithms without machine learning (procedural generation, rule-based systems)",
+        "composite_capture": "Multiple digital captures composited together without AI",
+        "composite_synthetic": "Composite of multiple elements where at least one is AI-generated (e.g., stock photo composited with AI-generated background)",
+        "human_edits": "Content augmented, corrected, or enhanced by humans using non-generative tools",
+        "data_driven_media": "Assembled from structured data feeds (DCO templates, product catalogs, weather-triggered variants)"
+      }
+    },
+    "DisclosurePersistence": {
+      "title": "Disclosure Persistence",
+      "description": "How long the disclosure must persist during content playback or display",
+      "type": "string",
+      "enum": [
+        "continuous",
+        "initial",
+        "flexible"
+      ],
+      "enumDescriptions": {
+        "continuous": "Disclosure must remain visible or audible throughout the entire content display duration. For video and audio, this means the full playback duration. For static formats (display, DOOH), this means the full display slot. For DOOH specifically, 'content duration' means the ad's display slot within the rotation, not the screen's full rotation cycle.",
+        "initial": "Disclosure must appear at the start of content for a minimum duration before it may be removed. Pair with min_duration_ms in render_guidance or creative brief to specify the required duration.",
+        "flexible": "Disclosure presence is sufficient; placement timing and duration are at the publisher's discretion"
+      }
+    },
+    "DisclosurePosition": {
+      "title": "Disclosure Position",
+      "description": "Where a required disclosure should appear within a creative. Used by creative briefs to specify disclosure placement and by formats to declare which positions they can render.",
+      "type": "string",
+      "enum": [
+        "prominent",
+        "footer",
+        "audio",
+        "subtitle",
+        "overlay",
+        "end_card",
+        "pre_roll",
+        "companion"
+      ]
+    }
+  },
+  "_bundled": {
+    "generatedAt": "2026-04-28T12:32:22.853Z",
+    "note": "This is a bundled schema with all $ref resolved inline. For the modular version with references, use the parent directory."
+  }
+}