@adcp/sdk 8.1.0-beta.1 → 8.1.0-beta.11

package/examples/hello_seller_adapter_guaranteed.ts

@@ -72,6 +72,9 @@ import {
   type DecisioningPlatform,
   type SalesCorePlatform,
   type SalesIngestionPlatform,
+  type GetProductsPayload,
+  type GetMediaBuyDeliveryPayload,
+  type GetMediaBuysPayload,
   type AccountStore,
   type Account,
   type SyncCreativesRow,
@@ -86,9 +89,7 @@ import type {
   UpdateMediaBuyRequest,
   UpdateMediaBuySuccess,
   GetMediaBuysRequest,
-  GetMediaBuysResponse,
   GetMediaBuyDeliveryRequest,
-  GetMediaBuyDeliveryResponse,
 } from '@adcp/sdk/types';
 
 // `Product` isn't re-exported from `@adcp/sdk/types` (#1254 in the rollup);
@@ -516,6 +517,7 @@ class SalesGuaranteedAdapter implements DecisioningPlatform<Record<string, never
     specialisms: ['sales-guaranteed'] as const,
     channels: ['olv', 'ctv', 'display'] as const,
     pricingModels: ['cpm'] as const,
+    supportsProposals: false,
     config: {},
     // Declares the comply_test_controller surface so the conformance
     // runner picks up `controller_detected: true` and grades missing
@@ -729,7 +731,7 @@ class SalesGuaranteedAdapter implements DecisioningPlatform<Record<string, never
   // level. See `decisioning.type-checks.ts` for the regression-locked
   // patterns.
   sales: SalesCorePlatform<NetworkMeta> & SalesIngestionPlatform<NetworkMeta> = {
-    getProducts: async (req: GetProductsRequest, ctx): Promise<GetProductsResponse> => {
+    getProducts: async (req: GetProductsRequest, ctx): Promise<GetProductsPayload> => {
       const networkCode = ctx.account.ctx_metadata.network_code;
       const publisherDomain = ctx.account.ctx_metadata.publisher_domain;
       // Storyboard sends buying_mode: 'brief' with a free-text brief —
@@ -751,7 +753,10 @@ class SalesGuaranteedAdapter implements DecisioningPlatform<Record<string, never
         ...(req.filters?.end_date && { flightEnd: req.filters.end_date }),
         ...(briefBudget !== undefined && { budget: briefBudget }),
       });
-      return { status: 'completed', products: guaranteed.map(p => projectProduct(p, publisherDomain)) };
+      return {
+        products: guaranteed.map(p => projectProduct(p, publisherDomain)),
+        cache_scope: 'account',
+      };
     },
 
     /**
@@ -915,7 +920,7 @@ class SalesGuaranteedAdapter implements DecisioningPlatform<Record<string, never
         localBuyStatus.set(order.order_id, 'pending_creatives');
         return {
           media_buy_id: order.order_id,
-          status: 'pending_creatives',
+          media_buy_status: 'pending_creatives',
           confirmed_at: new Date().toISOString(),
           packages: packagesOut,
         };
@@ -1010,11 +1015,11 @@ class SalesGuaranteedAdapter implements DecisioningPlatform<Record<string, never
       // worked example just echoes success with the post-transition status.
       return {
         media_buy_id: buyId,
-        status: nextStatus,
+        media_buy_status: nextStatus,
       };
     },
 
-    getMediaBuys: async (req: GetMediaBuysRequest, ctx): Promise<GetMediaBuysResponse> => {
+    getMediaBuys: async (req: GetMediaBuysRequest, ctx): Promise<GetMediaBuysPayload> => {
       const networkCode = ctx.account.ctx_metadata.network_code;
       const orders = await upstream.listOrders(networkCode);
       const filtered = req.media_buy_ids ? orders.filter(o => req.media_buy_ids!.includes(o.order_id)) : orders;
@@ -1044,7 +1049,7 @@ class SalesGuaranteedAdapter implements DecisioningPlatform<Record<string, never
           };
         })
       );
-      return { status: 'completed', media_buys: buys };
+      return { media_buys: buys };
     },
 
     syncCreatives: async (creatives, ctx): Promise<SyncCreativesRow[]> => {
@@ -1085,7 +1090,7 @@ class SalesGuaranteedAdapter implements DecisioningPlatform<Record<string, never
       return rows;
     },
 
-    getMediaBuyDelivery: async (req: GetMediaBuyDeliveryRequest, ctx): Promise<GetMediaBuyDeliveryResponse> => {
+    getMediaBuyDelivery: async (req: GetMediaBuyDeliveryRequest, ctx): Promise<GetMediaBuyDeliveryPayload> => {
       const networkCode = ctx.account.ctx_metadata.network_code;
       const ids = req.media_buy_ids ?? [];
       const deliveries = await Promise.all(ids.map(id => upstream.getDelivery(networkCode, id)));
@@ -1106,7 +1111,6 @@ class SalesGuaranteedAdapter implements DecisioningPlatform<Record<string, never
       const aggregateClicks = present.reduce((s, d) => s + d.totals.clicks, 0);
 
       return {
-        status: 'completed',
         reporting_period: { start: earliest, end: latest },
         currency,
         aggregated_totals: {

package/examples/hello_seller_adapter_multi_tenant.ts

@@ -551,10 +551,13 @@ class MultiTenantAdapter implements DecisioningPlatform<Record<string, never>, T
           tenant.governanceBindings.delete(brandDomain);
         }
       }
-      const echoedAgents = entry.governance_agents.map(a => ({
-        url: a.url,
-        ...(a.categories && { categories: a.categories }),
-      }));
+      const echoedAgents = entry.governance_agents.map(a => {
+        const categories = (a as { categories?: unknown }).categories;
+        return {
+          url: a.url,
+          ...(categories !== undefined && { categories }),
+        };
+      });
       return {
         account: entry.account,
         status: 'synced' as const,
@@ -594,7 +597,7 @@ class MultiTenantAdapter implements DecisioningPlatform<Record<string, never>, T
       // pre-existing plan.
       const firstNew = (req.plans ?? [])[0]?.plan_id;
       if (firstNew && !tenant.active_plan_id) tenant.active_plan_id = firstNew;
-      return { plans };
+      return { status: 'completed', plans };
     },
 
     checkGovernance: async (req: CheckGovernanceRequest, ctx): Promise<CheckGovernanceResponse> => {
@@ -615,18 +618,18 @@ class MultiTenantAdapter implements DecisioningPlatform<Record<string, never>, T
           : (proposed.packages ?? []).reduce((s, p) => s + (p.budget ?? 0), 0);
 
       const overBudget = proposedBudget > plan.budget_total;
-      const status = overBudget ? 'denied' : plan.custom_policies.length > 0 ? 'conditions' : 'approved';
+      const verdict = overBudget ? 'denied' : plan.custom_policies.length > 0 ? 'conditions' : 'approved';
 
       const response: CheckGovernanceResponse = {
         check_id: checkId,
-        status,
+        verdict,
         plan_id: plan.plan_id,
         explanation: overBudget
           ? `Proposed spend ${proposedBudget} ${plan.currency} exceeds plan budget ${plan.budget_total} ${plan.currency}.`
-          : status === 'conditions'
+          : verdict === 'conditions'
             ? 'Approved with custom policy conditions.'
             : 'Approved.',
-        ...(status === 'denied' && {
+        ...(verdict === 'denied' && {
           findings: [
             {
               category_id: 'budget_compliance',
@@ -635,13 +638,13 @@ class MultiTenantAdapter implements DecisioningPlatform<Record<string, never>, T
             },
           ],
         }),
-        ...(status === 'conditions' && {
+        ...(verdict === 'conditions' && {
           conditions: plan.custom_policies.map(p => ({
             field: `payload.${p.policy_id}`,
             reason: p.policy,
           })),
         }),
-        ...(status !== 'denied' && {
+        ...(verdict !== 'denied' && {
           governance_context: `gov_ctx_${plan.plan_id}_${checkId}`,
           expires_at: new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString(),
         }),
@@ -651,7 +654,7 @@ class MultiTenantAdapter implements DecisioningPlatform<Record<string, never>, T
         timestamp: new Date().toISOString(),
         kind: 'check',
         check_id: checkId,
-        detail: { status, proposed_budget: proposedBudget },
+        detail: { verdict, proposed_budget: proposedBudget },
       });
       return response;
     },
@@ -674,7 +677,7 @@ class MultiTenantAdapter implements DecisioningPlatform<Record<string, never>, T
       });
       return {
         outcome_id: randomUUID(),
-        status: 'accepted',
+        outcome_state: 'accepted',
         committed_budget: committed,
         plan_summary: {
           total_committed: committed,
@@ -702,7 +705,7 @@ class MultiTenantAdapter implements DecisioningPlatform<Record<string, never>, T
           governed_actions: [],
         };
       });
-      return { plans };
+      return { status: 'completed', plans };
     },
   });
 
@@ -726,7 +729,7 @@ class MultiTenantAdapter implements DecisioningPlatform<Record<string, never>, T
       };
       const auth_token = `pltok_${randomUUID().replace(/-/g, '')}`;
       tenant.propertyLists.set(listId, { list, auth_token });
-      return { list, auth_token };
+      return { status: 'completed', list, auth_token };
     },
 
     updatePropertyList: async (req: UpdatePropertyListRequest, ctx): Promise<UpdatePropertyListResponse> => {
@@ -748,7 +751,7 @@ class MultiTenantAdapter implements DecisioningPlatform<Record<string, never>, T
         updated_at: new Date().toISOString(),
       };
       stored.list = updated;
-      return { list: updated };
+      return { status: 'completed', list: updated };
     },
 
     getPropertyList: async (req: GetPropertyListRequest, ctx): Promise<GetPropertyListResponse> => {
@@ -761,6 +764,7 @@ class MultiTenantAdapter implements DecisioningPlatform<Record<string, never>, T
         });
       }
       return {
+        status: 'completed',
         list: stored.list,
         identifiers: [],
         resolved_at: new Date().toISOString(),
@@ -774,13 +778,13 @@ class MultiTenantAdapter implements DecisioningPlatform<Record<string, never>, T
       const filtered = req.name_contains
         ? all.filter(l => l.name.toLowerCase().includes(req.name_contains!.toLowerCase()))
         : all;
-      return { lists: filtered };
+      return { status: 'completed', lists: filtered };
     },
 
     deletePropertyList: async (req: DeletePropertyListRequest, ctx): Promise<DeletePropertyListResponse> => {
       const tenant = getTenant(ctx);
       const existed = tenant.propertyLists.delete(req.list_id);
-      return { deleted: existed, list_id: req.list_id };
+      return { status: 'completed', deleted: existed, list_id: req.list_id };
     },
   });
 
@@ -879,7 +883,7 @@ class MultiTenantAdapter implements DecisioningPlatform<Record<string, never>, T
       if (unsupported.length > 0) {
         return {
           rights_id: offering.rights_id,
-          status: 'rejected',
+          rights_status: 'rejected',
           brand_id: offering.brand_id,
           reason: `Requested uses [${unsupported.join(', ')}] are not covered by offering ${offering.rights_id}.`,
           suggestions: [`This offering covers: ${offering.available_uses.join(', ')}.`],
@@ -891,7 +895,7 @@ class MultiTenantAdapter implements DecisioningPlatform<Record<string, never>, T
       // tenant-scoped persistence when wiring a real backend.
       return {
         rights_id: offering.rights_id,
-        status: 'acquired',
+        rights_status: 'acquired',
         brand_id: offering.brand_id,
         terms: {
           pricing_option_id: offering.pricing_option_id,
@@ -936,7 +940,7 @@ class MultiTenantAdapter implements DecisioningPlatform<Record<string, never>, T
       // adopters validate brand-guideline compliance, queue for human review,
       // or reject with structured `reason` + `suggestions[]`.
       return {
-        status: 'approved',
+        approval_status: 'approved',
         rights_id: req.rights_id,
         ...(req.creative_id !== undefined && { creative_id: req.creative_id }),
       };
@@ -1010,7 +1014,7 @@ class MultiTenantAdapter implements DecisioningPlatform<Record<string, never>, T
       },
       ctx
     );
-    if (govResp.status !== 'denied') return null;
+    if (govResp.verdict !== 'denied') return null;
 
     // Spec-correct denial shape: `AcquireRightsRejected` with `reason`
     // (and optional `suggestions`). Don't echo the buyer-controlled
@@ -1020,7 +1024,7 @@ class MultiTenantAdapter implements DecisioningPlatform<Record<string, never>, T
     // belongs in server-side logs, not the buyer envelope.
     return {
       rights_id: offering.rights_id,
-      status: 'rejected',
+      rights_status: 'rejected',
       brand_id: offering.brand_id,
       reason: `Denied by governance plan ${planId}: ${govResp.explanation}`,
       ...(govResp.findings &&

package/examples/hello_seller_adapter_non_guaranteed.ts

@@ -66,6 +66,10 @@ import {
   type DecisioningPlatform,
   type SalesCorePlatform,
   type SalesIngestionPlatform,
+  type GetProductsPayload,
+  type GetMediaBuyDeliveryPayload,
+  type GetMediaBuysPayload,
+  type ListCreativeFormatsPayload,
   type AccountStore,
   type Account,
   type AdcpMediaBuyStatus,
@@ -81,10 +85,7 @@ import type {
   UpdateMediaBuyRequest,
   UpdateMediaBuySuccess,
   GetMediaBuysRequest,
-  GetMediaBuysResponse,
   GetMediaBuyDeliveryRequest,
-  GetMediaBuyDeliveryResponse,
-  ListCreativeFormatsResponse,
 } from '@adcp/sdk/types';
 
 // `Product` isn't re-exported from `@adcp/sdk/types`; derive from response.
@@ -580,7 +581,7 @@ class SalesNonGuaranteedAdapter implements DecisioningPlatform<Record<string, ne
   // all-optional and `RequiredPlatformsFor<'sales-non-guaranteed'>` requires
   // the closed shape on the way out.
   sales: SalesCorePlatform<NetworkMeta> & SalesIngestionPlatform<NetworkMeta> = {
-    getProducts: async (req: GetProductsRequest, ctx): Promise<GetProductsResponse> => {
+    getProducts: async (req: GetProductsRequest, ctx): Promise<GetProductsPayload> => {
       const networkCode = ctx.account.ctx_metadata.network_code;
       const publisherDomain = ctx.account.ctx_metadata.publisher_domain;
       // When the buyer provides structured filters (flight dates, budget),
@@ -593,7 +594,10 @@ class SalesNonGuaranteedAdapter implements DecisioningPlatform<Record<string, ne
         ...(req.filters?.end_date && { flightEnd: req.filters.end_date }),
         ...(briefBudget !== undefined && { budget: briefBudget }),
       });
-      return { status: 'completed', products: products.map(p => projectProduct(p, publisherDomain)) };
+      return {
+        products: products.map(p => projectProduct(p, publisherDomain)),
+        cache_scope: 'account',
+      };
     },
 
     /**
@@ -706,7 +710,7 @@ class SalesNonGuaranteedAdapter implements DecisioningPlatform<Record<string, ne
         media_buy_id: order.order_id,
         // pending_creatives — buy is auction-confirmed but no creatives
         // attached yet. Buyer transitions to `active` after sync_creatives.
-        status: 'pending_creatives',
+        media_buy_status: 'pending_creatives',
         confirmed_at: order.created_at ?? new Date().toISOString(),
         packages: packagesOut,
       };
@@ -782,11 +786,11 @@ class SalesNonGuaranteedAdapter implements DecisioningPlatform<Record<string, ne
       }
       return {
         media_buy_id: existing.order_id,
-        status: nextStatus,
+        media_buy_status: nextStatus,
       };
     },
 
-    getMediaBuyDelivery: async (req: GetMediaBuyDeliveryRequest, ctx): Promise<GetMediaBuyDeliveryResponse> => {
+    getMediaBuyDelivery: async (req: GetMediaBuyDeliveryRequest, ctx): Promise<GetMediaBuyDeliveryPayload> => {
       const networkCode = ctx.account.ctx_metadata.network_code;
       const requestedIds = req.media_buy_ids ?? [];
       // Multi-id pass-through per #1342 contract — fan out per id; framework
@@ -824,8 +828,7 @@ class SalesNonGuaranteedAdapter implements DecisioningPlatform<Record<string, ne
           `[sales-non-guaranteed] get_media_buy_delivery: ${missing.length} unknown media_buy_id(s) returned no delivery rows: ${missing.join(', ')}`
         );
       }
-      const response: GetMediaBuyDeliveryResponse = {
-        status: 'completed',
+      const response: GetMediaBuyDeliveryPayload = {
         currency: filtered[0]?.currency ?? 'USD',
         reporting_period: {
           start: filtered[0]?.reporting_period.start ?? new Date().toISOString(),
@@ -854,7 +857,7 @@ class SalesNonGuaranteedAdapter implements DecisioningPlatform<Record<string, ne
       return response;
     },
 
-    getMediaBuys: async (req: GetMediaBuysRequest, ctx): Promise<GetMediaBuysResponse> => {
+    getMediaBuys: async (req: GetMediaBuysRequest, ctx): Promise<GetMediaBuysPayload> => {
       const networkCode = ctx.account.ctx_metadata.network_code;
       const requestedIds = req.media_buy_ids ?? [];
       let orders: UpstreamOrder[];
@@ -892,7 +895,7 @@ class SalesNonGuaranteedAdapter implements DecisioningPlatform<Record<string, ne
           };
         })
       );
-      const response: GetMediaBuysResponse = { status: 'completed', media_buys };
+      const response: GetMediaBuysPayload = { media_buys };
       return response;
     },
 
@@ -939,7 +942,7 @@ class SalesNonGuaranteedAdapter implements DecisioningPlatform<Record<string, ne
       return out;
     },
 
-    listCreativeFormats: async (_req, _ctx): Promise<ListCreativeFormatsResponse> => {
+    listCreativeFormats: async (_req, _ctx): Promise<ListCreativeFormatsPayload> => {
       // Publisher-owned format catalog. The mock doesn't have a discrete
       // formats endpoint (formats live inline on Product); production sellers
       // typically expose `/v1/formats` separately. SWAP: replace with your
@@ -960,7 +963,6 @@ class SalesNonGuaranteedAdapter implements DecisioningPlatform<Record<string, ne
         FormatAsset.url({ asset_id: 'click_url', required: true }),
       ];
       return {
-        status: 'completed',
         formats: [
           {
             format_id: { agent_url: FORMAT_AGENT_URL, id: 'display_300x250' },

package/examples/hello_seller_adapter_proposal_mode.ts

@@ -68,7 +68,7 @@ import type {
 // Wire `Product` and `Proposal` aren't directly re-exported from
 // `@adcp/sdk/types` — derive from the response array (same pattern as
 // `hello_seller_adapter_guaranteed.ts`).
-type Product = GetProductsResponse['products'][number];
+type Product = NonNullable<GetProductsResponse['products']>[number];
 type Proposal = NonNullable<GetProductsResponse['proposals']>[number];
 type Package = CreateMediaBuySuccess['packages'][number];
 
@@ -324,6 +324,16 @@ function projectProposal(up: UpstreamProposal, total_budget?: { amount: number;
         ? `Locked at ${a.locked_cpm} ${total_budget?.currency ?? 'USD'} CPM.`
         : `Indicative pricing ${a.indicative_cpm} CPM.`,
     })),
+    ...(up.status === 'committed' && {
+      insertion_order: {
+        io_id: `io_${up.proposal_id}`,
+        requires_signature: false,
+        terms: {
+          publisher: up.network_code,
+          ...(total_budget && { total_budget }),
+        },
+      },
+    }),
     ...(up.expires_at !== undefined && { expires_at: up.expires_at }),
     ...(total_budget && { total_budget }),
   };
@@ -343,7 +353,7 @@ const proposalManager: ProposalManager<GAMLikeRecipe, NetworkMeta> = {
     const networkCode = ctx.account.ctx_metadata.network_code;
     const publisherDomain = ctx.account.ctx_metadata.publisher_domain;
     const products = await upstream.listProducts(networkCode);
-    if (products.length === 0) return { products: [] };
+    if (products.length === 0) return { status: 'completed', products: [], cache_scope: 'account' };
 
     // brief + total_budget signals → curated proposal. Without a brief
     // the buyer is browsing the catalog; skip proposal generation.
@@ -352,7 +362,7 @@ const proposalManager: ProposalManager<GAMLikeRecipe, NetworkMeta> = {
     if (!brief) {
       // Catalog mode — return products with recipes, no proposals.
       const productsOut = products.map(p => projectProduct(p, publisherDomain, buildGAMLikeRecipe(p)));
-      return { products: productsOut };
+      return { status: 'completed', products: productsOut, cache_scope: 'account' };
     }
 
     const draft = await upstream.createProposal(networkCode, {
@@ -364,8 +374,10 @@ const proposalManager: ProposalManager<GAMLikeRecipe, NetworkMeta> = {
       .filter(p => referencedIds.has(p.product_id))
       .map(p => projectProduct(p, publisherDomain, buildGAMLikeRecipe(p)));
     return {
+      status: 'completed',
       products: productsOut,
       proposals: [projectProposal(draft, totalBudget)],
+      cache_scope: 'account',
     };
   },
 
@@ -390,8 +402,10 @@ const proposalManager: ProposalManager<GAMLikeRecipe, NetworkMeta> = {
       .filter(p => referencedIds.has(p.product_id))
       .map(p => projectProduct(p, publisherDomain, buildGAMLikeRecipe(p)));
     return {
+      status: 'completed',
       products: productsOut,
       proposals: [projectProposal(refined)],
+      cache_scope: 'account',
       refinement_applied: refine.map(r => ({
         scope: r.scope ?? 'request',
         ...(r.proposal_id !== undefined && { proposal_id: r.proposal_id }),
@@ -449,7 +463,7 @@ const sales: SalesCorePlatform<NetworkMeta> = {
   // getProducts is owned by proposalManager when wired; the framework
   // routes there. We keep this empty at the type level — the framework
   // never reaches it.
-  getProducts: async () => ({ products: [] }),
+  getProducts: async () => ({ status: 'completed', products: [], cache_scope: 'account' }),
 
   async createMediaBuy(req: CreateMediaBuyRequest, ctx): Promise<CreateMediaBuySuccess> {
     const networkCode = ctx.account.ctx_metadata.network_code;
@@ -494,7 +508,8 @@ const sales: SalesCorePlatform<NetworkMeta> = {
     }
     return {
       media_buy_id: order.order_id,
-      status: 'pending_creatives',
+      status: 'completed',
+      media_buy_status: 'pending_creatives',
       packages,
     };
   },
@@ -529,6 +544,7 @@ const sales: SalesCorePlatform<NetworkMeta> = {
       });
     }
     return {
+      status: 'completed',
       reporting_period: { start: '2026-04-01T00:00:00Z', end: '2026-06-30T23:59:59Z' },
       currency: 'USD',
       media_buy_deliveries: deliveries,
@@ -536,7 +552,7 @@ const sales: SalesCorePlatform<NetworkMeta> = {
   },
 
   async getMediaBuys(_req: GetMediaBuysRequest): Promise<GetMediaBuysResponse> {
-    return { media_buys: [] };
+    return { status: 'completed', media_buys: [] };
   },
 };
 

package/examples/hello_signals_adapter_marketplace.ts

@@ -79,6 +79,20 @@ interface UpstreamActivation {
   agent_activation_key?: { agent_segment?: string };
 }
 
+const PLATFORM_CODE_ALIASES: Record<string, string> = {
+  // The compliance storyboard uses the buyer-facing DSP label; the mock
+  // upstream exposes the concrete integration vendor code.
+  'pinnacle-dsp': 'the-trade-desk',
+};
+
+function resolvePlatformDestination(
+  destinations: UpstreamDestination[],
+  requestedPlatform: string
+): UpstreamDestination | undefined {
+  const platformCode = PLATFORM_CODE_ALIASES[requestedPlatform] ?? requestedPlatform;
+  return destinations.find(d => d.platform_type !== 'agent' && d.platform_code === platformCode);
+}
+
 // ---------------------------------------------------------------------------
 // Upstream-traffic recorder (sandbox-only, opts into `upstream_traffic` storyboard checks)
 // ---------------------------------------------------------------------------
@@ -120,6 +134,12 @@ const http = createUpstreamHttpClient({
 
 const tenantHeader = (operatorId: string) => ({ 'X-Operator-Id': operatorId });
 
+function upstreamPlatformCode(platform: string): string {
+  // The compliance storyboard uses a fictional buyer-facing DSP label;
+  // this adapter maps it onto the mock upstream's concrete destination.
+  return platform === 'pinnacle-dsp' ? 'the-trade-desk' : platform;
+}
+
 const upstream = {
   // SWAP: tenant lookup. Mock exposes /_lookup; production typically a
   // directory service or config registry.
@@ -159,7 +179,13 @@ const upstream = {
   // SWAP: post an activation.
   async activate(
     operatorId: string,
-    body: { cohort_id: string; destination_id: string; pricing_id: string; client_request_id: string }
+    body: {
+      cohort_id: string;
+      destination_id: string;
+      pricing_id: string;
+      client_request_id: string;
+      signal_agent_segment_id: string;
+    }
   ): Promise<UpstreamActivation> {
     const r = await http.post<UpstreamActivation>('/v2/activations', body, tenantHeader(operatorId));
     if (r.body === null) {
@@ -405,7 +431,11 @@ class SignalMarketplaceAdapter implements DecisioningPlatform<Record<string, nev
               sid.id === c.data_provider_id
           );
         });
-        return { status: 'completed', signals: filtered.map(toAdcpSignal) } satisfies GetSignalsResponse;
+        return {
+          status: 'completed',
+          signals: filtered.map(toAdcpSignal),
+          cache_scope: 'account',
+        } satisfies GetSignalsResponse;
       }),
 
     activateSignal: (req: ActivateSignalRequest, ctx): Promise<ActivateSignalSuccess> =>
@@ -433,7 +463,7 @@ class SignalMarketplaceAdapter implements DecisioningPlatform<Record<string, nev
           req.destinations.map(async (dest, i) => {
             const matched =
               dest.type === 'platform'
-                ? upstreamDests.find(d => d.platform_type !== 'agent' && d.platform_code === dest.platform)
+                ? resolvePlatformDestination(upstreamDests, dest.platform)
                 : upstreamDests.find(d => d.platform_type === 'agent' && d.agent_url === dest.agent_url);
             if (!matched) {
               const target = dest.type === 'platform' ? dest.platform : dest.agent_url;
@@ -444,6 +474,7 @@ class SignalMarketplaceAdapter implements DecisioningPlatform<Record<string, nev
             }
             const activation = await upstream.activate(operatorId, {
               cohort_id: cohort.cohort_id,
+              signal_agent_segment_id: cohort.cohort_id,
               destination_id: matched.destination_id,
               pricing_id: pricingId,
               client_request_id: `${idempotency}.${i}`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adcp/sdk",
-  "version": "8.1.0-beta.1",
+  "version": "8.1.0-beta.11",
   "description": "AdCP SDK — client, server, and compliance harnesses for the AdContext Protocol (MCP + A2A)",
   "workspaces": [
     ".",
@@ -45,6 +45,9 @@
       "require": "./dist/lib/types/v3-1-beta/index.js",
       "types": "./dist/lib/types/v3-1-beta/index.d.ts"
     },
+    "./types/*": {
+      "types": "./dist/lib/types/*.d.ts"
+    },
     "./wholesale-feed-sync": {
       "import": "./dist/lib/wholesale-feed-sync/index.js",
       "require": "./dist/lib/wholesale-feed-sync/index.js",
@@ -85,6 +88,11 @@
       "require": "./dist/lib/webhooks/index.js",
       "types": "./dist/lib/webhooks/index.d.ts"
     },
+    "./net": {
+      "import": "./dist/lib/net/index.js",
+      "require": "./dist/lib/net/index.js",
+      "types": "./dist/lib/net/index.d.ts"
+    },
     "./server": {
       "import": "./dist/lib/server/index.js",
       "require": "./dist/lib/server/index.js",
@@ -193,6 +201,9 @@
       "webhooks": [
         "dist/lib/webhooks/index.d.ts"
       ],
+      "net": [
+        "dist/lib/net/index.d.ts"
+      ],
       "server": [
         "dist/lib/server/index.d.ts"
       ],
@@ -228,6 +239,9 @@
       ],
       "upstream-recorder": [
         "dist/lib/upstream-recorder/index.d.ts"
+      ],
+      "types/*": [
+        "dist/lib/types/*.d.ts"
       ]
     }
   },
@@ -253,7 +267,7 @@
     "sync:agents": "node scripts/import-claude-agents.mjs",
     "prepublishOnly": "npm run clean && npm run sync-schemas:all && (test -f src/lib/types/tools.generated.ts || npm run generate-types) && npm run build:lib && node --test-timeout=60000 --test-force-exit --test test/lib/adcp-client.test.js test/lib/validation.test.js test/lib/zod-schemas.test.js",
     "build": "npm run build:lib",
-    "build:lib": "npm run sync-version && npm run schemas:ensure && tsx scripts/generate-wire-spec-fields.ts && tsc --project tsconfig.lib.json && tsx scripts/copy-schemas-to-dist.ts && tsx scripts/copy-v2-projection-catalog.ts",
+    "build:lib": "npm run sync-version && npm run schemas:ensure && tsx scripts/generate-wire-spec-fields.ts && tsc --project tsconfig.lib.json && tsx scripts/copy-schemas-to-dist.ts && tsx scripts/copy-v2-projection-catalog.ts && tsx scripts/generate-per-tool-types.ts",
     "build:test-agents": "npm run build:lib && tsc -p test-agents/tsconfig.json --rootDir test-agents",
     "pretest": "npm run schemas:ensure",
     "test": "NODE_ENV=test node --test-timeout=60000 --test-force-exit --test test/*.test.js test/lib/*.test.js && npm test --workspace=packages/eslint-plugin --if-present",
@@ -294,6 +308,7 @@
     "typecheck:skill-examples": "tsx scripts/typecheck-skill-examples.ts",
     "check:skill-sync": "tsx scripts/check-skill-sync.ts",
     "check:adopter-types": "tsx scripts/check-adopter-types.ts",
+    "check:adopter-types-narrow": "tsx scripts/check-adopter-types-narrow.ts",
     "sync-version": "tsx scripts/sync-version.ts",
     "validate-schemas": "tsx scripts/validate-schemas.ts",
     "lint": "eslint 'src/lib/testing/**/*.ts'",