adcp

type ADCPVersion struct {
	MajorVersions []int           `json:"major_versions"`
	Idempotency   IdempotencyCaps `json:"idempotency"`
}

type Account struct {
	AccountID        string          `json:"account_id"`                  // Unique identifier for this account
	Name             string          `json:"name"`                        // Human-readable account name (e.g., 'Acme', 'Acme c/o Pinnacle')
	Advertiser       string          `json:"advertiser,omitempty"`        // The advertiser whose rates apply to this account
	BillingProxy     string          `json:"billing_proxy,omitempty"`     // Optional intermediary who receives invoices on behalf of the advertiser (e.g., a
	Status           string          `json:"status"`                      // Account lifecycle status. See the Accounts Protocol overview for the operations
	Brand            *BrandReference `json:"brand,omitempty"`             // Brand reference identifying the advertiser
	Operator         string          `json:"operator,omitempty"`          // Domain of the entity operating this account. When the brand operates directly, t
	Billing          string          `json:"billing,omitempty"`           // Who is invoiced on this account. operator: seller invoices the operator (agency
	BillingEntity    any             `json:"billing_entity,omitempty"`    // Business entity details for the party responsible for payment. Contains the lega
	RateCard         string          `json:"rate_card,omitempty"`         // Identifier for the rate card applied to this account
	PaymentTerms     string          `json:"payment_terms,omitempty"`     // Payment terms agreed for this account. Binding for all invoices when the account
	CreditLimit      any             `json:"credit_limit,omitempty"`      // Maximum outstanding balance allowed
	Setup            any             `json:"setup,omitempty"`             // Present when status is 'pending_approval'. Contains next steps for completing ac
	AccountScope     string          `json:"account_scope,omitempty"`     // How the seller scoped this account. operator: shared across all brands for this
	GovernanceAgents []any           `json:"governance_agents,omitempty"` // Governance agent endpoints registered on this account. Authentication credential
	ReportingBucket  any             `json:"reporting_bucket,omitempty"`  // Cloud storage bucket where the seller delivers offline reporting files for this
	Sandbox          *bool           `json:"sandbox,omitempty"`           // When true, this is a sandbox account — no real platform calls, no real spend. Fo
	Ext              any             `json:"ext,omitempty"`
}

type AccountCapabilities struct {
	RequireOperatorAuth   *bool    `json:"require_operator_auth,omitempty"`
	AuthorizationEndpoint string   `json:"authorization_endpoint,omitempty"`
	SupportedBilling      []string `json:"supported_billing"`
	RequiredForProducts   *bool    `json:"required_for_products,omitempty"`
	AccountFinancials     *bool    `json:"account_financials,omitempty"`
	Sandbox               *bool    `json:"sandbox,omitempty"`
}

type AccountInput struct {
	Brand        *BrandReference `json:"brand,omitempty"`
	Operator     string          `json:"operator,omitempty"`
	Billing      string          `json:"billing,omitempty"`
	PaymentTerms string          `json:"payment_terms,omitempty"`
	AccountID    string          `json:"account_id,omitempty"`
	Sandbox      bool            `json:"sandbox,omitempty"`
}

type AccountReference struct {
	AccountID string          `json:"account_id,omitempty"`
	Brand     *BrandReference `json:"brand,omitempty"`
	Operator  string          `json:"operator,omitempty"`
	Sandbox   bool            `json:"sandbox,omitempty"`
}

type AccountResult struct {
	AccountID    string          `json:"account_id"`
	Brand        *BrandReference `json:"brand,omitempty"`
	Operator     string          `json:"operator,omitempty"`
	Action       string          `json:"action"`
	Status       string          `json:"status"`
	AccountScope string          `json:"account_scope,omitempty"`
	Setup        *AccountSetup   `json:"setup,omitempty"`
	PaymentTerms string          `json:"payment_terms,omitempty"`
	Billing      string          `json:"billing,omitempty"`
}

type AccountSetup struct {
	URL     string `json:"url,omitempty"`
	Message string `json:"message,omitempty"`
}

type AccountStatus = string

type ActionSource = string

type ActivateSignalRequest struct {
	AdcpMajorVersion     int                `json:"adcp_major_version,omitempty"` // The AdCP major version the buyer's payloads conform to. Sellers validate against
	Action               string             `json:"action,omitempty"`             // Whether to activate or deactivate the signal. Deactivating removes the segment f
	SignalAgentSegmentID string             `json:"signal_agent_segment_id"`      // The universal identifier for the signal to activate
	Destinations         []DestinationInput `json:"destinations"`                 // Target destination(s) for activation. If the authenticated caller matches one of
	PricingOptionID      string             `json:"pricing_option_id,omitempty"`  // The pricing option selected from the signal's pricing_options in the get_signals
	Account              *AccountReference  `json:"account,omitempty"`            // Account for this activation. Associates with a commercial relationship establish
	IdempotencyKey       string             `json:"idempotency_key"`              // Client-generated unique key for this request. Prevents duplicate activations on
	Context              any                `json:"context,omitempty"`
	Ext                  any                `json:"ext,omitempty"`
}

type ActivationKey struct {
	Type      string `json:"type"`
	SegmentID string `json:"segment_id,omitempty"`
	Key       string `json:"key,omitempty"`
	Value     string `json:"value,omitempty"`
}

type AdcpError = map[string]any

type AdcpProtocol = string

type AdjustmentKind = string

type AdvertiserIndustry = string

type AgeRestrictionCaps struct {
	Supported           *bool    `json:"supported,omitempty"`
	VerificationMethods []string `json:"verification_methods,omitempty"`
}

type AgeVerificationMethod = string

type ArtifactWebhookPayload struct {
	IdempotencyKey string `json:"idempotency_key"`      // Sender-generated key stable across retries of the same webhook event. Sales agen
	MediaBuyID     string `json:"media_buy_id"`         // Media buy identifier these artifacts belong to
	BatchID        string `json:"batch_id"`             // Unique identifier for this batch of artifacts. Use for deduplication and acknowl
	Timestamp      string `json:"timestamp"`            // When this batch was generated (ISO 8601)
	Artifacts      []any  `json:"artifacts"`            // Content artifacts from delivered impressions
	Pagination     any    `json:"pagination,omitempty"` // Pagination info when batching large artifact sets
	Ext            any    `json:"ext,omitempty"`
}

type AssessmentStatus = string

type AssetContentType = string

type AssetSlot struct {
	ItemType           string   `json:"item_type"`
	AssetID            string   `json:"asset_id"`
	AssetType          string   `json:"asset_type"`
	Required           bool     `json:"required"`
	Description        string   `json:"description,omitempty"`
	AcceptedMediaTypes []string `json:"accepted_media_types,omitempty"`
}

type AttributionModel = string

type AttributionWindow struct {
	PostClick *Duration `json:"post_click,omitempty"`
	PostView  *Duration `json:"post_view,omitempty"`
	Model     string    `json:"model"`
}

type AttributionWindowOption struct {
	EventType string     `json:"event_type,omitempty"`
	PostClick []Duration `json:"post_click"`
	PostView  []Duration `json:"post_view,omitempty"`
}

type AudienceConstraints struct {
	Include []any `json:"include,omitempty"` // Desired audience criteria. The seller's targeting should align with these. Each
	Exclude []any `json:"exclude,omitempty"` // Excluded audience criteria. The seller's targeting must not overlap with these.
}

type AudienceSource = string

type AudienceStatus = string

type AudienceTargetingCaps struct {
	SupportedIdentifierTypes   []string              `json:"supported_identifier_types"`
	SupportsPlatformCustomerID *bool                 `json:"supports_platform_customer_id,omitempty"`
	SupportedUIDTypes          []string              `json:"supported_uid_types,omitempty"`
	MinimumAudienceSize        int                   `json:"minimum_audience_size"`
	MatchingLatencyHours       *MatchingLatencyRange `json:"matching_latency_hours,omitempty"`
}

type AuthScheme = string

type AvailableMetric = string

type BaseCollectionSource struct {
	SelectionType   string           `json:"selection_type"`
	Identifiers     []DistributionID `json:"identifiers,omitempty"`
	PublisherDomain string           `json:"publisher_domain,omitempty"`
	CollectionIDs   []string         `json:"collection_ids,omitempty"`
	Genres          []string         `json:"genres,omitempty"`
	GenreTaxonomy   string           `json:"genre_taxonomy,omitempty"`
}

type BillingMeasurement struct {
	Vendor             *BrandReference `json:"vendor"`
	MaxVariancePercent float64         `json:"max_variance_percent,omitempty"`
	MeasurementWindow  string          `json:"measurement_window,omitempty"`
}

type BrandAgentType = string

type BrandCapabilities struct {
	Rights              *bool    `json:"rights,omitempty"`
	RightTypes          []string `json:"right_types,omitempty"`
	AvailableUses       []string `json:"available_uses,omitempty"`
	GenerationProviders []string `json:"generation_providers,omitempty"`
	Description         string   `json:"description,omitempty"`
}

type BrandReference struct {
	Domain                  string                   `json:"domain"`
	BrandID                 string                   `json:"brand_id,omitempty"`
	Industries              []string                 `json:"industries,omitempty"`
	DataSubjectContestation *DataSubjectContestation `json:"data_subject_contestation,omitempty"`
}

type BuildCreativeRequest struct {
	AdcpMajorVersion    int               `json:"adcp_major_version,omitempty"`    // The AdCP major version the buyer's payloads conform to. Sellers validate against
	Message             string            `json:"message,omitempty"`               // Natural language instructions for the transformation or generation. For pure gen
	CreativeManifest    *CreativeManifest `json:"creative_manifest,omitempty"`     // Creative manifest to transform or generate from. For pure generation, this shoul
	CreativeID          string            `json:"creative_id,omitempty"`           // Reference to a creative in the agent's library. The creative agent resolves this
	ConceptID           string            `json:"concept_id,omitempty"`            // Creative concept containing the creative. Creative agents SHOULD assign globally
	MediaBuyID          string            `json:"media_buy_id,omitempty"`          // Media buy identifier for tag generation context. When the creative agent is also
	PackageID           string            `json:"package_id,omitempty"`            // Package identifier within the media buy. Used with media_buy_id when the creativ
	TargetFormatID      *FormatRef        `json:"target_format_id,omitempty"`      // Single format ID to generate. Mutually exclusive with target_format_ids. The for
	TargetFormatIDs     []FormatRef       `json:"target_format_ids,omitempty"`     // Array of format IDs to generate in a single call. Mutually exclusive with target
	Account             *AccountReference `json:"account,omitempty"`               // Account reference for pricing and billing. When present, the creative agent appl
	Brand               *BrandReference   `json:"brand,omitempty"`                 // Brand reference for creative generation. Resolved to full brand identity (colors
	Quality             string            `json:"quality,omitempty"`               // Quality tier for generation. 'draft' produces fast, lower-fidelity output for it
	ItemLimit           int               `json:"item_limit,omitempty"`            // Maximum number of catalog items to use when generating. When a catalog asset con
	IncludePreview      *bool             `json:"include_preview,omitempty"`       // When true, requests the creative agent to include preview renders in the respons
	PreviewInputs       []any             `json:"preview_inputs,omitempty"`        // Input sets for preview generation when include_preview is true. Each input set d
	PreviewQuality      string            `json:"preview_quality,omitempty"`       // Render quality for inline preview when include_preview is true. 'draft' produces
	PreviewOutputFormat string            `json:"preview_output_format,omitempty"` // Output format for preview renders when include_preview is true. 'url' returns pr
	MacroValues         map[string]string `json:"macro_values,omitempty"`          // Macro values to pre-substitute into the output manifest's assets. Keys are unive
	IdempotencyKey      string            `json:"idempotency_key"`                 // Client-generated unique key for this request. Prevents duplicate creative genera
	Context             any               `json:"context,omitempty"`
	Ext                 any               `json:"ext,omitempty"`
}

type BuildCreativeResult struct {
	CreativeManifest map[string]any `json:"creative_manifest"`
	Sandbox          bool           `json:"sandbox,omitempty"`
}

type CanceledBy = string

type CancellationFee struct {
	Type   string  `json:"type"` // "percent_remaining", "full_commitment", "fixed_fee", "none"
	Rate   float64 `json:"rate,omitempty"`
	Amount float64 `json:"amount,omitempty"`
}

type CancellationPolicy struct {
	NoticePeriod    Duration        `json:"notice_period"`
	CancellationFee CancellationFee `json:"cancellation_fee"`
}

