@adcp/sdk 5.25.1 → 6.1.0

package/dist/lib/server/decisioning/specialisms/creative-ad-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative-ad-server.d.ts","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/specialisms/creative-ad-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,EAC3B,aAAa,EACb,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,KAAK,QAAQ,GAAG,aAAa,CAAC;AAC9B,KAAK,GAAG,CAAC,QAAQ,IAAI,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEvD,MAAM,WAAW,wBAAwB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1E;;;;;;;;;;;;;;;;;;;OAmBG;IACH,aAAa,CACX,GAAG,EAAE,oBAAoB,EACzB,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GACjB,OAAO,CAAC,gBAAgB,GAAG,gBAAgB,EAAE,GAAG,oBAAoB,GAAG,yBAAyB,CAAC,CAAC;IAErG,+EAA+E;IAC/E,eAAe,CAAC,GAAG,EAAE,sBAAsB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAInG;;;;;;OAMG;IACH,aAAa,CAAC,CACZ,SAAS,EAAE,QAAQ,EAAE,EACrB,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GACjB,OAAO,CAAC,gBAAgB,EAAE,GAAG,WAAW,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;IAEjE;;;;;OAKG;IACH,aAAa,CAAC,GAAG,EAAE,oBAAoB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAE7F;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE,0BAA0B,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACnH"}

package/dist/lib/server/decisioning/specialisms/creative-ad-server.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * CreativeAdServerPlatform — third creative archetype (v6.0).
+ *
+ * Stateful creative library + per-creative pricing + tag generation. The
+ * canonical shape for creative-ad-server adopters: Innovid, Flashtalking,
+ * GAM-creative, CMP-style platforms.
+ *
+ * Distinct from `CreativeTemplatePlatform` (stateless transform) and
+ * `CreativeGenerativePlatform` (brief-driven generation):
+ *
+ *   - **Stateful** — adopter persists creatives in a library; `syncCreatives`
+ *     pushes assets in, `listCreatives` reads them back, `buildCreative`
+ *     either looks up an existing creative by id OR pushes a new one
+ *   - **Pricing per creative** — vendor pricing options on each creative;
+ *     `pricing_option_id` selected at activation, billed via `report_usage`
+ *   - **Tag generation** — `buildCreative` returns ad-server tags (VAST,
+ *     placement-specific tracking pixels, macro-substituted creative HTML)
+ *     when invoked with `media_buy_id` + `package_id` context
+ *   - **Per-creative delivery reports** — `get_creative_delivery` returns
+ *     pacing data per creative across the library
+ *
+ * Status: Preview / 6.0.
+ *
+ * @public
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=creative-ad-server.js.map

package/dist/lib/server/decisioning/specialisms/creative-ad-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative-ad-server.js","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/specialisms/creative-ad-server.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG"}

