@adcp/sdk 12.1.0 → 13.0.0-rc.0

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/utils/preview-utils.ts"],"sourcesContent":["// Preview utilities for rendering product/format cards with creative agent\n\nimport type { SingleAgentClient } from '../core/SingleAgentClient';\nimport type { Format, Product, FormatReferenceStructuredObject as FormatID } from '../types/tools.generated';\nimport type { PreviewCreativeRequest, PreviewCreativeResponse } from '../types/tools.generated';\n\n/**\n * Preview result for a single item (product or format)\n */\nexport interface PreviewResult {\n  /** The item being previewed (Product or Format) */\n  item: Product | Format;\n  /** Preview URL for the rendered card */\n  previewUrl?: string;\n  /** Preview ID from the creative agent */\n  previewId?: string;\n  /** Error message if preview failed */\n  error?: string;\n}\n\n/**\n * Options for batch preview generation\n */\nexport interface BatchPreviewOptions {\n  /** Cache TTL in milliseconds (defaults to 1 hour) */\n  cacheTtl?: number;\n  /** Whether to skip cache and force fresh previews (defaults to false) */\n  skipCache?: boolean;\n  /**\n   * Cache backend for preview results.\n   *\n   * The default backend is process-local memory. It is safe for tests,\n   * local development, and single-process CLIs, but it is not shared\n   * across pods and does not survive restarts. Production services that\n   * cache preview URLs should provide a shared backend such as Redis or\n   * Postgres, and the cached URL itself must still resolve to durable\n   * storage rather than process-local assets.\n   */\n  cacheBackend?: PreviewCacheBackend;\n}\n\n/**\n * Cache entry for preview results\n */\nexport interface PreviewCacheEntry {\n  previewUrl: string;\n  previewId: string;\n  timestamp: number;\n  /** ISO 8601 timestamp from `preview_creative.expires_at`, when provided. */\n  expiresAt?: string;\n}\n\n/**\n * Pluggable cache backend for preview results.\n *\n * This cache stores references returned by `preview_creative`; it is not\n * an asset store. Preview URLs placed in any cache must already be\n * durable across load-balancer hops, pod restarts, and later refinement\n * calls.\n */\nexport interface PreviewCacheBackend {\n  get(cacheKey: string): PreviewCacheEntry | null | undefined | Promise<PreviewCacheEntry | null | undefined>;\n  set(cacheKey: string, entry: PreviewCacheEntry): void | Promise<void>;\n  delete?(cacheKey: string): void | Promise<void>;\n  clear?(): void | Promise<void>;\n}\n\n/**\n * Process-local in-memory cache for preview results.\n *\n * Development-only default: this map is not multi-pod-safe and does not\n * survive process restarts. It must not be used as the backing store for\n * MCPUI preview assets in production.\n *\n * Key format: `${formatId.agent_url}:${formatId.id}:${manifestHash}`\n */\nconst previewCache = new Map<string, PreviewCacheEntry>();\n\nconst defaultPreviewCacheBackend: PreviewCacheBackend = {\n  get(cacheKey) {\n    return previewCache.get(cacheKey);\n  },\n  set(cacheKey, entry) {\n    previewCache.set(cacheKey, entry);\n  },\n  delete(cacheKey) {\n    previewCache.delete(cacheKey);\n  },\n  clear() {\n    previewCache.clear();\n  },\n};\n\n/**\n * Generate a cache key for a preview request\n */\nfunction getCacheKey(formatId: FormatID, manifest: any): string {\n  // Simple hash of manifest for cache key\n  const manifestStr = JSON.stringify(manifest);\n  const manifestHash = Array.from(manifestStr)\n    .reduce((hash, char) => (hash << 5) - hash + char.charCodeAt(0), 0)\n    .toString(36);\n\n  return `${formatId.agent_url}:${formatId.id}:${manifestHash}`;\n}\n\nfunction hasExpiredAt(expiresAt: string | undefined, now: number): boolean {\n  if (!expiresAt) return false;\n  const expiresAtMs = Date.parse(expiresAt);\n  return Number.isNaN(expiresAtMs) ? false : expiresAtMs <= now;\n}\n\n/**\n * Get cached preview if available and not expired\n */\nasync function getCachedPreview(\n  cacheBackend: PreviewCacheBackend,\n  cacheKey: string,\n  ttl: number\n): Promise<PreviewCacheEntry | null> {\n  const entry = await cacheBackend.get(cacheKey);\n  if (!entry) return null;\n\n  const now = Date.now();\n  if (now - entry.timestamp > ttl || hasExpiredAt(entry.expiresAt, now)) {\n    await cacheBackend.delete?.(cacheKey);\n    return null;\n  }\n\n  return entry;\n}\n\n/**\n * Set cached preview\n */\nasync function setCachedPreview(\n  cacheBackend: PreviewCacheBackend,\n  cacheKey: string,\n  previewUrl: string,\n  previewId: string,\n  expiresAt?: string\n): Promise<void> {\n  await cacheBackend.set(cacheKey, {\n    previewUrl,\n    previewId,\n    expiresAt,\n    timestamp: Date.now(),\n  });\n}\n\n/**\n * Clear all previews from the default process-local cache.\n */\nexport function clearPreviewCache(): void {\n  defaultPreviewCacheBackend.clear?.();\n}\n\n/**\n * Extract preview URLs from products' `product_card` fields.\n *\n * AdCP 3.1.0-beta.2 changed `product_card` from a creative-agent-rendered\n * shape (`{ format_id, manifest }`) to a self-contained visual card\n * (`{ image, title, description, price_label, cta_label }`). The card IS\n * the preview — no creative-agent round-trip required. This function now\n * extracts the image URL directly from the inline card.\n *\n * Products with no `product_card`, or with a card that lacks an `image.url`,\n * return a result with no `previewUrl`. The function preserves its\n * `Promise<PreviewResult[]>` return shape so existing adopters' code paths\n * keep compiling and behaving correctly.\n *\n * @param products - Array of products to extract previews from\n * @param creativeAgentClient - Retained for signature compatibility; unused\n *   under 3.1.0-beta.2's self-rendering card model. Will be removed in\n *   8.0 final (or 9.0 at the latest) — pass any value through during the\n *   beta cycle.\n * @param options - Retained for signature compatibility. Cache fields\n *   (`cacheTtl`, `skipCache`) are unused — there's no expensive call to\n *   cache. Will be removed alongside `creativeAgentClient`.\n * @returns Array of preview results matching input products by index.\n *\n * @example\n * ```typescript\n * const previews = await batchPreviewProducts(products, creativeAgent);\n * previews.forEach(p => {\n *   if (p.previewUrl) {\n *     console.log(`${p.item.name}: ${p.previewUrl}`);\n *   }\n * });\n * ```\n *\n * @deprecated Use `product.product_card?.image?.url` directly. This wrapper\n *   only exists for 8.0-beta migration ergonomics and will be removed.\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport async function batchPreviewProducts(\n  products: Product[],\n  _creativeAgentClient: SingleAgentClient,\n  _options: BatchPreviewOptions = {}\n): Promise<PreviewResult[]> {\n  return products.map(product => {\n    const imageUrl = product.product_card?.image?.url;\n    if (imageUrl) {\n      return { item: product, previewUrl: imageUrl };\n    }\n    return { item: product };\n  });\n}\n\n/**\n * Generate batch previews for formats with format_card manifests\n *\n * Formats with format_card fields will have their cards rendered via the creative agent.\n * Formats without format_card will be returned with no preview.\n *\n * @param formats - Array of formats to preview\n * @param creativeAgentClient - ADCP client configured for creative agent\n * @param options - Preview generation options\n * @returns Array of preview results matching input formats\n *\n * @example\n * ```typescript\n * const creativeAgent = new SingleAgentClient({\n *   id: 'creative',\n *   name: 'Creative Agent',\n *   agent_uri: 'https://creative.adcontextprotocol.org/mcp',\n *   protocol: 'mcp'\n * });\n *\n * const previews = await batchPreviewFormats(formats, creativeAgent);\n * previews.forEach(p => {\n *   if (p.previewUrl) {\n *     console.log(`${(p.item as Format).name}: ${p.previewUrl}`);\n *   }\n * });\n * ```\n */\nexport async function batchPreviewFormats(\n  formats: Format[],\n  creativeAgentClient: SingleAgentClient,\n  options: BatchPreviewOptions = {}\n): Promise<PreviewResult[]> {\n  const cacheTtl = options.cacheTtl ?? 3600000; // 1 hour default\n  const skipCache = options.skipCache ?? false;\n  const cacheBackend = options.cacheBackend ?? defaultPreviewCacheBackend;\n\n  // Collect all formats that have format_card manifests\n  const previewRequests: {\n    format: Format;\n    formatId: FormatID;\n    manifest: any;\n    cacheKey: string;\n    inputName: string;\n  }[] = [];\n\n  const results: PreviewResult[] = [];\n\n  for (const format of formats) {\n    if (format.format_card) {\n      const cacheKey = getCacheKey(format.format_card.format_id, format.format_card.manifest);\n\n      // Check cache first\n      if (!skipCache) {\n        let cached: PreviewCacheEntry | null = null;\n        try {\n          cached = await getCachedPreview(cacheBackend, cacheKey, cacheTtl);\n        } catch {\n          cached = null;\n        }\n        if (cached) {\n          results.push({\n            item: format,\n            previewUrl: cached.previewUrl,\n            previewId: cached.previewId,\n          });\n          continue;\n        }\n      }\n\n      previewRequests.push({\n        format,\n        formatId: format.format_card.format_id,\n        manifest: format.format_card.manifest,\n        cacheKey,\n        inputName: format.name || 'Format Card',\n      });\n    } else {\n      // No format_card, return format with no preview\n      results.push({\n        item: format,\n      });\n    }\n  }\n\n  // If all were cached or none have format_card, return early\n  if (previewRequests.length === 0) {\n    return results;\n  }\n\n  // Batch preview using preview_creative with inputs array\n  // Group by format_id since preview_creative takes one format_id\n  const groupedByFormat = new Map<string, typeof previewRequests>();\n\n  previewRequests.forEach(req => {\n    const formatKey = `${req.formatId.agent_url}:${req.formatId.id}`;\n    if (!groupedByFormat.has(formatKey)) {\n      groupedByFormat.set(formatKey, []);\n    }\n    groupedByFormat.get(formatKey)!.push(req);\n  });\n\n  // Process each format individually\n  // Note: Each format has different manifest data, so we can't truly batch them\n  // We process them sequentially but could parallelize in the future\n  for (const req of previewRequests) {\n    try {\n      // Build preview_creative request for this format\n      // For format cards, the manifest typically contains the format object as JSON\n      const previewRequest: PreviewCreativeRequest = {\n        request_type: 'single',\n        format_id: req.formatId,\n        creative_manifest: {\n          format_id: req.formatId,\n          assets: req.manifest, // manifest contains the asset map (format, etc)\n        },\n      };\n\n      // Call preview_creative\n      const response = await creativeAgentClient.previewCreative(previewRequest);\n\n      // Check for data even if validation failed (response.success may be false due to schema warnings)\n      // Handle both single request (previews) and batch request (results) response formats\n      const responseData = response.data;\n      if (responseData && 'previews' in responseData && responseData.previews && responseData.previews.length > 0) {\n        const preview = responseData.previews[0]!;\n        if (preview.renders && preview.renders.length > 0) {\n          const render = preview.renders[0]!;\n          const previewUrl =\n            render.output_format === 'url' || render.output_format === 'both' ? render.preview_url : undefined;\n          const previewId = preview.preview_id;\n\n          if (previewUrl) {\n            results.push({\n              item: req.format,\n              previewUrl,\n              previewId,\n            });\n            try {\n              await setCachedPreview(cacheBackend, req.cacheKey, previewUrl, previewId, responseData.expires_at);\n            } catch {\n              // Preview cache is an accelerator; successful previews should still return on cache write failures.\n            }\n          } else {\n            results.push({\n              item: req.format,\n              error: 'Preview render has no URL',\n            });\n          }\n        } else {\n          results.push({\n            item: req.format,\n            error: 'No renders in preview response',\n          });\n        }\n      } else {\n        // Only treat as error if we have no data at all\n        results.push({\n          item: req.format,\n          error: response.error || 'Preview generation failed',\n        });\n      }\n    } catch (error) {\n      results.push({\n        item: req.format,\n        error: error instanceof Error ? error.message : 'Unknown error',\n      });\n    }\n  }\n\n  return results;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/lib/utils/preview-utils.ts"],"sourcesContent":["// Preview utilities for rendering product/format cards with creative agent\n\nimport type { SingleAgentClient } from '../core/SingleAgentClient';\nimport type { Format, Product, FormatReferenceStructuredObject as FormatID } from '../types/tools.generated';\nimport type { PreviewCreativeRequest, PreviewCreativeResponse } from '../types/tools.generated';\nimport type { CanonicalProduct } from '../v2/projection/creative-delivery';\n\n/**\n * Preview result for a single canonical item.\n */\nexport interface PreviewResult<TItem = CanonicalProduct> {\n  /** The item being previewed. */\n  item: TItem;\n  /** Preview URL for the rendered card */\n  previewUrl?: string;\n  /** Preview ID from the creative agent */\n  previewId?: string;\n  /** Error message if preview failed */\n  error?: string;\n}\n\n/** Raw named-format preview result for explicit migration tooling. */\nexport type LegacyPreviewResult = PreviewResult<Product | Format>;\n\n/**\n * Options for batch preview generation\n */\nexport interface BatchPreviewOptions {\n  /** Cache TTL in milliseconds (defaults to 1 hour) */\n  cacheTtl?: number;\n  /** Whether to skip cache and force fresh previews (defaults to false) */\n  skipCache?: boolean;\n  /**\n   * Cache backend for preview results.\n   *\n   * The default backend is process-local memory. It is safe for tests,\n   * local development, and single-process CLIs, but it is not shared\n   * across pods and does not survive restarts. Production services that\n   * cache preview URLs should provide a shared backend such as Redis or\n   * Postgres, and the cached URL itself must still resolve to durable\n   * storage rather than process-local assets.\n   */\n  cacheBackend?: PreviewCacheBackend;\n}\n\n/**\n * Cache entry for preview results\n */\nexport interface PreviewCacheEntry {\n  previewUrl: string;\n  previewId: string;\n  timestamp: number;\n  /** ISO 8601 timestamp from `preview_creative.expires_at`, when provided. */\n  expiresAt?: string;\n}\n\n/**\n * Pluggable cache backend for preview results.\n *\n * This cache stores references returned by `preview_creative`; it is not\n * an asset store. Preview URLs placed in any cache must already be\n * durable across load-balancer hops, pod restarts, and later refinement\n * calls.\n */\nexport interface PreviewCacheBackend {\n  get(cacheKey: string): PreviewCacheEntry | null | undefined | Promise<PreviewCacheEntry | null | undefined>;\n  set(cacheKey: string, entry: PreviewCacheEntry): void | Promise<void>;\n  delete?(cacheKey: string): void | Promise<void>;\n  clear?(): void | Promise<void>;\n}\n\n/**\n * Process-local in-memory cache for preview results.\n *\n * Development-only default: this map is not multi-pod-safe and does not\n * survive process restarts. It must not be used as the backing store for\n * MCPUI preview assets in production.\n *\n * Key format: `${formatId.agent_url}:${formatId.id}:${manifestHash}`\n */\nconst previewCache = new Map<string, PreviewCacheEntry>();\n\nconst defaultPreviewCacheBackend: PreviewCacheBackend = {\n  get(cacheKey) {\n    return previewCache.get(cacheKey);\n  },\n  set(cacheKey, entry) {\n    previewCache.set(cacheKey, entry);\n  },\n  delete(cacheKey) {\n    previewCache.delete(cacheKey);\n  },\n  clear() {\n    previewCache.clear();\n  },\n};\n\n/**\n * Generate a cache key for a preview request\n */\nfunction getCacheKey(formatId: FormatID, manifest: any): string {\n  // Simple hash of manifest for cache key\n  const manifestStr = JSON.stringify(manifest);\n  const manifestHash = Array.from(manifestStr)\n    .reduce((hash, char) => (hash << 5) - hash + char.charCodeAt(0), 0)\n    .toString(36);\n\n  return `${formatId.agent_url}:${formatId.id}:${manifestHash}`;\n}\n\nfunction hasExpiredAt(expiresAt: string | undefined, now: number): boolean {\n  if (!expiresAt) return false;\n  const expiresAtMs = Date.parse(expiresAt);\n  return Number.isNaN(expiresAtMs) ? false : expiresAtMs <= now;\n}\n\n/**\n * Get cached preview if available and not expired\n */\nasync function getCachedPreview(\n  cacheBackend: PreviewCacheBackend,\n  cacheKey: string,\n  ttl: number\n): Promise<PreviewCacheEntry | null> {\n  const entry = await cacheBackend.get(cacheKey);\n  if (!entry) return null;\n\n  const now = Date.now();\n  if (now - entry.timestamp > ttl || hasExpiredAt(entry.expiresAt, now)) {\n    await cacheBackend.delete?.(cacheKey);\n    return null;\n  }\n\n  return entry;\n}\n\n/**\n * Set cached preview\n */\nasync function setCachedPreview(\n  cacheBackend: PreviewCacheBackend,\n  cacheKey: string,\n  previewUrl: string,\n  previewId: string,\n  expiresAt?: string\n): Promise<void> {\n  await cacheBackend.set(cacheKey, {\n    previewUrl,\n    previewId,\n    expiresAt,\n    timestamp: Date.now(),\n  });\n}\n\n/**\n * Clear all previews from the default process-local cache.\n */\nexport function clearPreviewCache(): void {\n  defaultPreviewCacheBackend.clear?.();\n}\n\n/**\n * Extract preview URLs from products' `product_card` fields.\n *\n * AdCP 3.1.0-beta.2 changed `product_card` from a creative-agent-rendered\n * shape (`{ format_id, manifest }`) to a self-contained visual card\n * (`{ image, title, description, price_label, cta_label }`). The card IS\n * the preview — no creative-agent round-trip required. This function now\n * extracts the image URL directly from the inline card.\n *\n * Products with no `product_card`, or with a card that lacks an `image.url`,\n * return a result with no `previewUrl`. The function preserves its\n * `Promise<PreviewResult[]>` return shape so existing adopters' code paths\n * keep compiling and behaving correctly.\n *\n * @param products - Array of products to extract previews from\n * @param creativeAgentClient - Retained for signature compatibility; unused\n *   under 3.1.0-beta.2's self-rendering card model. Will be removed in\n *   8.0 final (or 9.0 at the latest) — pass any value through during the\n *   beta cycle.\n * @param options - Retained for signature compatibility. Cache fields\n *   (`cacheTtl`, `skipCache`) are unused — there's no expensive call to\n *   cache. Will be removed alongside `creativeAgentClient`.\n * @returns Array of preview results matching input products by index.\n *\n * @example\n * ```typescript\n * const previews = await batchPreviewProducts(products, creativeAgent);\n * previews.forEach(p => {\n *   if (p.previewUrl) {\n *     console.log(`${p.item.name}: ${p.previewUrl}`);\n *   }\n * });\n * ```\n *\n * @deprecated Use `product.product_card?.image?.url` directly. This wrapper\n *   only exists for 8.0-beta migration ergonomics and will be removed.\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport async function batchPreviewProducts(\n  products: CanonicalProduct[],\n  _creativeAgentClient: SingleAgentClient,\n  _options: BatchPreviewOptions = {}\n): Promise<PreviewResult[]> {\n  return products.map(product => {\n    const imageUrl = (product.product_card as { image?: { url?: string } } | undefined)?.image?.url;\n    if (imageUrl) {\n      return { item: product, previewUrl: imageUrl };\n    }\n    return { item: product };\n  });\n}\n\n/**\n * Generate batch previews for legacy named formats with format_card manifests.\n *\n * Formats with format_card fields will have their cards rendered via the creative agent.\n * Formats without format_card will be returned with no preview.\n *\n * @param formats - Array of formats to preview\n * @param creativeAgentClient - ADCP client configured for creative agent\n * @param options - Preview generation options\n * @returns Array of preview results matching input formats\n *\n * @example\n * ```typescript\n * const creativeAgent = new SingleAgentClient({\n *   id: 'creative',\n *   name: 'Creative Agent',\n *   agent_uri: 'https://creative.adcontextprotocol.org/mcp',\n *   protocol: 'mcp'\n * });\n *\n * const previews = await batchPreviewFormatsLegacy(formats, creativeAgent);\n * previews.forEach(p => {\n *   if (p.previewUrl) {\n *     console.log(`${(p.item as Format).name}: ${p.previewUrl}`);\n *   }\n * });\n * ```\n */\nexport async function batchPreviewFormatsLegacy(\n  formats: Format[],\n  creativeAgentClient: SingleAgentClient,\n  options: BatchPreviewOptions = {}\n): Promise<LegacyPreviewResult[]> {\n  const cacheTtl = options.cacheTtl ?? 3600000; // 1 hour default\n  const skipCache = options.skipCache ?? false;\n  const cacheBackend = options.cacheBackend ?? defaultPreviewCacheBackend;\n\n  // Collect all formats that have format_card manifests\n  const previewRequests: {\n    format: Format;\n    formatId: FormatID;\n    manifest: any;\n    cacheKey: string;\n    inputName: string;\n  }[] = [];\n\n  const results: LegacyPreviewResult[] = [];\n\n  for (const format of formats) {\n    if (format.format_card) {\n      const cacheKey = getCacheKey(format.format_card.format_id, format.format_card.manifest);\n\n      // Check cache first\n      if (!skipCache) {\n        let cached: PreviewCacheEntry | null = null;\n        try {\n          cached = await getCachedPreview(cacheBackend, cacheKey, cacheTtl);\n        } catch {\n          cached = null;\n        }\n        if (cached) {\n          results.push({\n            item: format,\n            previewUrl: cached.previewUrl,\n            previewId: cached.previewId,\n          });\n          continue;\n        }\n      }\n\n      previewRequests.push({\n        format,\n        formatId: format.format_card.format_id,\n        manifest: format.format_card.manifest,\n        cacheKey,\n        inputName: format.name || 'Format Card',\n      });\n    } else {\n      // No format_card, return format with no preview\n      results.push({\n        item: format,\n      });\n    }\n  }\n\n  // If all were cached or none have format_card, return early\n  if (previewRequests.length === 0) {\n    return results;\n  }\n\n  // Batch preview using preview_creative with inputs array\n  // Group by format_id since preview_creative takes one format_id\n  const groupedByFormat = new Map<string, typeof previewRequests>();\n\n  previewRequests.forEach(req => {\n    const formatKey = `${req.formatId.agent_url}:${req.formatId.id}`;\n    if (!groupedByFormat.has(formatKey)) {\n      groupedByFormat.set(formatKey, []);\n    }\n    groupedByFormat.get(formatKey)!.push(req);\n  });\n\n  // Process each format individually\n  // Note: Each format has different manifest data, so we can't truly batch them\n  // We process them sequentially but could parallelize in the future\n  for (const req of previewRequests) {\n    try {\n      // Build preview_creative request for this format\n      // For format cards, the manifest typically contains the format object as JSON\n      const previewRequest: PreviewCreativeRequest = {\n        request_type: 'single',\n        format_id: req.formatId,\n        creative_manifest: {\n          format_id: req.formatId,\n          assets: req.manifest, // manifest contains the asset map (format, etc)\n        },\n      };\n\n      // Call preview_creative\n      const response = await creativeAgentClient.previewCreativeLegacy(previewRequest);\n\n      // Check for data even if validation failed (response.success may be false due to schema warnings)\n      // Handle both single request (previews) and batch request (results) response formats\n      const responseData = response.data;\n      if (responseData && 'previews' in responseData && responseData.previews && responseData.previews.length > 0) {\n        const preview = responseData.previews[0]!;\n        if (preview.renders && preview.renders.length > 0) {\n          const render = preview.renders[0]!;\n          const previewUrl =\n            render.output_format === 'url' || render.output_format === 'both' ? render.preview_url : undefined;\n          const previewId = preview.preview_id;\n\n          if (previewUrl) {\n            results.push({\n              item: req.format,\n              previewUrl,\n              previewId,\n            });\n            try {\n              await setCachedPreview(cacheBackend, req.cacheKey, previewUrl, previewId, responseData.expires_at);\n            } catch {\n              // Preview cache is an accelerator; successful previews should still return on cache write failures.\n            }\n          } else {\n            results.push({\n              item: req.format,\n              error: 'Preview render has no URL',\n            });\n          }\n        } else {\n          results.push({\n            item: req.format,\n            error: 'No renders in preview response',\n          });\n        }\n      } else {\n        // Only treat as error if we have no data at all\n        results.push({\n          item: req.format,\n          error: response.error || 'Preview generation failed',\n        });\n      }\n    } catch (error) {\n      results.push({\n        item: req.format,\n        error: error instanceof Error ? error.message : 'Unknown error',\n      });\n    }\n  }\n\n  return results;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgFA,MAAM,eAAe,oBAAI,IAA+B;AAExD,MAAM,6BAAkD;AAAA,EACtD,IAAI,UAAU;AACZ,WAAO,aAAa,IAAI,QAAQ;AAAA,EAClC;AAAA,EACA,IAAI,UAAU,OAAO;AACnB,iBAAa,IAAI,UAAU,KAAK;AAAA,EAClC;AAAA,EACA,OAAO,UAAU;AACf,iBAAa,OAAO,QAAQ;AAAA,EAC9B;AAAA,EACA,QAAQ;AACN,iBAAa,MAAM;AAAA,EACrB;AACF;AAKA,SAAS,YAAY,UAAoB,UAAuB;AAE9D,QAAM,cAAc,KAAK,UAAU,QAAQ;AAC3C,QAAM,eAAe,MAAM,KAAK,WAAW,EACxC,OAAO,CAAC,MAAM,UAAU,QAAQ,KAAK,OAAO,KAAK,WAAW,CAAC,GAAG,CAAC,EACjE,SAAS,EAAE;AAEd,SAAO,GAAG,SAAS,SAAS,IAAI,SAAS,EAAE,IAAI,YAAY;AAC7D;AAEA,SAAS,aAAa,WAA+B,KAAsB;AACzE,MAAI,CAAC,UAAW,QAAO;AACvB,QAAM,cAAc,KAAK,MAAM,SAAS;AACxC,SAAO,OAAO,MAAM,WAAW,IAAI,QAAQ,eAAe;AAC5D;AAKA,eAAe,iBACb,cACA,UACA,KACmC;AACnC,QAAM,QAAQ,MAAM,aAAa,IAAI,QAAQ;AAC7C,MAAI,CAAC,MAAO,QAAO;AAEnB,QAAM,MAAM,KAAK,IAAI;AACrB,MAAI,MAAM,MAAM,YAAY,OAAO,aAAa,MAAM,WAAW,GAAG,GAAG;AACrE,UAAM,aAAa,SAAS,QAAQ;AACpC,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAKA,eAAe,iBACb,cACA,UACA,YACA,WACA,WACe;AACf,QAAM,aAAa,IAAI,UAAU;AAAA,IAC/B;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW,KAAK,IAAI;AAAA,EACtB,CAAC;AACH;AAKO,SAAS,oBAA0B;AACxC,6BAA2B,QAAQ;AACrC;AAwCA,eAAsB,qBACpB,UACA,sBACA,WAAgC,CAAC,GACP;AAC1B,SAAO,SAAS,IAAI,aAAW;AAC7B,UAAM,WAAY,QAAQ,cAA2D,OAAO;AAC5F,QAAI,UAAU;AACZ,aAAO,EAAE,MAAM,SAAS,YAAY,SAAS;AAAA,IAC/C;AACA,WAAO,EAAE,MAAM,QAAQ;AAAA,EACzB,CAAC;AACH;AA8BA,eAAsB,0BACpB,SACA,qBACA,UAA+B,CAAC,GACA;AAChC,QAAM,WAAW,QAAQ,YAAY;AACrC,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,eAAe,QAAQ,gBAAgB;AAG7C,QAAM,kBAMA,CAAC;AAEP,QAAM,UAAiC,CAAC;AAExC,aAAW,UAAU,SAAS;AAC5B,QAAI,OAAO,aAAa;AACtB,YAAM,WAAW,YAAY,OAAO,YAAY,WAAW,OAAO,YAAY,QAAQ;AAGtF,UAAI,CAAC,WAAW;AACd,YAAI,SAAmC;AACvC,YAAI;AACF,mBAAS,MAAM,iBAAiB,cAAc,UAAU,QAAQ;AAAA,QAClE,QAAQ;AACN,mBAAS;AAAA,QACX;AACA,YAAI,QAAQ;AACV,kBAAQ,KAAK;AAAA,YACX,MAAM;AAAA,YACN,YAAY,OAAO;AAAA,YACnB,WAAW,OAAO;AAAA,UACpB,CAAC;AACD;AAAA,QACF;AAAA,MACF;AAEA,sBAAgB,KAAK;AAAA,QACnB;AAAA,QACA,UAAU,OAAO,YAAY;AAAA,QAC7B,UAAU,OAAO,YAAY;AAAA,QAC7B;AAAA,QACA,WAAW,OAAO,QAAQ;AAAA,MAC5B,CAAC;AAAA,IACH,OAAO;AAEL,cAAQ,KAAK;AAAA,QACX,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAAA,EACF;AAGA,MAAI,gBAAgB,WAAW,GAAG;AAChC,WAAO;AAAA,EACT;AAIA,QAAM,kBAAkB,oBAAI,IAAoC;AAEhE,kBAAgB,QAAQ,SAAO;AAC7B,UAAM,YAAY,GAAG,IAAI,SAAS,SAAS,IAAI,IAAI,SAAS,EAAE;AAC9D,QAAI,CAAC,gBAAgB,IAAI,SAAS,GAAG;AACnC,sBAAgB,IAAI,WAAW,CAAC,CAAC;AAAA,IACnC;AACA,oBAAgB,IAAI,SAAS,EAAG,KAAK,GAAG;AAAA,EAC1C,CAAC;AAKD,aAAW,OAAO,iBAAiB;AACjC,QAAI;AAGF,YAAM,iBAAyC;AAAA,QAC7C,cAAc;AAAA,QACd,WAAW,IAAI;AAAA,QACf,mBAAmB;AAAA,UACjB,WAAW,IAAI;AAAA,UACf,QAAQ,IAAI;AAAA;AAAA,QACd;AAAA,MACF;AAGA,YAAM,WAAW,MAAM,oBAAoB,sBAAsB,cAAc;AAI/E,YAAM,eAAe,SAAS;AAC9B,UAAI,gBAAgB,cAAc,gBAAgB,aAAa,YAAY,aAAa,SAAS,SAAS,GAAG;AAC3G,cAAM,UAAU,aAAa,SAAS,CAAC;AACvC,YAAI,QAAQ,WAAW,QAAQ,QAAQ,SAAS,GAAG;AACjD,gBAAM,SAAS,QAAQ,QAAQ,CAAC;AAChC,gBAAM,aACJ,OAAO,kBAAkB,SAAS,OAAO,kBAAkB,SAAS,OAAO,cAAc;AAC3F,gBAAM,YAAY,QAAQ;AAE1B,cAAI,YAAY;AACd,oBAAQ,KAAK;AAAA,cACX,MAAM,IAAI;AAAA,cACV;AAAA,cACA;AAAA,YACF,CAAC;AACD,gBAAI;AACF,oBAAM,iBAAiB,cAAc,IAAI,UAAU,YAAY,WAAW,aAAa,UAAU;AAAA,YACnG,QAAQ;AAAA,YAER;AAAA,UACF,OAAO;AACL,oBAAQ,KAAK;AAAA,cACX,MAAM,IAAI;AAAA,cACV,OAAO;AAAA,YACT,CAAC;AAAA,UACH;AAAA,QACF,OAAO;AACL,kBAAQ,KAAK;AAAA,YACX,MAAM,IAAI;AAAA,YACV,OAAO;AAAA,UACT,CAAC;AAAA,QACH;AAAA,MACF,OAAO;AAEL,gBAAQ,KAAK;AAAA,UACX,MAAM,IAAI;AAAA,UACV,OAAO,SAAS,SAAS;AAAA,QAC3B,CAAC;AAAA,MACH;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,KAAK;AAAA,QACX,MAAM,IAAI;AAAA,QACV,OAAO,iBAAiB,QAAQ,MAAM,UAAU;AAAA,MAClD,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

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

