@adcp/sdk 12.1.0 → 13.0.0-rc.0

package/dist/lib/utils/format-assets.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/utils/format-assets.ts"],"sourcesContent":["// Format Asset Utilities\n// Provides access to format assets from the v3 `assets` field\n\nimport type { Format } from '../types/tools.generated';\n\n// Internal types - derived from Format['assets'] since schema doesn't export standalone types\ntype FormatAsset = NonNullable<Format['assets']>[number];\ntype IndividualAsset = Extract<FormatAsset, { item_type: 'individual' }>;\ntype RepeatableAssetGroup = Extract<FormatAsset, { item_type: 'repeatable_group' }>;\n\n// Legacy support: v2 responses may still include assets_required (deprecated in v3)\n// This internal type allows runtime backward compatibility without exposing it in public API\ninterface LegacyFormat extends Format {\n  assets_required?: unknown[];\n}\n\n/**\n * Get assets from a Format\n *\n * Returns the assets from the v3 `assets` field. For backward compatibility with v2 servers,\n * this function also handles the deprecated `assets_required` field if present.\n *\n * @param format - The Format object from list_creative_formats response\n * @returns Array of assets\n *\n * @example\n * ```typescript\n * const formats = await agent.listCreativeFormats({});\n * for (const format of formats.formats) {\n *   const assets = getFormatAssets(format);\n *   console.log(`${format.name} has ${assets.length} assets`);\n * }\n * ```\n */\nexport function getFormatAssets(format: Format): FormatAsset[] {\n  // Use v3 `assets` field\n  if (format.assets && format.assets.length > 0) {\n    return format.assets;\n  }\n\n  // Runtime backward compatibility: handle v2 responses with deprecated assets_required\n  const legacyFormat = format as LegacyFormat;\n  if (\n    legacyFormat.assets_required &&\n    Array.isArray(legacyFormat.assets_required) &&\n    legacyFormat.assets_required.length > 0\n  ) {\n    return normalizeAssetsRequired(legacyFormat.assets_required);\n  }\n\n  return [];\n}\n\n/**\n * Convert deprecated assets_required to new assets format (internal use)\n *\n * All assets in assets_required are required by definition (that's why they were in that array).\n * The new `assets` field has an explicit `required: boolean` to allow both required AND optional assets.\n *\n * @param assetsRequired - The deprecated assets_required array\n * @returns Normalized assets array with explicit required: true\n * @internal\n */\nfunction normalizeAssetsRequired(assetsRequired: unknown[]): FormatAsset[] {\n  return assetsRequired.map(asset => ({\n    ...(asset as Record<string, unknown>),\n    required: true, // assets_required only contained required assets\n  })) as FormatAsset[];\n}\n\n/**\n * Get only required assets from a Format\n *\n * @param format - The Format object\n * @returns Array of required assets only\n *\n * @example\n * ```typescript\n * const requiredAssets = getRequiredAssets(format);\n * console.log(`Must provide ${requiredAssets.length} assets`);\n * ```\n */\nexport function getRequiredAssets(format: Format): FormatAsset[] {\n  return getFormatAssets(format).filter(asset => asset.required);\n}\n\n/**\n * Get only optional assets from a Format\n *\n * Note: When using deprecated `assets_required`, this will always return empty\n * since assets_required only contained required assets.\n *\n * @param format - The Format object\n * @returns Array of optional assets only\n *\n * @example\n * ```typescript\n * const optionalAssets = getOptionalAssets(format);\n * console.log(`Can optionally provide ${optionalAssets.length} additional assets`);\n * ```\n */\nexport function getOptionalAssets(format: Format): FormatAsset[] {\n  return getFormatAssets(format).filter(asset => !asset.required);\n}\n\n/**\n * Get individual assets (not repeatable groups) from a Format\n *\n * @param format - The Format object\n * @returns Array of individual assets\n */\nexport function getIndividualAssets(format: Format): IndividualAsset[] {\n  return getFormatAssets(format).filter((asset): asset is IndividualAsset => asset.item_type === 'individual');\n}\n\n/**\n * Get repeatable asset groups from a Format\n *\n * @param format - The Format object\n * @returns Array of repeatable asset groups\n */\nexport function getRepeatableGroups(format: Format): RepeatableAssetGroup[] {\n  return getFormatAssets(format).filter(\n    (asset): asset is RepeatableAssetGroup => asset.item_type === 'repeatable_group'\n  );\n}\n\n/**\n * Check if format uses deprecated assets_required field (for migration warnings)\n *\n * @param format - The Format object\n * @returns true if using deprecated field, false if using new field or neither\n *\n * @example\n * ```typescript\n * if (usesDeprecatedAssetsField(format)) {\n *   console.warn(`Format ${format.name} uses deprecated assets_required field`);\n * }\n * ```\n */\nexport function usesDeprecatedAssetsField(format: Format): boolean {\n  const legacyFormat = format as LegacyFormat;\n  return !format.assets && !!(legacyFormat.assets_required && Array.isArray(legacyFormat.assets_required));\n}\n\n/**\n * Get the count of assets in a format (for display purposes)\n *\n * @param format - The Format object\n * @returns Number of assets, or 0 if none defined\n */\nexport function getAssetCount(format: Format): number {\n  return getFormatAssets(format).length;\n}\n\n/**\n * Check if a format has any assets defined\n *\n * @param format - The Format object\n * @returns true if format has assets, false otherwise\n */\nexport function hasAssets(format: Format): boolean {\n  return getAssetCount(format) > 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAkCO,SAAS,gBAAgB,QAA+B;AAE7D,MAAI,OAAO,UAAU,OAAO,OAAO,SAAS,GAAG;AAC7C,WAAO,OAAO;AAAA,EAChB;AAGA,QAAM,eAAe;AACrB,MACE,aAAa,mBACb,MAAM,QAAQ,aAAa,eAAe,KAC1C,aAAa,gBAAgB,SAAS,GACtC;AACA,WAAO,wBAAwB,aAAa,eAAe;AAAA,EAC7D;AAEA,SAAO,CAAC;AACV;AAYA,SAAS,wBAAwB,gBAA0C;AACzE,SAAO,eAAe,IAAI,YAAU;AAAA,IAClC,GAAI;AAAA,IACJ,UAAU;AAAA;AAAA,EACZ,EAAE;AACJ;AAcO,SAAS,kBAAkB,QAA+B;AAC/D,SAAO,gBAAgB,MAAM,EAAE,OAAO,WAAS,MAAM,QAAQ;AAC/D;AAiBO,SAAS,kBAAkB,QAA+B;AAC/D,SAAO,gBAAgB,MAAM,EAAE,OAAO,WAAS,CAAC,MAAM,QAAQ;AAChE;AAQO,SAAS,oBAAoB,QAAmC;AACrE,SAAO,gBAAgB,MAAM,EAAE,OAAO,CAAC,UAAoC,MAAM,cAAc,YAAY;AAC7G;AAQO,SAAS,oBAAoB,QAAwC;AAC1E,SAAO,gBAAgB,MAAM,EAAE;AAAA,IAC7B,CAAC,UAAyC,MAAM,cAAc;AAAA,EAChE;AACF;AAeO,SAAS,0BAA0B,QAAyB;AACjE,QAAM,eAAe;AACrB,SAAO,CAAC,OAAO,UAAU,CAAC,EAAE,aAAa,mBAAmB,MAAM,QAAQ,aAAa,eAAe;AACxG;AAQO,SAAS,cAAc,QAAwB;AACpD,SAAO,gBAAgB,MAAM,EAAE;AACjC;AAQO,SAAS,UAAU,QAAyB;AACjD,SAAO,cAAc,MAAM,IAAI;AACjC;","names":[]}
+{"version":3,"sources":["../../../src/lib/utils/format-assets.ts"],"sourcesContent":["// Format Asset Utilities\n// Provides access to asset-slot declarations without requiring a raw\n// list_creative_formats `Format` or its legacy format identity.\n\nimport type {\n  IndividualAudioAsset,\n  IndividualBriefAsset,\n  IndividualCatalogAsset,\n  IndividualCssAsset,\n  IndividualDaastAsset,\n  IndividualHtmlAsset,\n  IndividualImageAsset,\n  IndividualJavaScriptAsset,\n  IndividualMarkdownAsset,\n  IndividualTextAsset,\n  IndividualUrlAsset,\n  IndividualVastAsset,\n  IndividualVideoAsset,\n  IndividualWebhookAsset,\n  RepeatableGroupAsset,\n} from '../types/tools.generated';\n\n/** Canonical structural union for the slots declared in an `assets` array. */\nexport type CanonicalFormatAssetSlot =\n  | IndividualAudioAsset\n  | IndividualBriefAsset\n  | IndividualCatalogAsset\n  | IndividualCssAsset\n  | IndividualDaastAsset\n  | IndividualHtmlAsset\n  | IndividualImageAsset\n  | IndividualJavaScriptAsset\n  | IndividualMarkdownAsset\n  | IndividualTextAsset\n  | IndividualUrlAsset\n  | IndividualVastAsset\n  | IndividualVideoAsset\n  | IndividualWebhookAsset\n  | RepeatableGroupAsset;\n\nexport type IndividualFormatAssetSlot = Exclude<CanonicalFormatAssetSlot, RepeatableGroupAsset>;\nexport type RepeatableFormatAssetGroup = RepeatableGroupAsset;\n\n/**\n * Minimal structural input for asset inspection. It deliberately has no\n * `format_id`, `agent_url`, name, or other legacy catalog identity.\n */\nexport interface FormatAssetsInput {\n  assets?: CanonicalFormatAssetSlot[];\n  /** Deprecated v2 compatibility field; values are normalized as required slots. */\n  assets_required?: unknown[];\n}\n\n// Legacy support: v2 responses may still include assets_required (deprecated in v3)\n// This internal type allows runtime backward compatibility without exposing it in public API\ntype LegacyFormatAssetsInput = FormatAssetsInput;\n\n/**\n * Get asset slots from any structural asset container.\n *\n * Returns the assets from the v3 `assets` field. For backward compatibility with v2 servers,\n * this function also handles the deprecated `assets_required` field if present.\n *\n * @param format - An object containing canonical `assets` slots\n * @returns Array of assets\n *\n * @example\n * ```typescript\n * const assets = getFormatAssets({\n *   assets: [FormatAsset.image({ asset_id: 'hero', required: true })]\n * });\n * ```\n */\nexport function getFormatAssets(format: FormatAssetsInput): CanonicalFormatAssetSlot[] {\n  // Use v3 `assets` field\n  if (format.assets && format.assets.length > 0) {\n    return format.assets;\n  }\n\n  // Runtime backward compatibility: handle v2 responses with deprecated assets_required\n  const legacyFormat = format as LegacyFormatAssetsInput;\n  if (\n    legacyFormat.assets_required &&\n    Array.isArray(legacyFormat.assets_required) &&\n    legacyFormat.assets_required.length > 0\n  ) {\n    return normalizeAssetsRequired(legacyFormat.assets_required);\n  }\n\n  return [];\n}\n\n/**\n * Convert deprecated assets_required to new assets format (internal use)\n *\n * All assets in assets_required are required by definition (that's why they were in that array).\n * The new `assets` field has an explicit `required: boolean` to allow both required AND optional assets.\n *\n * @param assetsRequired - The deprecated assets_required array\n * @returns Normalized assets array with explicit required: true\n * @internal\n */\nfunction normalizeAssetsRequired(assetsRequired: unknown[]): CanonicalFormatAssetSlot[] {\n  return assetsRequired.map(asset => ({\n    ...(asset as Record<string, unknown>),\n    required: true, // assets_required only contained required assets\n  })) as CanonicalFormatAssetSlot[];\n}\n\n/**\n * Get only required slots from an asset container.\n *\n * @param format - A structural asset container\n * @returns Array of required assets only\n *\n * @example\n * ```typescript\n * const requiredAssets = getRequiredAssets(format);\n * console.log(`Must provide ${requiredAssets.length} assets`);\n * ```\n */\nexport function getRequiredAssets(format: FormatAssetsInput): CanonicalFormatAssetSlot[] {\n  return getFormatAssets(format).filter(asset => asset.required);\n}\n\n/**\n * Get only optional slots from an asset container.\n *\n * Note: When using deprecated `assets_required`, this will always return empty\n * since assets_required only contained required assets.\n *\n * @param format - A structural asset container\n * @returns Array of optional assets only\n *\n * @example\n * ```typescript\n * const optionalAssets = getOptionalAssets(format);\n * console.log(`Can optionally provide ${optionalAssets.length} additional assets`);\n * ```\n */\nexport function getOptionalAssets(format: FormatAssetsInput): CanonicalFormatAssetSlot[] {\n  return getFormatAssets(format).filter(asset => !asset.required);\n}\n\n/**\n * Get individual slots (not repeatable groups) from an asset container.\n *\n * @param format - A structural asset container\n * @returns Array of individual assets\n */\nexport function getIndividualAssets(format: FormatAssetsInput): IndividualFormatAssetSlot[] {\n  return getFormatAssets(format).filter(\n    (asset): asset is IndividualFormatAssetSlot => asset.item_type === 'individual'\n  );\n}\n\n/**\n * Get repeatable asset groups from an asset container.\n *\n * @param format - A structural asset container\n * @returns Array of repeatable asset groups\n */\nexport function getRepeatableGroups(format: FormatAssetsInput): RepeatableFormatAssetGroup[] {\n  return getFormatAssets(format).filter(\n    (asset): asset is RepeatableFormatAssetGroup => asset.item_type === 'repeatable_group'\n  );\n}\n\n/**\n * Check if format uses deprecated assets_required field (for migration warnings)\n *\n * @param format - A structural asset container\n * @returns true if using deprecated field, false if using new field or neither\n *\n * @example\n * ```typescript\n * if (usesDeprecatedAssetsField(format)) {\n *   console.warn('Asset container uses deprecated assets_required field');\n * }\n * ```\n */\nexport function usesDeprecatedAssetsField(format: FormatAssetsInput): boolean {\n  const legacyFormat = format as LegacyFormatAssetsInput;\n  return !format.assets && !!(legacyFormat.assets_required && Array.isArray(legacyFormat.assets_required));\n}\n\n/**\n * Get the count of slots in an asset container.\n *\n * @param format - A structural asset container\n * @returns Number of assets, or 0 if none defined\n */\nexport function getAssetCount(format: FormatAssetsInput): number {\n  return getFormatAssets(format).length;\n}\n\n/**\n * Check if an asset container has any slots defined.\n *\n * @param format - A structural asset container\n * @returns true if format has assets, false otherwise\n */\nexport function hasAssets(format: FormatAssetsInput): boolean {\n  return getAssetCount(format) > 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAyEO,SAAS,gBAAgB,QAAuD;AAErF,MAAI,OAAO,UAAU,OAAO,OAAO,SAAS,GAAG;AAC7C,WAAO,OAAO;AAAA,EAChB;AAGA,QAAM,eAAe;AACrB,MACE,aAAa,mBACb,MAAM,QAAQ,aAAa,eAAe,KAC1C,aAAa,gBAAgB,SAAS,GACtC;AACA,WAAO,wBAAwB,aAAa,eAAe;AAAA,EAC7D;AAEA,SAAO,CAAC;AACV;AAYA,SAAS,wBAAwB,gBAAuD;AACtF,SAAO,eAAe,IAAI,YAAU;AAAA,IAClC,GAAI;AAAA,IACJ,UAAU;AAAA;AAAA,EACZ,EAAE;AACJ;AAcO,SAAS,kBAAkB,QAAuD;AACvF,SAAO,gBAAgB,MAAM,EAAE,OAAO,WAAS,MAAM,QAAQ;AAC/D;AAiBO,SAAS,kBAAkB,QAAuD;AACvF,SAAO,gBAAgB,MAAM,EAAE,OAAO,WAAS,CAAC,MAAM,QAAQ;AAChE;AAQO,SAAS,oBAAoB,QAAwD;AAC1F,SAAO,gBAAgB,MAAM,EAAE;AAAA,IAC7B,CAAC,UAA8C,MAAM,cAAc;AAAA,EACrE;AACF;AAQO,SAAS,oBAAoB,QAAyD;AAC3F,SAAO,gBAAgB,MAAM,EAAE;AAAA,IAC7B,CAAC,UAA+C,MAAM,cAAc;AAAA,EACtE;AACF;AAeO,SAAS,0BAA0B,QAAoC;AAC5E,QAAM,eAAe;AACrB,SAAO,CAAC,OAAO,UAAU,CAAC,EAAE,aAAa,mBAAmB,MAAM,QAAQ,aAAa,eAAe;AACxG;AAQO,SAAS,cAAc,QAAmC;AAC/D,SAAO,gBAAgB,MAAM,EAAE;AACjC;AAQO,SAAS,UAAU,QAAoC;AAC5D,SAAO,cAAc,MAAM,IAAI;AACjC;","names":[]}

package/dist/lib/utils/format-assets.mjs

@@ -22,7 +22,9 @@ function getOptionalAssets(format) {
   return getFormatAssets(format).filter((asset) => !asset.required);
 }
 function getIndividualAssets(format) {
-  return getFormatAssets(format).filter((asset) => asset.item_type === "individual");
+  return getFormatAssets(format).filter(
+    (asset) => asset.item_type === "individual"
+  );
 }
 function getRepeatableGroups(format) {
   return getFormatAssets(format).filter(

package/dist/lib/utils/format-assets.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/utils/format-assets.ts"],"sourcesContent":["// Format Asset Utilities\n// Provides access to format assets from the v3 `assets` field\n\nimport type { Format } from '../types/tools.generated';\n\n// Internal types - derived from Format['assets'] since schema doesn't export standalone types\ntype FormatAsset = NonNullable<Format['assets']>[number];\ntype IndividualAsset = Extract<FormatAsset, { item_type: 'individual' }>;\ntype RepeatableAssetGroup = Extract<FormatAsset, { item_type: 'repeatable_group' }>;\n\n// Legacy support: v2 responses may still include assets_required (deprecated in v3)\n// This internal type allows runtime backward compatibility without exposing it in public API\ninterface LegacyFormat extends Format {\n  assets_required?: unknown[];\n}\n\n/**\n * Get assets from a Format\n *\n * Returns the assets from the v3 `assets` field. For backward compatibility with v2 servers,\n * this function also handles the deprecated `assets_required` field if present.\n *\n * @param format - The Format object from list_creative_formats response\n * @returns Array of assets\n *\n * @example\n * ```typescript\n * const formats = await agent.listCreativeFormats({});\n * for (const format of formats.formats) {\n *   const assets = getFormatAssets(format);\n *   console.log(`${format.name} has ${assets.length} assets`);\n * }\n * ```\n */\nexport function getFormatAssets(format: Format): FormatAsset[] {\n  // Use v3 `assets` field\n  if (format.assets && format.assets.length > 0) {\n    return format.assets;\n  }\n\n  // Runtime backward compatibility: handle v2 responses with deprecated assets_required\n  const legacyFormat = format as LegacyFormat;\n  if (\n    legacyFormat.assets_required &&\n    Array.isArray(legacyFormat.assets_required) &&\n    legacyFormat.assets_required.length > 0\n  ) {\n    return normalizeAssetsRequired(legacyFormat.assets_required);\n  }\n\n  return [];\n}\n\n/**\n * Convert deprecated assets_required to new assets format (internal use)\n *\n * All assets in assets_required are required by definition (that's why they were in that array).\n * The new `assets` field has an explicit `required: boolean` to allow both required AND optional assets.\n *\n * @param assetsRequired - The deprecated assets_required array\n * @returns Normalized assets array with explicit required: true\n * @internal\n */\nfunction normalizeAssetsRequired(assetsRequired: unknown[]): FormatAsset[] {\n  return assetsRequired.map(asset => ({\n    ...(asset as Record<string, unknown>),\n    required: true, // assets_required only contained required assets\n  })) as FormatAsset[];\n}\n\n/**\n * Get only required assets from a Format\n *\n * @param format - The Format object\n * @returns Array of required assets only\n *\n * @example\n * ```typescript\n * const requiredAssets = getRequiredAssets(format);\n * console.log(`Must provide ${requiredAssets.length} assets`);\n * ```\n */\nexport function getRequiredAssets(format: Format): FormatAsset[] {\n  return getFormatAssets(format).filter(asset => asset.required);\n}\n\n/**\n * Get only optional assets from a Format\n *\n * Note: When using deprecated `assets_required`, this will always return empty\n * since assets_required only contained required assets.\n *\n * @param format - The Format object\n * @returns Array of optional assets only\n *\n * @example\n * ```typescript\n * const optionalAssets = getOptionalAssets(format);\n * console.log(`Can optionally provide ${optionalAssets.length} additional assets`);\n * ```\n */\nexport function getOptionalAssets(format: Format): FormatAsset[] {\n  return getFormatAssets(format).filter(asset => !asset.required);\n}\n\n/**\n * Get individual assets (not repeatable groups) from a Format\n *\n * @param format - The Format object\n * @returns Array of individual assets\n */\nexport function getIndividualAssets(format: Format): IndividualAsset[] {\n  return getFormatAssets(format).filter((asset): asset is IndividualAsset => asset.item_type === 'individual');\n}\n\n/**\n * Get repeatable asset groups from a Format\n *\n * @param format - The Format object\n * @returns Array of repeatable asset groups\n */\nexport function getRepeatableGroups(format: Format): RepeatableAssetGroup[] {\n  return getFormatAssets(format).filter(\n    (asset): asset is RepeatableAssetGroup => asset.item_type === 'repeatable_group'\n  );\n}\n\n/**\n * Check if format uses deprecated assets_required field (for migration warnings)\n *\n * @param format - The Format object\n * @returns true if using deprecated field, false if using new field or neither\n *\n * @example\n * ```typescript\n * if (usesDeprecatedAssetsField(format)) {\n *   console.warn(`Format ${format.name} uses deprecated assets_required field`);\n * }\n * ```\n */\nexport function usesDeprecatedAssetsField(format: Format): boolean {\n  const legacyFormat = format as LegacyFormat;\n  return !format.assets && !!(legacyFormat.assets_required && Array.isArray(legacyFormat.assets_required));\n}\n\n/**\n * Get the count of assets in a format (for display purposes)\n *\n * @param format - The Format object\n * @returns Number of assets, or 0 if none defined\n */\nexport function getAssetCount(format: Format): number {\n  return getFormatAssets(format).length;\n}\n\n/**\n * Check if a format has any assets defined\n *\n * @param format - The Format object\n * @returns true if format has assets, false otherwise\n */\nexport function hasAssets(format: Format): boolean {\n  return getAssetCount(format) > 0;\n}\n"],"mappings":"AAkCO,SAAS,gBAAgB,QAA+B;AAE7D,MAAI,OAAO,UAAU,OAAO,OAAO,SAAS,GAAG;AAC7C,WAAO,OAAO;AAAA,EAChB;AAGA,QAAM,eAAe;AACrB,MACE,aAAa,mBACb,MAAM,QAAQ,aAAa,eAAe,KAC1C,aAAa,gBAAgB,SAAS,GACtC;AACA,WAAO,wBAAwB,aAAa,eAAe;AAAA,EAC7D;AAEA,SAAO,CAAC;AACV;AAYA,SAAS,wBAAwB,gBAA0C;AACzE,SAAO,eAAe,IAAI,YAAU;AAAA,IAClC,GAAI;AAAA,IACJ,UAAU;AAAA;AAAA,EACZ,EAAE;AACJ;AAcO,SAAS,kBAAkB,QAA+B;AAC/D,SAAO,gBAAgB,MAAM,EAAE,OAAO,WAAS,MAAM,QAAQ;AAC/D;AAiBO,SAAS,kBAAkB,QAA+B;AAC/D,SAAO,gBAAgB,MAAM,EAAE,OAAO,WAAS,CAAC,MAAM,QAAQ;AAChE;AAQO,SAAS,oBAAoB,QAAmC;AACrE,SAAO,gBAAgB,MAAM,EAAE,OAAO,CAAC,UAAoC,MAAM,cAAc,YAAY;AAC7G;AAQO,SAAS,oBAAoB,QAAwC;AAC1E,SAAO,gBAAgB,MAAM,EAAE;AAAA,IAC7B,CAAC,UAAyC,MAAM,cAAc;AAAA,EAChE;AACF;AAeO,SAAS,0BAA0B,QAAyB;AACjE,QAAM,eAAe;AACrB,SAAO,CAAC,OAAO,UAAU,CAAC,EAAE,aAAa,mBAAmB,MAAM,QAAQ,aAAa,eAAe;AACxG;AAQO,SAAS,cAAc,QAAwB;AACpD,SAAO,gBAAgB,MAAM,EAAE;AACjC;AAQO,SAAS,UAAU,QAAyB;AACjD,SAAO,cAAc,MAAM,IAAI;AACjC;","names":[]}
+{"version":3,"sources":["../../../src/lib/utils/format-assets.ts"],"sourcesContent":["// Format Asset Utilities\n// Provides access to asset-slot declarations without requiring a raw\n// list_creative_formats `Format` or its legacy format identity.\n\nimport type {\n  IndividualAudioAsset,\n  IndividualBriefAsset,\n  IndividualCatalogAsset,\n  IndividualCssAsset,\n  IndividualDaastAsset,\n  IndividualHtmlAsset,\n  IndividualImageAsset,\n  IndividualJavaScriptAsset,\n  IndividualMarkdownAsset,\n  IndividualTextAsset,\n  IndividualUrlAsset,\n  IndividualVastAsset,\n  IndividualVideoAsset,\n  IndividualWebhookAsset,\n  RepeatableGroupAsset,\n} from '../types/tools.generated';\n\n/** Canonical structural union for the slots declared in an `assets` array. */\nexport type CanonicalFormatAssetSlot =\n  | IndividualAudioAsset\n  | IndividualBriefAsset\n  | IndividualCatalogAsset\n  | IndividualCssAsset\n  | IndividualDaastAsset\n  | IndividualHtmlAsset\n  | IndividualImageAsset\n  | IndividualJavaScriptAsset\n  | IndividualMarkdownAsset\n  | IndividualTextAsset\n  | IndividualUrlAsset\n  | IndividualVastAsset\n  | IndividualVideoAsset\n  | IndividualWebhookAsset\n  | RepeatableGroupAsset;\n\nexport type IndividualFormatAssetSlot = Exclude<CanonicalFormatAssetSlot, RepeatableGroupAsset>;\nexport type RepeatableFormatAssetGroup = RepeatableGroupAsset;\n\n/**\n * Minimal structural input for asset inspection. It deliberately has no\n * `format_id`, `agent_url`, name, or other legacy catalog identity.\n */\nexport interface FormatAssetsInput {\n  assets?: CanonicalFormatAssetSlot[];\n  /** Deprecated v2 compatibility field; values are normalized as required slots. */\n  assets_required?: unknown[];\n}\n\n// Legacy support: v2 responses may still include assets_required (deprecated in v3)\n// This internal type allows runtime backward compatibility without exposing it in public API\ntype LegacyFormatAssetsInput = FormatAssetsInput;\n\n/**\n * Get asset slots from any structural asset container.\n *\n * Returns the assets from the v3 `assets` field. For backward compatibility with v2 servers,\n * this function also handles the deprecated `assets_required` field if present.\n *\n * @param format - An object containing canonical `assets` slots\n * @returns Array of assets\n *\n * @example\n * ```typescript\n * const assets = getFormatAssets({\n *   assets: [FormatAsset.image({ asset_id: 'hero', required: true })]\n * });\n * ```\n */\nexport function getFormatAssets(format: FormatAssetsInput): CanonicalFormatAssetSlot[] {\n  // Use v3 `assets` field\n  if (format.assets && format.assets.length > 0) {\n    return format.assets;\n  }\n\n  // Runtime backward compatibility: handle v2 responses with deprecated assets_required\n  const legacyFormat = format as LegacyFormatAssetsInput;\n  if (\n    legacyFormat.assets_required &&\n    Array.isArray(legacyFormat.assets_required) &&\n    legacyFormat.assets_required.length > 0\n  ) {\n    return normalizeAssetsRequired(legacyFormat.assets_required);\n  }\n\n  return [];\n}\n\n/**\n * Convert deprecated assets_required to new assets format (internal use)\n *\n * All assets in assets_required are required by definition (that's why they were in that array).\n * The new `assets` field has an explicit `required: boolean` to allow both required AND optional assets.\n *\n * @param assetsRequired - The deprecated assets_required array\n * @returns Normalized assets array with explicit required: true\n * @internal\n */\nfunction normalizeAssetsRequired(assetsRequired: unknown[]): CanonicalFormatAssetSlot[] {\n  return assetsRequired.map(asset => ({\n    ...(asset as Record<string, unknown>),\n    required: true, // assets_required only contained required assets\n  })) as CanonicalFormatAssetSlot[];\n}\n\n/**\n * Get only required slots from an asset container.\n *\n * @param format - A structural asset container\n * @returns Array of required assets only\n *\n * @example\n * ```typescript\n * const requiredAssets = getRequiredAssets(format);\n * console.log(`Must provide ${requiredAssets.length} assets`);\n * ```\n */\nexport function getRequiredAssets(format: FormatAssetsInput): CanonicalFormatAssetSlot[] {\n  return getFormatAssets(format).filter(asset => asset.required);\n}\n\n/**\n * Get only optional slots from an asset container.\n *\n * Note: When using deprecated `assets_required`, this will always return empty\n * since assets_required only contained required assets.\n *\n * @param format - A structural asset container\n * @returns Array of optional assets only\n *\n * @example\n * ```typescript\n * const optionalAssets = getOptionalAssets(format);\n * console.log(`Can optionally provide ${optionalAssets.length} additional assets`);\n * ```\n */\nexport function getOptionalAssets(format: FormatAssetsInput): CanonicalFormatAssetSlot[] {\n  return getFormatAssets(format).filter(asset => !asset.required);\n}\n\n/**\n * Get individual slots (not repeatable groups) from an asset container.\n *\n * @param format - A structural asset container\n * @returns Array of individual assets\n */\nexport function getIndividualAssets(format: FormatAssetsInput): IndividualFormatAssetSlot[] {\n  return getFormatAssets(format).filter(\n    (asset): asset is IndividualFormatAssetSlot => asset.item_type === 'individual'\n  );\n}\n\n/**\n * Get repeatable asset groups from an asset container.\n *\n * @param format - A structural asset container\n * @returns Array of repeatable asset groups\n */\nexport function getRepeatableGroups(format: FormatAssetsInput): RepeatableFormatAssetGroup[] {\n  return getFormatAssets(format).filter(\n    (asset): asset is RepeatableFormatAssetGroup => asset.item_type === 'repeatable_group'\n  );\n}\n\n/**\n * Check if format uses deprecated assets_required field (for migration warnings)\n *\n * @param format - A structural asset container\n * @returns true if using deprecated field, false if using new field or neither\n *\n * @example\n * ```typescript\n * if (usesDeprecatedAssetsField(format)) {\n *   console.warn('Asset container uses deprecated assets_required field');\n * }\n * ```\n */\nexport function usesDeprecatedAssetsField(format: FormatAssetsInput): boolean {\n  const legacyFormat = format as LegacyFormatAssetsInput;\n  return !format.assets && !!(legacyFormat.assets_required && Array.isArray(legacyFormat.assets_required));\n}\n\n/**\n * Get the count of slots in an asset container.\n *\n * @param format - A structural asset container\n * @returns Number of assets, or 0 if none defined\n */\nexport function getAssetCount(format: FormatAssetsInput): number {\n  return getFormatAssets(format).length;\n}\n\n/**\n * Check if an asset container has any slots defined.\n *\n * @param format - A structural asset container\n * @returns true if format has assets, false otherwise\n */\nexport function hasAssets(format: FormatAssetsInput): boolean {\n  return getAssetCount(format) > 0;\n}\n"],"mappings":"AAyEO,SAAS,gBAAgB,QAAuD;AAErF,MAAI,OAAO,UAAU,OAAO,OAAO,SAAS,GAAG;AAC7C,WAAO,OAAO;AAAA,EAChB;AAGA,QAAM,eAAe;AACrB,MACE,aAAa,mBACb,MAAM,QAAQ,aAAa,eAAe,KAC1C,aAAa,gBAAgB,SAAS,GACtC;AACA,WAAO,wBAAwB,aAAa,eAAe;AAAA,EAC7D;AAEA,SAAO,CAAC;AACV;AAYA,SAAS,wBAAwB,gBAAuD;AACtF,SAAO,eAAe,IAAI,YAAU;AAAA,IAClC,GAAI;AAAA,IACJ,UAAU;AAAA;AAAA,EACZ,EAAE;AACJ;AAcO,SAAS,kBAAkB,QAAuD;AACvF,SAAO,gBAAgB,MAAM,EAAE,OAAO,WAAS,MAAM,QAAQ;AAC/D;AAiBO,SAAS,kBAAkB,QAAuD;AACvF,SAAO,gBAAgB,MAAM,EAAE,OAAO,WAAS,CAAC,MAAM,QAAQ;AAChE;AAQO,SAAS,oBAAoB,QAAwD;AAC1F,SAAO,gBAAgB,MAAM,EAAE;AAAA,IAC7B,CAAC,UAA8C,MAAM,cAAc;AAAA,EACrE;AACF;AAQO,SAAS,oBAAoB,QAAyD;AAC3F,SAAO,gBAAgB,MAAM,EAAE;AAAA,IAC7B,CAAC,UAA+C,MAAM,cAAc;AAAA,EACtE;AACF;AAeO,SAAS,0BAA0B,QAAoC;AAC5E,QAAM,eAAe;AACrB,SAAO,CAAC,OAAO,UAAU,CAAC,EAAE,aAAa,mBAAmB,MAAM,QAAQ,aAAa,eAAe;AACxG;AAQO,SAAS,cAAc,QAAmC;AAC/D,SAAO,gBAAgB,MAAM,EAAE;AACjC;AAQO,SAAS,UAAU,QAAoC;AAC5D,SAAO,cAAc,MAAM,IAAI;AACjC;","names":[]}

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

@@ -1,9 +1,9 @@
-import type { CreativeFormat } from '../types/index.mjs';
+import type { LegacyCreativeFormatSummary } from '../types/index.mjs';
 export { logger, createLogger, type LogLevel, type LoggerConfig } from './logger.mjs';
-export { batchPreviewProducts, batchPreviewFormats, clearPreviewCache, type PreviewResult, type BatchPreviewOptions, type PreviewCacheBackend, type PreviewCacheEntry, } from './preview-utils.mjs';
+export { batchPreviewProducts, batchPreviewFormatsLegacy, clearPreviewCache, type PreviewResult, type LegacyPreviewResult, type BatchPreviewOptions, type PreviewCacheBackend, type PreviewCacheEntry, } from './preview-utils.mjs';
 export declare const REQUEST_TIMEOUT: number;
 export declare const MAX_CONCURRENT: number;
-export declare const STANDARD_FORMATS: CreativeFormat[];
+export declare const LEGACY_STANDARD_FORMATS: LegacyCreativeFormatSummary[];
 /**
  * Circuit Breaker for handling agent failures
  */
@@ -21,9 +21,9 @@ export declare class CircuitBreaker {
 }
 export declare function getCircuitBreaker(agentId: string): CircuitBreaker;
 /**
- * Get standard creative formats
+ * Get legacy named creative formats for migration tooling.
  */
-export declare function getStandardFormats(): CreativeFormat[];
+export declare function getStandardFormatsLegacy(): LegacyCreativeFormatSummary[];
 export { unwrapProtocolResponse, isAdcpError, isAdcpSuccess, isTerminalAdcpError, hasAdvisorySuccessPayload, } from './response-unwrapper.mjs';
 export type { AdCPResponse } from './response-unwrapper.mjs';
 export { ensureGetProductsCacheScope, validateGetProductsCacheScope, type EnsureGetProductsCacheScopeOptions, type GetProductsCacheScope, type GetProductsResponseWithCacheScope, type GetProductsCacheScopeValidation, } from './get-products-cache-scope.mjs';
@@ -35,9 +35,9 @@ export { extractAdcpErrorFromMcp, extractAdcpErrorFromTransport, extractAdcpErro
 export type { ExtractedAdcpError } from './error-extraction.mjs';
 export { detectProtocol, detectProtocolWithTimeout } from './protocol-detection.mjs';
 export { A2A_CARD_PATHS, TRANSPORT_SUFFIX_REGEX, isAgentCardPath, isWellKnownAgentCardUrl, buildCardUrls, stripAgentCardPath, stripTransportSuffix, } from './a2a-discovery.mjs';
-export { getFormatAssets, getRequiredAssets, getOptionalAssets, getIndividualAssets, getRepeatableGroups, usesDeprecatedAssetsField, getAssetCount, hasAssets, } from './format-assets.mjs';
+export { getFormatAssets, getRequiredAssets, getOptionalAssets, getIndividualAssets, getRepeatableGroups, usesDeprecatedAssetsField, getAssetCount, hasAssets, type CanonicalFormatAssetSlot, type FormatAssetsInput, type IndividualFormatAssetSlot, type RepeatableFormatAssetGroup, } from './format-assets.mjs';
 export { adaptGetProductsRequestForV2, normalizeProductChannels, adaptPricingOptionForV2, normalizePricingOption, normalizeProductPricing, normalizeGetProductsResponse, usesV2PricingFields, usesV3PricingFields, isFixedPricing, isCPAPricing, getPrice, getFloorPrice, type PricingOptionV2, type PricingOptionV3, type PriceGuidanceV2, type PriceGuidanceV3, } from './pricing-adapter.mjs';
 export { adaptSyncCreativesRequestForV2 } from './sync-creatives-adapter.mjs';
-export { inlineCreativesForPackages } from './creative-delivery.mjs';
-export type { InlineCreativeAssignment, InlineCreativePackage, InlineCreativePackagePatch, InlineCreativesForPackagesOptions, } from './creative-delivery.mjs';
+export { inlineCreativesForPackages, inlineCreativesForPackagesLegacy } from './creative-delivery.mjs';
+export type { InlineCreativeAssignment, InlineCreativePackage, InlineCreativePackagePatch, InlineCreativesForPackagesOptions, InlineCreativesForPackagesLegacyOptions, LegacyInlineCreativePackage, } from './creative-delivery.mjs';
 export { paginate, paginatePages, type PaginateOptions } from './pagination.mjs';

package/dist/lib/utils/index.d.ts

@@ -1,9 +1,9 @@
-import type { CreativeFormat } from '../types';
+import type { LegacyCreativeFormatSummary } from '../types';
 export { logger, createLogger, type LogLevel, type LoggerConfig } from './logger';
-export { batchPreviewProducts, batchPreviewFormats, clearPreviewCache, type PreviewResult, type BatchPreviewOptions, type PreviewCacheBackend, type PreviewCacheEntry, } from './preview-utils';
+export { batchPreviewProducts, batchPreviewFormatsLegacy, clearPreviewCache, type PreviewResult, type LegacyPreviewResult, type BatchPreviewOptions, type PreviewCacheBackend, type PreviewCacheEntry, } from './preview-utils';
 export declare const REQUEST_TIMEOUT: number;
 export declare const MAX_CONCURRENT: number;
-export declare const STANDARD_FORMATS: CreativeFormat[];
+export declare const LEGACY_STANDARD_FORMATS: LegacyCreativeFormatSummary[];
 /**
  * Circuit Breaker for handling agent failures
  */
@@ -21,9 +21,9 @@ export declare class CircuitBreaker {
 }
 export declare function getCircuitBreaker(agentId: string): CircuitBreaker;
 /**
- * Get standard creative formats
+ * Get legacy named creative formats for migration tooling.
  */
-export declare function getStandardFormats(): CreativeFormat[];
+export declare function getStandardFormatsLegacy(): LegacyCreativeFormatSummary[];
 export { unwrapProtocolResponse, isAdcpError, isAdcpSuccess, isTerminalAdcpError, hasAdvisorySuccessPayload, } from './response-unwrapper';
 export type { AdCPResponse } from './response-unwrapper';
 export { ensureGetProductsCacheScope, validateGetProductsCacheScope, type EnsureGetProductsCacheScopeOptions, type GetProductsCacheScope, type GetProductsResponseWithCacheScope, type GetProductsCacheScopeValidation, } from './get-products-cache-scope';
@@ -35,10 +35,10 @@ export { extractAdcpErrorFromMcp, extractAdcpErrorFromTransport, extractAdcpErro
 export type { ExtractedAdcpError } from './error-extraction';
 export { detectProtocol, detectProtocolWithTimeout } from './protocol-detection';
 export { A2A_CARD_PATHS, TRANSPORT_SUFFIX_REGEX, isAgentCardPath, isWellKnownAgentCardUrl, buildCardUrls, stripAgentCardPath, stripTransportSuffix, } from './a2a-discovery';
-export { getFormatAssets, getRequiredAssets, getOptionalAssets, getIndividualAssets, getRepeatableGroups, usesDeprecatedAssetsField, getAssetCount, hasAssets, } from './format-assets';
+export { getFormatAssets, getRequiredAssets, getOptionalAssets, getIndividualAssets, getRepeatableGroups, usesDeprecatedAssetsField, getAssetCount, hasAssets, type CanonicalFormatAssetSlot, type FormatAssetsInput, type IndividualFormatAssetSlot, type RepeatableFormatAssetGroup, } from './format-assets';
 export { adaptGetProductsRequestForV2, normalizeProductChannels, adaptPricingOptionForV2, normalizePricingOption, normalizeProductPricing, normalizeGetProductsResponse, usesV2PricingFields, usesV3PricingFields, isFixedPricing, isCPAPricing, getPrice, getFloorPrice, type PricingOptionV2, type PricingOptionV3, type PriceGuidanceV2, type PriceGuidanceV3, } from './pricing-adapter';
 export { adaptSyncCreativesRequestForV2 } from './sync-creatives-adapter';
-export { inlineCreativesForPackages } from './creative-delivery';
-export type { InlineCreativeAssignment, InlineCreativePackage, InlineCreativePackagePatch, InlineCreativesForPackagesOptions, } from './creative-delivery';
+export { inlineCreativesForPackages, inlineCreativesForPackagesLegacy } from './creative-delivery';
+export type { InlineCreativeAssignment, InlineCreativePackage, InlineCreativePackagePatch, InlineCreativesForPackagesOptions, InlineCreativesForPackagesLegacyOptions, LegacyInlineCreativePackage, } from './creative-delivery';
 export { paginate, paginatePages, type PaginateOptions } from './pagination';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAG5D,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAIlF,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AAGzB,eAAO,MAAM,eAAe,QAAmD,CAAC;AAChF,eAAO,MAAM,cAAc,QAA8C,CAAC;AAG1E,eAAO,MAAM,uBAAuB,EAAE,2BAA2B,EA8ChE,CAAC;AAEF;;GAEG;AACH,qBAAa,cAAc;IAOb,OAAO,CAAC,OAAO;IAN3B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAK;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAElB,OAAO,EAAE,MAAM;IAE7B,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoB/C,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,SAAS;CASlB;AAKD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAKjE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,2BAA2B,EAAE,CAExE;AAGD,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,KAAK,kCAAkC,EACvC,KAAK,qBAAqB,EAC1B,KAAK,iCAAiC,EACtC,KAAK,+BAA+B,GACrC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,8BAA8B,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EACL,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG1E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGrD,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAGjF,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,aAAa,EACb,SAAS,EACT,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,GAChC,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,EAC5B,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAG1E,OAAO,EAAE,0BAA0B,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AACnG,YAAY,EACV,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,iCAAiC,EACjC,uCAAuC,EACvC,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/lib/utils/index.js

@@ -20,14 +20,14 @@ var utils_exports = {};
 __export(utils_exports, {
   A2A_CARD_PATHS: () => import_a2a_discovery.A2A_CARD_PATHS,
   CircuitBreaker: () => CircuitBreaker,
+  LEGACY_STANDARD_FORMATS: () => LEGACY_STANDARD_FORMATS,
   MAX_CONCURRENT: () => MAX_CONCURRENT,
   REQUEST_TIMEOUT: () => REQUEST_TIMEOUT,
-  STANDARD_FORMATS: () => STANDARD_FORMATS,
   TRANSPORT_SUFFIX_REGEX: () => import_a2a_discovery.TRANSPORT_SUFFIX_REGEX,
   adaptGetProductsRequestForV2: () => import_pricing_adapter.adaptGetProductsRequestForV2,
   adaptPricingOptionForV2: () => import_pricing_adapter.adaptPricingOptionForV2,
   adaptSyncCreativesRequestForV2: () => import_sync_creatives_adapter.adaptSyncCreativesRequestForV2,
-  batchPreviewFormats: () => import_preview_utils.batchPreviewFormats,
+  batchPreviewFormatsLegacy: () => import_preview_utils.batchPreviewFormatsLegacy,
   batchPreviewProducts: () => import_preview_utils.batchPreviewProducts,
   buildCardUrls: () => import_a2a_discovery.buildCardUrls,
   clearPreviewCache: () => import_preview_utils.clearPreviewCache,
@@ -52,10 +52,11 @@ __export(utils_exports, {
   getRepeatableGroups: () => import_format_assets.getRepeatableGroups,
   getRequiredAssets: () => import_format_assets.getRequiredAssets,
   getRetryDelay: () => import_retry.getRetryDelay,
-  getStandardFormats: () => getStandardFormats,
+  getStandardFormatsLegacy: () => getStandardFormatsLegacy,
   hasAdvisorySuccessPayload: () => import_response_unwrapper.hasAdvisorySuccessPayload,
   hasAssets: () => import_format_assets.hasAssets,
   inlineCreativesForPackages: () => import_creative_delivery.inlineCreativesForPackages,
+  inlineCreativesForPackagesLegacy: () => import_creative_delivery.inlineCreativesForPackagesLegacy,
   isAdcpError: () => import_response_unwrapper.isAdcpError,
   isAdcpSuccess: () => import_response_unwrapper.isAdcpSuccess,
   isAgentCardPath: () => import_a2a_discovery.isAgentCardPath,
@@ -102,7 +103,7 @@ var import_creative_delivery = require('./creative-delivery.js');
 var import_pagination = require('./pagination.js');
 const REQUEST_TIMEOUT = parseInt(process.env.REQUEST_TIMEOUT || "30000");
 const MAX_CONCURRENT = parseInt(process.env.MAX_CONCURRENT || "5");
-const STANDARD_FORMATS = [
+const LEGACY_STANDARD_FORMATS = [
   {
     format_id: {
       agent_url: "https://creatives.adcontextprotocol.org",
@@ -201,21 +202,21 @@ function getCircuitBreaker(agentId) {
   }
   return circuitBreakers.get(agentId);
 }
-function getStandardFormats() {
-  return STANDARD_FORMATS;
+function getStandardFormatsLegacy() {
+  return LEGACY_STANDARD_FORMATS;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   A2A_CARD_PATHS,
   CircuitBreaker,
+  LEGACY_STANDARD_FORMATS,
   MAX_CONCURRENT,
   REQUEST_TIMEOUT,
-  STANDARD_FORMATS,
   TRANSPORT_SUFFIX_REGEX,
   adaptGetProductsRequestForV2,
   adaptPricingOptionForV2,
   adaptSyncCreativesRequestForV2,
-  batchPreviewFormats,
+  batchPreviewFormatsLegacy,
   batchPreviewProducts,
   buildCardUrls,
   clearPreviewCache,
@@ -240,10 +241,11 @@ function getStandardFormats() {
   getRepeatableGroups,
   getRequiredAssets,
   getRetryDelay,
-  getStandardFormats,
+  getStandardFormatsLegacy,
   hasAdvisorySuccessPayload,
   hasAssets,
   inlineCreativesForPackages,
+  inlineCreativesForPackagesLegacy,
   isAdcpError,
   isAdcpSuccess,
   isAgentCardPath,

package/dist/lib/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/utils/index.ts"],"sourcesContent":["import type { CreativeFormat } from '../types';\n\n// Re-export logger utilities\nexport { logger, createLogger, type LogLevel, type LoggerConfig } from './logger';\nimport { logger } from './logger';\n\n// Re-export preview utilities\nexport {\n  batchPreviewProducts,\n  batchPreviewFormats,\n  clearPreviewCache,\n  type PreviewResult,\n  type BatchPreviewOptions,\n  type PreviewCacheBackend,\n  type PreviewCacheEntry,\n} from './preview-utils';\n\n// Configuration constants\nexport const REQUEST_TIMEOUT = parseInt(process.env.REQUEST_TIMEOUT || '30000'); // 30 seconds\nexport const MAX_CONCURRENT = parseInt(process.env.MAX_CONCURRENT || '5');\n\n// Standard creative formats (hardcoded for now)\nexport const STANDARD_FORMATS: CreativeFormat[] = [\n  {\n    format_id: {\n      agent_url: 'https://creatives.adcontextprotocol.org',\n      id: 'banner_728x90',\n    },\n    name: 'Leaderboard',\n    dimensions: { width: 728, height: 90 },\n    aspect_ratio: '8:1',\n    file_types: ['jpg', 'jpeg', 'png', 'gif'],\n    max_file_size: 150000,\n  },\n  {\n    format_id: {\n      agent_url: 'https://creatives.adcontextprotocol.org',\n      id: 'banner_300x250',\n    },\n    name: 'Medium Rectangle',\n    dimensions: { width: 300, height: 250 },\n    aspect_ratio: '6:5',\n    file_types: ['jpg', 'jpeg', 'png', 'gif'],\n    max_file_size: 150000,\n  },\n  {\n    format_id: {\n      agent_url: 'https://creatives.adcontextprotocol.org',\n      id: 'banner_320x50',\n    },\n    name: 'Mobile Banner',\n    dimensions: { width: 320, height: 50 },\n    aspect_ratio: '32:5',\n    file_types: ['jpg', 'jpeg', 'png', 'gif'],\n    max_file_size: 40000,\n  },\n  {\n    format_id: {\n      agent_url: 'https://creatives.adcontextprotocol.org',\n      id: 'video_1920x1080',\n    },\n    name: 'Full HD Video',\n    dimensions: { width: 1920, height: 1080 },\n    aspect_ratio: '16:9',\n    file_types: ['mp4', 'webm'],\n    max_file_size: 10000000,\n    duration_range: { min: 6, max: 30 },\n  },\n];\n\n/**\n * Circuit Breaker for handling agent failures\n */\nexport class CircuitBreaker {\n  private failures = 0;\n  private lastFailTime = 0;\n  private state: 'closed' | 'open' | 'half-open' = 'closed';\n  private readonly failureThreshold = 5;\n  private readonly resetTimeout = 60000; // 1 minute\n\n  constructor(private agentId: string) {}\n\n  async call<T>(fn: () => Promise<T>): Promise<T> {\n    if (this.state === 'open') {\n      if (Date.now() - this.lastFailTime > this.resetTimeout) {\n        this.state = 'half-open';\n        logger.info(`🔄 Circuit breaker for ${this.agentId} attempting to close...`);\n      } else {\n        throw new Error(`Circuit breaker is open for agent ${this.agentId}`);\n      }\n    }\n\n    try {\n      const result = await fn();\n      this.onSuccess();\n      return result;\n    } catch (error) {\n      this.onFailure();\n      throw error;\n    }\n  }\n\n  private onSuccess(): void {\n    this.failures = 0;\n    if (this.state === 'half-open') {\n      this.state = 'closed';\n      logger.info(`✅ Circuit breaker for ${this.agentId} closed successfully`);\n    }\n  }\n\n  private onFailure(): void {\n    this.failures++;\n    this.lastFailTime = Date.now();\n\n    if (this.failures >= this.failureThreshold) {\n      this.state = 'open';\n      logger.warn(`🚨 Circuit breaker opened for agent ${this.agentId} after ${this.failures} failures`);\n    }\n  }\n}\n\n// Circuit breaker instances for each agent\nconst circuitBreakers = new Map<string, CircuitBreaker>();\n\nexport function getCircuitBreaker(agentId: string): CircuitBreaker {\n  if (!circuitBreakers.has(agentId)) {\n    circuitBreakers.set(agentId, new CircuitBreaker(agentId));\n  }\n  return circuitBreakers.get(agentId)!;\n}\n\n/**\n * Get standard creative formats\n */\nexport function getStandardFormats(): CreativeFormat[] {\n  return STANDARD_FORMATS;\n}\n\n// Re-export response unwrapping utilities\nexport {\n  unwrapProtocolResponse,\n  isAdcpError,\n  isAdcpSuccess,\n  isTerminalAdcpError,\n  hasAdvisorySuccessPayload,\n} from './response-unwrapper';\nexport type { AdCPResponse } from './response-unwrapper';\nexport {\n  ensureGetProductsCacheScope,\n  validateGetProductsCacheScope,\n  type EnsureGetProductsCacheScopeOptions,\n  type GetProductsCacheScope,\n  type GetProductsResponseWithCacheScope,\n  type GetProductsCacheScopeValidation,\n} from './get-products-cache-scope';\nexport { getAuthoritativeMediaBuyStatus, isMediaBuyStatus } from './media-buy-status';\nexport {\n  resolveTaskState,\n  type EffectiveTaskState,\n  type ResolvedTaskState,\n  type ResolveTaskStateOptions,\n} from './task-state';\n\n// Lightweight MCP CallToolResult extractor (prefers structuredContent, falls back to JSON text).\nexport { extractResult, type ToolCallResultLike } from './extract-result';\n\n// Re-export retry utilities\nexport { isRetryable, getRetryDelay } from './retry';\n\n// Re-export error extraction utilities\nexport {\n  extractAdcpErrorFromMcp,\n  extractAdcpErrorFromTransport,\n  extractAdcpErrorInfo,\n  extractCorrelationId,\n  resolveRecovery,\n  getExpectedAction,\n} from './error-extraction';\nexport type { ExtractedAdcpError } from './error-extraction';\n\n// Re-export protocol detection utilities\nexport { detectProtocol, detectProtocolWithTimeout } from './protocol-detection';\n\n// Re-export A2A discovery utilities\nexport {\n  A2A_CARD_PATHS,\n  TRANSPORT_SUFFIX_REGEX,\n  isAgentCardPath,\n  isWellKnownAgentCardUrl,\n  buildCardUrls,\n  stripAgentCardPath,\n  stripTransportSuffix,\n} from './a2a-discovery';\n\n// Re-export format asset utilities\nexport {\n  getFormatAssets,\n  getRequiredAssets,\n  getOptionalAssets,\n  getIndividualAssets,\n  getRepeatableGroups,\n  usesDeprecatedAssetsField,\n  getAssetCount,\n  hasAssets,\n} from './format-assets';\n\n// Re-export pricing adapter utilities (v3 pricing field compatibility)\nexport {\n  adaptGetProductsRequestForV2,\n  normalizeProductChannels,\n  adaptPricingOptionForV2,\n  normalizePricingOption,\n  normalizeProductPricing,\n  normalizeGetProductsResponse,\n  usesV2PricingFields,\n  usesV3PricingFields,\n  isFixedPricing,\n  isCPAPricing,\n  getPrice,\n  getFloorPrice,\n  type PricingOptionV2,\n  type PricingOptionV3,\n  type PriceGuidanceV2,\n  type PriceGuidanceV3,\n} from './pricing-adapter';\n\n// Re-export sync creatives adapter (v2/v3 compatibility)\nexport { adaptSyncCreativesRequestForV2 } from './sync-creatives-adapter';\n\n// Re-export creative delivery helpers for package-scoped inline creatives\nexport { inlineCreativesForPackages } from './creative-delivery';\nexport type {\n  InlineCreativeAssignment,\n  InlineCreativePackage,\n  InlineCreativePackagePatch,\n  InlineCreativesForPackagesOptions,\n} from './creative-delivery';\n\n// Re-export pagination utilities\nexport { paginate, paginatePages, type PaginateOptions } from './pagination';\n"],"mappings":"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","names":["import_logger"]}
+{"version":3,"sources":["../../../src/lib/utils/index.ts"],"sourcesContent":["import type { LegacyCreativeFormatSummary } from '../types';\n\n// Re-export logger utilities\nexport { logger, createLogger, type LogLevel, type LoggerConfig } from './logger';\nimport { logger } from './logger';\n\n// Re-export preview utilities\nexport {\n  batchPreviewProducts,\n  batchPreviewFormatsLegacy,\n  clearPreviewCache,\n  type PreviewResult,\n  type LegacyPreviewResult,\n  type BatchPreviewOptions,\n  type PreviewCacheBackend,\n  type PreviewCacheEntry,\n} from './preview-utils';\n\n// Configuration constants\nexport const REQUEST_TIMEOUT = parseInt(process.env.REQUEST_TIMEOUT || '30000'); // 30 seconds\nexport const MAX_CONCURRENT = parseInt(process.env.MAX_CONCURRENT || '5');\n\n// Legacy named creative formats (hardcoded migration fixtures)\nexport const LEGACY_STANDARD_FORMATS: LegacyCreativeFormatSummary[] = [\n  {\n    format_id: {\n      agent_url: 'https://creatives.adcontextprotocol.org',\n      id: 'banner_728x90',\n    },\n    name: 'Leaderboard',\n    dimensions: { width: 728, height: 90 },\n    aspect_ratio: '8:1',\n    file_types: ['jpg', 'jpeg', 'png', 'gif'],\n    max_file_size: 150000,\n  },\n  {\n    format_id: {\n      agent_url: 'https://creatives.adcontextprotocol.org',\n      id: 'banner_300x250',\n    },\n    name: 'Medium Rectangle',\n    dimensions: { width: 300, height: 250 },\n    aspect_ratio: '6:5',\n    file_types: ['jpg', 'jpeg', 'png', 'gif'],\n    max_file_size: 150000,\n  },\n  {\n    format_id: {\n      agent_url: 'https://creatives.adcontextprotocol.org',\n      id: 'banner_320x50',\n    },\n    name: 'Mobile Banner',\n    dimensions: { width: 320, height: 50 },\n    aspect_ratio: '32:5',\n    file_types: ['jpg', 'jpeg', 'png', 'gif'],\n    max_file_size: 40000,\n  },\n  {\n    format_id: {\n      agent_url: 'https://creatives.adcontextprotocol.org',\n      id: 'video_1920x1080',\n    },\n    name: 'Full HD Video',\n    dimensions: { width: 1920, height: 1080 },\n    aspect_ratio: '16:9',\n    file_types: ['mp4', 'webm'],\n    max_file_size: 10000000,\n    duration_range: { min: 6, max: 30 },\n  },\n];\n\n/**\n * Circuit Breaker for handling agent failures\n */\nexport class CircuitBreaker {\n  private failures = 0;\n  private lastFailTime = 0;\n  private state: 'closed' | 'open' | 'half-open' = 'closed';\n  private readonly failureThreshold = 5;\n  private readonly resetTimeout = 60000; // 1 minute\n\n  constructor(private agentId: string) {}\n\n  async call<T>(fn: () => Promise<T>): Promise<T> {\n    if (this.state === 'open') {\n      if (Date.now() - this.lastFailTime > this.resetTimeout) {\n        this.state = 'half-open';\n        logger.info(`🔄 Circuit breaker for ${this.agentId} attempting to close...`);\n      } else {\n        throw new Error(`Circuit breaker is open for agent ${this.agentId}`);\n      }\n    }\n\n    try {\n      const result = await fn();\n      this.onSuccess();\n      return result;\n    } catch (error) {\n      this.onFailure();\n      throw error;\n    }\n  }\n\n  private onSuccess(): void {\n    this.failures = 0;\n    if (this.state === 'half-open') {\n      this.state = 'closed';\n      logger.info(`✅ Circuit breaker for ${this.agentId} closed successfully`);\n    }\n  }\n\n  private onFailure(): void {\n    this.failures++;\n    this.lastFailTime = Date.now();\n\n    if (this.failures >= this.failureThreshold) {\n      this.state = 'open';\n      logger.warn(`🚨 Circuit breaker opened for agent ${this.agentId} after ${this.failures} failures`);\n    }\n  }\n}\n\n// Circuit breaker instances for each agent\nconst circuitBreakers = new Map<string, CircuitBreaker>();\n\nexport function getCircuitBreaker(agentId: string): CircuitBreaker {\n  if (!circuitBreakers.has(agentId)) {\n    circuitBreakers.set(agentId, new CircuitBreaker(agentId));\n  }\n  return circuitBreakers.get(agentId)!;\n}\n\n/**\n * Get legacy named creative formats for migration tooling.\n */\nexport function getStandardFormatsLegacy(): LegacyCreativeFormatSummary[] {\n  return LEGACY_STANDARD_FORMATS;\n}\n\n// Re-export response unwrapping utilities\nexport {\n  unwrapProtocolResponse,\n  isAdcpError,\n  isAdcpSuccess,\n  isTerminalAdcpError,\n  hasAdvisorySuccessPayload,\n} from './response-unwrapper';\nexport type { AdCPResponse } from './response-unwrapper';\nexport {\n  ensureGetProductsCacheScope,\n  validateGetProductsCacheScope,\n  type EnsureGetProductsCacheScopeOptions,\n  type GetProductsCacheScope,\n  type GetProductsResponseWithCacheScope,\n  type GetProductsCacheScopeValidation,\n} from './get-products-cache-scope';\nexport { getAuthoritativeMediaBuyStatus, isMediaBuyStatus } from './media-buy-status';\nexport {\n  resolveTaskState,\n  type EffectiveTaskState,\n  type ResolvedTaskState,\n  type ResolveTaskStateOptions,\n} from './task-state';\n\n// Lightweight MCP CallToolResult extractor (prefers structuredContent, falls back to JSON text).\nexport { extractResult, type ToolCallResultLike } from './extract-result';\n\n// Re-export retry utilities\nexport { isRetryable, getRetryDelay } from './retry';\n\n// Re-export error extraction utilities\nexport {\n  extractAdcpErrorFromMcp,\n  extractAdcpErrorFromTransport,\n  extractAdcpErrorInfo,\n  extractCorrelationId,\n  resolveRecovery,\n  getExpectedAction,\n} from './error-extraction';\nexport type { ExtractedAdcpError } from './error-extraction';\n\n// Re-export protocol detection utilities\nexport { detectProtocol, detectProtocolWithTimeout } from './protocol-detection';\n\n// Re-export A2A discovery utilities\nexport {\n  A2A_CARD_PATHS,\n  TRANSPORT_SUFFIX_REGEX,\n  isAgentCardPath,\n  isWellKnownAgentCardUrl,\n  buildCardUrls,\n  stripAgentCardPath,\n  stripTransportSuffix,\n} from './a2a-discovery';\n\n// Re-export format asset utilities\nexport {\n  getFormatAssets,\n  getRequiredAssets,\n  getOptionalAssets,\n  getIndividualAssets,\n  getRepeatableGroups,\n  usesDeprecatedAssetsField,\n  getAssetCount,\n  hasAssets,\n  type CanonicalFormatAssetSlot,\n  type FormatAssetsInput,\n  type IndividualFormatAssetSlot,\n  type RepeatableFormatAssetGroup,\n} from './format-assets';\n\n// Re-export pricing adapter utilities (v3 pricing field compatibility)\nexport {\n  adaptGetProductsRequestForV2,\n  normalizeProductChannels,\n  adaptPricingOptionForV2,\n  normalizePricingOption,\n  normalizeProductPricing,\n  normalizeGetProductsResponse,\n  usesV2PricingFields,\n  usesV3PricingFields,\n  isFixedPricing,\n  isCPAPricing,\n  getPrice,\n  getFloorPrice,\n  type PricingOptionV2,\n  type PricingOptionV3,\n  type PriceGuidanceV2,\n  type PriceGuidanceV3,\n} from './pricing-adapter';\n\n// Re-export sync creatives adapter (v2/v3 compatibility)\nexport { adaptSyncCreativesRequestForV2 } from './sync-creatives-adapter';\n\n// Re-export creative delivery helpers for package-scoped inline creatives\nexport { inlineCreativesForPackages, inlineCreativesForPackagesLegacy } from './creative-delivery';\nexport type {\n  InlineCreativeAssignment,\n  InlineCreativePackage,\n  InlineCreativePackagePatch,\n  InlineCreativesForPackagesOptions,\n  InlineCreativesForPackagesLegacyOptions,\n  LegacyInlineCreativePackage,\n} from './creative-delivery';\n\n// Re-export pagination utilities\nexport { paginate, paginatePages, type PaginateOptions } from './pagination';\n"],"mappings":"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","names":["import_logger"]}

package/dist/lib/utils/index.mjs

@@ -2,12 +2,12 @@ import { logger, createLogger } from "./logger.mjs";
 import { logger as logger2 } from "./logger.mjs";
 import {
   batchPreviewProducts,
-  batchPreviewFormats,
+  batchPreviewFormatsLegacy,
   clearPreviewCache
 } from "./preview-utils.mjs";
 const REQUEST_TIMEOUT = parseInt(process.env.REQUEST_TIMEOUT || "30000");
 const MAX_CONCURRENT = parseInt(process.env.MAX_CONCURRENT || "5");
-const STANDARD_FORMATS = [
+const LEGACY_STANDARD_FORMATS = [
   {
     format_id: {
       agent_url: "https://creatives.adcontextprotocol.org",
@@ -106,8 +106,8 @@ function getCircuitBreaker(agentId) {
   }
   return circuitBreakers.get(agentId);
 }
-function getStandardFormats() {
-  return STANDARD_FORMATS;
+function getStandardFormatsLegacy() {
+  return LEGACY_STANDARD_FORMATS;
 }
 import {
   unwrapProtocolResponse,
@@ -169,19 +169,19 @@ import {
   getFloorPrice
 } from "./pricing-adapter.mjs";
 import { adaptSyncCreativesRequestForV2 } from "./sync-creatives-adapter.mjs";
-import { inlineCreativesForPackages } from "./creative-delivery.mjs";
+import { inlineCreativesForPackages, inlineCreativesForPackagesLegacy } from "./creative-delivery.mjs";
 import { paginate, paginatePages } from "./pagination.mjs";
 export {
   A2A_CARD_PATHS,
   CircuitBreaker,
+  LEGACY_STANDARD_FORMATS,
   MAX_CONCURRENT,
   REQUEST_TIMEOUT,
-  STANDARD_FORMATS,
   TRANSPORT_SUFFIX_REGEX,
   adaptGetProductsRequestForV2,
   adaptPricingOptionForV2,
   adaptSyncCreativesRequestForV2,
-  batchPreviewFormats,
+  batchPreviewFormatsLegacy,
   batchPreviewProducts,
   buildCardUrls,
   clearPreviewCache,
@@ -206,10 +206,11 @@ export {
   getRepeatableGroups,
   getRequiredAssets,
   getRetryDelay,
-  getStandardFormats,
+  getStandardFormatsLegacy,
   hasAdvisorySuccessPayload,
   hasAssets,
   inlineCreativesForPackages,
+  inlineCreativesForPackagesLegacy,
   isAdcpError,
   isAdcpSuccess,
   isAgentCardPath,

package/dist/lib/utils/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/utils/index.ts"],"sourcesContent":["import type { CreativeFormat } from '../types';\n\n// Re-export logger utilities\nexport { logger, createLogger, type LogLevel, type LoggerConfig } from './logger';\nimport { logger } from './logger';\n\n// Re-export preview utilities\nexport {\n  batchPreviewProducts,\n  batchPreviewFormats,\n  clearPreviewCache,\n  type PreviewResult,\n  type BatchPreviewOptions,\n  type PreviewCacheBackend,\n  type PreviewCacheEntry,\n} from './preview-utils';\n\n// Configuration constants\nexport const REQUEST_TIMEOUT = parseInt(process.env.REQUEST_TIMEOUT || '30000'); // 30 seconds\nexport const MAX_CONCURRENT = parseInt(process.env.MAX_CONCURRENT || '5');\n\n// Standard creative formats (hardcoded for now)\nexport const STANDARD_FORMATS: CreativeFormat[] = [\n  {\n    format_id: {\n      agent_url: 'https://creatives.adcontextprotocol.org',\n      id: 'banner_728x90',\n    },\n    name: 'Leaderboard',\n    dimensions: { width: 728, height: 90 },\n    aspect_ratio: '8:1',\n    file_types: ['jpg', 'jpeg', 'png', 'gif'],\n    max_file_size: 150000,\n  },\n  {\n    format_id: {\n      agent_url: 'https://creatives.adcontextprotocol.org',\n      id: 'banner_300x250',\n    },\n    name: 'Medium Rectangle',\n    dimensions: { width: 300, height: 250 },\n    aspect_ratio: '6:5',\n    file_types: ['jpg', 'jpeg', 'png', 'gif'],\n    max_file_size: 150000,\n  },\n  {\n    format_id: {\n      agent_url: 'https://creatives.adcontextprotocol.org',\n      id: 'banner_320x50',\n    },\n    name: 'Mobile Banner',\n    dimensions: { width: 320, height: 50 },\n    aspect_ratio: '32:5',\n    file_types: ['jpg', 'jpeg', 'png', 'gif'],\n    max_file_size: 40000,\n  },\n  {\n    format_id: {\n      agent_url: 'https://creatives.adcontextprotocol.org',\n      id: 'video_1920x1080',\n    },\n    name: 'Full HD Video',\n    dimensions: { width: 1920, height: 1080 },\n    aspect_ratio: '16:9',\n    file_types: ['mp4', 'webm'],\n    max_file_size: 10000000,\n    duration_range: { min: 6, max: 30 },\n  },\n];\n\n/**\n * Circuit Breaker for handling agent failures\n */\nexport class CircuitBreaker {\n  private failures = 0;\n  private lastFailTime = 0;\n  private state: 'closed' | 'open' | 'half-open' = 'closed';\n  private readonly failureThreshold = 5;\n  private readonly resetTimeout = 60000; // 1 minute\n\n  constructor(private agentId: string) {}\n\n  async call<T>(fn: () => Promise<T>): Promise<T> {\n    if (this.state === 'open') {\n      if (Date.now() - this.lastFailTime > this.resetTimeout) {\n        this.state = 'half-open';\n        logger.info(`🔄 Circuit breaker for ${this.agentId} attempting to close...`);\n      } else {\n        throw new Error(`Circuit breaker is open for agent ${this.agentId}`);\n      }\n    }\n\n    try {\n      const result = await fn();\n      this.onSuccess();\n      return result;\n    } catch (error) {\n      this.onFailure();\n      throw error;\n    }\n  }\n\n  private onSuccess(): void {\n    this.failures = 0;\n    if (this.state === 'half-open') {\n      this.state = 'closed';\n      logger.info(`✅ Circuit breaker for ${this.agentId} closed successfully`);\n    }\n  }\n\n  private onFailure(): void {\n    this.failures++;\n    this.lastFailTime = Date.now();\n\n    if (this.failures >= this.failureThreshold) {\n      this.state = 'open';\n      logger.warn(`🚨 Circuit breaker opened for agent ${this.agentId} after ${this.failures} failures`);\n    }\n  }\n}\n\n// Circuit breaker instances for each agent\nconst circuitBreakers = new Map<string, CircuitBreaker>();\n\nexport function getCircuitBreaker(agentId: string): CircuitBreaker {\n  if (!circuitBreakers.has(agentId)) {\n    circuitBreakers.set(agentId, new CircuitBreaker(agentId));\n  }\n  return circuitBreakers.get(agentId)!;\n}\n\n/**\n * Get standard creative formats\n */\nexport function getStandardFormats(): CreativeFormat[] {\n  return STANDARD_FORMATS;\n}\n\n// Re-export response unwrapping utilities\nexport {\n  unwrapProtocolResponse,\n  isAdcpError,\n  isAdcpSuccess,\n  isTerminalAdcpError,\n  hasAdvisorySuccessPayload,\n} from './response-unwrapper';\nexport type { AdCPResponse } from './response-unwrapper';\nexport {\n  ensureGetProductsCacheScope,\n  validateGetProductsCacheScope,\n  type EnsureGetProductsCacheScopeOptions,\n  type GetProductsCacheScope,\n  type GetProductsResponseWithCacheScope,\n  type GetProductsCacheScopeValidation,\n} from './get-products-cache-scope';\nexport { getAuthoritativeMediaBuyStatus, isMediaBuyStatus } from './media-buy-status';\nexport {\n  resolveTaskState,\n  type EffectiveTaskState,\n  type ResolvedTaskState,\n  type ResolveTaskStateOptions,\n} from './task-state';\n\n// Lightweight MCP CallToolResult extractor (prefers structuredContent, falls back to JSON text).\nexport { extractResult, type ToolCallResultLike } from './extract-result';\n\n// Re-export retry utilities\nexport { isRetryable, getRetryDelay } from './retry';\n\n// Re-export error extraction utilities\nexport {\n  extractAdcpErrorFromMcp,\n  extractAdcpErrorFromTransport,\n  extractAdcpErrorInfo,\n  extractCorrelationId,\n  resolveRecovery,\n  getExpectedAction,\n} from './error-extraction';\nexport type { ExtractedAdcpError } from './error-extraction';\n\n// Re-export protocol detection utilities\nexport { detectProtocol, detectProtocolWithTimeout } from './protocol-detection';\n\n// Re-export A2A discovery utilities\nexport {\n  A2A_CARD_PATHS,\n  TRANSPORT_SUFFIX_REGEX,\n  isAgentCardPath,\n  isWellKnownAgentCardUrl,\n  buildCardUrls,\n  stripAgentCardPath,\n  stripTransportSuffix,\n} from './a2a-discovery';\n\n// Re-export format asset utilities\nexport {\n  getFormatAssets,\n  getRequiredAssets,\n  getOptionalAssets,\n  getIndividualAssets,\n  getRepeatableGroups,\n  usesDeprecatedAssetsField,\n  getAssetCount,\n  hasAssets,\n} from './format-assets';\n\n// Re-export pricing adapter utilities (v3 pricing field compatibility)\nexport {\n  adaptGetProductsRequestForV2,\n  normalizeProductChannels,\n  adaptPricingOptionForV2,\n  normalizePricingOption,\n  normalizeProductPricing,\n  normalizeGetProductsResponse,\n  usesV2PricingFields,\n  usesV3PricingFields,\n  isFixedPricing,\n  isCPAPricing,\n  getPrice,\n  getFloorPrice,\n  type PricingOptionV2,\n  type PricingOptionV3,\n  type PriceGuidanceV2,\n  type PriceGuidanceV3,\n} from './pricing-adapter';\n\n// Re-export sync creatives adapter (v2/v3 compatibility)\nexport { adaptSyncCreativesRequestForV2 } from './sync-creatives-adapter';\n\n// Re-export creative delivery helpers for package-scoped inline creatives\nexport { inlineCreativesForPackages } from './creative-delivery';\nexport type {\n  InlineCreativeAssignment,\n  InlineCreativePackage,\n  InlineCreativePackagePatch,\n  InlineCreativesForPackagesOptions,\n} from './creative-delivery';\n\n// Re-export pagination utilities\nexport { paginate, paginatePages, type PaginateOptions } from './pagination';\n"],"mappings":"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","names":["logger"]}
+{"version":3,"sources":["../../../src/lib/utils/index.ts"],"sourcesContent":["import type { LegacyCreativeFormatSummary } from '../types';\n\n// Re-export logger utilities\nexport { logger, createLogger, type LogLevel, type LoggerConfig } from './logger';\nimport { logger } from './logger';\n\n// Re-export preview utilities\nexport {\n  batchPreviewProducts,\n  batchPreviewFormatsLegacy,\n  clearPreviewCache,\n  type PreviewResult,\n  type LegacyPreviewResult,\n  type BatchPreviewOptions,\n  type PreviewCacheBackend,\n  type PreviewCacheEntry,\n} from './preview-utils';\n\n// Configuration constants\nexport const REQUEST_TIMEOUT = parseInt(process.env.REQUEST_TIMEOUT || '30000'); // 30 seconds\nexport const MAX_CONCURRENT = parseInt(process.env.MAX_CONCURRENT || '5');\n\n// Legacy named creative formats (hardcoded migration fixtures)\nexport const LEGACY_STANDARD_FORMATS: LegacyCreativeFormatSummary[] = [\n  {\n    format_id: {\n      agent_url: 'https://creatives.adcontextprotocol.org',\n      id: 'banner_728x90',\n    },\n    name: 'Leaderboard',\n    dimensions: { width: 728, height: 90 },\n    aspect_ratio: '8:1',\n    file_types: ['jpg', 'jpeg', 'png', 'gif'],\n    max_file_size: 150000,\n  },\n  {\n    format_id: {\n      agent_url: 'https://creatives.adcontextprotocol.org',\n      id: 'banner_300x250',\n    },\n    name: 'Medium Rectangle',\n    dimensions: { width: 300, height: 250 },\n    aspect_ratio: '6:5',\n    file_types: ['jpg', 'jpeg', 'png', 'gif'],\n    max_file_size: 150000,\n  },\n  {\n    format_id: {\n      agent_url: 'https://creatives.adcontextprotocol.org',\n      id: 'banner_320x50',\n    },\n    name: 'Mobile Banner',\n    dimensions: { width: 320, height: 50 },\n    aspect_ratio: '32:5',\n    file_types: ['jpg', 'jpeg', 'png', 'gif'],\n    max_file_size: 40000,\n  },\n  {\n    format_id: {\n      agent_url: 'https://creatives.adcontextprotocol.org',\n      id: 'video_1920x1080',\n    },\n    name: 'Full HD Video',\n    dimensions: { width: 1920, height: 1080 },\n    aspect_ratio: '16:9',\n    file_types: ['mp4', 'webm'],\n    max_file_size: 10000000,\n    duration_range: { min: 6, max: 30 },\n  },\n];\n\n/**\n * Circuit Breaker for handling agent failures\n */\nexport class CircuitBreaker {\n  private failures = 0;\n  private lastFailTime = 0;\n  private state: 'closed' | 'open' | 'half-open' = 'closed';\n  private readonly failureThreshold = 5;\n  private readonly resetTimeout = 60000; // 1 minute\n\n  constructor(private agentId: string) {}\n\n  async call<T>(fn: () => Promise<T>): Promise<T> {\n    if (this.state === 'open') {\n      if (Date.now() - this.lastFailTime > this.resetTimeout) {\n        this.state = 'half-open';\n        logger.info(`🔄 Circuit breaker for ${this.agentId} attempting to close...`);\n      } else {\n        throw new Error(`Circuit breaker is open for agent ${this.agentId}`);\n      }\n    }\n\n    try {\n      const result = await fn();\n      this.onSuccess();\n      return result;\n    } catch (error) {\n      this.onFailure();\n      throw error;\n    }\n  }\n\n  private onSuccess(): void {\n    this.failures = 0;\n    if (this.state === 'half-open') {\n      this.state = 'closed';\n      logger.info(`✅ Circuit breaker for ${this.agentId} closed successfully`);\n    }\n  }\n\n  private onFailure(): void {\n    this.failures++;\n    this.lastFailTime = Date.now();\n\n    if (this.failures >= this.failureThreshold) {\n      this.state = 'open';\n      logger.warn(`🚨 Circuit breaker opened for agent ${this.agentId} after ${this.failures} failures`);\n    }\n  }\n}\n\n// Circuit breaker instances for each agent\nconst circuitBreakers = new Map<string, CircuitBreaker>();\n\nexport function getCircuitBreaker(agentId: string): CircuitBreaker {\n  if (!circuitBreakers.has(agentId)) {\n    circuitBreakers.set(agentId, new CircuitBreaker(agentId));\n  }\n  return circuitBreakers.get(agentId)!;\n}\n\n/**\n * Get legacy named creative formats for migration tooling.\n */\nexport function getStandardFormatsLegacy(): LegacyCreativeFormatSummary[] {\n  return LEGACY_STANDARD_FORMATS;\n}\n\n// Re-export response unwrapping utilities\nexport {\n  unwrapProtocolResponse,\n  isAdcpError,\n  isAdcpSuccess,\n  isTerminalAdcpError,\n  hasAdvisorySuccessPayload,\n} from './response-unwrapper';\nexport type { AdCPResponse } from './response-unwrapper';\nexport {\n  ensureGetProductsCacheScope,\n  validateGetProductsCacheScope,\n  type EnsureGetProductsCacheScopeOptions,\n  type GetProductsCacheScope,\n  type GetProductsResponseWithCacheScope,\n  type GetProductsCacheScopeValidation,\n} from './get-products-cache-scope';\nexport { getAuthoritativeMediaBuyStatus, isMediaBuyStatus } from './media-buy-status';\nexport {\n  resolveTaskState,\n  type EffectiveTaskState,\n  type ResolvedTaskState,\n  type ResolveTaskStateOptions,\n} from './task-state';\n\n// Lightweight MCP CallToolResult extractor (prefers structuredContent, falls back to JSON text).\nexport { extractResult, type ToolCallResultLike } from './extract-result';\n\n// Re-export retry utilities\nexport { isRetryable, getRetryDelay } from './retry';\n\n// Re-export error extraction utilities\nexport {\n  extractAdcpErrorFromMcp,\n  extractAdcpErrorFromTransport,\n  extractAdcpErrorInfo,\n  extractCorrelationId,\n  resolveRecovery,\n  getExpectedAction,\n} from './error-extraction';\nexport type { ExtractedAdcpError } from './error-extraction';\n\n// Re-export protocol detection utilities\nexport { detectProtocol, detectProtocolWithTimeout } from './protocol-detection';\n\n// Re-export A2A discovery utilities\nexport {\n  A2A_CARD_PATHS,\n  TRANSPORT_SUFFIX_REGEX,\n  isAgentCardPath,\n  isWellKnownAgentCardUrl,\n  buildCardUrls,\n  stripAgentCardPath,\n  stripTransportSuffix,\n} from './a2a-discovery';\n\n// Re-export format asset utilities\nexport {\n  getFormatAssets,\n  getRequiredAssets,\n  getOptionalAssets,\n  getIndividualAssets,\n  getRepeatableGroups,\n  usesDeprecatedAssetsField,\n  getAssetCount,\n  hasAssets,\n  type CanonicalFormatAssetSlot,\n  type FormatAssetsInput,\n  type IndividualFormatAssetSlot,\n  type RepeatableFormatAssetGroup,\n} from './format-assets';\n\n// Re-export pricing adapter utilities (v3 pricing field compatibility)\nexport {\n  adaptGetProductsRequestForV2,\n  normalizeProductChannels,\n  adaptPricingOptionForV2,\n  normalizePricingOption,\n  normalizeProductPricing,\n  normalizeGetProductsResponse,\n  usesV2PricingFields,\n  usesV3PricingFields,\n  isFixedPricing,\n  isCPAPricing,\n  getPrice,\n  getFloorPrice,\n  type PricingOptionV2,\n  type PricingOptionV3,\n  type PriceGuidanceV2,\n  type PriceGuidanceV3,\n} from './pricing-adapter';\n\n// Re-export sync creatives adapter (v2/v3 compatibility)\nexport { adaptSyncCreativesRequestForV2 } from './sync-creatives-adapter';\n\n// Re-export creative delivery helpers for package-scoped inline creatives\nexport { inlineCreativesForPackages, inlineCreativesForPackagesLegacy } from './creative-delivery';\nexport type {\n  InlineCreativeAssignment,\n  InlineCreativePackage,\n  InlineCreativePackagePatch,\n  InlineCreativesForPackagesOptions,\n  InlineCreativesForPackagesLegacyOptions,\n  LegacyInlineCreativePackage,\n} from './creative-delivery';\n\n// Re-export pagination utilities\nexport { paginate, paginatePages, type PaginateOptions } from './pagination';\n"],"mappings":"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","names":["logger"]}

package/dist/lib/utils/preview-utils.d.mts

@@ -1,11 +1,12 @@
 import type { SingleAgentClient } from '../core/SingleAgentClient.mjs';
 import type { Format, Product } from '../types/tools.generated.mjs';
+import type { CanonicalProduct } from '../v2/projection/creative-delivery.mjs';
 /**
- * Preview result for a single item (product or format)
+ * Preview result for a single canonical item.
  */
-export interface PreviewResult {
-    /** The item being previewed (Product or Format) */
-    item: Product | Format;
+export interface PreviewResult<TItem = CanonicalProduct> {
+    /** The item being previewed. */
+    item: TItem;
     /** Preview URL for the rendered card */
     previewUrl?: string;
     /** Preview ID from the creative agent */
@@ -13,6 +14,8 @@ export interface PreviewResult {
     /** Error message if preview failed */
     error?: string;
 }
+/** Raw named-format preview result for explicit migration tooling. */
+export type LegacyPreviewResult = PreviewResult<Product | Format>;
 /**
  * Options for batch preview generation
  */
@@ -98,9 +101,9 @@ export declare function clearPreviewCache(): void;
  * @deprecated Use `product.product_card?.image?.url` directly. This wrapper
  *   only exists for 8.0-beta migration ergonomics and will be removed.
  */
-export declare function batchPreviewProducts(products: Product[], _creativeAgentClient: SingleAgentClient, _options?: BatchPreviewOptions): Promise<PreviewResult[]>;
+export declare function batchPreviewProducts(products: CanonicalProduct[], _creativeAgentClient: SingleAgentClient, _options?: BatchPreviewOptions): Promise<PreviewResult[]>;
 /**
- * Generate batch previews for formats with format_card manifests
+ * Generate batch previews for legacy named formats with format_card manifests.
  *
  * Formats with format_card fields will have their cards rendered via the creative agent.
  * Formats without format_card will be returned with no preview.
@@ -119,7 +122,7 @@ export declare function batchPreviewProducts(products: Product[], _creativeAgent
  *   protocol: 'mcp'
  * });
  *
- * const previews = await batchPreviewFormats(formats, creativeAgent);
+ * const previews = await batchPreviewFormatsLegacy(formats, creativeAgent);
  * previews.forEach(p => {
  *   if (p.previewUrl) {
  *     console.log(`${(p.item as Format).name}: ${p.previewUrl}`);
@@ -127,4 +130,4 @@ export declare function batchPreviewProducts(products: Product[], _creativeAgent
  * });
  * ```
  */
-export declare function batchPreviewFormats(formats: Format[], creativeAgentClient: SingleAgentClient, options?: BatchPreviewOptions): Promise<PreviewResult[]>;
+export declare function batchPreviewFormatsLegacy(formats: Format[], creativeAgentClient: SingleAgentClient, options?: BatchPreviewOptions): Promise<LegacyPreviewResult[]>;

package/dist/lib/utils/preview-utils.d.ts

@@ -1,11 +1,12 @@
 import type { SingleAgentClient } from '../core/SingleAgentClient';
 import type { Format, Product } from '../types/tools.generated';
+import type { CanonicalProduct } from '../v2/projection/creative-delivery';
 /**
- * Preview result for a single item (product or format)
+ * Preview result for a single canonical item.
  */
-export interface PreviewResult {
-    /** The item being previewed (Product or Format) */
-    item: Product | Format;
+export interface PreviewResult<TItem = CanonicalProduct> {
+    /** The item being previewed. */
+    item: TItem;
     /** Preview URL for the rendered card */
     previewUrl?: string;
     /** Preview ID from the creative agent */
@@ -13,6 +14,8 @@ export interface PreviewResult {
     /** Error message if preview failed */
     error?: string;
 }
+/** Raw named-format preview result for explicit migration tooling. */
+export type LegacyPreviewResult = PreviewResult<Product | Format>;
 /**
  * Options for batch preview generation
  */
@@ -98,9 +101,9 @@ export declare function clearPreviewCache(): void;
  * @deprecated Use `product.product_card?.image?.url` directly. This wrapper
  *   only exists for 8.0-beta migration ergonomics and will be removed.
  */
-export declare function batchPreviewProducts(products: Product[], _creativeAgentClient: SingleAgentClient, _options?: BatchPreviewOptions): Promise<PreviewResult[]>;
+export declare function batchPreviewProducts(products: CanonicalProduct[], _creativeAgentClient: SingleAgentClient, _options?: BatchPreviewOptions): Promise<PreviewResult[]>;
 /**
- * Generate batch previews for formats with format_card manifests
+ * Generate batch previews for legacy named formats with format_card manifests.
  *
  * Formats with format_card fields will have their cards rendered via the creative agent.
  * Formats without format_card will be returned with no preview.
@@ -119,7 +122,7 @@ export declare function batchPreviewProducts(products: Product[], _creativeAgent
  *   protocol: 'mcp'
  * });
  *
- * const previews = await batchPreviewFormats(formats, creativeAgent);
+ * const previews = await batchPreviewFormatsLegacy(formats, creativeAgent);
  * previews.forEach(p => {
  *   if (p.previewUrl) {
  *     console.log(`${(p.item as Format).name}: ${p.previewUrl}`);
@@ -127,5 +130,5 @@ export declare function batchPreviewProducts(products: Product[], _creativeAgent
  * });
  * ```
  */
-export declare function batchPreviewFormats(formats: Format[], creativeAgentClient: SingleAgentClient, options?: BatchPreviewOptions): Promise<PreviewResult[]>;
+export declare function batchPreviewFormatsLegacy(formats: Format[], creativeAgentClient: SingleAgentClient, options?: BatchPreviewOptions): Promise<LegacyPreviewResult[]>;
 //# sourceMappingURL=preview-utils.d.ts.map

package/dist/lib/utils/preview-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/preview-utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAA+C,MAAM,0BAA0B,CAAC;AAG7G;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAC5G,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAqFD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,OAAO,EAAE,EACnB,oBAAoB,EAAE,iBAAiB,EACvC,QAAQ,GAAE,mBAAwB,GACjC,OAAO,CAAC,aAAa,EAAE,CAAC,CAQ1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EAAE,EACjB,mBAAmB,EAAE,iBAAiB,EACtC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,aAAa,EAAE,CAAC,CA2I1B"}
+{"version":3,"file":"preview-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/preview-utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAA+C,MAAM,0BAA0B,CAAC;AAE7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK,GAAG,gBAAgB;IACrD,gCAAgC;IAChC,IAAI,EAAE,KAAK,CAAC;IACZ,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAC5G,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAqFD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,oBAAoB,EAAE,iBAAiB,EACvC,QAAQ,GAAE,mBAAwB,GACjC,OAAO,CAAC,aAAa,EAAE,CAAC,CAQ1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EAAE,EACjB,mBAAmB,EAAE,iBAAiB,EACtC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA2IhC"}

package/dist/lib/utils/preview-utils.js

@@ -18,7 +18,7 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var preview_utils_exports = {};
 __export(preview_utils_exports, {
-  batchPreviewFormats: () => batchPreviewFormats,
+  batchPreviewFormatsLegacy: () => batchPreviewFormatsLegacy,
   batchPreviewProducts: () => batchPreviewProducts,
   clearPreviewCache: () => clearPreviewCache
 });
@@ -78,7 +78,7 @@ async function batchPreviewProducts(products, _creativeAgentClient, _options = {
     return { item: product };
   });
 }
-async function batchPreviewFormats(formats, creativeAgentClient, options = {}) {
+async function batchPreviewFormatsLegacy(formats, creativeAgentClient, options = {}) {
   const cacheTtl = options.cacheTtl ?? 36e5;
   const skipCache = options.skipCache ?? false;
   const cacheBackend = options.cacheBackend ?? defaultPreviewCacheBackend;
@@ -138,7 +138,7 @@ async function batchPreviewFormats(formats, creativeAgentClient, options = {}) {
           // manifest contains the asset map (format, etc)
         }
       };
-      const response = await creativeAgentClient.previewCreative(previewRequest);
+      const response = await creativeAgentClient.previewCreativeLegacy(previewRequest);
       const responseData = response.data;
       if (responseData && "previews" in responseData && responseData.previews && responseData.previews.length > 0) {
         const preview = responseData.previews[0];
@@ -185,7 +185,7 @@ async function batchPreviewFormats(formats, creativeAgentClient, options = {}) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  batchPreviewFormats,
+  batchPreviewFormatsLegacy,
   batchPreviewProducts,
   clearPreviewCache
 });