@trillboards/api-client 3.1.15 → 3.2.1

package/dist/generated.mjs

@@ -1,3 +1,3 @@
-export { generatedTypes } from './chunk-X2AIWEHJ.mjs';
+export { generatedTypes } from './chunk-JLSS2URG.mjs';
 //# sourceMappingURL=generated.mjs.map
 //# sourceMappingURL=generated.mjs.map

package/dist/index.d.mts

@@ -1,12 +1,13 @@
-import { Screen, PartnerDeviceRegistrationInput, DisplaySettingsResponse, DisplaySettingsInput, Device, PartnerDeviceBatchRegistrationInput, Impression, AnalyticsData, EarningsData, ErrorEntry, Webhook, FleetCommand, AudienceData, BillingInfo, CreatePartnerSensingRouteRequest, SensingRoute, UpdatePartnerSensingRouteRequest, createCreativeFeedbackExperimentOperation, configureCreativeFeedbackBrandOperation, importCreativeFeedbackCreativeOperation, getCreativeFeedbackExperimentOperation, registerCreativeFeedbackVariantsOperation, updateCreativeFeedbackPolicyOperation, getCreativeFeedbackRewardsOperation, generateCreativeFeedbackCreativeOperation, reviewCreativeFeedbackCreativeOperation, stopCreativeFeedbackExperimentOperation, WebhookEvent } from './generated.mjs';
+import { Screen, PartnerDeviceRegistrationInput, DisplaySettingsResponse, DisplaySettingsInput, Device, PartnerDeviceBatchRegistrationInput, Impression, AnalyticsData, EarningsData, ErrorEntry, Webhook, FleetCommand, AudienceData, dataApiListScreensOperation, dataApiScreenAudienceHistoryOperation, dataApiScreenAudienceLiveOperation, dataApiQueryDslOperation, dataApiStreamOperation, setupBillingOperation, createCreditCheckoutOperation, purchaseCreditsOperation, getBillingUsageSummaryOperation, BillingInfo, CreatePartnerSensingRouteRequest, SensingRoute, UpdatePartnerSensingRouteRequest, createCreativeFeedbackExperimentOperation, configureCreativeFeedbackBrandOperation, importCreativeFeedbackCreativeOperation, getCreativeFeedbackExperimentOperation, registerCreativeFeedbackVariantsOperation, updateCreativeFeedbackPolicyOperation, getCreativeFeedbackRewardsOperation, generateCreativeFeedbackCreativeOperation, reviewCreativeFeedbackCreativeOperation, stopCreativeFeedbackExperimentOperation, Mcp_get_products_Args, Mcp_list_accounts_Args, Mcp_sync_accounts_Args, Mcp_create_media_buy_Args, Mcp_get_media_buys_Args, Mcp_update_media_buy_Args, Mcp_get_media_buy_delivery_Args, Mcp_sync_creatives_Args, Mcp_discover_inventory_Args, WebhookEvent } from './generated.mjs';
 export { BleScanResultData, ContentFitSettings, CreativeRewardsReadyEvent, DeviceCapabilityPayload, FeedbackBrand, FeedbackBrandRequest, FeedbackCreateRequest, FeedbackExperiment, FeedbackGenerateRequest, FeedbackGeneratedCreative, FeedbackImportRequest, FeedbackPolicyRequest, FeedbackRegisterVariantsRequest, FeedbackReviewRequest, FeedbackRewardQuery, FeedbackRewardRow, FeedbackRewards, FeedbackStopRequest, GeneratedOperationName, GeneratedSchemaName, HttpProbeResult, MdnsNetworkDevice, PartnerAdDeliveryProfile, PartnerDeviceHeartbeatBody, PartnerHeartbeatMeasurementMetadata, PartnerHeartbeatQueryData, PartnerHeartbeatQueryResponse, PartnerHeartbeatRequest, PartnerHeartbeatResponse, PartnerSafeHeartbeatTelemetry, SsdpDeviceInfo, WifiEnvironmentSnapshot, WifiScanResult, generatedTypes, getDeviceHeartbeatOperation, heartbeatOperation } from './generated.mjs';
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 
 /**
  * Non-wire type definitions for the Trillboards API Client SDK.
  *
  * This file is DELIBERATELY narrow. Every type that has an on-the-wire peer in
  * the OpenAPI contract lives in `./generated` (emitted from
- * trillboard-api/docs/openapi/merged/partner-api.json via `npm run generate`)
+ * native partner/data OpenAPI and mounted MCP schemas via `npm run generate`)
  * and is re-exported from `./index`. What remains here is the set of types that
  * CANNOT be generated from the spec and are the SDK's own hand-crafted surface:
  *
@@ -150,7 +151,7 @@ interface SensingThresholdCrossedEvent {
 /**
  * Internal HTTP client for the Trillboards API.
  *
- * Uses native fetch (Node 18+). Zero runtime dependencies.
+ * Uses native fetch (Node 18+) for JSON requests and cancelable live streams.
  * Sends standard headers: Authorization, Content-Type, User-Agent, X-Trillboards-Client.
  */
 