@@ -53,7 +53,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;
@@ -113,7 +113,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];
@@ -159,7 +159,7 @@ async function batchPreviewFormats(formats, creativeAgentClient, options = {}) {
   return results;
 }
 export {
-  batchPreviewFormats,
+  batchPreviewFormatsLegacy,
   batchPreviewProducts,
   clearPreviewCache
 };

package/dist/lib/utils/preview-utils.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/utils/preview-utils.ts"],"sourcesContent":["// Preview utilities for rendering product/format cards with creative agent\n\nimport type { SingleAgentClient } from '../core/SingleAgentClient';\nimport type { Format, Product, FormatReferenceStructuredObject as FormatID } from '../types/tools.generated';\nimport type { PreviewCreativeRequest, PreviewCreativeResponse } from '../types/tools.generated';\n\n/**\n * Preview result for a single item (product or format)\n */\nexport interface PreviewResult {\n  /** The item being previewed (Product or Format) */\n  item: Product | Format;\n  /** Preview URL for the rendered card */\n  previewUrl?: string;\n  /** Preview ID from the creative agent */\n  previewId?: string;\n  /** Error message if preview failed */\n  error?: string;\n}\n\n/**\n * Options for batch preview generation\n */\nexport interface BatchPreviewOptions {\n  /** Cache TTL in milliseconds (defaults to 1 hour) */\n  cacheTtl?: number;\n  /** Whether to skip cache and force fresh previews (defaults to false) */\n  skipCache?: boolean;\n  /**\n   * Cache backend for preview results.\n   *\n   * The default backend is process-local memory. It is safe for tests,\n   * local development, and single-process CLIs, but it is not shared\n   * across pods and does not survive restarts. Production services that\n   * cache preview URLs should provide a shared backend such as Redis or\n   * Postgres, and the cached URL itself must still resolve to durable\n   * storage rather than process-local assets.\n   */\n  cacheBackend?: PreviewCacheBackend;\n}\n\n/**\n * Cache entry for preview results\n */\nexport interface PreviewCacheEntry {\n  previewUrl: string;\n  previewId: string;\n  timestamp: number;\n  /** ISO 8601 timestamp from `preview_creative.expires_at`, when provided. */\n  expiresAt?: string;\n}\n\n/**\n * Pluggable cache backend for preview results.\n *\n * This cache stores references returned by `preview_creative`; it is not\n * an asset store. Preview URLs placed in any cache must already be\n * durable across load-balancer hops, pod restarts, and later refinement\n * calls.\n */\nexport interface PreviewCacheBackend {\n  get(cacheKey: string): PreviewCacheEntry | null | undefined | Promise<PreviewCacheEntry | null | undefined>;\n  set(cacheKey: string, entry: PreviewCacheEntry): void | Promise<void>;\n  delete?(cacheKey: string): void | Promise<void>;\n  clear?(): void | Promise<void>;\n}\n\n/**\n * Process-local in-memory cache for preview results.\n *\n * Development-only default: this map is not multi-pod-safe and does not\n * survive process restarts. It must not be used as the backing store for\n * MCPUI preview assets in production.\n *\n * Key format: `${formatId.agent_url}:${formatId.id}:${manifestHash}`\n */\nconst previewCache = new Map<string, PreviewCacheEntry>();\n\nconst defaultPreviewCacheBackend: PreviewCacheBackend = {\n  get(cacheKey) {\n    return previewCache.get(cacheKey);\n  },\n  set(cacheKey, entry) {\n    previewCache.set(cacheKey, entry);\n  },\n  delete(cacheKey) {\n    previewCache.delete(cacheKey);\n  },\n  clear() {\n    previewCache.clear();\n  },\n};\n\n/**\n * Generate a cache key for a preview request\n */\nfunction getCacheKey(formatId: FormatID, manifest: any): string {\n  // Simple hash of manifest for cache key\n  const manifestStr = JSON.stringify(manifest);\n  const manifestHash = Array.from(manifestStr)\n    .reduce((hash, char) => (hash << 5) - hash + char.charCodeAt(0), 0)\n    .toString(36);\n\n  return `${formatId.agent_url}:${formatId.id}:${manifestHash}`;\n}\n\nfunction hasExpiredAt(expiresAt: string | undefined, now: number): boolean {\n  if (!expiresAt) return false;\n  const expiresAtMs = Date.parse(expiresAt);\n  return Number.isNaN(expiresAtMs) ? false : expiresAtMs <= now;\n}\n\n/**\n * Get cached preview if available and not expired\n */\nasync function getCachedPreview(\n  cacheBackend: PreviewCacheBackend,\n  cacheKey: string,\n  ttl: number\n): Promise<PreviewCacheEntry | null> {\n  const entry = await cacheBackend.get(cacheKey);\n  if (!entry) return null;\n\n  const now = Date.now();\n  if (now - entry.timestamp > ttl || hasExpiredAt(entry.expiresAt, now)) {\n    await cacheBackend.delete?.(cacheKey);\n    return null;\n  }\n\n  return entry;\n}\n\n/**\n * Set cached preview\n */\nasync function setCachedPreview(\n  cacheBackend: PreviewCacheBackend,\n  cacheKey: string,\n  previewUrl: string,\n  previewId: string,\n  expiresAt?: string\n): Promise<void> {\n  await cacheBackend.set(cacheKey, {\n    previewUrl,\n    previewId,\n    expiresAt,\n    timestamp: Date.now(),\n  });\n}\n\n/**\n * Clear all previews from the default process-local cache.\n */\nexport function clearPreviewCache(): void {\n  defaultPreviewCacheBackend.clear?.();\n}\n\n/**\n * Extract preview URLs from products' `product_card` fields.\n *\n * AdCP 3.1.0-beta.2 changed `product_card` from a creative-agent-rendered\n * shape (`{ format_id, manifest }`) to a self-contained visual card\n * (`{ image, title, description, price_label, cta_label }`). The card IS\n * the preview — no creative-agent round-trip required. This function now\n * extracts the image URL directly from the inline card.\n *\n * Products with no `product_card`, or with a card that lacks an `image.url`,\n * return a result with no `previewUrl`. The function preserves its\n * `Promise<PreviewResult[]>` return shape so existing adopters' code paths\n * keep compiling and behaving correctly.\n *\n * @param products - Array of products to extract previews from\n * @param creativeAgentClient - Retained for signature compatibility; unused\n *   under 3.1.0-beta.2's self-rendering card model. Will be removed in\n *   8.0 final (or 9.0 at the latest) — pass any value through during the\n *   beta cycle.\n * @param options - Retained for signature compatibility. Cache fields\n *   (`cacheTtl`, `skipCache`) are unused — there's no expensive call to\n *   cache. Will be removed alongside `creativeAgentClient`.\n * @returns Array of preview results matching input products by index.\n *\n * @example\n * ```typescript\n * const previews = await batchPreviewProducts(products, creativeAgent);\n * previews.forEach(p => {\n *   if (p.previewUrl) {\n *     console.log(`${p.item.name}: ${p.previewUrl}`);\n *   }\n * });\n * ```\n *\n * @deprecated Use `product.product_card?.image?.url` directly. This wrapper\n *   only exists for 8.0-beta migration ergonomics and will be removed.\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport async function batchPreviewProducts(\n  products: Product[],\n  _creativeAgentClient: SingleAgentClient,\n  _options: BatchPreviewOptions = {}\n): Promise<PreviewResult[]> {\n  return products.map(product => {\n    const imageUrl = product.product_card?.image?.url;\n    if (imageUrl) {\n      return { item: product, previewUrl: imageUrl };\n    }\n    return { item: product };\n  });\n}\n\n/**\n * Generate batch previews for formats with format_card manifests\n *\n * Formats with format_card fields will have their cards rendered via the creative agent.\n * Formats without format_card will be returned with no preview.\n *\n * @param formats - Array of formats to preview\n * @param creativeAgentClient - ADCP client configured for creative agent\n * @param options - Preview generation options\n * @returns Array of preview results matching input formats\n *\n * @example\n * ```typescript\n * const creativeAgent = new SingleAgentClient({\n *   id: 'creative',\n *   name: 'Creative Agent',\n *   agent_uri: 'https://creative.adcontextprotocol.org/mcp',\n *   protocol: 'mcp'\n * });\n *\n * const previews = await batchPreviewFormats(formats, creativeAgent);\n * previews.forEach(p => {\n *   if (p.previewUrl) {\n *     console.log(`${(p.item as Format).name}: ${p.previewUrl}`);\n *   }\n * });\n * ```\n */\nexport async function batchPreviewFormats(\n  formats: Format[],\n  creativeAgentClient: SingleAgentClient,\n  options: BatchPreviewOptions = {}\n): Promise<PreviewResult[]> {\n  const cacheTtl = options.cacheTtl ?? 3600000; // 1 hour default\n  const skipCache = options.skipCache ?? false;\n  const cacheBackend = options.cacheBackend ?? defaultPreviewCacheBackend;\n\n  // Collect all formats that have format_card manifests\n  const previewRequests: {\n    format: Format;\n    formatId: FormatID;\n    manifest: any;\n    cacheKey: string;\n    inputName: string;\n  }[] = [];\n\n  const results: PreviewResult[] = [];\n\n  for (const format of formats) {\n    if (format.format_card) {\n      const cacheKey = getCacheKey(format.format_card.format_id, format.format_card.manifest);\n\n      // Check cache first\n      if (!skipCache) {\n        let cached: PreviewCacheEntry | null = null;\n        try {\n          cached = await getCachedPreview(cacheBackend, cacheKey, cacheTtl);\n        } catch {\n          cached = null;\n        }\n        if (cached) {\n          results.push({\n            item: format,\n            previewUrl: cached.previewUrl,\n            previewId: cached.previewId,\n          });\n          continue;\n        }\n      }\n\n      previewRequests.push({\n        format,\n        formatId: format.format_card.format_id,\n        manifest: format.format_card.manifest,\n        cacheKey,\n        inputName: format.name || 'Format Card',\n      });\n    } else {\n      // No format_card, return format with no preview\n      results.push({\n        item: format,\n      });\n    }\n  }\n\n  // If all were cached or none have format_card, return early\n  if (previewRequests.length === 0) {\n    return results;\n  }\n\n  // Batch preview using preview_creative with inputs array\n  // Group by format_id since preview_creative takes one format_id\n  const groupedByFormat = new Map<string, typeof previewRequests>();\n\n  previewRequests.forEach(req => {\n    const formatKey = `${req.formatId.agent_url}:${req.formatId.id}`;\n    if (!groupedByFormat.has(formatKey)) {\n      groupedByFormat.set(formatKey, []);\n    }\n    groupedByFormat.get(formatKey)!.push(req);\n  });\n\n  // Process each format individually\n  // Note: Each format has different manifest data, so we can't truly batch them\n  // We process them sequentially but could parallelize in the future\n  for (const req of previewRequests) {\n    try {\n      // Build preview_creative request for this format\n      // For format cards, the manifest typically contains the format object as JSON\n      const previewRequest: PreviewCreativeRequest = {\n        request_type: 'single',\n        format_id: req.formatId,\n        creative_manifest: {\n          format_id: req.formatId,\n          assets: req.manifest, // manifest contains the asset map (format, etc)\n        },\n      };\n\n      // Call preview_creative\n      const response = await creativeAgentClient.previewCreative(previewRequest);\n\n      // Check for data even if validation failed (response.success may be false due to schema warnings)\n      // Handle both single request (previews) and batch request (results) response formats\n      const responseData = response.data;\n      if (responseData && 'previews' in responseData && responseData.previews && responseData.previews.length > 0) {\n        const preview = responseData.previews[0]!;\n        if (preview.renders && preview.renders.length > 0) {\n          const render = preview.renders[0]!;\n          const previewUrl =\n            render.output_format === 'url' || render.output_format === 'both' ? render.preview_url : undefined;\n          const previewId = preview.preview_id;\n\n          if (previewUrl) {\n            results.push({\n              item: req.format,\n              previewUrl,\n              previewId,\n            });\n            try {\n              await setCachedPreview(cacheBackend, req.cacheKey, previewUrl, previewId, responseData.expires_at);\n            } catch {\n              // Preview cache is an accelerator; successful previews should still return on cache write failures.\n            }\n          } else {\n            results.push({\n              item: req.format,\n              error: 'Preview render has no URL',\n            });\n          }\n        } else {\n          results.push({\n            item: req.format,\n            error: 'No renders in preview response',\n          });\n        }\n      } else {\n        // Only treat as error if we have no data at all\n        results.push({\n          item: req.format,\n          error: response.error || 'Preview generation failed',\n        });\n      }\n    } catch (error) {\n      results.push({\n        item: req.format,\n        error: error instanceof Error ? error.message : 'Unknown error',\n      });\n    }\n  }\n\n  return results;\n}\n"],"mappings":"AA4EA,MAAM,eAAe,oBAAI,IAA+B;AAExD,MAAM,6BAAkD;AAAA,EACtD,IAAI,UAAU;AACZ,WAAO,aAAa,IAAI,QAAQ;AAAA,EAClC;AAAA,EACA,IAAI,UAAU,OAAO;AACnB,iBAAa,IAAI,UAAU,KAAK;AAAA,EAClC;AAAA,EACA,OAAO,UAAU;AACf,iBAAa,OAAO,QAAQ;AAAA,EAC9B;AAAA,EACA,QAAQ;AACN,iBAAa,MAAM;AAAA,EACrB;AACF;AAKA,SAAS,YAAY,UAAoB,UAAuB;AAE9D,QAAM,cAAc,KAAK,UAAU,QAAQ;AAC3C,QAAM,eAAe,MAAM,KAAK,WAAW,EACxC,OAAO,CAAC,MAAM,UAAU,QAAQ,KAAK,OAAO,KAAK,WAAW,CAAC,GAAG,CAAC,EACjE,SAAS,EAAE;AAEd,SAAO,GAAG,SAAS,SAAS,IAAI,SAAS,EAAE,IAAI,YAAY;AAC7D;AAEA,SAAS,aAAa,WAA+B,KAAsB;AACzE,MAAI,CAAC,UAAW,QAAO;AACvB,QAAM,cAAc,KAAK,MAAM,SAAS;AACxC,SAAO,OAAO,MAAM,WAAW,IAAI,QAAQ,eAAe;AAC5D;AAKA,eAAe,iBACb,cACA,UACA,KACmC;AACnC,QAAM,QAAQ,MAAM,aAAa,IAAI,QAAQ;AAC7C,MAAI,CAAC,MAAO,QAAO;AAEnB,QAAM,MAAM,KAAK,IAAI;AACrB,MAAI,MAAM,MAAM,YAAY,OAAO,aAAa,MAAM,WAAW,GAAG,GAAG;AACrE,UAAM,aAAa,SAAS,QAAQ;AACpC,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAKA,eAAe,iBACb,cACA,UACA,YACA,WACA,WACe;AACf,QAAM,aAAa,IAAI,UAAU;AAAA,IAC/B;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW,KAAK,IAAI;AAAA,EACtB,CAAC;AACH;AAKO,SAAS,oBAA0B;AACxC,6BAA2B,QAAQ;AACrC;AAwCA,eAAsB,qBACpB,UACA,sBACA,WAAgC,CAAC,GACP;AAC1B,SAAO,SAAS,IAAI,aAAW;AAC7B,UAAM,WAAW,QAAQ,cAAc,OAAO;AAC9C,QAAI,UAAU;AACZ,aAAO,EAAE,MAAM,SAAS,YAAY,SAAS;AAAA,IAC/C;AACA,WAAO,EAAE,MAAM,QAAQ;AAAA,EACzB,CAAC;AACH;AA8BA,eAAsB,oBACpB,SACA,qBACA,UAA+B,CAAC,GACN;AAC1B,QAAM,WAAW,QAAQ,YAAY;AACrC,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,eAAe,QAAQ,gBAAgB;AAG7C,QAAM,kBAMA,CAAC;AAEP,QAAM,UAA2B,CAAC;AAElC,aAAW,UAAU,SAAS;AAC5B,QAAI,OAAO,aAAa;AACtB,YAAM,WAAW,YAAY,OAAO,YAAY,WAAW,OAAO,YAAY,QAAQ;AAGtF,UAAI,CAAC,WAAW;AACd,YAAI,SAAmC;AACvC,YAAI;AACF,mBAAS,MAAM,iBAAiB,cAAc,UAAU,QAAQ;AAAA,QAClE,QAAQ;AACN,mBAAS;AAAA,QACX;AACA,YAAI,QAAQ;AACV,kBAAQ,KAAK;AAAA,YACX,MAAM;AAAA,YACN,YAAY,OAAO;AAAA,YACnB,WAAW,OAAO;AAAA,UACpB,CAAC;AACD;AAAA,QACF;AAAA,MACF;AAEA,sBAAgB,KAAK;AAAA,QACnB;AAAA,QACA,UAAU,OAAO,YAAY;AAAA,QAC7B,UAAU,OAAO,YAAY;AAAA,QAC7B;AAAA,QACA,WAAW,OAAO,QAAQ;AAAA,MAC5B,CAAC;AAAA,IACH,OAAO;AAEL,cAAQ,KAAK;AAAA,QACX,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAAA,EACF;AAGA,MAAI,gBAAgB,WAAW,GAAG;AAChC,WAAO;AAAA,EACT;AAIA,QAAM,kBAAkB,oBAAI,IAAoC;AAEhE,kBAAgB,QAAQ,SAAO;AAC7B,UAAM,YAAY,GAAG,IAAI,SAAS,SAAS,IAAI,IAAI,SAAS,EAAE;AAC9D,QAAI,CAAC,gBAAgB,IAAI,SAAS,GAAG;AACnC,sBAAgB,IAAI,WAAW,CAAC,CAAC;AAAA,IACnC;AACA,oBAAgB,IAAI,SAAS,EAAG,KAAK,GAAG;AAAA,EAC1C,CAAC;AAKD,aAAW,OAAO,iBAAiB;AACjC,QAAI;AAGF,YAAM,iBAAyC;AAAA,QAC7C,cAAc;AAAA,QACd,WAAW,IAAI;AAAA,QACf,mBAAmB;AAAA,UACjB,WAAW,IAAI;AAAA,UACf,QAAQ,IAAI;AAAA;AAAA,QACd;AAAA,MACF;AAGA,YAAM,WAAW,MAAM,oBAAoB,gBAAgB,cAAc;AAIzE,YAAM,eAAe,SAAS;AAC9B,UAAI,gBAAgB,cAAc,gBAAgB,aAAa,YAAY,aAAa,SAAS,SAAS,GAAG;AAC3G,cAAM,UAAU,aAAa,SAAS,CAAC;AACvC,YAAI,QAAQ,WAAW,QAAQ,QAAQ,SAAS,GAAG;AACjD,gBAAM,SAAS,QAAQ,QAAQ,CAAC;AAChC,gBAAM,aACJ,OAAO,kBAAkB,SAAS,OAAO,kBAAkB,SAAS,OAAO,cAAc;AAC3F,gBAAM,YAAY,QAAQ;AAE1B,cAAI,YAAY;AACd,oBAAQ,KAAK;AAAA,cACX,MAAM,IAAI;AAAA,cACV;AAAA,cACA;AAAA,YACF,CAAC;AACD,gBAAI;AACF,oBAAM,iBAAiB,cAAc,IAAI,UAAU,YAAY,WAAW,aAAa,UAAU;AAAA,YACnG,QAAQ;AAAA,YAER;AAAA,UACF,OAAO;AACL,oBAAQ,KAAK;AAAA,cACX,MAAM,IAAI;AAAA,cACV,OAAO;AAAA,YACT,CAAC;AAAA,UACH;AAAA,QACF,OAAO;AACL,kBAAQ,KAAK;AAAA,YACX,MAAM,IAAI;AAAA,YACV,OAAO;AAAA,UACT,CAAC;AAAA,QACH;AAAA,MACF,OAAO;AAEL,gBAAQ,KAAK;AAAA,UACX,MAAM,IAAI;AAAA,UACV,OAAO,SAAS,SAAS;AAAA,QAC3B,CAAC;AAAA,MACH;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,KAAK;AAAA,QACX,MAAM,IAAI;AAAA,QACV,OAAO,iBAAiB,QAAQ,MAAM,UAAU;AAAA,MAClD,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../../src/lib/utils/preview-utils.ts"],"sourcesContent":["// Preview utilities for rendering product/format cards with creative agent\n\nimport type { SingleAgentClient } from '../core/SingleAgentClient';\nimport type { Format, Product, FormatReferenceStructuredObject as FormatID } from '../types/tools.generated';\nimport type { PreviewCreativeRequest, PreviewCreativeResponse } from '../types/tools.generated';\nimport type { CanonicalProduct } from '../v2/projection/creative-delivery';\n\n/**\n * Preview result for a single canonical item.\n */\nexport interface PreviewResult<TItem = CanonicalProduct> {\n  /** The item being previewed. */\n  item: TItem;\n  /** Preview URL for the rendered card */\n  previewUrl?: string;\n  /** Preview ID from the creative agent */\n  previewId?: string;\n  /** Error message if preview failed */\n  error?: string;\n}\n\n/** Raw named-format preview result for explicit migration tooling. */\nexport type LegacyPreviewResult = PreviewResult<Product | Format>;\n\n/**\n * Options for batch preview generation\n */\nexport interface BatchPreviewOptions {\n  /** Cache TTL in milliseconds (defaults to 1 hour) */\n  cacheTtl?: number;\n  /** Whether to skip cache and force fresh previews (defaults to false) */\n  skipCache?: boolean;\n  /**\n   * Cache backend for preview results.\n   *\n   * The default backend is process-local memory. It is safe for tests,\n   * local development, and single-process CLIs, but it is not shared\n   * across pods and does not survive restarts. Production services that\n   * cache preview URLs should provide a shared backend such as Redis or\n   * Postgres, and the cached URL itself must still resolve to durable\n   * storage rather than process-local assets.\n   */\n  cacheBackend?: PreviewCacheBackend;\n}\n\n/**\n * Cache entry for preview results\n */\nexport interface PreviewCacheEntry {\n  previewUrl: string;\n  previewId: string;\n  timestamp: number;\n  /** ISO 8601 timestamp from `preview_creative.expires_at`, when provided. */\n  expiresAt?: string;\n}\n\n/**\n * Pluggable cache backend for preview results.\n *\n * This cache stores references returned by `preview_creative`; it is not\n * an asset store. Preview URLs placed in any cache must already be\n * durable across load-balancer hops, pod restarts, and later refinement\n * calls.\n */\nexport interface PreviewCacheBackend {\n  get(cacheKey: string): PreviewCacheEntry | null | undefined | Promise<PreviewCacheEntry | null | undefined>;\n  set(cacheKey: string, entry: PreviewCacheEntry): void | Promise<void>;\n  delete?(cacheKey: string): void | Promise<void>;\n  clear?(): void | Promise<void>;\n}\n\n/**\n * Process-local in-memory cache for preview results.\n *\n * Development-only default: this map is not multi-pod-safe and does not\n * survive process restarts. It must not be used as the backing store for\n * MCPUI preview assets in production.\n *\n * Key format: `${formatId.agent_url}:${formatId.id}:${manifestHash}`\n */\nconst previewCache = new Map<string, PreviewCacheEntry>();\n\nconst defaultPreviewCacheBackend: PreviewCacheBackend = {\n  get(cacheKey) {\n    return previewCache.get(cacheKey);\n  },\n  set(cacheKey, entry) {\n    previewCache.set(cacheKey, entry);\n  },\n  delete(cacheKey) {\n    previewCache.delete(cacheKey);\n  },\n  clear() {\n    previewCache.clear();\n  },\n};\n\n/**\n * Generate a cache key for a preview request\n */\nfunction getCacheKey(formatId: FormatID, manifest: any): string {\n  // Simple hash of manifest for cache key\n  const manifestStr = JSON.stringify(manifest);\n  const manifestHash = Array.from(manifestStr)\n    .reduce((hash, char) => (hash << 5) - hash + char.charCodeAt(0), 0)\n    .toString(36);\n\n  return `${formatId.agent_url}:${formatId.id}:${manifestHash}`;\n}\n\nfunction hasExpiredAt(expiresAt: string | undefined, now: number): boolean {\n  if (!expiresAt) return false;\n  const expiresAtMs = Date.parse(expiresAt);\n  return Number.isNaN(expiresAtMs) ? false : expiresAtMs <= now;\n}\n\n/**\n * Get cached preview if available and not expired\n */\nasync function getCachedPreview(\n  cacheBackend: PreviewCacheBackend,\n  cacheKey: string,\n  ttl: number\n): Promise<PreviewCacheEntry | null> {\n  const entry = await cacheBackend.get(cacheKey);\n  if (!entry) return null;\n\n  const now = Date.now();\n  if (now - entry.timestamp > ttl || hasExpiredAt(entry.expiresAt, now)) {\n    await cacheBackend.delete?.(cacheKey);\n    return null;\n  }\n\n  return entry;\n}\n\n/**\n * Set cached preview\n */\nasync function setCachedPreview(\n  cacheBackend: PreviewCacheBackend,\n  cacheKey: string,\n  previewUrl: string,\n  previewId: string,\n  expiresAt?: string\n): Promise<void> {\n  await cacheBackend.set(cacheKey, {\n    previewUrl,\n    previewId,\n    expiresAt,\n    timestamp: Date.now(),\n  });\n}\n\n/**\n * Clear all previews from the default process-local cache.\n */\nexport function clearPreviewCache(): void {\n  defaultPreviewCacheBackend.clear?.();\n}\n\n/**\n * Extract preview URLs from products' `product_card` fields.\n *\n * AdCP 3.1.0-beta.2 changed `product_card` from a creative-agent-rendered\n * shape (`{ format_id, manifest }`) to a self-contained visual card\n * (`{ image, title, description, price_label, cta_label }`). The card IS\n * the preview — no creative-agent round-trip required. This function now\n * extracts the image URL directly from the inline card.\n *\n * Products with no `product_card`, or with a card that lacks an `image.url`,\n * return a result with no `previewUrl`. The function preserves its\n * `Promise<PreviewResult[]>` return shape so existing adopters' code paths\n * keep compiling and behaving correctly.\n *\n * @param products - Array of products to extract previews from\n * @param creativeAgentClient - Retained for signature compatibility; unused\n *   under 3.1.0-beta.2's self-rendering card model. Will be removed in\n *   8.0 final (or 9.0 at the latest) — pass any value through during the\n *   beta cycle.\n * @param options - Retained for signature compatibility. Cache fields\n *   (`cacheTtl`, `skipCache`) are unused — there's no expensive call to\n *   cache. Will be removed alongside `creativeAgentClient`.\n * @returns Array of preview results matching input products by index.\n *\n * @example\n * ```typescript\n * const previews = await batchPreviewProducts(products, creativeAgent);\n * previews.forEach(p => {\n *   if (p.previewUrl) {\n *     console.log(`${p.item.name}: ${p.previewUrl}`);\n *   }\n * });\n * ```\n *\n * @deprecated Use `product.product_card?.image?.url` directly. This wrapper\n *   only exists for 8.0-beta migration ergonomics and will be removed.\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport async function batchPreviewProducts(\n  products: CanonicalProduct[],\n  _creativeAgentClient: SingleAgentClient,\n  _options: BatchPreviewOptions = {}\n): Promise<PreviewResult[]> {\n  return products.map(product => {\n    const imageUrl = (product.product_card as { image?: { url?: string } } | undefined)?.image?.url;\n    if (imageUrl) {\n      return { item: product, previewUrl: imageUrl };\n    }\n    return { item: product };\n  });\n}\n\n/**\n * Generate batch previews for legacy named formats with format_card manifests.\n *\n * Formats with format_card fields will have their cards rendered via the creative agent.\n * Formats without format_card will be returned with no preview.\n *\n * @param formats - Array of formats to preview\n * @param creativeAgentClient - ADCP client configured for creative agent\n * @param options - Preview generation options\n * @returns Array of preview results matching input formats\n *\n * @example\n * ```typescript\n * const creativeAgent = new SingleAgentClient({\n *   id: 'creative',\n *   name: 'Creative Agent',\n *   agent_uri: 'https://creative.adcontextprotocol.org/mcp',\n *   protocol: 'mcp'\n * });\n *\n * const previews = await batchPreviewFormatsLegacy(formats, creativeAgent);\n * previews.forEach(p => {\n *   if (p.previewUrl) {\n *     console.log(`${(p.item as Format).name}: ${p.previewUrl}`);\n *   }\n * });\n * ```\n */\nexport async function batchPreviewFormatsLegacy(\n  formats: Format[],\n  creativeAgentClient: SingleAgentClient,\n  options: BatchPreviewOptions = {}\n): Promise<LegacyPreviewResult[]> {\n  const cacheTtl = options.cacheTtl ?? 3600000; // 1 hour default\n  const skipCache = options.skipCache ?? false;\n  const cacheBackend = options.cacheBackend ?? defaultPreviewCacheBackend;\n\n  // Collect all formats that have format_card manifests\n  const previewRequests: {\n    format: Format;\n    formatId: FormatID;\n    manifest: any;\n    cacheKey: string;\n    inputName: string;\n  }[] = [];\n\n  const results: LegacyPreviewResult[] = [];\n\n  for (const format of formats) {\n    if (format.format_card) {\n      const cacheKey = getCacheKey(format.format_card.format_id, format.format_card.manifest);\n\n      // Check cache first\n      if (!skipCache) {\n        let cached: PreviewCacheEntry | null = null;\n        try {\n          cached = await getCachedPreview(cacheBackend, cacheKey, cacheTtl);\n        } catch {\n          cached = null;\n        }\n        if (cached) {\n          results.push({\n            item: format,\n            previewUrl: cached.previewUrl,\n            previewId: cached.previewId,\n          });\n          continue;\n        }\n      }\n\n      previewRequests.push({\n        format,\n        formatId: format.format_card.format_id,\n        manifest: format.format_card.manifest,\n        cacheKey,\n        inputName: format.name || 'Format Card',\n      });\n    } else {\n      // No format_card, return format with no preview\n      results.push({\n        item: format,\n      });\n    }\n  }\n\n  // If all were cached or none have format_card, return early\n  if (previewRequests.length === 0) {\n    return results;\n  }\n\n  // Batch preview using preview_creative with inputs array\n  // Group by format_id since preview_creative takes one format_id\n  const groupedByFormat = new Map<string, typeof previewRequests>();\n\n  previewRequests.forEach(req => {\n    const formatKey = `${req.formatId.agent_url}:${req.formatId.id}`;\n    if (!groupedByFormat.has(formatKey)) {\n      groupedByFormat.set(formatKey, []);\n    }\n    groupedByFormat.get(formatKey)!.push(req);\n  });\n\n  // Process each format individually\n  // Note: Each format has different manifest data, so we can't truly batch them\n  // We process them sequentially but could parallelize in the future\n  for (const req of previewRequests) {\n    try {\n      // Build preview_creative request for this format\n      // For format cards, the manifest typically contains the format object as JSON\n      const previewRequest: PreviewCreativeRequest = {\n        request_type: 'single',\n        format_id: req.formatId,\n        creative_manifest: {\n          format_id: req.formatId,\n          assets: req.manifest, // manifest contains the asset map (format, etc)\n        },\n      };\n\n      // Call preview_creative\n      const response = await creativeAgentClient.previewCreativeLegacy(previewRequest);\n\n      // Check for data even if validation failed (response.success may be false due to schema warnings)\n      // Handle both single request (previews) and batch request (results) response formats\n      const responseData = response.data;\n      if (responseData && 'previews' in responseData && responseData.previews && responseData.previews.length > 0) {\n        const preview = responseData.previews[0]!;\n        if (preview.renders && preview.renders.length > 0) {\n          const render = preview.renders[0]!;\n          const previewUrl =\n            render.output_format === 'url' || render.output_format === 'both' ? render.preview_url : undefined;\n          const previewId = preview.preview_id;\n\n          if (previewUrl) {\n            results.push({\n              item: req.format,\n              previewUrl,\n              previewId,\n            });\n            try {\n              await setCachedPreview(cacheBackend, req.cacheKey, previewUrl, previewId, responseData.expires_at);\n            } catch {\n              // Preview cache is an accelerator; successful previews should still return on cache write failures.\n            }\n          } else {\n            results.push({\n              item: req.format,\n              error: 'Preview render has no URL',\n            });\n          }\n        } else {\n          results.push({\n            item: req.format,\n            error: 'No renders in preview response',\n          });\n        }\n      } else {\n        // Only treat as error if we have no data at all\n        results.push({\n          item: req.format,\n          error: response.error || 'Preview generation failed',\n        });\n      }\n    } catch (error) {\n      results.push({\n        item: req.format,\n        error: error instanceof Error ? error.message : 'Unknown error',\n      });\n    }\n  }\n\n  return results;\n}\n"],"mappings":"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","names":[]}

