@adcp/sdk 6.13.2 → 6.15.0

package/dist/lib/utils/build-creative-return-builders.js

@@ -0,0 +1,42 @@
+"use strict";
+// Typed factory helpers for `build_creative` return values. Four shapes:
+//   1. bare `CreativeManifest`            — auto-wrapped as `{ creative_manifest }`
+//   2. bare `CreativeManifest[]`          — auto-wrapped as `{ creative_manifests }`
+//   3. shaped `BuildCreativeSuccess`      — passthrough
+//   4. shaped `BuildCreativeMultiSuccess` — passthrough multi-format
+//
+// Adopters writing the shaped envelope by hand consistently miss the
+// distinction between single (`creative_manifest`) and multi
+// (`creative_manifests`) field names. SHAPE-GOTCHAS §5.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCreativeReturn = void 0;
+exports.singleBuildCreativeReturn = singleBuildCreativeReturn;
+exports.multiBuildCreativeReturn = multiBuildCreativeReturn;
+exports.singleEnvelopedBuildCreativeReturn = singleEnvelopedBuildCreativeReturn;
+exports.multiEnvelopedBuildCreativeReturn = multiEnvelopedBuildCreativeReturn;
+/** Bare single-format manifest. Framework wraps as `{ creative_manifest }`. */
+function singleBuildCreativeReturn(manifest) {
+    return manifest;
+}
+/** Bare multi-format manifest array. Framework wraps as `{ creative_manifests }`. */
+function multiBuildCreativeReturn(manifests) {
+    return manifests;
+}
+/** Shaped `BuildCreativeSuccess`. `manifest` field renamed to `creative_manifest` on wire. */
+function singleEnvelopedBuildCreativeReturn(fields) {
+    const { manifest, ...rest } = fields;
+    return { ...rest, creative_manifest: manifest };
+}
+/** Shaped `BuildCreativeMultiSuccess`. `manifests` renamed to `creative_manifests` on wire. */
+function multiEnvelopedBuildCreativeReturn(fields) {
+    const { manifests, ...rest } = fields;
+    return { ...rest, creative_manifests: manifests };
+}
+/** Grouped accessor for the four `build_creative` return shapes. */
+exports.buildCreativeReturn = {
+    single: singleBuildCreativeReturn,
+    multi: multiBuildCreativeReturn,
+    singleEnveloped: singleEnvelopedBuildCreativeReturn,
+    multiEnveloped: multiEnvelopedBuildCreativeReturn,
+};
+//# sourceMappingURL=build-creative-return-builders.js.map

package/dist/lib/utils/build-creative-return-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-creative-return-builders.js","sourceRoot":"","sources":["../../../src/lib/utils/build-creative-return-builders.ts"],"names":[],"mappings":";AAAA,yEAAyE;AACzE,oFAAoF;AACpF,qFAAqF;AACrF,wDAAwD;AACxD,qEAAqE;AACrE,EAAE;AACF,qEAAqE;AACrE,6DAA6D;AAC7D,wDAAwD;;;AAQxD,8DAEC;AAGD,4DAEC;AAGD,gFAGC;AAGD,8EAGC;AApBD,+EAA+E;AAC/E,SAAgB,yBAAyB,CAAC,QAA0B;IAClE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qFAAqF;AACrF,SAAgB,wBAAwB,CAAC,SAA6B;IACpE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,8FAA8F;AAC9F,SAAgB,kCAAkC,CAAC,MAA4B;IAC7E,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACrC,OAAO,EAAE,GAAG,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC;AAClD,CAAC;AAED,+FAA+F;AAC/F,SAAgB,iCAAiC,CAAC,MAA2B;IAC3E,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACtC,OAAO,EAAE,GAAG,IAAI,EAAE,kBAAkB,EAAE,SAAS,EAAE,CAAC;AACpD,CAAC;AAED,oEAAoE;AACvD,QAAA,mBAAmB,GAAG;IACjC,MAAM,EAAE,yBAAyB;IACjC,KAAK,EAAE,wBAAwB;IAC/B,eAAe,EAAE,kCAAkC;IACnD,cAAc,EAAE,iCAAiC;CACzC,CAAC"}

package/dist/lib/utils/media-buy-delivery-notification-builders.d.ts

@@ -0,0 +1,25 @@
+import type { GetMediaBuyDeliveryResponse } from '../types/core.generated';
+type NotificationFields = Omit<GetMediaBuyDeliveryResponse, 'notification_type'>;
+type Tagged<Tag extends string> = NotificationFields & {
+    notification_type: Tag;
+};
+/** Regular periodic delivery update. Set `sequence_number` and `next_expected_at`. */
+export declare function scheduledMediaBuyDeliveryNotification(fields: NotificationFields): Tagged<'scheduled'>;
+/** Campaign completed; no further notifications. Omit `next_expected_at`. */
+export declare function finalMediaBuyDeliveryNotification(fields: NotificationFields): Tagged<'final'>;
+/** Data not yet available. Set `partial_data: true` and `unavailable_count`. */
+export declare function delayedMediaBuyDeliveryNotification(fields: NotificationFields): Tagged<'delayed'>;
+/** Re-send with corrected data, SAME measurement window. Distinct from `window_update`. */
+export declare function adjustedMediaBuyDeliveryNotification(fields: NotificationFields): Tagged<'adjusted'>;
+/** Re-send with WIDER measurement window (e.g. C7 superseding C3). */
+export declare function windowUpdateMediaBuyDeliveryNotification(fields: NotificationFields): Tagged<'window_update'>;
+/** Grouped accessor for all five `MediaBuyDeliveryNotification` variants. */
+export declare const mediaBuyDeliveryNotification: {
+    readonly scheduled: typeof scheduledMediaBuyDeliveryNotification;
+    readonly final: typeof finalMediaBuyDeliveryNotification;
+    readonly delayed: typeof delayedMediaBuyDeliveryNotification;
+    readonly adjusted: typeof adjustedMediaBuyDeliveryNotification;
+    readonly windowUpdate: typeof windowUpdateMediaBuyDeliveryNotification;
+};
+export {};
+//# sourceMappingURL=media-buy-delivery-notification-builders.d.ts.map

