Class SingleAgentClient

new SingleAgentClient(
    agent: AgentConfig,
    config?: SingleAgentClientConfig,
): SingleAgentClient

getAdcpVersion(): string

handleWebhook(
    payload: MCPWebhookPayload | Task | TaskStatusUpdateEvent,
    taskType: string,
    operationId: string,
    signature?: WebhookHeaderValue,
    timestamp?: WebhookHeaderValue,
    rawBody?: string | Uint8Array<ArrayBufferLike> | Buffer<ArrayBufferLike>,
): Promise<boolean>

import { verifyWebhookRequest } from '@adcp/sdk/webhooks';

app.post('/webhook/:taskType', async (req, res) => {
  try {
    const check = verifyWebhookRequest({
      rawBody: req.rawBody,
      headers: req.headers,
      globalSecret: process.env.WEBHOOK_SECRET,
    });
    if (!check.ok) return res.status(401).json({ error: check.reason });

    const handled = await client.handleWebhook(
      req.body,
      req.params.taskType,
      req.params.operationId,
      check.signature,
      check.timestamp,
      req.rawBody
    );
    res.status(200).json({ received: handled });
  } catch (error) {
    res.status(401).json({ error: error.message });
  }
});
Copy

verifyAndParseWebhook(
    options: VerifyAndParseWebhookOptions,
): Promise<WebhookParseResult>

getWebhookUrl(taskType: string, operationId: string): string

// With template: "https://myapp.com/webhook/{task_type}/{agent_id}/{operation_id}"
const webhookUrl = client.getWebhookUrl('sync_creatives', 'op_123');
// Returns: https://myapp.com/webhook/sync_creatives/agent_x/op_123

// With template: "https://myapp.com/webhook?agent={agent_id}&op={operation_id}"
const webhookUrl = client.getWebhookUrl('sync_creatives', 'op_123');
// Returns: https://myapp.com/webhook?agent=agent_x&op=op_123
Copy

createWebhookHandler(
    adapter?: WebhookHandlerAdapter,
): (
    req: WebhookHandlerRequest,
    res: {
        status: (code: number) => { json: (body: unknown) => void };
        json?: unknown;
        writeHead: (code: number, headers: Record<string, string>) => void;
        end: (body: string) => void;
    },
) => Promise<void>

const client = new SingleAgentClient(agent, {
  webhookUrlTemplate: 'https://buyer.example/webhook/{task_type}/{operation_id}',
  handlers: {
    onSyncCreativesStatusChange: async (result) => {
      console.log('Creative synced:', result);
    }
  }
});

app.post(
  '/webhook/:task_type/:operation_id',
  express.raw({ type: 'application/json' }),
  client.createWebhookHandler({
    getRequestUrl: req => `https://buyer.example${req.originalUrl}`,
  }),
);
Copy

verifyWebhookSignature(
    rawBodyOrPayload: unknown,
    signature: WebhookHeaderValue,
    timestamp: WebhookHeaderValue,
): boolean

getProducts(
    params: CanonicalGetProductsRequest,
    inputHandler?: InputHandler,
    options?: CanonicalReadTaskOptions,
): Promise<TaskResult<CanonicalGetProductsResponse>>

const products = await client.getProducts(
  {
    buying_mode: 'brief',
    brief: 'Find podcast and streaming audio placements for an eco-friendly bike subscription launch'
  },
  (context) => {
    if (context.inputRequest.field === 'budget') return 50000;
    return context.deferToHuman();
  }
);
Copy

getProductsLegacy(
    params: LegacyGetProductsRequest,
    inputHandler?: InputHandler,
    options?: TaskOptions,
): Promise<TaskResult<LegacyGetProductsResponse>>

listCreativeFormatsLegacy(
    params: LegacyListCreativeFormatsRequest,
    inputHandler?: InputHandler,
    options?: TaskOptions,
): Promise<TaskResult<LegacyListCreativeFormatsResponse>>