package/dist/lib/utils/tool-request-schemas.d.mts

@@ -10400,9 +10400,9 @@ declare const UpdateMediaBuyToolRequestSchema: z.ZodObject<WithOptionalAccountSh
     cancellation_reason: z.ZodType<string | undefined, string | undefined, z.core.$ZodTypeInternals<string | undefined, string | undefined>>;
     start_time: z.ZodType<string | undefined, string | undefined, z.core.$ZodTypeInternals<string | undefined, string | undefined>>;
     end_time: z.ZodType<string | undefined, string | undefined, z.core.$ZodTypeInternals<string | undefined, string | undefined>>;
-    packages: z.ZodType<import("../index.mjs").PackageUpdate[] | undefined, import("../index.mjs").PackageUpdate[] | undefined, z.core.$ZodTypeInternals<import("../index.mjs").PackageUpdate[] | undefined, import("../index.mjs").PackageUpdate[] | undefined>>;
+    packages: z.ZodType<import("../index.mjs").LegacyPackageUpdate[] | undefined, import("../index.mjs").LegacyPackageUpdate[] | undefined, z.core.$ZodTypeInternals<import("../index.mjs").LegacyPackageUpdate[] | undefined, import("../index.mjs").LegacyPackageUpdate[] | undefined>>;
     invoice_recipient: z.ZodType<import("../types/tools.generated.mjs").BusinessEntity | undefined, import("../types/tools.generated.mjs").BusinessEntity | undefined, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").BusinessEntity | undefined, import("../types/tools.generated.mjs").BusinessEntity | undefined>>;