package/dist/lib/utils/media-buy-delivery-notification-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-buy-delivery-notification-builders.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/media-buy-delivery-notification-builders.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAE3E,KAAK,kBAAkB,GAAG,IAAI,CAAC,2BAA2B,EAAE,mBAAmB,CAAC,CAAC;AACjF,KAAK,MAAM,CAAC,GAAG,SAAS,MAAM,IAAI,kBAAkB,GAAG;IAAE,iBAAiB,EAAE,GAAG,CAAA;CAAE,CAAC;AAElF,sFAAsF;AACtF,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAAC,WAAW,CAAC,CAErG;AAED,6EAA6E;AAC7E,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC,CAE7F;AAED,gFAAgF;AAChF,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAAC,SAAS,CAAC,CAEjG;AAED,2FAA2F;AAC3F,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAAC,UAAU,CAAC,CAEnG;AAED,sEAAsE;AACtE,wBAAgB,wCAAwC,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAAC,eAAe,CAAC,CAE5G;AAED,6EAA6E;AAC7E,eAAO,MAAM,4BAA4B;;;;;;CAM/B,CAAC"}

package/dist/lib/utils/media-buy-delivery-notification-builders.js

@@ -0,0 +1,41 @@
+"use strict";
+// Typed factory helpers for `get_media_buy_delivery` webhook notifications.
+// `notification_type` discriminator carries five values, each with distinct
+// re-send / supersession semantics:
+//   `scheduled` / `final` / `delayed` / `adjusted` / `window_update`.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mediaBuyDeliveryNotification = void 0;
+exports.scheduledMediaBuyDeliveryNotification = scheduledMediaBuyDeliveryNotification;
+exports.finalMediaBuyDeliveryNotification = finalMediaBuyDeliveryNotification;
+exports.delayedMediaBuyDeliveryNotification = delayedMediaBuyDeliveryNotification;
+exports.adjustedMediaBuyDeliveryNotification = adjustedMediaBuyDeliveryNotification;
+exports.windowUpdateMediaBuyDeliveryNotification = windowUpdateMediaBuyDeliveryNotification;
+/** Regular periodic delivery update. Set `sequence_number` and `next_expected_at`. */
+function scheduledMediaBuyDeliveryNotification(fields) {
+    return { ...fields, notification_type: 'scheduled' };
+}
+/** Campaign completed; no further notifications. Omit `next_expected_at`. */
+function finalMediaBuyDeliveryNotification(fields) {
+    return { ...fields, notification_type: 'final' };
+}
+/** Data not yet available. Set `partial_data: true` and `unavailable_count`. */
+function delayedMediaBuyDeliveryNotification(fields) {
+    return { ...fields, notification_type: 'delayed' };
+}
+/** Re-send with corrected data, SAME measurement window. Distinct from `window_update`. */
+function adjustedMediaBuyDeliveryNotification(fields) {
+    return { ...fields, notification_type: 'adjusted' };
+}
+/** Re-send with WIDER measurement window (e.g. C7 superseding C3). */
+function windowUpdateMediaBuyDeliveryNotification(fields) {
+    return { ...fields, notification_type: 'window_update' };
+}
+/** Grouped accessor for all five `MediaBuyDeliveryNotification` variants. */
+exports.mediaBuyDeliveryNotification = {
+    scheduled: scheduledMediaBuyDeliveryNotification,
+    final: finalMediaBuyDeliveryNotification,
+    delayed: delayedMediaBuyDeliveryNotification,
+    adjusted: adjustedMediaBuyDeliveryNotification,
+    windowUpdate: windowUpdateMediaBuyDeliveryNotification,
+};
+//# sourceMappingURL=media-buy-delivery-notification-builders.js.map

