@adcp/sdk 15.7.1 → 15.8.0

package/dist/lib/core/SingleAgentClient.mjs

@@ -159,6 +159,7 @@ import {
   projectMediaBuyCreativesForDelivery,
   projectCreativeForDelivery,
   projectSyncCreativesForDelivery,
+  projectUndeclaredFormatOptionSelectors,
   resolveCreativeFormatWireMode,
   stripLegacyCreativeIdentity
 } from "../v2/projection/creative-delivery.mjs";
@@ -168,10 +169,13 @@ import {
 import { toCanonicalOnlyResponse } from "../v2/projection/augment-response.mjs";
 import {
   legacyFormatRefsForDeclaration,
+  rememberSellerDeclaredFormatOption,
+  sellerDeclaredFormatOption,
   structuredCloneWithLegacyCreativeMetadata
 } from "../v2/projection/legacy-metadata.mjs";
 import { isProjectionProductInput } from "../v2/projection/types.mjs";
 import { canonicalize as canonicalizeJson } from "../utils/jcs.mjs";
+const toolInputSchemasByProperties = /* @__PURE__ */ new WeakMap();
 const CAPABILITY_DISCOVERY_CONTEXT = /* @__PURE__ */ Symbol("capabilityDiscoveryContext");
 function a2aUrlString(input) {
   return typeof input === "string" ? input : input instanceof URL ? input.toString() : input.url;
@@ -218,32 +222,6 @@ function selectA2AJsonRpcUrl(agentCard, protocolVersion, configuredAgentUrl) {
   }
   return resolved.toString();
 }
-function creativeSchemaSupport(value, depth = 0) {
-  if (depth > 24 || value === null || typeof value !== "object") return "unknown";
-  if (Array.isArray(value)) {
-    let legacy2 = false;
-    for (const item of value) {
-      const support = creativeSchemaSupport(item, depth + 1);
-      if (support === "canonical") return support;
-      if (support === "legacy") legacy2 = true;
-    }
-    return legacy2 ? "legacy" : "unknown";
-  }
-  const object = value;
-  const properties = object.properties;
-  if (properties !== null && typeof properties === "object" && !Array.isArray(properties)) {
-    const keys = properties;
-    if ("creative_id" in keys && "format_kind" in keys) return "canonical";
-    if ("creative_id" in keys && "format_id" in keys) return "legacy";
-  }
-  let legacy = false;
-  for (const child of Object.values(object)) {
-    const support = creativeSchemaSupport(child, depth + 1);
-    if (support === "canonical") return support;
-    if (support === "legacy") legacy = true;
-  }
-  return legacy ? "legacy" : "unknown";
-}
 function hasMediaBuyCreativeFormatData(request) {
   if (request === null || typeof request !== "object" || Array.isArray(request)) return false;
   const record = request;
@@ -1404,9 +1382,10 @@ class SingleAgentClient {
       }
     }
   }
-  rememberCanonicalProductRoutes(products, account, authoritativeProducts = products) {
-    this.invalidateCanonicalProductRoutes(authoritativeProducts, account);
+  rememberCanonicalProductRoutes(products, account, authoritativeProducts) {
+    this.invalidateCanonicalProductRoutes(authoritativeProducts ?? products, account);
     const accountScope = this.canonicalAccountScope(account);
+    const declaredOptions = authoritativeProducts ? this.sellerDeclaredFormatOptions(authoritativeProducts) : void 0;
     for (const value of products) {
       if (!value || typeof value !== "object" || Array.isArray(value)) continue;
       const product = value;
@@ -1422,16 +1401,78 @@ class SingleAgentClient {
         } : { scope: "product", format_option_id: option.format_option_id };
         const refs = legacyFormatRefsForDeclaration(option);
         if (refs.length === 0) continue;
+        const declared = declaredOptions ? declaredOptions.get(product.product_id)?.some((declaredRef) => this.sameCanonicalOptionRef(declaredRef, ref)) : sellerDeclaredFormatOption(option);
+        if (declared !== void 0) rememberSellerDeclaredFormatOption(option, declared);
         this.rememberCanonicalLegacyRoute(this.canonicalLegacyRouteKey(account, product.product_id, ref), {
           kind: "product",
           accountScope,
           productId: product.product_id,
           optionRef: ref,
-          refs
+          refs,
+          ...declared === false ? {
+            undeclaredSelector: {
+              format_kind: typeof option.format_kind === "string" ? option.format_kind : "",
+              ...option.params !== void 0 && { params: structuredClone(option.params) },
+              ...(typeof option.format_kind !== "string" || option.format_kind === "custom" || option.format_shape !== void 0 || option.format_schema !== void 0) && { unrepresentable: true }
+            }
+          } : {}
         });
       }
     }
   }