-    new_packages: z.ZodType<import("../index.mjs").PackageRequest[] | undefined, import("../index.mjs").PackageRequest[] | undefined, z.core.$ZodTypeInternals<import("../index.mjs").PackageRequest[] | undefined, import("../index.mjs").PackageRequest[] | undefined>>;
+    new_packages: z.ZodType<import("../index.mjs").LegacyPackageRequest[] | undefined, import("../index.mjs").LegacyPackageRequest[] | undefined, z.core.$ZodTypeInternals<import("../index.mjs").LegacyPackageRequest[] | undefined, import("../index.mjs").LegacyPackageRequest[] | undefined>>;
     reporting_webhook: z.ZodType<import("../types/tools.generated.mjs").ReportingWebhook | undefined, import("../types/tools.generated.mjs").ReportingWebhook | undefined, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").ReportingWebhook | undefined, import("../types/tools.generated.mjs").ReportingWebhook | undefined>>;
     push_notification_config: z.ZodType<import("../types/tools.generated.mjs").PushNotificationConfig | undefined, import("../types/tools.generated.mjs").PushNotificationConfig | undefined, z.core.$ZodTypeInternals<import("../types/tools.generated.mjs").PushNotificationConfig | undefined, import("../types/tools.generated.mjs").PushNotificationConfig | undefined>>;
     idempotency_key: z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;