package/dist/lib/utils/media-buy-delivery-notification-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-buy-delivery-notification-builders.js","sourceRoot":"","sources":["../../../src/lib/utils/media-buy-delivery-notification-builders.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,4EAA4E;AAC5E,oCAAoC;AACpC,sEAAsE;;;AAQtE,sFAEC;AAGD,8EAEC;AAGD,kFAEC;AAGD,oFAEC;AAGD,4FAEC;AAvBD,sFAAsF;AACtF,SAAgB,qCAAqC,CAAC,MAA0B;IAC9E,OAAO,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC;AACvD,CAAC;AAED,6EAA6E;AAC7E,SAAgB,iCAAiC,CAAC,MAA0B;IAC1E,OAAO,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC;AACnD,CAAC;AAED,gFAAgF;AAChF,SAAgB,mCAAmC,CAAC,MAA0B;IAC5E,OAAO,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC;AACrD,CAAC;AAED,2FAA2F;AAC3F,SAAgB,oCAAoC,CAAC,MAA0B;IAC7E,OAAO,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC;AACtD,CAAC;AAED,sEAAsE;AACtE,SAAgB,wCAAwC,CAAC,MAA0B;IACjF,OAAO,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAC;AAC3D,CAAC;AAED,6EAA6E;AAChE,QAAA,4BAA4B,GAAG;IAC1C,SAAS,EAAE,qCAAqC;IAChD,KAAK,EAAE,iCAAiC;IACxC,OAAO,EAAE,mCAAmC;IAC5C,QAAQ,EAAE,oCAAoC;IAC9C,YAAY,EAAE,wCAAwC;CAC9C,CAAC"}

package/dist/lib/utils/preview-creative-builders.d.ts

@@ -0,0 +1,18 @@
+import type { PreviewCreativeSingleResponse, PreviewCreativeBatchResponse, PreviewCreativeVariantResponse } from '../types/core.generated';
+type Tagged<T, Tag extends string> = Omit<T, 'response_type'> & {
+    response_type: Tag;
+};
+/** Build a `single`-variant `PreviewCreativeResponse`. */
+export declare function singlePreviewCreativeResponse(fields: Omit<PreviewCreativeSingleResponse, 'response_type'>): Tagged<PreviewCreativeSingleResponse, 'single'>;
+/** Build a `batch`-variant `PreviewCreativeResponse`. */
+export declare function batchPreviewCreativeResponse(fields: Omit<PreviewCreativeBatchResponse, 'response_type'>): Tagged<PreviewCreativeBatchResponse, 'batch'>;
+/** Build a `variant`-variant `PreviewCreativeResponse`. */
+export declare function variantPreviewCreativeResponse(fields: Omit<PreviewCreativeVariantResponse, 'response_type'>): Tagged<PreviewCreativeVariantResponse, 'variant'>;
+/** Grouped accessor for the three `PreviewCreativeResponse` variants. */
+export declare const previewCreative: {
+    readonly single: typeof singlePreviewCreativeResponse;
+    readonly batch: typeof batchPreviewCreativeResponse;
+    readonly variant: typeof variantPreviewCreativeResponse;
+};
+export {};
+//# sourceMappingURL=preview-creative-builders.d.ts.map

package/dist/lib/utils/preview-creative-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-creative-builders.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/preview-creative-builders.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAC5B,8BAA8B,EAC/B,MAAM,yBAAyB,CAAC;AAEjC,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,IAAI,IAAI,CAAC,CAAC,EAAE,eAAe,CAAC,GAAG;IAAE,aAAa,EAAE,GAAG,CAAA;CAAE,CAAC;AAEvF,0DAA0D;AAC1D,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,IAAI,CAAC,6BAA6B,EAAE,eAAe,CAAC,GAC3D,MAAM,CAAC,6BAA6B,EAAE,QAAQ,CAAC,CAEjD;AAED,yDAAyD;AACzD,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,eAAe,CAAC,GAC1D,MAAM,CAAC,4BAA4B,EAAE,OAAO,CAAC,CAE/C;AAED,2DAA2D;AAC3D,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,IAAI,CAAC,8BAA8B,EAAE,eAAe,CAAC,GAC5D,MAAM,CAAC,8BAA8B,EAAE,SAAS,CAAC,CAEnD;AAED,yEAAyE;AACzE,eAAO,MAAM,eAAe;;;;CAIlB,CAAC"}

package/dist/lib/utils/preview-creative-builders.js

@@ -0,0 +1,28 @@
+"use strict";
+// Typed factory helpers for `preview_creative` responses. Schema oneOf is a
+// three-way switch on `response_type: "single" | "batch" | "variant"`.
+// SHAPE-GOTCHAS §4.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.previewCreative = void 0;
+exports.singlePreviewCreativeResponse = singlePreviewCreativeResponse;
+exports.batchPreviewCreativeResponse = batchPreviewCreativeResponse;
+exports.variantPreviewCreativeResponse = variantPreviewCreativeResponse;
+/** Build a `single`-variant `PreviewCreativeResponse`. */
+function singlePreviewCreativeResponse(fields) {
+    return { ...fields, response_type: 'single' };
+}
+/** Build a `batch`-variant `PreviewCreativeResponse`. */
+function batchPreviewCreativeResponse(fields) {
+    return { ...fields, response_type: 'batch' };
+}
+/** Build a `variant`-variant `PreviewCreativeResponse`. */
+function variantPreviewCreativeResponse(fields) {
+    return { ...fields, response_type: 'variant' };
+}
+/** Grouped accessor for the three `PreviewCreativeResponse` variants. */
+exports.previewCreative = {
+    single: singlePreviewCreativeResponse,
+    batch: batchPreviewCreativeResponse,
+    variant: variantPreviewCreativeResponse,
+};
+//# sourceMappingURL=preview-creative-builders.js.map