package/dist/lib/server/decisioning/specialisms/creative.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Creative specialism platform interfaces (v2 dual-method shape).
+ *
+ * Three creative archetypes:
+ *   - CreativeTemplatePlatform: stateless transform (AudioStack, Celtra)
+ *   - CreativeGenerativePlatform: brief-to-creative (DALL-E-style)
+ *   - CreativeAdServerPlatform: stateful library + tags (Innovid, GAM-creative; v1.1)
+ *
+ * `buildCreative` and `syncCreatives` each have sync OR task variants;
+ * adopter implements exactly one per pair. `validatePlatform()` enforces
+ * exactly-one at construction time.
+ *
+ * Status: Preview / 6.0.
+ *
+ * @public
+ */
+import type { Account } from '../account';
+import type { RequestContext } from '../context';
+import type { TaskHandoff } from '../async-outcome';
+import type { CreativeAsset, CreativeManifest, BuildCreativeRequest, BuildCreativeSuccess, BuildCreativeMultiSuccess, PreviewCreativeRequest, PreviewCreativeResponse } from '../../../types/tools.generated';
+import type { SyncCreativesRow } from './sales';
+/**
+ * Adopter return shape for `buildCreative`. Discriminated by the wire
+ * spec's Single vs Multi response arms — pick whichever matches the
+ * request the framework dispatched:
+ *
+ *   - **Single manifest, no metadata**: return a `CreativeManifest`
+ *     directly. Framework wraps as `{ creative_manifest: <manifest> }`.
+ *     Use this for single-format requests (`target_format_id`) when
+ *     you don't need to set `sandbox` / `expires_at` / `preview`.
+ *   - **Multi-format manifests, no metadata**: return a
+ *     `CreativeManifest[]`. Framework wraps as
+ *     `{ creative_manifests: [...] }`. Use this for multi-format
+ *     requests (`target_format_ids`) when you don't need rich metadata.
+ *   - **Fully-shaped envelope**: return a `BuildCreativeSuccess` (single)
+ *     or `BuildCreativeMultiSuccess` (multi) with `sandbox` /
+ *     `expires_at` / `preview` populated. Framework passes through
+ *     unchanged. Detected by the presence of `creative_manifest` (single
+ *     envelope) or `creative_manifests` (multi envelope) at the top level.
+ *
+ * Adopters route on `req.target_format_ids` (multi) vs `req.target_format_id`
+ * (single) and return the matching arm. Returning a `CreativeManifest[]`
+ * for a single-format request, or a single `CreativeManifest` for a
+ * multi-format request, is an adopter contract violation that surfaces
+ * as schema-validation failure on the wire response.
+ */
+export type BuildCreativeReturn = CreativeManifest | CreativeManifest[] | BuildCreativeSuccess | BuildCreativeMultiSuccess;
+type Creative = CreativeAsset;
+type Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;
+export type { SyncCreativesRow };
+/**
+ * Creative-builder agent. Produces creatives from buyer inputs — equally
+ * suited to template-driven dynamic creative platforms (Bannerflow,
+ * Celtra), brief-to-creative AI agents (Pencil, Omneky, AdCreative.ai),
+ * and hybrids that mix both modes. The wire shape doesn't distinguish
+ * "transform a template" from "generate from a brief" — both produce a
+ * `CreativeManifest` from a `BuildCreativeRequest`. The previous v6
+ * preview separated them into `CreativeTemplatePlatform` and
+ * `CreativeGenerativePlatform`, but every interface field is the same;
+ * the only meaningful difference was whether `refineCreative` was
+ * supported, which is now optional on the unified shape.
+ *
+ * Spec defines a Submitted arm via `async-response-data.json`
+ * (`BuildCreativeAsyncSubmitted`) but the per-tool
+ * `build-creative-response.json` `oneOf` doesn't include it — a SPEC
+ * inconsistency tracked as adcontextprotocol/adcp#3392. Until the spec
+ * rolls Submitted into the `oneOf`, slow operations (TTS, audio mixing,
+ * long-running generation) await in-request; status changes surface via
+ * `publishStatusChange` on `resource_type: 'creative'`.
+ *
+ * Both `creative-template` and `creative-generative` specialism claims
+ * map to this interface in `RequiredPlatformsFor<S>` — the discovery
+ * distinction is preserved at the buyer-facing spec level (so buyers
+ * filtering for "AI brief-to-creative" still find generative agents)
+ * while implementation surface stays unified.
+ *
+ * Adopters that ALSO want library + tag generation + delivery reporting
+ * (i.e., a full ad server on top of the builder) declare
+ * `CreativeAdServerPlatform` instead. Multi-archetype omni agents
+ * (rare in the wild) front each archetype as a separate tenant via
+ * `TenantRegistry`.
+ */
+export interface CreativeBuilderPlatform<TCtxMeta = Record<string, unknown>> {
+    /**
+     * Build the creative. Single method covers template-driven transform
+     * (`req.template_id` + asset slots), brief-to-creative generation
+     * (`req.brief`), and any hybrid the platform supports — adopters
+     * route internally on `req` shape.
+     *
+     * Return shape is discriminated; see {@link BuildCreativeReturn}:
+     * single `CreativeManifest`, `CreativeManifest[]` for multi-format
+     * requests, OR a fully-shaped `BuildCreativeSuccess` /
+     * `BuildCreativeMultiSuccess` envelope when you need to set
+     * `sandbox` / `expires_at` / `preview`.
+     */
+    buildCreative(req: BuildCreativeRequest, ctx: Ctx<TCtxMeta>): Promise<BuildCreativeReturn>;
+    /**
+     * Preview-only variant — sandbox URL or inline HTML, expires. Always
+     * sync. Optional because generative-only adopters that don't render
+     * preview ahead of generation can omit it; the framework returns
+     * `UNSUPPORTED_FEATURE` to buyers calling `preview_creative` against
+     * a platform that didn't wire this.
+     */
+    previewCreative?(req: PreviewCreativeRequest, ctx: Ctx<TCtxMeta>): Promise<PreviewCreativeResponse>;
+    /**
+     * Refine a prior generation. `taskId` references a prior submission.
+     * Sync — refinement is a mutation on existing state, not a new task
+     * creation. Optional because pure template platforms iterate by
+     * re-calling `buildCreative` with different inputs and don't carry
+     * generation state across calls.
+     */
+    refineCreative?(taskId: string, refinement: RefinementMessage, ctx: Ctx<TCtxMeta>): Promise<CreativeManifest>;
+    /**
+     * Sync review surface. Stateless platforms typically auto-approve;
+     * adopters needing mandatory pre-persist review return
+     * `ctx.handoffToTask(fn)` to defer to a background task. Unified
+     * hybrid shape — return rows OR `ctx.handoffToTask(fn)`.
+     */
+    syncCreatives?(creatives: Creative[], ctx: Ctx<TCtxMeta>): Promise<SyncCreativesRow[] | TaskHandoff<SyncCreativesRow[]>>;
+}
+/**
+ * @deprecated Use `CreativeBuilderPlatform` — the unified interface
+ * covering both template-driven and brief-to-creative agents. The
+ * v6 preview's separation of `CreativeTemplatePlatform` and
+ * `CreativeGenerativePlatform` had no meaningful interface
+ * distinction; this alias preserves source compatibility for one
+ * release while adopters migrate. Will be removed in a future
+ * release.
+ */
+export type CreativeTemplatePlatform<TCtxMeta = Record<string, unknown>> = CreativeBuilderPlatform<TCtxMeta>;
+/**
+ * @deprecated Use `CreativeBuilderPlatform` — the unified interface
+ * covering both template-driven and brief-to-creative agents. See
+ * `CreativeTemplatePlatform` deprecation note. Will be removed in a
+ * future release.
+ */
+export type CreativeGenerativePlatform<TCtxMeta = Record<string, unknown>> = CreativeBuilderPlatform<TCtxMeta>;
+export interface RefinementMessage {
+    /** Free-text instruction from the buyer. */
+    message: string;
+    /** Optional structured changes (e.g., "make headline say X"). */
+    changes?: Record<string, unknown>;
+}
+//# sourceMappingURL=creative.d.ts.map