type CapabilitiesData struct {
	ADCP                  *ADCPVersion                   `json:"adcp"`
	SupportedProtocols    []string                       `json:"supported_protocols"`
	Account               *AccountCapabilities           `json:"account,omitempty"`
	MediaBuy              *MediaBuyCapabilities          `json:"media_buy,omitempty"`
	Signals               *SignalsCapabilities           `json:"signals,omitempty"`
	Governance            *GovernanceCapabilities        `json:"governance,omitempty"`
	SponsoredIntelligence *SICapabilities                `json:"sponsored_intelligence,omitempty"`
	Brand                 *BrandCapabilities             `json:"brand,omitempty"`
	Creative              *CreativeCapabilities          `json:"creative,omitempty"`
	RequestSigning        *RequestSigningCapabilities    `json:"request_signing,omitempty"`
	WebhookSigning        *WebhookSigningCapabilities    `json:"webhook_signing,omitempty"`
	Identity              *IdentityCapabilities          `json:"identity,omitempty"`
	ComplianceTesting     *ComplianceTestingCapabilities `json:"compliance_testing,omitempty"`
	Specialisms           []string                       `json:"specialisms,omitempty"`
	ExtensionsSupported   []string                       `json:"extensions_supported,omitempty"`
	LastUpdated           string                         `json:"last_updated,omitempty"`
	Errors                []AdcpError                    `json:"errors,omitempty"`
	Context               any                            `json:"context,omitempty"`
	Ext                   any                            `json:"ext,omitempty"`
}

type Catalog struct {
	CatalogID         string           `json:"catalog_id,omitempty"`          // Buyer's identifier for this catalog. Required when syncing via sync_catalogs. Wh
	Name              string           `json:"name,omitempty"`                // Human-readable name for this catalog (e.g., 'Summer Products 2025', 'Amsterdam S
	Type              string           `json:"type"`                          // Catalog type. Structural types: 'offering' (AdCP Offering objects), 'product' (e
	URL               string           `json:"url,omitempty"`                 // URL to an external catalog feed. The platform fetches and resolves items from th
	FeedFormat        string           `json:"feed_format,omitempty"`         // Format of the external feed at url. Required when url points to a non-AdCP feed
	UpdateFrequency   string           `json:"update_frequency,omitempty"`    // How often the platform should re-fetch the feed from url. Only applicable when u
	Items             []map[string]any `json:"items,omitempty"`               // Inline catalog data. The item schema depends on the catalog type: Offering objec
	IDs               []string         `json:"ids,omitempty"`                 // Filter catalog to specific item IDs. For offering-type catalogs, these are offer
	Gtins             []string         `json:"gtins,omitempty"`               // Filter product-type catalogs by GTIN identifiers for cross-retailer catalog matc
	Tags              []string         `json:"tags,omitempty"`                // Filter catalog to items with these tags. Tags are matched using OR logic — items
	Category          string           `json:"category,omitempty"`            // Filter catalog to items in this category (e.g., 'beverages/soft-drinks', 'chef-p
	Query             string           `json:"query,omitempty"`               // Natural language filter for catalog items (e.g., 'all pasta sauces under $5', 'a
	ConversionEvents  []string         `json:"conversion_events,omitempty"`   // Event types that represent conversions for items in this catalog. Declares what
	ContentIDType     string           `json:"content_id_type,omitempty"`     // Identifier type that the event's content_ids field should be matched against for
	FeedFieldMappings []any            `json:"feed_field_mappings,omitempty"` // Declarative normalization rules for external feeds. Maps non-standard feed field
}

type CatalogAction = string

type CatalogInput struct {
	CatalogID string           `json:"catalog_id"`
	Items     []map[string]any `json:"items,omitempty"`
}

type CatalogItemStatus = string

type CatalogResult struct {
	CatalogID     string `json:"catalog_id"`
	Action        string `json:"action"`
	ItemCount     int    `json:"item_count"`
	ItemsApproved int    `json:"items_approved"`
}

type CatalogType = string

type Channels = string

type CheckGovernanceRequest struct {
	AdcpMajorVersion    int            `json:"adcp_major_version,omitempty"`   // The AdCP major version the buyer's payloads conform to. Sellers validate against
	PlanID              string         `json:"plan_id"`                        // Campaign governance plan identifier. The plan uniquely scopes the account and op
	Caller              string         `json:"caller"`                         // URL of the agent making the request.
	PurchaseType        string         `json:"purchase_type,omitempty"`        // The type of financial commitment being checked. Determines which budget allocati
	Tool                string         `json:"tool,omitempty"`                 // The AdCP tool being checked (e.g., 'create_media_buy', 'acquire_rights', 'activa
	Payload             map[string]any `json:"payload,omitempty"`              // The full tool arguments as they would be sent to the seller. Present on intent c
	GovernanceContext   string         `json:"governance_context,omitempty"`   // Governance context token from a prior check_governance response. Pass this on su
	Phase               string         `json:"phase,omitempty"`                // The phase of the governed action's lifecycle. 'purchase': initial commitment (cr
	PlannedDelivery     any            `json:"planned_delivery,omitempty"`     // What the seller will actually deliver. Present on execution checks.
	DeliveryMetrics     any            `json:"delivery_metrics,omitempty"`     // Actual delivery performance data. MUST be present for 'delivery' phase. The gove
	ModificationSummary string         `json:"modification_summary,omitempty"` // Human-readable summary of what changed. SHOULD be present for 'modification' pha
	InvoiceRecipient    any            `json:"invoice_recipient,omitempty"`    // Invoice recipient from the purchase request. MUST be present when the tool paylo
	Context             any            `json:"context,omitempty"`
	Ext                 any            `json:"ext,omitempty"`
}

type CheckGovernanceResponse struct {
	CheckID             string   `json:"check_id"`                       // Unique identifier for this governance check record. Use in report_plan_outcome t
	Status              string   `json:"status"`                         // Governance decision. 'approved': proceed as planned. 'denied': do not proceed. '
	PlanID              string   `json:"plan_id"`                        // Echoed from request.
	Explanation         string   `json:"explanation"`                    // Human-readable explanation of the governance decision.
	Findings            []any    `json:"findings,omitempty"`             // Specific issues found during the governance check. Present when status is 'denie
	Conditions          []any    `json:"conditions,omitempty"`           // Present when status is 'conditions'. Specific adjustments the caller must make.
	ExpiresAt           string   `json:"expires_at,omitempty"`           // When this approval expires. Present when status is 'approved' or 'conditions'. T
	NextCheck           string   `json:"next_check,omitempty"`           // When the seller should next call check_governance with delivery metrics. Present
	CategoriesEvaluated []string `json:"categories_evaluated,omitempty"` // Governance categories evaluated during this check.
	PoliciesEvaluated   []string `json:"policies_evaluated,omitempty"`   // Registry policy IDs evaluated during this check.
	GovernanceContext   string   `json:"governance_context,omitempty"`   // Governance context token for this governed action. The buyer MUST attach this to
	Context             any      `json:"context,omitempty"`
	Ext                 any      `json:"ext,omitempty"`
}

type CloudStorageProtocol = string

type CoBrandingRequirement = string

type CollectionCadence = string

type CollectionList struct {
	ListID             string                 `json:"list_id"`
	Name               string                 `json:"name"`
	Description        string                 `json:"description,omitempty"`
	Principal          string                 `json:"principal,omitempty"`
	BaseCollections    []BaseCollectionSource `json:"base_collections,omitempty"`
	Filters            *CollectionListFilters `json:"filters,omitempty"`
	Brand              *BrandReference        `json:"brand,omitempty"`
	WebhookURL         string                 `json:"webhook_url,omitempty"`
	CacheDurationHours int                    `json:"cache_duration_hours,omitempty"`
	CreatedAt          string                 `json:"created_at,omitempty"`
	UpdatedAt          string                 `json:"updated_at,omitempty"`
	CollectionCount    int                    `json:"collection_count,omitempty"`
}

type CollectionListChangedWebhook struct {
	IdempotencyKey  string `json:"idempotency_key"`             // Sender-generated key stable across retries of the same webhook event. Governance
	Event           string `json:"event"`                       // The event type
	ListID          string `json:"list_id"`                     // ID of the collection list that changed
	ListName        string `json:"list_name,omitempty"`         // Name of the collection list
	ChangeSummary   any    `json:"change_summary,omitempty"`    // Summary of changes to the resolved list
	ResolvedAt      string `json:"resolved_at"`                 // When the list was re-resolved
	CacheValidUntil string `json:"cache_valid_until,omitempty"` // When the consumer should refresh from the governance agent
	Signature       string `json:"signature"`                   // HMAC-SHA256 webhook signature over {unix_timestamp}.{raw_http_body_bytes} using
	Ext             any    `json:"ext,omitempty"`
}

type CollectionListFilters struct {
	ContentRatingsExclude  []ContentRating  `json:"content_ratings_exclude,omitempty"`
	ContentRatingsInclude  []ContentRating  `json:"content_ratings_include,omitempty"`
	GenresExclude          []string         `json:"genres_exclude,omitempty"`
	GenresInclude          []string         `json:"genres_include,omitempty"`
	GenreTaxonomy          string           `json:"genre_taxonomy,omitempty"`
	Kinds                  []string         `json:"kinds,omitempty"`
	ExcludeDistributionIDs []DistributionID `json:"exclude_distribution_ids,omitempty"`
	ProductionQuality      []string         `json:"production_quality,omitempty"`
}

type CollectionListRef struct {
	AgentURL  string `json:"agent_url"`
	ListID    string `json:"list_id"`
	AuthToken string `json:"auth_token,omitempty"`
}

type CollectionPagination struct {
	MaxResults int    `json:"max_results,omitempty"` // 1-10000, default 1000
	Cursor     string `json:"cursor,omitempty"`
}

type CollectionRelationship = string

type CollectionStatus = string

type ComplianceTestingCapabilities struct {
	Scenarios []string `json:"scenarios"`
}

type ComplyTestControllerRequest struct {
	Scenario string `json:"scenario"`         // Test scenario to execute. 'list_scenarios' discovers supported scenarios. 'force
	Params   any    `json:"params,omitempty"` // Scenario-specific parameters. Required for all scenarios except list_scenarios.
	Context  any    `json:"context,omitempty"`
	Ext      any    `json:"ext,omitempty"`
}

type ComplyTestControllerResponse = any

type Config struct {
	// Sandbox marks all responses as sandbox/test data.
	Sandbox bool

	// IdempotencyReplayTTL is how long this agent retains a canonical response
	// for an idempotency_key. Required by AdCP 3.0 — sellers MUST declare their
	// replay window. Must be in [1h, 7d]; 24h is recommended. Register panics
	// if this is zero or outside the valid range.
	IdempotencyReplayTTL time.Duration

	// Capabilities, if set, declares the full typed capabilities response.
	// supported_protocols and adcp.idempotency are filled in automatically if
	// left empty. Use this to declare account / media_buy / signals / etc.
	// blocks. If nil, a minimal response with just adcp + supported_protocols
	// is built from the registered handlers.
	Capabilities *CapabilitiesData

	// ResolveAccount converts an AccountReference (brand + operator) to your
	// internal account object. Called automatically before handlers that receive
	// an account field. Return nil for unknown accounts (SDK sends ACCOUNT_NOT_FOUND).
	ResolveAccount func(ctx context.Context, ref AccountReference) (any, error)

	// --- Media buy ---
	SyncAccounts   func(ctx context.Context, req *SyncAccountsRequest) ([]AccountResult, error)
	SyncGovernance func(ctx context.Context, req *SyncGovernanceRequest) ([]GovernanceResult, error)
	GetProducts    func(ctx context.Context, acct any, req *GetProductsRequest) (*ProductsData, error)
	CreateMediaBuy func(ctx context.Context, acct any, req *CreateMediaBuyRequest) (*MediaBuyData, error)
	GetMediaBuys   func(ctx context.Context, acct any, req *GetMediaBuysRequest) ([]MediaBuyData, error)
	GetDelivery    func(ctx context.Context, acct any, req *GetMediaBuyDeliveryRequest) (*DeliveryData, error)

	// --- Creative ---
	ListCreativeFormats func(ctx context.Context, req *ListCreativeFormatsRequest) ([]CreativeFormat, error)
	SyncCreatives       func(ctx context.Context, req *SyncCreativesRequest) ([]CreativeResult, error)

	// --- Signals ---
	GetSignals     func(ctx context.Context, req *GetSignalsRequest) ([]Signal, error)
	ActivateSignal func(ctx context.Context, req *ActivateSignalRequest) ([]Deployment, error)

	// --- Collection ---
	CreateCollectionList func(ctx context.Context, req *CreateCollectionListRequest) (*CreateCollectionListResult, error)
	GetCollectionList    func(ctx context.Context, req *GetCollectionListRequest) (*GetCollectionListResult, error)
	UpdateCollectionList func(ctx context.Context, req *UpdateCollectionListRequest) (*CollectionList, error)
	DeleteCollectionList func(ctx context.Context, req *DeleteCollectionListRequest) error
	ListCollectionLists  func(ctx context.Context, req *ListCollectionListsRequest) (*ListCollectionListsResult, error)
}