package/dist/lib/utils/preview-creative-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-creative-builders.js","sourceRoot":"","sources":["../../../src/lib/utils/preview-creative-builders.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,uEAAuE;AACvE,oBAAoB;;;AAWpB,sEAIC;AAGD,oEAIC;AAGD,wEAIC;AAnBD,0DAA0D;AAC1D,SAAgB,6BAA6B,CAC3C,MAA4D;IAE5D,OAAO,EAAE,GAAG,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;AAChD,CAAC;AAED,yDAAyD;AACzD,SAAgB,4BAA4B,CAC1C,MAA2D;IAE3D,OAAO,EAAE,GAAG,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC;AAED,2DAA2D;AAC3D,SAAgB,8BAA8B,CAC5C,MAA6D;IAE7D,OAAO,EAAE,GAAG,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;AACjD,CAAC;AAED,yEAAyE;AAC5D,QAAA,eAAe,GAAG;IAC7B,MAAM,EAAE,6BAA6B;IACrC,KAAK,EAAE,4BAA4B;IACnC,OAAO,EAAE,8BAA8B;CAC/B,CAAC"}

package/dist/lib/utils/signal-id-builders.d.ts

@@ -0,0 +1,21 @@
+import type { SignalID } from '../types/core.generated';
+type CatalogSignal = Extract<SignalID, {
+    source: 'catalog';
+}>;
+type AgentSignal = Extract<SignalID, {
+    source: 'agent';
+}>;
+type Tagged<T, Tag extends string> = Omit<T, 'source'> & {
+    source: Tag;
+};
+/** Build a `catalog`-variant `SignalID`. Verifiable via the providers adagents.json. */
+export declare function catalogSignalId(fields: Omit<CatalogSignal, 'source'>): Tagged<CatalogSignal, 'catalog'>;
+/** Build an `agent`-variant `SignalID`. Agent-native segments not in a catalog. */
+export declare function agentSignalId(fields: Omit<AgentSignal, 'source'>): Tagged<AgentSignal, 'agent'>;
+/** Grouped accessor for both `SignalID` variants. */
+export declare const signalId: {
+    readonly catalog: typeof catalogSignalId;
+    readonly agent: typeof agentSignalId;
+};
+export {};
+//# sourceMappingURL=signal-id-builders.d.ts.map

package/dist/lib/utils/signal-id-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-id-builders.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/signal-id-builders.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,KAAK,aAAa,GAAG,OAAO,CAAC,QAAQ,EAAE;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAC9D,KAAK,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAC1D,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,IAAI,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG;IAAE,MAAM,EAAE,GAAG,CAAA;CAAE,CAAC;AAEzE,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,CAEvG;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAE/F;AAED,qDAAqD;AACrD,eAAO,MAAM,QAAQ;;;CAGX,CAAC"}

package/dist/lib/utils/signal-id-builders.js

@@ -0,0 +1,24 @@
+"use strict";
+// Typed factory helpers for `SignalID` — provenance tuple used in
+// `signal_ids` filters and as the `signal_id` field on `Signal` records.
+// Schema oneOf on `source: "catalog" | "agent"`. Adopters emit bare ID
+// strings for `signal_ids` filters even though the wire shape is an array
+// of provenance objects. SHAPE-GOTCHAS §2.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signalId = void 0;
+exports.catalogSignalId = catalogSignalId;
+exports.agentSignalId = agentSignalId;
+/** Build a `catalog`-variant `SignalID`. Verifiable via the providers adagents.json. */
+function catalogSignalId(fields) {
+    return { ...fields, source: 'catalog' };
+}
+/** Build an `agent`-variant `SignalID`. Agent-native segments not in a catalog. */
+function agentSignalId(fields) {
+    return { ...fields, source: 'agent' };
+}
+/** Grouped accessor for both `SignalID` variants. */
+exports.signalId = {
+    catalog: catalogSignalId,
+    agent: agentSignalId,
+};
+//# sourceMappingURL=signal-id-builders.js.map

package/dist/lib/utils/signal-id-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-id-builders.js","sourceRoot":"","sources":["../../../src/lib/utils/signal-id-builders.ts"],"names":[],"mappings":";AAAA,kEAAkE;AAClE,yEAAyE;AACzE,uEAAuE;AACvE,0EAA0E;AAC1E,2CAA2C;;;AAS3C,0CAEC;AAGD,sCAEC;AARD,wFAAwF;AACxF,SAAgB,eAAe,CAAC,MAAqC;IACnE,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC1C,CAAC;AAED,mFAAmF;AACnF,SAAgB,aAAa,CAAC,MAAmC;IAC/D,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACxC,CAAC;AAED,qDAAqD;AACxC,QAAA,QAAQ,GAAG;IACtB,OAAO,EAAE,eAAe;IACxB,KAAK,EAAE,aAAa;CACZ,CAAC"}

package/dist/lib/version.d.ts

@@ -1,11 +1,11 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "6.13.2";
+export declare const LIBRARY_VERSION = "6.15.0";
 /**
  * AdCP specification version this library is built for
  */
-export declare const ADCP_VERSION = "3.0.6";
+export declare const ADCP_VERSION = "3.0.8";
 /**
  * AdCP major version sent with every request (adcp_major_version field).
  * Sellers validate this against their supported versions and return
@@ -15,7 +15,7 @@ export declare const ADCP_MAJOR_VERSION = 3;
 /**
  * AdCP versions this library maintains backward compatibility with
  */