package/dist/lib/server/decisioning/specialisms/creative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative.d.ts","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/specialisms/creative.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,mBAAmB,GAC3B,gBAAgB,GAChB,gBAAgB,EAAE,GAClB,oBAAoB,GACpB,yBAAyB,CAAC;AAE9B,KAAK,QAAQ,GAAG,aAAa,CAAC;AAC9B,KAAK,GAAG,CAAC,QAAQ,IAAI,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAIvD,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAMjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,uBAAuB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzE;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,GAAG,EAAE,oBAAoB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE3F;;;;;;OAMG;IACH,eAAe,CAAC,CAAC,GAAG,EAAE,sBAAsB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAEpG;;;;;;OAMG;IACH,cAAc,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE9G;;;;;OAKG;IACH,aAAa,CAAC,CACZ,SAAS,EAAE,QAAQ,EAAE,EACrB,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GACjB,OAAO,CAAC,gBAAgB,EAAE,GAAG,WAAW,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;CAClE;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,wBAAwB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,uBAAuB,CAAC,QAAQ,CAAC,CAAC;AAE7G;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,uBAAuB,CAAC,QAAQ,CAAC,CAAC;AAM/G,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

package/dist/lib/server/decisioning/specialisms/creative.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Creative specialism platform interfaces (v2 dual-method shape).
+ *
+ * Three creative archetypes:
+ *   - CreativeTemplatePlatform: stateless transform (AudioStack, Celtra)
+ *   - CreativeGenerativePlatform: brief-to-creative (DALL-E-style)
+ *   - CreativeAdServerPlatform: stateful library + tags (Innovid, GAM-creative; v1.1)
+ *
+ * `buildCreative` and `syncCreatives` each have sync OR task variants;
+ * adopter implements exactly one per pair. `validatePlatform()` enforces
+ * exactly-one at construction time.
+ *
+ * Status: Preview / 6.0.
+ *
+ * @public
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=creative.js.map

package/dist/lib/server/decisioning/specialisms/creative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative.js","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/specialisms/creative.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/lib/server/decisioning/specialisms/lists.d.ts

