@adcp/client 4.3.0 → 4.4.0

package/dist/lib/types/tools.generated.d.ts

@@ -70,6 +70,10 @@ export type GetProductsRequest = {
      * Specific product fields to include in the response. When omitted, all fields are returned. Use for lightweight discovery calls where only a subset of product data is needed (e.g., just IDs and pricing for comparison). Required fields (product_id, name) are always included regardless of selection.
      */
     fields?: ('product_id' | 'name' | 'description' | 'publisher_properties' | 'channels' | 'format_ids' | 'placements' | 'delivery_type' | 'pricing_options' | 'forecast' | 'outcome_measurement' | 'delivery_measurement' | 'reporting_capabilities' | 'creative_policy' | 'catalog_types' | 'metric_optimization' | 'conversion_tracking' | 'data_provider_signals' | 'max_optimization_goals' | 'catalog_match' | 'brief_relevance' | 'expires_at' | 'product_card' | 'product_card_detailed')[];
+    /**
+     * Maximum time the buyer will commit to this request. The seller returns the best results achievable within this budget and does not start processes (human approvals, expensive external queries) that cannot complete in time. When omitted, the seller decides timing.
+     */
+    time_budget?: Duration;
     pagination?: PaginationRequest;
     context?: ContextObject;
     ext?: ExtensionObject;
@@ -486,6 +490,19 @@ export interface PropertyListReference {
      */
     auth_token?: string;
 }
+/**
+ * A time duration expressed as an interval and unit. Used for frequency cap windows, attribution windows, reach optimization windows, time budgets, and other time-based settings. When unit is 'campaign', interval must be 1 — the window spans the full campaign flight.
+ */
+export interface Duration {
+    /**
+     * Number of time units. Must be 1 when unit is 'campaign'.
+     */
+    interval: number;
+    /**
+     * Time unit. 'seconds' for sub-minute precision. 'campaign' spans the full campaign flight.
+     */
+    unit: 'seconds' | 'minutes' | 'hours' | 'days' | 'campaign';
+}
 /**
  * Standard cursor-based pagination parameters for list operations
  */
@@ -679,6 +696,23 @@ export interface GetProductsResponse {
          */
         notes?: string;
     }[];
+    /**
+     * Declares what the seller could not finish within the buyer's time_budget or due to internal limits. Each entry identifies a scope that is missing or partial. Absent when the response is fully complete.
+     */
+    incomplete?: {
+        /**
+         * 'products': not all inventory sources were searched. 'pricing': products returned but pricing is absent or unconfirmed. 'forecast': products returned but forecast data is absent. 'proposals': proposals were not generated or are incomplete.
+         */
+        scope: 'products' | 'pricing' | 'forecast' | 'proposals';
+        /**
+         * Human-readable explanation of what is missing and why.
+         */
+        description: string;
+        /**
+         * How much additional time would resolve this scope. Allows the buyer to decide whether to retry with a larger time_budget.
+         */
+        estimated_wait?: Duration;
+    }[];
     pagination?: PaginationResponse;
     /**
      * When true, this response contains simulated data from sandbox mode.
@@ -1364,19 +1398,6 @@ export interface OutcomeMeasurement {
      */
     reporting: string;
 }
-/**
- * A time duration expressed as an interval and unit. Used for frequency cap windows, attribution windows, reach optimization windows, and other time-based settings. When unit is 'campaign', interval must be 1 — the window spans the full campaign flight.
- */
-export interface Duration {
-    /**
-     * Number of time units. Must be 1 when unit is 'campaign'.
-     */
-    interval: number;
-    /**
-     * Time unit. 'campaign' spans the full campaign flight.
-     */
-    unit: 'minutes' | 'hours' | 'days' | 'campaign';
-}
 /**
  * Reporting capabilities available for a product
  */