-export declare const COMPATIBLE_ADCP_VERSIONS: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0.0-beta.3", "3.0.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6"];
+export declare const COMPATIBLE_ADCP_VERSIONS: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0.0-beta.3", "3.0.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"];
 /**
  * String literal union of every AdCP version the SDK formally supports.
  *
@@ -29,10 +29,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "6.13.2";
-    readonly adcp: "3.0.6";
-    readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0.0-beta.3", "3.0.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6"];
-    readonly generatedAt: "2026-05-08T10:37:20.162Z";
+    readonly library: "6.15.0";
+    readonly adcp: "3.0.8";
+    readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0.0-beta.3", "3.0.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"];
+    readonly generatedAt: "2026-05-08T17:50:20.998Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,wBAAwB,gIAa3B,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,MAAM,EAAE,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK7D"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,wBAAwB,kJAe3B,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,MAAM,EAAE,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK7D"}

package/dist/lib/version.js

@@ -11,11 +11,11 @@ exports.parseAdcpMajorVersion = parseAdcpMajorVersion;
 /**
  * AdCP SDK library version
  */
-exports.LIBRARY_VERSION = '6.13.2';
+exports.LIBRARY_VERSION = '6.15.0';
 /**
  * AdCP specification version this library is built for
  */
-exports.ADCP_VERSION = '3.0.6';
+exports.ADCP_VERSION = '3.0.8';
 /**
  * AdCP major version sent with every request (adcp_major_version field).
  * Sellers validate this against their supported versions and return
@@ -38,15 +38,17 @@ exports.COMPATIBLE_ADCP_VERSIONS = [
     '3.0.4',
     '3.0.5',
     '3.0.6',
+    '3.0.7',
+    '3.0.8',
 ];
 /**
  * Full version information
  */
 exports.VERSION_INFO = {
-    library: '6.13.2',
-    adcp: '3.0.6',
+    library: '6.15.0',
+    adcp: '3.0.8',
     compatibleVersions: exports.COMPATIBLE_ADCP_VERSIONS,
-    generatedAt: '2026-05-08T10:37:20.162Z',
+    generatedAt: '2026-05-08T17:50:20.998Z',
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,iDAAiD;;;AA4DjD,wCAEC;AAKD,8CAEC;AAKD,4CAEC;AAKD,sDAEC;AAWD,sDAKC;AAjGD;;GAEG;AACU,QAAA,eAAe,GAAG,QAAQ,CAAC;AAExC;;GAEG;AACU,QAAA,YAAY,GAAG,OAAO,CAAC;AAEpC;;;;GAIG;AACU,QAAA,kBAAkB,GAAG,CAAC,CAAC;AAEpC;;GAEG;AACU,QAAA,wBAAwB,GAAG;IACtC,MAAM;IACN,MAAM;IACN,IAAI;IACJ,cAAc;IACd,cAAc;IACd,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;CACC,CAAC;AAYX;;GAEG;AACU,QAAA,YAAY,GAAG;IAC1B,OAAO,EAAE,QAAQ;IACjB,IAAI,EAAE,OAAO;IACb,kBAAkB,EAAE,gCAAwB;IAC5C,WAAW,EAAE,0BAA0B;CAC/B,CAAC;AAEX;;GAEG;AACH,SAAgB,cAAc;IAC5B,OAAO,oBAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,uBAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,WAAmB;IAClD,OAAQ,gCAA8C,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB;IACnC,OAAO,gCAAwB,CAAC;AAClC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CAAC,OAAe;IACnD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACxE,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,iDAAiD;;;AA8DjD,wCAEC;AAKD,8CAEC;AAKD,4CAEC;AAKD,sDAEC;AAWD,sDAKC;AAnGD;;GAEG;AACU,QAAA,eAAe,GAAG,QAAQ,CAAC;AAExC;;GAEG;AACU,QAAA,YAAY,GAAG,OAAO,CAAC;AAEpC;;;;GAIG;AACU,QAAA,kBAAkB,GAAG,CAAC,CAAC;AAEpC;;GAEG;AACU,QAAA,wBAAwB,GAAG;IACtC,MAAM;IACN,MAAM;IACN,IAAI;IACJ,cAAc;IACd,cAAc;IACd,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;CACC,CAAC;AAYX;;GAEG;AACU,QAAA,YAAY,GAAG;IAC1B,OAAO,EAAE,QAAQ;IACjB,IAAI,EAAE,OAAO;IACb,kBAAkB,EAAE,gCAAwB;IAC5C,WAAW,EAAE,0BAA0B;CAC/B,CAAC;AAEX;;GAEG;AACH,SAAgB,cAAc;IAC5B,OAAO,oBAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,uBAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,WAAmB;IAClD,OAAQ,gCAA8C,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB;IACnC,OAAO,gCAAwB,CAAC;AAClC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CAAC,OAAe;IACnD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACxE,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;AAC9C,CAAC"}

package/docs/guides/BUILD-AN-AGENT.md

@@ -12,38 +12,28 @@ We'll build a **signals agent** that serves audience segments via the `get_signa
 - `@adcp/sdk` installed (`npm install @adcp/sdk`)
 - `@modelcontextprotocol/sdk` (installed as a dependency of `@adcp/sdk`)
 
-## Two paths
-
-`@adcp/sdk` exposes two server entry points. Pick based on the agent
-shape:
-
-- **`createAdcpServerFromPlatform`** — **recommended for new agents.**
-  You declare a typed `DecisioningPlatform` (per-specialism interfaces:
-  `SalesCorePlatform` + `SalesIngestionPlatform`, `CreativeBuilderPlatform`,
-  `AudiencePlatform`, `SignalsPlatform`, `CampaignGovernancePlatform`,
-  `BrandRightsPlatform`, etc.) and the framework wires capability
-  projection, idempotency, RFC 9421 signing, async tasks, status
-  normalization, lifecycle state, multi-tenant routing, and webhook
-  auto-emit on sync mutations. Compile-time enforcement via
-  `RequiredPlatformsFor<S>` catches missing methods before runtime.
-  6.7 `definePlatform` / `defineSalesCorePlatform` / etc. helpers let
-  you write inline platform literals without `req: unknown` casts.
-- **`createAdcpServer`** — the lower-level handler-bag API. Still
-  fully supported (it's the substrate `createAdcpServerFromPlatform`
-  calls into) but lives at `@adcp/sdk/server/legacy/v5` in 6.x.
-  Reach for it only when mid-migration from a v5 codebase, when you
-  need a custom-shaped tool the platform interface doesn't yet model,
-  or when you've decided to own the whole handler bag yourself. The
-  appendix at the bottom of this guide covers it.
+## The server entry point
+
+`@adcp/sdk` exposes `createAdcpServerFromPlatform` as the server entry
+point. You declare a typed `DecisioningPlatform` (per-specialism
+interfaces: `SalesCorePlatform` + `SalesIngestionPlatform`,
+`CreativeBuilderPlatform`, `AudiencePlatform`, `SignalsPlatform`,
+`CampaignGovernancePlatform`, `BrandRightsPlatform`, etc.) and the
+framework wires capability projection, idempotency, RFC 9421 signing,
+async tasks, status normalization, lifecycle state, multi-tenant
+routing, and webhook auto-emit on sync mutations. Compile-time
+enforcement via `RequiredPlatformsFor<S>` catches missing methods
+before runtime. The `definePlatform` / `defineSalesCorePlatform` /
+sibling helpers let you write inline platform literals without
+`req: unknown` casts.
 
 For multi-specialism production agents (sales + creative + governance +
-brand-rights), see `docs/migration-5.x-to-6.x.md` and
-`docs/migration-6.6-to-6.7.md`. The `examples/hello_*` family is the
-copy-paste starting point for each specialism.
+brand-rights), the `examples/hello_*` family is the copy-paste
+starting point for each specialism.
 
 ## Quick Start
 