@@ -0,0 +1,61 @@
+/**
+ * PropertyListsPlatform + CollectionListsPlatform — list-publishing
+ * specialisms (v6.0).
+ *
+ * Two distinct specialisms with parallel CRUD shapes:
+ *
+ *   - **`property-lists`** — agent publishes/maintains authorized property
+ *     lists (which sellers can sell what for which advertisers; buyer-side
+ *     authorization graphs). Sellers FETCH and validate against these.
+ *   - **`collection-lists`** — agent publishes/maintains authorized
+ *     collection lists (program/show-level brand safety via IMDb /
+ *     Gracenote / EIDR ids). Sellers FETCH and apply for inventory
+ *     filtering.
+ *
+ * Both have CRUD on the same shape — create, update, get, list, delete —
+ * just on different list types. Could fold into one interface if your
+ * adopter implements both; today they're separated to match the spec
+ * specialism-per-list-type shape.
+ *
+ * Shape: standard CRUD + token-issuance semantics. `create_*` returns a
+ * one-time fetch token sellers store in their secret manager; `delete_*`
+ * revokes the token. Tokens are scoped per-seller for revocation.
+ *
+ * Status: Preview / 6.0.
+ *
+ * @public
+ */
+import type { Account } from '../account';
+import type { RequestContext } from '../context';
+import type { CreatePropertyListRequest, CreatePropertyListResponse, UpdatePropertyListRequest, UpdatePropertyListResponse, GetPropertyListRequest, GetPropertyListResponse, ListPropertyListsRequest, ListPropertyListsResponse, DeletePropertyListRequest, DeletePropertyListResponse, CreateCollectionListRequest, CreateCollectionListResponse, UpdateCollectionListRequest, UpdateCollectionListResponse, GetCollectionListRequest, GetCollectionListResponse, ListCollectionListsRequest, ListCollectionListsResponse, DeleteCollectionListRequest, DeleteCollectionListResponse } from '../../../types/tools.generated';
+type Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;
+export interface PropertyListsPlatform<TCtxMeta = Record<string, unknown>> {
+    /**
+     * Create a property list. Returns a `fetch_token` the buyer stores in
+     * their secret manager. Token is scoped to this list_id; MUST NOT be
+     * reused across lists.
+     */
+    createPropertyList(req: CreatePropertyListRequest, ctx: Ctx<TCtxMeta>): Promise<CreatePropertyListResponse>;
+    /** Patch an existing property list. */
+    updatePropertyList(req: UpdatePropertyListRequest, ctx: Ctx<TCtxMeta>): Promise<UpdatePropertyListResponse>;
+    /** Read a property list by id. Sellers call this with the fetch_token. */
+    getPropertyList(req: GetPropertyListRequest, ctx: Ctx<TCtxMeta>): Promise<GetPropertyListResponse>;
+    /** Discover property lists the caller is authorized to read. */
+    listPropertyLists(req: ListPropertyListsRequest, ctx: Ctx<TCtxMeta>): Promise<ListPropertyListsResponse>;
+    /**
+     * Delete a property list. MUST revoke the fetch_token immediately and
+     * signal cache invalidation to sellers (reduced cache_valid_until or
+     * a list-changed webhook). Compromise-driven revocation MUST also
+     * trigger this path.
+     */
+    deletePropertyList(req: DeletePropertyListRequest, ctx: Ctx<TCtxMeta>): Promise<DeletePropertyListResponse>;
+}
+export interface CollectionListsPlatform<TCtxMeta = Record<string, unknown>> {
+    createCollectionList(req: CreateCollectionListRequest, ctx: Ctx<TCtxMeta>): Promise<CreateCollectionListResponse>;
+    updateCollectionList(req: UpdateCollectionListRequest, ctx: Ctx<TCtxMeta>): Promise<UpdateCollectionListResponse>;
+    getCollectionList(req: GetCollectionListRequest, ctx: Ctx<TCtxMeta>): Promise<GetCollectionListResponse>;
+    listCollectionLists(req: ListCollectionListsRequest, ctx: Ctx<TCtxMeta>): Promise<ListCollectionListsResponse>;
+    deleteCollectionList(req: DeleteCollectionListRequest, ctx: Ctx<TCtxMeta>): Promise<DeleteCollectionListResponse>;
+}
+export {};
+//# sourceMappingURL=lists.d.ts.map

package/dist/lib/server/decisioning/specialisms/lists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lists.d.ts","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/specialisms/lists.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,gCAAgC,CAAC;AAExC,KAAK,GAAG,CAAC,QAAQ,IAAI,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEvD,MAAM,WAAW,qBAAqB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvE;;;;OAIG;IACH,kBAAkB,CAAC,GAAG,EAAE,yBAAyB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAE5G,uCAAuC;IACvC,kBAAkB,CAAC,GAAG,EAAE,yBAAyB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAE5G,0EAA0E;IAC1E,eAAe,CAAC,GAAG,EAAE,sBAAsB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAEnG,gEAAgE;IAChE,iBAAiB,CAAC,GAAG,EAAE,wBAAwB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAEzG;;;;;OAKG;IACH,kBAAkB,CAAC,GAAG,EAAE,yBAAyB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CAC7G;AAED,MAAM,WAAW,uBAAuB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzE,oBAAoB,CAAC,GAAG,EAAE,2BAA2B,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAClH,oBAAoB,CAAC,GAAG,EAAE,2BAA2B,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAClH,iBAAiB,CAAC,GAAG,EAAE,wBAAwB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACzG,mBAAmB,CAAC,GAAG,EAAE,0BAA0B,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC/G,oBAAoB,CAAC,GAAG,EAAE,2BAA2B,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;CACnH"}