type ConsentBasis = string

type ContentIDType = string

type ContentRating struct {
	System string `json:"system"`
	Rating string `json:"rating"`
}

type ContentRatingSystem = string

type ContentStandardsCaps struct {
	SupportsLocalEvaluation *bool    `json:"supports_local_evaluation,omitempty"`
	SupportedChannels       []string `json:"supported_channels,omitempty"`
	SupportsWebhookDelivery *bool    `json:"supports_webhook_delivery,omitempty"`
}

type ControllerError struct {
	Success      bool   `json:"success"`
	Error        string `json:"error"`                   // Structured error code
	ErrorDetail  string `json:"error_detail,omitempty"`  // Human-readable explanation of the failure
	CurrentState any    `json:"current_state,omitempty"` // Current state of the entity, or null if not found
	Context      any    `json:"context,omitempty"`
	Ext          any    `json:"ext,omitempty"`
}

type ConversionTrackingCaps struct {
	MultiSourceEventDedup      *bool                     `json:"multi_source_event_dedup,omitempty"`
	SupportedEventTypes        []string                  `json:"supported_event_types,omitempty"`
	SupportedUIDTypes          []string                  `json:"supported_uid_types,omitempty"`
	SupportedHashedIdentifiers []string                  `json:"supported_hashed_identifiers,omitempty"`
	SupportedActionSources     []string                  `json:"supported_action_sources,omitempty"`
	AttributionWindows         []AttributionWindowOption `json:"attribution_windows,omitempty"`
}

type CreateCollectionListRequest struct {
	AdcpMajorVersion int                    `json:"adcp_major_version,omitempty"` // The AdCP major version the buyer's payloads conform to. Sellers validate against
	Account          *AccountReference      `json:"account,omitempty"`            // Account that will own the list. Pass a natural key (brand, operator, optional sa
	Name             string                 `json:"name"`                         // Human-readable name for the list
	Description      string                 `json:"description,omitempty"`        // Description of the list's purpose
	BaseCollections  []BaseCollectionSource `json:"base_collections,omitempty"`   // Array of collection sources to evaluate. Each entry is a discriminated union: di
	Filters          *CollectionListFilters `json:"filters,omitempty"`            // Dynamic filters to apply when resolving the list
	Brand            *BrandReference        `json:"brand,omitempty"`              // Brand reference. When provided, the agent automatically applies appropriate rule
	IdempotencyKey   string                 `json:"idempotency_key"`              // Client-generated unique key for this request. Prevents duplicate collection list
	Context          any                    `json:"context,omitempty"`
	Ext              any                    `json:"ext,omitempty"`
}

type CreateCollectionListResult struct {
	List      *CollectionList
	AuthToken string
}

type CreateMediaBuyError struct {
	Errors  []AdcpError `json:"errors"` // Array of errors explaining why the operation failed
	Context any         `json:"context,omitempty"`
	Ext     any         `json:"ext,omitempty"`
}

type CreateMediaBuyRequest struct {
	AdcpMajorVersion       int              `json:"adcp_major_version,omitempty"`     // The AdCP major version the buyer's payloads conform to. Sellers validate against
	IdempotencyKey         string           `json:"idempotency_key"`                  // Client-generated unique key for this request. If a request with the same idempot
	PlanID                 string           `json:"plan_id,omitempty"`                // Campaign governance plan identifier. Required when the account has governance_ag
	Account                AccountReference `json:"account"`                          // Account to bill for this media buy. Pass a natural key (brand, operator, optiona
	ProposalID             string           `json:"proposal_id,omitempty"`            // ID of a proposal from get_products to execute. When provided with total_budget,
	TotalBudget            any              `json:"total_budget,omitempty"`           // Total budget for the media buy when executing a proposal. The publisher applies
	Packages               []PackageInput   `json:"packages,omitempty"`               // Array of package configurations. Required when not using proposal_id. When execu
	Brand                  BrandReference   `json:"brand"`                            // Brand reference for this media buy. Resolved to full brand identity at execution
	AdvertiserIndustry     string           `json:"advertiser_industry,omitempty"`    // Industry classification for this specific campaign. A brand may operate across m
	InvoiceRecipient       any              `json:"invoice_recipient,omitempty"`      // Override the account's default billing entity for this specific buy. When provid
	IoAcceptance           any              `json:"io_acceptance,omitempty"`          // Acceptance of an insertion order from a committed proposal. Required when the pr
	PoNumber               string           `json:"po_number,omitempty"`              // Purchase order number for tracking
	AgencyEstimateNumber   string           `json:"agency_estimate_number,omitempty"` // Agency estimate or authorization number. Primary financial reference for broadca
	StartTime              any              `json:"start_time"`
	EndTime                string           `json:"end_time"`                           // Campaign end date/time in ISO 8601 format
	PushNotificationConfig any              `json:"push_notification_config,omitempty"` // Optional webhook configuration for async task status notifications. Publisher wi
	ReportingWebhook       any              `json:"reporting_webhook,omitempty"`        // Optional webhook configuration for automated reporting delivery
	ArtifactWebhook        any              `json:"artifact_webhook,omitempty"`         // Optional webhook configuration for content artifact delivery. Used by governance
	Context                any              `json:"context,omitempty"`
	Ext                    any              `json:"ext,omitempty"`
}

type CreateMediaBuyResponse = any

type CreateMediaBuySubmitted struct {
	Status  string      `json:"status"`            // Task-level status literal. Discriminates this async envelope from the synchronou
	TaskID  string      `json:"task_id"`           // Task handle the buyer uses with tasks/get, and that the seller references on pus
	Message string      `json:"message,omitempty"` // Optional human-readable explanation of why the task is submitted — e.g., 'Awaiti
	Errors  []AdcpError `json:"errors,omitempty"`  // Optional advisory errors accompanying the submitted envelope. Use only for non-b
	Context any         `json:"context,omitempty"`
	Ext     any         `json:"ext,omitempty"`
}

type CreateMediaBuySuccess struct {
	MediaBuyID       string    `json:"media_buy_id"`                // Seller's unique identifier for the created media buy
	Account          *Account  `json:"account,omitempty"`           // Account billed for this media buy. Includes advertiser, billing proxy (if any),
	InvoiceRecipient any       `json:"invoice_recipient,omitempty"` // Per-buy invoice recipient, echoed from the request when provided. Confirms the s
	Status           string    `json:"status,omitempty"`            // Initial media buy status. Either 'pending_creatives' (awaiting creative assets),
	ConfirmedAt      string    `json:"confirmed_at,omitempty"`      // ISO 8601 timestamp when this media buy was confirmed by the seller. A successful
	CreativeDeadline string    `json:"creative_deadline,omitempty"` // ISO 8601 timestamp for creative upload deadline
	Revision         int       `json:"revision,omitempty"`          // Initial revision number for this media buy. Use in subsequent update_media_buy r
	ValidActions     []string  `json:"valid_actions,omitempty"`     // Actions the buyer can perform on this media buy after creation. Saves a round-tr
	Packages         []Package `json:"packages"`                    // Array of created packages with complete state information
	PlannedDelivery  any       `json:"planned_delivery,omitempty"`  // The seller's interpreted delivery parameters. Describes what the seller will act
	Sandbox          *bool     `json:"sandbox,omitempty"`           // When true, this response contains simulated data from sandbox mode.
	Context          any       `json:"context,omitempty"`
	Ext              any       `json:"ext,omitempty"`
}

type CreativeAction = string

type CreativeAgentCapability = string

type CreativeApprovalStatus = string

type CreativeAsset struct {
	CreativeID          string               `json:"creative_id"`                    // Unique identifier for the creative
	Name                string               `json:"name"`                           // Human-readable creative name
	FormatID            FormatRef            `json:"format_id"`                      // Format identifier specifying which format this creative conforms to. Can be: (1)
	Assets              map[string]any       `json:"assets"`                         // Assets required by the format, keyed by asset_id. Each asset value carries an `a
	Inputs              []any                `json:"inputs,omitempty"`               // Preview contexts for generative formats - defines what scenarios to generate pre
	Tags                []string             `json:"tags,omitempty"`                 // User-defined tags for organization and searchability
	Status              string               `json:"status,omitempty"`               // For generative creatives: set to 'approved' to finalize, 'rejected' to request r
	Weight              float64              `json:"weight,omitempty"`               // Optional delivery weight for creative rotation when uploading via create_media_b
	PlacementIDs        []string             `json:"placement_ids,omitempty"`        // Optional array of placement IDs where this creative should run when uploading vi
	IndustryIdentifiers []IndustryIdentifier `json:"industry_identifiers,omitempty"` // Industry-standard identifiers for this creative (e.g., Ad-ID, ISCI, Clearcast cl
	Provenance          any                  `json:"provenance,omitempty"`           // Provenance metadata for this creative. Serves as the default provenance for all
}

type CreativeBrief struct {
	Name            string `json:"name"`                       // Campaign or flight name for identification
	Objective       string `json:"objective,omitempty"`        // Campaign objective that guides creative tone and call-to-action strategy
	Tone            string `json:"tone,omitempty"`             // Desired tone for this campaign, modulating the brand's base tone (e.g., 'playful
	Audience        string `json:"audience,omitempty"`         // Target audience description for this campaign
	Territory       string `json:"territory,omitempty"`        // Creative territory or positioning the campaign should occupy
	Messaging       any    `json:"messaging,omitempty"`        // Messaging framework for the campaign
	ReferenceAssets []any  `json:"reference_assets,omitempty"` // Visual and strategic reference materials such as mood boards, product shots, exa
	Compliance      any    `json:"compliance,omitempty"`       // Regulatory and legal compliance requirements for this campaign. Campaign-specifi
}

type CreativeCapabilities struct {
	SupportsCompliance     *bool `json:"supports_compliance,omitempty"`
	HasCreativeLibrary     *bool `json:"has_creative_library,omitempty"`
	SupportsGeneration     *bool `json:"supports_generation,omitempty"`
	SupportsTransformation *bool `json:"supports_transformation,omitempty"`
}

type CreativeConsumption struct {
	Tokens          int     `json:"tokens,omitempty"`
	ImagesGenerated int     `json:"images_generated,omitempty"`
	Renders         int     `json:"renders,omitempty"`
	DurationSeconds float64 `json:"duration_seconds,omitempty"`
}

type CreativeFilters struct {
	FormatIDs []FormatRef `json:"format_ids,omitempty"`
}

type CreativeFormat struct {
	FormatID                     FormatRef             `json:"format_id"`                                // Structured format identifier with agent URL and format name
	Name                         string                `json:"name"`                                     // Human-readable format name
	Description                  string                `json:"description,omitempty"`                    // Plain text explanation of what this format does and what assets it requires
	ExampleURL                   string                `json:"example_url,omitempty"`                    // Optional URL to showcase page with examples and interactive demos of this format
	AcceptsParameters            []string              `json:"accepts_parameters,omitempty"`             // List of parameters this format accepts in format_id. Template formats define whi
	Renders                      []Render              `json:"renders,omitempty"`                        // Specification of rendered pieces for this format. Most formats produce a single
	Assets                       []AssetSlot           `json:"assets,omitempty"`                         // Array of all assets supported for this format. Each asset is identified by its a
	Delivery                     map[string]any        `json:"delivery,omitempty"`                       // Delivery method specifications (e.g., hosted, VAST, third-party tags)
	SupportedMacros              []any                 `json:"supported_macros,omitempty"`               // List of universal macros supported by this format (e.g., MEDIA_BUY_ID, CACHEBUST
	InputFormatIDs               []FormatRef           `json:"input_format_ids,omitempty"`               // Array of format IDs this format accepts as input creative manifests. When presen
	OutputFormatIDs              []FormatRef           `json:"output_format_ids,omitempty"`              // Array of format IDs that this format can produce as output. When present, indica
	FormatCard                   any                   `json:"format_card,omitempty"`                    // Optional standard visual card (300x400px) for displaying this format in user int
	Accessibility                any                   `json:"accessibility,omitempty"`                  // Accessibility posture of this format. Declares the WCAG conformance level that c
	SupportedDisclosurePositions []string              `json:"supported_disclosure_positions,omitempty"` // Disclosure positions this format can render. Buyers use this to determine whethe
	DisclosureCapabilities       []any                 `json:"disclosure_capabilities,omitempty"`        // Structured disclosure capabilities per position with persistence modes. Declares
	FormatCardDetailed           any                   `json:"format_card_detailed,omitempty"`           // Optional detailed card with carousel and full specifications. Provides rich form
	ReportedMetrics              []string              `json:"reported_metrics,omitempty"`               // Metrics this format can produce in delivery reporting. Buyers receive the inters
	PricingOptions               []VendorPricingOption `json:"pricing_options,omitempty"`                // Pricing options for this format. Used by transformation and generation agents th
}

type CreativeIdentifierType = string

