@adcp/sdk 12.1.0 → 13.0.0-rc.0

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

@@ -0,0 +1,265 @@
+import { canonicalizeAgentUrl } from "../../discovery/resolve-agent-properties.mjs";
+import { isCanonicalV1Translatable } from "./canonical-properties.mjs";
+const compiledSnapshotCache = /* @__PURE__ */ new WeakMap();
+function normalizedAgentUrl(value) {
+  return canonicalizeAgentUrl(value) ?? value;
+}
+function legacyRefKey(ref) {
+  return JSON.stringify([
+    normalizedAgentUrl(ref.agent_url),
+    ref.id,
+    ref.width ?? null,
+    ref.height ?? null,
+    ref.duration_ms ?? null
+  ]);
+}
+function normalizedPublisherDomain(value) {
+  return (value ?? "").trim().toLowerCase().replace(/\.$/, "");
+}
+function formatOptionRefKey(formatOptionId, publisherDomain) {
+  return JSON.stringify([normalizedPublisherDomain(publisherDomain), formatOptionId]);
+}
+function formatOptionRefFromValue(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const record = value;
+  if (typeof record.format_option_id !== "string" || record.format_option_id.length === 0) return void 0;
+  if (record.scope === "publisher" || record.scope === void 0 && typeof record.publisher_domain === "string") {
+    if (typeof record.publisher_domain !== "string" || record.publisher_domain.length === 0) return void 0;
+    return { format_option_id: record.format_option_id, publisher_domain: record.publisher_domain };
+  }
+  return { format_option_id: record.format_option_id };
+}
+function semanticFields(value) {
+  return {
+    ...typeof value.format_kind === "string" ? { format_kind: value.format_kind } : {},
+    ...value.params !== null && typeof value.params === "object" && !Array.isArray(value.params) ? { params: value.params } : {}
+  };
+}
+function collectFormatOptionRefs(value, seen = /* @__PURE__ */ new WeakSet()) {
+  if (value === null || typeof value !== "object" || seen.has(value)) return [];
+  seen.add(value);
+  const record = value;
+  const refs = [];
+  const direct = formatOptionRefFromValue(record.format_option_ref);
+  if (direct) refs.push({ ...direct, ...semanticFields(record) });
+  for (const key of ["format_option_refs", "format_options"]) {
+    if (!Array.isArray(record[key])) continue;
+    for (const item of record[key]) {
+      const ref = formatOptionRefFromValue(item);
+      const itemRecord = item !== null && typeof item === "object" && !Array.isArray(item) ? item : record;
+      if (ref) refs.push({ ...ref, ...semanticFields(itemRecord) });
+    }
+  }
+  if (Array.isArray(record.selector_containers)) {
+    for (const container of record.selector_containers) refs.push(...collectFormatOptionRefs(container, seen));
+  }
+  return refs;
+}
+function resolutionContextFormatOptionRefs(context) {
+  if (context.source === "product") {
+    const declaration = context.declaration;
+    if (typeof declaration.format_option_id !== "string" || declaration.format_option_id.length === 0) return [];
+    return [
+      {
+        format_option_id: declaration.format_option_id,
+        ...typeof declaration.publisher_domain === "string" ? { publisher_domain: declaration.publisher_domain } : {},
+        format_kind: declaration.format_kind,
+        params: declaration.params
+      }
+    ];
+  }
+  if (context.source === "creative") {
+    const creativeRefs = collectFormatOptionRefs(context.creative);
+    return creativeRefs.length > 0 ? creativeRefs : collectFormatOptionRefs(context.selector);
+  }
+  return collectFormatOptionRefs(context.selector);
+}
+function dataValuesEqual(left, right) {
+  if (Object.is(left, right)) return true;
+  if (Array.isArray(left) || Array.isArray(right)) {
+    return Array.isArray(left) && Array.isArray(right) && left.length === right.length && left.every((item, index) => dataValuesEqual(item, right[index]));
+  }
+  if (left === null || right === null || typeof left !== "object" || typeof right !== "object") return false;
+  const leftRecord = left;
+  const rightRecord = right;
+  const leftKeys = Object.keys(leftRecord).sort();
+  const rightKeys = Object.keys(rightRecord).sort();
+  return leftKeys.length === rightKeys.length && leftKeys.every((key, index) => key === rightKeys[index] && dataValuesEqual(leftRecord[key], rightRecord[key]));
+}
+function sharedParamsAgree(declarationParams, contextParams) {
+  if (!contextParams) return true;
+  return Object.keys(contextParams).every(
+    (key) => !(key in declarationParams) || dataValuesEqual(declarationParams[key], contextParams[key])
+  );
+}
+function routeMatchesContext(route, ref, context) {
+  if (ref.format_kind !== void 0 && ref.format_kind !== route.declaration.format_kind) return false;
+  if (!sharedParamsAgree(route.declaration.params, ref.params)) return false;
+  const records = context.source === "creative" ? [context.creative, context.selector] : context.source === "selector" ? [context.selector] : [];
+  return records.every((record) => {
+    const fields = semanticFields(record);
+    return (fields.format_kind === void 0 || fields.format_kind === route.declaration.format_kind) && sharedParamsAgree(route.declaration.params, fields.params);
+  });
+}
+function immutableClone(value) {
+  const clone = structuredClone(value);
+  const freeze = (candidate, seen = /* @__PURE__ */ new WeakSet()) => {
+    if (candidate === null || typeof candidate !== "object" || seen.has(candidate)) return;
+    seen.add(candidate);
+    for (const child of Object.values(candidate)) freeze(child, seen);
+    Object.freeze(candidate);
+  };
+  freeze(clone);
+  return clone;
+}
+function declarationWithoutLegacyIdentity(declaration, publisherDomain) {
+  const { v1_format_ref: _dropRefs, canonical_formats_only: _dropCanonicalOnly, ...canonical } = declaration;
+  void _dropRefs;
+  void _dropCanonicalOnly;
+  return {
+    ...canonical,
+    ...canonical.publisher_domain === void 0 && publisherDomain ? { publisher_domain: publisherDomain } : {}
+  };
+}
+function compileProjectionCatalogSnapshots(snapshots) {
+  const cached = compiledSnapshotCache.get(snapshots);
+  if (cached) return cached;
+  const compiled = snapshots.map((snapshot) => {
+    const byLegacyRef = /* @__PURE__ */ new Map();
+    const byFormatOptionRef = /* @__PURE__ */ new Map();
+    for (const sourceDeclaration of snapshot.formats) {
+      const declaration = immutableClone(sourceDeclaration);
+      if (declaration.canonical_formats_only === true || !isCanonicalV1Translatable(declaration.format_kind) || !Array.isArray(declaration.v1_format_ref) || declaration.v1_format_ref.length === 0) {
+        continue;
+      }
+      const canonical = immutableClone(declarationWithoutLegacyIdentity(declaration, snapshot.publisher_domain));
+      const legacyRefs = immutableClone([
+        ...new Map(declaration.v1_format_ref.map((ref) => [legacyRefKey(ref), { ...ref }])).values()
+      ]);
+      const declarationKeys = new Set(declaration.v1_format_ref.map(legacyRefKey));
+      for (const key of declarationKeys) {
+        const matches = byLegacyRef.get(key) ?? [];
+        matches.push(canonical);
+        byLegacyRef.set(key, matches);
+      }
+      if (typeof canonical.format_option_id === "string" && canonical.format_option_id.length > 0 && typeof canonical.publisher_domain === "string" && canonical.publisher_domain.length > 0) {
+        const key = formatOptionRefKey(canonical.format_option_id, canonical.publisher_domain);
+        const matches = byFormatOptionRef.get(key) ?? [];
+        matches.push(Object.freeze({ declaration: canonical, legacyRefs }));
+        byFormatOptionRef.set(key, matches);
+      }
+    }
+    for (const matches of byLegacyRef.values()) Object.freeze(matches);
+    for (const matches of byFormatOptionRef.values()) Object.freeze(matches);
+    return Object.freeze({ byLegacyRef, byFormatOptionRef });
+  });
+  Object.freeze(compiled);
+  compiledSnapshotCache.set(snapshots, compiled);
+  return compiled;
+}
+function legacyFormatConverterFromCatalogSnapshots(snapshots, fallback) {
+  if (!snapshots || snapshots.length === 0) return fallback;
+  const compiled = compileProjectionCatalogSnapshots(snapshots);
+  return (context) => {
+    const key = legacyRefKey(context.formatId);
+    for (const snapshot of compiled) {
+      const matches = snapshot.byLegacyRef.get(key) ?? [];
+      if (matches.length > 1) {
+        throw new Error("projection catalog contains ambiguous legacy aliases");
+      }
+      if (matches.length === 1) {
+        return matches[0];
+      }
+    }
+    return fallback?.(context);
+  };
+}
+function canonicalFormatLegacyResolverFromCatalogSnapshots(snapshots, fallback) {
+  if (!snapshots || snapshots.length === 0) return fallback;
+  const compiled = compileProjectionCatalogSnapshots(snapshots);
+  return (context) => {
+    const refs = resolutionContextFormatOptionRefs(context);
+    if (refs.length === 0) return fallback?.(context);
+    const resolved = [];
+    for (const ref of refs) {
+      const key = formatOptionRefKey(ref.format_option_id, ref.publisher_domain);
+      let matched;
+      for (const snapshot of compiled) {
+        const matches = snapshot.byFormatOptionRef.get(key) ?? [];
+        if (matches.length > 1) {
+          throw new Error("projection catalog contains ambiguous canonical format option aliases");
+        }
+        if (matches.length === 1) {
+          matched = matches[0];
+          break;
+        }
+      }
+      if (!matched) return fallback?.(context);
+      if (!routeMatchesContext(matched, ref, context)) return fallback?.(context);
+      resolved.push(...matched.legacyRefs.map((item) => ({ ...item })));
+    }
+    return [...new Map(resolved.map((ref) => [legacyRefKey(ref), ref])).values()];
+  };
+}
+function assertBidirectionalProjectionCatalogs(snapshots) {
+  const routeByCanonicalOption = /* @__PURE__ */ new Map();
+  const canonicalOptionByLegacyRoute = /* @__PURE__ */ new Map();
+  for (const snapshot of snapshots) {
+    const declarationsAtThisTier = /* @__PURE__ */ new Set();
+    for (const declaration of snapshot.formats) {
+      if (declaration.canonical_formats_only === true || !Array.isArray(declaration.v1_format_ref) || declaration.v1_format_ref.length === 0) {
+        continue;
+      }
+      if (!isCanonicalV1Translatable(declaration.format_kind)) {
+        throw new Error("bidirectional projection adapters cannot downgrade a canonical-only format kind");
+      }
+      const canonical = declarationWithoutLegacyIdentity(declaration, snapshot.publisher_domain);
+      if (typeof canonical.format_option_id !== "string" || canonical.format_option_id.length === 0) {
+        throw new Error("bidirectional projection adapters require a stable format_option_id");
+      }
+      if (typeof canonical.publisher_domain !== "string" || canonical.publisher_domain.length === 0) {
+        throw new Error("bidirectional projection adapters require publisher-scoped format options");
+      }
+      const uniqueLegacyKeys = new Set(declaration.v1_format_ref.map(legacyRefKey));
+      if (uniqueLegacyKeys.size !== 1) {
+        throw new Error(
+          "bidirectional projection adapters require exactly one legacy route per canonical format option"
+        );
+      }
+      const canonicalKey = formatOptionRefKey(canonical.format_option_id, canonical.publisher_domain);
+      const legacyKey = [...uniqueLegacyKeys][0];
+      const declarationKey = JSON.stringify([canonicalKey, legacyKey]);
+      if (declarationsAtThisTier.has(declarationKey)) {
+        throw new Error("bidirectional projection adapters contain duplicate declarations at one precedence tier");
+      }
+      declarationsAtThisTier.add(declarationKey);
+      const existing = routeByCanonicalOption.get(canonicalKey);
+      if (existing !== void 0 && existing !== legacyKey) {
+        throw new Error("bidirectional projection adapters contain conflicting reverse routes");
+      }
+      const existingCanonical = canonicalOptionByLegacyRoute.get(legacyKey);
+      if (existingCanonical !== void 0 && existingCanonical !== canonicalKey) {
+        throw new Error("bidirectional projection adapters contain conflicting forward routes");
+      }
+      routeByCanonicalOption.set(canonicalKey, legacyKey);
+      canonicalOptionByLegacyRoute.set(legacyKey, canonicalKey);
+    }
+  }
+}
+function projectionAdaptersFromCatalogSnapshots(snapshots, fallbackCanonicalResolver) {
+  assertBidirectionalProjectionCatalogs(snapshots);
+  const canonicalFormatLegacyResolver = canonicalFormatLegacyResolverFromCatalogSnapshots(
+    snapshots,
+    fallbackCanonicalResolver
+  );
+  if (!canonicalFormatLegacyResolver) {
+    throw new Error("projection adapters require at least one catalog snapshot or a fallback resolver");
+  }
+  return { projectionCatalogs: snapshots, canonicalFormatLegacyResolver };
+}
+export {
+  canonicalFormatLegacyResolverFromCatalogSnapshots,
+  legacyFormatConverterFromCatalogSnapshots,
+  projectionAdaptersFromCatalogSnapshots
+};
+//# sourceMappingURL=catalog-snapshot.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/v2/projection/catalog-snapshot.ts"],"sourcesContent":["import type { LegacyFormatConverter } from './v1-to-v2';\nimport type { V1FormatId, V2ProductFormatDeclaration } from './types';\nimport type { CanonicalFormatLegacyResolutionContext, CanonicalFormatLegacyResolver } from './v2-to-v1';\nimport { canonicalizeAgentUrl } from '../../discovery/resolve-agent-properties';\nimport { isCanonicalV1Translatable } from './canonical-properties';\n\n/** Provenance tier for a pre-resolved immutable format catalog snapshot. */\nexport type ProjectionCatalogSource = 'publisher' | 'aao_mirror' | 'agent_derived' | 'configured';\n\n/**\n * Canonical catalog data resolved outside the pure projector.\n *\n * Network discovery deliberately does not happen inside projection. Callers\n * may resolve publisher/community catalogs asynchronously, then inject the\n * immutable result here for synchronous reads, writes, continuations, and\n * webhook handling. Array order is precedence order (most specific first).\n */\nexport interface ProjectionCatalogSnapshot {\n  source: ProjectionCatalogSource;\n  /** Canonical publisher scope applied when declarations omit it. */\n  publisher_domain?: string;\n  formats: readonly V2ProductFormatDeclaration[];\n}\n\ninterface CompiledProjectionCatalogSnapshot {\n  byLegacyRef: ReadonlyMap<string, readonly V2ProductFormatDeclaration[]>;\n  byFormatOptionRef: ReadonlyMap<string, readonly CompiledReverseRoute[]>;\n}\n\ninterface CompiledReverseRoute {\n  declaration: Readonly<V2ProductFormatDeclaration>;\n  legacyRefs: readonly V1FormatId[];\n}\n\ninterface ContextFormatOptionRef {\n  format_option_id: string;\n  publisher_domain?: string;\n  format_kind?: string;\n  params?: Readonly<Record<string, unknown>>;\n}\n\nconst compiledSnapshotCache = new WeakMap<object, readonly CompiledProjectionCatalogSnapshot[]>();\n\n/** Preserve protocol URL identity, including a distinct terminal slash. */\nfunction normalizedAgentUrl(value: string): string {\n  return canonicalizeAgentUrl(value) ?? value;\n}\n\nfunction legacyRefKey(ref: V1FormatId): string {\n  return JSON.stringify([\n    normalizedAgentUrl(ref.agent_url),\n    ref.id,\n    ref.width ?? null,\n    ref.height ?? null,\n    ref.duration_ms ?? null,\n  ]);\n}\n\nfunction normalizedPublisherDomain(value: string | undefined): string {\n  return (value ?? '').trim().toLowerCase().replace(/\\.$/, '');\n}\n\nfunction formatOptionRefKey(formatOptionId: string, publisherDomain?: string): string {\n  return JSON.stringify([normalizedPublisherDomain(publisherDomain), formatOptionId]);\n}\n\nfunction formatOptionRefFromValue(value: unknown): { format_option_id: string; publisher_domain?: string } | undefined {\n  if (value === null || typeof value !== 'object' || Array.isArray(value)) return undefined;\n  const record = value as Record<string, unknown>;\n  if (typeof record.format_option_id !== 'string' || record.format_option_id.length === 0) return undefined;\n  if (record.scope === 'publisher' || (record.scope === undefined && typeof record.publisher_domain === 'string')) {\n    if (typeof record.publisher_domain !== 'string' || record.publisher_domain.length === 0) return undefined;\n    return { format_option_id: record.format_option_id, publisher_domain: record.publisher_domain };\n  }\n  return { format_option_id: record.format_option_id };\n}\n\nfunction semanticFields(value: Record<string, unknown>): Pick<ContextFormatOptionRef, 'format_kind' | 'params'> {\n  return {\n    ...(typeof value.format_kind === 'string' ? { format_kind: value.format_kind } : {}),\n    ...(value.params !== null && typeof value.params === 'object' && !Array.isArray(value.params)\n      ? { params: value.params as Record<string, unknown> }\n      : {}),\n  };\n}\n\nfunction collectFormatOptionRefs(value: unknown, seen = new WeakSet<object>()): ContextFormatOptionRef[] {\n  if (value === null || typeof value !== 'object' || seen.has(value as object)) return [];\n  seen.add(value as object);\n  const record = value as Record<string, unknown>;\n  const refs: ContextFormatOptionRef[] = [];\n  const direct = formatOptionRefFromValue(record.format_option_ref);\n  if (direct) refs.push({ ...direct, ...semanticFields(record) });\n  for (const key of ['format_option_refs', 'format_options'] as const) {\n    if (!Array.isArray(record[key])) continue;\n    for (const item of record[key]) {\n      const ref = formatOptionRefFromValue(item);\n      const itemRecord = item !== null && typeof item === 'object' && !Array.isArray(item) ? item : record;\n      if (ref) refs.push({ ...ref, ...semanticFields(itemRecord as Record<string, unknown>) });\n    }\n  }\n  if (Array.isArray(record.selector_containers)) {\n    for (const container of record.selector_containers) refs.push(...collectFormatOptionRefs(container, seen));\n  }\n  return refs;\n}\n\nfunction resolutionContextFormatOptionRefs(context: CanonicalFormatLegacyResolutionContext): ContextFormatOptionRef[] {\n  if (context.source === 'product') {\n    const declaration = context.declaration;\n    if (typeof declaration.format_option_id !== 'string' || declaration.format_option_id.length === 0) return [];\n    return [\n      {\n        format_option_id: declaration.format_option_id,\n        ...(typeof declaration.publisher_domain === 'string' ? { publisher_domain: declaration.publisher_domain } : {}),\n        format_kind: declaration.format_kind,\n        params: declaration.params,\n      },\n    ];\n  }\n  if (context.source === 'creative') {\n    const creativeRefs = collectFormatOptionRefs(context.creative);\n    return creativeRefs.length > 0 ? creativeRefs : collectFormatOptionRefs(context.selector);\n  }\n  return collectFormatOptionRefs(context.selector);\n}\n\nfunction dataValuesEqual(left: unknown, right: unknown): boolean {\n  if (Object.is(left, right)) return true;\n  if (Array.isArray(left) || Array.isArray(right)) {\n    return (\n      Array.isArray(left) &&\n      Array.isArray(right) &&\n      left.length === right.length &&\n      left.every((item, index) => dataValuesEqual(item, right[index]))\n    );\n  }\n  if (left === null || right === null || typeof left !== 'object' || typeof right !== 'object') return false;\n  const leftRecord = left as Record<string, unknown>;\n  const rightRecord = right as Record<string, unknown>;\n  const leftKeys = Object.keys(leftRecord).sort();\n  const rightKeys = Object.keys(rightRecord).sort();\n  return (\n    leftKeys.length === rightKeys.length &&\n    leftKeys.every((key, index) => key === rightKeys[index] && dataValuesEqual(leftRecord[key], rightRecord[key]))\n  );\n}\n\nfunction sharedParamsAgree(\n  declarationParams: Readonly<Record<string, unknown>>,\n  contextParams: Readonly<Record<string, unknown>> | undefined\n): boolean {\n  if (!contextParams) return true;\n  return Object.keys(contextParams).every(\n    key => !(key in declarationParams) || dataValuesEqual(declarationParams[key], contextParams[key])\n  );\n}\n\nfunction routeMatchesContext(\n  route: CompiledReverseRoute,\n  ref: ContextFormatOptionRef,\n  context: CanonicalFormatLegacyResolutionContext\n): boolean {\n  if (ref.format_kind !== undefined && ref.format_kind !== route.declaration.format_kind) return false;\n  if (!sharedParamsAgree(route.declaration.params, ref.params)) return false;\n\n  const records =\n    context.source === 'creative'\n      ? [context.creative, context.selector]\n      : context.source === 'selector'\n        ? [context.selector]\n        : [];\n  return records.every(record => {\n    const fields = semanticFields(record as Record<string, unknown>);\n    return (\n      (fields.format_kind === undefined || fields.format_kind === route.declaration.format_kind) &&\n      sharedParamsAgree(route.declaration.params, fields.params)\n    );\n  });\n}\n\nfunction immutableClone<T>(value: T): T {\n  const clone = structuredClone(value);\n  const freeze = (candidate: unknown, seen = new WeakSet<object>()): void => {\n    if (candidate === null || typeof candidate !== 'object' || seen.has(candidate)) return;\n    seen.add(candidate);\n    for (const child of Object.values(candidate)) freeze(child, seen);\n    Object.freeze(candidate);\n  };\n  freeze(clone);\n  return clone;\n}\n\nfunction declarationWithoutLegacyIdentity(\n  declaration: V2ProductFormatDeclaration,\n  publisherDomain?: string\n): V2ProductFormatDeclaration {\n  const { v1_format_ref: _dropRefs, canonical_formats_only: _dropCanonicalOnly, ...canonical } = declaration;\n  void _dropRefs;\n  void _dropCanonicalOnly;\n  return {\n    ...canonical,\n    ...(canonical.publisher_domain === undefined && publisherDomain ? { publisher_domain: publisherDomain } : {}),\n  };\n}\n\nfunction compileProjectionCatalogSnapshots(\n  snapshots: readonly ProjectionCatalogSnapshot[]\n): readonly CompiledProjectionCatalogSnapshot[] {\n  const cached = compiledSnapshotCache.get(snapshots);\n  if (cached) return cached;\n\n  const compiled = snapshots.map(snapshot => {\n    const byLegacyRef = new Map<string, V2ProductFormatDeclaration[]>();\n    const byFormatOptionRef = new Map<string, CompiledReverseRoute[]>();\n    for (const sourceDeclaration of snapshot.formats) {\n      const declaration = immutableClone(sourceDeclaration);\n      if (\n        declaration.canonical_formats_only === true ||\n        !isCanonicalV1Translatable(declaration.format_kind) ||\n        !Array.isArray(declaration.v1_format_ref) ||\n        declaration.v1_format_ref.length === 0\n      ) {\n        continue;\n      }\n\n      const canonical = immutableClone(declarationWithoutLegacyIdentity(declaration, snapshot.publisher_domain));\n      const legacyRefs = immutableClone([\n        ...new Map(declaration.v1_format_ref.map(ref => [legacyRefKey(ref), { ...ref }])).values(),\n      ]);\n      // Repeating one alias on a declaration does not make it ambiguous. Two\n      // distinct declarations at the same precedence tier still do.\n      const declarationKeys = new Set(declaration.v1_format_ref.map(legacyRefKey));\n      for (const key of declarationKeys) {\n        const matches = byLegacyRef.get(key) ?? [];\n        matches.push(canonical);\n        byLegacyRef.set(key, matches);\n      }\n      if (\n        typeof canonical.format_option_id === 'string' &&\n        canonical.format_option_id.length > 0 &&\n        typeof canonical.publisher_domain === 'string' &&\n        canonical.publisher_domain.length > 0\n      ) {\n        const key = formatOptionRefKey(canonical.format_option_id, canonical.publisher_domain);\n        const matches = byFormatOptionRef.get(key) ?? [];\n        matches.push(Object.freeze({ declaration: canonical, legacyRefs }));\n        byFormatOptionRef.set(key, matches);\n      }\n    }\n    for (const matches of byLegacyRef.values()) Object.freeze(matches);\n    for (const matches of byFormatOptionRef.values()) Object.freeze(matches);\n    return Object.freeze({ byLegacyRef, byFormatOptionRef });\n  });\n\n  Object.freeze(compiled);\n  compiledSnapshotCache.set(snapshots, compiled);\n  return compiled;\n}\n\n/**\n * Convert exact, catalog-authored `v1_format_ref` aliases into the existing\n * converter seam. Canonical-only declarations never become legacy aliases,\n * and matching is always owner + id + dimensional discriminators—never ID\n * alone. Duplicate aliases at the same precedence tier fail closed.\n */\nexport function legacyFormatConverterFromCatalogSnapshots(\n  snapshots: readonly ProjectionCatalogSnapshot[] | undefined,\n  fallback?: LegacyFormatConverter\n): LegacyFormatConverter | undefined {\n  if (!snapshots || snapshots.length === 0) return fallback;\n  const compiled = compileProjectionCatalogSnapshots(snapshots);\n  return context => {\n    const key = legacyRefKey(context.formatId);\n    for (const snapshot of compiled) {\n      const matches = snapshot.byLegacyRef.get(key) ?? [];\n      if (matches.length > 1) {\n        throw new Error('projection catalog contains ambiguous legacy aliases');\n      }\n      if (matches.length === 1) {\n        return matches[0];\n      }\n    }\n    return fallback?.(context);\n  };\n}\n\n/**\n * Build the canonical → legacy half of an exact catalog-authored adapter.\n *\n * Only stable `format_option_id` references participate. Snapshot precedence\n * mirrors the forward projector, duplicate declarations at one tier fail\n * closed, and a multi-option selector is returned only when every option has\n * an exact mapping. This makes the resolver safe to use after canonical\n * objects have crossed a process or persistence boundary and lost the SDK's\n * private in-memory route metadata.\n */\nexport function canonicalFormatLegacyResolverFromCatalogSnapshots(\n  snapshots: readonly ProjectionCatalogSnapshot[] | undefined,\n  fallback?: CanonicalFormatLegacyResolver\n): CanonicalFormatLegacyResolver | undefined {\n  if (!snapshots || snapshots.length === 0) return fallback;\n  const compiled = compileProjectionCatalogSnapshots(snapshots);\n  return context => {\n    const refs = resolutionContextFormatOptionRefs(context);\n    if (refs.length === 0) return fallback?.(context);\n\n    const resolved: V1FormatId[] = [];\n    for (const ref of refs) {\n      const key = formatOptionRefKey(ref.format_option_id, ref.publisher_domain);\n      let matched: CompiledReverseRoute | undefined;\n      for (const snapshot of compiled) {\n        const matches = snapshot.byFormatOptionRef.get(key) ?? [];\n        if (matches.length > 1) {\n          throw new Error('projection catalog contains ambiguous canonical format option aliases');\n        }\n        if (matches.length === 1) {\n          matched = matches[0];\n          break;\n        }\n      }\n      if (!matched) return fallback?.(context);\n      if (!routeMatchesContext(matched, ref, context)) return fallback?.(context);\n      resolved.push(...matched.legacyRefs.map(item => ({ ...item })));\n    }\n\n    return [...new Map(resolved.map(ref => [legacyRefKey(ref), ref])).values()];\n  };\n}\n\n/** Client configuration generated from one bidirectional, owner-scoped catalog. */\nexport interface ProjectionCatalogAdapters {\n  projectionCatalogs: readonly ProjectionCatalogSnapshot[];\n  canonicalFormatLegacyResolver: CanonicalFormatLegacyResolver;\n}\n\nfunction assertBidirectionalProjectionCatalogs(snapshots: readonly ProjectionCatalogSnapshot[]): void {\n  const routeByCanonicalOption = new Map<string, string>();\n  const canonicalOptionByLegacyRoute = new Map<string, string>();\n  for (const snapshot of snapshots) {\n    const declarationsAtThisTier = new Set<string>();\n    for (const declaration of snapshot.formats) {\n      if (\n        declaration.canonical_formats_only === true ||\n        !Array.isArray(declaration.v1_format_ref) ||\n        declaration.v1_format_ref.length === 0\n      ) {\n        continue;\n      }\n      if (!isCanonicalV1Translatable(declaration.format_kind)) {\n        throw new Error('bidirectional projection adapters cannot downgrade a canonical-only format kind');\n      }\n      const canonical = declarationWithoutLegacyIdentity(declaration, snapshot.publisher_domain);\n      if (typeof canonical.format_option_id !== 'string' || canonical.format_option_id.length === 0) {\n        throw new Error('bidirectional projection adapters require a stable format_option_id');\n      }\n      if (typeof canonical.publisher_domain !== 'string' || canonical.publisher_domain.length === 0) {\n        throw new Error('bidirectional projection adapters require publisher-scoped format options');\n      }\n      const uniqueLegacyKeys = new Set(declaration.v1_format_ref.map(legacyRefKey));\n      if (uniqueLegacyKeys.size !== 1) {\n        throw new Error(\n          'bidirectional projection adapters require exactly one legacy route per canonical format option'\n        );\n      }\n      const canonicalKey = formatOptionRefKey(canonical.format_option_id, canonical.publisher_domain);\n      const legacyKey = [...uniqueLegacyKeys][0]!;\n      const declarationKey = JSON.stringify([canonicalKey, legacyKey]);\n      if (declarationsAtThisTier.has(declarationKey)) {\n        throw new Error('bidirectional projection adapters contain duplicate declarations at one precedence tier');\n      }\n      declarationsAtThisTier.add(declarationKey);\n      const existing = routeByCanonicalOption.get(canonicalKey);\n      if (existing !== undefined && existing !== legacyKey) {\n        throw new Error('bidirectional projection adapters contain conflicting reverse routes');\n      }\n      const existingCanonical = canonicalOptionByLegacyRoute.get(legacyKey);\n      if (existingCanonical !== undefined && existingCanonical !== canonicalKey) {\n        throw new Error('bidirectional projection adapters contain conflicting forward routes');\n      }\n      routeByCanonicalOption.set(canonicalKey, legacyKey);\n      canonicalOptionByLegacyRoute.set(legacyKey, canonicalKey);\n    }\n  }\n}\n\n/**\n * Configure both discovery upgrade and legacy delivery downgrade from one\n * immutable catalog. Spread the result into `AgentClient` configuration.\n */\nexport function projectionAdaptersFromCatalogSnapshots(\n  snapshots: readonly ProjectionCatalogSnapshot[],\n  fallbackCanonicalResolver?: CanonicalFormatLegacyResolver\n): ProjectionCatalogAdapters {\n  assertBidirectionalProjectionCatalogs(snapshots);\n  const canonicalFormatLegacyResolver = canonicalFormatLegacyResolverFromCatalogSnapshots(\n    snapshots,\n    fallbackCanonicalResolver\n  );\n  if (!canonicalFormatLegacyResolver) {\n    throw new Error('projection adapters require at least one catalog snapshot or a fallback resolver');\n  }\n  return { projectionCatalogs: snapshots, canonicalFormatLegacyResolver };\n}\n"],"mappings":"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","names":[]}

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