package/dist/lib/server/decisioning/specialisms/lists.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * PropertyListsPlatform + CollectionListsPlatform — list-publishing
+ * specialisms (v6.0).
+ *
+ * Two distinct specialisms with parallel CRUD shapes:
+ *
+ *   - **`property-lists`** — agent publishes/maintains authorized property
+ *     lists (which sellers can sell what for which advertisers; buyer-side
+ *     authorization graphs). Sellers FETCH and validate against these.
+ *   - **`collection-lists`** — agent publishes/maintains authorized
+ *     collection lists (program/show-level brand safety via IMDb /
+ *     Gracenote / EIDR ids). Sellers FETCH and apply for inventory
+ *     filtering.
+ *
+ * Both have CRUD on the same shape — create, update, get, list, delete —
+ * just on different list types. Could fold into one interface if your
+ * adopter implements both; today they're separated to match the spec
+ * specialism-per-list-type shape.
+ *
+ * Shape: standard CRUD + token-issuance semantics. `create_*` returns a
+ * one-time fetch token sellers store in their secret manager; `delete_*`
+ * revokes the token. Tokens are scoped per-seller for revocation.
+ *
+ * Status: Preview / 6.0.
+ *
+ * @public
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=lists.js.map

package/dist/lib/server/decisioning/specialisms/lists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lists.js","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/specialisms/lists.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG"}

package/dist/lib/server/decisioning/specialisms/sales.d.ts