type CreativeInput struct {
	CreativeID string         `json:"creative_id"`
	FormatID   *FormatRef     `json:"format_id,omitempty"`
	Name       string         `json:"name,omitempty"`
	Assets     map[string]any `json:"assets,omitempty"`
}

type CreativeListItem struct {
	CreativeID string    `json:"creative_id"`
	Name       string    `json:"name"`
	FormatID   FormatRef `json:"format_id"`
	Status     string    `json:"status"`
}

type CreativeManifest struct {
	FormatID            FormatRef            `json:"format_id"`                      // Format identifier this manifest is for. Can be a template format (id only) or a
	Assets              map[string]any       `json:"assets"`                         // Map of asset IDs to actual asset content. Each key MUST match an asset_id from t
	Rights              []any                `json:"rights,omitempty"`               // Rights constraints attached to this creative. Each entry represents constraints
	IndustryIdentifiers []IndustryIdentifier `json:"industry_identifiers,omitempty"` // Industry-standard identifiers for this specific manifest (e.g., Ad-ID, ISCI, Cle
	Provenance          any                  `json:"provenance,omitempty"`           // Provenance metadata for this creative manifest. Serves as the default provenance
	Ext                 any                  `json:"ext,omitempty"`
}

type CreativeQuality = string

type CreativeResult struct {
	CreativeID      string   `json:"creative_id"`
	Action          string   `json:"action"`
	Status          string   `json:"status,omitempty"`
	RejectionReason string   `json:"rejection_reason,omitempty"`
	Errors          []string `json:"errors,omitempty"`
}

type CreativeSortField = string

type CreativeSpecsCaps struct {
	VASTVersions  []string `json:"vast_versions,omitempty"`
	MRAIDVersions []string `json:"mraid_versions,omitempty"`
	VPAID         *bool    `json:"vpaid,omitempty"`
	SIMID         *bool    `json:"simid,omitempty"`
}

type CreativeStatus = string

type DaastTrackingEvent = string

type DaastVersion = string

type DataSubjectContestation struct {
	URL       string   `json:"url,omitempty"`
	Email     string   `json:"email,omitempty"`
	Languages []string `json:"languages,omitempty"`
}

type DayOfWeek = string

type DelegationAuthority = string

type DeleteCollectionListRequest struct {
	AdcpMajorVersion int               `json:"adcp_major_version,omitempty"` // The AdCP major version the buyer's payloads conform to. Sellers validate against
	ListID           string            `json:"list_id"`                      // ID of the collection list to delete
	Account          *AccountReference `json:"account,omitempty"`            // Account that owns the list. Required when the authenticated agent has access to
	Context          any               `json:"context,omitempty"`
	Ext              any               `json:"ext,omitempty"`
	IdempotencyKey   string            `json:"idempotency_key"` // Client-generated unique key for at-most-once execution. If a request with the sa
}

type DeliveryData struct {
	ReportingPeriod    ReportingPeriod    `json:"reporting_period"`
	MediaBuyDeliveries []MediaBuyDelivery `json:"media_buy_deliveries"`
}

type DeliveryTotals struct {
	Impressions        float64 `json:"impressions,omitempty"`          // Impressions delivered
	Spend              float64 `json:"spend,omitempty"`                // Amount spent
	Clicks             float64 `json:"clicks,omitempty"`               // Total clicks
	Ctr                float64 `json:"ctr,omitempty"`                  // Click-through rate (clicks/impressions)
	Views              float64 `json:"views,omitempty"`                // Content engagements counted toward the billable view threshold. For video this i
	CompletedViews     float64 `json:"completed_views,omitempty"`      // Video/audio completions. When the package has a completed_views optimization goa
	CompletionRate     float64 `json:"completion_rate,omitempty"`      // Completion rate (completed_views/impressions)
	Conversions        float64 `json:"conversions,omitempty"`          // Total conversions attributed to this delivery. When by_event_type is present, th
	ConversionValue    float64 `json:"conversion_value,omitempty"`     // Total monetary value of attributed conversions (in the reporting currency)
	Roas               float64 `json:"roas,omitempty"`                 // Return on ad spend (conversion_value / spend)
	CostPerAcquisition float64 `json:"cost_per_acquisition,omitempty"` // Cost per conversion (spend / conversions)
	NewToBrandRate     float64 `json:"new_to_brand_rate,omitempty"`    // Fraction of conversions from first-time brand buyers (0 = none, 1 = all)
	Leads              float64 `json:"leads,omitempty"`                // Leads generated (convenience alias for by_event_type where event_type='lead')
	ByEventType        []any   `json:"by_event_type,omitempty"`        // Conversion metrics broken down by event type. Spend-derived metrics (ROAS, CPA)
	Grps               float64 `json:"grps,omitempty"`                 // Gross Rating Points delivered (for CPP)
	Reach              float64 `json:"reach,omitempty"`                // Unique reach in the units specified by reach_unit. When reach_unit is omitted, u
	ReachUnit          any     `json:"reach_unit,omitempty"`           // Unit of measurement for the reach field. Aligns with the reach_unit declared on
	Frequency          float64 `json:"frequency,omitempty"`            // Average frequency per reach unit (typically measured over campaign duration, but
	QuartileData       any     `json:"quartile_data,omitempty"`        // Audio/video quartile completion data
	DoohMetrics        any     `json:"dooh_metrics,omitempty"`         // DOOH-specific metrics (only included for DOOH campaigns)
	Viewability        any     `json:"viewability,omitempty"`          // Viewability metrics. Viewable rate should be calculated as viewable_impressions
	Engagements        float64 `json:"engagements,omitempty"`          // Total engagements — direct interactions with the ad beyond viewing. Includes soc
	Follows            float64 `json:"follows,omitempty"`              // New followers, page likes, artist/podcast/channel subscribes attributed to this
	Saves              float64 `json:"saves,omitempty"`                // Saves, bookmarks, playlist adds, pins attributed to this delivery.
	ProfileVisits      float64 `json:"profile_visits,omitempty"`       // Visits to the brand's in-platform page (profile, artist page, channel, or storef
	EngagementRate     float64 `json:"engagement_rate,omitempty"`      // Platform-specific engagement rate (0.0 to 1.0). Typically engagements/impression
	CostPerClick       float64 `json:"cost_per_click,omitempty"`       // Cost per click (spend / clicks)
	ByActionSource     []any   `json:"by_action_source,omitempty"`     // Conversion metrics broken down by action source (website, app, in_store, etc.).
}

type DeliveryType = string

type DemographicSystem = string

type Deployment struct {
	Type                               string         `json:"type"`
	Platform                           string         `json:"platform,omitempty"`
	AgentURL                           string         `json:"agent_url,omitempty"`
	Account                            string         `json:"account,omitempty"`
	IsLive                             bool           `json:"is_live"`
	ActivationKey                      *ActivationKey `json:"activation_key,omitempty"`
	DeployedAt                         string         `json:"deployed_at,omitempty"`
	EstimatedActivationDurationMinutes int            `json:"estimated_activation_duration_minutes,omitempty"`
}

type DerivativeType = string

type DestinationInput struct {
	Type     string `json:"type"`
	Platform string `json:"platform,omitempty"`
	AgentURL string `json:"agent_url,omitempty"`
	Account  string `json:"account,omitempty"`
}

type DevicePlatform = string

type DeviceType = string

type DigitalSourceType = string

type DimensionUnit = string

type DisclosurePersistence = string

type DisclosurePosition = string

type DistanceUnit = string

type DistributionID struct {
	Type  string `json:"type"`
	Value string `json:"value"`
}

type DistributionIdentifierType = string

type Duration struct {
	Interval int    `json:"interval"`
	Unit     string `json:"unit"` // "seconds", "minutes", "hours", "days", "campaign"
}

type EmptyInput struct{}

type ErrorCode = string

type ErrorOptions struct {
	Message    string
	Recovery   string // "retry", "revise", "contact_support", "terminal"
	Field      string
	Suggestion string
	RetryAfter int
	Details    map[string]any
}

type EscalationSeverity = string

type Event struct {
	EventID         string `json:"event_id"`                    // Unique identifier for deduplication (scoped to event_type + event_source_id)
	EventType       string `json:"event_type"`                  // Standard event type
	EventTime       string `json:"event_time"`                  // ISO 8601 timestamp when the event occurred
	UserMatch       any    `json:"user_match,omitempty"`        // User identifiers for attribution matching
	CustomData      any    `json:"custom_data,omitempty"`       // Event-specific data (value, currency, items, etc.)
	ActionSource    string `json:"action_source,omitempty"`     // Where the event originated
	EventSourceURL  string `json:"event_source_url,omitempty"`  // URL where the event occurred (required when action_source is 'website')
	CustomEventName string `json:"custom_event_name,omitempty"` // Name for custom events (used when event_type is 'custom')
	Ext             any    `json:"ext,omitempty"`
}

type EventSourceInput struct {
	EventSourceID string `json:"event_source_id"`
}

type EventSourceResult struct {
	EventSourceID string            `json:"event_source_id"`
	Action        string            `json:"action"`
	Setup         *EventSourceSetup `json:"setup,omitempty"`
}

type EventSourceSetup struct {
	Snippet     string `json:"snippet,omitempty"`
	Description string `json:"description,omitempty"`
}

type EventType = string

type Exclusivity = string

type FeatureRange struct {
	Min float64 `json:"min"`
	Max float64 `json:"max"`
}

type FeedFormat = string

type FeedbackSource = string

type ForecastMethod = string

type ForecastRangeUnit = string

type ForecastableMetric = string

type FormatIDParameter = string

type FormatRef struct {
	AgentURL   string  `json:"agent_url"`             // URL of the agent that defines this format (e.g., 'https://creatives.adcontextpro
	ID         string  `json:"id"`                    // Format identifier within the agent's namespace (e.g., 'display_static', 'video_h
	Width      int     `json:"width,omitempty"`       // Width in pixels for visual formats. When specified, height must also be specifie
	Height     int     `json:"height,omitempty"`      // Height in pixels for visual formats. When specified, width must also be specifie
	DurationMs float64 `json:"duration_ms,omitempty"` // Duration in milliseconds for time-based formats (video, audio). When specified,
}

type FrequencyCapScope = string

type GenreTaxonomy = string

type GeoLevel = string

type GeoMetrosCaps struct {
	NielsenDMA    *bool `json:"nielsen_dma,omitempty"`
	UKITL1        *bool `json:"uk_itl1,omitempty"`
	UKITL2        *bool `json:"uk_itl2,omitempty"`
	EurostatNUTS2 *bool `json:"eurostat_nuts2,omitempty"`
}

type GeoPostalAreasCaps struct {
	USZip         *bool `json:"us_zip,omitempty"`
	USZipPlusFour *bool `json:"us_zip_plus_four,omitempty"`
	GBOutward     *bool `json:"gb_outward,omitempty"`
	GBFull        *bool `json:"gb_full,omitempty"`
	CAFSA         *bool `json:"ca_fsa,omitempty"`
	CAFull        *bool `json:"ca_full,omitempty"`
	DEPLZ         *bool `json:"de_plz,omitempty"`
	FRCodePostal  *bool `json:"fr_code_postal,omitempty"`
	AUPostcode    *bool `json:"au_postcode,omitempty"`
	CHPLZ         *bool `json:"ch_plz,omitempty"`
	ATPLZ         *bool `json:"at_plz,omitempty"`
}

type GeoProximityCaps struct {
	Radius         *bool    `json:"radius,omitempty"`
	TravelTime     *bool    `json:"travel_time,omitempty"`
	Geometry       *bool    `json:"geometry,omitempty"`
	TransportModes []string `json:"transport_modes,omitempty"`
}

type GetAdcpCapabilitiesRequest struct {
	AdcpMajorVersion int      `json:"adcp_major_version,omitempty"` // The AdCP major version the buyer's payloads conform to. When provided, the selle
	Protocols        []string `json:"protocols,omitempty"`          // Specific protocols to query capabilities for. If omitted, returns capabilities f
	Context          any      `json:"context,omitempty"`
	Ext              any      `json:"ext,omitempty"`
}

