@adcp/sdk 13.0.0-rc.13 → 13.0.0-rc.14

package/dist/lib/testing/storyboard/validations.d.mts

@@ -195,7 +195,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "13.0.0-rc.13";
+export declare const RUNNER_CAPABILITY_VERSION = "13.0.0-rc.14";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/testing/storyboard/validations.d.ts

@@ -195,7 +195,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "13.0.0-rc.13";
+export declare const RUNNER_CAPABILITY_VERSION = "13.0.0-rc.14";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/v2/projection/augment-response.d.mts

@@ -101,6 +101,22 @@ export declare function withFormatOptions<R extends {
 export type AdditiveCanonicalProduct<P> = Omit<P, 'format_options'> & {
     format_options: CanonicalFormatDeclaration[];
 };
+/**
+ * Conceal migration-only legacy identities from canonical format declarations
+ * while extracting their durable downgrade routes first.
+ *
+ * This is the declaration-array counterpart to
+ * {@link toAdditiveCanonicalProduct}. It is intended for persisted catalogs
+ * and other consumers that do not hold a complete Product. The source array
+ * and declarations are never mutated.
+ *
+ * @throws TypeError when a canonical declaration uses a direct legacy identity
+ * alias such as `agent_url` or `agentUrl` instead of `v1_format_ref`.
+ */
+export declare function toCanonicalFormatOptionsWithRoutes(productId: string, formatOptions: readonly V2ProductFormatDeclaration[]): {
+    formatOptions: CanonicalFormatDeclaration[];
+    routes: CanonicalFormatLegacyRoute[];
+};
 /**
  * Project a Product to an additive, URL-free canonical surface.
  *

package/dist/lib/v2/projection/augment-response.d.ts

@@ -101,6 +101,22 @@ export declare function withFormatOptions<R extends {
 export type AdditiveCanonicalProduct<P> = Omit<P, 'format_options'> & {
     format_options: CanonicalFormatDeclaration[];
 };
+/**
+ * Conceal migration-only legacy identities from canonical format declarations
+ * while extracting their durable downgrade routes first.
+ *
+ * This is the declaration-array counterpart to
+ * {@link toAdditiveCanonicalProduct}. It is intended for persisted catalogs
+ * and other consumers that do not hold a complete Product. The source array
+ * and declarations are never mutated.
+ *
+ * @throws TypeError when a canonical declaration uses a direct legacy identity
+ * alias such as `agent_url` or `agentUrl` instead of `v1_format_ref`.
+ */
+export declare function toCanonicalFormatOptionsWithRoutes(productId: string, formatOptions: readonly V2ProductFormatDeclaration[]): {
+    formatOptions: CanonicalFormatDeclaration[];
+    routes: CanonicalFormatLegacyRoute[];
+};
 /**
  * Project a Product to an additive, URL-free canonical surface.
  *

package/dist/lib/v2/projection/augment-response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"augment-response.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/augment-response.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"augment-response.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/augment-response.ts"],"names":[],"mappings":"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"}

package/dist/lib/v2/projection/augment-response.js

@@ -21,6 +21,7 @@ __export(augment_response_exports, {
   augmentProductWithFormatOptions: () => augmentProductWithFormatOptions,
   projectionDiagnosticToError: () => projectionDiagnosticToError,
   toAdditiveCanonicalProduct: () => toAdditiveCanonicalProduct,
+  toCanonicalFormatOptionsWithRoutes: () => toCanonicalFormatOptionsWithRoutes,
   toCanonicalOnlyProduct: () => toCanonicalOnlyProduct,
   toCanonicalOnlyResponse: () => toCanonicalOnlyResponse,
   withAdditiveCanonicalFormatOptions: () => withAdditiveCanonicalFormatOptions,
@@ -213,17 +214,24 @@ function assertNoDirectLegacyFormatAliases(declarations) {
     }
   }
 }
+function toCanonicalFormatOptionsWithRoutes(productId, formatOptions) {
+  assertNoDirectLegacyFormatAliases(formatOptions);
+  const routes = (0, import_legacy_routes.legacyRoutesForProduct)(productId, formatOptions);
+  return {
+    formatOptions: canonicalDeclarations(formatOptions),
+    routes
+  };
+}
 function toAdditiveCanonicalProduct(product, options) {
   const { product: augmented, diagnostics } = augmentProductWithFormatOptions(product, options);
-  const routes = (0, import_legacy_routes.legacyRoutesForProduct)(product.product_id, augmented.format_options);
-  assertNoDirectLegacyFormatAliases(augmented.format_options);
+  const projected = toCanonicalFormatOptionsWithRoutes(product.product_id, augmented.format_options);
   return {
     product: {
       ...augmented,
-      format_options: canonicalDeclarations(augmented.format_options)
+      format_options: projected.formatOptions
     },
     diagnostics,
-    routes
+    routes: projected.routes
   };
 }
 function withAdditiveCanonicalFormatOptions(response, options) {
@@ -411,6 +419,7 @@ function toCanonicalOnlyResponse(response, options) {
   augmentProductWithFormatOptions,
   projectionDiagnosticToError,
   toAdditiveCanonicalProduct,
+  toCanonicalFormatOptionsWithRoutes,
   toCanonicalOnlyProduct,
   toCanonicalOnlyResponse,
   withAdditiveCanonicalFormatOptions,

package/dist/lib/v2/projection/augment-response.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/v2/projection/augment-response.ts"],"sourcesContent":["/**\n * Buyer-side helpers that augment a v1-shaped agent response with v2\n * `format_options[]` derived from the existing `format_ids[]` on each\n * Product.\n *\n * Buyers who want the canonical creative-format model call\n * `withFormatOptions(response)` and read `format_options` instead of\n * relying only on legacy `format_ids`.\n *\n * The SDK also auto-projects compatible `AgentClient.getProducts()`\n * responses; this helper remains useful for cached responses, fixtures,\n * upstream seller/storefront composition, and explicit migration code.\n *\n * Pure functions — no IO, no caching. Each Product is projected\n * independently; diagnostics aggregate so a multi-product response\n * surfaces every projection issue at once. The helpers preserve the\n * input shape verbatim and add `format_options[]` (additive). They do\n * NOT drop `format_ids[]` — that's the 8.0 narrowing. To DROP\n * `format_ids[]` once a consumer has fully migrated, use\n * `toCanonicalOnlyProduct` / `toCanonicalOnlyResponse`.\n */\n\nimport type { V1Product, V1FormatId, V2ProductFormatDeclaration, ProjectionDiagnostic } from './types';\nimport { projectV1ProductToV2 } from './v1-to-v2';\nimport type { V1ToV2ProjectionOptions } from './v1-to-v2';\nimport { LIBRARY_VERSION } from '../../version';\nimport { canonicalize as canonicalizeJson } from '../../utils/jcs';\nimport { concealLegacyFormatRefs } from './legacy-metadata';\nimport type { CanonicalFormatDeclaration } from './legacy-metadata';\nimport { legacyRoutesForProduct } from './legacy-routes';\nimport type { CanonicalFormatLegacyRoute } from './legacy-routes';\n\nconst SDK_ID = `@adcp/sdk@${LIBRARY_VERSION}`;\nconst DIRECT_LEGACY_FORMAT_IDENTITY_KEYS = new Set(['agenturl', 'formatid', 'formatids', 'v1formatref']);\n\nfunction canonicalDiagnostic(diagnostic: ProjectionDiagnostic): ProjectionDiagnostic {\n  return {\n    ...diagnostic,\n    // A source `format_ids[i]` index is not an index into the projected\n    // `format_options[]`: earlier source refs may have failed while later refs\n    // projected successfully. Point at the canonical collection instead of\n    // claiming that a successful projected option is the failing value.\n    field: diagnostic.field.replace(/\\.format_ids\\[\\d+\\]/g, '.format_options'),\n  };\n}\n\n/** Protocol Error shape used for portable response-level projection advisories. */\nexport interface CanonicalProjectionError {\n  code: ProjectionDiagnostic['code'];\n  message: string;\n  field: string;\n  recovery: 'correctable';\n  source: 'sdk';\n  sdk_id: string;\n  details: ProjectionDiagnostic['error']['details'];\n}\n\nfunction projectionErrorMessage(code: ProjectionDiagnostic['code']): string {\n  switch (code) {\n    case 'CANONICAL_PRODUCT_FORMATS_UNAVAILABLE':\n      return 'Product has no format declaration representable on the canonical-only surface';\n    case 'FORMAT_PROJECTION_FAILED':\n      return 'Legacy creative format could not be projected to a canonical declaration';\n    case 'FORMAT_DECLARATION_V1_AMBIGUOUS':\n      return 'Canonical creative format has no unambiguous legacy declaration';\n    case 'FORMAT_DECLARATION_V1_NOT_APPLICABLE':\n      return 'Canonical-only creative format cannot be represented on a legacy format path';\n    case 'CANONICAL_NOT_V1_TRANSLATABLE':\n      return 'Canonical creative format has no legacy representation';\n    case 'FORMAT_DECLARATION_V1_LOSSY_MULTI_SIZE':\n      return 'Canonical multi-size format has incomplete legacy coverage';\n    case 'LEGACY_FORMAT_ID_DROPPED_UNMAPPED':\n      return 'Redundant legacy creative identity has no canonical counterpart';\n  }\n}\n\n/** Flatten the projector's internal diagnostic into the protocol `Error` shape. */\nexport function projectionDiagnosticToError(diagnostic: ProjectionDiagnostic): CanonicalProjectionError {\n  return {\n    code: diagnostic.code,\n    message: projectionErrorMessage(diagnostic.code),\n    field: diagnostic.field,\n    recovery: 'correctable',\n    source: diagnostic.source,\n    sdk_id: diagnostic.sdk_id,\n    details: diagnostic.error.details,\n  } as CanonicalProjectionError;\n}\n\nfunction canonicalFormatsUnavailableForProduct(\n  product: V1Product,\n  reason: Extract<ProjectionDiagnostic, { code: 'CANONICAL_PRODUCT_FORMATS_UNAVAILABLE' }>['error']['details']['reason']\n): ProjectionDiagnostic {\n  return {\n    source: 'sdk',\n    sdk_id: SDK_ID,\n    field: `products[${product.product_id}].format_options`,\n    code: 'CANONICAL_PRODUCT_FORMATS_UNAVAILABLE',\n    error: {\n      details: {\n        product_id: product.product_id,\n        reason,\n      },\n    },\n  };\n}\n\nfunction errorIdentity(value: Record<string, unknown>): string | undefined {\n  if (typeof value.code !== 'string' || typeof value.field !== 'string') return undefined;\n  try {\n    return `${value.code}\\u0000${value.field}\\u0000${canonicalizeJson(value.details ?? null)}`;\n  } catch {\n    // Preserve unreadable third-party errors instead of falsely deduplicating.\n    return undefined;\n  }\n}\n\nfunction mergeProjectionErrors(existing: unknown, diagnostics: readonly ProjectionDiagnostic[]): unknown[] {\n  const merged = Array.isArray(existing) ? [...existing] : [];\n  const seen = new Set<string>();\n  for (const value of merged) {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) continue;\n    const record = value as Record<string, unknown>;\n    const key = errorIdentity(record);\n    if (key) seen.add(key);\n  }\n  for (const diagnostic of diagnostics) {\n    const error = projectionDiagnosticToError(diagnostic) as unknown as Record<string, unknown>;\n    const key = errorIdentity(error)!;\n    if (seen.has(key)) continue;\n    seen.add(key);\n    merged.push(error);\n  }\n  return merged;\n}\n\nfunction remapExistingProductErrors(\n  existing: unknown,\n  originalToOutputIndex: ReadonlyMap<number, number | undefined>,\n  products: readonly V1Product[]\n): unknown {\n  if (!Array.isArray(existing)) return existing;\n  return existing.map(value => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) return value;\n    const record = value as Record<string, unknown>;\n    let issuesChanged = false;\n    const issues = Array.isArray(record.issues)\n      ? record.issues.map(issue => {\n          if (!issue || typeof issue !== 'object' || Array.isArray(issue)) return issue;\n          const issueRecord = issue as Record<string, unknown>;\n          if (typeof issueRecord.pointer !== 'string') return issue;\n          const pointerMatch = /^\\/products\\/(\\d+)(\\/.*)?$/.exec(issueRecord.pointer);\n          if (!pointerMatch) return issue;\n          const originalIssueIndex = Number(pointerMatch[1]);\n          if (!originalToOutputIndex.has(originalIssueIndex)) return issue;\n          const outputIssueIndex = originalToOutputIndex.get(originalIssueIndex);\n          issuesChanged = true;\n          return {\n            ...issueRecord,\n            pointer:\n              outputIssueIndex === undefined ? '/products' : `/products/${outputIssueIndex}${pointerMatch[2] ?? ''}`,\n          };\n        })\n      : record.issues;\n    const withIssues = issuesChanged ? { ...record, issues } : record;\n    if (typeof record.field !== 'string') return issuesChanged ? withIssues : value;\n    const match = /^products\\[(\\d+)\\](.*)$/.exec(record.field);\n    if (!match) return issuesChanged ? withIssues : value;\n    const originalIndex = Number(match[1]);\n    if (!originalToOutputIndex.has(originalIndex)) return issuesChanged ? withIssues : value;\n    const outputIndex = originalToOutputIndex.get(originalIndex);\n    if (outputIndex !== undefined) {\n      return { ...withIssues, field: `products[${outputIndex}]${match[2] ?? ''}` };\n    }\n    const productId = products[originalIndex]?.product_id;\n    const details =\n      record.details && typeof record.details === 'object' && !Array.isArray(record.details)\n        ? { ...(record.details as Record<string, unknown>) }\n        : {};\n    if (typeof productId === 'string' && details.product_id === undefined) details.product_id = productId;\n    return { ...withIssues, field: 'products', ...(Object.keys(details).length > 0 ? { details } : {}) };\n  });\n}\n\nfunction hasEmptyPlacementFormatOptions(product: CanonicalOnlyProduct<V1Product>): boolean {\n  const placements = (product as Record<string, unknown>).placements;\n  if (!Array.isArray(placements)) return false;\n  return placements.some(value => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) return false;\n    const options = (value as Record<string, unknown>).format_options;\n    return Array.isArray(options) && options.length === 0;\n  });\n}\n\n/**\n * A Product that has been augmented with `format_options[]` while\n * preserving the original `format_ids[]`. Carries the projection\n * diagnostics that were generated mapping each `format_id` so the\n * buyer can see what (if anything) didn't project cleanly.\n *\n * **Write-side bridge.** After picking a `format_options[i]` entry,\n * use {@link formatIdsFromOptions} (from `@adcp/sdk/v2/projection`)\n * to extract the `format_ids[]` value for a `create_media_buy`\n * package. Inlining `decl.v1_format_ref` works but bypasses the\n * fail-closed semantics (canonical_formats_only / inherently-v2\n * canonical → throw). The spec gap that forces this bridge is tracked\n * at adcontextprotocol/adcp#4842.\n *\n * @see formatIdsFromOptions\n * @see formatIdsForCapability\n */\nexport type V2AugmentedProduct<P> = P & {\n  format_options: V2ProductFormatDeclaration[];\n};\n\n/**\n * Augment a single Product. Idempotent — when `format_options[]` is\n * already present (the seller is v2-native), passes the Product\n * through unchanged. Otherwise projects from `format_ids[]`.\n *\n * Returns `{ product, diagnostics }`. `diagnostics` is empty for a\n * clean projection; populated when individual format_ids don't have\n * a v2 mapping (catalog gap, structural unreachability, etc.).\n *\n * @see toCanonicalOnlyProduct — the canonical-only counterpart that DROPS\n * `format_ids[]` for a fully-migrated consumer.\n */\nexport function augmentProductWithFormatOptions<P extends V1Product>(\n  product: P,\n  options?: V1ToV2ProjectionOptions\n): { product: V2AugmentedProduct<P>; diagnostics: ProjectionDiagnostic[] } {\n  // Already v2-shaped (seller sent format_options directly) — pass through.\n  const existing = (product as unknown as { format_options?: unknown }).format_options;\n  if (Array.isArray(existing)) {\n    return {\n      product: product as V2AugmentedProduct<P>,\n      diagnostics: [],\n    };\n  }\n  // v1 shape — project to add format_options[].\n  if (!Array.isArray(product.format_ids)) {\n    // Neither shape — nothing to project. Return as-is with an empty\n    // format_options so the buyer doesn't have to special-case.\n    return {\n      product: { ...product, format_options: [] },\n      diagnostics: [],\n    };\n  }\n  const { v2, diagnostics } = projectV1ProductToV2(product, options);\n  // Preserve the original product shape (especially format_ids); just\n  // add format_options.\n  return {\n    product: {\n      ...product,\n      format_options: v2.format_options,\n    },\n    diagnostics,\n  };\n}\n\n/**\n * Augment every Product in a `get_products` response with\n * `format_options[]`. Returns `{ response, diagnostics }` so callers\n * can surface projection diagnostics alongside the response's existing\n * `errors[]` array (or filter by `source: 'sdk'` to distinguish SDK\n * diagnostics from seller-emitted errors).\n *\n * Idempotent: if the seller is v2-native and every Product already\n * carries `format_options[]`, returns the response verbatim with no\n * diagnostics.\n *\n * @see toCanonicalOnlyResponse — the canonical-only counterpart that DROPS\n * `format_ids[]` for a fully-migrated consumer.\n */\nexport function withFormatOptions<R extends { products?: V1Product[] }>(\n  response: R,\n  options?: V1ToV2ProjectionOptions\n): { response: R & { products: V2AugmentedProduct<V1Product>[] }; diagnostics: ProjectionDiagnostic[] } {\n  if (!Array.isArray(response?.products)) {\n    return {\n      response: { ...response, products: [] } as R & { products: V2AugmentedProduct<V1Product>[] },\n      diagnostics: [],\n    };\n  }\n  const out: V2AugmentedProduct<V1Product>[] = [];\n  const diagnostics: ProjectionDiagnostic[] = [];\n  for (const p of response.products) {\n    const { product, diagnostics: d } = augmentProductWithFormatOptions(p, options);\n    out.push(product);\n    diagnostics.push(...d);\n  }\n  return {\n    response: { ...response, products: out } as R & { products: V2AugmentedProduct<V1Product>[] },\n    diagnostics,\n  };\n}\n\n/**\n * An additive canonical Product: canonical declarations contain no legacy\n * routing identity, while the Product's top-level `format_ids[]` remains\n * available to compatibility consumers.\n */\nexport type AdditiveCanonicalProduct<P> = Omit<P, 'format_options'> & {\n  format_options: CanonicalFormatDeclaration[];\n};\n\nfunction assertNoDirectLegacyFormatAliases(declarations: readonly V2ProductFormatDeclaration[]): void {\n  for (let index = 0; index < declarations.length; index++) {\n    const declaration = declarations[index] as unknown as Record<string, unknown>;\n    for (const field of Object.keys(declaration)) {\n      if (\n        field !== 'v1_format_ref' &&\n        DIRECT_LEGACY_FORMAT_IDENTITY_KEYS.has(field.replaceAll('_', '').toLowerCase())\n      ) {\n        throw new TypeError(\n          `format_options[${index}] must not use legacy identity field ${field}; use v1_format_ref for migration routing`\n        );\n      }\n    }\n  }\n}\n\n/**\n * Project a Product to an additive, URL-free canonical surface.\n *\n * Unlike {@link augmentProductWithFormatOptions}, this always returns fresh\n * `format_options[]` declarations with `v1_format_ref` concealed. Unlike\n * {@link toCanonicalOnlyProduct}, it preserves the Product's top-level\n * `format_ids[]`. Exact canonical-to-legacy downgrade identity is returned\n * separately as JSON-safe {@link CanonicalFormatLegacyRoute} sidecars.\n *\n * Extract `routes` before any JSON round-trip — WeakMap metadata is gone after\n * deserialization. This helper enforces that ordering internally; persist its\n * returned `routes` whenever a canonical selection may cross a process boundary\n * before being forwarded to a legacy seller. Rebuild the write-side resolver\n * with `canonicalFormatLegacyResolverFromRoutes(restoredRoutes)`.\n *\n * @throws TypeError when a canonical declaration uses a direct legacy identity\n * alias such as `agent_url` or `agentUrl` instead of `v1_format_ref`.\n */\nexport function toAdditiveCanonicalProduct<P extends V1Product>(\n  product: P,\n  options?: V1ToV2ProjectionOptions\n): {\n  product: AdditiveCanonicalProduct<P>;\n  diagnostics: ProjectionDiagnostic[];\n  routes: CanonicalFormatLegacyRoute[];\n} {\n  const { product: augmented, diagnostics } = augmentProductWithFormatOptions(product, options);\n  const routes = legacyRoutesForProduct(product.product_id, augmented.format_options);\n  assertNoDirectLegacyFormatAliases(augmented.format_options);\n  return {\n    product: {\n      ...augmented,\n      format_options: canonicalDeclarations(augmented.format_options),\n    } as AdditiveCanonicalProduct<P>,\n    diagnostics,\n    routes,\n  };\n}\n\n/**\n * Response-level companion to {@link toAdditiveCanonicalProduct}. Projects\n * every Product and accumulates its serializable legacy routes.\n */\nexport function withAdditiveCanonicalFormatOptions<R extends { products?: V1Product[] }>(\n  response: R,\n  options?: V1ToV2ProjectionOptions\n): {\n  response: Omit<R, 'products'> & { products: AdditiveCanonicalProduct<V1Product>[] };\n  diagnostics: ProjectionDiagnostic[];\n  routes: CanonicalFormatLegacyRoute[];\n} {\n  if (!Array.isArray(response?.products)) {\n    return {\n      response: { ...response, products: [] } as Omit<R, 'products'> & {\n        products: AdditiveCanonicalProduct<V1Product>[];\n      },\n      diagnostics: [],\n      routes: [],\n    };\n  }\n  const products: AdditiveCanonicalProduct<V1Product>[] = [];\n  const diagnostics: ProjectionDiagnostic[] = [];\n  const routes: CanonicalFormatLegacyRoute[] = [];\n  for (const sourceProduct of response.products) {\n    const projected = toAdditiveCanonicalProduct(sourceProduct, options);\n    products.push(projected.product);\n    diagnostics.push(...projected.diagnostics);\n    routes.push(...projected.routes);\n  }\n  return {\n    response: { ...response, products } as Omit<R, 'products'> & {\n      products: AdditiveCanonicalProduct<V1Product>[];\n    },\n    diagnostics,\n    routes,\n  };\n}\n\n/**\n * A Product reduced to the canonical creative-format surface:\n * `format_options[]` only, with the legacy `format_ids[]` removed. The\n * read-side counterpart to a fully-migrated consumer — naive downstream\n * code can no longer fall back to the stale `{ agent_url, id }` shape and\n * silently bypass the canonical model.\n */\nexport type CanonicalOnlyProduct<P> = Omit<P, 'format_ids'> & {\n  format_ids?: never;\n  format_options: CanonicalFormatDeclaration[];\n};\n\nfunction canonicalDeclarations(values: readonly V2ProductFormatDeclaration[]): CanonicalFormatDeclaration[] {\n  return values.map(value => concealLegacyFormatRefs(value));\n}\n\nfunction canonicalPlacements(\n  product: Record<string, unknown>,\n  options: V1ToV2ProjectionOptions | undefined,\n  diagnostics: ProjectionDiagnostic[]\n): unknown {\n  if (!Array.isArray(product.placements)) return product.placements;\n  return product.placements.map((value, placementIndex) => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) return value;\n    const placement = value as Record<string, unknown>;\n    const { format_ids: _drop, ...rest } = placement;\n    void _drop;\n    const hasLegacyFormats = Array.isArray(placement.format_ids);\n    const hasCanonicalFormats = Array.isArray(placement.format_options);\n    if (!hasLegacyFormats && !hasCanonicalFormats) return rest;\n\n    const productId = typeof product.product_id === 'string' ? product.product_id : '(unknown)';\n    const placementId = typeof placement.placement_id === 'string' ? placement.placement_id : String(placementIndex);\n    const pseudoProduct = {\n      product_id: `${productId}:placement:${placementId}`,\n      name: typeof placement.name === 'string' ? placement.name : placementId,\n      description: `Nested placement ${placementId}`,\n      ...(hasLegacyFormats ? { format_ids: placement.format_ids } : {}),\n      ...(hasCanonicalFormats ? { format_options: placement.format_options } : {}),\n    } as unknown as V1Product;\n    const projected = toCanonicalOnlyProduct(pseudoProduct, options);\n    for (const diagnostic of projected.diagnostics) {\n      diagnostics.push({\n        ...diagnostic,\n        field: diagnostic.field.replace(/^products\\[[^\\]]+\\]/, `products[${productId}].placements[${placementIndex}]`),\n      });\n    }\n    return {\n      ...rest,\n      format_options: projected.product.format_options,\n    };\n  });\n}\n\n/**\n * Identity key for a `format_id` ref used by the coverage check.\n * Trailing-slash-insensitive on `agent_url` (folds the AAO host's slash /\n * no-slash forms, per `catalog.ts`'s `normalizeAgentUrl`), and includes the\n * dimensional discriminators so multi-size declarations sharing one\n * `{ agent_url, id }` but differing by size/duration are NOT collapsed —\n * the same key shape `write-side.ts` uses for v1 ref de-dup. Without the\n * size half, a `format_ids[]` entry for a size no `v1_format_ref` covers\n * would read as covered and be dropped silently.\n */\nfunction formatRefCoverageKey(ref: V1FormatId): string {\n  const url = ref.agent_url && !ref.agent_url.endsWith('/') ? ref.agent_url + '/' : ref.agent_url;\n  return `${url}::${ref.id}::${ref.width ?? ''}x${ref.height ?? ''}::${ref.duration_ms ?? ''}`;\n}\n\n/**\n * Project a single Product to the canonical-only shape: `format_options[]`\n * present, `format_ids[]` dropped.\n *\n * **Dropping legacy never silently loses a format.** Every input\n * `format_id` is either represented in the returned `format_options[]` or\n * surfaced in `diagnostics` — never discarded without a trace:\n *\n *   - **v1-shaped input** (`format_ids[]`, no `format_options[]`): runs the\n *     v1 → v2 projection. Mapped refs become `format_options[]`; any ref\n *     the projection can't map is surfaced as `FORMAT_PROJECTION_FAILED`.\n *   - **v2-native input** (`format_options[]` already present): keeps the\n *     seller's canonical surface and drops the redundant v1 fallback. If a\n *     legacy routing entry exists that no canonical option covers, it\n *     surfaces a canonical-safe `LEGACY_FORMAT_ID_DROPPED_UNMAPPED`\n *     diagnostic without echoing the routing identifier.\n *   - **neither shape**: returns `format_options: []`; there is nothing to\n *     project and nothing to lose.\n *\n * Pure and subtractive: unlike {@link augmentProductWithFormatOptions}\n * (which preserves `format_ids[]`), this drops it — the opt-in narrowing for\n * a consumer that has fully migrated. Complements the write-side\n * non-invertibility tracked at adcontextprotocol/adcp#4842 — this is the\n * read-side transparency half.\n */\nexport function toCanonicalOnlyProduct<P extends V1Product>(\n  product: P,\n  options?: V1ToV2ProjectionOptions\n): { product: CanonicalOnlyProduct<P>; diagnostics: ProjectionDiagnostic[] } {\n  const existing = (product as unknown as { format_options?: unknown }).format_options;\n\n  // v2-native: the seller already sent format_options[]. Drop the\n  // redundant v1 fallback, but flag any legacy ref no v1_format_ref covers.\n  if (Array.isArray(existing)) {\n    const formatOptions = existing as V2ProductFormatDeclaration[];\n    const diagnostics: ProjectionDiagnostic[] = [];\n    const inputIds = Array.isArray(product.format_ids) ? product.format_ids : [];\n    if (inputIds.length > 0) {\n      const covered = new Set<string>();\n      for (const opt of formatOptions) {\n        const refs = Array.isArray(opt?.v1_format_ref) ? opt.v1_format_ref : [];\n        for (const ref of refs) covered.add(formatRefCoverageKey(ref));\n      }\n      for (let k = 0; k < inputIds.length; k++) {\n        const fid = inputIds[k]!;\n        if (!covered.has(formatRefCoverageKey(fid))) {\n          diagnostics.push({\n            source: 'sdk',\n            sdk_id: SDK_ID,\n            field: `products[${product.product_id}].format_options`,\n            code: 'LEGACY_FORMAT_ID_DROPPED_UNMAPPED',\n            error: {\n              details: {\n                product_id: product.product_id,\n                resolution_failure: 'unmapped_legacy_format',\n              },\n            },\n          });\n        }\n      }\n    }\n    const { format_ids: _dropV2, ...rest } = product as P & { format_ids?: unknown };\n    void _dropV2;\n    return {\n      product: {\n        ...rest,\n        format_options: canonicalDeclarations(formatOptions),\n        ...(Array.isArray((product as Record<string, unknown>).placements)\n          ? { placements: canonicalPlacements(product as Record<string, unknown>, options, diagnostics) }\n          : {}),\n      } as CanonicalOnlyProduct<P>,\n      diagnostics: diagnostics.map(canonicalDiagnostic),\n    };\n  }\n\n  // v1 shape: project. projectV1ProductToV2 already omits format_ids and\n  // emits a diagnostic for every ref it couldn't map.\n  if (Array.isArray(product.format_ids)) {\n    const { v2, diagnostics } = projectV1ProductToV2(product, options);\n    const { format_ids: _dropV1, ...rest } = product as P & { format_ids?: unknown };\n    void _dropV1;\n    return {\n      product: {\n        ...(rest as Omit<P, 'format_ids'>),\n        format_options: canonicalDeclarations(v2.format_options),\n        ...(Array.isArray((product as Record<string, unknown>).placements)\n          ? { placements: canonicalPlacements(product as Record<string, unknown>, options, diagnostics) }\n          : {}),\n      } as CanonicalOnlyProduct<P>,\n      diagnostics: diagnostics.map(canonicalDiagnostic),\n    };\n  }\n\n  // Neither shape — nothing to project, nothing to lose.\n  const { format_ids: _dropNone, ...rest } = product as P & { format_ids?: unknown };\n  void _dropNone;\n  const diagnostics: ProjectionDiagnostic[] = [];\n  return {\n    product: {\n      ...(rest as Omit<P, 'format_ids'>),\n      format_options: [],\n      ...(Array.isArray((product as Record<string, unknown>).placements)\n        ? { placements: canonicalPlacements(product as Record<string, unknown>, options, diagnostics) }\n        : {}),\n    } as CanonicalOnlyProduct<P>,\n    diagnostics: diagnostics.map(canonicalDiagnostic),\n  };\n}\n\n/**\n * Reduce every Product in a `get_products` response to the canonical-only\n * shape — `format_options[]` present, `format_ids[]` dropped. Returns\n * `{ response, diagnostics }` so callers surface projection diagnostics\n * alongside the response's existing `errors[]`.\n *\n * Response-level counterpart to {@link toCanonicalOnlyProduct}; same\n * fail-closed guarantee, aggregated across products. A wholly unmappable\n * legacy product cannot be represented as a canonical Product because the\n * protocol requires `format_options` to contain at least one declaration. It\n * is therefore omitted from the canonical list and surfaced through the\n * response's portable `errors[]` plus the SDK convenience diagnostics. A\n * partially mappable product remains with its mapped options and advisories\n * for the refs that could not be projected.\n */\nexport function toCanonicalOnlyResponse<R extends { products?: V1Product[] }>(\n  response: R,\n  options?: V1ToV2ProjectionOptions\n): {\n  response: Omit<R, 'products'> & { products: CanonicalOnlyProduct<V1Product>[]; errors?: unknown[] };\n  diagnostics: ProjectionDiagnostic[];\n} {\n  if (!Array.isArray(response?.products)) {\n    return {\n      response: { ...response, products: [] } as Omit<R, 'products'> & {\n        products: CanonicalOnlyProduct<V1Product>[];\n        errors?: unknown[];\n      },\n      diagnostics: [],\n    };\n  }\n  const out: CanonicalOnlyProduct<V1Product>[] = [];\n  const diagnostics: ProjectionDiagnostic[] = [];\n  const originalToOutputIndex = new Map<number, number | undefined>();\n  for (let productIndex = 0; productIndex < response.products.length; productIndex++) {\n    const p = response.products[productIndex]!;\n    const { product, diagnostics: rawDiagnostics } = toCanonicalOnlyProduct(p, options);\n    const hasEmptyPlacement = hasEmptyPlacementFormatOptions(product);\n    const keep = product.format_options.length > 0 && !hasEmptyPlacement;\n    const outputIndex = keep ? out.length : undefined;\n    originalToOutputIndex.set(productIndex, outputIndex);\n    const d = rawDiagnostics.map(diagnostic => ({\n      ...diagnostic,\n      field: keep ? diagnostic.field.replace(/^products\\[[^\\]]+\\]/, `products[${outputIndex}]`) : 'products',\n      error: keep\n        ? diagnostic.error\n        : {\n            details: {\n              ...diagnostic.error.details,\n              product_id: p.product_id,\n            },\n          },\n    })) as ProjectionDiagnostic[];\n    if (!keep && d.length === 0) {\n      const reason = hasEmptyPlacement\n        ? 'nested_placement_format_list_empty'\n        : Array.isArray((p as Record<string, unknown>).format_options)\n          ? 'canonical_format_list_empty'\n          : Array.isArray(p.format_ids)\n            ? 'legacy_format_list_empty'\n            : 'missing_format_declaration';\n      d.push({\n        ...canonicalFormatsUnavailableForProduct(p, reason),\n        field: 'products',\n      });\n    }\n    diagnostics.push(...d);\n    if (keep) out.push(product);\n  }\n  const remappedExistingErrors = remapExistingProductErrors(\n    (response as { errors?: unknown }).errors,\n    originalToOutputIndex,\n    response.products\n  );\n  const errors = mergeProjectionErrors(remappedExistingErrors, diagnostics);\n  return {\n    response: {\n      ...response,\n      products: out,\n      ...(errors.length > 0 ? { errors } : {}),\n    } as Omit<R, 'products'> & { products: CanonicalOnlyProduct<V1Product>[]; errors?: unknown[] },\n    diagnostics,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuBA,sBAAqC;AAErC,qBAAgC;AAChC,iBAAiD;AACjD,6BAAwC;AAExC,2BAAuC;AAGvC,MAAM,SAAS,aAAa,8BAAe;AAC3C,MAAM,qCAAqC,oBAAI,IAAI,CAAC,YAAY,YAAY,aAAa,aAAa,CAAC;AAEvG,SAAS,oBAAoB,YAAwD;AACnF,SAAO;AAAA,IACL,GAAG;AAAA;AAAA;AAAA;AAAA;AAAA,IAKH,OAAO,WAAW,MAAM,QAAQ,wBAAwB,iBAAiB;AAAA,EAC3E;AACF;AAaA,SAAS,uBAAuB,MAA4C;AAC1E,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,EACX;AACF;AAGO,SAAS,4BAA4B,YAA4D;AACtG,SAAO;AAAA,IACL,MAAM,WAAW;AAAA,IACjB,SAAS,uBAAuB,WAAW,IAAI;AAAA,IAC/C,OAAO,WAAW;AAAA,IAClB,UAAU;AAAA,IACV,QAAQ,WAAW;AAAA,IACnB,QAAQ,WAAW;AAAA,IACnB,SAAS,WAAW,MAAM;AAAA,EAC5B;AACF;AAEA,SAAS,sCACP,SACA,QACsB;AACtB,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,OAAO,YAAY,QAAQ,UAAU;AAAA,IACrC,MAAM;AAAA,IACN,OAAO;AAAA,MACL,SAAS;AAAA,QACP,YAAY,QAAQ;AAAA,QACpB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEA,SAAS,cAAc,OAAoD;AACzE,MAAI,OAAO,MAAM,SAAS,YAAY,OAAO,MAAM,UAAU,SAAU,QAAO;AAC9E,MAAI;AACF,WAAO,GAAG,MAAM,IAAI,KAAS,MAAM,KAAK,SAAS,WAAAA,cAAiB,MAAM,WAAW,IAAI,CAAC;AAAA,EAC1F,QAAQ;AAEN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,sBAAsB,UAAmB,aAAyD;AACzG,QAAM,SAAS,MAAM,QAAQ,QAAQ,IAAI,CAAC,GAAG,QAAQ,IAAI,CAAC;AAC1D,QAAM,OAAO,oBAAI,IAAY;AAC7B,aAAW,SAAS,QAAQ;AAC1B,QAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,EAAG;AACjE,UAAM,SAAS;AACf,UAAM,MAAM,cAAc,MAAM;AAChC,QAAI,IAAK,MAAK,IAAI,GAAG;AAAA,EACvB;AACA,aAAW,cAAc,aAAa;AACpC,UAAM,QAAQ,4BAA4B,UAAU;AACpD,UAAM,MAAM,cAAc,KAAK;AAC/B,QAAI,KAAK,IAAI,GAAG,EAAG;AACnB,SAAK,IAAI,GAAG;AACZ,WAAO,KAAK,KAAK;AAAA,EACnB;AACA,SAAO;AACT;AAEA,SAAS,2BACP,UACA,uBACA,UACS;AACT,MAAI,CAAC,MAAM,QAAQ,QAAQ,EAAG,QAAO;AACrC,SAAO,SAAS,IAAI,WAAS;AAC3B,QAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,EAAG,QAAO;AACxE,UAAM,SAAS;AACf,QAAI,gBAAgB;AACpB,UAAM,SAAS,MAAM,QAAQ,OAAO,MAAM,IACtC,OAAO,OAAO,IAAI,WAAS;AACzB,UAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,EAAG,QAAO;AACxE,YAAM,cAAc;AACpB,UAAI,OAAO,YAAY,YAAY,SAAU,QAAO;AACpD,YAAM,eAAe,6BAA6B,KAAK,YAAY,OAAO;AAC1E,UAAI,CAAC,aAAc,QAAO;AAC1B,YAAM,qBAAqB,OAAO,aAAa,CAAC,CAAC;AACjD,UAAI,CAAC,sBAAsB,IAAI,kBAAkB,EAAG,QAAO;AAC3D,YAAM,mBAAmB,sBAAsB,IAAI,kBAAkB;AACrE,sBAAgB;AAChB,aAAO;AAAA,QACL,GAAG;AAAA,QACH,SACE,qBAAqB,SAAY,cAAc,aAAa,gBAAgB,GAAG,aAAa,CAAC,KAAK,EAAE;AAAA,MACxG;AAAA,IACF,CAAC,IACD,OAAO;AACX,UAAM,aAAa,gBAAgB,EAAE,GAAG,QAAQ,OAAO,IAAI;AAC3D,QAAI,OAAO,OAAO,UAAU,SAAU,QAAO,gBAAgB,aAAa;AAC1E,UAAM,QAAQ,0BAA0B,KAAK,OAAO,KAAK;AACzD,QAAI,CAAC,MAAO,QAAO,gBAAgB,aAAa;AAChD,UAAM,gBAAgB,OAAO,MAAM,CAAC,CAAC;AACrC,QAAI,CAAC,sBAAsB,IAAI,aAAa,EAAG,QAAO,gBAAgB,aAAa;AACnF,UAAM,cAAc,sBAAsB,IAAI,aAAa;AAC3D,QAAI,gBAAgB,QAAW;AAC7B,aAAO,EAAE,GAAG,YAAY,OAAO,YAAY,WAAW,IAAI,MAAM,CAAC,KAAK,EAAE,GAAG;AAAA,IAC7E;AACA,UAAM,YAAY,SAAS,aAAa,GAAG;AAC3C,UAAM,UACJ,OAAO,WAAW,OAAO,OAAO,YAAY,YAAY,CAAC,MAAM,QAAQ,OAAO,OAAO,IACjF,EAAE,GAAI,OAAO,QAAoC,IACjD,CAAC;AACP,QAAI,OAAO,cAAc,YAAY,QAAQ,eAAe,OAAW,SAAQ,aAAa;AAC5F,WAAO,EAAE,GAAG,YAAY,OAAO,YAAY,GAAI,OAAO,KAAK,OAAO,EAAE,SAAS,IAAI,EAAE,QAAQ,IAAI,CAAC,EAAG;AAAA,EACrG,CAAC;AACH;AAEA,SAAS,+BAA+B,SAAmD;AACzF,QAAM,aAAc,QAAoC;AACxD,MAAI,CAAC,MAAM,QAAQ,UAAU,EAAG,QAAO;AACvC,SAAO,WAAW,KAAK,WAAS;AAC9B,QAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,EAAG,QAAO;AACxE,UAAM,UAAW,MAAkC;AACnD,WAAO,MAAM,QAAQ,OAAO,KAAK,QAAQ,WAAW;AAAA,EACtD,CAAC;AACH;AAmCO,SAAS,gCACd,SACA,SACyE;AAEzE,QAAM,WAAY,QAAoD;AACtE,MAAI,MAAM,QAAQ,QAAQ,GAAG;AAC3B,WAAO;AAAA,MACL;AAAA,MACA,aAAa,CAAC;AAAA,IAChB;AAAA,EACF;AAEA,MAAI,CAAC,MAAM,QAAQ,QAAQ,UAAU,GAAG;AAGtC,WAAO;AAAA,MACL,SAAS,EAAE,GAAG,SAAS,gBAAgB,CAAC,EAAE;AAAA,MAC1C,aAAa,CAAC;AAAA,IAChB;AAAA,EACF;AACA,QAAM,EAAE,IAAI,YAAY,QAAI,sCAAqB,SAAS,OAAO;AAGjE,SAAO;AAAA,IACL,SAAS;AAAA,MACP,GAAG;AAAA,MACH,gBAAgB,GAAG;AAAA,IACrB;AAAA,IACA;AAAA,EACF;AACF;AAgBO,SAAS,kBACd,UACA,SACsG;AACtG,MAAI,CAAC,MAAM,QAAQ,UAAU,QAAQ,GAAG;AACtC,WAAO;AAAA,MACL,UAAU,EAAE,GAAG,UAAU,UAAU,CAAC,EAAE;AAAA,MACtC,aAAa,CAAC;AAAA,IAChB;AAAA,EACF;AACA,QAAM,MAAuC,CAAC;AAC9C,QAAM,cAAsC,CAAC;AAC7C,aAAW,KAAK,SAAS,UAAU;AACjC,UAAM,EAAE,SAAS,aAAa,EAAE,IAAI,gCAAgC,GAAG,OAAO;AAC9E,QAAI,KAAK,OAAO;AAChB,gBAAY,KAAK,GAAG,CAAC;AAAA,EACvB;AACA,SAAO;AAAA,IACL,UAAU,EAAE,GAAG,UAAU,UAAU,IAAI;AAAA,IACvC;AAAA,EACF;AACF;AAWA,SAAS,kCAAkC,cAA2D;AACpG,WAAS,QAAQ,GAAG,QAAQ,aAAa,QAAQ,SAAS;AACxD,UAAM,cAAc,aAAa,KAAK;AACtC,eAAW,SAAS,OAAO,KAAK,WAAW,GAAG;AAC5C,UACE,UAAU,mBACV,mCAAmC,IAAI,MAAM,WAAW,KAAK,EAAE,EAAE,YAAY,CAAC,GAC9E;AACA,cAAM,IAAI;AAAA,UACR,kBAAkB,KAAK,wCAAwC,KAAK;AAAA,QACtE;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAoBO,SAAS,2BACd,SACA,SAKA;AACA,QAAM,EAAE,SAAS,WAAW,YAAY,IAAI,gCAAgC,SAAS,OAAO;AAC5F,QAAM,aAAS,6CAAuB,QAAQ,YAAY,UAAU,cAAc;AAClF,oCAAkC,UAAU,cAAc;AAC1D,SAAO;AAAA,IACL,SAAS;AAAA,MACP,GAAG;AAAA,MACH,gBAAgB,sBAAsB,UAAU,cAAc;AAAA,IAChE;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAMO,SAAS,mCACd,UACA,SAKA;AACA,MAAI,CAAC,MAAM,QAAQ,UAAU,QAAQ,GAAG;AACtC,WAAO;AAAA,MACL,UAAU,EAAE,GAAG,UAAU,UAAU,CAAC,EAAE;AAAA,MAGtC,aAAa,CAAC;AAAA,MACd,QAAQ,CAAC;AAAA,IACX;AAAA,EACF;AACA,QAAM,WAAkD,CAAC;AACzD,QAAM,cAAsC,CAAC;AAC7C,QAAM,SAAuC,CAAC;AAC9C,aAAW,iBAAiB,SAAS,UAAU;AAC7C,UAAM,YAAY,2BAA2B,eAAe,OAAO;AACnE,aAAS,KAAK,UAAU,OAAO;AAC/B,gBAAY,KAAK,GAAG,UAAU,WAAW;AACzC,WAAO,KAAK,GAAG,UAAU,MAAM;AAAA,EACjC;AACA,SAAO;AAAA,IACL,UAAU,EAAE,GAAG,UAAU,SAAS;AAAA,IAGlC;AAAA,IACA;AAAA,EACF;AACF;AAcA,SAAS,sBAAsB,QAA6E;AAC1G,SAAO,OAAO,IAAI,eAAS,gDAAwB,KAAK,CAAC;AAC3D;AAEA,SAAS,oBACP,SACA,SACA,aACS;AACT,MAAI,CAAC,MAAM,QAAQ,QAAQ,UAAU,EAAG,QAAO,QAAQ;AACvD,SAAO,QAAQ,WAAW,IAAI,CAAC,OAAO,mBAAmB;AACvD,QAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,EAAG,QAAO;AACxE,UAAM,YAAY;AAClB,UAAM,EAAE,YAAY,OAAO,GAAG,KAAK,IAAI;AACvC,SAAK;AACL,UAAM,mBAAmB,MAAM,QAAQ,UAAU,UAAU;AAC3D,UAAM,sBAAsB,MAAM,QAAQ,UAAU,cAAc;AAClE,QAAI,CAAC,oBAAoB,CAAC,oBAAqB,QAAO;AAEtD,UAAM,YAAY,OAAO,QAAQ,eAAe,WAAW,QAAQ,aAAa;AAChF,UAAM,cAAc,OAAO,UAAU,iBAAiB,WAAW,UAAU,eAAe,OAAO,cAAc;AAC/G,UAAM,gBAAgB;AAAA,MACpB,YAAY,GAAG,SAAS,cAAc,WAAW;AAAA,MACjD,MAAM,OAAO,UAAU,SAAS,WAAW,UAAU,OAAO;AAAA,MAC5D,aAAa,oBAAoB,WAAW;AAAA,MAC5C,GAAI,mBAAmB,EAAE,YAAY,UAAU,WAAW,IAAI,CAAC;AAAA,MAC/D,GAAI,sBAAsB,EAAE,gBAAgB,UAAU,eAAe,IAAI,CAAC;AAAA,IAC5E;AACA,UAAM,YAAY,uBAAuB,eAAe,OAAO;AAC/D,eAAW,cAAc,UAAU,aAAa;AAC9C,kBAAY,KAAK;AAAA,QACf,GAAG;AAAA,QACH,OAAO,WAAW,MAAM,QAAQ,uBAAuB,YAAY,SAAS,gBAAgB,cAAc,GAAG;AAAA,MAC/G,CAAC;AAAA,IACH;AACA,WAAO;AAAA,MACL,GAAG;AAAA,MACH,gBAAgB,UAAU,QAAQ;AAAA,IACpC;AAAA,EACF,CAAC;AACH;AAYA,SAAS,qBAAqB,KAAyB;AACrD,QAAM,MAAM,IAAI,aAAa,CAAC,IAAI,UAAU,SAAS,GAAG,IAAI,IAAI,YAAY,MAAM,IAAI;AACtF,SAAO,GAAG,GAAG,KAAK,IAAI,EAAE,KAAK,IAAI,SAAS,EAAE,IAAI,IAAI,UAAU,EAAE,KAAK,IAAI,eAAe,EAAE;AAC5F;AA2BO,SAAS,uBACd,SACA,SAC2E;AAC3E,QAAM,WAAY,QAAoD;AAItE,MAAI,MAAM,QAAQ,QAAQ,GAAG;AAC3B,UAAM,gBAAgB;AACtB,UAAMC,eAAsC,CAAC;AAC7C,UAAM,WAAW,MAAM,QAAQ,QAAQ,UAAU,IAAI,QAAQ,aAAa,CAAC;AAC3E,QAAI,SAAS,SAAS,GAAG;AACvB,YAAM,UAAU,oBAAI,IAAY;AAChC,iBAAW,OAAO,eAAe;AAC/B,cAAM,OAAO,MAAM,QAAQ,KAAK,aAAa,IAAI,IAAI,gBAAgB,CAAC;AACtE,mBAAW,OAAO,KAAM,SAAQ,IAAI,qBAAqB,GAAG,CAAC;AAAA,MAC/D;AACA,eAAS,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;AACxC,cAAM,MAAM,SAAS,CAAC;AACtB,YAAI,CAAC,QAAQ,IAAI,qBAAqB,GAAG,CAAC,GAAG;AAC3C,UAAAA,aAAY,KAAK;AAAA,YACf,QAAQ;AAAA,YACR,QAAQ;AAAA,YACR,OAAO,YAAY,QAAQ,UAAU;AAAA,YACrC,MAAM;AAAA,YACN,OAAO;AAAA,cACL,SAAS;AAAA,gBACP,YAAY,QAAQ;AAAA,gBACpB,oBAAoB;AAAA,cACtB;AAAA,YACF;AAAA,UACF,CAAC;AAAA,QACH;AAAA,MACF;AAAA,IACF;AACA,UAAM,EAAE,YAAY,SAAS,GAAGC,MAAK,IAAI;AACzC,SAAK;AACL,WAAO;AAAA,MACL,SAAS;AAAA,QACP,GAAGA;AAAA,QACH,gBAAgB,sBAAsB,aAAa;AAAA,QACnD,GAAI,MAAM,QAAS,QAAoC,UAAU,IAC7D,EAAE,YAAY,oBAAoB,SAAoC,SAASD,YAAW,EAAE,IAC5F,CAAC;AAAA,MACP;AAAA,MACA,aAAaA,aAAY,IAAI,mBAAmB;AAAA,IAClD;AAAA,EACF;AAIA,MAAI,MAAM,QAAQ,QAAQ,UAAU,GAAG;AACrC,UAAM,EAAE,IAAI,aAAAA,aAAY,QAAI,sCAAqB,SAAS,OAAO;AACjE,UAAM,EAAE,YAAY,SAAS,GAAGC,MAAK,IAAI;AACzC,SAAK;AACL,WAAO;AAAA,MACL,SAAS;AAAA,QACP,GAAIA;AAAA,QACJ,gBAAgB,sBAAsB,GAAG,cAAc;AAAA,QACvD,GAAI,MAAM,QAAS,QAAoC,UAAU,IAC7D,EAAE,YAAY,oBAAoB,SAAoC,SAASD,YAAW,EAAE,IAC5F,CAAC;AAAA,MACP;AAAA,MACA,aAAaA,aAAY,IAAI,mBAAmB;AAAA,IAClD;AAAA,EACF;AAGA,QAAM,EAAE,YAAY,WAAW,GAAG,KAAK,IAAI;AAC3C,OAAK;AACL,QAAM,cAAsC,CAAC;AAC7C,SAAO;AAAA,IACL,SAAS;AAAA,MACP,GAAI;AAAA,MACJ,gBAAgB,CAAC;AAAA,MACjB,GAAI,MAAM,QAAS,QAAoC,UAAU,IAC7D,EAAE,YAAY,oBAAoB,SAAoC,SAAS,WAAW,EAAE,IAC5F,CAAC;AAAA,IACP;AAAA,IACA,aAAa,YAAY,IAAI,mBAAmB;AAAA,EAClD;AACF;AAiBO,SAAS,wBACd,UACA,SAIA;AACA,MAAI,CAAC,MAAM,QAAQ,UAAU,QAAQ,GAAG;AACtC,WAAO;AAAA,MACL,UAAU,EAAE,GAAG,UAAU,UAAU,CAAC,EAAE;AAAA,MAItC,aAAa,CAAC;AAAA,IAChB;AAAA,EACF;AACA,QAAM,MAAyC,CAAC;AAChD,QAAM,cAAsC,CAAC;AAC7C,QAAM,wBAAwB,oBAAI,IAAgC;AAClE,WAAS,eAAe,GAAG,eAAe,SAAS,SAAS,QAAQ,gBAAgB;AAClF,UAAM,IAAI,SAAS,SAAS,YAAY;AACxC,UAAM,EAAE,SAAS,aAAa,eAAe,IAAI,uBAAuB,GAAG,OAAO;AAClF,UAAM,oBAAoB,+BAA+B,OAAO;AAChE,UAAM,OAAO,QAAQ,eAAe,SAAS,KAAK,CAAC;AACnD,UAAM,cAAc,OAAO,IAAI,SAAS;AACxC,0BAAsB,IAAI,cAAc,WAAW;AACnD,UAAM,IAAI,eAAe,IAAI,iBAAe;AAAA,MAC1C,GAAG;AAAA,MACH,OAAO,OAAO,WAAW,MAAM,QAAQ,uBAAuB,YAAY,WAAW,GAAG,IAAI;AAAA,MAC5F,OAAO,OACH,WAAW,QACX;AAAA,QACE,SAAS;AAAA,UACP,GAAG,WAAW,MAAM;AAAA,UACpB,YAAY,EAAE;AAAA,QAChB;AAAA,MACF;AAAA,IACN,EAAE;AACF,QAAI,CAAC,QAAQ,EAAE,WAAW,GAAG;AAC3B,YAAM,SAAS,oBACX,uCACA,MAAM,QAAS,EAA8B,cAAc,IACzD,gCACA,MAAM,QAAQ,EAAE,UAAU,IACxB,6BACA;AACR,QAAE,KAAK;AAAA,QACL,GAAG,sCAAsC,GAAG,MAAM;AAAA,QAClD,OAAO;AAAA,MACT,CAAC;AAAA,IACH;AACA,gBAAY,KAAK,GAAG,CAAC;AACrB,QAAI,KAAM,KAAI,KAAK,OAAO;AAAA,EAC5B;AACA,QAAM,yBAAyB;AAAA,IAC5B,SAAkC;AAAA,IACnC;AAAA,IACA,SAAS;AAAA,EACX;AACA,QAAM,SAAS,sBAAsB,wBAAwB,WAAW;AACxE,SAAO;AAAA,IACL,UAAU;AAAA,MACR,GAAG;AAAA,MACH,UAAU;AAAA,MACV,GAAI,OAAO,SAAS,IAAI,EAAE,OAAO,IAAI,CAAC;AAAA,IACxC;AAAA,IACA;AAAA,EACF;AACF;","names":["canonicalizeJson","diagnostics","rest"]}
+{"version":3,"sources":["../../../../src/lib/v2/projection/augment-response.ts"],"sourcesContent":["/**\n * Buyer-side helpers that augment a v1-shaped agent response with v2\n * `format_options[]` derived from the existing `format_ids[]` on each\n * Product.\n *\n * Buyers who want the canonical creative-format model call\n * `withFormatOptions(response)` and read `format_options` instead of\n * relying only on legacy `format_ids`.\n *\n * The SDK also auto-projects compatible `AgentClient.getProducts()`\n * responses; this helper remains useful for cached responses, fixtures,\n * upstream seller/storefront composition, and explicit migration code.\n *\n * Pure functions — no IO, no caching. Each Product is projected\n * independently; diagnostics aggregate so a multi-product response\n * surfaces every projection issue at once. The helpers preserve the\n * input shape verbatim and add `format_options[]` (additive). They do\n * NOT drop `format_ids[]` — that's the 8.0 narrowing. To DROP\n * `format_ids[]` once a consumer has fully migrated, use\n * `toCanonicalOnlyProduct` / `toCanonicalOnlyResponse`.\n */\n\nimport type { V1Product, V1FormatId, V2ProductFormatDeclaration, ProjectionDiagnostic } from './types';\nimport { projectV1ProductToV2 } from './v1-to-v2';\nimport type { V1ToV2ProjectionOptions } from './v1-to-v2';\nimport { LIBRARY_VERSION } from '../../version';\nimport { canonicalize as canonicalizeJson } from '../../utils/jcs';\nimport { concealLegacyFormatRefs } from './legacy-metadata';\nimport type { CanonicalFormatDeclaration } from './legacy-metadata';\nimport { legacyRoutesForProduct } from './legacy-routes';\nimport type { CanonicalFormatLegacyRoute } from './legacy-routes';\n\nconst SDK_ID = `@adcp/sdk@${LIBRARY_VERSION}`;\nconst DIRECT_LEGACY_FORMAT_IDENTITY_KEYS = new Set(['agenturl', 'formatid', 'formatids', 'v1formatref']);\n\nfunction canonicalDiagnostic(diagnostic: ProjectionDiagnostic): ProjectionDiagnostic {\n  return {\n    ...diagnostic,\n    // A source `format_ids[i]` index is not an index into the projected\n    // `format_options[]`: earlier source refs may have failed while later refs\n    // projected successfully. Point at the canonical collection instead of\n    // claiming that a successful projected option is the failing value.\n    field: diagnostic.field.replace(/\\.format_ids\\[\\d+\\]/g, '.format_options'),\n  };\n}\n\n/** Protocol Error shape used for portable response-level projection advisories. */\nexport interface CanonicalProjectionError {\n  code: ProjectionDiagnostic['code'];\n  message: string;\n  field: string;\n  recovery: 'correctable';\n  source: 'sdk';\n  sdk_id: string;\n  details: ProjectionDiagnostic['error']['details'];\n}\n\nfunction projectionErrorMessage(code: ProjectionDiagnostic['code']): string {\n  switch (code) {\n    case 'CANONICAL_PRODUCT_FORMATS_UNAVAILABLE':\n      return 'Product has no format declaration representable on the canonical-only surface';\n    case 'FORMAT_PROJECTION_FAILED':\n      return 'Legacy creative format could not be projected to a canonical declaration';\n    case 'FORMAT_DECLARATION_V1_AMBIGUOUS':\n      return 'Canonical creative format has no unambiguous legacy declaration';\n    case 'FORMAT_DECLARATION_V1_NOT_APPLICABLE':\n      return 'Canonical-only creative format cannot be represented on a legacy format path';\n    case 'CANONICAL_NOT_V1_TRANSLATABLE':\n      return 'Canonical creative format has no legacy representation';\n    case 'FORMAT_DECLARATION_V1_LOSSY_MULTI_SIZE':\n      return 'Canonical multi-size format has incomplete legacy coverage';\n    case 'LEGACY_FORMAT_ID_DROPPED_UNMAPPED':\n      return 'Redundant legacy creative identity has no canonical counterpart';\n  }\n}\n\n/** Flatten the projector's internal diagnostic into the protocol `Error` shape. */\nexport function projectionDiagnosticToError(diagnostic: ProjectionDiagnostic): CanonicalProjectionError {\n  return {\n    code: diagnostic.code,\n    message: projectionErrorMessage(diagnostic.code),\n    field: diagnostic.field,\n    recovery: 'correctable',\n    source: diagnostic.source,\n    sdk_id: diagnostic.sdk_id,\n    details: diagnostic.error.details,\n  } as CanonicalProjectionError;\n}\n\nfunction canonicalFormatsUnavailableForProduct(\n  product: V1Product,\n  reason: Extract<ProjectionDiagnostic, { code: 'CANONICAL_PRODUCT_FORMATS_UNAVAILABLE' }>['error']['details']['reason']\n): ProjectionDiagnostic {\n  return {\n    source: 'sdk',\n    sdk_id: SDK_ID,\n    field: `products[${product.product_id}].format_options`,\n    code: 'CANONICAL_PRODUCT_FORMATS_UNAVAILABLE',\n    error: {\n      details: {\n        product_id: product.product_id,\n        reason,\n      },\n    },\n  };\n}\n\nfunction errorIdentity(value: Record<string, unknown>): string | undefined {\n  if (typeof value.code !== 'string' || typeof value.field !== 'string') return undefined;\n  try {\n    return `${value.code}\\u0000${value.field}\\u0000${canonicalizeJson(value.details ?? null)}`;\n  } catch {\n    // Preserve unreadable third-party errors instead of falsely deduplicating.\n    return undefined;\n  }\n}\n\nfunction mergeProjectionErrors(existing: unknown, diagnostics: readonly ProjectionDiagnostic[]): unknown[] {\n  const merged = Array.isArray(existing) ? [...existing] : [];\n  const seen = new Set<string>();\n  for (const value of merged) {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) continue;\n    const record = value as Record<string, unknown>;\n    const key = errorIdentity(record);\n    if (key) seen.add(key);\n  }\n  for (const diagnostic of diagnostics) {\n    const error = projectionDiagnosticToError(diagnostic) as unknown as Record<string, unknown>;\n    const key = errorIdentity(error)!;\n    if (seen.has(key)) continue;\n    seen.add(key);\n    merged.push(error);\n  }\n  return merged;\n}\n\nfunction remapExistingProductErrors(\n  existing: unknown,\n  originalToOutputIndex: ReadonlyMap<number, number | undefined>,\n  products: readonly V1Product[]\n): unknown {\n  if (!Array.isArray(existing)) return existing;\n  return existing.map(value => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) return value;\n    const record = value as Record<string, unknown>;\n    let issuesChanged = false;\n    const issues = Array.isArray(record.issues)\n      ? record.issues.map(issue => {\n          if (!issue || typeof issue !== 'object' || Array.isArray(issue)) return issue;\n          const issueRecord = issue as Record<string, unknown>;\n          if (typeof issueRecord.pointer !== 'string') return issue;\n          const pointerMatch = /^\\/products\\/(\\d+)(\\/.*)?$/.exec(issueRecord.pointer);\n          if (!pointerMatch) return issue;\n          const originalIssueIndex = Number(pointerMatch[1]);\n          if (!originalToOutputIndex.has(originalIssueIndex)) return issue;\n          const outputIssueIndex = originalToOutputIndex.get(originalIssueIndex);\n          issuesChanged = true;\n          return {\n            ...issueRecord,\n            pointer:\n              outputIssueIndex === undefined ? '/products' : `/products/${outputIssueIndex}${pointerMatch[2] ?? ''}`,\n          };\n        })\n      : record.issues;\n    const withIssues = issuesChanged ? { ...record, issues } : record;\n    if (typeof record.field !== 'string') return issuesChanged ? withIssues : value;\n    const match = /^products\\[(\\d+)\\](.*)$/.exec(record.field);\n    if (!match) return issuesChanged ? withIssues : value;\n    const originalIndex = Number(match[1]);\n    if (!originalToOutputIndex.has(originalIndex)) return issuesChanged ? withIssues : value;\n    const outputIndex = originalToOutputIndex.get(originalIndex);\n    if (outputIndex !== undefined) {\n      return { ...withIssues, field: `products[${outputIndex}]${match[2] ?? ''}` };\n    }\n    const productId = products[originalIndex]?.product_id;\n    const details =\n      record.details && typeof record.details === 'object' && !Array.isArray(record.details)\n        ? { ...(record.details as Record<string, unknown>) }\n        : {};\n    if (typeof productId === 'string' && details.product_id === undefined) details.product_id = productId;\n    return { ...withIssues, field: 'products', ...(Object.keys(details).length > 0 ? { details } : {}) };\n  });\n}\n\nfunction hasEmptyPlacementFormatOptions(product: CanonicalOnlyProduct<V1Product>): boolean {\n  const placements = (product as Record<string, unknown>).placements;\n  if (!Array.isArray(placements)) return false;\n  return placements.some(value => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) return false;\n    const options = (value as Record<string, unknown>).format_options;\n    return Array.isArray(options) && options.length === 0;\n  });\n}\n\n/**\n * A Product that has been augmented with `format_options[]` while\n * preserving the original `format_ids[]`. Carries the projection\n * diagnostics that were generated mapping each `format_id` so the\n * buyer can see what (if anything) didn't project cleanly.\n *\n * **Write-side bridge.** After picking a `format_options[i]` entry,\n * use {@link formatIdsFromOptions} (from `@adcp/sdk/v2/projection`)\n * to extract the `format_ids[]` value for a `create_media_buy`\n * package. Inlining `decl.v1_format_ref` works but bypasses the\n * fail-closed semantics (canonical_formats_only / inherently-v2\n * canonical → throw). The spec gap that forces this bridge is tracked\n * at adcontextprotocol/adcp#4842.\n *\n * @see formatIdsFromOptions\n * @see formatIdsForCapability\n */\nexport type V2AugmentedProduct<P> = P & {\n  format_options: V2ProductFormatDeclaration[];\n};\n\n/**\n * Augment a single Product. Idempotent — when `format_options[]` is\n * already present (the seller is v2-native), passes the Product\n * through unchanged. Otherwise projects from `format_ids[]`.\n *\n * Returns `{ product, diagnostics }`. `diagnostics` is empty for a\n * clean projection; populated when individual format_ids don't have\n * a v2 mapping (catalog gap, structural unreachability, etc.).\n *\n * @see toCanonicalOnlyProduct — the canonical-only counterpart that DROPS\n * `format_ids[]` for a fully-migrated consumer.\n */\nexport function augmentProductWithFormatOptions<P extends V1Product>(\n  product: P,\n  options?: V1ToV2ProjectionOptions\n): { product: V2AugmentedProduct<P>; diagnostics: ProjectionDiagnostic[] } {\n  // Already v2-shaped (seller sent format_options directly) — pass through.\n  const existing = (product as unknown as { format_options?: unknown }).format_options;\n  if (Array.isArray(existing)) {\n    return {\n      product: product as V2AugmentedProduct<P>,\n      diagnostics: [],\n    };\n  }\n  // v1 shape — project to add format_options[].\n  if (!Array.isArray(product.format_ids)) {\n    // Neither shape — nothing to project. Return as-is with an empty\n    // format_options so the buyer doesn't have to special-case.\n    return {\n      product: { ...product, format_options: [] },\n      diagnostics: [],\n    };\n  }\n  const { v2, diagnostics } = projectV1ProductToV2(product, options);\n  // Preserve the original product shape (especially format_ids); just\n  // add format_options.\n  return {\n    product: {\n      ...product,\n      format_options: v2.format_options,\n    },\n    diagnostics,\n  };\n}\n\n/**\n * Augment every Product in a `get_products` response with\n * `format_options[]`. Returns `{ response, diagnostics }` so callers\n * can surface projection diagnostics alongside the response's existing\n * `errors[]` array (or filter by `source: 'sdk'` to distinguish SDK\n * diagnostics from seller-emitted errors).\n *\n * Idempotent: if the seller is v2-native and every Product already\n * carries `format_options[]`, returns the response verbatim with no\n * diagnostics.\n *\n * @see toCanonicalOnlyResponse — the canonical-only counterpart that DROPS\n * `format_ids[]` for a fully-migrated consumer.\n */\nexport function withFormatOptions<R extends { products?: V1Product[] }>(\n  response: R,\n  options?: V1ToV2ProjectionOptions\n): { response: R & { products: V2AugmentedProduct<V1Product>[] }; diagnostics: ProjectionDiagnostic[] } {\n  if (!Array.isArray(response?.products)) {\n    return {\n      response: { ...response, products: [] } as R & { products: V2AugmentedProduct<V1Product>[] },\n      diagnostics: [],\n    };\n  }\n  const out: V2AugmentedProduct<V1Product>[] = [];\n  const diagnostics: ProjectionDiagnostic[] = [];\n  for (const p of response.products) {\n    const { product, diagnostics: d } = augmentProductWithFormatOptions(p, options);\n    out.push(product);\n    diagnostics.push(...d);\n  }\n  return {\n    response: { ...response, products: out } as R & { products: V2AugmentedProduct<V1Product>[] },\n    diagnostics,\n  };\n}\n\n/**\n * An additive canonical Product: canonical declarations contain no legacy\n * routing identity, while the Product's top-level `format_ids[]` remains\n * available to compatibility consumers.\n */\nexport type AdditiveCanonicalProduct<P> = Omit<P, 'format_options'> & {\n  format_options: CanonicalFormatDeclaration[];\n};\n\nfunction assertNoDirectLegacyFormatAliases(declarations: readonly V2ProductFormatDeclaration[]): void {\n  for (let index = 0; index < declarations.length; index++) {\n    const declaration = declarations[index] as unknown as Record<string, unknown>;\n    for (const field of Object.keys(declaration)) {\n      if (\n        field !== 'v1_format_ref' &&\n        DIRECT_LEGACY_FORMAT_IDENTITY_KEYS.has(field.replaceAll('_', '').toLowerCase())\n      ) {\n        throw new TypeError(\n          `format_options[${index}] must not use legacy identity field ${field}; use v1_format_ref for migration routing`\n        );\n      }\n    }\n  }\n}\n\n/**\n * Conceal migration-only legacy identities from canonical format declarations\n * while extracting their durable downgrade routes first.\n *\n * This is the declaration-array counterpart to\n * {@link toAdditiveCanonicalProduct}. It is intended for persisted catalogs\n * and other consumers that do not hold a complete Product. The source array\n * and declarations are never mutated.\n *\n * @throws TypeError when a canonical declaration uses a direct legacy identity\n * alias such as `agent_url` or `agentUrl` instead of `v1_format_ref`.\n */\nexport function toCanonicalFormatOptionsWithRoutes(\n  productId: string,\n  formatOptions: readonly V2ProductFormatDeclaration[]\n): {\n  formatOptions: CanonicalFormatDeclaration[];\n  routes: CanonicalFormatLegacyRoute[];\n} {\n  assertNoDirectLegacyFormatAliases(formatOptions);\n  const routes = legacyRoutesForProduct(productId, formatOptions);\n  return {\n    formatOptions: canonicalDeclarations(formatOptions),\n    routes,\n  };\n}\n\n/**\n * Project a Product to an additive, URL-free canonical surface.\n *\n * Unlike {@link augmentProductWithFormatOptions}, this always returns fresh\n * `format_options[]` declarations with `v1_format_ref` concealed. Unlike\n * {@link toCanonicalOnlyProduct}, it preserves the Product's top-level\n * `format_ids[]`. Exact canonical-to-legacy downgrade identity is returned\n * separately as JSON-safe {@link CanonicalFormatLegacyRoute} sidecars.\n *\n * Extract `routes` before any JSON round-trip — WeakMap metadata is gone after\n * deserialization. This helper enforces that ordering internally; persist its\n * returned `routes` whenever a canonical selection may cross a process boundary\n * before being forwarded to a legacy seller. Rebuild the write-side resolver\n * with `canonicalFormatLegacyResolverFromRoutes(restoredRoutes)`.\n *\n * @throws TypeError when a canonical declaration uses a direct legacy identity\n * alias such as `agent_url` or `agentUrl` instead of `v1_format_ref`.\n */\nexport function toAdditiveCanonicalProduct<P extends V1Product>(\n  product: P,\n  options?: V1ToV2ProjectionOptions\n): {\n  product: AdditiveCanonicalProduct<P>;\n  diagnostics: ProjectionDiagnostic[];\n  routes: CanonicalFormatLegacyRoute[];\n} {\n  const { product: augmented, diagnostics } = augmentProductWithFormatOptions(product, options);\n  const projected = toCanonicalFormatOptionsWithRoutes(product.product_id, augmented.format_options);\n  return {\n    product: {\n      ...augmented,\n      format_options: projected.formatOptions,\n    } as AdditiveCanonicalProduct<P>,\n    diagnostics,\n    routes: projected.routes,\n  };\n}\n\n/**\n * Response-level companion to {@link toAdditiveCanonicalProduct}. Projects\n * every Product and accumulates its serializable legacy routes.\n */\nexport function withAdditiveCanonicalFormatOptions<R extends { products?: V1Product[] }>(\n  response: R,\n  options?: V1ToV2ProjectionOptions\n): {\n  response: Omit<R, 'products'> & { products: AdditiveCanonicalProduct<V1Product>[] };\n  diagnostics: ProjectionDiagnostic[];\n  routes: CanonicalFormatLegacyRoute[];\n} {\n  if (!Array.isArray(response?.products)) {\n    return {\n      response: { ...response, products: [] } as Omit<R, 'products'> & {\n        products: AdditiveCanonicalProduct<V1Product>[];\n      },\n      diagnostics: [],\n      routes: [],\n    };\n  }\n  const products: AdditiveCanonicalProduct<V1Product>[] = [];\n  const diagnostics: ProjectionDiagnostic[] = [];\n  const routes: CanonicalFormatLegacyRoute[] = [];\n  for (const sourceProduct of response.products) {\n    const projected = toAdditiveCanonicalProduct(sourceProduct, options);\n    products.push(projected.product);\n    diagnostics.push(...projected.diagnostics);\n    routes.push(...projected.routes);\n  }\n  return {\n    response: { ...response, products } as Omit<R, 'products'> & {\n      products: AdditiveCanonicalProduct<V1Product>[];\n    },\n    diagnostics,\n    routes,\n  };\n}\n\n/**\n * A Product reduced to the canonical creative-format surface:\n * `format_options[]` only, with the legacy `format_ids[]` removed. The\n * read-side counterpart to a fully-migrated consumer — naive downstream\n * code can no longer fall back to the stale `{ agent_url, id }` shape and\n * silently bypass the canonical model.\n */\nexport type CanonicalOnlyProduct<P> = Omit<P, 'format_ids'> & {\n  format_ids?: never;\n  format_options: CanonicalFormatDeclaration[];\n};\n\nfunction canonicalDeclarations(values: readonly V2ProductFormatDeclaration[]): CanonicalFormatDeclaration[] {\n  return values.map(value => concealLegacyFormatRefs(value));\n}\n\nfunction canonicalPlacements(\n  product: Record<string, unknown>,\n  options: V1ToV2ProjectionOptions | undefined,\n  diagnostics: ProjectionDiagnostic[]\n): unknown {\n  if (!Array.isArray(product.placements)) return product.placements;\n  return product.placements.map((value, placementIndex) => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) return value;\n    const placement = value as Record<string, unknown>;\n    const { format_ids: _drop, ...rest } = placement;\n    void _drop;\n    const hasLegacyFormats = Array.isArray(placement.format_ids);\n    const hasCanonicalFormats = Array.isArray(placement.format_options);\n    if (!hasLegacyFormats && !hasCanonicalFormats) return rest;\n\n    const productId = typeof product.product_id === 'string' ? product.product_id : '(unknown)';\n    const placementId = typeof placement.placement_id === 'string' ? placement.placement_id : String(placementIndex);\n    const pseudoProduct = {\n      product_id: `${productId}:placement:${placementId}`,\n      name: typeof placement.name === 'string' ? placement.name : placementId,\n      description: `Nested placement ${placementId}`,\n      ...(hasLegacyFormats ? { format_ids: placement.format_ids } : {}),\n      ...(hasCanonicalFormats ? { format_options: placement.format_options } : {}),\n    } as unknown as V1Product;\n    const projected = toCanonicalOnlyProduct(pseudoProduct, options);\n    for (const diagnostic of projected.diagnostics) {\n      diagnostics.push({\n        ...diagnostic,\n        field: diagnostic.field.replace(/^products\\[[^\\]]+\\]/, `products[${productId}].placements[${placementIndex}]`),\n      });\n    }\n    return {\n      ...rest,\n      format_options: projected.product.format_options,\n    };\n  });\n}\n\n/**\n * Identity key for a `format_id` ref used by the coverage check.\n * Trailing-slash-insensitive on `agent_url` (folds the AAO host's slash /\n * no-slash forms, per `catalog.ts`'s `normalizeAgentUrl`), and includes the\n * dimensional discriminators so multi-size declarations sharing one\n * `{ agent_url, id }` but differing by size/duration are NOT collapsed —\n * the same key shape `write-side.ts` uses for v1 ref de-dup. Without the\n * size half, a `format_ids[]` entry for a size no `v1_format_ref` covers\n * would read as covered and be dropped silently.\n */\nfunction formatRefCoverageKey(ref: V1FormatId): string {\n  const url = ref.agent_url && !ref.agent_url.endsWith('/') ? ref.agent_url + '/' : ref.agent_url;\n  return `${url}::${ref.id}::${ref.width ?? ''}x${ref.height ?? ''}::${ref.duration_ms ?? ''}`;\n}\n\n/**\n * Project a single Product to the canonical-only shape: `format_options[]`\n * present, `format_ids[]` dropped.\n *\n * **Dropping legacy never silently loses a format.** Every input\n * `format_id` is either represented in the returned `format_options[]` or\n * surfaced in `diagnostics` — never discarded without a trace:\n *\n *   - **v1-shaped input** (`format_ids[]`, no `format_options[]`): runs the\n *     v1 → v2 projection. Mapped refs become `format_options[]`; any ref\n *     the projection can't map is surfaced as `FORMAT_PROJECTION_FAILED`.\n *   - **v2-native input** (`format_options[]` already present): keeps the\n *     seller's canonical surface and drops the redundant v1 fallback. If a\n *     legacy routing entry exists that no canonical option covers, it\n *     surfaces a canonical-safe `LEGACY_FORMAT_ID_DROPPED_UNMAPPED`\n *     diagnostic without echoing the routing identifier.\n *   - **neither shape**: returns `format_options: []`; there is nothing to\n *     project and nothing to lose.\n *\n * Pure and subtractive: unlike {@link augmentProductWithFormatOptions}\n * (which preserves `format_ids[]`), this drops it — the opt-in narrowing for\n * a consumer that has fully migrated. Complements the write-side\n * non-invertibility tracked at adcontextprotocol/adcp#4842 — this is the\n * read-side transparency half.\n */\nexport function toCanonicalOnlyProduct<P extends V1Product>(\n  product: P,\n  options?: V1ToV2ProjectionOptions\n): { product: CanonicalOnlyProduct<P>; diagnostics: ProjectionDiagnostic[] } {\n  const existing = (product as unknown as { format_options?: unknown }).format_options;\n\n  // v2-native: the seller already sent format_options[]. Drop the\n  // redundant v1 fallback, but flag any legacy ref no v1_format_ref covers.\n  if (Array.isArray(existing)) {\n    const formatOptions = existing as V2ProductFormatDeclaration[];\n    const diagnostics: ProjectionDiagnostic[] = [];\n    const inputIds = Array.isArray(product.format_ids) ? product.format_ids : [];\n    if (inputIds.length > 0) {\n      const covered = new Set<string>();\n      for (const opt of formatOptions) {\n        const refs = Array.isArray(opt?.v1_format_ref) ? opt.v1_format_ref : [];\n        for (const ref of refs) covered.add(formatRefCoverageKey(ref));\n      }\n      for (let k = 0; k < inputIds.length; k++) {\n        const fid = inputIds[k]!;\n        if (!covered.has(formatRefCoverageKey(fid))) {\n          diagnostics.push({\n            source: 'sdk',\n            sdk_id: SDK_ID,\n            field: `products[${product.product_id}].format_options`,\n            code: 'LEGACY_FORMAT_ID_DROPPED_UNMAPPED',\n            error: {\n              details: {\n                product_id: product.product_id,\n                resolution_failure: 'unmapped_legacy_format',\n              },\n            },\n          });\n        }\n      }\n    }\n    const { format_ids: _dropV2, ...rest } = product as P & { format_ids?: unknown };\n    void _dropV2;\n    return {\n      product: {\n        ...rest,\n        format_options: canonicalDeclarations(formatOptions),\n        ...(Array.isArray((product as Record<string, unknown>).placements)\n          ? { placements: canonicalPlacements(product as Record<string, unknown>, options, diagnostics) }\n          : {}),\n      } as CanonicalOnlyProduct<P>,\n      diagnostics: diagnostics.map(canonicalDiagnostic),\n    };\n  }\n\n  // v1 shape: project. projectV1ProductToV2 already omits format_ids and\n  // emits a diagnostic for every ref it couldn't map.\n  if (Array.isArray(product.format_ids)) {\n    const { v2, diagnostics } = projectV1ProductToV2(product, options);\n    const { format_ids: _dropV1, ...rest } = product as P & { format_ids?: unknown };\n    void _dropV1;\n    return {\n      product: {\n        ...(rest as Omit<P, 'format_ids'>),\n        format_options: canonicalDeclarations(v2.format_options),\n        ...(Array.isArray((product as Record<string, unknown>).placements)\n          ? { placements: canonicalPlacements(product as Record<string, unknown>, options, diagnostics) }\n          : {}),\n      } as CanonicalOnlyProduct<P>,\n      diagnostics: diagnostics.map(canonicalDiagnostic),\n    };\n  }\n\n  // Neither shape — nothing to project, nothing to lose.\n  const { format_ids: _dropNone, ...rest } = product as P & { format_ids?: unknown };\n  void _dropNone;\n  const diagnostics: ProjectionDiagnostic[] = [];\n  return {\n    product: {\n      ...(rest as Omit<P, 'format_ids'>),\n      format_options: [],\n      ...(Array.isArray((product as Record<string, unknown>).placements)\n        ? { placements: canonicalPlacements(product as Record<string, unknown>, options, diagnostics) }\n        : {}),\n    } as CanonicalOnlyProduct<P>,\n    diagnostics: diagnostics.map(canonicalDiagnostic),\n  };\n}\n\n/**\n * Reduce every Product in a `get_products` response to the canonical-only\n * shape — `format_options[]` present, `format_ids[]` dropped. Returns\n * `{ response, diagnostics }` so callers surface projection diagnostics\n * alongside the response's existing `errors[]`.\n *\n * Response-level counterpart to {@link toCanonicalOnlyProduct}; same\n * fail-closed guarantee, aggregated across products. A wholly unmappable\n * legacy product cannot be represented as a canonical Product because the\n * protocol requires `format_options` to contain at least one declaration. It\n * is therefore omitted from the canonical list and surfaced through the\n * response's portable `errors[]` plus the SDK convenience diagnostics. A\n * partially mappable product remains with its mapped options and advisories\n * for the refs that could not be projected.\n */\nexport function toCanonicalOnlyResponse<R extends { products?: V1Product[] }>(\n  response: R,\n  options?: V1ToV2ProjectionOptions\n): {\n  response: Omit<R, 'products'> & { products: CanonicalOnlyProduct<V1Product>[]; errors?: unknown[] };\n  diagnostics: ProjectionDiagnostic[];\n} {\n  if (!Array.isArray(response?.products)) {\n    return {\n      response: { ...response, products: [] } as Omit<R, 'products'> & {\n        products: CanonicalOnlyProduct<V1Product>[];\n        errors?: unknown[];\n      },\n      diagnostics: [],\n    };\n  }\n  const out: CanonicalOnlyProduct<V1Product>[] = [];\n  const diagnostics: ProjectionDiagnostic[] = [];\n  const originalToOutputIndex = new Map<number, number | undefined>();\n  for (let productIndex = 0; productIndex < response.products.length; productIndex++) {\n    const p = response.products[productIndex]!;\n    const { product, diagnostics: rawDiagnostics } = toCanonicalOnlyProduct(p, options);\n    const hasEmptyPlacement = hasEmptyPlacementFormatOptions(product);\n    const keep = product.format_options.length > 0 && !hasEmptyPlacement;\n    const outputIndex = keep ? out.length : undefined;\n    originalToOutputIndex.set(productIndex, outputIndex);\n    const d = rawDiagnostics.map(diagnostic => ({\n      ...diagnostic,\n      field: keep ? diagnostic.field.replace(/^products\\[[^\\]]+\\]/, `products[${outputIndex}]`) : 'products',\n      error: keep\n        ? diagnostic.error\n        : {\n            details: {\n              ...diagnostic.error.details,\n              product_id: p.product_id,\n            },\n          },\n    })) as ProjectionDiagnostic[];\n    if (!keep && d.length === 0) {\n      const reason = hasEmptyPlacement\n        ? 'nested_placement_format_list_empty'\n        : Array.isArray((p as Record<string, unknown>).format_options)\n          ? 'canonical_format_list_empty'\n          : Array.isArray(p.format_ids)\n            ? 'legacy_format_list_empty'\n            : 'missing_format_declaration';\n      d.push({\n        ...canonicalFormatsUnavailableForProduct(p, reason),\n        field: 'products',\n      });\n    }\n    diagnostics.push(...d);\n    if (keep) out.push(product);\n  }\n  const remappedExistingErrors = remapExistingProductErrors(\n    (response as { errors?: unknown }).errors,\n    originalToOutputIndex,\n    response.products\n  );\n  const errors = mergeProjectionErrors(remappedExistingErrors, diagnostics);\n  return {\n    response: {\n      ...response,\n      products: out,\n      ...(errors.length > 0 ? { errors } : {}),\n    } as Omit<R, 'products'> & { products: CanonicalOnlyProduct<V1Product>[]; errors?: unknown[] },\n    diagnostics,\n  };\n}\n"],"mappings":"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","names":["canonicalizeJson","diagnostics","rest"]}

package/dist/lib/v2/projection/augment-response.mjs

@@ -184,17 +184,24 @@ function assertNoDirectLegacyFormatAliases(declarations) {
     }
   }
 }
+function toCanonicalFormatOptionsWithRoutes(productId, formatOptions) {
+  assertNoDirectLegacyFormatAliases(formatOptions);
+  const routes = legacyRoutesForProduct(productId, formatOptions);
+  return {
+    formatOptions: canonicalDeclarations(formatOptions),
+    routes
+  };
+}
 function toAdditiveCanonicalProduct(product, options) {
   const { product: augmented, diagnostics } = augmentProductWithFormatOptions(product, options);
-  const routes = legacyRoutesForProduct(product.product_id, augmented.format_options);
-  assertNoDirectLegacyFormatAliases(augmented.format_options);
+  const projected = toCanonicalFormatOptionsWithRoutes(product.product_id, augmented.format_options);
   return {
     product: {
       ...augmented,
-      format_options: canonicalDeclarations(augmented.format_options)
+      format_options: projected.formatOptions
     },
     diagnostics,
-    routes
+    routes: projected.routes
   };
 }
 function withAdditiveCanonicalFormatOptions(response, options) {
@@ -381,6 +388,7 @@ export {
   augmentProductWithFormatOptions,
   projectionDiagnosticToError,
   toAdditiveCanonicalProduct,
+  toCanonicalFormatOptionsWithRoutes,
   toCanonicalOnlyProduct,
   toCanonicalOnlyResponse,
   withAdditiveCanonicalFormatOptions,

package/dist/lib/v2/projection/augment-response.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/v2/projection/augment-response.ts"],"sourcesContent":["/**\n * Buyer-side helpers that augment a v1-shaped agent response with v2\n * `format_options[]` derived from the existing `format_ids[]` on each\n * Product.\n *\n * Buyers who want the canonical creative-format model call\n * `withFormatOptions(response)` and read `format_options` instead of\n * relying only on legacy `format_ids`.\n *\n * The SDK also auto-projects compatible `AgentClient.getProducts()`\n * responses; this helper remains useful for cached responses, fixtures,\n * upstream seller/storefront composition, and explicit migration code.\n *\n * Pure functions — no IO, no caching. Each Product is projected\n * independently; diagnostics aggregate so a multi-product response\n * surfaces every projection issue at once. The helpers preserve the\n * input shape verbatim and add `format_options[]` (additive). They do\n * NOT drop `format_ids[]` — that's the 8.0 narrowing. To DROP\n * `format_ids[]` once a consumer has fully migrated, use\n * `toCanonicalOnlyProduct` / `toCanonicalOnlyResponse`.\n */\n\nimport type { V1Product, V1FormatId, V2ProductFormatDeclaration, ProjectionDiagnostic } from './types';\nimport { projectV1ProductToV2 } from './v1-to-v2';\nimport type { V1ToV2ProjectionOptions } from './v1-to-v2';\nimport { LIBRARY_VERSION } from '../../version';\nimport { canonicalize as canonicalizeJson } from '../../utils/jcs';\nimport { concealLegacyFormatRefs } from './legacy-metadata';\nimport type { CanonicalFormatDeclaration } from './legacy-metadata';\nimport { legacyRoutesForProduct } from './legacy-routes';\nimport type { CanonicalFormatLegacyRoute } from './legacy-routes';\n\nconst SDK_ID = `@adcp/sdk@${LIBRARY_VERSION}`;\nconst DIRECT_LEGACY_FORMAT_IDENTITY_KEYS = new Set(['agenturl', 'formatid', 'formatids', 'v1formatref']);\n\nfunction canonicalDiagnostic(diagnostic: ProjectionDiagnostic): ProjectionDiagnostic {\n  return {\n    ...diagnostic,\n    // A source `format_ids[i]` index is not an index into the projected\n    // `format_options[]`: earlier source refs may have failed while later refs\n    // projected successfully. Point at the canonical collection instead of\n    // claiming that a successful projected option is the failing value.\n    field: diagnostic.field.replace(/\\.format_ids\\[\\d+\\]/g, '.format_options'),\n  };\n}\n\n/** Protocol Error shape used for portable response-level projection advisories. */\nexport interface CanonicalProjectionError {\n  code: ProjectionDiagnostic['code'];\n  message: string;\n  field: string;\n  recovery: 'correctable';\n  source: 'sdk';\n  sdk_id: string;\n  details: ProjectionDiagnostic['error']['details'];\n}\n\nfunction projectionErrorMessage(code: ProjectionDiagnostic['code']): string {\n  switch (code) {\n    case 'CANONICAL_PRODUCT_FORMATS_UNAVAILABLE':\n      return 'Product has no format declaration representable on the canonical-only surface';\n    case 'FORMAT_PROJECTION_FAILED':\n      return 'Legacy creative format could not be projected to a canonical declaration';\n    case 'FORMAT_DECLARATION_V1_AMBIGUOUS':\n      return 'Canonical creative format has no unambiguous legacy declaration';\n    case 'FORMAT_DECLARATION_V1_NOT_APPLICABLE':\n      return 'Canonical-only creative format cannot be represented on a legacy format path';\n    case 'CANONICAL_NOT_V1_TRANSLATABLE':\n      return 'Canonical creative format has no legacy representation';\n    case 'FORMAT_DECLARATION_V1_LOSSY_MULTI_SIZE':\n      return 'Canonical multi-size format has incomplete legacy coverage';\n    case 'LEGACY_FORMAT_ID_DROPPED_UNMAPPED':\n      return 'Redundant legacy creative identity has no canonical counterpart';\n  }\n}\n\n/** Flatten the projector's internal diagnostic into the protocol `Error` shape. */\nexport function projectionDiagnosticToError(diagnostic: ProjectionDiagnostic): CanonicalProjectionError {\n  return {\n    code: diagnostic.code,\n    message: projectionErrorMessage(diagnostic.code),\n    field: diagnostic.field,\n    recovery: 'correctable',\n    source: diagnostic.source,\n    sdk_id: diagnostic.sdk_id,\n    details: diagnostic.error.details,\n  } as CanonicalProjectionError;\n}\n\nfunction canonicalFormatsUnavailableForProduct(\n  product: V1Product,\n  reason: Extract<ProjectionDiagnostic, { code: 'CANONICAL_PRODUCT_FORMATS_UNAVAILABLE' }>['error']['details']['reason']\n): ProjectionDiagnostic {\n  return {\n    source: 'sdk',\n    sdk_id: SDK_ID,\n    field: `products[${product.product_id}].format_options`,\n    code: 'CANONICAL_PRODUCT_FORMATS_UNAVAILABLE',\n    error: {\n      details: {\n        product_id: product.product_id,\n        reason,\n      },\n    },\n  };\n}\n\nfunction errorIdentity(value: Record<string, unknown>): string | undefined {\n  if (typeof value.code !== 'string' || typeof value.field !== 'string') return undefined;\n  try {\n    return `${value.code}\\u0000${value.field}\\u0000${canonicalizeJson(value.details ?? null)}`;\n  } catch {\n    // Preserve unreadable third-party errors instead of falsely deduplicating.\n    return undefined;\n  }\n}\n\nfunction mergeProjectionErrors(existing: unknown, diagnostics: readonly ProjectionDiagnostic[]): unknown[] {\n  const merged = Array.isArray(existing) ? [...existing] : [];\n  const seen = new Set<string>();\n  for (const value of merged) {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) continue;\n    const record = value as Record<string, unknown>;\n    const key = errorIdentity(record);\n    if (key) seen.add(key);\n  }\n  for (const diagnostic of diagnostics) {\n    const error = projectionDiagnosticToError(diagnostic) as unknown as Record<string, unknown>;\n    const key = errorIdentity(error)!;\n    if (seen.has(key)) continue;\n    seen.add(key);\n    merged.push(error);\n  }\n  return merged;\n}\n\nfunction remapExistingProductErrors(\n  existing: unknown,\n  originalToOutputIndex: ReadonlyMap<number, number | undefined>,\n  products: readonly V1Product[]\n): unknown {\n  if (!Array.isArray(existing)) return existing;\n  return existing.map(value => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) return value;\n    const record = value as Record<string, unknown>;\n    let issuesChanged = false;\n    const issues = Array.isArray(record.issues)\n      ? record.issues.map(issue => {\n          if (!issue || typeof issue !== 'object' || Array.isArray(issue)) return issue;\n          const issueRecord = issue as Record<string, unknown>;\n          if (typeof issueRecord.pointer !== 'string') return issue;\n          const pointerMatch = /^\\/products\\/(\\d+)(\\/.*)?$/.exec(issueRecord.pointer);\n          if (!pointerMatch) return issue;\n          const originalIssueIndex = Number(pointerMatch[1]);\n          if (!originalToOutputIndex.has(originalIssueIndex)) return issue;\n          const outputIssueIndex = originalToOutputIndex.get(originalIssueIndex);\n          issuesChanged = true;\n          return {\n            ...issueRecord,\n            pointer:\n              outputIssueIndex === undefined ? '/products' : `/products/${outputIssueIndex}${pointerMatch[2] ?? ''}`,\n          };\n        })\n      : record.issues;\n    const withIssues = issuesChanged ? { ...record, issues } : record;\n    if (typeof record.field !== 'string') return issuesChanged ? withIssues : value;\n    const match = /^products\\[(\\d+)\\](.*)$/.exec(record.field);\n    if (!match) return issuesChanged ? withIssues : value;\n    const originalIndex = Number(match[1]);\n    if (!originalToOutputIndex.has(originalIndex)) return issuesChanged ? withIssues : value;\n    const outputIndex = originalToOutputIndex.get(originalIndex);\n    if (outputIndex !== undefined) {\n      return { ...withIssues, field: `products[${outputIndex}]${match[2] ?? ''}` };\n    }\n    const productId = products[originalIndex]?.product_id;\n    const details =\n      record.details && typeof record.details === 'object' && !Array.isArray(record.details)\n        ? { ...(record.details as Record<string, unknown>) }\n        : {};\n    if (typeof productId === 'string' && details.product_id === undefined) details.product_id = productId;\n    return { ...withIssues, field: 'products', ...(Object.keys(details).length > 0 ? { details } : {}) };\n  });\n}\n\nfunction hasEmptyPlacementFormatOptions(product: CanonicalOnlyProduct<V1Product>): boolean {\n  const placements = (product as Record<string, unknown>).placements;\n  if (!Array.isArray(placements)) return false;\n  return placements.some(value => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) return false;\n    const options = (value as Record<string, unknown>).format_options;\n    return Array.isArray(options) && options.length === 0;\n  });\n}\n\n/**\n * A Product that has been augmented with `format_options[]` while\n * preserving the original `format_ids[]`. Carries the projection\n * diagnostics that were generated mapping each `format_id` so the\n * buyer can see what (if anything) didn't project cleanly.\n *\n * **Write-side bridge.** After picking a `format_options[i]` entry,\n * use {@link formatIdsFromOptions} (from `@adcp/sdk/v2/projection`)\n * to extract the `format_ids[]` value for a `create_media_buy`\n * package. Inlining `decl.v1_format_ref` works but bypasses the\n * fail-closed semantics (canonical_formats_only / inherently-v2\n * canonical → throw). The spec gap that forces this bridge is tracked\n * at adcontextprotocol/adcp#4842.\n *\n * @see formatIdsFromOptions\n * @see formatIdsForCapability\n */\nexport type V2AugmentedProduct<P> = P & {\n  format_options: V2ProductFormatDeclaration[];\n};\n\n/**\n * Augment a single Product. Idempotent — when `format_options[]` is\n * already present (the seller is v2-native), passes the Product\n * through unchanged. Otherwise projects from `format_ids[]`.\n *\n * Returns `{ product, diagnostics }`. `diagnostics` is empty for a\n * clean projection; populated when individual format_ids don't have\n * a v2 mapping (catalog gap, structural unreachability, etc.).\n *\n * @see toCanonicalOnlyProduct — the canonical-only counterpart that DROPS\n * `format_ids[]` for a fully-migrated consumer.\n */\nexport function augmentProductWithFormatOptions<P extends V1Product>(\n  product: P,\n  options?: V1ToV2ProjectionOptions\n): { product: V2AugmentedProduct<P>; diagnostics: ProjectionDiagnostic[] } {\n  // Already v2-shaped (seller sent format_options directly) — pass through.\n  const existing = (product as unknown as { format_options?: unknown }).format_options;\n  if (Array.isArray(existing)) {\n    return {\n      product: product as V2AugmentedProduct<P>,\n      diagnostics: [],\n    };\n  }\n  // v1 shape — project to add format_options[].\n  if (!Array.isArray(product.format_ids)) {\n    // Neither shape — nothing to project. Return as-is with an empty\n    // format_options so the buyer doesn't have to special-case.\n    return {\n      product: { ...product, format_options: [] },\n      diagnostics: [],\n    };\n  }\n  const { v2, diagnostics } = projectV1ProductToV2(product, options);\n  // Preserve the original product shape (especially format_ids); just\n  // add format_options.\n  return {\n    product: {\n      ...product,\n      format_options: v2.format_options,\n    },\n    diagnostics,\n  };\n}\n\n/**\n * Augment every Product in a `get_products` response with\n * `format_options[]`. Returns `{ response, diagnostics }` so callers\n * can surface projection diagnostics alongside the response's existing\n * `errors[]` array (or filter by `source: 'sdk'` to distinguish SDK\n * diagnostics from seller-emitted errors).\n *\n * Idempotent: if the seller is v2-native and every Product already\n * carries `format_options[]`, returns the response verbatim with no\n * diagnostics.\n *\n * @see toCanonicalOnlyResponse — the canonical-only counterpart that DROPS\n * `format_ids[]` for a fully-migrated consumer.\n */\nexport function withFormatOptions<R extends { products?: V1Product[] }>(\n  response: R,\n  options?: V1ToV2ProjectionOptions\n): { response: R & { products: V2AugmentedProduct<V1Product>[] }; diagnostics: ProjectionDiagnostic[] } {\n  if (!Array.isArray(response?.products)) {\n    return {\n      response: { ...response, products: [] } as R & { products: V2AugmentedProduct<V1Product>[] },\n      diagnostics: [],\n    };\n  }\n  const out: V2AugmentedProduct<V1Product>[] = [];\n  const diagnostics: ProjectionDiagnostic[] = [];\n  for (const p of response.products) {\n    const { product, diagnostics: d } = augmentProductWithFormatOptions(p, options);\n    out.push(product);\n    diagnostics.push(...d);\n  }\n  return {\n    response: { ...response, products: out } as R & { products: V2AugmentedProduct<V1Product>[] },\n    diagnostics,\n  };\n}\n\n/**\n * An additive canonical Product: canonical declarations contain no legacy\n * routing identity, while the Product's top-level `format_ids[]` remains\n * available to compatibility consumers.\n */\nexport type AdditiveCanonicalProduct<P> = Omit<P, 'format_options'> & {\n  format_options: CanonicalFormatDeclaration[];\n};\n\nfunction assertNoDirectLegacyFormatAliases(declarations: readonly V2ProductFormatDeclaration[]): void {\n  for (let index = 0; index < declarations.length; index++) {\n    const declaration = declarations[index] as unknown as Record<string, unknown>;\n    for (const field of Object.keys(declaration)) {\n      if (\n        field !== 'v1_format_ref' &&\n        DIRECT_LEGACY_FORMAT_IDENTITY_KEYS.has(field.replaceAll('_', '').toLowerCase())\n      ) {\n        throw new TypeError(\n          `format_options[${index}] must not use legacy identity field ${field}; use v1_format_ref for migration routing`\n        );\n      }\n    }\n  }\n}\n\n/**\n * Project a Product to an additive, URL-free canonical surface.\n *\n * Unlike {@link augmentProductWithFormatOptions}, this always returns fresh\n * `format_options[]` declarations with `v1_format_ref` concealed. Unlike\n * {@link toCanonicalOnlyProduct}, it preserves the Product's top-level\n * `format_ids[]`. Exact canonical-to-legacy downgrade identity is returned\n * separately as JSON-safe {@link CanonicalFormatLegacyRoute} sidecars.\n *\n * Extract `routes` before any JSON round-trip — WeakMap metadata is gone after\n * deserialization. This helper enforces that ordering internally; persist its\n * returned `routes` whenever a canonical selection may cross a process boundary\n * before being forwarded to a legacy seller. Rebuild the write-side resolver\n * with `canonicalFormatLegacyResolverFromRoutes(restoredRoutes)`.\n *\n * @throws TypeError when a canonical declaration uses a direct legacy identity\n * alias such as `agent_url` or `agentUrl` instead of `v1_format_ref`.\n */\nexport function toAdditiveCanonicalProduct<P extends V1Product>(\n  product: P,\n  options?: V1ToV2ProjectionOptions\n): {\n  product: AdditiveCanonicalProduct<P>;\n  diagnostics: ProjectionDiagnostic[];\n  routes: CanonicalFormatLegacyRoute[];\n} {\n  const { product: augmented, diagnostics } = augmentProductWithFormatOptions(product, options);\n  const routes = legacyRoutesForProduct(product.product_id, augmented.format_options);\n  assertNoDirectLegacyFormatAliases(augmented.format_options);\n  return {\n    product: {\n      ...augmented,\n      format_options: canonicalDeclarations(augmented.format_options),\n    } as AdditiveCanonicalProduct<P>,\n    diagnostics,\n    routes,\n  };\n}\n\n/**\n * Response-level companion to {@link toAdditiveCanonicalProduct}. Projects\n * every Product and accumulates its serializable legacy routes.\n */\nexport function withAdditiveCanonicalFormatOptions<R extends { products?: V1Product[] }>(\n  response: R,\n  options?: V1ToV2ProjectionOptions\n): {\n  response: Omit<R, 'products'> & { products: AdditiveCanonicalProduct<V1Product>[] };\n  diagnostics: ProjectionDiagnostic[];\n  routes: CanonicalFormatLegacyRoute[];\n} {\n  if (!Array.isArray(response?.products)) {\n    return {\n      response: { ...response, products: [] } as Omit<R, 'products'> & {\n        products: AdditiveCanonicalProduct<V1Product>[];\n      },\n      diagnostics: [],\n      routes: [],\n    };\n  }\n  const products: AdditiveCanonicalProduct<V1Product>[] = [];\n  const diagnostics: ProjectionDiagnostic[] = [];\n  const routes: CanonicalFormatLegacyRoute[] = [];\n  for (const sourceProduct of response.products) {\n    const projected = toAdditiveCanonicalProduct(sourceProduct, options);\n    products.push(projected.product);\n    diagnostics.push(...projected.diagnostics);\n    routes.push(...projected.routes);\n  }\n  return {\n    response: { ...response, products } as Omit<R, 'products'> & {\n      products: AdditiveCanonicalProduct<V1Product>[];\n    },\n    diagnostics,\n    routes,\n  };\n}\n\n/**\n * A Product reduced to the canonical creative-format surface:\n * `format_options[]` only, with the legacy `format_ids[]` removed. The\n * read-side counterpart to a fully-migrated consumer — naive downstream\n * code can no longer fall back to the stale `{ agent_url, id }` shape and\n * silently bypass the canonical model.\n */\nexport type CanonicalOnlyProduct<P> = Omit<P, 'format_ids'> & {\n  format_ids?: never;\n  format_options: CanonicalFormatDeclaration[];\n};\n\nfunction canonicalDeclarations(values: readonly V2ProductFormatDeclaration[]): CanonicalFormatDeclaration[] {\n  return values.map(value => concealLegacyFormatRefs(value));\n}\n\nfunction canonicalPlacements(\n  product: Record<string, unknown>,\n  options: V1ToV2ProjectionOptions | undefined,\n  diagnostics: ProjectionDiagnostic[]\n): unknown {\n  if (!Array.isArray(product.placements)) return product.placements;\n  return product.placements.map((value, placementIndex) => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) return value;\n    const placement = value as Record<string, unknown>;\n    const { format_ids: _drop, ...rest } = placement;\n    void _drop;\n    const hasLegacyFormats = Array.isArray(placement.format_ids);\n    const hasCanonicalFormats = Array.isArray(placement.format_options);\n    if (!hasLegacyFormats && !hasCanonicalFormats) return rest;\n\n    const productId = typeof product.product_id === 'string' ? product.product_id : '(unknown)';\n    const placementId = typeof placement.placement_id === 'string' ? placement.placement_id : String(placementIndex);\n    const pseudoProduct = {\n      product_id: `${productId}:placement:${placementId}`,\n      name: typeof placement.name === 'string' ? placement.name : placementId,\n      description: `Nested placement ${placementId}`,\n      ...(hasLegacyFormats ? { format_ids: placement.format_ids } : {}),\n      ...(hasCanonicalFormats ? { format_options: placement.format_options } : {}),\n    } as unknown as V1Product;\n    const projected = toCanonicalOnlyProduct(pseudoProduct, options);\n    for (const diagnostic of projected.diagnostics) {\n      diagnostics.push({\n        ...diagnostic,\n        field: diagnostic.field.replace(/^products\\[[^\\]]+\\]/, `products[${productId}].placements[${placementIndex}]`),\n      });\n    }\n    return {\n      ...rest,\n      format_options: projected.product.format_options,\n    };\n  });\n}\n\n/**\n * Identity key for a `format_id` ref used by the coverage check.\n * Trailing-slash-insensitive on `agent_url` (folds the AAO host's slash /\n * no-slash forms, per `catalog.ts`'s `normalizeAgentUrl`), and includes the\n * dimensional discriminators so multi-size declarations sharing one\n * `{ agent_url, id }` but differing by size/duration are NOT collapsed —\n * the same key shape `write-side.ts` uses for v1 ref de-dup. Without the\n * size half, a `format_ids[]` entry for a size no `v1_format_ref` covers\n * would read as covered and be dropped silently.\n */\nfunction formatRefCoverageKey(ref: V1FormatId): string {\n  const url = ref.agent_url && !ref.agent_url.endsWith('/') ? ref.agent_url + '/' : ref.agent_url;\n  return `${url}::${ref.id}::${ref.width ?? ''}x${ref.height ?? ''}::${ref.duration_ms ?? ''}`;\n}\n\n/**\n * Project a single Product to the canonical-only shape: `format_options[]`\n * present, `format_ids[]` dropped.\n *\n * **Dropping legacy never silently loses a format.** Every input\n * `format_id` is either represented in the returned `format_options[]` or\n * surfaced in `diagnostics` — never discarded without a trace:\n *\n *   - **v1-shaped input** (`format_ids[]`, no `format_options[]`): runs the\n *     v1 → v2 projection. Mapped refs become `format_options[]`; any ref\n *     the projection can't map is surfaced as `FORMAT_PROJECTION_FAILED`.\n *   - **v2-native input** (`format_options[]` already present): keeps the\n *     seller's canonical surface and drops the redundant v1 fallback. If a\n *     legacy routing entry exists that no canonical option covers, it\n *     surfaces a canonical-safe `LEGACY_FORMAT_ID_DROPPED_UNMAPPED`\n *     diagnostic without echoing the routing identifier.\n *   - **neither shape**: returns `format_options: []`; there is nothing to\n *     project and nothing to lose.\n *\n * Pure and subtractive: unlike {@link augmentProductWithFormatOptions}\n * (which preserves `format_ids[]`), this drops it — the opt-in narrowing for\n * a consumer that has fully migrated. Complements the write-side\n * non-invertibility tracked at adcontextprotocol/adcp#4842 — this is the\n * read-side transparency half.\n */\nexport function toCanonicalOnlyProduct<P extends V1Product>(\n  product: P,\n  options?: V1ToV2ProjectionOptions\n): { product: CanonicalOnlyProduct<P>; diagnostics: ProjectionDiagnostic[] } {\n  const existing = (product as unknown as { format_options?: unknown }).format_options;\n\n  // v2-native: the seller already sent format_options[]. Drop the\n  // redundant v1 fallback, but flag any legacy ref no v1_format_ref covers.\n  if (Array.isArray(existing)) {\n    const formatOptions = existing as V2ProductFormatDeclaration[];\n    const diagnostics: ProjectionDiagnostic[] = [];\n    const inputIds = Array.isArray(product.format_ids) ? product.format_ids : [];\n    if (inputIds.length > 0) {\n      const covered = new Set<string>();\n      for (const opt of formatOptions) {\n        const refs = Array.isArray(opt?.v1_format_ref) ? opt.v1_format_ref : [];\n        for (const ref of refs) covered.add(formatRefCoverageKey(ref));\n      }\n      for (let k = 0; k < inputIds.length; k++) {\n        const fid = inputIds[k]!;\n        if (!covered.has(formatRefCoverageKey(fid))) {\n          diagnostics.push({\n            source: 'sdk',\n            sdk_id: SDK_ID,\n            field: `products[${product.product_id}].format_options`,\n            code: 'LEGACY_FORMAT_ID_DROPPED_UNMAPPED',\n            error: {\n              details: {\n                product_id: product.product_id,\n                resolution_failure: 'unmapped_legacy_format',\n              },\n            },\n          });\n        }\n      }\n    }\n    const { format_ids: _dropV2, ...rest } = product as P & { format_ids?: unknown };\n    void _dropV2;\n    return {\n      product: {\n        ...rest,\n        format_options: canonicalDeclarations(formatOptions),\n        ...(Array.isArray((product as Record<string, unknown>).placements)\n          ? { placements: canonicalPlacements(product as Record<string, unknown>, options, diagnostics) }\n          : {}),\n      } as CanonicalOnlyProduct<P>,\n      diagnostics: diagnostics.map(canonicalDiagnostic),\n    };\n  }\n\n  // v1 shape: project. projectV1ProductToV2 already omits format_ids and\n  // emits a diagnostic for every ref it couldn't map.\n  if (Array.isArray(product.format_ids)) {\n    const { v2, diagnostics } = projectV1ProductToV2(product, options);\n    const { format_ids: _dropV1, ...rest } = product as P & { format_ids?: unknown };\n    void _dropV1;\n    return {\n      product: {\n        ...(rest as Omit<P, 'format_ids'>),\n        format_options: canonicalDeclarations(v2.format_options),\n        ...(Array.isArray((product as Record<string, unknown>).placements)\n          ? { placements: canonicalPlacements(product as Record<string, unknown>, options, diagnostics) }\n          : {}),\n      } as CanonicalOnlyProduct<P>,\n      diagnostics: diagnostics.map(canonicalDiagnostic),\n    };\n  }\n\n  // Neither shape — nothing to project, nothing to lose.\n  const { format_ids: _dropNone, ...rest } = product as P & { format_ids?: unknown };\n  void _dropNone;\n  const diagnostics: ProjectionDiagnostic[] = [];\n  return {\n    product: {\n      ...(rest as Omit<P, 'format_ids'>),\n      format_options: [],\n      ...(Array.isArray((product as Record<string, unknown>).placements)\n        ? { placements: canonicalPlacements(product as Record<string, unknown>, options, diagnostics) }\n        : {}),\n    } as CanonicalOnlyProduct<P>,\n    diagnostics: diagnostics.map(canonicalDiagnostic),\n  };\n}\n\n/**\n * Reduce every Product in a `get_products` response to the canonical-only\n * shape — `format_options[]` present, `format_ids[]` dropped. Returns\n * `{ response, diagnostics }` so callers surface projection diagnostics\n * alongside the response's existing `errors[]`.\n *\n * Response-level counterpart to {@link toCanonicalOnlyProduct}; same\n * fail-closed guarantee, aggregated across products. A wholly unmappable\n * legacy product cannot be represented as a canonical Product because the\n * protocol requires `format_options` to contain at least one declaration. It\n * is therefore omitted from the canonical list and surfaced through the\n * response's portable `errors[]` plus the SDK convenience diagnostics. A\n * partially mappable product remains with its mapped options and advisories\n * for the refs that could not be projected.\n */\nexport function toCanonicalOnlyResponse<R extends { products?: V1Product[] }>(\n  response: R,\n  options?: V1ToV2ProjectionOptions\n): {\n  response: Omit<R, 'products'> & { products: CanonicalOnlyProduct<V1Product>[]; errors?: unknown[] };\n  diagnostics: ProjectionDiagnostic[];\n} {\n  if (!Array.isArray(response?.products)) {\n    return {\n      response: { ...response, products: [] } as Omit<R, 'products'> & {\n        products: CanonicalOnlyProduct<V1Product>[];\n        errors?: unknown[];\n      },\n      diagnostics: [],\n    };\n  }\n  const out: CanonicalOnlyProduct<V1Product>[] = [];\n  const diagnostics: ProjectionDiagnostic[] = [];\n  const originalToOutputIndex = new Map<number, number | undefined>();\n  for (let productIndex = 0; productIndex < response.products.length; productIndex++) {\n    const p = response.products[productIndex]!;\n    const { product, diagnostics: rawDiagnostics } = toCanonicalOnlyProduct(p, options);\n    const hasEmptyPlacement = hasEmptyPlacementFormatOptions(product);\n    const keep = product.format_options.length > 0 && !hasEmptyPlacement;\n    const outputIndex = keep ? out.length : undefined;\n    originalToOutputIndex.set(productIndex, outputIndex);\n    const d = rawDiagnostics.map(diagnostic => ({\n      ...diagnostic,\n      field: keep ? diagnostic.field.replace(/^products\\[[^\\]]+\\]/, `products[${outputIndex}]`) : 'products',\n      error: keep\n        ? diagnostic.error\n        : {\n            details: {\n              ...diagnostic.error.details,\n              product_id: p.product_id,\n            },\n          },\n    })) as ProjectionDiagnostic[];\n    if (!keep && d.length === 0) {\n      const reason = hasEmptyPlacement\n        ? 'nested_placement_format_list_empty'\n        : Array.isArray((p as Record<string, unknown>).format_options)\n          ? 'canonical_format_list_empty'\n          : Array.isArray(p.format_ids)\n            ? 'legacy_format_list_empty'\n            : 'missing_format_declaration';\n      d.push({\n        ...canonicalFormatsUnavailableForProduct(p, reason),\n        field: 'products',\n      });\n    }\n    diagnostics.push(...d);\n    if (keep) out.push(product);\n  }\n  const remappedExistingErrors = remapExistingProductErrors(\n    (response as { errors?: unknown }).errors,\n    originalToOutputIndex,\n    response.products\n  );\n  const errors = mergeProjectionErrors(remappedExistingErrors, diagnostics);\n  return {\n    response: {\n      ...response,\n      products: out,\n      ...(errors.length > 0 ? { errors } : {}),\n    } as Omit<R, 'products'> & { products: CanonicalOnlyProduct<V1Product>[]; errors?: unknown[] },\n    diagnostics,\n  };\n}\n"],"mappings":"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","names":["diagnostics","rest"]}
+{"version":3,"sources":["../../../../src/lib/v2/projection/augment-response.ts"],"sourcesContent":["/**\n * Buyer-side helpers that augment a v1-shaped agent response with v2\n * `format_options[]` derived from the existing `format_ids[]` on each\n * Product.\n *\n * Buyers who want the canonical creative-format model call\n * `withFormatOptions(response)` and read `format_options` instead of\n * relying only on legacy `format_ids`.\n *\n * The SDK also auto-projects compatible `AgentClient.getProducts()`\n * responses; this helper remains useful for cached responses, fixtures,\n * upstream seller/storefront composition, and explicit migration code.\n *\n * Pure functions — no IO, no caching. Each Product is projected\n * independently; diagnostics aggregate so a multi-product response\n * surfaces every projection issue at once. The helpers preserve the\n * input shape verbatim and add `format_options[]` (additive). They do\n * NOT drop `format_ids[]` — that's the 8.0 narrowing. To DROP\n * `format_ids[]` once a consumer has fully migrated, use\n * `toCanonicalOnlyProduct` / `toCanonicalOnlyResponse`.\n */\n\nimport type { V1Product, V1FormatId, V2ProductFormatDeclaration, ProjectionDiagnostic } from './types';\nimport { projectV1ProductToV2 } from './v1-to-v2';\nimport type { V1ToV2ProjectionOptions } from './v1-to-v2';\nimport { LIBRARY_VERSION } from '../../version';\nimport { canonicalize as canonicalizeJson } from '../../utils/jcs';\nimport { concealLegacyFormatRefs } from './legacy-metadata';\nimport type { CanonicalFormatDeclaration } from './legacy-metadata';\nimport { legacyRoutesForProduct } from './legacy-routes';\nimport type { CanonicalFormatLegacyRoute } from './legacy-routes';\n\nconst SDK_ID = `@adcp/sdk@${LIBRARY_VERSION}`;\nconst DIRECT_LEGACY_FORMAT_IDENTITY_KEYS = new Set(['agenturl', 'formatid', 'formatids', 'v1formatref']);\n\nfunction canonicalDiagnostic(diagnostic: ProjectionDiagnostic): ProjectionDiagnostic {\n  return {\n    ...diagnostic,\n    // A source `format_ids[i]` index is not an index into the projected\n    // `format_options[]`: earlier source refs may have failed while later refs\n    // projected successfully. Point at the canonical collection instead of\n    // claiming that a successful projected option is the failing value.\n    field: diagnostic.field.replace(/\\.format_ids\\[\\d+\\]/g, '.format_options'),\n  };\n}\n\n/** Protocol Error shape used for portable response-level projection advisories. */\nexport interface CanonicalProjectionError {\n  code: ProjectionDiagnostic['code'];\n  message: string;\n  field: string;\n  recovery: 'correctable';\n  source: 'sdk';\n  sdk_id: string;\n  details: ProjectionDiagnostic['error']['details'];\n}\n\nfunction projectionErrorMessage(code: ProjectionDiagnostic['code']): string {\n  switch (code) {\n    case 'CANONICAL_PRODUCT_FORMATS_UNAVAILABLE':\n      return 'Product has no format declaration representable on the canonical-only surface';\n    case 'FORMAT_PROJECTION_FAILED':\n      return 'Legacy creative format could not be projected to a canonical declaration';\n    case 'FORMAT_DECLARATION_V1_AMBIGUOUS':\n      return 'Canonical creative format has no unambiguous legacy declaration';\n    case 'FORMAT_DECLARATION_V1_NOT_APPLICABLE':\n      return 'Canonical-only creative format cannot be represented on a legacy format path';\n    case 'CANONICAL_NOT_V1_TRANSLATABLE':\n      return 'Canonical creative format has no legacy representation';\n    case 'FORMAT_DECLARATION_V1_LOSSY_MULTI_SIZE':\n      return 'Canonical multi-size format has incomplete legacy coverage';\n    case 'LEGACY_FORMAT_ID_DROPPED_UNMAPPED':\n      return 'Redundant legacy creative identity has no canonical counterpart';\n  }\n}\n\n/** Flatten the projector's internal diagnostic into the protocol `Error` shape. */\nexport function projectionDiagnosticToError(diagnostic: ProjectionDiagnostic): CanonicalProjectionError {\n  return {\n    code: diagnostic.code,\n    message: projectionErrorMessage(diagnostic.code),\n    field: diagnostic.field,\n    recovery: 'correctable',\n    source: diagnostic.source,\n    sdk_id: diagnostic.sdk_id,\n    details: diagnostic.error.details,\n  } as CanonicalProjectionError;\n}\n\nfunction canonicalFormatsUnavailableForProduct(\n  product: V1Product,\n  reason: Extract<ProjectionDiagnostic, { code: 'CANONICAL_PRODUCT_FORMATS_UNAVAILABLE' }>['error']['details']['reason']\n): ProjectionDiagnostic {\n  return {\n    source: 'sdk',\n    sdk_id: SDK_ID,\n    field: `products[${product.product_id}].format_options`,\n    code: 'CANONICAL_PRODUCT_FORMATS_UNAVAILABLE',\n    error: {\n      details: {\n        product_id: product.product_id,\n        reason,\n      },\n    },\n  };\n}\n\nfunction errorIdentity(value: Record<string, unknown>): string | undefined {\n  if (typeof value.code !== 'string' || typeof value.field !== 'string') return undefined;\n  try {\n    return `${value.code}\\u0000${value.field}\\u0000${canonicalizeJson(value.details ?? null)}`;\n  } catch {\n    // Preserve unreadable third-party errors instead of falsely deduplicating.\n    return undefined;\n  }\n}\n\nfunction mergeProjectionErrors(existing: unknown, diagnostics: readonly ProjectionDiagnostic[]): unknown[] {\n  const merged = Array.isArray(existing) ? [...existing] : [];\n  const seen = new Set<string>();\n  for (const value of merged) {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) continue;\n    const record = value as Record<string, unknown>;\n    const key = errorIdentity(record);\n    if (key) seen.add(key);\n  }\n  for (const diagnostic of diagnostics) {\n    const error = projectionDiagnosticToError(diagnostic) as unknown as Record<string, unknown>;\n    const key = errorIdentity(error)!;\n    if (seen.has(key)) continue;\n    seen.add(key);\n    merged.push(error);\n  }\n  return merged;\n}\n\nfunction remapExistingProductErrors(\n  existing: unknown,\n  originalToOutputIndex: ReadonlyMap<number, number | undefined>,\n  products: readonly V1Product[]\n): unknown {\n  if (!Array.isArray(existing)) return existing;\n  return existing.map(value => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) return value;\n    const record = value as Record<string, unknown>;\n    let issuesChanged = false;\n    const issues = Array.isArray(record.issues)\n      ? record.issues.map(issue => {\n          if (!issue || typeof issue !== 'object' || Array.isArray(issue)) return issue;\n          const issueRecord = issue as Record<string, unknown>;\n          if (typeof issueRecord.pointer !== 'string') return issue;\n          const pointerMatch = /^\\/products\\/(\\d+)(\\/.*)?$/.exec(issueRecord.pointer);\n          if (!pointerMatch) return issue;\n          const originalIssueIndex = Number(pointerMatch[1]);\n          if (!originalToOutputIndex.has(originalIssueIndex)) return issue;\n          const outputIssueIndex = originalToOutputIndex.get(originalIssueIndex);\n          issuesChanged = true;\n          return {\n            ...issueRecord,\n            pointer:\n              outputIssueIndex === undefined ? '/products' : `/products/${outputIssueIndex}${pointerMatch[2] ?? ''}`,\n          };\n        })\n      : record.issues;\n    const withIssues = issuesChanged ? { ...record, issues } : record;\n    if (typeof record.field !== 'string') return issuesChanged ? withIssues : value;\n    const match = /^products\\[(\\d+)\\](.*)$/.exec(record.field);\n    if (!match) return issuesChanged ? withIssues : value;\n    const originalIndex = Number(match[1]);\n    if (!originalToOutputIndex.has(originalIndex)) return issuesChanged ? withIssues : value;\n    const outputIndex = originalToOutputIndex.get(originalIndex);\n    if (outputIndex !== undefined) {\n      return { ...withIssues, field: `products[${outputIndex}]${match[2] ?? ''}` };\n    }\n    const productId = products[originalIndex]?.product_id;\n    const details =\n      record.details && typeof record.details === 'object' && !Array.isArray(record.details)\n        ? { ...(record.details as Record<string, unknown>) }\n        : {};\n    if (typeof productId === 'string' && details.product_id === undefined) details.product_id = productId;\n    return { ...withIssues, field: 'products', ...(Object.keys(details).length > 0 ? { details } : {}) };\n  });\n}\n\nfunction hasEmptyPlacementFormatOptions(product: CanonicalOnlyProduct<V1Product>): boolean {\n  const placements = (product as Record<string, unknown>).placements;\n  if (!Array.isArray(placements)) return false;\n  return placements.some(value => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) return false;\n    const options = (value as Record<string, unknown>).format_options;\n    return Array.isArray(options) && options.length === 0;\n  });\n}\n\n/**\n * A Product that has been augmented with `format_options[]` while\n * preserving the original `format_ids[]`. Carries the projection\n * diagnostics that were generated mapping each `format_id` so the\n * buyer can see what (if anything) didn't project cleanly.\n *\n * **Write-side bridge.** After picking a `format_options[i]` entry,\n * use {@link formatIdsFromOptions} (from `@adcp/sdk/v2/projection`)\n * to extract the `format_ids[]` value for a `create_media_buy`\n * package. Inlining `decl.v1_format_ref` works but bypasses the\n * fail-closed semantics (canonical_formats_only / inherently-v2\n * canonical → throw). The spec gap that forces this bridge is tracked\n * at adcontextprotocol/adcp#4842.\n *\n * @see formatIdsFromOptions\n * @see formatIdsForCapability\n */\nexport type V2AugmentedProduct<P> = P & {\n  format_options: V2ProductFormatDeclaration[];\n};\n\n/**\n * Augment a single Product. Idempotent — when `format_options[]` is\n * already present (the seller is v2-native), passes the Product\n * through unchanged. Otherwise projects from `format_ids[]`.\n *\n * Returns `{ product, diagnostics }`. `diagnostics` is empty for a\n * clean projection; populated when individual format_ids don't have\n * a v2 mapping (catalog gap, structural unreachability, etc.).\n *\n * @see toCanonicalOnlyProduct — the canonical-only counterpart that DROPS\n * `format_ids[]` for a fully-migrated consumer.\n */\nexport function augmentProductWithFormatOptions<P extends V1Product>(\n  product: P,\n  options?: V1ToV2ProjectionOptions\n): { product: V2AugmentedProduct<P>; diagnostics: ProjectionDiagnostic[] } {\n  // Already v2-shaped (seller sent format_options directly) — pass through.\n  const existing = (product as unknown as { format_options?: unknown }).format_options;\n  if (Array.isArray(existing)) {\n    return {\n      product: product as V2AugmentedProduct<P>,\n      diagnostics: [],\n    };\n  }\n  // v1 shape — project to add format_options[].\n  if (!Array.isArray(product.format_ids)) {\n    // Neither shape — nothing to project. Return as-is with an empty\n    // format_options so the buyer doesn't have to special-case.\n    return {\n      product: { ...product, format_options: [] },\n      diagnostics: [],\n    };\n  }\n  const { v2, diagnostics } = projectV1ProductToV2(product, options);\n  // Preserve the original product shape (especially format_ids); just\n  // add format_options.\n  return {\n    product: {\n      ...product,\n      format_options: v2.format_options,\n    },\n    diagnostics,\n  };\n}\n\n/**\n * Augment every Product in a `get_products` response with\n * `format_options[]`. Returns `{ response, diagnostics }` so callers\n * can surface projection diagnostics alongside the response's existing\n * `errors[]` array (or filter by `source: 'sdk'` to distinguish SDK\n * diagnostics from seller-emitted errors).\n *\n * Idempotent: if the seller is v2-native and every Product already\n * carries `format_options[]`, returns the response verbatim with no\n * diagnostics.\n *\n * @see toCanonicalOnlyResponse — the canonical-only counterpart that DROPS\n * `format_ids[]` for a fully-migrated consumer.\n */\nexport function withFormatOptions<R extends { products?: V1Product[] }>(\n  response: R,\n  options?: V1ToV2ProjectionOptions\n): { response: R & { products: V2AugmentedProduct<V1Product>[] }; diagnostics: ProjectionDiagnostic[] } {\n  if (!Array.isArray(response?.products)) {\n    return {\n      response: { ...response, products: [] } as R & { products: V2AugmentedProduct<V1Product>[] },\n      diagnostics: [],\n    };\n  }\n  const out: V2AugmentedProduct<V1Product>[] = [];\n  const diagnostics: ProjectionDiagnostic[] = [];\n  for (const p of response.products) {\n    const { product, diagnostics: d } = augmentProductWithFormatOptions(p, options);\n    out.push(product);\n    diagnostics.push(...d);\n  }\n  return {\n    response: { ...response, products: out } as R & { products: V2AugmentedProduct<V1Product>[] },\n    diagnostics,\n  };\n}\n\n/**\n * An additive canonical Product: canonical declarations contain no legacy\n * routing identity, while the Product's top-level `format_ids[]` remains\n * available to compatibility consumers.\n */\nexport type AdditiveCanonicalProduct<P> = Omit<P, 'format_options'> & {\n  format_options: CanonicalFormatDeclaration[];\n};\n\nfunction assertNoDirectLegacyFormatAliases(declarations: readonly V2ProductFormatDeclaration[]): void {\n  for (let index = 0; index < declarations.length; index++) {\n    const declaration = declarations[index] as unknown as Record<string, unknown>;\n    for (const field of Object.keys(declaration)) {\n      if (\n        field !== 'v1_format_ref' &&\n        DIRECT_LEGACY_FORMAT_IDENTITY_KEYS.has(field.replaceAll('_', '').toLowerCase())\n      ) {\n        throw new TypeError(\n          `format_options[${index}] must not use legacy identity field ${field}; use v1_format_ref for migration routing`\n        );\n      }\n    }\n  }\n}\n\n/**\n * Conceal migration-only legacy identities from canonical format declarations\n * while extracting their durable downgrade routes first.\n *\n * This is the declaration-array counterpart to\n * {@link toAdditiveCanonicalProduct}. It is intended for persisted catalogs\n * and other consumers that do not hold a complete Product. The source array\n * and declarations are never mutated.\n *\n * @throws TypeError when a canonical declaration uses a direct legacy identity\n * alias such as `agent_url` or `agentUrl` instead of `v1_format_ref`.\n */\nexport function toCanonicalFormatOptionsWithRoutes(\n  productId: string,\n  formatOptions: readonly V2ProductFormatDeclaration[]\n): {\n  formatOptions: CanonicalFormatDeclaration[];\n  routes: CanonicalFormatLegacyRoute[];\n} {\n  assertNoDirectLegacyFormatAliases(formatOptions);\n  const routes = legacyRoutesForProduct(productId, formatOptions);\n  return {\n    formatOptions: canonicalDeclarations(formatOptions),\n    routes,\n  };\n}\n\n/**\n * Project a Product to an additive, URL-free canonical surface.\n *\n * Unlike {@link augmentProductWithFormatOptions}, this always returns fresh\n * `format_options[]` declarations with `v1_format_ref` concealed. Unlike\n * {@link toCanonicalOnlyProduct}, it preserves the Product's top-level\n * `format_ids[]`. Exact canonical-to-legacy downgrade identity is returned\n * separately as JSON-safe {@link CanonicalFormatLegacyRoute} sidecars.\n *\n * Extract `routes` before any JSON round-trip — WeakMap metadata is gone after\n * deserialization. This helper enforces that ordering internally; persist its\n * returned `routes` whenever a canonical selection may cross a process boundary\n * before being forwarded to a legacy seller. Rebuild the write-side resolver\n * with `canonicalFormatLegacyResolverFromRoutes(restoredRoutes)`.\n *\n * @throws TypeError when a canonical declaration uses a direct legacy identity\n * alias such as `agent_url` or `agentUrl` instead of `v1_format_ref`.\n */\nexport function toAdditiveCanonicalProduct<P extends V1Product>(\n  product: P,\n  options?: V1ToV2ProjectionOptions\n): {\n  product: AdditiveCanonicalProduct<P>;\n  diagnostics: ProjectionDiagnostic[];\n  routes: CanonicalFormatLegacyRoute[];\n} {\n  const { product: augmented, diagnostics } = augmentProductWithFormatOptions(product, options);\n  const projected = toCanonicalFormatOptionsWithRoutes(product.product_id, augmented.format_options);\n  return {\n    product: {\n      ...augmented,\n      format_options: projected.formatOptions,\n    } as AdditiveCanonicalProduct<P>,\n    diagnostics,\n    routes: projected.routes,\n  };\n}\n\n/**\n * Response-level companion to {@link toAdditiveCanonicalProduct}. Projects\n * every Product and accumulates its serializable legacy routes.\n */\nexport function withAdditiveCanonicalFormatOptions<R extends { products?: V1Product[] }>(\n  response: R,\n  options?: V1ToV2ProjectionOptions\n): {\n  response: Omit<R, 'products'> & { products: AdditiveCanonicalProduct<V1Product>[] };\n  diagnostics: ProjectionDiagnostic[];\n  routes: CanonicalFormatLegacyRoute[];\n} {\n  if (!Array.isArray(response?.products)) {\n    return {\n      response: { ...response, products: [] } as Omit<R, 'products'> & {\n        products: AdditiveCanonicalProduct<V1Product>[];\n      },\n      diagnostics: [],\n      routes: [],\n    };\n  }\n  const products: AdditiveCanonicalProduct<V1Product>[] = [];\n  const diagnostics: ProjectionDiagnostic[] = [];\n  const routes: CanonicalFormatLegacyRoute[] = [];\n  for (const sourceProduct of response.products) {\n    const projected = toAdditiveCanonicalProduct(sourceProduct, options);\n    products.push(projected.product);\n    diagnostics.push(...projected.diagnostics);\n    routes.push(...projected.routes);\n  }\n  return {\n    response: { ...response, products } as Omit<R, 'products'> & {\n      products: AdditiveCanonicalProduct<V1Product>[];\n    },\n    diagnostics,\n    routes,\n  };\n}\n\n/**\n * A Product reduced to the canonical creative-format surface:\n * `format_options[]` only, with the legacy `format_ids[]` removed. The\n * read-side counterpart to a fully-migrated consumer — naive downstream\n * code can no longer fall back to the stale `{ agent_url, id }` shape and\n * silently bypass the canonical model.\n */\nexport type CanonicalOnlyProduct<P> = Omit<P, 'format_ids'> & {\n  format_ids?: never;\n  format_options: CanonicalFormatDeclaration[];\n};\n\nfunction canonicalDeclarations(values: readonly V2ProductFormatDeclaration[]): CanonicalFormatDeclaration[] {\n  return values.map(value => concealLegacyFormatRefs(value));\n}\n\nfunction canonicalPlacements(\n  product: Record<string, unknown>,\n  options: V1ToV2ProjectionOptions | undefined,\n  diagnostics: ProjectionDiagnostic[]\n): unknown {\n  if (!Array.isArray(product.placements)) return product.placements;\n  return product.placements.map((value, placementIndex) => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) return value;\n    const placement = value as Record<string, unknown>;\n    const { format_ids: _drop, ...rest } = placement;\n    void _drop;\n    const hasLegacyFormats = Array.isArray(placement.format_ids);\n    const hasCanonicalFormats = Array.isArray(placement.format_options);\n    if (!hasLegacyFormats && !hasCanonicalFormats) return rest;\n\n    const productId = typeof product.product_id === 'string' ? product.product_id : '(unknown)';\n    const placementId = typeof placement.placement_id === 'string' ? placement.placement_id : String(placementIndex);\n    const pseudoProduct = {\n      product_id: `${productId}:placement:${placementId}`,\n      name: typeof placement.name === 'string' ? placement.name : placementId,\n      description: `Nested placement ${placementId}`,\n      ...(hasLegacyFormats ? { format_ids: placement.format_ids } : {}),\n      ...(hasCanonicalFormats ? { format_options: placement.format_options } : {}),\n    } as unknown as V1Product;\n    const projected = toCanonicalOnlyProduct(pseudoProduct, options);\n    for (const diagnostic of projected.diagnostics) {\n      diagnostics.push({\n        ...diagnostic,\n        field: diagnostic.field.replace(/^products\\[[^\\]]+\\]/, `products[${productId}].placements[${placementIndex}]`),\n      });\n    }\n    return {\n      ...rest,\n      format_options: projected.product.format_options,\n    };\n  });\n}\n\n/**\n * Identity key for a `format_id` ref used by the coverage check.\n * Trailing-slash-insensitive on `agent_url` (folds the AAO host's slash /\n * no-slash forms, per `catalog.ts`'s `normalizeAgentUrl`), and includes the\n * dimensional discriminators so multi-size declarations sharing one\n * `{ agent_url, id }` but differing by size/duration are NOT collapsed —\n * the same key shape `write-side.ts` uses for v1 ref de-dup. Without the\n * size half, a `format_ids[]` entry for a size no `v1_format_ref` covers\n * would read as covered and be dropped silently.\n */\nfunction formatRefCoverageKey(ref: V1FormatId): string {\n  const url = ref.agent_url && !ref.agent_url.endsWith('/') ? ref.agent_url + '/' : ref.agent_url;\n  return `${url}::${ref.id}::${ref.width ?? ''}x${ref.height ?? ''}::${ref.duration_ms ?? ''}`;\n}\n\n/**\n * Project a single Product to the canonical-only shape: `format_options[]`\n * present, `format_ids[]` dropped.\n *\n * **Dropping legacy never silently loses a format.** Every input\n * `format_id` is either represented in the returned `format_options[]` or\n * surfaced in `diagnostics` — never discarded without a trace:\n *\n *   - **v1-shaped input** (`format_ids[]`, no `format_options[]`): runs the\n *     v1 → v2 projection. Mapped refs become `format_options[]`; any ref\n *     the projection can't map is surfaced as `FORMAT_PROJECTION_FAILED`.\n *   - **v2-native input** (`format_options[]` already present): keeps the\n *     seller's canonical surface and drops the redundant v1 fallback. If a\n *     legacy routing entry exists that no canonical option covers, it\n *     surfaces a canonical-safe `LEGACY_FORMAT_ID_DROPPED_UNMAPPED`\n *     diagnostic without echoing the routing identifier.\n *   - **neither shape**: returns `format_options: []`; there is nothing to\n *     project and nothing to lose.\n *\n * Pure and subtractive: unlike {@link augmentProductWithFormatOptions}\n * (which preserves `format_ids[]`), this drops it — the opt-in narrowing for\n * a consumer that has fully migrated. Complements the write-side\n * non-invertibility tracked at adcontextprotocol/adcp#4842 — this is the\n * read-side transparency half.\n */\nexport function toCanonicalOnlyProduct<P extends V1Product>(\n  product: P,\n  options?: V1ToV2ProjectionOptions\n): { product: CanonicalOnlyProduct<P>; diagnostics: ProjectionDiagnostic[] } {\n  const existing = (product as unknown as { format_options?: unknown }).format_options;\n\n  // v2-native: the seller already sent format_options[]. Drop the\n  // redundant v1 fallback, but flag any legacy ref no v1_format_ref covers.\n  if (Array.isArray(existing)) {\n    const formatOptions = existing as V2ProductFormatDeclaration[];\n    const diagnostics: ProjectionDiagnostic[] = [];\n    const inputIds = Array.isArray(product.format_ids) ? product.format_ids : [];\n    if (inputIds.length > 0) {\n      const covered = new Set<string>();\n      for (const opt of formatOptions) {\n        const refs = Array.isArray(opt?.v1_format_ref) ? opt.v1_format_ref : [];\n        for (const ref of refs) covered.add(formatRefCoverageKey(ref));\n      }\n      for (let k = 0; k < inputIds.length; k++) {\n        const fid = inputIds[k]!;\n        if (!covered.has(formatRefCoverageKey(fid))) {\n          diagnostics.push({\n            source: 'sdk',\n            sdk_id: SDK_ID,\n            field: `products[${product.product_id}].format_options`,\n            code: 'LEGACY_FORMAT_ID_DROPPED_UNMAPPED',\n            error: {\n              details: {\n                product_id: product.product_id,\n                resolution_failure: 'unmapped_legacy_format',\n              },\n            },\n          });\n        }\n      }\n    }\n    const { format_ids: _dropV2, ...rest } = product as P & { format_ids?: unknown };\n    void _dropV2;\n    return {\n      product: {\n        ...rest,\n        format_options: canonicalDeclarations(formatOptions),\n        ...(Array.isArray((product as Record<string, unknown>).placements)\n          ? { placements: canonicalPlacements(product as Record<string, unknown>, options, diagnostics) }\n          : {}),\n      } as CanonicalOnlyProduct<P>,\n      diagnostics: diagnostics.map(canonicalDiagnostic),\n    };\n  }\n\n  // v1 shape: project. projectV1ProductToV2 already omits format_ids and\n  // emits a diagnostic for every ref it couldn't map.\n  if (Array.isArray(product.format_ids)) {\n    const { v2, diagnostics } = projectV1ProductToV2(product, options);\n    const { format_ids: _dropV1, ...rest } = product as P & { format_ids?: unknown };\n    void _dropV1;\n    return {\n      product: {\n        ...(rest as Omit<P, 'format_ids'>),\n        format_options: canonicalDeclarations(v2.format_options),\n        ...(Array.isArray((product as Record<string, unknown>).placements)\n          ? { placements: canonicalPlacements(product as Record<string, unknown>, options, diagnostics) }\n          : {}),\n      } as CanonicalOnlyProduct<P>,\n      diagnostics: diagnostics.map(canonicalDiagnostic),\n    };\n  }\n\n  // Neither shape — nothing to project, nothing to lose.\n  const { format_ids: _dropNone, ...rest } = product as P & { format_ids?: unknown };\n  void _dropNone;\n  const diagnostics: ProjectionDiagnostic[] = [];\n  return {\n    product: {\n      ...(rest as Omit<P, 'format_ids'>),\n      format_options: [],\n      ...(Array.isArray((product as Record<string, unknown>).placements)\n        ? { placements: canonicalPlacements(product as Record<string, unknown>, options, diagnostics) }\n        : {}),\n    } as CanonicalOnlyProduct<P>,\n    diagnostics: diagnostics.map(canonicalDiagnostic),\n  };\n}\n\n/**\n * Reduce every Product in a `get_products` response to the canonical-only\n * shape — `format_options[]` present, `format_ids[]` dropped. Returns\n * `{ response, diagnostics }` so callers surface projection diagnostics\n * alongside the response's existing `errors[]`.\n *\n * Response-level counterpart to {@link toCanonicalOnlyProduct}; same\n * fail-closed guarantee, aggregated across products. A wholly unmappable\n * legacy product cannot be represented as a canonical Product because the\n * protocol requires `format_options` to contain at least one declaration. It\n * is therefore omitted from the canonical list and surfaced through the\n * response's portable `errors[]` plus the SDK convenience diagnostics. A\n * partially mappable product remains with its mapped options and advisories\n * for the refs that could not be projected.\n */\nexport function toCanonicalOnlyResponse<R extends { products?: V1Product[] }>(\n  response: R,\n  options?: V1ToV2ProjectionOptions\n): {\n  response: Omit<R, 'products'> & { products: CanonicalOnlyProduct<V1Product>[]; errors?: unknown[] };\n  diagnostics: ProjectionDiagnostic[];\n} {\n  if (!Array.isArray(response?.products)) {\n    return {\n      response: { ...response, products: [] } as Omit<R, 'products'> & {\n        products: CanonicalOnlyProduct<V1Product>[];\n        errors?: unknown[];\n      },\n      diagnostics: [],\n    };\n  }\n  const out: CanonicalOnlyProduct<V1Product>[] = [];\n  const diagnostics: ProjectionDiagnostic[] = [];\n  const originalToOutputIndex = new Map<number, number | undefined>();\n  for (let productIndex = 0; productIndex < response.products.length; productIndex++) {\n    const p = response.products[productIndex]!;\n    const { product, diagnostics: rawDiagnostics } = toCanonicalOnlyProduct(p, options);\n    const hasEmptyPlacement = hasEmptyPlacementFormatOptions(product);\n    const keep = product.format_options.length > 0 && !hasEmptyPlacement;\n    const outputIndex = keep ? out.length : undefined;\n    originalToOutputIndex.set(productIndex, outputIndex);\n    const d = rawDiagnostics.map(diagnostic => ({\n      ...diagnostic,\n      field: keep ? diagnostic.field.replace(/^products\\[[^\\]]+\\]/, `products[${outputIndex}]`) : 'products',\n      error: keep\n        ? diagnostic.error\n        : {\n            details: {\n              ...diagnostic.error.details,\n              product_id: p.product_id,\n            },\n          },\n    })) as ProjectionDiagnostic[];\n    if (!keep && d.length === 0) {\n      const reason = hasEmptyPlacement\n        ? 'nested_placement_format_list_empty'\n        : Array.isArray((p as Record<string, unknown>).format_options)\n          ? 'canonical_format_list_empty'\n          : Array.isArray(p.format_ids)\n            ? 'legacy_format_list_empty'\n            : 'missing_format_declaration';\n      d.push({\n        ...canonicalFormatsUnavailableForProduct(p, reason),\n        field: 'products',\n      });\n    }\n    diagnostics.push(...d);\n    if (keep) out.push(product);\n  }\n  const remappedExistingErrors = remapExistingProductErrors(\n    (response as { errors?: unknown }).errors,\n    originalToOutputIndex,\n    response.products\n  );\n  const errors = mergeProjectionErrors(remappedExistingErrors, diagnostics);\n  return {\n    response: {\n      ...response,\n      products: out,\n      ...(errors.length > 0 ? { errors } : {}),\n    } as Omit<R, 'products'> & { products: CanonicalOnlyProduct<V1Product>[]; errors?: unknown[] },\n    diagnostics,\n  };\n}\n"],"mappings":"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","names":["diagnostics","rest"]}

package/dist/lib/v2/projection/index.d.mts

@@ -23,6 +23,8 @@
  *     `format_options[]`, preserved top-level `format_ids[]`, and explicit
  *     serializable legacy-route sidecars for later forwarding.
  *     `withAdditiveCanonicalFormatOptions` is the response-level companion.
+ *     `toCanonicalFormatOptionsWithRoutes` provides the same safe route-first
+ *     concealment for callers that hold only a declaration array.
  *
  *   - `toCanonicalOnlyProduct` / `toCanonicalOnlyResponse` — the
  *     read-side narrowing for a fully-migrated consumer. Returns
@@ -42,7 +44,7 @@ export type { V1ToV2Result, V1ToV2ProjectionOptions, BareFormatIdResolveOptions,
 export { projectV2ProductToV1 } from './v2-to-v1.mjs';
 export type { V2ToV1Result, V2ToV1ProjectionOptions, CanonicalFormatLegacyResolver, CanonicalFormatLegacyResolutionContext, CanonicalProductFormatLegacyResolutionContext, CanonicalCreativeFormatLegacyResolutionContext, CanonicalSelectorFormatLegacyResolutionContext, } from './v2-to-v1.mjs';
 export { canonicalFormatLegacyResolverFromRoutes, legacyRoutesForProduct, type CanonicalFormatLegacyRoute, } from './legacy-routes.mjs';
-export { augmentProductWithFormatOptions, withFormatOptions, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, type V2AugmentedProduct, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, } from './augment-response.mjs';
+export { augmentProductWithFormatOptions, withFormatOptions, toCanonicalFormatOptionsWithRoutes, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, type V2AugmentedProduct, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, } from './augment-response.mjs';
 export { CanonicalFormat, audioDaastFormatDeclaration, audioHostedFormatDeclaration, agentPlacementFormatDeclaration, canonicalFormatDeclaration, customFormatDeclaration, displayTagFormatDeclaration, legacyFormatRef, legacyFormatRefs, html5FormatDeclaration, imageCarouselFormatDeclaration, imageFormatDeclaration, nativeInFeedFormatDeclaration, productCard, productCardDetailed, responsiveCreativeFormatDeclaration, sponsoredPlacementFormatDeclaration, videoHostedFormatDeclaration, videoVastFormatDeclaration, type CanonicalFormatDeclaration, type CanonicalFormatDeclarationFields, type CanonicalFormatKind, type CanonicalFormatParams, type FormatReferenceInput, type ProductCardDetailedFields, type ProductCardFields, } from './builders.mjs';
 export { packageRefsForFormatOptions, packageRefsForCapabilities, legacyFormatIdsFromOptions, tryLegacyFormatIdsFromOptions, legacyFormatIdsForFormatOption, legacyFormatIdsForCapability, FormatOptionRefsLookupError, CapabilityIdsLookupError, type PackageFormatRefs, type PackageCapabilityRefs, type FormatOptionRef, type FormatOptionSelector, type FormatOptionRefsLookupErrorCode, type CapabilityIdsLookupErrorCode, } from './write-side.mjs';
 export type { V1FormatId, V2ProductFormatDeclaration, V2Product, V1Product, ProjectionDiagnostic } from './types.mjs';

package/dist/lib/v2/projection/index.d.ts

@@ -23,6 +23,8 @@
  *     `format_options[]`, preserved top-level `format_ids[]`, and explicit
  *     serializable legacy-route sidecars for later forwarding.
  *     `withAdditiveCanonicalFormatOptions` is the response-level companion.
+ *     `toCanonicalFormatOptionsWithRoutes` provides the same safe route-first
+ *     concealment for callers that hold only a declaration array.
  *
  *   - `toCanonicalOnlyProduct` / `toCanonicalOnlyResponse` — the
  *     read-side narrowing for a fully-migrated consumer. Returns
@@ -42,7 +44,7 @@ export type { V1ToV2Result, V1ToV2ProjectionOptions, BareFormatIdResolveOptions,
 export { projectV2ProductToV1 } from './v2-to-v1';
 export type { V2ToV1Result, V2ToV1ProjectionOptions, CanonicalFormatLegacyResolver, CanonicalFormatLegacyResolutionContext, CanonicalProductFormatLegacyResolutionContext, CanonicalCreativeFormatLegacyResolutionContext, CanonicalSelectorFormatLegacyResolutionContext, } from './v2-to-v1';
 export { canonicalFormatLegacyResolverFromRoutes, legacyRoutesForProduct, type CanonicalFormatLegacyRoute, } from './legacy-routes';
-export { augmentProductWithFormatOptions, withFormatOptions, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, type V2AugmentedProduct, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, } from './augment-response';
+export { augmentProductWithFormatOptions, withFormatOptions, toCanonicalFormatOptionsWithRoutes, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, type V2AugmentedProduct, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, } from './augment-response';
 export { CanonicalFormat, audioDaastFormatDeclaration, audioHostedFormatDeclaration, agentPlacementFormatDeclaration, canonicalFormatDeclaration, customFormatDeclaration, displayTagFormatDeclaration, legacyFormatRef, legacyFormatRefs, html5FormatDeclaration, imageCarouselFormatDeclaration, imageFormatDeclaration, nativeInFeedFormatDeclaration, productCard, productCardDetailed, responsiveCreativeFormatDeclaration, sponsoredPlacementFormatDeclaration, videoHostedFormatDeclaration, videoVastFormatDeclaration, type CanonicalFormatDeclaration, type CanonicalFormatDeclarationFields, type CanonicalFormatKind, type CanonicalFormatParams, type FormatReferenceInput, type ProductCardDetailedFields, type ProductCardFields, } from './builders';
 export { packageRefsForFormatOptions, packageRefsForCapabilities, legacyFormatIdsFromOptions, tryLegacyFormatIdsFromOptions, legacyFormatIdsForFormatOption, legacyFormatIdsForCapability, FormatOptionRefsLookupError, CapabilityIdsLookupError, type PackageFormatRefs, type PackageCapabilityRefs, type FormatOptionRef, type FormatOptionSelector, type FormatOptionRefsLookupErrorCode, type CapabilityIdsLookupErrorCode, } from './write-side';
 export type { V1FormatId, V2ProductFormatDeclaration, V2Product, V1Product, ProjectionDiagnostic } from './types';

package/dist/lib/v2/projection/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/index.ts"],"names":[],"mappings":"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"}