@@ -0,0 +1,163 @@
+/**
+ * SalesPlatform — sales specialism platform interface.
+ *
+ * **Unified hybrid shape.** `create_media_buy` and `sync_creatives` use a
+ * single method each. The method returns the wire success arm (sync fast
+ * path) OR `ctx.handoffToTask(fn)` to promote the call to a background
+ * task (HITL slow path). Branch per-call — the same method handles
+ * programmatic remnant, guaranteed inventory, and hybrid sellers. Every
+ * other tool is sync-only:
+ *
+ *   - `get_products` — sync. Brief in, products out.
+ *   - `create_media_buy` — sync OR `ctx.handoffToTask(...)`.
+ *   - `update_media_buy` — sync only. Re-approval flows that need HITL run
+ *     out-of-band; `publishStatusChange` carries the result.
+ *   - `sync_creatives` — sync OR `ctx.handoffToTask(...)`.
+ *   - `get_media_buy_delivery` — sync only.
+ *
+ * Sync-only tools that need long-running semantics use `publishStatusChange`
+ * (see `status-changes.ts`) — that's the spec-aligned channel for tools
+ * whose wire response unions don't define a Submitted arm.
+ *
+ * Each method either returns the value or throws `AdcpError` for structured
+ * rejection. Generic thrown errors map to `SERVICE_UNAVAILABLE`.
+ *
+ * **Method groups** — implement the group(s) matching your specialism:
+ *
+ * | Group | Methods | Claim when |
+ * |---|---|---|
+ * | Core sales (required) | `getProducts`, `updateMediaBuy`, `getMediaBuyDelivery` | Any `sales-*` specialism |
+ * | Core sales (unified hybrid) | `createMediaBuy` | Any `sales-*` specialism |
+ * | Core sales (unified hybrid) | `syncCreatives` | Any `sales-*` specialism |
+ * | Read / feedback | `getMediaBuys`, `providePerformanceFeedback`, `listCreativeFormats`, `listCreatives` | Most sellers; optional |
+ * | Retail-media extensions | `syncCatalogs`, `logEvent`, `syncEventSources` | `sales-catalog-driven`, `sales-retail-media` |
+ *
+ * New adopters implementing a non-retail seller (GAM, FreeWheel, a social
+ * platform) only need the three core-required methods plus `createMediaBuy`
+ * and `syncCreatives`. The retail-media extension methods (`syncCatalogs`,
+ * `logEvent`, `syncEventSources`) are unnecessary unless you claim
+ * `sales-catalog-driven` or `sales-retail-media`.
+ *
+ * **No-account tools (`providePerformanceFeedback`, `listCreativeFormats`):**
+ * the wire requests for these two tools don't carry an `account` field, so
+ * `ctx.account` may be `undefined` when `accounts.resolution === 'explicit'`.
+ * Three safe patterns:
+ *
+ * 1. **`'derived'` resolution** — `accounts.resolve(undefined)` returns a
+ *    singleton; `ctx.account` is always set. Best for single-tenant
+ *    deployers.
+ * 2. **Don't implement the method** — the framework returns
+ *    `UNSUPPORTED_FEATURE`; buyers using the merge-seam custom handler or
+ *    external creative agents still receive a response.
+ * 3. **Explicit-mode with defensive read** — cast `ctx.account as Account |
+ *    undefined` and derive the account from the request body (e.g., via a
+ *    `media_buy_id` lookup), or throw `AdcpError('ACCOUNT_NOT_FOUND')`.
+ *    Full `resolveAccount(undefined, { authInfo, toolName })` support for
+ *    explicit-mode lands in rc.1.
+ *
+ * Status: Preview / 6.0.
+ *
+ * @public
+ */
+import type { Account } from '../account';
+import type { RequestContext } from '../context';
+import type { TaskHandoff } from '../async-outcome';
+import type { GetProductsRequest, GetProductsResponse, CreateMediaBuyRequest, CreateMediaBuySuccess, UpdateMediaBuyRequest, UpdateMediaBuySuccess, GetMediaBuysRequest, GetMediaBuysResponse, GetMediaBuyDeliveryRequest, GetMediaBuyDeliveryResponse, ProvidePerformanceFeedbackRequest, ProvidePerformanceFeedbackSuccess, ListCreativeFormatsRequest, ListCreativeFormatsResponse, ListCreativesRequest, ListCreativesResponse, SyncCatalogsRequest, SyncCatalogsSuccess, LogEventRequest, LogEventSuccess, SyncEventSourcesRequest, SyncEventSourcesSuccess, SyncCreativesSuccess, CreativeAsset } from '../../../types/tools.generated';
+type Creative = CreativeAsset;
+type Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;
+/**
+ * Wire success-row shape for `sync_creatives`. Returning the array of these
+ * rows from `syncCreatives` is what adopters write — the framework wraps
+ * with `{ creatives: [...] }` to form `SyncCreativesSuccess`.
+ */
+export type SyncCreativesRow = SyncCreativesSuccess['creatives'][number];
+export interface SalesPlatform<TCtxMeta = Record<string, unknown>> {
+    /** Sync catalog lookup: filters in, products out. NOT for proposal generation. */
+    getProducts(req: GetProductsRequest, ctx: Ctx<TCtxMeta>): Promise<GetProductsResponse>;
+    /**
+     * Create a media buy. Return the wire success-arm shape (sync fast path)
+     * OR `ctx.handoffToTask(fn)` to promote the call to a background task
+     * (HITL slow path). Adopters can branch per-call: hybrid sellers route
+     * programmatic remnant sync, guaranteed inventory through HITL, all
+     * from the same method.
+     *
+     * Buyers pattern-match on the wire response shape (`media_buy_id` on
+     * the immediate response → sync; `task_id` + `status: 'submitted'` →
+     * poll `tasks_get` or receive webhook). Predictable per request,
+     * dynamic per call.
+     *
+     * Status changes flow via `publishStatusChange(...)` regardless of
+     * which path was taken.
+     *
+     * The handoff function's return value is persisted as JSONB in the
+     * task registry. Postgres-backed registries cap row size at 4MB —
+     * offload large payloads to blob storage and return references.
+     *
+     * @example Sync-only adopter (no HITL inventory)
+     * ```ts
+     * createMediaBuy: async (req, ctx) => {
+     *   return await this.commitSync(req);
+     * }
+     * ```
+     *
+     * @example HITL-only adopter (every call goes through trafficker review)
+     * ```ts
+     * createMediaBuy: async (req, ctx) => {
+     *   return ctx.handoffToTask(async (taskCtx) => {
+     *     await taskCtx.update({ message: 'Awaiting trafficker' });
+     *     return await this.runHITL(req);
+     *   });
+     * }
+     * ```
+     *
+     * @example Hybrid adopter (programmatic + guaranteed in same tenant)
+     * ```ts
+     * createMediaBuy: async (req, ctx) => {
+     *   if (this.requiresHITL(req)) {
+     *     return ctx.handoffToTask(async (taskCtx) => await this.runHITL(req));
+     *   }
+     *   return await this.commitSync(req);
+     * }
+     * ```
+     */
+    createMediaBuy(req: CreateMediaBuyRequest, ctx: Ctx<TCtxMeta>): Promise<CreateMediaBuySuccess | TaskHandoff<CreateMediaBuySuccess>>;
+    /** Sync update. Returns the patched buy. */
+    updateMediaBuy(buyId: string, patch: UpdateMediaBuyRequest, ctx: Ctx<TCtxMeta>): Promise<UpdateMediaBuySuccess>;
+    /**
+     * Push creatives. Return the array of wire success rows (sync fast
+     * path) OR `ctx.handoffToTask(fn)` to defer to a background task
+     * (HITL slow path — manual review, brand-suitability gates, etc.).
+     * Hybrid: branch per-batch — auto-approve simple creatives sync,
+     * route everything else to HITL.
+     *
+     * Each row carries `action` (CRUD outcome) and optional `status`
+     * (review state). Buyers see mixed `approved` / `pending_review`
+     * rows on the sync path; subsequent review changes flow via
+     * `publishStatusChange(...)`.
+     *
+     * @example Hybrid adopter
+     * ```ts
+     * syncCreatives: async (creatives, ctx) => {
+     *   if (creatives.some(c => this.needsReview(c))) {
+     *     return ctx.handoffToTask(async (taskCtx) => {
+     *       return await this.reviewAndPersist(creatives);
+     *     });
+     *   }
+     *   return creatives.map(c => ({ creative_id: c.creative_id, action: 'created', status: 'approved' }));
+     * }
+     * ```
+     */
+    syncCreatives?(creatives: Creative[], ctx: Ctx<TCtxMeta>): Promise<SyncCreativesRow[] | TaskHandoff<SyncCreativesRow[]>>;
+    getMediaBuyDelivery(filter: GetMediaBuyDeliveryRequest, ctx: Ctx<TCtxMeta>): Promise<GetMediaBuyDeliveryResponse>;
+    /** List media buys this account owns. Filter + pagination per the wire shape. */
+    getMediaBuys(req: GetMediaBuysRequest, ctx: Ctx<TCtxMeta>): Promise<GetMediaBuysResponse>;
+    /** Accept buyer-side performance signals on a media buy / creative. */
+    providePerformanceFeedback?(req: ProvidePerformanceFeedbackRequest, ctx: Ctx<TCtxMeta>): Promise<ProvidePerformanceFeedbackSuccess>;
+    listCreativeFormats?(req: ListCreativeFormatsRequest, ctx: Ctx<TCtxMeta>): Promise<ListCreativeFormatsResponse>;
+    listCreatives?(req: ListCreativesRequest, ctx: Ctx<TCtxMeta>): Promise<ListCreativesResponse>;
+    syncCatalogs?(req: SyncCatalogsRequest, ctx: Ctx<TCtxMeta>): Promise<SyncCatalogsSuccess>;
+    logEvent?(req: LogEventRequest, ctx: Ctx<TCtxMeta>): Promise<LogEventSuccess>;
+    syncEventSources?(req: SyncEventSourcesRequest, ctx: Ctx<TCtxMeta>): Promise<SyncEventSourcesSuccess>;
+}
+export {};
+//# sourceMappingURL=sales.d.ts.map