type GetAdcpCapabilitiesResponse struct {
	Adcp                  any         `json:"adcp"`                             // Core AdCP protocol information
	SupportedProtocols    []string    `json:"supported_protocols"`              // AdCP protocols this agent supports. Each value both (a) declares which tools the
	Account               any         `json:"account,omitempty"`                // Account management capabilities. Describes how accounts are established, what bi
	MediaBuy              any         `json:"media_buy,omitempty"`              // Media-buy protocol capabilities. Expected when media_buy is in supported_protoco
	Signals               any         `json:"signals,omitempty"`                // Signals protocol capabilities. Only present if signals is in supported_protocols
	Governance            any         `json:"governance,omitempty"`             // Governance protocol capabilities. Only present if governance is in supported_pro
	SponsoredIntelligence any         `json:"sponsored_intelligence,omitempty"` // Sponsored Intelligence protocol capabilities. Only present if sponsored_intellig
	Brand                 any         `json:"brand,omitempty"`                  // Brand protocol capabilities. Only present if brand is in supported_protocols. Br
	Creative              any         `json:"creative,omitempty"`               // Creative protocol capabilities. Only present if creative is in supported_protoco
	RequestSigning        any         `json:"request_signing,omitempty"`        // RFC 9421 HTTP Signatures support for incoming requests. Optional in 3.0 — capabi
	WebhookSigning        any         `json:"webhook_signing,omitempty"`        // RFC 9421 webhook-signature support for outbound webhook callbacks (top-level pee
	Identity              any         `json:"identity,omitempty"`               // Operator identity posture — key-scoping and compromise-response controls the age
	ComplianceTesting     any         `json:"compliance_testing,omitempty"`     // Compliance testing capabilities. The presence of this block declares that the ag
	Specialisms           []string    `json:"specialisms,omitempty"`            // Optional — specialized compliance claims this agent supports. Omitting the field
	ExtensionsSupported   []string    `json:"extensions_supported,omitempty"`   // Extension namespaces this agent supports. Buyers can expect meaningful data in e
	ExperimentalFeatures  []string    `json:"experimental_features,omitempty"`  // Experimental AdCP surfaces this agent implements. A surface is experimental when
	LastUpdated           string      `json:"last_updated,omitempty"`           // ISO 8601 timestamp of when capabilities were last updated. Buyers can use this f
	Errors                []AdcpError `json:"errors,omitempty"`                 // Task-specific errors and warnings
	Context               any         `json:"context,omitempty"`
	Ext                   any         `json:"ext,omitempty"`
}

type GetCollectionListRequest struct {
	AdcpMajorVersion int               `json:"adcp_major_version,omitempty"` // The AdCP major version the buyer's payloads conform to. Sellers validate against
	ListID           string            `json:"list_id"`                      // ID of the collection list to retrieve
	Account          *AccountReference `json:"account,omitempty"`            // Account that owns the list. Required when the authenticated agent has access to
	Resolve          *bool             `json:"resolve,omitempty"`            // Whether to apply filters and return resolved collections (default: true)
	Pagination       any               `json:"pagination,omitempty"`         // Pagination parameters. Uses higher limits than standard pagination because colle
	Context          any               `json:"context,omitempty"`
	Ext              any               `json:"ext,omitempty"`
}

type GetCollectionListResult struct {
	List        *CollectionList
	Collections []ResolvedCollection
	Pagination  *PaginationResponse
}

type GetMediaBuyDeliveryRequest struct {
	AdcpMajorVersion             int               `json:"adcp_major_version,omitempty"`              // The AdCP major version the buyer's payloads conform to. Sellers validate against
	Account                      *AccountReference `json:"account,omitempty"`                         // Filter delivery data to a specific account. When omitted, returns data across al
	MediaBuyIDs                  []string          `json:"media_buy_ids,omitempty"`                   // Array of media buy IDs to get delivery data for
	StatusFilter                 any               `json:"status_filter,omitempty"`                   // Filter by status. Can be a single status or array of statuses
	StartDate                    string            `json:"start_date,omitempty"`                      // Start date for reporting period (YYYY-MM-DD). When omitted along with end_date,
	EndDate                      string            `json:"end_date,omitempty"`                        // End date for reporting period (YYYY-MM-DD). When omitted along with start_date,
	IncludePackageDailyBreakdown *bool             `json:"include_package_daily_breakdown,omitempty"` // When true, include daily_breakdown arrays within each package in by_package. Use
	AttributionWindow            any               `json:"attribution_window,omitempty"`              // Attribution window to apply for conversion metrics. When provided, the seller re
	ReportingDimensions          any               `json:"reporting_dimensions,omitempty"`            // Request dimensional breakdowns in delivery reporting. Each key enables a specifi
	Context                      any               `json:"context,omitempty"`
	Ext                          any               `json:"ext,omitempty"`
}

type GetMediaBuyDeliveryResponse struct {
	NotificationType   string             `json:"notification_type,omitempty"`  // Type of webhook notification (only present in webhook deliveries): scheduled = r
	PartialData        *bool              `json:"partial_data,omitempty"`       // Indicates if any media buys in this webhook have missing/delayed data (only pres
	UnavailableCount   int                `json:"unavailable_count,omitempty"`  // Number of media buys with reporting_delayed or failed status (only present in we
	SequenceNumber     int                `json:"sequence_number,omitempty"`    // Sequential notification number (only present in webhook deliveries, starts at 1)
	NextExpectedAt     string             `json:"next_expected_at,omitempty"`   // ISO 8601 timestamp for next expected notification (only present in webhook deliv
	ReportingPeriod    any                `json:"reporting_period"`             // Date range for the report. All periods use UTC timezone.
	Currency           string             `json:"currency"`                     // ISO 4217 currency code
	AttributionWindow  *AttributionWindow `json:"attribution_window,omitempty"` // Attribution methodology and lookback windows used for conversion metrics in this
	AggregatedTotals   any                `json:"aggregated_totals,omitempty"`  // Combined metrics across all returned media buys. Only included in API responses
	MediaBuyDeliveries []any              `json:"media_buy_deliveries"`         // Array of delivery data for media buys. When used in webhook notifications, may c
	Errors             []AdcpError        `json:"errors,omitempty"`             // Task-specific errors and warnings (e.g., missing delivery data, reporting platfo
	Sandbox            *bool              `json:"sandbox,omitempty"`            // When true, this response contains simulated data from sandbox mode.
	Context            any                `json:"context,omitempty"`
	Ext                any                `json:"ext,omitempty"`
}

type GetMediaBuysRequest struct {
	AdcpMajorVersion int                `json:"adcp_major_version,omitempty"` // The AdCP major version the buyer's payloads conform to. Sellers validate against
	Account          *AccountReference  `json:"account,omitempty"`            // Account to retrieve media buys for. When omitted, returns data across all access
	MediaBuyIDs      []string           `json:"media_buy_ids,omitempty"`      // Array of media buy IDs to retrieve. When omitted, returns a paginated set of acc
	StatusFilter     any                `json:"status_filter,omitempty"`      // Filter by status. Can be a single status or array of statuses. Defaults to ["act
	IncludeSnapshot  *bool              `json:"include_snapshot,omitempty"`   // When true, include a near-real-time delivery snapshot for each package. Snapshot
	IncludeHistory   int                `json:"include_history,omitempty"`    // When present, include the last N revision history entries for each media buy (re
	Pagination       *PaginationRequest `json:"pagination,omitempty"`         // Cursor-based pagination controls. Strongly recommended when querying broad scope
	Context          any                `json:"context,omitempty"`
	Ext              any                `json:"ext,omitempty"`
}

type GetMediaBuysResponse struct {
	MediaBuys  []any               `json:"media_buys"`           // Array of media buys with status, creative approval state, and optional delivery
	Errors     []AdcpError         `json:"errors,omitempty"`     // Task-specific errors (e.g., media buy not found)
	Pagination *PaginationResponse `json:"pagination,omitempty"` // Pagination metadata for the media_buys array.
	Sandbox    *bool               `json:"sandbox,omitempty"`    // When true, this response contains simulated data from sandbox mode.
	Context    any                 `json:"context,omitempty"`
	Ext        any                 `json:"ext,omitempty"`
}

type GetPlanAuditLogsRequest struct {
	AdcpMajorVersion   int      `json:"adcp_major_version,omitempty"`  // The AdCP major version the buyer's payloads conform to. Sellers validate against
	PlanIDs            []string `json:"plan_ids,omitempty"`            // Plan IDs to retrieve. For a single plan, pass a one-element array. Plans uniquel
	PortfolioPlanIDs   []string `json:"portfolio_plan_ids,omitempty"`  // Portfolio plan IDs. The governance agent expands each to its member_plan_ids and
	GovernanceContexts []string `json:"governance_contexts,omitempty"` // Filter audit entries by governance context. Returns only checks and outcomes tha
	PurchaseTypes      []string `json:"purchase_types,omitempty"`      // Filter audit entries by purchase type. Returns only checks and outcomes matching
	IncludeEntries     *bool    `json:"include_entries,omitempty"`     // Include the full audit trail. Default: false.
	Context            any      `json:"context,omitempty"`
	Ext                any      `json:"ext,omitempty"`
}

type GetPlanAuditLogsResponse struct {
	Plans   []any `json:"plans"` // Audit data for each requested plan.
	Context any   `json:"context,omitempty"`
	Ext     any   `json:"ext,omitempty"`
}

type GetProductsRequest struct {
	AdcpMajorVersion       int                `json:"adcp_major_version,omitempty"`       // The AdCP major version the buyer's payloads conform to. Sellers validate against
	BuyingMode             string             `json:"buying_mode"`                        // Declares buyer intent for this request. 'brief': publisher curates product recom
	Brief                  string             `json:"brief,omitempty"`                    // Natural language description of campaign requirements. Required when buying_mode
	Refine                 []map[string]any   `json:"refine,omitempty"`                   // Array of change requests for iterating on products and proposals from a previous
	Brand                  *BrandReference    `json:"brand,omitempty"`                    // Brand reference for product discovery context. Resolved to full brand identity a
	Catalog                *Catalog           `json:"catalog,omitempty"`                  // Catalog of items the buyer wants to promote. The seller matches catalog items ag
	Account                *AccountReference  `json:"account,omitempty"`                  // Account for product lookup. Returns products with pricing specific to this accou
	PreferredDeliveryTypes []string           `json:"preferred_delivery_types,omitempty"` // Delivery types the buyer prefers, in priority order. Unlike filters.delivery_typ
	Filters                any                `json:"filters,omitempty"`
	PropertyList           any                `json:"property_list,omitempty"` // [AdCP 3.0] Reference to an externally managed property list. When provided, the
	Fields                 []string           `json:"fields,omitempty"`        // Specific product fields to include in the response. When omitted, all fields are
	TimeBudget             any                `json:"time_budget,omitempty"`   // Maximum time the buyer will commit to this request. The seller returns the best
	Pagination             *PaginationRequest `json:"pagination,omitempty"`
	Context                any                `json:"context,omitempty"`
	RequiredPolicies       []string           `json:"required_policies,omitempty"` // Registry policy IDs that the buyer requires to be enforced for products in this
	Ext                    any                `json:"ext,omitempty"`
}

type GetProductsResponse struct {
	Products            []Product           `json:"products"`                        // Array of matching products
	Proposals           []any               `json:"proposals,omitempty"`             // Optional array of proposed media plans with budget allocations across products.
	Errors              []AdcpError         `json:"errors,omitempty"`                // Task-specific errors and warnings (e.g., product filtering issues)
	PropertyListApplied *bool               `json:"property_list_applied,omitempty"` // [AdCP 3.0] Indicates whether property_list filtering was applied. True if the ag
	CatalogApplied      *bool               `json:"catalog_applied,omitempty"`       // Whether the seller filtered results based on the provided catalog. True if the s
	RefinementApplied   []map[string]any    `json:"refinement_applied,omitempty"`    // Seller's response to each change request in the refine array, matched by positio
	Incomplete          []any               `json:"incomplete,omitempty"`            // Declares what the seller could not finish within the buyer's time_budget or due
	Pagination          *PaginationResponse `json:"pagination,omitempty"`
	Sandbox             *bool               `json:"sandbox,omitempty"` // When true, this response contains simulated data from sandbox mode.
	Context             any                 `json:"context,omitempty"`
	Ext                 any                 `json:"ext,omitempty"`
}

type GetSignalsRequest struct {
	AdcpMajorVersion int                `json:"adcp_major_version,omitempty"` // The AdCP major version the buyer's payloads conform to. Sellers validate against
	Account          *AccountReference  `json:"account,omitempty"`            // Account for this request. When provided, the signals agent returns per-account p
	SignalSpec       string             `json:"signal_spec,omitempty"`        // Natural language description of the desired signals. When used alone, enables se
	SignalIDs        []SignalID         `json:"signal_ids,omitempty"`         // Specific signals to look up by data provider and ID. Returns exact matches from
	Destinations     []any              `json:"destinations,omitempty"`       // Filter signals to those activatable on specific agents/platforms. When omitted,
	Countries        []string           `json:"countries,omitempty"`          // Countries where signals will be used (ISO 3166-1 alpha-2 codes). When omitted, n
	Filters          *SignalFilters     `json:"filters,omitempty"`
	MaxResults       int                `json:"max_results,omitempty"` // Maximum number of results to return
	Pagination       *PaginationRequest `json:"pagination,omitempty"`
	Context          any                `json:"context,omitempty"`
	Ext              any                `json:"ext,omitempty"`
}

