@adcp/sdk 15.0.0 → 15.2.0

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

@@ -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

@@ -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/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 {};

package/dist/lib/reporting/gcs/adapter.js

@@ -0,0 +1,342 @@
+"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 adapter_exports = {};
+__export(adapter_exports, {
+  createGcsReportingManagedDeliveryAdapterV1: () => createGcsReportingManagedDeliveryAdapterV1
+});
+module.exports = __toCommonJS(adapter_exports);
+var import_node_crypto = require("node:crypto");
+var import_jcs = require('../../utils/jcs.js');
+var import_inspection = require('../inspection.js');
+var import_handler = require('../ledger/handler.js');
+var import_object_writes = require('../ledger/object-writes.js');
+var import_fence = require('./fence.js');
+var import_errors = require('./errors.js');
+var import_io = require('./io.js');
+var import_validation = require('./validation.js');
+var import_reader = require('./reader.js');
+const hash = (bytes) => (0, import_node_crypto.createHash)("sha256").update(bytes).digest("hex");
+const scopeFor = (binding) => ({
+  account_id: binding.account_id,
+  destination_ref: binding.destination_ref,
+  generation: binding.authorization_generation
+});
+function deliveryIdentity(input) {
+  return hash(
+    (0, import_jcs.canonicalize)([
+      input.binding.configurationId,
+      input.binding.delivery_config_id,
+      input.binding.delivery_config_version,
+      input.materialization.reporting_materialization_id,
+      input.materialization.reporting_revision_id,
+      input.materialization.reporting_obligation_id
+    ])
+  );
+}
+function matchingBinding(input) {
+  const { materialization: m, binding: b } = input;
+  if (b.method !== "file_transfer" || b.transport !== "gcs" || m.method !== b.method || m.transport !== b.transport || m.destination_ref !== b.destination_ref || m.delivery_config_id !== b.delivery_config_id || m.delivery_config_version !== b.delivery_config_version || m.feed_purpose !== b.feed_purpose || !["manifest_checksums", "canonical_digest"].includes(b.verification_profile) || !Number.isSafeInteger(b.resource_retention_days) || b.resource_retention_days < 1 || b.resource_retention_days > 3650)
+    throw new import_errors.ReportingGcsFenceError("INVALID_INPUT");
+}
+async function createGcsReportingManagedDeliveryAdapterV1(options, context = {}) {
+  const milliseconds = options.operationDeadlineMilliseconds ?? 6e4;
+  const { resolveExpectedPeriod, resolveContractReader, namespace: hostNamespace } = options;
+  const minimumDays = options.minimumResourceRetentionDays ?? 1;
+  if (options.acknowledgeDedicatedFreshBucket !== true || typeof hostNamespace !== "string" || hostNamespace.length < 1 || hostNamespace.length > 255 || !Number.isSafeInteger(minimumDays) || minimumDays < 1 || minimumDays > 3650 || typeof options.resolveExpectedPeriod !== "function" || typeof options.resolveContractReader !== "function")
+    throw new import_errors.ReportingGcsFenceError("INVALID_INPUT");
+  const { storage, coreStore, store, bucket } = options;
+  const { id, fence } = await (0, import_io.withGcsDeadline)(
+    async (signal) => {
+      if (await store.probeObjectWriteAuthority({ signal }) !== true)
+        throw new import_errors.ReportingGcsFenceError("STATE_UNAVAILABLE");
+      (0, import_io.activeGcsSignal)(signal);
+      if (await store.probe(coreStore) !== true) throw new import_errors.ReportingGcsFenceError("STATE_UNAVAILABLE");
+      (0, import_io.activeGcsSignal)(signal);
+      const id2 = await store.getObjectWriteAuthorityId({ signal });
+      (0, import_io.activeGcsSignal)(signal);
+      const fence2 = (0, import_fence.createGcsReportingObjectFenceV1)({
+        storage,
+        store,
+        bucket,
+        namespace: hash((0, import_jcs.canonicalize)([hostNamespace, id2])),
+        operationDeadlineMilliseconds: milliseconds
+      });
+      await fence2.probe({ signal });
+      (0, import_io.activeGcsSignal)(signal);
+      return { id: id2, fence: fence2 };
+    },
+    { signal: context.signal, milliseconds }
+  );
+  const getStatus = (0, import_handler.createReportingStatusHandler)(coreStore);
+  async function readerOptions(binding, signal) {
+    const scope = scopeFor(binding);
+    const provider = await store.getAuthorizedObjectWriteBinding(scope, { signal });
+    (0, import_io.activeGcsSignal)(signal);
+    if (!provider) throw new import_errors.ReportingGcsFenceError("REVOKED");
+    const prefix = `adcp-reporting/${provider.namespace_key}/${(0, import_object_writes.reportingObjectWriteScopeKey)(scope)}/`;
+    return {
+      scope: { ...scope, principal_id: `producer:${id}` },
+      bucket: provider.bucket,
+      objectPrefix: prefix,
+      getStorage: async () => storage,
+      authorize: async (request, call) => {
+        if (request.bucket !== provider.bucket || request.objectPrefix !== prefix || request.scope.principal_id !== `producer:${id}` || request.scope.account_id !== scope.account_id || request.scope.destination_ref !== scope.destination_ref || request.scope.generation !== scope.generation)
+          return false;
+        const current = await store.getAuthorizedObjectWriteBinding(scope, { signal: call.signal });
+        return current?.bucket === provider.bucket && current.namespace_key === provider.namespace_key;
+      },
+      operationDeadlineMilliseconds: milliseconds
+    };
+  }
+  async function trueObligation(input, signal) {
+    let cursor;
+    for (let page = 0; page < 25; page++) {
+      (0, import_io.activeGcsSignal)(signal);
+      const status = await getStatus(
+        {
+          account: { account_id: input.binding.account_id },
+          view: "periods",
+          delivery_config_ids: [input.binding.delivery_config_id],
+          period: input.revision.wireRevision.period,
+          pagination: { max_results: 100, ...cursor ? { cursor } : {} }
+        },
+        { account: { id: input.binding.account_id, account_id: input.binding.account_id }, signal }
+      );
+      (0, import_io.activeGcsSignal)(signal);
+      const selected = status.periods?.find(
+        (value) => value.reporting_obligation_id === input.obligation.reporting_obligation_id
+      );
+      if (selected) return selected;
+      cursor = status.pagination?.cursor;
+      if (!cursor) break;
+    }
+    throw new import_errors.ReportingGcsFenceError("STATE_UNAVAILABLE");
+  }
+  async function hostCallback(work, signal) {
+    try {
+      const result = await work();
+      (0, import_io.activeGcsSignal)(signal);
+      return result;
+    } catch {
+      (0, import_io.activeGcsSignal)(signal);
+      throw new import_errors.ReportingGcsFenceError("HOST_CALLBACK_FAILED");
+    }
+  }
+  return {
+    verificationProfiles: Object.freeze(["manifest_checksums", "canonical_digest"]),
+    revocationFencesDeliveryGenerations: true,
+    async deliver(caller, call) {
+      return (0, import_io.withGcsDeadline)(
+        async (signal) => {
+          matchingBinding(caller);
+          if (!Number.isSafeInteger(caller.maxBytes) || caller.maxBytes < 1 || caller.maxBytes > 64 * 1024 * 1024 || caller.revision.binding.byteCount > caller.maxBytes || caller.revision.rows.length > 1e5)
+            throw new import_errors.ReportingGcsFenceError("INVALID_INPUT");
+          const input = structuredClone(caller);
+          matchingBinding(input);
+          if (input.revision.rows.length > 1e5 || input.revision.binding.byteCount > input.maxBytes || !Number.isSafeInteger(input.maxBytes) || input.maxBytes < 1 || input.maxBytes > 64 * 1024 * 1024)
+            throw new import_errors.ReportingGcsFenceError("INVALID_INPUT");
+          const { revision, binding, materialization, obligation } = input;
+          if (revision.reporting_revision_id !== materialization.reporting_revision_id || revision.reporting_obligation_id !== obligation.reporting_obligation_id || materialization.reporting_obligation_id !== obligation.reporting_obligation_id || obligation.account.account_id !== binding.account_id || obligation.configurationId !== binding.configurationId || obligation.delivery_config_id !== binding.delivery_config_id || obligation.delivery_config_version !== binding.delivery_config_version)
+            throw new import_errors.ReportingGcsFenceError("INVALID_INPUT");
+          const coreBytes = Buffer.from(
+            (0, import_jcs.canonicalize)({
+              reporting_revision_id: revision.reporting_revision_id,
+              row_count: revision.wireRevision.row_count,
+              control_totals: revision.wireRevision.control_totals,
+              reporting_rows: revision.rows
+            })
+          );
+          if (revision.binding.algorithm !== "rfc8785_jcs_v1" || coreBytes.length !== revision.binding.byteCount || hash(coreBytes) !== revision.binding.sha256 || revision.wireRevision.revision_content_sha256 !== revision.binding.sha256 || revision.binding.rowCount !== revision.rows.length || revision.wireRevision.row_count !== revision.rows.length)
+            throw new import_errors.ReportingGcsFenceError("CONTENT_CONFLICT");
+          const expected = await hostCallback(async () => {
+            const value = structuredClone(await resolveExpectedPeriod(structuredClone(input), { signal }));
+            if (!value || typeof value !== "object" || !Array.isArray(value.mediaBuyIds) || !value.coverage || typeof value.coverage !== "object" || Array.isArray(value.coverage) || value.verificationProfile === "canonical_digest" && (!value.canonicalization || typeof value.canonicalization !== "object"))
+              throw new import_errors.ReportingGcsFenceError("HOST_CALLBACK_FAILED");
+            return value;
+          }, signal);
+          (0, import_io.activeGcsSignal)(signal);
+          (0, import_validation.assertExpectedBinding)(input, expected);
+          const actualObligation = await trueObligation(input, signal);
+          const contractOptions = await hostCallback(
+            () => resolveContractReader(structuredClone(input), { signal }),
+            signal
+          );
+          (0, import_io.activeGcsSignal)(signal);
+          if (!contractOptions || typeof contractOptions !== "object" || !contractOptions.scope)
+            throw new import_errors.ReportingGcsFenceError("HOST_CALLBACK_FAILED");
+          let contractResolver;
+          try {
+            contractResolver = (0, import_reader.createGcsReportingReferenceResolverV1)({
+              ...contractOptions,
+              signal: contractOptions.signal ? AbortSignal.any([signal, contractOptions.signal]) : signal
+            });
+          } catch {
+            throw new import_errors.ReportingGcsFenceError("HOST_CALLBACK_FAILED");
+          }
+          if (contractOptions.scope.account_id !== binding.account_id || contractOptions.scope.destination_ref !== binding.destination_ref || contractOptions.scope.generation !== binding.authorization_generation)
+            throw new import_errors.ReportingGcsFenceError("INVALID_INPUT");
+          const rows = Buffer.from(revision.rows.map((row) => (0, import_jcs.canonicalize)(row) + "\n").join(""));
+          const manifestBytes = Buffer.from(
+            (0, import_jcs.canonicalize)({
+              manifest_version: "1.0",
+              complete: true,
+              reporting_revision_id: revision.reporting_revision_id,
+              reporting_obligation_id: obligation.reporting_obligation_id,
+              reporting_materialization_id: materialization.reporting_materialization_id,
+              period: revision.wireRevision.period,
+              format: "jsonl",
+              compression: "none",
+              files: [
+                { object_ref: "0", size_bytes: rows.length, sha256: hash(rows), row_count: revision.rows.length }
+              ],
+              total_size_bytes: rows.length,
+              row_count: revision.rows.length,
+              control_totals: revision.wireRevision.control_totals,
+              created_at: revision.createdAt
+            })
+          );
+          if (rows.length + manifestBytes.length > input.maxBytes) throw new import_errors.ReportingGcsFenceError("INVALID_INPUT");
+          const scope = scopeFor(binding);
+          const plan = await fence.register(scope, deliveryIdentity(input), [rows, manifestBytes], { signal });
+          (0, import_io.activeGcsSignal)(signal);
+          await fence.write(plan, 0, rows, { signal });
+          await fence.write(plan, 1, manifestBytes, { signal });
+          (0, import_io.activeGcsSignal)(signal);
+          const readerConfig = await readerOptions(binding, signal);
+          const location = `https://storage.googleapis.com/${plan.provider.bucket}/${plan.objects[1].object_name}`;
+          const read = await (0, import_reader.createGcsScopedObjectReadV1)(readerConfig)(location, input.maxBytes, signal);
+          (0, import_io.activeGcsSignal)(signal);
+          if (hash(read.body) !== hash(manifestBytes)) throw new import_errors.ReportingGcsFenceError("CONTENT_CONFLICT");
+          const resource = {
+            resource_ref: `gcs:${plan.plan_id}`,
+            kind: "manifest",
+            location,
+            manifest_version: "1.0",
+            manifest_sha256: hash(read.body),
+            immutability: "native_version",
+            native_version_ref: read.generation,
+            expires_at: new Date(
+              Date.now() + Math.max(minimumDays, binding.resource_retention_days) * 864e5
+            ).toISOString(),
+            reader_compatibility: ["jsonl", "utf-8"]
+          };
+          const inspectionContext = {
+            obligation: actualObligation,
+            revision: revision.wireRevision,
+            materialization: { ...materialization, resource },
+            expected
+          };
+          const reader = (0, import_reader.createGcsReportingResourceReaderV1)(readerConfig);
+          const observedChecksums = /* @__PURE__ */ new Map();
+          const inspect = (0, import_inspection.createReportingManifestInspector)({
+            reader: {
+              async read(request) {
+                const result = await reader.read({
+                  ...request,
+                  signal: request.signal ? AbortSignal.any([signal, request.signal]) : signal
+                });
+                (0, import_io.activeGcsSignal)(signal);
+                if (request.role === "object")
+                  observedChecksums.set(request.objectRef, {
+                    object_ref: request.objectRef,
+                    algorithm: "sha256",
+                    value: hash(result.body)
+                  });
+                return result;
+              }
+            },
+            referenceResolver: contractResolver,
+            referenceAllowedOrigins: ["https://storage.googleapis.com"],
+            maxTotalBytes: input.maxBytes,
+            maxObjectBytes: input.maxBytes,
+            maxRows: 1e5
+          });
+          const observation = await inspect(inspectionContext);
+          (0, import_io.activeGcsSignal)(signal);
+          if (!observedChecksums.size) throw new import_errors.ReportingGcsFenceError("CONTENT_CONFLICT");
+          resource.expires_at = new Date(
+            Date.now() + Math.max(minimumDays, binding.resource_retention_days) * 864e5 + milliseconds
+          ).toISOString();
+          const checksums = [...observedChecksums.values()];
+          if (checksums.length !== 1 || checksums[0].object_ref !== "0" || checksums[0].value !== plan.objects[0].sha256)
+            throw new import_errors.ReportingGcsFenceError("CONTENT_CONFLICT");
+          const verification = {
+            verified_at: (/* @__PURE__ */ new Date()).toISOString(),
+            verification_path: "producer",
+            verification_profile: binding.verification_profile,
+            row_count: observation.rowCount,
+            control_totals: observation.controlTotals,
+            physical_checksums: [checksums[0], ...checksums.slice(1)],
+            ...observation.canonicalContentDigest ? { canonical_content_digest: observation.canonicalContentDigest } : {}
+          };
+          if (!await store.getAuthorizedObjectWriteBinding(scope, { signal }))
+            throw new import_errors.ReportingGcsFenceError("REVOKED");
+          (0, import_io.activeGcsSignal)(signal);
+          return { status: "available", resource, verification };
+        },
+        { signal: call.signal, milliseconds }
+      );
+    },
+    async read(caller, call) {
+      return (0, import_io.withGcsDeadline)(
+        async (signal) => {
+          const input = structuredClone(caller);
+          matchingBinding(input);
+          const planId = hash(deliveryIdentity(input));
+          const scope = scopeFor(input.binding);
+          const plan = await store.getObjectWritePlan(scope, planId, { signal });
+          (0, import_io.activeGcsSignal)(signal);
+          if (!plan) throw new import_errors.ReportingGcsFenceError("REVOKED");
+          const location = `https://storage.googleapis.com/${plan.provider.bucket}/${(0, import_object_writes.reportingObjectWriteName)(scope, plan.provider, planId, 1)}`;
+          if (plan.objects.length !== 2 || input.resource.resource_ref !== `gcs:${planId}` || input.resource.location !== location || input.resource.kind !== "manifest" || input.resource.immutability !== "native_version" || !input.resource.native_version_ref || !Number.isFinite(Date.parse(input.resource.expires_at ?? "")) || input.resource.manifest_sha256 !== plan.objects[1]?.sha256)
+            throw new import_errors.ReportingGcsFenceError("INVALID_INPUT");
+          const config = await readerOptions(input.binding, signal);
+          const result = await (0, import_reader.createGcsScopedObjectReadV1)(config)(
+            location,
+            input.maxBytes,
+            signal,
+            input.resource.native_version_ref
+          );
+          if (hash(result.body) !== input.resource.manifest_sha256)
+            throw new import_errors.ReportingGcsFenceError("CONTENT_CONFLICT");
+          return result.body;
+        },
+        { signal: call.signal, milliseconds }
+      );
+    },
+    async revoke(input, call) {
+      await (0, import_io.withGcsDeadline)(
+        async (signal) => {
+          for (let page = 0; page < 1e3; page++) {
+            (0, import_io.activeGcsSignal)(signal);
+            const result = await fence.revoke(input.authorization, { signal });
+            if (result.complete) return;
+            if (result.fenced < 1) throw new import_errors.ReportingGcsFenceError("STATE_UNAVAILABLE");
+          }
+          throw new import_errors.ReportingGcsFenceError("STATE_UNAVAILABLE");
+        },
+        { signal: call.signal, milliseconds }
+      );
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createGcsReportingManagedDeliveryAdapterV1
+});