+  /**
+   * Option refs each product declared in the seller's own response. A product
+   * absent from the response yields no entry, so its options are treated as
+   * declared rather than guessed undeclared.
+   */
+  sellerDeclaredFormatOptions(authoritativeProducts) {
+    const declared = /* @__PURE__ */ new Map();
+    for (const value of authoritativeProducts) {
+      if (!value || typeof value !== "object" || Array.isArray(value)) continue;
+      const product = value;
+      if (typeof product.product_id !== "string") continue;
+      const refs = [];
+      for (const optionValue of Array.isArray(product.format_options) ? product.format_options : []) {
+        if (!optionValue || typeof optionValue !== "object" || Array.isArray(optionValue)) continue;
+        const option = optionValue;
+        if (typeof option.format_option_id !== "string") continue;
+        refs.push(
+          typeof option.publisher_domain === "string" ? {
+            scope: "publisher",
+            publisher_domain: option.publisher_domain,
+            format_option_id: option.format_option_id
+          } : { scope: "product", format_option_id: option.format_option_id }
+        );
+      }
+      declared.set(product.product_id, refs);
+    }
+    return declared;
+  }
+  /**
+   * The direct selector for an option this client derived from the seller's
+   * legacy `format_ids`. Without a product id, every remembered route for the
+   * option must agree that the seller did not declare it.
+   */
+  undeclaredFormatOptionSelector(account, ref, productId) {
+    if (productId !== void 0) {
+      const route = this.routeForOption(account, productId, ref);
+      return route?.kind === "product" ? route.undeclaredSelector : void 0;
+    }
+    const accountScope = this.canonicalAccountScope(account);
+    const routes = [...this.canonicalLegacyRoutes.values()].filter(
+      (route) => route.kind === "product" && (route.accountScope === accountScope || route.accountScope === "none") && this.sameCanonicalOptionRef(route.optionRef, ref)
+    );
+    if (routes.length === 0 || routes.some((route) => route.undeclaredSelector === void 0)) return void 0;
+    return routes[0].undeclaredSelector;
+  }
+  projectUndeclaredFormatOptions(request, operation, wireMode, account) {
+    if (wireMode !== "canonical") return request;
+    return projectUndeclaredFormatOptionSelectors(
+      request,
+      operation,
+      (ref, productId) => this.undeclaredFormatOptionSelector(account, ref, productId)
+    );
+  }
   rememberCanonicalProductRoutesForCompletion(taskType, data, legacyFormatConverter, account) {
     if (taskType !== "get_products" || !data || typeof data !== "object" || Array.isArray(data)) return;
     const authoritativeProducts = Array.isArray(data.products) ? data.products : [];
@@ -4560,7 +4601,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
         if (hit) {
           throwIfAborted(effectiveOptions.signal);
           if (hit.success && hit.status === "completed")
-            this.rememberCanonicalProductRoutes(hit.data.products ?? [], account, hit.data.products ?? []);
+            this.rememberCanonicalProductRoutes(hit.data.products ?? [], account);
           return attachMatch(
             await this.applyProductPropertyPolicy(
               hit,
@@ -4604,11 +4645,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
               [SKIP_PRODUCT_CACHE]: true
             });
           }
-          this.rememberCanonicalProductRoutes(
-            cachedResult.data.products ?? [],
-            account,
-            cachedResult.data.products ?? []
-          );
+          this.rememberCanonicalProductRoutes(cachedResult.data.products ?? [], account);
         }
         if (cachedResult.submitted) {
           const submitted = cachedResult.submitted;
@@ -4764,12 +4801,17 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     const result = await this.executeAndHandle(
       "create_media_buy",
       "onCreateMediaBuyStatusChange",
-      projectMediaBuyCreativesForDelivery(
-        wireParams,
-        wireMode,
+      this.projectUndeclaredFormatOptions(
+        projectMediaBuyCreativesForDelivery(
+          wireParams,
+          wireMode,
+          "create_media_buy",
+          effectiveLegacyFormatConverter,
+          effectiveCanonicalFormatLegacyResolver
+        ),
         "create_media_buy",
-        effectiveLegacyFormatConverter,
-        effectiveCanonicalFormatLegacyResolver
+        wireMode,
+        wireParams.account
       ),
       inputHandler,
       taskOptions,
@@ -4845,12 +4887,17 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     const result = await this.executeAndHandle(
       "update_media_buy",
       "onUpdateMediaBuyStatusChange",
-      projectMediaBuyCreativesForDelivery(
-        params,
-        wireMode,
+      this.projectUndeclaredFormatOptions(
+        projectMediaBuyCreativesForDelivery(
+          params,
+          wireMode,
+          "update_media_buy",
+          effectiveLegacyFormatConverter,
+          effectiveCanonicalFormatLegacyResolver
+        ),
         "update_media_buy",
-        effectiveLegacyFormatConverter,
-        effectiveCanonicalFormatLegacyResolver
+        wireMode,
+        params.account
       ),
       inputHandler,
       taskOptions,
@@ -4936,12 +4983,17 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     const assignmentPackageContainers = Array.isArray(params.assignments) ? params.assignments.flatMap(
       (assignment) => typeof assignment.package_id === "string" && !configuredPackageIds.has(assignment.package_id) ? [{ package_id: assignment.package_id }] : []
     ) : [];
-    const wireParams = projectSyncCreativesForDelivery(
-      params,
-      [...configuredSelectorContainers, ...assignmentPackageContainers],
+    const wireParams = this.projectUndeclaredFormatOptions(
+      projectSyncCreativesForDelivery(
+        params,
+        [...configuredSelectorContainers, ...assignmentPackageContainers],
+        wireMode,
+        effectiveLegacyFormatConverter,
+        effectiveCanonicalFormatLegacyResolver
+      ),
+      "sync_creatives",
       wireMode,
-      effectiveLegacyFormatConverter,
-      effectiveCanonicalFormatLegacyResolver
+      params.account
     );
     return this.executeAndHandle(
       "sync_creatives",
@@ -4980,6 +5032,9 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
    * `CreativeFormatCapabilityError`, just as they do during a write.
    */
   async resolveCreativeFormatWireMode(taskType, options) {
+    return this.resolveCreativeWireMode(taskType, options, true);
+  }
+  async resolveCreativeWireMode(taskType, options, canRediscover) {
     const discoveryContext = {};
     const capabilities = await this.getCapabilities({
       ...options,
@@ -4989,7 +5044,10 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     const toolSchemas = discoveryContext.toolSchemas ?? (usesScopedFetch ? void 0 : this.cachedToolSchemas);
     const wireRelease = this.config.wireAdcpVersion ?? this.resolvedAdcpVersion;
     const declared = resolveCreativeFormatWireMode(capabilities, wireRelease);
-    const schema = creativeSchemaSupport(toolSchemas?.get(taskType));
+    const document = toolSchemas && toolInputSchemasByProperties.get(toolSchemas)?.get(taskType);
+    const { creativeSchemaSupport } = await import("./creative-schema-support.mjs");
+    throwIfAborted(options?.signal);
+    const schema = creativeSchemaSupport(document ?? { properties: toolSchemas?.get(taskType) });
     if (declared !== "unknown" && schema !== "unknown" && declared !== schema) {
       throw new CreativeFormatCapabilityError(
         `Seller capability and ${taskType} input schema disagree about canonical creative support`
@@ -4999,6 +5057,10 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     const release = /^v?(\d+)\.(\d+)(?:\.|-|$)/.exec(wireRelease.trim());
     const canonicalRequiredByBuyerPin = release !== null && (Number(release[1]) > 3 || Number(release[1]) === 3 && Number(release[2]) >= 2);
     if (resolved === "unknown" && canonicalRequiredByBuyerPin) {
+      if (canRediscover && !usesScopedFetch && this.normalizedAgent.protocol === "mcp" && this.capabilitiesFromSharedCache && toolSchemas?.has(taskType) && !toolInputSchemasByProperties.has(toolSchemas)) {
+        await this.invalidateDiscoveryCache(options);
+        return this.resolveCreativeWireMode(taskType, options, false);
+      }
       throw new CreativeFormatCapabilityError(
         `Cannot prove which AdCP release the seller serves for ${taskType}; a 3.2+ client will not guess a legacy creative wire shape`
       );
@@ -6658,11 +6720,20 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     if (toolSchemas !== void 0 && !isToolSchemaRecord(toolSchemas)) {
       return void 0;
     }
+    if (entry.toolInputSchemas !== void 0 && (!toolSchemas || !isToolSchemaRecord(entry.toolInputSchemas))) {
+      return void 0;
+    }
     let installed;
     let schemas;
     try {
       installed = structuredClone(capabilities);
       schemas = toolSchemas ? new Map(Object.entries(toolSchemas).map(([tool, properties]) => [tool, structuredClone(properties)])) : void 0;
+      if (schemas && entry.toolInputSchemas) {
+        toolInputSchemasByProperties.set(
+          schemas,
+          new Map(Object.entries(entry.toolInputSchemas).map(([tool, schema]) => [tool, structuredClone(schema)]))
+        );
+      }
     } catch {
       return void 0;
     }
@@ -6683,9 +6754,13 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
       name: t.name,
       description: t.description
     }));
+    const discoveredInputSchemas = new Map(
+      agentInfo.tools.filter((t) => t.inputSchema).map((t) => [t.name, t.inputSchema])
+    );
     const discoveredToolSchemas = new Map(
-      agentInfo.tools.filter((t) => t.inputSchema?.properties).map((t) => [t.name, t.inputSchema.properties])
+      [...discoveredInputSchemas].map(([name, schema]) => [name, schema.properties ?? {}])
     );
+    toolInputSchemasByProperties.set(discoveredToolSchemas, discoveredInputSchemas);
     if (discoveryContext) discoveryContext.toolSchemas = discoveredToolSchemas;
     if (!usesScopedFetch && !superseded()) this.cachedToolSchemas = discoveredToolSchemas;
     const advertisesCapabilitiesTool = tools.some((t) => t.name === "get_adcp_capabilities");
@@ -6728,7 +6803,8 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
                 options,
                 {
                   capabilities: structuredClone(capabilities2),
-                  toolSchemas: Object.fromEntries(discoveredToolSchemas)
+                  toolSchemas: Object.fromEntries(discoveredToolSchemas),
+                  toolInputSchemas: Object.fromEntries(discoveredInputSchemas)
                 },
                 false,
                 startedAtEpoch
@@ -7126,7 +7202,11 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     const key = this.sharedDiscoveryKey(options);
     if (!key) return void 0;
     if (patch.endpoint && !this.isDiscoverableEndpoint(patch.endpoint.agentUri)) {
-      patch = { capabilities: patch.capabilities, toolSchemas: patch.toolSchemas };
+      patch = {
+        capabilities: patch.capabilities,
+        toolSchemas: patch.toolSchemas,
+        toolInputSchemas: patch.toolInputSchemas
+      };
       if (!patch.capabilities && !patch.toolSchemas) return void 0;
     }
     const config = this.config.discoveryCache;
@@ -7154,10 +7234,17 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
           const entry = {
             ...existing?.capabilities && { capabilities: existing.capabilities },
             ...existing?.toolSchemas && { toolSchemas: existing.toolSchemas },
+            // Endpoint-only writes retain schema documents. Fresh tool evidence
+            // replaces them together, including clearing older full documents
+            // when the caller supplies only a property map.
+            ...patch.toolSchemas === void 0 && existing?.toolInputSchemas && {
+              toolInputSchemas: existing.toolInputSchemas
+            },
             ...existing?.endpoint && { endpoint: existing.endpoint },
             ...patch.endpoint && { endpoint: { ...patch.endpoint, observedAt: now } },
             ...patch.capabilities && { capabilities: patch.capabilities },
             ...patch.toolSchemas && { toolSchemas: patch.toolSchemas },
+            ...patch.toolInputSchemas && { toolInputSchemas: patch.toolInputSchemas },
             observedAt: restartsClock || !existing ? now : Math.min(existing.observedAt, now),
             expiresAt: restartsClock || !existing ? now + ttl : Math.min(existing.expiresAt, now + ttl)
           };

package/dist/lib/core/agent-discovery-cache.d.mts

@@ -20,6 +20,8 @@ export interface AgentDiscoveryEntry {
     capabilities?: AdcpCapabilities;
     /** `tools/list` input-schema properties keyed by tool name. */
     toolSchemas?: Record<string, Record<string, unknown>>;
+    /** Complete listed input schemas, including local reference targets; absent in older entries. Backends must allow space for both these documents and their property maps. */
+    toolInputSchemas?: Record<string, Record<string, unknown>>;
     /** Epoch milliseconds when this evidence was observed. */
     observedAt: number;
     /** Epoch milliseconds after which the entry must not be used. Enforced by the SDK on read. */

package/dist/lib/core/agent-discovery-cache.d.ts

@@ -20,6 +20,8 @@ export interface AgentDiscoveryEntry {
     capabilities?: AdcpCapabilities;
     /** `tools/list` input-schema properties keyed by tool name. */
     toolSchemas?: Record<string, Record<string, unknown>>;
+    /** Complete listed input schemas, including local reference targets; absent in older entries. Backends must allow space for both these documents and their property maps. */
+    toolInputSchemas?: Record<string, Record<string, unknown>>;
     /** Epoch milliseconds when this evidence was observed. */
     observedAt: number;
     /** Epoch milliseconds after which the entry must not be used. Enforced by the SDK on read. */

package/dist/lib/core/creative-schema-support.d.mts

@@ -0,0 +1,3 @@
+import type { CreativeFormatWireMode } from '../v2/projection/creative-delivery.mjs';
+/** Inspect reachable input schemas without fetching references or treating unused definitions as evidence. */
+export declare function creativeSchemaSupport(inputSchema: unknown): CreativeFormatWireMode;

package/dist/lib/core/creative-schema-support.d.ts

@@ -0,0 +1,3 @@
+import type { CreativeFormatWireMode } from '../v2/projection/creative-delivery';
+/** Inspect reachable input schemas without fetching references or treating unused definitions as evidence. */
+export declare function creativeSchemaSupport(inputSchema: unknown): CreativeFormatWireMode;

package/dist/lib/core/creative-schema-support.js

@@ -0,0 +1,113 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var creative_schema_support_exports = {};
+__export(creative_schema_support_exports, {
+  creativeSchemaSupport: () => creativeSchemaSupport
+});
+module.exports = __toCommonJS(creative_schema_support_exports);
+function creativeSchemaSupport(inputSchema) {
+  const visited = /* @__PURE__ */ new WeakSet();
+  let remaining = 1e4;
+  let truncated = false;
+  function resolvePointer(reference, root) {
+    if (!reference.startsWith("#")) return void 0;
+    let pointer;
+    try {
+      pointer = decodeURIComponent(reference.slice(1));
+    } catch {
+      return void 0;
+    }
+    if (pointer === "") return { value: root, root };
+    if (!pointer.startsWith("/") || /~(?![01])/.test(pointer)) return void 0;
+    let value = root;
+    for (const token of pointer.slice(1).split("/")) {
+      const key = token.replace(/~1/g, "/").replace(/~0/g, "~");
+      if (value === null || typeof value !== "object" || !Object.hasOwn(value, key)) return void 0;
+      const resource = value;
+      if (typeof resource.$id === "string" && resource.$id !== "" && !resource.$id.startsWith("#")) root = resource;
+      value = value[key];
+    }
+    return { value, root };
+  }
+  function visit(value, root, depth) {
+    if (value === null || typeof value !== "object" || visited.has(value)) {
+      return "unknown";
+    }
+    if (--remaining < 0 || depth > 64) {
+      truncated = true;
+      return "unknown";
+    }
+    visited.add(value);
+    let legacy = false;
+    const inspect = (child) => {
+      const mode2 = visit(child, root, depth + 1);
+      if (mode2 === "legacy") legacy = true;
+      return mode2 === "canonical";
+    };
+    if (Array.isArray(value)) {
+      for (const child of value) if (inspect(child)) return "canonical";
+      return legacy ? "legacy" : "unknown";
+    }
+    const schema = value;
+    if (typeof schema.$id === "string" && schema.$id !== "" && !schema.$id.startsWith("#")) root = schema;
+    const properties = schema.properties;
+    if (properties !== null && typeof properties === "object" && !Array.isArray(properties)) {
+      const fields = properties;
+      if (Object.hasOwn(fields, "creative_id") && fields.creative_id !== false) {
+        if (Object.hasOwn(fields, "format_kind") && fields.format_kind !== false) return "canonical";
+        if (Object.hasOwn(fields, "format_id") && fields.format_id !== false) legacy = true;
+      }
+    }
+    if (typeof schema.$ref === "string") {
+      const target = resolvePointer(schema.$ref, root);
+      if (target) {
+        const mode2 = visit(target.value, target.root, depth + 1);
+        if (mode2 === "canonical") return mode2;
+        if (mode2 === "legacy") legacy = true;
+      }
+    }
+    for (const keyword of ["properties", "patternProperties", "dependentSchemas"]) {
+      const children = schema[keyword];
+      if (children !== null && typeof children === "object" && !Array.isArray(children)) {
+        for (const child of Object.values(children)) if (inspect(child)) return "canonical";
+      }
+    }
+    for (const keyword of [
+      "items",
+      "prefixItems",
+      "contains",
+      "additionalItems",
+      "additionalProperties",
+      "unevaluatedItems",
+      "unevaluatedProperties",
+      "allOf",
+      "anyOf",
+      "oneOf"
+    ]) {
+      if (inspect(schema[keyword])) return "canonical";
+    }
+    return legacy ? "legacy" : "unknown";
+  }
+  const mode = visit(inputSchema, inputSchema, 0);
+  return truncated ? "unknown" : mode;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  creativeSchemaSupport
+});

package/dist/lib/core/creative-schema-support.mjs

@@ -0,0 +1,89 @@
+function creativeSchemaSupport(inputSchema) {
+  const visited = /* @__PURE__ */ new WeakSet();
+  let remaining = 1e4;
+  let truncated = false;
+  function resolvePointer(reference, root) {
+    if (!reference.startsWith("#")) return void 0;
+    let pointer;
+    try {
+      pointer = decodeURIComponent(reference.slice(1));
+    } catch {
+      return void 0;
+    }
+    if (pointer === "") return { value: root, root };
+    if (!pointer.startsWith("/") || /~(?![01])/.test(pointer)) return void 0;
+    let value = root;
+    for (const token of pointer.slice(1).split("/")) {
+      const key = token.replace(/~1/g, "/").replace(/~0/g, "~");
+      if (value === null || typeof value !== "object" || !Object.hasOwn(value, key)) return void 0;
+      const resource = value;
+      if (typeof resource.$id === "string" && resource.$id !== "" && !resource.$id.startsWith("#")) root = resource;
+      value = value[key];
+    }
+    return { value, root };
+  }
+  function visit(value, root, depth) {
+    if (value === null || typeof value !== "object" || visited.has(value)) {
+      return "unknown";
+    }
+    if (--remaining < 0 || depth > 64) {
+      truncated = true;
+      return "unknown";
+    }
+    visited.add(value);
+    let legacy = false;
+    const inspect = (child) => {
+      const mode2 = visit(child, root, depth + 1);
+      if (mode2 === "legacy") legacy = true;
+      return mode2 === "canonical";
+    };
+    if (Array.isArray(value)) {
+      for (const child of value) if (inspect(child)) return "canonical";
+      return legacy ? "legacy" : "unknown";
+    }
+    const schema = value;
+    if (typeof schema.$id === "string" && schema.$id !== "" && !schema.$id.startsWith("#")) root = schema;
+    const properties = schema.properties;
+    if (properties !== null && typeof properties === "object" && !Array.isArray(properties)) {
+      const fields = properties;
+      if (Object.hasOwn(fields, "creative_id") && fields.creative_id !== false) {
+        if (Object.hasOwn(fields, "format_kind") && fields.format_kind !== false) return "canonical";
+        if (Object.hasOwn(fields, "format_id") && fields.format_id !== false) legacy = true;
+      }
+    }
+    if (typeof schema.$ref === "string") {
+      const target = resolvePointer(schema.$ref, root);
+      if (target) {
+        const mode2 = visit(target.value, target.root, depth + 1);
+        if (mode2 === "canonical") return mode2;
+        if (mode2 === "legacy") legacy = true;
+      }
+    }
+    for (const keyword of ["properties", "patternProperties", "dependentSchemas"]) {
+      const children = schema[keyword];
+      if (children !== null && typeof children === "object" && !Array.isArray(children)) {
+        for (const child of Object.values(children)) if (inspect(child)) return "canonical";
+      }
+    }
+    for (const keyword of [
+      "items",
+      "prefixItems",
+      "contains",
+      "additionalItems",
+      "additionalProperties",
+      "unevaluatedItems",
+      "unevaluatedProperties",
+      "allOf",
+      "anyOf",
+      "oneOf"
+    ]) {
+      if (inspect(schema[keyword])) return "canonical";
+    }
+    return legacy ? "legacy" : "unknown";
+  }
+  const mode = visit(inputSchema, inputSchema, 0);
+  return truncated ? "unknown" : mode;
+}
+export {
+  creativeSchemaSupport
+};

package/dist/lib/core/product-cache.js

@@ -23,6 +23,7 @@ __export(product_cache_exports, {
 });
 module.exports = __toCommonJS(product_cache_exports);
 var import_account_key = require('./account-key.js');
+var import_legacy_metadata = require('../v2/projection/legacy-metadata.js');
 function stable(value) {
   if (Array.isArray(value)) return value.map(stable);
   if (value && typeof value === "object")
@@ -69,7 +70,7 @@ class ProductCache {
     if (!allowExpired && Date.now() - entry.storedAt >= ttl) return void 0;
     return {
       ...entry.result,
-      data: structuredClone(entry.result.data),
+      data: (0, import_legacy_metadata.structuredCloneWithLegacyCreativeMetadata)(entry.result.data),
       metadata: structuredClone(entry.result.metadata),
       ...entry.result.debug_logs && { debug_logs: structuredClone(entry.result.debug_logs) }
     };
@@ -107,14 +108,14 @@ class ProductCache {
       if (!old || old.scope !== data.cache_scope || !oldData || data.wholesale_feed_version !== oldData.wholesale_feed_version || data.pricing_version !== void 0 && data.pricing_version !== oldData.pricing_version)
         return result;
       if (params.if_wholesale_feed_version !== void 0 || params.if_pricing_version !== void 0) return result;
-      completed = { ...result, data: structuredClone(oldData) };
+      completed = { ...result, data: (0, import_legacy_metadata.structuredCloneWithLegacyCreativeMetadata)(oldData) };
     } else if (!Array.isArray(data.products)) return result;
     if (!this.entries.has(key) && this.entries.size >= (this.options.maxEntries ?? 1e3))
       this.entries.delete(this.entries.keys().next().value);
     this.entries.set(key, {
       result: {
         ...completed,
-        data: structuredClone(completed.data),
+        data: (0, import_legacy_metadata.structuredCloneWithLegacyCreativeMetadata)(completed.data),
         metadata: structuredClone(completed.metadata),
         ...completed.debug_logs && { debug_logs: structuredClone(completed.debug_logs) }
       },

package/dist/lib/core/product-cache.mjs

@@ -1,4 +1,5 @@
 import { accountReferenceKey } from "./account-key.mjs";
+import { structuredCloneWithLegacyCreativeMetadata } from "../v2/projection/legacy-metadata.mjs";
 function stable(value) {
   if (Array.isArray(value)) return value.map(stable);
   if (value && typeof value === "object")
@@ -45,7 +46,7 @@ class ProductCache {
     if (!allowExpired && Date.now() - entry.storedAt >= ttl) return void 0;
     return {
       ...entry.result,
-      data: structuredClone(entry.result.data),
+      data: structuredCloneWithLegacyCreativeMetadata(entry.result.data),
       metadata: structuredClone(entry.result.metadata),
       ...entry.result.debug_logs && { debug_logs: structuredClone(entry.result.debug_logs) }
     };
@@ -83,14 +84,14 @@ class ProductCache {
       if (!old || old.scope !== data.cache_scope || !oldData || data.wholesale_feed_version !== oldData.wholesale_feed_version || data.pricing_version !== void 0 && data.pricing_version !== oldData.pricing_version)
         return result;
       if (params.if_wholesale_feed_version !== void 0 || params.if_pricing_version !== void 0) return result;
-      completed = { ...result, data: structuredClone(oldData) };
+      completed = { ...result, data: structuredCloneWithLegacyCreativeMetadata(oldData) };
     } else if (!Array.isArray(data.products)) return result;
     if (!this.entries.has(key) && this.entries.size >= (this.options.maxEntries ?? 1e3))
       this.entries.delete(this.entries.keys().next().value);
     this.entries.set(key, {
       result: {
         ...completed,
-        data: structuredClone(completed.data),
+        data: structuredCloneWithLegacyCreativeMetadata(completed.data),
         metadata: structuredClone(completed.metadata),
         ...completed.debug_logs && { debug_logs: structuredClone(completed.debug_logs) }
       },