@adcp/sdk 6.3.0 → 6.4.0

package/examples/decisioning-platform-broadcast-tv.ts

@@ -28,6 +28,7 @@
 
 import {
   AdcpError,
+  DEFAULT_REPORTING_CAPABILITIES,
   publishStatusChange,
   type DecisioningPlatform,
   type SalesPlatform,
@@ -135,14 +136,7 @@ export class BroadcastTvSeller implements DecisioningPlatform<BroadcastTvConfig,
             format_ids: [{ id: 'video_30s', agent_url: 'https://example.com/broadcast-creative-agent/mcp' }],
             delivery_type: 'guaranteed',
             publisher_properties: [{ publisher_domain: 'broadcast.example.com', selection_type: 'all' }],
-            reporting_capabilities: {
-              available_reporting_frequencies: ['daily'],
-              expected_delay_minutes: 240,
-              timezone: 'UTC',
-              supports_webhooks: false,
-              available_metrics: [],
-              date_range_support: 'date_range',
-            },
+            reporting_capabilities: DEFAULT_REPORTING_CAPABILITIES,
             pricing_options: [
               {
                 pricing_option_id: 'cpm_42_00',

package/examples/decisioning-platform-mock-seller.ts

@@ -41,6 +41,7 @@
 import {
   AdcpError,
   createAdcpServerFromPlatform,
+  DEFAULT_REPORTING_CAPABILITIES,
   type DecisioningPlatform,
   type SalesPlatform,
   type AccountStore,
@@ -162,12 +163,9 @@ const SHARED_GET_PRODUCTS = async (_req: GetProductsRequest): Promise<GetProduct
         },
       ],
       reporting_capabilities: {
+        ...DEFAULT_REPORTING_CAPABILITIES,
         available_reporting_frequencies: ['hourly', 'daily'],
         expected_delay_minutes: 30,
-        timezone: 'UTC',
-        supports_webhooks: false,
-        available_metrics: [],
-        date_range_support: 'date_range',
       },
     },
   ],

package/examples/decisioning-platform-programmatic.ts

@@ -22,12 +22,13 @@
 
 import {
   AdcpError,
+  DEFAULT_REPORTING_CAPABILITIES,
   publishStatusChange,
   type DecisioningPlatform,
   type SalesPlatform,
   type AccountStore,
+  type SyncCreativesRow,
 } from '@adcp/sdk/server';
