@adcp/sdk 14.0.0-beta.11 → 14.0.0-beta.12

package/bin/adcp-storyboard-sandbox.js

@@ -0,0 +1,16 @@
+'use strict';
+
+/**
+ * Translate storyboard CLI routing flags into runner options.
+ * Omitted flags intentionally preserve the historical undefined sandbox mode.
+ */
+function sandboxRunOptions(options = {}) {
+  if (options.sandbox && options.noSandbox) {
+    throw new Error('--sandbox and --no-sandbox are mutually exclusive');
+  }
+  if (options.sandbox) return { sandbox: true };
+  if (options.noSandbox) return { sandbox: false, disable_sandbox: true };
+  return {};
+}
+
+module.exports = { sandboxRunOptions };

package/bin/adcp.js

@@ -53,6 +53,7 @@ const { scheduleVersionCheck } = require('./adcp-version-check.js');
 const { formatStoryboardResultsAsJUnit } = require('../dist/lib/testing/storyboard/junit.js');
 const { LIBRARY_VERSION } = require('../dist/lib/version.js');
 const { appendBuiltInVersionUnsupportedHint } = require('./adcp-version-unsupported-hint.js');
+const { sandboxRunOptions } = require('./adcp-storyboard-sandbox.js');
 const {
   createCLIOAuthProvider,
   hasValidOAuthTokens,
@@ -1053,12 +1054,14 @@ function parseAgentOptions(args) {
   // transport/version behavior against a known schema-invalid legacy seller.
   // Normal local compliance runs remain strict by default.
   const strictResponseSchemaValidation = !args.includes('--no-strict-response-schema-validation');
-  // `--no-sandbox` forces `account.sandbox: false` (production) on every
-  // request the runner builds. The default behavior leaves the field unset
-  // (spec-equivalent to false), but agents that key sandbox routing on
-  // field PRESENCE rather than VALUE behave differently. Setting the flag
-  // makes the production intent explicit on the wire.
+  // Direct storyboard runs can explicitly choose sandbox or production
+  // routing. Leaving both flags absent preserves the historical wire shape.
+  const sandbox = args.includes('--sandbox');
   const noSandbox = args.includes('--no-sandbox');
+  if (sandbox && noSandbox) {
+    console.error('Error: --sandbox and --no-sandbox are mutually exclusive.');
+    process.exit(2);
+  }
 
   // `--asserts-seeded-state` declares that the operator has provisioned
   // initial test state out-of-band (HTTP admin endpoint, pre-test script,
@@ -1238,6 +1241,7 @@ function parseAgentOptions(args) {
     dryRun,
     allowHttp,
     strictResponseSchemaValidation,
+    sandbox,
     noSandbox,
     assertsSeededState,
     mediaBuyLifecycleCompatibility,
@@ -2049,6 +2053,9 @@ RUN OPTIONS (full assessment):
                       after this budget, without aborting an active storyboard
                       (default: max(120, 10 × selected storyboard count))
   --brief TEXT        Custom brief for product discovery
+  --sandbox           Explicitly run against sandbox accounts. Sets
+                      account.sandbox=true and enables sandbox-only runner
+                      facilities such as functional request signing.
   --no-sandbox        Force production-path responses (#841). Sets
                       account.sandbox=false on every request AND stamps
                       ext.adcp.disable_sandbox=true to signal adopters
@@ -2916,7 +2923,7 @@ async function handleStoryboardRun(args) {
     ...(fileComplianceOptions.adcpVersion && { adcpVersion: fileComplianceOptions.adcpVersion }),
     ...(fileComplianceOptions.schemaRoot && { schemaRoot: fileComplianceOptions.schemaRoot }),
     ...(!opts.strictResponseSchemaValidation && { strictResponseSchemaValidation: false }),
-    ...(opts.noSandbox && { sandbox: false, disable_sandbox: true }),
+    ...sandboxRunOptions(opts),
     ...(opts.assertsSeededState && { assertsSeededState: true }),
     ...(opts.mediaBuyLifecycleCompatibility && {
       mediaBuyLifecycleCompatibility: opts.mediaBuyLifecycleCompatibility,
@@ -3755,27 +3762,17 @@ async function handleLocalAgentStoryboardRun(modulePath, args, opts) {
       createAgent,
       storyboards: storyboardsSpec,
       compliance: resolveOptions,
-      ...(opts.complianceVersion ||
-      opts.schemaRoot ||
-      !opts.strictResponseSchemaValidation ||
-      opts.noSandbox ||
-      opts.assertsSeededState ||
-      opts.mediaBuyLifecycleCompatibility ||
-      opts.loadedTestKit !== undefined
-        ? {
-            runStoryboardOptions: {
-              ...(opts.complianceVersion && !opts.complianceDir && { adcpVersion: opts.complianceVersion }),
-              ...(opts.schemaRoot && { schemaRoot: opts.schemaRoot }),
-              ...(!opts.strictResponseSchemaValidation && { strictResponseSchemaValidation: false }),
-              ...(opts.noSandbox && { sandbox: false, disable_sandbox: true }),
-              ...(opts.assertsSeededState && { assertsSeededState: true }),
-              ...(opts.mediaBuyLifecycleCompatibility && {
-                mediaBuyLifecycleCompatibility: opts.mediaBuyLifecycleCompatibility,
-              }),
-              ...(opts.loadedTestKit !== undefined && { test_kit: opts.loadedTestKit }),
-            },
-          }
-        : {}),
+      runStoryboardOptions: {
+        ...sandboxRunOptions(opts),
+        ...(opts.complianceVersion && !opts.complianceDir && { adcpVersion: opts.complianceVersion }),
+        ...(opts.schemaRoot && { schemaRoot: opts.schemaRoot }),
+        ...(!opts.strictResponseSchemaValidation && { strictResponseSchemaValidation: false }),
+        ...(opts.assertsSeededState && { assertsSeededState: true }),
+        ...(opts.mediaBuyLifecycleCompatibility && {
+          mediaBuyLifecycleCompatibility: opts.mediaBuyLifecycleCompatibility,
+        }),
+        ...(opts.loadedTestKit !== undefined && { test_kit: opts.loadedTestKit }),
+      },
       onStoryboardComplete:
         jsonOutput || format === 'junit'
           ? undefined
@@ -4204,7 +4201,7 @@ async function handleMultiInstanceStoryboardRun(args, opts, urls) {
     ...(runAdcpVersion && { adcpVersion: runAdcpVersion }),
     ...(runSchemaRoot && { schemaRoot: runSchemaRoot }),
     ...(!opts.strictResponseSchemaValidation && { strictResponseSchemaValidation: false }),
-    ...(opts.noSandbox && { sandbox: false, disable_sandbox: true }),
+    ...sandboxRunOptions(opts),
     ...(opts.assertsSeededState && { assertsSeededState: true }),
     ...(opts.mediaBuyLifecycleCompatibility && {
       mediaBuyLifecycleCompatibility: opts.mediaBuyLifecycleCompatibility,
@@ -4488,7 +4485,7 @@ async function handleAgentsRoutedStoryboardRun(args, opts, routing) {
     ...(runAdcpVersion && { adcpVersion: runAdcpVersion }),
     ...(runSchemaRoot && { schemaRoot: runSchemaRoot }),
     ...(!opts.strictResponseSchemaValidation && { strictResponseSchemaValidation: false }),
-    ...(opts.noSandbox && { sandbox: false, disable_sandbox: true }),
+    ...sandboxRunOptions(opts),
     ...(opts.assertsSeededState && { assertsSeededState: true }),
     ...(opts.mediaBuyLifecycleCompatibility && {
       mediaBuyLifecycleCompatibility: opts.mediaBuyLifecycleCompatibility,
@@ -4703,7 +4700,7 @@ async function runFullAssessment(agentArg, rawArgs, parsedOpts) {
     ...(authOption && { auth: authOption }),
     ...(opts.allowHttp && { allow_http: true }),
     ...(webhookReceiverOpts ?? {}),
-    ...(opts.noSandbox && { sandbox: false, disable_sandbox: true }),
+    ...sandboxRunOptions(opts),
     ...(opts.assertsSeededState && { assertsSeededState: true }),
     ...(opts.mediaBuyLifecycleCompatibility && {
       mediaBuyLifecycleCompatibility: opts.mediaBuyLifecycleCompatibility,
@@ -4941,6 +4938,7 @@ async function handleStoryboardStepCmd(args) {
     context,
     ...(contributions && { contributions }),
     request,
+    ...sandboxRunOptions(opts),
     ...(complianceVersion && { adcpVersion: complianceVersion }),
     ...(opts.complianceDir && { complianceDir: opts.complianceDir }),
     ...(schemaRoot && { schemaRoot }),

package/dist/lib/schemas/index.d.mts

@@ -39,11 +39,395 @@
  * });
  * ```
  */
-import type { z } from 'zod';
+import { z } from 'zod';
 import * as schemas from '../types/schemas.generated.mjs';
+import type { CanonicalGetProductsRequest } from '../v2/projection/creative-delivery.mjs';
 import type { KnownToolRequestSchemas } from '../utils/tool-request-schemas.mjs';
 import { type ResolvedToolSchemaDocument, type ResponseVariant } from '../validation/schema-loader.mjs';
 export * from '../types/schemas.generated.mjs';
+type LooseObjectSchemaFor<T extends object> = z.ZodObject<{
+    [K in keyof T]-?: undefined extends T[K] ? z.ZodOptional<z.ZodType<Exclude<T[K], undefined>, Exclude<T[K], undefined>>> : z.ZodType<T[K], T[K]>;
+}, z.core.$loose> & z.ZodType<T & Record<string, unknown>, T & Record<string, unknown>>;
+/** Wire-compatible request schema, including the legacy `format_ids` selector. */
+export declare const LegacyGetProductsRequestSchema: z.ZodObject<{
+    adcp_version: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    adcp_major_version: z.ZodOptional<z.ZodType<number, number, z.core.$ZodTypeInternals<number, number>>>;
+    idempotency_key: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    buying_mode: z.ZodType<"brief" | "wholesale" | "refine", "brief" | "wholesale" | "refine", z.core.$ZodTypeInternals<"brief" | "wholesale" | "refine", "brief" | "wholesale" | "refine">>;
+    brief: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    refine: z.ZodOptional<z.ZodType<({
+        scope: "request";
+        ask: string;
+    } | {
+        scope: "product";
+        product_id: string;
+        action?: "include" | "omit" | "more_like_this";
+        ask?: string;
+    } | {
+        scope: "proposal";
+        proposal_id: string;
+        action?: "include" | "omit" | "finalize";
+        ask?: string;
+    })[], ({
+        scope: "request";
+        ask: string;
+    } | {
+        scope: "product";
+        product_id: string;
+        action?: "include" | "omit" | "more_like_this";
+        ask?: string;
+    } | {
+        scope: "proposal";
+        proposal_id: string;
+        action?: "include" | "omit" | "finalize";
+        ask?: string;
+    })[], z.core.$ZodTypeInternals<({
+        scope: "request";
+        ask: string;
+    } | {
+        scope: "product";
+        product_id: string;
+        action?: "include" | "omit" | "more_like_this";
+        ask?: string;
+    } | {
+        scope: "proposal";
+        proposal_id: string;
+        action?: "include" | "omit" | "finalize";
+        ask?: string;
+    })[], ({
+        scope: "request";
+        ask: string;
+    } | {
+        scope: "product";
+        product_id: string;
+        action?: "include" | "omit" | "more_like_this";
+        ask?: string;
+    } | {
+        scope: "proposal";
+        proposal_id: string;
+        action?: "include" | "omit" | "finalize";
+        ask?: string;
+    })[]>>>;
+    brand: z.ZodOptional<z.ZodType<import("../index.mjs").BrandReference, import("../index.mjs").BrandReference, z.core.$ZodTypeInternals<import("../index.mjs").BrandReference, import("../index.mjs").BrandReference>>>;
+    catalog: z.ZodOptional<z.ZodType<import("../index.mjs").Catalog, import("../index.mjs").Catalog, z.core.$ZodTypeInternals<import("../index.mjs").Catalog, import("../index.mjs").Catalog>>>;
+    account: z.ZodOptional<z.ZodType<import("../index.mjs").AccountReference, import("../index.mjs").AccountReference, z.core.$ZodTypeInternals<import("../index.mjs").AccountReference, import("../index.mjs").AccountReference>>>;
+    preferred_delivery_types: z.ZodOptional<z.ZodType<import("../types/core.generated.mjs").DeliveryType[], import("../types/core.generated.mjs").DeliveryType[], z.core.$ZodTypeInternals<import("../types/core.generated.mjs").DeliveryType[], import("../types/core.generated.mjs").DeliveryType[]>>>;
+    filters: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").ProductFilters, import("../types/tools.generated.mjs").ProductFilters, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").ProductFilters, import("../types/tools.generated.mjs").ProductFilters>>>;
+    targeting_overlay: z.ZodOptional<z.ZodType<{
+        geo_countries?: [string, ...string[]];
+        geo_countries_exclude?: [string, ...string[]];
+        geo_regions?: [string, ...string[]];
+        geo_regions_exclude?: [string, ...string[]];
+        geo_metros?: [{
+            system: import("../types/core.generated.mjs").MetroAreaSystem;
+            values: [string, ...string[]];
+        }, ...{
+            system: import("../types/core.generated.mjs").MetroAreaSystem;
+            values: [string, ...string[]];
+        }[]];
+        geo_metros_exclude?: [{
+            system: import("../types/core.generated.mjs").MetroAreaSystem;
+            values: [string, ...string[]];
+        }, ...{
+            system: import("../types/core.generated.mjs").MetroAreaSystem;
+            values: [string, ...string[]];
+        }[]];
+        geo_postal_areas?: [import("../types/tools.generated.mjs").PostalArea, ...import("../types/tools.generated.mjs").PostalArea[]];
+        geo_postal_areas_exclude?: [import("../types/tools.generated.mjs").PostalArea, ...import("../types/tools.generated.mjs").PostalArea[]];
+        geo_places?: [import("../types/tools.generated.mjs").GeographicPlaceArea, ...import("../types/tools.generated.mjs").GeographicPlaceArea[]];
+        geo_places_exclude?: [import("../types/tools.generated.mjs").GeographicPlaceArea, ...import("../types/tools.generated.mjs").GeographicPlaceArea[]];
+        daypart_targets?: [import("../types/tools.generated.mjs").DaypartTarget, ...import("../types/tools.generated.mjs").DaypartTarget[]];
+        axe_include_segment?: string;
+        axe_exclude_segment?: string;
+        audience_include?: [string, ...string[]];
+        audience_exclude?: [string, ...string[]];
+        signal_targeting_groups?: import("../types/tools.generated.mjs").PackageSignalTargetingGroups;
+        signal_targeting?: [import("../index.mjs").SignalTargeting, ...import("../index.mjs").SignalTargeting[]];
+        demographics?: import("../types/tools.generated.mjs").DemographicTargetingIntent;
+        frequency_cap?: import("../index.mjs").FrequencyCap;
+        property_list?: import("../types/tools.generated.mjs").PropertyListReference;
+        property_list_exclude?: import("../types/tools.generated.mjs").PropertyListReference;
+        collection_list?: import("../types/tools.generated.mjs").CollectionListReference;
+        collection_list_exclude?: import("../types/tools.generated.mjs").CollectionListReference;
+        placement_selection?: import("../types/tools.generated.mjs").PlacementSelection;
+        age_restriction?: {
+            min: number;
+            verification_required?: boolean;
+            accepted_methods?: [import("../types/core.generated.mjs").AgeVerificationMethod, ...import("../types/core.generated.mjs").AgeVerificationMethod[]];
+        };
+        device_platform?: [import("../types/core.generated.mjs").DevicePlatform, ...import("../types/core.generated.mjs").DevicePlatform[]];
+        device_platform_exclude?: [import("../types/core.generated.mjs").DevicePlatform, ...import("../types/core.generated.mjs").DevicePlatform[]];
+        device_type?: [import("../index.mjs").DeviceType, ...import("../index.mjs").DeviceType[]];
+        device_type_exclude?: [import("../index.mjs").DeviceType, ...import("../index.mjs").DeviceType[]];
+        browser?: [import("../types/core.generated.mjs").BrowserFamily, ...import("../types/core.generated.mjs").BrowserFamily[]];
+        browser_exclude?: [import("../types/core.generated.mjs").BrowserFamily, ...import("../types/core.generated.mjs").BrowserFamily[]];
+        store_catchments?: [{
+            catalog_id: string;
+            store_ids?: [string, ...string[]];
+            catchment_ids?: [string, ...string[]];
+        }, ...{
+            catalog_id: string;
+            store_ids?: [string, ...string[]];
+            catchment_ids?: [string, ...string[]];
+        }[]];
+        geo_proximity?: [({} | {} | {}), ...({} | {} | {})[]];
+        language?: [import("../types/tools.generated.mjs").LanguageTag, ...import("../types/tools.generated.mjs").LanguageTag[]];
+        keyword_targets?: [{
+            keyword: string;
+            match_type: import("../types/core.generated.mjs").MatchType;
+            bid_price?: number;
+        }, ...{
+            keyword: string;
+            match_type: import("../types/core.generated.mjs").MatchType;
+            bid_price?: number;
+        }[]];
+        negative_keywords?: [{
+            keyword: string;
+            match_type: import("../types/core.generated.mjs").MatchType;
+        }, ...{
+            keyword: string;
+            match_type: import("../types/core.generated.mjs").MatchType;
+        }[]];
+    }, {
+        geo_countries?: [string, ...string[]];
+        geo_countries_exclude?: [string, ...string[]];
+        geo_regions?: [string, ...string[]];
+        geo_regions_exclude?: [string, ...string[]];
+        geo_metros?: [{
+            system: import("../types/core.generated.mjs").MetroAreaSystem;
+            values: [string, ...string[]];
+        }, ...{
+            system: import("../types/core.generated.mjs").MetroAreaSystem;
+            values: [string, ...string[]];
+        }[]];
+        geo_metros_exclude?: [{
+            system: import("../types/core.generated.mjs").MetroAreaSystem;
+            values: [string, ...string[]];
+        }, ...{
+            system: import("../types/core.generated.mjs").MetroAreaSystem;
+            values: [string, ...string[]];
+        }[]];
+        geo_postal_areas?: [import("../types/tools.generated.mjs").PostalArea, ...import("../types/tools.generated.mjs").PostalArea[]];
+        geo_postal_areas_exclude?: [import("../types/tools.generated.mjs").PostalArea, ...import("../types/tools.generated.mjs").PostalArea[]];
+        geo_places?: [import("../types/tools.generated.mjs").GeographicPlaceArea, ...import("../types/tools.generated.mjs").GeographicPlaceArea[]];
+        geo_places_exclude?: [import("../types/tools.generated.mjs").GeographicPlaceArea, ...import("../types/tools.generated.mjs").GeographicPlaceArea[]];
+        daypart_targets?: [import("../types/tools.generated.mjs").DaypartTarget, ...import("../types/tools.generated.mjs").DaypartTarget[]];
+        axe_include_segment?: string;
+        axe_exclude_segment?: string;
+        audience_include?: [string, ...string[]];
+        audience_exclude?: [string, ...string[]];
+        signal_targeting_groups?: import("../types/tools.generated.mjs").PackageSignalTargetingGroups;
+        signal_targeting?: [import("../index.mjs").SignalTargeting, ...import("../index.mjs").SignalTargeting[]];
+        demographics?: import("../types/tools.generated.mjs").DemographicTargetingIntent;
+        frequency_cap?: import("../index.mjs").FrequencyCap;
+        property_list?: import("../types/tools.generated.mjs").PropertyListReference;
+        property_list_exclude?: import("../types/tools.generated.mjs").PropertyListReference;
+        collection_list?: import("../types/tools.generated.mjs").CollectionListReference;
+        collection_list_exclude?: import("../types/tools.generated.mjs").CollectionListReference;
+        placement_selection?: import("../types/tools.generated.mjs").PlacementSelection;
+        age_restriction?: {
+            min: number;
+            verification_required?: boolean;
+            accepted_methods?: [import("../types/core.generated.mjs").AgeVerificationMethod, ...import("../types/core.generated.mjs").AgeVerificationMethod[]];
+        };
+        device_platform?: [import("../types/core.generated.mjs").DevicePlatform, ...import("../types/core.generated.mjs").DevicePlatform[]];
+        device_platform_exclude?: [import("../types/core.generated.mjs").DevicePlatform, ...import("../types/core.generated.mjs").DevicePlatform[]];
+        device_type?: [import("../index.mjs").DeviceType, ...import("../index.mjs").DeviceType[]];
+        device_type_exclude?: [import("../index.mjs").DeviceType, ...import("../index.mjs").DeviceType[]];
+        browser?: [import("../types/core.generated.mjs").BrowserFamily, ...import("../types/core.generated.mjs").BrowserFamily[]];
+        browser_exclude?: [import("../types/core.generated.mjs").BrowserFamily, ...import("../types/core.generated.mjs").BrowserFamily[]];
+        store_catchments?: [{
+            catalog_id: string;
+            store_ids?: [string, ...string[]];
+            catchment_ids?: [string, ...string[]];
+        }, ...{
+            catalog_id: string;
+            store_ids?: [string, ...string[]];
+            catchment_ids?: [string, ...string[]];
+        }[]];
+        geo_proximity?: [({} | {} | {}), ...({} | {} | {})[]];
+        language?: [import("../types/tools.generated.mjs").LanguageTag, ...import("../types/tools.generated.mjs").LanguageTag[]];
+        keyword_targets?: [{
+            keyword: string;
+            match_type: import("../types/core.generated.mjs").MatchType;
+            bid_price?: number;
+        }, ...{
+            keyword: string;
+            match_type: import("../types/core.generated.mjs").MatchType;
+            bid_price?: number;
+        }[]];
+        negative_keywords?: [{
+            keyword: string;
+            match_type: import("../types/core.generated.mjs").MatchType;
+        }, ...{
+            keyword: string;
+            match_type: import("../types/core.generated.mjs").MatchType;
+        }[]];
+    }, z.core.$ZodTypeInternals<{
+        geo_countries?: [string, ...string[]];
+        geo_countries_exclude?: [string, ...string[]];
+        geo_regions?: [string, ...string[]];
+        geo_regions_exclude?: [string, ...string[]];
+        geo_metros?: [{
+            system: import("../types/core.generated.mjs").MetroAreaSystem;
+            values: [string, ...string[]];
+        }, ...{
+            system: import("../types/core.generated.mjs").MetroAreaSystem;
+            values: [string, ...string[]];
+        }[]];
+        geo_metros_exclude?: [{
+            system: import("../types/core.generated.mjs").MetroAreaSystem;
+            values: [string, ...string[]];
+        }, ...{
+            system: import("../types/core.generated.mjs").MetroAreaSystem;
+            values: [string, ...string[]];
+        }[]];
+        geo_postal_areas?: [import("../types/tools.generated.mjs").PostalArea, ...import("../types/tools.generated.mjs").PostalArea[]];
+        geo_postal_areas_exclude?: [import("../types/tools.generated.mjs").PostalArea, ...import("../types/tools.generated.mjs").PostalArea[]];
+        geo_places?: [import("../types/tools.generated.mjs").GeographicPlaceArea, ...import("../types/tools.generated.mjs").GeographicPlaceArea[]];
+        geo_places_exclude?: [import("../types/tools.generated.mjs").GeographicPlaceArea, ...import("../types/tools.generated.mjs").GeographicPlaceArea[]];
+        daypart_targets?: [import("../types/tools.generated.mjs").DaypartTarget, ...import("../types/tools.generated.mjs").DaypartTarget[]];
+        axe_include_segment?: string;
+        axe_exclude_segment?: string;
+        audience_include?: [string, ...string[]];
+        audience_exclude?: [string, ...string[]];
+        signal_targeting_groups?: import("../types/tools.generated.mjs").PackageSignalTargetingGroups;
+        signal_targeting?: [import("../index.mjs").SignalTargeting, ...import("../index.mjs").SignalTargeting[]];
+        demographics?: import("../types/tools.generated.mjs").DemographicTargetingIntent;
+        frequency_cap?: import("../index.mjs").FrequencyCap;
+        property_list?: import("../types/tools.generated.mjs").PropertyListReference;
+        property_list_exclude?: import("../types/tools.generated.mjs").PropertyListReference;
+        collection_list?: import("../types/tools.generated.mjs").CollectionListReference;
+        collection_list_exclude?: import("../types/tools.generated.mjs").CollectionListReference;
+        placement_selection?: import("../types/tools.generated.mjs").PlacementSelection;
+        age_restriction?: {
+            min: number;
+            verification_required?: boolean;
+            accepted_methods?: [import("../types/core.generated.mjs").AgeVerificationMethod, ...import("../types/core.generated.mjs").AgeVerificationMethod[]];
+        };
+        device_platform?: [import("../types/core.generated.mjs").DevicePlatform, ...import("../types/core.generated.mjs").DevicePlatform[]];
+        device_platform_exclude?: [import("../types/core.generated.mjs").DevicePlatform, ...import("../types/core.generated.mjs").DevicePlatform[]];
+        device_type?: [import("../index.mjs").DeviceType, ...import("../index.mjs").DeviceType[]];
+        device_type_exclude?: [import("../index.mjs").DeviceType, ...import("../index.mjs").DeviceType[]];
+        browser?: [import("../types/core.generated.mjs").BrowserFamily, ...import("../types/core.generated.mjs").BrowserFamily[]];
+        browser_exclude?: [import("../types/core.generated.mjs").BrowserFamily, ...import("../types/core.generated.mjs").BrowserFamily[]];
+        store_catchments?: [{
+            catalog_id: string;
+            store_ids?: [string, ...string[]];
+            catchment_ids?: [string, ...string[]];
+        }, ...{
+            catalog_id: string;
+            store_ids?: [string, ...string[]];
+            catchment_ids?: [string, ...string[]];
+        }[]];
+        geo_proximity?: [({} | {} | {}), ...({} | {} | {})[]];
+        language?: [import("../types/tools.generated.mjs").LanguageTag, ...import("../types/tools.generated.mjs").LanguageTag[]];
+        keyword_targets?: [{
+            keyword: string;
+            match_type: import("../types/core.generated.mjs").MatchType;
+            bid_price?: number;
+        }, ...{
+            keyword: string;
+            match_type: import("../types/core.generated.mjs").MatchType;
+            bid_price?: number;
+        }[]];
+        negative_keywords?: [{
+            keyword: string;
+            match_type: import("../types/core.generated.mjs").MatchType;
+        }, ...{
+            keyword: string;
+            match_type: import("../types/core.generated.mjs").MatchType;
+        }[]];
+    }, {
+        geo_countries?: [string, ...string[]];
+        geo_countries_exclude?: [string, ...string[]];
+        geo_regions?: [string, ...string[]];
+        geo_regions_exclude?: [string, ...string[]];
+        geo_metros?: [{
+            system: import("../types/core.generated.mjs").MetroAreaSystem;
+            values: [string, ...string[]];
+        }, ...{
+            system: import("../types/core.generated.mjs").MetroAreaSystem;
+            values: [string, ...string[]];
+        }[]];
+        geo_metros_exclude?: [{
+            system: import("../types/core.generated.mjs").MetroAreaSystem;
+            values: [string, ...string[]];
+        }, ...{
+            system: import("../types/core.generated.mjs").MetroAreaSystem;
+            values: [string, ...string[]];
+        }[]];
+        geo_postal_areas?: [import("../types/tools.generated.mjs").PostalArea, ...import("../types/tools.generated.mjs").PostalArea[]];
+        geo_postal_areas_exclude?: [import("../types/tools.generated.mjs").PostalArea, ...import("../types/tools.generated.mjs").PostalArea[]];
+        geo_places?: [import("../types/tools.generated.mjs").GeographicPlaceArea, ...import("../types/tools.generated.mjs").GeographicPlaceArea[]];
+        geo_places_exclude?: [import("../types/tools.generated.mjs").GeographicPlaceArea, ...import("../types/tools.generated.mjs").GeographicPlaceArea[]];
+        daypart_targets?: [import("../types/tools.generated.mjs").DaypartTarget, ...import("../types/tools.generated.mjs").DaypartTarget[]];
+        axe_include_segment?: string;
+        axe_exclude_segment?: string;
+        audience_include?: [string, ...string[]];
+        audience_exclude?: [string, ...string[]];
+        signal_targeting_groups?: import("../types/tools.generated.mjs").PackageSignalTargetingGroups;
+        signal_targeting?: [import("../index.mjs").SignalTargeting, ...import("../index.mjs").SignalTargeting[]];
+        demographics?: import("../types/tools.generated.mjs").DemographicTargetingIntent;
+        frequency_cap?: import("../index.mjs").FrequencyCap;
+        property_list?: import("../types/tools.generated.mjs").PropertyListReference;
+        property_list_exclude?: import("../types/tools.generated.mjs").PropertyListReference;
+        collection_list?: import("../types/tools.generated.mjs").CollectionListReference;
+        collection_list_exclude?: import("../types/tools.generated.mjs").CollectionListReference;
+        placement_selection?: import("../types/tools.generated.mjs").PlacementSelection;
+        age_restriction?: {
+            min: number;
+            verification_required?: boolean;
+            accepted_methods?: [import("../types/core.generated.mjs").AgeVerificationMethod, ...import("../types/core.generated.mjs").AgeVerificationMethod[]];
+        };
+        device_platform?: [import("../types/core.generated.mjs").DevicePlatform, ...import("../types/core.generated.mjs").DevicePlatform[]];
+        device_platform_exclude?: [import("../types/core.generated.mjs").DevicePlatform, ...import("../types/core.generated.mjs").DevicePlatform[]];
+        device_type?: [import("../index.mjs").DeviceType, ...import("../index.mjs").DeviceType[]];
+        device_type_exclude?: [import("../index.mjs").DeviceType, ...import("../index.mjs").DeviceType[]];
+        browser?: [import("../types/core.generated.mjs").BrowserFamily, ...import("../types/core.generated.mjs").BrowserFamily[]];
+        browser_exclude?: [import("../types/core.generated.mjs").BrowserFamily, ...import("../types/core.generated.mjs").BrowserFamily[]];
+        store_catchments?: [{
+            catalog_id: string;
+            store_ids?: [string, ...string[]];
+            catchment_ids?: [string, ...string[]];
+        }, ...{
+            catalog_id: string;
+            store_ids?: [string, ...string[]];
+            catchment_ids?: [string, ...string[]];
+        }[]];
+        geo_proximity?: [({} | {} | {}), ...({} | {} | {})[]];
+        language?: [import("../types/tools.generated.mjs").LanguageTag, ...import("../types/tools.generated.mjs").LanguageTag[]];
+        keyword_targets?: [{
+            keyword: string;
+            match_type: import("../types/core.generated.mjs").MatchType;
+            bid_price?: number;
+        }, ...{
+            keyword: string;
+            match_type: import("../types/core.generated.mjs").MatchType;
+            bid_price?: number;
+        }[]];
+        negative_keywords?: [{
+            keyword: string;
+            match_type: import("../types/core.generated.mjs").MatchType;
+        }, ...{
+            keyword: string;
+            match_type: import("../types/core.generated.mjs").MatchType;
+        }[]];
+    }>>>;
+    required_overlay_support: z.ZodOptional<z.ZodType<import("../types/core.generated.mjs").TargetingOverlayRequirements, import("../types/core.generated.mjs").TargetingOverlayRequirements, z.core.$ZodTypeInternals<import("../types/core.generated.mjs").TargetingOverlayRequirements, import("../types/core.generated.mjs").TargetingOverlayRequirements>>>;
+    property_list: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").PropertyListReference, import("../types/tools.generated.mjs").PropertyListReference, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").PropertyListReference, import("../types/tools.generated.mjs").PropertyListReference>>>;
+    fields: z.ZodOptional<z.ZodType<("name" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "brief_relevance" | "expires_at" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "overlay_support" | "targeting_resolution" | "collections" | "collection_targeting_allowed" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], ("name" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "brief_relevance" | "expires_at" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "overlay_support" | "targeting_resolution" | "collections" | "collection_targeting_allowed" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], z.core.$ZodTypeInternals<("name" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "brief_relevance" | "expires_at" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "overlay_support" | "targeting_resolution" | "collections" | "collection_targeting_allowed" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[], ("name" | "forecast" | "description" | "publisher_properties" | "audience_evidence" | "product_id" | "channels" | "video_placement_types" | "audio_distribution_types" | "sponsored_placement_types" | "social_placement_surfaces" | "format_options" | "placements" | "delivery_type" | "exclusivity" | "pricing_options" | "reporting_capabilities" | "catalog_types" | "signal_targeting_allowed" | "signal_targeting_rules" | "demographic_targeting" | "audience_evidence_selections" | "max_optimization_goals" | "catalog_match" | "brief_relevance" | "expires_at" | "product_card" | "format_ids" | "outcome_measurement" | "delivery_measurement" | "creative_policy" | "metric_optimization" | "conversion_tracking" | "data_provider_signals" | "included_signals" | "signal_targeting_options" | "overlay_support" | "targeting_resolution" | "collections" | "collection_targeting_allowed" | "installments" | "is_custom" | "product_card_detailed" | "enforced_policies" | "trusted_match")[]>>>;
+    time_budget: z.ZodOptional<z.ZodType<import("../index.mjs").Duration, import("../index.mjs").Duration, z.core.$ZodTypeInternals<import("../index.mjs").Duration, import("../index.mjs").Duration>>>;
+    push_notification_config: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").PushNotificationConfig, import("../types/tools.generated.mjs").PushNotificationConfig, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").PushNotificationConfig, import("../types/tools.generated.mjs").PushNotificationConfig>>>;
+    pagination: z.ZodOptional<z.ZodType<import("../index.mjs").PaginationRequest, import("../index.mjs").PaginationRequest, z.core.$ZodTypeInternals<import("../index.mjs").PaginationRequest, import("../index.mjs").PaginationRequest>>>;
+    if_wholesale_feed_version: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    if_pricing_version: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
+    context: z.ZodOptional<z.ZodType<import("../types/tools.generated.mjs").ContextObject, import("../types/tools.generated.mjs").ContextObject, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").ContextObject, import("../types/tools.generated.mjs").ContextObject>>>;
+    required_policies: z.ZodOptional<z.ZodType<string[], string[], z.core.$ZodTypeInternals<string[], string[]>>>;
+    ext: z.ZodOptional<z.ZodType<import("../index.mjs").ExtensionObject, import("../index.mjs").ExtensionObject, z.core.$ZodTypeInternals<import("../index.mjs").ExtensionObject, import("../index.mjs").ExtensionObject>>>;
+}, z.core.$loose> & z.ZodType<import("../index.mjs").LegacyGetProductsRequest & Record<string, unknown>, import("../index.mjs").LegacyGetProductsRequest & Record<string, unknown>, z.core.$ZodTypeInternals<import("../index.mjs").LegacyGetProductsRequest & Record<string, unknown>, import("../index.mjs").LegacyGetProductsRequest & Record<string, unknown>>>;
+/** Primary request schema; legacy `format_ids` selection is rejected. */
+export declare const GetProductsRequestSchema: LooseObjectSchemaFor<CanonicalGetProductsRequest>;
 export { BiddingPolicySchema } from '../validation/bidding-policy.mjs';
 export { CanonicalBudgetAllocationSchema } from '../validation/budget-allocation.mjs';
 export { TOOL_REQUEST_SCHEMAS } from '../utils/tool-request-schemas.mjs';