@@ -189,6 +190,12 @@ declare class HttpClient {
     private readonly config;
     constructor(config: HttpClientConfig);
     request<T>(method: string, path: string, options?: RequestOptions): Promise<T>;
+    private requestResponse;
+    private readJson;
+    /** Open one authenticated live tail. The native endpoint has no replay cursor. */
+    openStream(path: string, options?: RequestOptions & {
+        signal?: AbortSignal;
+    }): Promise<Response>;
     get<T>(path: string, opts?: {
         params?: Record<string, unknown>;
     }): Promise<T>;
@@ -518,11 +525,18 @@ declare class AudienceClient {
     }>;
 }
 
-/**
- * DataClient — data export and venue intelligence.
- *
- * Base path: /v1/partner
- */
+/** The SSE frame and its decoded JSON payload; in-band error events remain events. */
+interface DataStreamEvent {
+    event: string;
+    data: unknown;
+    id?: string;
+    retry?: number;
+}
+interface StreamOptions {
+    signal?: AbortSignal;
+}
+
+/** Native data access through the existing authenticated transport. */
 
 declare class DataClient {
     private readonly http;
@@ -539,6 +553,12 @@ declare class DataClient {
         success: boolean;
         data: Record<string, unknown>;
     }>;
+    listScreens(query?: dataApiListScreensOperation['query']): Promise<dataApiListScreensOperation['response']>;
+    getHistory(screenId: string, query?: dataApiScreenAudienceHistoryOperation['query']): Promise<dataApiScreenAudienceHistoryOperation['response']>;
+    getAudience(screenId: string): Promise<dataApiScreenAudienceLiveOperation['response']>;
+    query(body: dataApiQueryDslOperation['request']): Promise<dataApiQueryDslOperation['response']>;
+    /** One live tail; reconnect explicitly and recover history through bounded reads. */
+    stream(query?: dataApiStreamOperation['query'], options?: StreamOptions): AsyncIterable<DataStreamEvent>;
 }
 
 /**
@@ -547,9 +567,18 @@ declare class DataClient {
  * Base path: /v1/partner
  */
 