package/dist/lib/server/decisioning/specialisms/sales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sales.d.ts","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/specialisms/sales.ts"],"names":[],"mappings":"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"}

package/dist/lib/server/decisioning/specialisms/sales.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * SalesPlatform — sales specialism platform interface.
+ *
+ * **Unified hybrid shape.** `create_media_buy` and `sync_creatives` use a
+ * single method each. The method returns the wire success arm (sync fast
+ * path) OR `ctx.handoffToTask(fn)` to promote the call to a background
+ * task (HITL slow path). Branch per-call — the same method handles
+ * programmatic remnant, guaranteed inventory, and hybrid sellers. Every
+ * other tool is sync-only:
+ *
+ *   - `get_products` — sync. Brief in, products out.
+ *   - `create_media_buy` — sync OR `ctx.handoffToTask(...)`.
+ *   - `update_media_buy` — sync only. Re-approval flows that need HITL run
+ *     out-of-band; `publishStatusChange` carries the result.
+ *   - `sync_creatives` — sync OR `ctx.handoffToTask(...)`.
+ *   - `get_media_buy_delivery` — sync only.
+ *
+ * Sync-only tools that need long-running semantics use `publishStatusChange`
+ * (see `status-changes.ts`) — that's the spec-aligned channel for tools
+ * whose wire response unions don't define a Submitted arm.
+ *
+ * Each method either returns the value or throws `AdcpError` for structured
+ * rejection. Generic thrown errors map to `SERVICE_UNAVAILABLE`.
+ *
+ * **Method groups** — implement the group(s) matching your specialism:
+ *
+ * | Group | Methods | Claim when |
+ * |---|---|---|
+ * | Core sales (required) | `getProducts`, `updateMediaBuy`, `getMediaBuyDelivery` | Any `sales-*` specialism |
+ * | Core sales (unified hybrid) | `createMediaBuy` | Any `sales-*` specialism |
+ * | Core sales (unified hybrid) | `syncCreatives` | Any `sales-*` specialism |
+ * | Read / feedback | `getMediaBuys`, `providePerformanceFeedback`, `listCreativeFormats`, `listCreatives` | Most sellers; optional |
+ * | Retail-media extensions | `syncCatalogs`, `logEvent`, `syncEventSources` | `sales-catalog-driven`, `sales-retail-media` |
+ *
+ * New adopters implementing a non-retail seller (GAM, FreeWheel, a social
+ * platform) only need the three core-required methods plus `createMediaBuy`
+ * and `syncCreatives`. The retail-media extension methods (`syncCatalogs`,
+ * `logEvent`, `syncEventSources`) are unnecessary unless you claim
+ * `sales-catalog-driven` or `sales-retail-media`.
+ *
+ * **No-account tools (`providePerformanceFeedback`, `listCreativeFormats`):**
+ * the wire requests for these two tools don't carry an `account` field, so
+ * `ctx.account` may be `undefined` when `accounts.resolution === 'explicit'`.
+ * Three safe patterns:
+ *
+ * 1. **`'derived'` resolution** — `accounts.resolve(undefined)` returns a
+ *    singleton; `ctx.account` is always set. Best for single-tenant
+ *    deployers.
+ * 2. **Don't implement the method** — the framework returns
+ *    `UNSUPPORTED_FEATURE`; buyers using the merge-seam custom handler or
+ *    external creative agents still receive a response.
+ * 3. **Explicit-mode with defensive read** — cast `ctx.account as Account |
+ *    undefined` and derive the account from the request body (e.g., via a
+ *    `media_buy_id` lookup), or throw `AdcpError('ACCOUNT_NOT_FOUND')`.
+ *    Full `resolveAccount(undefined, { authInfo, toolName })` support for
+ *    explicit-mode lands in rc.1.
+ *
+ * Status: Preview / 6.0.
+ *
+ * @public
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=sales.js.map