package/dist/lib/utils/tool-request-schemas.d.ts

@@ -10400,9 +10400,9 @@ declare const UpdateMediaBuyToolRequestSchema: z.ZodObject<WithOptionalAccountSh
     cancellation_reason: z.ZodType<string | undefined, string | undefined, z.core.$ZodTypeInternals<string | undefined, string | undefined>>;
     start_time: z.ZodType<string | undefined, string | undefined, z.core.$ZodTypeInternals<string | undefined, string | undefined>>;
     end_time: z.ZodType<string | undefined, string | undefined, z.core.$ZodTypeInternals<string | undefined, string | undefined>>;
-    packages: z.ZodType<import("..").PackageUpdate[] | undefined, import("..").PackageUpdate[] | undefined, z.core.$ZodTypeInternals<import("..").PackageUpdate[] | undefined, import("..").PackageUpdate[] | undefined>>;
+    packages: z.ZodType<import("..").LegacyPackageUpdate[] | undefined, import("..").LegacyPackageUpdate[] | undefined, z.core.$ZodTypeInternals<import("..").LegacyPackageUpdate[] | undefined, import("..").LegacyPackageUpdate[] | undefined>>;
     invoice_recipient: z.ZodType<import("../types/tools.generated").BusinessEntity | undefined, import("../types/tools.generated").BusinessEntity | undefined, z.core.$ZodTypeInternals<import("../types/tools.generated").BusinessEntity | undefined, import("../types/tools.generated").BusinessEntity | undefined>>;
-    new_packages: z.ZodType<import("..").PackageRequest[] | undefined, import("..").PackageRequest[] | undefined, z.core.$ZodTypeInternals<import("..").PackageRequest[] | undefined, import("..").PackageRequest[] | undefined>>;
+    new_packages: z.ZodType<import("..").LegacyPackageRequest[] | undefined, import("..").LegacyPackageRequest[] | undefined, z.core.$ZodTypeInternals<import("..").LegacyPackageRequest[] | undefined, import("..").LegacyPackageRequest[] | undefined>>;
     reporting_webhook: z.ZodType<import("../types/tools.generated").ReportingWebhook | undefined, import("../types/tools.generated").ReportingWebhook | undefined, z.core.$ZodTypeInternals<import("../types/tools.generated").ReportingWebhook | undefined, import("../types/tools.generated").ReportingWebhook | undefined>>;
     push_notification_config: z.ZodType<import("../types/tools.generated").PushNotificationConfig | undefined, import("../types/tools.generated").PushNotificationConfig | undefined, z.core.$ZodTypeInternals<import("../types/tools.generated").PushNotificationConfig | undefined, import("../types/tools.generated").PushNotificationConfig | undefined>>;
     idempotency_key: z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;