-A minimal signals agent using `createAdcpServerFromPlatform` + the v6
+A minimal signals agent using `createAdcpServerFromPlatform` + the
 `definePlatform` / `defineSignalsPlatform` identity helpers:
 
 ```typescript
@@ -288,7 +278,7 @@ import { AdcpError } from '@adcp/sdk/server';
 throw new AdcpError('CUSTOM_CODE', { recovery: 'terminal', message: '...', details: { foo: 'bar' } });
 ```
 
-All surface as `isError: true` on the wire and skip response-schema validation. The lower-level `adcpError(code, ...)` *return value* form is a v5-substrate pattern; in 6.x, prefer throwing the typed class.
+All surface as `isError: true` on the wire and skip response-schema validation. Prefer throwing the typed class.
 
 **7 domain groups:**
 
@@ -541,7 +531,7 @@ See [SIGNING-GUIDE.md](./SIGNING-GUIDE.md) for the full walkthrough: key generat
 
 ### createTaskCapableServer (Low-Level)
 
-For advanced cases where you need direct control over MCP tool registration, schema wiring, and response formatting. `createAdcpServer` (the legacy v5 substrate) uses this internally; `createAdcpServerFromPlatform` calls into `createAdcpServer`.
+For advanced cases where you need direct control over MCP tool registration, schema wiring, and response formatting. `createAdcpServerFromPlatform` calls into this internally.
 
 ```typescript
 import { createTaskCapableServer, taskToolResponse, GetSignalsRequestSchema } from '@adcp/sdk';
@@ -585,13 +575,12 @@ return wrapEnvelope(
 
 ### Response Builders
 
-With `createAdcpServerFromPlatform` (and the legacy `createAdcpServer` substrate), response builders are applied automatically — return raw data and the framework wraps it. If you need manual control (e.g., with `createTaskCapableServer`), builders are available:
+With `createAdcpServerFromPlatform`, response builders are applied automatically — return raw data and the framework wraps it. If you need manual control (e.g., with `createTaskCapableServer`), builders are available:
 
 ```typescript
 import { productsResponse, mediaBuyResponse, deliveryResponse, taskToolResponse } from '@adcp/sdk';
