@adcp/sdk 15.2.0 → 15.2.2

package/dist/lib/types/wellknown-schemas.generated.js

@@ -23,7 +23,7 @@ __export(wellknown_schemas_generated_exports, {
 });
 module.exports = __toCommonJS(wellknown_schemas_generated_exports);
 var import_zod = require("zod");
-const BrandJsonSchema = import_zod.z.union([import_zod.z.object({ "$schema": import_zod.z.string().optional(), "authoritative_location": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL of the authoritative brand.json file"), "redirect_reason": import_zod.z.enum(["acquisition", "divestiture", "rebrand", "regional", "legacy", "consolidation", "other"]).describe("Optional structured signal indicating why this redirect was put in place. Consumers SHOULD use this to inform cache TTL decisions: 'acquisition' / 'divestiture' / 'rebrand' / 'consolidation' suggest the resolved target is in transition and consumers SHOULD shorten cache TTL until stable. 'regional' / 'legacy' suggest a stable redirect with no special cache handling needed. Free-text rationale belongs in 'note'.").optional(), "redirect_effective_at": import_zod.z.string().datetime().describe("Optional timestamp when this redirect became effective. Caches MUST treat any entry cached before this timestamp as stale and re-fetch through the redirect.").optional(), "note": import_zod.z.string().describe("Optional human-readable rationale for the redirect.").optional(), "last_updated": import_zod.z.string().datetime().optional() }).strict().describe("Redirects to a hosted brand.json file at another URL"), import_zod.z.object({ "$schema": import_zod.z.string().optional(), "house": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("House domain to fetch brand portfolio from"), "region": import_zod.z.string().regex(new RegExp("^[A-Z]{2}$")).describe("ISO 3166-1 alpha-2 country code if this is a regional domain").optional(), "redirect_reason": import_zod.z.enum(["acquisition", "divestiture", "rebrand", "regional", "legacy", "consolidation", "other"]).describe("Optional structured signal indicating why this redirect was put in place. Consumers SHOULD use this to inform cache TTL decisions: 'acquisition' / 'divestiture' / 'rebrand' / 'consolidation' suggest the resolved target is in transition and consumers SHOULD shorten cache TTL until stable. 'regional' / 'legacy' suggest a stable redirect with no special cache handling needed. Free-text rationale belongs in 'note'.").optional(), "redirect_effective_at": import_zod.z.string().datetime().describe("Optional timestamp when this redirect became effective. Caches MUST treat any entry cached before this timestamp as stale and re-fetch through the redirect.").optional(), "note": import_zod.z.string().describe("Optional human-readable rationale for the redirect.").optional(), "last_updated": import_zod.z.string().datetime().optional() }).strict().describe("Redirects to the house domain that contains the full brand portfolio"), import_zod.z.object({ "$schema": import_zod.z.string().optional(), "version": import_zod.z.string().optional(), "agents": import_zod.z.array(import_zod.z.object({ "type": import_zod.z.enum(["brand", "rights", "measurement", "governance", "creative", "sales", "buying", "signals"]).describe("Functional role of this agent"), "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Agent endpoint URL (MCP or A2A). Callers comparing a brand's declared agent URL against another value (e.g., resolving 'is this the agent that signed this artifact?' or matching against a discovery cache) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. After the publication chain and an authorized request-signing key verify, this exact entry's canonical URL is the stable Agent identity input for principal mapping; the domain, JWKS URI, kid, and key material are credential or trust facts beneath it, not the Agent identity. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).max(100).describe("Agent identifier (useful for logging, multi-tenant platforms)"), "description": import_zod.z.string().max(500).describe("Human-readable description of this agent's capabilities or scope").optional(), "jwks_uri": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL of the agent's JWKS (RFC 7517) containing public keys used to verify artifacts this agent signs or requests it sends. Verified artifacts include signed governance_context tokens (for governance agents) and RFC 9421 HTTP Signatures on outgoing requests (for any agent). When absent, verifiers MUST default to /.well-known/jwks.json on the origin of `url`. Keys are identified by `kid` in the JWS header or RFC 9421 `keyid` parameter; JWKS MAY contain multiple keys to support rotation and per-purpose separation via `key_ops` and `use`.").optional(), "available_uses": import_zod.z.array(import_zod.z.enum(["likeness", "voice", "name", "endorsement", "motion_capture", "signature", "catchphrase", "sync", "background_music", "editorial", "commercial", "ai_generated_image"]).describe("Types of rights usage that can be licensed through the brand protocol. Aligned with DDEX UseType direction for interoperability with music and media rights systems.")).describe("For rights agents: rights uses available for licensing").optional(), "right_types": import_zod.z.array(import_zod.z.enum(["talent", "character", "brand_ip", "music", "stock_media"]).describe("Categories of intellectual property rights that can be licensed through the brand protocol.")).describe("For rights agents: types of rights available").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("ISO 3166-1 alpha-2 country codes where this agent operates. Omit for global scope.").optional() }).catchall(import_zod.z.any()).describe("An agent declared by a brand or house. Each entry identifies one agent endpoint and its functional role in the advertising ecosystem.")).describe("Agents declared by this brand or house. Multiple entries with the same type are permitted when they have distinct url values, such as one endpoint URL per tenant or property scope. Agent url values MUST be unique within this array; duplicate urls are invalid because signature verifiers resolve a signing key by matching one agent url to one agents[] entry and reject ambiguous matches.").optional(), "brand_agent": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Brand agent MCP endpoint URL. Callers comparing this URL against another value (e.g., resolving 'is this the brand's declared agent?' against a discovery cache) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Agent identifier (useful for logging, multi-tenant DAMs)") }).catchall(import_zod.z.any()).describe("Reference to a brand agent that provides brand data via MCP").optional(), "contact": import_zod.z.object({ "name": import_zod.z.string().min(1).max(255), "email": import_zod.z.string().email().max(255).optional(), "domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("A valid domain name").optional() }).catchall(import_zod.z.any()).describe("Contact information").optional(), "data_subject_contestation": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to a human-accessible contestation form or information page.").optional(), "email": import_zod.z.string().email().describe("Email address for contestation requests. Deployer MUST monitor and respond within the timelines set by applicable law (e.g., 1 month under GDPR Art. 12(3)).").optional(), "languages": import_zod.z.array(import_zod.z.string()).describe("BCP 47 language tags the contestation channel supports (e.g., ['en', 'de', 'fr']). At minimum SHOULD include a language spoken in every jurisdiction where the brand runs regulated-vertical campaigns.").optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("Contact point where a data subject can request human intervention, express their view, or contest an automated decision \u2014 satisfying GDPR Article 22(3) and EU AI Act Article 26(11) transparency obligations. This is a contact reference (URL, email, or both), not a machine-callable API. AdCP surfaces the pointer; the deployer runs the contestation workflow.").optional(), "last_updated": import_zod.z.string().datetime().optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("Brand represented by agents that provide brand info via MCP"), import_zod.z.object({ "$schema": import_zod.z.string().optional(), "version": import_zod.z.string().optional(), "default_language": import_zod.z.string().regex(new RegExp("^(?:[a-z]{2,8}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[0-9]{3}))?(?:-(?:[a-z0-9]{5,8}|[0-9][a-z0-9]{3}))*(?:-[0-9a-wy-z](?:-[a-z0-9]{2,8})+)*(?:-x(?:-[a-z0-9]{1,8})+)?|x(?:-[a-z0-9]{1,8})+)$")).min(2).max(63).describe("A well-formed BCP 47 language tag used by AdCP only as language identity. Script and region may refine that identity; other valid BCP 47 subtags remain part of tag matching but do not make this a general locale-settings object. It does not determine currency, time zone, number/date formatting, market, or legal jurisdiction. The AdCP canonical wire profile requires lower-case language and variants, title-case script, and upper-case region (for example `en-US`, `zh-Hant-TW`, or `x-private`). RFC 5646 comparisons are case-insensitive and its case regularization is optional; AdCP intentionally requires this stricter single wire spelling and receivers MUST reject differently cased tags rather than silently normalizing them. The schema pattern enforces the AdCP casing profile and extension structure for commonly used tags; conforming receivers additionally validate the complete RFC 5646 grammar and registry rules. Every new AdCP field carrying BCP 47 language identity or a concrete language range MUST reference this schema instead of declaring independent string constraints.").describe("BCP 47 language tag for legacy plain-string and plain-array content in this document. Readers assume en when omitted.").default("en"), "house": import_zod.z.object({ "domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("The house's domain where brand.json is hosted"), "name": import_zod.z.string().min(1).describe("Primary display name of the house"), "names": import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged.")).describe("Localized house names including legal name, stock symbol, etc.").optional(), "architecture": import_zod.z.enum(["branded_house", "house_of_brands", "hybrid"]).describe("Brand architecture model: branded_house (Google), house_of_brands (P&G), hybrid (Nike)").optional(), "agents": import_zod.z.array(import_zod.z.object({ "type": import_zod.z.enum(["brand", "rights", "measurement", "governance", "creative", "sales", "buying", "signals"]).describe("Functional role of this agent"), "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Agent endpoint URL (MCP or A2A). Callers comparing a brand's declared agent URL against another value (e.g., resolving 'is this the agent that signed this artifact?' or matching against a discovery cache) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. After the publication chain and an authorized request-signing key verify, this exact entry's canonical URL is the stable Agent identity input for principal mapping; the domain, JWKS URI, kid, and key material are credential or trust facts beneath it, not the Agent identity. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).max(100).describe("Agent identifier (useful for logging, multi-tenant platforms)"), "description": import_zod.z.string().max(500).describe("Human-readable description of this agent's capabilities or scope").optional(), "jwks_uri": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL of the agent's JWKS (RFC 7517) containing public keys used to verify artifacts this agent signs or requests it sends. Verified artifacts include signed governance_context tokens (for governance agents) and RFC 9421 HTTP Signatures on outgoing requests (for any agent). When absent, verifiers MUST default to /.well-known/jwks.json on the origin of `url`. Keys are identified by `kid` in the JWS header or RFC 9421 `keyid` parameter; JWKS MAY contain multiple keys to support rotation and per-purpose separation via `key_ops` and `use`.").optional(), "available_uses": import_zod.z.array(import_zod.z.enum(["likeness", "voice", "name", "endorsement", "motion_capture", "signature", "catchphrase", "sync", "background_music", "editorial", "commercial", "ai_generated_image"]).describe("Types of rights usage that can be licensed through the brand protocol. Aligned with DDEX UseType direction for interoperability with music and media rights systems.")).describe("For rights agents: rights uses available for licensing").optional(), "right_types": import_zod.z.array(import_zod.z.enum(["talent", "character", "brand_ip", "music", "stock_media"]).describe("Categories of intellectual property rights that can be licensed through the brand protocol.")).describe("For rights agents: types of rights available").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("ISO 3166-1 alpha-2 country codes where this agent operates. Omit for global scope.").optional() }).catchall(import_zod.z.any()).describe("An agent declared by a brand or house. Each entry identifies one agent endpoint and its functional role in the advertising ecosystem.")).describe("House-level agents that apply to all brands unless overridden at the brand level").optional(), "data_subject_contestation": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to a human-accessible contestation form or information page.").optional(), "email": import_zod.z.string().email().describe("Email address for contestation requests. Deployer MUST monitor and respond within the timelines set by applicable law (e.g., 1 month under GDPR Art. 12(3)).").optional(), "languages": import_zod.z.array(import_zod.z.string()).describe("BCP 47 language tags the contestation channel supports (e.g., ['en', 'de', 'fr']). At minimum SHOULD include a language spoken in every jurisdiction where the brand runs regulated-vertical campaigns.").optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("House-level fallback contestation contact. Governance agents resolve in order: brand.data_subject_contestation \u2192 house.data_subject_contestation \u2192 missing (critical finding when human review required).").optional(), "identity_relying_parties": import_zod.z.array(import_zod.z.object({ "issuer": import_zod.z.object({ "domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where /.well-known/brand.json is hosted, or the brand's operating domain"), "brand_id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Brand identifier within the house portfolio. Optional for single-brand domains.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Canonical set of ISO 3166-1 alpha-2 countries for this advertiser identity. Omit for a global/default identity. Array order is not meaningful; producers MUST sort codes lexicographically before computing keys or signatures. This qualifies account identity and is not delivery targeting.").optional(), "industries": import_zod.z.array(import_zod.z.string()).describe("Inline override for the brand's industries. Useful when the caller cannot modify the brand's canonical brand.json but needs to declare industries for governance (e.g., Annex III vertical detection). brand.json remains the canonical source; when omitted here, governance agents SHOULD resolve from brand.json.").optional(), "data_subject_contestation": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).optional(), "email": import_zod.z.string().email().optional(), "languages": import_zod.z.array(import_zod.z.string()).optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("Inline override for the brand's contestation contact point. Useful when the operator does not control brand.json but needs to discharge Art 22(3) for this plan. brand.json is canonical; when omitted, governance agents resolve brand \u2192 house \u2192 missing.").optional(), "brand_kit_override": import_zod.z.object({ "logo": import_zod.z.object({ "asset_type": import_zod.z.literal("image").describe("Discriminator identifying this as an image asset. See /schemas/creative/asset-types for the registry."), "url": import_zod.z.string().url().describe("URL to the image asset"), "width": import_zod.z.number().int().gte(1).describe("Width in pixels"), "height": import_zod.z.number().int().gte(1).describe("Height in pixels"), "file_size_bytes": import_zod.z.number().int().gte(1).describe("Image file size in bytes. Required by agents that advertise a max_file_size_kb constraint.").optional(), "pixel_ratio": import_zod.z.number().gt(0).describe("Intrinsic pixels per logical render pixel (for example `2` for a 600\xD7500 image intended to render at 300\xD7250). Optional because a validator can infer the ratio when the target format declares logical dimensions. When supplied, it MUST agree with both `width / logical_width` and `height / logical_height`; it is never a substitute for the intrinsic `width` and `height` fields.").optional(), "state_id": import_zod.z.string().describe("Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one declared `states[].state_id` (semantic validators resolve it). Omit for ordinary image slots.").optional(), "breakpoint_id": import_zod.z.string().describe("Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one breakpoint declared on the selected state (semantic validators resolve it). Omit for ordinary image slots.").optional(), "focal_point": import_zod.z.array(import_zod.z.number().gte(0).lte(1)).max(2).describe("Normalized `[x, y]` coordinates (0\u20131 from top-left) of the image's visual anchor. Seller-side renderers crop toward the focal point when deriving renditions across breakpoints and aspect ratios; absent, cropping falls back to center-weighted defaults.").optional(), "format": import_zod.z.string().describe("Image file format (jpg, png, gif, webp, etc.)").optional(), "alt_text": import_zod.z.string().describe("Alternative text for accessibility").optional(), "provenance": import_zod.z.object({ "digital_source_type": import_zod.z.enum(["digital_capture", "digital_creation", "trained_algorithmic_media", "composite_with_trained_algorithmic_media", "algorithmic_media", "composite_capture", "composite_synthetic", "human_edits", "data_driven_media"]).describe("IPTC-aligned classification of AI involvement in producing this content").optional(), "synthetic_depiction": import_zod.z.boolean().describe("Assessed declaration of whether the content synthetically depicts a real or fictional person performing or appearing in a way that was generated or materially manipulated rather than captured as depicted. `true` covers both a fully synthetic performer and material manipulation of a real performer; `false` is an assessed declaration that the content does not contain such a depiction. Absence means the content has not been assessed for synthetic depiction. This field does not claim consent, legality, or independent verification, and receivers MUST NOT derive it solely from `digital_source_type`.").optional(), "ai_tool": import_zod.z.object({ "name": import_zod.z.string().describe("Name of the AI tool or model (e.g., 'DALL-E 3', 'Stable Diffusion XL', 'Gemini')"), "version": import_zod.z.string().describe("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.").optional(), "provider": import_zod.z.string().describe("Organization that provides the AI tool (e.g., 'OpenAI', 'Stability AI', 'Google')").optional() }).describe("AI system used to generate or modify this content. Aligns with IPTC 2025.1 AI metadata fields and C2PA claim_generator.").optional(), "human_oversight": import_zod.z.enum(["none", "prompt_only", "selected", "edited", "directed"]).describe("Level of human involvement in the AI-assisted creation process. Independent of `disclosure.required` \u2014 the protocol does not derive disclosure obligations from oversight level. Some regulations include carve-outs for human-edited or human-directed AI output, but those carve-outs have factual prerequisites the schema cannot evaluate. Asserting `edited` or `directed` does not by itself justify `disclosure.required: false`.").optional(), "declared_by": import_zod.z.object({ "agent_url": import_zod.z.string().url().describe("URL of the agent or service that declared this provenance").optional(), "role": import_zod.z.enum(["creator", "advertiser", "agency", "platform", "tool"]).describe("Role of the declaring party in the supply chain") }).describe("Party declaring this provenance. Identifies who attached the provenance claim, enabling receiving parties to assess trust.").optional(), "declared_at": import_zod.z.string().datetime().describe("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.").optional(), "created_time": import_zod.z.string().datetime().describe("When this content was created or generated (ISO 8601)").optional(), "c2pa": import_zod.z.object({ "manifest_url": import_zod.z.string().url().describe("URL to the C2PA manifest store for this content") }).describe("C2PA sidecar manifest reference. Links to a detached cryptographic provenance manifest for this content. Note: file-level C2PA bindings break when ad servers transcode, resize, or re-encode assets. For pipelines with intermediaries, consider embedded_provenance as the primary provenance mechanism.").optional(), "embedded_provenance": import_zod.z.array(import_zod.z.object({ "method": import_zod.z.enum(["manifest_wrapper", "provenance_markers"]).describe("How provenance data is carried within the content"), "standard": import_zod.z.string().describe("Standard the embedding conforms to, if any (e.g., 'c2pa' for C2PA Section A.7 text manifest embedding)").optional(), "provider": import_zod.z.string().describe("Organization that performed the embedding (e.g., 'Encypher', 'Digimarc'). Display label and audit context \u2014 not a wire identifier."), "verify_agent": import_zod.z.object({ "agent_url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("URL of the governance agent the buyer represents was used to embed/verify this layer. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."), "feature_id": import_zod.z.string().describe("Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `encypher.markers_present_v2`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog.").optional() }).strict().describe("Buyer's representation that this embedding can be verified by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing \u2014 the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist). MAY be omitted for self-verifiable embeddings (e.g., a C2PA text manifest with a public key the seller already trusts).").optional(), "embedded_at": import_zod.z.string().datetime().describe("When the provenance data was embedded (ISO 8601)").optional() })).describe("Provenance metadata embedded within the content stream. Each entry declares one embedding layer: structured provenance data carried inside the content itself, as distinct from sidecar references (c2pa.manifest_url). Embedded provenance survives operations that break sidecar and file-level bindings: ad-server transcoding, CMS ingestion, copy-paste, reformatting, and CDN re-encoding. For ad-tech pipelines where content passes through multiple intermediaries, embedded provenance is the reliable path for provenance that persists from declaration through delivery. This is a declaration by the embedding party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).").optional(), "watermarks": import_zod.z.array(import_zod.z.object({ "media_type": import_zod.z.enum(["audio", "image", "video", "text"]).describe("Media category of the watermarked content"), "provider": import_zod.z.string().describe("Organization that applied the watermark (e.g., 'Imatag', 'Steg.AI', 'Encypher'). Display label and audit context \u2014 not a wire identifier."), "verify_agent": import_zod.z.object({ "agent_url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("URL of the governance agent the buyer represents was used to apply/detect this watermark. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."), "feature_id": import_zod.z.string().describe("Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `imatag.watermark_detected`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog.").optional() }).strict().describe("Buyer's representation that this watermark can be detected by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing \u2014 the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist).").optional(), "c2pa_action": import_zod.z.enum(["c2pa.watermarked.bound", "c2pa.watermarked.unbound"]).describe("C2PA action classification for this watermark").optional(), "embedded_at": import_zod.z.string().datetime().describe("When the watermark was applied (ISO 8601)").optional() })).describe("Content watermarks applied to this asset. Each entry declares one watermarking layer: a content modification that encodes an identifier or fingerprint within the asset. Watermarks differ from embedded provenance: a watermark encodes an identifier (who generated it, who owns it), while embedded provenance carries or references a structured provenance record (the full chain of custody). A single asset may carry both. Aligns with C2PA action taxonomy: c2pa.watermarked.bound (watermark linked to a C2PA manifest) and c2pa.watermarked.unbound (watermark independent of any manifest). This is a declaration by the watermarking party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).").optional(), "disclosure": import_zod.z.object({ "required": import_zod.z.boolean().describe("The declaring party's claim that AI disclosure is required for this content under applicable regulations. This is a declared signal carried through the supply chain \u2014 useful as a routing and audit input \u2014 not a regulatory determination made by the protocol. Receiving parties remain responsible for their own jurisdictional analysis and should not treat `required: false` as compliance cover."), "jurisdictions": import_zod.z.array(import_zod.z.object({ "country": import_zod.z.string().describe("ISO 3166-1 alpha-2 country code (e.g., 'US', 'DE', 'CN')"), "region": import_zod.z.string().describe("Sub-national region code (e.g., 'CA' for California, 'BY' for Bavaria)").optional(), "regulation": import_zod.z.string().describe("Regulation identifier (e.g., 'eu_ai_act_article_50', 'ca_sb_942', 'cn_deep_synthesis')"), "label_text": import_zod.z.string().describe("Required disclosure label text for this jurisdiction, in the local language").optional(), "render_guidance": import_zod.z.object({ "persistence": import_zod.z.enum(["continuous", "initial", "flexible"]).describe("How long the disclosure must persist during content playback or display").optional(), "min_duration_ms": import_zod.z.number().int().gte(1).describe("Minimum display duration in milliseconds for initial persistence. Recommended when persistence is initial \u2014 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.").optional(), "positions": import_zod.z.array(import_zod.z.enum(["prominent", "footer", "audio", "subtitle", "overlay", "end_card", "pre_roll", "companion"]).describe("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.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Preferred disclosure positions in priority order. The first position a format supports should be used.").optional(), "ext": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).describe("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.").optional() }).describe("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.").optional() })).describe("Jurisdictions where disclosure obligations apply").optional() }).describe("Regulatory disclosure requirements for this content. Indicates whether AI disclosure is required and under which jurisdictions.").optional(), "verification": import_zod.z.array(import_zod.z.object({ "verified_by": import_zod.z.string().describe("Name of the verification service (e.g., 'DoubleVerify', 'Hive Moderation', 'Reality Defender')"), "verified_time": import_zod.z.string().datetime().describe("When the verification was performed (ISO 8601)").optional(), "result": import_zod.z.enum(["authentic", "ai_generated", "ai_modified", "inconclusive"]).describe("Verification outcome"), "confidence": import_zod.z.number().gte(0).lte(1).describe("Confidence score of the verification result (0.0 to 1.0)").optional(), "details_url": import_zod.z.string().url().describe("URL to the full verification report").optional() })).describe("Third-party verification or detection results for this content. Multiple services may independently evaluate the same content. Provenance is a claim \u2014 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.").optional(), "ext": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).describe("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.").optional() }).describe("Provenance metadata for this asset, overrides manifest-level provenance").optional() }).catchall(import_zod.z.any()).describe("Override logo asset.").optional(), "colors": import_zod.z.object({ "primary": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional(), "secondary": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional(), "accent": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional() }).catchall(import_zod.z.any()).describe("Override brand colors (hex strings).").optional(), "voice": import_zod.z.string().describe("Override brand-voice description for surface-composed text/audio output.").optional(), "tagline": import_zod.z.string().describe("Override tagline.").optional() }).catchall(import_zod.z.any()).describe("Inline override for brand-kit fields normally resolved from `/.well-known/brand.json` on `domain` (logo, colors, voice, tagline). Use when brand.json is missing, stale, or inappropriate for this specific call \u2014 e.g., a campaign-scoped tagline, a co-branded creative, a freshly-rebranded color palette the brand.json hasn't shipped yet. Same inline-override pattern as `industries` and `data_subject_contestation` above: brand.json is canonical, the override is per-call. Adopters needing to override fields outside this subset (`voice_attributes`, `prohibited_terms`, etc.) MUST publish a different brand.json and reference it via a different `domain` \u2014 the inline override is intentionally narrow to a small high-traffic subset.\n\n**Merge semantics (normative).** The merge is **field-level**, not whole-object replacement. Each field within `brand_kit_override` (`logo`, `colors`, `voice`, `tagline`) is evaluated independently \u2014 when a field is present on the override the override value applies; when a field is absent the brand.json value applies (or is absent if brand.json doesn't carry one either). For composite fields (`colors.primary`, `colors.secondary`, `colors.accent`), the merge is one level deeper: each color slot is evaluated independently \u2014 a producer can override `colors.primary` while still inheriting `colors.secondary` from brand.json. SDKs MUST NOT treat a present `brand_kit_override.colors` as wiping the brand.json `colors` block entirely; only the per-slot fields present in the override take precedence. Without this rule, a partial-override semantics would diverge across SDKs and produce inconsistent rendering for the same payload.").optional() }).strict().describe(`Identity issuer / attestation authority, referenced as a vendor BrandRef (e.g. {"domain": "world.org"}) \u2014 the same vendor-reference shape AdCP uses for measurement and signals vendors. The issuer's canonical domain is the anchor; it need not host a brand.json, but if it does, that is where its verifier metadata (scheme versions, verify endpoint, JWKs) lives. Issuer-agnostic: World ID, ISO 18013-5 mDL, and W3C-VC issuers all reference by domain. The relying party is namespaced by the issuer \u2014 identity is the tuple (issuer.domain, issuer.brand_id, relying_party_id), mirroring (vendor.domain, vendor.brand_id, metric_id).`), "scheme": import_zod.z.string().describe('Proof scheme and version, e.g. "world_id_v4".').optional(), "relying_party_id": import_zod.z.string().describe("The relying-party id registered with the issuer (and, for on-chain issuers like World ID, with the issuer's registry). One entity may operate many relying parties (scope=entity vs scope=property); this is the attestation's audience / linkability boundary, not an entity identifier."), "scope": import_zod.z.enum(["entity", "property"]).describe("Whether this relying_party_id is shared across the entity's properties (entity \u2192 a within-entity unique-human graph) or scoped to a single property (property \u2192 per-property pseudonyms, unlinkable across the entity).").optional() }).strict().describe("A verified-identity relying party an entity or brand operates. Used for attestation provenance in TMP Identity Match (the buyer checks a forwarded attestation's relying_party_id against the owner's published list). Issuer-agnostic; World ID is the first issuer.")).describe("Verified-identity relying parties this house/entity operates, so a buyer can verify that a forwarded TMP identity attestation's relying_party_id genuinely belongs to this entity (provenance) rather than being replayed under another owner. For network-as-RP, the network publishes its own relying_party_id here. See specs/tmp-verified-identity-attestation.md.").optional() }).catchall(import_zod.z.any()).describe("Corporate or organizational entity that owns brands"), "brands": import_zod.z.array(import_zod.z.object({ "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Brand identifier within the house. House chooses this ID."), "url": import_zod.z.string().url().describe("Primary brand URL for context and asset discovery").optional(), "identity_relying_parties": import_zod.z.array(import_zod.z.object({ "issuer": import_zod.z.object({ "domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where /.well-known/brand.json is hosted, or the brand's operating domain"), "brand_id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Brand identifier within the house portfolio. Optional for single-brand domains.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Canonical set of ISO 3166-1 alpha-2 countries for this advertiser identity. Omit for a global/default identity. Array order is not meaningful; producers MUST sort codes lexicographically before computing keys or signatures. This qualifies account identity and is not delivery targeting.").optional(), "industries": import_zod.z.array(import_zod.z.string()).describe("Inline override for the brand's industries. Useful when the caller cannot modify the brand's canonical brand.json but needs to declare industries for governance (e.g., Annex III vertical detection). brand.json remains the canonical source; when omitted here, governance agents SHOULD resolve from brand.json.").optional(), "data_subject_contestation": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).optional(), "email": import_zod.z.string().email().optional(), "languages": import_zod.z.array(import_zod.z.string()).optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("Inline override for the brand's contestation contact point. Useful when the operator does not control brand.json but needs to discharge Art 22(3) for this plan. brand.json is canonical; when omitted, governance agents resolve brand \u2192 house \u2192 missing.").optional(), "brand_kit_override": import_zod.z.object({ "logo": import_zod.z.object({ "asset_type": import_zod.z.literal("image").describe("Discriminator identifying this as an image asset. See /schemas/creative/asset-types for the registry."), "url": import_zod.z.string().url().describe("URL to the image asset"), "width": import_zod.z.number().int().gte(1).describe("Width in pixels"), "height": import_zod.z.number().int().gte(1).describe("Height in pixels"), "file_size_bytes": import_zod.z.number().int().gte(1).describe("Image file size in bytes. Required by agents that advertise a max_file_size_kb constraint.").optional(), "pixel_ratio": import_zod.z.number().gt(0).describe("Intrinsic pixels per logical render pixel (for example `2` for a 600\xD7500 image intended to render at 300\xD7250). Optional because a validator can infer the ratio when the target format declares logical dimensions. When supplied, it MUST agree with both `width / logical_width` and `height / logical_height`; it is never a substitute for the intrinsic `width` and `height` fields.").optional(), "state_id": import_zod.z.string().describe("Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one declared `states[].state_id` (semantic validators resolve it). Omit for ordinary image slots.").optional(), "breakpoint_id": import_zod.z.string().describe("Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one breakpoint declared on the selected state (semantic validators resolve it). Omit for ordinary image slots.").optional(), "focal_point": import_zod.z.array(import_zod.z.number().gte(0).lte(1)).max(2).describe("Normalized `[x, y]` coordinates (0\u20131 from top-left) of the image's visual anchor. Seller-side renderers crop toward the focal point when deriving renditions across breakpoints and aspect ratios; absent, cropping falls back to center-weighted defaults.").optional(), "format": import_zod.z.string().describe("Image file format (jpg, png, gif, webp, etc.)").optional(), "alt_text": import_zod.z.string().describe("Alternative text for accessibility").optional(), "provenance": import_zod.z.object({ "digital_source_type": import_zod.z.enum(["digital_capture", "digital_creation", "trained_algorithmic_media", "composite_with_trained_algorithmic_media", "algorithmic_media", "composite_capture", "composite_synthetic", "human_edits", "data_driven_media"]).describe("IPTC-aligned classification of AI involvement in producing this content").optional(), "synthetic_depiction": import_zod.z.boolean().describe("Assessed declaration of whether the content synthetically depicts a real or fictional person performing or appearing in a way that was generated or materially manipulated rather than captured as depicted. `true` covers both a fully synthetic performer and material manipulation of a real performer; `false` is an assessed declaration that the content does not contain such a depiction. Absence means the content has not been assessed for synthetic depiction. This field does not claim consent, legality, or independent verification, and receivers MUST NOT derive it solely from `digital_source_type`.").optional(), "ai_tool": import_zod.z.object({ "name": import_zod.z.string().describe("Name of the AI tool or model (e.g., 'DALL-E 3', 'Stable Diffusion XL', 'Gemini')"), "version": import_zod.z.string().describe("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.").optional(), "provider": import_zod.z.string().describe("Organization that provides the AI tool (e.g., 'OpenAI', 'Stability AI', 'Google')").optional() }).describe("AI system used to generate or modify this content. Aligns with IPTC 2025.1 AI metadata fields and C2PA claim_generator.").optional(), "human_oversight": import_zod.z.enum(["none", "prompt_only", "selected", "edited", "directed"]).describe("Level of human involvement in the AI-assisted creation process. Independent of `disclosure.required` \u2014 the protocol does not derive disclosure obligations from oversight level. Some regulations include carve-outs for human-edited or human-directed AI output, but those carve-outs have factual prerequisites the schema cannot evaluate. Asserting `edited` or `directed` does not by itself justify `disclosure.required: false`.").optional(), "declared_by": import_zod.z.object({ "agent_url": import_zod.z.string().url().describe("URL of the agent or service that declared this provenance").optional(), "role": import_zod.z.enum(["creator", "advertiser", "agency", "platform", "tool"]).describe("Role of the declaring party in the supply chain") }).describe("Party declaring this provenance. Identifies who attached the provenance claim, enabling receiving parties to assess trust.").optional(), "declared_at": import_zod.z.string().datetime().describe("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.").optional(), "created_time": import_zod.z.string().datetime().describe("When this content was created or generated (ISO 8601)").optional(), "c2pa": import_zod.z.object({ "manifest_url": import_zod.z.string().url().describe("URL to the C2PA manifest store for this content") }).describe("C2PA sidecar manifest reference. Links to a detached cryptographic provenance manifest for this content. Note: file-level C2PA bindings break when ad servers transcode, resize, or re-encode assets. For pipelines with intermediaries, consider embedded_provenance as the primary provenance mechanism.").optional(), "embedded_provenance": import_zod.z.array(import_zod.z.object({ "method": import_zod.z.enum(["manifest_wrapper", "provenance_markers"]).describe("How provenance data is carried within the content"), "standard": import_zod.z.string().describe("Standard the embedding conforms to, if any (e.g., 'c2pa' for C2PA Section A.7 text manifest embedding)").optional(), "provider": import_zod.z.string().describe("Organization that performed the embedding (e.g., 'Encypher', 'Digimarc'). Display label and audit context \u2014 not a wire identifier."), "verify_agent": import_zod.z.object({ "agent_url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("URL of the governance agent the buyer represents was used to embed/verify this layer. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."), "feature_id": import_zod.z.string().describe("Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `encypher.markers_present_v2`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog.").optional() }).strict().describe("Buyer's representation that this embedding can be verified by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing \u2014 the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist). MAY be omitted for self-verifiable embeddings (e.g., a C2PA text manifest with a public key the seller already trusts).").optional(), "embedded_at": import_zod.z.string().datetime().describe("When the provenance data was embedded (ISO 8601)").optional() })).describe("Provenance metadata embedded within the content stream. Each entry declares one embedding layer: structured provenance data carried inside the content itself, as distinct from sidecar references (c2pa.manifest_url). Embedded provenance survives operations that break sidecar and file-level bindings: ad-server transcoding, CMS ingestion, copy-paste, reformatting, and CDN re-encoding. For ad-tech pipelines where content passes through multiple intermediaries, embedded provenance is the reliable path for provenance that persists from declaration through delivery. This is a declaration by the embedding party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).").optional(), "watermarks": import_zod.z.array(import_zod.z.object({ "media_type": import_zod.z.enum(["audio", "image", "video", "text"]).describe("Media category of the watermarked content"), "provider": import_zod.z.string().describe("Organization that applied the watermark (e.g., 'Imatag', 'Steg.AI', 'Encypher'). Display label and audit context \u2014 not a wire identifier."), "verify_agent": import_zod.z.object({ "agent_url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("URL of the governance agent the buyer represents was used to apply/detect this watermark. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."), "feature_id": import_zod.z.string().describe("Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `imatag.watermark_detected`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog.").optional() }).strict().describe("Buyer's representation that this watermark can be detected by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing \u2014 the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist).").optional(), "c2pa_action": import_zod.z.enum(["c2pa.watermarked.bound", "c2pa.watermarked.unbound"]).describe("C2PA action classification for this watermark").optional(), "embedded_at": import_zod.z.string().datetime().describe("When the watermark was applied (ISO 8601)").optional() })).describe("Content watermarks applied to this asset. Each entry declares one watermarking layer: a content modification that encodes an identifier or fingerprint within the asset. Watermarks differ from embedded provenance: a watermark encodes an identifier (who generated it, who owns it), while embedded provenance carries or references a structured provenance record (the full chain of custody). A single asset may carry both. Aligns with C2PA action taxonomy: c2pa.watermarked.bound (watermark linked to a C2PA manifest) and c2pa.watermarked.unbound (watermark independent of any manifest). This is a declaration by the watermarking party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).").optional(), "disclosure": import_zod.z.object({ "required": import_zod.z.boolean().describe("The declaring party's claim that AI disclosure is required for this content under applicable regulations. This is a declared signal carried through the supply chain \u2014 useful as a routing and audit input \u2014 not a regulatory determination made by the protocol. Receiving parties remain responsible for their own jurisdictional analysis and should not treat `required: false` as compliance cover."), "jurisdictions": import_zod.z.array(import_zod.z.object({ "country": import_zod.z.string().describe("ISO 3166-1 alpha-2 country code (e.g., 'US', 'DE', 'CN')"), "region": import_zod.z.string().describe("Sub-national region code (e.g., 'CA' for California, 'BY' for Bavaria)").optional(), "regulation": import_zod.z.string().describe("Regulation identifier (e.g., 'eu_ai_act_article_50', 'ca_sb_942', 'cn_deep_synthesis')"), "label_text": import_zod.z.string().describe("Required disclosure label text for this jurisdiction, in the local language").optional(), "render_guidance": import_zod.z.object({ "persistence": import_zod.z.enum(["continuous", "initial", "flexible"]).describe("How long the disclosure must persist during content playback or display").optional(), "min_duration_ms": import_zod.z.number().int().gte(1).describe("Minimum display duration in milliseconds for initial persistence. Recommended when persistence is initial \u2014 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.").optional(), "positions": import_zod.z.array(import_zod.z.enum(["prominent", "footer", "audio", "subtitle", "overlay", "end_card", "pre_roll", "companion"]).describe("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.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Preferred disclosure positions in priority order. The first position a format supports should be used.").optional(), "ext": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).describe("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.").optional() }).describe("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.").optional() })).describe("Jurisdictions where disclosure obligations apply").optional() }).describe("Regulatory disclosure requirements for this content. Indicates whether AI disclosure is required and under which jurisdictions.").optional(), "verification": import_zod.z.array(import_zod.z.object({ "verified_by": import_zod.z.string().describe("Name of the verification service (e.g., 'DoubleVerify', 'Hive Moderation', 'Reality Defender')"), "verified_time": import_zod.z.string().datetime().describe("When the verification was performed (ISO 8601)").optional(), "result": import_zod.z.enum(["authentic", "ai_generated", "ai_modified", "inconclusive"]).describe("Verification outcome"), "confidence": import_zod.z.number().gte(0).lte(1).describe("Confidence score of the verification result (0.0 to 1.0)").optional(), "details_url": import_zod.z.string().url().describe("URL to the full verification report").optional() })).describe("Third-party verification or detection results for this content. Multiple services may independently evaluate the same content. Provenance is a claim \u2014 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.").optional(), "ext": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).describe("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.").optional() }).describe("Provenance metadata for this asset, overrides manifest-level provenance").optional() }).catchall(import_zod.z.any()).describe("Override logo asset.").optional(), "colors": import_zod.z.object({ "primary": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional(), "secondary": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional(), "accent": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional() }).catchall(import_zod.z.any()).describe("Override brand colors (hex strings).").optional(), "voice": import_zod.z.string().describe("Override brand-voice description for surface-composed text/audio output.").optional(), "tagline": import_zod.z.string().describe("Override tagline.").optional() }).catchall(import_zod.z.any()).describe("Inline override for brand-kit fields normally resolved from `/.well-known/brand.json` on `domain` (logo, colors, voice, tagline). Use when brand.json is missing, stale, or inappropriate for this specific call \u2014 e.g., a campaign-scoped tagline, a co-branded creative, a freshly-rebranded color palette the brand.json hasn't shipped yet. Same inline-override pattern as `industries` and `data_subject_contestation` above: brand.json is canonical, the override is per-call. Adopters needing to override fields outside this subset (`voice_attributes`, `prohibited_terms`, etc.) MUST publish a different brand.json and reference it via a different `domain` \u2014 the inline override is intentionally narrow to a small high-traffic subset.\n\n**Merge semantics (normative).** The merge is **field-level**, not whole-object replacement. Each field within `brand_kit_override` (`logo`, `colors`, `voice`, `tagline`) is evaluated independently \u2014 when a field is present on the override the override value applies; when a field is absent the brand.json value applies (or is absent if brand.json doesn't carry one either). For composite fields (`colors.primary`, `colors.secondary`, `colors.accent`), the merge is one level deeper: each color slot is evaluated independently \u2014 a producer can override `colors.primary` while still inheriting `colors.secondary` from brand.json. SDKs MUST NOT treat a present `brand_kit_override.colors` as wiping the brand.json `colors` block entirely; only the per-slot fields present in the override take precedence. Without this rule, a partial-override semantics would diverge across SDKs and produce inconsistent rendering for the same payload.").optional() }).strict().describe(`Identity issuer / attestation authority, referenced as a vendor BrandRef (e.g. {"domain": "world.org"}) \u2014 the same vendor-reference shape AdCP uses for measurement and signals vendors. The issuer's canonical domain is the anchor; it need not host a brand.json, but if it does, that is where its verifier metadata (scheme versions, verify endpoint, JWKs) lives. Issuer-agnostic: World ID, ISO 18013-5 mDL, and W3C-VC issuers all reference by domain. The relying party is namespaced by the issuer \u2014 identity is the tuple (issuer.domain, issuer.brand_id, relying_party_id), mirroring (vendor.domain, vendor.brand_id, metric_id).`), "scheme": import_zod.z.string().describe('Proof scheme and version, e.g. "world_id_v4".').optional(), "relying_party_id": import_zod.z.string().describe("The relying-party id registered with the issuer (and, for on-chain issuers like World ID, with the issuer's registry). One entity may operate many relying parties (scope=entity vs scope=property); this is the attestation's audience / linkability boundary, not an entity identifier."), "scope": import_zod.z.enum(["entity", "property"]).describe("Whether this relying_party_id is shared across the entity's properties (entity \u2192 a within-entity unique-human graph) or scoped to a single property (property \u2192 per-property pseudonyms, unlinkable across the entity).").optional() }).strict().describe("A verified-identity relying party an entity or brand operates. Used for attestation provenance in TMP Identity Match (the buyer checks a forwarded attestation's relying_party_id against the owner's published list). Issuer-agnostic; World ID is the first issuer.")).describe("Verified-identity relying parties scoped to this brand/property, for attestation provenance in TMP Identity Match. Use when a brand or property runs its own relying_party_id (per-property pseudonyms); entity-wide relying parties live on the house object. See specs/tmp-verified-identity-attestation.md.").optional(), "names": import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged.")).describe("Localized brand names. Multiple entries per language allowed for aliases."), "keller_type": import_zod.z.enum(["master", "sub_brand", "endorsed", "independent"]).describe("Brand architecture type from Keller's theory. master: primary brand of house. sub_brand: carries parent name (Nike SB). endorsed: independent identity backed by parent (Air Jordan 'by Nike'). independent: operates separately (Converse under Nike, Inc.)").optional(), "parent_brand": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Parent brand ID for sub-brands and endorsed brands").optional(), "description": import_zod.z.string().describe("Brand description").optional(), "industries": import_zod.z.array(import_zod.z.string()).describe("Brand industries (e.g., ['automotive'] or ['pharmaceutical', 'cpg'] for a consumer health company). Describes what the company does \u2014 not what regulatory regimes apply (use policy_categories for that).").optional(), "target_audience": import_zod.z.string().describe("Primary target audience").optional(), "logos": import_zod.z.array(import_zod.z.object({ "id": import_zod.z.string().regex(new RegExp("^[a-z0-9][a-z0-9_-]*$")).describe("Stable identifier for this logo entry. Recommended when logo usage rules or mark lockups need to bind to a specific logo asset.").optional(), "url": import_zod.z.string().url().describe("URL to the logo asset"), "orientation": import_zod.z.enum(["square", "horizontal", "vertical", "stacked"]).describe("Logo aspect ratio orientation. square: ~1:1, horizontal: wide, vertical: tall, stacked: vertically arranged elements").optional(), "background": import_zod.z.enum(["dark-bg", "light-bg", "transparent-bg"]).describe("Background compatibility. dark-bg: use on dark backgrounds, light-bg: use on light backgrounds, transparent-bg: has transparent background").optional(), "variant": import_zod.z.enum(["primary", "secondary", "icon", "wordmark", "full-lockup"]).describe("Logo variant type. primary: main logo, secondary: alternative, icon: symbol only, wordmark: text only, full-lockup: complete logo").optional(), "tags": import_zod.z.array(import_zod.z.string()).describe("Additional semantic tags for custom categorization beyond the standard orientation, background, and variant fields").optional(), "slots": import_zod.z.array(import_zod.z.enum(["logo_card_light", "logo_card_dark", "profile_mark", "favicon", "app_icon", "social_profile_mark", "nav_header", "footer", "email_header", "watermark", "ad_end_card", "co_brand_lockup", "marketplace_listing"]).describe("Canonical renderer-facing logo slot. Use when selecting a logo variant from brand.json for a specific UI or creative placement.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Canonical renderer slots where this logo is appropriate. Consumers SHOULD prefer this over inferring from tags or usage prose when selecting a logo for a specific UI surface.").optional(), "usage": import_zod.z.string().describe("Human-readable description of when to use this logo variant (e.g., 'Primary logo for use on light backgrounds')").optional(), "width": import_zod.z.number().int().describe("Width in pixels").optional(), "height": import_zod.z.number().int().describe("Height in pixels").optional() }).catchall(import_zod.z.any()).describe("Brand logo asset with structured fields for orientation, background compatibility, and variant type")).describe("Brand logo assets").optional(), "colors": import_zod.z.object({ "primary": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "secondary": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "accent": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "background": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "text": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "heading": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "body": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "label": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "border": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "divider": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "surface_1": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "surface_2": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional() }).catchall(import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))])).describe("Brand color palette. Each role accepts a single hex color or an array of hex colors for brands with multiple values per role. Beyond the core five roles, brands can provide additional color roles for finer granularity \u2014 heading, body, label, border, divider, surface_1, surface_2, etc.").optional(), "fonts": import_zod.z.object({ "primary": import_zod.z.union([import_zod.z.string().describe("CSS font-family name (e.g., 'Montserrat', 'Arial, sans-serif')"), import_zod.z.object({ "family": import_zod.z.string().describe("CSS font-family name (e.g., 'Brand Sans')"), "files": import_zod.z.array(import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to the font file (WOFF2, TTF, or OTF)"), "weight": import_zod.z.number().int().gte(100).lte(900).describe("CSS numeric font-weight for static fonts (100-900)").optional(), "weight_range": import_zod.z.array(import_zod.z.number().int().gte(100).lte(900)).max(2).describe("Variable font weight axis range as [min, max] (e.g., [100, 900]). Use instead of weight for variable fonts.").optional(), "style": import_zod.z.enum(["normal", "italic", "oblique"]).describe("CSS font-style").optional() }).catchall(import_zod.z.any()).describe("A font file with weight, style, and variable font metadata")).max(36).describe("Font files for different weights and styles").optional(), "opentype_features": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9]{4}$"))).max(20).describe("OpenType feature tags to enable (e.g., ['ss01', 'tnum', 'cv01']). These are four-character tags per the OpenType spec.").optional(), "fallbacks": import_zod.z.array(import_zod.z.string().max(100)).max(10).describe("Ordered fallback font-family names for when the primary font is unavailable or does not support the required script (e.g., ['Noto Sans Arabic', 'Noto Sans SC', 'sans-serif'])").optional() }).catchall(import_zod.z.any()).describe("Structured font with family name, downloadable font files, and typographic metadata")]).describe("Primary font family").optional(), "secondary": import_zod.z.union([import_zod.z.string().describe("CSS font-family name (e.g., 'Montserrat', 'Arial, sans-serif')"), import_zod.z.object({ "family": import_zod.z.string().describe("CSS font-family name (e.g., 'Brand Sans')"), "files": import_zod.z.array(import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to the font file (WOFF2, TTF, or OTF)"), "weight": import_zod.z.number().int().gte(100).lte(900).describe("CSS numeric font-weight for static fonts (100-900)").optional(), "weight_range": import_zod.z.array(import_zod.z.number().int().gte(100).lte(900)).max(2).describe("Variable font weight axis range as [min, max] (e.g., [100, 900]). Use instead of weight for variable fonts.").optional(), "style": import_zod.z.enum(["normal", "italic", "oblique"]).describe("CSS font-style").optional() }).catchall(import_zod.z.any()).describe("A font file with weight, style, and variable font metadata")).max(36).describe("Font files for different weights and styles").optional(), "opentype_features": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9]{4}$"))).max(20).describe("OpenType feature tags to enable (e.g., ['ss01', 'tnum', 'cv01']). These are four-character tags per the OpenType spec.").optional(), "fallbacks": import_zod.z.array(import_zod.z.string().max(100)).max(10).describe("Ordered fallback font-family names for when the primary font is unavailable or does not support the required script (e.g., ['Noto Sans Arabic', 'Noto Sans SC', 'sans-serif'])").optional() }).catchall(import_zod.z.any()).describe("Structured font with family name, downloadable font files, and typographic metadata")]).describe("Secondary font family").optional() }).catchall(import_zod.z.union([import_zod.z.string().describe("CSS font-family name (e.g., 'Montserrat', 'Arial, sans-serif')"), import_zod.z.object({ "family": import_zod.z.string().describe("CSS font-family name (e.g., 'Brand Sans')"), "files": import_zod.z.array(import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to the font file (WOFF2, TTF, or OTF)"), "weight": import_zod.z.number().int().gte(100).lte(900).describe("CSS numeric font-weight for static fonts (100-900)").optional(), "weight_range": import_zod.z.array(import_zod.z.number().int().gte(100).lte(900)).max(2).describe("Variable font weight axis range as [min, max] (e.g., [100, 900]). Use instead of weight for variable fonts.").optional(), "style": import_zod.z.enum(["normal", "italic", "oblique"]).describe("CSS font-style").optional() }).catchall(import_zod.z.any()).describe("A font file with weight, style, and variable font metadata")).max(36).describe("Font files for different weights and styles").optional(), "opentype_features": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9]{4}$"))).max(20).describe("OpenType feature tags to enable (e.g., ['ss01', 'tnum', 'cv01']). These are four-character tags per the OpenType spec.").optional(), "fallbacks": import_zod.z.array(import_zod.z.string().max(100)).max(10).describe("Ordered fallback font-family names for when the primary font is unavailable or does not support the required script (e.g., ['Noto Sans Arabic', 'Noto Sans SC', 'sans-serif'])").optional() }).catchall(import_zod.z.any()).describe("Structured font with family name, downloadable font files, and typographic metadata")]).describe("A font role entry. Either a CSS font-family string (simple) or a structured object with family name and font files (rich).")).describe("Brand typography. Each key is a role name (e.g., 'primary', 'secondary') referenced by type_scale entries. Values are either a CSS font-family string or a structured object with font files for reliable resolution.").optional(), "tone": import_zod.z.union([import_zod.z.string().describe("Simple tone descriptors for backwards compatibility"), import_zod.z.object({ "voice": import_zod.z.union([import_zod.z.string(), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged."))]).describe("High-level voice descriptor, either a legacy plain string or localized values.").optional(), "attributes": import_zod.z.union([import_zod.z.array(import_zod.z.string()), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.array(import_zod.z.string())).describe("One locale mapped to a complete ordered string list. The list is selected as a unit so readers never assemble mixed-language output from independently localized elements."))]).describe("Personality traits that characterize the brand voice. Localized lists are selected as a whole.").optional(), "dos": import_zod.z.union([import_zod.z.array(import_zod.z.string()), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.array(import_zod.z.string())).describe("One locale mapped to a complete ordered string list. The list is selected as a unit so readers never assemble mixed-language output from independently localized elements."))]).describe("Guidance for copy generation - what TO do. Localized lists are selected as a whole.").optional(), "donts": import_zod.z.union([import_zod.z.array(import_zod.z.string()), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.array(import_zod.z.string())).describe("One locale mapped to a complete ordered string list. The list is selected as a unit so readers never assemble mixed-language output from independently localized elements."))]).describe("Guardrails to avoid brand violations - what NOT to do. Localized lists are selected as a whole.").optional() }).describe("Structured brand voice guidelines")]).describe("Brand voice and messaging tone guidelines").optional(), "tagline": import_zod.z.union([import_zod.z.string().describe("Plain tagline string for backwards compatibility"), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged.")).describe("Localized taglines with BCP 47 locale codes")]).describe("Brand tagline or slogan. Accepts a plain string or a localized array matching the names pattern.").optional(), "assets": import_zod.z.array(import_zod.z.object({ "asset_id": import_zod.z.string().describe("Unique identifier"), "asset_type": import_zod.z.enum(["image", "video", "audio", "text", "markdown", "html", "css", "javascript", "zip", "vast", "daast", "url", "webhook", "brief", "catalog", "published_post"]).describe("Type of asset content"), "url": import_zod.z.string().url().describe("URL to CDN-hosted asset file"), "tags": import_zod.z.array(import_zod.z.string()).describe("Tags for discovery (e.g., 'hero', 'lifestyle', 'product', 'holiday')").optional(), "name": import_zod.z.union([import_zod.z.string(), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged."))]).describe("Human-readable name, either a legacy plain string or localized values.").optional(), "description": import_zod.z.union([import_zod.z.string(), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged."))]).describe("Asset description or usage notes, either a legacy plain string or localized values.").optional(), "width": import_zod.z.number().int().describe("Image/video width in pixels").optional(), "height": import_zod.z.number().int().describe("Image/video height in pixels").optional(), "duration_seconds": import_zod.z.number().describe("Video/audio duration in seconds").optional(), "file_size_bytes": import_zod.z.number().int().describe("File size in bytes").optional(), "format": import_zod.z.string().describe("File format (e.g., 'jpg', 'mp4', 'mp3')").optional(), "metadata": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).describe("Additional asset-specific metadata").optional() }).catchall(import_zod.z.any()).describe("Brand asset (image, video, audio, text)")).describe("Brand asset library").optional(), "properties": import_zod.z.array(import_zod.z.object({ "type": import_zod.z.enum(["website", "mobile_app", "ctv_app", "desktop_app", "dooh", "podcast", "radio", "linear_tv", "streaming_audio", "ai_assistant"]).describe("Property type"), "identifier": import_zod.z.string().min(1).describe("Property identifier - domain for websites, bundle ID for apps"), "store": import_zod.z.enum(["apple", "google", "amazon", "roku", "samsung", "lg", "other"]).describe("App store for mobile/CTV apps").optional(), "region": import_zod.z.string().regex(new RegExp("^([A-Z]{2}|global)$")).describe("ISO 3166-1 alpha-2 country code or 'global'").optional(), "primary": import_zod.z.boolean().describe("Whether this is the primary property for the brand").default(false), "relationship": import_zod.z.enum(["owned", "direct", "delegated", "ad_network"]).describe("How this brand relates to the property. 'owned': the brand owns and operates this property (default) and has no adagents.json delegation_type counterpart. 'direct': the brand is the direct sales path for this property, even if a third party operates the software (e.g., a publisher's in-house ad team using a vendor's tech). 'delegated': the brand manages monetization for this property \u2014 they are in charge of ad sales (e.g., Mediavine managing a food blog). 'ad_network': the brand sells this property's inventory as part of a network or exchange \u2014 they are a path to the inventory, not the path (e.g., PubMatic as an SSP). For non-owned properties, the publisher confirms the relationship by setting the matching delegation_type on the agent's authorization in their adagents.json.").default("owned") }).catchall(import_zod.z.any()).describe("A digital property associated with a brand. Defaults to owned; use 'relationship' to declare direct, delegated, or ad_network properties. For delegated and network paths, these values match the delegation_type field in adagents.json, creating a bilateral verification chain: the operator declares the relationship here, the publisher confirms by setting the same delegation_type on the agent's authorization in their adagents.json. 'owned' is an inline ownership declaration with no adagents.json counterpart.")).describe("Digital properties associated with this brand \u2014 owned, managed, or represented").optional(), "product_catalog": import_zod.z.object({ "feed_url": import_zod.z.string().url().describe("URL to product catalog feed"), "feed_format": import_zod.z.enum(["google_merchant_center", "facebook_catalog", "shopify", "linkedin_jobs", "tiktok_shop", "pinterest_catalog", "openai_product_feed", "custom"]).describe("Format of the product feed").optional(), "categories": import_zod.z.array(import_zod.z.string()).describe("Product categories available in the catalog").optional(), "last_updated": import_zod.z.string().datetime().describe("When the product catalog was last updated").optional(), "update_frequency": import_zod.z.enum(["realtime", "hourly", "daily", "weekly"]).describe("How frequently the product catalog is updated").optional(), "agentic_checkout": import_zod.z.object({ "endpoint": import_zod.z.string().url().describe("Base URL for checkout session API"), "spec": import_zod.z.string().describe("Checkout API specification identifier. Use a namespaced string to identify the checkout protocol (e.g., vendor-prefixed or custom). Vendor-specific values belong under ext.{vendor}."), "supported_payment_providers": import_zod.z.array(import_zod.z.string()).describe("Payment providers supported by this checkout endpoint").optional() }).describe("Agentic checkout endpoint configuration").optional() }).catchall(import_zod.z.any()).describe("Product catalog for e-commerce brands").optional(), "privacy_policy_url": import_zod.z.string().url().describe("URL to the brand's privacy policy").optional(), "data_subject_contestation": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to a human-accessible contestation form or information page.").optional(), "email": import_zod.z.string().email().describe("Email address for contestation requests. Deployer MUST monitor and respond within the timelines set by applicable law (e.g., 1 month under GDPR Art. 12(3)).").optional(), "languages": import_zod.z.array(import_zod.z.string()).describe("BCP 47 language tags the contestation channel supports (e.g., ['en', 'de', 'fr']). At minimum SHOULD include a language spoken in every jurisdiction where the brand runs regulated-vertical campaigns.").optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("Contact point where a data subject can request human intervention, express their view, or contest an automated decision \u2014 satisfying GDPR Article 22(3) and EU AI Act Article 26(11) transparency obligations. This is a contact reference (URL, email, or both), not a machine-callable API. AdCP surfaces the pointer; the deployer runs the contestation workflow.").optional(), "disclaimers": import_zod.z.array(import_zod.z.object({ "text": import_zod.z.string(), "context": import_zod.z.string().optional(), "required": import_zod.z.boolean().default(true) })).describe("Legal disclaimers for creatives").optional(), "trademarks": import_zod.z.array(import_zod.z.object({ "registry": import_zod.z.string().describe("Trademark registry (e.g., 'USPTO', 'EUIPO', 'JPO', 'CNIPA')"), "number": import_zod.z.string().describe("Registration number as issued by the registry"), "mark": import_zod.z.string().describe("The registered mark as published"), "status": import_zod.z.enum(["active", "pending", "abandoned", "cancelled", "expired"]).describe("Registration status. Omit for active marks if status tracking is not maintained.").optional(), "license_type": import_zod.z.enum(["owned", "licensed_in", "licensed_out"]).describe("Whether the publisher owns the mark, licenses it from another entity, or licenses it to others. 'owned' is the default if omitted.").optional(), "licensor_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain of the entity that licenses this mark to the publisher. Meaningful when license_type=licensed_in; omit otherwise.").optional(), "countries": import_zod.z.array(import_zod.z.string().min(2).max(2)).describe("ISO 3166-1 alpha-2 country codes where this registration applies. Omit for global or where the registry's jurisdiction is implicit.").optional(), "nice_classes": import_zod.z.array(import_zod.z.number().int().gte(1).lte(45)).describe("Nice Classification class numbers (1-45) covered by this registration. Disambiguates marks across industries (e.g., Delta-airline vs Delta-faucet). Omit if scope is implicit from registry.").optional() }).catchall(import_zod.z.any()).describe("A registered trademark. May appear at house level (corporate marks, e.g., 'NIKE' owned by Nike, Inc.) or at brand level (brand-specific marks, e.g., 'CONVERSE' owned by Converse). Resolution between house- and brand-level trademarks is union \u2014 both lists are valid claims about marks the publisher controls.")).describe("Brand-level registered trademarks. Use for marks the brand owns or controls (e.g., a sub-brand's own marks distinct from the corporate parent). House-level trademarks live on the house object; resolution between the two is union \u2014 both lists are valid claims.").optional(), "voice_synthesis": import_zod.z.object({ "provider": import_zod.z.string().optional(), "voice_id": import_zod.z.string().optional(), "settings": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).optional() }).catchall(import_zod.z.any()).describe("TTS voice synthesis configuration for AI-generated audio").optional(), "avatar": import_zod.z.object({ "provider": import_zod.z.string().optional(), "avatar_id": import_zod.z.string().optional(), "settings": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).optional() }).catchall(import_zod.z.any()).describe("Visual avatar configuration").optional(), "visual_guidelines": import_zod.z.object({ "photography": import_zod.z.object({ "realism": import_zod.z.enum(["natural", "stylized", "hyperreal", "abstract"]).describe("Level of photographic realism").optional(), "lighting": import_zod.z.string().describe("Lighting style (e.g., 'soft daylight', 'studio', 'golden hour', 'high-key', 'low-key')").optional(), "color_temperature": import_zod.z.enum(["warm", "neutral", "cool"]).describe("Overall color temperature of photography").optional(), "contrast": import_zod.z.enum(["low", "medium", "high"]).describe("Contrast level in photography").optional(), "depth_of_field": import_zod.z.enum(["shallow", "medium", "deep"]).describe("Depth of field preference. shallow: blurred background with subject isolation, deep: everything in focus").optional(), "subject": import_zod.z.object({ "people": import_zod.z.object({ "age_range": import_zod.z.string().describe("Target age range (e.g., '20-35')").optional(), "diversity": import_zod.z.string().describe("Diversity representation (e.g., 'mixed', 'varied')").optional(), "mood": import_zod.z.array(import_zod.z.string()).describe("Mood descriptors (e.g., ['confident', 'relaxed'])").optional() }).catchall(import_zod.z.any()).describe("People photography guidelines").optional(), "product_focus": import_zod.z.enum(["in-use", "isolated", "lifestyle", "detail"]).describe("How products are shown").optional(), "setting": import_zod.z.string().describe("Environmental context for photography (e.g., 'indoor', 'outdoor', 'studio', 'urban', 'nature', 'workplace')").optional() }).catchall(import_zod.z.any()).describe("Subject matter guidelines").optional(), "framing": import_zod.z.object({ "subject_position": import_zod.z.string().describe("Where the subject sits in frame (e.g., 'center', 'center-left', 'rule-of-thirds')").optional(), "crop_style": import_zod.z.string().describe("Cropping convention (e.g., 'waist-up', 'full-body', 'close-up', 'wide')").optional(), "perspective": import_zod.z.string().describe("Camera perspective (e.g., 'eye-level', 'overhead', 'low-angle')").optional() }).catchall(import_zod.z.any()).describe("Camera framing rules").optional(), "preferred_aspect_ratios": import_zod.z.array(import_zod.z.string().regex(new RegExp("^\\d+:\\d+$"))).describe("Preferred aspect ratios for brand photography (e.g., '16:9', '4:5', '1:1')").optional(), "tags": import_zod.z.array(import_zod.z.string()).describe("Additional style descriptors").optional() }).catchall(import_zod.z.any()).describe("Photography style rules for generative creative systems. Defines how brand photography should look when selected or generated.").optional(), "graphic_style": import_zod.z.object({ "style_type": import_zod.z.enum(["flat_illustration", "geometric", "gradient_mesh", "editorial_collage", "hand_drawn", "minimal_line_art", "3d_render", "isometric", "photographic_composite"]).describe("Primary graphic style").optional(), "stroke_style": import_zod.z.enum(["rounded", "square", "mixed", "none"]).describe("Stroke end/join style").optional(), "stroke_weight": import_zod.z.string().describe("Stroke weight (e.g., '2px', 'thin', 'bold')").optional(), "corner_radius": import_zod.z.string().describe("Default corner radius for graphic and illustration elements (e.g., '12px', '8px', 'sharp'). For UI component radii (buttons, cards, inputs), see visual_guidelines.border_radius.").optional(), "tags": import_zod.z.array(import_zod.z.string()).describe("Additional style descriptors").optional() }).catchall(import_zod.z.any()).describe("Visual language for brand graphics and illustrations").optional(), "shapes": import_zod.z.object({ "primary_shape": import_zod.z.string().describe("Primary brand shape (e.g., 'rounded_rectangle', 'circle', 'hexagon')").optional(), "secondary_shapes": import_zod.z.array(import_zod.z.string()).describe("Secondary shapes in the brand vocabulary").optional(), "usage": import_zod.z.object({ "max_per_layout": import_zod.z.number().int().describe("Maximum distinct shapes per layout").optional(), "overlap_allowed": import_zod.z.boolean().describe("Whether shapes may overlap").optional() }).catchall(import_zod.z.any()).describe("Shape usage rules").optional() }).catchall(import_zod.z.any()).describe("Distinctive shapes used as part of brand visual identity").optional(), "iconography": import_zod.z.object({ "style": import_zod.z.enum(["outline", "filled", "duotone", "flat", "glyph", "hand_drawn"]).describe("Icon rendering style").optional(), "stroke_weight": import_zod.z.string().describe("Icon stroke weight (e.g., '2px', '1.5px')").optional(), "corner_style": import_zod.z.enum(["rounded", "square", "mixed"]).describe("Corner style for icon paths").optional(), "usage": import_zod.z.object({ "max_per_frame": import_zod.z.number().int().describe("Maximum icons per creative frame").optional(), "size_ratio": import_zod.z.string().describe("Icon-to-layout size ratio (e.g., '1:8')").optional() }).catchall(import_zod.z.any()).describe("Icon usage rules").optional() }).catchall(import_zod.z.any()).describe("Icon style system and usage rules").optional(), "composition": import_zod.z.object({ "overlays": import_zod.z.object({ "gradient_style": import_zod.z.enum(["linear", "radial", "conic", "none"]).describe("Gradient type for overlays").optional(), "gradient_direction": import_zod.z.string().describe("Gradient direction (e.g., '45deg', 'to-bottom-right')").optional(), "opacity": import_zod.z.string().describe("Overlay opacity (e.g., '70%')").optional() }).catchall(import_zod.z.any()).describe("Graphic overlay rules").optional(), "texture": import_zod.z.object({ "style": import_zod.z.enum(["none", "subtle_grain", "noise", "paper", "fabric", "concrete"]).describe("Texture style applied to creative assets").optional(), "intensity": import_zod.z.enum(["low", "medium", "high"]).describe("Texture intensity").optional() }).catchall(import_zod.z.any()).describe("Texture treatment rules").optional(), "backgrounds": import_zod.z.object({ "types_allowed": import_zod.z.array(import_zod.z.enum(["solid_color", "gradient", "blurred_photo", "image", "video", "pattern", "transparent"])).describe("Permitted background types").optional() }).catchall(import_zod.z.any()).describe("Background treatment rules").optional() }).catchall(import_zod.z.any()).describe("Layout composition rules including overlays, textures, and backgrounds").optional(), "border_radius": import_zod.z.object({ "none": import_zod.z.string().describe("Explicitly sharp corners (e.g., '0')").optional(), "default": import_zod.z.string().describe("Default border radius for UI components (e.g., '8px', '12px', '0'). For graphic/illustration elements, see graphic_style.corner_radius.").optional(), "small": import_zod.z.string().describe("Small border radius for compact elements (e.g., '4px')").optional(), "large": import_zod.z.string().describe("Large border radius for cards and containers (e.g., '16px', '24px')").optional(), "pill": import_zod.z.string().describe("Fully rounded / pill shape (e.g., '999px')").optional() }).catchall(import_zod.z.string()).describe("Named border radius presets for UI components and layout elements. One of the most visible brand differentiators \u2014 Airbnb uses generous 20px, Stripe uses precise 4\u20138px, Spotify uses pill/999px.").optional(), "elevation": import_zod.z.object({ "none": import_zod.z.string().describe("No shadow (e.g., 'none')").optional(), "subtle": import_zod.z.string().describe("Subtle shadow for slight lift (e.g., '0 1px 2px rgba(0,0,0,0.05)')").optional(), "card": import_zod.z.string().describe("Card-level shadow (e.g., '0 4px 6px -1px rgba(0,0,0,0.1), 0 2px 4px -2px rgba(0,0,0,0.1)')").optional(), "modal": import_zod.z.string().describe("Modal/overlay shadow (e.g., '0 20px 25px -5px rgba(0,0,0,0.1), 0 8px 10px -6px rgba(0,0,0,0.1)')").optional() }).catchall(import_zod.z.string()).describe("Named shadow/elevation levels. Brands use elevation as identity \u2014 from Stripe's blue-tinted multi-layer shadows to Apple's single diffuse shadow. Values are CSS box-shadow syntax.").optional(), "spacing": import_zod.z.object({ "unit": import_zod.z.string().describe("Base grid unit this scale was designed from (e.g., '8px', '4px'). Informational \u2014 agents should use the named scale values, not compute from this.").optional(), "scale": import_zod.z.object({ "xs": import_zod.z.string().describe("Extra small spacing (e.g., '4px')").optional(), "sm": import_zod.z.string().describe("Small spacing (e.g., '8px')").optional(), "md": import_zod.z.string().describe("Medium spacing (e.g., '16px')").optional(), "lg": import_zod.z.string().describe("Large spacing (e.g., '24px')").optional(), "xl": import_zod.z.string().describe("Extra large spacing (e.g., '32px')").optional(), "2xl": import_zod.z.string().describe("Section-level spacing (e.g., '48px', '64px')").optional() }).catchall(import_zod.z.string()).describe("Named spacing scale built from the base unit").optional() }).strict().describe("Spacing system for consistent layout rhythm. Most design systems use an 8px base grid.").optional(), "graphic_elements": import_zod.z.array(import_zod.z.object({ "name": import_zod.z.string().describe("Element name (e.g., 'Paper Tear', 'Brand Watermark', 'Section Divider')"), "type": import_zod.z.enum(["border", "divider", "frame", "watermark", "pattern", "texture_overlay", "decorative"]).describe("Element type").optional(), "description": import_zod.z.string().describe("How the element is used in layouts").optional(), "orientation": import_zod.z.enum(["horizontal", "vertical", "any"]).describe("Preferred orientation when used in layouts").optional(), "colors": import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value")).describe("Colors this element may appear in").optional(), "max_per_layout": import_zod.z.number().int().describe("Maximum instances per layout").optional() }).catchall(import_zod.z.any()).describe("A reusable decorative or structural visual element that is part of the brand identity (e.g., torn paper edges, watermarks, dividers, background patterns)")).describe("Reusable decorative elements that are part of the brand visual identity (e.g., torn paper edges, watermarks, dividers)").optional(), "motion": import_zod.z.object({ "transition_style": import_zod.z.enum(["cut", "dissolve", "slide", "wipe", "zoom", "fade"]).describe("Primary transition style between scenes").optional(), "animation_speed": import_zod.z.enum(["slow", "moderate", "fast"]).describe("Overall animation pacing").optional(), "easing": import_zod.z.string().describe("Default easing function (e.g., 'ease-in-out', 'spring', 'linear')").optional(), "text_entrance": import_zod.z.enum(["fade", "typewriter", "slide_up", "slide_left", "scale", "none"]).describe("How text enters the frame").optional(), "pacing": import_zod.z.enum(["lingering", "moderate", "fast_cuts"]).describe("Overall editing rhythm").optional(), "kinetic_typography": import_zod.z.boolean().describe("Whether animated/kinetic typography is allowed").optional(), "tags": import_zod.z.array(import_zod.z.string()).describe("Additional motion style descriptors").optional() }).catchall(import_zod.z.any()).describe("Motion and animation rules for video, animated display, and interactive formats").optional(), "logo_placement": import_zod.z.object({ "preferred_position": import_zod.z.enum(["top-left", "top-center", "top-right", "bottom-left", "bottom-center", "bottom-right", "center"]).describe("Preferred logo position in layouts").optional(), "min_clear_space": import_zod.z.string().describe("Minimum clear space around the logo, expressed as a multiple of logo height (e.g., '0.5x', '1x') or fixed value (e.g., '16px')").optional(), "min_height": import_zod.z.string().describe("Minimum logo height to maintain legibility (e.g., '40px', '24px')").optional(), "background_contrast": import_zod.z.enum(["light_only", "dark_only", "any"]).describe("Permitted background contrast behind logo").optional() }).catchall(import_zod.z.any()).describe("Logo placement and clear space rules for automated creative production").optional(), "colorways": import_zod.z.array(import_zod.z.object({ "name": import_zod.z.string().describe("Colorway name (e.g., 'primary', 'inverted', 'subtle')"), "foreground": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value"), "background": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value"), "accent": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value").optional(), "border": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value").optional(), "cta_foreground": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("CTA text/icon color, if different from foreground").optional(), "cta_background": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("CTA button/container color, if different from accent").optional(), "channels": import_zod.z.array(import_zod.z.string()).describe("Channels or contexts where this colorway applies (e.g., 'online', 'print', 'pos', 'social', 'outdoor'). Omit for universal colorways.").optional() }).catchall(import_zod.z.any()).describe("A named color pairing that defines how colors work together. Colorways ensure foreground/background combinations are always on-brand and accessible.")).describe("Named color pairings for consistent foreground/background combinations").optional(), "color_constraints": import_zod.z.array(import_zod.z.object({ "color": import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Color role or value this constraint governs."), "applies_to": import_zod.z.array(import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"])).describe("Surfaces where this color may be used.").optional(), "allowed_on": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Backgrounds, surfaces, or color roles where this color is allowed.").optional(), "forbidden_on": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Backgrounds, surfaces, or color roles where this color is forbidden.").optional(), "never_pair_with": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Color roles or values that must not be paired with this color.").optional(), "contexts": import_zod.z.array(import_zod.z.string()).describe("Channels or creative contexts where this constraint applies, such as digital, print, social, or ctv_end_card.").optional(), "severity": import_zod.z.enum(["must", "should"]).describe("Strength of a machine-readable brand guideline constraint.").optional(), "description": import_zod.z.string().describe("Human-readable rationale or source-language summary for the rule.").optional() }).catchall(import_zod.z.any()).describe("Machine-readable rule constraining how a brand color may be used or paired. Use for accent-only colors, forbidden foreground/background combinations, and palette pairs that should never appear together.")).describe("Machine-readable constraints for color usage and pairings, such as accent-only rules or forbidden foreground/background combinations.").optional(), "logo_usage_rules": import_zod.z.array(import_zod.z.object({ "logo_url": import_zod.z.string().url().describe("Specific logo asset URL this rule applies to. Omit when the rule applies by variant or tags.").optional(), "logo_id": import_zod.z.string().regex(new RegExp("^[a-z0-9][a-z0-9_-]*$")).describe("Stable `logos[].id` this rule applies to. Prefer this over logo_url when the rule targets a specific logo entry.").optional(), "logo_variant": import_zod.z.enum(["primary", "secondary", "icon", "wordmark", "full-lockup"]).describe("Logo variant this rule applies to.").optional(), "logo_tags": import_zod.z.array(import_zod.z.string()).describe("Logo tags this rule applies to.").optional(), "contexts": import_zod.z.array(import_zod.z.string()).describe("Creative contexts where this rule applies.").optional(), "slots": import_zod.z.array(import_zod.z.enum(["logo_card_light", "logo_card_dark", "profile_mark", "favicon", "app_icon", "social_profile_mark", "nav_header", "footer", "email_header", "watermark", "ad_end_card", "co_brand_lockup", "marketplace_listing"]).describe("Canonical renderer-facing logo slot. Use when selecting a logo variant from brand.json for a specific UI or creative placement.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Canonical renderer slots where this rule applies. Use this for deterministic logo-card, profile-mark, end-card, and lockup selection.").optional(), "minimum_size": import_zod.z.object({ "width": import_zod.z.string().describe("Minimum width, such as 48px or 12mm.").optional(), "height": import_zod.z.string().describe("Minimum height, such as 18px or 6mm.").optional() }).strict().describe("Minimum rendered size needed for legibility.").optional(), "clear_space": import_zod.z.string().describe("Minimum clear space around the logo, expressed in brand terms or units.").optional(), "allowed_backgrounds": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Background color roles, values, or surfaces where this logo may be placed.").optional(), "forbidden_backgrounds": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Background color roles, values, or surfaces where this logo must not be placed.").optional(), "forbidden_contexts": import_zod.z.array(import_zod.z.string()).describe("Contexts where this logo must not be used, such as photography_without_knockout.").optional(), "severity": import_zod.z.enum(["must", "should"]).describe("Strength of a machine-readable brand guideline constraint.").optional(), "description": import_zod.z.string().describe("Human-readable rationale or source-language summary for the rule.").optional() }).catchall(import_zod.z.any()).and(import_zod.z.union([import_zod.z.any(), import_zod.z.any(), import_zod.z.any(), import_zod.z.any(), import_zod.z.any()])).describe("Machine-readable logo selection and placement rule. Complements logos[].usage by making enforceable minimum size, clear-space, background, and context constraints queryable.")).describe("Machine-readable logo selection and placement constraints for minimum size, clear space, backgrounds, and contexts.").optional(), "mark_lockups": import_zod.z.array(import_zod.z.object({ "lockup_type": import_zod.z.enum(["co_brand", "secondary_mark", "partner", "sponsor", "program", "talent", "custom"]).describe("Type of mark relationship governed by this lockup rule."), "ordering": import_zod.z.enum(["brand_first", "partner_first", "equal", "contextual"]).describe("Required visual ordering of the brand mark relative to partner or secondary marks.").optional(), "contexts": import_zod.z.array(import_zod.z.string()).describe("Creative contexts where this lockup rule applies.").optional(), "brand_logo_id": import_zod.z.string().regex(new RegExp("^[a-z0-9][a-z0-9_-]*$")).describe("Stable `logos[].id` for the brand logo this lockup rule is anchored on.").optional(), "secondary_logo_ids": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9][a-z0-9_-]*$")).describe("Stable identifier for a logo entry within this brand.json document. Use lowercase words separated by underscores or hyphens; do not key integrations on mutable asset URLs.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Stable `logos[].id` values for secondary, program, sponsor, or partner marks governed by this lockup rule when those marks are represented in this brand.json.").optional(), "separator": import_zod.z.object({ "type": import_zod.z.enum(["none", "keyline", "space", "divider"]).describe("Separator style."), "color": import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.").optional(), "width": import_zod.z.string().describe("Separator width, such as 1px.").optional() }).catchall(import_zod.z.any()).describe("Separator between marks, when required.").optional(), "min_gap": import_zod.z.string().describe("Minimum gap between marks, expressed in brand terms or units.").optional(), "brand_min_optical_weight_ratio": import_zod.z.number().gt(0).describe("Minimum optical weight of the brand mark relative to partner marks. 1 means at least equal.").optional(), "partner_max_optical_weight_ratio": import_zod.z.number().gt(0).describe("Maximum optical weight of partner marks relative to the brand mark. 1 means no larger than the brand mark. Enforcement is at layout time, not parse time \u2014 this value signals to renderers and creative agents how much space to provision for each mark.").optional(), "severity": import_zod.z.enum(["must", "should"]).describe("Strength of a machine-readable brand guideline constraint.").optional(), "description": import_zod.z.string().describe("Human-readable rationale or source-language summary for the lockup rule.").optional() }).catchall(import_zod.z.any()).describe("Machine-readable layout constraints for co-brand, partner, sponsor, program, or secondary-mark lockups.")).describe("Machine-readable co-brand, partner, sponsor, program, or secondary-mark lockup rules.").optional(), "type_scale": import_zod.z.object({ "base_width": import_zod.z.string().describe("Reference canvas width these sizes were designed for (e.g., '1080px'). Generative systems should scale proportionally for other canvas sizes.").optional(), "heading": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional(), "subheading": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional(), "body": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional(), "caption": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional(), "cta": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional() }).catchall(import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale")).describe("Typography scale defining sizes and weights for different text roles. When sizes are in px, use base_width to indicate the reference canvas.").optional(), "asset_libraries": import_zod.z.array(import_zod.z.object({ "name": import_zod.z.string().describe("Display name of the asset library"), "type": import_zod.z.enum(["icon_set", "illustration_system", "image_library", "video_library", "template_library"]).describe("Type of asset library").optional(), "url": import_zod.z.string().url().describe("URL to the asset library (for human access)"), "description": import_zod.z.string().describe("Description of the library contents and usage").optional(), "color_guide": import_zod.z.object({ "roles": import_zod.z.array(import_zod.z.string()).describe("Named color roles used in the library (e.g., base, shadow_1, highlight_1, stroke)").optional(), "palettes": import_zod.z.array(import_zod.z.object({ "name": import_zod.z.string().describe("Palette name"), "colors": import_zod.z.record(import_zod.z.string(), import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value")).describe("Map of role names to hex color values") }).catchall(import_zod.z.any())).describe("Named color palettes mapping roles to specific colors").optional() }).catchall(import_zod.z.any()).describe("Color guide for the asset library defining roles and palettes").optional() }).catchall(import_zod.z.any()).describe("A managed asset library (icon set, illustration system, image collection). The URL is for human access; agent-facing DAM integration is under investigation.")).describe("References to managed asset libraries (icon sets, illustration systems, image collections). URLs are intended for human access; agent-facing DAM integration is under investigation.").optional(), "restrictions": import_zod.z.array(import_zod.z.string()).describe("Visual prohibitions and guardrails (e.g., 'Never use black backgrounds', 'Do not crop the logo', 'No stock photography of people on phones')").optional() }).catchall(import_zod.z.any()).describe("Structured visual rules for generative creative systems").optional(), "agents": import_zod.z.array(import_zod.z.object({ "type": import_zod.z.enum(["brand", "rights", "measurement", "governance", "creative", "sales", "buying", "signals"]).describe("Functional role of this agent"), "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Agent endpoint URL (MCP or A2A). Callers comparing a brand's declared agent URL against another value (e.g., resolving 'is this the agent that signed this artifact?' or matching against a discovery cache) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. After the publication chain and an authorized request-signing key verify, this exact entry's canonical URL is the stable Agent identity input for principal mapping; the domain, JWKS URI, kid, and key material are credential or trust facts beneath it, not the Agent identity. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).max(100).describe("Agent identifier (useful for logging, multi-tenant platforms)"), "description": import_zod.z.string().max(500).describe("Human-readable description of this agent's capabilities or scope").optional(), "jwks_uri": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL of the agent's JWKS (RFC 7517) containing public keys used to verify artifacts this agent signs or requests it sends. Verified artifacts include signed governance_context tokens (for governance agents) and RFC 9421 HTTP Signatures on outgoing requests (for any agent). When absent, verifiers MUST default to /.well-known/jwks.json on the origin of `url`. Keys are identified by `kid` in the JWS header or RFC 9421 `keyid` parameter; JWKS MAY contain multiple keys to support rotation and per-purpose separation via `key_ops` and `use`.").optional(), "available_uses": import_zod.z.array(import_zod.z.enum(["likeness", "voice", "name", "endorsement", "motion_capture", "signature", "catchphrase", "sync", "background_music", "editorial", "commercial", "ai_generated_image"]).describe("Types of rights usage that can be licensed through the brand protocol. Aligned with DDEX UseType direction for interoperability with music and media rights systems.")).describe("For rights agents: rights uses available for licensing").optional(), "right_types": import_zod.z.array(import_zod.z.enum(["talent", "character", "brand_ip", "music", "stock_media"]).describe("Categories of intellectual property rights that can be licensed through the brand protocol.")).describe("For rights agents: types of rights available").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("ISO 3166-1 alpha-2 country codes where this agent operates. Omit for global scope.").optional() }).catchall(import_zod.z.any()).describe("An agent declared by a brand or house. Each entry identifies one agent endpoint and its functional role in the advertising ecosystem.")).describe("Agents authorized to act on behalf of this brand. Consumers resolving an agent by URL use the matching brand-level entry; do not infer a type-wide override of unrelated house-level entries when multiple same-type entries exist.").optional(), "brand_agent": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Brand agent MCP endpoint URL. Callers comparing this URL against another value (e.g., resolving 'is this the brand's declared agent?' against a discovery cache) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Agent identifier (useful for logging, multi-tenant DAMs)") }).catchall(import_zod.z.any()).describe("Deprecated: use agents array with type 'brand' instead. Brand agent that provides dynamic brand data via MCP.").optional(), "rights_agent": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Rights agent MCP endpoint URL. Callers comparing this URL against another value (e.g., matching against a brand's declared rights endpoint) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Agent identifier"), "available_uses": import_zod.z.array(import_zod.z.enum(["likeness", "voice", "name", "endorsement", "motion_capture", "signature", "catchphrase", "sync", "background_music", "editorial", "commercial", "ai_generated_image"]).describe("Types of rights usage that can be licensed through the brand protocol. Aligned with DDEX UseType direction for interoperability with music and media rights systems.")).describe("Rights uses available for licensing through this agent"), "right_types": import_zod.z.array(import_zod.z.enum(["talent", "character", "brand_ip", "music", "stock_media"]).describe("Categories of intellectual property rights that can be licensed through the brand protocol.")).describe("Types of rights available").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("Countries where rights are available (ISO 3166-1 alpha-2)").optional() }).catchall(import_zod.z.any()).describe("Deprecated: use agents array with type 'rights' instead. Rights licensing agent for this brand.").optional(), "contact": import_zod.z.object({ "email": import_zod.z.string().email().describe("Contact email").optional(), "phone": import_zod.z.string().describe("Contact phone number").optional() }).describe("Brand-level contact information").optional(), "collections": import_zod.z.array(import_zod.z.object({ "collection_id": import_zod.z.string().describe("Collection identifier as used in the seller's get_products responses").optional(), "name": import_zod.z.string().describe("Human-readable collection name"), "role": import_zod.z.enum(["host", "guest", "creator", "cast", "narrator", "producer", "correspondent", "commentator", "analyst"]).describe("This person's role on the collection").optional(), "seller_agent_url": import_zod.z.string().url().describe("URL of the sales agent that sells inventory for this collection. Buyer agents can query this agent for collection products.").optional() }).catchall(import_zod.z.any())).describe("Collections this person or brand is associated with. Enables bidirectional linking: a collection's talent references brand.json via brand_url, and brand.json links back to collections.").optional() }).catchall(import_zod.z.any()).describe("A brand within a house portfolio. Combines identity (who) with creative assets (how to represent). Referenced as domain + brand_id.")).describe("Inline brands owned by this house (parent-owned data). Use for sub-brands without their own canonical document \u2014 typically those without a dedicated domain or that the holdco wants to manage centrally. A brand_id MUST NOT appear in both brands[] and brand_refs[].").optional(), "brand_refs": import_zod.z.array(import_zod.z.object({ "domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where the child's canonical brand.json lives"), "brand_id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Stable brand identifier within the house portfolio. Required so the cross-array uniqueness invariant (brand_id MUST NOT appear in both brands[] and brand_refs[]) is enforceable."), "managed_by": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Optional domain of the entity that operationally manages this brand (e.g., an agency network within a holdco). House-declared. Consumers MUST NOT use it for trust or authorization decisions. Aggregation across houses ('show me everything BBH manages') is the intended use; trust is unaffected.").optional(), "effective_at": import_zod.z.string().datetime().describe("ISO 8601 timestamp when the house established this ownership claim. Consumers age mutual-assertion edges from this date for TTL purposes and MUST NOT extend relationship trust before a future effective_at is reached. Optional; absent means the consumer ages from its own durable first observation.").optional() }).strict().describe("A house's ownership entry for a brand that publishes its own canonical brand.json elsewhere. The publisher (the house) asserts 'I own this brand, hosted at this domain, effective on this date.' Mutual-assertion trust requires the child's house_domain to reciprocate. Distinct from core/brand-ref.json (which identifies brands in media-buy plans). See docs/brand-protocol/brand-json.mdx")).describe("Portfolio entries for brands owned by this house that publish their own canonical brand.json elsewhere (child-owned data). Each entry asserts ownership plus where the child's document lives. Mutual-assertion trust: the pointed-to document's house_domain must equal this house's domain. Invariants: a brand_id MUST NOT appear in both brands[] and brand_refs[]; brand_id and domain MUST each be unique within brand_refs[]. See docs/brand-protocol/brand-json.mdx").optional(), "contact": import_zod.z.object({ "name": import_zod.z.string().min(1).max(255), "email": import_zod.z.string().email().max(255).optional(), "domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("A valid domain name").optional() }).catchall(import_zod.z.any()).describe("Contact information").optional(), "authorized_operators": import_zod.z.array(import_zod.z.object({ "domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain of the authorized operator (e.g., 'groupm.com')"), "brands": import_zod.z.array(import_zod.z.string().regex(new RegExp("^([a-z0-9_]+|\\*)$"))).describe("Brand IDs this operator is authorized for. Use ['*'] for all brands in the portfolio."), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("ISO 3166-1 alpha-2 country codes where this authorization applies. Omit for global authorization.").optional(), "scopes": import_zod.z.array(import_zod.z.enum(["all", "media_buying", "creative_generation", "rights_clearance", "governance", "measurement", "agent_operations"])).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Activities this operator is authorized to perform for the listed brands and countries. Omit for backwards-compatible broad authorization. Use ['all'] only when every listed scope is delegated.").optional(), "valid_from": import_zod.z.string().datetime().describe("ISO 8601 timestamp when this operator authorization starts. Omit when authorization is already active or the start date is not tracked.").optional(), "valid_until": import_zod.z.string().datetime().describe("ISO 8601 timestamp when this operator authorization expires. Consumers MUST treat entries at or after this timestamp as inactive for authorization decisions.").optional() }).catchall(import_zod.z.any()).describe("An entity authorized to represent brands from this house. Verified by resolving the operator's domain. Optional validity fields let houses time-box agency-of-record and delegated-operator relationships without changing historical entries.")).describe("Entities authorized to represent brands from this house. Third parties (sellers, platforms) can verify an operator's authorization by checking this list. Operators are identified by domain.").optional(), "trademarks": import_zod.z.array(import_zod.z.object({ "registry": import_zod.z.string().describe("Trademark registry (e.g., 'USPTO', 'EUIPO', 'JPO', 'CNIPA')"), "number": import_zod.z.string().describe("Registration number as issued by the registry"), "mark": import_zod.z.string().describe("The registered mark as published"), "status": import_zod.z.enum(["active", "pending", "abandoned", "cancelled", "expired"]).describe("Registration status. Omit for active marks if status tracking is not maintained.").optional(), "license_type": import_zod.z.enum(["owned", "licensed_in", "licensed_out"]).describe("Whether the publisher owns the mark, licenses it from another entity, or licenses it to others. 'owned' is the default if omitted.").optional(), "licensor_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain of the entity that licenses this mark to the publisher. Meaningful when license_type=licensed_in; omit otherwise.").optional(), "countries": import_zod.z.array(import_zod.z.string().min(2).max(2)).describe("ISO 3166-1 alpha-2 country codes where this registration applies. Omit for global or where the registry's jurisdiction is implicit.").optional(), "nice_classes": import_zod.z.array(import_zod.z.number().int().gte(1).lte(45)).describe("Nice Classification class numbers (1-45) covered by this registration. Disambiguates marks across industries (e.g., Delta-airline vs Delta-faucet). Omit if scope is implicit from registry.").optional() }).catchall(import_zod.z.any()).describe("A registered trademark. May appear at house level (corporate marks, e.g., 'NIKE' owned by Nike, Inc.) or at brand level (brand-specific marks, e.g., 'CONVERSE' owned by Converse). Resolution between house- and brand-level trademarks is union \u2014 both lists are valid claims about marks the publisher controls.")).describe("House-level (corporate) registered trademarks. Brand-level marks live on individual brand entries; resolution is union.").optional(), "last_updated": import_zod.z.string().datetime().optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("Full house/brand portfolio with hierarchy, creative assets, and properties. May carry inline brands (parent-owned, brands[]) and/or pointer brands (child-owned canonical documents, brand_refs[]). At least one of brands[] or brand_refs[] is required. A brand_id MUST NOT appear in both. See docs/brand-protocol/brand-json.mdx"), import_zod.z.record(import_zod.z.string(), import_zod.z.any()).and(import_zod.z.intersection(import_zod.z.object({ "$schema": import_zod.z.string().optional(), "version": import_zod.z.string().optional(), "default_language": import_zod.z.string().regex(new RegExp("^(?:[a-z]{2,8}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[0-9]{3}))?(?:-(?:[a-z0-9]{5,8}|[0-9][a-z0-9]{3}))*(?:-[0-9a-wy-z](?:-[a-z0-9]{2,8})+)*(?:-x(?:-[a-z0-9]{1,8})+)?|x(?:-[a-z0-9]{1,8})+)$")).min(2).max(63).describe("A well-formed BCP 47 language tag used by AdCP only as language identity. Script and region may refine that identity; other valid BCP 47 subtags remain part of tag matching but do not make this a general locale-settings object. It does not determine currency, time zone, number/date formatting, market, or legal jurisdiction. The AdCP canonical wire profile requires lower-case language and variants, title-case script, and upper-case region (for example `en-US`, `zh-Hant-TW`, or `x-private`). RFC 5646 comparisons are case-insensitive and its case regularization is optional; AdCP intentionally requires this stricter single wire spelling and receivers MUST reject differently cased tags rather than silently normalizing them. The schema pattern enforces the AdCP casing profile and extension structure for commonly used tags; conforming receivers additionally validate the complete RFC 5646 grammar and registry rules. Every new AdCP field carrying BCP 47 language identity or a concrete language range MUST reference this schema instead of declaring independent string constraints.").describe("BCP 47 language tag for legacy plain-string and plain-array content in this document. Readers assume en when omitted.").default("en"), "house_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Optional pointer to the corporate house this brand belongs to. The named house's brand_refs[] MUST reciprocate for mutual-assertion trust. Single-hop only \u2014 a brand cannot itself declare brand_refs[]. Omit for standalone brands (no house).").optional(), "last_updated": import_zod.z.string().datetime().optional() }), import_zod.z.object({ "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Brand identifier within the house. House chooses this ID."), "url": import_zod.z.string().url().describe("Primary brand URL for context and asset discovery").optional(), "identity_relying_parties": import_zod.z.array(import_zod.z.object({ "issuer": import_zod.z.object({ "domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where /.well-known/brand.json is hosted, or the brand's operating domain"), "brand_id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Brand identifier within the house portfolio. Optional for single-brand domains.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Canonical set of ISO 3166-1 alpha-2 countries for this advertiser identity. Omit for a global/default identity. Array order is not meaningful; producers MUST sort codes lexicographically before computing keys or signatures. This qualifies account identity and is not delivery targeting.").optional(), "industries": import_zod.z.array(import_zod.z.string()).describe("Inline override for the brand's industries. Useful when the caller cannot modify the brand's canonical brand.json but needs to declare industries for governance (e.g., Annex III vertical detection). brand.json remains the canonical source; when omitted here, governance agents SHOULD resolve from brand.json.").optional(), "data_subject_contestation": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).optional(), "email": import_zod.z.string().email().optional(), "languages": import_zod.z.array(import_zod.z.string()).optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("Inline override for the brand's contestation contact point. Useful when the operator does not control brand.json but needs to discharge Art 22(3) for this plan. brand.json is canonical; when omitted, governance agents resolve brand \u2192 house \u2192 missing.").optional(), "brand_kit_override": import_zod.z.object({ "logo": import_zod.z.object({ "asset_type": import_zod.z.literal("image").describe("Discriminator identifying this as an image asset. See /schemas/creative/asset-types for the registry."), "url": import_zod.z.string().url().describe("URL to the image asset"), "width": import_zod.z.number().int().gte(1).describe("Width in pixels"), "height": import_zod.z.number().int().gte(1).describe("Height in pixels"), "file_size_bytes": import_zod.z.number().int().gte(1).describe("Image file size in bytes. Required by agents that advertise a max_file_size_kb constraint.").optional(), "pixel_ratio": import_zod.z.number().gt(0).describe("Intrinsic pixels per logical render pixel (for example `2` for a 600\xD7500 image intended to render at 300\xD7250). Optional because a validator can infer the ratio when the target format declares logical dimensions. When supplied, it MUST agree with both `width / logical_width` and `height / logical_height`; it is never a substitute for the intrinsic `width` and `height` fields.").optional(), "state_id": import_zod.z.string().describe("Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one declared `states[].state_id` (semantic validators resolve it). Omit for ordinary image slots.").optional(), "breakpoint_id": import_zod.z.string().describe("Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one breakpoint declared on the selected state (semantic validators resolve it). Omit for ordinary image slots.").optional(), "focal_point": import_zod.z.array(import_zod.z.number().gte(0).lte(1)).max(2).describe("Normalized `[x, y]` coordinates (0\u20131 from top-left) of the image's visual anchor. Seller-side renderers crop toward the focal point when deriving renditions across breakpoints and aspect ratios; absent, cropping falls back to center-weighted defaults.").optional(), "format": import_zod.z.string().describe("Image file format (jpg, png, gif, webp, etc.)").optional(), "alt_text": import_zod.z.string().describe("Alternative text for accessibility").optional(), "provenance": import_zod.z.object({ "digital_source_type": import_zod.z.enum(["digital_capture", "digital_creation", "trained_algorithmic_media", "composite_with_trained_algorithmic_media", "algorithmic_media", "composite_capture", "composite_synthetic", "human_edits", "data_driven_media"]).describe("IPTC-aligned classification of AI involvement in producing this content").optional(), "synthetic_depiction": import_zod.z.boolean().describe("Assessed declaration of whether the content synthetically depicts a real or fictional person performing or appearing in a way that was generated or materially manipulated rather than captured as depicted. `true` covers both a fully synthetic performer and material manipulation of a real performer; `false` is an assessed declaration that the content does not contain such a depiction. Absence means the content has not been assessed for synthetic depiction. This field does not claim consent, legality, or independent verification, and receivers MUST NOT derive it solely from `digital_source_type`.").optional(), "ai_tool": import_zod.z.object({ "name": import_zod.z.string().describe("Name of the AI tool or model (e.g., 'DALL-E 3', 'Stable Diffusion XL', 'Gemini')"), "version": import_zod.z.string().describe("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.").optional(), "provider": import_zod.z.string().describe("Organization that provides the AI tool (e.g., 'OpenAI', 'Stability AI', 'Google')").optional() }).describe("AI system used to generate or modify this content. Aligns with IPTC 2025.1 AI metadata fields and C2PA claim_generator.").optional(), "human_oversight": import_zod.z.enum(["none", "prompt_only", "selected", "edited", "directed"]).describe("Level of human involvement in the AI-assisted creation process. Independent of `disclosure.required` \u2014 the protocol does not derive disclosure obligations from oversight level. Some regulations include carve-outs for human-edited or human-directed AI output, but those carve-outs have factual prerequisites the schema cannot evaluate. Asserting `edited` or `directed` does not by itself justify `disclosure.required: false`.").optional(), "declared_by": import_zod.z.object({ "agent_url": import_zod.z.string().url().describe("URL of the agent or service that declared this provenance").optional(), "role": import_zod.z.enum(["creator", "advertiser", "agency", "platform", "tool"]).describe("Role of the declaring party in the supply chain") }).describe("Party declaring this provenance. Identifies who attached the provenance claim, enabling receiving parties to assess trust.").optional(), "declared_at": import_zod.z.string().datetime().describe("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.").optional(), "created_time": import_zod.z.string().datetime().describe("When this content was created or generated (ISO 8601)").optional(), "c2pa": import_zod.z.object({ "manifest_url": import_zod.z.string().url().describe("URL to the C2PA manifest store for this content") }).describe("C2PA sidecar manifest reference. Links to a detached cryptographic provenance manifest for this content. Note: file-level C2PA bindings break when ad servers transcode, resize, or re-encode assets. For pipelines with intermediaries, consider embedded_provenance as the primary provenance mechanism.").optional(), "embedded_provenance": import_zod.z.array(import_zod.z.object({ "method": import_zod.z.enum(["manifest_wrapper", "provenance_markers"]).describe("How provenance data is carried within the content"), "standard": import_zod.z.string().describe("Standard the embedding conforms to, if any (e.g., 'c2pa' for C2PA Section A.7 text manifest embedding)").optional(), "provider": import_zod.z.string().describe("Organization that performed the embedding (e.g., 'Encypher', 'Digimarc'). Display label and audit context \u2014 not a wire identifier."), "verify_agent": import_zod.z.object({ "agent_url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("URL of the governance agent the buyer represents was used to embed/verify this layer. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."), "feature_id": import_zod.z.string().describe("Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `encypher.markers_present_v2`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog.").optional() }).strict().describe("Buyer's representation that this embedding can be verified by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing \u2014 the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist). MAY be omitted for self-verifiable embeddings (e.g., a C2PA text manifest with a public key the seller already trusts).").optional(), "embedded_at": import_zod.z.string().datetime().describe("When the provenance data was embedded (ISO 8601)").optional() })).describe("Provenance metadata embedded within the content stream. Each entry declares one embedding layer: structured provenance data carried inside the content itself, as distinct from sidecar references (c2pa.manifest_url). Embedded provenance survives operations that break sidecar and file-level bindings: ad-server transcoding, CMS ingestion, copy-paste, reformatting, and CDN re-encoding. For ad-tech pipelines where content passes through multiple intermediaries, embedded provenance is the reliable path for provenance that persists from declaration through delivery. This is a declaration by the embedding party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).").optional(), "watermarks": import_zod.z.array(import_zod.z.object({ "media_type": import_zod.z.enum(["audio", "image", "video", "text"]).describe("Media category of the watermarked content"), "provider": import_zod.z.string().describe("Organization that applied the watermark (e.g., 'Imatag', 'Steg.AI', 'Encypher'). Display label and audit context \u2014 not a wire identifier."), "verify_agent": import_zod.z.object({ "agent_url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("URL of the governance agent the buyer represents was used to apply/detect this watermark. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."), "feature_id": import_zod.z.string().describe("Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `imatag.watermark_detected`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog.").optional() }).strict().describe("Buyer's representation that this watermark can be detected by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing \u2014 the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist).").optional(), "c2pa_action": import_zod.z.enum(["c2pa.watermarked.bound", "c2pa.watermarked.unbound"]).describe("C2PA action classification for this watermark").optional(), "embedded_at": import_zod.z.string().datetime().describe("When the watermark was applied (ISO 8601)").optional() })).describe("Content watermarks applied to this asset. Each entry declares one watermarking layer: a content modification that encodes an identifier or fingerprint within the asset. Watermarks differ from embedded provenance: a watermark encodes an identifier (who generated it, who owns it), while embedded provenance carries or references a structured provenance record (the full chain of custody). A single asset may carry both. Aligns with C2PA action taxonomy: c2pa.watermarked.bound (watermark linked to a C2PA manifest) and c2pa.watermarked.unbound (watermark independent of any manifest). This is a declaration by the watermarking party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).").optional(), "disclosure": import_zod.z.object({ "required": import_zod.z.boolean().describe("The declaring party's claim that AI disclosure is required for this content under applicable regulations. This is a declared signal carried through the supply chain \u2014 useful as a routing and audit input \u2014 not a regulatory determination made by the protocol. Receiving parties remain responsible for their own jurisdictional analysis and should not treat `required: false` as compliance cover."), "jurisdictions": import_zod.z.array(import_zod.z.object({ "country": import_zod.z.string().describe("ISO 3166-1 alpha-2 country code (e.g., 'US', 'DE', 'CN')"), "region": import_zod.z.string().describe("Sub-national region code (e.g., 'CA' for California, 'BY' for Bavaria)").optional(), "regulation": import_zod.z.string().describe("Regulation identifier (e.g., 'eu_ai_act_article_50', 'ca_sb_942', 'cn_deep_synthesis')"), "label_text": import_zod.z.string().describe("Required disclosure label text for this jurisdiction, in the local language").optional(), "render_guidance": import_zod.z.object({ "persistence": import_zod.z.enum(["continuous", "initial", "flexible"]).describe("How long the disclosure must persist during content playback or display").optional(), "min_duration_ms": import_zod.z.number().int().gte(1).describe("Minimum display duration in milliseconds for initial persistence. Recommended when persistence is initial \u2014 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.").optional(), "positions": import_zod.z.array(import_zod.z.enum(["prominent", "footer", "audio", "subtitle", "overlay", "end_card", "pre_roll", "companion"]).describe("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.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Preferred disclosure positions in priority order. The first position a format supports should be used.").optional(), "ext": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).describe("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.").optional() }).describe("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.").optional() })).describe("Jurisdictions where disclosure obligations apply").optional() }).describe("Regulatory disclosure requirements for this content. Indicates whether AI disclosure is required and under which jurisdictions.").optional(), "verification": import_zod.z.array(import_zod.z.object({ "verified_by": import_zod.z.string().describe("Name of the verification service (e.g., 'DoubleVerify', 'Hive Moderation', 'Reality Defender')"), "verified_time": import_zod.z.string().datetime().describe("When the verification was performed (ISO 8601)").optional(), "result": import_zod.z.enum(["authentic", "ai_generated", "ai_modified", "inconclusive"]).describe("Verification outcome"), "confidence": import_zod.z.number().gte(0).lte(1).describe("Confidence score of the verification result (0.0 to 1.0)").optional(), "details_url": import_zod.z.string().url().describe("URL to the full verification report").optional() })).describe("Third-party verification or detection results for this content. Multiple services may independently evaluate the same content. Provenance is a claim \u2014 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.").optional(), "ext": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).describe("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.").optional() }).describe("Provenance metadata for this asset, overrides manifest-level provenance").optional() }).catchall(import_zod.z.any()).describe("Override logo asset.").optional(), "colors": import_zod.z.object({ "primary": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional(), "secondary": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional(), "accent": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional() }).catchall(import_zod.z.any()).describe("Override brand colors (hex strings).").optional(), "voice": import_zod.z.string().describe("Override brand-voice description for surface-composed text/audio output.").optional(), "tagline": import_zod.z.string().describe("Override tagline.").optional() }).catchall(import_zod.z.any()).describe("Inline override for brand-kit fields normally resolved from `/.well-known/brand.json` on `domain` (logo, colors, voice, tagline). Use when brand.json is missing, stale, or inappropriate for this specific call \u2014 e.g., a campaign-scoped tagline, a co-branded creative, a freshly-rebranded color palette the brand.json hasn't shipped yet. Same inline-override pattern as `industries` and `data_subject_contestation` above: brand.json is canonical, the override is per-call. Adopters needing to override fields outside this subset (`voice_attributes`, `prohibited_terms`, etc.) MUST publish a different brand.json and reference it via a different `domain` \u2014 the inline override is intentionally narrow to a small high-traffic subset.\n\n**Merge semantics (normative).** The merge is **field-level**, not whole-object replacement. Each field within `brand_kit_override` (`logo`, `colors`, `voice`, `tagline`) is evaluated independently \u2014 when a field is present on the override the override value applies; when a field is absent the brand.json value applies (or is absent if brand.json doesn't carry one either). For composite fields (`colors.primary`, `colors.secondary`, `colors.accent`), the merge is one level deeper: each color slot is evaluated independently \u2014 a producer can override `colors.primary` while still inheriting `colors.secondary` from brand.json. SDKs MUST NOT treat a present `brand_kit_override.colors` as wiping the brand.json `colors` block entirely; only the per-slot fields present in the override take precedence. Without this rule, a partial-override semantics would diverge across SDKs and produce inconsistent rendering for the same payload.").optional() }).strict().describe(`Identity issuer / attestation authority, referenced as a vendor BrandRef (e.g. {"domain": "world.org"}) \u2014 the same vendor-reference shape AdCP uses for measurement and signals vendors. The issuer's canonical domain is the anchor; it need not host a brand.json, but if it does, that is where its verifier metadata (scheme versions, verify endpoint, JWKs) lives. Issuer-agnostic: World ID, ISO 18013-5 mDL, and W3C-VC issuers all reference by domain. The relying party is namespaced by the issuer \u2014 identity is the tuple (issuer.domain, issuer.brand_id, relying_party_id), mirroring (vendor.domain, vendor.brand_id, metric_id).`), "scheme": import_zod.z.string().describe('Proof scheme and version, e.g. "world_id_v4".').optional(), "relying_party_id": import_zod.z.string().describe("The relying-party id registered with the issuer (and, for on-chain issuers like World ID, with the issuer's registry). One entity may operate many relying parties (scope=entity vs scope=property); this is the attestation's audience / linkability boundary, not an entity identifier."), "scope": import_zod.z.enum(["entity", "property"]).describe("Whether this relying_party_id is shared across the entity's properties (entity \u2192 a within-entity unique-human graph) or scoped to a single property (property \u2192 per-property pseudonyms, unlinkable across the entity).").optional() }).strict().describe("A verified-identity relying party an entity or brand operates. Used for attestation provenance in TMP Identity Match (the buyer checks a forwarded attestation's relying_party_id against the owner's published list). Issuer-agnostic; World ID is the first issuer.")).describe("Verified-identity relying parties scoped to this brand/property, for attestation provenance in TMP Identity Match. Use when a brand or property runs its own relying_party_id (per-property pseudonyms); entity-wide relying parties live on the house object. See specs/tmp-verified-identity-attestation.md.").optional(), "names": import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged.")).describe("Localized brand names. Multiple entries per language allowed for aliases."), "keller_type": import_zod.z.enum(["master", "sub_brand", "endorsed", "independent"]).describe("Brand architecture type from Keller's theory. master: primary brand of house. sub_brand: carries parent name (Nike SB). endorsed: independent identity backed by parent (Air Jordan 'by Nike'). independent: operates separately (Converse under Nike, Inc.)").optional(), "parent_brand": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Parent brand ID for sub-brands and endorsed brands").optional(), "description": import_zod.z.string().describe("Brand description").optional(), "industries": import_zod.z.array(import_zod.z.string()).describe("Brand industries (e.g., ['automotive'] or ['pharmaceutical', 'cpg'] for a consumer health company). Describes what the company does \u2014 not what regulatory regimes apply (use policy_categories for that).").optional(), "target_audience": import_zod.z.string().describe("Primary target audience").optional(), "logos": import_zod.z.array(import_zod.z.object({ "id": import_zod.z.string().regex(new RegExp("^[a-z0-9][a-z0-9_-]*$")).describe("Stable identifier for this logo entry. Recommended when logo usage rules or mark lockups need to bind to a specific logo asset.").optional(), "url": import_zod.z.string().url().describe("URL to the logo asset"), "orientation": import_zod.z.enum(["square", "horizontal", "vertical", "stacked"]).describe("Logo aspect ratio orientation. square: ~1:1, horizontal: wide, vertical: tall, stacked: vertically arranged elements").optional(), "background": import_zod.z.enum(["dark-bg", "light-bg", "transparent-bg"]).describe("Background compatibility. dark-bg: use on dark backgrounds, light-bg: use on light backgrounds, transparent-bg: has transparent background").optional(), "variant": import_zod.z.enum(["primary", "secondary", "icon", "wordmark", "full-lockup"]).describe("Logo variant type. primary: main logo, secondary: alternative, icon: symbol only, wordmark: text only, full-lockup: complete logo").optional(), "tags": import_zod.z.array(import_zod.z.string()).describe("Additional semantic tags for custom categorization beyond the standard orientation, background, and variant fields").optional(), "slots": import_zod.z.array(import_zod.z.enum(["logo_card_light", "logo_card_dark", "profile_mark", "favicon", "app_icon", "social_profile_mark", "nav_header", "footer", "email_header", "watermark", "ad_end_card", "co_brand_lockup", "marketplace_listing"]).describe("Canonical renderer-facing logo slot. Use when selecting a logo variant from brand.json for a specific UI or creative placement.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Canonical renderer slots where this logo is appropriate. Consumers SHOULD prefer this over inferring from tags or usage prose when selecting a logo for a specific UI surface.").optional(), "usage": import_zod.z.string().describe("Human-readable description of when to use this logo variant (e.g., 'Primary logo for use on light backgrounds')").optional(), "width": import_zod.z.number().int().describe("Width in pixels").optional(), "height": import_zod.z.number().int().describe("Height in pixels").optional() }).catchall(import_zod.z.any()).describe("Brand logo asset with structured fields for orientation, background compatibility, and variant type")).describe("Brand logo assets").optional(), "colors": import_zod.z.object({ "primary": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "secondary": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "accent": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "background": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "text": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "heading": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "body": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "label": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "border": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "divider": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "surface_1": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "surface_2": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional() }).catchall(import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))])).describe("Brand color palette. Each role accepts a single hex color or an array of hex colors for brands with multiple values per role. Beyond the core five roles, brands can provide additional color roles for finer granularity \u2014 heading, body, label, border, divider, surface_1, surface_2, etc.").optional(), "fonts": import_zod.z.object({ "primary": import_zod.z.union([import_zod.z.string().describe("CSS font-family name (e.g., 'Montserrat', 'Arial, sans-serif')"), import_zod.z.object({ "family": import_zod.z.string().describe("CSS font-family name (e.g., 'Brand Sans')"), "files": import_zod.z.array(import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to the font file (WOFF2, TTF, or OTF)"), "weight": import_zod.z.number().int().gte(100).lte(900).describe("CSS numeric font-weight for static fonts (100-900)").optional(), "weight_range": import_zod.z.array(import_zod.z.number().int().gte(100).lte(900)).max(2).describe("Variable font weight axis range as [min, max] (e.g., [100, 900]). Use instead of weight for variable fonts.").optional(), "style": import_zod.z.enum(["normal", "italic", "oblique"]).describe("CSS font-style").optional() }).catchall(import_zod.z.any()).describe("A font file with weight, style, and variable font metadata")).max(36).describe("Font files for different weights and styles").optional(), "opentype_features": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9]{4}$"))).max(20).describe("OpenType feature tags to enable (e.g., ['ss01', 'tnum', 'cv01']). These are four-character tags per the OpenType spec.").optional(), "fallbacks": import_zod.z.array(import_zod.z.string().max(100)).max(10).describe("Ordered fallback font-family names for when the primary font is unavailable or does not support the required script (e.g., ['Noto Sans Arabic', 'Noto Sans SC', 'sans-serif'])").optional() }).catchall(import_zod.z.any()).describe("Structured font with family name, downloadable font files, and typographic metadata")]).describe("Primary font family").optional(), "secondary": import_zod.z.union([import_zod.z.string().describe("CSS font-family name (e.g., 'Montserrat', 'Arial, sans-serif')"), import_zod.z.object({ "family": import_zod.z.string().describe("CSS font-family name (e.g., 'Brand Sans')"), "files": import_zod.z.array(import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to the font file (WOFF2, TTF, or OTF)"), "weight": import_zod.z.number().int().gte(100).lte(900).describe("CSS numeric font-weight for static fonts (100-900)").optional(), "weight_range": import_zod.z.array(import_zod.z.number().int().gte(100).lte(900)).max(2).describe("Variable font weight axis range as [min, max] (e.g., [100, 900]). Use instead of weight for variable fonts.").optional(), "style": import_zod.z.enum(["normal", "italic", "oblique"]).describe("CSS font-style").optional() }).catchall(import_zod.z.any()).describe("A font file with weight, style, and variable font metadata")).max(36).describe("Font files for different weights and styles").optional(), "opentype_features": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9]{4}$"))).max(20).describe("OpenType feature tags to enable (e.g., ['ss01', 'tnum', 'cv01']). These are four-character tags per the OpenType spec.").optional(), "fallbacks": import_zod.z.array(import_zod.z.string().max(100)).max(10).describe("Ordered fallback font-family names for when the primary font is unavailable or does not support the required script (e.g., ['Noto Sans Arabic', 'Noto Sans SC', 'sans-serif'])").optional() }).catchall(import_zod.z.any()).describe("Structured font with family name, downloadable font files, and typographic metadata")]).describe("Secondary font family").optional() }).catchall(import_zod.z.union([import_zod.z.string().describe("CSS font-family name (e.g., 'Montserrat', 'Arial, sans-serif')"), import_zod.z.object({ "family": import_zod.z.string().describe("CSS font-family name (e.g., 'Brand Sans')"), "files": import_zod.z.array(import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to the font file (WOFF2, TTF, or OTF)"), "weight": import_zod.z.number().int().gte(100).lte(900).describe("CSS numeric font-weight for static fonts (100-900)").optional(), "weight_range": import_zod.z.array(import_zod.z.number().int().gte(100).lte(900)).max(2).describe("Variable font weight axis range as [min, max] (e.g., [100, 900]). Use instead of weight for variable fonts.").optional(), "style": import_zod.z.enum(["normal", "italic", "oblique"]).describe("CSS font-style").optional() }).catchall(import_zod.z.any()).describe("A font file with weight, style, and variable font metadata")).max(36).describe("Font files for different weights and styles").optional(), "opentype_features": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9]{4}$"))).max(20).describe("OpenType feature tags to enable (e.g., ['ss01', 'tnum', 'cv01']). These are four-character tags per the OpenType spec.").optional(), "fallbacks": import_zod.z.array(import_zod.z.string().max(100)).max(10).describe("Ordered fallback font-family names for when the primary font is unavailable or does not support the required script (e.g., ['Noto Sans Arabic', 'Noto Sans SC', 'sans-serif'])").optional() }).catchall(import_zod.z.any()).describe("Structured font with family name, downloadable font files, and typographic metadata")]).describe("A font role entry. Either a CSS font-family string (simple) or a structured object with family name and font files (rich).")).describe("Brand typography. Each key is a role name (e.g., 'primary', 'secondary') referenced by type_scale entries. Values are either a CSS font-family string or a structured object with font files for reliable resolution.").optional(), "tone": import_zod.z.union([import_zod.z.string().describe("Simple tone descriptors for backwards compatibility"), import_zod.z.object({ "voice": import_zod.z.union([import_zod.z.string(), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged."))]).describe("High-level voice descriptor, either a legacy plain string or localized values.").optional(), "attributes": import_zod.z.union([import_zod.z.array(import_zod.z.string()), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.array(import_zod.z.string())).describe("One locale mapped to a complete ordered string list. The list is selected as a unit so readers never assemble mixed-language output from independently localized elements."))]).describe("Personality traits that characterize the brand voice. Localized lists are selected as a whole.").optional(), "dos": import_zod.z.union([import_zod.z.array(import_zod.z.string()), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.array(import_zod.z.string())).describe("One locale mapped to a complete ordered string list. The list is selected as a unit so readers never assemble mixed-language output from independently localized elements."))]).describe("Guidance for copy generation - what TO do. Localized lists are selected as a whole.").optional(), "donts": import_zod.z.union([import_zod.z.array(import_zod.z.string()), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.array(import_zod.z.string())).describe("One locale mapped to a complete ordered string list. The list is selected as a unit so readers never assemble mixed-language output from independently localized elements."))]).describe("Guardrails to avoid brand violations - what NOT to do. Localized lists are selected as a whole.").optional() }).describe("Structured brand voice guidelines")]).describe("Brand voice and messaging tone guidelines").optional(), "tagline": import_zod.z.union([import_zod.z.string().describe("Plain tagline string for backwards compatibility"), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged.")).describe("Localized taglines with BCP 47 locale codes")]).describe("Brand tagline or slogan. Accepts a plain string or a localized array matching the names pattern.").optional(), "assets": import_zod.z.array(import_zod.z.object({ "asset_id": import_zod.z.string().describe("Unique identifier"), "asset_type": import_zod.z.enum(["image", "video", "audio", "text", "markdown", "html", "css", "javascript", "zip", "vast", "daast", "url", "webhook", "brief", "catalog", "published_post"]).describe("Type of asset content"), "url": import_zod.z.string().url().describe("URL to CDN-hosted asset file"), "tags": import_zod.z.array(import_zod.z.string()).describe("Tags for discovery (e.g., 'hero', 'lifestyle', 'product', 'holiday')").optional(), "name": import_zod.z.union([import_zod.z.string(), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged."))]).describe("Human-readable name, either a legacy plain string or localized values.").optional(), "description": import_zod.z.union([import_zod.z.string(), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged."))]).describe("Asset description or usage notes, either a legacy plain string or localized values.").optional(), "width": import_zod.z.number().int().describe("Image/video width in pixels").optional(), "height": import_zod.z.number().int().describe("Image/video height in pixels").optional(), "duration_seconds": import_zod.z.number().describe("Video/audio duration in seconds").optional(), "file_size_bytes": import_zod.z.number().int().describe("File size in bytes").optional(), "format": import_zod.z.string().describe("File format (e.g., 'jpg', 'mp4', 'mp3')").optional(), "metadata": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).describe("Additional asset-specific metadata").optional() }).catchall(import_zod.z.any()).describe("Brand asset (image, video, audio, text)")).describe("Brand asset library").optional(), "properties": import_zod.z.array(import_zod.z.object({ "type": import_zod.z.enum(["website", "mobile_app", "ctv_app", "desktop_app", "dooh", "podcast", "radio", "linear_tv", "streaming_audio", "ai_assistant"]).describe("Property type"), "identifier": import_zod.z.string().min(1).describe("Property identifier - domain for websites, bundle ID for apps"), "store": import_zod.z.enum(["apple", "google", "amazon", "roku", "samsung", "lg", "other"]).describe("App store for mobile/CTV apps").optional(), "region": import_zod.z.string().regex(new RegExp("^([A-Z]{2}|global)$")).describe("ISO 3166-1 alpha-2 country code or 'global'").optional(), "primary": import_zod.z.boolean().describe("Whether this is the primary property for the brand").default(false), "relationship": import_zod.z.enum(["owned", "direct", "delegated", "ad_network"]).describe("How this brand relates to the property. 'owned': the brand owns and operates this property (default) and has no adagents.json delegation_type counterpart. 'direct': the brand is the direct sales path for this property, even if a third party operates the software (e.g., a publisher's in-house ad team using a vendor's tech). 'delegated': the brand manages monetization for this property \u2014 they are in charge of ad sales (e.g., Mediavine managing a food blog). 'ad_network': the brand sells this property's inventory as part of a network or exchange \u2014 they are a path to the inventory, not the path (e.g., PubMatic as an SSP). For non-owned properties, the publisher confirms the relationship by setting the matching delegation_type on the agent's authorization in their adagents.json.").default("owned") }).catchall(import_zod.z.any()).describe("A digital property associated with a brand. Defaults to owned; use 'relationship' to declare direct, delegated, or ad_network properties. For delegated and network paths, these values match the delegation_type field in adagents.json, creating a bilateral verification chain: the operator declares the relationship here, the publisher confirms by setting the same delegation_type on the agent's authorization in their adagents.json. 'owned' is an inline ownership declaration with no adagents.json counterpart.")).describe("Digital properties associated with this brand \u2014 owned, managed, or represented").optional(), "product_catalog": import_zod.z.object({ "feed_url": import_zod.z.string().url().describe("URL to product catalog feed"), "feed_format": import_zod.z.enum(["google_merchant_center", "facebook_catalog", "shopify", "linkedin_jobs", "tiktok_shop", "pinterest_catalog", "openai_product_feed", "custom"]).describe("Format of the product feed").optional(), "categories": import_zod.z.array(import_zod.z.string()).describe("Product categories available in the catalog").optional(), "last_updated": import_zod.z.string().datetime().describe("When the product catalog was last updated").optional(), "update_frequency": import_zod.z.enum(["realtime", "hourly", "daily", "weekly"]).describe("How frequently the product catalog is updated").optional(), "agentic_checkout": import_zod.z.object({ "endpoint": import_zod.z.string().url().describe("Base URL for checkout session API"), "spec": import_zod.z.string().describe("Checkout API specification identifier. Use a namespaced string to identify the checkout protocol (e.g., vendor-prefixed or custom). Vendor-specific values belong under ext.{vendor}."), "supported_payment_providers": import_zod.z.array(import_zod.z.string()).describe("Payment providers supported by this checkout endpoint").optional() }).describe("Agentic checkout endpoint configuration").optional() }).catchall(import_zod.z.any()).describe("Product catalog for e-commerce brands").optional(), "privacy_policy_url": import_zod.z.string().url().describe("URL to the brand's privacy policy").optional(), "data_subject_contestation": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to a human-accessible contestation form or information page.").optional(), "email": import_zod.z.string().email().describe("Email address for contestation requests. Deployer MUST monitor and respond within the timelines set by applicable law (e.g., 1 month under GDPR Art. 12(3)).").optional(), "languages": import_zod.z.array(import_zod.z.string()).describe("BCP 47 language tags the contestation channel supports (e.g., ['en', 'de', 'fr']). At minimum SHOULD include a language spoken in every jurisdiction where the brand runs regulated-vertical campaigns.").optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("Contact point where a data subject can request human intervention, express their view, or contest an automated decision \u2014 satisfying GDPR Article 22(3) and EU AI Act Article 26(11) transparency obligations. This is a contact reference (URL, email, or both), not a machine-callable API. AdCP surfaces the pointer; the deployer runs the contestation workflow.").optional(), "disclaimers": import_zod.z.array(import_zod.z.object({ "text": import_zod.z.string(), "context": import_zod.z.string().optional(), "required": import_zod.z.boolean().default(true) })).describe("Legal disclaimers for creatives").optional(), "trademarks": import_zod.z.array(import_zod.z.object({ "registry": import_zod.z.string().describe("Trademark registry (e.g., 'USPTO', 'EUIPO', 'JPO', 'CNIPA')"), "number": import_zod.z.string().describe("Registration number as issued by the registry"), "mark": import_zod.z.string().describe("The registered mark as published"), "status": import_zod.z.enum(["active", "pending", "abandoned", "cancelled", "expired"]).describe("Registration status. Omit for active marks if status tracking is not maintained.").optional(), "license_type": import_zod.z.enum(["owned", "licensed_in", "licensed_out"]).describe("Whether the publisher owns the mark, licenses it from another entity, or licenses it to others. 'owned' is the default if omitted.").optional(), "licensor_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain of the entity that licenses this mark to the publisher. Meaningful when license_type=licensed_in; omit otherwise.").optional(), "countries": import_zod.z.array(import_zod.z.string().min(2).max(2)).describe("ISO 3166-1 alpha-2 country codes where this registration applies. Omit for global or where the registry's jurisdiction is implicit.").optional(), "nice_classes": import_zod.z.array(import_zod.z.number().int().gte(1).lte(45)).describe("Nice Classification class numbers (1-45) covered by this registration. Disambiguates marks across industries (e.g., Delta-airline vs Delta-faucet). Omit if scope is implicit from registry.").optional() }).catchall(import_zod.z.any()).describe("A registered trademark. May appear at house level (corporate marks, e.g., 'NIKE' owned by Nike, Inc.) or at brand level (brand-specific marks, e.g., 'CONVERSE' owned by Converse). Resolution between house- and brand-level trademarks is union \u2014 both lists are valid claims about marks the publisher controls.")).describe("Brand-level registered trademarks. Use for marks the brand owns or controls (e.g., a sub-brand's own marks distinct from the corporate parent). House-level trademarks live on the house object; resolution between the two is union \u2014 both lists are valid claims.").optional(), "voice_synthesis": import_zod.z.object({ "provider": import_zod.z.string().optional(), "voice_id": import_zod.z.string().optional(), "settings": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).optional() }).catchall(import_zod.z.any()).describe("TTS voice synthesis configuration for AI-generated audio").optional(), "avatar": import_zod.z.object({ "provider": import_zod.z.string().optional(), "avatar_id": import_zod.z.string().optional(), "settings": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).optional() }).catchall(import_zod.z.any()).describe("Visual avatar configuration").optional(), "visual_guidelines": import_zod.z.object({ "photography": import_zod.z.object({ "realism": import_zod.z.enum(["natural", "stylized", "hyperreal", "abstract"]).describe("Level of photographic realism").optional(), "lighting": import_zod.z.string().describe("Lighting style (e.g., 'soft daylight', 'studio', 'golden hour', 'high-key', 'low-key')").optional(), "color_temperature": import_zod.z.enum(["warm", "neutral", "cool"]).describe("Overall color temperature of photography").optional(), "contrast": import_zod.z.enum(["low", "medium", "high"]).describe("Contrast level in photography").optional(), "depth_of_field": import_zod.z.enum(["shallow", "medium", "deep"]).describe("Depth of field preference. shallow: blurred background with subject isolation, deep: everything in focus").optional(), "subject": import_zod.z.object({ "people": import_zod.z.object({ "age_range": import_zod.z.string().describe("Target age range (e.g., '20-35')").optional(), "diversity": import_zod.z.string().describe("Diversity representation (e.g., 'mixed', 'varied')").optional(), "mood": import_zod.z.array(import_zod.z.string()).describe("Mood descriptors (e.g., ['confident', 'relaxed'])").optional() }).catchall(import_zod.z.any()).describe("People photography guidelines").optional(), "product_focus": import_zod.z.enum(["in-use", "isolated", "lifestyle", "detail"]).describe("How products are shown").optional(), "setting": import_zod.z.string().describe("Environmental context for photography (e.g., 'indoor', 'outdoor', 'studio', 'urban', 'nature', 'workplace')").optional() }).catchall(import_zod.z.any()).describe("Subject matter guidelines").optional(), "framing": import_zod.z.object({ "subject_position": import_zod.z.string().describe("Where the subject sits in frame (e.g., 'center', 'center-left', 'rule-of-thirds')").optional(), "crop_style": import_zod.z.string().describe("Cropping convention (e.g., 'waist-up', 'full-body', 'close-up', 'wide')").optional(), "perspective": import_zod.z.string().describe("Camera perspective (e.g., 'eye-level', 'overhead', 'low-angle')").optional() }).catchall(import_zod.z.any()).describe("Camera framing rules").optional(), "preferred_aspect_ratios": import_zod.z.array(import_zod.z.string().regex(new RegExp("^\\d+:\\d+$"))).describe("Preferred aspect ratios for brand photography (e.g., '16:9', '4:5', '1:1')").optional(), "tags": import_zod.z.array(import_zod.z.string()).describe("Additional style descriptors").optional() }).catchall(import_zod.z.any()).describe("Photography style rules for generative creative systems. Defines how brand photography should look when selected or generated.").optional(), "graphic_style": import_zod.z.object({ "style_type": import_zod.z.enum(["flat_illustration", "geometric", "gradient_mesh", "editorial_collage", "hand_drawn", "minimal_line_art", "3d_render", "isometric", "photographic_composite"]).describe("Primary graphic style").optional(), "stroke_style": import_zod.z.enum(["rounded", "square", "mixed", "none"]).describe("Stroke end/join style").optional(), "stroke_weight": import_zod.z.string().describe("Stroke weight (e.g., '2px', 'thin', 'bold')").optional(), "corner_radius": import_zod.z.string().describe("Default corner radius for graphic and illustration elements (e.g., '12px', '8px', 'sharp'). For UI component radii (buttons, cards, inputs), see visual_guidelines.border_radius.").optional(), "tags": import_zod.z.array(import_zod.z.string()).describe("Additional style descriptors").optional() }).catchall(import_zod.z.any()).describe("Visual language for brand graphics and illustrations").optional(), "shapes": import_zod.z.object({ "primary_shape": import_zod.z.string().describe("Primary brand shape (e.g., 'rounded_rectangle', 'circle', 'hexagon')").optional(), "secondary_shapes": import_zod.z.array(import_zod.z.string()).describe("Secondary shapes in the brand vocabulary").optional(), "usage": import_zod.z.object({ "max_per_layout": import_zod.z.number().int().describe("Maximum distinct shapes per layout").optional(), "overlap_allowed": import_zod.z.boolean().describe("Whether shapes may overlap").optional() }).catchall(import_zod.z.any()).describe("Shape usage rules").optional() }).catchall(import_zod.z.any()).describe("Distinctive shapes used as part of brand visual identity").optional(), "iconography": import_zod.z.object({ "style": import_zod.z.enum(["outline", "filled", "duotone", "flat", "glyph", "hand_drawn"]).describe("Icon rendering style").optional(), "stroke_weight": import_zod.z.string().describe("Icon stroke weight (e.g., '2px', '1.5px')").optional(), "corner_style": import_zod.z.enum(["rounded", "square", "mixed"]).describe("Corner style for icon paths").optional(), "usage": import_zod.z.object({ "max_per_frame": import_zod.z.number().int().describe("Maximum icons per creative frame").optional(), "size_ratio": import_zod.z.string().describe("Icon-to-layout size ratio (e.g., '1:8')").optional() }).catchall(import_zod.z.any()).describe("Icon usage rules").optional() }).catchall(import_zod.z.any()).describe("Icon style system and usage rules").optional(), "composition": import_zod.z.object({ "overlays": import_zod.z.object({ "gradient_style": import_zod.z.enum(["linear", "radial", "conic", "none"]).describe("Gradient type for overlays").optional(), "gradient_direction": import_zod.z.string().describe("Gradient direction (e.g., '45deg', 'to-bottom-right')").optional(), "opacity": import_zod.z.string().describe("Overlay opacity (e.g., '70%')").optional() }).catchall(import_zod.z.any()).describe("Graphic overlay rules").optional(), "texture": import_zod.z.object({ "style": import_zod.z.enum(["none", "subtle_grain", "noise", "paper", "fabric", "concrete"]).describe("Texture style applied to creative assets").optional(), "intensity": import_zod.z.enum(["low", "medium", "high"]).describe("Texture intensity").optional() }).catchall(import_zod.z.any()).describe("Texture treatment rules").optional(), "backgrounds": import_zod.z.object({ "types_allowed": import_zod.z.array(import_zod.z.enum(["solid_color", "gradient", "blurred_photo", "image", "video", "pattern", "transparent"])).describe("Permitted background types").optional() }).catchall(import_zod.z.any()).describe("Background treatment rules").optional() }).catchall(import_zod.z.any()).describe("Layout composition rules including overlays, textures, and backgrounds").optional(), "border_radius": import_zod.z.object({ "none": import_zod.z.string().describe("Explicitly sharp corners (e.g., '0')").optional(), "default": import_zod.z.string().describe("Default border radius for UI components (e.g., '8px', '12px', '0'). For graphic/illustration elements, see graphic_style.corner_radius.").optional(), "small": import_zod.z.string().describe("Small border radius for compact elements (e.g., '4px')").optional(), "large": import_zod.z.string().describe("Large border radius for cards and containers (e.g., '16px', '24px')").optional(), "pill": import_zod.z.string().describe("Fully rounded / pill shape (e.g., '999px')").optional() }).catchall(import_zod.z.string()).describe("Named border radius presets for UI components and layout elements. One of the most visible brand differentiators \u2014 Airbnb uses generous 20px, Stripe uses precise 4\u20138px, Spotify uses pill/999px.").optional(), "elevation": import_zod.z.object({ "none": import_zod.z.string().describe("No shadow (e.g., 'none')").optional(), "subtle": import_zod.z.string().describe("Subtle shadow for slight lift (e.g., '0 1px 2px rgba(0,0,0,0.05)')").optional(), "card": import_zod.z.string().describe("Card-level shadow (e.g., '0 4px 6px -1px rgba(0,0,0,0.1), 0 2px 4px -2px rgba(0,0,0,0.1)')").optional(), "modal": import_zod.z.string().describe("Modal/overlay shadow (e.g., '0 20px 25px -5px rgba(0,0,0,0.1), 0 8px 10px -6px rgba(0,0,0,0.1)')").optional() }).catchall(import_zod.z.string()).describe("Named shadow/elevation levels. Brands use elevation as identity \u2014 from Stripe's blue-tinted multi-layer shadows to Apple's single diffuse shadow. Values are CSS box-shadow syntax.").optional(), "spacing": import_zod.z.object({ "unit": import_zod.z.string().describe("Base grid unit this scale was designed from (e.g., '8px', '4px'). Informational \u2014 agents should use the named scale values, not compute from this.").optional(), "scale": import_zod.z.object({ "xs": import_zod.z.string().describe("Extra small spacing (e.g., '4px')").optional(), "sm": import_zod.z.string().describe("Small spacing (e.g., '8px')").optional(), "md": import_zod.z.string().describe("Medium spacing (e.g., '16px')").optional(), "lg": import_zod.z.string().describe("Large spacing (e.g., '24px')").optional(), "xl": import_zod.z.string().describe("Extra large spacing (e.g., '32px')").optional(), "2xl": import_zod.z.string().describe("Section-level spacing (e.g., '48px', '64px')").optional() }).catchall(import_zod.z.string()).describe("Named spacing scale built from the base unit").optional() }).strict().describe("Spacing system for consistent layout rhythm. Most design systems use an 8px base grid.").optional(), "graphic_elements": import_zod.z.array(import_zod.z.object({ "name": import_zod.z.string().describe("Element name (e.g., 'Paper Tear', 'Brand Watermark', 'Section Divider')"), "type": import_zod.z.enum(["border", "divider", "frame", "watermark", "pattern", "texture_overlay", "decorative"]).describe("Element type").optional(), "description": import_zod.z.string().describe("How the element is used in layouts").optional(), "orientation": import_zod.z.enum(["horizontal", "vertical", "any"]).describe("Preferred orientation when used in layouts").optional(), "colors": import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value")).describe("Colors this element may appear in").optional(), "max_per_layout": import_zod.z.number().int().describe("Maximum instances per layout").optional() }).catchall(import_zod.z.any()).describe("A reusable decorative or structural visual element that is part of the brand identity (e.g., torn paper edges, watermarks, dividers, background patterns)")).describe("Reusable decorative elements that are part of the brand visual identity (e.g., torn paper edges, watermarks, dividers)").optional(), "motion": import_zod.z.object({ "transition_style": import_zod.z.enum(["cut", "dissolve", "slide", "wipe", "zoom", "fade"]).describe("Primary transition style between scenes").optional(), "animation_speed": import_zod.z.enum(["slow", "moderate", "fast"]).describe("Overall animation pacing").optional(), "easing": import_zod.z.string().describe("Default easing function (e.g., 'ease-in-out', 'spring', 'linear')").optional(), "text_entrance": import_zod.z.enum(["fade", "typewriter", "slide_up", "slide_left", "scale", "none"]).describe("How text enters the frame").optional(), "pacing": import_zod.z.enum(["lingering", "moderate", "fast_cuts"]).describe("Overall editing rhythm").optional(), "kinetic_typography": import_zod.z.boolean().describe("Whether animated/kinetic typography is allowed").optional(), "tags": import_zod.z.array(import_zod.z.string()).describe("Additional motion style descriptors").optional() }).catchall(import_zod.z.any()).describe("Motion and animation rules for video, animated display, and interactive formats").optional(), "logo_placement": import_zod.z.object({ "preferred_position": import_zod.z.enum(["top-left", "top-center", "top-right", "bottom-left", "bottom-center", "bottom-right", "center"]).describe("Preferred logo position in layouts").optional(), "min_clear_space": import_zod.z.string().describe("Minimum clear space around the logo, expressed as a multiple of logo height (e.g., '0.5x', '1x') or fixed value (e.g., '16px')").optional(), "min_height": import_zod.z.string().describe("Minimum logo height to maintain legibility (e.g., '40px', '24px')").optional(), "background_contrast": import_zod.z.enum(["light_only", "dark_only", "any"]).describe("Permitted background contrast behind logo").optional() }).catchall(import_zod.z.any()).describe("Logo placement and clear space rules for automated creative production").optional(), "colorways": import_zod.z.array(import_zod.z.object({ "name": import_zod.z.string().describe("Colorway name (e.g., 'primary', 'inverted', 'subtle')"), "foreground": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value"), "background": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value"), "accent": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value").optional(), "border": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value").optional(), "cta_foreground": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("CTA text/icon color, if different from foreground").optional(), "cta_background": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("CTA button/container color, if different from accent").optional(), "channels": import_zod.z.array(import_zod.z.string()).describe("Channels or contexts where this colorway applies (e.g., 'online', 'print', 'pos', 'social', 'outdoor'). Omit for universal colorways.").optional() }).catchall(import_zod.z.any()).describe("A named color pairing that defines how colors work together. Colorways ensure foreground/background combinations are always on-brand and accessible.")).describe("Named color pairings for consistent foreground/background combinations").optional(), "color_constraints": import_zod.z.array(import_zod.z.object({ "color": import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Color role or value this constraint governs."), "applies_to": import_zod.z.array(import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"])).describe("Surfaces where this color may be used.").optional(), "allowed_on": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Backgrounds, surfaces, or color roles where this color is allowed.").optional(), "forbidden_on": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Backgrounds, surfaces, or color roles where this color is forbidden.").optional(), "never_pair_with": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Color roles or values that must not be paired with this color.").optional(), "contexts": import_zod.z.array(import_zod.z.string()).describe("Channels or creative contexts where this constraint applies, such as digital, print, social, or ctv_end_card.").optional(), "severity": import_zod.z.enum(["must", "should"]).describe("Strength of a machine-readable brand guideline constraint.").optional(), "description": import_zod.z.string().describe("Human-readable rationale or source-language summary for the rule.").optional() }).catchall(import_zod.z.any()).describe("Machine-readable rule constraining how a brand color may be used or paired. Use for accent-only colors, forbidden foreground/background combinations, and palette pairs that should never appear together.")).describe("Machine-readable constraints for color usage and pairings, such as accent-only rules or forbidden foreground/background combinations.").optional(), "logo_usage_rules": import_zod.z.array(import_zod.z.object({ "logo_url": import_zod.z.string().url().describe("Specific logo asset URL this rule applies to. Omit when the rule applies by variant or tags.").optional(), "logo_id": import_zod.z.string().regex(new RegExp("^[a-z0-9][a-z0-9_-]*$")).describe("Stable `logos[].id` this rule applies to. Prefer this over logo_url when the rule targets a specific logo entry.").optional(), "logo_variant": import_zod.z.enum(["primary", "secondary", "icon", "wordmark", "full-lockup"]).describe("Logo variant this rule applies to.").optional(), "logo_tags": import_zod.z.array(import_zod.z.string()).describe("Logo tags this rule applies to.").optional(), "contexts": import_zod.z.array(import_zod.z.string()).describe("Creative contexts where this rule applies.").optional(), "slots": import_zod.z.array(import_zod.z.enum(["logo_card_light", "logo_card_dark", "profile_mark", "favicon", "app_icon", "social_profile_mark", "nav_header", "footer", "email_header", "watermark", "ad_end_card", "co_brand_lockup", "marketplace_listing"]).describe("Canonical renderer-facing logo slot. Use when selecting a logo variant from brand.json for a specific UI or creative placement.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Canonical renderer slots where this rule applies. Use this for deterministic logo-card, profile-mark, end-card, and lockup selection.").optional(), "minimum_size": import_zod.z.object({ "width": import_zod.z.string().describe("Minimum width, such as 48px or 12mm.").optional(), "height": import_zod.z.string().describe("Minimum height, such as 18px or 6mm.").optional() }).strict().describe("Minimum rendered size needed for legibility.").optional(), "clear_space": import_zod.z.string().describe("Minimum clear space around the logo, expressed in brand terms or units.").optional(), "allowed_backgrounds": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Background color roles, values, or surfaces where this logo may be placed.").optional(), "forbidden_backgrounds": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Background color roles, values, or surfaces where this logo must not be placed.").optional(), "forbidden_contexts": import_zod.z.array(import_zod.z.string()).describe("Contexts where this logo must not be used, such as photography_without_knockout.").optional(), "severity": import_zod.z.enum(["must", "should"]).describe("Strength of a machine-readable brand guideline constraint.").optional(), "description": import_zod.z.string().describe("Human-readable rationale or source-language summary for the rule.").optional() }).catchall(import_zod.z.any()).and(import_zod.z.union([import_zod.z.any(), import_zod.z.any(), import_zod.z.any(), import_zod.z.any(), import_zod.z.any()])).describe("Machine-readable logo selection and placement rule. Complements logos[].usage by making enforceable minimum size, clear-space, background, and context constraints queryable.")).describe("Machine-readable logo selection and placement constraints for minimum size, clear space, backgrounds, and contexts.").optional(), "mark_lockups": import_zod.z.array(import_zod.z.object({ "lockup_type": import_zod.z.enum(["co_brand", "secondary_mark", "partner", "sponsor", "program", "talent", "custom"]).describe("Type of mark relationship governed by this lockup rule."), "ordering": import_zod.z.enum(["brand_first", "partner_first", "equal", "contextual"]).describe("Required visual ordering of the brand mark relative to partner or secondary marks.").optional(), "contexts": import_zod.z.array(import_zod.z.string()).describe("Creative contexts where this lockup rule applies.").optional(), "brand_logo_id": import_zod.z.string().regex(new RegExp("^[a-z0-9][a-z0-9_-]*$")).describe("Stable `logos[].id` for the brand logo this lockup rule is anchored on.").optional(), "secondary_logo_ids": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9][a-z0-9_-]*$")).describe("Stable identifier for a logo entry within this brand.json document. Use lowercase words separated by underscores or hyphens; do not key integrations on mutable asset URLs.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Stable `logos[].id` values for secondary, program, sponsor, or partner marks governed by this lockup rule when those marks are represented in this brand.json.").optional(), "separator": import_zod.z.object({ "type": import_zod.z.enum(["none", "keyline", "space", "divider"]).describe("Separator style."), "color": import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.").optional(), "width": import_zod.z.string().describe("Separator width, such as 1px.").optional() }).catchall(import_zod.z.any()).describe("Separator between marks, when required.").optional(), "min_gap": import_zod.z.string().describe("Minimum gap between marks, expressed in brand terms or units.").optional(), "brand_min_optical_weight_ratio": import_zod.z.number().gt(0).describe("Minimum optical weight of the brand mark relative to partner marks. 1 means at least equal.").optional(), "partner_max_optical_weight_ratio": import_zod.z.number().gt(0).describe("Maximum optical weight of partner marks relative to the brand mark. 1 means no larger than the brand mark. Enforcement is at layout time, not parse time \u2014 this value signals to renderers and creative agents how much space to provision for each mark.").optional(), "severity": import_zod.z.enum(["must", "should"]).describe("Strength of a machine-readable brand guideline constraint.").optional(), "description": import_zod.z.string().describe("Human-readable rationale or source-language summary for the lockup rule.").optional() }).catchall(import_zod.z.any()).describe("Machine-readable layout constraints for co-brand, partner, sponsor, program, or secondary-mark lockups.")).describe("Machine-readable co-brand, partner, sponsor, program, or secondary-mark lockup rules.").optional(), "type_scale": import_zod.z.object({ "base_width": import_zod.z.string().describe("Reference canvas width these sizes were designed for (e.g., '1080px'). Generative systems should scale proportionally for other canvas sizes.").optional(), "heading": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional(), "subheading": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional(), "body": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional(), "caption": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional(), "cta": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional() }).catchall(import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale")).describe("Typography scale defining sizes and weights for different text roles. When sizes are in px, use base_width to indicate the reference canvas.").optional(), "asset_libraries": import_zod.z.array(import_zod.z.object({ "name": import_zod.z.string().describe("Display name of the asset library"), "type": import_zod.z.enum(["icon_set", "illustration_system", "image_library", "video_library", "template_library"]).describe("Type of asset library").optional(), "url": import_zod.z.string().url().describe("URL to the asset library (for human access)"), "description": import_zod.z.string().describe("Description of the library contents and usage").optional(), "color_guide": import_zod.z.object({ "roles": import_zod.z.array(import_zod.z.string()).describe("Named color roles used in the library (e.g., base, shadow_1, highlight_1, stroke)").optional(), "palettes": import_zod.z.array(import_zod.z.object({ "name": import_zod.z.string().describe("Palette name"), "colors": import_zod.z.record(import_zod.z.string(), import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value")).describe("Map of role names to hex color values") }).catchall(import_zod.z.any())).describe("Named color palettes mapping roles to specific colors").optional() }).catchall(import_zod.z.any()).describe("Color guide for the asset library defining roles and palettes").optional() }).catchall(import_zod.z.any()).describe("A managed asset library (icon set, illustration system, image collection). The URL is for human access; agent-facing DAM integration is under investigation.")).describe("References to managed asset libraries (icon sets, illustration systems, image collections). URLs are intended for human access; agent-facing DAM integration is under investigation.").optional(), "restrictions": import_zod.z.array(import_zod.z.string()).describe("Visual prohibitions and guardrails (e.g., 'Never use black backgrounds', 'Do not crop the logo', 'No stock photography of people on phones')").optional() }).catchall(import_zod.z.any()).describe("Structured visual rules for generative creative systems").optional(), "agents": import_zod.z.array(import_zod.z.object({ "type": import_zod.z.enum(["brand", "rights", "measurement", "governance", "creative", "sales", "buying", "signals"]).describe("Functional role of this agent"), "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Agent endpoint URL (MCP or A2A). Callers comparing a brand's declared agent URL against another value (e.g., resolving 'is this the agent that signed this artifact?' or matching against a discovery cache) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. After the publication chain and an authorized request-signing key verify, this exact entry's canonical URL is the stable Agent identity input for principal mapping; the domain, JWKS URI, kid, and key material are credential or trust facts beneath it, not the Agent identity. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).max(100).describe("Agent identifier (useful for logging, multi-tenant platforms)"), "description": import_zod.z.string().max(500).describe("Human-readable description of this agent's capabilities or scope").optional(), "jwks_uri": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL of the agent's JWKS (RFC 7517) containing public keys used to verify artifacts this agent signs or requests it sends. Verified artifacts include signed governance_context tokens (for governance agents) and RFC 9421 HTTP Signatures on outgoing requests (for any agent). When absent, verifiers MUST default to /.well-known/jwks.json on the origin of `url`. Keys are identified by `kid` in the JWS header or RFC 9421 `keyid` parameter; JWKS MAY contain multiple keys to support rotation and per-purpose separation via `key_ops` and `use`.").optional(), "available_uses": import_zod.z.array(import_zod.z.enum(["likeness", "voice", "name", "endorsement", "motion_capture", "signature", "catchphrase", "sync", "background_music", "editorial", "commercial", "ai_generated_image"]).describe("Types of rights usage that can be licensed through the brand protocol. Aligned with DDEX UseType direction for interoperability with music and media rights systems.")).describe("For rights agents: rights uses available for licensing").optional(), "right_types": import_zod.z.array(import_zod.z.enum(["talent", "character", "brand_ip", "music", "stock_media"]).describe("Categories of intellectual property rights that can be licensed through the brand protocol.")).describe("For rights agents: types of rights available").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("ISO 3166-1 alpha-2 country codes where this agent operates. Omit for global scope.").optional() }).catchall(import_zod.z.any()).describe("An agent declared by a brand or house. Each entry identifies one agent endpoint and its functional role in the advertising ecosystem.")).describe("Agents authorized to act on behalf of this brand. Consumers resolving an agent by URL use the matching brand-level entry; do not infer a type-wide override of unrelated house-level entries when multiple same-type entries exist.").optional(), "brand_agent": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Brand agent MCP endpoint URL. Callers comparing this URL against another value (e.g., resolving 'is this the brand's declared agent?' against a discovery cache) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Agent identifier (useful for logging, multi-tenant DAMs)") }).catchall(import_zod.z.any()).describe("Deprecated: use agents array with type 'brand' instead. Brand agent that provides dynamic brand data via MCP.").optional(), "rights_agent": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Rights agent MCP endpoint URL. Callers comparing this URL against another value (e.g., matching against a brand's declared rights endpoint) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Agent identifier"), "available_uses": import_zod.z.array(import_zod.z.enum(["likeness", "voice", "name", "endorsement", "motion_capture", "signature", "catchphrase", "sync", "background_music", "editorial", "commercial", "ai_generated_image"]).describe("Types of rights usage that can be licensed through the brand protocol. Aligned with DDEX UseType direction for interoperability with music and media rights systems.")).describe("Rights uses available for licensing through this agent"), "right_types": import_zod.z.array(import_zod.z.enum(["talent", "character", "brand_ip", "music", "stock_media"]).describe("Categories of intellectual property rights that can be licensed through the brand protocol.")).describe("Types of rights available").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("Countries where rights are available (ISO 3166-1 alpha-2)").optional() }).catchall(import_zod.z.any()).describe("Deprecated: use agents array with type 'rights' instead. Rights licensing agent for this brand.").optional(), "contact": import_zod.z.object({ "email": import_zod.z.string().email().describe("Contact email").optional(), "phone": import_zod.z.string().describe("Contact phone number").optional() }).describe("Brand-level contact information").optional(), "collections": import_zod.z.array(import_zod.z.object({ "collection_id": import_zod.z.string().describe("Collection identifier as used in the seller's get_products responses").optional(), "name": import_zod.z.string().describe("Human-readable collection name"), "role": import_zod.z.enum(["host", "guest", "creator", "cast", "narrator", "producer", "correspondent", "commentator", "analyst"]).describe("This person's role on the collection").optional(), "seller_agent_url": import_zod.z.string().url().describe("URL of the sales agent that sells inventory for this collection. Buyer agents can query this agent for collection products.").optional() }).catchall(import_zod.z.any())).describe("Collections this person or brand is associated with. Enables bidirectional linking: a collection's talent references brand.json via brand_url, and brand.json links back to collections.").optional() }).catchall(import_zod.z.any()).describe("A brand within a house portfolio. Combines identity (who) with creative assets (how to represent). Referenced as domain + brand_id."))).describe("Self-published brand document where the brand owns its own identity attributes. Optionally declares its house via house_domain; for trust, the named house's brand_refs[] must reciprocate (mutual assertion). Standalone brands (no parent house) omit house_domain. Hosted at the brand's own /.well-known/brand.json (or via authoritative_location indirection). See docs/brand-protocol/brand-json.mdx")]).describe("Brand identity and discovery file. Hosted at /.well-known/brand.json on house domains. Contains the full brand portfolio with identity, creative assets, and digital properties. Brands are identified by house + brand_id (like properties are identified by publisher + property_id). Supports variants: house portfolio (full brand data), brand agent (agent provides brand info via MCP), house redirect (pointer to house domain), or authoritative location redirect.");
+const BrandJsonSchema = import_zod.z.union([import_zod.z.object({ "$schema": import_zod.z.string().optional(), "authoritative_location": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL of the authoritative brand.json file"), "redirect_reason": import_zod.z.enum(["acquisition", "divestiture", "rebrand", "regional", "legacy", "consolidation", "other"]).describe("Optional structured signal indicating why this redirect was put in place. Consumers SHOULD use this to inform cache TTL decisions: 'acquisition' / 'divestiture' / 'rebrand' / 'consolidation' suggest the resolved target is in transition and consumers SHOULD shorten cache TTL until stable. 'regional' / 'legacy' suggest a stable redirect with no special cache handling needed. Free-text rationale belongs in 'note'.").optional(), "redirect_effective_at": import_zod.z.string().datetime().describe("Optional timestamp when this redirect became effective. Caches MUST treat any entry cached before this timestamp as stale and re-fetch through the redirect.").optional(), "note": import_zod.z.string().describe("Optional human-readable rationale for the redirect.").optional(), "last_updated": import_zod.z.string().datetime().optional() }).strict().describe("Redirects to a hosted brand.json file at another URL"), import_zod.z.object({ "$schema": import_zod.z.string().optional(), "house": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("House domain to fetch brand portfolio from"), "region": import_zod.z.string().regex(new RegExp("^[A-Z]{2}$")).describe("ISO 3166-1 alpha-2 country code if this is a regional domain").optional(), "redirect_reason": import_zod.z.enum(["acquisition", "divestiture", "rebrand", "regional", "legacy", "consolidation", "other"]).describe("Optional structured signal indicating why this redirect was put in place. Consumers SHOULD use this to inform cache TTL decisions: 'acquisition' / 'divestiture' / 'rebrand' / 'consolidation' suggest the resolved target is in transition and consumers SHOULD shorten cache TTL until stable. 'regional' / 'legacy' suggest a stable redirect with no special cache handling needed. Free-text rationale belongs in 'note'.").optional(), "redirect_effective_at": import_zod.z.string().datetime().describe("Optional timestamp when this redirect became effective. Caches MUST treat any entry cached before this timestamp as stale and re-fetch through the redirect.").optional(), "note": import_zod.z.string().describe("Optional human-readable rationale for the redirect.").optional(), "last_updated": import_zod.z.string().datetime().optional() }).strict().describe("Redirects to the house domain that contains the full brand portfolio"), import_zod.z.object({ "$schema": import_zod.z.string().optional(), "version": import_zod.z.string().optional(), "agents": import_zod.z.array(import_zod.z.object({ "type": import_zod.z.enum(["brand", "rights", "measurement", "governance", "creative", "sales", "buying", "signals"]).describe("Functional role of this agent"), "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Agent endpoint URL (MCP or A2A). Callers comparing a brand's declared agent URL against another value (e.g., resolving 'is this the agent that signed this artifact?' or matching against a discovery cache) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. After the publication chain and an authorized request-signing key verify, this exact entry's canonical URL is the stable Agent identity input for principal mapping; the domain, JWKS URI, kid, and key material are credential or trust facts beneath it, not the Agent identity. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).max(100).describe("Agent identifier (useful for logging, multi-tenant platforms)"), "description": import_zod.z.string().max(500).describe("Human-readable description of this agent's capabilities or scope").optional(), "jwks_uri": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL of the agent's JWKS (RFC 7517) containing public keys used to verify artifacts this agent signs or requests it sends. Verified artifacts include signed governance_context tokens (for governance agents) and RFC 9421 HTTP Signatures on outgoing requests (for any agent). When absent, verifiers MUST default to /.well-known/jwks.json on the origin of `url`. Keys are identified by `kid` in the JWS header or RFC 9421 `keyid` parameter; JWKS MAY contain multiple keys to support rotation and per-purpose separation via `key_ops` and `use`.").optional(), "available_uses": import_zod.z.array(import_zod.z.enum(["likeness", "voice", "name", "endorsement", "motion_capture", "signature", "catchphrase", "sync", "background_music", "editorial", "commercial", "ai_generated_image"]).describe("Types of rights usage that can be licensed through the brand protocol. Aligned with DDEX UseType direction for interoperability with music and media rights systems.")).describe("For rights agents: rights uses available for licensing").optional(), "right_types": import_zod.z.array(import_zod.z.enum(["talent", "character", "brand_ip", "music", "stock_media"]).describe("Categories of intellectual property rights that can be licensed through the brand protocol.")).describe("For rights agents: types of rights available").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("ISO 3166-1 alpha-2 country codes where this agent operates. Omit for global scope.").optional() }).catchall(import_zod.z.any()).describe("An agent declared by a brand or house. Each entry identifies one agent endpoint and its functional role in the advertising ecosystem.")).describe("Agents declared by this brand or house. Multiple entries with the same type are permitted when they have distinct url values, such as one endpoint URL per tenant or property scope. Agent url values MUST be unique within this array; duplicate urls are invalid because signature verifiers resolve a signing key by matching one agent url to one agents[] entry and reject ambiguous matches.").optional(), "brand_agent": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Brand agent MCP endpoint URL. Callers comparing this URL against another value (e.g., resolving 'is this the brand's declared agent?' against a discovery cache) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Agent identifier (useful for logging, multi-tenant DAMs)") }).catchall(import_zod.z.any()).describe("Reference to a brand agent that provides brand data via MCP").optional(), "contact": import_zod.z.object({ "name": import_zod.z.string().min(1).max(255), "email": import_zod.z.string().email().max(255).optional(), "domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("A valid domain name").optional() }).catchall(import_zod.z.any()).describe("Contact information").optional(), "data_subject_contestation": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to a human-accessible contestation form or information page.").optional(), "email": import_zod.z.string().email().describe("Email address for contestation requests. Deployer MUST monitor and respond within the timelines set by applicable law (e.g., 1 month under GDPR Art. 12(3)).").optional(), "languages": import_zod.z.array(import_zod.z.string()).describe("BCP 47 language tags the contestation channel supports (e.g., ['en', 'de', 'fr']). At minimum SHOULD include a language spoken in every jurisdiction where the brand runs regulated-vertical campaigns.").optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("Contact point where a data subject can request human intervention, express their view, or contest an automated decision \u2014 satisfying GDPR Article 22(3) and EU AI Act Article 26(11) transparency obligations. This is a contact reference (URL, email, or both), not a machine-callable API. AdCP surfaces the pointer; the deployer runs the contestation workflow.").optional(), "last_updated": import_zod.z.string().datetime().optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("Brand represented by agents that provide brand info via MCP"), import_zod.z.object({ "$schema": import_zod.z.string().optional(), "version": import_zod.z.string().optional(), "default_language": import_zod.z.string().regex(new RegExp("^(?:[a-z]{2,8}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[0-9]{3}))?(?:-(?:[a-z0-9]{5,8}|[0-9][a-z0-9]{3}))*(?:-[0-9a-wy-z](?:-[a-z0-9]{2,8})+)*(?:-x(?:-[a-z0-9]{1,8})+)?|x(?:-[a-z0-9]{1,8})+)$")).min(2).max(63).describe("A well-formed BCP 47 language tag used by AdCP only as language identity. Script and region may refine that identity; other valid BCP 47 subtags remain part of tag matching but do not make this a general locale-settings object. It does not determine currency, time zone, number/date formatting, market, or legal jurisdiction. The AdCP canonical wire profile requires lower-case language and variants, title-case script, and upper-case region (for example `en-US`, `zh-Hant-TW`, or `x-private`). RFC 5646 comparisons are case-insensitive and its case regularization is optional; AdCP intentionally requires this stricter single wire spelling and receivers MUST reject differently cased tags rather than silently normalizing them. The schema pattern enforces the AdCP casing profile and extension structure for commonly used tags; conforming receivers additionally validate the complete RFC 5646 grammar and registry rules. Every new AdCP field carrying BCP 47 language identity or a concrete language range MUST reference this schema instead of declaring independent string constraints.").describe("BCP 47 language tag for legacy plain-string and plain-array content in this document. Readers assume en when omitted.").default("en"), "house": import_zod.z.object({ "domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("The house's domain where brand.json is hosted"), "name": import_zod.z.string().min(1).describe("Primary display name of the house"), "names": import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged.")).describe("Localized house names including legal name, stock symbol, etc.").optional(), "architecture": import_zod.z.enum(["branded_house", "house_of_brands", "hybrid"]).describe("Brand architecture model: branded_house (Google), house_of_brands (P&G), hybrid (Nike)").optional(), "agents": import_zod.z.array(import_zod.z.object({ "type": import_zod.z.enum(["brand", "rights", "measurement", "governance", "creative", "sales", "buying", "signals"]).describe("Functional role of this agent"), "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Agent endpoint URL (MCP or A2A). Callers comparing a brand's declared agent URL against another value (e.g., resolving 'is this the agent that signed this artifact?' or matching against a discovery cache) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. After the publication chain and an authorized request-signing key verify, this exact entry's canonical URL is the stable Agent identity input for principal mapping; the domain, JWKS URI, kid, and key material are credential or trust facts beneath it, not the Agent identity. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).max(100).describe("Agent identifier (useful for logging, multi-tenant platforms)"), "description": import_zod.z.string().max(500).describe("Human-readable description of this agent's capabilities or scope").optional(), "jwks_uri": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL of the agent's JWKS (RFC 7517) containing public keys used to verify artifacts this agent signs or requests it sends. Verified artifacts include signed governance_context tokens (for governance agents) and RFC 9421 HTTP Signatures on outgoing requests (for any agent). When absent, verifiers MUST default to /.well-known/jwks.json on the origin of `url`. Keys are identified by `kid` in the JWS header or RFC 9421 `keyid` parameter; JWKS MAY contain multiple keys to support rotation and per-purpose separation via `key_ops` and `use`.").optional(), "available_uses": import_zod.z.array(import_zod.z.enum(["likeness", "voice", "name", "endorsement", "motion_capture", "signature", "catchphrase", "sync", "background_music", "editorial", "commercial", "ai_generated_image"]).describe("Types of rights usage that can be licensed through the brand protocol. Aligned with DDEX UseType direction for interoperability with music and media rights systems.")).describe("For rights agents: rights uses available for licensing").optional(), "right_types": import_zod.z.array(import_zod.z.enum(["talent", "character", "brand_ip", "music", "stock_media"]).describe("Categories of intellectual property rights that can be licensed through the brand protocol.")).describe("For rights agents: types of rights available").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("ISO 3166-1 alpha-2 country codes where this agent operates. Omit for global scope.").optional() }).catchall(import_zod.z.any()).describe("An agent declared by a brand or house. Each entry identifies one agent endpoint and its functional role in the advertising ecosystem.")).describe("House-level agents that apply to all brands unless overridden at the brand level").optional(), "data_subject_contestation": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to a human-accessible contestation form or information page.").optional(), "email": import_zod.z.string().email().describe("Email address for contestation requests. Deployer MUST monitor and respond within the timelines set by applicable law (e.g., 1 month under GDPR Art. 12(3)).").optional(), "languages": import_zod.z.array(import_zod.z.string()).describe("BCP 47 language tags the contestation channel supports (e.g., ['en', 'de', 'fr']). At minimum SHOULD include a language spoken in every jurisdiction where the brand runs regulated-vertical campaigns.").optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("House-level fallback contestation contact. Governance agents resolve in order: brand.data_subject_contestation \u2192 house.data_subject_contestation \u2192 missing (critical finding when human review required).").optional(), "identity_relying_parties": import_zod.z.array(import_zod.z.object({ "issuer": import_zod.z.object({ "domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where /.well-known/brand.json is hosted, or the brand's operating domain"), "brand_id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Brand identifier within the house portfolio. Optional for single-brand domains.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Canonical set of ISO 3166-1 alpha-2 countries for this advertiser identity. Omit for a global/default identity. Array order is not meaningful; producers MUST sort codes lexicographically before computing keys or signatures. This qualifies account identity and is not delivery targeting.").optional(), "industries": import_zod.z.array(import_zod.z.string()).describe("Inline override for the brand's industries. Useful when the caller cannot modify the brand's canonical brand.json but needs to declare industries for governance (e.g., Annex III vertical detection). brand.json remains the canonical source; when omitted here, governance agents SHOULD resolve from brand.json.").optional(), "data_subject_contestation": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).optional(), "email": import_zod.z.string().email().optional(), "languages": import_zod.z.array(import_zod.z.string()).optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("Inline override for the brand's contestation contact point. Useful when the operator does not control brand.json but needs to discharge Art 22(3) for this plan. brand.json is canonical; when omitted, governance agents resolve brand \u2192 house \u2192 missing.").optional(), "brand_kit_override": import_zod.z.object({ "logo": import_zod.z.object({ "asset_type": import_zod.z.literal("image").describe("Discriminator identifying this as an image asset. See /schemas/creative/asset-types for the registry."), "url": import_zod.z.string().url().describe("URL to the image asset"), "width": import_zod.z.number().int().gte(1).describe("Width in pixels"), "height": import_zod.z.number().int().gte(1).describe("Height in pixels"), "file_size_bytes": import_zod.z.number().int().gte(1).describe("Image file size in bytes. Required by agents that advertise a max_file_size_kb constraint.").optional(), "pixel_ratio": import_zod.z.number().gt(0).describe("Intrinsic pixels per logical render pixel (for example `2` for a 600\xD7500 image intended to render at 300\xD7250). Optional because a validator can infer the ratio when the target format declares logical dimensions. When supplied, it MUST agree with both `width / logical_width` and `height / logical_height`; it is never a substitute for the intrinsic `width` and `height` fields.").optional(), "state_id": import_zod.z.string().describe("Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one declared `states[].state_id` (semantic validators resolve it). Omit for ordinary image slots.").optional(), "breakpoint_id": import_zod.z.string().describe("Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one breakpoint declared on the selected state (semantic validators resolve it). Omit for ordinary image slots.").optional(), "focal_point": import_zod.z.array(import_zod.z.number().gte(0).lte(1)).max(2).describe("Normalized `[x, y]` coordinates (0\u20131 from top-left) of the image's visual anchor. Seller-side renderers crop toward the focal point when deriving renditions across breakpoints and aspect ratios; absent, cropping falls back to center-weighted defaults.").optional(), "format": import_zod.z.string().describe("Image file format (jpg, png, gif, webp, etc.)").optional(), "alt_text": import_zod.z.string().describe("Alternative text for accessibility").optional(), "provenance": import_zod.z.object({ "digital_source_type": import_zod.z.enum(["digital_capture", "digital_creation", "trained_algorithmic_media", "composite_with_trained_algorithmic_media", "algorithmic_media", "composite_capture", "composite_synthetic", "human_edits", "data_driven_media"]).describe("IPTC-aligned classification of AI involvement in producing this content").optional(), "synthetic_depiction": import_zod.z.boolean().describe("Assessed declaration of whether the content synthetically depicts a real or fictional person performing or appearing in a way that was generated or materially manipulated rather than captured as depicted. `true` covers both a fully synthetic performer and material manipulation of a real performer; `false` is an assessed declaration that the content does not contain such a depiction. Absence means the content has not been assessed for synthetic depiction. This field does not claim consent, legality, or independent verification, and receivers MUST NOT derive it solely from `digital_source_type`.").optional(), "ai_tool": import_zod.z.object({ "name": import_zod.z.string().describe("Name of the AI tool or model (e.g., 'DALL-E 3', 'Stable Diffusion XL', 'Gemini')"), "version": import_zod.z.string().describe("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.").optional(), "provider": import_zod.z.string().describe("Organization that provides the AI tool (e.g., 'OpenAI', 'Stability AI', 'Google')").optional() }).describe("AI system used to generate or modify this content. Aligns with IPTC 2025.1 AI metadata fields and C2PA claim_generator.").optional(), "human_oversight": import_zod.z.enum(["none", "prompt_only", "selected", "edited", "directed"]).describe("Level of human involvement in the AI-assisted creation process. Independent of `disclosure.required` \u2014 the protocol does not derive disclosure obligations from oversight level. Some regulations include carve-outs for human-edited or human-directed AI output, but those carve-outs have factual prerequisites the schema cannot evaluate. Asserting `edited` or `directed` does not by itself justify `disclosure.required: false`.").optional(), "declared_by": import_zod.z.object({ "agent_url": import_zod.z.string().url().describe("URL of the agent or service that declared this provenance").optional(), "role": import_zod.z.enum(["creator", "advertiser", "agency", "platform", "tool"]).describe("Role of the declaring party in the supply chain") }).describe("Party declaring this provenance. Identifies who attached the provenance claim, enabling receiving parties to assess trust.").optional(), "declared_at": import_zod.z.string().datetime().describe("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.").optional(), "created_time": import_zod.z.string().datetime().describe("When this content was created or generated (ISO 8601)").optional(), "c2pa": import_zod.z.object({ "manifest_url": import_zod.z.string().url().describe("URL to the C2PA manifest store for this content") }).describe("C2PA sidecar manifest reference. Links to a detached cryptographic provenance manifest for this content. Note: file-level C2PA bindings break when ad servers transcode, resize, or re-encode assets. For pipelines with intermediaries, consider embedded_provenance as the primary provenance mechanism.").optional(), "embedded_provenance": import_zod.z.array(import_zod.z.object({ "method": import_zod.z.enum(["manifest_wrapper", "provenance_markers"]).describe("How provenance data is carried within the content"), "standard": import_zod.z.string().describe("Standard the embedding conforms to, if any (e.g., 'c2pa' for C2PA Section A.7 text manifest embedding)").optional(), "provider": import_zod.z.string().describe("Organization that performed the embedding (e.g., 'Encypher', 'Digimarc'). Display label and audit context \u2014 not a wire identifier."), "verify_agent": import_zod.z.object({ "agent_url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("URL of the governance agent the buyer represents was used to embed/verify this layer. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."), "feature_id": import_zod.z.string().describe("Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `encypher.markers_present_v2`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog.").optional() }).strict().describe("Buyer's representation that this embedding can be verified by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing \u2014 the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist). MAY be omitted for self-verifiable embeddings (e.g., a C2PA text manifest with a public key the seller already trusts).").optional(), "embedded_at": import_zod.z.string().datetime().describe("When the provenance data was embedded (ISO 8601)").optional() })).describe("Provenance metadata embedded within the content stream. Each entry declares one embedding layer: structured provenance data carried inside the content itself, as distinct from sidecar references (c2pa.manifest_url). Embedded provenance survives operations that break sidecar and file-level bindings: ad-server transcoding, CMS ingestion, copy-paste, reformatting, and CDN re-encoding. For ad-tech pipelines where content passes through multiple intermediaries, embedded provenance is the reliable path for provenance that persists from declaration through delivery. This is a declaration by the embedding party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).").optional(), "watermarks": import_zod.z.array(import_zod.z.object({ "media_type": import_zod.z.enum(["audio", "image", "video", "text"]).describe("Media category of the watermarked content"), "provider": import_zod.z.string().describe("Organization that applied the watermark (e.g., 'Imatag', 'Steg.AI', 'Encypher'). Display label and audit context \u2014 not a wire identifier."), "verify_agent": import_zod.z.object({ "agent_url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("URL of the governance agent the buyer represents was used to apply/detect this watermark. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."), "feature_id": import_zod.z.string().describe("Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `imatag.watermark_detected`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog.").optional() }).strict().describe("Buyer's representation that this watermark can be detected by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing \u2014 the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist).").optional(), "c2pa_action": import_zod.z.enum(["c2pa.watermarked.bound", "c2pa.watermarked.unbound"]).describe("C2PA action classification for this watermark").optional(), "embedded_at": import_zod.z.string().datetime().describe("When the watermark was applied (ISO 8601)").optional() })).describe("Content watermarks applied to this asset. Each entry declares one watermarking layer: a content modification that encodes an identifier or fingerprint within the asset. Watermarks differ from embedded provenance: a watermark encodes an identifier (who generated it, who owns it), while embedded provenance carries or references a structured provenance record (the full chain of custody). A single asset may carry both. Aligns with C2PA action taxonomy: c2pa.watermarked.bound (watermark linked to a C2PA manifest) and c2pa.watermarked.unbound (watermark independent of any manifest). This is a declaration by the watermarking party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).").optional(), "disclosure": import_zod.z.object({ "required": import_zod.z.boolean().describe("The declaring party's claim that AI disclosure is required for this content under applicable regulations. This is a declared signal carried through the supply chain \u2014 useful as a routing and audit input \u2014 not a regulatory determination made by the protocol. Receiving parties remain responsible for their own jurisdictional analysis and should not treat `required: false` as compliance cover."), "jurisdictions": import_zod.z.array(import_zod.z.object({ "country": import_zod.z.string().describe("ISO 3166-1 alpha-2 country code (e.g., 'US', 'DE', 'CN')"), "region": import_zod.z.string().describe("Sub-national region code (e.g., 'CA' for California, 'BY' for Bavaria)").optional(), "regulation": import_zod.z.string().describe("Regulation identifier (e.g., 'eu_ai_act_article_50', 'ca_sb_942', 'cn_deep_synthesis')"), "label_text": import_zod.z.string().describe("Required disclosure label text for this jurisdiction, in the local language").optional(), "render_guidance": import_zod.z.object({ "persistence": import_zod.z.enum(["continuous", "initial", "flexible"]).describe("How long the disclosure must persist during content playback or display").optional(), "min_duration_ms": import_zod.z.number().int().gte(1).describe("Minimum display duration in milliseconds for initial persistence. Recommended when persistence is initial \u2014 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.").optional(), "positions": import_zod.z.array(import_zod.z.enum(["prominent", "footer", "audio", "subtitle", "overlay", "end_card", "pre_roll", "companion"]).describe("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.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Preferred disclosure positions in priority order. The first position a format supports should be used.").optional(), "ext": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).describe("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.").optional() }).describe("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.").optional() })).describe("Jurisdictions where disclosure obligations apply").optional() }).describe("Regulatory disclosure requirements for this content. Indicates whether AI disclosure is required and under which jurisdictions.").optional(), "verification": import_zod.z.array(import_zod.z.object({ "verified_by": import_zod.z.string().describe("Name of the verification service (e.g., 'DoubleVerify', 'Hive Moderation', 'Reality Defender')"), "verified_time": import_zod.z.string().datetime().describe("When the verification was performed (ISO 8601)").optional(), "result": import_zod.z.enum(["authentic", "ai_generated", "ai_modified", "inconclusive"]).describe("Verification outcome"), "confidence": import_zod.z.number().gte(0).lte(1).describe("Confidence score of the verification result (0.0 to 1.0)").optional(), "details_url": import_zod.z.string().url().describe("URL to the full verification report").optional() })).describe("Third-party verification or detection results for this content. Multiple services may independently evaluate the same content. Provenance is a claim \u2014 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.").optional(), "ext": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).describe("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.").optional() }).describe("Provenance metadata for this asset, overrides manifest-level provenance").optional() }).catchall(import_zod.z.any()).describe("Override logo asset.").optional(), "colors": import_zod.z.object({ "primary": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional(), "secondary": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional(), "accent": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional() }).catchall(import_zod.z.any()).describe("Override brand colors (hex strings).").optional(), "voice": import_zod.z.string().describe("Override brand-voice description for surface-composed text/audio output.").optional(), "tagline": import_zod.z.string().describe("Override tagline.").optional() }).catchall(import_zod.z.any()).describe("Inline override for brand-kit fields normally resolved from `/.well-known/brand.json` on `domain` (logo, colors, voice, tagline). Use when brand.json is missing, stale, or inappropriate for this specific call \u2014 e.g., a campaign-scoped tagline, a co-branded creative, a freshly-rebranded color palette the brand.json hasn't shipped yet. Same inline-override pattern as `industries` and `data_subject_contestation` above: brand.json is canonical, the override is per-call. Adopters needing to override fields outside this subset (`voice_attributes`, `prohibited_terms`, etc.) MUST publish a different brand.json and reference it via a different `domain` \u2014 the inline override is intentionally narrow to a small high-traffic subset.\n\n**Merge semantics (normative).** The merge is **field-level**, not whole-object replacement. Each field within `brand_kit_override` (`logo`, `colors`, `voice`, `tagline`) is evaluated independently \u2014 when a field is present on the override the override value applies; when a field is absent the brand.json value applies (or is absent if brand.json doesn't carry one either). For composite fields (`colors.primary`, `colors.secondary`, `colors.accent`), the merge is one level deeper: each color slot is evaluated independently \u2014 a producer can override `colors.primary` while still inheriting `colors.secondary` from brand.json. SDKs MUST NOT treat a present `brand_kit_override.colors` as wiping the brand.json `colors` block entirely; only the per-slot fields present in the override take precedence. Without this rule, a partial-override semantics would diverge across SDKs and produce inconsistent rendering for the same payload.").optional() }).strict().describe(`Identity issuer / attestation authority, referenced as a vendor BrandRef (e.g. {"domain": "world.org"}) \u2014 the same vendor-reference shape AdCP uses for measurement and signals vendors. The issuer's canonical domain is the anchor; it need not host a brand.json, but if it does, that is where its verifier metadata (scheme versions, verify endpoint, JWKs) lives. Issuer-agnostic: World ID, ISO 18013-5 mDL, and W3C-VC issuers all reference by domain. The relying party is namespaced by the issuer \u2014 identity is the tuple (issuer.domain, issuer.brand_id, relying_party_id), mirroring (vendor.domain, vendor.brand_id, metric_id).`), "scheme": import_zod.z.string().describe('Proof scheme and version, e.g. "world_id_v4".').optional(), "relying_party_id": import_zod.z.string().describe("The relying-party id registered with the issuer (and, for on-chain issuers like World ID, with the issuer's registry). One entity may operate many relying parties (scope=entity vs scope=property); this is the attestation's audience / linkability boundary, not an entity identifier."), "scope": import_zod.z.enum(["entity", "property"]).describe("Whether this relying_party_id is shared across the entity's properties (entity \u2192 a within-entity unique-human graph) or scoped to a single property (property \u2192 per-property pseudonyms, unlinkable across the entity).").optional() }).strict().describe("A verified-identity relying party an entity or brand operates. Used for attestation provenance in TMP Identity Match (the buyer checks a forwarded attestation's relying_party_id against the owner's published list). Issuer-agnostic; World ID is the first issuer.")).describe("Verified-identity relying parties this house/entity operates, so a buyer can verify that a forwarded TMP identity attestation's relying_party_id genuinely belongs to this entity (provenance) rather than being replayed under another owner. For network-as-RP, the network publishes its own relying_party_id here. See specs/tmp-verified-identity-attestation.md.").optional() }).catchall(import_zod.z.any()).describe("Corporate or organizational entity that owns brands"), "brands": import_zod.z.array(import_zod.z.object({ "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Brand identifier within the house. House chooses this ID."), "url": import_zod.z.string().url().describe("Primary brand URL for context and asset discovery").optional(), "identity_relying_parties": import_zod.z.array(import_zod.z.object({ "issuer": import_zod.z.object({ "domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where /.well-known/brand.json is hosted, or the brand's operating domain"), "brand_id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Brand identifier within the house portfolio. Optional for single-brand domains.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Canonical set of ISO 3166-1 alpha-2 countries for this advertiser identity. Omit for a global/default identity. Array order is not meaningful; producers MUST sort codes lexicographically before computing keys or signatures. This qualifies account identity and is not delivery targeting.").optional(), "industries": import_zod.z.array(import_zod.z.string()).describe("Inline override for the brand's industries. Useful when the caller cannot modify the brand's canonical brand.json but needs to declare industries for governance (e.g., Annex III vertical detection). brand.json remains the canonical source; when omitted here, governance agents SHOULD resolve from brand.json.").optional(), "data_subject_contestation": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).optional(), "email": import_zod.z.string().email().optional(), "languages": import_zod.z.array(import_zod.z.string()).optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("Inline override for the brand's contestation contact point. Useful when the operator does not control brand.json but needs to discharge Art 22(3) for this plan. brand.json is canonical; when omitted, governance agents resolve brand \u2192 house \u2192 missing.").optional(), "brand_kit_override": import_zod.z.object({ "logo": import_zod.z.object({ "asset_type": import_zod.z.literal("image").describe("Discriminator identifying this as an image asset. See /schemas/creative/asset-types for the registry."), "url": import_zod.z.string().url().describe("URL to the image asset"), "width": import_zod.z.number().int().gte(1).describe("Width in pixels"), "height": import_zod.z.number().int().gte(1).describe("Height in pixels"), "file_size_bytes": import_zod.z.number().int().gte(1).describe("Image file size in bytes. Required by agents that advertise a max_file_size_kb constraint.").optional(), "pixel_ratio": import_zod.z.number().gt(0).describe("Intrinsic pixels per logical render pixel (for example `2` for a 600\xD7500 image intended to render at 300\xD7250). Optional because a validator can infer the ratio when the target format declares logical dimensions. When supplied, it MUST agree with both `width / logical_width` and `height / logical_height`; it is never a substitute for the intrinsic `width` and `height` fields.").optional(), "state_id": import_zod.z.string().describe("Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one declared `states[].state_id` (semantic validators resolve it). Omit for ordinary image slots.").optional(), "breakpoint_id": import_zod.z.string().describe("Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one breakpoint declared on the selected state (semantic validators resolve it). Omit for ordinary image slots.").optional(), "focal_point": import_zod.z.array(import_zod.z.number().gte(0).lte(1)).max(2).describe("Normalized `[x, y]` coordinates (0\u20131 from top-left) of the image's visual anchor. Seller-side renderers crop toward the focal point when deriving renditions across breakpoints and aspect ratios; absent, cropping falls back to center-weighted defaults.").optional(), "format": import_zod.z.string().describe("Image file format (jpg, png, gif, webp, etc.)").optional(), "alt_text": import_zod.z.string().describe("Alternative text for accessibility").optional(), "provenance": import_zod.z.object({ "digital_source_type": import_zod.z.enum(["digital_capture", "digital_creation", "trained_algorithmic_media", "composite_with_trained_algorithmic_media", "algorithmic_media", "composite_capture", "composite_synthetic", "human_edits", "data_driven_media"]).describe("IPTC-aligned classification of AI involvement in producing this content").optional(), "synthetic_depiction": import_zod.z.boolean().describe("Assessed declaration of whether the content synthetically depicts a real or fictional person performing or appearing in a way that was generated or materially manipulated rather than captured as depicted. `true` covers both a fully synthetic performer and material manipulation of a real performer; `false` is an assessed declaration that the content does not contain such a depiction. Absence means the content has not been assessed for synthetic depiction. This field does not claim consent, legality, or independent verification, and receivers MUST NOT derive it solely from `digital_source_type`.").optional(), "ai_tool": import_zod.z.object({ "name": import_zod.z.string().describe("Name of the AI tool or model (e.g., 'DALL-E 3', 'Stable Diffusion XL', 'Gemini')"), "version": import_zod.z.string().describe("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.").optional(), "provider": import_zod.z.string().describe("Organization that provides the AI tool (e.g., 'OpenAI', 'Stability AI', 'Google')").optional() }).describe("AI system used to generate or modify this content. Aligns with IPTC 2025.1 AI metadata fields and C2PA claim_generator.").optional(), "human_oversight": import_zod.z.enum(["none", "prompt_only", "selected", "edited", "directed"]).describe("Level of human involvement in the AI-assisted creation process. Independent of `disclosure.required` \u2014 the protocol does not derive disclosure obligations from oversight level. Some regulations include carve-outs for human-edited or human-directed AI output, but those carve-outs have factual prerequisites the schema cannot evaluate. Asserting `edited` or `directed` does not by itself justify `disclosure.required: false`.").optional(), "declared_by": import_zod.z.object({ "agent_url": import_zod.z.string().url().describe("URL of the agent or service that declared this provenance").optional(), "role": import_zod.z.enum(["creator", "advertiser", "agency", "platform", "tool"]).describe("Role of the declaring party in the supply chain") }).describe("Party declaring this provenance. Identifies who attached the provenance claim, enabling receiving parties to assess trust.").optional(), "declared_at": import_zod.z.string().datetime().describe("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.").optional(), "created_time": import_zod.z.string().datetime().describe("When this content was created or generated (ISO 8601)").optional(), "c2pa": import_zod.z.object({ "manifest_url": import_zod.z.string().url().describe("URL to the C2PA manifest store for this content") }).describe("C2PA sidecar manifest reference. Links to a detached cryptographic provenance manifest for this content. Note: file-level C2PA bindings break when ad servers transcode, resize, or re-encode assets. For pipelines with intermediaries, consider embedded_provenance as the primary provenance mechanism.").optional(), "embedded_provenance": import_zod.z.array(import_zod.z.object({ "method": import_zod.z.enum(["manifest_wrapper", "provenance_markers"]).describe("How provenance data is carried within the content"), "standard": import_zod.z.string().describe("Standard the embedding conforms to, if any (e.g., 'c2pa' for C2PA Section A.7 text manifest embedding)").optional(), "provider": import_zod.z.string().describe("Organization that performed the embedding (e.g., 'Encypher', 'Digimarc'). Display label and audit context \u2014 not a wire identifier."), "verify_agent": import_zod.z.object({ "agent_url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("URL of the governance agent the buyer represents was used to embed/verify this layer. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."), "feature_id": import_zod.z.string().describe("Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `encypher.markers_present_v2`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog.").optional() }).strict().describe("Buyer's representation that this embedding can be verified by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing \u2014 the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist). MAY be omitted for self-verifiable embeddings (e.g., a C2PA text manifest with a public key the seller already trusts).").optional(), "embedded_at": import_zod.z.string().datetime().describe("When the provenance data was embedded (ISO 8601)").optional() })).describe("Provenance metadata embedded within the content stream. Each entry declares one embedding layer: structured provenance data carried inside the content itself, as distinct from sidecar references (c2pa.manifest_url). Embedded provenance survives operations that break sidecar and file-level bindings: ad-server transcoding, CMS ingestion, copy-paste, reformatting, and CDN re-encoding. For ad-tech pipelines where content passes through multiple intermediaries, embedded provenance is the reliable path for provenance that persists from declaration through delivery. This is a declaration by the embedding party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).").optional(), "watermarks": import_zod.z.array(import_zod.z.object({ "media_type": import_zod.z.enum(["audio", "image", "video", "text"]).describe("Media category of the watermarked content"), "provider": import_zod.z.string().describe("Organization that applied the watermark (e.g., 'Imatag', 'Steg.AI', 'Encypher'). Display label and audit context \u2014 not a wire identifier."), "verify_agent": import_zod.z.object({ "agent_url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("URL of the governance agent the buyer represents was used to apply/detect this watermark. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."), "feature_id": import_zod.z.string().describe("Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `imatag.watermark_detected`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog.").optional() }).strict().describe("Buyer's representation that this watermark can be detected by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing \u2014 the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist).").optional(), "c2pa_action": import_zod.z.enum(["c2pa.watermarked.bound", "c2pa.watermarked.unbound"]).describe("C2PA action classification for this watermark").optional(), "embedded_at": import_zod.z.string().datetime().describe("When the watermark was applied (ISO 8601)").optional() })).describe("Content watermarks applied to this asset. Each entry declares one watermarking layer: a content modification that encodes an identifier or fingerprint within the asset. Watermarks differ from embedded provenance: a watermark encodes an identifier (who generated it, who owns it), while embedded provenance carries or references a structured provenance record (the full chain of custody). A single asset may carry both. Aligns with C2PA action taxonomy: c2pa.watermarked.bound (watermark linked to a C2PA manifest) and c2pa.watermarked.unbound (watermark independent of any manifest). This is a declaration by the watermarking party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).").optional(), "disclosure": import_zod.z.object({ "required": import_zod.z.boolean().describe("The declaring party's claim that AI disclosure is required for this content under applicable regulations. This is a declared signal carried through the supply chain \u2014 useful as a routing and audit input \u2014 not a regulatory determination made by the protocol. Receiving parties remain responsible for their own jurisdictional analysis and should not treat `required: false` as compliance cover."), "jurisdictions": import_zod.z.array(import_zod.z.object({ "country": import_zod.z.string().describe("ISO 3166-1 alpha-2 country code (e.g., 'US', 'DE', 'CN')"), "region": import_zod.z.string().describe("Sub-national region code (e.g., 'CA' for California, 'BY' for Bavaria)").optional(), "regulation": import_zod.z.string().describe("Regulation identifier (e.g., 'eu_ai_act_article_50', 'ca_sb_942', 'cn_deep_synthesis')"), "label_text": import_zod.z.string().describe("Required disclosure label text for this jurisdiction, in the local language").optional(), "render_guidance": import_zod.z.object({ "persistence": import_zod.z.enum(["continuous", "initial", "flexible"]).describe("How long the disclosure must persist during content playback or display").optional(), "min_duration_ms": import_zod.z.number().int().gte(1).describe("Minimum display duration in milliseconds for initial persistence. Recommended when persistence is initial \u2014 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.").optional(), "positions": import_zod.z.array(import_zod.z.enum(["prominent", "footer", "audio", "subtitle", "overlay", "end_card", "pre_roll", "companion"]).describe("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.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Preferred disclosure positions in priority order. The first position a format supports should be used.").optional(), "ext": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).describe("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.").optional() }).describe("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.").optional() })).describe("Jurisdictions where disclosure obligations apply").optional() }).describe("Regulatory disclosure requirements for this content. Indicates whether AI disclosure is required and under which jurisdictions.").optional(), "verification": import_zod.z.array(import_zod.z.object({ "verified_by": import_zod.z.string().describe("Name of the verification service (e.g., 'DoubleVerify', 'Hive Moderation', 'Reality Defender')"), "verified_time": import_zod.z.string().datetime().describe("When the verification was performed (ISO 8601)").optional(), "result": import_zod.z.enum(["authentic", "ai_generated", "ai_modified", "inconclusive"]).describe("Verification outcome"), "confidence": import_zod.z.number().gte(0).lte(1).describe("Confidence score of the verification result (0.0 to 1.0)").optional(), "details_url": import_zod.z.string().url().describe("URL to the full verification report").optional() })).describe("Third-party verification or detection results for this content. Multiple services may independently evaluate the same content. Provenance is a claim \u2014 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.").optional(), "ext": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).describe("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.").optional() }).describe("Provenance metadata for this asset, overrides manifest-level provenance").optional() }).catchall(import_zod.z.any()).describe("Override logo asset.").optional(), "colors": import_zod.z.object({ "primary": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional(), "secondary": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional(), "accent": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional() }).catchall(import_zod.z.any()).describe("Override brand colors (hex strings).").optional(), "voice": import_zod.z.string().describe("Override brand-voice description for surface-composed text/audio output.").optional(), "tagline": import_zod.z.string().describe("Override tagline.").optional() }).catchall(import_zod.z.any()).describe("Inline override for brand-kit fields normally resolved from `/.well-known/brand.json` on `domain` (logo, colors, voice, tagline). Use when brand.json is missing, stale, or inappropriate for this specific call \u2014 e.g., a campaign-scoped tagline, a co-branded creative, a freshly-rebranded color palette the brand.json hasn't shipped yet. Same inline-override pattern as `industries` and `data_subject_contestation` above: brand.json is canonical, the override is per-call. Adopters needing to override fields outside this subset (`voice_attributes`, `prohibited_terms`, etc.) MUST publish a different brand.json and reference it via a different `domain` \u2014 the inline override is intentionally narrow to a small high-traffic subset.\n\n**Merge semantics (normative).** The merge is **field-level**, not whole-object replacement. Each field within `brand_kit_override` (`logo`, `colors`, `voice`, `tagline`) is evaluated independently \u2014 when a field is present on the override the override value applies; when a field is absent the brand.json value applies (or is absent if brand.json doesn't carry one either). For composite fields (`colors.primary`, `colors.secondary`, `colors.accent`), the merge is one level deeper: each color slot is evaluated independently \u2014 a producer can override `colors.primary` while still inheriting `colors.secondary` from brand.json. SDKs MUST NOT treat a present `brand_kit_override.colors` as wiping the brand.json `colors` block entirely; only the per-slot fields present in the override take precedence. Without this rule, a partial-override semantics would diverge across SDKs and produce inconsistent rendering for the same payload.").optional() }).strict().describe(`Identity issuer / attestation authority, referenced as a vendor BrandRef (e.g. {"domain": "world.org"}) \u2014 the same vendor-reference shape AdCP uses for measurement and signals vendors. The issuer's canonical domain is the anchor; it need not host a brand.json, but if it does, that is where its verifier metadata (scheme versions, verify endpoint, JWKs) lives. Issuer-agnostic: World ID, ISO 18013-5 mDL, and W3C-VC issuers all reference by domain. The relying party is namespaced by the issuer \u2014 identity is the tuple (issuer.domain, issuer.brand_id, relying_party_id), mirroring (vendor.domain, vendor.brand_id, metric_id).`), "scheme": import_zod.z.string().describe('Proof scheme and version, e.g. "world_id_v4".').optional(), "relying_party_id": import_zod.z.string().describe("The relying-party id registered with the issuer (and, for on-chain issuers like World ID, with the issuer's registry). One entity may operate many relying parties (scope=entity vs scope=property); this is the attestation's audience / linkability boundary, not an entity identifier."), "scope": import_zod.z.enum(["entity", "property"]).describe("Whether this relying_party_id is shared across the entity's properties (entity \u2192 a within-entity unique-human graph) or scoped to a single property (property \u2192 per-property pseudonyms, unlinkable across the entity).").optional() }).strict().describe("A verified-identity relying party an entity or brand operates. Used for attestation provenance in TMP Identity Match (the buyer checks a forwarded attestation's relying_party_id against the owner's published list). Issuer-agnostic; World ID is the first issuer.")).describe("Verified-identity relying parties scoped to this brand/property, for attestation provenance in TMP Identity Match. Use when a brand or property runs its own relying_party_id (per-property pseudonyms); entity-wide relying parties live on the house object. See specs/tmp-verified-identity-attestation.md.").optional(), "names": import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged.")).describe("Localized brand names. Multiple entries per language allowed for aliases."), "keller_type": import_zod.z.enum(["master", "sub_brand", "endorsed", "independent"]).describe("Brand architecture type from Keller's theory. master: primary brand of house. sub_brand: carries parent name (Nike SB). endorsed: independent identity backed by parent (Air Jordan 'by Nike'). independent: operates separately (Converse under Nike, Inc.)").optional(), "parent_brand": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Parent brand ID for sub-brands and endorsed brands").optional(), "description": import_zod.z.string().describe("Brand description").optional(), "industries": import_zod.z.array(import_zod.z.string()).describe("Brand industries (e.g., ['automotive'] or ['pharmaceutical', 'cpg'] for a consumer health company). Describes what the company does \u2014 not what regulatory regimes apply (use policy_categories for that).").optional(), "target_audience": import_zod.z.string().describe("Primary target audience").optional(), "logos": import_zod.z.array(import_zod.z.object({ "id": import_zod.z.string().regex(new RegExp("^[a-z0-9][a-z0-9_-]*$")).describe("Stable identifier for this logo entry. Recommended when logo usage rules or mark lockups need to bind to a specific logo asset.").optional(), "url": import_zod.z.string().url().describe("URL to the logo asset"), "orientation": import_zod.z.enum(["square", "horizontal", "vertical", "stacked"]).describe("Logo aspect ratio orientation. square: ~1:1, horizontal: wide, vertical: tall, stacked: vertically arranged elements").optional(), "background": import_zod.z.enum(["dark-bg", "light-bg", "transparent-bg"]).describe("Background compatibility. dark-bg: use on dark backgrounds, light-bg: use on light backgrounds, transparent-bg: has transparent background").optional(), "variant": import_zod.z.enum(["primary", "secondary", "icon", "wordmark", "full-lockup"]).describe("Logo variant type. primary: main logo, secondary: alternative, icon: symbol only, wordmark: text only, full-lockup: complete logo").optional(), "tags": import_zod.z.array(import_zod.z.string()).describe("Additional semantic tags for custom categorization beyond the standard orientation, background, and variant fields").optional(), "slots": import_zod.z.array(import_zod.z.enum(["logo_card_light", "logo_card_dark", "profile_mark", "favicon", "app_icon", "social_profile_mark", "nav_header", "footer", "email_header", "watermark", "ad_end_card", "co_brand_lockup", "marketplace_listing"]).describe("Canonical renderer-facing logo slot. Use when selecting a logo variant from brand.json for a specific UI or creative placement.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Canonical renderer slots where this logo is appropriate. Consumers SHOULD prefer this over inferring from tags or usage prose when selecting a logo for a specific UI surface.").optional(), "usage": import_zod.z.string().describe("Human-readable description of when to use this logo variant (e.g., 'Primary logo for use on light backgrounds')").optional(), "width": import_zod.z.number().int().describe("Width in pixels").optional(), "height": import_zod.z.number().int().describe("Height in pixels").optional() }).catchall(import_zod.z.any()).describe("Brand logo asset with structured fields for orientation, background compatibility, and variant type")).describe("Brand logo assets").optional(), "colors": import_zod.z.object({ "primary": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "secondary": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "accent": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "background": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "text": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "heading": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "body": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "label": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "border": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "divider": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "surface_1": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "surface_2": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional() }).catchall(import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))])).describe("Brand color palette. Each role accepts a single hex color or an array of hex colors for brands with multiple values per role. Beyond the core five roles, brands can provide additional color roles for finer granularity \u2014 heading, body, label, border, divider, surface_1, surface_2, etc.").optional(), "fonts": import_zod.z.object({ "primary": import_zod.z.union([import_zod.z.string().describe("CSS font-family name (e.g., 'Montserrat', 'Arial, sans-serif')"), import_zod.z.object({ "family": import_zod.z.string().describe("CSS font-family name (e.g., 'Brand Sans')"), "files": import_zod.z.array(import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to the font file (WOFF2, TTF, or OTF)"), "weight": import_zod.z.number().int().gte(100).lte(900).describe("CSS numeric font-weight for static fonts (100-900)").optional(), "weight_range": import_zod.z.array(import_zod.z.number().int().gte(100).lte(900)).max(2).describe("Variable font weight axis range as [min, max] (e.g., [100, 900]). Use instead of weight for variable fonts.").optional(), "style": import_zod.z.enum(["normal", "italic", "oblique"]).describe("CSS font-style").optional() }).catchall(import_zod.z.any()).describe("A font file with weight, style, and variable font metadata")).max(36).describe("Font files for different weights and styles").optional(), "opentype_features": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9]{4}$"))).max(20).describe("OpenType feature tags to enable (e.g., ['ss01', 'tnum', 'cv01']). These are four-character tags per the OpenType spec.").optional(), "fallbacks": import_zod.z.array(import_zod.z.string().max(100)).max(10).describe("Ordered fallback font-family names for when the primary font is unavailable or does not support the required script (e.g., ['Noto Sans Arabic', 'Noto Sans SC', 'sans-serif'])").optional() }).catchall(import_zod.z.any()).describe("Structured font with family name, downloadable font files, and typographic metadata")]).describe("Primary font family").optional(), "secondary": import_zod.z.union([import_zod.z.string().describe("CSS font-family name (e.g., 'Montserrat', 'Arial, sans-serif')"), import_zod.z.object({ "family": import_zod.z.string().describe("CSS font-family name (e.g., 'Brand Sans')"), "files": import_zod.z.array(import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to the font file (WOFF2, TTF, or OTF)"), "weight": import_zod.z.number().int().gte(100).lte(900).describe("CSS numeric font-weight for static fonts (100-900)").optional(), "weight_range": import_zod.z.array(import_zod.z.number().int().gte(100).lte(900)).max(2).describe("Variable font weight axis range as [min, max] (e.g., [100, 900]). Use instead of weight for variable fonts.").optional(), "style": import_zod.z.enum(["normal", "italic", "oblique"]).describe("CSS font-style").optional() }).catchall(import_zod.z.any()).describe("A font file with weight, style, and variable font metadata")).max(36).describe("Font files for different weights and styles").optional(), "opentype_features": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9]{4}$"))).max(20).describe("OpenType feature tags to enable (e.g., ['ss01', 'tnum', 'cv01']). These are four-character tags per the OpenType spec.").optional(), "fallbacks": import_zod.z.array(import_zod.z.string().max(100)).max(10).describe("Ordered fallback font-family names for when the primary font is unavailable or does not support the required script (e.g., ['Noto Sans Arabic', 'Noto Sans SC', 'sans-serif'])").optional() }).catchall(import_zod.z.any()).describe("Structured font with family name, downloadable font files, and typographic metadata")]).describe("Secondary font family").optional() }).catchall(import_zod.z.union([import_zod.z.string().describe("CSS font-family name (e.g., 'Montserrat', 'Arial, sans-serif')"), import_zod.z.object({ "family": import_zod.z.string().describe("CSS font-family name (e.g., 'Brand Sans')"), "files": import_zod.z.array(import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to the font file (WOFF2, TTF, or OTF)"), "weight": import_zod.z.number().int().gte(100).lte(900).describe("CSS numeric font-weight for static fonts (100-900)").optional(), "weight_range": import_zod.z.array(import_zod.z.number().int().gte(100).lte(900)).max(2).describe("Variable font weight axis range as [min, max] (e.g., [100, 900]). Use instead of weight for variable fonts.").optional(), "style": import_zod.z.enum(["normal", "italic", "oblique"]).describe("CSS font-style").optional() }).catchall(import_zod.z.any()).describe("A font file with weight, style, and variable font metadata")).max(36).describe("Font files for different weights and styles").optional(), "opentype_features": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9]{4}$"))).max(20).describe("OpenType feature tags to enable (e.g., ['ss01', 'tnum', 'cv01']). These are four-character tags per the OpenType spec.").optional(), "fallbacks": import_zod.z.array(import_zod.z.string().max(100)).max(10).describe("Ordered fallback font-family names for when the primary font is unavailable or does not support the required script (e.g., ['Noto Sans Arabic', 'Noto Sans SC', 'sans-serif'])").optional() }).catchall(import_zod.z.any()).describe("Structured font with family name, downloadable font files, and typographic metadata")]).describe("A font role entry. Either a CSS font-family string (simple) or a structured object with family name and font files (rich).")).describe("Brand typography. Each key is a role name (e.g., 'primary', 'secondary') referenced by type_scale entries. Values are either a CSS font-family string or a structured object with font files for reliable resolution.").optional(), "tone": import_zod.z.union([import_zod.z.string().describe("Simple tone descriptors for backwards compatibility"), import_zod.z.object({ "voice": import_zod.z.union([import_zod.z.string(), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged."))]).describe("High-level voice descriptor, either a legacy plain string or localized values.").optional(), "attributes": import_zod.z.union([import_zod.z.array(import_zod.z.string()), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.array(import_zod.z.string())).describe("One locale mapped to a complete ordered string list. The list is selected as a unit so readers never assemble mixed-language output from independently localized elements."))]).describe("Personality traits that characterize the brand voice. Localized lists are selected as a whole.").optional(), "dos": import_zod.z.union([import_zod.z.array(import_zod.z.string()), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.array(import_zod.z.string())).describe("One locale mapped to a complete ordered string list. The list is selected as a unit so readers never assemble mixed-language output from independently localized elements."))]).describe("Guidance for copy generation - what TO do. Localized lists are selected as a whole.").optional(), "donts": import_zod.z.union([import_zod.z.array(import_zod.z.string()), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.array(import_zod.z.string())).describe("One locale mapped to a complete ordered string list. The list is selected as a unit so readers never assemble mixed-language output from independently localized elements."))]).describe("Guardrails to avoid brand violations - what NOT to do. Localized lists are selected as a whole.").optional() }).describe("Structured brand voice guidelines")]).describe("Brand voice and messaging tone guidelines").optional(), "tagline": import_zod.z.union([import_zod.z.string().describe("Plain tagline string for backwards compatibility"), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged.")).describe("Localized taglines with BCP 47 locale codes")]).describe("Brand tagline or slogan. Accepts a plain string or a localized array matching the names pattern.").optional(), "assets": import_zod.z.array(import_zod.z.object({ "asset_id": import_zod.z.string().describe("Unique identifier"), "asset_type": import_zod.z.enum(["image", "video", "audio", "text", "markdown", "html", "css", "javascript", "zip", "vast", "daast", "url", "webhook", "brief", "catalog", "published_post"]).describe("Type of asset content"), "url": import_zod.z.string().url().describe("URL to CDN-hosted asset file"), "tags": import_zod.z.array(import_zod.z.string()).describe("Tags for discovery (e.g., 'hero', 'lifestyle', 'product', 'holiday')").optional(), "name": import_zod.z.union([import_zod.z.string(), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged."))]).describe("Human-readable name, either a legacy plain string or localized values.").optional(), "description": import_zod.z.union([import_zod.z.string(), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged."))]).describe("Asset description or usage notes, either a legacy plain string or localized values.").optional(), "width": import_zod.z.number().int().describe("Image/video width in pixels").optional(), "height": import_zod.z.number().int().describe("Image/video height in pixels").optional(), "duration_seconds": import_zod.z.number().describe("Video/audio duration in seconds").optional(), "file_size_bytes": import_zod.z.number().int().describe("File size in bytes").optional(), "format": import_zod.z.string().describe("File format (e.g., 'jpg', 'mp4', 'mp3')").optional(), "metadata": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).describe("Additional asset-specific metadata").optional() }).catchall(import_zod.z.any()).describe("Brand asset (image, video, audio, text)")).describe("Brand asset library").optional(), "properties": import_zod.z.array(import_zod.z.object({ "type": import_zod.z.enum(["website", "mobile_app", "ctv_app", "desktop_app", "dooh", "podcast", "radio", "linear_tv", "streaming_audio", "ai_assistant"]).describe("Property type"), "identifier": import_zod.z.string().min(1).describe("Property identifier - domain for websites, bundle ID for apps"), "store": import_zod.z.enum(["apple", "google", "amazon", "roku", "samsung", "lg", "other"]).describe("App store for mobile/CTV apps").optional(), "region": import_zod.z.string().regex(new RegExp("^([A-Z]{2}|global)$")).describe("ISO 3166-1 alpha-2 country code or 'global'").optional(), "primary": import_zod.z.boolean().describe("Whether this is the primary property for the brand").default(false), "relationship": import_zod.z.enum(["owned", "direct", "delegated", "ad_network"]).describe("How this brand relates to the property. 'owned': the brand owns and operates this property (default) and has no adagents.json delegation_type counterpart. 'direct': the brand is the direct sales path for this property, even if a third party operates the software (e.g., a publisher's in-house ad team using a vendor's tech). 'delegated': the brand manages monetization for this property \u2014 they are in charge of ad sales (e.g., Mediavine managing a food blog). 'ad_network': the brand sells this property's inventory as part of a network or exchange \u2014 they are a path to the inventory, not the path (e.g., PubMatic as an SSP). For non-owned properties, the publisher confirms the relationship by setting the matching delegation_type on the agent's authorization in their adagents.json.").default("owned") }).catchall(import_zod.z.any()).describe("A digital property associated with a brand. Defaults to owned; use 'relationship' to declare direct, delegated, or ad_network properties. For direct, delegated, and network paths, these values match the delegation_type field in adagents.json, creating a bilateral verification chain: the operator declares the relationship here, the publisher confirms by setting the same delegation_type on the agent's authorization in their adagents.json. 'owned' is an inline ownership declaration with no adagents.json counterpart.")).describe("Digital properties associated with this brand \u2014 owned, managed, or represented").optional(), "product_catalog": import_zod.z.object({ "feed_url": import_zod.z.string().url().describe("URL to product catalog feed"), "feed_format": import_zod.z.enum(["google_merchant_center", "facebook_catalog", "shopify", "linkedin_jobs", "tiktok_shop", "pinterest_catalog", "openai_product_feed", "custom"]).describe("Format of the product feed").optional(), "categories": import_zod.z.array(import_zod.z.string()).describe("Product categories available in the catalog").optional(), "last_updated": import_zod.z.string().datetime().describe("When the product catalog was last updated").optional(), "update_frequency": import_zod.z.enum(["realtime", "hourly", "daily", "weekly"]).describe("How frequently the product catalog is updated").optional(), "agentic_checkout": import_zod.z.object({ "endpoint": import_zod.z.string().url().describe("Base URL for checkout session API"), "spec": import_zod.z.string().describe("Checkout API specification identifier. Use a namespaced string to identify the checkout protocol (e.g., vendor-prefixed or custom). Vendor-specific values belong under ext.{vendor}."), "supported_payment_providers": import_zod.z.array(import_zod.z.string()).describe("Payment providers supported by this checkout endpoint").optional() }).describe("Agentic checkout endpoint configuration").optional() }).catchall(import_zod.z.any()).describe("Product catalog for e-commerce brands").optional(), "privacy_policy_url": import_zod.z.string().url().describe("URL to the brand's privacy policy").optional(), "data_subject_contestation": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to a human-accessible contestation form or information page.").optional(), "email": import_zod.z.string().email().describe("Email address for contestation requests. Deployer MUST monitor and respond within the timelines set by applicable law (e.g., 1 month under GDPR Art. 12(3)).").optional(), "languages": import_zod.z.array(import_zod.z.string()).describe("BCP 47 language tags the contestation channel supports (e.g., ['en', 'de', 'fr']). At minimum SHOULD include a language spoken in every jurisdiction where the brand runs regulated-vertical campaigns.").optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("Contact point where a data subject can request human intervention, express their view, or contest an automated decision \u2014 satisfying GDPR Article 22(3) and EU AI Act Article 26(11) transparency obligations. This is a contact reference (URL, email, or both), not a machine-callable API. AdCP surfaces the pointer; the deployer runs the contestation workflow.").optional(), "disclaimers": import_zod.z.array(import_zod.z.object({ "text": import_zod.z.string(), "context": import_zod.z.string().optional(), "required": import_zod.z.boolean().default(true) })).describe("Legal disclaimers for creatives").optional(), "trademarks": import_zod.z.array(import_zod.z.object({ "registry": import_zod.z.string().describe("Trademark registry (e.g., 'USPTO', 'EUIPO', 'JPO', 'CNIPA')"), "number": import_zod.z.string().describe("Registration number as issued by the registry"), "mark": import_zod.z.string().describe("The registered mark as published"), "status": import_zod.z.enum(["active", "pending", "abandoned", "cancelled", "expired"]).describe("Registration status. Omit for active marks if status tracking is not maintained.").optional(), "license_type": import_zod.z.enum(["owned", "licensed_in", "licensed_out"]).describe("Whether the publisher owns the mark, licenses it from another entity, or licenses it to others. 'owned' is the default if omitted.").optional(), "licensor_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain of the entity that licenses this mark to the publisher. Meaningful when license_type=licensed_in; omit otherwise.").optional(), "countries": import_zod.z.array(import_zod.z.string().min(2).max(2)).describe("ISO 3166-1 alpha-2 country codes where this registration applies. Omit for global or where the registry's jurisdiction is implicit.").optional(), "nice_classes": import_zod.z.array(import_zod.z.number().int().gte(1).lte(45)).describe("Nice Classification class numbers (1-45) covered by this registration. Disambiguates marks across industries (e.g., Delta-airline vs Delta-faucet). Omit if scope is implicit from registry.").optional() }).catchall(import_zod.z.any()).describe("A registered trademark. May appear at house level (corporate marks, e.g., 'NIKE' owned by Nike, Inc.) or at brand level (brand-specific marks, e.g., 'CONVERSE' owned by Converse). Resolution between house- and brand-level trademarks is union \u2014 both lists are valid claims about marks the publisher controls.")).describe("Brand-level registered trademarks. Use for marks the brand owns or controls (e.g., a sub-brand's own marks distinct from the corporate parent). House-level trademarks live on the house object; resolution between the two is union \u2014 both lists are valid claims.").optional(), "voice_synthesis": import_zod.z.object({ "provider": import_zod.z.string().optional(), "voice_id": import_zod.z.string().optional(), "settings": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).optional() }).catchall(import_zod.z.any()).describe("TTS voice synthesis configuration for AI-generated audio").optional(), "avatar": import_zod.z.object({ "provider": import_zod.z.string().optional(), "avatar_id": import_zod.z.string().optional(), "settings": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).optional() }).catchall(import_zod.z.any()).describe("Visual avatar configuration").optional(), "visual_guidelines": import_zod.z.object({ "photography": import_zod.z.object({ "realism": import_zod.z.enum(["natural", "stylized", "hyperreal", "abstract"]).describe("Level of photographic realism").optional(), "lighting": import_zod.z.string().describe("Lighting style (e.g., 'soft daylight', 'studio', 'golden hour', 'high-key', 'low-key')").optional(), "color_temperature": import_zod.z.enum(["warm", "neutral", "cool"]).describe("Overall color temperature of photography").optional(), "contrast": import_zod.z.enum(["low", "medium", "high"]).describe("Contrast level in photography").optional(), "depth_of_field": import_zod.z.enum(["shallow", "medium", "deep"]).describe("Depth of field preference. shallow: blurred background with subject isolation, deep: everything in focus").optional(), "subject": import_zod.z.object({ "people": import_zod.z.object({ "age_range": import_zod.z.string().describe("Target age range (e.g., '20-35')").optional(), "diversity": import_zod.z.string().describe("Diversity representation (e.g., 'mixed', 'varied')").optional(), "mood": import_zod.z.array(import_zod.z.string()).describe("Mood descriptors (e.g., ['confident', 'relaxed'])").optional() }).catchall(import_zod.z.any()).describe("People photography guidelines").optional(), "product_focus": import_zod.z.enum(["in-use", "isolated", "lifestyle", "detail"]).describe("How products are shown").optional(), "setting": import_zod.z.string().describe("Environmental context for photography (e.g., 'indoor', 'outdoor', 'studio', 'urban', 'nature', 'workplace')").optional() }).catchall(import_zod.z.any()).describe("Subject matter guidelines").optional(), "framing": import_zod.z.object({ "subject_position": import_zod.z.string().describe("Where the subject sits in frame (e.g., 'center', 'center-left', 'rule-of-thirds')").optional(), "crop_style": import_zod.z.string().describe("Cropping convention (e.g., 'waist-up', 'full-body', 'close-up', 'wide')").optional(), "perspective": import_zod.z.string().describe("Camera perspective (e.g., 'eye-level', 'overhead', 'low-angle')").optional() }).catchall(import_zod.z.any()).describe("Camera framing rules").optional(), "preferred_aspect_ratios": import_zod.z.array(import_zod.z.string().regex(new RegExp("^\\d+:\\d+$"))).describe("Preferred aspect ratios for brand photography (e.g., '16:9', '4:5', '1:1')").optional(), "tags": import_zod.z.array(import_zod.z.string()).describe("Additional style descriptors").optional() }).catchall(import_zod.z.any()).describe("Photography style rules for generative creative systems. Defines how brand photography should look when selected or generated.").optional(), "graphic_style": import_zod.z.object({ "style_type": import_zod.z.enum(["flat_illustration", "geometric", "gradient_mesh", "editorial_collage", "hand_drawn", "minimal_line_art", "3d_render", "isometric", "photographic_composite"]).describe("Primary graphic style").optional(), "stroke_style": import_zod.z.enum(["rounded", "square", "mixed", "none"]).describe("Stroke end/join style").optional(), "stroke_weight": import_zod.z.string().describe("Stroke weight (e.g., '2px', 'thin', 'bold')").optional(), "corner_radius": import_zod.z.string().describe("Default corner radius for graphic and illustration elements (e.g., '12px', '8px', 'sharp'). For UI component radii (buttons, cards, inputs), see visual_guidelines.border_radius.").optional(), "tags": import_zod.z.array(import_zod.z.string()).describe("Additional style descriptors").optional() }).catchall(import_zod.z.any()).describe("Visual language for brand graphics and illustrations").optional(), "shapes": import_zod.z.object({ "primary_shape": import_zod.z.string().describe("Primary brand shape (e.g., 'rounded_rectangle', 'circle', 'hexagon')").optional(), "secondary_shapes": import_zod.z.array(import_zod.z.string()).describe("Secondary shapes in the brand vocabulary").optional(), "usage": import_zod.z.object({ "max_per_layout": import_zod.z.number().int().describe("Maximum distinct shapes per layout").optional(), "overlap_allowed": import_zod.z.boolean().describe("Whether shapes may overlap").optional() }).catchall(import_zod.z.any()).describe("Shape usage rules").optional() }).catchall(import_zod.z.any()).describe("Distinctive shapes used as part of brand visual identity").optional(), "iconography": import_zod.z.object({ "style": import_zod.z.enum(["outline", "filled", "duotone", "flat", "glyph", "hand_drawn"]).describe("Icon rendering style").optional(), "stroke_weight": import_zod.z.string().describe("Icon stroke weight (e.g., '2px', '1.5px')").optional(), "corner_style": import_zod.z.enum(["rounded", "square", "mixed"]).describe("Corner style for icon paths").optional(), "usage": import_zod.z.object({ "max_per_frame": import_zod.z.number().int().describe("Maximum icons per creative frame").optional(), "size_ratio": import_zod.z.string().describe("Icon-to-layout size ratio (e.g., '1:8')").optional() }).catchall(import_zod.z.any()).describe("Icon usage rules").optional() }).catchall(import_zod.z.any()).describe("Icon style system and usage rules").optional(), "composition": import_zod.z.object({ "overlays": import_zod.z.object({ "gradient_style": import_zod.z.enum(["linear", "radial", "conic", "none"]).describe("Gradient type for overlays").optional(), "gradient_direction": import_zod.z.string().describe("Gradient direction (e.g., '45deg', 'to-bottom-right')").optional(), "opacity": import_zod.z.string().describe("Overlay opacity (e.g., '70%')").optional() }).catchall(import_zod.z.any()).describe("Graphic overlay rules").optional(), "texture": import_zod.z.object({ "style": import_zod.z.enum(["none", "subtle_grain", "noise", "paper", "fabric", "concrete"]).describe("Texture style applied to creative assets").optional(), "intensity": import_zod.z.enum(["low", "medium", "high"]).describe("Texture intensity").optional() }).catchall(import_zod.z.any()).describe("Texture treatment rules").optional(), "backgrounds": import_zod.z.object({ "types_allowed": import_zod.z.array(import_zod.z.enum(["solid_color", "gradient", "blurred_photo", "image", "video", "pattern", "transparent"])).describe("Permitted background types").optional() }).catchall(import_zod.z.any()).describe("Background treatment rules").optional() }).catchall(import_zod.z.any()).describe("Layout composition rules including overlays, textures, and backgrounds").optional(), "border_radius": import_zod.z.object({ "none": import_zod.z.string().describe("Explicitly sharp corners (e.g., '0')").optional(), "default": import_zod.z.string().describe("Default border radius for UI components (e.g., '8px', '12px', '0'). For graphic/illustration elements, see graphic_style.corner_radius.").optional(), "small": import_zod.z.string().describe("Small border radius for compact elements (e.g., '4px')").optional(), "large": import_zod.z.string().describe("Large border radius for cards and containers (e.g., '16px', '24px')").optional(), "pill": import_zod.z.string().describe("Fully rounded / pill shape (e.g., '999px')").optional() }).catchall(import_zod.z.string()).describe("Named border radius presets for UI components and layout elements. One of the most visible brand differentiators \u2014 Airbnb uses generous 20px, Stripe uses precise 4\u20138px, Spotify uses pill/999px.").optional(), "elevation": import_zod.z.object({ "none": import_zod.z.string().describe("No shadow (e.g., 'none')").optional(), "subtle": import_zod.z.string().describe("Subtle shadow for slight lift (e.g., '0 1px 2px rgba(0,0,0,0.05)')").optional(), "card": import_zod.z.string().describe("Card-level shadow (e.g., '0 4px 6px -1px rgba(0,0,0,0.1), 0 2px 4px -2px rgba(0,0,0,0.1)')").optional(), "modal": import_zod.z.string().describe("Modal/overlay shadow (e.g., '0 20px 25px -5px rgba(0,0,0,0.1), 0 8px 10px -6px rgba(0,0,0,0.1)')").optional() }).catchall(import_zod.z.string()).describe("Named shadow/elevation levels. Brands use elevation as identity \u2014 from Stripe's blue-tinted multi-layer shadows to Apple's single diffuse shadow. Values are CSS box-shadow syntax.").optional(), "spacing": import_zod.z.object({ "unit": import_zod.z.string().describe("Base grid unit this scale was designed from (e.g., '8px', '4px'). Informational \u2014 agents should use the named scale values, not compute from this.").optional(), "scale": import_zod.z.object({ "xs": import_zod.z.string().describe("Extra small spacing (e.g., '4px')").optional(), "sm": import_zod.z.string().describe("Small spacing (e.g., '8px')").optional(), "md": import_zod.z.string().describe("Medium spacing (e.g., '16px')").optional(), "lg": import_zod.z.string().describe("Large spacing (e.g., '24px')").optional(), "xl": import_zod.z.string().describe("Extra large spacing (e.g., '32px')").optional(), "2xl": import_zod.z.string().describe("Section-level spacing (e.g., '48px', '64px')").optional() }).catchall(import_zod.z.string()).describe("Named spacing scale built from the base unit").optional() }).strict().describe("Spacing system for consistent layout rhythm. Most design systems use an 8px base grid.").optional(), "graphic_elements": import_zod.z.array(import_zod.z.object({ "name": import_zod.z.string().describe("Element name (e.g., 'Paper Tear', 'Brand Watermark', 'Section Divider')"), "type": import_zod.z.enum(["border", "divider", "frame", "watermark", "pattern", "texture_overlay", "decorative"]).describe("Element type").optional(), "description": import_zod.z.string().describe("How the element is used in layouts").optional(), "orientation": import_zod.z.enum(["horizontal", "vertical", "any"]).describe("Preferred orientation when used in layouts").optional(), "colors": import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value")).describe("Colors this element may appear in").optional(), "max_per_layout": import_zod.z.number().int().describe("Maximum instances per layout").optional() }).catchall(import_zod.z.any()).describe("A reusable decorative or structural visual element that is part of the brand identity (e.g., torn paper edges, watermarks, dividers, background patterns)")).describe("Reusable decorative elements that are part of the brand visual identity (e.g., torn paper edges, watermarks, dividers)").optional(), "motion": import_zod.z.object({ "transition_style": import_zod.z.enum(["cut", "dissolve", "slide", "wipe", "zoom", "fade"]).describe("Primary transition style between scenes").optional(), "animation_speed": import_zod.z.enum(["slow", "moderate", "fast"]).describe("Overall animation pacing").optional(), "easing": import_zod.z.string().describe("Default easing function (e.g., 'ease-in-out', 'spring', 'linear')").optional(), "text_entrance": import_zod.z.enum(["fade", "typewriter", "slide_up", "slide_left", "scale", "none"]).describe("How text enters the frame").optional(), "pacing": import_zod.z.enum(["lingering", "moderate", "fast_cuts"]).describe("Overall editing rhythm").optional(), "kinetic_typography": import_zod.z.boolean().describe("Whether animated/kinetic typography is allowed").optional(), "tags": import_zod.z.array(import_zod.z.string()).describe("Additional motion style descriptors").optional() }).catchall(import_zod.z.any()).describe("Motion and animation rules for video, animated display, and interactive formats").optional(), "logo_placement": import_zod.z.object({ "preferred_position": import_zod.z.enum(["top-left", "top-center", "top-right", "bottom-left", "bottom-center", "bottom-right", "center"]).describe("Preferred logo position in layouts").optional(), "min_clear_space": import_zod.z.string().describe("Minimum clear space around the logo, expressed as a multiple of logo height (e.g., '0.5x', '1x') or fixed value (e.g., '16px')").optional(), "min_height": import_zod.z.string().describe("Minimum logo height to maintain legibility (e.g., '40px', '24px')").optional(), "background_contrast": import_zod.z.enum(["light_only", "dark_only", "any"]).describe("Permitted background contrast behind logo").optional() }).catchall(import_zod.z.any()).describe("Logo placement and clear space rules for automated creative production").optional(), "colorways": import_zod.z.array(import_zod.z.object({ "name": import_zod.z.string().describe("Colorway name (e.g., 'primary', 'inverted', 'subtle')"), "foreground": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value"), "background": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value"), "accent": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value").optional(), "border": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value").optional(), "cta_foreground": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("CTA text/icon color, if different from foreground").optional(), "cta_background": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("CTA button/container color, if different from accent").optional(), "channels": import_zod.z.array(import_zod.z.string()).describe("Channels or contexts where this colorway applies (e.g., 'online', 'print', 'pos', 'social', 'outdoor'). Omit for universal colorways.").optional() }).catchall(import_zod.z.any()).describe("A named color pairing that defines how colors work together. Colorways ensure foreground/background combinations are always on-brand and accessible.")).describe("Named color pairings for consistent foreground/background combinations").optional(), "color_constraints": import_zod.z.array(import_zod.z.object({ "color": import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Color role or value this constraint governs."), "applies_to": import_zod.z.array(import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"])).describe("Surfaces where this color may be used.").optional(), "allowed_on": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Backgrounds, surfaces, or color roles where this color is allowed.").optional(), "forbidden_on": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Backgrounds, surfaces, or color roles where this color is forbidden.").optional(), "never_pair_with": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Color roles or values that must not be paired with this color.").optional(), "contexts": import_zod.z.array(import_zod.z.string()).describe("Channels or creative contexts where this constraint applies, such as digital, print, social, or ctv_end_card.").optional(), "severity": import_zod.z.enum(["must", "should"]).describe("Strength of a machine-readable brand guideline constraint.").optional(), "description": import_zod.z.string().describe("Human-readable rationale or source-language summary for the rule.").optional() }).catchall(import_zod.z.any()).describe("Machine-readable rule constraining how a brand color may be used or paired. Use for accent-only colors, forbidden foreground/background combinations, and palette pairs that should never appear together.")).describe("Machine-readable constraints for color usage and pairings, such as accent-only rules or forbidden foreground/background combinations.").optional(), "logo_usage_rules": import_zod.z.array(import_zod.z.object({ "logo_url": import_zod.z.string().url().describe("Specific logo asset URL this rule applies to. Omit when the rule applies by variant or tags.").optional(), "logo_id": import_zod.z.string().regex(new RegExp("^[a-z0-9][a-z0-9_-]*$")).describe("Stable `logos[].id` this rule applies to. Prefer this over logo_url when the rule targets a specific logo entry.").optional(), "logo_variant": import_zod.z.enum(["primary", "secondary", "icon", "wordmark", "full-lockup"]).describe("Logo variant this rule applies to.").optional(), "logo_tags": import_zod.z.array(import_zod.z.string()).describe("Logo tags this rule applies to.").optional(), "contexts": import_zod.z.array(import_zod.z.string()).describe("Creative contexts where this rule applies.").optional(), "slots": import_zod.z.array(import_zod.z.enum(["logo_card_light", "logo_card_dark", "profile_mark", "favicon", "app_icon", "social_profile_mark", "nav_header", "footer", "email_header", "watermark", "ad_end_card", "co_brand_lockup", "marketplace_listing"]).describe("Canonical renderer-facing logo slot. Use when selecting a logo variant from brand.json for a specific UI or creative placement.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Canonical renderer slots where this rule applies. Use this for deterministic logo-card, profile-mark, end-card, and lockup selection.").optional(), "minimum_size": import_zod.z.object({ "width": import_zod.z.string().describe("Minimum width, such as 48px or 12mm.").optional(), "height": import_zod.z.string().describe("Minimum height, such as 18px or 6mm.").optional() }).strict().describe("Minimum rendered size needed for legibility.").optional(), "clear_space": import_zod.z.string().describe("Minimum clear space around the logo, expressed in brand terms or units.").optional(), "allowed_backgrounds": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Background color roles, values, or surfaces where this logo may be placed.").optional(), "forbidden_backgrounds": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Background color roles, values, or surfaces where this logo must not be placed.").optional(), "forbidden_contexts": import_zod.z.array(import_zod.z.string()).describe("Contexts where this logo must not be used, such as photography_without_knockout.").optional(), "severity": import_zod.z.enum(["must", "should"]).describe("Strength of a machine-readable brand guideline constraint.").optional(), "description": import_zod.z.string().describe("Human-readable rationale or source-language summary for the rule.").optional() }).catchall(import_zod.z.any()).and(import_zod.z.union([import_zod.z.any(), import_zod.z.any(), import_zod.z.any(), import_zod.z.any(), import_zod.z.any()])).describe("Machine-readable logo selection and placement rule. Complements logos[].usage by making enforceable minimum size, clear-space, background, and context constraints queryable.")).describe("Machine-readable logo selection and placement constraints for minimum size, clear space, backgrounds, and contexts.").optional(), "mark_lockups": import_zod.z.array(import_zod.z.object({ "lockup_type": import_zod.z.enum(["co_brand", "secondary_mark", "partner", "sponsor", "program", "talent", "custom"]).describe("Type of mark relationship governed by this lockup rule."), "ordering": import_zod.z.enum(["brand_first", "partner_first", "equal", "contextual"]).describe("Required visual ordering of the brand mark relative to partner or secondary marks.").optional(), "contexts": import_zod.z.array(import_zod.z.string()).describe("Creative contexts where this lockup rule applies.").optional(), "brand_logo_id": import_zod.z.string().regex(new RegExp("^[a-z0-9][a-z0-9_-]*$")).describe("Stable `logos[].id` for the brand logo this lockup rule is anchored on.").optional(), "secondary_logo_ids": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9][a-z0-9_-]*$")).describe("Stable identifier for a logo entry within this brand.json document. Use lowercase words separated by underscores or hyphens; do not key integrations on mutable asset URLs.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Stable `logos[].id` values for secondary, program, sponsor, or partner marks governed by this lockup rule when those marks are represented in this brand.json.").optional(), "separator": import_zod.z.object({ "type": import_zod.z.enum(["none", "keyline", "space", "divider"]).describe("Separator style."), "color": import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.").optional(), "width": import_zod.z.string().describe("Separator width, such as 1px.").optional() }).catchall(import_zod.z.any()).describe("Separator between marks, when required.").optional(), "min_gap": import_zod.z.string().describe("Minimum gap between marks, expressed in brand terms or units.").optional(), "brand_min_optical_weight_ratio": import_zod.z.number().gt(0).describe("Minimum optical weight of the brand mark relative to partner marks. 1 means at least equal.").optional(), "partner_max_optical_weight_ratio": import_zod.z.number().gt(0).describe("Maximum optical weight of partner marks relative to the brand mark. 1 means no larger than the brand mark. Enforcement is at layout time, not parse time \u2014 this value signals to renderers and creative agents how much space to provision for each mark.").optional(), "severity": import_zod.z.enum(["must", "should"]).describe("Strength of a machine-readable brand guideline constraint.").optional(), "description": import_zod.z.string().describe("Human-readable rationale or source-language summary for the lockup rule.").optional() }).catchall(import_zod.z.any()).describe("Machine-readable layout constraints for co-brand, partner, sponsor, program, or secondary-mark lockups.")).describe("Machine-readable co-brand, partner, sponsor, program, or secondary-mark lockup rules.").optional(), "type_scale": import_zod.z.object({ "base_width": import_zod.z.string().describe("Reference canvas width these sizes were designed for (e.g., '1080px'). Generative systems should scale proportionally for other canvas sizes.").optional(), "heading": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional(), "subheading": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional(), "body": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional(), "caption": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional(), "cta": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional() }).catchall(import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale")).describe("Typography scale defining sizes and weights for different text roles. When sizes are in px, use base_width to indicate the reference canvas.").optional(), "asset_libraries": import_zod.z.array(import_zod.z.object({ "name": import_zod.z.string().describe("Display name of the asset library"), "type": import_zod.z.enum(["icon_set", "illustration_system", "image_library", "video_library", "template_library"]).describe("Type of asset library").optional(), "url": import_zod.z.string().url().describe("URL to the asset library (for human access)"), "description": import_zod.z.string().describe("Description of the library contents and usage").optional(), "color_guide": import_zod.z.object({ "roles": import_zod.z.array(import_zod.z.string()).describe("Named color roles used in the library (e.g., base, shadow_1, highlight_1, stroke)").optional(), "palettes": import_zod.z.array(import_zod.z.object({ "name": import_zod.z.string().describe("Palette name"), "colors": import_zod.z.record(import_zod.z.string(), import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value")).describe("Map of role names to hex color values") }).catchall(import_zod.z.any())).describe("Named color palettes mapping roles to specific colors").optional() }).catchall(import_zod.z.any()).describe("Color guide for the asset library defining roles and palettes").optional() }).catchall(import_zod.z.any()).describe("A managed asset library (icon set, illustration system, image collection). The URL is for human access; agent-facing DAM integration is under investigation.")).describe("References to managed asset libraries (icon sets, illustration systems, image collections). URLs are intended for human access; agent-facing DAM integration is under investigation.").optional(), "restrictions": import_zod.z.array(import_zod.z.string()).describe("Visual prohibitions and guardrails (e.g., 'Never use black backgrounds', 'Do not crop the logo', 'No stock photography of people on phones')").optional() }).catchall(import_zod.z.any()).describe("Structured visual rules for generative creative systems").optional(), "agents": import_zod.z.array(import_zod.z.object({ "type": import_zod.z.enum(["brand", "rights", "measurement", "governance", "creative", "sales", "buying", "signals"]).describe("Functional role of this agent"), "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Agent endpoint URL (MCP or A2A). Callers comparing a brand's declared agent URL against another value (e.g., resolving 'is this the agent that signed this artifact?' or matching against a discovery cache) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. After the publication chain and an authorized request-signing key verify, this exact entry's canonical URL is the stable Agent identity input for principal mapping; the domain, JWKS URI, kid, and key material are credential or trust facts beneath it, not the Agent identity. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).max(100).describe("Agent identifier (useful for logging, multi-tenant platforms)"), "description": import_zod.z.string().max(500).describe("Human-readable description of this agent's capabilities or scope").optional(), "jwks_uri": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL of the agent's JWKS (RFC 7517) containing public keys used to verify artifacts this agent signs or requests it sends. Verified artifacts include signed governance_context tokens (for governance agents) and RFC 9421 HTTP Signatures on outgoing requests (for any agent). When absent, verifiers MUST default to /.well-known/jwks.json on the origin of `url`. Keys are identified by `kid` in the JWS header or RFC 9421 `keyid` parameter; JWKS MAY contain multiple keys to support rotation and per-purpose separation via `key_ops` and `use`.").optional(), "available_uses": import_zod.z.array(import_zod.z.enum(["likeness", "voice", "name", "endorsement", "motion_capture", "signature", "catchphrase", "sync", "background_music", "editorial", "commercial", "ai_generated_image"]).describe("Types of rights usage that can be licensed through the brand protocol. Aligned with DDEX UseType direction for interoperability with music and media rights systems.")).describe("For rights agents: rights uses available for licensing").optional(), "right_types": import_zod.z.array(import_zod.z.enum(["talent", "character", "brand_ip", "music", "stock_media"]).describe("Categories of intellectual property rights that can be licensed through the brand protocol.")).describe("For rights agents: types of rights available").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("ISO 3166-1 alpha-2 country codes where this agent operates. Omit for global scope.").optional() }).catchall(import_zod.z.any()).describe("An agent declared by a brand or house. Each entry identifies one agent endpoint and its functional role in the advertising ecosystem.")).describe("Agents authorized to act on behalf of this brand. Consumers resolving an agent by URL use the matching brand-level entry; do not infer a type-wide override of unrelated house-level entries when multiple same-type entries exist.").optional(), "brand_agent": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Brand agent MCP endpoint URL. Callers comparing this URL against another value (e.g., resolving 'is this the brand's declared agent?' against a discovery cache) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Agent identifier (useful for logging, multi-tenant DAMs)") }).catchall(import_zod.z.any()).describe("Deprecated: use agents array with type 'brand' instead. Brand agent that provides dynamic brand data via MCP.").optional(), "rights_agent": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Rights agent MCP endpoint URL. Callers comparing this URL against another value (e.g., matching against a brand's declared rights endpoint) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Agent identifier"), "available_uses": import_zod.z.array(import_zod.z.enum(["likeness", "voice", "name", "endorsement", "motion_capture", "signature", "catchphrase", "sync", "background_music", "editorial", "commercial", "ai_generated_image"]).describe("Types of rights usage that can be licensed through the brand protocol. Aligned with DDEX UseType direction for interoperability with music and media rights systems.")).describe("Rights uses available for licensing through this agent"), "right_types": import_zod.z.array(import_zod.z.enum(["talent", "character", "brand_ip", "music", "stock_media"]).describe("Categories of intellectual property rights that can be licensed through the brand protocol.")).describe("Types of rights available").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("Countries where rights are available (ISO 3166-1 alpha-2)").optional() }).catchall(import_zod.z.any()).describe("Deprecated: use agents array with type 'rights' instead. Rights licensing agent for this brand.").optional(), "contact": import_zod.z.object({ "email": import_zod.z.string().email().describe("Contact email").optional(), "phone": import_zod.z.string().describe("Contact phone number").optional() }).describe("Brand-level contact information").optional(), "collections": import_zod.z.array(import_zod.z.object({ "collection_id": import_zod.z.string().describe("Collection identifier as used in the seller's get_products responses").optional(), "name": import_zod.z.string().describe("Human-readable collection name"), "role": import_zod.z.enum(["host", "guest", "creator", "cast", "narrator", "producer", "correspondent", "commentator", "analyst"]).describe("This person's role on the collection").optional(), "seller_agent_url": import_zod.z.string().url().describe("URL of the sales agent that sells inventory for this collection. Buyer agents can query this agent for collection products.").optional() }).catchall(import_zod.z.any())).describe("Collections this person or brand is associated with. Enables bidirectional linking: a collection's talent references brand.json via brand_url, and brand.json links back to collections.").optional() }).catchall(import_zod.z.any()).describe("A brand within a house portfolio. Combines identity (who) with creative assets (how to represent). Referenced as domain + brand_id.")).describe("Inline brands owned by this house (parent-owned data). Use for sub-brands without their own canonical document \u2014 typically those without a dedicated domain or that the holdco wants to manage centrally. A brand_id MUST NOT appear in both brands[] and brand_refs[].").optional(), "brand_refs": import_zod.z.array(import_zod.z.object({ "domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where the child's canonical brand.json lives"), "brand_id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Stable brand identifier within the house portfolio. Required so the cross-array uniqueness invariant (brand_id MUST NOT appear in both brands[] and brand_refs[]) is enforceable."), "managed_by": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Optional domain of the entity that operationally manages this brand (e.g., an agency network within a holdco). House-declared. Consumers MUST NOT use it for trust or authorization decisions. Aggregation across houses ('show me everything BBH manages') is the intended use; trust is unaffected.").optional(), "effective_at": import_zod.z.string().datetime().describe("ISO 8601 timestamp when the house established this ownership claim. Consumers age mutual-assertion edges from this date for TTL purposes and MUST NOT extend relationship trust before a future effective_at is reached. Optional; absent means the consumer ages from its own durable first observation.").optional() }).strict().describe("A house's ownership entry for a brand that publishes its own canonical brand.json elsewhere. The publisher (the house) asserts 'I own this brand, hosted at this domain, effective on this date.' Mutual-assertion trust requires the child's house_domain to reciprocate. Distinct from core/brand-ref.json (which identifies brands in media-buy plans). See docs/brand-protocol/brand-json.mdx")).describe("Portfolio entries for brands owned by this house that publish their own canonical brand.json elsewhere (child-owned data). Each entry asserts ownership plus where the child's document lives. Mutual-assertion trust: the pointed-to document's house_domain must equal this house's domain. Invariants: a brand_id MUST NOT appear in both brands[] and brand_refs[]; brand_id and domain MUST each be unique within brand_refs[]. See docs/brand-protocol/brand-json.mdx").optional(), "contact": import_zod.z.object({ "name": import_zod.z.string().min(1).max(255), "email": import_zod.z.string().email().max(255).optional(), "domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("A valid domain name").optional() }).catchall(import_zod.z.any()).describe("Contact information").optional(), "authorized_operators": import_zod.z.array(import_zod.z.object({ "domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain of the authorized operator (e.g., 'groupm.com')"), "brands": import_zod.z.array(import_zod.z.string().regex(new RegExp("^([a-z0-9_]+|\\*)$"))).describe("Brand IDs this operator is authorized for. Use ['*'] for all brands in the portfolio."), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("ISO 3166-1 alpha-2 country codes where this authorization applies. Omit for global authorization.").optional(), "scopes": import_zod.z.array(import_zod.z.enum(["all", "media_buying", "creative_generation", "rights_clearance", "governance", "measurement", "agent_operations"])).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Activities this operator is authorized to perform for the listed brands and countries. Omit for backwards-compatible broad authorization. Use ['all'] only when every listed scope is delegated.").optional(), "valid_from": import_zod.z.string().datetime().describe("ISO 8601 timestamp when this operator authorization starts. Omit when authorization is already active or the start date is not tracked.").optional(), "valid_until": import_zod.z.string().datetime().describe("ISO 8601 timestamp when this operator authorization expires. Consumers MUST treat entries at or after this timestamp as inactive for authorization decisions.").optional() }).catchall(import_zod.z.any()).describe("An entity authorized to represent brands from this house. Verified by resolving the operator's domain. Optional validity fields let houses time-box agency-of-record and delegated-operator relationships without changing historical entries.")).describe("Entities authorized to represent brands from this house. Third parties (sellers, platforms) can verify an operator's authorization by checking this list. Operators are identified by domain.").optional(), "trademarks": import_zod.z.array(import_zod.z.object({ "registry": import_zod.z.string().describe("Trademark registry (e.g., 'USPTO', 'EUIPO', 'JPO', 'CNIPA')"), "number": import_zod.z.string().describe("Registration number as issued by the registry"), "mark": import_zod.z.string().describe("The registered mark as published"), "status": import_zod.z.enum(["active", "pending", "abandoned", "cancelled", "expired"]).describe("Registration status. Omit for active marks if status tracking is not maintained.").optional(), "license_type": import_zod.z.enum(["owned", "licensed_in", "licensed_out"]).describe("Whether the publisher owns the mark, licenses it from another entity, or licenses it to others. 'owned' is the default if omitted.").optional(), "licensor_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain of the entity that licenses this mark to the publisher. Meaningful when license_type=licensed_in; omit otherwise.").optional(), "countries": import_zod.z.array(import_zod.z.string().min(2).max(2)).describe("ISO 3166-1 alpha-2 country codes where this registration applies. Omit for global or where the registry's jurisdiction is implicit.").optional(), "nice_classes": import_zod.z.array(import_zod.z.number().int().gte(1).lte(45)).describe("Nice Classification class numbers (1-45) covered by this registration. Disambiguates marks across industries (e.g., Delta-airline vs Delta-faucet). Omit if scope is implicit from registry.").optional() }).catchall(import_zod.z.any()).describe("A registered trademark. May appear at house level (corporate marks, e.g., 'NIKE' owned by Nike, Inc.) or at brand level (brand-specific marks, e.g., 'CONVERSE' owned by Converse). Resolution between house- and brand-level trademarks is union \u2014 both lists are valid claims about marks the publisher controls.")).describe("House-level (corporate) registered trademarks. Brand-level marks live on individual brand entries; resolution is union.").optional(), "last_updated": import_zod.z.string().datetime().optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("Full house/brand portfolio with hierarchy, creative assets, and properties. May carry inline brands (parent-owned, brands[]) and/or pointer brands (child-owned canonical documents, brand_refs[]). At least one of brands[] or brand_refs[] is required. A brand_id MUST NOT appear in both. See docs/brand-protocol/brand-json.mdx"), import_zod.z.record(import_zod.z.string(), import_zod.z.any()).and(import_zod.z.intersection(import_zod.z.object({ "$schema": import_zod.z.string().optional(), "version": import_zod.z.string().optional(), "default_language": import_zod.z.string().regex(new RegExp("^(?:[a-z]{2,8}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[0-9]{3}))?(?:-(?:[a-z0-9]{5,8}|[0-9][a-z0-9]{3}))*(?:-[0-9a-wy-z](?:-[a-z0-9]{2,8})+)*(?:-x(?:-[a-z0-9]{1,8})+)?|x(?:-[a-z0-9]{1,8})+)$")).min(2).max(63).describe("A well-formed BCP 47 language tag used by AdCP only as language identity. Script and region may refine that identity; other valid BCP 47 subtags remain part of tag matching but do not make this a general locale-settings object. It does not determine currency, time zone, number/date formatting, market, or legal jurisdiction. The AdCP canonical wire profile requires lower-case language and variants, title-case script, and upper-case region (for example `en-US`, `zh-Hant-TW`, or `x-private`). RFC 5646 comparisons are case-insensitive and its case regularization is optional; AdCP intentionally requires this stricter single wire spelling and receivers MUST reject differently cased tags rather than silently normalizing them. The schema pattern enforces the AdCP casing profile and extension structure for commonly used tags; conforming receivers additionally validate the complete RFC 5646 grammar and registry rules. Every new AdCP field carrying BCP 47 language identity or a concrete language range MUST reference this schema instead of declaring independent string constraints.").describe("BCP 47 language tag for legacy plain-string and plain-array content in this document. Readers assume en when omitted.").default("en"), "house_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Optional pointer to the corporate house this brand belongs to. The named house's brand_refs[] MUST reciprocate for mutual-assertion trust. Single-hop only \u2014 a brand cannot itself declare brand_refs[]. Omit for standalone brands (no house).").optional(), "last_updated": import_zod.z.string().datetime().optional() }), import_zod.z.object({ "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Brand identifier within the house. House chooses this ID."), "url": import_zod.z.string().url().describe("Primary brand URL for context and asset discovery").optional(), "identity_relying_parties": import_zod.z.array(import_zod.z.object({ "issuer": import_zod.z.object({ "domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where /.well-known/brand.json is hosted, or the brand's operating domain"), "brand_id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Brand identifier within the house portfolio. Optional for single-brand domains.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Canonical set of ISO 3166-1 alpha-2 countries for this advertiser identity. Omit for a global/default identity. Array order is not meaningful; producers MUST sort codes lexicographically before computing keys or signatures. This qualifies account identity and is not delivery targeting.").optional(), "industries": import_zod.z.array(import_zod.z.string()).describe("Inline override for the brand's industries. Useful when the caller cannot modify the brand's canonical brand.json but needs to declare industries for governance (e.g., Annex III vertical detection). brand.json remains the canonical source; when omitted here, governance agents SHOULD resolve from brand.json.").optional(), "data_subject_contestation": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).optional(), "email": import_zod.z.string().email().optional(), "languages": import_zod.z.array(import_zod.z.string()).optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("Inline override for the brand's contestation contact point. Useful when the operator does not control brand.json but needs to discharge Art 22(3) for this plan. brand.json is canonical; when omitted, governance agents resolve brand \u2192 house \u2192 missing.").optional(), "brand_kit_override": import_zod.z.object({ "logo": import_zod.z.object({ "asset_type": import_zod.z.literal("image").describe("Discriminator identifying this as an image asset. See /schemas/creative/asset-types for the registry."), "url": import_zod.z.string().url().describe("URL to the image asset"), "width": import_zod.z.number().int().gte(1).describe("Width in pixels"), "height": import_zod.z.number().int().gte(1).describe("Height in pixels"), "file_size_bytes": import_zod.z.number().int().gte(1).describe("Image file size in bytes. Required by agents that advertise a max_file_size_kb constraint.").optional(), "pixel_ratio": import_zod.z.number().gt(0).describe("Intrinsic pixels per logical render pixel (for example `2` for a 600\xD7500 image intended to render at 300\xD7250). Optional because a validator can infer the ratio when the target format declares logical dimensions. When supplied, it MUST agree with both `width / logical_width` and `height / logical_height`; it is never a substitute for the intrinsic `width` and `height` fields.").optional(), "state_id": import_zod.z.string().describe("Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one declared `states[].state_id` (semantic validators resolve it). Omit for ordinary image slots.").optional(), "breakpoint_id": import_zod.z.string().describe("Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one breakpoint declared on the selected state (semantic validators resolve it). Omit for ordinary image slots.").optional(), "focal_point": import_zod.z.array(import_zod.z.number().gte(0).lte(1)).max(2).describe("Normalized `[x, y]` coordinates (0\u20131 from top-left) of the image's visual anchor. Seller-side renderers crop toward the focal point when deriving renditions across breakpoints and aspect ratios; absent, cropping falls back to center-weighted defaults.").optional(), "format": import_zod.z.string().describe("Image file format (jpg, png, gif, webp, etc.)").optional(), "alt_text": import_zod.z.string().describe("Alternative text for accessibility").optional(), "provenance": import_zod.z.object({ "digital_source_type": import_zod.z.enum(["digital_capture", "digital_creation", "trained_algorithmic_media", "composite_with_trained_algorithmic_media", "algorithmic_media", "composite_capture", "composite_synthetic", "human_edits", "data_driven_media"]).describe("IPTC-aligned classification of AI involvement in producing this content").optional(), "synthetic_depiction": import_zod.z.boolean().describe("Assessed declaration of whether the content synthetically depicts a real or fictional person performing or appearing in a way that was generated or materially manipulated rather than captured as depicted. `true` covers both a fully synthetic performer and material manipulation of a real performer; `false` is an assessed declaration that the content does not contain such a depiction. Absence means the content has not been assessed for synthetic depiction. This field does not claim consent, legality, or independent verification, and receivers MUST NOT derive it solely from `digital_source_type`.").optional(), "ai_tool": import_zod.z.object({ "name": import_zod.z.string().describe("Name of the AI tool or model (e.g., 'DALL-E 3', 'Stable Diffusion XL', 'Gemini')"), "version": import_zod.z.string().describe("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.").optional(), "provider": import_zod.z.string().describe("Organization that provides the AI tool (e.g., 'OpenAI', 'Stability AI', 'Google')").optional() }).describe("AI system used to generate or modify this content. Aligns with IPTC 2025.1 AI metadata fields and C2PA claim_generator.").optional(), "human_oversight": import_zod.z.enum(["none", "prompt_only", "selected", "edited", "directed"]).describe("Level of human involvement in the AI-assisted creation process. Independent of `disclosure.required` \u2014 the protocol does not derive disclosure obligations from oversight level. Some regulations include carve-outs for human-edited or human-directed AI output, but those carve-outs have factual prerequisites the schema cannot evaluate. Asserting `edited` or `directed` does not by itself justify `disclosure.required: false`.").optional(), "declared_by": import_zod.z.object({ "agent_url": import_zod.z.string().url().describe("URL of the agent or service that declared this provenance").optional(), "role": import_zod.z.enum(["creator", "advertiser", "agency", "platform", "tool"]).describe("Role of the declaring party in the supply chain") }).describe("Party declaring this provenance. Identifies who attached the provenance claim, enabling receiving parties to assess trust.").optional(), "declared_at": import_zod.z.string().datetime().describe("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.").optional(), "created_time": import_zod.z.string().datetime().describe("When this content was created or generated (ISO 8601)").optional(), "c2pa": import_zod.z.object({ "manifest_url": import_zod.z.string().url().describe("URL to the C2PA manifest store for this content") }).describe("C2PA sidecar manifest reference. Links to a detached cryptographic provenance manifest for this content. Note: file-level C2PA bindings break when ad servers transcode, resize, or re-encode assets. For pipelines with intermediaries, consider embedded_provenance as the primary provenance mechanism.").optional(), "embedded_provenance": import_zod.z.array(import_zod.z.object({ "method": import_zod.z.enum(["manifest_wrapper", "provenance_markers"]).describe("How provenance data is carried within the content"), "standard": import_zod.z.string().describe("Standard the embedding conforms to, if any (e.g., 'c2pa' for C2PA Section A.7 text manifest embedding)").optional(), "provider": import_zod.z.string().describe("Organization that performed the embedding (e.g., 'Encypher', 'Digimarc'). Display label and audit context \u2014 not a wire identifier."), "verify_agent": import_zod.z.object({ "agent_url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("URL of the governance agent the buyer represents was used to embed/verify this layer. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."), "feature_id": import_zod.z.string().describe("Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `encypher.markers_present_v2`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog.").optional() }).strict().describe("Buyer's representation that this embedding can be verified by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing \u2014 the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist). MAY be omitted for self-verifiable embeddings (e.g., a C2PA text manifest with a public key the seller already trusts).").optional(), "embedded_at": import_zod.z.string().datetime().describe("When the provenance data was embedded (ISO 8601)").optional() })).describe("Provenance metadata embedded within the content stream. Each entry declares one embedding layer: structured provenance data carried inside the content itself, as distinct from sidecar references (c2pa.manifest_url). Embedded provenance survives operations that break sidecar and file-level bindings: ad-server transcoding, CMS ingestion, copy-paste, reformatting, and CDN re-encoding. For ad-tech pipelines where content passes through multiple intermediaries, embedded provenance is the reliable path for provenance that persists from declaration through delivery. This is a declaration by the embedding party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).").optional(), "watermarks": import_zod.z.array(import_zod.z.object({ "media_type": import_zod.z.enum(["audio", "image", "video", "text"]).describe("Media category of the watermarked content"), "provider": import_zod.z.string().describe("Organization that applied the watermark (e.g., 'Imatag', 'Steg.AI', 'Encypher'). Display label and audit context \u2014 not a wire identifier."), "verify_agent": import_zod.z.object({ "agent_url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("URL of the governance agent the buyer represents was used to apply/detect this watermark. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."), "feature_id": import_zod.z.string().describe("Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `imatag.watermark_detected`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog.").optional() }).strict().describe("Buyer's representation that this watermark can be detected by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing \u2014 the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist).").optional(), "c2pa_action": import_zod.z.enum(["c2pa.watermarked.bound", "c2pa.watermarked.unbound"]).describe("C2PA action classification for this watermark").optional(), "embedded_at": import_zod.z.string().datetime().describe("When the watermark was applied (ISO 8601)").optional() })).describe("Content watermarks applied to this asset. Each entry declares one watermarking layer: a content modification that encodes an identifier or fingerprint within the asset. Watermarks differ from embedded provenance: a watermark encodes an identifier (who generated it, who owns it), while embedded provenance carries or references a structured provenance record (the full chain of custody). A single asset may carry both. Aligns with C2PA action taxonomy: c2pa.watermarked.bound (watermark linked to a C2PA manifest) and c2pa.watermarked.unbound (watermark independent of any manifest). This is a declaration by the watermarking party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).").optional(), "disclosure": import_zod.z.object({ "required": import_zod.z.boolean().describe("The declaring party's claim that AI disclosure is required for this content under applicable regulations. This is a declared signal carried through the supply chain \u2014 useful as a routing and audit input \u2014 not a regulatory determination made by the protocol. Receiving parties remain responsible for their own jurisdictional analysis and should not treat `required: false` as compliance cover."), "jurisdictions": import_zod.z.array(import_zod.z.object({ "country": import_zod.z.string().describe("ISO 3166-1 alpha-2 country code (e.g., 'US', 'DE', 'CN')"), "region": import_zod.z.string().describe("Sub-national region code (e.g., 'CA' for California, 'BY' for Bavaria)").optional(), "regulation": import_zod.z.string().describe("Regulation identifier (e.g., 'eu_ai_act_article_50', 'ca_sb_942', 'cn_deep_synthesis')"), "label_text": import_zod.z.string().describe("Required disclosure label text for this jurisdiction, in the local language").optional(), "render_guidance": import_zod.z.object({ "persistence": import_zod.z.enum(["continuous", "initial", "flexible"]).describe("How long the disclosure must persist during content playback or display").optional(), "min_duration_ms": import_zod.z.number().int().gte(1).describe("Minimum display duration in milliseconds for initial persistence. Recommended when persistence is initial \u2014 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.").optional(), "positions": import_zod.z.array(import_zod.z.enum(["prominent", "footer", "audio", "subtitle", "overlay", "end_card", "pre_roll", "companion"]).describe("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.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Preferred disclosure positions in priority order. The first position a format supports should be used.").optional(), "ext": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).describe("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.").optional() }).describe("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.").optional() })).describe("Jurisdictions where disclosure obligations apply").optional() }).describe("Regulatory disclosure requirements for this content. Indicates whether AI disclosure is required and under which jurisdictions.").optional(), "verification": import_zod.z.array(import_zod.z.object({ "verified_by": import_zod.z.string().describe("Name of the verification service (e.g., 'DoubleVerify', 'Hive Moderation', 'Reality Defender')"), "verified_time": import_zod.z.string().datetime().describe("When the verification was performed (ISO 8601)").optional(), "result": import_zod.z.enum(["authentic", "ai_generated", "ai_modified", "inconclusive"]).describe("Verification outcome"), "confidence": import_zod.z.number().gte(0).lte(1).describe("Confidence score of the verification result (0.0 to 1.0)").optional(), "details_url": import_zod.z.string().url().describe("URL to the full verification report").optional() })).describe("Third-party verification or detection results for this content. Multiple services may independently evaluate the same content. Provenance is a claim \u2014 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.").optional(), "ext": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).describe("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.").optional() }).describe("Provenance metadata for this asset, overrides manifest-level provenance").optional() }).catchall(import_zod.z.any()).describe("Override logo asset.").optional(), "colors": import_zod.z.object({ "primary": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional(), "secondary": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional(), "accent": import_zod.z.string().regex(new RegExp("^#[0-9a-fA-F]{6}$")).optional() }).catchall(import_zod.z.any()).describe("Override brand colors (hex strings).").optional(), "voice": import_zod.z.string().describe("Override brand-voice description for surface-composed text/audio output.").optional(), "tagline": import_zod.z.string().describe("Override tagline.").optional() }).catchall(import_zod.z.any()).describe("Inline override for brand-kit fields normally resolved from `/.well-known/brand.json` on `domain` (logo, colors, voice, tagline). Use when brand.json is missing, stale, or inappropriate for this specific call \u2014 e.g., a campaign-scoped tagline, a co-branded creative, a freshly-rebranded color palette the brand.json hasn't shipped yet. Same inline-override pattern as `industries` and `data_subject_contestation` above: brand.json is canonical, the override is per-call. Adopters needing to override fields outside this subset (`voice_attributes`, `prohibited_terms`, etc.) MUST publish a different brand.json and reference it via a different `domain` \u2014 the inline override is intentionally narrow to a small high-traffic subset.\n\n**Merge semantics (normative).** The merge is **field-level**, not whole-object replacement. Each field within `brand_kit_override` (`logo`, `colors`, `voice`, `tagline`) is evaluated independently \u2014 when a field is present on the override the override value applies; when a field is absent the brand.json value applies (or is absent if brand.json doesn't carry one either). For composite fields (`colors.primary`, `colors.secondary`, `colors.accent`), the merge is one level deeper: each color slot is evaluated independently \u2014 a producer can override `colors.primary` while still inheriting `colors.secondary` from brand.json. SDKs MUST NOT treat a present `brand_kit_override.colors` as wiping the brand.json `colors` block entirely; only the per-slot fields present in the override take precedence. Without this rule, a partial-override semantics would diverge across SDKs and produce inconsistent rendering for the same payload.").optional() }).strict().describe(`Identity issuer / attestation authority, referenced as a vendor BrandRef (e.g. {"domain": "world.org"}) \u2014 the same vendor-reference shape AdCP uses for measurement and signals vendors. The issuer's canonical domain is the anchor; it need not host a brand.json, but if it does, that is where its verifier metadata (scheme versions, verify endpoint, JWKs) lives. Issuer-agnostic: World ID, ISO 18013-5 mDL, and W3C-VC issuers all reference by domain. The relying party is namespaced by the issuer \u2014 identity is the tuple (issuer.domain, issuer.brand_id, relying_party_id), mirroring (vendor.domain, vendor.brand_id, metric_id).`), "scheme": import_zod.z.string().describe('Proof scheme and version, e.g. "world_id_v4".').optional(), "relying_party_id": import_zod.z.string().describe("The relying-party id registered with the issuer (and, for on-chain issuers like World ID, with the issuer's registry). One entity may operate many relying parties (scope=entity vs scope=property); this is the attestation's audience / linkability boundary, not an entity identifier."), "scope": import_zod.z.enum(["entity", "property"]).describe("Whether this relying_party_id is shared across the entity's properties (entity \u2192 a within-entity unique-human graph) or scoped to a single property (property \u2192 per-property pseudonyms, unlinkable across the entity).").optional() }).strict().describe("A verified-identity relying party an entity or brand operates. Used for attestation provenance in TMP Identity Match (the buyer checks a forwarded attestation's relying_party_id against the owner's published list). Issuer-agnostic; World ID is the first issuer.")).describe("Verified-identity relying parties scoped to this brand/property, for attestation provenance in TMP Identity Match. Use when a brand or property runs its own relying_party_id (per-property pseudonyms); entity-wide relying parties live on the house object. See specs/tmp-verified-identity-attestation.md.").optional(), "names": import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged.")).describe("Localized brand names. Multiple entries per language allowed for aliases."), "keller_type": import_zod.z.enum(["master", "sub_brand", "endorsed", "independent"]).describe("Brand architecture type from Keller's theory. master: primary brand of house. sub_brand: carries parent name (Nike SB). endorsed: independent identity backed by parent (Air Jordan 'by Nike'). independent: operates separately (Converse under Nike, Inc.)").optional(), "parent_brand": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Parent brand ID for sub-brands and endorsed brands").optional(), "description": import_zod.z.string().describe("Brand description").optional(), "industries": import_zod.z.array(import_zod.z.string()).describe("Brand industries (e.g., ['automotive'] or ['pharmaceutical', 'cpg'] for a consumer health company). Describes what the company does \u2014 not what regulatory regimes apply (use policy_categories for that).").optional(), "target_audience": import_zod.z.string().describe("Primary target audience").optional(), "logos": import_zod.z.array(import_zod.z.object({ "id": import_zod.z.string().regex(new RegExp("^[a-z0-9][a-z0-9_-]*$")).describe("Stable identifier for this logo entry. Recommended when logo usage rules or mark lockups need to bind to a specific logo asset.").optional(), "url": import_zod.z.string().url().describe("URL to the logo asset"), "orientation": import_zod.z.enum(["square", "horizontal", "vertical", "stacked"]).describe("Logo aspect ratio orientation. square: ~1:1, horizontal: wide, vertical: tall, stacked: vertically arranged elements").optional(), "background": import_zod.z.enum(["dark-bg", "light-bg", "transparent-bg"]).describe("Background compatibility. dark-bg: use on dark backgrounds, light-bg: use on light backgrounds, transparent-bg: has transparent background").optional(), "variant": import_zod.z.enum(["primary", "secondary", "icon", "wordmark", "full-lockup"]).describe("Logo variant type. primary: main logo, secondary: alternative, icon: symbol only, wordmark: text only, full-lockup: complete logo").optional(), "tags": import_zod.z.array(import_zod.z.string()).describe("Additional semantic tags for custom categorization beyond the standard orientation, background, and variant fields").optional(), "slots": import_zod.z.array(import_zod.z.enum(["logo_card_light", "logo_card_dark", "profile_mark", "favicon", "app_icon", "social_profile_mark", "nav_header", "footer", "email_header", "watermark", "ad_end_card", "co_brand_lockup", "marketplace_listing"]).describe("Canonical renderer-facing logo slot. Use when selecting a logo variant from brand.json for a specific UI or creative placement.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Canonical renderer slots where this logo is appropriate. Consumers SHOULD prefer this over inferring from tags or usage prose when selecting a logo for a specific UI surface.").optional(), "usage": import_zod.z.string().describe("Human-readable description of when to use this logo variant (e.g., 'Primary logo for use on light backgrounds')").optional(), "width": import_zod.z.number().int().describe("Width in pixels").optional(), "height": import_zod.z.number().int().describe("Height in pixels").optional() }).catchall(import_zod.z.any()).describe("Brand logo asset with structured fields for orientation, background compatibility, and variant type")).describe("Brand logo assets").optional(), "colors": import_zod.z.object({ "primary": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "secondary": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "accent": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "background": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "text": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "heading": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "body": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "label": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "border": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "divider": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "surface_1": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional(), "surface_2": import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))]).optional() }).catchall(import_zod.z.union([import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")), import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")))])).describe("Brand color palette. Each role accepts a single hex color or an array of hex colors for brands with multiple values per role. Beyond the core five roles, brands can provide additional color roles for finer granularity \u2014 heading, body, label, border, divider, surface_1, surface_2, etc.").optional(), "fonts": import_zod.z.object({ "primary": import_zod.z.union([import_zod.z.string().describe("CSS font-family name (e.g., 'Montserrat', 'Arial, sans-serif')"), import_zod.z.object({ "family": import_zod.z.string().describe("CSS font-family name (e.g., 'Brand Sans')"), "files": import_zod.z.array(import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to the font file (WOFF2, TTF, or OTF)"), "weight": import_zod.z.number().int().gte(100).lte(900).describe("CSS numeric font-weight for static fonts (100-900)").optional(), "weight_range": import_zod.z.array(import_zod.z.number().int().gte(100).lte(900)).max(2).describe("Variable font weight axis range as [min, max] (e.g., [100, 900]). Use instead of weight for variable fonts.").optional(), "style": import_zod.z.enum(["normal", "italic", "oblique"]).describe("CSS font-style").optional() }).catchall(import_zod.z.any()).describe("A font file with weight, style, and variable font metadata")).max(36).describe("Font files for different weights and styles").optional(), "opentype_features": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9]{4}$"))).max(20).describe("OpenType feature tags to enable (e.g., ['ss01', 'tnum', 'cv01']). These are four-character tags per the OpenType spec.").optional(), "fallbacks": import_zod.z.array(import_zod.z.string().max(100)).max(10).describe("Ordered fallback font-family names for when the primary font is unavailable or does not support the required script (e.g., ['Noto Sans Arabic', 'Noto Sans SC', 'sans-serif'])").optional() }).catchall(import_zod.z.any()).describe("Structured font with family name, downloadable font files, and typographic metadata")]).describe("Primary font family").optional(), "secondary": import_zod.z.union([import_zod.z.string().describe("CSS font-family name (e.g., 'Montserrat', 'Arial, sans-serif')"), import_zod.z.object({ "family": import_zod.z.string().describe("CSS font-family name (e.g., 'Brand Sans')"), "files": import_zod.z.array(import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to the font file (WOFF2, TTF, or OTF)"), "weight": import_zod.z.number().int().gte(100).lte(900).describe("CSS numeric font-weight for static fonts (100-900)").optional(), "weight_range": import_zod.z.array(import_zod.z.number().int().gte(100).lte(900)).max(2).describe("Variable font weight axis range as [min, max] (e.g., [100, 900]). Use instead of weight for variable fonts.").optional(), "style": import_zod.z.enum(["normal", "italic", "oblique"]).describe("CSS font-style").optional() }).catchall(import_zod.z.any()).describe("A font file with weight, style, and variable font metadata")).max(36).describe("Font files for different weights and styles").optional(), "opentype_features": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9]{4}$"))).max(20).describe("OpenType feature tags to enable (e.g., ['ss01', 'tnum', 'cv01']). These are four-character tags per the OpenType spec.").optional(), "fallbacks": import_zod.z.array(import_zod.z.string().max(100)).max(10).describe("Ordered fallback font-family names for when the primary font is unavailable or does not support the required script (e.g., ['Noto Sans Arabic', 'Noto Sans SC', 'sans-serif'])").optional() }).catchall(import_zod.z.any()).describe("Structured font with family name, downloadable font files, and typographic metadata")]).describe("Secondary font family").optional() }).catchall(import_zod.z.union([import_zod.z.string().describe("CSS font-family name (e.g., 'Montserrat', 'Arial, sans-serif')"), import_zod.z.object({ "family": import_zod.z.string().describe("CSS font-family name (e.g., 'Brand Sans')"), "files": import_zod.z.array(import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to the font file (WOFF2, TTF, or OTF)"), "weight": import_zod.z.number().int().gte(100).lte(900).describe("CSS numeric font-weight for static fonts (100-900)").optional(), "weight_range": import_zod.z.array(import_zod.z.number().int().gte(100).lte(900)).max(2).describe("Variable font weight axis range as [min, max] (e.g., [100, 900]). Use instead of weight for variable fonts.").optional(), "style": import_zod.z.enum(["normal", "italic", "oblique"]).describe("CSS font-style").optional() }).catchall(import_zod.z.any()).describe("A font file with weight, style, and variable font metadata")).max(36).describe("Font files for different weights and styles").optional(), "opentype_features": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9]{4}$"))).max(20).describe("OpenType feature tags to enable (e.g., ['ss01', 'tnum', 'cv01']). These are four-character tags per the OpenType spec.").optional(), "fallbacks": import_zod.z.array(import_zod.z.string().max(100)).max(10).describe("Ordered fallback font-family names for when the primary font is unavailable or does not support the required script (e.g., ['Noto Sans Arabic', 'Noto Sans SC', 'sans-serif'])").optional() }).catchall(import_zod.z.any()).describe("Structured font with family name, downloadable font files, and typographic metadata")]).describe("A font role entry. Either a CSS font-family string (simple) or a structured object with family name and font files (rich).")).describe("Brand typography. Each key is a role name (e.g., 'primary', 'secondary') referenced by type_scale entries. Values are either a CSS font-family string or a structured object with font files for reliable resolution.").optional(), "tone": import_zod.z.union([import_zod.z.string().describe("Simple tone descriptors for backwards compatibility"), import_zod.z.object({ "voice": import_zod.z.union([import_zod.z.string(), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged."))]).describe("High-level voice descriptor, either a legacy plain string or localized values.").optional(), "attributes": import_zod.z.union([import_zod.z.array(import_zod.z.string()), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.array(import_zod.z.string())).describe("One locale mapped to a complete ordered string list. The list is selected as a unit so readers never assemble mixed-language output from independently localized elements."))]).describe("Personality traits that characterize the brand voice. Localized lists are selected as a whole.").optional(), "dos": import_zod.z.union([import_zod.z.array(import_zod.z.string()), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.array(import_zod.z.string())).describe("One locale mapped to a complete ordered string list. The list is selected as a unit so readers never assemble mixed-language output from independently localized elements."))]).describe("Guidance for copy generation - what TO do. Localized lists are selected as a whole.").optional(), "donts": import_zod.z.union([import_zod.z.array(import_zod.z.string()), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.array(import_zod.z.string())).describe("One locale mapped to a complete ordered string list. The list is selected as a unit so readers never assemble mixed-language output from independently localized elements."))]).describe("Guardrails to avoid brand violations - what NOT to do. Localized lists are selected as a whole.").optional() }).describe("Structured brand voice guidelines")]).describe("Brand voice and messaging tone guidelines").optional(), "tagline": import_zod.z.union([import_zod.z.string().describe("Plain tagline string for backwards compatibility"), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged.")).describe("Localized taglines with BCP 47 locale codes")]).describe("Brand tagline or slogan. Accepts a plain string or a localized array matching the names pattern.").optional(), "assets": import_zod.z.array(import_zod.z.object({ "asset_id": import_zod.z.string().describe("Unique identifier"), "asset_type": import_zod.z.enum(["image", "video", "audio", "text", "markdown", "html", "css", "javascript", "zip", "vast", "daast", "url", "webhook", "brief", "catalog", "published_post"]).describe("Type of asset content"), "url": import_zod.z.string().url().describe("URL to CDN-hosted asset file"), "tags": import_zod.z.array(import_zod.z.string()).describe("Tags for discovery (e.g., 'hero', 'lifestyle', 'product', 'holiday')").optional(), "name": import_zod.z.union([import_zod.z.string(), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged."))]).describe("Human-readable name, either a legacy plain string or localized values.").optional(), "description": import_zod.z.union([import_zod.z.string(), import_zod.z.array(import_zod.z.record(import_zod.z.string(), import_zod.z.string().min(1)).describe("A localized name using the legacy underscore-separated language/region key convention (for example 'en_US', 'fr_CA', or 'zh_CN') and a name value. Bare language codes such as 'en' are also accepted for backwards compatibility. These keys are not AdCP locale-tag values: a bridge to /schemas/core/locale-tag.json replaces '_' with '-', applies the AdCP canonical wire profile, and validates the result rather than passing the key through unchanged."))]).describe("Asset description or usage notes, either a legacy plain string or localized values.").optional(), "width": import_zod.z.number().int().describe("Image/video width in pixels").optional(), "height": import_zod.z.number().int().describe("Image/video height in pixels").optional(), "duration_seconds": import_zod.z.number().describe("Video/audio duration in seconds").optional(), "file_size_bytes": import_zod.z.number().int().describe("File size in bytes").optional(), "format": import_zod.z.string().describe("File format (e.g., 'jpg', 'mp4', 'mp3')").optional(), "metadata": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).describe("Additional asset-specific metadata").optional() }).catchall(import_zod.z.any()).describe("Brand asset (image, video, audio, text)")).describe("Brand asset library").optional(), "properties": import_zod.z.array(import_zod.z.object({ "type": import_zod.z.enum(["website", "mobile_app", "ctv_app", "desktop_app", "dooh", "podcast", "radio", "linear_tv", "streaming_audio", "ai_assistant"]).describe("Property type"), "identifier": import_zod.z.string().min(1).describe("Property identifier - domain for websites, bundle ID for apps"), "store": import_zod.z.enum(["apple", "google", "amazon", "roku", "samsung", "lg", "other"]).describe("App store for mobile/CTV apps").optional(), "region": import_zod.z.string().regex(new RegExp("^([A-Z]{2}|global)$")).describe("ISO 3166-1 alpha-2 country code or 'global'").optional(), "primary": import_zod.z.boolean().describe("Whether this is the primary property for the brand").default(false), "relationship": import_zod.z.enum(["owned", "direct", "delegated", "ad_network"]).describe("How this brand relates to the property. 'owned': the brand owns and operates this property (default) and has no adagents.json delegation_type counterpart. 'direct': the brand is the direct sales path for this property, even if a third party operates the software (e.g., a publisher's in-house ad team using a vendor's tech). 'delegated': the brand manages monetization for this property \u2014 they are in charge of ad sales (e.g., Mediavine managing a food blog). 'ad_network': the brand sells this property's inventory as part of a network or exchange \u2014 they are a path to the inventory, not the path (e.g., PubMatic as an SSP). For non-owned properties, the publisher confirms the relationship by setting the matching delegation_type on the agent's authorization in their adagents.json.").default("owned") }).catchall(import_zod.z.any()).describe("A digital property associated with a brand. Defaults to owned; use 'relationship' to declare direct, delegated, or ad_network properties. For direct, delegated, and network paths, these values match the delegation_type field in adagents.json, creating a bilateral verification chain: the operator declares the relationship here, the publisher confirms by setting the same delegation_type on the agent's authorization in their adagents.json. 'owned' is an inline ownership declaration with no adagents.json counterpart.")).describe("Digital properties associated with this brand \u2014 owned, managed, or represented").optional(), "product_catalog": import_zod.z.object({ "feed_url": import_zod.z.string().url().describe("URL to product catalog feed"), "feed_format": import_zod.z.enum(["google_merchant_center", "facebook_catalog", "shopify", "linkedin_jobs", "tiktok_shop", "pinterest_catalog", "openai_product_feed", "custom"]).describe("Format of the product feed").optional(), "categories": import_zod.z.array(import_zod.z.string()).describe("Product categories available in the catalog").optional(), "last_updated": import_zod.z.string().datetime().describe("When the product catalog was last updated").optional(), "update_frequency": import_zod.z.enum(["realtime", "hourly", "daily", "weekly"]).describe("How frequently the product catalog is updated").optional(), "agentic_checkout": import_zod.z.object({ "endpoint": import_zod.z.string().url().describe("Base URL for checkout session API"), "spec": import_zod.z.string().describe("Checkout API specification identifier. Use a namespaced string to identify the checkout protocol (e.g., vendor-prefixed or custom). Vendor-specific values belong under ext.{vendor}."), "supported_payment_providers": import_zod.z.array(import_zod.z.string()).describe("Payment providers supported by this checkout endpoint").optional() }).describe("Agentic checkout endpoint configuration").optional() }).catchall(import_zod.z.any()).describe("Product catalog for e-commerce brands").optional(), "privacy_policy_url": import_zod.z.string().url().describe("URL to the brand's privacy policy").optional(), "data_subject_contestation": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL to a human-accessible contestation form or information page.").optional(), "email": import_zod.z.string().email().describe("Email address for contestation requests. Deployer MUST monitor and respond within the timelines set by applicable law (e.g., 1 month under GDPR Art. 12(3)).").optional(), "languages": import_zod.z.array(import_zod.z.string()).describe("BCP 47 language tags the contestation channel supports (e.g., ['en', 'de', 'fr']). At minimum SHOULD include a language spoken in every jurisdiction where the brand runs regulated-vertical campaigns.").optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("Contact point where a data subject can request human intervention, express their view, or contest an automated decision \u2014 satisfying GDPR Article 22(3) and EU AI Act Article 26(11) transparency obligations. This is a contact reference (URL, email, or both), not a machine-callable API. AdCP surfaces the pointer; the deployer runs the contestation workflow.").optional(), "disclaimers": import_zod.z.array(import_zod.z.object({ "text": import_zod.z.string(), "context": import_zod.z.string().optional(), "required": import_zod.z.boolean().default(true) })).describe("Legal disclaimers for creatives").optional(), "trademarks": import_zod.z.array(import_zod.z.object({ "registry": import_zod.z.string().describe("Trademark registry (e.g., 'USPTO', 'EUIPO', 'JPO', 'CNIPA')"), "number": import_zod.z.string().describe("Registration number as issued by the registry"), "mark": import_zod.z.string().describe("The registered mark as published"), "status": import_zod.z.enum(["active", "pending", "abandoned", "cancelled", "expired"]).describe("Registration status. Omit for active marks if status tracking is not maintained.").optional(), "license_type": import_zod.z.enum(["owned", "licensed_in", "licensed_out"]).describe("Whether the publisher owns the mark, licenses it from another entity, or licenses it to others. 'owned' is the default if omitted.").optional(), "licensor_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain of the entity that licenses this mark to the publisher. Meaningful when license_type=licensed_in; omit otherwise.").optional(), "countries": import_zod.z.array(import_zod.z.string().min(2).max(2)).describe("ISO 3166-1 alpha-2 country codes where this registration applies. Omit for global or where the registry's jurisdiction is implicit.").optional(), "nice_classes": import_zod.z.array(import_zod.z.number().int().gte(1).lte(45)).describe("Nice Classification class numbers (1-45) covered by this registration. Disambiguates marks across industries (e.g., Delta-airline vs Delta-faucet). Omit if scope is implicit from registry.").optional() }).catchall(import_zod.z.any()).describe("A registered trademark. May appear at house level (corporate marks, e.g., 'NIKE' owned by Nike, Inc.) or at brand level (brand-specific marks, e.g., 'CONVERSE' owned by Converse). Resolution between house- and brand-level trademarks is union \u2014 both lists are valid claims about marks the publisher controls.")).describe("Brand-level registered trademarks. Use for marks the brand owns or controls (e.g., a sub-brand's own marks distinct from the corporate parent). House-level trademarks live on the house object; resolution between the two is union \u2014 both lists are valid claims.").optional(), "voice_synthesis": import_zod.z.object({ "provider": import_zod.z.string().optional(), "voice_id": import_zod.z.string().optional(), "settings": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).optional() }).catchall(import_zod.z.any()).describe("TTS voice synthesis configuration for AI-generated audio").optional(), "avatar": import_zod.z.object({ "provider": import_zod.z.string().optional(), "avatar_id": import_zod.z.string().optional(), "settings": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).optional() }).catchall(import_zod.z.any()).describe("Visual avatar configuration").optional(), "visual_guidelines": import_zod.z.object({ "photography": import_zod.z.object({ "realism": import_zod.z.enum(["natural", "stylized", "hyperreal", "abstract"]).describe("Level of photographic realism").optional(), "lighting": import_zod.z.string().describe("Lighting style (e.g., 'soft daylight', 'studio', 'golden hour', 'high-key', 'low-key')").optional(), "color_temperature": import_zod.z.enum(["warm", "neutral", "cool"]).describe("Overall color temperature of photography").optional(), "contrast": import_zod.z.enum(["low", "medium", "high"]).describe("Contrast level in photography").optional(), "depth_of_field": import_zod.z.enum(["shallow", "medium", "deep"]).describe("Depth of field preference. shallow: blurred background with subject isolation, deep: everything in focus").optional(), "subject": import_zod.z.object({ "people": import_zod.z.object({ "age_range": import_zod.z.string().describe("Target age range (e.g., '20-35')").optional(), "diversity": import_zod.z.string().describe("Diversity representation (e.g., 'mixed', 'varied')").optional(), "mood": import_zod.z.array(import_zod.z.string()).describe("Mood descriptors (e.g., ['confident', 'relaxed'])").optional() }).catchall(import_zod.z.any()).describe("People photography guidelines").optional(), "product_focus": import_zod.z.enum(["in-use", "isolated", "lifestyle", "detail"]).describe("How products are shown").optional(), "setting": import_zod.z.string().describe("Environmental context for photography (e.g., 'indoor', 'outdoor', 'studio', 'urban', 'nature', 'workplace')").optional() }).catchall(import_zod.z.any()).describe("Subject matter guidelines").optional(), "framing": import_zod.z.object({ "subject_position": import_zod.z.string().describe("Where the subject sits in frame (e.g., 'center', 'center-left', 'rule-of-thirds')").optional(), "crop_style": import_zod.z.string().describe("Cropping convention (e.g., 'waist-up', 'full-body', 'close-up', 'wide')").optional(), "perspective": import_zod.z.string().describe("Camera perspective (e.g., 'eye-level', 'overhead', 'low-angle')").optional() }).catchall(import_zod.z.any()).describe("Camera framing rules").optional(), "preferred_aspect_ratios": import_zod.z.array(import_zod.z.string().regex(new RegExp("^\\d+:\\d+$"))).describe("Preferred aspect ratios for brand photography (e.g., '16:9', '4:5', '1:1')").optional(), "tags": import_zod.z.array(import_zod.z.string()).describe("Additional style descriptors").optional() }).catchall(import_zod.z.any()).describe("Photography style rules for generative creative systems. Defines how brand photography should look when selected or generated.").optional(), "graphic_style": import_zod.z.object({ "style_type": import_zod.z.enum(["flat_illustration", "geometric", "gradient_mesh", "editorial_collage", "hand_drawn", "minimal_line_art", "3d_render", "isometric", "photographic_composite"]).describe("Primary graphic style").optional(), "stroke_style": import_zod.z.enum(["rounded", "square", "mixed", "none"]).describe("Stroke end/join style").optional(), "stroke_weight": import_zod.z.string().describe("Stroke weight (e.g., '2px', 'thin', 'bold')").optional(), "corner_radius": import_zod.z.string().describe("Default corner radius for graphic and illustration elements (e.g., '12px', '8px', 'sharp'). For UI component radii (buttons, cards, inputs), see visual_guidelines.border_radius.").optional(), "tags": import_zod.z.array(import_zod.z.string()).describe("Additional style descriptors").optional() }).catchall(import_zod.z.any()).describe("Visual language for brand graphics and illustrations").optional(), "shapes": import_zod.z.object({ "primary_shape": import_zod.z.string().describe("Primary brand shape (e.g., 'rounded_rectangle', 'circle', 'hexagon')").optional(), "secondary_shapes": import_zod.z.array(import_zod.z.string()).describe("Secondary shapes in the brand vocabulary").optional(), "usage": import_zod.z.object({ "max_per_layout": import_zod.z.number().int().describe("Maximum distinct shapes per layout").optional(), "overlap_allowed": import_zod.z.boolean().describe("Whether shapes may overlap").optional() }).catchall(import_zod.z.any()).describe("Shape usage rules").optional() }).catchall(import_zod.z.any()).describe("Distinctive shapes used as part of brand visual identity").optional(), "iconography": import_zod.z.object({ "style": import_zod.z.enum(["outline", "filled", "duotone", "flat", "glyph", "hand_drawn"]).describe("Icon rendering style").optional(), "stroke_weight": import_zod.z.string().describe("Icon stroke weight (e.g., '2px', '1.5px')").optional(), "corner_style": import_zod.z.enum(["rounded", "square", "mixed"]).describe("Corner style for icon paths").optional(), "usage": import_zod.z.object({ "max_per_frame": import_zod.z.number().int().describe("Maximum icons per creative frame").optional(), "size_ratio": import_zod.z.string().describe("Icon-to-layout size ratio (e.g., '1:8')").optional() }).catchall(import_zod.z.any()).describe("Icon usage rules").optional() }).catchall(import_zod.z.any()).describe("Icon style system and usage rules").optional(), "composition": import_zod.z.object({ "overlays": import_zod.z.object({ "gradient_style": import_zod.z.enum(["linear", "radial", "conic", "none"]).describe("Gradient type for overlays").optional(), "gradient_direction": import_zod.z.string().describe("Gradient direction (e.g., '45deg', 'to-bottom-right')").optional(), "opacity": import_zod.z.string().describe("Overlay opacity (e.g., '70%')").optional() }).catchall(import_zod.z.any()).describe("Graphic overlay rules").optional(), "texture": import_zod.z.object({ "style": import_zod.z.enum(["none", "subtle_grain", "noise", "paper", "fabric", "concrete"]).describe("Texture style applied to creative assets").optional(), "intensity": import_zod.z.enum(["low", "medium", "high"]).describe("Texture intensity").optional() }).catchall(import_zod.z.any()).describe("Texture treatment rules").optional(), "backgrounds": import_zod.z.object({ "types_allowed": import_zod.z.array(import_zod.z.enum(["solid_color", "gradient", "blurred_photo", "image", "video", "pattern", "transparent"])).describe("Permitted background types").optional() }).catchall(import_zod.z.any()).describe("Background treatment rules").optional() }).catchall(import_zod.z.any()).describe("Layout composition rules including overlays, textures, and backgrounds").optional(), "border_radius": import_zod.z.object({ "none": import_zod.z.string().describe("Explicitly sharp corners (e.g., '0')").optional(), "default": import_zod.z.string().describe("Default border radius for UI components (e.g., '8px', '12px', '0'). For graphic/illustration elements, see graphic_style.corner_radius.").optional(), "small": import_zod.z.string().describe("Small border radius for compact elements (e.g., '4px')").optional(), "large": import_zod.z.string().describe("Large border radius for cards and containers (e.g., '16px', '24px')").optional(), "pill": import_zod.z.string().describe("Fully rounded / pill shape (e.g., '999px')").optional() }).catchall(import_zod.z.string()).describe("Named border radius presets for UI components and layout elements. One of the most visible brand differentiators \u2014 Airbnb uses generous 20px, Stripe uses precise 4\u20138px, Spotify uses pill/999px.").optional(), "elevation": import_zod.z.object({ "none": import_zod.z.string().describe("No shadow (e.g., 'none')").optional(), "subtle": import_zod.z.string().describe("Subtle shadow for slight lift (e.g., '0 1px 2px rgba(0,0,0,0.05)')").optional(), "card": import_zod.z.string().describe("Card-level shadow (e.g., '0 4px 6px -1px rgba(0,0,0,0.1), 0 2px 4px -2px rgba(0,0,0,0.1)')").optional(), "modal": import_zod.z.string().describe("Modal/overlay shadow (e.g., '0 20px 25px -5px rgba(0,0,0,0.1), 0 8px 10px -6px rgba(0,0,0,0.1)')").optional() }).catchall(import_zod.z.string()).describe("Named shadow/elevation levels. Brands use elevation as identity \u2014 from Stripe's blue-tinted multi-layer shadows to Apple's single diffuse shadow. Values are CSS box-shadow syntax.").optional(), "spacing": import_zod.z.object({ "unit": import_zod.z.string().describe("Base grid unit this scale was designed from (e.g., '8px', '4px'). Informational \u2014 agents should use the named scale values, not compute from this.").optional(), "scale": import_zod.z.object({ "xs": import_zod.z.string().describe("Extra small spacing (e.g., '4px')").optional(), "sm": import_zod.z.string().describe("Small spacing (e.g., '8px')").optional(), "md": import_zod.z.string().describe("Medium spacing (e.g., '16px')").optional(), "lg": import_zod.z.string().describe("Large spacing (e.g., '24px')").optional(), "xl": import_zod.z.string().describe("Extra large spacing (e.g., '32px')").optional(), "2xl": import_zod.z.string().describe("Section-level spacing (e.g., '48px', '64px')").optional() }).catchall(import_zod.z.string()).describe("Named spacing scale built from the base unit").optional() }).strict().describe("Spacing system for consistent layout rhythm. Most design systems use an 8px base grid.").optional(), "graphic_elements": import_zod.z.array(import_zod.z.object({ "name": import_zod.z.string().describe("Element name (e.g., 'Paper Tear', 'Brand Watermark', 'Section Divider')"), "type": import_zod.z.enum(["border", "divider", "frame", "watermark", "pattern", "texture_overlay", "decorative"]).describe("Element type").optional(), "description": import_zod.z.string().describe("How the element is used in layouts").optional(), "orientation": import_zod.z.enum(["horizontal", "vertical", "any"]).describe("Preferred orientation when used in layouts").optional(), "colors": import_zod.z.array(import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value")).describe("Colors this element may appear in").optional(), "max_per_layout": import_zod.z.number().int().describe("Maximum instances per layout").optional() }).catchall(import_zod.z.any()).describe("A reusable decorative or structural visual element that is part of the brand identity (e.g., torn paper edges, watermarks, dividers, background patterns)")).describe("Reusable decorative elements that are part of the brand visual identity (e.g., torn paper edges, watermarks, dividers)").optional(), "motion": import_zod.z.object({ "transition_style": import_zod.z.enum(["cut", "dissolve", "slide", "wipe", "zoom", "fade"]).describe("Primary transition style between scenes").optional(), "animation_speed": import_zod.z.enum(["slow", "moderate", "fast"]).describe("Overall animation pacing").optional(), "easing": import_zod.z.string().describe("Default easing function (e.g., 'ease-in-out', 'spring', 'linear')").optional(), "text_entrance": import_zod.z.enum(["fade", "typewriter", "slide_up", "slide_left", "scale", "none"]).describe("How text enters the frame").optional(), "pacing": import_zod.z.enum(["lingering", "moderate", "fast_cuts"]).describe("Overall editing rhythm").optional(), "kinetic_typography": import_zod.z.boolean().describe("Whether animated/kinetic typography is allowed").optional(), "tags": import_zod.z.array(import_zod.z.string()).describe("Additional motion style descriptors").optional() }).catchall(import_zod.z.any()).describe("Motion and animation rules for video, animated display, and interactive formats").optional(), "logo_placement": import_zod.z.object({ "preferred_position": import_zod.z.enum(["top-left", "top-center", "top-right", "bottom-left", "bottom-center", "bottom-right", "center"]).describe("Preferred logo position in layouts").optional(), "min_clear_space": import_zod.z.string().describe("Minimum clear space around the logo, expressed as a multiple of logo height (e.g., '0.5x', '1x') or fixed value (e.g., '16px')").optional(), "min_height": import_zod.z.string().describe("Minimum logo height to maintain legibility (e.g., '40px', '24px')").optional(), "background_contrast": import_zod.z.enum(["light_only", "dark_only", "any"]).describe("Permitted background contrast behind logo").optional() }).catchall(import_zod.z.any()).describe("Logo placement and clear space rules for automated creative production").optional(), "colorways": import_zod.z.array(import_zod.z.object({ "name": import_zod.z.string().describe("Colorway name (e.g., 'primary', 'inverted', 'subtle')"), "foreground": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value"), "background": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value"), "accent": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value").optional(), "border": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value").optional(), "cta_foreground": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("CTA text/icon color, if different from foreground").optional(), "cta_background": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("CTA button/container color, if different from accent").optional(), "channels": import_zod.z.array(import_zod.z.string()).describe("Channels or contexts where this colorway applies (e.g., 'online', 'print', 'pos', 'social', 'outdoor'). Omit for universal colorways.").optional() }).catchall(import_zod.z.any()).describe("A named color pairing that defines how colors work together. Colorways ensure foreground/background combinations are always on-brand and accessible.")).describe("Named color pairings for consistent foreground/background combinations").optional(), "color_constraints": import_zod.z.array(import_zod.z.object({ "color": import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Color role or value this constraint governs."), "applies_to": import_zod.z.array(import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"])).describe("Surfaces where this color may be used.").optional(), "allowed_on": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Backgrounds, surfaces, or color roles where this color is allowed.").optional(), "forbidden_on": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Backgrounds, surfaces, or color roles where this color is forbidden.").optional(), "never_pair_with": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Color roles or values that must not be paired with this color.").optional(), "contexts": import_zod.z.array(import_zod.z.string()).describe("Channels or creative contexts where this constraint applies, such as digital, print, social, or ctv_end_card.").optional(), "severity": import_zod.z.enum(["must", "should"]).describe("Strength of a machine-readable brand guideline constraint.").optional(), "description": import_zod.z.string().describe("Human-readable rationale or source-language summary for the rule.").optional() }).catchall(import_zod.z.any()).describe("Machine-readable rule constraining how a brand color may be used or paired. Use for accent-only colors, forbidden foreground/background combinations, and palette pairs that should never appear together.")).describe("Machine-readable constraints for color usage and pairings, such as accent-only rules or forbidden foreground/background combinations.").optional(), "logo_usage_rules": import_zod.z.array(import_zod.z.object({ "logo_url": import_zod.z.string().url().describe("Specific logo asset URL this rule applies to. Omit when the rule applies by variant or tags.").optional(), "logo_id": import_zod.z.string().regex(new RegExp("^[a-z0-9][a-z0-9_-]*$")).describe("Stable `logos[].id` this rule applies to. Prefer this over logo_url when the rule targets a specific logo entry.").optional(), "logo_variant": import_zod.z.enum(["primary", "secondary", "icon", "wordmark", "full-lockup"]).describe("Logo variant this rule applies to.").optional(), "logo_tags": import_zod.z.array(import_zod.z.string()).describe("Logo tags this rule applies to.").optional(), "contexts": import_zod.z.array(import_zod.z.string()).describe("Creative contexts where this rule applies.").optional(), "slots": import_zod.z.array(import_zod.z.enum(["logo_card_light", "logo_card_dark", "profile_mark", "favicon", "app_icon", "social_profile_mark", "nav_header", "footer", "email_header", "watermark", "ad_end_card", "co_brand_lockup", "marketplace_listing"]).describe("Canonical renderer-facing logo slot. Use when selecting a logo variant from brand.json for a specific UI or creative placement.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Canonical renderer slots where this rule applies. Use this for deterministic logo-card, profile-mark, end-card, and lockup selection.").optional(), "minimum_size": import_zod.z.object({ "width": import_zod.z.string().describe("Minimum width, such as 48px or 12mm.").optional(), "height": import_zod.z.string().describe("Minimum height, such as 18px or 6mm.").optional() }).strict().describe("Minimum rendered size needed for legibility.").optional(), "clear_space": import_zod.z.string().describe("Minimum clear space around the logo, expressed in brand terms or units.").optional(), "allowed_backgrounds": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Background color roles, values, or surfaces where this logo may be placed.").optional(), "forbidden_backgrounds": import_zod.z.array(import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.")).describe("Background color roles, values, or surfaces where this logo must not be placed.").optional(), "forbidden_contexts": import_zod.z.array(import_zod.z.string()).describe("Contexts where this logo must not be used, such as photography_without_knockout.").optional(), "severity": import_zod.z.enum(["must", "should"]).describe("Strength of a machine-readable brand guideline constraint.").optional(), "description": import_zod.z.string().describe("Human-readable rationale or source-language summary for the rule.").optional() }).catchall(import_zod.z.any()).and(import_zod.z.union([import_zod.z.any(), import_zod.z.any(), import_zod.z.any(), import_zod.z.any(), import_zod.z.any()])).describe("Machine-readable logo selection and placement rule. Complements logos[].usage by making enforceable minimum size, clear-space, background, and context constraints queryable.")).describe("Machine-readable logo selection and placement constraints for minimum size, clear space, backgrounds, and contexts.").optional(), "mark_lockups": import_zod.z.array(import_zod.z.object({ "lockup_type": import_zod.z.enum(["co_brand", "secondary_mark", "partner", "sponsor", "program", "talent", "custom"]).describe("Type of mark relationship governed by this lockup rule."), "ordering": import_zod.z.enum(["brand_first", "partner_first", "equal", "contextual"]).describe("Required visual ordering of the brand mark relative to partner or secondary marks.").optional(), "contexts": import_zod.z.array(import_zod.z.string()).describe("Creative contexts where this lockup rule applies.").optional(), "brand_logo_id": import_zod.z.string().regex(new RegExp("^[a-z0-9][a-z0-9_-]*$")).describe("Stable `logos[].id` for the brand logo this lockup rule is anchored on.").optional(), "secondary_logo_ids": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9][a-z0-9_-]*$")).describe("Stable identifier for a logo entry within this brand.json document. Use lowercase words separated by underscores or hyphens; do not key integrations on mutable asset URLs.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Stable `logos[].id` values for secondary, program, sponsor, or partner marks governed by this lockup rule when those marks are represented in this brand.json.").optional(), "separator": import_zod.z.object({ "type": import_zod.z.enum(["none", "keyline", "space", "divider"]).describe("Separator style."), "color": import_zod.z.object({ "kind": import_zod.z.enum(["name", "value", "surface"]).describe("Discriminator for the color reference variant.").optional(), "name": import_zod.z.string().describe("Key from the colors object, such as market_yellow, river_green, or any custom palette key. Unambiguous lookup into colors{}.").optional(), "value": import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("Literal hex color when no palette key exists.").optional(), "surface": import_zod.z.enum(["background", "foreground", "text", "logo_background", "cta", "accent", "border", "icon", "graphic_element"]).describe("Usage surface rather than a specific color value.").optional() }).strict().and(import_zod.z.union([import_zod.z.object({ "kind": import_zod.z.literal("name") }), import_zod.z.object({ "kind": import_zod.z.literal("value") }), import_zod.z.object({ "kind": import_zod.z.literal("surface") })])).describe("Reference to a brand color or usage surface for machine-readable guideline constraints. Use kind=name for palette lookup keys in colors, kind=value for a literal hex color, and kind=surface for layout surfaces such as background or text.").optional(), "width": import_zod.z.string().describe("Separator width, such as 1px.").optional() }).catchall(import_zod.z.any()).describe("Separator between marks, when required.").optional(), "min_gap": import_zod.z.string().describe("Minimum gap between marks, expressed in brand terms or units.").optional(), "brand_min_optical_weight_ratio": import_zod.z.number().gt(0).describe("Minimum optical weight of the brand mark relative to partner marks. 1 means at least equal.").optional(), "partner_max_optical_weight_ratio": import_zod.z.number().gt(0).describe("Maximum optical weight of partner marks relative to the brand mark. 1 means no larger than the brand mark. Enforcement is at layout time, not parse time \u2014 this value signals to renderers and creative agents how much space to provision for each mark.").optional(), "severity": import_zod.z.enum(["must", "should"]).describe("Strength of a machine-readable brand guideline constraint.").optional(), "description": import_zod.z.string().describe("Human-readable rationale or source-language summary for the lockup rule.").optional() }).catchall(import_zod.z.any()).describe("Machine-readable layout constraints for co-brand, partner, sponsor, program, or secondary-mark lockups.")).describe("Machine-readable co-brand, partner, sponsor, program, or secondary-mark lockup rules.").optional(), "type_scale": import_zod.z.object({ "base_width": import_zod.z.string().describe("Reference canvas width these sizes were designed for (e.g., '1080px'). Generative systems should scale proportionally for other canvas sizes.").optional(), "heading": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional(), "subheading": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional(), "body": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional(), "caption": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional(), "cta": import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale").optional() }).catchall(import_zod.z.object({ "font": import_zod.z.string().describe("Font reference. Use a key from the fonts object (e.g., 'primary', 'secondary') to reference a defined font role, or a literal CSS font-family string as a fallback.").optional(), "size": import_zod.z.string().describe("Font size (e.g., '48px', '2rem')").optional(), "weight": import_zod.z.string().describe("Font weight (e.g., '700', 'bold')").optional(), "line_height": import_zod.z.string().describe("Line height (e.g., '1.2', '56px')").optional(), "letter_spacing": import_zod.z.string().describe("Letter spacing (e.g., '-0.02em', '0.5px')").optional(), "text_transform": import_zod.z.enum(["none", "uppercase", "lowercase", "capitalize"]).describe("Text transformation").optional() }).catchall(import_zod.z.any()).describe("A single entry in the type scale")).describe("Typography scale defining sizes and weights for different text roles. When sizes are in px, use base_width to indicate the reference canvas.").optional(), "asset_libraries": import_zod.z.array(import_zod.z.object({ "name": import_zod.z.string().describe("Display name of the asset library"), "type": import_zod.z.enum(["icon_set", "illustration_system", "image_library", "video_library", "template_library"]).describe("Type of asset library").optional(), "url": import_zod.z.string().url().describe("URL to the asset library (for human access)"), "description": import_zod.z.string().describe("Description of the library contents and usage").optional(), "color_guide": import_zod.z.object({ "roles": import_zod.z.array(import_zod.z.string()).describe("Named color roles used in the library (e.g., base, shadow_1, highlight_1, stroke)").optional(), "palettes": import_zod.z.array(import_zod.z.object({ "name": import_zod.z.string().describe("Palette name"), "colors": import_zod.z.record(import_zod.z.string(), import_zod.z.string().regex(new RegExp("^#[0-9A-Fa-f]{6}$")).describe("A single hex color value")).describe("Map of role names to hex color values") }).catchall(import_zod.z.any())).describe("Named color palettes mapping roles to specific colors").optional() }).catchall(import_zod.z.any()).describe("Color guide for the asset library defining roles and palettes").optional() }).catchall(import_zod.z.any()).describe("A managed asset library (icon set, illustration system, image collection). The URL is for human access; agent-facing DAM integration is under investigation.")).describe("References to managed asset libraries (icon sets, illustration systems, image collections). URLs are intended for human access; agent-facing DAM integration is under investigation.").optional(), "restrictions": import_zod.z.array(import_zod.z.string()).describe("Visual prohibitions and guardrails (e.g., 'Never use black backgrounds', 'Do not crop the logo', 'No stock photography of people on phones')").optional() }).catchall(import_zod.z.any()).describe("Structured visual rules for generative creative systems").optional(), "agents": import_zod.z.array(import_zod.z.object({ "type": import_zod.z.enum(["brand", "rights", "measurement", "governance", "creative", "sales", "buying", "signals"]).describe("Functional role of this agent"), "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Agent endpoint URL (MCP or A2A). Callers comparing a brand's declared agent URL against another value (e.g., resolving 'is this the agent that signed this artifact?' or matching against a discovery cache) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. After the publication chain and an authorized request-signing key verify, this exact entry's canonical URL is the stable Agent identity input for principal mapping; the domain, JWKS URI, kid, and key material are credential or trust facts beneath it, not the Agent identity. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).max(100).describe("Agent identifier (useful for logging, multi-tenant platforms)"), "description": import_zod.z.string().max(500).describe("Human-readable description of this agent's capabilities or scope").optional(), "jwks_uri": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL of the agent's JWKS (RFC 7517) containing public keys used to verify artifacts this agent signs or requests it sends. Verified artifacts include signed governance_context tokens (for governance agents) and RFC 9421 HTTP Signatures on outgoing requests (for any agent). When absent, verifiers MUST default to /.well-known/jwks.json on the origin of `url`. Keys are identified by `kid` in the JWS header or RFC 9421 `keyid` parameter; JWKS MAY contain multiple keys to support rotation and per-purpose separation via `key_ops` and `use`.").optional(), "available_uses": import_zod.z.array(import_zod.z.enum(["likeness", "voice", "name", "endorsement", "motion_capture", "signature", "catchphrase", "sync", "background_music", "editorial", "commercial", "ai_generated_image"]).describe("Types of rights usage that can be licensed through the brand protocol. Aligned with DDEX UseType direction for interoperability with music and media rights systems.")).describe("For rights agents: rights uses available for licensing").optional(), "right_types": import_zod.z.array(import_zod.z.enum(["talent", "character", "brand_ip", "music", "stock_media"]).describe("Categories of intellectual property rights that can be licensed through the brand protocol.")).describe("For rights agents: types of rights available").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("ISO 3166-1 alpha-2 country codes where this agent operates. Omit for global scope.").optional() }).catchall(import_zod.z.any()).describe("An agent declared by a brand or house. Each entry identifies one agent endpoint and its functional role in the advertising ecosystem.")).describe("Agents authorized to act on behalf of this brand. Consumers resolving an agent by URL use the matching brand-level entry; do not infer a type-wide override of unrelated house-level entries when multiple same-type entries exist.").optional(), "brand_agent": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Brand agent MCP endpoint URL. Callers comparing this URL against another value (e.g., resolving 'is this the brand's declared agent?' against a discovery cache) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Agent identifier (useful for logging, multi-tenant DAMs)") }).catchall(import_zod.z.any()).describe("Deprecated: use agents array with type 'brand' instead. Brand agent that provides dynamic brand data via MCP.").optional(), "rights_agent": import_zod.z.object({ "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Rights agent MCP endpoint URL. Callers comparing this URL against another value (e.g., matching against a brand's declared rights endpoint) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. See docs/reference/url-canonicalization."), "id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Agent identifier"), "available_uses": import_zod.z.array(import_zod.z.enum(["likeness", "voice", "name", "endorsement", "motion_capture", "signature", "catchphrase", "sync", "background_music", "editorial", "commercial", "ai_generated_image"]).describe("Types of rights usage that can be licensed through the brand protocol. Aligned with DDEX UseType direction for interoperability with music and media rights systems.")).describe("Rights uses available for licensing through this agent"), "right_types": import_zod.z.array(import_zod.z.enum(["talent", "character", "brand_ip", "music", "stock_media"]).describe("Categories of intellectual property rights that can be licensed through the brand protocol.")).describe("Types of rights available").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("Countries where rights are available (ISO 3166-1 alpha-2)").optional() }).catchall(import_zod.z.any()).describe("Deprecated: use agents array with type 'rights' instead. Rights licensing agent for this brand.").optional(), "contact": import_zod.z.object({ "email": import_zod.z.string().email().describe("Contact email").optional(), "phone": import_zod.z.string().describe("Contact phone number").optional() }).describe("Brand-level contact information").optional(), "collections": import_zod.z.array(import_zod.z.object({ "collection_id": import_zod.z.string().describe("Collection identifier as used in the seller's get_products responses").optional(), "name": import_zod.z.string().describe("Human-readable collection name"), "role": import_zod.z.enum(["host", "guest", "creator", "cast", "narrator", "producer", "correspondent", "commentator", "analyst"]).describe("This person's role on the collection").optional(), "seller_agent_url": import_zod.z.string().url().describe("URL of the sales agent that sells inventory for this collection. Buyer agents can query this agent for collection products.").optional() }).catchall(import_zod.z.any())).describe("Collections this person or brand is associated with. Enables bidirectional linking: a collection's talent references brand.json via brand_url, and brand.json links back to collections.").optional() }).catchall(import_zod.z.any()).describe("A brand within a house portfolio. Combines identity (who) with creative assets (how to represent). Referenced as domain + brand_id."))).describe("Self-published brand document where the brand owns its own identity attributes. Optionally declares its house via house_domain; for trust, the named house's brand_refs[] must reciprocate (mutual assertion). Standalone brands (no parent house) omit house_domain. Hosted at the brand's own /.well-known/brand.json (or via authoritative_location indirection). See docs/brand-protocol/brand-json.mdx")]).describe("Brand identity and discovery file. Hosted at /.well-known/brand.json on house domains. Contains the full brand portfolio with identity, creative assets, and digital properties. Brands are identified by house + brand_id (like properties are identified by publisher + property_id). Supports variants: house portfolio (full brand data), brand agent (agent provides brand info via MCP), house redirect (pointer to house domain), or authoritative location redirect.");
 const AdagentsJsonSchema = import_zod.z.union([import_zod.z.object({ "$schema": import_zod.z.string().describe("JSON Schema identifier for this adagents.json file").optional(), "authoritative_location": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL of the authoritative adagents.json file. When present, this file is a reference and the authoritative location contains the actual agent authorization data. Because one deploy can change authorization across every publisher in the network, validators MUST cap response size, refuse redirects on the fetch, enforce short timeouts, and serve the previously cached file on transient 5xx. Two-tier size cap: pointer files served at `/.well-known/adagents.json` use the general 5 MB SSRF cap; dereferenced authoritative files (this URL's response, after the indirection) use a recommended 20 MB cap because the origin has explicitly opted in to fanning out across a publisher network. See docs/governance/property/managed-networks#security-considerations."), "last_updated": import_zod.z.string().datetime().describe("ISO 8601 timestamp indicating when this reference was last updated").optional() }).catchall(import_zod.z.any()).describe("URL reference variant - points to the authoritative location of the adagents.json file"), import_zod.z.object({ "$schema": import_zod.z.string().describe("JSON Schema identifier for this adagents.json file").optional(), "contact": import_zod.z.object({ "name": import_zod.z.string().min(1).max(255).describe("Name of the entity managing this file (e.g., 'Meta Advertising Operations', 'Clear Channel Digital')"), "email": import_zod.z.string().email().min(1).max(255).describe("Contact email for questions or issues with this authorization file").optional(), "domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Primary domain of the entity managing this file").optional(), "seller_id": import_zod.z.string().min(1).max(255).describe("Seller ID from IAB Tech Lab sellers.json (if applicable)").optional(), "tag_id": import_zod.z.string().min(1).max(100).describe("TAG Certified Against Fraud ID for verification (if applicable)").optional(), "privacy_policy_url": import_zod.z.string().url().describe("URL to the entity's privacy policy. Used for consumer consent flows when interacting with this sales agent.").optional() }).catchall(import_zod.z.any()).describe("Contact information for the entity managing this adagents.json file (may be publisher or third-party operator)").optional(), "catalog_etag": import_zod.z.string().min(1).max(255).describe("Opaque publisher-controlled cache validator for the public catalog portions of this file (`properties[]`, `collections[]`, `placements[]`, `formats[]`, `signals[]`, and tag metadata). Publishers SHOULD change this value whenever any catalog entry or catalog-scoped authorization changes, even when the hosting URL and HTTP validators stay the same. Buyer SDKs SHOULD cache resolved catalog lookups by URL plus `catalog_etag` (falling back to HTTP ETag/Last-Modified, then bounded TTL when absent) and re-resolve placement, format, collection, property, and signal references when it changes. This value is not a cryptographic digest; it is a compact version token such as a deployment hash, revision ID, or ISO timestamp.").optional(), "catalog_role": import_zod.z.literal("community_format_registry").describe("Marks a catalog payload intended for the fixed AgenticAdvertising.org community-format registry. This self-description is not provenance: consumers accept reference_renderer only when the document was obtained from the configured, reviewed community-registry origin.").optional(), "properties": import_zod.z.array(import_zod.z.object({ "property_id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Unique identifier for this property (optional). Enables referencing properties by ID instead of repeating full objects.").optional(), "property_type": import_zod.z.enum(["website", "mobile_app", "ctv_app", "desktop_app", "dooh", "podcast", "radio", "linear_tv", "streaming_audio", "ai_assistant"]).describe("Type of advertising property"), "name": import_zod.z.string().describe("Human-readable property name"), "identifiers": import_zod.z.array(import_zod.z.object({ "type": import_zod.z.enum(["domain", "subdomain", "network_id", "ios_bundle", "android_package", "apple_app_store_id", "google_play_id", "roku_store_id", "fire_tv_asin", "samsung_app_id", "apple_tv_bundle", "bundle_id", "venue_id", "screen_id", "openooh_venue_type", "rss_url", "apple_podcast_id", "spotify_collection_id", "podcast_guid", "station_id", "facility_id"]).describe("Type of identifier for this property"), "value": import_zod.z.string().describe("The identifier value. For domain type: 'example.com' matches base domain plus www and m subdomains; 'edition.example.com' matches that specific subdomain; '*.example.com' matches ALL subdomains but NOT base domain") }).catchall(import_zod.z.any())).describe("Array of identifiers for this property"), "tags": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Tag for categorizing publisher properties. Must be lowercase alphanumeric with underscores only.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Tags for categorization and grouping (e.g., network membership, content categories)").optional(), "supported_channels": import_zod.z.array(import_zod.z.enum(["display", "olv", "social", "search", "ctv", "linear_tv", "radio", "streaming_audio", "podcast", "dooh", "ooh", "print", "cinema", "email", "gaming", "retail_media", "influencer", "affiliate", "product_placement", "sponsored_intelligence"]).describe("Standardized advertising media channels describing how buyers allocate budget. Channels are planning abstractions, not technical substrates. See the Media Channel Taxonomy specification for detailed definitions.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Advertising channels this property supports (e.g., ['display', 'olv', 'social']). Publishers declare which channels their inventory aligns with. Properties may support multiple channels. See the Media Channel Taxonomy for definitions.").optional(), "publisher_domain": import_zod.z.string().describe("Domain where adagents.json should be checked for authorization validation. Optional in adagents.json (file location implies domain).").optional() }).catchall(import_zod.z.any()).describe("An advertising property that can be validated via adagents.json")).describe("Array of all properties covered by this adagents.json file. Defines the canonical property list that authorized agents reference.").optional(), "revoked_publisher_domains": import_zod.z.array(import_zod.z.object({ "publisher_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Publisher domain being revoked. Matches against the same canonicalized form used in `publisher_properties[].publisher_domain`."), "revoked_at": import_zod.z.string().datetime().describe("ISO 8601 timestamp when this publisher was revoked. Validators MAY use this to order revocations against their own cached state."), "reason": import_zod.z.enum(["relationship_ended", "compliance_violation", "publisher_request", "other"]).describe("Reason for revocation. **Operator-internal self-classification for review routing \u2014 not a public accusation.** `relationship_ended` is the routine commercial case. `compliance_violation` SHOULD be used only when the network has itself determined the publisher is out of policy; for un-adjudicated third-party allegations (regulator inquiries, advertiser complaints, ongoing investigations), use `other` to avoid making a discoverable adverse statement. `publisher_request` is for publisher-initiated exits. Compare to sellers.json, which deliberately carries no reason field for the same exposure concern.").optional() }).catchall(import_zod.z.any())).describe("Publisher domains explicitly removed from this managed network. Validators MUST treat any publisher domain listed here as no-longer-authorized, taking precedence over any appearance of the same domain in `authorized_agents[].publisher_properties[].publisher_domain` / `.publisher_domains[]`, in `authorized_agents[].properties[].publisher_domain` (`inline_properties` authorization type), or in top-level `properties[].publisher_domain`. Lets a network propagate per-publisher revocations on the next refresh instead of waiting for the file-level 7-day cache cap. Validators MUST hold previously-observed publisher revocations, keyed by authority and publisher_domain, for 7 days from the validator's first observation; changing revoked_at MUST NOT reset that first observation, even if the entry vanishes from a subsequent fetch \u2014 this closes the rollback gap where an attacker re-serves a stale file with the revocation removed. Networks SHOULD retain entries for at least 7 days after `revoked_at` so validators that didn't observe the original entry still pick it up on refresh.").optional(), "collections": import_zod.z.array(import_zod.z.object({ "publisher_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Publisher namespace that owns this collection. Required for supply-path verification when the declaration is read from a cross-origin authoritative document; it must match the publisher whose origin delegated retrieval. A pointer alone cannot claim another publisher's collection. May be omitted for a publisher-origin document, where that origin supplies the namespace.").optional(), "collection_id": import_zod.z.string().describe("Publisher-assigned identifier for this collection. Declared in the publisher's adagents.json collections array. Products reference collections via collection selectors with publisher_domain and collection_ids. Use distribution identifiers for cross-seller matching across publishers."), "name": import_zod.z.string().describe("Human-readable collection name"), "kind": import_zod.z.enum(["series", "publication", "event_series", "rotation", "channel"]).describe("What kind of content program this is. Helps agents interpret installments correctly. A channel collection represents the persistent programmed stream; its installments, when present, are scheduled airings or programming blocks. Defaults to 'series' when absent.").optional(), "description": import_zod.z.string().describe("What the collection is about").optional(), "genre": import_zod.z.array(import_zod.z.string()).describe("Genre tags. When genre_taxonomy is present, values are taxonomy IDs (e.g., IAB Content Taxonomy 3.0 codes). Otherwise free-form.").optional(), "genre_taxonomy": import_zod.z.string().describe("Taxonomy system for genre values (e.g., 'iab_content_3.0'). When present, genre values should be valid taxonomy IDs. Recommended for machine-readable brand safety evaluation.").optional(), "language": import_zod.z.string().describe("Primary language (BCP 47 tag, e.g., 'en', 'es-MX')").optional(), "content_rating": import_zod.z.object({ "system": import_zod.z.enum(["tv_parental", "mpaa", "podcast", "esrb", "bbfc", "fsk", "acb", "chvrs", "csa", "pegi", "custom"]).describe("Rating system used"), "rating": import_zod.z.string().describe("Rating value within the system (e.g., 'TV-PG', 'R', 'explicit')") }).catchall(import_zod.z.any()).describe("Baseline content rating for the collection. Individual installments may override this.").optional(), "cadence": import_zod.z.enum(["daily", "weekly", "monthly", "seasonal", "event", "irregular"]).describe("How frequently the collection releases new installments").optional(), "season": import_zod.z.string().describe("Current or most recent season identifier (e.g., '3', '2026', 'spring_2026'). A lightweight label \u2014 not a full season object.").optional(), "status": import_zod.z.enum(["active", "hiatus", "ended", "upcoming"]).describe("Lifecycle status of the collection").optional(), "production_quality": import_zod.z.enum(["professional", "prosumer", "ugc"]).describe("Production quality tier. Seller-declared. Maps to OpenRTB content.prodq (professional=1, prosumer=2, ugc=3).").optional(), "talent": import_zod.z.array(import_zod.z.object({ "role": import_zod.z.enum(["host", "guest", "creator", "cast", "narrator", "producer", "correspondent", "commentator", "analyst"]).describe("Role of this person on the collection or installment"), "name": import_zod.z.string().describe("Person's name as credited on the collection"), "brand_url": import_zod.z.string().url().describe("URL to this person's brand.json entry. Enables buyer agents to evaluate the talent's brand identity and associations.").optional() }).catchall(import_zod.z.any()).describe("A person associated with a collection or installment, with an optional link to their brand.json identity")).describe("Hosts, recurring cast, creators associated with the collection. Each talent entry may include a brand_url linking to their brand.json identity.").optional(), "special": import_zod.z.object({ "name": import_zod.z.string().describe("Name of the event (e.g., 'Olympics 2028', 'Super Bowl LXI')"), "category": import_zod.z.enum(["awards", "championship", "concert", "conference", "election", "festival", "gala", "holiday", "premiere", "product_launch", "reunion", "tribute"]).describe("Category of the event").optional(), "starts": import_zod.z.string().datetime().describe("When the event starts (ISO 8601)").optional(), "ends": import_zod.z.string().datetime().describe("When the event ends (ISO 8601). Omit for single-day events.").optional() }).catchall(import_zod.z.any()).describe("When present, this collection is a special \u2014 content anchored to a real-world event or occasion. Individual installments may override with their own event context.").optional(), "limited_series": import_zod.z.object({ "total_installments": import_zod.z.number().int().gte(1).describe("Planned number of installments in the series"), "starts": import_zod.z.string().datetime().describe("When the series begins (ISO 8601)").optional(), "ends": import_zod.z.string().datetime().describe("When the series ends (ISO 8601)").optional() }).catchall(import_zod.z.any()).describe("When present, this collection is a limited series \u2014 a bounded run with a defined arc, installment count, and end date.").optional(), "distribution": import_zod.z.array(import_zod.z.object({ "publisher_domain": import_zod.z.string().describe("Domain of the publisher platform where the collection is distributed (e.g., 'youtube.com', 'spotify.com'). Property IDs and publisher-scoped identifiers in this object resolve in this publisher's namespace."), "property_ids": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Identifier for a publisher property. Must be lowercase alphanumeric with underscores only.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Publisher-scoped property IDs from publisher_domain's adagents.json that carry this collection. For owner-sold channel inventory, these identify the host apps without requiring the host to publish channel-owner placement definitions.").optional(), "identifiers": import_zod.z.array(import_zod.z.object({ "type": import_zod.z.enum(["apple_podcast_id", "spotify_collection_id", "rss_url", "podcast_guid", "amazon_music_id", "iheart_id", "podcast_index_id", "youtube_channel_id", "youtube_channel_handle", "youtube_channel_url", "youtube_playlist_id", "amazon_title_id", "platform_channel_id", "roku_channel_id", "pluto_channel_id", "tubi_id", "peacock_id", "tiktok_id", "twitch_channel", "imdb_id", "gracenote_id", "eidr_id", "domain", "substack_id"]).describe("Type of distribution identifier"), "value": import_zod.z.string().describe("The identifier value") }).strict()).describe("Identifiers for the collection on this publisher, including publisher-scoped channel/EPG identifiers and platform-independent metadata identifiers").optional() }).catchall(import_zod.z.any()).and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("A collection's presence on a specific publisher platform. For a channel collection, this is a carriage assertion: property_ids identify the host surfaces carrying the channel, while identifiers identify the channel in the host's catalog or an independent metadata system. This publisher-authored assertion supports discovery and cross-seller matching but does not authorize a sale; authorization remains rooted in the host publisher's collection-scoped authorized_agents entry.")).describe("Where this collection is distributed. Each entry maps the collection to a publisher platform using host property IDs, identifiers, or both. For channel collections this is the carriage map. It is a publisher assertion for discovery, not sales authorization; buyers validate owner-sold carriage against the host publisher's collection-scoped authorized_agents declaration. Collections SHOULD include at least one platform-independent identifier (imdb_id, gracenote_id, eidr_id) when available.").optional(), "deadline_policy": import_zod.z.object({ "booking_lead_days": import_zod.z.number().int().gte(0).describe("Days before scheduled_at by which the placement must be booked").optional(), "cancellation_lead_days": import_zod.z.number().int().gte(0).describe("Days before scheduled_at by which cancellation is penalty-free").optional(), "material_stages": import_zod.z.array(import_zod.z.object({ "stage": import_zod.z.string().describe("Stage identifier. Standard values: 'draft' (needs seller processing), 'final' (production-ready)."), "lead_days": import_zod.z.number().int().gte(0).describe("Days before scheduled_at this stage is due"), "label": import_zod.z.string().describe("What the seller needs at this stage").optional() }).catchall(import_zod.z.any())).describe("Default material submission stages. Items MUST be in chronological order (earliest due first). Agents compute due_at as: installment.scheduled_at minus lead_days.").optional(), "business_days_only": import_zod.z.boolean().describe("When true, lead_days counts business days (Mon-Fri) rather than calendar days. Defaults to false.").default(false) }).catchall(import_zod.z.any()).describe("Default deadline rules for installments of this collection. Agents compute absolute deadlines from each installment's scheduled_at and these lead times. Installments with explicit deadlines override this policy. Only meaningful when installments carry scheduled_at; a continuously programmed channel collection without enumerated installments has no deadlines to derive.").optional(), "related_collections": import_zod.z.array(import_zod.z.object({ "collection_id": import_zod.z.string().describe("The related collection's collection_id within this seller's response"), "relationship": import_zod.z.enum(["spinoff", "companion", "sequel", "prequel", "crossover"]).describe("How the collections are related") }).strict()).describe("Relationships to other collections (spin-offs, companion collections, etc.). Each entry references another collection by collection_id within the same publisher's adagents.json.").optional(), "ext": import_zod.z.record(import_zod.z.string(), import_zod.z.any()).describe("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.").optional() }).catchall(import_zod.z.any()).describe("A recurring inventory container \u2014 a named program, publication, event series, rotation, or programmed channel that produces bookable installments on a defined cadence. The kind field indicates how to interpret this collection: 'series' for TV/podcast programs, 'publication' for print/newsletter titles, 'event_series' for live events, 'rotation' for DOOH scheduling, and 'channel' for continuously programmed audio or video streams regardless of carriage or monetization model. Declared in the publisher's adagents.json and referenced by products via collection selectors.")).describe("Collections produced or distributed by this publisher. Declares the content programs whose inventory is sold through authorized agents. Products in get_products responses reference these collections by collection_id.").optional(), "placements": import_zod.z.array(import_zod.z.object({ "placement_id": import_zod.z.string().describe("Stable placement identifier unique within this adagents.json file."), "name": import_zod.z.string().describe("Human-readable placement name (e.g., 'Homepage Banner', 'Pre-roll', 'Sponsored Listing Slot 1')."), "description": import_zod.z.string().describe("Description of where and how this placement appears.").optional(), "tags": import_zod.z.array(import_zod.z.string()).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Tags for grouping and querying placements across properties and products (e.g., 'homepage', 'native', 'premium', 'pre_roll').").optional(), "property_ids": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Identifier for a publisher property. Must be lowercase alphanumeric with underscores only.")).describe("Property IDs in this adagents.json where this placement can appear.").optional(), "property_tags": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Tag for categorizing publisher properties. Must be lowercase alphanumeric with underscores only.")).describe("Property tags in this adagents.json where this placement can appear. Useful for network-wide positions such as 'pre_roll' or 'homepage_native_feed'.").optional(), "collection_ids": import_zod.z.array(import_zod.z.string()).describe("Optional collection IDs in this adagents.json where this placement is valid. Use to narrow a placement to specific content programs carried on the selected properties.").optional(), "channels": import_zod.z.array(import_zod.z.enum(["display", "olv", "social", "search", "ctv", "linear_tv", "radio", "streaming_audio", "podcast", "dooh", "ooh", "print", "cinema", "email", "gaming", "retail_media", "influencer", "affiliate", "product_placement", "sponsored_intelligence"]).describe("Standardized advertising media channels describing how buyers allocate budget. Channels are planning abstractions, not technical substrates. See the Media Channel Taxonomy specification for detailed definitions.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Advertising channels where this placement can run. Products that reference the placement may narrow this set but should not broaden it.").optional(), "presentation_ref": import_zod.z.object({ "uri": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Publisher-controlled HTTPS URL for the presentation metadata. Consumers MUST apply the same SSRF, redirect, response-size, timeout, and DNS-rebinding protections used for format_schema fetches."), "digest": import_zod.z.string().regex(new RegExp("^sha256:[a-f0-9]{64}$")).describe("SHA-256 content digest. Consumers cache by uri@digest and MUST fail closed on a digest mismatch."), "media_type": import_zod.z.literal("application/vnd.adcp.placement-presentation+json").describe("Media type of the referenced declarative presentation document."), "schema_version": import_zod.z.literal("1.0").describe("Version of /schemas/core/placement-presentation.json used to validate and compose the referenced document.") }).strict().describe("Optional publisher-specific declarative frame for representing this placement's real chrome offline. It composes around the selected creative rendering unless the publisher-delegated preview_provider route explicitly covers placement presentation. It MUST NOT be promoted to or copied onto a shared format entry.").optional(), "preview_provider": import_zod.z.object({ "agent_url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL of the delegated creative-agent endpoint. Buyers call get_adcp_capabilities and preview_creative on this endpoint. They MUST allow only public IPs, pin DNS resolution through connection, refuse redirects, cap time and response size, and attach provider credentials only after exact normalized-origin binding."), "authority": import_zod.z.literal("publisher_designated").describe("Explicitly states that authority comes from the publisher-hosted placement declaration. The provider's rendering_origin metadata is informational and remains non-authoritative elsewhere."), "routes": import_zod.z.array(import_zod.z.object({ "format_option_id": import_zod.z.string().min(1).describe("Format option in this adagents.json placement for which the delegation applies. It MUST resolve through the same-file top-level formats[] catalog or an inline placement format declaration."), "capability_id": import_zod.z.string().regex(new RegExp("^[a-zA-Z0-9_-]+$")).describe("Agent-local preview capability advertised by the delegated provider. The provider's canonical format declaration MUST satisfy the resolved placement format option."), "covers_placement_presentation": import_zod.z.boolean().describe("True only when the publisher delegates both creative rendering and the complete placement-specific frame to this route. When false or omitted, consumers compose any presentation_ref around the provider's creative render.").default(false) }).strict()) }).strict().describe("Optional publisher delegation to a callable AdCP preview provider for specific format options on this placement. This publisher-origin route is the only mechanism that grants preview authority inside the placement's scope; an agent's own rendering_origin description does not.").optional(), "format_options": import_zod.z.array(import_zod.z.union([import_zod.z.object({ "format_option_id": import_zod.z.string().describe("Matches a `format_option_id` in the file's top-level `formats[]`."), "locale_policy": import_zod.z.object({ "accepted_language_ranges": import_zod.z.array(import_zod.z.string().regex(new RegExp("^(?:[a-z]{2,8}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[0-9]{3}))?(?:-(?:[a-z0-9]{5,8}|[0-9][a-z0-9]{3}))*(?:-[0-9a-wy-z](?:-[a-z0-9]{2,8})+)*(?:-x(?:-[a-z0-9]{1,8})+)?|x(?:-[a-z0-9]{1,8})+)$")).min(2).max(63).describe("A well-formed BCP 47 language tag used by AdCP only as language identity. Script and region may refine that identity; other valid BCP 47 subtags remain part of tag matching but do not make this a general locale-settings object. It does not determine currency, time zone, number/date formatting, market, or legal jurisdiction. The AdCP canonical wire profile requires lower-case language and variants, title-case script, and upper-case region (for example `en-US`, `zh-Hant-TW`, or `x-private`). RFC 5646 comparisons are case-insensitive and its case regularization is optional; AdCP intentionally requires this stricter single wire spelling and receivers MUST reject differently cased tags rather than silently normalizing them. The schema pattern enforces the AdCP casing profile and extension structure for commonly used tags; conforming receivers additionally validate the complete RFC 5646 grammar and registry rules. Every new AdCP field carrying BCP 47 language identity or a concrete language range MUST reference this schema instead of declaring independent string constraints.")).max(50).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Concrete canonical BCP 47 language ranges accepted by this format option. RFC 4647 Basic Filtering is directional: seller range fr accepts variant fr-CA, but seller range fr-CA does not accept variant fr or fr-FR. Use zxx explicitly for language-neutral creative; und means unknown and is not a wildcard.") }).catchall(import_zod.z.any()).describe("Optional placement-local locale policy. When the resolved top-level format declares a policy, every placement range must be contained by one of its ranges; otherwise this introduces a narrowing of the unconstrained format. The resolved effective route remains canonical-only.").optional() }).catchall(import_zod.z.any()).describe("Reference an entry in the file's top-level `formats[]` by `format_option_id`. Resolved at validation time. additionalProperties: true so placement-local fields (display_name, etc.) carry through without forcing a full inline declaration."), import_zod.z.object({ "format_option_id": import_zod.z.string().describe("Stable identifier for this declaration within its namespace. REQUIRED when a product contains multiple declarations with the same format_kind and SHOULD be set on every entry. Publisher-backed options pair it with publisher_domain; product-local options omit publisher_domain. When a single declaration has a unique format_kind and no ID, buyers author canonically with format_kind plus params; they MUST NOT fall back to deprecated format_ids merely because this optional ID is absent. Examples: 'display_image_300x250', 'responsive_search', 'daily_pulse_homepage_image'.").optional(), "publisher_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Namespace for `format_option_id` when this declaration references or narrows a publisher-declared format option from that publisher's adagents.json top-level `formats[]`. Product-local options omit this field and are selected by `format_option_id` within the target product.").optional(), "tracker_execution_contract": import_zod.z.object({ "complete": import_zod.z.boolean().describe("Whether honored is the complete set. complete:true with an empty honored array explicitly supports no buyer-supplied trackers."), "honored": import_zod.z.array(import_zod.z.union([import_zod.z.object({ "selector_id": import_zod.z.string().min(1).describe("Stable identifier unique within the materialized execution contract."), "asset_type": import_zod.z.literal("pixel_tracker"), "event": import_zod.z.enum(["impression", "viewable_mrc_50", "viewable_mrc_100", "viewable_video_50", "audible_video_complete", "click", "custom"]).describe("Closed AdCP event vocabulary for renderer-fired pixel trackers. Impression and viewability values through `viewable_video_50` map to IAB OpenRTB Native event tracker types 1-4. `audible_video_complete` is an AdCP-defined first-class event, not an assigned IAB Native event type; Native reserves 500+ for exchange-specific use. `click` represents Native click trackers and `custom` is the explicit adopter-defined extension point."), "method": import_zod.z.literal("img").describe("AdCP 3.2 execution contracts cover image-pixel initiation only; JavaScript response evaluation is outside this contract version."), "custom_event_name": import_zod.z.string().min(1).describe("Required only when event is custom.").optional(), "execution_actor": import_zod.z.enum(["seller", "request_executor"]).describe("Actor responsible for initiating a buyer-supplied tracker under a seller-authored execution contract. This v1 vocabulary is intentionally narrower than the macro resolver actor vocabulary."), "firing_paths": import_zod.z.array(import_zod.z.enum(["client", "server"]).describe("Environment in which the responsible actor initiates a tracker. A selector may permit both values, but exactly one path is used for each logical event occurrence.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Complete set of permitted initiation environments. Exactly one path is selected for each logical event occurrence.") }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any().refine((value) => !import_zod.z.any().safeParse(value).success, "Invalid input: Should NOT be valid against schema")]).superRefine((value, ctx) => {
   const result = import_zod.z.any().safeParse(value).success ? import_zod.z.any().safeParse(value) : import_zod.z.any().refine((value2) => !import_zod.z.any().safeParse(value2).success, "Invalid input: Should NOT be valid against schema").safeParse(value);
   if (!result.success) {
@@ -164,7 +164,7 @@ const AdagentsJsonSchema = import_zod.z.union([import_zod.z.object({ "$schema":
   if (!result.success) {
     result.error.issues.forEach((error) => ctx.addIssue(error));
   }
-}))), import_zod.z.intersection(import_zod.z.any().refine((value) => !import_zod.z.intersection(import_zod.z.any(), import_zod.z.any()).safeParse(value).success, "Invalid input: Should NOT be valid against schema"), import_zod.z.intersection(import_zod.z.any().refine((value) => !import_zod.z.any().safeParse(value).success, "Invalid input: Should NOT be valid against schema"), import_zod.z.any())))).describe("Inline format declaration on a product. The `format_kind` discriminator names which canonical format the product narrows; `params` carries only the canonical creative-shape parameters (slots, dimensions, durations, codecs, character limits, platform_extensions, etc.). Processing metadata such as `macro_resolution_capabilities` belongs at this declaration's top level rather than inside `params`. Optional `format_option_id` (stable identifier for routing when a product's `format_options` contains multiple declarations sharing the same `format_kind`), optional `publisher_domain` (namespace for the format option when it comes from a publisher adagents.json catalog), `display_name` (seller-controlled human-readable label for dashboard and catalog UIs), and `applies_to_channels` (subset of the product's declared channels this declaration applies to \u2014 lets a multi-channel product carry distinct format_options per channel). Discriminated-union shape generates clean tagged unions in TypeScript and Pydantic codegen. Replaces v1's named-format pattern (where products referenced a separately-defined format file via compound `format_id`). Canonical product-bound declarations are the AdCP 3.2 authoring path; v1 named formats remain only as deprecated 3.x compatibility projections.\n\n**Closed-set semantics (normative).** `format_options[]` is the closed set of accepted formats for this product. Sellers MUST reject `create_media_buy` requests targeting any `format_kind` (or format option reference) not present in this list \u2014 typically with `UNSUPPORTED_FEATURE` or a seller-specific code; the rejection is structural, not negotiable. `seller_preference` modulates *within* the accepted set (a soft ranking hint between equally-acceptable options), it is NOT an enforcement axis. A product wanting to say 'this format is the only one that works' lists exactly that one entry in `format_options[]`; everything else falls outside the set and is rejected by the closed-set rule.\n\n**Format matching vs satisfaction (normative).** Legacy named formats MUST be normalized to canonical declarations before comparison; do not exact-match raw `(agent_url, id)` pairs once a `format_id` has been projected through `canonical`, `v1_format_ref`, or the canonical mapping registry. Equivalence matching can treat a legacy fixed-size display ID and `format_kind: \"image\"` with matching `width`/`height` as the same underlying shape. Product satisfaction is stricter and directional: when this declaration specifies fixed constraints such as `width`, `height`, `duration_ms_exact`, or `duration_ms_range`, a buyer request or creative manifest MUST declare and satisfy those constraints. A broad request with no dimensions or duration does not satisfy a fixed-size or fixed-duration product; a broad product MAY accept a more specific creative unless another product constraint excludes it. Duration precedence is `duration_ms_exact` > `duration_ms_range`. Range constraints use containment: a range-based request satisfies this declaration only when every value it permits falls within this declaration's accepted range; overlap alone is insufficient. An exact value satisfies a range when the exact value falls inside the accepted interval. For hosted audio/video, a null range endpoint is unbounded: [null, 60000] means up to 60s, and [15000, null] means at least 15s; [null, null] is invalid because at least one endpoint must be bounded.\n\n**Custom format_kind** (`format_kind: \"custom\"`): for adopter-defined shapes that don't fit the 15 canonicals (branded content, cross-screen sponsorship, sponsorship lockup, newsletter sponsorship, AR lens, playable, live event sponsorship). When `format_kind` is `custom`, the declaration MUST carry `format_shape` (recognized global pattern from the [format-shape vocabulary registry](/schemas/core/format-shape-vocabulary.json)) AND `format_schema` (URI+digest reference to a fetchable schema describing the actual `params` and `slots`). Buyer agents fetch the schema, validate manifests structurally, and reason about manifests without per-seller integration code. See [adcp#3666](https://github.com/adcontextprotocol/adcp/issues/3666) for the canonical promotion queue."), import_zod.z.object({ "applies_to_property_ids": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Identifier for a publisher property. Must be lowercase alphanumeric with underscores only.")).describe('Optional property IDs from this file\'s `properties[]` that this format declaration applies to. When omitted, the declaration applies to all properties in the file. Mutually compatible with `applies_to_property_tags` (union is the effective scope). Example: Meta declares Reels with `applies_to_property_ids: ["instagram", "facebook"]` because WhatsApp doesn\'t carry Reels inventory.').optional(), "applies_to_property_tags": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Tag for categorizing publisher properties. Must be lowercase alphanumeric with underscores only.")).describe('Optional property tags from this file\'s `tags` map that this format declaration applies to. When omitted, the declaration applies to all properties in the file. Useful for network-wide formats (e.g., a managed network declaring `applies_to_property_tags: ["premium_video"]`). Compatible with `applies_to_property_ids` \u2014 a property is in scope if it matches either ID list or tag list.').optional(), "reference_renderer": import_zod.z.object({ "runtime": import_zod.z.literal("browser-esm").describe("Execution contract for the referenced package. browser-esm means a browser-safe ECMAScript module that accepts canonical manifest data and returns an inert presentation without Node.js APIs, ambient credentials, delivery tracking, or undeclared network access. Non-JavaScript clients use a hosted preview_creative provider or display the manifest."), "package": import_zod.z.string().regex(new RegExp("^(?:@[a-z0-9][a-z0-9._~-]*/)?[a-z0-9][a-z0-9._~-]*$")).describe("npm package name, scoped or unscoped. The package is resolved from the npm registry; the AdCP registry does not proxy its executable contents."), "version": import_zod.z.string().regex(new RegExp("^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$")).describe("Exact semantic version. Ranges and tags such as latest are forbidden so the registry entry is reproducible. Package semantic versioning identifies the pinned distribution artifact; it is independent of any one format revision because one package may expose renderers for multiple formats."), "export": import_zod.z.string().min(1).describe("Named package export that implements the renderer contract for this enclosing format entry. Compatibility is bound at the export-to-entry edge, not to matching version labels: registry review and contract fixtures verify that the export implements the entry's input contract. When that input contract changes, the registry MUST rerun those fixtures and MAY retain the existing export and package pin when they still pass. One package version MAY expose different named exports for different formats or input contracts."), "format_revision": import_zod.z.string().regex(new RegExp("^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)$")).describe("Deprecated compatibility annotation retained for previously published registry entries. Renderer package versions and community format revisions have independent lifecycles, so consumers MUST NOT require this value to equal the enclosing entry's format_revision or use matching values as evidence of compatibility. Registry review and contract fixtures bind the named export to the enclosing format's input contract. New entries SHOULD omit this field.").optional(), "integrity": import_zod.z.string().regex(new RegExp("^(?:sha256-[A-Za-z0-9+/]{43}=|sha384-[A-Za-z0-9+/]{64}|sha512-[A-Za-z0-9+/]{86}==)$")).describe("Subresource Integrity value for the exact npm package tarball. Consumers MUST compare this value before loading code, require the provenance subject digest to match the same tarball, and fail closed on mismatch."), "provenance": import_zod.z.object({ "source_repository": import_zod.z.string().url().regex(new RegExp("^https://github\\.com/")).describe("Allowlisted source repository that the npm provenance attestation MUST identify."), "workflow_path": import_zod.z.string().regex(new RegExp("^\\.github/workflows/[A-Za-z0-9._/-]+\\.ya?ml$")).describe("Repository-relative GitHub Actions workflow path that npm provenance buildDefinition.externalParameters.workflow.path MUST identify.") }).strict() }).strict().describe("Optional only for an AgenticAdvertising.org community-registry format entry fetched from the configured registry origin. Points to a pinned browser-ESM OSS renderer package export that provides a non-authoritative reference presentation. Registry review and contract fixtures bind the named export to the enclosing format's input contract (its canonical format kind, manifest shape, constraints, and declared macros); renderer package versions and format revisions have independent lifecycles. Display metadata and property scope do not affect that compatibility binding. Non-JavaScript clients use hosted preview_creative or display the manifest. Publisher-origin catalogs and seller product declarations do not use this field: publishers describe placement-specific chrome with placements[].presentation_ref and grant route-specific preview authority with placements[].preview_provider.").optional(), "format_revision": import_zod.z.string().regex(new RegExp("^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)$")).describe("Registry-managed revision of this community format entry's input contract. Required when reference_renderer is present, but independent of any reference-renderer package version or legacy reference_renderer.format_revision annotation. A contract update may retain an existing renderer pin when that export still passes the updated declaration's contract fixtures.").optional() }).and(import_zod.z.any()))).describe("Publisher-authoritative format catalog. Declares the 3.1+ canonical format-option shapes the publisher supports across its properties \u2014 the single place a publisher (or its community-registry stand-in) asserts \"these are the formats my inventory accepts.\" Products selling this publisher's inventory SHOULD reference these declarations by `format_option_id` on the placement or via inline `format_options` whose `format_option_id` matches an entry here, eliminating the N-copies-of-Meta-Reels-on-N-products drift surface.\n\nEach item is a `ProductFormatDeclaration` (same 3.1+ canonical format-option shape used on Products) plus optional `applies_to_property_ids` / `applies_to_property_tags` for property scoping within the file. A `formats[]` entry without scope applies to all properties in the file; with scope, only to the named subset (e.g., Reels applies to Instagram + Facebook but not WhatsApp).\n\n**Community registry pattern (normative for unadopted platforms).** When a platform hasn't adopted AdCP (Meta, TikTok, Snap, Pinterest, etc.), AAO publishes a community-maintained adagents.json at `https://creative.adcontextprotocol.org/translated/<platform>/adagents.json` carrying that platform's `formats[]`. Buyer SDKs fetch the platform's own `<domain>/.well-known/adagents.json` first; on 404 or absence-of-formats[], they fall back to the AAO mirror. When the platform adopts AdCP and publishes their own adagents.json with `formats[]`, the platform-hosted file takes precedence and the mirror entry becomes redundant (AAO maintainers deprecate it).\n\nThe `v1_format_ref.agent_url` on each declaration SHOULD match the agent_url of the file's hosting location \u2014 platform-hosted formats point at the platform's agent, community-mirror formats point at `https://creative.adcontextprotocol.org/translated/<platform>`. This keeps the legacy named-format namespace converged regardless of which side hosts the catalog. See `docs/creative/canonical-formats.mdx` Meta Reels worked example.").optional(), "superseded_by": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Optional pointer indicating this adagents.json file has been superseded by another adagents.json at a different URL. Used by the AAO community-mirror lifecycle: when a platform (e.g., Meta) adopts AdCP and publishes its own adagents.json at `<platform-domain>/.well-known/adagents.json`, the AAO mirror file at `creative.adcontextprotocol.org/translated/<platform>/adagents.json` sets `superseded_by` to the platform-hosted URL. Buyer SDKs encountering a file with `superseded_by` SHOULD short-circuit and re-fetch from the named URL rather than serving stale content from the mirror. The mirror SHOULD continue serving with `superseded_by` set for \u22651 minor release after platform adoption so buyer caches keyed on the mirror URL get an explicit migration signal rather than a silent break.").optional(), "tags": import_zod.z.record(import_zod.z.string(), import_zod.z.object({ "name": import_zod.z.string().describe("Human-readable name for this tag"), "description": import_zod.z.string().describe("Description of what this tag represents") }).catchall(import_zod.z.any())).describe("Metadata for each tag referenced by properties. Provides human-readable context for property tag values.").optional(), "placement_tags": import_zod.z.record(import_zod.z.string(), import_zod.z.object({ "name": import_zod.z.string().describe("Human-readable name for this placement tag"), "description": import_zod.z.string().describe("Description of what this placement tag represents") }).catchall(import_zod.z.any())).describe("Metadata for each tag referenced by placements. Provides human-readable context for publisher-defined placement tag values used in grouping and authorization.").optional(), "authorized_agents": import_zod.z.array(import_zod.z.union([import_zod.z.object({ "authorization_type": import_zod.z.literal("property_ids").describe("Discriminator indicating authorization by specific property IDs"), "property_ids": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Identifier for a publisher property. Must be lowercase alphanumeric with underscores only.")).describe("Property IDs this agent is authorized for. Resolved against the top-level properties array in this file"), "collections": import_zod.z.array(import_zod.z.object({ "publisher_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where the adagents.json declaring these collections is hosted (e.g., 'mrbeast.com'). The collections array in that file contains the authoritative collection definitions."), "collection_ids": import_zod.z.array(import_zod.z.string()).describe("Collection IDs from the adagents.json collections array. Each ID must match a collection_id declared in that file. Omit to reference all collections declared in that file.").optional() }).catchall(import_zod.z.any()).describe("References collections declared in an adagents.json. Buyers resolve full collection objects by fetching the adagents.json at the given domain and matching collection_ids against its collections array. When collection_ids is omitted, the selector references every collection declared in that adagents.json \u2014 the bulk-grant form for authorization scoping (e.g., a host authorizing a channel owner's sales agent for all of the owner's collections without tracking owner-assigned IDs).")).describe("Optional collection constraints. When present, authorization only applies to inventory associated with these collections. A selector without collection_ids grants for all collections declared in that selector's publisher_domain adagents.json (the bulk-grant form for owner-sold carriage).").optional(), "placement_ids": import_zod.z.array(import_zod.z.string()).describe("Optional placement constraints. When present, authorization only applies to these placement IDs from the top-level placements array in this file.").optional(), "placement_tags": import_zod.z.array(import_zod.z.string()).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Optional placement tag constraints. When present, authorization only applies to placements whose tags include any of these publisher-defined values.").optional(), "delegation_type": import_zod.z.enum(["direct", "delegated", "ad_network"]).describe("Commercial relationship for this inventory path. 'direct' means the publisher treats this as a direct way to buy from them, even if a third party operates the software. 'delegated' means the agent is authorized to sell on the publisher's behalf. 'ad_network' means the inventory is sold as part of a network/package context rather than as the publisher's direct endpoint.").optional(), "exclusive": import_zod.z.boolean().describe("Whether this agent is the publisher's sole authorized path for the scoped inventory slice. When false or absent, other authorized agents may also sell the same inventory.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Optional ISO 3166-1 alpha-2 country codes limiting where this authorization applies. Omit for worldwide authorization.").optional(), "effective_from": import_zod.z.string().datetime().describe("Optional start time for this authorization window.").optional(), "effective_until": import_zod.z.string().datetime().describe("Optional end time for this authorization window.").optional() }).catchall(import_zod.z.any()).and(import_zod.z.object({ "url": import_zod.z.string().url().describe("The authorized agent's API endpoint URL. Callers comparing this URL against a registry (sales-agent list, signal-provider registry, TMP provider lookup, etc.) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality \u2014 two URLs that differ only in case, default port, or percent-encoding of unreserved characters are the same agent. See docs/reference/url-canonicalization."), "authorized_for": import_zod.z.string().min(1).max(500).describe("Human-readable description of what this agent is authorized to do \u2014 what it sells (for sales/property agents) or what data it provides (for signal agents). The variant the entry uses (`property_ids`, `signal_tags`, etc.) tells consumers which inflection applies; this field carries the operator-supplied label."), "signing_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().describe("Key identifier for selecting the correct signing key."), "kty": import_zod.z.string().describe("JWK key type, such as 'OKP', 'EC', or 'RSA'."), "alg": import_zod.z.string().describe("Expected signing algorithm for this key, such as 'EdDSA' or 'RS256'.").optional(), "use": import_zod.z.string().describe("Optional JWK use value. Typically 'sig' for signing keys.").optional(), "crv": import_zod.z.string().describe("Curve name for OKP or EC keys, such as 'Ed25519' or 'P-256'.").optional(), "x": import_zod.z.string().describe("Base64url-encoded public key x coordinate or public key value for OKP keys.").optional(), "y": import_zod.z.string().describe("Base64url-encoded public key y coordinate for EC keys.").optional(), "n": import_zod.z.string().describe("Base64url-encoded RSA modulus.").optional(), "e": import_zod.z.string().describe("Base64url-encoded RSA public exponent.").optional(), "revoked_at": import_zod.z.string().datetime().describe("Optional revocation timestamp. When present, verifiers MUST reject any signature produced with this key whose signing epoch (or equivalent time reference) is at or after this timestamp. The key may continue to appear in the trust anchor during a grace period so caches that have not yet refreshed still find the key and can evaluate the revocation marker. Keys past their revocation can be removed once the cache TTL (recommended: 5 minutes) has elapsed across all verifiers.").optional() }).catchall(import_zod.z.any()).describe("Publisher-attested public key material for an authorized agent. Buyers use these keys to verify signed agent responses against the trust anchor published in adagents.json rather than trusting key discovery from the agent domain alone.")).describe("Optional publisher-attested public signing keys for this agent. Use these as the trust anchor for verifying signed agent responses instead of relying on key discovery from the agent domain alone.").optional(), "encryption_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().max(8).describe("Key identifier. Opaque \u2014 MUST NOT encode geographic or deployment information."), "kty": import_zod.z.literal("OKP").describe("JWK key type. Must be OKP for X25519."), "crv": import_zod.z.literal("X25519").describe("Curve name. Must be X25519 for TMPX encryption."), "use": import_zod.z.literal("enc").describe("JWK use value. Must be enc for encryption keys."), "x": import_zod.z.string().describe("Base64url-encoded X25519 public key (32 bytes).") }).strict().describe("X25519 public key for HPKE encryption. Used for TMPX exposure token encryption with HPKE mode_base.")).describe("X25519 public keys for TMPX exposure token encryption. Each key identifies a cluster master that can decrypt TMPX tokens. Used with HPKE mode_base \u2014 read replicas encrypt with this public key, only the master can decrypt.").optional(), "last_updated": import_zod.z.string().datetime().describe("Optional ISO 8601 timestamp indicating when this `authorized_agents[]` entry last changed. Independent of the file-level `last_updated`. Lets validators perform a partial walk by skipping entries whose `last_updated` is older than their indexed value. Advisory \u2014 consumers MAY ignore and re-index the full file.").optional() }).describe("Fields shared by every variant of `authorized_agents[*]` in adagents.json, regardless of authorization_type. Variants `allOf` this base and add their discriminator-specific fields. Centralized to prevent drift across all authorization-type variants.")), import_zod.z.object({ "authorization_type": import_zod.z.literal("property_tags").describe("Discriminator indicating authorization by property tags"), "property_tags": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Tag for categorizing publisher properties. Must be lowercase alphanumeric with underscores only.")).describe("Tags identifying which properties this agent is authorized for. Resolved against the top-level properties array in this file using tag matching"), "collections": import_zod.z.array(import_zod.z.object({ "publisher_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where the adagents.json declaring these collections is hosted (e.g., 'mrbeast.com'). The collections array in that file contains the authoritative collection definitions."), "collection_ids": import_zod.z.array(import_zod.z.string()).describe("Collection IDs from the adagents.json collections array. Each ID must match a collection_id declared in that file. Omit to reference all collections declared in that file.").optional() }).catchall(import_zod.z.any()).describe("References collections declared in an adagents.json. Buyers resolve full collection objects by fetching the adagents.json at the given domain and matching collection_ids against its collections array. When collection_ids is omitted, the selector references every collection declared in that adagents.json \u2014 the bulk-grant form for authorization scoping (e.g., a host authorizing a channel owner's sales agent for all of the owner's collections without tracking owner-assigned IDs).")).describe("Optional collection constraints. When present, authorization only applies to inventory associated with these collections. A selector without collection_ids grants for all collections declared in that selector's publisher_domain adagents.json (the bulk-grant form for owner-sold carriage).").optional(), "placement_ids": import_zod.z.array(import_zod.z.string()).describe("Optional placement constraints. When present, authorization only applies to these placement IDs from the top-level placements array in this file.").optional(), "placement_tags": import_zod.z.array(import_zod.z.string()).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Optional placement tag constraints. When present, authorization only applies to placements whose tags include any of these publisher-defined values.").optional(), "delegation_type": import_zod.z.enum(["direct", "delegated", "ad_network"]).describe("Commercial relationship for this inventory path. 'direct' means the publisher treats this as a direct way to buy from them, even if a third party operates the software. 'delegated' means the agent is authorized to sell on the publisher's behalf. 'ad_network' means the inventory is sold as part of a network/package context rather than as the publisher's direct endpoint.").optional(), "exclusive": import_zod.z.boolean().describe("Whether this agent is the publisher's sole authorized path for the scoped inventory slice. When false or absent, other authorized agents may also sell the same inventory.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Optional ISO 3166-1 alpha-2 country codes limiting where this authorization applies. Omit for worldwide authorization.").optional(), "effective_from": import_zod.z.string().datetime().describe("Optional start time for this authorization window.").optional(), "effective_until": import_zod.z.string().datetime().describe("Optional end time for this authorization window.").optional() }).catchall(import_zod.z.any()).and(import_zod.z.object({ "url": import_zod.z.string().url().describe("The authorized agent's API endpoint URL. Callers comparing this URL against a registry (sales-agent list, signal-provider registry, TMP provider lookup, etc.) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality \u2014 two URLs that differ only in case, default port, or percent-encoding of unreserved characters are the same agent. See docs/reference/url-canonicalization."), "authorized_for": import_zod.z.string().min(1).max(500).describe("Human-readable description of what this agent is authorized to do \u2014 what it sells (for sales/property agents) or what data it provides (for signal agents). The variant the entry uses (`property_ids`, `signal_tags`, etc.) tells consumers which inflection applies; this field carries the operator-supplied label."), "signing_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().describe("Key identifier for selecting the correct signing key."), "kty": import_zod.z.string().describe("JWK key type, such as 'OKP', 'EC', or 'RSA'."), "alg": import_zod.z.string().describe("Expected signing algorithm for this key, such as 'EdDSA' or 'RS256'.").optional(), "use": import_zod.z.string().describe("Optional JWK use value. Typically 'sig' for signing keys.").optional(), "crv": import_zod.z.string().describe("Curve name for OKP or EC keys, such as 'Ed25519' or 'P-256'.").optional(), "x": import_zod.z.string().describe("Base64url-encoded public key x coordinate or public key value for OKP keys.").optional(), "y": import_zod.z.string().describe("Base64url-encoded public key y coordinate for EC keys.").optional(), "n": import_zod.z.string().describe("Base64url-encoded RSA modulus.").optional(), "e": import_zod.z.string().describe("Base64url-encoded RSA public exponent.").optional(), "revoked_at": import_zod.z.string().datetime().describe("Optional revocation timestamp. When present, verifiers MUST reject any signature produced with this key whose signing epoch (or equivalent time reference) is at or after this timestamp. The key may continue to appear in the trust anchor during a grace period so caches that have not yet refreshed still find the key and can evaluate the revocation marker. Keys past their revocation can be removed once the cache TTL (recommended: 5 minutes) has elapsed across all verifiers.").optional() }).catchall(import_zod.z.any()).describe("Publisher-attested public key material for an authorized agent. Buyers use these keys to verify signed agent responses against the trust anchor published in adagents.json rather than trusting key discovery from the agent domain alone.")).describe("Optional publisher-attested public signing keys for this agent. Use these as the trust anchor for verifying signed agent responses instead of relying on key discovery from the agent domain alone.").optional(), "encryption_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().max(8).describe("Key identifier. Opaque \u2014 MUST NOT encode geographic or deployment information."), "kty": import_zod.z.literal("OKP").describe("JWK key type. Must be OKP for X25519."), "crv": import_zod.z.literal("X25519").describe("Curve name. Must be X25519 for TMPX encryption."), "use": import_zod.z.literal("enc").describe("JWK use value. Must be enc for encryption keys."), "x": import_zod.z.string().describe("Base64url-encoded X25519 public key (32 bytes).") }).strict().describe("X25519 public key for HPKE encryption. Used for TMPX exposure token encryption with HPKE mode_base.")).describe("X25519 public keys for TMPX exposure token encryption. Each key identifies a cluster master that can decrypt TMPX tokens. Used with HPKE mode_base \u2014 read replicas encrypt with this public key, only the master can decrypt.").optional(), "last_updated": import_zod.z.string().datetime().describe("Optional ISO 8601 timestamp indicating when this `authorized_agents[]` entry last changed. Independent of the file-level `last_updated`. Lets validators perform a partial walk by skipping entries whose `last_updated` is older than their indexed value. Advisory \u2014 consumers MAY ignore and re-index the full file.").optional() }).describe("Fields shared by every variant of `authorized_agents[*]` in adagents.json, regardless of authorization_type. Variants `allOf` this base and add their discriminator-specific fields. Centralized to prevent drift across all authorization-type variants.")), import_zod.z.object({ "authorization_type": import_zod.z.literal("inline_properties").describe("Discriminator indicating authorization by inline property definitions. Companion field is `properties` (not `inline_properties`) \u2014 the only authorization_type whose companion field name does not mirror the discriminator value."), "properties": import_zod.z.array(import_zod.z.object({ "property_id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Unique identifier for this property (optional). Enables referencing properties by ID instead of repeating full objects.").optional(), "property_type": import_zod.z.enum(["website", "mobile_app", "ctv_app", "desktop_app", "dooh", "podcast", "radio", "linear_tv", "streaming_audio", "ai_assistant"]).describe("Type of advertising property"), "name": import_zod.z.string().describe("Human-readable property name"), "identifiers": import_zod.z.array(import_zod.z.object({ "type": import_zod.z.enum(["domain", "subdomain", "network_id", "ios_bundle", "android_package", "apple_app_store_id", "google_play_id", "roku_store_id", "fire_tv_asin", "samsung_app_id", "apple_tv_bundle", "bundle_id", "venue_id", "screen_id", "openooh_venue_type", "rss_url", "apple_podcast_id", "spotify_collection_id", "podcast_guid", "station_id", "facility_id"]).describe("Type of identifier for this property"), "value": import_zod.z.string().describe("The identifier value. For domain type: 'example.com' matches base domain plus www and m subdomains; 'edition.example.com' matches that specific subdomain; '*.example.com' matches ALL subdomains but NOT base domain") }).catchall(import_zod.z.any())).describe("Array of identifiers for this property"), "tags": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Tag for categorizing publisher properties. Must be lowercase alphanumeric with underscores only.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Tags for categorization and grouping (e.g., network membership, content categories)").optional(), "supported_channels": import_zod.z.array(import_zod.z.enum(["display", "olv", "social", "search", "ctv", "linear_tv", "radio", "streaming_audio", "podcast", "dooh", "ooh", "print", "cinema", "email", "gaming", "retail_media", "influencer", "affiliate", "product_placement", "sponsored_intelligence"]).describe("Standardized advertising media channels describing how buyers allocate budget. Channels are planning abstractions, not technical substrates. See the Media Channel Taxonomy specification for detailed definitions.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Advertising channels this property supports (e.g., ['display', 'olv', 'social']). Publishers declare which channels their inventory aligns with. Properties may support multiple channels. See the Media Channel Taxonomy for definitions.").optional(), "publisher_domain": import_zod.z.string().describe("Domain where adagents.json should be checked for authorization validation. Optional in adagents.json (file location implies domain).").optional() }).catchall(import_zod.z.any()).describe("An advertising property that can be validated via adagents.json")).describe('Specific properties this agent is authorized for, defined inline on the agent entry (alternative to property_ids/property_tags). Note: this is the companion field for `authorization_type: "inline_properties"` \u2014 the field is named `properties`, not `inline_properties`.'), "collections": import_zod.z.array(import_zod.z.object({ "publisher_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where the adagents.json declaring these collections is hosted (e.g., 'mrbeast.com'). The collections array in that file contains the authoritative collection definitions."), "collection_ids": import_zod.z.array(import_zod.z.string()).describe("Collection IDs from the adagents.json collections array. Each ID must match a collection_id declared in that file. Omit to reference all collections declared in that file.").optional() }).catchall(import_zod.z.any()).describe("References collections declared in an adagents.json. Buyers resolve full collection objects by fetching the adagents.json at the given domain and matching collection_ids against its collections array. When collection_ids is omitted, the selector references every collection declared in that adagents.json \u2014 the bulk-grant form for authorization scoping (e.g., a host authorizing a channel owner's sales agent for all of the owner's collections without tracking owner-assigned IDs).")).describe("Optional collection constraints. When present, authorization only applies to inventory associated with these collections. A selector without collection_ids grants for all collections declared in that selector's publisher_domain adagents.json (the bulk-grant form for owner-sold carriage).").optional(), "placement_ids": import_zod.z.array(import_zod.z.string()).describe("Optional placement constraints. When present, authorization only applies to these placement IDs from the top-level placements array in this file.").optional(), "placement_tags": import_zod.z.array(import_zod.z.string()).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Optional placement tag constraints. When present, authorization only applies to placements whose tags include any of these publisher-defined values.").optional(), "delegation_type": import_zod.z.enum(["direct", "delegated", "ad_network"]).describe("Commercial relationship for this inventory path. 'direct' means the publisher treats this as a direct way to buy from them, even if a third party operates the software. 'delegated' means the agent is authorized to sell on the publisher's behalf. 'ad_network' means the inventory is sold as part of a network/package context rather than as the publisher's direct endpoint.").optional(), "exclusive": import_zod.z.boolean().describe("Whether this agent is the publisher's sole authorized path for the scoped inventory slice. When false or absent, other authorized agents may also sell the same inventory.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Optional ISO 3166-1 alpha-2 country codes limiting where this authorization applies. Omit for worldwide authorization.").optional(), "effective_from": import_zod.z.string().datetime().describe("Optional start time for this authorization window.").optional(), "effective_until": import_zod.z.string().datetime().describe("Optional end time for this authorization window.").optional() }).catchall(import_zod.z.any()).and(import_zod.z.object({ "url": import_zod.z.string().url().describe("The authorized agent's API endpoint URL. Callers comparing this URL against a registry (sales-agent list, signal-provider registry, TMP provider lookup, etc.) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality \u2014 two URLs that differ only in case, default port, or percent-encoding of unreserved characters are the same agent. See docs/reference/url-canonicalization."), "authorized_for": import_zod.z.string().min(1).max(500).describe("Human-readable description of what this agent is authorized to do \u2014 what it sells (for sales/property agents) or what data it provides (for signal agents). The variant the entry uses (`property_ids`, `signal_tags`, etc.) tells consumers which inflection applies; this field carries the operator-supplied label."), "signing_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().describe("Key identifier for selecting the correct signing key."), "kty": import_zod.z.string().describe("JWK key type, such as 'OKP', 'EC', or 'RSA'."), "alg": import_zod.z.string().describe("Expected signing algorithm for this key, such as 'EdDSA' or 'RS256'.").optional(), "use": import_zod.z.string().describe("Optional JWK use value. Typically 'sig' for signing keys.").optional(), "crv": import_zod.z.string().describe("Curve name for OKP or EC keys, such as 'Ed25519' or 'P-256'.").optional(), "x": import_zod.z.string().describe("Base64url-encoded public key x coordinate or public key value for OKP keys.").optional(), "y": import_zod.z.string().describe("Base64url-encoded public key y coordinate for EC keys.").optional(), "n": import_zod.z.string().describe("Base64url-encoded RSA modulus.").optional(), "e": import_zod.z.string().describe("Base64url-encoded RSA public exponent.").optional(), "revoked_at": import_zod.z.string().datetime().describe("Optional revocation timestamp. When present, verifiers MUST reject any signature produced with this key whose signing epoch (or equivalent time reference) is at or after this timestamp. The key may continue to appear in the trust anchor during a grace period so caches that have not yet refreshed still find the key and can evaluate the revocation marker. Keys past their revocation can be removed once the cache TTL (recommended: 5 minutes) has elapsed across all verifiers.").optional() }).catchall(import_zod.z.any()).describe("Publisher-attested public key material for an authorized agent. Buyers use these keys to verify signed agent responses against the trust anchor published in adagents.json rather than trusting key discovery from the agent domain alone.")).describe("Optional publisher-attested public signing keys for this agent. Use these as the trust anchor for verifying signed agent responses instead of relying on key discovery from the agent domain alone.").optional(), "encryption_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().max(8).describe("Key identifier. Opaque \u2014 MUST NOT encode geographic or deployment information."), "kty": import_zod.z.literal("OKP").describe("JWK key type. Must be OKP for X25519."), "crv": import_zod.z.literal("X25519").describe("Curve name. Must be X25519 for TMPX encryption."), "use": import_zod.z.literal("enc").describe("JWK use value. Must be enc for encryption keys."), "x": import_zod.z.string().describe("Base64url-encoded X25519 public key (32 bytes).") }).strict().describe("X25519 public key for HPKE encryption. Used for TMPX exposure token encryption with HPKE mode_base.")).describe("X25519 public keys for TMPX exposure token encryption. Each key identifies a cluster master that can decrypt TMPX tokens. Used with HPKE mode_base \u2014 read replicas encrypt with this public key, only the master can decrypt.").optional(), "last_updated": import_zod.z.string().datetime().describe("Optional ISO 8601 timestamp indicating when this `authorized_agents[]` entry last changed. Independent of the file-level `last_updated`. Lets validators perform a partial walk by skipping entries whose `last_updated` is older than their indexed value. Advisory \u2014 consumers MAY ignore and re-index the full file.").optional() }).describe("Fields shared by every variant of `authorized_agents[*]` in adagents.json, regardless of authorization_type. Variants `allOf` this base and add their discriminator-specific fields. Centralized to prevent drift across all authorization-type variants.")), import_zod.z.object({ "authorization_type": import_zod.z.literal("publisher_properties").describe("Discriminator indicating authorization for properties from other publisher domains"), "publisher_properties": import_zod.z.array(import_zod.z.union([import_zod.z.object({ "publisher_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where publisher's adagents.json is hosted (e.g., 'cnn.com'). XOR with `publisher_domains` \u2014 exactly one MUST be present on each `publisher_properties[]` entry; both-present and neither-present both fail validation.").optional(), "publisher_domains": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Compact form for fanning the same selector across many publishers (e.g., a managed network listing every publisher it represents). Each entry is the domain where that publisher's adagents.json is hosted. Each listed domain MUST be canonicalized to lowercase (the `pattern` already rejects uppercase). Mutually exclusive with `publisher_domain`. Each listed domain counts as explicitly scoped for the `managerdomain` fallback safety rule.").optional(), "selection_type": import_zod.z.literal("all").describe("Discriminator indicating all properties from each addressed publisher are included") }).catchall(import_zod.z.any()).and(import_zod.z.intersection(import_zod.z.any().refine((value) => !import_zod.z.any().safeParse(value).success, "Invalid input: Should NOT be valid against schema"), import_zod.z.union([import_zod.z.any(), import_zod.z.any()]))).describe("Select all properties from one publisher domain, or from each publisher domain when `publisher_domains` is used. Consumers MAY satisfy the selector from the parent file's top-level `properties[]` when those properties carry a `publisher_domain` matching one of the listed domains (see Resolution paths in the spec)."), import_zod.z.object({ "publisher_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')."), "selection_type": import_zod.z.literal("by_id").describe("Discriminator indicating selection by specific property IDs"), "property_ids": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Identifier for a publisher property. Must be lowercase alphanumeric with underscores only.")).describe("Specific property IDs from the publisher's adagents.json") }).catchall(import_zod.z.any()).describe("Select specific properties by ID. Single-publisher only \u2014 property IDs are publisher-scoped, so the compact `publisher_domains[]` form is intentionally NOT available for this selector. Use multiple `publisher_properties[]` entries (one per publisher) when each publisher's ID set differs."), import_zod.z.object({ "publisher_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where publisher's adagents.json is hosted (e.g., 'cnn.com'). XOR with `publisher_domains` \u2014 exactly one MUST be present on each `publisher_properties[]` entry; both-present and neither-present both fail validation.").optional(), "publisher_domains": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Compact form for fanning the same tag predicate across many publishers (canonical managed-network shape). Each entry is the domain where that publisher's adagents.json is hosted. Each listed domain MUST be canonicalized to lowercase (the `pattern` already rejects uppercase). Mutually exclusive with `publisher_domain`. Each listed domain counts as explicitly scoped for the `managerdomain` fallback safety rule.").optional(), "selection_type": import_zod.z.literal("by_tag").describe("Discriminator indicating selection by property tags"), "property_tags": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Tag for categorizing publisher properties. Must be lowercase alphanumeric with underscores only.")).describe("Property tags resolved against each addressed publisher's adagents.json, OR against the parent file's top-level `properties[]` when those properties carry a `publisher_domain` matching the selector. Selector covers all properties carrying any of these tags.") }).catchall(import_zod.z.any()).and(import_zod.z.intersection(import_zod.z.any().refine((value) => !import_zod.z.any().safeParse(value).success, "Invalid input: Should NOT be valid against schema"), import_zod.z.union([import_zod.z.any(), import_zod.z.any()]))).describe("Select properties by tag membership. With `publisher_domains`, the same `property_tags` predicate is resolved against each listed publisher's adagents.json \u2014 the common managed-network case where every represented site tags inventory with a shared label. Consumers MAY also satisfy the predicate from the parent file's top-level `properties[]` when those properties carry a `publisher_domain` matching one of the selector's `publisher_domains[]` (see Resolution paths in the spec).")]).describe("Selects properties from a publisher's adagents.json. Used for both product definitions and agent authorization. Supports three selection patterns: all properties, specific IDs, or by tags. Each selector targets one publisher via `publisher_domain` (string) or a fan-out across many publishers that share the same selector via `publisher_domains` (array). Exactly one of `publisher_domain` or `publisher_domains` MUST be present. When `publisher_domains` is used, the selector is logically equivalent to repeating the same entry once per listed domain.")).describe("Properties from other publisher domains this agent is authorized for. Each entry specifies a publisher domain and which of their properties this agent can sell"), "collections": import_zod.z.array(import_zod.z.object({ "publisher_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where the adagents.json declaring these collections is hosted (e.g., 'mrbeast.com'). The collections array in that file contains the authoritative collection definitions."), "collection_ids": import_zod.z.array(import_zod.z.string()).describe("Collection IDs from the adagents.json collections array. Each ID must match a collection_id declared in that file. Omit to reference all collections declared in that file.").optional() }).catchall(import_zod.z.any()).describe("References collections declared in an adagents.json. Buyers resolve full collection objects by fetching the adagents.json at the given domain and matching collection_ids against its collections array. When collection_ids is omitted, the selector references every collection declared in that adagents.json \u2014 the bulk-grant form for authorization scoping (e.g., a host authorizing a channel owner's sales agent for all of the owner's collections without tracking owner-assigned IDs).")).describe("Optional collection constraints. When present, authorization only applies to inventory associated with these collections. A selector without collection_ids grants for all collections declared in that selector's publisher_domain adagents.json (the bulk-grant form for owner-sold carriage).").optional(), "placement_ids": import_zod.z.array(import_zod.z.string()).describe("Optional placement constraints. When present, authorization only applies to these placement IDs from the top-level placements array in this file.").optional(), "placement_tags": import_zod.z.array(import_zod.z.string()).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Optional placement tag constraints. When present, authorization only applies to placements whose tags include any of these publisher-defined values.").optional(), "delegation_type": import_zod.z.enum(["direct", "delegated", "ad_network"]).describe("Commercial relationship for this inventory path. 'direct' means the publisher treats this as a direct way to buy from them, even if a third party operates the software. 'delegated' means the agent is authorized to sell on the publisher's behalf. 'ad_network' means the inventory is sold as part of a network/package context rather than as the publisher's direct endpoint.").optional(), "exclusive": import_zod.z.boolean().describe("Whether this agent is the publisher's sole authorized path for the scoped inventory slice. When false or absent, other authorized agents may also sell the same inventory.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Optional ISO 3166-1 alpha-2 country codes limiting where this authorization applies. Omit for worldwide authorization.").optional(), "effective_from": import_zod.z.string().datetime().describe("Optional start time for this authorization window.").optional(), "effective_until": import_zod.z.string().datetime().describe("Optional end time for this authorization window.").optional() }).catchall(import_zod.z.any()).and(import_zod.z.object({ "url": import_zod.z.string().url().describe("The authorized agent's API endpoint URL. Callers comparing this URL against a registry (sales-agent list, signal-provider registry, TMP provider lookup, etc.) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality \u2014 two URLs that differ only in case, default port, or percent-encoding of unreserved characters are the same agent. See docs/reference/url-canonicalization."), "authorized_for": import_zod.z.string().min(1).max(500).describe("Human-readable description of what this agent is authorized to do \u2014 what it sells (for sales/property agents) or what data it provides (for signal agents). The variant the entry uses (`property_ids`, `signal_tags`, etc.) tells consumers which inflection applies; this field carries the operator-supplied label."), "signing_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().describe("Key identifier for selecting the correct signing key."), "kty": import_zod.z.string().describe("JWK key type, such as 'OKP', 'EC', or 'RSA'."), "alg": import_zod.z.string().describe("Expected signing algorithm for this key, such as 'EdDSA' or 'RS256'.").optional(), "use": import_zod.z.string().describe("Optional JWK use value. Typically 'sig' for signing keys.").optional(), "crv": import_zod.z.string().describe("Curve name for OKP or EC keys, such as 'Ed25519' or 'P-256'.").optional(), "x": import_zod.z.string().describe("Base64url-encoded public key x coordinate or public key value for OKP keys.").optional(), "y": import_zod.z.string().describe("Base64url-encoded public key y coordinate for EC keys.").optional(), "n": import_zod.z.string().describe("Base64url-encoded RSA modulus.").optional(), "e": import_zod.z.string().describe("Base64url-encoded RSA public exponent.").optional(), "revoked_at": import_zod.z.string().datetime().describe("Optional revocation timestamp. When present, verifiers MUST reject any signature produced with this key whose signing epoch (or equivalent time reference) is at or after this timestamp. The key may continue to appear in the trust anchor during a grace period so caches that have not yet refreshed still find the key and can evaluate the revocation marker. Keys past their revocation can be removed once the cache TTL (recommended: 5 minutes) has elapsed across all verifiers.").optional() }).catchall(import_zod.z.any()).describe("Publisher-attested public key material for an authorized agent. Buyers use these keys to verify signed agent responses against the trust anchor published in adagents.json rather than trusting key discovery from the agent domain alone.")).describe("Optional publisher-attested public signing keys for this agent. Use these as the trust anchor for verifying signed agent responses instead of relying on key discovery from the agent domain alone.").optional(), "encryption_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().max(8).describe("Key identifier. Opaque \u2014 MUST NOT encode geographic or deployment information."), "kty": import_zod.z.literal("OKP").describe("JWK key type. Must be OKP for X25519."), "crv": import_zod.z.literal("X25519").describe("Curve name. Must be X25519 for TMPX encryption."), "use": import_zod.z.literal("enc").describe("JWK use value. Must be enc for encryption keys."), "x": import_zod.z.string().describe("Base64url-encoded X25519 public key (32 bytes).") }).strict().describe("X25519 public key for HPKE encryption. Used for TMPX exposure token encryption with HPKE mode_base.")).describe("X25519 public keys for TMPX exposure token encryption. Each key identifies a cluster master that can decrypt TMPX tokens. Used with HPKE mode_base \u2014 read replicas encrypt with this public key, only the master can decrypt.").optional(), "last_updated": import_zod.z.string().datetime().describe("Optional ISO 8601 timestamp indicating when this `authorized_agents[]` entry last changed. Independent of the file-level `last_updated`. Lets validators perform a partial walk by skipping entries whose `last_updated` is older than their indexed value. Advisory \u2014 consumers MAY ignore and re-index the full file.").optional() }).describe("Fields shared by every variant of `authorized_agents[*]` in adagents.json, regardless of authorization_type. Variants `allOf` this base and add their discriminator-specific fields. Centralized to prevent drift across all authorization-type variants.")), import_zod.z.object({ "authorization_type": import_zod.z.literal("signal_ids").describe("Discriminator indicating authorization by specific signal IDs"), "signal_ids": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-zA-Z0-9_-]+$"))).describe("Signal IDs this agent is authorized to resell. Resolved against the top-level signals array in this file") }).catchall(import_zod.z.any()).and(import_zod.z.object({ "url": import_zod.z.string().url().describe("The authorized agent's API endpoint URL. Callers comparing this URL against a registry (sales-agent list, signal-provider registry, TMP provider lookup, etc.) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality \u2014 two URLs that differ only in case, default port, or percent-encoding of unreserved characters are the same agent. See docs/reference/url-canonicalization."), "authorized_for": import_zod.z.string().min(1).max(500).describe("Human-readable description of what this agent is authorized to do \u2014 what it sells (for sales/property agents) or what data it provides (for signal agents). The variant the entry uses (`property_ids`, `signal_tags`, etc.) tells consumers which inflection applies; this field carries the operator-supplied label."), "signing_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().describe("Key identifier for selecting the correct signing key."), "kty": import_zod.z.string().describe("JWK key type, such as 'OKP', 'EC', or 'RSA'."), "alg": import_zod.z.string().describe("Expected signing algorithm for this key, such as 'EdDSA' or 'RS256'.").optional(), "use": import_zod.z.string().describe("Optional JWK use value. Typically 'sig' for signing keys.").optional(), "crv": import_zod.z.string().describe("Curve name for OKP or EC keys, such as 'Ed25519' or 'P-256'.").optional(), "x": import_zod.z.string().describe("Base64url-encoded public key x coordinate or public key value for OKP keys.").optional(), "y": import_zod.z.string().describe("Base64url-encoded public key y coordinate for EC keys.").optional(), "n": import_zod.z.string().describe("Base64url-encoded RSA modulus.").optional(), "e": import_zod.z.string().describe("Base64url-encoded RSA public exponent.").optional(), "revoked_at": import_zod.z.string().datetime().describe("Optional revocation timestamp. When present, verifiers MUST reject any signature produced with this key whose signing epoch (or equivalent time reference) is at or after this timestamp. The key may continue to appear in the trust anchor during a grace period so caches that have not yet refreshed still find the key and can evaluate the revocation marker. Keys past their revocation can be removed once the cache TTL (recommended: 5 minutes) has elapsed across all verifiers.").optional() }).catchall(import_zod.z.any()).describe("Publisher-attested public key material for an authorized agent. Buyers use these keys to verify signed agent responses against the trust anchor published in adagents.json rather than trusting key discovery from the agent domain alone.")).describe("Optional publisher-attested public signing keys for this agent. Use these as the trust anchor for verifying signed agent responses instead of relying on key discovery from the agent domain alone.").optional(), "encryption_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().max(8).describe("Key identifier. Opaque \u2014 MUST NOT encode geographic or deployment information."), "kty": import_zod.z.literal("OKP").describe("JWK key type. Must be OKP for X25519."), "crv": import_zod.z.literal("X25519").describe("Curve name. Must be X25519 for TMPX encryption."), "use": import_zod.z.literal("enc").describe("JWK use value. Must be enc for encryption keys."), "x": import_zod.z.string().describe("Base64url-encoded X25519 public key (32 bytes).") }).strict().describe("X25519 public key for HPKE encryption. Used for TMPX exposure token encryption with HPKE mode_base.")).describe("X25519 public keys for TMPX exposure token encryption. Each key identifies a cluster master that can decrypt TMPX tokens. Used with HPKE mode_base \u2014 read replicas encrypt with this public key, only the master can decrypt.").optional(), "last_updated": import_zod.z.string().datetime().describe("Optional ISO 8601 timestamp indicating when this `authorized_agents[]` entry last changed. Independent of the file-level `last_updated`. Lets validators perform a partial walk by skipping entries whose `last_updated` is older than their indexed value. Advisory \u2014 consumers MAY ignore and re-index the full file.").optional() }).describe("Fields shared by every variant of `authorized_agents[*]` in adagents.json, regardless of authorization_type. Variants `allOf` this base and add their discriminator-specific fields. Centralized to prevent drift across all authorization-type variants.")).describe("Authorization for signals by specific signal IDs"), import_zod.z.object({ "authorization_type": import_zod.z.literal("signal_tags").describe("Discriminator indicating authorization by signal tags"), "signal_tags": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_-]+$"))).describe("Signal tags this agent is authorized for. Agent can resell all signals with these tags") }).catchall(import_zod.z.any()).and(import_zod.z.object({ "url": import_zod.z.string().url().describe("The authorized agent's API endpoint URL. Callers comparing this URL against a registry (sales-agent list, signal-provider registry, TMP provider lookup, etc.) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality \u2014 two URLs that differ only in case, default port, or percent-encoding of unreserved characters are the same agent. See docs/reference/url-canonicalization."), "authorized_for": import_zod.z.string().min(1).max(500).describe("Human-readable description of what this agent is authorized to do \u2014 what it sells (for sales/property agents) or what data it provides (for signal agents). The variant the entry uses (`property_ids`, `signal_tags`, etc.) tells consumers which inflection applies; this field carries the operator-supplied label."), "signing_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().describe("Key identifier for selecting the correct signing key."), "kty": import_zod.z.string().describe("JWK key type, such as 'OKP', 'EC', or 'RSA'."), "alg": import_zod.z.string().describe("Expected signing algorithm for this key, such as 'EdDSA' or 'RS256'.").optional(), "use": import_zod.z.string().describe("Optional JWK use value. Typically 'sig' for signing keys.").optional(), "crv": import_zod.z.string().describe("Curve name for OKP or EC keys, such as 'Ed25519' or 'P-256'.").optional(), "x": import_zod.z.string().describe("Base64url-encoded public key x coordinate or public key value for OKP keys.").optional(), "y": import_zod.z.string().describe("Base64url-encoded public key y coordinate for EC keys.").optional(), "n": import_zod.z.string().describe("Base64url-encoded RSA modulus.").optional(), "e": import_zod.z.string().describe("Base64url-encoded RSA public exponent.").optional(), "revoked_at": import_zod.z.string().datetime().describe("Optional revocation timestamp. When present, verifiers MUST reject any signature produced with this key whose signing epoch (or equivalent time reference) is at or after this timestamp. The key may continue to appear in the trust anchor during a grace period so caches that have not yet refreshed still find the key and can evaluate the revocation marker. Keys past their revocation can be removed once the cache TTL (recommended: 5 minutes) has elapsed across all verifiers.").optional() }).catchall(import_zod.z.any()).describe("Publisher-attested public key material for an authorized agent. Buyers use these keys to verify signed agent responses against the trust anchor published in adagents.json rather than trusting key discovery from the agent domain alone.")).describe("Optional publisher-attested public signing keys for this agent. Use these as the trust anchor for verifying signed agent responses instead of relying on key discovery from the agent domain alone.").optional(), "encryption_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().max(8).describe("Key identifier. Opaque \u2014 MUST NOT encode geographic or deployment information."), "kty": import_zod.z.literal("OKP").describe("JWK key type. Must be OKP for X25519."), "crv": import_zod.z.literal("X25519").describe("Curve name. Must be X25519 for TMPX encryption."), "use": import_zod.z.literal("enc").describe("JWK use value. Must be enc for encryption keys."), "x": import_zod.z.string().describe("Base64url-encoded X25519 public key (32 bytes).") }).strict().describe("X25519 public key for HPKE encryption. Used for TMPX exposure token encryption with HPKE mode_base.")).describe("X25519 public keys for TMPX exposure token encryption. Each key identifies a cluster master that can decrypt TMPX tokens. Used with HPKE mode_base \u2014 read replicas encrypt with this public key, only the master can decrypt.").optional(), "last_updated": import_zod.z.string().datetime().describe("Optional ISO 8601 timestamp indicating when this `authorized_agents[]` entry last changed. Independent of the file-level `last_updated`. Lets validators perform a partial walk by skipping entries whose `last_updated` is older than their indexed value. Advisory \u2014 consumers MAY ignore and re-index the full file.").optional() }).describe("Fields shared by every variant of `authorized_agents[*]` in adagents.json, regardless of authorization_type. Variants `allOf` this base and add their discriminator-specific fields. Centralized to prevent drift across all authorization-type variants.")).describe("Authorization for signals by tag membership")])).describe("Array of sales agents authorized to make inventory from this file available to buyers. Authorization can be scoped to specific properties, collections, countries, and time windows, with optional delegation metadata indicating whether the path is direct, delegated, or network-mediated. MAY be empty (`[]`) for a catalog-only community mirror \u2014 a file that publishes `formats`/`properties`/`placements` (with `catalog_etag`) for a platform that has not adopted AdCP, where there is no sales agent to authorize (see `catalog_etag`, `formats`, `superseded_by`). An empty array asserts *no sales authorization*: validators MUST NOT read it as deny-all, authorize-all, or a revocation, MUST NOT treat its presence as an error, and MUST still consume the catalog arrays."), "last_updated": import_zod.z.string().datetime().describe("ISO 8601 timestamp indicating when this file was last updated").optional(), "property_features": import_zod.z.array(import_zod.z.object({ "url": import_zod.z.string().url().describe("The agent's API endpoint URL. Callers comparing this URL against a feature-provider registry MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. See docs/reference/url-canonicalization."), "name": import_zod.z.string().describe("Human-readable name of the vendor/agent (e.g., 'Scope3', 'TAG', 'OneTrust')"), "features": import_zod.z.array(import_zod.z.string()).describe("Feature IDs this agent provides (e.g., 'carbon_score', 'tag_certified_against_fraud'). Use get_adcp_capabilities on the agent for full definitions."), "publisher_id": import_zod.z.string().describe("Optional publisher identifier at this agent (for lookup)").optional() }).catchall(import_zod.z.any())).describe("[AdCP 3.0] Optional list of agents that provide property feature data (certifications, scores, compliance status). Used for discovery - actual data is accessed through property list filters.").optional(), "signals": import_zod.z.array(import_zod.z.object({ "id": import_zod.z.string().regex(new RegExp("^[a-zA-Z0-9_-]+$")).describe("Signal identifier within the publishing domain's adagents.json signals[]"), "name": import_zod.z.string().min(1).max(255).describe("Human-readable signal name"), "description": import_zod.z.string().max(2e3).describe("Detailed description of what this signal represents and how it's derived").optional(), "value_type": import_zod.z.enum(["binary", "categorical", "numeric"]).describe("The data type of this signal's values"), "tags": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_-]+$"))).describe("Tags for grouping and filtering this domain's published signal definitions").optional(), "allowed_values": import_zod.z.array(import_zod.z.string()).describe("For categorical signals, the valid values users can be assigned").optional(), "restricted_attributes": import_zod.z.array(import_zod.z.enum(["racial_ethnic_origin", "political_opinions", "religious_beliefs", "trade_union_membership", "health_data", "sex_life_sexual_orientation", "genetic_data", "biometric_data", "age", "familial_status"]).describe("Personal data categories that may be restricted from use in audience targeting. Combines GDPR Article 9 special categories with US civil-rights protected classes (FHA familial_status, ADEA age). Used in two places: (1) on campaign plans via restricted_attributes to declare which categories are prohibited, and (2) on signal-definition.json via restricted_attributes to declare which categories a signal touches. Governance agents match plan restrictions against signal declarations for structural validation.")).describe("Restricted attribute categories this signal touches. Data providers SHOULD declare these so governance agents can structurally match signals against a plan's restricted_attributes without relying on semantic inference from the signal name or description.").optional(), "demographic_predicate": import_zod.z.object({ "age": import_zod.z.object({ "min": import_zod.z.number().int().gte(0).lte(150).describe("Inclusive minimum age in completed years. Omit for an open lower bound.").optional(), "max": import_zod.z.number().int().gte(0).lte(150).describe("Inclusive maximum age in completed years. Omit for an open upper bound.").optional(), "include_unknown": import_zod.z.boolean().describe("Whether delivery to people whose age is unavailable is part of this predicate. This field has no default and MUST be supplied.") }).catchall(import_zod.z.any()).and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("A canonical audience-age predicate in completed integer years. min and max are inclusive; omitting one bound means no restriction in that direction. At least one bound is required. include_unknown is always explicit because people whose age is unavailable are not members of any numeric interval. Implementations MUST reject min greater than max; JSON Schema draft-07 cannot compare sibling numeric values.") }).catchall(import_zod.z.any()).describe("Authoritative machine-readable demographic meaning for this signal. Signal names and taxonomy labels alone never establish exact demographic equivalence. Signals carrying this field MUST also declare restricted_attributes including age.").optional(), "policy_categories": import_zod.z.array(import_zod.z.string()).describe("Policy categories this signal is sensitive for (e.g., a children's interest signal declares ['children_directed']). Governance agents match these against a plan's policy_categories to flag sensitive data usage.").optional(), "range": import_zod.z.object({ "min": import_zod.z.number().describe("Minimum value"), "max": import_zod.z.number().describe("Maximum value"), "unit": import_zod.z.string().describe("Unit of measurement (e.g., 'score', 'dollars', 'years')").optional() }).strict().describe("For numeric signals, the valid value range").optional(), "taxonomy": import_zod.z.object({ "ref": import_zod.z.string().url().describe("URI identifying the taxonomy or taxonomy documentation."), "version": import_zod.z.string().describe("Version identifier for the taxonomy when the taxonomy has versioned definitions.").optional(), "segtax": import_zod.z.number().int().gte(1).describe("OpenRTB segtax code when the taxonomy maps to an OpenRTB segment taxonomy.").optional(), "etag": import_zod.z.string().describe("Optional validator for custom taxonomy definitions so consumers can detect drift between signal publication and taxonomy resolution.").optional(), "values": import_zod.z.array(import_zod.z.object({ "id": import_zod.z.string().min(1).describe("Taxonomy node identifier."), "path": import_zod.z.string().describe("Optional human-readable or taxonomy-native path for display and review.").optional(), "modifiers": import_zod.z.array(import_zod.z.string()).describe("Optional taxonomy-specific modifiers that qualify the node.").optional() }).strict()).describe("Taxonomy node values that describe this signal. These are meaning/discovery metadata for the signal definition, not the values a buyer submits in package targeting expressions."), "value_mappings": import_zod.z.array(import_zod.z.object({ "value": import_zod.z.string().describe("Categorical value from allowed_values[]."), "taxonomy_value_id": import_zod.z.string().describe("Taxonomy node identifier corresponding to this categorical value."), "path": import_zod.z.string().describe("Optional human-readable or taxonomy-native path for display and review.").optional(), "modifiers": import_zod.z.array(import_zod.z.string()).describe("Optional taxonomy-specific modifiers that qualify the mapped value.").optional() }).strict()).describe("For categorical signals, maps package-targeting allowed_values[] strings to stable taxonomy node identifiers. The allowed_values[] strings remain the wire values buyers submit; this mapping explains how those strings resolve into the published taxonomy. Each value_mappings[].value SHOULD match one of the signal's allowed_values[] entries; JSON Schema draft-07 cannot enforce this cross-array constraint.").optional(), "parent_match_behavior": import_zod.z.enum(["exact_only", "descendants_supported", "unknown"]).describe("Whether this signal definition supports treating a parent taxonomy node as matching descendant nodes for discovery/filtering or seller-side expansion. 'exact_only' means only explicitly listed node ids match. 'descendants_supported' means the seller can expand known, version-pinned parent nodes to descendants internally, typically by ORing the children in its execution system. 'unknown' means the provider has not declared parent-node behavior. This field is metadata about discovery/translation behavior, not a package targeting operator.").optional() }).strict().describe("Optional taxonomy metadata describing what this signal means in an external audience, content, retail-media, or provider-owned taxonomy. Taxonomy metadata does not create a new value_type and does not change package targeting grammar: buyers still target the named signal according to value_type. When a taxonomy value is a parent node, parent/descendant expansion is seller behavior and must be declared through parent_match_behavior rather than assumed.").optional(), "segmentation_criteria": import_zod.z.string().max(500).describe("Rules governing inclusion of identifiers in the segment. Aligns with IAB Data Transparency Standard audience criteria disclosure.").optional(), "criteria_url": import_zod.z.string().url().describe("Optional URL to a longer-form methodology or criteria document. This is a disclosure pointer; buyers should not branch programmatically on the linked content.").optional(), "data_sources": import_zod.z.array(import_zod.z.enum(["app_behavior", "app_usage", "web_usage", "geo_location", "email", "tv_ott_or_stb_device", "panel", "online_ecommerce", "credit_data", "loyalty_card", "transaction", "online_survey", "offline_survey", "public_record_census", "public_record_voter_file", "public_record_other", "offline_transaction"])).describe("Origin categories of the raw data used to compile the signal, aligned with IAB Data Transparency Standard source disclosure. Use 'panel' for respondent-panel or JIC-style audience sources. Offline and public-record sources require onboarder disclosure. Co-viewing projection and reconciliation of seller claims against a JIC or measurement vendor belong in measurement reporting/vendor metrics rather than package signal targeting.").optional(), "methodology": import_zod.z.enum(["observed", "declared", "derived", "inferred", "modeled"]).describe("How the signal's audience membership or attribute was determined. 'modeled' requires the modeling block.").optional(), "audience_expansion": import_zod.z.boolean().describe("Whether look-alike or similar-audience expansion was used to include additional identifiers. When true, modeling is required.").optional(), "device_expansion": import_zod.z.boolean().describe("Whether the signal was expanded deterministically across devices of the same user, household, or business. Probabilistic cross-device expansion is modeling and should use methodology 'modeled' or the modeling block.").optional(), "refresh_cadence": import_zod.z.enum(["intra_day", "daily", "weekly", "monthly", "bi_monthly", "quarterly", "bi_annually", "annually"]).describe("Cadence at which the signal definition's underlying segment membership is refreshed.").optional(), "lookback_window": import_zod.z.enum(["intra_day", "daily", "weekly", "monthly", "bi_monthly", "quarterly", "bi_annually", "annually"]).describe("Time window in which a qualifying event can occur for inclusion.").optional(), "onboarder": import_zod.z.object({ "match_keys": import_zod.z.array(import_zod.z.enum(["name", "address", "email", "postal", "lat_long", "mobile_id", "cookie_id", "ip", "customer_id", "phone"])), "pre_onboarding_audience_expansion": import_zod.z.boolean().optional(), "pre_onboarding_device_expansion": import_zod.z.boolean().optional(), "pre_onboarding_precision_level": import_zod.z.enum(["individual", "household", "business", "geography"]).optional() }).strict().describe("Onboarder disclosure. Required when data_sources includes an offline_* or public_record_* source.").optional(), "subject_type": import_zod.z.enum(["individual", "household", "business", "contextual", "none"]).describe("What kind of subject this signal characterizes.").optional(), "resolution_method": import_zod.z.enum(["deterministic_id", "probabilistic_device", "browser", "geographic", "content_signal", "mixed"]).describe("How the subject is resolved at decision time.").optional(), "id_types": import_zod.z.array(import_zod.z.enum(["cookie", "mobile_id", "platform_id", "user_enabled_id"])).describe("Identifier currencies analyzed to determine audience membership or attributes.").optional(), "audience_scope": import_zod.z.enum(["single_domain", "cross_domain_owned", "cross_domain_unowned", "offline"]).describe("Context within which the audience attribute was determined. 'single_domain' requires originating_domain.").optional(), "originating_domain": import_zod.z.string().describe("Domain of the digital property where the audience originates. Required when audience_scope is 'single_domain'.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("ISO 3166-1 alpha-2 country codes where the signal is applicable. Sellers must not expose a signal for media buys in countries outside this list. Federating agents that surface a peer's signal MUST treat the peer-published list as an upper bound, re-check it against the buyer's intended deployment countries, and may apply only narrower local policy.").optional(), "consent_basis": import_zod.z.array(import_zod.z.enum(["consent", "legitimate_interest", "contract", "legal_obligation"]).describe("Common GDPR lawful bases relevant to advertising. Covers the Article 6(1) bases used in programmatic advertising contexts.")).describe("Declared GDPR Article 6 lawful basis or consent basis under which this signal's data is processed. For non-GDPR regimes, use countries, policy_categories, and disclosure fields to describe jurisdiction-specific obligations unless a future enum value applies.").optional(), "art9_basis": import_zod.z.enum(["explicit_consent", "manifestly_made_public", "substantial_public_interest", "vital_interests"]).describe("GDPR Article 9 basis when restricted_attributes is non-empty and the signal is used in jurisdictions where Article 9 applies. Required by policy for applicable use cases rather than universally required at schema level because sensitivity and lawful basis are jurisdiction-relative.").optional(), "modeling": import_zod.z.object({ "method": import_zod.z.enum(["lookalike", "supervised", "embedding", "rules"]), "seed_source": import_zod.z.object({ "type": import_zod.z.enum(["first_party_crm", "panel", "declared_survey", "transactional", "behavioral"]), "provider_signed": import_zod.z.boolean().describe("Whether the seed source carries a signed attestation under one of the provider's published signing keys. This is a forward-looking claim until the consumer can resolve and verify the provider's applicable signing keys through the AdCP signing profile; consumers MUST NOT treat this boolean alone as cryptographic proof.") }).strict(), "training_data_jurisdictions": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("ISO 3166-1 alpha-2 country codes where the model's training data was collected."), "ai_act_risk_class": import_zod.z.enum(["minimal", "limited", "high_risk"]).describe("EU AI Act risk classification self-declared by the provider. Prohibited-risk modeled signals must not be published as AdCP signal definitions."), "disclosure": import_zod.z.object({ "required": import_zod.z.boolean().describe("The provider's claim that a modeling or AI-use disclosure is required for this signal in at least one applicable jurisdiction. This is a declared compliance signal, not a protocol-level legal determination."), "jurisdictions": import_zod.z.array(import_zod.z.object({ "country": import_zod.z.string().regex(new RegExp("^[A-Z]{2}$")).describe("ISO 3166-1 alpha-2 country code."), "region": import_zod.z.string().describe("Provider-defined sub-national region code or name when the obligation is regional. No global canonical format is implied.").optional(), "regulation": import_zod.z.string().describe("Provider-supplied regulation identifier for the disclosure obligation."), "disclosure_text": import_zod.z.string().describe("Human-readable disclosure text or summary the provider expects buyers or reviewers to see.").optional(), "disclosure_url": import_zod.z.string().url().describe("Optional URL to the provider's canonical disclosure or methodology page for this jurisdiction.").optional(), "audience": import_zod.z.enum(["buyer", "data_subject", "regulator", "public"]).describe("Primary audience for this disclosure entry.").optional() }).strict()).describe("Jurisdictions where a modeling or AI-use disclosure applies.").optional(), "notes": import_zod.z.string().max(2e3).describe("Optional provider notes on how the disclosure should be interpreted. Informational only; buyers should not branch programmatically on this text.").optional() }).strict().and(import_zod.z.any()).describe("Signal/modeling-specific disclosure requirements and jurisdictional notes. This is not creative provenance render guidance.").optional() }).strict().describe("Modeling disclosure for modeled data signals. Required when methodology is 'modeled' or audience_expansion is true. This describes data modeling and intentionally does not reuse creative provenance, which is content/render oriented.").optional(), "data_subject_rights": import_zod.z.object({ "upstream_source_domain": import_zod.z.string().max(253).describe("Domain of the upstream data source whose rights process these channels reach, when different from the publishing domain.").optional(), "channels": import_zod.z.array(import_zod.z.object({ "rights": import_zod.z.array(import_zod.z.enum(["access", "rectification", "erasure", "portability", "objection"])).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Rights supported by this channel."), "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL for submitting the rights request.").optional(), "email": import_zod.z.string().email().describe("Email address for submitting the rights request.").optional(), "languages": import_zod.z.array(import_zod.z.string()).describe("BCP 47 language tags supported by this channel.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("ISO 3166-1 alpha-2 countries this channel serves, when the provider routes rights by country.").optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()]))).describe("Rights request channels and the rights each channel supports. At least one declared channel MUST support one or more of access, erasure, or objection; schema validators enforce this with draft-07 contains, and consumers whose SDK drops contains need an equivalent runtime check."), "response_sla_days": import_zod.z.number().int().gte(1).lte(90).describe("Maximum response time in days for rights requests handled through the declared rights channels. For provider-published signals, providers SHOULD avoid duplicating this field across every signal unless the value varies by signal or upstream source; consumers MAY also consult the provider's public privacy policy or registry disclosures when present.").optional(), "ccpa_opt_out_url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("US-specific 'Do Not Sell or Share' opt-out URL where required.").optional() }).strict().describe("Per-signal data-subject-rights routing. Inline on the signal because upstream source, rights routing, and response commitments can differ by segment or may be unavailable from a public provider document for custom/private signals. This is a contact/routing reference, not a machine-callable AdCP API.").optional(), "last_updated": import_zod.z.string().datetime().describe("When this definition record was last updated. This indicates freshness of the definition record, not an attestation that the underlying data or model was refreshed at that time.").optional(), "dts_compliant_version": import_zod.z.string().describe("IAB Data Transparency Standard version this signal definition self-attests as satisfying, when applicable.").optional() }).catchall(import_zod.z.any()).and(import_zod.z.intersection(import_zod.z.intersection(import_zod.z.any(), import_zod.z.intersection(import_zod.z.any(), import_zod.z.any())), import_zod.z.intersection(import_zod.z.any(), import_zod.z.intersection(import_zod.z.any(), import_zod.z.any())))).describe("Definition of a signal in published adagents.json signals[]. The publishing domain supplies the namespace, so this definition carries a local id rather than a signal_ref. Media-buy products reference this definition with signal_ref scope 'data_provider', data_provider_domain set to the publishing domain, and signal_id set to this id. Some constraints use JSON Schema draft-07 conditional keywords such as if/then and contains; SDK generators that drop those keywords need equivalent runtime guards.")).describe("Signal definitions published by this domain. Each entry defines a signal id within this file's publishing-domain namespace; entries do not include signal_ref objects. Signals Protocol discovery and media-buy product targeting reference these through signal_ref scope 'data_provider', with data_provider_domain set to this file's publishing domain and signal_id set to signals[].id.").optional(), "signal_tags": import_zod.z.record(import_zod.z.string(), import_zod.z.object({ "name": import_zod.z.string().describe("Human-readable name for this tag"), "description": import_zod.z.string().describe("Description of what this tag represents") }).catchall(import_zod.z.any())).describe("Metadata for each tag referenced by signals. Provides human-readable context for signal tag values.").optional() }).catchall(import_zod.z.any()).and(import_zod.z.intersection(import_zod.z.union([import_zod.z.any(), import_zod.z.any(), import_zod.z.any(), import_zod.z.any(), import_zod.z.any(), import_zod.z.any()]), import_zod.z.any())).describe("Inline structure variant - contains full agent authorization data")]).describe("Declaration of authorized agents for advertising inventory and data signals. Hosted at /.well-known/adagents.json on publisher domains (for properties) or data provider domains (for signals). Can either contain the full structure inline or reference an authoritative URL.");
+}))), import_zod.z.intersection(import_zod.z.any().refine((value) => !import_zod.z.intersection(import_zod.z.any(), import_zod.z.any()).safeParse(value).success, "Invalid input: Should NOT be valid against schema"), import_zod.z.intersection(import_zod.z.any().refine((value) => !import_zod.z.any().safeParse(value).success, "Invalid input: Should NOT be valid against schema"), import_zod.z.any())))).describe("Inline format declaration on a product. The `format_kind` discriminator names which canonical format the product narrows; `params` carries only the canonical creative-shape parameters (slots, dimensions, durations, codecs, character limits, platform_extensions, etc.). Processing metadata such as `macro_resolution_capabilities` belongs at this declaration's top level rather than inside `params`. Optional `format_option_id` (stable identifier for routing when a product's `format_options` contains multiple declarations sharing the same `format_kind`), optional `publisher_domain` (namespace for the format option when it comes from a publisher adagents.json catalog), `display_name` (seller-controlled human-readable label for dashboard and catalog UIs), and `applies_to_channels` (subset of the product's declared channels this declaration applies to \u2014 lets a multi-channel product carry distinct format_options per channel). Discriminated-union shape generates clean tagged unions in TypeScript and Pydantic codegen. Replaces v1's named-format pattern (where products referenced a separately-defined format file via compound `format_id`). Canonical product-bound declarations are the AdCP 3.2 authoring path; v1 named formats remain only as deprecated 3.x compatibility projections.\n\n**Closed-set semantics (normative).** `format_options[]` is the closed set of accepted formats for this product. Sellers MUST reject `create_media_buy` requests targeting any `format_kind` (or format option reference) not present in this list \u2014 typically with `UNSUPPORTED_FEATURE` or a seller-specific code; the rejection is structural, not negotiable. `seller_preference` modulates *within* the accepted set (a soft ranking hint between equally-acceptable options), it is NOT an enforcement axis. A product wanting to say 'this format is the only one that works' lists exactly that one entry in `format_options[]`; everything else falls outside the set and is rejected by the closed-set rule.\n\n**Format matching vs satisfaction (normative).** Legacy named formats MUST be normalized to canonical declarations before comparison; do not exact-match raw `(agent_url, id)` pairs once a `format_id` has been projected through `canonical`, `v1_format_ref`, or the canonical mapping registry. Equivalence matching can treat a legacy fixed-size display ID and `format_kind: \"image\"` with matching `width`/`height` as the same underlying shape. Product satisfaction is stricter and directional: when this declaration specifies fixed constraints such as `width`, `height`, `duration_ms_exact`, or `duration_ms_range`, a buyer request or creative manifest MUST declare and satisfy those constraints. A broad request with no dimensions or duration does not satisfy a fixed-size or fixed-duration product; a broad product MAY accept a more specific creative unless another product constraint excludes it. Duration precedence is `duration_ms_exact` > `duration_ms_range`. Range constraints use containment: a range-based request satisfies this declaration only when every value it permits falls within this declaration's accepted range; overlap alone is insufficient. An exact value satisfies a range when the exact value falls inside the accepted interval. For hosted audio/video, a null range endpoint is unbounded: [null, 60000] means up to 60s, and [15000, null] means at least 15s; [null, null] is invalid because at least one endpoint must be bounded.\n\n**Custom format_kind** (`format_kind: \"custom\"`): for adopter-defined shapes that don't fit the 15 canonicals (branded content, cross-screen sponsorship, sponsorship lockup, newsletter sponsorship, AR lens, playable, live event sponsorship). When `format_kind` is `custom`, the declaration MUST carry `format_shape` (recognized global pattern from the [format-shape vocabulary registry](/schemas/core/format-shape-vocabulary.json)) AND `format_schema` (URI+digest reference to a fetchable schema describing the actual `params` and `slots`). Buyer agents fetch the schema, validate manifests structurally, and reason about manifests without per-seller integration code. See [adcp#3666](https://github.com/adcontextprotocol/adcp/issues/3666) for the canonical promotion queue."), import_zod.z.object({ "applies_to_property_ids": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Identifier for a publisher property. Must be lowercase alphanumeric with underscores only.")).describe('Optional property IDs from this file\'s `properties[]` that this format declaration applies to. When omitted, the declaration applies to all properties in the file. Mutually compatible with `applies_to_property_tags` (union is the effective scope). Example: Meta declares Reels with `applies_to_property_ids: ["instagram", "facebook"]` because WhatsApp doesn\'t carry Reels inventory.').optional(), "applies_to_property_tags": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Tag for categorizing publisher properties. Must be lowercase alphanumeric with underscores only.")).describe('Optional property tags from this file\'s `tags` map that this format declaration applies to. When omitted, the declaration applies to all properties in the file. Useful for network-wide formats (e.g., a managed network declaring `applies_to_property_tags: ["premium_video"]`). Compatible with `applies_to_property_ids` \u2014 a property is in scope if it matches either ID list or tag list.').optional(), "reference_renderer": import_zod.z.object({ "runtime": import_zod.z.literal("browser-esm").describe("Execution contract for the referenced package. browser-esm means a browser-safe ECMAScript module that accepts canonical manifest data and returns an inert presentation without Node.js APIs, ambient credentials, delivery tracking, or undeclared network access. Non-JavaScript clients use a hosted preview_creative provider or display the manifest."), "package": import_zod.z.string().regex(new RegExp("^(?:@[a-z0-9][a-z0-9._~-]*/)?[a-z0-9][a-z0-9._~-]*$")).describe("npm package name, scoped or unscoped. The package is resolved from the npm registry; the AdCP registry does not proxy its executable contents."), "version": import_zod.z.string().regex(new RegExp("^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$")).describe("Exact semantic version. Ranges and tags such as latest are forbidden so the registry entry is reproducible. Package semantic versioning identifies the pinned distribution artifact; it is independent of any one format revision because one package may expose renderers for multiple formats."), "export": import_zod.z.string().min(1).describe("Named package export that implements the renderer contract for this enclosing format entry. Compatibility is bound at the export-to-entry edge, not to matching version labels: registry review and contract fixtures verify that the export implements the entry's input contract. When that input contract changes, the registry MUST rerun those fixtures and MAY retain the existing export and package pin when they still pass. One package version MAY expose different named exports for different formats or input contracts."), "format_revision": import_zod.z.string().regex(new RegExp("^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)$")).describe("Deprecated compatibility annotation retained for previously published registry entries. Renderer package versions and community format revisions have independent lifecycles, so consumers MUST NOT require this value to equal the enclosing entry's format_revision or use matching values as evidence of compatibility. Registry review and contract fixtures bind the named export to the enclosing format's input contract. New entries SHOULD omit this field.").optional(), "integrity": import_zod.z.string().regex(new RegExp("^(?:sha256-[A-Za-z0-9+/]{43}=|sha384-[A-Za-z0-9+/]{64}|sha512-[A-Za-z0-9+/]{86}==)$")).describe("Subresource Integrity value for the exact npm package tarball. Consumers MUST compare this value before loading code, require the provenance subject digest to match the same tarball, and fail closed on mismatch."), "provenance": import_zod.z.object({ "source_repository": import_zod.z.string().url().regex(new RegExp("^https://github\\.com/")).describe("Allowlisted source repository that the npm provenance attestation MUST identify."), "workflow_path": import_zod.z.string().regex(new RegExp("^\\.github/workflows/[A-Za-z0-9._/-]+\\.ya?ml$")).describe("Repository-relative GitHub Actions workflow path that npm provenance buildDefinition.externalParameters.workflow.path MUST identify.") }).strict() }).strict().describe("Optional only for an AgenticAdvertising.org community-registry format entry fetched from the configured registry origin. Points to a pinned browser-ESM OSS renderer package export that provides a non-authoritative reference presentation. Registry review and contract fixtures bind the named export to the enclosing format's input contract (its canonical format kind, manifest shape, constraints, and declared macros); renderer package versions and format revisions have independent lifecycles. Display metadata and property scope do not affect that compatibility binding. Non-JavaScript clients use hosted preview_creative or display the manifest. Publisher-origin catalogs and seller product declarations do not use this field: publishers describe placement-specific chrome with placements[].presentation_ref and grant route-specific preview authority with placements[].preview_provider.").optional(), "format_revision": import_zod.z.string().regex(new RegExp("^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)$")).describe("Registry-managed revision of this community format entry's input contract. Required when reference_renderer is present, but independent of any reference-renderer package version or legacy reference_renderer.format_revision annotation. A contract update may retain an existing renderer pin when that export still passes the updated declaration's contract fixtures.").optional() }).and(import_zod.z.any()))).describe("Publisher-authoritative format catalog. Declares the 3.1+ canonical format-option shapes the publisher supports across its properties \u2014 the single place a publisher (or its community-registry stand-in) asserts \"these are the formats my inventory accepts.\" Products selling this publisher's inventory SHOULD reference these declarations by `format_option_id` on the placement or via inline `format_options` whose `format_option_id` matches an entry here, eliminating the N-copies-of-Meta-Reels-on-N-products drift surface.\n\nEach item is a `ProductFormatDeclaration` (same 3.1+ canonical format-option shape used on Products) plus optional `applies_to_property_ids` / `applies_to_property_tags` for property scoping within the file. A `formats[]` entry without scope applies to all properties in the file; with scope, only to the named subset (e.g., Reels applies to Instagram + Facebook but not WhatsApp).\n\n**Community registry pattern (normative for unadopted platforms).** When a platform hasn't adopted AdCP (Meta, TikTok, Snap, Pinterest, etc.), AAO publishes a community-maintained adagents.json at `https://creative.adcontextprotocol.org/translated/<platform>/adagents.json` carrying that platform's `formats[]`. Buyer SDKs fetch the platform's own `<domain>/.well-known/adagents.json` first; on 404 or absence-of-formats[], they fall back to the AAO mirror. When the platform adopts AdCP and publishes their own adagents.json with `formats[]`, the platform-hosted file takes precedence and the mirror entry becomes redundant (AAO maintainers deprecate it).\n\nThe `v1_format_ref.agent_url` on each declaration SHOULD match the agent_url of the file's hosting location \u2014 platform-hosted formats point at the platform's agent, community-mirror formats point at `https://creative.adcontextprotocol.org/translated/<platform>`. This keeps the legacy named-format namespace converged regardless of which side hosts the catalog. See `docs/creative/canonical-formats.mdx` Meta Reels worked example.").optional(), "superseded_by": import_zod.z.string().url().regex(new RegExp("^https://")).describe("Optional pointer indicating this adagents.json file has been superseded by another adagents.json at a different URL. Used by the AAO community-mirror lifecycle: when a platform (e.g., Meta) adopts AdCP and publishes its own adagents.json at `<platform-domain>/.well-known/adagents.json`, the AAO mirror file at `creative.adcontextprotocol.org/translated/<platform>/adagents.json` sets `superseded_by` to the platform-hosted URL. Buyer SDKs encountering a file with `superseded_by` SHOULD short-circuit and re-fetch from the named URL rather than serving stale content from the mirror. The mirror SHOULD continue serving with `superseded_by` set for \u22651 minor release after platform adoption so buyer caches keyed on the mirror URL get an explicit migration signal rather than a silent break.").optional(), "tags": import_zod.z.record(import_zod.z.string(), import_zod.z.object({ "name": import_zod.z.string().describe("Human-readable name for this tag"), "description": import_zod.z.string().describe("Description of what this tag represents") }).catchall(import_zod.z.any())).describe("Metadata for each tag referenced by properties. Provides human-readable context for property tag values.").optional(), "placement_tags": import_zod.z.record(import_zod.z.string(), import_zod.z.object({ "name": import_zod.z.string().describe("Human-readable name for this placement tag"), "description": import_zod.z.string().describe("Description of what this placement tag represents") }).catchall(import_zod.z.any())).describe("Metadata for each tag referenced by placements. Provides human-readable context for publisher-defined placement tag values used in grouping and authorization.").optional(), "authorized_agents": import_zod.z.array(import_zod.z.union([import_zod.z.object({ "authorization_type": import_zod.z.literal("property_ids").describe("Discriminator indicating authorization by specific property IDs"), "property_ids": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Identifier for a publisher property. Must be lowercase alphanumeric with underscores only.")).describe("Property IDs this agent is authorized for. Resolved against the top-level properties array in this file"), "collections": import_zod.z.array(import_zod.z.object({ "publisher_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where the adagents.json declaring these collections is hosted (e.g., 'mrbeast.com'). The collections array in that file contains the authoritative collection definitions."), "collection_ids": import_zod.z.array(import_zod.z.string()).describe("Collection IDs from the adagents.json collections array. Each ID must match a collection_id declared in that file. Omit to reference all collections declared in that file.").optional() }).catchall(import_zod.z.any()).describe("References collections declared in an adagents.json. Buyers resolve full collection objects by fetching the adagents.json at the given domain and matching collection_ids against its collections array. When collection_ids is omitted, the selector references every collection declared in that adagents.json \u2014 the bulk-grant form for authorization scoping (e.g., a host authorizing a channel owner's sales agent for all of the owner's collections without tracking owner-assigned IDs).")).describe("Optional collection constraints. When present, authorization only applies to inventory associated with these collections. A selector without collection_ids grants for all collections declared in that selector's publisher_domain adagents.json (the bulk-grant form for owner-sold carriage).").optional(), "placement_ids": import_zod.z.array(import_zod.z.string()).describe("Optional placement constraints. When present, authorization only applies to these placement IDs from the top-level placements array in this file.").optional(), "placement_tags": import_zod.z.array(import_zod.z.string()).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Optional placement tag constraints. When present, authorization only applies to placements whose tags include any of these publisher-defined values.").optional(), "delegation_type": import_zod.z.enum(["direct", "delegated", "ad_network"]).describe("Commercial relationship for this inventory path. 'direct' means the publisher treats this as a direct way to buy from them, even if a third party operates the software. 'delegated' means the agent is authorized to sell on the publisher's behalf. 'ad_network' means the inventory is sold as part of a network/package context rather than as the publisher's direct endpoint.").optional(), "exclusive": import_zod.z.boolean().describe("Whether this agent is the publisher's sole authorized path for the scoped inventory slice. When false or absent, other authorized agents may also sell the same inventory.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Optional ISO 3166-1 alpha-2 country codes limiting where this authorization applies. Omit for worldwide authorization.").optional(), "effective_from": import_zod.z.string().datetime().describe("Optional start time for this authorization window.").optional(), "effective_until": import_zod.z.string().datetime().describe("Optional end time for this authorization window.").optional() }).catchall(import_zod.z.any()).and(import_zod.z.object({ "url": import_zod.z.string().url().describe("The authorized agent's protocol endpoint URL: the exact agent URL buyers are given and send AdCP requests to, including the path (e.g., `https://agent.example.com/mcp`). A bare origin matches only an agent served at the root. An agent reachable at more than one agent URL (for example, separate MCP and A2A endpoints) needs one entry per URL. Callers comparing this URL against a registry (sales-agent list, signal-provider registry, TMP provider lookup, etc.) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality \u2014 two URLs that differ only in case, default port, or percent-encoding of unreserved characters are the same agent. See docs/reference/url-canonicalization."), "authorized_for": import_zod.z.string().min(1).max(500).describe("Human-readable description of what this agent is authorized to do \u2014 what it sells (for sales/property agents) or what data it provides (for signal agents). The variant the entry uses (`property_ids`, `signal_tags`, etc.) tells consumers which inflection applies; this field carries the operator-supplied label."), "signing_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().describe("Key identifier for selecting the correct signing key."), "kty": import_zod.z.string().describe("JWK key type, such as 'OKP', 'EC', or 'RSA'."), "alg": import_zod.z.string().describe("Expected signing algorithm for this key, such as 'EdDSA' or 'RS256'.").optional(), "use": import_zod.z.string().describe("Optional JWK use value. Typically 'sig' for signing keys.").optional(), "crv": import_zod.z.string().describe("Curve name for OKP or EC keys, such as 'Ed25519' or 'P-256'.").optional(), "x": import_zod.z.string().describe("Base64url-encoded public key x coordinate or public key value for OKP keys.").optional(), "y": import_zod.z.string().describe("Base64url-encoded public key y coordinate for EC keys.").optional(), "n": import_zod.z.string().describe("Base64url-encoded RSA modulus.").optional(), "e": import_zod.z.string().describe("Base64url-encoded RSA public exponent.").optional(), "revoked_at": import_zod.z.string().datetime().describe("Optional revocation timestamp. When present, verifiers MUST reject any signature produced with this key whose signing epoch (or equivalent time reference) is at or after this timestamp. The key may continue to appear in the trust anchor during a grace period so caches that have not yet refreshed still find the key and can evaluate the revocation marker. Keys past their revocation can be removed once the cache TTL (recommended: 5 minutes) has elapsed across all verifiers.").optional() }).catchall(import_zod.z.any()).describe("Publisher-attested public key material for an authorized agent. Buyers use these keys to verify signed agent responses against the trust anchor published in adagents.json rather than trusting key discovery from the agent domain alone.")).describe("Optional publisher-attested public signing keys for this agent. Use these as the trust anchor for verifying signed agent responses instead of relying on key discovery from the agent domain alone.").optional(), "encryption_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().max(8).describe("Key identifier. Opaque \u2014 MUST NOT encode geographic or deployment information."), "kty": import_zod.z.literal("OKP").describe("JWK key type. Must be OKP for X25519."), "crv": import_zod.z.literal("X25519").describe("Curve name. Must be X25519 for TMPX encryption."), "use": import_zod.z.literal("enc").describe("JWK use value. Must be enc for encryption keys."), "x": import_zod.z.string().describe("Base64url-encoded X25519 public key (32 bytes).") }).strict().describe("X25519 public key for HPKE encryption. Used for TMPX exposure token encryption with HPKE mode_base.")).describe("X25519 public keys for TMPX exposure token encryption. Each key identifies a cluster master that can decrypt TMPX tokens. Used with HPKE mode_base \u2014 read replicas encrypt with this public key, only the master can decrypt.").optional(), "last_updated": import_zod.z.string().datetime().describe("Optional ISO 8601 timestamp indicating when this `authorized_agents[]` entry last changed. Independent of the file-level `last_updated`. Lets validators perform a partial walk by skipping entries whose `last_updated` is older than their indexed value. Advisory \u2014 consumers MAY ignore and re-index the full file.").optional() }).describe("Fields shared by every variant of `authorized_agents[*]` in adagents.json, regardless of authorization_type. Variants `allOf` this base and add their discriminator-specific fields. Centralized to prevent drift across all authorization-type variants.")), import_zod.z.object({ "authorization_type": import_zod.z.literal("property_tags").describe("Discriminator indicating authorization by property tags"), "property_tags": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Tag for categorizing publisher properties. Must be lowercase alphanumeric with underscores only.")).describe("Tags identifying which properties this agent is authorized for. Resolved against the top-level properties array in this file using tag matching"), "collections": import_zod.z.array(import_zod.z.object({ "publisher_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where the adagents.json declaring these collections is hosted (e.g., 'mrbeast.com'). The collections array in that file contains the authoritative collection definitions."), "collection_ids": import_zod.z.array(import_zod.z.string()).describe("Collection IDs from the adagents.json collections array. Each ID must match a collection_id declared in that file. Omit to reference all collections declared in that file.").optional() }).catchall(import_zod.z.any()).describe("References collections declared in an adagents.json. Buyers resolve full collection objects by fetching the adagents.json at the given domain and matching collection_ids against its collections array. When collection_ids is omitted, the selector references every collection declared in that adagents.json \u2014 the bulk-grant form for authorization scoping (e.g., a host authorizing a channel owner's sales agent for all of the owner's collections without tracking owner-assigned IDs).")).describe("Optional collection constraints. When present, authorization only applies to inventory associated with these collections. A selector without collection_ids grants for all collections declared in that selector's publisher_domain adagents.json (the bulk-grant form for owner-sold carriage).").optional(), "placement_ids": import_zod.z.array(import_zod.z.string()).describe("Optional placement constraints. When present, authorization only applies to these placement IDs from the top-level placements array in this file.").optional(), "placement_tags": import_zod.z.array(import_zod.z.string()).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Optional placement tag constraints. When present, authorization only applies to placements whose tags include any of these publisher-defined values.").optional(), "delegation_type": import_zod.z.enum(["direct", "delegated", "ad_network"]).describe("Commercial relationship for this inventory path. 'direct' means the publisher treats this as a direct way to buy from them, even if a third party operates the software. 'delegated' means the agent is authorized to sell on the publisher's behalf. 'ad_network' means the inventory is sold as part of a network/package context rather than as the publisher's direct endpoint.").optional(), "exclusive": import_zod.z.boolean().describe("Whether this agent is the publisher's sole authorized path for the scoped inventory slice. When false or absent, other authorized agents may also sell the same inventory.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Optional ISO 3166-1 alpha-2 country codes limiting where this authorization applies. Omit for worldwide authorization.").optional(), "effective_from": import_zod.z.string().datetime().describe("Optional start time for this authorization window.").optional(), "effective_until": import_zod.z.string().datetime().describe("Optional end time for this authorization window.").optional() }).catchall(import_zod.z.any()).and(import_zod.z.object({ "url": import_zod.z.string().url().describe("The authorized agent's protocol endpoint URL: the exact agent URL buyers are given and send AdCP requests to, including the path (e.g., `https://agent.example.com/mcp`). A bare origin matches only an agent served at the root. An agent reachable at more than one agent URL (for example, separate MCP and A2A endpoints) needs one entry per URL. Callers comparing this URL against a registry (sales-agent list, signal-provider registry, TMP provider lookup, etc.) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality \u2014 two URLs that differ only in case, default port, or percent-encoding of unreserved characters are the same agent. See docs/reference/url-canonicalization."), "authorized_for": import_zod.z.string().min(1).max(500).describe("Human-readable description of what this agent is authorized to do \u2014 what it sells (for sales/property agents) or what data it provides (for signal agents). The variant the entry uses (`property_ids`, `signal_tags`, etc.) tells consumers which inflection applies; this field carries the operator-supplied label."), "signing_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().describe("Key identifier for selecting the correct signing key."), "kty": import_zod.z.string().describe("JWK key type, such as 'OKP', 'EC', or 'RSA'."), "alg": import_zod.z.string().describe("Expected signing algorithm for this key, such as 'EdDSA' or 'RS256'.").optional(), "use": import_zod.z.string().describe("Optional JWK use value. Typically 'sig' for signing keys.").optional(), "crv": import_zod.z.string().describe("Curve name for OKP or EC keys, such as 'Ed25519' or 'P-256'.").optional(), "x": import_zod.z.string().describe("Base64url-encoded public key x coordinate or public key value for OKP keys.").optional(), "y": import_zod.z.string().describe("Base64url-encoded public key y coordinate for EC keys.").optional(), "n": import_zod.z.string().describe("Base64url-encoded RSA modulus.").optional(), "e": import_zod.z.string().describe("Base64url-encoded RSA public exponent.").optional(), "revoked_at": import_zod.z.string().datetime().describe("Optional revocation timestamp. When present, verifiers MUST reject any signature produced with this key whose signing epoch (or equivalent time reference) is at or after this timestamp. The key may continue to appear in the trust anchor during a grace period so caches that have not yet refreshed still find the key and can evaluate the revocation marker. Keys past their revocation can be removed once the cache TTL (recommended: 5 minutes) has elapsed across all verifiers.").optional() }).catchall(import_zod.z.any()).describe("Publisher-attested public key material for an authorized agent. Buyers use these keys to verify signed agent responses against the trust anchor published in adagents.json rather than trusting key discovery from the agent domain alone.")).describe("Optional publisher-attested public signing keys for this agent. Use these as the trust anchor for verifying signed agent responses instead of relying on key discovery from the agent domain alone.").optional(), "encryption_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().max(8).describe("Key identifier. Opaque \u2014 MUST NOT encode geographic or deployment information."), "kty": import_zod.z.literal("OKP").describe("JWK key type. Must be OKP for X25519."), "crv": import_zod.z.literal("X25519").describe("Curve name. Must be X25519 for TMPX encryption."), "use": import_zod.z.literal("enc").describe("JWK use value. Must be enc for encryption keys."), "x": import_zod.z.string().describe("Base64url-encoded X25519 public key (32 bytes).") }).strict().describe("X25519 public key for HPKE encryption. Used for TMPX exposure token encryption with HPKE mode_base.")).describe("X25519 public keys for TMPX exposure token encryption. Each key identifies a cluster master that can decrypt TMPX tokens. Used with HPKE mode_base \u2014 read replicas encrypt with this public key, only the master can decrypt.").optional(), "last_updated": import_zod.z.string().datetime().describe("Optional ISO 8601 timestamp indicating when this `authorized_agents[]` entry last changed. Independent of the file-level `last_updated`. Lets validators perform a partial walk by skipping entries whose `last_updated` is older than their indexed value. Advisory \u2014 consumers MAY ignore and re-index the full file.").optional() }).describe("Fields shared by every variant of `authorized_agents[*]` in adagents.json, regardless of authorization_type. Variants `allOf` this base and add their discriminator-specific fields. Centralized to prevent drift across all authorization-type variants.")), import_zod.z.object({ "authorization_type": import_zod.z.literal("inline_properties").describe("Discriminator indicating authorization by inline property definitions. Companion field is `properties` (not `inline_properties`) \u2014 the only authorization_type whose companion field name does not mirror the discriminator value."), "properties": import_zod.z.array(import_zod.z.object({ "property_id": import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Unique identifier for this property (optional). Enables referencing properties by ID instead of repeating full objects.").optional(), "property_type": import_zod.z.enum(["website", "mobile_app", "ctv_app", "desktop_app", "dooh", "podcast", "radio", "linear_tv", "streaming_audio", "ai_assistant"]).describe("Type of advertising property"), "name": import_zod.z.string().describe("Human-readable property name"), "identifiers": import_zod.z.array(import_zod.z.object({ "type": import_zod.z.enum(["domain", "subdomain", "network_id", "ios_bundle", "android_package", "apple_app_store_id", "google_play_id", "roku_store_id", "fire_tv_asin", "samsung_app_id", "apple_tv_bundle", "bundle_id", "venue_id", "screen_id", "openooh_venue_type", "rss_url", "apple_podcast_id", "spotify_collection_id", "podcast_guid", "station_id", "facility_id"]).describe("Type of identifier for this property"), "value": import_zod.z.string().describe("The identifier value. For domain type: 'example.com' matches base domain plus www and m subdomains; 'edition.example.com' matches that specific subdomain; '*.example.com' matches ALL subdomains but NOT base domain") }).catchall(import_zod.z.any())).describe("Array of identifiers for this property"), "tags": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Tag for categorizing publisher properties. Must be lowercase alphanumeric with underscores only.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Tags for categorization and grouping (e.g., network membership, content categories)").optional(), "supported_channels": import_zod.z.array(import_zod.z.enum(["display", "olv", "social", "search", "ctv", "linear_tv", "radio", "streaming_audio", "podcast", "dooh", "ooh", "print", "cinema", "email", "gaming", "retail_media", "influencer", "affiliate", "product_placement", "sponsored_intelligence"]).describe("Standardized advertising media channels describing how buyers allocate budget. Channels are planning abstractions, not technical substrates. See the Media Channel Taxonomy specification for detailed definitions.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Advertising channels this property supports (e.g., ['display', 'olv', 'social']). Publishers declare which channels their inventory aligns with. Properties may support multiple channels. See the Media Channel Taxonomy for definitions.").optional(), "publisher_domain": import_zod.z.string().describe("Domain where adagents.json should be checked for authorization validation. Optional in adagents.json (file location implies domain).").optional() }).catchall(import_zod.z.any()).describe("An advertising property that can be validated via adagents.json")).describe('Specific properties this agent is authorized for, defined inline on the agent entry (alternative to property_ids/property_tags). Note: this is the companion field for `authorization_type: "inline_properties"` \u2014 the field is named `properties`, not `inline_properties`.'), "collections": import_zod.z.array(import_zod.z.object({ "publisher_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where the adagents.json declaring these collections is hosted (e.g., 'mrbeast.com'). The collections array in that file contains the authoritative collection definitions."), "collection_ids": import_zod.z.array(import_zod.z.string()).describe("Collection IDs from the adagents.json collections array. Each ID must match a collection_id declared in that file. Omit to reference all collections declared in that file.").optional() }).catchall(import_zod.z.any()).describe("References collections declared in an adagents.json. Buyers resolve full collection objects by fetching the adagents.json at the given domain and matching collection_ids against its collections array. When collection_ids is omitted, the selector references every collection declared in that adagents.json \u2014 the bulk-grant form for authorization scoping (e.g., a host authorizing a channel owner's sales agent for all of the owner's collections without tracking owner-assigned IDs).")).describe("Optional collection constraints. When present, authorization only applies to inventory associated with these collections. A selector without collection_ids grants for all collections declared in that selector's publisher_domain adagents.json (the bulk-grant form for owner-sold carriage).").optional(), "placement_ids": import_zod.z.array(import_zod.z.string()).describe("Optional placement constraints. When present, authorization only applies to these placement IDs from the top-level placements array in this file.").optional(), "placement_tags": import_zod.z.array(import_zod.z.string()).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Optional placement tag constraints. When present, authorization only applies to placements whose tags include any of these publisher-defined values.").optional(), "delegation_type": import_zod.z.enum(["direct", "delegated", "ad_network"]).describe("Commercial relationship for this inventory path. 'direct' means the publisher treats this as a direct way to buy from them, even if a third party operates the software. 'delegated' means the agent is authorized to sell on the publisher's behalf. 'ad_network' means the inventory is sold as part of a network/package context rather than as the publisher's direct endpoint.").optional(), "exclusive": import_zod.z.boolean().describe("Whether this agent is the publisher's sole authorized path for the scoped inventory slice. When false or absent, other authorized agents may also sell the same inventory.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Optional ISO 3166-1 alpha-2 country codes limiting where this authorization applies. Omit for worldwide authorization.").optional(), "effective_from": import_zod.z.string().datetime().describe("Optional start time for this authorization window.").optional(), "effective_until": import_zod.z.string().datetime().describe("Optional end time for this authorization window.").optional() }).catchall(import_zod.z.any()).and(import_zod.z.object({ "url": import_zod.z.string().url().describe("The authorized agent's protocol endpoint URL: the exact agent URL buyers are given and send AdCP requests to, including the path (e.g., `https://agent.example.com/mcp`). A bare origin matches only an agent served at the root. An agent reachable at more than one agent URL (for example, separate MCP and A2A endpoints) needs one entry per URL. Callers comparing this URL against a registry (sales-agent list, signal-provider registry, TMP provider lookup, etc.) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality \u2014 two URLs that differ only in case, default port, or percent-encoding of unreserved characters are the same agent. See docs/reference/url-canonicalization."), "authorized_for": import_zod.z.string().min(1).max(500).describe("Human-readable description of what this agent is authorized to do \u2014 what it sells (for sales/property agents) or what data it provides (for signal agents). The variant the entry uses (`property_ids`, `signal_tags`, etc.) tells consumers which inflection applies; this field carries the operator-supplied label."), "signing_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().describe("Key identifier for selecting the correct signing key."), "kty": import_zod.z.string().describe("JWK key type, such as 'OKP', 'EC', or 'RSA'."), "alg": import_zod.z.string().describe("Expected signing algorithm for this key, such as 'EdDSA' or 'RS256'.").optional(), "use": import_zod.z.string().describe("Optional JWK use value. Typically 'sig' for signing keys.").optional(), "crv": import_zod.z.string().describe("Curve name for OKP or EC keys, such as 'Ed25519' or 'P-256'.").optional(), "x": import_zod.z.string().describe("Base64url-encoded public key x coordinate or public key value for OKP keys.").optional(), "y": import_zod.z.string().describe("Base64url-encoded public key y coordinate for EC keys.").optional(), "n": import_zod.z.string().describe("Base64url-encoded RSA modulus.").optional(), "e": import_zod.z.string().describe("Base64url-encoded RSA public exponent.").optional(), "revoked_at": import_zod.z.string().datetime().describe("Optional revocation timestamp. When present, verifiers MUST reject any signature produced with this key whose signing epoch (or equivalent time reference) is at or after this timestamp. The key may continue to appear in the trust anchor during a grace period so caches that have not yet refreshed still find the key and can evaluate the revocation marker. Keys past their revocation can be removed once the cache TTL (recommended: 5 minutes) has elapsed across all verifiers.").optional() }).catchall(import_zod.z.any()).describe("Publisher-attested public key material for an authorized agent. Buyers use these keys to verify signed agent responses against the trust anchor published in adagents.json rather than trusting key discovery from the agent domain alone.")).describe("Optional publisher-attested public signing keys for this agent. Use these as the trust anchor for verifying signed agent responses instead of relying on key discovery from the agent domain alone.").optional(), "encryption_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().max(8).describe("Key identifier. Opaque \u2014 MUST NOT encode geographic or deployment information."), "kty": import_zod.z.literal("OKP").describe("JWK key type. Must be OKP for X25519."), "crv": import_zod.z.literal("X25519").describe("Curve name. Must be X25519 for TMPX encryption."), "use": import_zod.z.literal("enc").describe("JWK use value. Must be enc for encryption keys."), "x": import_zod.z.string().describe("Base64url-encoded X25519 public key (32 bytes).") }).strict().describe("X25519 public key for HPKE encryption. Used for TMPX exposure token encryption with HPKE mode_base.")).describe("X25519 public keys for TMPX exposure token encryption. Each key identifies a cluster master that can decrypt TMPX tokens. Used with HPKE mode_base \u2014 read replicas encrypt with this public key, only the master can decrypt.").optional(), "last_updated": import_zod.z.string().datetime().describe("Optional ISO 8601 timestamp indicating when this `authorized_agents[]` entry last changed. Independent of the file-level `last_updated`. Lets validators perform a partial walk by skipping entries whose `last_updated` is older than their indexed value. Advisory \u2014 consumers MAY ignore and re-index the full file.").optional() }).describe("Fields shared by every variant of `authorized_agents[*]` in adagents.json, regardless of authorization_type. Variants `allOf` this base and add their discriminator-specific fields. Centralized to prevent drift across all authorization-type variants.")), import_zod.z.object({ "authorization_type": import_zod.z.literal("publisher_properties").describe("Discriminator indicating authorization for properties from other publisher domains"), "publisher_properties": import_zod.z.array(import_zod.z.union([import_zod.z.object({ "publisher_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where publisher's adagents.json is hosted (e.g., 'cnn.com'). XOR with `publisher_domains` \u2014 exactly one MUST be present on each `publisher_properties[]` entry; both-present and neither-present both fail validation.").optional(), "publisher_domains": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Compact form for fanning the same selector across many publishers (e.g., a managed network listing every publisher it represents). Each entry is the domain where that publisher's adagents.json is hosted. Each listed domain MUST be canonicalized to lowercase (the `pattern` already rejects uppercase). Mutually exclusive with `publisher_domain`. Each listed domain counts as explicitly scoped for the `managerdomain` fallback safety rule.").optional(), "selection_type": import_zod.z.literal("all").describe("Discriminator indicating all properties from each addressed publisher are included") }).catchall(import_zod.z.any()).and(import_zod.z.intersection(import_zod.z.any().refine((value) => !import_zod.z.any().safeParse(value).success, "Invalid input: Should NOT be valid against schema"), import_zod.z.union([import_zod.z.any(), import_zod.z.any()]))).describe("Select all properties from one publisher domain, or from each publisher domain when `publisher_domains` is used. Consumers MAY satisfy the selector from the parent file's top-level `properties[]` when those properties carry a `publisher_domain` matching one of the listed domains (see Resolution paths in the spec)."), import_zod.z.object({ "publisher_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')."), "selection_type": import_zod.z.literal("by_id").describe("Discriminator indicating selection by specific property IDs"), "property_ids": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Identifier for a publisher property. Must be lowercase alphanumeric with underscores only.")).describe("Specific property IDs from the publisher's adagents.json") }).catchall(import_zod.z.any()).describe("Select specific properties by ID. Single-publisher only \u2014 property IDs are publisher-scoped, so the compact `publisher_domains[]` form is intentionally NOT available for this selector. Use multiple `publisher_properties[]` entries (one per publisher) when each publisher's ID set differs."), import_zod.z.object({ "publisher_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where publisher's adagents.json is hosted (e.g., 'cnn.com'). XOR with `publisher_domains` \u2014 exactly one MUST be present on each `publisher_properties[]` entry; both-present and neither-present both fail validation.").optional(), "publisher_domains": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Compact form for fanning the same tag predicate across many publishers (canonical managed-network shape). Each entry is the domain where that publisher's adagents.json is hosted. Each listed domain MUST be canonicalized to lowercase (the `pattern` already rejects uppercase). Mutually exclusive with `publisher_domain`. Each listed domain counts as explicitly scoped for the `managerdomain` fallback safety rule.").optional(), "selection_type": import_zod.z.literal("by_tag").describe("Discriminator indicating selection by property tags"), "property_tags": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_]+$")).describe("Tag for categorizing publisher properties. Must be lowercase alphanumeric with underscores only.")).describe("Property tags resolved against each addressed publisher's adagents.json, OR against the parent file's top-level `properties[]` when those properties carry a `publisher_domain` matching the selector. Selector covers all properties carrying any of these tags.") }).catchall(import_zod.z.any()).and(import_zod.z.intersection(import_zod.z.any().refine((value) => !import_zod.z.any().safeParse(value).success, "Invalid input: Should NOT be valid against schema"), import_zod.z.union([import_zod.z.any(), import_zod.z.any()]))).describe("Select properties by tag membership. With `publisher_domains`, the same `property_tags` predicate is resolved against each listed publisher's adagents.json \u2014 the common managed-network case where every represented site tags inventory with a shared label. Consumers MAY also satisfy the predicate from the parent file's top-level `properties[]` when those properties carry a `publisher_domain` matching one of the selector's `publisher_domains[]` (see Resolution paths in the spec).")]).describe("Selects properties from a publisher's adagents.json. Used for both product definitions and agent authorization. Supports three selection patterns: all properties, specific IDs, or by tags. Each selector targets one publisher via `publisher_domain` (string) or a fan-out across many publishers that share the same selector via `publisher_domains` (array). Exactly one of `publisher_domain` or `publisher_domains` MUST be present. When `publisher_domains` is used, the selector is logically equivalent to repeating the same entry once per listed domain.")).describe("Properties from other publisher domains this agent is authorized for. Each entry specifies a publisher domain and which of their properties this agent can sell"), "collections": import_zod.z.array(import_zod.z.object({ "publisher_domain": import_zod.z.string().regex(new RegExp("^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$")).describe("Domain where the adagents.json declaring these collections is hosted (e.g., 'mrbeast.com'). The collections array in that file contains the authoritative collection definitions."), "collection_ids": import_zod.z.array(import_zod.z.string()).describe("Collection IDs from the adagents.json collections array. Each ID must match a collection_id declared in that file. Omit to reference all collections declared in that file.").optional() }).catchall(import_zod.z.any()).describe("References collections declared in an adagents.json. Buyers resolve full collection objects by fetching the adagents.json at the given domain and matching collection_ids against its collections array. When collection_ids is omitted, the selector references every collection declared in that adagents.json \u2014 the bulk-grant form for authorization scoping (e.g., a host authorizing a channel owner's sales agent for all of the owner's collections without tracking owner-assigned IDs).")).describe("Optional collection constraints. When present, authorization only applies to inventory associated with these collections. A selector without collection_ids grants for all collections declared in that selector's publisher_domain adagents.json (the bulk-grant form for owner-sold carriage).").optional(), "placement_ids": import_zod.z.array(import_zod.z.string()).describe("Optional placement constraints. When present, authorization only applies to these placement IDs from the top-level placements array in this file.").optional(), "placement_tags": import_zod.z.array(import_zod.z.string()).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Optional placement tag constraints. When present, authorization only applies to placements whose tags include any of these publisher-defined values.").optional(), "delegation_type": import_zod.z.enum(["direct", "delegated", "ad_network"]).describe("Commercial relationship for this inventory path. 'direct' means the publisher treats this as a direct way to buy from them, even if a third party operates the software. 'delegated' means the agent is authorized to sell on the publisher's behalf. 'ad_network' means the inventory is sold as part of a network/package context rather than as the publisher's direct endpoint.").optional(), "exclusive": import_zod.z.boolean().describe("Whether this agent is the publisher's sole authorized path for the scoped inventory slice. When false or absent, other authorized agents may also sell the same inventory.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Optional ISO 3166-1 alpha-2 country codes limiting where this authorization applies. Omit for worldwide authorization.").optional(), "effective_from": import_zod.z.string().datetime().describe("Optional start time for this authorization window.").optional(), "effective_until": import_zod.z.string().datetime().describe("Optional end time for this authorization window.").optional() }).catchall(import_zod.z.any()).and(import_zod.z.object({ "url": import_zod.z.string().url().describe("The authorized agent's protocol endpoint URL: the exact agent URL buyers are given and send AdCP requests to, including the path (e.g., `https://agent.example.com/mcp`). A bare origin matches only an agent served at the root. An agent reachable at more than one agent URL (for example, separate MCP and A2A endpoints) needs one entry per URL. Callers comparing this URL against a registry (sales-agent list, signal-provider registry, TMP provider lookup, etc.) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality \u2014 two URLs that differ only in case, default port, or percent-encoding of unreserved characters are the same agent. See docs/reference/url-canonicalization."), "authorized_for": import_zod.z.string().min(1).max(500).describe("Human-readable description of what this agent is authorized to do \u2014 what it sells (for sales/property agents) or what data it provides (for signal agents). The variant the entry uses (`property_ids`, `signal_tags`, etc.) tells consumers which inflection applies; this field carries the operator-supplied label."), "signing_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().describe("Key identifier for selecting the correct signing key."), "kty": import_zod.z.string().describe("JWK key type, such as 'OKP', 'EC', or 'RSA'."), "alg": import_zod.z.string().describe("Expected signing algorithm for this key, such as 'EdDSA' or 'RS256'.").optional(), "use": import_zod.z.string().describe("Optional JWK use value. Typically 'sig' for signing keys.").optional(), "crv": import_zod.z.string().describe("Curve name for OKP or EC keys, such as 'Ed25519' or 'P-256'.").optional(), "x": import_zod.z.string().describe("Base64url-encoded public key x coordinate or public key value for OKP keys.").optional(), "y": import_zod.z.string().describe("Base64url-encoded public key y coordinate for EC keys.").optional(), "n": import_zod.z.string().describe("Base64url-encoded RSA modulus.").optional(), "e": import_zod.z.string().describe("Base64url-encoded RSA public exponent.").optional(), "revoked_at": import_zod.z.string().datetime().describe("Optional revocation timestamp. When present, verifiers MUST reject any signature produced with this key whose signing epoch (or equivalent time reference) is at or after this timestamp. The key may continue to appear in the trust anchor during a grace period so caches that have not yet refreshed still find the key and can evaluate the revocation marker. Keys past their revocation can be removed once the cache TTL (recommended: 5 minutes) has elapsed across all verifiers.").optional() }).catchall(import_zod.z.any()).describe("Publisher-attested public key material for an authorized agent. Buyers use these keys to verify signed agent responses against the trust anchor published in adagents.json rather than trusting key discovery from the agent domain alone.")).describe("Optional publisher-attested public signing keys for this agent. Use these as the trust anchor for verifying signed agent responses instead of relying on key discovery from the agent domain alone.").optional(), "encryption_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().max(8).describe("Key identifier. Opaque \u2014 MUST NOT encode geographic or deployment information."), "kty": import_zod.z.literal("OKP").describe("JWK key type. Must be OKP for X25519."), "crv": import_zod.z.literal("X25519").describe("Curve name. Must be X25519 for TMPX encryption."), "use": import_zod.z.literal("enc").describe("JWK use value. Must be enc for encryption keys."), "x": import_zod.z.string().describe("Base64url-encoded X25519 public key (32 bytes).") }).strict().describe("X25519 public key for HPKE encryption. Used for TMPX exposure token encryption with HPKE mode_base.")).describe("X25519 public keys for TMPX exposure token encryption. Each key identifies a cluster master that can decrypt TMPX tokens. Used with HPKE mode_base \u2014 read replicas encrypt with this public key, only the master can decrypt.").optional(), "last_updated": import_zod.z.string().datetime().describe("Optional ISO 8601 timestamp indicating when this `authorized_agents[]` entry last changed. Independent of the file-level `last_updated`. Lets validators perform a partial walk by skipping entries whose `last_updated` is older than their indexed value. Advisory \u2014 consumers MAY ignore and re-index the full file.").optional() }).describe("Fields shared by every variant of `authorized_agents[*]` in adagents.json, regardless of authorization_type. Variants `allOf` this base and add their discriminator-specific fields. Centralized to prevent drift across all authorization-type variants.")), import_zod.z.object({ "authorization_type": import_zod.z.literal("signal_ids").describe("Discriminator indicating authorization by specific signal IDs"), "signal_ids": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-zA-Z0-9_-]+$"))).describe("Signal IDs this agent is authorized to resell. Resolved against the top-level signals array in this file") }).catchall(import_zod.z.any()).and(import_zod.z.object({ "url": import_zod.z.string().url().describe("The authorized agent's protocol endpoint URL: the exact agent URL buyers are given and send AdCP requests to, including the path (e.g., `https://agent.example.com/mcp`). A bare origin matches only an agent served at the root. An agent reachable at more than one agent URL (for example, separate MCP and A2A endpoints) needs one entry per URL. Callers comparing this URL against a registry (sales-agent list, signal-provider registry, TMP provider lookup, etc.) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality \u2014 two URLs that differ only in case, default port, or percent-encoding of unreserved characters are the same agent. See docs/reference/url-canonicalization."), "authorized_for": import_zod.z.string().min(1).max(500).describe("Human-readable description of what this agent is authorized to do \u2014 what it sells (for sales/property agents) or what data it provides (for signal agents). The variant the entry uses (`property_ids`, `signal_tags`, etc.) tells consumers which inflection applies; this field carries the operator-supplied label."), "signing_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().describe("Key identifier for selecting the correct signing key."), "kty": import_zod.z.string().describe("JWK key type, such as 'OKP', 'EC', or 'RSA'."), "alg": import_zod.z.string().describe("Expected signing algorithm for this key, such as 'EdDSA' or 'RS256'.").optional(), "use": import_zod.z.string().describe("Optional JWK use value. Typically 'sig' for signing keys.").optional(), "crv": import_zod.z.string().describe("Curve name for OKP or EC keys, such as 'Ed25519' or 'P-256'.").optional(), "x": import_zod.z.string().describe("Base64url-encoded public key x coordinate or public key value for OKP keys.").optional(), "y": import_zod.z.string().describe("Base64url-encoded public key y coordinate for EC keys.").optional(), "n": import_zod.z.string().describe("Base64url-encoded RSA modulus.").optional(), "e": import_zod.z.string().describe("Base64url-encoded RSA public exponent.").optional(), "revoked_at": import_zod.z.string().datetime().describe("Optional revocation timestamp. When present, verifiers MUST reject any signature produced with this key whose signing epoch (or equivalent time reference) is at or after this timestamp. The key may continue to appear in the trust anchor during a grace period so caches that have not yet refreshed still find the key and can evaluate the revocation marker. Keys past their revocation can be removed once the cache TTL (recommended: 5 minutes) has elapsed across all verifiers.").optional() }).catchall(import_zod.z.any()).describe("Publisher-attested public key material for an authorized agent. Buyers use these keys to verify signed agent responses against the trust anchor published in adagents.json rather than trusting key discovery from the agent domain alone.")).describe("Optional publisher-attested public signing keys for this agent. Use these as the trust anchor for verifying signed agent responses instead of relying on key discovery from the agent domain alone.").optional(), "encryption_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().max(8).describe("Key identifier. Opaque \u2014 MUST NOT encode geographic or deployment information."), "kty": import_zod.z.literal("OKP").describe("JWK key type. Must be OKP for X25519."), "crv": import_zod.z.literal("X25519").describe("Curve name. Must be X25519 for TMPX encryption."), "use": import_zod.z.literal("enc").describe("JWK use value. Must be enc for encryption keys."), "x": import_zod.z.string().describe("Base64url-encoded X25519 public key (32 bytes).") }).strict().describe("X25519 public key for HPKE encryption. Used for TMPX exposure token encryption with HPKE mode_base.")).describe("X25519 public keys for TMPX exposure token encryption. Each key identifies a cluster master that can decrypt TMPX tokens. Used with HPKE mode_base \u2014 read replicas encrypt with this public key, only the master can decrypt.").optional(), "last_updated": import_zod.z.string().datetime().describe("Optional ISO 8601 timestamp indicating when this `authorized_agents[]` entry last changed. Independent of the file-level `last_updated`. Lets validators perform a partial walk by skipping entries whose `last_updated` is older than their indexed value. Advisory \u2014 consumers MAY ignore and re-index the full file.").optional() }).describe("Fields shared by every variant of `authorized_agents[*]` in adagents.json, regardless of authorization_type. Variants `allOf` this base and add their discriminator-specific fields. Centralized to prevent drift across all authorization-type variants.")).describe("Authorization for signals by specific signal IDs"), import_zod.z.object({ "authorization_type": import_zod.z.literal("signal_tags").describe("Discriminator indicating authorization by signal tags"), "signal_tags": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_-]+$"))).describe("Signal tags this agent is authorized for. Agent can resell all signals with these tags") }).catchall(import_zod.z.any()).and(import_zod.z.object({ "url": import_zod.z.string().url().describe("The authorized agent's protocol endpoint URL: the exact agent URL buyers are given and send AdCP requests to, including the path (e.g., `https://agent.example.com/mcp`). A bare origin matches only an agent served at the root. An agent reachable at more than one agent URL (for example, separate MCP and A2A endpoints) needs one entry per URL. Callers comparing this URL against a registry (sales-agent list, signal-provider registry, TMP provider lookup, etc.) MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality \u2014 two URLs that differ only in case, default port, or percent-encoding of unreserved characters are the same agent. See docs/reference/url-canonicalization."), "authorized_for": import_zod.z.string().min(1).max(500).describe("Human-readable description of what this agent is authorized to do \u2014 what it sells (for sales/property agents) or what data it provides (for signal agents). The variant the entry uses (`property_ids`, `signal_tags`, etc.) tells consumers which inflection applies; this field carries the operator-supplied label."), "signing_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().describe("Key identifier for selecting the correct signing key."), "kty": import_zod.z.string().describe("JWK key type, such as 'OKP', 'EC', or 'RSA'."), "alg": import_zod.z.string().describe("Expected signing algorithm for this key, such as 'EdDSA' or 'RS256'.").optional(), "use": import_zod.z.string().describe("Optional JWK use value. Typically 'sig' for signing keys.").optional(), "crv": import_zod.z.string().describe("Curve name for OKP or EC keys, such as 'Ed25519' or 'P-256'.").optional(), "x": import_zod.z.string().describe("Base64url-encoded public key x coordinate or public key value for OKP keys.").optional(), "y": import_zod.z.string().describe("Base64url-encoded public key y coordinate for EC keys.").optional(), "n": import_zod.z.string().describe("Base64url-encoded RSA modulus.").optional(), "e": import_zod.z.string().describe("Base64url-encoded RSA public exponent.").optional(), "revoked_at": import_zod.z.string().datetime().describe("Optional revocation timestamp. When present, verifiers MUST reject any signature produced with this key whose signing epoch (or equivalent time reference) is at or after this timestamp. The key may continue to appear in the trust anchor during a grace period so caches that have not yet refreshed still find the key and can evaluate the revocation marker. Keys past their revocation can be removed once the cache TTL (recommended: 5 minutes) has elapsed across all verifiers.").optional() }).catchall(import_zod.z.any()).describe("Publisher-attested public key material for an authorized agent. Buyers use these keys to verify signed agent responses against the trust anchor published in adagents.json rather than trusting key discovery from the agent domain alone.")).describe("Optional publisher-attested public signing keys for this agent. Use these as the trust anchor for verifying signed agent responses instead of relying on key discovery from the agent domain alone.").optional(), "encryption_keys": import_zod.z.array(import_zod.z.object({ "kid": import_zod.z.string().max(8).describe("Key identifier. Opaque \u2014 MUST NOT encode geographic or deployment information."), "kty": import_zod.z.literal("OKP").describe("JWK key type. Must be OKP for X25519."), "crv": import_zod.z.literal("X25519").describe("Curve name. Must be X25519 for TMPX encryption."), "use": import_zod.z.literal("enc").describe("JWK use value. Must be enc for encryption keys."), "x": import_zod.z.string().describe("Base64url-encoded X25519 public key (32 bytes).") }).strict().describe("X25519 public key for HPKE encryption. Used for TMPX exposure token encryption with HPKE mode_base.")).describe("X25519 public keys for TMPX exposure token encryption. Each key identifies a cluster master that can decrypt TMPX tokens. Used with HPKE mode_base \u2014 read replicas encrypt with this public key, only the master can decrypt.").optional(), "last_updated": import_zod.z.string().datetime().describe("Optional ISO 8601 timestamp indicating when this `authorized_agents[]` entry last changed. Independent of the file-level `last_updated`. Lets validators perform a partial walk by skipping entries whose `last_updated` is older than their indexed value. Advisory \u2014 consumers MAY ignore and re-index the full file.").optional() }).describe("Fields shared by every variant of `authorized_agents[*]` in adagents.json, regardless of authorization_type. Variants `allOf` this base and add their discriminator-specific fields. Centralized to prevent drift across all authorization-type variants.")).describe("Authorization for signals by tag membership")])).describe("Array of sales agents authorized to make inventory from this file available to buyers. Authorization can be scoped to specific properties, collections, countries, and time windows, with optional delegation metadata indicating whether the path is direct, delegated, or network-mediated. MAY be empty (`[]`) for a catalog-only community mirror \u2014 a file that publishes `formats`/`properties`/`placements` (with `catalog_etag`) for a platform that has not adopted AdCP, where there is no sales agent to authorize (see `catalog_etag`, `formats`, `superseded_by`). An empty array asserts *no sales authorization*: validators MUST NOT read it as deny-all, authorize-all, or a revocation, MUST NOT treat its presence as an error, and MUST still consume the catalog arrays."), "last_updated": import_zod.z.string().datetime().describe("ISO 8601 timestamp indicating when this file was last updated").optional(), "property_features": import_zod.z.array(import_zod.z.object({ "url": import_zod.z.string().url().describe("The agent's API endpoint URL. Callers comparing this URL against a feature-provider registry MUST canonicalize both sides per the AdCP URL canonicalization rules, not byte-equality. See docs/reference/url-canonicalization."), "name": import_zod.z.string().describe("Human-readable name of the vendor/agent (e.g., 'Scope3', 'TAG', 'OneTrust')"), "features": import_zod.z.array(import_zod.z.string()).describe("Feature IDs this agent provides (e.g., 'carbon_score', 'tag_certified_against_fraud'). Use get_adcp_capabilities on the agent for full definitions."), "publisher_id": import_zod.z.string().describe("Optional publisher identifier at this agent (for lookup)").optional() }).catchall(import_zod.z.any())).describe("[AdCP 3.0] Optional list of agents that provide property feature data (certifications, scores, compliance status). Used for discovery - actual data is accessed through property list filters.").optional(), "signals": import_zod.z.array(import_zod.z.object({ "id": import_zod.z.string().regex(new RegExp("^[a-zA-Z0-9_-]+$")).describe("Signal identifier within the publishing domain's adagents.json signals[]"), "name": import_zod.z.string().min(1).max(255).describe("Human-readable signal name"), "description": import_zod.z.string().max(2e3).describe("Detailed description of what this signal represents and how it's derived").optional(), "value_type": import_zod.z.enum(["binary", "categorical", "numeric"]).describe("The data type of this signal's values"), "tags": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[a-z0-9_-]+$"))).describe("Tags for grouping and filtering this domain's published signal definitions").optional(), "allowed_values": import_zod.z.array(import_zod.z.string()).describe("For categorical signals, the valid values users can be assigned").optional(), "restricted_attributes": import_zod.z.array(import_zod.z.enum(["racial_ethnic_origin", "political_opinions", "religious_beliefs", "trade_union_membership", "health_data", "sex_life_sexual_orientation", "genetic_data", "biometric_data", "age", "familial_status"]).describe("Personal data categories that may be restricted from use in audience targeting. Combines GDPR Article 9 special categories with US civil-rights protected classes (FHA familial_status, ADEA age). Used in two places: (1) on campaign plans via restricted_attributes to declare which categories are prohibited, and (2) on signal-definition.json via restricted_attributes to declare which categories a signal touches. Governance agents match plan restrictions against signal declarations for structural validation.")).describe("Restricted attribute categories this signal touches. Data providers SHOULD declare these so governance agents can structurally match signals against a plan's restricted_attributes without relying on semantic inference from the signal name or description.").optional(), "demographic_predicate": import_zod.z.object({ "age": import_zod.z.object({ "min": import_zod.z.number().int().gte(0).lte(150).describe("Inclusive minimum age in completed years. Omit for an open lower bound.").optional(), "max": import_zod.z.number().int().gte(0).lte(150).describe("Inclusive maximum age in completed years. Omit for an open upper bound.").optional(), "include_unknown": import_zod.z.boolean().describe("Whether delivery to people whose age is unavailable is part of this predicate. This field has no default and MUST be supplied.") }).catchall(import_zod.z.any()).and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()])).describe("A canonical audience-age predicate in completed integer years. min and max are inclusive; omitting one bound means no restriction in that direction. At least one bound is required. include_unknown is always explicit because people whose age is unavailable are not members of any numeric interval. Implementations MUST reject min greater than max; JSON Schema draft-07 cannot compare sibling numeric values.") }).catchall(import_zod.z.any()).describe("Authoritative machine-readable demographic meaning for this signal. Signal names and taxonomy labels alone never establish exact demographic equivalence. Signals carrying this field MUST also declare restricted_attributes including age.").optional(), "policy_categories": import_zod.z.array(import_zod.z.string()).describe("Policy categories this signal is sensitive for (e.g., a children's interest signal declares ['children_directed']). Governance agents match these against a plan's policy_categories to flag sensitive data usage.").optional(), "range": import_zod.z.object({ "min": import_zod.z.number().describe("Minimum value"), "max": import_zod.z.number().describe("Maximum value"), "unit": import_zod.z.string().describe("Unit of measurement (e.g., 'score', 'dollars', 'years')").optional() }).strict().describe("For numeric signals, the valid value range").optional(), "taxonomy": import_zod.z.object({ "ref": import_zod.z.string().url().describe("URI identifying the taxonomy or taxonomy documentation."), "version": import_zod.z.string().describe("Version identifier for the taxonomy when the taxonomy has versioned definitions.").optional(), "segtax": import_zod.z.number().int().gte(1).describe("OpenRTB segtax code when the taxonomy maps to an OpenRTB segment taxonomy.").optional(), "etag": import_zod.z.string().describe("Optional validator for custom taxonomy definitions so consumers can detect drift between signal publication and taxonomy resolution.").optional(), "values": import_zod.z.array(import_zod.z.object({ "id": import_zod.z.string().min(1).describe("Taxonomy node identifier."), "path": import_zod.z.string().describe("Optional human-readable or taxonomy-native path for display and review.").optional(), "modifiers": import_zod.z.array(import_zod.z.string()).describe("Optional taxonomy-specific modifiers that qualify the node.").optional() }).strict()).describe("Taxonomy node values that describe this signal. These are meaning/discovery metadata for the signal definition, not the values a buyer submits in package targeting expressions."), "value_mappings": import_zod.z.array(import_zod.z.object({ "value": import_zod.z.string().describe("Categorical value from allowed_values[]."), "taxonomy_value_id": import_zod.z.string().describe("Taxonomy node identifier corresponding to this categorical value."), "path": import_zod.z.string().describe("Optional human-readable or taxonomy-native path for display and review.").optional(), "modifiers": import_zod.z.array(import_zod.z.string()).describe("Optional taxonomy-specific modifiers that qualify the mapped value.").optional() }).strict()).describe("For categorical signals, maps package-targeting allowed_values[] strings to stable taxonomy node identifiers. The allowed_values[] strings remain the wire values buyers submit; this mapping explains how those strings resolve into the published taxonomy. Each value_mappings[].value SHOULD match one of the signal's allowed_values[] entries; JSON Schema draft-07 cannot enforce this cross-array constraint.").optional(), "parent_match_behavior": import_zod.z.enum(["exact_only", "descendants_supported", "unknown"]).describe("Whether this signal definition supports treating a parent taxonomy node as matching descendant nodes for discovery/filtering or seller-side expansion. 'exact_only' means only explicitly listed node ids match. 'descendants_supported' means the seller can expand known, version-pinned parent nodes to descendants internally, typically by ORing the children in its execution system. 'unknown' means the provider has not declared parent-node behavior. This field is metadata about discovery/translation behavior, not a package targeting operator.").optional() }).strict().describe("Optional taxonomy metadata describing what this signal means in an external audience, content, retail-media, or provider-owned taxonomy. Taxonomy metadata does not create a new value_type and does not change package targeting grammar: buyers still target the named signal according to value_type. When a taxonomy value is a parent node, parent/descendant expansion is seller behavior and must be declared through parent_match_behavior rather than assumed.").optional(), "segmentation_criteria": import_zod.z.string().max(500).describe("Rules governing inclusion of identifiers in the segment. Aligns with IAB Data Transparency Standard audience criteria disclosure.").optional(), "criteria_url": import_zod.z.string().url().describe("Optional URL to a longer-form methodology or criteria document. This is a disclosure pointer; buyers should not branch programmatically on the linked content.").optional(), "data_sources": import_zod.z.array(import_zod.z.enum(["app_behavior", "app_usage", "web_usage", "geo_location", "email", "tv_ott_or_stb_device", "panel", "online_ecommerce", "credit_data", "loyalty_card", "transaction", "online_survey", "offline_survey", "public_record_census", "public_record_voter_file", "public_record_other", "offline_transaction"])).describe("Origin categories of the raw data used to compile the signal, aligned with IAB Data Transparency Standard source disclosure. Use 'panel' for respondent-panel or JIC-style audience sources. Offline and public-record sources require onboarder disclosure. Co-viewing projection and reconciliation of seller claims against a JIC or measurement vendor belong in measurement reporting/vendor metrics rather than package signal targeting.").optional(), "methodology": import_zod.z.enum(["observed", "declared", "derived", "inferred", "modeled"]).describe("How the signal's audience membership or attribute was determined. 'modeled' requires the modeling block.").optional(), "audience_expansion": import_zod.z.boolean().describe("Whether look-alike or similar-audience expansion was used to include additional identifiers. When true, modeling is required.").optional(), "device_expansion": import_zod.z.boolean().describe("Whether the signal was expanded deterministically across devices of the same user, household, or business. Probabilistic cross-device expansion is modeling and should use methodology 'modeled' or the modeling block.").optional(), "refresh_cadence": import_zod.z.enum(["intra_day", "daily", "weekly", "monthly", "bi_monthly", "quarterly", "bi_annually", "annually"]).describe("Cadence at which the signal definition's underlying segment membership is refreshed.").optional(), "lookback_window": import_zod.z.enum(["intra_day", "daily", "weekly", "monthly", "bi_monthly", "quarterly", "bi_annually", "annually"]).describe("Time window in which a qualifying event can occur for inclusion.").optional(), "onboarder": import_zod.z.object({ "match_keys": import_zod.z.array(import_zod.z.enum(["name", "address", "email", "postal", "lat_long", "mobile_id", "cookie_id", "ip", "customer_id", "phone"])), "pre_onboarding_audience_expansion": import_zod.z.boolean().optional(), "pre_onboarding_device_expansion": import_zod.z.boolean().optional(), "pre_onboarding_precision_level": import_zod.z.enum(["individual", "household", "business", "geography"]).optional() }).strict().describe("Onboarder disclosure. Required when data_sources includes an offline_* or public_record_* source.").optional(), "subject_type": import_zod.z.enum(["individual", "household", "business", "contextual", "none"]).describe("What kind of subject this signal characterizes.").optional(), "resolution_method": import_zod.z.enum(["deterministic_id", "probabilistic_device", "browser", "geographic", "content_signal", "mixed"]).describe("How the subject is resolved at decision time.").optional(), "id_types": import_zod.z.array(import_zod.z.enum(["cookie", "mobile_id", "platform_id", "user_enabled_id"])).describe("Identifier currencies analyzed to determine audience membership or attributes.").optional(), "audience_scope": import_zod.z.enum(["single_domain", "cross_domain_owned", "cross_domain_unowned", "offline"]).describe("Context within which the audience attribute was determined. 'single_domain' requires originating_domain.").optional(), "originating_domain": import_zod.z.string().describe("Domain of the digital property where the audience originates. Required when audience_scope is 'single_domain'.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("ISO 3166-1 alpha-2 country codes where the signal is applicable. Sellers must not expose a signal for media buys in countries outside this list. Federating agents that surface a peer's signal MUST treat the peer-published list as an upper bound, re-check it against the buyer's intended deployment countries, and may apply only narrower local policy.").optional(), "consent_basis": import_zod.z.array(import_zod.z.enum(["consent", "legitimate_interest", "contract", "legal_obligation"]).describe("Common GDPR lawful bases relevant to advertising. Covers the Article 6(1) bases used in programmatic advertising contexts.")).describe("Declared GDPR Article 6 lawful basis or consent basis under which this signal's data is processed. For non-GDPR regimes, use countries, policy_categories, and disclosure fields to describe jurisdiction-specific obligations unless a future enum value applies.").optional(), "art9_basis": import_zod.z.enum(["explicit_consent", "manifestly_made_public", "substantial_public_interest", "vital_interests"]).describe("GDPR Article 9 basis when restricted_attributes is non-empty and the signal is used in jurisdictions where Article 9 applies. Required by policy for applicable use cases rather than universally required at schema level because sensitivity and lawful basis are jurisdiction-relative.").optional(), "modeling": import_zod.z.object({ "method": import_zod.z.enum(["lookalike", "supervised", "embedding", "rules"]), "seed_source": import_zod.z.object({ "type": import_zod.z.enum(["first_party_crm", "panel", "declared_survey", "transactional", "behavioral"]), "provider_signed": import_zod.z.boolean().describe("Whether the seed source carries a signed attestation under one of the provider's published signing keys. This is a forward-looking claim until the consumer can resolve and verify the provider's applicable signing keys through the AdCP signing profile; consumers MUST NOT treat this boolean alone as cryptographic proof.") }).strict(), "training_data_jurisdictions": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("ISO 3166-1 alpha-2 country codes where the model's training data was collected."), "ai_act_risk_class": import_zod.z.enum(["minimal", "limited", "high_risk"]).describe("EU AI Act risk classification self-declared by the provider. Prohibited-risk modeled signals must not be published as AdCP signal definitions."), "disclosure": import_zod.z.object({ "required": import_zod.z.boolean().describe("The provider's claim that a modeling or AI-use disclosure is required for this signal in at least one applicable jurisdiction. This is a declared compliance signal, not a protocol-level legal determination."), "jurisdictions": import_zod.z.array(import_zod.z.object({ "country": import_zod.z.string().regex(new RegExp("^[A-Z]{2}$")).describe("ISO 3166-1 alpha-2 country code."), "region": import_zod.z.string().describe("Provider-defined sub-national region code or name when the obligation is regional. No global canonical format is implied.").optional(), "regulation": import_zod.z.string().describe("Provider-supplied regulation identifier for the disclosure obligation."), "disclosure_text": import_zod.z.string().describe("Human-readable disclosure text or summary the provider expects buyers or reviewers to see.").optional(), "disclosure_url": import_zod.z.string().url().describe("Optional URL to the provider's canonical disclosure or methodology page for this jurisdiction.").optional(), "audience": import_zod.z.enum(["buyer", "data_subject", "regulator", "public"]).describe("Primary audience for this disclosure entry.").optional() }).strict()).describe("Jurisdictions where a modeling or AI-use disclosure applies.").optional(), "notes": import_zod.z.string().max(2e3).describe("Optional provider notes on how the disclosure should be interpreted. Informational only; buyers should not branch programmatically on this text.").optional() }).strict().and(import_zod.z.any()).describe("Signal/modeling-specific disclosure requirements and jurisdictional notes. This is not creative provenance render guidance.").optional() }).strict().describe("Modeling disclosure for modeled data signals. Required when methodology is 'modeled' or audience_expansion is true. This describes data modeling and intentionally does not reuse creative provenance, which is content/render oriented.").optional(), "data_subject_rights": import_zod.z.object({ "upstream_source_domain": import_zod.z.string().max(253).describe("Domain of the upstream data source whose rights process these channels reach, when different from the publishing domain.").optional(), "channels": import_zod.z.array(import_zod.z.object({ "rights": import_zod.z.array(import_zod.z.enum(["access", "rectification", "erasure", "portability", "objection"])).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), "All items must be unique!").describe("Rights supported by this channel."), "url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("HTTPS URL for submitting the rights request.").optional(), "email": import_zod.z.string().email().describe("Email address for submitting the rights request.").optional(), "languages": import_zod.z.array(import_zod.z.string()).describe("BCP 47 language tags supported by this channel.").optional(), "countries": import_zod.z.array(import_zod.z.string().regex(new RegExp("^[A-Z]{2}$"))).describe("ISO 3166-1 alpha-2 countries this channel serves, when the provider routes rights by country.").optional() }).strict().and(import_zod.z.union([import_zod.z.any(), import_zod.z.any()]))).describe("Rights request channels and the rights each channel supports. At least one declared channel MUST support one or more of access, erasure, or objection; schema validators enforce this with draft-07 contains, and consumers whose SDK drops contains need an equivalent runtime check."), "response_sla_days": import_zod.z.number().int().gte(1).lte(90).describe("Maximum response time in days for rights requests handled through the declared rights channels. For provider-published signals, providers SHOULD avoid duplicating this field across every signal unless the value varies by signal or upstream source; consumers MAY also consult the provider's public privacy policy or registry disclosures when present.").optional(), "ccpa_opt_out_url": import_zod.z.string().url().regex(new RegExp("^https://")).describe("US-specific 'Do Not Sell or Share' opt-out URL where required.").optional() }).strict().describe("Per-signal data-subject-rights routing. Inline on the signal because upstream source, rights routing, and response commitments can differ by segment or may be unavailable from a public provider document for custom/private signals. This is a contact/routing reference, not a machine-callable AdCP API.").optional(), "last_updated": import_zod.z.string().datetime().describe("When this definition record was last updated. This indicates freshness of the definition record, not an attestation that the underlying data or model was refreshed at that time.").optional(), "dts_compliant_version": import_zod.z.string().describe("IAB Data Transparency Standard version this signal definition self-attests as satisfying, when applicable.").optional() }).catchall(import_zod.z.any()).and(import_zod.z.intersection(import_zod.z.intersection(import_zod.z.any(), import_zod.z.intersection(import_zod.z.any(), import_zod.z.any())), import_zod.z.intersection(import_zod.z.any(), import_zod.z.intersection(import_zod.z.any(), import_zod.z.any())))).describe("Definition of a signal in published adagents.json signals[]. The publishing domain supplies the namespace, so this definition carries a local id rather than a signal_ref. Media-buy products reference this definition with signal_ref scope 'data_provider', data_provider_domain set to the publishing domain, and signal_id set to this id. Some constraints use JSON Schema draft-07 conditional keywords such as if/then and contains; SDK generators that drop those keywords need equivalent runtime guards.")).describe("Signal definitions published by this domain. Each entry defines a signal id within this file's publishing-domain namespace; entries do not include signal_ref objects. Signals Protocol discovery and media-buy product targeting reference these through signal_ref scope 'data_provider', with data_provider_domain set to this file's publishing domain and signal_id set to signals[].id.").optional(), "signal_tags": import_zod.z.record(import_zod.z.string(), import_zod.z.object({ "name": import_zod.z.string().describe("Human-readable name for this tag"), "description": import_zod.z.string().describe("Description of what this tag represents") }).catchall(import_zod.z.any())).describe("Metadata for each tag referenced by signals. Provides human-readable context for signal tag values.").optional() }).catchall(import_zod.z.any()).and(import_zod.z.intersection(import_zod.z.union([import_zod.z.any(), import_zod.z.any(), import_zod.z.any(), import_zod.z.any(), import_zod.z.any(), import_zod.z.any()]), import_zod.z.any())).describe("Inline structure variant - contains full agent authorization data")]).describe("Declaration of authorized agents for advertising inventory and data signals. Hosted at /.well-known/adagents.json on publisher domains (for properties) or data provider domains (for signals). Can either contain the full structure inline or reference an authoritative URL.");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AdagentsJsonSchema,