type GetSignalsResponse struct {
	Signals    []any               `json:"signals"`          // Array of matching signals
	Errors     []AdcpError         `json:"errors,omitempty"` // Task-specific errors and warnings (e.g., signal discovery or pricing issues)
	Pagination *PaginationResponse `json:"pagination,omitempty"`
	Sandbox    *bool               `json:"sandbox,omitempty"` // When true, this response contains simulated data from sandbox mode.
	Context    any                 `json:"context,omitempty"`
	Ext        any                 `json:"ext,omitempty"`
}

type GovernanceAccount struct {
	Brand    *BrandReference `json:"brand,omitempty"`
	Operator string          `json:"operator,omitempty"`
}

type GovernanceAccountInput struct {
	Account          *GovernanceAccount `json:"account,omitempty"`
	Brand            *BrandReference    `json:"brand,omitempty"`
	Operator         string             `json:"operator,omitempty"`
	GovernanceAgents []GovernanceAgent  `json:"governance_agents,omitempty"`
}

type GovernanceAgent struct {
	URL        string   `json:"url"`
	Categories []string `json:"categories,omitempty"`
}

type GovernanceCapabilities struct {
	PropertyFeatures []GovernanceFeature `json:"property_features,omitempty"`
	CreativeFeatures []GovernanceFeature `json:"creative_features,omitempty"`
}

type GovernanceDomain = string

type GovernanceFeature struct {
	FeatureID      string        `json:"feature_id"`
	Type           string        `json:"type"`
	Range          *FeatureRange `json:"range,omitempty"`
	Categories     []string      `json:"categories,omitempty"`
	Description    string        `json:"description,omitempty"`
	MethodologyURL string        `json:"methodology_url,omitempty"`
}

type GovernanceMode = string

type GovernancePhase = string

type GovernanceResult struct {
	Account          *GovernanceAccount `json:"account"`
	Status           string             `json:"status"`
	GovernanceAgents []GovernanceAgent  `json:"governance_agents"`
}

type HTTPMethod = string

type HistoryEntryType = string

type HumanOverride struct {
	Reason     string `json:"reason"`
	Approver   string `json:"approver"`
	ApprovedAt string `json:"approved_at,omitempty"`
}

type IdempotencyCaps struct {
	ReplayTTLSeconds int `json:"replay_ttl_seconds"`
}

type IdentifierTypes = string

type IdentityCapabilities struct {
	PerPrincipalKeyIsolation bool                            `json:"per_principal_key_isolation,omitempty"`
	KeyOrigins               *IdentityKeyOrigins             `json:"key_origins,omitempty"`
	CompromiseNotification   *IdentityCompromiseNotification `json:"compromise_notification,omitempty"`
}

type IdentityCompromiseNotification struct {
	Emits   bool `json:"emits,omitempty"`
	Accepts bool `json:"accepts,omitempty"`
}

type IdentityKeyOrigins struct {
	GovernanceSigning string `json:"governance_signing,omitempty"`
	RequestSigning    string `json:"request_signing,omitempty"`
	WebhookSigning    string `json:"webhook_signing,omitempty"`
	TMPSigning        string `json:"tmp_signing,omitempty"`
}

type IndustryIdentifier struct {
	Type  string `json:"type"`
	Value string `json:"value"`
}

type InstallmentStatus = string

type JavascriptModuleType = string

type KeywordMatchCaps struct {
	SupportedMatchTypes []string `json:"supported_match_types"`
}

type LandingPageRequirement = string

type ListAccountsRequest struct {
	AdcpMajorVersion int                `json:"adcp_major_version,omitempty"` // The AdCP major version the buyer's payloads conform to. Sellers validate against
	Status           string             `json:"status,omitempty"`             // Filter accounts by status. Omit to return accounts in all statuses.
	Pagination       *PaginationRequest `json:"pagination,omitempty"`
	Sandbox          *bool              `json:"sandbox,omitempty"` // Filter by sandbox status. true returns only sandbox accounts, false returns only
	Context          any                `json:"context,omitempty"`
	Ext              any                `json:"ext,omitempty"`
}

type ListAccountsResponse struct {
	Accounts   []Account           `json:"accounts"`         // Array of accounts accessible to the authenticated agent
	Errors     []AdcpError         `json:"errors,omitempty"` // Task-specific errors and warnings
	Pagination *PaginationResponse `json:"pagination,omitempty"`
	Context    any                 `json:"context,omitempty"`
	Ext        any                 `json:"ext,omitempty"`
}

type ListCollectionListsRequest struct {
	AdcpMajorVersion int                `json:"adcp_major_version,omitempty"` // The AdCP major version the buyer's payloads conform to. Sellers validate against
	Account          *AccountReference  `json:"account,omitempty"`            // Filter to lists owned by this account. When omitted, returns lists across all ac
	NameContains     string             `json:"name_contains,omitempty"`      // Filter to lists whose name contains this string
	Pagination       *PaginationRequest `json:"pagination,omitempty"`
	Context          any                `json:"context,omitempty"`
	Ext              any                `json:"ext,omitempty"`
}

type ListCollectionListsResult struct {
	Lists      []CollectionList
	Pagination *PaginationResponse
}

type ListCreativeFormatsRequest struct {
	AdcpMajorVersion      int                `json:"adcp_major_version,omitempty"`     // The AdCP major version the buyer's payloads conform to. Sellers validate against
	FormatIDs             []FormatRef        `json:"format_ids,omitempty"`             // Return only these specific format IDs (e.g., from get_products response)
	AssetTypes            []string           `json:"asset_types,omitempty"`            // Filter to formats that include these asset types. For third-party tags, search f
	MaxWidth              int                `json:"max_width,omitempty"`              // Maximum width in pixels (inclusive). Returns formats where ANY render has width
	MaxHeight             int                `json:"max_height,omitempty"`             // Maximum height in pixels (inclusive). Returns formats where ANY render has heigh
	MinWidth              int                `json:"min_width,omitempty"`              // Minimum width in pixels (inclusive). Returns formats where ANY render has width
	MinHeight             int                `json:"min_height,omitempty"`             // Minimum height in pixels (inclusive). Returns formats where ANY render has heigh
	IsResponsive          *bool              `json:"is_responsive,omitempty"`          // Filter for responsive formats that adapt to container size. When true, returns f
	NameSearch            string             `json:"name_search,omitempty"`            // Search for formats by name (case-insensitive partial match)
	WcagLevel             string             `json:"wcag_level,omitempty"`             // Filter to formats that meet at least this WCAG conformance level (A < AA < AAA)
	DisclosurePositions   []string           `json:"disclosure_positions,omitempty"`   // Filter to formats that support all of these disclosure positions. When a format
	DisclosurePersistence []string           `json:"disclosure_persistence,omitempty"` // Filter to formats where each requested persistence mode is supported by at least
	OutputFormatIDs       []FormatRef        `json:"output_format_ids,omitempty"`      // Filter to formats whose output_format_ids includes any of these format IDs. Retu
	InputFormatIDs        []FormatRef        `json:"input_format_ids,omitempty"`       // Filter to formats whose input_format_ids includes any of these format IDs. Retur
	Pagination            *PaginationRequest `json:"pagination,omitempty"`
	Context               any                `json:"context,omitempty"`
	Ext                   any                `json:"ext,omitempty"`
}

type ListCreativeFormatsResponse struct {
	Formats        []CreativeFormat    `json:"formats"`                   // Full format definitions for all formats this agent supports. Each format's autho
	CreativeAgents []any               `json:"creative_agents,omitempty"` // Optional: Creative agents that provide additional formats. Buyers can recursivel
	Errors         []AdcpError         `json:"errors,omitempty"`          // Task-specific errors and warnings (e.g., format availability issues)
	Pagination     *PaginationResponse `json:"pagination,omitempty"`
	Sandbox        *bool               `json:"sandbox,omitempty"` // When true, this response contains simulated data from sandbox mode.
	Context        any                 `json:"context,omitempty"`
	Ext            any                 `json:"ext,omitempty"`
}

type ListCreativesRequest struct {
	AdcpMajorVersion   int                `json:"adcp_major_version,omitempty"` // The AdCP major version the buyer's payloads conform to. Sellers validate against
	Filters            *CreativeFilters   `json:"filters,omitempty"`
	Sort               any                `json:"sort,omitempty"` // Sorting parameters
	Pagination         *PaginationRequest `json:"pagination,omitempty"`
	IncludeAssignments *bool              `json:"include_assignments,omitempty"` // Include package assignment information in response
	IncludeSnapshot    *bool              `json:"include_snapshot,omitempty"`    // Include a lightweight delivery snapshot per creative (lifetime impressions and l
	IncludeItems       *bool              `json:"include_items,omitempty"`       // Include items for multi-asset formats like carousels and native ads
	IncludeVariables   *bool              `json:"include_variables,omitempty"`   // Include dynamic content variable definitions (DCO slots) for each creative
	IncludePricing     *bool              `json:"include_pricing,omitempty"`     // Include pricing_options on each creative. Requires account to be provided. When
	Account            *AccountReference  `json:"account,omitempty"`             // Account reference for pricing and access. When provided with include_pricing, th
	Fields             []string           `json:"fields,omitempty"`              // Specific fields to include in response (omit for all fields). The 'concept' valu
	Context            any                `json:"context,omitempty"`
	Ext                any                `json:"ext,omitempty"`
}

type ListScenariosSuccess struct {
	Success   bool     `json:"success"`
	Scenarios []string `json:"scenarios"` // Scenarios this seller has implemented. Runners and sellers MUST accept unknown s
	Context   any      `json:"context,omitempty"`
	Ext       any      `json:"ext,omitempty"`
}

type LogEventRequest struct {
	AdcpMajorVersion int              `json:"adcp_major_version,omitempty"` // The AdCP major version the buyer's payloads conform to. Sellers validate against
	EventSourceID    string           `json:"event_source_id"`              // Event source configured on the account via sync_event_sources
	TestEventCode    string           `json:"test_event_code,omitempty"`    // Test event code for validation without affecting production data. Events with th
	Events           []map[string]any `json:"events"`                       // Events to log
	IdempotencyKey   string           `json:"idempotency_key"`              // Client-generated unique key for this request. Prevents duplicate event logging o
	Context          any              `json:"context,omitempty"`
	Ext              any              `json:"ext,omitempty"`
}

type LogEventResult struct {
	EventsReceived  int `json:"events_received"`
	EventsProcessed int `json:"events_processed"`
}

type MCPWebhookPayload struct {
	IdempotencyKey string `json:"idempotency_key"`        // Sender-generated key stable across retries of the same webhook event. Publishers
	OperationID    string `json:"operation_id,omitempty"` // Client-generated identifier that was embedded in the webhook URL by the buyer. P
	TaskID         string `json:"task_id"`                // Unique identifier for this task. Use this to correlate webhook notifications wit
	TaskType       string `json:"task_type"`              // Type of AdCP operation that triggered this webhook. Enables webhook handlers to
	Protocol       string `json:"protocol,omitempty"`     // AdCP protocol this task belongs to. Helps classify the operation type at a high
	Status         string `json:"status"`                 // Current task status. Webhooks are triggered for status changes after initial sub
	Timestamp      string `json:"timestamp"`              // ISO 8601 timestamp when this webhook was generated.
	Message        string `json:"message,omitempty"`      // Human-readable summary of the current task state. Provides context about what ha
	ContextID      string `json:"context_id,omitempty"`   // Session/conversation identifier. Use this to continue the conversation if input-
	Result         any    `json:"result,omitempty"`       // Task-specific payload matching the status. For completed/failed, contains the fu
}

type MakegoodPolicy struct {
	AvailableRemedies []string `json:"available_remedies"`
}

type MakegoodRemedy = string

type MarkdownFlavor = string

type MatchIDType = string

type MatchingLatencyRange struct {
	Min *int `json:"min,omitempty"`
	Max *int `json:"max,omitempty"`
}

type MeasurementTerms struct {
	BillingMeasurement *BillingMeasurement `json:"billing_measurement,omitempty"`
	MakegoodPolicy     *MakegoodPolicy     `json:"makegood_policy,omitempty"`
}

type MeasurementWindow struct {
	WindowID                 string `json:"window_id"`
	Description              string `json:"description,omitempty"`
	DurationDays             int    `json:"duration_days"`
	ExpectedAvailabilityDays int    `json:"expected_availability_days,omitempty"`
	IsGuaranteeBasis         bool   `json:"is_guarantee_basis,omitempty"`
}