listTransformersLegacy(
    params: ListTransformersRequestCreativeAgent,
    inputHandler?: InputHandler,
    options?: TaskOptions,
): Promise<TaskResult<ListTransformersResponseCreativeAgent>>

createMediaBuy(
    params: MutatingRequestInput<CanonicalCreateMediaBuyRequest>,
    inputHandler?: InputHandler,
    options?: CreativeDeliveryTaskOptions,
): Promise<
    TaskResult<CanonicalCreativeResponse<LegacyCreateMediaBuyResponse>>,
>

createMediaBuyLegacy(
    params: MutatingRequestInput<LegacyCreateMediaBuyRequest>,
    inputHandler?: InputHandler,
    options?: CreativeDeliveryTaskOptions,
): Promise<TaskResult<LegacyCreateMediaBuyResponse>>

updateMediaBuy(
    params: MutatingRequestInput<CanonicalUpdateMediaBuyRequest>,
    inputHandler?: InputHandler,
    options?: CreativeDeliveryTaskOptions,
): Promise<
    TaskResult<CanonicalCreativeResponse<LegacyUpdateMediaBuyResponse>>,
>

updateMediaBuyLegacy(
    params: MutatingRequestInput<LegacyUpdateMediaBuyRequest>,
    inputHandler?: InputHandler,
    options?: CreativeDeliveryTaskOptions,
): Promise<TaskResult<LegacyUpdateMediaBuyResponse>>

syncCreatives(
    params: MutatingRequestInput<CanonicalSyncCreativesRequest>,
    inputHandler?: InputHandler,
    options?: SyncCreativesTaskOptions,
): Promise<
    TaskResult<CanonicalCreativeResponse<LegacySyncCreativesResponse>>,
>

syncCreativesLegacy(
    params: MutatingRequestInput<LegacySyncCreativesRequest>,
    inputHandler?: InputHandler,
    options?: SyncCreativesTaskOptions,
): Promise<TaskResult<LegacySyncCreativesResponse>>

listCreatives(
    params: CanonicalListCreativesRequest,
    inputHandler?: InputHandler,
    options?: CanonicalReadTaskOptions,
): Promise<TaskResult<CanonicalListCreativesResponse>>

listCreativesLegacy(
    params: LegacyListCreativesRequest,
    inputHandler?: InputHandler,
    options?: TaskOptions,
): Promise<TaskResult<LegacyListCreativesResponse>>

previewCreative(
    params: CanonicalPreviewCreativeRequest,
    inputHandler?: InputHandler,
    options?: TaskOptions,
): Promise<TaskResult<CanonicalPreviewCreativeResponse>>

previewCreativeLegacy(
    params: {
        adcp_version?: string;
        adcp_major_version?: number;
        request_type: "single" | "batch" | "variant";
        creative_manifest?: LegacyCreativeManifest;
        target_capability_id?: string;
        format_id?: LegacyFormatReferenceStructuredObject;
        inputs?: {
            name: string;
            macros?: { [k: string]: string | undefined };
            context_description?: string;
        }[];
        template_id?: string;
        quality?: CreativeQuality;
        output_format?: PreviewOutputFormat;
        item_limit?: number;
        requests?: {
            target_capability_id?: string;
            format_id?: LegacyFormatReferenceStructuredObject;
            creative_manifest?: LegacyCreativeManifest;
            creative_id?: string;
            inputs?: {
                name: string;
                macros?: { [k: string]: string
                | undefined };
                context_description?: string;
            }[];
            template_id?: string;
            quality?: CreativeQuality;
            output_format?: PreviewOutputFormat;
            item_limit?: number;
        }[];
        variant_id?: string;
        creative_id?: string;
        allow_async?: boolean;
        push_notification_config?: PushNotificationConfig;
        context?: ContextObject;
        ext?: ExtensionObject;
    },
    inputHandler?: InputHandler,
    options?: TaskOptions,
): Promise<TaskResult<LegacyPreviewCreativeResponse>>

