@adcp/sdk 15.7.1 → 15.8.1

package/dist/lib/core/SingleAgentClient.d.mts

@@ -595,6 +595,19 @@ export declare class SingleAgentClient {
     private rememberCanonicalLegacyRoute;
     private invalidateCanonicalProductRoutes;
     private rememberCanonicalProductRoutes;
+    /**
+     * 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.
+     */
+    private sellerDeclaredFormatOptions;
+    /**
+     * 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.
+     */
+    private undeclaredFormatOptionSelector;
+    private projectUndeclaredFormatOptions;
     private rememberCanonicalProductRoutesForCompletion;
     private routeForOption;
     private routeForPackage;
@@ -995,6 +1008,7 @@ export declare class SingleAgentClient {
      * `CreativeFormatCapabilityError`, just as they do during a write.
      */
     resolveCreativeFormatWireMode(taskType: 'sync_creatives' | 'create_media_buy' | 'update_media_buy', options?: ReadRequestOptions): Promise<CreativeFormatWireMode>;
+    private resolveCreativeWireMode;
     /** Validate malformed creative payloads before capability discovery can perform I/O. */
     private validateBeforeCreativeCapabilityProbe;
     /**

package/dist/lib/core/SingleAgentClient.d.ts

@@ -595,6 +595,19 @@ export declare class SingleAgentClient {
     private rememberCanonicalLegacyRoute;
     private invalidateCanonicalProductRoutes;
     private rememberCanonicalProductRoutes;
+    /**
+     * 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.
+     */
+    private sellerDeclaredFormatOptions;
+    /**
+     * 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.
+     */
+    private undeclaredFormatOptionSelector;
+    private projectUndeclaredFormatOptions;
     private rememberCanonicalProductRoutesForCompletion;
     private routeForOption;
     private routeForPackage;
@@ -995,6 +1008,7 @@ export declare class SingleAgentClient {
      * `CreativeFormatCapabilityError`, just as they do during a write.
      */
     resolveCreativeFormatWireMode(taskType: 'sync_creatives' | 'create_media_buy' | 'update_media_buy', options?: ReadRequestOptions): Promise<CreativeFormatWireMode>;
+    private resolveCreativeWireMode;
     /** Validate malformed creative payloads before capability discovery can perform I/O. */
     private validateBeforeCreativeCapabilityProbe;
     /**

package/dist/lib/core/SingleAgentClient.js

@@ -97,6 +97,7 @@ function presentedStaticTransportCredential(authToken, headers, authProvider) {
     return normalized === "authorization" || normalized === "x-adcp-auth";
   });
 }
+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;
@@ -143,32 +144,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;
@@ -1329,9 +1304,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;
@@ -1347,16 +1323,78 @@ class SingleAgentClient {
         } : { scope: "product", format_option_id: option.format_option_id };
         const refs = (0, import_legacy_metadata.legacyFormatRefsForDeclaration)(option);
         if (refs.length === 0) continue;
+        const declared = declaredOptions ? declaredOptions.get(product.product_id)?.some((declaredRef) => this.sameCanonicalOptionRef(declaredRef, ref)) : (0, import_legacy_metadata.sellerDeclaredFormatOption)(option);
+        if (declared !== void 0) (0, import_legacy_metadata.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 (0, import_creative_delivery.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 : [];
@@ -4485,7 +4523,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
         if (hit) {
           (0, import_abort2.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 (0, import_match.attachMatch)(
             await this.applyProductPropertyPolicy(
               hit,
@@ -4529,11 +4567,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;
@@ -4689,12 +4723,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",
-      (0, import_creative_delivery.projectMediaBuyCreativesForDelivery)(
-        wireParams,
-        wireMode,
+      this.projectUndeclaredFormatOptions(
+        (0, import_creative_delivery.projectMediaBuyCreativesForDelivery)(
+          wireParams,
+          wireMode,
+          "create_media_buy",
+          effectiveLegacyFormatConverter,
+          effectiveCanonicalFormatLegacyResolver
+        ),
         "create_media_buy",
-        effectiveLegacyFormatConverter,
-        effectiveCanonicalFormatLegacyResolver
+        wireMode,
+        wireParams.account
       ),
       inputHandler,
       taskOptions,
@@ -4770,12 +4809,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",
-      (0, import_creative_delivery.projectMediaBuyCreativesForDelivery)(
-        params,
-        wireMode,
+      this.projectUndeclaredFormatOptions(
+        (0, import_creative_delivery.projectMediaBuyCreativesForDelivery)(
+          params,
+          wireMode,
+          "update_media_buy",
+          effectiveLegacyFormatConverter,
+          effectiveCanonicalFormatLegacyResolver
+        ),
         "update_media_buy",
-        effectiveLegacyFormatConverter,
-        effectiveCanonicalFormatLegacyResolver
+        wireMode,
+        params.account
       ),
       inputHandler,
       taskOptions,
@@ -4861,12 +4905,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 = (0, import_creative_delivery.projectSyncCreativesForDelivery)(
-      params,
-      [...configuredSelectorContainers, ...assignmentPackageContainers],
+    const wireParams = this.projectUndeclaredFormatOptions(
+      (0, import_creative_delivery.projectSyncCreativesForDelivery)(
+        params,
+        [...configuredSelectorContainers, ...assignmentPackageContainers],
+        wireMode,
+        effectiveLegacyFormatConverter,
+        effectiveCanonicalFormatLegacyResolver
+      ),
+      "sync_creatives",
       wireMode,
-      effectiveLegacyFormatConverter,
-      effectiveCanonicalFormatLegacyResolver
+      params.account
     );
     return this.executeAndHandle(
       "sync_creatives",
@@ -4905,6 +4954,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,
@@ -4914,7 +4966,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 = (0, import_creative_delivery.resolveCreativeFormatWireMode)(capabilities, wireRelease);
-    const schema = creativeSchemaSupport(toolSchemas?.get(taskType));
+    const document = toolSchemas && toolInputSchemasByProperties.get(toolSchemas)?.get(taskType);
+    const { creativeSchemaSupport } = await import("./creative-schema-support.js");
+    (0, import_abort2.throwIfAborted)(options?.signal);
+    const schema = creativeSchemaSupport(document ?? { properties: toolSchemas?.get(taskType) });
     if (declared !== "unknown" && schema !== "unknown" && declared !== schema) {
       throw new import_creative_delivery.CreativeFormatCapabilityError(
         `Seller capability and ${taskType} input schema disagree about canonical creative support`
@@ -4924,6 +4979,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 import_creative_delivery.CreativeFormatCapabilityError(
         `Cannot prove which AdCP release the seller serves for ${taskType}; a 3.2+ client will not guess a legacy creative wire shape`
       );
@@ -6583,11 +6642,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;
     }
@@ -6608,9 +6676,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");
@@ -6653,7 +6725,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
@@ -7051,7 +7124,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;
@@ -7079,10 +7156,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)
           };