type MediaBuyCapabilities struct {
	SupportedPricingModels   []string                `json:"supported_pricing_models,omitempty"`
	ReportingDeliveryMethods []string                `json:"reporting_delivery_methods,omitempty"`
	OfflineDeliveryProtocols []string                `json:"offline_delivery_protocols,omitempty"`
	Features                 map[string]any          `json:"features,omitempty"`
	Execution                *MediaBuyExecution      `json:"execution,omitempty"`
	AudienceTargeting        *AudienceTargetingCaps  `json:"audience_targeting,omitempty"`
	ConversionTracking       *ConversionTrackingCaps `json:"conversion_tracking,omitempty"`
	ContentStandards         *ContentStandardsCaps   `json:"content_standards,omitempty"`
	Portfolio                *PortfolioCaps          `json:"portfolio,omitempty"`
}

type MediaBuyData struct {
	MediaBuyID       string    `json:"media_buy_id"`      // Seller's unique identifier for the media buy
	Account          *Account  `json:"account,omitempty"` // Account billed for this media buy
	Status           string    `json:"status"`
	RejectionReason  string    `json:"rejection_reason,omitempty"`  // Reason provided by the seller when status is 'rejected'. Present only when statu
	ConfirmedAt      string    `json:"confirmed_at,omitempty"`      // ISO 8601 timestamp when the seller confirmed this media buy. A successful create
	Cancellation     any       `json:"cancellation,omitempty"`      // Cancellation metadata. Present only when status is 'canceled'.
	TotalBudget      float64   `json:"total_budget"`                // Total budget amount
	Packages         []Package `json:"packages"`                    // Array of packages within this media buy
	InvoiceRecipient any       `json:"invoice_recipient,omitempty"` // Per-buy override for who receives the invoice. When provided, the seller invoice
	CreativeDeadline string    `json:"creative_deadline,omitempty"` // ISO 8601 timestamp for creative upload deadline
	Revision         int       `json:"revision,omitempty"`          // Monotonically increasing revision number. Incremented on every state change or u
	CreatedAt        string    `json:"created_at,omitempty"`        // Creation timestamp
	UpdatedAt        string    `json:"updated_at,omitempty"`        // Last update timestamp
	Ext              any       `json:"ext,omitempty"`
}

type MediaBuyDelivery struct {
	MediaBuyID string            `json:"media_buy_id"`
	Status     string            `json:"status"`
	Totals     DeliveryTotals    `json:"totals"`
	ByPackage  []PackageDelivery `json:"by_package"`
}

type MediaBuyExecution struct {
	TrustedMatch  *TrustedMatchCaps  `json:"trusted_match,omitempty"`
	CreativeSpecs *CreativeSpecsCaps `json:"creative_specs,omitempty"`
	Targeting     *TargetingCaps     `json:"targeting,omitempty"`
}

type MediaBuyListItem struct {
	MediaBuyID string    `json:"media_buy_id"`
	Status     string    `json:"status"`
	Currency   string    `json:"currency"`
	Packages   []Package `json:"packages"`
}

type MediaBuyStatus = string

type MetricType = string

type MetroSystem = string

type NotificationType = string

type OutcomeType = string

type Pacing = string

type Package struct {
	PackageID            string                `json:"package_id"`           // Seller's unique identifier for the package
	ProductID            string                `json:"product_id,omitempty"` // ID of the product this package is based on
	Budget               float64               `json:"budget,omitempty"`     // Budget allocation for this package in the currency specified by the pricing opti
	Pacing               string                `json:"pacing,omitempty"`
	PricingOptionID      string                `json:"pricing_option_id,omitempty"` // ID of the selected pricing option from the product's pricing_options array
	BidPrice             float64               `json:"bid_price,omitempty"`         // Bid price for auction-based pricing. This is the exact bid/price to honor unless
	PriceBreakdown       any                   `json:"price_breakdown,omitempty"`   // Breakdown of the effective price for this package. On fixed-price packages, echo
	Impressions          float64               `json:"impressions,omitempty"`       // Impression goal for this package
	Catalogs             []Catalog             `json:"catalogs,omitempty"`          // Catalogs this package promotes. Each catalog MUST have a distinct type (e.g., on
	FormatIDs            []FormatRef           `json:"format_ids,omitempty"`        // Format IDs active for this package. Echoed from the create_media_buy request; om
	TargetingOverlay     *Targeting            `json:"targeting_overlay,omitempty"`
	MeasurementTerms     *MeasurementTerms     `json:"measurement_terms,omitempty"`      // Agreed billing measurement and makegood terms for this package. Reflects what wa
	PerformanceStandards []PerformanceStandard `json:"performance_standards,omitempty"`  // Agreed performance standards for this package. When any entry specifies a vendor
	CreativeAssignments  []any                 `json:"creative_assignments,omitempty"`   // Creative assets assigned to this package
	FormatIDsToProvide   []FormatRef           `json:"format_ids_to_provide,omitempty"`  // Format IDs that creative assets will be provided for this package
	OptimizationGoals    []any                 `json:"optimization_goals,omitempty"`     // Optimization targets for this package. The seller optimizes delivery toward thes
	StartTime            string                `json:"start_time,omitempty"`             // Flight start date/time for this package in ISO 8601 format. When omitted, the pa
	EndTime              string                `json:"end_time,omitempty"`               // Flight end date/time for this package in ISO 8601 format. When omitted, the pack
	Paused               *bool                 `json:"paused,omitempty"`                 // Whether this package is paused by the buyer. Paused packages do not deliver impr
	Canceled             *bool                 `json:"canceled,omitempty"`               // Whether this package has been canceled. Canceled packages stop delivery and cann
	Cancellation         any                   `json:"cancellation,omitempty"`           // Cancellation metadata. Present only when canceled is true.
	AgencyEstimateNumber string                `json:"agency_estimate_number,omitempty"` // Agency estimate or authorization number for this package. Echoed from the buyer'
	CreativeDeadline     string                `json:"creative_deadline,omitempty"`      // ISO 8601 timestamp for creative upload or change deadline for this package. Afte
	Context              any                   `json:"context,omitempty"`
	Ext                  any                   `json:"ext,omitempty"`
}

type PackageDelivery struct {
	PackageID string         `json:"package_id"`
	Totals    DeliveryTotals `json:"totals"`
}

type PackageInput struct {
	ProductID       string  `json:"product_id"`
	PricingOptionID string  `json:"pricing_option_id,omitempty"`
	Budget          float64 `json:"budget"`
	BidPrice        float64 `json:"bid_price,omitempty"`

	// Business terms (buyer proposals, override product defaults)
	MeasurementTerms     *MeasurementTerms     `json:"measurement_terms,omitempty"`
	PerformanceStandards []PerformanceStandard `json:"performance_standards,omitempty"`

	// Broadcast / scheduling
	AgencyEstimateNumber string `json:"agency_estimate_number,omitempty"`
	StartTime            string `json:"start_time,omitempty"`
	EndTime              string `json:"end_time,omitempty"`
}

type PaginationRequest struct {
	MaxResults int    `json:"max_results,omitempty"` // Maximum number of items to return per page
	Cursor     string `json:"cursor,omitempty"`      // Opaque cursor from a previous response to fetch the next page
}

type PaginationResponse struct {
	HasMore    bool   `json:"has_more"`              // Whether more results are available beyond this page
	Cursor     string `json:"cursor,omitempty"`      // Opaque cursor to pass in the next request to fetch the next page. Only present w
	TotalCount int    `json:"total_count,omitempty"` // Total number of items matching the query across all pages. Optional because not
}

type PerformanceFeedback struct {
	FeedbackID        string  `json:"feedback_id"`           // Unique identifier for this performance feedback submission
	MediaBuyID        string  `json:"media_buy_id"`          // Publisher's media buy identifier
	PackageID         string  `json:"package_id,omitempty"`  // Specific package within the media buy (if feedback is package-specific)
	CreativeID        string  `json:"creative_id,omitempty"` // Specific creative asset (if feedback is creative-specific)
	MeasurementPeriod any     `json:"measurement_period"`    // Time period for performance measurement
	PerformanceIndex  float64 `json:"performance_index"`     // Normalized performance score (0.0 = no value, 1.0 = expected, >1.0 = above expec
	MetricType        string  `json:"metric_type"`           // The business metric being measured
	FeedbackSource    string  `json:"feedback_source"`       // Source of the performance data
	Status            string  `json:"status"`                // Processing status of the performance feedback
	SubmittedAt       string  `json:"submitted_at"`          // ISO 8601 timestamp when feedback was submitted
	AppliedAt         string  `json:"applied_at,omitempty"`  // ISO 8601 timestamp when feedback was applied to optimization algorithms
}

type PerformanceStandard struct {
	Metric    string          `json:"metric"`
	Threshold float64         `json:"threshold"`
	Standard  string          `json:"standard,omitempty"`
	Vendor    *BrandReference `json:"vendor"`
}

type PerformanceStandardMetric = string

type Plan struct {
	PlanID                     string                `json:"plan_id"`
	Brand                      *BrandReference       `json:"brand"`
	Objectives                 string                `json:"objectives"`
	Budget                     PlanBudget            `json:"budget"`
	Channels                   *PlanChannels         `json:"channels,omitempty"`
	Flight                     PlanFlight            `json:"flight"`
	Countries                  []string              `json:"countries,omitempty"`
	Regions                    []string              `json:"regions,omitempty"`
	PolicyIDs                  []string              `json:"policy_ids,omitempty"`
	PolicyCategories           []string              `json:"policy_categories,omitempty"`
	Audience                   *AudienceConstraints  `json:"audience,omitempty"`
	RestrictedAttributes       []RestrictedAttribute `json:"restricted_attributes,omitempty"`
	RestrictedAttributesCustom []string              `json:"restricted_attributes_custom,omitempty"`
	MinAudienceSize            int                   `json:"min_audience_size,omitempty"`
	HumanReviewRequired        bool                  `json:"human_review_required,omitempty"`
	HumanOverride              *HumanOverride        `json:"human_override,omitempty"`
	CustomPolicies             []PolicyEntry         `json:"custom_policies,omitempty"`
	ApprovedSellers            []string              `json:"approved_sellers,omitempty"`
	Delegations                []PlanDelegation      `json:"delegations,omitempty"`
	Portfolio                  *PlanPortfolio        `json:"portfolio,omitempty"`
	Ext                        map[string]any        `json:"ext,omitempty"`
}

type PlanBudget struct {
	Total                 float64                         `json:"total"`
	Currency              string                          `json:"currency"`
	PerSellerMaxPct       float64                         `json:"per_seller_max_pct,omitempty"`
	ReallocationThreshold *float64                        `json:"reallocation_threshold,omitempty"`
	ReallocationUnlimited bool                            `json:"reallocation_unlimited,omitempty"`
	Allocations           map[string]PlanBudgetAllocation `json:"allocations,omitempty"`
}

type PlanBudgetAllocation struct {
	Amount float64 `json:"amount,omitempty"`
	MaxPct float64 `json:"max_pct,omitempty"`
}

type PlanChannelMixTarget struct {
	MinPct float64 `json:"min_pct,omitempty"`
	MaxPct float64 `json:"max_pct,omitempty"`
}

type PlanChannels struct {
	Required   []string                        `json:"required,omitempty"`
	Allowed    []string                        `json:"allowed,omitempty"`
	MixTargets map[string]PlanChannelMixTarget `json:"mix_targets,omitempty"`
}

type PlanDelegation struct {
	AgentURL    string                `json:"agent_url"`
	Authority   string                `json:"authority"`
	BudgetLimit *PlanDelegationBudget `json:"budget_limit,omitempty"`
	Markets     []string              `json:"markets,omitempty"`
	ExpiresAt   string                `json:"expires_at,omitempty"`
}

type PlanDelegationBudget struct {
	Amount   float64 `json:"amount"`
	Currency string  `json:"currency"`
}

type PlanFlight struct {
	Start string `json:"start"`
	End   string `json:"end"`
}

type PlanPortfolio struct {
	MemberPlanIDs    []string                `json:"member_plan_ids"`
	TotalBudgetCap   *PlanPortfolioBudgetCap `json:"total_budget_cap,omitempty"`
	SharedPolicyIDs  []string                `json:"shared_policy_ids,omitempty"`
	SharedExclusions []PolicyEntry           `json:"shared_exclusions,omitempty"`
}

type PlanPortfolioBudgetCap struct {
	Amount   float64 `json:"amount"`
	Currency string  `json:"currency"`
}

type PlanValidationError struct {
	Field   string
	Code    string
	Message string
}

type PolicyCategory = string

type PolicyCategoryDefinition struct {
	CategoryID           string   `json:"category_id"`                     // Unique identifier for this category. Used in plan.policy_categories, signal-defi
	Name                 string   `json:"name"`                            // Human-readable name (e.g., 'Children-Directed Content').
	Description          string   `json:"description"`                     // What this category covers. Defines the boundary — what campaigns or data fall un
	RegulatoryFrameworks []any    `json:"regulatory_frameworks,omitempty"` // Key regulations and standards grouped under this category. Governance agents use
	RestrictedAttributes []string `json:"restricted_attributes,omitempty"` // Restricted attribute categories that regulations in this category prohibit for t
	RequiresHumanReview  *bool    `json:"requires_human_review,omitempty"` // When true, any plan declaring this category MUST set plan.human_review_required
	Industries           []string `json:"industries,omitempty"`            // Industries where this category commonly applies (e.g., 'pharmaceutical' for age_
	Guidance             string   `json:"guidance,omitempty"`              // Implementation notes for governance agents. Edge cases, disambiguation, and comm
	RelatedCategories    []string `json:"related_categories,omitempty"`    // Categories that frequently co-occur (e.g., 'children_directed' often appears wit
}