-// For error envelopes, throw a typed error class (recipe #6 in the 6.6→6.7 migration doc)
-// — `AuthRequiredError`, `PermissionDeniedError`, `RateLimitedError`, etc. — instead of
-// returning the legacy `adcpError(code, ...)` envelope from the v5 substrate.
+// For error envelopes, throw a typed error class — `AuthRequiredError`,
+// `PermissionDeniedError`, `RateLimitedError`, etc. — from `@adcp/sdk/server`.
 ```
 
 ### Task Statuses (Server-Side Contract)
@@ -606,7 +595,7 @@ When your agent receives a tool call, it returns one of these statuses. The buye
 | `input_required` | Need clarification from buyer | Fires buyer's `InputHandler` callback with the question |
 | `deferred` | Requires human decision | Returns a token; human resumes later via `result.deferred.resume()` |
 
-With `createAdcpServerFromPlatform` (or the legacy `createAdcpServer`), synchronous handlers return raw data and the framework sets `completed` automatically. With `createTaskCapableServer`, use `taskToolResponse()` explicitly.
+With `createAdcpServerFromPlatform`, synchronous handlers return raw data and the framework sets `completed` automatically. With `createTaskCapableServer`, use `taskToolResponse()` explicitly.
 
 For async tools that need background processing, use `registerAdcpTaskTool()`:
 
@@ -649,7 +638,7 @@ throw new ServiceUnavailableError({ retryAfterSeconds: 30 });
 throw new PermissionDeniedError('account_access', { message: 'Contact support' });
 ```
 
-For codes without a typed wrapper, `throw new AdcpError('CUSTOM_CODE', { recovery, message })` is the raw escape hatch. v5 adopters who used `return adcpError('CODE', '...')` (the return-value form) keep working under the legacy substrate, but v6 adopters should throw.
+For codes without a typed wrapper, `throw new AdcpError('CUSTOM_CODE', { recovery, message })` is the raw escape hatch.
 
 > **Heads-up for buyer-agent authors**: four codes are spec-`correctable` but operator-semantically human-escalate — don't auto-mutate-and-retry on `POLICY_VIOLATION`, `COMPLIANCE_UNSATISFIED`, `GOVERNANCE_DENIED`, or `AUTH_REQUIRED`. Surface to the user. (`AUTH_REQUIRED` conflates missing-creds with revoked-creds; until [adcontextprotocol/adcp#3730](https://github.com/adcontextprotocol/adcp/issues/3730) splits these, treat as escalate.) See `skills/call-adcp-agent/SKILL.md` for the full callout.
 
@@ -778,7 +767,7 @@ See [`examples/signals-agent.ts`](../../examples/signals-agent.ts) for a complet
 See [`examples/error-compliant-server.ts`](../../examples/error-compliant-server.ts) for a media buy agent demonstrating:
 
 - Multiple tools (`get_products`, `create_media_buy`, `get_media_buy_delivery`)
-- Structured error handling (the example uses the v5 `adcpError(...)` return-value form; v6 adopters throw the typed error classes from `@adcp/sdk/server` — `AuthRequiredError`, `RateLimitedError`, etc. — see § "Returning errors from handlers")
+- Structured error handling (throw the typed error classes from `@adcp/sdk/server` — `AuthRequiredError`, `RateLimitedError`, etc. — see § "Returning errors from handlers")
 - Rate limiting
 - Business logic validation
 

package/docs/llms.txt

@@ -1,7 +1,7 @@
 # Ad Context Protocol (AdCP)
 
-> Generated at: 2026-05-03
-> Library: @adcp/sdk v6.8.0
+> Generated at: 2026-05-08
+> Library: @adcp/sdk v6.11.0
 > 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.
@@ -1188,12 +1188,12 @@ Run compliance tests with `adcp test <agent> <scenario>`. 24 built-in scenarios:
 
 ### Seeding fixtures for compliance (seller-side)
 
-Group A storyboards seed fixtures via `comply_test_controller.seed_product` (and the other `seed_*` scenarios) before calling the spec tool. Two SDK helpers bridge this to `createAdcpServer`:
+Group A storyboards seed fixtures via `comply_test_controller.seed_product` (and the other `seed_*` scenarios) before calling the spec tool. Two SDK helpers bridge this:
 
 - **`mergeSeedProduct`** (plus `mergeSeedPricingOption`, `mergeSeedCreative`, `mergeSeedPlan`, `mergeSeedMediaBuy`): permissive merge of a sparse storyboard fixture onto the seller's baseline defaults. `undefined`/`null` keep base; arrays replace by default; well-known id-keyed lists (`pricing_options`, `publisher_properties`, `packages`, `assets`, plan `findings`) overlay by id so seeding one entry doesn't drop the rest.
 - **`bridgeFromTestControllerStore(store, productDefaults)`**: wires a `Map<string, unknown>` seed store into `get_products` responses automatically. Sandbox requests merge seeded + handler products (seeded wins collisions); production traffic (no sandbox marker, or a resolved non-sandbox account) skips the bridge.
 
-Wire on `createAdcpServer({ testController: bridgeFromTestControllerStore(store, baseline) })`. See `skills/build-seller-agent/SKILL.md` for the full pattern alongside `createComplyController`.
+Wire on `createAdcpServerFromPlatform(platform, { testController: bridgeFromTestControllerStore(store, baseline) })`. See `skills/build-seller-agent/SKILL.md` for the full pattern alongside `createComplyController`.
 
 ### Anti-façade upstream-traffic recording (`@adcp/sdk/upstream-recorder`)
 

package/examples/hello_creative_adapter_ad_server.ts

@@ -66,7 +66,7 @@ import {
   type DecisioningPlatform,
   type SyncCreativesRow,
 } from '@adcp/sdk/server';