getMediaBuys(
    params: GetMediaBuysRequest,
    inputHandler?: InputHandler,
    options?: CanonicalReadTaskOptions,
): Promise<
    TaskResult<
        {
            context_id?: string;
            context?: {};
            task_id?: string;
            status: TaskStatus;
            message?: string;
            timestamp?: string;
            replayed?: boolean;
            adcp_error?: {
                code: string;
                message: string;
                field?: string;
                suggestion?: string;
                retry_after?: number;
                issues?: {
                    pointer: string;
                    message: string;
                    keyword: string;
                    schemaPath?: string;
                    schema_id?: string;
                    discriminator?: { property_name: ...; value: ... }[];
                }[];
                details?: {};
                recovery?: "transient"
                | "correctable"
                | "terminal";
                source?: "producer" | "sdk";
                sdk_id?: string;
            };
            push_notification_config?: {
                url: string;
                operation_id?: string;
                token?: string;
                authentication?: {
                    schemes: [AuthenticationScheme];
                    credentials: string;
                };
            };
            governance_context?: string;
            payload?: {};
            adcp_version?: string;
            adcp_major_version?: number;
            media_buys: {
                media_buy_id: string;
                name?: string;
                accepted_proposal_id?: string;
                accepted_proposal_terms_digest?: string;
                accepted_proposal?: {
                    proposal_id: string;
                    proposal_kind: | "new_media_buy"
                    | "media_buy_update"
                    | "media_buy_cancellation";
                    parent_proposal_id?: string;
                    media_buy_id: string;
                    opportunity_id?: string;
                    base_media_buy_revision?: number;
                    proposal_status: "accepted";
                    accepted_at?: string;
                    expires_at?: string;
                    name: string;
                    description?: string;
                    brief_alignment?: string;
                    commercial_terms: {
                        source_feed_version?: string;
                        source_pricing_version?: string;
                        brand: {
                            domain: string;
                            brand_id?: string;
                            countries?: [(...), ...(...)[]];
                        };
                        advertiser_industry?: AdvertiserIndustry;
                        purchases: [
                            {
                                product_id: string;
                                pricing_option_id: string;
                                pricing?: (...)
                                | (...);
                                format_option_refs?: (...) | (...);
                                catalog_ids?: (...) | (...);
                                budget?: (...) | (...);
                                daily_budget_cap?: (...) | (...);
                                min_spend_target?: (...) | (...);
                                impressions?: (...) | (...);
                                start_time?: (...) | (...);
                                end_time?: (...) | (...);
                                pacing?: (...) | (...);
                                bidding?: (...) | (...);
                                targeting_overlay?: (...) | (...);
                                optimization_goals?: (...) | (...);
                                audience_evidence_requirements?: (...) | (...);
                                audience_evidence_pins?: (...) | (...);
                                agency_estimate_number?: (...) | (...);
                                context?: (...) | (...);
                                ext?: (...) | (...);
                                measurement_terms?: (...) | (...);
                                performance_standards?: (...) | (...);
                            },
                            ...{
                                product_id: string;
                                pricing_option_id: string;
                                pricing?: (...)
                                | (...);
                                format_option_refs?: (...) | (...);
                                catalog_ids?: (...) | (...);
                                budget?: (...) | (...);
                                daily_budget_cap?: (...) | (...);
                                min_spend_target?: (...) | (...);
                                impressions?: (...) | (...);
                                start_time?: (...) | (...);
                                end_time?: (...) | (...);
                                pacing?: (...) | (...);
                                bidding?: (...) | (...);
                                targeting_overlay?: (...) | (...);
                                optimization_goals?: (...) | (...);
                                audience_evidence_requirements?: (...) | (...);
                                audience_evidence_pins?: (...) | (...);
                                agency_estimate_number?: (...) | (...);
                                context?: (...) | (...);
                                ext?: (...) | (...);
                                measurement_terms?: (...) | (...);
                                performance_standards?: (...) | (...);
                            }[],
                        ];
                        start_time: string;
                        end_time: string;
                        total_budget?: { amount: number; currency: string };
                        daily_budget_cap?: number;
                        budget_cap_timezone?: string;
                        budget_allocation?:
                            | { mode: "fixed" }
                            | {
                                mode: "seller_optimized";
                                optimization_goals: [(...), ...(...)[]];
                            };
                        pacing?: Pacing;
                        bidding?: {
                            automatic?: (...)
                            | (...);
                            bid_amount?: (...) | (...);
                            max_bid?: (...) | (...);
                            cost_per?: (...) | (...);
                            roas?: (...) | (...);
                        };
                        invoice_recipient?: {
                            legal_name: string;
                            vat_id?: (...)
                            | (...);
                            tax_id?: (...) | (...);
                            registration_number?: (...) | (...);
                            address?: (...) | (...);
                            contacts?: (...) | (...);
                            bank?: (...) | (...);
                            ext?: (...) | (...);
                        };
                        purchase_order_ref?: string;
                        agency_estimate_number?: string;
                        reporting_commitments?: [
                            { purchase_index: ...; metrics: ... },
                            ...{ purchase_index: ...; metrics: ... }[],
                        ];
                        cancellation_terms?: {
                            effective_at: string;
                            fee?: (...) | (...);
                            reason?: (...) | (...);
                        };
                    };
                    terms_digest: string;
                    insertion_order?: {
                        io_id: string;
                        terms?: {
                            advertiser?: ...;
                            publisher?: ...;
                            total_budget?: ...;
                            flight_start?: ...;
                            flight_end?: ...;
                            payment_terms?: ...;
                        };
                        terms_url?: string;
                        signing_url?: string;
                        requires_signature: boolean;
                    };
                };
                account?: {
                    account_id: string;
                    name: string;
                    advertiser?: string;
                    billing_proxy?: string;
                    status: AccountStatus;
                    brand?: {
                        domain: string;
                        brand_id?: string;
                        countries?: (...)[];
                        industries?: (...)[];
                        data_subject_contestation?: {
                            url?: ...;
                            email?: ...;
                            languages?: ...;
                        };
                        brand_kit_override?: {
                            logo?: ...;
                            colors?: ...;
                            voice?: ...;
                            tagline?: ...;
                        };
                    };
                    operator?: string;
                    operator_unit?: { id: string; name?: string };
                    revision?: number;
                    identity_change?:
                        | {
                            status: "pending_approval";
                            requested_operator_identity: {
                                operator: string;
                                operator_unit?: (...)
                                | (...);
                            };
                            requested_at?: string;
                        }
                        | {
                            status: "rejected";
                            requested_operator_identity: {
                                operator: string;
                                operator_unit?: (...)
                                | (...);
                            };
                            requested_at?: string;
                            reason: string;
                        };
                    currency?: string;
                    timezone?: string;
                    billing?: BillingParty;
                    billing_entity?: {
                        legal_name: string;
                        vat_id?: string;
                        tax_id?: string;
                        registration_number?: string;
                        address?: {
                            street: ...;
                            city: ...;
                            postal_code: ...;
                            region?: ...;
                            country: ...;
                        };
                        contacts?: (...)[];
                        bank?: {
                            account_holder: ...;
                            iban?: ...;
                            bic?: ...;
                            routing_number?: ...;
                            account_number?: ...;
                        };
                        ext?: { [key: ...]: ... };
                    };
                    destination_billing_entity?: {};
                    rate_card?: string;
                    payment_terms?: PaymentTerms;
                    credit_limit?: { amount: number; currency: string };
                    setup?: { url?: string; message: string; expires_at?: string };
                    account_scope?: AccountScope;
                    governance_agents?: [{ url: string }];
                    reporting_bucket?: {
                        protocol: CloudStorageProtocol;
                        bucket: string;
                        prefix?: string;
                        region?: string;
                        format?: "jsonl" | "csv" | "parquet" | "avro" | "orc";
                        compression?: "none" | "gzip";
                        file_retention_days: number;
                        setup_instructions?: string;
                    };
                    sandbox?: boolean;
                    notification_configs?: | []
                    | [
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                    ]
                    | [
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                    ]
                    | [
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                    ]
                    | [
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                    ]
                    | [
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                    ]
                    | [
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                    ]
                    | [
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                    ]
                    | [
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                    ]
                    | [
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                    ]
                    | [
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                    ]
                    | [
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                    ]
                    | [
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                    ]
                    | [
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                    ]
                    | [
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                    ]
                    | [
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                    ]
                    | [
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                        {
                            subscriber_id: string;
                            url: string;
                            event_types: [(...), ...(...)[]];
                            product_payload_view?: (...) | (...) | (...);
                            authentication?: (...) | (...);
                            active?: (...) | (...) | (...);
                            ext?: (...) | (...);
                        },
                    ];
                    webhook_activity?: {
                        idempotency_key: string;
                        notification_id?: (...)
                        | (...);
                        subscriber_id?: (...) | (...);
                        fired_at: string;
                        completed_at?: (...) | (...) | (...);
                        notification_type: NotificationType;
                        sequence_number?: (...) | (...);
                        attempt: number;
                        status: (...) | (...) | (...) | (...) | (...);
                        url: string;
                        http_status_code?: (...) | (...) | (...);
                        response_time_ms?: (...) | (...) | (...);
                        payload_size_bytes?: (...) | (...);
                        error_message?: (...) | (...) | (...);
                        ext?: (...) | (...);
                    }[];
                    ext?: { [key: string]: unknown };
                };
                invoice_recipient?: {
                    legal_name: string;
                    vat_id?: string;
                    tax_id?: string;
                    registration_number?: string;
                    address?: {
                        street: string;
                        city: string;
                        postal_code: string;
                        region?: string;
                        country: string;
                    };
                    contacts?: {
                        role: (...)
                        | (...)
                        | (...)
                        | (...);
                        name?: (...) | (...);
                        email?: (...) | (...);
                        phone?: (...) | (...);
                    }[];
                    bank?: {
                        account_holder: string;
                        iban?: string;
                        bic?: string;
                        routing_number?: string;
                        account_number?: string;
                    };
                    ext?: { [key: string]: unknown };
                };
                status: MediaBuyStatus;
                status_as_of?: string
                | null;
                health?: "ok" | "impaired";
                impairments?: {
                    impairment_id: string;
                    resource_type:
                        | "creative"
                        | "property"
                        | "audience"
                        | "catalog_item"
                        | "event_source";
                    resource_id: string;
                    package_ids: [string, ...string[]];
                    transition: { from?: string; to: ImpairmentOfflineState };
                    reason_code: ImpairmentReasonCode;
                    reason?: string;
                    observed_at: string;
                    remediation?: string;
                }[];
                rejection_reason?: string;
                currency: string;
                total_budget?: number;
                daily_budget_cap?: number;
                budget_cap_timezone?: string;
                budget_allocation?: | { mode: "fixed" }
                | {
                    mode: "seller_optimized";
                    optimization_goals: [
                        | {
                            kind: "metric";
                            metric: | (...)
                            | (...)
                            | (...)
                            | (...)
                            | (...)
                            | (...)
                            | (...)
                            | (...)
                            | (...)
                            | (...)
                            | (...);
                            reach_unit?: (...) | (...);
                            target_frequency?: (...) | (...);
                            view_duration_seconds?: (...) | (...);
                            target?: (...) | (...) | (...);
                            priority?: (...) | (...);
                        }
                        | {
                            kind: "event";
                            event_sources: [(...), ...(...)[]];
                            target?: (...) | (...) | (...) | (...);
                            attribution_window?: (...) | (...);
                            priority?: (...) | (...);
                        }
                        | {
                            kind: "vendor_metric";
                            vendor: {
                                domain: ...;
                                brand_id?: ...;
                                countries?: ...;
                                industries?: ...;
                                data_subject_contestation?: ...;
                                brand_kit_override?: ...;
                            };
                            metric_id: string;
                            target?: (...)
                            | (...)
                            | (...);
                            priority?: (...) | (...);
                        },
                        ...(
                            | {
                                kind: "metric";
                                metric: | (...)
                                | (...)
                                | (...)
                                | (...)
                                | (...)
                                | (...)
                                | (...)
                                | (...)
                                | (...)
                                | (...)
                                | (...);
                                reach_unit?: (...) | (...);
                                target_frequency?: (...) | (...);
                                view_duration_seconds?: (...) | (...);
                                target?: (...) | (...) | (...);
                                priority?: (...) | (...);
                            }
                            | {
                                kind: "event";
                                event_sources: [(...), ...(...)[]];
                                target?: (...) | (...) | (...) | (...);
                                attribution_window?: (...) | (...);
                                priority?: (...) | (...);
                            }
                            | {
                                kind: "vendor_metric";
                                vendor: {
                                    domain: ...;
                                    brand_id?: ...;
                                    countries?: ...;
                                    industries?: ...;
                                    data_subject_contestation?: ...;
                                    brand_kit_override?: ...;
                                };
                                metric_id: string;
                                target?: (...)
                                | (...)
                                | (...);
                                priority?: (...) | (...);
                            }
                        )[],
                    ];
                };
                pacing?: Pacing;
                bidding?: {
                    automatic?: true;
                    bid_amount?: number;
                    max_bid?: number;
                    cost_per?: { amount: number; strength: "cap"
                    | "target" };
                    roas?: { value: number; strength: "target" | "floor" };
                };
                start_time?: string;
                end_time?: string;
                creative_deadline?: string;
                confirmed_at?: string
                | null;
                cancellation?: {
                    canceled_at: string;
                    canceled_by: CanceledBy;
                    reason?: string;
                };
                revision?: number;
                created_at?: string;
                updated_at?: string;
                context?: {};
                valid_actions?: MediaBuyValidAction[];
                available_actions?: (
                    | {
                        action: MediaBuyValidAction;
                        mode: MediaBuyActionMode;
                        task?: "sync_creatives"
                        | "control_media_buy"
                        | "refine_proposals";
                        sla?: { response_max?: ...; completion_max?: ... };
                        terms_ref?: string;
                    }
                    | {
                        task: "control_media_buy";
                        action: | "pause"
                        | "resume"
                        | "cancel"
                        | "increase_budget"
                        | "decrease_budget"
                        | "reallocate_budget"
                        | "update_budget_allocation"
                        | "update_targeting"
                        | "update_pacing"
                        | "update_bidding"
                        | "update_frequency_caps"
                        | "update_catalog_assignments"
                        | "update_keywords"
                        | "update_optimization_goals"
                        | "update_impression_goal"
                        | "update_spend_target"
                        | "update_reporting_webhook"
                        | "remove_packages"
                        | "update_name";
                        mode: CanonicalMediaBuyActionMode;
                        sla?: { response_max?: ...; completion_max?: ... };
                        terms_ref?: string;
                    }
                    | {
                        task: "refine_proposals";
                        action: | "cancel"
                        | "extend_flight"
                        | "shorten_flight"
                        | "update_flight_dates"
                        | "increase_budget"
                        | "decrease_budget"
                        | "reallocate_budget"
                        | "update_budget_allocation"
                        | "update_targeting"
                        | "update_pacing"
                        | "update_bidding"
                        | "update_frequency_caps"
                        | "add_packages"
                        | "remove_packages";
                        mode: CanonicalMediaBuyActionMode;
                        sla?: { response_max?: ...; completion_max?: ... };
                        terms_ref?: string;
                    }
                    | {
                        task: "sync_creatives";
                        action: | "replace_creative"
                        | "update_creative_assignments"
                        | "remove_creative";
                        mode: CanonicalMediaBuyActionMode;
                        sla?: { response_max?: ...; completion_max?: ... };
                        terms_ref?: string;
                    }
                )[];
                webhook_activity?: {
                    idempotency_key: string;
                    notification_id?: string;
                    subscriber_id?: string;
                    fired_at: string;
                    completed_at?: string
                    | null;
                    notification_type: NotificationType;
                    sequence_number?: number;
                    attempt: number;
                    status:
                        | "failed"
                        | "pending"
                        | "success"
                        | "timeout"
                        | "connection_error";
                    url: string;
                    http_status_code?: number
                    | null;
                    response_time_ms?: number | null;
                    payload_size_bytes?: number;
                    error_message?: string | null;
                    ext?: { [key: string]: unknown };
                }[];
                history?: {
                    revision: number;
                    timestamp: string;
                    actor?: string;
                    action: string;
                    summary?: string;
                    package_id?: string;
                    ext?: { [key: string]: unknown };
                }[];
                packages: {
                    package_id: string;
                    product_id?: string;
                    budget?: number;
                    min_spend_target?: number;
                    daily_budget_cap?: number;
                    currency?: string;
                    bid_price?: number;
                    bidding?: {
                        automatic?: true;
                        bid_amount?: number;
                        max_bid?: number;
                        cost_per?: { amount: ...; strength: ... };
                        roas?: { value: ...; strength: ... };
                    };
                    optimization_goals?: (
                        | {
                            kind: ...;
                            metric: ...;
                            reach_unit?: ...;
                            target_frequency?: ...;
                            view_duration_seconds?: ...;
                            target?: ...;
                            priority?: ...;
                        }
                        | {
                            kind: ...;
                            event_sources: ...;
                            target?: ...;
                            attribution_window?: ...;
                            priority?: ...;
                        }
                        | {
                            kind: ...;
                            vendor: ...;
                            metric_id: ...;
                            target?: ...;
                            priority?: ...;
                        }
                    )[];
                    format_option_refs?: (
                        | { scope: ...; publisher_domain: ...; format_option_id: ... }
                        | { scope: ...; format_option_id: ...; publisher_domain?: ... }
                    )[];
                    format_kind?: CanonicalFormatKind;
                    params?: {};
                    impressions?: number;
                    pacing?: Pacing;
                    targeting_overlay?: {
                        geo_countries?: [(...), ...(...)[]];
                        geo_countries_exclude?: [(...), ...(...)[]];
                        geo_regions?: [(...), ...(...)[]];
                        geo_regions_exclude?: [(...), ...(...)[]];
                        geo_metros?: [(...), ...(...)[]];
                        geo_metros_exclude?: [(...), ...(...)[]];
                        geo_postal_areas?: [(...), ...(...)[]];
                        geo_postal_areas_exclude?: [(...), ...(...)[]];
                        geo_places?: [(...), ...(...)[]];
                        geo_places_exclude?: [(...), ...(...)[]];
                        daypart_targets?: [(...), ...(...)[]];
                        axe_include_segment?: string;
                        axe_exclude_segment?: string;
                        audience_include?: [(...), ...(...)[]];
                        audience_exclude?: [(...), ...(...)[]];
                        signal_targeting_groups?: { operator: ...; groups: ... };
                        signal_targeting?: [(...), ...(...)[]];
                        demographics?: { age: ... };
                        frequency_cap?: {
                            suppress?: ...;
                            suppress_minutes?: ...;
                            max_impressions?: ...;
                            per?: ...;
                            window?: ...;
                        };
                        property_list?: { agent_url: ...; list_id: ...; auth_token?: ... };
                        property_list_exclude?: {
                            agent_url: ...;
                            list_id: ...;
                            auth_token?: ...;
                        };
                        collection_list?: { agent_url: ...; list_id: ...; auth_token?: ... };
                        collection_list_exclude?: {
                            agent_url: ...;
                            list_id: ...;
                            auth_token?: ...;
                        };
                        placement_selection?: | { mode: ...; placement_refs: ...; ext?: ... }
                        | { mode: ...; ext?: ... };
                        age_restriction?: {
                            min: ...;
                            verification_required?: ...;
                            accepted_methods?: ...;
                        };
                        device_platform?: [(...), ...(...)[]];
                        device_platform_exclude?: [(...), ...(...)[]];
                        device_type?: [(...), ...(...)[]];
                        device_type_exclude?: [(...), ...(...)[]];
                        browser?: [(...), ...(...)[]];
                        browser_exclude?: [(...), ...(...)[]];
                        store_catchments?: [(...), ...(...)[]];
                        geo_proximity?: [(...), ...(...)[]];
                        language?: [(...), ...(...)[]];
                        keyword_targets?: [(...), ...(...)[]];
                        negative_keywords?: [(...), ...(...)[]];
                    };
                    targeting_resolution?: {
                        demographics: {
                            requested: { age: ... };
                            applied: { age: ... };
                            equivalent: true;
                            execution: (...) | (...) | (...);
                            applied_bases?: (...) | (...);
                            applied_verification_methods?: (...) | (...);
                            ext?: (...) | (...);
                        };
                        ext?: { [key: ...]: ... };
                    };
                    start_time?: string;
                    end_time?: string;
                    paused?: boolean;
                    canceled?: boolean;
                    cancellation?: {
                        canceled_at: string;
                        canceled_by: CanceledBy;
                        reason?: string;
                    };
                    creative_deadline?: string;
                    context?: {};
                    creative_approvals?: {
                        creative_id: string;
                        approval_status?: (...)
                        | (...);
                        rejection_reason?: (...) | (...);
                        approval_scopes?: (...) | (...);
                        indicators?: (...) | (...);
                        indicator_types_evaluated?: (...) | (...);
                        indicators_as_of?: (...) | (...);
                        indicators_evaluated_scope?: (...) | (...);
                    }[];
                    formats_to_provide?: (
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                    )[];
                    formats_pending?: (
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                        | {
                            format_option_id?: ...;
                            publisher_domain?: ...;
                            display_name?: ...;
                            sample_render_url?: ...;
                            applies_to_channels?: ...;
                            seller_preference?: ...;
                            locale_policy?: ...;
                            canonical_formats_only?: ...;
                            experimental?: ...;
                            format_shape?: ...;
                            format_schema?: ...;
                            format_kind: ...;
                            params: ...;
                        }
                    )[];
                    snapshot_unavailable_reason?: SnapshotUnavailableReason;
                    snapshot?: {
                        as_of: string;
                        staleness_seconds: number;
                        impressions: number;
                        spend: number;
                        currency?: string;
                        clicks?: number;
                        pacing_index?: number;
                        delivery_status?: DeliveryStatus;
                        ext?: { [key: ...]: ... };
                    };
                    ext?: { [key: string]: unknown };
                    indicator_types_evaluated?: (
                        | "creative_diversity_low"
                        | "audience_saturation"
                        | "inventory_shortfall_forecast"
                        | "pacing_risk"
                        | "budget_constrained"
                    )[];
                    indicators?: { type?: (...)
                    | (...)
                    | (...)
                    | (...)
                    | (...)
                    | (...) }[];
                }[];
                ext?: { [key: string]: unknown };
                indicator_types_evaluated?: "budget_constrained"[];
                indicators?: { type?: "budget_constrained" }[];
            }[];
            errors?: {
                code: string;
                message: string;
                field?: string;
                suggestion?: string;
                retry_after?: number;
                issues?: {
                    pointer: string;
                    message: string;
                    keyword: string;
                    schemaPath?: string;
                    schema_id?: string;
                    discriminator?: (...)[];
                }[];
                details?: {};
                recovery?: "transient"
                | "correctable"
                | "terminal";
                source?: "producer" | "sdk";
                sdk_id?: string;
            }[];
            pagination?: { has_more: boolean; cursor?: string; total_count?: number };
            sandbox?: boolean;
            ext?: { [key: string]: unknown };
        },
    >,
>