type PolicyEnforcement = string

type PolicyEntry struct {
	PolicyID            string              `json:"policy_id"`                       // Unique identifier for this policy. Registry-published ids are canonical (e.g., "
	Source              string              `json:"source,omitempty"`                // Origin of this policy. 'registry' = published to the shared AdCP policy registry
	Version             string              `json:"version,omitempty"`               // Semver version string (e.g., "1.0.0"). Incremented when policy content changes.
	Name                string              `json:"name,omitempty"`                  // Human-readable name (e.g., "UK HFSS Restrictions"). Optional for inline bespoke
	Description         string              `json:"description,omitempty"`           // Brief summary of what this policy covers.
	Category            string              `json:"category,omitempty"`              // The nature of the obligation: regulation (legal requirement) or standard (best p
	Enforcement         string              `json:"enforcement"`                     // How governance agents treat violations. Regulations are typically "must"; standa
	RequiresHumanReview *bool               `json:"requires_human_review,omitempty"` // When true, plans subject to this policy MUST set plan.human_review_required = tr
	Jurisdictions       []string            `json:"jurisdictions,omitempty"`         // ISO 3166-1 alpha-2 country codes where this policy applies. Empty array means th
	RegionAliases       map[string][]string `json:"region_aliases,omitempty"`        // Named groups of jurisdictions for convenience (e.g., {"EU": ["AT","BE","BG",...]
	PolicyCategories    []string            `json:"policy_categories,omitempty"`     // Regulatory categories this policy belongs to (e.g., ["children_directed", "age_r
	Channels            []string            `json:"channels,omitempty"`              // Advertising channels this policy applies to. If omitted or null, the policy appl
	GovernanceDomains   []string            `json:"governance_domains,omitempty"`    // Governance sub-domains this policy applies to. Determines which types of governa
	EffectiveDate       string              `json:"effective_date,omitempty"`        // ISO 8601 date when the regulation or standard takes effect. Before this date, go
	SunsetDate          string              `json:"sunset_date,omitempty"`           // ISO 8601 date when the regulation or standard is no longer enforced. After this
	SourceURL           string              `json:"source_url,omitempty"`            // Link to the source regulation, standard, or legislation.
	SourceName          string              `json:"source_name,omitempty"`           // Name of the issuing body (e.g., "UK Food Standards Agency", "US Federal Trade Co
	Policy              string              `json:"policy"`                          // Natural language policy text describing what is required, prohibited, or recomme
	Guidance            string              `json:"guidance,omitempty"`              // Implementation notes for governance agent developers. Not used in evaluation pro
	Exemplars           any                 `json:"exemplars,omitempty"`             // Calibration examples for governance agents, following the Content Standards patt
	Ext                 any                 `json:"ext,omitempty"`
}

type PortfolioCaps struct {
	PublisherDomains    []string `json:"publisher_domains"`
	PrimaryChannels     []string `json:"primary_channels,omitempty"`
	PrimaryCountries    []string `json:"primary_countries,omitempty"`
	Description         string   `json:"description,omitempty"`
	AdvertisingPolicies string   `json:"advertising_policies,omitempty"`
}

type PostalSystem = string

type Preview struct {
	PreviewID string          `json:"preview_id"`
	Input     map[string]any  `json:"input"`
	Renders   []PreviewRender `json:"renders"`
}

type PreviewCreativeRequest struct {
	AdcpMajorVersion int               `json:"adcp_major_version,omitempty"` // The AdCP major version the buyer's payloads conform to. Sellers validate against
	RequestType      string            `json:"request_type"`                 // Preview mode. 'single' previews one creative manifest. 'batch' previews multiple
	CreativeManifest *CreativeManifest `json:"creative_manifest,omitempty"`  // Complete creative manifest with all required assets for the format. Required whe
	FormatID         *FormatRef        `json:"format_id,omitempty"`          // Format identifier for rendering the preview. Defaults to creative_manifest.forma
	Inputs           []any             `json:"inputs,omitempty"`             // Array of input sets for generating multiple preview variants. Each input set def
	TemplateID       string            `json:"template_id,omitempty"`        // Specific template ID for custom format rendering. Used in single mode.
	Quality          string            `json:"quality,omitempty"`            // Render quality. 'draft' produces fast, lower-fidelity renderings. 'production' p
	OutputFormat     string            `json:"output_format,omitempty"`      // Output format. 'url' returns preview_url (iframe-embeddable URL), 'html' returns
	ItemLimit        int               `json:"item_limit,omitempty"`         // Maximum number of catalog items to render per preview variant. Used in single mo
	Requests         []any             `json:"requests,omitempty"`           // Array of preview requests (1-50 items). Required when request_type is 'batch'. E
	VariantID        string            `json:"variant_id,omitempty"`         // Platform-assigned variant identifier from get_creative_delivery response. Requir
	CreativeID       string            `json:"creative_id,omitempty"`        // Creative identifier for context. Used in variant mode.
	Context          any               `json:"context,omitempty"`
	Ext              any               `json:"ext,omitempty"`
}

type PreviewOutputFormat = string

type PreviewRender struct {
	RenderID     string  `json:"render_id"`
	OutputFormat string  `json:"output_format"`
	PreviewURL   string  `json:"preview_url,omitempty"`
	HTML         string  `json:"html,omitempty"`
	Role         string  `json:"role"`
	Dimensions   *Render `json:"dimensions,omitempty"`
}

type PreviewResult struct {
	ResponseType string    `json:"response_type"`
	Previews     []Preview `json:"previews"`
	ExpiresAt    string    `json:"expires_at"`
}

type PricingModel = string

type PricingOption struct {
	PricingOptionID     string   `json:"pricing_option_id"`
	PricingModel        string   `json:"pricing_model"`
	Currency            string   `json:"currency"`
	FixedPrice          float64  `json:"fixed_price,omitempty"`
	FloorPrice          float64  `json:"floor_price,omitempty"`
	MinSpendPerPackage  float64  `json:"min_spend_per_package,omitempty"`
	MaxBid              *bool    `json:"max_bid,omitempty"`
	PriceGuidance       any      `json:"price_guidance,omitempty"`
	PriceBreakdown      any      `json:"price_breakdown,omitempty"`
	EventSourceID       string   `json:"event_source_id,omitempty"`
	EventType           string   `json:"event_type,omitempty"`
	CustomEventName     string   `json:"custom_event_name,omitempty"`
	EligibleAdjustments []string `json:"eligible_adjustments,omitempty"`
	Parameters          any      `json:"parameters,omitempty"`
}

type Product struct {
	ProductID                  string                      `json:"product_id"`           // Unique identifier for the product
	Name                       string                      `json:"name"`                 // Human-readable product name
	Description                string                      `json:"description"`          // Detailed description of the product and its inventory
	PublisherProperties        []PublisherPropertySelector `json:"publisher_properties"` // Publisher properties covered by this product. Buyers fetch actual property defin
	Channels                   []string                    `json:"channels,omitempty"`   // Advertising channels this product is sold as. Products inherit from their proper
	FormatIDs                  []FormatRef                 `json:"format_ids"`           // Array of supported creative format IDs - structured format_id objects with agent
	Placements                 []any                       `json:"placements,omitempty"` // Optional array of specific placements within this product. When provided, buyers
	DeliveryType               string                      `json:"delivery_type"`
	Exclusivity                string                      `json:"exclusivity,omitempty"` // Whether this product offers exclusive access to its inventory. Defaults to 'none
	PricingOptions             []PricingOption             `json:"pricing_options"`       // Available pricing models for this product
	Forecast                   any                         `json:"forecast,omitempty"`    // Forecasted delivery metrics for this product. Gives buyers an estimate of expect
	OutcomeMeasurement         any                         `json:"outcome_measurement,omitempty"`
	DeliveryMeasurement        any                         `json:"delivery_measurement,omitempty"`  // Measurement provider and methodology for delivery metrics. The buyer accepts the
	MeasurementTerms           *MeasurementTerms           `json:"measurement_terms,omitempty"`     // Seller's default billing measurement and makegood terms. Declares who counts the
	PerformanceStandards       []PerformanceStandard       `json:"performance_standards,omitempty"` // Seller's default performance standards for this product: viewability, IVT, compl
	CancellationPolicy         *CancellationPolicy         `json:"cancellation_policy,omitempty"`   // Cancellation terms for this product. Declares the minimum notice period required
	ReportingCapabilities      any                         `json:"reporting_capabilities"`
	CreativePolicy             any                         `json:"creative_policy,omitempty"`
	IsCustom                   *bool                       `json:"is_custom,omitempty"`                    // Whether this is a custom product
	PropertyTargetingAllowed   *bool                       `json:"property_targeting_allowed,omitempty"`   // Whether buyers can filter this product to a subset of its publisher_properties.
	DataProviderSignals        []any                       `json:"data_provider_signals,omitempty"`        // Data provider signals available for this product. Buyers fetch signal definition
	SignalTargetingAllowed     *bool                       `json:"signal_targeting_allowed,omitempty"`     // Whether buyers can filter this product to a subset of its data_provider_signals.
	CatalogTypes               []string                    `json:"catalog_types,omitempty"`                // Catalog types this product supports for catalog-driven campaigns. A sponsored pr
	MetricOptimization         any                         `json:"metric_optimization,omitempty"`          // Metric optimization capabilities for this product. Presence indicates the produc
	MaxOptimizationGoals       int                         `json:"max_optimization_goals,omitempty"`       // Maximum number of optimization_goals this product accepts on a package. When abs
	MeasurementReadiness       any                         `json:"measurement_readiness,omitempty"`        // Assessment of whether the buyer's event source setup is sufficient for this prod
	ConversionTracking         any                         `json:"conversion_tracking,omitempty"`          // Conversion event tracking for this product. Presence indicates the product suppo
	CatalogMatch               any                         `json:"catalog_match,omitempty"`                // When the buyer provides a catalog on get_products, indicates which catalog items
	BriefRelevance             string                      `json:"brief_relevance,omitempty"`              // Explanation of why this product matches the brief (only included when brief is p
	ExpiresAt                  string                      `json:"expires_at,omitempty"`                   // Expiration timestamp. After this time, the product may no longer be available fo
	ProductCard                any                         `json:"product_card,omitempty"`                 // Optional standard visual card (300x400px) for displaying this product in user in
	ProductCardDetailed        any                         `json:"product_card_detailed,omitempty"`        // Optional detailed card with carousel and full specifications. Provides rich prod
	Collections                []any                       `json:"collections,omitempty"`                  // Collections available in this product. Each entry references collections declare
	CollectionTargetingAllowed *bool                       `json:"collection_targeting_allowed,omitempty"` // Whether buyers can target a subset of this product's collections. When false (de
	Installments               []any                       `json:"installments,omitempty"`                 // Specific installments included in this product. Each installment references its
	EnforcedPolicies           []string                    `json:"enforced_policies,omitempty"`            // Registry policy IDs the seller enforces for this product. Enforcement level come
	TrustedMatch               any                         `json:"trusted_match,omitempty"`                // Trusted Match Protocol capabilities for this product. When present, the product
	MaterialSubmission         any                         `json:"material_submission,omitempty"`          // Instructions for submitting physical creative materials (print, static OOH, cine
	Ext                        any                         `json:"ext,omitempty"`
}

type ProductionQuality = string

type ProductsData struct {
	Products []Product `json:"products"`
	Sandbox  bool      `json:"sandbox,omitempty"`
}

type PropertyListChangedWebhook struct {
	IdempotencyKey  string `json:"idempotency_key"`             // Sender-generated key stable across retries of the same webhook event. Governance
	Event           string `json:"event"`                       // The event type
	ListID          string `json:"list_id"`                     // ID of the property list that changed
	ListName        string `json:"list_name,omitempty"`         // Name of the property list
	ChangeSummary   any    `json:"change_summary,omitempty"`    // Summary of changes to the resolved list
	ResolvedAt      string `json:"resolved_at"`                 // When the list was re-resolved
	CacheValidUntil string `json:"cache_valid_until,omitempty"` // When the consumer should refresh from the governance agent
	Signature       string `json:"signature"`                   // Cryptographic signature of the webhook payload, signed with the agent's private
	Ext             any    `json:"ext,omitempty"`
}

type PropertyType = string

type ProposalStatus = string