-import type { SyncCreativesRow } from '@adcp/sdk/server';
 import type {
   GetProductsRequest,
   GetProductsResponse,
@@ -104,14 +105,7 @@ export class ProgrammaticSeller implements DecisioningPlatform<ProgrammaticConfi
           format_ids: [{ id: 'display_300x250', agent_url: 'https://example.com/programmatic-creative-agent/mcp' }],
           delivery_type: 'non_guaranteed',
           publisher_properties: [{ publisher_domain: 'programmatic.example.com', selection_type: 'all' }],
-          reporting_capabilities: {
-            available_reporting_frequencies: ['daily'],
-            expected_delay_minutes: 60,
-            timezone: 'UTC',
-            supports_webhooks: false,
-            available_metrics: [],
-            date_range_support: 'date_range',
-          },
+          reporting_capabilities: { ...DEFAULT_REPORTING_CAPABILITIES, expected_delay_minutes: 60 },
           pricing_options: [
             {
               pricing_option_id: 'cpm_2_50',
@@ -128,14 +122,7 @@ export class ProgrammaticSeller implements DecisioningPlatform<ProgrammaticConfi
           format_ids: [{ id: 'video_15s', agent_url: 'https://example.com/programmatic-creative-agent/mcp' }],
           delivery_type: 'non_guaranteed',
           publisher_properties: [{ publisher_domain: 'programmatic.example.com', selection_type: 'all' }],
-          reporting_capabilities: {
-            available_reporting_frequencies: ['daily'],
-            expected_delay_minutes: 60,
-            timezone: 'UTC',
-            supports_webhooks: false,
-            available_metrics: [],
-            date_range_support: 'date_range',
-          },
+          reporting_capabilities: { ...DEFAULT_REPORTING_CAPABILITIES, expected_delay_minutes: 60 },
           pricing_options: [
             {
               pricing_option_id: 'cpm_18_00',

package/package.json

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

package/skills/build-decisioning-platform/SKILL.md

@@ -18,19 +18,31 @@ For 95% of sales agents, these are the only `@adcp/sdk/server` imports you need:
 ```ts
 import {
   // Server entry + persistence
-  createAdcpServerFromPlatform, getAllAdcpMigrations, serve,
+  createAdcpServerFromPlatform,
+  getAllAdcpMigrations,
+  serve,
   // Wire-shape helpers (eliminate 30+ lines of boilerplate per Product)
-  buildProduct, buildPackage, buildPricingOption,
+  buildProduct,
+  buildPackage,
+  buildPricingOption,
+  DEFAULT_REPORTING_CAPABILITIES, // required field; override per-product
   // Typed errors — pick from this catalog instead of `throw new AdcpError(...)`
-  PackageNotFoundError, MediaBuyNotFoundError, ProductNotFoundError,
-  BudgetTooLowError, BackwardsTimeRangeError, InvalidStateError,
-  RateLimitedError, UnsupportedFeatureError,
+  PackageNotFoundError,
+  MediaBuyNotFoundError,
+  ProductNotFoundError,
+  BudgetTooLowError,
+  BackwardsTimeRangeError,
+  InvalidStateError,
+  RateLimitedError,
+  UnsupportedFeatureError,
   // Types
-  type DecisioningPlatform, type SalesPlatform,
+  type DecisioningPlatform,
+  type SalesPlatform,
 } from '@adcp/sdk/server';
 ```
 
 For other agent shapes:
+
 - **Creative agent (template / generative):** swap `SalesPlatform` for `CreativeBuilderPlatform`
 - **Signals agent:** swap for `SignalsPlatform`
 - **Brand-rights agent:** swap for `BrandRightsPlatform`
@@ -57,10 +69,17 @@ The full export list is in `@adcp/sdk/server`. Many surfaces are marked `@deprec
 ```ts
 import {
   createAdcpServerFromPlatform,
-  createCtxMetadataStore, memoryCtxMetadataStore,
-  PackageNotFoundError, MediaBuyNotFoundError, ProductNotFoundError,
-  BudgetTooLowError, BackwardsTimeRangeError, InvalidStateError,
-  type DecisioningPlatform, type SalesPlatform,
+  createCtxMetadataStore,
+  memoryCtxMetadataStore,
+  DEFAULT_REPORTING_CAPABILITIES,
+  PackageNotFoundError,
+  MediaBuyNotFoundError,
+  ProductNotFoundError,
+  BudgetTooLowError,
+  BackwardsTimeRangeError,
+  InvalidStateError,
+  type DecisioningPlatform,
+  type SalesPlatform,
 } from '@adcp/sdk/server';
 
 class MyPlatform implements DecisioningPlatform {
@@ -68,13 +87,13 @@ class MyPlatform implements DecisioningPlatform {
     adcp_version: '3.0.0',
     specialisms: ['sales-non-guaranteed'] as const,
     pricingModels: ['cpm'] as const,
-    channels: ['display', 'video'] as const,                  // strict literal-union — TS catches typos
+    channels: ['display', 'video'] as const, // strict literal-union — TS catches typos
     formats: [{ format_id: 'display_300x250' }],
     idempotency: { replay_ttl_seconds: 86400 },
   };
 
   accounts = {
-    resolution: 'derived' as const,                            // single tenant; framework returns the same Account every call
+    resolution: 'derived' as const, // single tenant; framework returns the same Account every call
     resolve: async () => ({ id: 'pub_main', operator: 'mypub', ctx_metadata: {} }),
     upsert: async () => ({ ok: true, items: [] }),
     list: async () => ({ items: [], nextCursor: null }),
@@ -90,8 +109,11 @@ class MyPlatform implements DecisioningPlatform {
           name: p.name,
           format_ids: p.formatIds.map(id => ({ id })),
           delivery_type: 'non_guaranteed',
-          pricing_options: [{ pricing_option_id: `${p.id}-cpm`, model: 'cpm', floor: { amount: p.floor, currency: 'USD' } }],
-          ctx_metadata: { gam: { ad_unit_ids: p.adUnitIds } },  // stashed; framework round-trips
+          reporting_capabilities: DEFAULT_REPORTING_CAPABILITIES, // required — see ReportingCapabilities type for all fields
+          pricing_options: [
+            { pricing_option_id: `${p.id}-cpm`, model: 'cpm', floor: { amount: p.floor, currency: 'USD' } },
+          ],
+          ctx_metadata: { gam: { ad_unit_ids: p.adUnitIds } }, // stashed; framework round-trips
         })),
       };
     },
@@ -124,8 +146,8 @@ class MyPlatform implements DecisioningPlatform {
       // Stash your platform's IDs so subsequent updateMediaBuy can hydrate them too.
       return {
         media_buy_id: order.id,
-        status: 'pending_creatives',                           // creative state machine — see advanced/STATE-MACHINE.md
-        ctx_metadata: { gam_order_id: order.gamOrderId },     // SDK persists; subsequent updateMediaBuy gets req.ctx_metadata.gam_order_id
+        status: 'pending_creatives', // creative state machine — see advanced/STATE-MACHINE.md
+        ctx_metadata: { gam_order_id: order.gamOrderId }, // SDK persists; subsequent updateMediaBuy gets req.ctx_metadata.gam_order_id
         packages: order.lineItems.map(li => ({
           package_id: li.id,
           status: 'pending_creatives',
@@ -180,14 +202,14 @@ class MyPlatform implements DecisioningPlatform {
           media_buy_id: buy.id,
           status: this.statusMappers.mediaBuy(buy.nativeStatus),
           buyer_ref: buy.buyerRef,
-          total_budget: { amount: buy.budgetAmount, currency: buy.currency },  // REQUIRED on the wire shape
+          total_budget: { amount: buy.budgetAmount, currency: buy.currency }, // REQUIRED on the wire shape
           start_time: buy.startTime,
           end_time: buy.endTime,
           packages: buy.lineItems.map(li => ({
             package_id: li.id,
             status: this.statusMappers.mediaBuy(li.nativeStatus),
             buyer_ref: li.buyerRef,
-            ctx_metadata: { gam_line_item_id: li.gamLineItemId },               // round-trip publisher state
+            ctx_metadata: { gam_line_item_id: li.gamLineItemId }, // round-trip publisher state
           })),
           ctx_metadata: { gam_order_id: buy.gamOrderId },
         })),
@@ -208,25 +230,25 @@ That's the agent. Five functions. The framework wires the wire protocol around i
 
 ```ts
 import {
-  PackageNotFoundError,        // wrong package_id on update
-  MediaBuyNotFoundError,       // wrong media_buy_id
-  ProductNotFoundError,        // wrong product_id on create
-  ProductUnavailableError,     // product exists but sold out
-  CreativeNotFoundError,       // wrong creative_id
-  CreativeRejectedError,       // brand-safety failed, etc.
-  BudgetTooLowError,           // under floor (correctable — buyer raises)
-  BudgetExhaustedError,        // pacing burst hit cap
-  IdempotencyConflictError,    // same key, different payload
-  InvalidRequestError,         // generic field-level bad input
-  InvalidStateError,           // illegal transition (paused → archived violations)
-  BackwardsTimeRangeError,     // start_time >= end_time
-  AuthRequiredError,           // need auth, then retry
-  PermissionDeniedError,       // auth present, lacks scope
-  RateLimitedError,            // throttled (clamps retry_after to [1, 3600])
-  UnsupportedFeatureError,     // tool unimplemented
-  ComplianceUnsatisfiedError,  // brand-safety attestation missing
-  GovernanceDeniedError,       // spending authority revoked
-  PolicyViolationError,        // categorical content rejection
+  PackageNotFoundError, // wrong package_id on update
+  MediaBuyNotFoundError, // wrong media_buy_id
+  ProductNotFoundError, // wrong product_id on create
+  ProductUnavailableError, // product exists but sold out
+  CreativeNotFoundError, // wrong creative_id
+  CreativeRejectedError, // brand-safety failed, etc.
+  BudgetTooLowError, // under floor (correctable — buyer raises)
+  BudgetExhaustedError, // pacing burst hit cap
+  IdempotencyConflictError, // same key, different payload
+  InvalidRequestError, // generic field-level bad input
+  InvalidStateError, // illegal transition (paused → archived violations)
+  BackwardsTimeRangeError, // start_time >= end_time
+  AuthRequiredError, // need auth, then retry
+  PermissionDeniedError, // auth present, lacks scope
+  RateLimitedError, // throttled (clamps retry_after to [1, 3600])
+  UnsupportedFeatureError, // tool unimplemented
+  ComplianceUnsatisfiedError, // brand-safety attestation missing
+  GovernanceDeniedError, // spending authority revoked
+  PolicyViolationError, // categorical content rejection
 } from '@adcp/sdk/server';
 ```
 
@@ -258,20 +280,16 @@ const meta = await ctx.ctxMetadata?.product(productId);
 
 ```ts
 import { Pool } from 'pg';
-import {
-  createAdcpServerFromPlatform,
-  getAllAdcpMigrations,
-  serve,
-} from '@adcp/sdk/server';
+import { createAdcpServerFromPlatform, getAllAdcpMigrations, serve } from '@adcp/sdk/server';
 
 const pool = new Pool({ connectionString: process.env.DATABASE_URL });
-await pool.query(getAllAdcpMigrations());                                 // one DDL call, all 3 tables
+await pool.query(getAllAdcpMigrations()); // one DDL call, all 3 tables
 
 const platform = new MyPlatform(myAdServer);
 const server = createAdcpServerFromPlatform(platform, {
   name: 'My Sales Agent',
   version: '1.0.0',
-  pool,                                                                    // wires idempotency + ctxMetadata + taskRegistry
+  pool, // wires idempotency + ctxMetadata + taskRegistry
 });
 
 serve(() => server, { port: process.env.PORT });