@adcp/sdk 14.0.0-beta.26 → 14.0.0-beta.28

package/dist/lib/validation/sync-creatives.d.ts

@@ -166,42 +166,20 @@ export declare const SyncCreativesItemSchema: z.ZodObject<{
                 }, z.core.$loose>;
                 method: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
                     pattern: z.ZodLiteral<"file_transfer">;
-                    transport: z.ZodUnion<readonly [z.ZodLiteral<"s3">, z.ZodLiteral<"gcs">, z.ZodLiteral<"azure_blob">]>;
-                    directions: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"buyer_to_seller">, z.ZodLiteral<"seller_to_buyer">]>>>;
-                    vendor: z.ZodObject<{
-                        domain: z.ZodString;
-                        brand_id: z.ZodOptional<z.ZodString>;
-                        countries: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                        industries: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                        data_subject_contestation: z.ZodOptional<z.ZodObject<{
-                            url: z.ZodOptional<z.ZodString>;
-                            email: z.ZodOptional<z.ZodEmail>;
-                            languages: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                        }, z.core.$loose>>;
-                        brand_kit_override: z.ZodOptional<z.ZodObject<{
-                            logo: z.ZodOptional<Omit<z.ZodObject<{
-                                asset_type: z.ZodType<"image", "image", z.core.$ZodTypeInternals<"image", "image">>;
-                                url: z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
-                                width: z.ZodType<number, number, z.core.$ZodTypeInternals<number, number>>;
-                                height: z.ZodType<number, number, z.core.$ZodTypeInternals<number, number>>;
-                                file_size_bytes: z.ZodOptional<z.ZodType<number, number, z.core.$ZodTypeInternals<number, number>>>;
-                                pixel_ratio: z.ZodOptional<z.ZodType<number, number, z.core.$ZodTypeInternals<number, number>>>;
-                                state_id: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
-                                breakpoint_id: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
-                                focal_point: z.ZodOptional<z.ZodType<[number, number], [number, number], z.core.$ZodTypeInternals<[number, number], [number, number]>>>;
-                                format: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
-                                alt_text: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
-                                provenance: z.ZodOptional<z.ZodType<import("..").Provenance, import("..").Provenance, z.core.$ZodTypeInternals<import("..").Provenance, import("..").Provenance>>>;
-                            }, z.core.$loose>, keyof z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>> & z.ZodType<import("..").ImageAsset & Record<string, unknown>, import("..").ImageAsset, z.core.$ZodTypeInternals<import("..").ImageAsset & Record<string, unknown>, import("..").ImageAsset>>>;
-                            colors: z.ZodOptional<z.ZodObject<{
-                                primary: z.ZodOptional<z.ZodString>;
-                                secondary: z.ZodOptional<z.ZodString>;
-                                accent: z.ZodOptional<z.ZodString>;
-                            }, z.core.$loose>>;
-                            voice: z.ZodOptional<z.ZodString>;
-                            tagline: z.ZodOptional<z.ZodString>;
-                        }, z.core.$loose>>;
-                    }, z.core.$loose>;
+                    transport: z.ZodString;
+                    orchestration: z.ZodUnion<readonly [z.ZodLiteral<"producer_managed">, z.ZodLiteral<"consumer_managed">]>;
+                    destination: z.ZodUnion<readonly [z.ZodObject<{
+                        mode: z.ZodLiteral<"existing">;
+                        destination_ref: z.ZodString;
+                    }, z.core.$loose>, z.ZodObject<{
+                        mode: z.ZodLiteral<"provision">;
+                        provider: z.ZodObject<{
+                            domain: z.ZodString;
+                        }, z.core.$loose>;
+                        location: z.ZodString;
+                        access_mode: z.ZodOptional<z.ZodString>;
+                    }, z.core.$loose>]>;
+                    format: z.ZodUnion<readonly [z.ZodLiteral<"jsonl">, z.ZodLiteral<"csv">, z.ZodLiteral<"parquet">, z.ZodLiteral<"avro">, z.ZodLiteral<"orc">]>;
                 }, z.core.$loose>, z.ZodObject<{
                     pattern: z.ZodLiteral<"dataset_share">;
                     transport: z.ZodString;
@@ -538,42 +516,20 @@ export declare const SyncCreativesSuccessStrictSchema: z.ZodObject<{
                     }, z.core.$loose>;
                     method: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
                         pattern: z.ZodLiteral<"file_transfer">;
-                        transport: z.ZodUnion<readonly [z.ZodLiteral<"s3">, z.ZodLiteral<"gcs">, z.ZodLiteral<"azure_blob">]>;
-                        directions: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"buyer_to_seller">, z.ZodLiteral<"seller_to_buyer">]>>>;
-                        vendor: z.ZodObject<{
-                            domain: z.ZodString;
-                            brand_id: z.ZodOptional<z.ZodString>;
-                            countries: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                            industries: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                            data_subject_contestation: z.ZodOptional<z.ZodObject<{
-                                url: z.ZodOptional<z.ZodString>;
-                                email: z.ZodOptional<z.ZodEmail>;
-                                languages: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                            }, z.core.$loose>>;
-                            brand_kit_override: z.ZodOptional<z.ZodObject<{
-                                logo: z.ZodOptional<Omit<z.ZodObject<{
-                                    asset_type: z.ZodType<"image", "image", z.core.$ZodTypeInternals<"image", "image">>;
-                                    url: z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
-                                    width: z.ZodType<number, number, z.core.$ZodTypeInternals<number, number>>;
-                                    height: z.ZodType<number, number, z.core.$ZodTypeInternals<number, number>>;
-                                    file_size_bytes: z.ZodOptional<z.ZodType<number, number, z.core.$ZodTypeInternals<number, number>>>;
-                                    pixel_ratio: z.ZodOptional<z.ZodType<number, number, z.core.$ZodTypeInternals<number, number>>>;
-                                    state_id: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
-                                    breakpoint_id: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
-                                    focal_point: z.ZodOptional<z.ZodType<[number, number], [number, number], z.core.$ZodTypeInternals<[number, number], [number, number]>>>;
-                                    format: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
-                                    alt_text: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
-                                    provenance: z.ZodOptional<z.ZodType<import("..").Provenance, import("..").Provenance, z.core.$ZodTypeInternals<import("..").Provenance, import("..").Provenance>>>;
-                                }, z.core.$loose>, keyof z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>> & z.ZodType<import("..").ImageAsset & Record<string, unknown>, import("..").ImageAsset, z.core.$ZodTypeInternals<import("..").ImageAsset & Record<string, unknown>, import("..").ImageAsset>>>;
-                                colors: z.ZodOptional<z.ZodObject<{
-                                    primary: z.ZodOptional<z.ZodString>;
-                                    secondary: z.ZodOptional<z.ZodString>;
-                                    accent: z.ZodOptional<z.ZodString>;
-                                }, z.core.$loose>>;
-                                voice: z.ZodOptional<z.ZodString>;
-                                tagline: z.ZodOptional<z.ZodString>;
-                            }, z.core.$loose>>;
-                        }, z.core.$loose>;
+                        transport: z.ZodString;
+                        orchestration: z.ZodUnion<readonly [z.ZodLiteral<"producer_managed">, z.ZodLiteral<"consumer_managed">]>;
+                        destination: z.ZodUnion<readonly [z.ZodObject<{
+                            mode: z.ZodLiteral<"existing">;
+                            destination_ref: z.ZodString;
+                        }, z.core.$loose>, z.ZodObject<{
+                            mode: z.ZodLiteral<"provision">;
+                            provider: z.ZodObject<{
+                                domain: z.ZodString;
+                            }, z.core.$loose>;
+                            location: z.ZodString;
+                            access_mode: z.ZodOptional<z.ZodString>;
+                        }, z.core.$loose>]>;
+                        format: z.ZodUnion<readonly [z.ZodLiteral<"jsonl">, z.ZodLiteral<"csv">, z.ZodLiteral<"parquet">, z.ZodLiteral<"avro">, z.ZodLiteral<"orc">]>;
                     }, z.core.$loose>, z.ZodObject<{
                         pattern: z.ZodLiteral<"dataset_share">;
                         transport: z.ZodString;
@@ -922,42 +878,20 @@ export declare const SyncCreativesResponseStrictSchema: z.ZodUnion<readonly [z.Z
                     }, z.core.$loose>;
                     method: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
                         pattern: z.ZodLiteral<"file_transfer">;
-                        transport: z.ZodUnion<readonly [z.ZodLiteral<"s3">, z.ZodLiteral<"gcs">, z.ZodLiteral<"azure_blob">]>;
-                        directions: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"buyer_to_seller">, z.ZodLiteral<"seller_to_buyer">]>>>;
-                        vendor: z.ZodObject<{
-                            domain: z.ZodString;
-                            brand_id: z.ZodOptional<z.ZodString>;
-                            countries: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                            industries: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                            data_subject_contestation: z.ZodOptional<z.ZodObject<{
-                                url: z.ZodOptional<z.ZodString>;
-                                email: z.ZodOptional<z.ZodEmail>;
-                                languages: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                            }, z.core.$loose>>;
-                            brand_kit_override: z.ZodOptional<z.ZodObject<{
-                                logo: z.ZodOptional<Omit<z.ZodObject<{
-                                    asset_type: z.ZodType<"image", "image", z.core.$ZodTypeInternals<"image", "image">>;
-                                    url: z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
-                                    width: z.ZodType<number, number, z.core.$ZodTypeInternals<number, number>>;
-                                    height: z.ZodType<number, number, z.core.$ZodTypeInternals<number, number>>;
-                                    file_size_bytes: z.ZodOptional<z.ZodType<number, number, z.core.$ZodTypeInternals<number, number>>>;
-                                    pixel_ratio: z.ZodOptional<z.ZodType<number, number, z.core.$ZodTypeInternals<number, number>>>;
-                                    state_id: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
-                                    breakpoint_id: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
-                                    focal_point: z.ZodOptional<z.ZodType<[number, number], [number, number], z.core.$ZodTypeInternals<[number, number], [number, number]>>>;
-                                    format: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
-                                    alt_text: z.ZodOptional<z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>>;
-                                    provenance: z.ZodOptional<z.ZodType<import("..").Provenance, import("..").Provenance, z.core.$ZodTypeInternals<import("..").Provenance, import("..").Provenance>>>;
-                                }, z.core.$loose>, keyof z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>> & z.ZodType<import("..").ImageAsset & Record<string, unknown>, import("..").ImageAsset, z.core.$ZodTypeInternals<import("..").ImageAsset & Record<string, unknown>, import("..").ImageAsset>>>;
-                                colors: z.ZodOptional<z.ZodObject<{
-                                    primary: z.ZodOptional<z.ZodString>;
-                                    secondary: z.ZodOptional<z.ZodString>;
-                                    accent: z.ZodOptional<z.ZodString>;
-                                }, z.core.$loose>>;
-                                voice: z.ZodOptional<z.ZodString>;
-                                tagline: z.ZodOptional<z.ZodString>;
-                            }, z.core.$loose>>;
-                        }, z.core.$loose>;
+                        transport: z.ZodString;
+                        orchestration: z.ZodUnion<readonly [z.ZodLiteral<"producer_managed">, z.ZodLiteral<"consumer_managed">]>;
+                        destination: z.ZodUnion<readonly [z.ZodObject<{
+                            mode: z.ZodLiteral<"existing">;
+                            destination_ref: z.ZodString;
+                        }, z.core.$loose>, z.ZodObject<{
+                            mode: z.ZodLiteral<"provision">;
+                            provider: z.ZodObject<{
+                                domain: z.ZodString;
+                            }, z.core.$loose>;
+                            location: z.ZodString;
+                            access_mode: z.ZodOptional<z.ZodString>;
+                        }, z.core.$loose>]>;
+                        format: z.ZodUnion<readonly [z.ZodLiteral<"jsonl">, z.ZodLiteral<"csv">, z.ZodLiteral<"parquet">, z.ZodLiteral<"avro">, z.ZodLiteral<"orc">]>;
                     }, z.core.$loose>, z.ZodObject<{
                         pattern: z.ZodLiteral<"dataset_share">;
                         transport: z.ZodString;

package/dist/lib/version.d.mts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "14.0.0-beta.26";
+export declare const LIBRARY_VERSION = "14.0.0-beta.28";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "14.0.0-beta.26";
+    readonly library: "14.0.0-beta.28";
     readonly adcp: "3.2.0-beta.10";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0-beta.1", "3.0-beta", "3.0.0-beta.3", "3.0-beta.3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.2.0-beta.10", "3.2-beta.10"];
-    readonly generatedAt: "2026-09-01T23:32:34.220Z";
+    readonly generatedAt: "2026-09-02T09:57:23.680Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.d.ts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "14.0.0-beta.26";
+export declare const LIBRARY_VERSION = "14.0.0-beta.28";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "14.0.0-beta.26";
+    readonly library: "14.0.0-beta.28";
     readonly adcp: "3.2.0-beta.10";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0-beta.1", "3.0-beta", "3.0.0-beta.3", "3.0-beta.3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.2.0-beta.10", "3.2-beta.10"];
-    readonly generatedAt: "2026-09-01T23:32:34.220Z";
+    readonly generatedAt: "2026-09-02T09:57:23.680Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.js

@@ -31,7 +31,7 @@ __export(version_exports, {
   toReleasePrecisionVersion: () => toReleasePrecisionVersion
 });
 module.exports = __toCommonJS(version_exports);
-const LIBRARY_VERSION = "14.0.0-beta.26";
+const LIBRARY_VERSION = "14.0.0-beta.28";
 const ADCP_VERSION = "3.2.0-beta.10";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
@@ -94,10 +94,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.2-beta.10"
 ];
 const VERSION_INFO = {
-  library: "14.0.0-beta.26",
+  library: "14.0.0-beta.28",
   adcp: "3.2.0-beta.10",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-09-01T23:32:34.220Z"
+  generatedAt: "2026-09-02T09:57:23.680Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;

package/dist/lib/version.mjs

@@ -1,4 +1,4 @@
-const LIBRARY_VERSION = "14.0.0-beta.26";
+const LIBRARY_VERSION = "14.0.0-beta.28";
 const ADCP_VERSION = "3.2.0-beta.10";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
@@ -61,10 +61,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.2-beta.10"
 ];
 const VERSION_INFO = {
-  library: "14.0.0-beta.26",
+  library: "14.0.0-beta.28",
   adcp: "3.2.0-beta.10",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-09-01T23:32:34.220Z"
+  generatedAt: "2026-09-02T09:57:23.680Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;

package/docs/TYPE-SUMMARY.md

@@ -1,7 +1,7 @@
 # AdCP Type Summary
 
-> Generated at: 2026-09-01
-> @adcp/sdk v14.0.0-beta.26
+> Generated at: 2026-09-02
+> @adcp/sdk v14.0.0-beta.28
 
 Curated reference of the types that matter for using the AdCP client. For full generated types see `src/lib/types/tools.generated.ts` and `src/lib/types/core.generated.ts`.
 

package/docs/guides/REPORTING-RECONCILIATION.md

@@ -0,0 +1,107 @@
+# Reporting reconciliation
+
+`reconcileReporting` turns the reporting ledger into a buyer-verifiable result. It reads one stable ledger snapshot, checks the expected period set, inspects each current destination materialization, submits any required consumer receipts, and then reads the seller's ledger back before returning.
+
+The helper only returns `definitive: true` when all of these conditions hold:
+
+- the buyer supplies its own complete `expectedPeriods` denominator;
+- the seller closes the requested scope and declares its coverage complete;
+- every expected report definition, feed, reporting profile, campaign set, and period has an obligation;
+- every obligation's history counts match the returned immutable records;
+- the current revision has the required finality;
+- a verified, unexpired materialization matches the obligation;
+- every consumer-receipt obligation has an accepted receipt for the same revision, materialization, row count, control totals, and required verification evidence.
+
+An omitted expected-period denominator can still diagnose delivery, but can never prove completeness. Pass `[]` only when the buyer independently knows that no periods are expected in the requested scope.
+
+```ts
+import {
+  createHttpsReportingResourceReader,
+  reconcileReporting,
+} from '@adcp/sdk';
+
+const result = await reconcileReporting({
+  client: seller,
+  request: {
+    account: { account_id: 'account-1' },
+    period: {
+      start: '2026-08-01T00:00:00Z',
+      end: '2026-09-01T00:00:00Z',
+    },
+  },
+  expectedPeriods: [{
+    deliveryConfigId: 'billing-feed',
+    deliveryConfigVersion: 3,
+    reportDefinitionId: 'billing-v1',
+    feedPurpose: 'billing',
+    reportingProfile: 'billing-v1',
+    mediaBuyIds: ['buy-1', 'buy-2'],
+    destinationRef: 'destination-billing-v3',
+    deliveryMethod: 'file_transfer',
+    requiredFinality: 'official',
+    reconciliationMode: 'consumer_receipt',
+    coverageRequirement: 'full',
+    coverage: {
+      status: 'full',
+      media_buy_ids: ['buy-1', 'buy-2'],
+      fully_covered_media_buy_ids: ['buy-1', 'buy-2'],
+      partially_covered_media_buy_ids: [],
+      unsupported_media_buy_ids: [],
+      unknown_media_buy_ids: [],
+      package_ids: ['package-1', 'package-2'],
+      covered_package_ids: ['package-1', 'package-2'],
+      unsupported_package_ids: [],
+      unknown_package_ids: [],
+    },
+    reportDefinitionUri: 'https://schemas.seller.example/report-definitions/billing-v1.json',
+    reportDefinitionSha256: savedBillingDefinitionSha256,
+    schemaVersion: '1',
+    schemaUri: 'https://schemas.seller.example/reporting/billing-v1.json',
+    schemaSha256: savedBillingSchemaSha256,
+    schemaDialect: 'https://json-schema.org/draft/2020-12/schema',
+    schemaRefPolicy: 'local_fragment_only',
+    officialFinality: {
+      policyId: 'billing-close-v1',
+      basis: 'contractual_cutoff',
+    },
+    verificationProfile: 'canonical_digest',
+    canonicalization: {
+      id: 'billing-rows-v1',
+      uri: 'https://schemas.seller.example/canonicalization/billing-rows-v1.json',
+      sha256: savedCanonicalizationSha256,
+      primaryKeys: ['media_buy_id', 'date'],
+    },
+    periodStart: '2026-08-01T00:00:00Z',
+    periodEnd: '2026-09-01T00:00:00Z',
+  }],
+  resourceReader: createHttpsReportingResourceReader(),
+  credentialProvider: {
+    async getCredentials({ obligation }) {
+      const destination = await loadSavedDestination(obligation.destination_ref);
+      return {
+        headers: {
+          authorization: `Bearer ${await destinationToken(obligation.destination_ref)}`,
+        },
+        allowedOrigins: [destination.readerOrigin],
+      };
+    },
+  },
+  manifestInspectorOptions: {
+    referenceAllowedOrigins: ['https://schemas.seller.example'],
+    consumerCommitRef: 'buyer-reporting-ledger:2026-08',
+    maxInspectionMs: 60_000,
+  },
+});
+
+if (!result.definitive) {
+  throw new Error('Reporting is not ready for billing');
+}
+```
+
+When `inspect` is omitted, `resourceReader` enables the built-in manifest path. It verifies the exact manifest bytes before parsing, manifest identity and completeness, every object size and SHA-256, declared compression and format, the pinned row schema and report definition, row count and control totals, and the pinned RFC 8785 canonical-content contract. The bundled decoders cover JSONL and CSV with `none` or `gzip` compression. Configure format/compression decoders for Parquet, Avro, ORC, Zstandard, or Snappy. The aggregate inspection deadline covers credential lookup, reads, reference resolution, custom adapters, validation, and canonicalization.
+
+The HTTPS reader applies the SDK's DNS-pinned SSRF controls, refuses redirects and cross-origin `object_ref` values, and accepts short-lived headers only through the credential provider. `allowedOrigins` must come from the consumer's saved destination configuration; the reader refuses to send credentials to an origin named only by the seller's resource descriptor. For S3, GCS, or Azure, implement `ReportingResourceReader`; it receives the destination-bound context and opaque credentials without placing either in the ledger or receipt. Complex control totals can supply `controlTotalCalculator`; the default handles only report-definition metrics whose declared aggregation is `sum` and whose `source_expression` resolves to numeric row values.
+
+Keep `inspect` as the advanced override for native snapshots. A BigQuery adapter can inspect a table version, while Snowflake or Databricks adapters can verify a shared relation. `ReportingInspectionError.retryable` distinguishes transport/readiness failures from permanent digest, schema, or integrity failures, so permanent failures are never retried. Store receipts in a durable `checkpointStore` so a process restart does not repeat destination work. Set `checkpointScope` to a stable, non-secret seller-and-authenticated-principal identifier; checkpoint keys also include account, obligation, revision, materialization, and destination. The checkpoint preserves the receipt-write idempotency key across uncertain retries.
+
+Totals are returned once per canonical reporting revision. Each entry includes its coverage status and covered/package denominators, so partial evidence cannot be mistaken for full billing totals. Delivering the same revision to a buyer, governance agent, and archive destination does not multiply its rows or financial control totals. Each consumer still authenticates independently and submits its own receipt; one consumer's acceptance never implies another's.

package/docs/llms.txt

@@ -1,7 +1,7 @@
 # Ad Context Protocol (AdCP)
 
-> Generated at: 2026-09-01
-> Library: @adcp/sdk v14.0.0-beta.26
+> Generated at: 2026-09-02
+> Library: @adcp/sdk v14.0.0-beta.28
 > AdCP major version: 3
 > Canonical URL: https://adcontextprotocol.github.io/adcp-client/llms.txt
 > Note: the `Library` stamp reflects the package.json version at doc-generation time. The narrative below describes the surface that lands on the next-published minor — including any 6.7 helpers documented here ahead of the release tag.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adcp/sdk",
-  "version": "14.0.0-beta.26",
+  "version": "14.0.0-beta.28",
   "description": "AdCP SDK — client, server, and compliance harnesses for the AdContext Protocol (MCP + A2A)",
   "workspaces": [
     ".",