@@ -11,8 +11,10 @@
  * format projects to. This is the spec's resolution-order step 2 —
  * "seller-asserted on the v1 file" — applied to AAO-published v1 formats.
  *
- * Loader is keyed by `agent_url` (with trailing-slash normalization) +
- * `format_id.id`. Same scope as the v2→v1 registry: AAO catalog only.
+ * Primary lookup is keyed by `agent_url` (with trailing-slash normalization) +
+ * `format_id.id`. The inbound migration path may also use an exact bare ID
+ * when it has one unique meaning in the AAO catalog; the source owner is
+ * preserved for reverse delivery. Same scope as the v2→v1 registry: AAO catalog only.
  * Seller-specific catalogs (from a publisher's
  * `list_creative_formats`) are out of scope for the prototype — the
  * full 8.0 enablement would fetch them via an `AgentClient` injected
@@ -53,6 +55,15 @@ export interface V1FormatDefinition {
     description?: string;
     type?: string;
     accepts_parameters?: string[];
+    renders?: Array<{
+        role?: string;
+        dimensions?: {
+            width?: number;
+            height?: number;
+            [k: string]: unknown;
+        };
+        [k: string]: unknown;
+    }>;
     assets?: Array<{
         item_type?: string;
         asset_id?: string;
@@ -72,6 +83,8 @@ export interface V1FormatDefinition {
 interface CatalogIndex {
     /** Keyed by `<normalized-agent-url>::<id>` for O(1) lookup. */
     byKey: Map<string, V1FormatDefinition>;
+    /** Exact bare IDs with one AAO-published meaning; `null` marks a collision. */
+    byUniqueId: Map<string, V1FormatDefinition | null>;
     entries: V1FormatDefinition[];
 }
 /**
@@ -99,6 +112,14 @@ export declare function loadCatalog(explicitPath?: string): CatalogIndex;
  * match per the resolution order.
  */
 export declare function lookupV1Format(formatId: V1FormatId, explicitPath?: string): V1FormatDefinition | undefined;
+/**
+ * Resolve an AAO-published bare ID only when the bundled catalog gives that
+ * ID exactly one meaning. This is an inbound legacy compatibility seam for
+ * sellers that copied an AAO standard ID but incorrectly emitted their own
+ * creative-agent URL. It never rewrites the source ref, so a later downgrade
+ * returns the seller's original owner tuple. Duplicate IDs fail closed.
+ */
+export declare function lookupUniqueV1FormatById(id: string, explicitPath?: string): V1FormatDefinition | undefined;
 /** Test hook: reset the memoized catalog. */
 export declare function _resetCatalogCache(): void;
 /**

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

@@ -11,8 +11,10 @@
  * format projects to. This is the spec's resolution-order step 2 —
  * "seller-asserted on the v1 file" — applied to AAO-published v1 formats.
  *
- * Loader is keyed by `agent_url` (with trailing-slash normalization) +
- * `format_id.id`. Same scope as the v2→v1 registry: AAO catalog only.
+ * Primary lookup is keyed by `agent_url` (with trailing-slash normalization) +
+ * `format_id.id`. The inbound migration path may also use an exact bare ID
+ * when it has one unique meaning in the AAO catalog; the source owner is
+ * preserved for reverse delivery. Same scope as the v2→v1 registry: AAO catalog only.
  * Seller-specific catalogs (from a publisher's
  * `list_creative_formats`) are out of scope for the prototype — the
  * full 8.0 enablement would fetch them via an `AgentClient` injected
@@ -53,6 +55,15 @@ export interface V1FormatDefinition {
     description?: string;
     type?: string;
     accepts_parameters?: string[];
+    renders?: Array<{
+        role?: string;
+        dimensions?: {
+            width?: number;
+            height?: number;
+            [k: string]: unknown;
+        };
+        [k: string]: unknown;
+    }>;
     assets?: Array<{
         item_type?: string;
         asset_id?: string;
@@ -72,6 +83,8 @@ export interface V1FormatDefinition {
 interface CatalogIndex {
     /** Keyed by `<normalized-agent-url>::<id>` for O(1) lookup. */
     byKey: Map<string, V1FormatDefinition>;
+    /** Exact bare IDs with one AAO-published meaning; `null` marks a collision. */
+    byUniqueId: Map<string, V1FormatDefinition | null>;
     entries: V1FormatDefinition[];
 }
 /**
@@ -99,6 +112,14 @@ export declare function loadCatalog(explicitPath?: string): CatalogIndex;
  * match per the resolution order.
  */
 export declare function lookupV1Format(formatId: V1FormatId, explicitPath?: string): V1FormatDefinition | undefined;
+/**
+ * Resolve an AAO-published bare ID only when the bundled catalog gives that
+ * ID exactly one meaning. This is an inbound legacy compatibility seam for
+ * sellers that copied an AAO standard ID but incorrectly emitted their own
+ * creative-agent URL. It never rewrites the source ref, so a later downgrade
+ * returns the seller's original owner tuple. Duplicate IDs fail closed.
+ */
+export declare function lookupUniqueV1FormatById(id: string, explicitPath?: string): V1FormatDefinition | undefined;
 /** Test hook: reset the memoized catalog. */
 export declare function _resetCatalogCache(): void;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE/D;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,gHAAgH;IAChH,YAAY,CAAC,EAAE,mBAAmB,GAAG,gBAAgB,GAAG,MAAM,CAAC;IAC/D,6EAA6E;IAC7E,cAAc,CAAC,EAAE,KAAK,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtB,CAAC,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,UAAU,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACxC,CAAC,CAAC;IACH;;;;;OAKG;IACH,SAAS,CAAC,EAAE,sBAAsB,CAAC;IAEnC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,UAAU,YAAY;IACpB,+DAA+D;IAC/D,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACvC,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAmBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,YAAY,CAyC/D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAG1G;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAuBD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAI/F;AAED,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE,kBAAkB,GAAG,SAAS,CAiBhC"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../src/lib/v2/projection/catalog.ts"],"names":[],"mappings":"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"}

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

