@adcp/sdk 12.1.0 → 13.0.0-rc.0

package/dist/lib/v2/projection/catalog.mjs

@@ -5,16 +5,25 @@ const __dirname = __adcpDirname(__adcpFileURLToPath(import.meta.url));
 const require2 = __adcpCreateRequire(import.meta.url);
 import { readFileSync, existsSync } from "fs";
 import path from "path";
-let cached = null;
+import { AAO_CANONICAL_AGENT_URL } from "./constants.mjs";
+import { canonicalizeAgentUrl } from "../../discovery/resolve-agent-properties.mjs";
+const cachedByPath = /* @__PURE__ */ new Map();
+const AAO_LEGACY_AGENT_URL_ALIASES = /* @__PURE__ */ new Set([
+  // Early AAO reference implementations, including Optimera's deployed
+  // catalog, used the protocol root before creative.adcontextprotocol.org
+  // became the canonical format-agent host.
+  "https://adcontextprotocol.org/"
+]);
 function normalizeAgentUrl(u) {
-  if (!u) return u;
-  return u.endsWith("/") ? u : u + "/";
+  const canonical = canonicalizeAgentUrl(u);
+  if (canonical === null) return void 0;
+  return AAO_LEGACY_AGENT_URL_ALIASES.has(canonical) ? AAO_CANONICAL_AGENT_URL : canonical;
 }
 function indexKey(agentUrl, id) {
-  return `${normalizeAgentUrl(agentUrl)}::${id}`;
+  const normalized = normalizeAgentUrl(agentUrl);
+  return normalized === void 0 ? void 0 : `${normalized}::${id}`;
 }
 function loadCatalog(explicitPath) {
-  if (cached) return cached;
   const candidates = explicitPath ? [explicitPath] : [
     path.join(__dirname, "aao-reference-formats.json"),
     path.join(
@@ -31,15 +40,22 @@ function loadCatalog(explicitPath) {
   ];
   for (const file of candidates) {
     if (existsSync(file)) {
+      const cached = cachedByPath.get(file);
+      if (cached) return cached;
       const raw = JSON.parse(readFileSync(file, "utf-8"));
       const byKey = /* @__PURE__ */ new Map();
+      const byUniqueId = /* @__PURE__ */ new Map();
       for (const entry of raw) {
         if (entry?.format_id?.agent_url && entry?.format_id?.id) {
-          byKey.set(indexKey(entry.format_id.agent_url, entry.format_id.id), entry);
+          const key = indexKey(entry.format_id.agent_url, entry.format_id.id);
+          if (key !== void 0) byKey.set(key, entry);
+          if (byUniqueId.has(entry.format_id.id)) byUniqueId.set(entry.format_id.id, null);
+          else byUniqueId.set(entry.format_id.id, entry);
         }
       }
-      cached = { byKey, entries: raw };
-      return cached;
+      const compiled = { byKey, byUniqueId, entries: raw };
+      cachedByPath.set(file, compiled);
+      return compiled;
     }
   }
   throw new Error(
@@ -48,10 +64,15 @@ function loadCatalog(explicitPath) {
 }
 function lookupV1Format(formatId, explicitPath) {
   const catalog = loadCatalog(explicitPath);
-  return catalog.byKey.get(indexKey(formatId.agent_url, formatId.id));
+  const key = indexKey(formatId.agent_url, formatId.id);
+  return key === void 0 ? void 0 : catalog.byKey.get(key);
+}
+function lookupUniqueV1FormatById(id, explicitPath) {
+  const match = loadCatalog(explicitPath).byUniqueId.get(id);
+  return match ?? void 0;
 }
 function _resetCatalogCache() {
-  cached = null;
+  cachedByPath.clear();
 }
 const SIZED_ID_RE = /^([a-z]+)_(\d+)x(\d+)_([a-z]+)$/;
 function parseSizedIdTemplate(id) {
@@ -62,6 +83,7 @@ function parseSizedIdTemplate(id) {
 function findCatalogEntryByCanonicalAndSize(canonical, width, height, agentUrl, options) {
   const catalog = loadCatalog(options?.explicitPath);
   const normalizedAgentUrl = normalizeAgentUrl(agentUrl);
+  if (normalizedAgentUrl === void 0) return void 0;
   for (const entry of catalog.entries) {
     if (entry.canonical?.kind !== canonical) continue;
     if (!entry.format_id?.id || !entry.format_id?.agent_url) continue;
@@ -81,6 +103,7 @@ export {
   _resetCatalogCache,
   findCatalogEntryByCanonicalAndSize,
   loadCatalog,
+  lookupUniqueV1FormatById,
   lookupV1Format,
   parseSizedIdTemplate
 };

package/dist/lib/v2/projection/catalog.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/v2/projection/catalog.ts"],"sourcesContent":["import { fileURLToPath as __adcpFileURLToPath } from 'node:url';\nimport { dirname as __adcpDirname } from 'node:path';\nimport { createRequire as __adcpCreateRequire } from 'node:module';\nconst __dirname = __adcpDirname(__adcpFileURLToPath(import.meta.url));\nconst require = __adcpCreateRequire(import.meta.url);\n/**\n * Loader for the AAO canonical-formats catalog (`reference-formats.json`).\n * Source of truth: `server/src/creative-agent/reference-formats.json` in\n * the adcontextprotocol/adcp repo — published by the AAO with the\n * `canonical` annotation on entries that have a v2 canonical-format\n * equivalent.\n *\n * The catalog is the v1→v2 direction's primary lookup table: each entry\n * is a v1 format definition, and 32 of the 57 entries in 3.1-beta carry\n * a `canonical: <kind>` annotation that names the v2 canonical the v1\n * format projects to. This is the spec's resolution-order step 2 —\n * \"seller-asserted on the v1 file\" — applied to AAO-published v1 formats.\n *\n * Loader is keyed by `agent_url` (with trailing-slash normalization) +\n * `format_id.id`. Same scope as the v2→v1 registry: AAO catalog only.\n * Seller-specific catalogs (from a publisher's\n * `list_creative_formats`) are out of scope for the prototype — the\n * full 8.0 enablement would fetch them via an `AgentClient` injected\n * by the auto-negotiation surface.\n */\n\nimport { readFileSync, existsSync } from 'fs';\nimport path from 'path';\nimport type { CanonicalFormatKind, V1FormatId } from './types';\n\n/**\n * Canonical projection reference (`canonical-projection-ref.json` in the\n * 3.1 spec). Always object-shaped: required `kind` + optional\n * `asset_source` + optional `slots_override`. Carries the v2 canonical-\n * format projection for a v1 catalog entry. Generative-AI v1 entries\n * use the rich form (`asset_source: 'agent_synthesized'` +\n * slots_override) so the v2 declaration produced from them carries the\n * generative contract; standard entries use the minimal form\n * (`{ kind }`) and inherit the canonical's default slots.\n */\nexport interface CanonicalProjectionRef {\n  kind: CanonicalFormatKind;\n  /** Narrows how the asset is produced (e.g., agent_synthesized for AI generation, buyer_uploaded for native). */\n  asset_source?: 'agent_synthesized' | 'buyer_uploaded' | string;\n  /** When set, replaces the canonical's default slots with these specifics. */\n  slots_override?: Array<{\n    asset_group_id: string;\n    asset_type?: string;\n    required?: boolean;\n    [k: string]: unknown;\n  }>;\n}\n\n/**\n * v1 format definition shape from `reference-formats.json`. Only carries\n * the fields the projection algorithm reads — name/description and the\n * full asset/macro/requirement bodies are passed through opaquely when\n * the caller wants them.\n */\nexport interface V1FormatDefinition {\n  format_id: V1FormatId;\n  name?: string;\n  description?: string;\n  type?: string;\n  accepts_parameters?: string[];\n  assets?: Array<{\n    item_type?: string;\n    asset_id?: string;\n    required?: boolean;\n    asset_type?: string;\n    requirements?: Record<string, unknown>;\n  }>;\n  /**\n   * v2 canonical projection. Always object-shaped per\n   * `canonical-projection-ref.json`. Absent on entries that have no\n   * v2 mapping yet (none at 3.1.0-beta.1 GA — the AAO catalog is\n   * 100% annotated; absence is reserved for future un-blessed entries).\n   */\n  canonical?: CanonicalProjectionRef;\n  // Pass-through for caller code that wants the rest.\n  [k: string]: unknown;\n}\n\ninterface CatalogIndex {\n  /** Keyed by `<normalized-agent-url>::<id>` for O(1) lookup. */\n  byKey: Map<string, V1FormatDefinition>;\n  entries: V1FormatDefinition[];\n}\n\nlet cached: CatalogIndex | null = null;\n\n/**\n * Normalize agent_url for indexing. Adds trailing slash when missing.\n * The AAO publishes the canonical form as `https://creative.adcontextprotocol.org/`\n * (with slash); some v2 fixtures use the no-slash form. Both refer to\n * the same agent; this lookup folds them.\n */\nfunction normalizeAgentUrl(u: string): string {\n  if (!u) return u;\n  return u.endsWith('/') ? u : u + '/';\n}\n\nfunction indexKey(agentUrl: string, id: string): string {\n  return `${normalizeAgentUrl(agentUrl)}::${id}`;\n}\n\n/**\n * Load the catalog from a known path. Resolution order:\n *\n *   1. Caller-supplied `explicitPath` (test hook).\n *   2. Adjacent to the compiled loader — `dist/lib/v2/projection/\n *      aao-reference-formats.json`. This is the path that ships in the\n *      published npm tarball; `scripts/copy-v2-projection-catalog.ts`\n *      vendors the file here during `build:lib`.\n *   3. Source-tree test fixture at\n *      `test/lib/v2-projection-fixtures/aao-reference-formats.json`,\n *      relative to the loader's source location. Used when running from\n *      a source checkout (e.g., `tsx` / vitest) before `build:lib`.\n *\n * Memoized — catalog is small and immutable per spec version.\n *\n * @param explicitPath caller-supplied path; takes precedence over\n *                     fallback resolution.\n */\nexport function loadCatalog(explicitPath?: string): CatalogIndex {\n  if (cached) return cached;\n\n  const candidates = explicitPath\n    ? [explicitPath]\n    : [\n        path.join(__dirname, 'aao-reference-formats.json'),\n        path.join(\n          __dirname,\n          '..',\n          '..',\n          '..',\n          '..',\n          'test',\n          'lib',\n          'v2-projection-fixtures',\n          'aao-reference-formats.json'\n        ),\n      ];\n\n  for (const file of candidates) {\n    if (existsSync(file)) {\n      const raw = JSON.parse(readFileSync(file, 'utf-8')) as V1FormatDefinition[];\n      const byKey = new Map<string, V1FormatDefinition>();\n      for (const entry of raw) {\n        if (entry?.format_id?.agent_url && entry?.format_id?.id) {\n          byKey.set(indexKey(entry.format_id.agent_url, entry.format_id.id), entry);\n        }\n      }\n      cached = { byKey, entries: raw };\n      return cached;\n    }\n  }\n\n  throw new Error(\n    `AAO catalog (aao-reference-formats.json) not found. Looked in: ${candidates.join(', ')}. ` +\n      `This indicates a corrupted @adcp/sdk install or an SDK packaging regression — ` +\n      `please file an issue at https://github.com/adcontextprotocol/adcp-client/issues with ` +\n      `your install method (npm/yarn/pnpm) and Node version. ` +\n      `If you're working from a source checkout, run \\`npm run build:lib\\` first.`\n  );\n}\n\n/**\n * Look up a v1 format definition by its format_id. Returns undefined\n * when not in the catalog — caller falls through to registry / structural\n * match per the resolution order.\n */\nexport function lookupV1Format(formatId: V1FormatId, explicitPath?: string): V1FormatDefinition | undefined {\n  const catalog = loadCatalog(explicitPath);\n  return catalog.byKey.get(indexKey(formatId.agent_url, formatId.id));\n}\n\n/** Test hook: reset the memoized catalog. */\nexport function _resetCatalogCache(): void {\n  cached = null;\n}\n\n/**\n * Find a catalog entry matching `(canonical, width, height)` at the same\n * publisher domain as `agentUrl`. Used by the v2 → v1 multi-size fan-out:\n * when a v2 declaration says `sizes: [W1×H1, W2×H2, ...]` and the\n * seller-asserted `v1_format_ref` points at the catalog entry for one of\n * those sizes, the SDK can look up the entries for the OTHER sizes and\n * emit additional v1 format_ids — giving v1 buyers full size coverage\n * instead of just the rep.\n *\n * The catalog uses a stable id-pattern convention\n * (`<prefix>_<W>x<H>_<suffix>`) for per-size entries — image, html5, and\n * generative all follow it. This function parses ids matching that\n * pattern and matches on extracted dimensions, so the lookup is\n * dimensionally honest without requiring the spec to add explicit\n * width/height fields to catalog entries.\n *\n * Returns undefined when no matching entry exists at this publisher.\n * Caller falls back to the seller-asserted rep + lossy advisory.\n */\nconst SIZED_ID_RE = /^([a-z]+)_(\\d+)x(\\d+)_([a-z]+)$/;\n\n/**\n * Extract the `<prefix>_<W>x<H>_<suffix>` template from a sized catalog\n * id. Used by `findCatalogEntryByCanonicalAndSize` to filter fan-out\n * candidates to siblings of the seller-asserted ref. Multiple catalog\n * entries can share the same `canonical:` annotation but represent\n * different families (e.g., `image` is both `display_*_image` and\n * `display_*_generative`); without a suffix filter, fan-out would\n * collide families.\n */\nexport function parseSizedIdTemplate(id: string): { prefix: string; suffix: string } | undefined {\n  const m = id.match(SIZED_ID_RE);\n  if (!m) return undefined;\n  return { prefix: m[1]!, suffix: m[4]! };\n}\n\nexport function findCatalogEntryByCanonicalAndSize(\n  canonical: CanonicalFormatKind,\n  width: number,\n  height: number,\n  agentUrl: string,\n  options?: { prefix?: string; suffix?: string; explicitPath?: string }\n): V1FormatDefinition | undefined {\n  const catalog = loadCatalog(options?.explicitPath);\n  const normalizedAgentUrl = normalizeAgentUrl(agentUrl);\n  for (const entry of catalog.entries) {\n    if (entry.canonical?.kind !== canonical) continue;\n    if (!entry.format_id?.id || !entry.format_id?.agent_url) continue;\n    if (normalizeAgentUrl(entry.format_id.agent_url) !== normalizedAgentUrl) continue;\n    const m = entry.format_id.id.match(SIZED_ID_RE);\n    if (!m) continue;\n    const [, prefix, wStr, hStr, suffix] = m;\n    if (options?.prefix && prefix !== options.prefix) continue;\n    if (options?.suffix && suffix !== options.suffix) continue;\n    if (parseInt(wStr!, 10) === width && parseInt(hStr!, 10) === height) {\n      return entry;\n    }\n  }\n  return undefined;\n}\n"],"mappings":"AAAA,SAAS,iBAAiB,2BAA2B;AACrD,SAAS,WAAW,qBAAqB;AACzC,SAAS,iBAAiB,2BAA2B;AACrD,MAAM,YAAY,cAAc,oBAAoB,YAAY,GAAG,CAAC;AACpE,MAAMA,WAAU,oBAAoB,YAAY,GAAG;AAsBnD,SAAS,cAAc,kBAAkB;AACzC,OAAO,UAAU;AA8DjB,IAAI,SAA8B;AAQlC,SAAS,kBAAkB,GAAmB;AAC5C,MAAI,CAAC,EAAG,QAAO;AACf,SAAO,EAAE,SAAS,GAAG,IAAI,IAAI,IAAI;AACnC;AAEA,SAAS,SAAS,UAAkB,IAAoB;AACtD,SAAO,GAAG,kBAAkB,QAAQ,CAAC,KAAK,EAAE;AAC9C;AAoBO,SAAS,YAAY,cAAqC;AAC/D,MAAI,OAAQ,QAAO;AAEnB,QAAM,aAAa,eACf,CAAC,YAAY,IACb;AAAA,IACE,KAAK,KAAK,WAAW,4BAA4B;AAAA,IACjD,KAAK;AAAA,MACH;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEJ,aAAW,QAAQ,YAAY;AAC7B,QAAI,WAAW,IAAI,GAAG;AACpB,YAAM,MAAM,KAAK,MAAM,aAAa,MAAM,OAAO,CAAC;AAClD,YAAM,QAAQ,oBAAI,IAAgC;AAClD,iBAAW,SAAS,KAAK;AACvB,YAAI,OAAO,WAAW,aAAa,OAAO,WAAW,IAAI;AACvD,gBAAM,IAAI,SAAS,MAAM,UAAU,WAAW,MAAM,UAAU,EAAE,GAAG,KAAK;AAAA,QAC1E;AAAA,MACF;AACA,eAAS,EAAE,OAAO,SAAS,IAAI;AAC/B,aAAO;AAAA,IACT;AAAA,EACF;AAEA,QAAM,IAAI;AAAA,IACR,kEAAkE,WAAW,KAAK,IAAI,CAAC;AAAA,EAKzF;AACF;AAOO,SAAS,eAAe,UAAsB,cAAuD;AAC1G,QAAM,UAAU,YAAY,YAAY;AACxC,SAAO,QAAQ,MAAM,IAAI,SAAS,SAAS,WAAW,SAAS,EAAE,CAAC;AACpE;AAGO,SAAS,qBAA2B;AACzC,WAAS;AACX;AAqBA,MAAM,cAAc;AAWb,SAAS,qBAAqB,IAA4D;AAC/F,QAAM,IAAI,GAAG,MAAM,WAAW;AAC9B,MAAI,CAAC,EAAG,QAAO;AACf,SAAO,EAAE,QAAQ,EAAE,CAAC,GAAI,QAAQ,EAAE,CAAC,EAAG;AACxC;AAEO,SAAS,mCACd,WACA,OACA,QACA,UACA,SACgC;AAChC,QAAM,UAAU,YAAY,SAAS,YAAY;AACjD,QAAM,qBAAqB,kBAAkB,QAAQ;AACrD,aAAW,SAAS,QAAQ,SAAS;AACnC,QAAI,MAAM,WAAW,SAAS,UAAW;AACzC,QAAI,CAAC,MAAM,WAAW,MAAM,CAAC,MAAM,WAAW,UAAW;AACzD,QAAI,kBAAkB,MAAM,UAAU,SAAS,MAAM,mBAAoB;AACzE,UAAM,IAAI,MAAM,UAAU,GAAG,MAAM,WAAW;AAC9C,QAAI,CAAC,EAAG;AACR,UAAM,CAAC,EAAE,QAAQ,MAAM,MAAM,MAAM,IAAI;AACvC,QAAI,SAAS,UAAU,WAAW,QAAQ,OAAQ;AAClD,QAAI,SAAS,UAAU,WAAW,QAAQ,OAAQ;AAClD,QAAI,SAAS,MAAO,EAAE,MAAM,SAAS,SAAS,MAAO,EAAE,MAAM,QAAQ;AACnE,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;","names":["require"]}
+{"version":3,"sources":["../../../../src/lib/v2/projection/catalog.ts"],"sourcesContent":["import { fileURLToPath as __adcpFileURLToPath } from 'node:url';\nimport { dirname as __adcpDirname } from 'node:path';\nimport { createRequire as __adcpCreateRequire } from 'node:module';\nconst __dirname = __adcpDirname(__adcpFileURLToPath(import.meta.url));\nconst require = __adcpCreateRequire(import.meta.url);\n/**\n * Loader for the AAO canonical-formats catalog (`reference-formats.json`).\n * Source of truth: `server/src/creative-agent/reference-formats.json` in\n * the adcontextprotocol/adcp repo — published by the AAO with the\n * `canonical` annotation on entries that have a v2 canonical-format\n * equivalent.\n *\n * The catalog is the v1→v2 direction's primary lookup table: each entry\n * is a v1 format definition, and 32 of the 57 entries in 3.1-beta carry\n * a `canonical: <kind>` annotation that names the v2 canonical the v1\n * format projects to. This is the spec's resolution-order step 2 —\n * \"seller-asserted on the v1 file\" — applied to AAO-published v1 formats.\n *\n * Primary lookup is keyed by `agent_url` (with trailing-slash normalization) +\n * `format_id.id`. The inbound migration path may also use an exact bare ID\n * when it has one unique meaning in the AAO catalog; the source owner is\n * preserved for reverse delivery. Same scope as the v2→v1 registry: AAO catalog only.\n * Seller-specific catalogs (from a publisher's\n * `list_creative_formats`) are out of scope for the prototype — the\n * full 8.0 enablement would fetch them via an `AgentClient` injected\n * by the auto-negotiation surface.\n */\n\nimport { readFileSync, existsSync } from 'fs';\nimport path from 'path';\nimport type { CanonicalFormatKind, V1FormatId } from './types';\nimport { AAO_CANONICAL_AGENT_URL } from './constants';\nimport { canonicalizeAgentUrl } from '../../discovery/resolve-agent-properties';\n\n/**\n * Canonical projection reference (`canonical-projection-ref.json` in the\n * 3.1 spec). Always object-shaped: required `kind` + optional\n * `asset_source` + optional `slots_override`. Carries the v2 canonical-\n * format projection for a v1 catalog entry. Generative-AI v1 entries\n * use the rich form (`asset_source: 'agent_synthesized'` +\n * slots_override) so the v2 declaration produced from them carries the\n * generative contract; standard entries use the minimal form\n * (`{ kind }`) and inherit the canonical's default slots.\n */\nexport interface CanonicalProjectionRef {\n  kind: CanonicalFormatKind;\n  /** Narrows how the asset is produced (e.g., agent_synthesized for AI generation, buyer_uploaded for native). */\n  asset_source?: 'agent_synthesized' | 'buyer_uploaded' | string;\n  /** When set, replaces the canonical's default slots with these specifics. */\n  slots_override?: Array<{\n    asset_group_id: string;\n    asset_type?: string;\n    required?: boolean;\n    [k: string]: unknown;\n  }>;\n}\n\n/**\n * v1 format definition shape from `reference-formats.json`. Only carries\n * the fields the projection algorithm reads — name/description and the\n * full asset/macro/requirement bodies are passed through opaquely when\n * the caller wants them.\n */\nexport interface V1FormatDefinition {\n  format_id: V1FormatId;\n  name?: string;\n  description?: string;\n  type?: string;\n  accepts_parameters?: string[];\n  renders?: Array<{\n    role?: string;\n    dimensions?: {\n      width?: number;\n      height?: number;\n      [k: string]: unknown;\n    };\n    [k: string]: unknown;\n  }>;\n  assets?: Array<{\n    item_type?: string;\n    asset_id?: string;\n    required?: boolean;\n    asset_type?: string;\n    requirements?: Record<string, unknown>;\n  }>;\n  /**\n   * v2 canonical projection. Always object-shaped per\n   * `canonical-projection-ref.json`. Absent on entries that have no\n   * v2 mapping yet (none at 3.1.0-beta.1 GA — the AAO catalog is\n   * 100% annotated; absence is reserved for future un-blessed entries).\n   */\n  canonical?: CanonicalProjectionRef;\n  // Pass-through for caller code that wants the rest.\n  [k: string]: unknown;\n}\n\ninterface CatalogIndex {\n  /** Keyed by `<normalized-agent-url>::<id>` for O(1) lookup. */\n  byKey: Map<string, V1FormatDefinition>;\n  /** Exact bare IDs with one AAO-published meaning; `null` marks a collision. */\n  byUniqueId: Map<string, V1FormatDefinition | null>;\n  entries: V1FormatDefinition[];\n}\n\nconst cachedByPath = new Map<string, CatalogIndex>();\n\n/**\n * Normalize agent_url for indexing. Adds trailing slash when missing and\n * folds only explicitly known historical AAO hosts into the current host.\n * The AAO publishes the canonical form as `https://creative.adcontextprotocol.org/`\n * (with slash); some v2 fixtures use the no-slash form. Both refer to\n * the same agent; this lookup folds them. This composite-identity lookup\n * never ignores ownership. The separate unique-bare-ID compatibility lookup\n * is fail-closed on collisions and never changes this index.\n */\nconst AAO_LEGACY_AGENT_URL_ALIASES = new Set([\n  // Early AAO reference implementations, including Optimera's deployed\n  // catalog, used the protocol root before creative.adcontextprotocol.org\n  // became the canonical format-agent host.\n  'https://adcontextprotocol.org/',\n]);\n\nfunction normalizeAgentUrl(u: string): string | undefined {\n  const canonical = canonicalizeAgentUrl(u);\n  if (canonical === null) return undefined;\n  return AAO_LEGACY_AGENT_URL_ALIASES.has(canonical) ? AAO_CANONICAL_AGENT_URL : canonical;\n}\n\nfunction indexKey(agentUrl: string, id: string): string | undefined {\n  const normalized = normalizeAgentUrl(agentUrl);\n  return normalized === undefined ? undefined : `${normalized}::${id}`;\n}\n\n/**\n * Load the catalog from a known path. Resolution order:\n *\n *   1. Caller-supplied `explicitPath` (test hook).\n *   2. Adjacent to the compiled loader — `dist/lib/v2/projection/\n *      aao-reference-formats.json`. This is the path that ships in the\n *      published npm tarball; `scripts/copy-v2-projection-catalog.ts`\n *      vendors the file here during `build:lib`.\n *   3. Source-tree test fixture at\n *      `test/lib/v2-projection-fixtures/aao-reference-formats.json`,\n *      relative to the loader's source location. Used when running from\n *      a source checkout (e.g., `tsx` / vitest) before `build:lib`.\n *\n * Memoized — catalog is small and immutable per spec version.\n *\n * @param explicitPath caller-supplied path; takes precedence over\n *                     fallback resolution.\n */\nexport function loadCatalog(explicitPath?: string): CatalogIndex {\n  const candidates = explicitPath\n    ? [explicitPath]\n    : [\n        path.join(__dirname, 'aao-reference-formats.json'),\n        path.join(\n          __dirname,\n          '..',\n          '..',\n          '..',\n          '..',\n          'test',\n          'lib',\n          'v2-projection-fixtures',\n          'aao-reference-formats.json'\n        ),\n      ];\n\n  for (const file of candidates) {\n    if (existsSync(file)) {\n      const cached = cachedByPath.get(file);\n      if (cached) return cached;\n      const raw = JSON.parse(readFileSync(file, 'utf-8')) as V1FormatDefinition[];\n      const byKey = new Map<string, V1FormatDefinition>();\n      const byUniqueId = new Map<string, V1FormatDefinition | null>();\n      for (const entry of raw) {\n        if (entry?.format_id?.agent_url && entry?.format_id?.id) {\n          const key = indexKey(entry.format_id.agent_url, entry.format_id.id);\n          if (key !== undefined) byKey.set(key, entry);\n          if (byUniqueId.has(entry.format_id.id)) byUniqueId.set(entry.format_id.id, null);\n          else byUniqueId.set(entry.format_id.id, entry);\n        }\n      }\n      const compiled = { byKey, byUniqueId, entries: raw };\n      cachedByPath.set(file, compiled);\n      return compiled;\n    }\n  }\n\n  throw new Error(\n    `AAO catalog (aao-reference-formats.json) not found. Looked in: ${candidates.join(', ')}. ` +\n      `This indicates a corrupted @adcp/sdk install or an SDK packaging regression — ` +\n      `please file an issue at https://github.com/adcontextprotocol/adcp-client/issues with ` +\n      `your install method (npm/yarn/pnpm) and Node version. ` +\n      `If you're working from a source checkout, run \\`npm run build:lib\\` first.`\n  );\n}\n\n/**\n * Look up a v1 format definition by its format_id. Returns undefined\n * when not in the catalog — caller falls through to registry / structural\n * match per the resolution order.\n */\nexport function lookupV1Format(formatId: V1FormatId, explicitPath?: string): V1FormatDefinition | undefined {\n  const catalog = loadCatalog(explicitPath);\n  const key = indexKey(formatId.agent_url, formatId.id);\n  return key === undefined ? undefined : catalog.byKey.get(key);\n}\n\n/**\n * Resolve an AAO-published bare ID only when the bundled catalog gives that\n * ID exactly one meaning. This is an inbound legacy compatibility seam for\n * sellers that copied an AAO standard ID but incorrectly emitted their own\n * creative-agent URL. It never rewrites the source ref, so a later downgrade\n * returns the seller's original owner tuple. Duplicate IDs fail closed.\n */\nexport function lookupUniqueV1FormatById(id: string, explicitPath?: string): V1FormatDefinition | undefined {\n  const match = loadCatalog(explicitPath).byUniqueId.get(id);\n  return match ?? undefined;\n}\n\n/** Test hook: reset the memoized catalog. */\nexport function _resetCatalogCache(): void {\n  cachedByPath.clear();\n}\n\n/**\n * Find a catalog entry matching `(canonical, width, height)` at the same\n * publisher domain as `agentUrl`. Used by the v2 → v1 multi-size fan-out:\n * when a v2 declaration says `sizes: [W1×H1, W2×H2, ...]` and the\n * seller-asserted `v1_format_ref` points at the catalog entry for one of\n * those sizes, the SDK can look up the entries for the OTHER sizes and\n * emit additional v1 format_ids — giving v1 buyers full size coverage\n * instead of just the rep.\n *\n * The catalog uses a stable id-pattern convention\n * (`<prefix>_<W>x<H>_<suffix>`) for per-size entries — image, html5, and\n * generative all follow it. This function parses ids matching that\n * pattern and matches on extracted dimensions, so the lookup is\n * dimensionally honest without requiring the spec to add explicit\n * width/height fields to catalog entries.\n *\n * Returns undefined when no matching entry exists at this publisher.\n * Caller falls back to the seller-asserted rep + lossy advisory.\n */\nconst SIZED_ID_RE = /^([a-z]+)_(\\d+)x(\\d+)_([a-z]+)$/;\n\n/**\n * Extract the `<prefix>_<W>x<H>_<suffix>` template from a sized catalog\n * id. Used by `findCatalogEntryByCanonicalAndSize` to filter fan-out\n * candidates to siblings of the seller-asserted ref. Multiple catalog\n * entries can share the same `canonical:` annotation but represent\n * different families (e.g., `image` is both `display_*_image` and\n * `display_*_generative`); without a suffix filter, fan-out would\n * collide families.\n */\nexport function parseSizedIdTemplate(id: string): { prefix: string; suffix: string } | undefined {\n  const m = id.match(SIZED_ID_RE);\n  if (!m) return undefined;\n  return { prefix: m[1]!, suffix: m[4]! };\n}\n\nexport function findCatalogEntryByCanonicalAndSize(\n  canonical: CanonicalFormatKind,\n  width: number,\n  height: number,\n  agentUrl: string,\n  options?: { prefix?: string; suffix?: string; explicitPath?: string }\n): V1FormatDefinition | undefined {\n  const catalog = loadCatalog(options?.explicitPath);\n  const normalizedAgentUrl = normalizeAgentUrl(agentUrl);\n  if (normalizedAgentUrl === undefined) return undefined;\n  for (const entry of catalog.entries) {\n    if (entry.canonical?.kind !== canonical) continue;\n    if (!entry.format_id?.id || !entry.format_id?.agent_url) continue;\n    if (normalizeAgentUrl(entry.format_id.agent_url) !== normalizedAgentUrl) continue;\n    const m = entry.format_id.id.match(SIZED_ID_RE);\n    if (!m) continue;\n    const [, prefix, wStr, hStr, suffix] = m;\n    if (options?.prefix && prefix !== options.prefix) continue;\n    if (options?.suffix && suffix !== options.suffix) continue;\n    if (parseInt(wStr!, 10) === width && parseInt(hStr!, 10) === height) {\n      return entry;\n    }\n  }\n  return undefined;\n}\n"],"mappings":"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","names":["require"]}

package/dist/lib/v2/projection/creative-delivery.d.mts

@@ -0,0 +1,157 @@
+import type { CreativeAsset, CreateMediaBuyRequest, CreateMediaBuyResponse, FormatOptionReference, GetProductsRequest, GetProductsResponse, GetCreativeDeliveryResponse, GetMediaBuyDeliveryResponse, GetMediaBuysResponse, CreativeFilters, ListCreativesResponse, ListCreativesRequest, PackageRequest, PackageUpdate, Package, Placement, Product, SyncCreativesRequest, SyncCreativesResponse, UpdateMediaBuyRequest, UpdateMediaBuyResponse } from '../../types/tools.generated.mjs';
+import type { LegacyFormatConverter } from './v1-to-v2.mjs';
+import type { CanonicalFormatLegacyResolver } from './v2-to-v1.mjs';
+import type { CanonicalFormatKind, ProjectionDiagnostic, V1FormatId } from './types.mjs';
+import type { CanonicalFormatDeclaration } from './legacy-metadata.mjs';
+type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, Extract<keyof T, K>> : never;
+/** Primary SDK creative shape. Legacy creative identity is a wire-adapter concern. */
+export type CanonicalCreativeAsset = Omit<CanonicalCreativeResponse<CreativeAsset>, 'format_kind'> & {
+    format_kind: CanonicalFormatKind;
+    format_id?: never;
+};
+/** Explicit compatibility-only creative shape used at a legacy wire boundary. */
+export type LegacyCreativeAsset = Omit<CreativeAsset, 'format_id' | 'format_kind' | 'format_option_ref'> & {
+    format_id: V1FormatId;
+    format_kind?: never;
+    format_option_ref?: never;
+};
+export type CanonicalPackageRequest = DistributiveOmit<CanonicalCreativeResponse<PackageRequest>, 'creatives' | 'format_ids'> & {
+    creatives?: CanonicalCreativeAsset[];
+    format_ids?: never;
+};
+export type NonEmptyCanonicalFormatDeclarations = [CanonicalFormatDeclaration, ...CanonicalFormatDeclaration[]];
+export type CanonicalPlacement = Omit<CanonicalCreativeResponse<Placement>, 'format_ids' | 'format_options'> & {
+    format_ids?: never;
+    format_options?: NonEmptyCanonicalFormatDeclarations;
+};
+export type CanonicalProduct = Omit<CanonicalCreativeResponse<Product>, 'format_ids' | 'format_options' | 'placements'> & {
+    product_id: string;
+    format_ids?: never;
+    format_options: NonEmptyCanonicalFormatDeclarations;
+    placements?: CanonicalPlacement[];
+};
+type CanonicalGetProductsField = Exclude<NonNullable<GetProductsRequest['fields']>[number], 'format_ids'>;
+/** Primary product discovery request cannot ask the SDK to expose legacy format IDs. */
+export type CanonicalGetProductsRequest = Omit<GetProductsRequest, 'fields'> & {
+    fields?: CanonicalGetProductsField[];
+};
+export type CanonicalGetProductsResponse = Omit<CanonicalCreativeResponse<GetProductsResponse>, 'products'> & {
+    products: CanonicalProduct[];
+    projection: {
+        diagnostics: ProjectionDiagnostic[];
+    };
+};
+export type CanonicalPackageUpdate = Omit<CanonicalCreativeResponse<PackageUpdate>, 'creatives'> & {
+    creatives?: CanonicalCreativeAsset[];
+};
+export type CanonicalPackage = CanonicalCreativeResponse<Package>;
+export type CanonicalCreateMediaBuyRequest = Omit<CanonicalCreativeResponse<CreateMediaBuyRequest>, 'packages'> & {
+    packages?: CanonicalPackageRequest[];
+};
+export type CanonicalUpdateMediaBuyRequest = Omit<CanonicalCreativeResponse<UpdateMediaBuyRequest>, 'packages' | 'new_packages'> & {
+    packages?: CanonicalPackageUpdate[];
+    new_packages?: CanonicalPackageRequest[];
+};
+export type CanonicalSyncCreativesRequest = Omit<CanonicalCreativeResponse<SyncCreativesRequest>, 'creatives'> & {
+    creatives: CanonicalCreativeAsset[];
+};
+export type CanonicalListedCreative = Omit<CanonicalCreativeResponse<ListCreativesResponse['creatives'][number]>, 'format_id' | 'format_kind' | 'format_option_ref'> & {
+    format_kind: CanonicalFormatKind;
+    format_option_ref?: FormatOptionReference;
+    format_id?: never;
+};
+export type CanonicalListCreativesResponse = Omit<CanonicalCreativeResponse<ListCreativesResponse>, 'creatives'> & {
+    creatives: CanonicalListedCreative[];
+};
+export type CanonicalCreateMediaBuyResponse = CanonicalCreativeResponse<CreateMediaBuyResponse>;
+export type CanonicalUpdateMediaBuyResponse = CanonicalCreativeResponse<UpdateMediaBuyResponse>;
+export type CanonicalSyncCreativesResponse = CanonicalCreativeResponse<SyncCreativesResponse>;
+export type CanonicalGetMediaBuysResponse = CanonicalCreativeResponse<GetMediaBuysResponse>;
+export type CanonicalGetMediaBuyDeliveryResponse = CanonicalCreativeResponse<GetMediaBuyDeliveryResponse>;
+export type CanonicalGetCreativeDeliveryResponse = CanonicalCreativeResponse<GetCreativeDeliveryResponse>;
+export type CanonicalCreativeFilters = Omit<CanonicalCreativeResponse<CreativeFilters>, 'format_ids'> & {
+    format_ids?: never;
+};
+type CanonicalListCreativeField = Exclude<NonNullable<ListCreativesRequest['fields']>[number], 'format_id'>;
+/** Primary list request: legacy named-format filters and response fields are migration-only. */
+export type CanonicalListCreativesRequest = Omit<CanonicalCreativeResponse<ListCreativesRequest>, 'filters' | 'fields'> & {
+    filters?: CanonicalCreativeFilters;
+    fields?: CanonicalListCreativeField[];
+};
+type IsLegacyCreativeIdentityKey<K extends PropertyKey> = K extends string ? K extends '_message' | `${string}format_id${string}` | `${string}v1_format_ref${string}` ? true : false : false;
+/** Recursively removes legacy creative routing identity from primary response types. */
+export type CanonicalCreativeResponse<T> = T extends (...args: never[]) => unknown ? T : T extends readonly (infer TItem)[] ? CanonicalCreativeResponse<TItem>[] : T extends object ? {
+    [K in keyof T as IsLegacyCreativeIdentityKey<K> extends true ? never : K]: CanonicalCreativeResponse<T[K]>;
+} : T;
+/** Runtime counterpart to {@link CanonicalCreativeResponse}. */
+export declare function stripLegacyCreativeIdentity<T>(value: T): CanonicalCreativeResponse<T>;
+export type CanonicalProjectedCreative<T> = Omit<T, 'format_id' | 'format_kind'> & {
+    format_kind: CanonicalFormatKind;
+    format_id?: never;
+};
+export type LegacyProjectedCreative<T> = Omit<T, 'format_id' | 'format_kind' | 'format_option_ref'> & {
+    format_id: V1FormatId;
+    format_kind?: never;
+    format_option_ref?: never;
+};
+type ProjectedCreativeArray<T, TMode extends 'canonical' | 'legacy'> = T extends ReadonlyArray<infer TCreative> ? Array<TMode extends 'canonical' ? CanonicalProjectedCreative<TCreative> : LegacyProjectedCreative<TCreative>> : T;
+type ReplaceCreatives<T, TMode extends 'canonical' | 'legacy'> = T extends object ? 'creatives' extends keyof T ? Omit<T, 'creatives'> & (Record<never, never> extends Pick<T, 'creatives'> ? {
+    creatives?: ProjectedCreativeArray<T['creatives'], TMode>;
+} : {
+    creatives: ProjectedCreativeArray<T['creatives'], TMode>;
+}) : T : T;
+type ProjectedContainerArray<T, TMode extends 'canonical' | 'legacy'> = T extends ReadonlyArray<infer TContainer> ? Array<ReplaceCreatives<TContainer, TMode>> : T;
+type ReplaceContainerKey<T, TKey extends 'packages' | 'new_packages', TMode extends 'canonical' | 'legacy'> = TKey extends keyof T ? Record<never, never> extends Pick<T, TKey> ? {
+    [K in TKey]?: ProjectedContainerArray<T[TKey], TMode>;
+} : {
+    [K in TKey]: ProjectedContainerArray<T[TKey], TMode>;
+} : Record<never, never>;
+export type ProjectedMediaBuyCreativeRequest<T, TMode extends 'canonical' | 'legacy'> = Omit<T, 'packages' | 'new_packages'> & ReplaceContainerKey<T, 'packages', TMode> & ReplaceContainerKey<T, 'new_packages', TMode>;
+export type ProjectedSyncCreativeRequest<T, TMode extends 'canonical' | 'legacy'> = ReplaceCreatives<T, TMode>;
+export type CreativeFormatWireMode = 'canonical' | 'legacy' | 'unknown';
+export interface CreativeFormatSelectorContainer {
+    package_id?: string;
+    format_ids?: unknown[];
+    formats?: unknown[];
+    format_options?: unknown[];
+    format_option_refs?: unknown[];
+    format_kind?: unknown;
+    params?: unknown;
+    /** Internal composition seam used to preserve per-package selector constraints. */
+    selector_containers?: ReadonlyArray<CreativeFormatSelectorContainer>;
+    [key: string]: unknown;
+}
+/** Canonical package/product selectors accepted by the primary sync API. */
+export interface CanonicalCreativeFormatSelectorContainer {
+    package_id?: string;
+    format_options?: ReadonlyArray<CanonicalFormatDeclaration>;
+    format_option_refs?: ReadonlyArray<FormatOptionReference>;
+    format_kind?: CanonicalFormatKind;
+    params?: CanonicalFormatDeclaration['params'];
+    selector_containers?: ReadonlyArray<CanonicalCreativeFormatSelectorContainer>;
+}
+export interface SyncCreativeFormatProjection {
+    selectorContainers: ReadonlyArray<CanonicalCreativeFormatSelectorContainer>;
+    legacyFormatConverter?: LegacyFormatConverter;
+}
+export declare class CreativeFormatProjectionError extends Error {
+    readonly operation: string;
+    readonly creativeId: string;
+    readonly code = "ADCP_CREATIVE_FORMAT_PROJECTION_FAILED";
+    constructor(operation: string, creativeId: string, reason: string);
+}
+export declare class CreativeFormatCapabilityError extends Error {
+    readonly code = "ADCP_CREATIVE_FORMAT_CAPABILITY_CONTRADICTION";
+    constructor(message: string);
+}
+export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode?: 'canonical', operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): CanonicalProjectedCreative<T>;
+export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode: 'legacy' | 'unknown', operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): LegacyProjectedCreative<T>;
+export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode: CreativeFormatWireMode, operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): CanonicalProjectedCreative<T> | LegacyProjectedCreative<T>;
+export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: 'canonical', operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedMediaBuyCreativeRequest<T, 'canonical'>;
+export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: 'legacy' | 'unknown', operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedMediaBuyCreativeRequest<T, 'legacy'>;
+export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: CreativeFormatWireMode, operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedMediaBuyCreativeRequest<T, 'canonical'> | ProjectedMediaBuyCreativeRequest<T, 'legacy'>;
+export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'canonical', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'canonical'>;
+export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'legacy' | 'unknown', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'legacy'>;
+export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: CreativeFormatWireMode, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'canonical'> | ProjectedSyncCreativeRequest<T, 'legacy'>;
+export declare function resolveCreativeFormatWireMode(capabilities: unknown, negotiatedVersion?: string): CreativeFormatWireMode;
+export {};

package/dist/lib/v2/projection/creative-delivery.d.ts

@@ -0,0 +1,158 @@
+import type { CreativeAsset, CreateMediaBuyRequest, CreateMediaBuyResponse, FormatOptionReference, GetProductsRequest, GetProductsResponse, GetCreativeDeliveryResponse, GetMediaBuyDeliveryResponse, GetMediaBuysResponse, CreativeFilters, ListCreativesResponse, ListCreativesRequest, PackageRequest, PackageUpdate, Package, Placement, Product, SyncCreativesRequest, SyncCreativesResponse, UpdateMediaBuyRequest, UpdateMediaBuyResponse } from '../../types/tools.generated';
+import type { LegacyFormatConverter } from './v1-to-v2';
+import type { CanonicalFormatLegacyResolver } from './v2-to-v1';
+import type { CanonicalFormatKind, ProjectionDiagnostic, V1FormatId } from './types';
+import type { CanonicalFormatDeclaration } from './legacy-metadata';
+type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, Extract<keyof T, K>> : never;
+/** Primary SDK creative shape. Legacy creative identity is a wire-adapter concern. */
+export type CanonicalCreativeAsset = Omit<CanonicalCreativeResponse<CreativeAsset>, 'format_kind'> & {
+    format_kind: CanonicalFormatKind;
+    format_id?: never;
+};
+/** Explicit compatibility-only creative shape used at a legacy wire boundary. */
+export type LegacyCreativeAsset = Omit<CreativeAsset, 'format_id' | 'format_kind' | 'format_option_ref'> & {
+    format_id: V1FormatId;
+    format_kind?: never;
+    format_option_ref?: never;
+};
+export type CanonicalPackageRequest = DistributiveOmit<CanonicalCreativeResponse<PackageRequest>, 'creatives' | 'format_ids'> & {
+    creatives?: CanonicalCreativeAsset[];
+    format_ids?: never;
+};
+export type NonEmptyCanonicalFormatDeclarations = [CanonicalFormatDeclaration, ...CanonicalFormatDeclaration[]];
+export type CanonicalPlacement = Omit<CanonicalCreativeResponse<Placement>, 'format_ids' | 'format_options'> & {
+    format_ids?: never;
+    format_options?: NonEmptyCanonicalFormatDeclarations;
+};
+export type CanonicalProduct = Omit<CanonicalCreativeResponse<Product>, 'format_ids' | 'format_options' | 'placements'> & {
+    product_id: string;
+    format_ids?: never;
+    format_options: NonEmptyCanonicalFormatDeclarations;
+    placements?: CanonicalPlacement[];
+};
+type CanonicalGetProductsField = Exclude<NonNullable<GetProductsRequest['fields']>[number], 'format_ids'>;
+/** Primary product discovery request cannot ask the SDK to expose legacy format IDs. */
+export type CanonicalGetProductsRequest = Omit<GetProductsRequest, 'fields'> & {
+    fields?: CanonicalGetProductsField[];
+};
+export type CanonicalGetProductsResponse = Omit<CanonicalCreativeResponse<GetProductsResponse>, 'products'> & {
+    products: CanonicalProduct[];
+    projection: {
+        diagnostics: ProjectionDiagnostic[];
+    };
+};
+export type CanonicalPackageUpdate = Omit<CanonicalCreativeResponse<PackageUpdate>, 'creatives'> & {
+    creatives?: CanonicalCreativeAsset[];
+};
+export type CanonicalPackage = CanonicalCreativeResponse<Package>;
+export type CanonicalCreateMediaBuyRequest = Omit<CanonicalCreativeResponse<CreateMediaBuyRequest>, 'packages'> & {
+    packages?: CanonicalPackageRequest[];
+};
+export type CanonicalUpdateMediaBuyRequest = Omit<CanonicalCreativeResponse<UpdateMediaBuyRequest>, 'packages' | 'new_packages'> & {
+    packages?: CanonicalPackageUpdate[];
+    new_packages?: CanonicalPackageRequest[];
+};
+export type CanonicalSyncCreativesRequest = Omit<CanonicalCreativeResponse<SyncCreativesRequest>, 'creatives'> & {
+    creatives: CanonicalCreativeAsset[];
+};
+export type CanonicalListedCreative = Omit<CanonicalCreativeResponse<ListCreativesResponse['creatives'][number]>, 'format_id' | 'format_kind' | 'format_option_ref'> & {
+    format_kind: CanonicalFormatKind;
+    format_option_ref?: FormatOptionReference;
+    format_id?: never;
+};
+export type CanonicalListCreativesResponse = Omit<CanonicalCreativeResponse<ListCreativesResponse>, 'creatives'> & {
+    creatives: CanonicalListedCreative[];
+};
+export type CanonicalCreateMediaBuyResponse = CanonicalCreativeResponse<CreateMediaBuyResponse>;
+export type CanonicalUpdateMediaBuyResponse = CanonicalCreativeResponse<UpdateMediaBuyResponse>;
+export type CanonicalSyncCreativesResponse = CanonicalCreativeResponse<SyncCreativesResponse>;
+export type CanonicalGetMediaBuysResponse = CanonicalCreativeResponse<GetMediaBuysResponse>;
+export type CanonicalGetMediaBuyDeliveryResponse = CanonicalCreativeResponse<GetMediaBuyDeliveryResponse>;
+export type CanonicalGetCreativeDeliveryResponse = CanonicalCreativeResponse<GetCreativeDeliveryResponse>;
+export type CanonicalCreativeFilters = Omit<CanonicalCreativeResponse<CreativeFilters>, 'format_ids'> & {
+    format_ids?: never;
+};
+type CanonicalListCreativeField = Exclude<NonNullable<ListCreativesRequest['fields']>[number], 'format_id'>;
+/** Primary list request: legacy named-format filters and response fields are migration-only. */
+export type CanonicalListCreativesRequest = Omit<CanonicalCreativeResponse<ListCreativesRequest>, 'filters' | 'fields'> & {
+    filters?: CanonicalCreativeFilters;
+    fields?: CanonicalListCreativeField[];
+};
+type IsLegacyCreativeIdentityKey<K extends PropertyKey> = K extends string ? K extends '_message' | `${string}format_id${string}` | `${string}v1_format_ref${string}` ? true : false : false;
+/** Recursively removes legacy creative routing identity from primary response types. */
+export type CanonicalCreativeResponse<T> = T extends (...args: never[]) => unknown ? T : T extends readonly (infer TItem)[] ? CanonicalCreativeResponse<TItem>[] : T extends object ? {
+    [K in keyof T as IsLegacyCreativeIdentityKey<K> extends true ? never : K]: CanonicalCreativeResponse<T[K]>;
+} : T;
+/** Runtime counterpart to {@link CanonicalCreativeResponse}. */
+export declare function stripLegacyCreativeIdentity<T>(value: T): CanonicalCreativeResponse<T>;
+export type CanonicalProjectedCreative<T> = Omit<T, 'format_id' | 'format_kind'> & {
+    format_kind: CanonicalFormatKind;
+    format_id?: never;
+};
+export type LegacyProjectedCreative<T> = Omit<T, 'format_id' | 'format_kind' | 'format_option_ref'> & {
+    format_id: V1FormatId;
+    format_kind?: never;
+    format_option_ref?: never;
+};
+type ProjectedCreativeArray<T, TMode extends 'canonical' | 'legacy'> = T extends ReadonlyArray<infer TCreative> ? Array<TMode extends 'canonical' ? CanonicalProjectedCreative<TCreative> : LegacyProjectedCreative<TCreative>> : T;
+type ReplaceCreatives<T, TMode extends 'canonical' | 'legacy'> = T extends object ? 'creatives' extends keyof T ? Omit<T, 'creatives'> & (Record<never, never> extends Pick<T, 'creatives'> ? {
+    creatives?: ProjectedCreativeArray<T['creatives'], TMode>;
+} : {
+    creatives: ProjectedCreativeArray<T['creatives'], TMode>;
+}) : T : T;
+type ProjectedContainerArray<T, TMode extends 'canonical' | 'legacy'> = T extends ReadonlyArray<infer TContainer> ? Array<ReplaceCreatives<TContainer, TMode>> : T;
+type ReplaceContainerKey<T, TKey extends 'packages' | 'new_packages', TMode extends 'canonical' | 'legacy'> = TKey extends keyof T ? Record<never, never> extends Pick<T, TKey> ? {
+    [K in TKey]?: ProjectedContainerArray<T[TKey], TMode>;
+} : {
+    [K in TKey]: ProjectedContainerArray<T[TKey], TMode>;
+} : Record<never, never>;
+export type ProjectedMediaBuyCreativeRequest<T, TMode extends 'canonical' | 'legacy'> = Omit<T, 'packages' | 'new_packages'> & ReplaceContainerKey<T, 'packages', TMode> & ReplaceContainerKey<T, 'new_packages', TMode>;
+export type ProjectedSyncCreativeRequest<T, TMode extends 'canonical' | 'legacy'> = ReplaceCreatives<T, TMode>;
+export type CreativeFormatWireMode = 'canonical' | 'legacy' | 'unknown';
+export interface CreativeFormatSelectorContainer {
+    package_id?: string;
+    format_ids?: unknown[];
+    formats?: unknown[];
+    format_options?: unknown[];
+    format_option_refs?: unknown[];
+    format_kind?: unknown;
+    params?: unknown;
+    /** Internal composition seam used to preserve per-package selector constraints. */
+    selector_containers?: ReadonlyArray<CreativeFormatSelectorContainer>;
+    [key: string]: unknown;
+}
+/** Canonical package/product selectors accepted by the primary sync API. */
+export interface CanonicalCreativeFormatSelectorContainer {
+    package_id?: string;
+    format_options?: ReadonlyArray<CanonicalFormatDeclaration>;
+    format_option_refs?: ReadonlyArray<FormatOptionReference>;
+    format_kind?: CanonicalFormatKind;
+    params?: CanonicalFormatDeclaration['params'];
+    selector_containers?: ReadonlyArray<CanonicalCreativeFormatSelectorContainer>;
+}
+export interface SyncCreativeFormatProjection {
+    selectorContainers: ReadonlyArray<CanonicalCreativeFormatSelectorContainer>;
+    legacyFormatConverter?: LegacyFormatConverter;
+}
+export declare class CreativeFormatProjectionError extends Error {
+    readonly operation: string;
+    readonly creativeId: string;
+    readonly code = "ADCP_CREATIVE_FORMAT_PROJECTION_FAILED";
+    constructor(operation: string, creativeId: string, reason: string);
+}
+export declare class CreativeFormatCapabilityError extends Error {
+    readonly code = "ADCP_CREATIVE_FORMAT_CAPABILITY_CONTRADICTION";
+    constructor(message: string);
+}
+export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode?: 'canonical', operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): CanonicalProjectedCreative<T>;
+export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode: 'legacy' | 'unknown', operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): LegacyProjectedCreative<T>;
+export declare function projectCreativeForDelivery<T extends CreativeAsset>(creative: T, selectorContainer: CreativeFormatSelectorContainer, wireMode: CreativeFormatWireMode, operation?: string, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): CanonicalProjectedCreative<T> | LegacyProjectedCreative<T>;
+export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: 'canonical', operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedMediaBuyCreativeRequest<T, 'canonical'>;
+export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: 'legacy' | 'unknown', operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedMediaBuyCreativeRequest<T, 'legacy'>;
+export declare function projectMediaBuyCreativesForDelivery<T>(request: T, wireMode: CreativeFormatWireMode, operation?: 'create_media_buy' | 'update_media_buy', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedMediaBuyCreativeRequest<T, 'canonical'> | ProjectedMediaBuyCreativeRequest<T, 'legacy'>;
+export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'canonical', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'canonical'>;
+export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: 'legacy' | 'unknown', legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'legacy'>;
+export declare function projectSyncCreativesForDelivery<T>(request: T, selectorContainers: ReadonlyArray<CreativeFormatSelectorContainer>, wireMode: CreativeFormatWireMode, legacyFormatConverter?: LegacyFormatConverter, canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver): ProjectedSyncCreativeRequest<T, 'canonical'> | ProjectedSyncCreativeRequest<T, 'legacy'>;
+export declare function resolveCreativeFormatWireMode(capabilities: unknown, negotiatedVersion?: string): CreativeFormatWireMode;
+export {};
+//# sourceMappingURL=creative-delivery.d.ts.map

package/dist/lib/v2/projection/creative-delivery.d.ts.map

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