package/dist/lib/server/decisioning/specialisms/sales.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sales.js","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/specialisms/sales.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG"}

package/dist/lib/server/decisioning/specialisms/signals.d.ts

@@ -0,0 +1,64 @@
+/**
+ * SignalsPlatform — signal-marketplace + signal-owned specialism interface
+ * (v6.0).
+ *
+ * Two specialisms share the same platform interface:
+ *
+ *   - **`signal-marketplace`** — third-party data brokers serving curated
+ *     audience signals (LiveRamp, Oracle Data Cloud, third-party DMPs)
+ *   - **`signal-owned`** — first-party data providers serving their own
+ *     signals (publisher first-party data, retailer customer-graph)
+ *
+ * Both expose the same surface: `getSignals` for catalog discovery and
+ * `activateSignal` for provisioning a signal onto a destination platform.
+ *
+ * Async story: `activate_signal` is sync at the wire level — its response
+ * union has no `Submitted` arm. Long-running activation pipelines (identity-
+ * graph match: 5-30 min, destination provisioning: hours) return the wire
+ * `ActivateSignalSuccess` immediately with deployments in `pending` state,
+ * then emit `publishStatusChange({ resource_type: 'signal', ... })` events
+ * as each deployment reaches `activating` / `deployed` / `failed`.
+ *
+ * Status: Preview / 6.0.
+ *
+ * @public
+ */
+import type { Account } from '../account';
+import type { RequestContext } from '../context';
+import type { GetSignalsRequest, GetSignalsResponse, ActivateSignalRequest, ActivateSignalSuccess } from '../../../types/tools.generated';
+type Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;
+export interface SignalsPlatform<TCtxMeta = Record<string, unknown>> {
+    /**
+     * Catalog discovery. Sync — query your signal index, return signals
+     * matching the buyer's filters (industry, intent type, audience size,
+     * etc.). The wire `GetSignalsResponse` has no async envelope, so
+     * platforms with slow catalog stores need internal caches.
+     *
+     * Throw `AdcpError` for buyer-fixable rejection (e.g.,
+     * `'POLICY_VIOLATION'` if the buyer doesn't have rights to the data
+     * category they're requesting).
+     */
+    getSignals(req: GetSignalsRequest, ctx: Ctx<TCtxMeta>): Promise<GetSignalsResponse>;
+    /**
+     * Provision a signal onto one or more destination platforms (Snap,
+     * Meta, TikTok, etc.). Returns the success-arm shape immediately with
+     * `deployments` rows in their current state — `'pending'` is a valid
+     * sync return for slow activation pipelines.
+     *
+     * Subsequent state changes (per-deployment `activating` / `deployed` /
+     * `failed`) flow via `publishStatusChange({ resource_type: 'signal',
+     * resource_id: signal_agent_segment_id, payload: ... })` as each
+     * destination's identity-graph match completes.
+     *
+     * Use `req.action: 'deactivate'` for GDPR/CCPA-compliant teardown when
+     * campaigns end.
+     *
+     * Throw `AdcpError` for buyer-fixable rejection:
+     *   - `'SIGNAL_NOT_FOUND'` — unknown `signal_agent_segment_id`
+     *   - `'POLICY_VIOLATION'` — buyer lacks rights to activate this data
+     *   - `'INVALID_REQUEST'` — missing or unrecognized destination
+     */
+    activateSignal(req: ActivateSignalRequest, ctx: Ctx<TCtxMeta>): Promise<ActivateSignalSuccess>;
+}
+export {};
+//# sourceMappingURL=signals.d.ts.map

package/dist/lib/server/decisioning/specialisms/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/specialisms/signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAExC,KAAK,GAAG,CAAC,QAAQ,IAAI,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEvD,MAAM,WAAW,eAAe,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE;;;;;;;;;OASG;IACH,UAAU,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEpF;;;;;;;;;;;;;;;;;;OAkBG;IACH,cAAc,CAAC,GAAG,EAAE,qBAAqB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAChG"}