@@ -31,22 +31,32 @@ __export(catalog_exports, {
   _resetCatalogCache: () => _resetCatalogCache,
   findCatalogEntryByCanonicalAndSize: () => findCatalogEntryByCanonicalAndSize,
   loadCatalog: () => loadCatalog,
+  lookupUniqueV1FormatById: () => lookupUniqueV1FormatById,
   lookupV1Format: () => lookupV1Format,
   parseSizedIdTemplate: () => parseSizedIdTemplate
 });
 module.exports = __toCommonJS(catalog_exports);
 var import_fs = require("fs");
 var import_path = __toESM(require("path"));
-let cached = null;
+var import_constants = require('./constants.js');
+var import_resolve_agent_properties = require('../../discovery/resolve-agent-properties.js');
+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 = (0, import_resolve_agent_properties.canonicalizeAgentUrl)(u);
+  if (canonical === null) return void 0;
+  return AAO_LEGACY_AGENT_URL_ALIASES.has(canonical) ? import_constants.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] : [
     import_path.default.join(__dirname, "aao-reference-formats.json"),
     import_path.default.join(
@@ -63,15 +73,22 @@ function loadCatalog(explicitPath) {
   ];
   for (const file of candidates) {
     if ((0, import_fs.existsSync)(file)) {
+      const cached = cachedByPath.get(file);
+      if (cached) return cached;
       const raw = JSON.parse((0, import_fs.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(
@@ -80,10 +97,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) {
@@ -94,6 +116,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;
@@ -114,6 +137,7 @@ function findCatalogEntryByCanonicalAndSize(canonical, width, height, agentUrl,
   _resetCatalogCache,
   findCatalogEntryByCanonicalAndSize,
   loadCatalog,
+  lookupUniqueV1FormatById,
   lookupV1Format,
   parseSizedIdTemplate
 });

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/v2/projection/catalog.ts"],"sourcesContent":["/**\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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqBA,gBAAyC;AACzC,kBAAiB;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,YAAAA,QAAK,KAAK,WAAW,4BAA4B;AAAA,IACjD,YAAAA,QAAK;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,YAAI,sBAAW,IAAI,GAAG;AACpB,YAAM,MAAM,KAAK,UAAM,wBAAa,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":["path"]}
+{"version":3,"sources":["../../../../src/lib/v2/projection/catalog.ts"],"sourcesContent":["/**\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":["path"]}