-import { FormatAsset } from '@adcp/sdk';
+import { FormatAsset, buildCreativeReturn, previewCreative, urlRender } from '@adcp/sdk';
 import type {
   BuildCreativeRequest,
   BuildCreativeSuccess,
@@ -511,16 +511,17 @@ class CreativeAdServerAdapter implements DecisioningPlatform<Record<string, neve
       // satisfying creative-manifest.json:14. Each `assets[key]` is a
       // discriminated AssetVariant — `asset_type` selects the matching
       // schema (html requires `content`, etc.).
-      return {
-        creative_manifest: {
+      // `buildCreativeReturn.singleEnveloped({...})` injects the wire-shape
+      // discriminator: takes a flat `manifest` field (renamed to
+      // `creative_manifest` on the wire). SHAPE-GOTCHAS §5.
+      return buildCreativeReturn.singleEnveloped({
+        manifest: {
           format_id: { agent_url: FORMAT_AGENT_URL, id: creative.format_id },
           assets: {
             serving_tag: { asset_type: 'html', content: rendered.tag_html },
           },
         },
-        // CAST: oneOf-emitter — picking variant 0 (single creative_manifest)
-        // of the BuildCreativeResponse oneOf. Adopters keep this cast.
-      } as unknown as BuildCreativeSuccess;
+      });
     },
 
     /**
@@ -553,26 +554,24 @@ class CreativeAdServerAdapter implements DecisioningPlatform<Record<string, neve
         });
       }
       const rendered = await upstream.renderCreative(networkCode, creativeId, {});
-      return {
-        response_type: 'single',
+      // `previewCreative.single({...})` injects
+      // `response_type: 'single'`. SHAPE-GOTCHAS §4.
+      return previewCreative.single({
         previews: [
           {
             preview_id: `prv_${creative.creative_id}`,
             renders: [
-              {
+              urlRender({
                 render_id: `rnd_${creative.creative_id}`,
                 preview_url: rendered.preview_url,
                 role: 'primary',
-              },
+              }),
             ],
             input: { name: 'default' },
           },
         ],
         expires_at: new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString(),
-        // CAST: oneOf-emitter — picking the `single` discriminator branch
-        // of the PreviewCreativeResponse 3-way union (single | batch | variant).
-        // See SHAPE-GOTCHAS §4. Adopters keep this cast.
-      } as unknown as PreviewCreativeResponse;
+      });
     },
 
     listCreativeFormats: async (_req, _ctx): Promise<ListCreativeFormatsResponse> => {

package/examples/hello_creative_adapter_template.ts

@@ -52,6 +52,8 @@ import {
   javascriptAsset,
   audioAsset,
   urlRender,
+  buildCreativeReturn,
+  previewCreative,
   type Format,
   type ListCreativeFormatsResponse,
   type BuildCreativeRequest,
@@ -446,12 +448,13 @@ class CreativeTemplateAdapter implements DecisioningPlatform<Record<string, neve
         return projectRenderToManifest(completed, { agent_url: PUBLIC_AGENT_URL, id: target.id });
       };
 
-      // Multi-format request — return `CreativeManifest[]`; framework wraps
-      // as `{ creative_manifests: [...] }`. See BuildCreativeReturn (4-arm
-      // discriminated union) — returning the wrong arm fails wire-schema
-      // validation. SHAPE-GOTCHAS.md §5.
+      // `buildCreativeReturn.multi(...)` / `.single(...)` pin which arm of
+      // the 4-shape `BuildCreativeReturn` union you're emitting. The framework
+      // wraps `multi` into `{ creative_manifests: [...] }` and `single` into
+      // `{ creative_manifest: <obj> }` on the wire. SHAPE-GOTCHAS §5.
       if (req.target_format_ids && req.target_format_ids.length > 0) {
-        return Promise.all(req.target_format_ids.map((t, i) => buildOne(t, i)));
+        const manifests = await Promise.all(req.target_format_ids.map((t, i) => buildOne(t, i)));
+        return buildCreativeReturn.multi(manifests);
       }
 
       // Single-format request.
@@ -461,7 +464,7 @@ class CreativeTemplateAdapter implements DecisioningPlatform<Record<string, neve
           field: 'target_format_id',
         });
       }
-      return buildOne(req.target_format_id, 0);
+      return buildCreativeReturn.single(await buildOne(req.target_format_id, 0));
     },
 
     previewCreative: async (req: PreviewCreativeRequest, ctx): Promise<PreviewCreativeResponse> => {
@@ -516,12 +519,11 @@ class CreativeTemplateAdapter implements DecisioningPlatform<Record<string, neve
         throw new AdcpError('INVALID_REQUEST', { message: 'upstream returned no preview_url' });
       }
 
-      // PreviewCreativeResponse is a 3-way discriminated union (single |
-      // batch | variant). Single mode requires `previews[].renders[]` even
-      // for one preview — and each render needs the `output_format`
-      // discriminator. urlRender({...}) injects it. SHAPE-GOTCHAS.md §4.
-      return {
-        response_type: 'single',
+      // `previewCreative.single({...})` injects
+      // `response_type: 'single'`. The render slot's `output_format`
+      // discriminator is in turn injected by `urlRender({...})`.
+      // SHAPE-GOTCHAS §4.
+      return previewCreative.single({
         previews: [
           {
             preview_id: `prv_${created.render_id}`,
@@ -539,7 +541,7 @@ class CreativeTemplateAdapter implements DecisioningPlatform<Record<string, neve
           },
         ],
         expires_at: new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString(),
-      };
+      });
     },
   });
 }