+/** Reuse the same key only for the exact same financial request. */
+interface BillingOperationOptions {
+    idempotencyKey: string;
+}
 declare class BillingClient {
     private readonly http;
     constructor(http: HttpClient);
+    setup(body: setupBillingOperation['request']): Promise<setupBillingOperation['response']>;
+    createCreditCheckout(body: createCreditCheckoutOperation['request'], options: BillingOperationOptions): Promise<createCreditCheckoutOperation['response']>;
+    purchaseCredits(body: purchaseCreditsOperation['request'], options: BillingOperationOptions): Promise<purchaseCreditsOperation['response']>;
+    /** Read the committed shared credit ledger after Stripe payment completes. */
+    getUsageSummary(): Promise<getBillingUsageSummaryOperation['response']>;
     /** Get current billing info (plan, credits, usage). */
     get(): Promise<{
         success: boolean;
@@ -637,6 +666,153 @@ declare class CreativeExperimentsClient {
     stop(id: string, body: stopCreativeFeedbackExperimentOperation['request']): Promise<stopCreativeFeedbackExperimentOperation['response']>;
 }
 
+/** Native MCP errors retain their complete result, including structured receipts. */
+declare class McpToolError extends Error {
+    readonly tool: string;
+    readonly result: CallToolResult;
+    readonly name = "McpToolError";
+    constructor(tool: string, result: CallToolResult);
+}
+interface MediaPagination {
+    has_more: boolean;
+    cursor?: string;
+    total_count?: number;
+}
+interface MediaProduct extends Record<string, unknown> {
+    product_id: string;
+    name?: string;
+    pricing_options: Array<{
+        pricing_option_id: string;
+        fixed_price?: number;
+        floor_price?: number;
+        currency?: string;
+        [key: string]: unknown;
+    }>;
+}
+interface MediaFunding extends Record<string, unknown> {
+    status: string;
+    required_cents?: number | string;
+    available_cents?: number | string;
+    drawn_cents?: number | string;
+}
+interface MediaPackage extends Record<string, unknown> {
+    package_id: string;
+    product_id?: string;
+}
+/** Selected native response fields; the complete extensible payload is preserved. */
+interface MediaBuy extends Record<string, unknown> {
+    media_buy_id: string;
+    packages: MediaPackage[];
+    revision: number;
+    media_buy_status?: string;
+    status?: string;
+    funding?: MediaFunding;
+}
+interface MediaProductsResponse extends Record<string, unknown> {
+    products: MediaProduct[];
+    pagination?: MediaPagination;
+}
+interface MediaBuysResponse extends Record<string, unknown> {
+    media_buys: MediaBuy[];
+    pagination: MediaPagination;
+}
+interface MediaAccountsResponse extends Record<string, unknown> {
+    accounts: Array<{
+        account_id: string;
+        status: string;
+        [key: string]: unknown;
+    }>;
+    pagination?: MediaPagination;
+}
+interface MediaNativeError extends Record<string, unknown> {
+    code: string;
+    message: string;
+}
+interface MediaBuyUpdateResponse extends Record<string, unknown> {
+    media_buy_id: string;
+    revision: number;
+    media_buy_status: string;
+    sandbox: boolean;
+    affected_packages?: MediaPackage[];
+    applied: Record<string, unknown>;
+    unsupported: string[];
+    placements_updated: number;
+    placement_count: number;
+}
+interface MediaDeliveryResponse extends Record<string, unknown> {
+    media_buy_id: string;
+    impressions: number;
+    reach_screens: number;
+    contracted_spend_usd: number;
+    sandbox: boolean;
+    pacing: {
+        goal_impressions: number;
+        delivered: number;
+        delivery_rate: number;
+    };
+    dimensions_honoured: string[];
+    dimensions_unsupported: string[];
+}
+interface MediaCreativeSyncResponse extends Record<string, unknown> {
+    media_buy_id: string | null;
+    advertisement_id: string | null;
+    sandbox: boolean;
+    creatives: Array<{
+        creative_id: string;
+        action: string;
+        status?: string;
+        errors?: MediaNativeError[];
+        [key: string]: unknown;
+    }>;
+    validation_results: Array<Record<string, unknown>>;
+    approved_count: number;
+    rejected_count: number;
+    placements_activated: number;
+    servable: boolean;
+    funding?: MediaFunding;
+    moderation?: Record<string, unknown>;
+    validated_against: {
+        catalogue_generated_at: string;
+        stale: boolean;
+    };
+}
+interface MediaAccountsSyncResponse extends Record<string, unknown> {
+    dry_run: boolean;
+    accounts: Array<{
+        account_id: string | null;
+        action: string;
+        status?: string;
+        errors?: MediaNativeError[];
+        [key: string]: unknown;
+    }>;
+}
+declare class MediaBuysClient {
+    private readonly config;
+    private client?;
+    private transport?;
+    private connecting?;
+    constructor(config: HttpClientConfig);
+    private connection;
+    private call;
+    getProducts(args?: Mcp_get_products_Args): Promise<MediaProductsResponse>;
+    listAccounts(args?: Mcp_list_accounts_Args): Promise<MediaAccountsResponse>;
+    syncAccounts(args: Mcp_sync_accounts_Args): Promise<MediaAccountsSyncResponse>;
+    create(args: Mcp_create_media_buy_Args): Promise<MediaBuy>;
+    list(args?: Mcp_get_media_buys_Args): Promise<MediaBuysResponse>;
+    update(args: Mcp_update_media_buy_Args): Promise<MediaBuyUpdateResponse>;
+    getDelivery(args: Mcp_get_media_buy_delivery_Args): Promise<MediaDeliveryResponse>;
+    syncCreatives(args: Mcp_sync_creatives_Args): Promise<MediaCreativeSyncResponse>;
+    discoverInventory(args?: Mcp_discover_inventory_Args): Promise<{
+        success: boolean;
+        data: {
+            screens: Array<Record<string, unknown>>;
+            [key: string]: unknown;
+        };
+    }>;
+    /** Release MCP streams and terminate an optional server session. */
+    close(): Promise<void>;
+}
+
 /**
  * TrillboardsClient — main entry point for the Trillboards Partner API SDK.
  *
@@ -661,6 +837,7 @@ declare class TrillboardsClient {
     readonly billing: BillingClient;
     readonly routes: RoutesClient;
     readonly creativeExperiments: CreativeExperimentsClient;
+    readonly mediaBuys: MediaBuysClient;
     /** The underlying HTTP client (exposed for advanced use cases). */
     readonly _http: HttpClient;
     constructor(options: ClientOptions);
@@ -913,6 +1090,6 @@ declare const Webhooks: {
  * SDK version constant. Sent in User-Agent and X-Trillboards-Client headers.
  * Keep in sync with package.json version.
  */
-declare const VERSION = "3.1.15";
+declare const VERSION = "3.2.1";
 
-export { ADCP_WEBHOOK_SIGNING_TAG, type AdcpJwk, AnalyticsClient, AnalyticsData, type ApiErrorType, AudienceClient, AudienceData, BillingClient, BillingInfo, type ClientOptions, type ConstructEventOptions, type ContentFitMode, CreatePartnerSensingRouteRequest, CreativeExperimentsClient, DataClient, Device, DevicesClient, DisplaySettingsInput, DisplaySettingsResponse, EarningsClient, EarningsData, type ErrorDetail, ErrorEntry, type ErrorResponseBody, ErrorsClient, FleetClient, FleetCommand, Impression, ImpressionsClient, type ListResponse, type ParsedSignatureHeader, PartnerDeviceBatchRegistrationInput, PartnerDeviceRegistrationInput, type RequestOptions, type RetryOptions, type RouteAction, type RouteChannel, type RouteCondition, type RouteConditionOp, type RouteDigest, type RouteDigestSummary, type RouteWebhookEvent, RoutesClient, Screen, ScreensClient, SensingRoute, type SensingThresholdCrossedEvent, TrillboardsClient, TrillboardsError, type TrillboardsErrorOptions, UpdatePartnerSensingRouteRequest, VERSION, type VerifyAdcpWebhookOptions, Webhook, WebhookEvent, type WebhookHeaders, Webhooks, WebhooksClient, constructEvent, constructEventLegacy, parseSignatureHeader, retryWithBackoff, verifyAdcpWebhook };
+export { ADCP_WEBHOOK_SIGNING_TAG, type AdcpJwk, AnalyticsClient, AnalyticsData, type ApiErrorType, AudienceClient, AudienceData, BillingClient, BillingInfo, type BillingOperationOptions, type ClientOptions, type ConstructEventOptions, type ContentFitMode, CreatePartnerSensingRouteRequest, CreativeExperimentsClient, DataClient, type DataStreamEvent, Device, DevicesClient, DisplaySettingsInput, DisplaySettingsResponse, EarningsClient, EarningsData, type ErrorDetail, ErrorEntry, type ErrorResponseBody, ErrorsClient, FleetClient, FleetCommand, Impression, ImpressionsClient, type ListResponse, McpToolError, Mcp_create_media_buy_Args, Mcp_discover_inventory_Args, Mcp_get_media_buy_delivery_Args, Mcp_get_media_buys_Args, Mcp_get_products_Args, Mcp_list_accounts_Args, Mcp_sync_accounts_Args, Mcp_sync_creatives_Args, Mcp_update_media_buy_Args, type MediaAccountsResponse, type MediaAccountsSyncResponse, type MediaBuy, type MediaBuyUpdateResponse, MediaBuysClient, type MediaBuysResponse, type MediaCreativeSyncResponse, type MediaDeliveryResponse, type MediaFunding, type MediaNativeError, type MediaPackage, type MediaPagination, type MediaProduct, type MediaProductsResponse, type ParsedSignatureHeader, PartnerDeviceBatchRegistrationInput, PartnerDeviceRegistrationInput, type RequestOptions, type RetryOptions, type RouteAction, type RouteChannel, type RouteCondition, type RouteConditionOp, type RouteDigest, type RouteDigestSummary, type RouteWebhookEvent, RoutesClient, Screen, ScreensClient, SensingRoute, type SensingThresholdCrossedEvent, type StreamOptions, TrillboardsClient, TrillboardsError, type TrillboardsErrorOptions, UpdatePartnerSensingRouteRequest, VERSION, type VerifyAdcpWebhookOptions, Webhook, WebhookEvent, type WebhookHeaders, Webhooks, WebhooksClient, constructEvent, constructEventLegacy, createCreditCheckoutOperation, dataApiListScreensOperation, dataApiQueryDslOperation, dataApiScreenAudienceHistoryOperation, dataApiScreenAudienceLiveOperation, dataApiStreamOperation, getBillingUsageSummaryOperation, parseSignatureHeader, purchaseCreditsOperation, retryWithBackoff, setupBillingOperation, verifyAdcpWebhook };

package/dist/index.d.ts

@@ -1,12 +1,13 @@
-import { Screen, PartnerDeviceRegistrationInput, DisplaySettingsResponse, DisplaySettingsInput, Device, PartnerDeviceBatchRegistrationInput, Impression, AnalyticsData, EarningsData, ErrorEntry, Webhook, FleetCommand, AudienceData, BillingInfo, CreatePartnerSensingRouteRequest, SensingRoute, UpdatePartnerSensingRouteRequest, createCreativeFeedbackExperimentOperation, configureCreativeFeedbackBrandOperation, importCreativeFeedbackCreativeOperation, getCreativeFeedbackExperimentOperation, registerCreativeFeedbackVariantsOperation, updateCreativeFeedbackPolicyOperation, getCreativeFeedbackRewardsOperation, generateCreativeFeedbackCreativeOperation, reviewCreativeFeedbackCreativeOperation, stopCreativeFeedbackExperimentOperation, WebhookEvent } from './generated.js';
+import { Screen, PartnerDeviceRegistrationInput, DisplaySettingsResponse, DisplaySettingsInput, Device, PartnerDeviceBatchRegistrationInput, Impression, AnalyticsData, EarningsData, ErrorEntry, Webhook, FleetCommand, AudienceData, dataApiListScreensOperation, dataApiScreenAudienceHistoryOperation, dataApiScreenAudienceLiveOperation, dataApiQueryDslOperation, dataApiStreamOperation, setupBillingOperation, createCreditCheckoutOperation, purchaseCreditsOperation, getBillingUsageSummaryOperation, BillingInfo, CreatePartnerSensingRouteRequest, SensingRoute, UpdatePartnerSensingRouteRequest, createCreativeFeedbackExperimentOperation, configureCreativeFeedbackBrandOperation, importCreativeFeedbackCreativeOperation, getCreativeFeedbackExperimentOperation, registerCreativeFeedbackVariantsOperation, updateCreativeFeedbackPolicyOperation, getCreativeFeedbackRewardsOperation, generateCreativeFeedbackCreativeOperation, reviewCreativeFeedbackCreativeOperation, stopCreativeFeedbackExperimentOperation, Mcp_get_products_Args, Mcp_list_accounts_Args, Mcp_sync_accounts_Args, Mcp_create_media_buy_Args, Mcp_get_media_buys_Args, Mcp_update_media_buy_Args, Mcp_get_media_buy_delivery_Args, Mcp_sync_creatives_Args, Mcp_discover_inventory_Args, WebhookEvent } from './generated.js';
 export { BleScanResultData, ContentFitSettings, CreativeRewardsReadyEvent, DeviceCapabilityPayload, FeedbackBrand, FeedbackBrandRequest, FeedbackCreateRequest, FeedbackExperiment, FeedbackGenerateRequest, FeedbackGeneratedCreative, FeedbackImportRequest, FeedbackPolicyRequest, FeedbackRegisterVariantsRequest, FeedbackReviewRequest, FeedbackRewardQuery, FeedbackRewardRow, FeedbackRewards, FeedbackStopRequest, GeneratedOperationName, GeneratedSchemaName, HttpProbeResult, MdnsNetworkDevice, PartnerAdDeliveryProfile, PartnerDeviceHeartbeatBody, PartnerHeartbeatMeasurementMetadata, PartnerHeartbeatQueryData, PartnerHeartbeatQueryResponse, PartnerHeartbeatRequest, PartnerHeartbeatResponse, PartnerSafeHeartbeatTelemetry, SsdpDeviceInfo, WifiEnvironmentSnapshot, WifiScanResult, generatedTypes, getDeviceHeartbeatOperation, heartbeatOperation } from './generated.js';
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 
 /**
  * Non-wire type definitions for the Trillboards API Client SDK.
  *
  * This file is DELIBERATELY narrow. Every type that has an on-the-wire peer in
  * the OpenAPI contract lives in `./generated` (emitted from
- * trillboard-api/docs/openapi/merged/partner-api.json via `npm run generate`)
+ * native partner/data OpenAPI and mounted MCP schemas via `npm run generate`)
  * and is re-exported from `./index`. What remains here is the set of types that
  * CANNOT be generated from the spec and are the SDK's own hand-crafted surface:
  *
@@ -150,7 +151,7 @@ interface SensingThresholdCrossedEvent {
 /**
  * Internal HTTP client for the Trillboards API.
  *
- * Uses native fetch (Node 18+). Zero runtime dependencies.
+ * Uses native fetch (Node 18+) for JSON requests and cancelable live streams.
  * Sends standard headers: Authorization, Content-Type, User-Agent, X-Trillboards-Client.
  */
 
@@ -189,6 +190,12 @@ declare class HttpClient {
     private readonly config;
     constructor(config: HttpClientConfig);
     request<T>(method: string, path: string, options?: RequestOptions): Promise<T>;
+    private requestResponse;
+    private readJson;
+    /** Open one authenticated live tail. The native endpoint has no replay cursor. */
+    openStream(path: string, options?: RequestOptions & {
+        signal?: AbortSignal;
+    }): Promise<Response>;
     get<T>(path: string, opts?: {
         params?: Record<string, unknown>;
     }): Promise<T>;
@@ -518,11 +525,18 @@ declare class AudienceClient {
     }>;
 }
 
-/**
- * DataClient — data export and venue intelligence.
- *
- * Base path: /v1/partner
- */
+/** The SSE frame and its decoded JSON payload; in-band error events remain events. */
+interface DataStreamEvent {
+    event: string;
+    data: unknown;
+    id?: string;
+    retry?: number;
+}
+interface StreamOptions {
+    signal?: AbortSignal;
+}
+
+/** Native data access through the existing authenticated transport. */
 
 declare class DataClient {
     private readonly http;
@@ -539,6 +553,12 @@ declare class DataClient {
         success: boolean;
         data: Record<string, unknown>;
     }>;
+    listScreens(query?: dataApiListScreensOperation['query']): Promise<dataApiListScreensOperation['response']>;
+    getHistory(screenId: string, query?: dataApiScreenAudienceHistoryOperation['query']): Promise<dataApiScreenAudienceHistoryOperation['response']>;
+    getAudience(screenId: string): Promise<dataApiScreenAudienceLiveOperation['response']>;
+    query(body: dataApiQueryDslOperation['request']): Promise<dataApiQueryDslOperation['response']>;
+    /** One live tail; reconnect explicitly and recover history through bounded reads. */
+    stream(query?: dataApiStreamOperation['query'], options?: StreamOptions): AsyncIterable<DataStreamEvent>;
 }
 
 /**
@@ -547,9 +567,18 @@ declare class DataClient {
  * Base path: /v1/partner
  */
 
+/** Reuse the same key only for the exact same financial request. */
+interface BillingOperationOptions {
+    idempotencyKey: string;
+}
 declare class BillingClient {
     private readonly http;
     constructor(http: HttpClient);
+    setup(body: setupBillingOperation['request']): Promise<setupBillingOperation['response']>;
+    createCreditCheckout(body: createCreditCheckoutOperation['request'], options: BillingOperationOptions): Promise<createCreditCheckoutOperation['response']>;
+    purchaseCredits(body: purchaseCreditsOperation['request'], options: BillingOperationOptions): Promise<purchaseCreditsOperation['response']>;
+    /** Read the committed shared credit ledger after Stripe payment completes. */
+    getUsageSummary(): Promise<getBillingUsageSummaryOperation['response']>;
     /** Get current billing info (plan, credits, usage). */
     get(): Promise<{
         success: boolean;
@@ -637,6 +666,153 @@ declare class CreativeExperimentsClient {
     stop(id: string, body: stopCreativeFeedbackExperimentOperation['request']): Promise<stopCreativeFeedbackExperimentOperation['response']>;
 }
 
+/** Native MCP errors retain their complete result, including structured receipts. */
+declare class McpToolError extends Error {
+    readonly tool: string;
+    readonly result: CallToolResult;
+    readonly name = "McpToolError";
+    constructor(tool: string, result: CallToolResult);
+}
+interface MediaPagination {
+    has_more: boolean;
+    cursor?: string;
+    total_count?: number;
+}
+interface MediaProduct extends Record<string, unknown> {
+    product_id: string;
+    name?: string;
+    pricing_options: Array<{
+        pricing_option_id: string;
+        fixed_price?: number;
+        floor_price?: number;
+        currency?: string;
+        [key: string]: unknown;
+    }>;
+}
+interface MediaFunding extends Record<string, unknown> {
+    status: string;
+    required_cents?: number | string;
+    available_cents?: number | string;
+    drawn_cents?: number | string;
+}
+interface MediaPackage extends Record<string, unknown> {
+    package_id: string;
+    product_id?: string;
+}
+/** Selected native response fields; the complete extensible payload is preserved. */
+interface MediaBuy extends Record<string, unknown> {
+    media_buy_id: string;
+    packages: MediaPackage[];
+    revision: number;
+    media_buy_status?: string;
+    status?: string;
+    funding?: MediaFunding;
+}
+interface MediaProductsResponse extends Record<string, unknown> {
+    products: MediaProduct[];
+    pagination?: MediaPagination;
+}
+interface MediaBuysResponse extends Record<string, unknown> {
+    media_buys: MediaBuy[];
+    pagination: MediaPagination;
+}
+interface MediaAccountsResponse extends Record<string, unknown> {
+    accounts: Array<{
+        account_id: string;
+        status: string;
+        [key: string]: unknown;
+    }>;
+    pagination?: MediaPagination;
+}
+interface MediaNativeError extends Record<string, unknown> {
+    code: string;
+    message: string;
+}
+interface MediaBuyUpdateResponse extends Record<string, unknown> {
+    media_buy_id: string;
+    revision: number;
+    media_buy_status: string;
+    sandbox: boolean;
+    affected_packages?: MediaPackage[];
+    applied: Record<string, unknown>;
+    unsupported: string[];
+    placements_updated: number;
+    placement_count: number;
+}
+interface MediaDeliveryResponse extends Record<string, unknown> {
+    media_buy_id: string;
+    impressions: number;
+    reach_screens: number;
+    contracted_spend_usd: number;
+    sandbox: boolean;
+    pacing: {
+        goal_impressions: number;
+        delivered: number;
+        delivery_rate: number;
+    };
+    dimensions_honoured: string[];
+    dimensions_unsupported: string[];
+}
+interface MediaCreativeSyncResponse extends Record<string, unknown> {
+    media_buy_id: string | null;
+    advertisement_id: string | null;
+    sandbox: boolean;
+    creatives: Array<{
+        creative_id: string;
+        action: string;
+        status?: string;
+        errors?: MediaNativeError[];
+        [key: string]: unknown;
+    }>;
+    validation_results: Array<Record<string, unknown>>;
+    approved_count: number;
+    rejected_count: number;
+    placements_activated: number;
+    servable: boolean;
+    funding?: MediaFunding;
+    moderation?: Record<string, unknown>;
+    validated_against: {
+        catalogue_generated_at: string;
+        stale: boolean;
+    };
+}
+interface MediaAccountsSyncResponse extends Record<string, unknown> {
+    dry_run: boolean;
+    accounts: Array<{
+        account_id: string | null;
+        action: string;
+        status?: string;
+        errors?: MediaNativeError[];
+        [key: string]: unknown;
+    }>;
+}
+declare class MediaBuysClient {
+    private readonly config;
+    private client?;
+    private transport?;
+    private connecting?;
+    constructor(config: HttpClientConfig);
+    private connection;
+    private call;
+    getProducts(args?: Mcp_get_products_Args): Promise<MediaProductsResponse>;
+    listAccounts(args?: Mcp_list_accounts_Args): Promise<MediaAccountsResponse>;
+    syncAccounts(args: Mcp_sync_accounts_Args): Promise<MediaAccountsSyncResponse>;
+    create(args: Mcp_create_media_buy_Args): Promise<MediaBuy>;
+    list(args?: Mcp_get_media_buys_Args): Promise<MediaBuysResponse>;
+    update(args: Mcp_update_media_buy_Args): Promise<MediaBuyUpdateResponse>;
+    getDelivery(args: Mcp_get_media_buy_delivery_Args): Promise<MediaDeliveryResponse>;
+    syncCreatives(args: Mcp_sync_creatives_Args): Promise<MediaCreativeSyncResponse>;
+    discoverInventory(args?: Mcp_discover_inventory_Args): Promise<{
+        success: boolean;
+        data: {
+            screens: Array<Record<string, unknown>>;
+            [key: string]: unknown;
+        };
+    }>;
+    /** Release MCP streams and terminate an optional server session. */
+    close(): Promise<void>;
+}
+
 /**
  * TrillboardsClient — main entry point for the Trillboards Partner API SDK.
  *
@@ -661,6 +837,7 @@ declare class TrillboardsClient {
     readonly billing: BillingClient;
     readonly routes: RoutesClient;
     readonly creativeExperiments: CreativeExperimentsClient;
+    readonly mediaBuys: MediaBuysClient;
     /** The underlying HTTP client (exposed for advanced use cases). */
     readonly _http: HttpClient;
     constructor(options: ClientOptions);
@@ -913,6 +1090,6 @@ declare const Webhooks: {
  * SDK version constant. Sent in User-Agent and X-Trillboards-Client headers.
  * Keep in sync with package.json version.
  */
-declare const VERSION = "3.1.15";
+declare const VERSION = "3.2.1";
 
-export { ADCP_WEBHOOK_SIGNING_TAG, type AdcpJwk, AnalyticsClient, AnalyticsData, type ApiErrorType, AudienceClient, AudienceData, BillingClient, BillingInfo, type ClientOptions, type ConstructEventOptions, type ContentFitMode, CreatePartnerSensingRouteRequest, CreativeExperimentsClient, DataClient, Device, DevicesClient, DisplaySettingsInput, DisplaySettingsResponse, EarningsClient, EarningsData, type ErrorDetail, ErrorEntry, type ErrorResponseBody, ErrorsClient, FleetClient, FleetCommand, Impression, ImpressionsClient, type ListResponse, type ParsedSignatureHeader, PartnerDeviceBatchRegistrationInput, PartnerDeviceRegistrationInput, type RequestOptions, type RetryOptions, type RouteAction, type RouteChannel, type RouteCondition, type RouteConditionOp, type RouteDigest, type RouteDigestSummary, type RouteWebhookEvent, RoutesClient, Screen, ScreensClient, SensingRoute, type SensingThresholdCrossedEvent, TrillboardsClient, TrillboardsError, type TrillboardsErrorOptions, UpdatePartnerSensingRouteRequest, VERSION, type VerifyAdcpWebhookOptions, Webhook, WebhookEvent, type WebhookHeaders, Webhooks, WebhooksClient, constructEvent, constructEventLegacy, parseSignatureHeader, retryWithBackoff, verifyAdcpWebhook };
+export { ADCP_WEBHOOK_SIGNING_TAG, type AdcpJwk, AnalyticsClient, AnalyticsData, type ApiErrorType, AudienceClient, AudienceData, BillingClient, BillingInfo, type BillingOperationOptions, type ClientOptions, type ConstructEventOptions, type ContentFitMode, CreatePartnerSensingRouteRequest, CreativeExperimentsClient, DataClient, type DataStreamEvent, Device, DevicesClient, DisplaySettingsInput, DisplaySettingsResponse, EarningsClient, EarningsData, type ErrorDetail, ErrorEntry, type ErrorResponseBody, ErrorsClient, FleetClient, FleetCommand, Impression, ImpressionsClient, type ListResponse, McpToolError, Mcp_create_media_buy_Args, Mcp_discover_inventory_Args, Mcp_get_media_buy_delivery_Args, Mcp_get_media_buys_Args, Mcp_get_products_Args, Mcp_list_accounts_Args, Mcp_sync_accounts_Args, Mcp_sync_creatives_Args, Mcp_update_media_buy_Args, type MediaAccountsResponse, type MediaAccountsSyncResponse, type MediaBuy, type MediaBuyUpdateResponse, MediaBuysClient, type MediaBuysResponse, type MediaCreativeSyncResponse, type MediaDeliveryResponse, type MediaFunding, type MediaNativeError, type MediaPackage, type MediaPagination, type MediaProduct, type MediaProductsResponse, type ParsedSignatureHeader, PartnerDeviceBatchRegistrationInput, PartnerDeviceRegistrationInput, type RequestOptions, type RetryOptions, type RouteAction, type RouteChannel, type RouteCondition, type RouteConditionOp, type RouteDigest, type RouteDigestSummary, type RouteWebhookEvent, RoutesClient, Screen, ScreensClient, SensingRoute, type SensingThresholdCrossedEvent, type StreamOptions, TrillboardsClient, TrillboardsError, type TrillboardsErrorOptions, UpdatePartnerSensingRouteRequest, VERSION, type VerifyAdcpWebhookOptions, Webhook, WebhookEvent, type WebhookHeaders, Webhooks, WebhooksClient, constructEvent, constructEventLegacy, createCreditCheckoutOperation, dataApiListScreensOperation, dataApiQueryDslOperation, dataApiScreenAudienceHistoryOperation, dataApiScreenAudienceLiveOperation, dataApiStreamOperation, getBillingUsageSummaryOperation, parseSignatureHeader, purchaseCreditsOperation, retryWithBackoff, setupBillingOperation, verifyAdcpWebhook };