@adcp/sdk 14.4.0 → 15.2.0

package/dist/lib/canonical-references/index.mjs

@@ -18,6 +18,18 @@ import {
 } from "../v2/format-schema/sandbox-refs.mjs";
 import { findUnsafeRegexPattern, unsafeRegexDetails } from "../v2/format-schema/regex-safety.mjs";
 import { rejectDuplicateJsonKeys } from "../signing/agent-resolver/strict-json.mjs";
+class CanonicalDocumentReadError extends Error {
+  constructor(code) {
+    super(`Canonical document read: ${code}`);
+    this.code = code;
+    this.name = "CanonicalDocumentReadError";
+    Object.defineProperty(this, /* @__PURE__ */ Symbol.for("adcp.canonicalDocumentReadError"), { value: true });
+  }
+  code;
+}
+function isCanonicalDocumentReadError(error) {
+  return !!error && typeof error === "object" && error[/* @__PURE__ */ Symbol.for("adcp.canonicalDocumentReadError")] === true;
+}
 const DEFAULT_TIMEOUT_MS = 5e3;
 const DEFAULT_MAX_BODY_BYTES = 1024 * 1024;
 const DEFAULT_MAX_TOTAL_REF_BYTES = 8 * 1024 * 1024;
@@ -123,10 +135,13 @@ function exceedsJsonDocumentDepth(value) {
   return false;
 }
 function createCanonicalReferenceResolver(defaults = {}) {
+  if (defaults.documentReader && (!Number.isSafeInteger(defaults.timeoutMs ?? DEFAULT_TIMEOUT_MS) || (defaults.timeoutMs ?? DEFAULT_TIMEOUT_MS) < 1 || (defaults.timeoutMs ?? DEFAULT_TIMEOUT_MS) > 6e4 || !Number.isSafeInteger(defaults.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES) || (defaults.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES) < 1 || (defaults.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES) > 8 * 1024 * 1024))
+    throw new RangeError("Private canonical document transport limits are invalid");
   const cache = defaults.cache ?? createCanonicalReferenceCache();
   const merge = (options = {}) => ({
     ...defaults,
     ...options,
+    documentReader: defaults.documentReader ?? options.documentReader,
     cache
   });
   return {
@@ -179,7 +194,7 @@ async function fetchJsonReference(ref, options) {
   const kind = options.kind ?? "generic";
   const valid = validateRef(ref, kind, options);
   if (!valid.ok) return valid.result;
-  const cache = options.cache;
+  const cache = options.documentReader ? void 0 : options.cache;
   const cacheKey = canonicalReferenceCacheKey(ref, options);
   const cached = cache?.get(cacheKey);
   if (cached) {
@@ -197,15 +212,70 @@ async function fetchJsonReference(ref, options) {
   }
   let response;
   try {
-    response = await ssrfSafeFetch(ref.uri, {
-      method: "GET",
-      headers: { accept: "application/json, application/schema+json" },
-      timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
-      maxBodyBytes: options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES,
-      allowPrivateIp: options.allowPrivateNetwork === true,
-      signal: options.signal
-    });
+    if (options.documentReader) {
+      const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+      const maxBytes = options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES;
+      if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 6e4 || !Number.isSafeInteger(maxBytes) || maxBytes < 1 || maxBytes > 8 * 1024 * 1024)
+        throw new CanonicalDocumentReadError("invalid_options");
+      const controller = new AbortController();
+      const onAbort = () => controller.abort(new CanonicalDocumentReadError("aborted"));
+      options.signal?.addEventListener("abort", onAbort, { once: true });
+      if (options.signal?.aborted) onAbort();
+      let abortListener;
+      const timer = setTimeout(() => controller.abort(new CanonicalDocumentReadError("network_error")), timeoutMs);
+      try {
+        controller.signal.throwIfAborted();
+        const read = await Promise.race([
+          options.documentReader.read({ uri: ref.uri, maxBytes, signal: controller.signal }),
+          new Promise((_, reject) => {
+            abortListener = () => reject(controller.signal.reason);
+            controller.signal.addEventListener("abort", abortListener, { once: true });
+            if (controller.signal.aborted) abortListener();
+          })
+        ]);
+        controller.signal.throwIfAborted();
+        if (!(read?.body instanceof Uint8Array) || read.body.byteLength > maxBytes)
+          throw new CanonicalDocumentReadError("body_too_large");
+        response = {
+          status: 200,
+          body: Uint8Array.from(read.body),
+          headers: { "content-type": read.contentType ?? "" }
+        };
+      } finally {
+        clearTimeout(timer);
+        options.signal?.removeEventListener("abort", onAbort);
+        if (abortListener) controller.signal.removeEventListener("abort", abortListener);
+      }
+    } else {
+      response = await ssrfSafeFetch(ref.uri, {
+        method: "GET",
+        headers: { accept: "application/json, application/schema+json" },
+        timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+        maxBodyBytes: options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES,
+        allowPrivateIp: options.allowPrivateNetwork === true,
+        signal: options.signal
+      });
+    }
   } catch (err) {
+    if (isCanonicalDocumentReadError(err)) {
+      const code = [
+        "access_denied",
+        "unsafe_url",
+        "body_too_large",
+        "network_error",
+        "invalid_options",
+        "aborted"
+      ].includes(err.code) ? err.code : "network_error";
+      return fail(
+        kind,
+        ref,
+        cacheKey,
+        code === "unsafe_url" ? "blocked_unsafe_url" : "unresolvable",
+        code,
+        `Canonical document read failed: ${code}`,
+        { retryable: code === "network_error" }
+      );
+    }
     if (err instanceof SsrfRefusedError) {
       if (err.code === "body_exceeds_limit") {
         return fail(
@@ -726,6 +796,7 @@ function countSchemaKeywords(root) {
   return walk(root);
 }
 export {
+  CanonicalDocumentReadError,
   canonicalReferenceCacheKey,
   createCanonicalReferenceCache,
   createCanonicalReferenceResolver,

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

@@ -7,3 +7,4 @@ export { InMemoryWebhookRegistrationStore, type InMemoryWebhookRegistrationStore
 export type { ConversationConfig, ConversationContext, InputHandler, InputHandlerResponse, InputRequest, Message, TaskInfo, TaskOptions, TaskResult, TaskResultCompleted, TaskResultFailure, TaskResultIntermediate, TaskResultMetadata, } from '../core/ConversationTypes.mjs';
 export type { AgentConfig } from '../types/adcp.mjs';
 export type { ResolveAccountOptions, ListedAccount } from '../core/account-resolution.mjs';
+export type { CreativeFormatWireMode } from '../v2/projection/creative-delivery.mjs';

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

@@ -7,3 +7,4 @@ export { InMemoryWebhookRegistrationStore, type InMemoryWebhookRegistrationStore
 export type { ConversationConfig, ConversationContext, InputHandler, InputHandlerResponse, InputRequest, Message, TaskInfo, TaskOptions, TaskResult, TaskResultCompleted, TaskResultFailure, TaskResultIntermediate, TaskResultMetadata, } from '../core/ConversationTypes';
 export type { AgentConfig } from '../types/adcp';
 export type { ResolveAccountOptions, ListedAccount } from '../core/account-resolution';
+export type { CreativeFormatWireMode } from '../v2/projection/creative-delivery';

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

@@ -14,7 +14,7 @@ import type { MediaBuyLifecycleCoordinator, MediaBuyLifecycleCoordinatorOptions
 import type { ProposalRefinementCapabilities, RefineProposalsInput, RefineProposalsResponse } from '../negotiation/types.mjs';
 import type { LegacyFormatConverter } from '../v2/projection/v1-to-v2.mjs';
 import type { ProjectionCatalogSnapshot } from '../v2/projection/catalog-snapshot.mjs';
-import type { CanonicalCreateMediaBuyInput, CanonicalCreativeResponse, CanonicalGetProductsRequest, CanonicalGetProductsResponse, CanonicalListCreativesRequest, CanonicalListCreativesResponse, CanonicalPreviewCreativeRequest, CanonicalPreviewCreativeResponse, CanonicalSyncCreativesRequest, CanonicalUpdateMediaBuyRequest } from '../v2/projection/creative-delivery.mjs';
+import type { CanonicalCreateMediaBuyInput, CanonicalCreativeResponse, CanonicalGetProductsRequest, CanonicalGetProductsResponse, CanonicalListCreativesRequest, CanonicalListCreativesResponse, CanonicalPreviewCreativeRequest, CanonicalPreviewCreativeResponse, CanonicalSyncCreativesRequest, CanonicalUpdateMediaBuyRequest, CreativeFormatWireMode } from '../v2/projection/creative-delivery.mjs';
 export type { CanonicalGetProductsResponse } from '../v2/projection/creative-delivery.mjs';
 export type CanonicalProjectionTaskOptions = TaskOptions & {
     /** Migration escape hatch for seller-specific legacy refs absent from the bundled registry. */
@@ -533,6 +533,14 @@ export declare class AgentClient {
      * For v2 servers: builds synthetic capabilities from tool list
      */
     getCapabilities(options?: Pick<TaskOptions, 'signal' | 'transport'>): Promise<AdcpCapabilities>;
+    /**
+     * Resolve the creative wire mode used by canonical writes without sending a
+     * mutation. Uses capabilities, this tool's input schema, and the client wire
+     * pin. Older peers with insufficient evidence return `unknown` and require
+     * an unambiguous legacy reference during projection; conflicting evidence
+     * or unproven support with a 3.2+ buyer pin throws `CreativeFormatCapabilityError`.
+     */
+    resolveCreativeFormatWireMode(taskType: 'sync_creatives' | 'create_media_buy' | 'update_media_buy', options?: Pick<TaskOptions, 'signal' | 'transport'>): Promise<CreativeFormatWireMode>;
     /** Scope token for a tenant-bound, application-owned capability preflight. */
     getCapabilityEvidenceScope(): import('./SingleAgentClient.mjs').CapabilityEvidenceScope;
     /** Install fresh capability evidence without making a redundant probe. */

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

@@ -14,7 +14,7 @@ import type { MediaBuyLifecycleCoordinator, MediaBuyLifecycleCoordinatorOptions
 import type { ProposalRefinementCapabilities, RefineProposalsInput, RefineProposalsResponse } from '../negotiation/types';
 import type { LegacyFormatConverter } from '../v2/projection/v1-to-v2';
 import type { ProjectionCatalogSnapshot } from '../v2/projection/catalog-snapshot';
-import type { CanonicalCreateMediaBuyInput, CanonicalCreativeResponse, CanonicalGetProductsRequest, CanonicalGetProductsResponse, CanonicalListCreativesRequest, CanonicalListCreativesResponse, CanonicalPreviewCreativeRequest, CanonicalPreviewCreativeResponse, CanonicalSyncCreativesRequest, CanonicalUpdateMediaBuyRequest } from '../v2/projection/creative-delivery';
+import type { CanonicalCreateMediaBuyInput, CanonicalCreativeResponse, CanonicalGetProductsRequest, CanonicalGetProductsResponse, CanonicalListCreativesRequest, CanonicalListCreativesResponse, CanonicalPreviewCreativeRequest, CanonicalPreviewCreativeResponse, CanonicalSyncCreativesRequest, CanonicalUpdateMediaBuyRequest, CreativeFormatWireMode } from '../v2/projection/creative-delivery';
 export type { CanonicalGetProductsResponse } from '../v2/projection/creative-delivery';
 export type CanonicalProjectionTaskOptions = TaskOptions & {
     /** Migration escape hatch for seller-specific legacy refs absent from the bundled registry. */
@@ -533,6 +533,14 @@ export declare class AgentClient {
      * For v2 servers: builds synthetic capabilities from tool list
      */
     getCapabilities(options?: Pick<TaskOptions, 'signal' | 'transport'>): Promise<AdcpCapabilities>;
+    /**
+     * Resolve the creative wire mode used by canonical writes without sending a
+     * mutation. Uses capabilities, this tool's input schema, and the client wire
+     * pin. Older peers with insufficient evidence return `unknown` and require
+     * an unambiguous legacy reference during projection; conflicting evidence
+     * or unproven support with a 3.2+ buyer pin throws `CreativeFormatCapabilityError`.
+     */
+    resolveCreativeFormatWireMode(taskType: 'sync_creatives' | 'create_media_buy' | 'update_media_buy', options?: Pick<TaskOptions, 'signal' | 'transport'>): Promise<CreativeFormatWireMode>;
     /** Scope token for a tenant-bound, application-owned capability preflight. */
     getCapabilityEvidenceScope(): import('./SingleAgentClient').CapabilityEvidenceScope;
     /** Install fresh capability evidence without making a redundant probe. */

package/dist/lib/core/AgentClient.js

@@ -791,6 +791,16 @@ class AgentClient {
   async getCapabilities(options) {
     return this.client.getCapabilities(options);
   }
+  /**
+   * Resolve the creative wire mode used by canonical writes without sending a
+   * mutation. Uses capabilities, this tool's input schema, and the client wire
+   * pin. Older peers with insufficient evidence return `unknown` and require
+   * an unambiguous legacy reference during projection; conflicting evidence
+   * or unproven support with a 3.2+ buyer pin throws `CreativeFormatCapabilityError`.
+   */
+  async resolveCreativeFormatWireMode(taskType, options) {
+    return this.client.resolveCreativeFormatWireMode(taskType, options);
+  }
   /** Scope token for a tenant-bound, application-owned capability preflight. */
   getCapabilityEvidenceScope() {
     return this.client.getCapabilityEvidenceScope();

package/dist/lib/core/AgentClient.mjs

@@ -759,6 +759,16 @@ class AgentClient {
   async getCapabilities(options) {
     return this.client.getCapabilities(options);
   }
+  /**
+   * Resolve the creative wire mode used by canonical writes without sending a
+   * mutation. Uses capabilities, this tool's input schema, and the client wire
+   * pin. Older peers with insufficient evidence return `unknown` and require
+   * an unambiguous legacy reference during projection; conflicting evidence
+   * or unproven support with a 3.2+ buyer pin throws `CreativeFormatCapabilityError`.
+   */
+  async resolveCreativeFormatWireMode(taskType, options) {
+    return this.client.resolveCreativeFormatWireMode(taskType, options);
+  }
   /** Scope token for a tenant-bound, application-owned capability preflight. */
   getCapabilityEvidenceScope() {
     return this.client.getCapabilityEvidenceScope();

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

@@ -19,7 +19,7 @@ import type { ProductCache } from './product-cache.mjs';
 import { type ResolveAccountOptions } from './account-resolution.mjs';
 import { type BuyerPropertyPolicy, type ProductPropertyPolicyMode } from '../media-buy/property-policy.mjs';
 import { type ResolveListOptions } from '../server/targeting-helpers.mjs';
-import { type CanonicalCreateMediaBuyInput, type CanonicalCreativeResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsResponse, type CanonicalListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalSyncCreativesRequest, type CanonicalUpdateMediaBuyRequest, type SyncCreativeFormatProjection } from '../v2/projection/creative-delivery.mjs';
+import { type CanonicalCreateMediaBuyInput, type CanonicalCreativeResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsResponse, type CanonicalListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalSyncCreativesRequest, type CanonicalUpdateMediaBuyRequest, type CreativeFormatWireMode, type SyncCreativeFormatProjection } from '../v2/projection/creative-delivery.mjs';
 import type { LegacyFormatConverter } from '../v2/projection/v1-to-v2.mjs';
 import { type ProjectionCatalogSnapshot } from '../v2/projection/catalog-snapshot.mjs';
 import type { CanonicalFormatLegacyResolver } from '../v2/projection/v2-to-v1.mjs';
@@ -927,7 +927,18 @@ export declare class SingleAgentClient {
      * Projection-only options are ignored because this method preserves the caller's legacy wire payload.
      */
     syncCreativesLegacy(params: MutatingRequestInput<SyncCreativesRequest>, inputHandler?: InputHandler, options?: SyncCreativesTaskOptions): Promise<TaskResult<SyncCreativesResponse>>;
-    private resolveCreativeFormatWireMode;
+    /**
+     * Resolve the creative wire mode used by the canonical write methods without
+     * sending a mutation. Discovers capabilities and the current tool's input
+     * schema, or reuses fresh cached/primed evidence, with this client's wire pin.
+     *
+     * `unknown` preserves the conservative legacy projection for older peers
+     * whose capabilities and schema do not establish support. Projection still
+     * requires an unambiguous legacy reference for each creative in that case.
+     * Conflicting evidence and unproven support with a 3.2+ buyer pin throw
+     * `CreativeFormatCapabilityError`, just as they do during a write.
+     */
+    resolveCreativeFormatWireMode(taskType: 'sync_creatives' | 'create_media_buy' | 'update_media_buy', options?: ReadRequestOptions): Promise<CreativeFormatWireMode>;
     /** Validate malformed creative payloads before capability discovery can perform I/O. */
     private validateBeforeCreativeCapabilityProbe;
     /**

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

@@ -19,7 +19,7 @@ import type { ProductCache } from './product-cache';
 import { type ResolveAccountOptions } from './account-resolution';
 import { type BuyerPropertyPolicy, type ProductPropertyPolicyMode } from '../media-buy/property-policy';
 import { type ResolveListOptions } from '../server/targeting-helpers';
-import { type CanonicalCreateMediaBuyInput, type CanonicalCreativeResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsResponse, type CanonicalListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalSyncCreativesRequest, type CanonicalUpdateMediaBuyRequest, type SyncCreativeFormatProjection } from '../v2/projection/creative-delivery';
+import { type CanonicalCreateMediaBuyInput, type CanonicalCreativeResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsResponse, type CanonicalListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalSyncCreativesRequest, type CanonicalUpdateMediaBuyRequest, type CreativeFormatWireMode, type SyncCreativeFormatProjection } from '../v2/projection/creative-delivery';
 import type { LegacyFormatConverter } from '../v2/projection/v1-to-v2';
 import { type ProjectionCatalogSnapshot } from '../v2/projection/catalog-snapshot';
 import type { CanonicalFormatLegacyResolver } from '../v2/projection/v2-to-v1';
@@ -927,7 +927,18 @@ export declare class SingleAgentClient {
      * Projection-only options are ignored because this method preserves the caller's legacy wire payload.
      */
     syncCreativesLegacy(params: MutatingRequestInput<SyncCreativesRequest>, inputHandler?: InputHandler, options?: SyncCreativesTaskOptions): Promise<TaskResult<SyncCreativesResponse>>;
-    private resolveCreativeFormatWireMode;
+    /**
+     * Resolve the creative wire mode used by the canonical write methods without
+     * sending a mutation. Discovers capabilities and the current tool's input
+     * schema, or reuses fresh cached/primed evidence, with this client's wire pin.
+     *
+     * `unknown` preserves the conservative legacy projection for older peers
+     * whose capabilities and schema do not establish support. Projection still
+     * requires an unambiguous legacy reference for each creative in that case.
+     * Conflicting evidence and unproven support with a 3.2+ buyer pin throw
+     * `CreativeFormatCapabilityError`, just as they do during a write.
+     */
+    resolveCreativeFormatWireMode(taskType: 'sync_creatives' | 'create_media_buy' | 'update_media_buy', options?: ReadRequestOptions): Promise<CreativeFormatWireMode>;
     /** Validate malformed creative payloads before capability discovery can perform I/O. */
     private validateBeforeCreativeCapabilityProbe;
     /**

package/dist/lib/core/SingleAgentClient.js

@@ -4566,7 +4566,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     if (hasCreativeFormatData) {
       this.validateBeforeCreativeCapabilityProbe("create_media_buy", params, taskOptions);
     }
-    const wireMode = hasCreativeFormatData ? this.resolveCreativeFormatWireMode("create_media_buy", await this.getCapabilities(taskOptions)) : "canonical";
+    const wireMode = hasCreativeFormatData ? await this.resolveCreativeFormatWireMode("create_media_buy", taskOptions) : "canonical";
     const wireParams = params;
     const result = await this.executeAndHandle(
       "create_media_buy",
@@ -4648,7 +4648,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     if (hasCreativeFormatData) {
       this.validateBeforeCreativeCapabilityProbe("update_media_buy", params, taskOptions);
     }
-    const wireMode = hasCreativeFormatData ? this.resolveCreativeFormatWireMode("update_media_buy", await this.getCapabilities(taskOptions)) : "canonical";
+    const wireMode = hasCreativeFormatData ? await this.resolveCreativeFormatWireMode("update_media_buy", taskOptions) : "canonical";
     const result = await this.executeAndHandle(
       "update_media_buy",
       "onUpdateMediaBuyStatusChange",
@@ -4731,7 +4731,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
       projectionCatalogs ?? this.config.projectionCatalogs
     );
     this.validateBeforeCreativeCapabilityProbe("sync_creatives", params, taskOptions);
-    const wireMode = this.resolveCreativeFormatWireMode("sync_creatives", await this.getCapabilities(taskOptions));
+    const wireMode = await this.resolveCreativeFormatWireMode("sync_creatives", taskOptions);
     const configuredSelectorContainers = [
       ...creativeFormatProjection?.selectorContainers ?? []
     ];
@@ -4775,10 +4775,28 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
       "onSyncCreativesStatusChange"
     );
   }
-  resolveCreativeFormatWireMode(taskType, capabilities) {
+  /**
+   * Resolve the creative wire mode used by the canonical write methods without
+   * sending a mutation. Discovers capabilities and the current tool's input
+   * schema, or reuses fresh cached/primed evidence, with this client's wire pin.
+   *
+   * `unknown` preserves the conservative legacy projection for older peers
+   * whose capabilities and schema do not establish support. Projection still
+   * requires an unambiguous legacy reference for each creative in that case.
+   * Conflicting evidence and unproven support with a 3.2+ buyer pin throw
+   * `CreativeFormatCapabilityError`, just as they do during a write.
+   */
+  async resolveCreativeFormatWireMode(taskType, options) {
+    const discoveryContext = {};
+    const capabilities = await this.getCapabilities({
+      ...options,
+      [CAPABILITY_DISCOVERY_CONTEXT]: discoveryContext
+    });
+    const usesScopedFetch = (0, import_protocols.normalizeTransportOptions)(options?.transport ?? this.config.transport)?.trustedFetchFn !== void 0;
+    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(this.cachedToolSchemas?.get(taskType));
+    const schema = creativeSchemaSupport(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`

package/dist/lib/core/SingleAgentClient.mjs

@@ -4636,7 +4636,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     if (hasCreativeFormatData) {
       this.validateBeforeCreativeCapabilityProbe("create_media_buy", params, taskOptions);
     }
-    const wireMode = hasCreativeFormatData ? this.resolveCreativeFormatWireMode("create_media_buy", await this.getCapabilities(taskOptions)) : "canonical";
+    const wireMode = hasCreativeFormatData ? await this.resolveCreativeFormatWireMode("create_media_buy", taskOptions) : "canonical";
     const wireParams = params;
     const result = await this.executeAndHandle(
       "create_media_buy",
@@ -4718,7 +4718,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
     if (hasCreativeFormatData) {
       this.validateBeforeCreativeCapabilityProbe("update_media_buy", params, taskOptions);
     }
-    const wireMode = hasCreativeFormatData ? this.resolveCreativeFormatWireMode("update_media_buy", await this.getCapabilities(taskOptions)) : "canonical";
+    const wireMode = hasCreativeFormatData ? await this.resolveCreativeFormatWireMode("update_media_buy", taskOptions) : "canonical";
     const result = await this.executeAndHandle(
       "update_media_buy",
       "onUpdateMediaBuyStatusChange",
@@ -4801,7 +4801,7 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
       projectionCatalogs ?? this.config.projectionCatalogs
     );
     this.validateBeforeCreativeCapabilityProbe("sync_creatives", params, taskOptions);
-    const wireMode = this.resolveCreativeFormatWireMode("sync_creatives", await this.getCapabilities(taskOptions));
+    const wireMode = await this.resolveCreativeFormatWireMode("sync_creatives", taskOptions);
     const configuredSelectorContainers = [
       ...creativeFormatProjection?.selectorContainers ?? []
     ];
@@ -4845,10 +4845,28 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
       "onSyncCreativesStatusChange"
     );
   }
-  resolveCreativeFormatWireMode(taskType, capabilities) {
+  /**
+   * Resolve the creative wire mode used by the canonical write methods without
+   * sending a mutation. Discovers capabilities and the current tool's input
+   * schema, or reuses fresh cached/primed evidence, with this client's wire pin.
+   *
+   * `unknown` preserves the conservative legacy projection for older peers
+   * whose capabilities and schema do not establish support. Projection still
+   * requires an unambiguous legacy reference for each creative in that case.
+   * Conflicting evidence and unproven support with a 3.2+ buyer pin throw
+   * `CreativeFormatCapabilityError`, just as they do during a write.
+   */
+  async resolveCreativeFormatWireMode(taskType, options) {
+    const discoveryContext = {};
+    const capabilities = await this.getCapabilities({
+      ...options,
+      [CAPABILITY_DISCOVERY_CONTEXT]: discoveryContext
+    });
+    const usesScopedFetch = normalizeTransportOptions(options?.transport ?? this.config.transport)?.trustedFetchFn !== void 0;
+    const toolSchemas = discoveryContext.toolSchemas ?? (usesScopedFetch ? void 0 : this.cachedToolSchemas);
     const wireRelease = this.config.wireAdcpVersion ?? this.resolvedAdcpVersion;
     const declared = resolveCreativeFormatWireMode(capabilities, wireRelease);
-    const schema = creativeSchemaSupport(this.cachedToolSchemas?.get(taskType));
+    const schema = creativeSchemaSupport(toolSchemas?.get(taskType));
     if (declared !== "unknown" && schema !== "unknown" && declared !== schema) {
       throw new CreativeFormatCapabilityError(
         `Seller capability and ${taskType} input schema disagree about canonical creative support`

package/dist/lib/index.d.mts

@@ -186,7 +186,7 @@ export { getAuthToken, createAdCPHeaders, createMCPAuthHeaders, createAuthentica
 export { parseWWWAuthenticate, decodeAccessTokenClaims, validateTokenAudience, type WWWAuthenticateChallenge, type DecodedJWTHeader, type DecodedJWTClaims, type DecodedAccessToken, type TokenAudienceResult, InvalidTokenError, InsufficientScopeError, } from './auth/oauth/index.mjs';
 export { runAuthDiagnosis, AUTH_DIAGNOSIS_SCHEMA_VERSION, type DiagnoseOptions, type HttpCapture as DiagnosisHttpCapture, type DiagnosisStep, type Hypothesis as DiagnosisHypothesis, type HypothesisVerdict as DiagnosisHypothesisVerdict, type AuthDiagnosisReport, } from './auth/oauth/index.mjs';
 export { NeedsAuthorizationError, discoverAuthorizationRequirements, hasValidatedMcpAuthorizationRequirements, createFileOAuthStorage, bindAgentStorage, getAgentStorage, unbindAgentStorage, type AuthorizationRequirements, type DiscoverAuthorizationOptions, type FileOAuthStorageOptions, } from './auth/oauth/index.mjs';
-export { exchangeClientCredentials, ensureClientCredentialsTokens, ClientCredentialsExchangeError, MissingEnvSecretError, resolveSecret, isEnvSecretReference, toEnvSecretReference, extractEnvSecretName, type ExchangeClientCredentialsOptions, type EnsureClientCredentialsOptions, type AgentOAuthClientCredentials, } from './auth/oauth/index.mjs';
+export { exchangeClientCredentials, ensureClientCredentialsTokens, ClientCredentialsExchangeError, MissingEnvSecretError, resolveSecret, isEnvSecretReference, toEnvSecretReference, extractEnvSecretName, type ExchangeClientCredentialsOptions, type EnsureClientCredentialsOptions, type AgentOAuthClientCredentials, AgentOAuthClientCredentialsSchema, } from './auth/oauth/index.mjs';
 export { validateAgentUrl, validateAdCPResponse, getExpectedSchema, handleAdCPResponse } from './validation/index.mjs';
 export { ProtocolClient, callMCPTool, callA2ATool, createA2AClientFromCardUrl, createMCPClient, createA2AClient, closeMCPConnections, closeOAuthConnections, bundleSupportsAdcpVersionField, BODY_SNIPPET_TIMEOUT_MS, OBSERVER_FLUSH_TIMEOUT_MS, sanitizeTransportHeaders, sanitizeTransportUrl, } from './protocols/index.mjs';
 export { toReleasePrecisionWire, validateAdcpVersionWire } from './validation/schema-loader.mjs';
@@ -214,7 +214,7 @@ export { FormatAsset, imageAssetSlot, videoAssetSlot, audioAssetSlot, textAssetS
 export { Render, urlRender, htmlRender, bothRender } from './utils/render-builders.mjs';
 export { FormatRender, displayRender, parameterizedRender, templateRender, type DimensionsRender, type ParameterizedRender, type RenderItem, } from './utils/format-render-builders.mjs';
 export { CanonicalFormat, canonicalFormatDeclaration, type CanonicalFormatDeclaration, type CanonicalFormatDeclaration as Format, type CanonicalFormatDeclarationFields, type CanonicalFormatKind, type CanonicalFormatParams, type ProductCardDetailedFields, type ProductCardFields, } from './v2/projection/index.mjs';
-export { toCanonicalFormatOptionsWithRoutes, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, packageRefsForFormatOptions, FormatOptionRefsLookupError, CreativeFormatCapabilityError, CreativeFormatProjectionError, type LegacyFormatConversionContext, type LegacyFormatConverter, type LegacyFormatResolutionContext, type LegacyFormatResolver, legacyFormatConverterFromCatalogSnapshots, canonicalFormatLegacyResolverFromCatalogSnapshots, canonicalFormatLegacyResolverFromRoutes, legacyRoutesForProduct, projectionAdaptersFromCatalogSnapshots, type ProjectionCatalogAdapters, type ProjectionCatalogSnapshot, type ProjectionCatalogSource, type CanonicalFormatLegacyResolver, type CanonicalFormatLegacyResolutionContext, type CanonicalFormatLegacyRoute, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, type CanonicalCreativeAsset, type CanonicalCreativeAsset as CreativeAsset, type CanonicalSyncCreativeAsset, type CanonicalCreateMediaBuyInput, type CanonicalCreateMediaBuyRequest, type CanonicalCreateMediaBuyRequest as CreateMediaBuyRequest, type CanonicalCreateMediaBuyResponse, type CanonicalCreateMediaBuyResponse as CreateMediaBuyResponse, type CanonicalCreativeResponse, type CanonicalCreativeFilters, type CanonicalCreativeFilters as CreativeFilters, type CanonicalGetCreativeDeliveryResponse, type CanonicalGetCreativeDeliveryResponse as GetCreativeDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse as GetMediaBuyDeliveryResponse, type CanonicalGetMediaBuysResponse, type CanonicalGetMediaBuysResponse as GetMediaBuysResponse, type CanonicalGetProductsResponse as GetProductsResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsRequest as GetProductsRequest, type CanonicalListCreativesRequest, type CanonicalListCreativesRequest as ListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalListCreativesResponse as ListCreativesResponse, type CanonicalListedCreative, type CanonicalPackageRequest, type CanonicalPackageRequest as PackageRequest, type CanonicalPackageUpdate, type CanonicalPackageUpdate as PackageUpdate, type CanonicalPackage, type CanonicalPackage as Package, type CanonicalPlacement, type CanonicalPlacement as Placement, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeRequest as PreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalPreviewCreativeResponse as PreviewCreativeResponse, type CanonicalProduct, type CanonicalProduct as Product, type CanonicalProjectedCreative, type CanonicalSyncCreativesRequest, type CanonicalSyncCreativesRequest as SyncCreativesRequest, type CanonicalSyncCreativesResponse, type CanonicalSyncCreativesResponse as SyncCreativesResponse, type CanonicalUpdateMediaBuyRequest, type CanonicalUpdateMediaBuyRequest as UpdateMediaBuyRequest, type CanonicalUpdateMediaBuyResponse, type CanonicalUpdateMediaBuyResponse as UpdateMediaBuyResponse, type LegacyCreativeAsset, type CanonicalCreativeFormatSelectorContainer, type PackageFormatRefs, type ProjectionDiagnostic, type SyncCreativeFormatProjection, } from './v2/projection/index.mjs';
+export { toCanonicalFormatOptionsWithRoutes, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, packageRefsForFormatOptions, FormatOptionRefsLookupError, CreativeFormatCapabilityError, CreativeFormatProjectionError, type CreativeFormatWireMode, type LegacyFormatConversionContext, type LegacyFormatConverter, type LegacyFormatResolutionContext, type LegacyFormatResolver, legacyFormatConverterFromCatalogSnapshots, canonicalFormatLegacyResolverFromCatalogSnapshots, canonicalFormatLegacyResolverFromRoutes, legacyRoutesForProduct, projectionAdaptersFromCatalogSnapshots, type ProjectionCatalogAdapters, type ProjectionCatalogSnapshot, type ProjectionCatalogSource, type CanonicalFormatLegacyResolver, type CanonicalFormatLegacyResolutionContext, type CanonicalFormatLegacyRoute, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, type CanonicalCreativeAsset, type CanonicalCreativeAsset as CreativeAsset, type CanonicalSyncCreativeAsset, type CanonicalCreateMediaBuyInput, type CanonicalCreateMediaBuyRequest, type CanonicalCreateMediaBuyRequest as CreateMediaBuyRequest, type CanonicalCreateMediaBuyResponse, type CanonicalCreateMediaBuyResponse as CreateMediaBuyResponse, type CanonicalCreativeResponse, type CanonicalCreativeFilters, type CanonicalCreativeFilters as CreativeFilters, type CanonicalGetCreativeDeliveryResponse, type CanonicalGetCreativeDeliveryResponse as GetCreativeDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse as GetMediaBuyDeliveryResponse, type CanonicalGetMediaBuysResponse, type CanonicalGetMediaBuysResponse as GetMediaBuysResponse, type CanonicalGetProductsResponse as GetProductsResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsRequest as GetProductsRequest, type CanonicalListCreativesRequest, type CanonicalListCreativesRequest as ListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalListCreativesResponse as ListCreativesResponse, type CanonicalListedCreative, type CanonicalPackageRequest, type CanonicalPackageRequest as PackageRequest, type CanonicalPackageUpdate, type CanonicalPackageUpdate as PackageUpdate, type CanonicalPackage, type CanonicalPackage as Package, type CanonicalPlacement, type CanonicalPlacement as Placement, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeRequest as PreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalPreviewCreativeResponse as PreviewCreativeResponse, type CanonicalProduct, type CanonicalProduct as Product, type CanonicalProjectedCreative, type CanonicalSyncCreativesRequest, type CanonicalSyncCreativesRequest as SyncCreativesRequest, type CanonicalSyncCreativesResponse, type CanonicalSyncCreativesResponse as SyncCreativesResponse, type CanonicalUpdateMediaBuyRequest, type CanonicalUpdateMediaBuyRequest as UpdateMediaBuyRequest, type CanonicalUpdateMediaBuyResponse, type CanonicalUpdateMediaBuyResponse as UpdateMediaBuyResponse, type LegacyCreativeAsset, type CanonicalCreativeFormatSelectorContainer, type PackageFormatRefs, type ProjectionDiagnostic, type SyncCreativeFormatProjection, } from './v2/projection/index.mjs';
 export { activationKey, segmentIdActivationKey, keyValueActivationKey } from './utils/activation-key-builders.mjs';
 export { signalId, catalogSignalId, agentSignalId, getSignalId, getSignalIssuer } from './utils/signal-id-builders.mjs';
 export { buildActivateSignalRequest, getSignalActivationId, getSignalPricingOptionIds, normalizeDiscoveredSignal, } from './utils/signal-discovery-helpers.mjs';

package/dist/lib/index.d.ts

@@ -186,7 +186,7 @@ export { getAuthToken, createAdCPHeaders, createMCPAuthHeaders, createAuthentica
 export { parseWWWAuthenticate, decodeAccessTokenClaims, validateTokenAudience, type WWWAuthenticateChallenge, type DecodedJWTHeader, type DecodedJWTClaims, type DecodedAccessToken, type TokenAudienceResult, InvalidTokenError, InsufficientScopeError, } from './auth/oauth';
 export { runAuthDiagnosis, AUTH_DIAGNOSIS_SCHEMA_VERSION, type DiagnoseOptions, type HttpCapture as DiagnosisHttpCapture, type DiagnosisStep, type Hypothesis as DiagnosisHypothesis, type HypothesisVerdict as DiagnosisHypothesisVerdict, type AuthDiagnosisReport, } from './auth/oauth';
 export { NeedsAuthorizationError, discoverAuthorizationRequirements, hasValidatedMcpAuthorizationRequirements, createFileOAuthStorage, bindAgentStorage, getAgentStorage, unbindAgentStorage, type AuthorizationRequirements, type DiscoverAuthorizationOptions, type FileOAuthStorageOptions, } from './auth/oauth';
-export { exchangeClientCredentials, ensureClientCredentialsTokens, ClientCredentialsExchangeError, MissingEnvSecretError, resolveSecret, isEnvSecretReference, toEnvSecretReference, extractEnvSecretName, type ExchangeClientCredentialsOptions, type EnsureClientCredentialsOptions, type AgentOAuthClientCredentials, } from './auth/oauth';
+export { exchangeClientCredentials, ensureClientCredentialsTokens, ClientCredentialsExchangeError, MissingEnvSecretError, resolveSecret, isEnvSecretReference, toEnvSecretReference, extractEnvSecretName, type ExchangeClientCredentialsOptions, type EnsureClientCredentialsOptions, type AgentOAuthClientCredentials, AgentOAuthClientCredentialsSchema, } from './auth/oauth';
 export { validateAgentUrl, validateAdCPResponse, getExpectedSchema, handleAdCPResponse } from './validation';
 export { ProtocolClient, callMCPTool, callA2ATool, createA2AClientFromCardUrl, createMCPClient, createA2AClient, closeMCPConnections, closeOAuthConnections, bundleSupportsAdcpVersionField, BODY_SNIPPET_TIMEOUT_MS, OBSERVER_FLUSH_TIMEOUT_MS, sanitizeTransportHeaders, sanitizeTransportUrl, } from './protocols';
 export { toReleasePrecisionWire, validateAdcpVersionWire } from './validation/schema-loader';
@@ -214,7 +214,7 @@ export { FormatAsset, imageAssetSlot, videoAssetSlot, audioAssetSlot, textAssetS
 export { Render, urlRender, htmlRender, bothRender } from './utils/render-builders';
 export { FormatRender, displayRender, parameterizedRender, templateRender, type DimensionsRender, type ParameterizedRender, type RenderItem, } from './utils/format-render-builders';
 export { CanonicalFormat, canonicalFormatDeclaration, type CanonicalFormatDeclaration, type CanonicalFormatDeclaration as Format, type CanonicalFormatDeclarationFields, type CanonicalFormatKind, type CanonicalFormatParams, type ProductCardDetailedFields, type ProductCardFields, } from './v2/projection';
-export { toCanonicalFormatOptionsWithRoutes, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, packageRefsForFormatOptions, FormatOptionRefsLookupError, CreativeFormatCapabilityError, CreativeFormatProjectionError, type LegacyFormatConversionContext, type LegacyFormatConverter, type LegacyFormatResolutionContext, type LegacyFormatResolver, legacyFormatConverterFromCatalogSnapshots, canonicalFormatLegacyResolverFromCatalogSnapshots, canonicalFormatLegacyResolverFromRoutes, legacyRoutesForProduct, projectionAdaptersFromCatalogSnapshots, type ProjectionCatalogAdapters, type ProjectionCatalogSnapshot, type ProjectionCatalogSource, type CanonicalFormatLegacyResolver, type CanonicalFormatLegacyResolutionContext, type CanonicalFormatLegacyRoute, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, type CanonicalCreativeAsset, type CanonicalCreativeAsset as CreativeAsset, type CanonicalSyncCreativeAsset, type CanonicalCreateMediaBuyInput, type CanonicalCreateMediaBuyRequest, type CanonicalCreateMediaBuyRequest as CreateMediaBuyRequest, type CanonicalCreateMediaBuyResponse, type CanonicalCreateMediaBuyResponse as CreateMediaBuyResponse, type CanonicalCreativeResponse, type CanonicalCreativeFilters, type CanonicalCreativeFilters as CreativeFilters, type CanonicalGetCreativeDeliveryResponse, type CanonicalGetCreativeDeliveryResponse as GetCreativeDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse as GetMediaBuyDeliveryResponse, type CanonicalGetMediaBuysResponse, type CanonicalGetMediaBuysResponse as GetMediaBuysResponse, type CanonicalGetProductsResponse as GetProductsResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsRequest as GetProductsRequest, type CanonicalListCreativesRequest, type CanonicalListCreativesRequest as ListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalListCreativesResponse as ListCreativesResponse, type CanonicalListedCreative, type CanonicalPackageRequest, type CanonicalPackageRequest as PackageRequest, type CanonicalPackageUpdate, type CanonicalPackageUpdate as PackageUpdate, type CanonicalPackage, type CanonicalPackage as Package, type CanonicalPlacement, type CanonicalPlacement as Placement, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeRequest as PreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalPreviewCreativeResponse as PreviewCreativeResponse, type CanonicalProduct, type CanonicalProduct as Product, type CanonicalProjectedCreative, type CanonicalSyncCreativesRequest, type CanonicalSyncCreativesRequest as SyncCreativesRequest, type CanonicalSyncCreativesResponse, type CanonicalSyncCreativesResponse as SyncCreativesResponse, type CanonicalUpdateMediaBuyRequest, type CanonicalUpdateMediaBuyRequest as UpdateMediaBuyRequest, type CanonicalUpdateMediaBuyResponse, type CanonicalUpdateMediaBuyResponse as UpdateMediaBuyResponse, type LegacyCreativeAsset, type CanonicalCreativeFormatSelectorContainer, type PackageFormatRefs, type ProjectionDiagnostic, type SyncCreativeFormatProjection, } from './v2/projection';
+export { toCanonicalFormatOptionsWithRoutes, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, packageRefsForFormatOptions, FormatOptionRefsLookupError, CreativeFormatCapabilityError, CreativeFormatProjectionError, type CreativeFormatWireMode, type LegacyFormatConversionContext, type LegacyFormatConverter, type LegacyFormatResolutionContext, type LegacyFormatResolver, legacyFormatConverterFromCatalogSnapshots, canonicalFormatLegacyResolverFromCatalogSnapshots, canonicalFormatLegacyResolverFromRoutes, legacyRoutesForProduct, projectionAdaptersFromCatalogSnapshots, type ProjectionCatalogAdapters, type ProjectionCatalogSnapshot, type ProjectionCatalogSource, type CanonicalFormatLegacyResolver, type CanonicalFormatLegacyResolutionContext, type CanonicalFormatLegacyRoute, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, type CanonicalCreativeAsset, type CanonicalCreativeAsset as CreativeAsset, type CanonicalSyncCreativeAsset, type CanonicalCreateMediaBuyInput, type CanonicalCreateMediaBuyRequest, type CanonicalCreateMediaBuyRequest as CreateMediaBuyRequest, type CanonicalCreateMediaBuyResponse, type CanonicalCreateMediaBuyResponse as CreateMediaBuyResponse, type CanonicalCreativeResponse, type CanonicalCreativeFilters, type CanonicalCreativeFilters as CreativeFilters, type CanonicalGetCreativeDeliveryResponse, type CanonicalGetCreativeDeliveryResponse as GetCreativeDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse as GetMediaBuyDeliveryResponse, type CanonicalGetMediaBuysResponse, type CanonicalGetMediaBuysResponse as GetMediaBuysResponse, type CanonicalGetProductsResponse as GetProductsResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsRequest as GetProductsRequest, type CanonicalListCreativesRequest, type CanonicalListCreativesRequest as ListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalListCreativesResponse as ListCreativesResponse, type CanonicalListedCreative, type CanonicalPackageRequest, type CanonicalPackageRequest as PackageRequest, type CanonicalPackageUpdate, type CanonicalPackageUpdate as PackageUpdate, type CanonicalPackage, type CanonicalPackage as Package, type CanonicalPlacement, type CanonicalPlacement as Placement, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeRequest as PreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalPreviewCreativeResponse as PreviewCreativeResponse, type CanonicalProduct, type CanonicalProduct as Product, type CanonicalProjectedCreative, type CanonicalSyncCreativesRequest, type CanonicalSyncCreativesRequest as SyncCreativesRequest, type CanonicalSyncCreativesResponse, type CanonicalSyncCreativesResponse as SyncCreativesResponse, type CanonicalUpdateMediaBuyRequest, type CanonicalUpdateMediaBuyRequest as UpdateMediaBuyRequest, type CanonicalUpdateMediaBuyResponse, type CanonicalUpdateMediaBuyResponse as UpdateMediaBuyResponse, type LegacyCreativeAsset, type CanonicalCreativeFormatSelectorContainer, type PackageFormatRefs, type ProjectionDiagnostic, type SyncCreativeFormatProjection, } from './v2/projection';
 export { activationKey, segmentIdActivationKey, keyValueActivationKey } from './utils/activation-key-builders';
 export { signalId, catalogSignalId, agentSignalId, getSignalId, getSignalIssuer } from './utils/signal-id-builders';
 export { buildActivateSignalRequest, getSignalActivationId, getSignalPricingOptionIds, normalizeDiscoveredSignal, } from './utils/signal-discovery-helpers';

package/dist/lib/index.js

@@ -48,6 +48,7 @@ __export(index_exports, {
   AdagentsJsonSchema: () => import_wellknown_schemas.AdagentsJsonSchema,
   AgentClient: () => import_AgentClient.AgentClient,
   AgentNotFoundError: () => import_errors.AgentNotFoundError,
+  AgentOAuthClientCredentialsSchema: () => import_oauth4.AgentOAuthClientCredentialsSchema,
   Asset: () => import_asset_builders.Asset,
   AsyncHandler: () => import_AsyncHandler.AsyncHandler,
   AuthenticationCredentialsRejectedError: () => import_errors.AuthenticationCredentialsRejectedError,
@@ -888,6 +889,7 @@ function createAdCPClientFromEnv() {
   AdagentsJsonSchema,
   AgentClient,
   AgentNotFoundError,
+  AgentOAuthClientCredentialsSchema,
   Asset,
   AsyncHandler,
   AuthenticationCredentialsRejectedError,

package/dist/lib/index.mjs

@@ -445,7 +445,8 @@ import {
   resolveSecret,
   isEnvSecretReference,
   toEnvSecretReference,
-  extractEnvSecretName
+  extractEnvSecretName,
+  AgentOAuthClientCredentialsSchema
 } from "./auth/oauth/index.mjs";
 import { validateAgentUrl, validateAdCPResponse, getExpectedSchema, handleAdCPResponse } from "./validation/index.mjs";
 import {
@@ -847,6 +848,7 @@ export {
   AdagentsJsonSchema,
   AgentClient,
   AgentNotFoundError,
+  AgentOAuthClientCredentialsSchema,
   Asset,
   AsyncHandler,
   AuthenticationCredentialsRejectedError,

package/dist/lib/reporting/gcs/adapter.d.mts

@@ -0,0 +1,31 @@
+import type { Storage } from '@google-cloud/storage';
+import type { ExpectedReportingPeriod } from '../reconciliation.mjs';
+import type { ReportingManagedDeliveryAdapterV1, ReportingManagedDeliveryStore } from '../ledger/managed.mjs';
+import type { ReportingLedgerStore } from '../ledger/types.mjs';
+import { type ReportingObjectWriteAuthorityStoreV1 } from '../ledger/object-writes.mjs';
+import { type GcsReportingReaderOptionsV1 } from './reader.mjs';
+type DeliveryInput = Parameters<ReportingManagedDeliveryAdapterV1['deliver']>[0];
+export interface CreateGcsReportingManagedDeliveryAdapterOptionsV1 {
+    storage: Storage;
+    coreStore: ReportingLedgerStore;
+    store: ReportingManagedDeliveryStore & ReportingObjectWriteAuthorityStoreV1;
+    bucket: string;
+    namespace: string;
+    /** Bucket was dedicated and safe before any reporting bytes existed; its policy remains host-controlled. */
+    acknowledgeDedicatedFreshBucket: true;
+    /** Independently selected contract from authenticated saved host configuration, not returned producer evidence. */
+    resolveExpectedPeriod(input: DeliveryInput, context: {
+        signal: AbortSignal;
+    }): Promise<ExpectedReportingPeriod>;
+    /** Exact saved private-contract scope, with principal and bucket/prefix ownership checks. */
+    resolveContractReader(input: DeliveryInput, context: {
+        signal: AbortSignal;
+    }): Promise<GcsReportingReaderOptionsV1>;
+    operationDeadlineMilliseconds?: number;
+    minimumResourceRetentionDays?: number;
+}
+/** Complete file-transfer adapter. Availability and cleanup lease commits remain with the managed runtime. */
+export declare function createGcsReportingManagedDeliveryAdapterV1(options: CreateGcsReportingManagedDeliveryAdapterOptionsV1, context?: {
+    signal?: AbortSignal;
+}): Promise<ReportingManagedDeliveryAdapterV1>;
+export {};

package/dist/lib/reporting/gcs/adapter.d.ts

@@ -0,0 +1,31 @@
+import type { Storage } from '@google-cloud/storage';
+import type { ExpectedReportingPeriod } from '../reconciliation';
+import type { ReportingManagedDeliveryAdapterV1, ReportingManagedDeliveryStore } from '../ledger/managed';
+import type { ReportingLedgerStore } from '../ledger/types';
+import { type ReportingObjectWriteAuthorityStoreV1 } from '../ledger/object-writes';
+import { type GcsReportingReaderOptionsV1 } from './reader';
+type DeliveryInput = Parameters<ReportingManagedDeliveryAdapterV1['deliver']>[0];
+export interface CreateGcsReportingManagedDeliveryAdapterOptionsV1 {
+    storage: Storage;
+    coreStore: ReportingLedgerStore;
+    store: ReportingManagedDeliveryStore & ReportingObjectWriteAuthorityStoreV1;
+    bucket: string;
+    namespace: string;
+    /** Bucket was dedicated and safe before any reporting bytes existed; its policy remains host-controlled. */
+    acknowledgeDedicatedFreshBucket: true;
+    /** Independently selected contract from authenticated saved host configuration, not returned producer evidence. */
+    resolveExpectedPeriod(input: DeliveryInput, context: {
+        signal: AbortSignal;
+    }): Promise<ExpectedReportingPeriod>;
+    /** Exact saved private-contract scope, with principal and bucket/prefix ownership checks. */
+    resolveContractReader(input: DeliveryInput, context: {
+        signal: AbortSignal;
+    }): Promise<GcsReportingReaderOptionsV1>;
+    operationDeadlineMilliseconds?: number;
+    minimumResourceRetentionDays?: number;
+}
+/** Complete file-transfer adapter. Availability and cleanup lease commits remain with the managed runtime. */
+export declare function createGcsReportingManagedDeliveryAdapterV1(options: CreateGcsReportingManagedDeliveryAdapterOptionsV1, context?: {
+    signal?: AbortSignal;
+}): Promise<ReportingManagedDeliveryAdapterV1>;
+export {};