@adcp/sdk 12.1.0 → 13.0.0-rc.0

package/dist/lib/server/decisioning/specialisms/brand-rights.d.mts

@@ -36,12 +36,12 @@ import type { ServerPayload } from '../../../types/server-payload.mjs';
 import type { GetBrandIdentityRequest, GetBrandIdentitySuccess, GetRightsRequest, GetRightsSuccess, AcquireRightsRequest, AcquireRightsAcquired, AcquireRightsPendingApproval, AcquireRightsRejected, UpdateRightsRequest, UpdateRightsSuccess, CreativeApprovalRequest, CreativeApproved, CreativeRejected, CreativePendingReview } from '../../../types/core.generated.mjs';
 type Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;
 export type GetBrandIdentityPayload = ServerPayload<GetBrandIdentitySuccess>;
-export type GetRightsPayload = ServerPayload<GetRightsSuccess>;
-export type AcquireRightsAcquiredPayload = ServerPayload<AcquireRightsAcquired>;
-export type AcquireRightsPendingApprovalPayload = ServerPayload<AcquireRightsPendingApproval>;
-export type AcquireRightsRejectedPayload = ServerPayload<AcquireRightsRejected>;
-export type AcquireRightsPayload = AcquireRightsAcquiredPayload | AcquireRightsPendingApprovalPayload | AcquireRightsRejectedPayload;
-export type UpdateRightsPayload = ServerPayload<UpdateRightsSuccess>;
+export type LegacyGetRightsPayload = ServerPayload<GetRightsSuccess>;
+export type LegacyAcquireRightsAcquiredPayload = ServerPayload<AcquireRightsAcquired>;
+export type LegacyAcquireRightsPendingApprovalPayload = ServerPayload<AcquireRightsPendingApproval>;
+export type LegacyAcquireRightsRejectedPayload = ServerPayload<AcquireRightsRejected>;
+export type LegacyAcquireRightsPayload = LegacyAcquireRightsAcquiredPayload | LegacyAcquireRightsPendingApprovalPayload | LegacyAcquireRightsRejectedPayload;
+export type LegacyUpdateRightsPayload = ServerPayload<UpdateRightsSuccess>;
 export type CreativeApprovedPayload = ServerPayload<CreativeApproved>;
 export type CreativeRejectedPayload = ServerPayload<CreativeRejected>;
 export type CreativePendingReviewPayload = ServerPayload<CreativePendingReview>;
@@ -64,7 +64,7 @@ export interface BrandRightsPlatform<TCtxMeta = Record<string, unknown>> {
      * Note: the wire field is `rights`, NOT `offerings`. Adopters who
      * named their internal model `offerings` translate at this seam.
      */
-    getRights(req: GetRightsRequest, ctx: Ctx<TCtxMeta>): Promise<GetRightsPayload>;
+    getRightsLegacy(req: GetRightsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyGetRightsPayload>;
     /**
      * Acquire rights — buyer commits to an offering. Four wire-spec arms:
      *
@@ -105,7 +105,7 @@ export interface BrandRightsPlatform<TCtxMeta = Record<string, unknown>> {
      * sync regardless of arm — invalid requests reject before allocating
      * any state.
      */
-    acquireRights(req: AcquireRightsRequest, ctx: Ctx<TCtxMeta>): Promise<AcquireRightsPayload>;
+    acquireRightsLegacy(req: AcquireRightsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyAcquireRightsPayload>;
     /**
      * Modify an existing rights grant — extend dates, adjust impression caps,
      * change pricing, pause/resume. Parallels `updateMediaBuy` semantics on
@@ -140,7 +140,7 @@ export interface BrandRightsPlatform<TCtxMeta = Record<string, unknown>> {
      * the response for replay against the same `idempotency_key`; this
      * handler runs at most once per (key, principal).
      */
-    updateRights(req: UpdateRightsRequest, ctx: Ctx<TCtxMeta>): Promise<UpdateRightsPayload>;
+    updateRightsLegacy(req: UpdateRightsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyUpdateRightsPayload>;
     /**
      * Review a creative submitted under an existing rights grant.
      *

package/dist/lib/server/decisioning/specialisms/brand-rights.d.ts

@@ -36,12 +36,12 @@ import type { ServerPayload } from '../../../types/server-payload';
 import type { GetBrandIdentityRequest, GetBrandIdentitySuccess, GetRightsRequest, GetRightsSuccess, AcquireRightsRequest, AcquireRightsAcquired, AcquireRightsPendingApproval, AcquireRightsRejected, UpdateRightsRequest, UpdateRightsSuccess, CreativeApprovalRequest, CreativeApproved, CreativeRejected, CreativePendingReview } from '../../../types/core.generated';
 type Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;
 export type GetBrandIdentityPayload = ServerPayload<GetBrandIdentitySuccess>;
-export type GetRightsPayload = ServerPayload<GetRightsSuccess>;
-export type AcquireRightsAcquiredPayload = ServerPayload<AcquireRightsAcquired>;
-export type AcquireRightsPendingApprovalPayload = ServerPayload<AcquireRightsPendingApproval>;
-export type AcquireRightsRejectedPayload = ServerPayload<AcquireRightsRejected>;
-export type AcquireRightsPayload = AcquireRightsAcquiredPayload | AcquireRightsPendingApprovalPayload | AcquireRightsRejectedPayload;
-export type UpdateRightsPayload = ServerPayload<UpdateRightsSuccess>;
+export type LegacyGetRightsPayload = ServerPayload<GetRightsSuccess>;
+export type LegacyAcquireRightsAcquiredPayload = ServerPayload<AcquireRightsAcquired>;
+export type LegacyAcquireRightsPendingApprovalPayload = ServerPayload<AcquireRightsPendingApproval>;
+export type LegacyAcquireRightsRejectedPayload = ServerPayload<AcquireRightsRejected>;
+export type LegacyAcquireRightsPayload = LegacyAcquireRightsAcquiredPayload | LegacyAcquireRightsPendingApprovalPayload | LegacyAcquireRightsRejectedPayload;
+export type LegacyUpdateRightsPayload = ServerPayload<UpdateRightsSuccess>;
 export type CreativeApprovedPayload = ServerPayload<CreativeApproved>;
 export type CreativeRejectedPayload = ServerPayload<CreativeRejected>;
 export type CreativePendingReviewPayload = ServerPayload<CreativePendingReview>;
@@ -64,7 +64,7 @@ export interface BrandRightsPlatform<TCtxMeta = Record<string, unknown>> {
      * Note: the wire field is `rights`, NOT `offerings`. Adopters who
      * named their internal model `offerings` translate at this seam.
      */
-    getRights(req: GetRightsRequest, ctx: Ctx<TCtxMeta>): Promise<GetRightsPayload>;
+    getRightsLegacy(req: GetRightsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyGetRightsPayload>;
     /**
      * Acquire rights — buyer commits to an offering. Four wire-spec arms:
      *
@@ -105,7 +105,7 @@ export interface BrandRightsPlatform<TCtxMeta = Record<string, unknown>> {
      * sync regardless of arm — invalid requests reject before allocating
      * any state.
      */
-    acquireRights(req: AcquireRightsRequest, ctx: Ctx<TCtxMeta>): Promise<AcquireRightsPayload>;
+    acquireRightsLegacy(req: AcquireRightsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyAcquireRightsPayload>;
     /**
      * Modify an existing rights grant — extend dates, adjust impression caps,
      * change pricing, pause/resume. Parallels `updateMediaBuy` semantics on
@@ -140,7 +140,7 @@ export interface BrandRightsPlatform<TCtxMeta = Record<string, unknown>> {
      * the response for replay against the same `idempotency_key`; this
      * handler runs at most once per (key, principal).
      */
-    updateRights(req: UpdateRightsRequest, ctx: Ctx<TCtxMeta>): Promise<UpdateRightsPayload>;
+    updateRightsLegacy(req: UpdateRightsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyUpdateRightsPayload>;
     /**
      * Review a creative submitted under an existing rights grant.
      *

package/dist/lib/server/decisioning/specialisms/brand-rights.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brand-rights.d.ts","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/specialisms/brand-rights.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAMnE,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,4BAA4B,EAC5B,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,+BAA+B,CAAC;AAEvC,KAAK,GAAG,CAAC,QAAQ,IAAI,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEvD,MAAM,MAAM,uBAAuB,GAAG,aAAa,CAAC,uBAAuB,CAAC,CAAC;AAC7E,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;AAC/D,MAAM,MAAM,4BAA4B,GAAG,aAAa,CAAC,qBAAqB,CAAC,CAAC;AAChF,MAAM,MAAM,mCAAmC,GAAG,aAAa,CAAC,4BAA4B,CAAC,CAAC;AAC9F,MAAM,MAAM,4BAA4B,GAAG,aAAa,CAAC,qBAAqB,CAAC,CAAC;AAChF,MAAM,MAAM,oBAAoB,GAC5B,4BAA4B,GAC5B,mCAAmC,GACnC,4BAA4B,CAAC;AACjC,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC;AACrE,MAAM,MAAM,uBAAuB,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;AACtE,MAAM,MAAM,uBAAuB,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;AACtE,MAAM,MAAM,4BAA4B,GAAG,aAAa,CAAC,qBAAqB,CAAC,CAAC;AAChF,MAAM,MAAM,uBAAuB,GAAG,uBAAuB,GAAG,uBAAuB,GAAG,4BAA4B,CAAC;AAEvH,MAAM,WAAW,mBAAmB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrE;;;;;OAKG;IACH,gBAAgB,CAAC,GAAG,EAAE,uBAAuB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAErG;;;;;;;;;OASG;IACH,SAAS,CAAC,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACH,aAAa,CAAC,GAAG,EAAE,oBAAoB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAE5F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,YAAY,CAAC,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,sBAAsB,CAAC,GAAG,EAAE,uBAAuB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC5G"}
+{"version":3,"file":"brand-rights.d.ts","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/specialisms/brand-rights.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAMnE,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,4BAA4B,EAC5B,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,+BAA+B,CAAC;AAEvC,KAAK,GAAG,CAAC,QAAQ,IAAI,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEvD,MAAM,MAAM,uBAAuB,GAAG,aAAa,CAAC,uBAAuB,CAAC,CAAC;AAC7E,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;AACrE,MAAM,MAAM,kCAAkC,GAAG,aAAa,CAAC,qBAAqB,CAAC,CAAC;AACtF,MAAM,MAAM,yCAAyC,GAAG,aAAa,CAAC,4BAA4B,CAAC,CAAC;AACpG,MAAM,MAAM,kCAAkC,GAAG,aAAa,CAAC,qBAAqB,CAAC,CAAC;AACtF,MAAM,MAAM,0BAA0B,GAClC,kCAAkC,GAClC,yCAAyC,GACzC,kCAAkC,CAAC;AACvC,MAAM,MAAM,yBAAyB,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC;AAC3E,MAAM,MAAM,uBAAuB,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;AACtE,MAAM,MAAM,uBAAuB,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;AACtE,MAAM,MAAM,4BAA4B,GAAG,aAAa,CAAC,qBAAqB,CAAC,CAAC;AAChF,MAAM,MAAM,uBAAuB,GAAG,uBAAuB,GAAG,uBAAuB,GAAG,4BAA4B,CAAC;AAEvH,MAAM,WAAW,mBAAmB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrE;;;;;OAKG;IACH,gBAAgB,CAAC,GAAG,EAAE,uBAAuB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAErG;;;;;;;;;OASG;IACH,eAAe,CAAC,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAE5F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACH,mBAAmB,CAAC,GAAG,EAAE,oBAAoB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAExG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,kBAAkB,CAAC,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAErG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,sBAAsB,CAAC,GAAG,EAAE,uBAAuB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC5G"}

package/dist/lib/server/decisioning/specialisms/brand-rights.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/specialisms/brand-rights.ts"],"sourcesContent":["/**\n * BrandRightsPlatform — `brand-rights` specialism (v1.0).\n *\n * Brand-rights agents handle identity discovery + licensing for branded\n * inventory — covers IP holders (sports leagues, movie studios), CTV\n * brand-rights desks, and brand-licensing marketplaces. Adopters\n * implement the four wire tools the spec ships with stable schemas\n * AND framework dispatch infrastructure (in `AdcpToolMap`):\n *\n *   - `get_brand_identity` — sync read; brand catalog + identity record\n *   - `get_rights` — sync read; rights matching a brand + use query\n *   - `acquire_rights` — buyer commits to an offering. Async outcomes\n *     are delivered via the buyer-supplied `push_notification_config`\n *     webhook (NOT a polling tool — the spec doesn't define one for\n *     this surface).\n *   - `update_rights` — modify an existing rights grant. Mutating;\n *     `idempotency_key` required. Returns updated terms + re-issued\n *     credentials, or pending if the change requires rights-holder\n *     approval (signaled via `implementation_date: null`).\n *\n * `creative_approval` is also part of this domain but is webhook-only\n * (not in `AdcpToolMap`). Adopters wire {@link reviewCreativeApproval}\n * to their HTTP server's `approval_webhook` route — the URL they\n * returned to the buyer in `acquire_rights`. Use the\n * `creativeApproved` / `creativeApprovalRejected` /\n * `creativeApprovalPendingReview` / `creativeApprovalError` builders\n * from `@adcp/sdk/server` to construct the webhook response.\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { Account } from '../account';\nimport type { RequestContext } from '../context';\nimport type { ServerPayload } from '../../../types/server-payload';\n// Brand-rights wire types only live in `core.generated`; the other\n// specialism files import from `tools.generated` (where most\n// per-tool wire types are emitted). Don't \"consistency-fix\" this\n// import path — `tools.generated` doesn't re-export the brand-rights\n// shapes.\nimport type {\n  GetBrandIdentityRequest,\n  GetBrandIdentitySuccess,\n  GetRightsRequest,\n  GetRightsSuccess,\n  AcquireRightsRequest,\n  AcquireRightsAcquired,\n  AcquireRightsPendingApproval,\n  AcquireRightsRejected,\n  UpdateRightsRequest,\n  UpdateRightsSuccess,\n  CreativeApprovalRequest,\n  CreativeApproved,\n  CreativeRejected,\n  CreativePendingReview,\n} from '../../../types/core.generated';\n\ntype Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;\n\nexport type GetBrandIdentityPayload = ServerPayload<GetBrandIdentitySuccess>;\nexport type GetRightsPayload = ServerPayload<GetRightsSuccess>;\nexport type AcquireRightsAcquiredPayload = ServerPayload<AcquireRightsAcquired>;\nexport type AcquireRightsPendingApprovalPayload = ServerPayload<AcquireRightsPendingApproval>;\nexport type AcquireRightsRejectedPayload = ServerPayload<AcquireRightsRejected>;\nexport type AcquireRightsPayload =\n  | AcquireRightsAcquiredPayload\n  | AcquireRightsPendingApprovalPayload\n  | AcquireRightsRejectedPayload;\nexport type UpdateRightsPayload = ServerPayload<UpdateRightsSuccess>;\nexport type CreativeApprovedPayload = ServerPayload<CreativeApproved>;\nexport type CreativeRejectedPayload = ServerPayload<CreativeRejected>;\nexport type CreativePendingReviewPayload = ServerPayload<CreativePendingReview>;\nexport type CreativeApprovalPayload = CreativeApprovedPayload | CreativeRejectedPayload | CreativePendingReviewPayload;\n\nexport interface BrandRightsPlatform<TCtxMeta = Record<string, unknown>> {\n  /**\n   * Read brand identity record — `brand_id`, `house`, localized `names`,\n   * optional logos / industries / `keller_type`. Sync; no async ceremony.\n   * Throw `AdcpError('REFERENCE_NOT_FOUND')` when the brand reference\n   * doesn't resolve to an identity the platform tracks.\n   */\n  getBrandIdentity(req: GetBrandIdentityRequest, ctx: Ctx<TCtxMeta>): Promise<GetBrandIdentityPayload>;\n\n  /**\n   * List rights matching a brand + use query. Sync read; framework\n   * wraps the response in the wire envelope. Returning an empty\n   * `rights` array is valid (= \"no rights available for the requested\n   * terms\"); throw `AdcpError` only for buyer-fixable rejection (e.g.,\n   * unsupported jurisdiction).\n   *\n   * Note: the wire field is `rights`, NOT `offerings`. Adopters who\n   * named their internal model `offerings` translate at this seam.\n   */\n  getRights(req: GetRightsRequest, ctx: Ctx<TCtxMeta>): Promise<GetRightsPayload>;\n\n  /**\n   * Acquire rights — buyer commits to an offering. Four wire-spec arms:\n   *\n   *   - `AcquireRightsAcquired` — rights granted immediately. Carries\n   *     `rights_id`, `rights_status: 'acquired'`, `brand_id`, `terms`,\n   *     `generation_credentials` (scoped per-LLM-provider keys), and\n   *     `rights_constraint` so the buyer can plumb the grant directly\n   *     into creative generation.\n   *   - `AcquireRightsPendingApproval` — clearance pending counter-\n   *     signature, legal review, or rights-holder approval. Carries\n   *     `rights_id`, `rights_status: 'pending_approval'`, `brand_id`, plus\n   *     optional `detail` and `estimated_response_time` (e.g., '48h').\n   *     **Async delivery is webhook-only** — the buyer's\n   *     `push_notification_config.url` receives the eventual\n   *     `Acquired` or `Rejected` outcome. The spec does NOT define\n   *     a polling tool for `acquire_rights`; do not reach for\n   *     `tasks_get` here.\n   *   - `AcquireRightsRejected` — terminal rejection. Carries\n   *     `rights_id`, `rights_status: 'rejected'`, `brand_id`, `reason`,\n   *     and optional `suggestions[]` for buyer remediation.\n   *\n   * The wire spec also defines a fourth `AcquireRightsError` arm\n   * (multi-error `{ errors: Error[] }`) for batch-style failures.\n   * Adopters who need that shape throw\n   * `AdcpError('INVALID_REQUEST', { details: { errors: [...] } })`\n   * — the framework projects to the same wire envelope. The platform\n   * interface accepts only the 3 success-arm shapes by design;\n   * `AdcpError` is the canonical multi-error path here, matching\n   * `SalesPlatform.createMediaBuy` preflight.\n   *\n   * Throw `AdcpError` only for buyer-fixable REQUEST rejection\n   * (`INVALID_REQUEST`, `BUDGET_TOO_LOW`). For spec-defined GRANT\n   * rejection (rights unavailable in jurisdiction, talent dispute\n   * pending) return the `AcquireRightsRejected` arm so the buyer sees\n   * the structured wire response with `reason` + `suggestions`.\n   *\n   * Pre-flight (catalog availability, agency authorization) MUST run\n   * sync regardless of arm — invalid requests reject before allocating\n   * any state.\n   */\n  acquireRights(req: AcquireRightsRequest, ctx: Ctx<TCtxMeta>): Promise<AcquireRightsPayload>;\n\n  /**\n   * Modify an existing rights grant — extend dates, adjust impression caps,\n   * change pricing, pause/resume. Parallels `updateMediaBuy` semantics on\n   * the media-buy side: only the fields the buyer provides are touched;\n   * omitted fields remain unchanged. The framework auto-hydrates the\n   * underlying grant from `req.rights_id` (mirroring `acquire_rights`'s\n   * `req.rights` hydration), so the implementation reads the resolved\n   * grant from `ctx.store` rather than re-fetching it.\n   *\n   * Return shape:\n   *   - `UpdateRightsPayload` — change applied. Carries updated `terms`,\n   *     re-issued `generation_credentials` (LLM keys reflecting the new\n   *     constraint), updated `rights_constraint`, and an\n   *     `implementation_date`:\n   *       - timestamp string when changes are live immediately\n   *       - **`null`** when the change requires rights-holder approval —\n   *         the buyer's `push_notification_config.url` will receive a\n   *         follow-up webhook with the resolved state.\n   *\n   * For terminal rejection (e.g., `impression_cap` below already-delivered\n   * count, `end_date` earlier than now, switching to an incompatible\n   * `pricing_option_id`) throw `AdcpError('INVALID_REQUEST', { details })`\n   * — the framework projects the throw into the `UpdateRightsError` wire\n   * arm. The Platform method's return type is `Promise<UpdateRightsPayload>`\n   * by design: error arms are exclusively reachable via thrown `AdcpError`\n   * (matching `acquireRights`'s convention — its return type carries only\n   * the three success arms; the multi-error `AcquireRightsError` arm is\n   * also thrown). For a multi-error batch result, throw with\n   * `details: { errors: [...] }` and the framework projects the array.\n   *\n   * Idempotency: required (`x-mutates-state: true`). The framework caches\n   * the response for replay against the same `idempotency_key`; this\n   * handler runs at most once per (key, principal).\n   */\n  updateRights(req: UpdateRightsRequest, ctx: Ctx<TCtxMeta>): Promise<UpdateRightsPayload>;\n\n  /**\n   * Review a creative submitted under an existing rights grant.\n   *\n   * **This is a WEBHOOK handler, not a tool.** The spec models creative\n   * approval as an HTTP webhook: the buyer POSTs a\n   * `CreativeApprovalRequest` to the `approval_webhook` URL the seller\n   * returned in `acquire_rights`. The framework does NOT register this as\n   * an MCP/A2A tool — adopters mount their own HTTP route at the URL they\n   * advertised, parse the request body against\n   * `CreativeApprovalRequestSchema`, dispatch to this method, and use\n   * `creativeApproved` / `creativeApprovalRejected` /\n   * `creativeApprovalPendingReview` / `creativeApprovalError` from\n   * `@adcp/sdk/server` to construct the JSON response.\n   *\n   * Three success arms (the framework's typed signature surfaces the\n   * three; the multi-error arm is reachable via thrown `AdcpError` once\n   * the receiver glue lands in v6.1+):\n   *\n   *   - `CreativeApproved` — creative cleared for distribution; carries\n   *     optional `conditions[]` (e.g. \"approved for NL only\").\n   *   - `CreativeRejected` — terminal rejection; carries `reason` plus\n   *     optional `suggestions[]` for remediation. Buyer revises and\n   *     resubmits with a fresh `idempotency_key`.\n   *   - `CreativePendingReview` — queued for human review. Carry\n   *     `estimated_response_time` (e.g. \"24h\") and a `status_url` the\n   *     buyer can poll.\n   *\n   * Pre-flight (rights grant exists, `creative_url` reachable for review)\n   * runs before this method — adopters can read the resolved grant from\n   * `ctx.store` after their HTTP route does the schema validation step.\n   *\n   * Idempotency: required (`x-mutates-state: true`). Resubmission with\n   * the same `idempotency_key` returns the original verdict.\n   */\n  reviewCreativeApproval(req: CreativeApprovalRequest, ctx: Ctx<TCtxMeta>): Promise<CreativeApprovalPayload>;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/specialisms/brand-rights.ts"],"sourcesContent":["/**\n * BrandRightsPlatform — `brand-rights` specialism (v1.0).\n *\n * Brand-rights agents handle identity discovery + licensing for branded\n * inventory — covers IP holders (sports leagues, movie studios), CTV\n * brand-rights desks, and brand-licensing marketplaces. Adopters\n * implement the four wire tools the spec ships with stable schemas\n * AND framework dispatch infrastructure (in `AdcpToolMap`):\n *\n *   - `get_brand_identity` — sync read; brand catalog + identity record\n *   - `get_rights` — sync read; rights matching a brand + use query\n *   - `acquire_rights` — buyer commits to an offering. Async outcomes\n *     are delivered via the buyer-supplied `push_notification_config`\n *     webhook (NOT a polling tool — the spec doesn't define one for\n *     this surface).\n *   - `update_rights` — modify an existing rights grant. Mutating;\n *     `idempotency_key` required. Returns updated terms + re-issued\n *     credentials, or pending if the change requires rights-holder\n *     approval (signaled via `implementation_date: null`).\n *\n * `creative_approval` is also part of this domain but is webhook-only\n * (not in `AdcpToolMap`). Adopters wire {@link reviewCreativeApproval}\n * to their HTTP server's `approval_webhook` route — the URL they\n * returned to the buyer in `acquire_rights`. Use the\n * `creativeApproved` / `creativeApprovalRejected` /\n * `creativeApprovalPendingReview` / `creativeApprovalError` builders\n * from `@adcp/sdk/server` to construct the webhook response.\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { Account } from '../account';\nimport type { RequestContext } from '../context';\nimport type { ServerPayload } from '../../../types/server-payload';\n// Brand-rights wire types only live in `core.generated`; the other\n// specialism files import from `tools.generated` (where most\n// per-tool wire types are emitted). Don't \"consistency-fix\" this\n// import path — `tools.generated` doesn't re-export the brand-rights\n// shapes.\nimport type {\n  GetBrandIdentityRequest,\n  GetBrandIdentitySuccess,\n  GetRightsRequest,\n  GetRightsSuccess,\n  AcquireRightsRequest,\n  AcquireRightsAcquired,\n  AcquireRightsPendingApproval,\n  AcquireRightsRejected,\n  UpdateRightsRequest,\n  UpdateRightsSuccess,\n  CreativeApprovalRequest,\n  CreativeApproved,\n  CreativeRejected,\n  CreativePendingReview,\n} from '../../../types/core.generated';\n\ntype Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;\n\nexport type GetBrandIdentityPayload = ServerPayload<GetBrandIdentitySuccess>;\nexport type LegacyGetRightsPayload = ServerPayload<GetRightsSuccess>;\nexport type LegacyAcquireRightsAcquiredPayload = ServerPayload<AcquireRightsAcquired>;\nexport type LegacyAcquireRightsPendingApprovalPayload = ServerPayload<AcquireRightsPendingApproval>;\nexport type LegacyAcquireRightsRejectedPayload = ServerPayload<AcquireRightsRejected>;\nexport type LegacyAcquireRightsPayload =\n  | LegacyAcquireRightsAcquiredPayload\n  | LegacyAcquireRightsPendingApprovalPayload\n  | LegacyAcquireRightsRejectedPayload;\nexport type LegacyUpdateRightsPayload = ServerPayload<UpdateRightsSuccess>;\nexport type CreativeApprovedPayload = ServerPayload<CreativeApproved>;\nexport type CreativeRejectedPayload = ServerPayload<CreativeRejected>;\nexport type CreativePendingReviewPayload = ServerPayload<CreativePendingReview>;\nexport type CreativeApprovalPayload = CreativeApprovedPayload | CreativeRejectedPayload | CreativePendingReviewPayload;\n\nexport interface BrandRightsPlatform<TCtxMeta = Record<string, unknown>> {\n  /**\n   * Read brand identity record — `brand_id`, `house`, localized `names`,\n   * optional logos / industries / `keller_type`. Sync; no async ceremony.\n   * Throw `AdcpError('REFERENCE_NOT_FOUND')` when the brand reference\n   * doesn't resolve to an identity the platform tracks.\n   */\n  getBrandIdentity(req: GetBrandIdentityRequest, ctx: Ctx<TCtxMeta>): Promise<GetBrandIdentityPayload>;\n\n  /**\n   * List rights matching a brand + use query. Sync read; framework\n   * wraps the response in the wire envelope. Returning an empty\n   * `rights` array is valid (= \"no rights available for the requested\n   * terms\"); throw `AdcpError` only for buyer-fixable rejection (e.g.,\n   * unsupported jurisdiction).\n   *\n   * Note: the wire field is `rights`, NOT `offerings`. Adopters who\n   * named their internal model `offerings` translate at this seam.\n   */\n  getRightsLegacy(req: GetRightsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyGetRightsPayload>;\n\n  /**\n   * Acquire rights — buyer commits to an offering. Four wire-spec arms:\n   *\n   *   - `AcquireRightsAcquired` — rights granted immediately. Carries\n   *     `rights_id`, `rights_status: 'acquired'`, `brand_id`, `terms`,\n   *     `generation_credentials` (scoped per-LLM-provider keys), and\n   *     `rights_constraint` so the buyer can plumb the grant directly\n   *     into creative generation.\n   *   - `AcquireRightsPendingApproval` — clearance pending counter-\n   *     signature, legal review, or rights-holder approval. Carries\n   *     `rights_id`, `rights_status: 'pending_approval'`, `brand_id`, plus\n   *     optional `detail` and `estimated_response_time` (e.g., '48h').\n   *     **Async delivery is webhook-only** — the buyer's\n   *     `push_notification_config.url` receives the eventual\n   *     `Acquired` or `Rejected` outcome. The spec does NOT define\n   *     a polling tool for `acquire_rights`; do not reach for\n   *     `tasks_get` here.\n   *   - `AcquireRightsRejected` — terminal rejection. Carries\n   *     `rights_id`, `rights_status: 'rejected'`, `brand_id`, `reason`,\n   *     and optional `suggestions[]` for buyer remediation.\n   *\n   * The wire spec also defines a fourth `AcquireRightsError` arm\n   * (multi-error `{ errors: Error[] }`) for batch-style failures.\n   * Adopters who need that shape throw\n   * `AdcpError('INVALID_REQUEST', { details: { errors: [...] } })`\n   * — the framework projects to the same wire envelope. The platform\n   * interface accepts only the 3 success-arm shapes by design;\n   * `AdcpError` is the canonical multi-error path here, matching\n   * `SalesPlatform.createMediaBuy` preflight.\n   *\n   * Throw `AdcpError` only for buyer-fixable REQUEST rejection\n   * (`INVALID_REQUEST`, `BUDGET_TOO_LOW`). For spec-defined GRANT\n   * rejection (rights unavailable in jurisdiction, talent dispute\n   * pending) return the `AcquireRightsRejected` arm so the buyer sees\n   * the structured wire response with `reason` + `suggestions`.\n   *\n   * Pre-flight (catalog availability, agency authorization) MUST run\n   * sync regardless of arm — invalid requests reject before allocating\n   * any state.\n   */\n  acquireRightsLegacy(req: AcquireRightsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyAcquireRightsPayload>;\n\n  /**\n   * Modify an existing rights grant — extend dates, adjust impression caps,\n   * change pricing, pause/resume. Parallels `updateMediaBuy` semantics on\n   * the media-buy side: only the fields the buyer provides are touched;\n   * omitted fields remain unchanged. The framework auto-hydrates the\n   * underlying grant from `req.rights_id` (mirroring `acquire_rights`'s\n   * `req.rights` hydration), so the implementation reads the resolved\n   * grant from `ctx.store` rather than re-fetching it.\n   *\n   * Return shape:\n   *   - `UpdateRightsPayload` — change applied. Carries updated `terms`,\n   *     re-issued `generation_credentials` (LLM keys reflecting the new\n   *     constraint), updated `rights_constraint`, and an\n   *     `implementation_date`:\n   *       - timestamp string when changes are live immediately\n   *       - **`null`** when the change requires rights-holder approval —\n   *         the buyer's `push_notification_config.url` will receive a\n   *         follow-up webhook with the resolved state.\n   *\n   * For terminal rejection (e.g., `impression_cap` below already-delivered\n   * count, `end_date` earlier than now, switching to an incompatible\n   * `pricing_option_id`) throw `AdcpError('INVALID_REQUEST', { details })`\n   * — the framework projects the throw into the `UpdateRightsError` wire\n   * arm. The Platform method's return type is `Promise<UpdateRightsPayload>`\n   * by design: error arms are exclusively reachable via thrown `AdcpError`\n   * (matching `acquireRights`'s convention — its return type carries only\n   * the three success arms; the multi-error `AcquireRightsError` arm is\n   * also thrown). For a multi-error batch result, throw with\n   * `details: { errors: [...] }` and the framework projects the array.\n   *\n   * Idempotency: required (`x-mutates-state: true`). The framework caches\n   * the response for replay against the same `idempotency_key`; this\n   * handler runs at most once per (key, principal).\n   */\n  updateRightsLegacy(req: UpdateRightsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyUpdateRightsPayload>;\n\n  /**\n   * Review a creative submitted under an existing rights grant.\n   *\n   * **This is a WEBHOOK handler, not a tool.** The spec models creative\n   * approval as an HTTP webhook: the buyer POSTs a\n   * `CreativeApprovalRequest` to the `approval_webhook` URL the seller\n   * returned in `acquire_rights`. The framework does NOT register this as\n   * an MCP/A2A tool — adopters mount their own HTTP route at the URL they\n   * advertised, parse the request body against\n   * `CreativeApprovalRequestSchema`, dispatch to this method, and use\n   * `creativeApproved` / `creativeApprovalRejected` /\n   * `creativeApprovalPendingReview` / `creativeApprovalError` from\n   * `@adcp/sdk/server` to construct the JSON response.\n   *\n   * Three success arms (the framework's typed signature surfaces the\n   * three; the multi-error arm is reachable via thrown `AdcpError` once\n   * the receiver glue lands in v6.1+):\n   *\n   *   - `CreativeApproved` — creative cleared for distribution; carries\n   *     optional `conditions[]` (e.g. \"approved for NL only\").\n   *   - `CreativeRejected` — terminal rejection; carries `reason` plus\n   *     optional `suggestions[]` for remediation. Buyer revises and\n   *     resubmits with a fresh `idempotency_key`.\n   *   - `CreativePendingReview` — queued for human review. Carry\n   *     `estimated_response_time` (e.g. \"24h\") and a `status_url` the\n   *     buyer can poll.\n   *\n   * Pre-flight (rights grant exists, `creative_url` reachable for review)\n   * runs before this method — adopters can read the resolved grant from\n   * `ctx.store` after their HTTP route does the schema validation step.\n   *\n   * Idempotency: required (`x-mutates-state: true`). Resubmission with\n   * the same `idempotency_key` returns the original verdict.\n   */\n  reviewCreativeApproval(req: CreativeApprovalRequest, ctx: Ctx<TCtxMeta>): Promise<CreativeApprovalPayload>;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/lib/server/decisioning/specialisms/content-standards.d.mts

@@ -35,52 +35,52 @@ import type { RequestContext } from '../context.mjs';
 import type { ServerPayload } from '../../../types/server-payload.mjs';
 import type { ListContentStandardsRequest, ListContentStandardsResponse, GetContentStandardsRequest, GetContentStandardsResponse, CreateContentStandardsRequest, CreateContentStandardsResponse, UpdateContentStandardsRequest, UpdateContentStandardsResponse, CalibrateContentRequest, CalibrateContentResponse, ValidateContentDeliveryRequest, ValidateContentDeliveryResponse, GetMediaBuyArtifactsRequest, GetMediaBuyArtifactsResponse, GetCreativeFeaturesRequest, GetCreativeFeaturesResponse } from '../../../types/tools.generated.mjs';
 type Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;
-export type ListContentStandardsPayload = ServerPayload<ListContentStandardsResponse>;
-export type GetContentStandardsPayload = ServerPayload<GetContentStandardsResponse>;
-export type CreateContentStandardsPayload = ServerPayload<CreateContentStandardsResponse>;
-export type UpdateContentStandardsPayload = ServerPayload<UpdateContentStandardsResponse>;
-export type CalibrateContentPayload = ServerPayload<CalibrateContentResponse>;
-export type ValidateContentDeliveryPayload = ServerPayload<ValidateContentDeliveryResponse>;
-export type GetMediaBuyArtifactsPayload = ServerPayload<GetMediaBuyArtifactsResponse>;
-export type GetCreativeFeaturesPayload = ServerPayload<GetCreativeFeaturesResponse>;
+export type LegacyListContentStandardsPayload = ServerPayload<ListContentStandardsResponse>;
+export type LegacyGetContentStandardsPayload = ServerPayload<GetContentStandardsResponse>;
+export type LegacyCreateContentStandardsPayload = ServerPayload<CreateContentStandardsResponse>;
+export type LegacyUpdateContentStandardsPayload = ServerPayload<UpdateContentStandardsResponse>;
+export type LegacyCalibrateContentPayload = ServerPayload<CalibrateContentResponse>;
+export type LegacyValidateContentDeliveryPayload = ServerPayload<ValidateContentDeliveryResponse>;
+export type LegacyGetMediaBuyArtifactsPayload = ServerPayload<GetMediaBuyArtifactsResponse>;
+export type LegacyGetCreativeFeaturesPayload = ServerPayload<GetCreativeFeaturesResponse>;
 export interface ContentStandardsPlatform<TCtxMeta = Record<string, unknown>> {
     /** Discover content standards published by this agent. */
-    listContentStandards(req: ListContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<ListContentStandardsPayload>;
+    listContentStandardsLegacy(req: ListContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyListContentStandardsPayload>;
     /** Read a single content standard by id. */
-    getContentStandards(req: GetContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<GetContentStandardsPayload>;
+    getContentStandardsLegacy(req: GetContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyGetContentStandardsPayload>;
     /**
      * Create a new content standard. Adopter validates the policy schema
      * and returns the persisted record. Idempotent on the buyer's
      * `idempotency_key`.
      */
-    createContentStandards(req: CreateContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<CreateContentStandardsPayload>;
+    createContentStandardsLegacy(req: CreateContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyCreateContentStandardsPayload>;
     /** Update an existing content standard. */
-    updateContentStandards(req: UpdateContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<UpdateContentStandardsPayload>;
+    updateContentStandardsLegacy(req: UpdateContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyUpdateContentStandardsPayload>;
     /**
      * Calibrate content against the published standards. Returns the
      * standard's current calibration profile + any flags raised against
      * the submitted content.
      */
-    calibrateContent(req: CalibrateContentRequest, ctx: Ctx<TCtxMeta>): Promise<CalibrateContentPayload>;
+    calibrateContentLegacy(req: CalibrateContentRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyCalibrateContentPayload>;
     /**
      * Validate that a delivered media-buy / creative meets the buyer's
      * declared content-standards. Sellers call this post-flight to confirm
      * adjacency and policy conformance before issuing a
      * `validate_content_delivery_artifact` to a governance agent.
      */
-    validateContentDelivery(req: ValidateContentDeliveryRequest, ctx: Ctx<TCtxMeta>): Promise<ValidateContentDeliveryPayload>;
+    validateContentDeliveryLegacy(req: ValidateContentDeliveryRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyValidateContentDeliveryPayload>;
     /**
      * Read content artifacts produced during a media buy's flight (creative
      * proofs, ad-server tags, completed log captures). Optional — adopters
      * who don't expose artifact archival omit. Required by governance
      * receivers running adjacency validation.
      */
-    getMediaBuyArtifacts?(req: GetMediaBuyArtifactsRequest, ctx: Ctx<TCtxMeta>): Promise<GetMediaBuyArtifactsPayload>;
+    getMediaBuyArtifactsLegacy?(req: GetMediaBuyArtifactsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyGetMediaBuyArtifactsPayload>;
     /**
      * Read per-creative analyzed features (object detection, scene
      * classification, transcript) the agent extracted during calibration.
      * Optional — adopters without analyzer pipelines omit.
      */
-    getCreativeFeatures?(req: GetCreativeFeaturesRequest, ctx: Ctx<TCtxMeta>): Promise<GetCreativeFeaturesPayload>;
+    getCreativeFeaturesLegacy?(req: GetCreativeFeaturesRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyGetCreativeFeaturesPayload>;
 }
 export {};

package/dist/lib/server/decisioning/specialisms/content-standards.d.ts

@@ -35,53 +35,53 @@ import type { RequestContext } from '../context';
 import type { ServerPayload } from '../../../types/server-payload';
 import type { ListContentStandardsRequest, ListContentStandardsResponse, GetContentStandardsRequest, GetContentStandardsResponse, CreateContentStandardsRequest, CreateContentStandardsResponse, UpdateContentStandardsRequest, UpdateContentStandardsResponse, CalibrateContentRequest, CalibrateContentResponse, ValidateContentDeliveryRequest, ValidateContentDeliveryResponse, GetMediaBuyArtifactsRequest, GetMediaBuyArtifactsResponse, GetCreativeFeaturesRequest, GetCreativeFeaturesResponse } from '../../../types/tools.generated';
 type Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;
-export type ListContentStandardsPayload = ServerPayload<ListContentStandardsResponse>;
-export type GetContentStandardsPayload = ServerPayload<GetContentStandardsResponse>;
-export type CreateContentStandardsPayload = ServerPayload<CreateContentStandardsResponse>;
-export type UpdateContentStandardsPayload = ServerPayload<UpdateContentStandardsResponse>;
-export type CalibrateContentPayload = ServerPayload<CalibrateContentResponse>;
-export type ValidateContentDeliveryPayload = ServerPayload<ValidateContentDeliveryResponse>;
-export type GetMediaBuyArtifactsPayload = ServerPayload<GetMediaBuyArtifactsResponse>;
-export type GetCreativeFeaturesPayload = ServerPayload<GetCreativeFeaturesResponse>;
+export type LegacyListContentStandardsPayload = ServerPayload<ListContentStandardsResponse>;
+export type LegacyGetContentStandardsPayload = ServerPayload<GetContentStandardsResponse>;
+export type LegacyCreateContentStandardsPayload = ServerPayload<CreateContentStandardsResponse>;
+export type LegacyUpdateContentStandardsPayload = ServerPayload<UpdateContentStandardsResponse>;
+export type LegacyCalibrateContentPayload = ServerPayload<CalibrateContentResponse>;
+export type LegacyValidateContentDeliveryPayload = ServerPayload<ValidateContentDeliveryResponse>;
+export type LegacyGetMediaBuyArtifactsPayload = ServerPayload<GetMediaBuyArtifactsResponse>;
+export type LegacyGetCreativeFeaturesPayload = ServerPayload<GetCreativeFeaturesResponse>;
 export interface ContentStandardsPlatform<TCtxMeta = Record<string, unknown>> {
     /** Discover content standards published by this agent. */
-    listContentStandards(req: ListContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<ListContentStandardsPayload>;
+    listContentStandardsLegacy(req: ListContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyListContentStandardsPayload>;
     /** Read a single content standard by id. */
-    getContentStandards(req: GetContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<GetContentStandardsPayload>;
+    getContentStandardsLegacy(req: GetContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyGetContentStandardsPayload>;
     /**
      * Create a new content standard. Adopter validates the policy schema
      * and returns the persisted record. Idempotent on the buyer's
      * `idempotency_key`.
      */
-    createContentStandards(req: CreateContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<CreateContentStandardsPayload>;
+    createContentStandardsLegacy(req: CreateContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyCreateContentStandardsPayload>;
     /** Update an existing content standard. */
-    updateContentStandards(req: UpdateContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<UpdateContentStandardsPayload>;
+    updateContentStandardsLegacy(req: UpdateContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyUpdateContentStandardsPayload>;
     /**
      * Calibrate content against the published standards. Returns the
      * standard's current calibration profile + any flags raised against
      * the submitted content.
      */
-    calibrateContent(req: CalibrateContentRequest, ctx: Ctx<TCtxMeta>): Promise<CalibrateContentPayload>;
+    calibrateContentLegacy(req: CalibrateContentRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyCalibrateContentPayload>;
     /**
      * Validate that a delivered media-buy / creative meets the buyer's
      * declared content-standards. Sellers call this post-flight to confirm
      * adjacency and policy conformance before issuing a
      * `validate_content_delivery_artifact` to a governance agent.
      */
-    validateContentDelivery(req: ValidateContentDeliveryRequest, ctx: Ctx<TCtxMeta>): Promise<ValidateContentDeliveryPayload>;
+    validateContentDeliveryLegacy(req: ValidateContentDeliveryRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyValidateContentDeliveryPayload>;
     /**
      * Read content artifacts produced during a media buy's flight (creative
      * proofs, ad-server tags, completed log captures). Optional — adopters
      * who don't expose artifact archival omit. Required by governance
      * receivers running adjacency validation.
      */
-    getMediaBuyArtifacts?(req: GetMediaBuyArtifactsRequest, ctx: Ctx<TCtxMeta>): Promise<GetMediaBuyArtifactsPayload>;
+    getMediaBuyArtifactsLegacy?(req: GetMediaBuyArtifactsRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyGetMediaBuyArtifactsPayload>;
     /**
      * Read per-creative analyzed features (object detection, scene
      * classification, transcript) the agent extracted during calibration.
      * Optional — adopters without analyzer pipelines omit.
      */
-    getCreativeFeatures?(req: GetCreativeFeaturesRequest, ctx: Ctx<TCtxMeta>): Promise<GetCreativeFeaturesPayload>;
+    getCreativeFeaturesLegacy?(req: GetCreativeFeaturesRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyGetCreativeFeaturesPayload>;
 }
 export {};
 //# sourceMappingURL=content-standards.d.ts.map

package/dist/lib/server/decisioning/specialisms/content-standards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-standards.d.ts","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/specialisms/content-standards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EACV,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC3B,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,8BAA8B,EAC9B,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAC/B,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC5B,MAAM,gCAAgC,CAAC;AAExC,KAAK,GAAG,CAAC,QAAQ,IAAI,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEvD,MAAM,MAAM,2BAA2B,GAAG,aAAa,CAAC,4BAA4B,CAAC,CAAC;AACtF,MAAM,MAAM,0BAA0B,GAAG,aAAa,CAAC,2BAA2B,CAAC,CAAC;AACpF,MAAM,MAAM,6BAA6B,GAAG,aAAa,CAAC,8BAA8B,CAAC,CAAC;AAC1F,MAAM,MAAM,6BAA6B,GAAG,aAAa,CAAC,8BAA8B,CAAC,CAAC;AAC1F,MAAM,MAAM,uBAAuB,GAAG,aAAa,CAAC,wBAAwB,CAAC,CAAC;AAC9E,MAAM,MAAM,8BAA8B,GAAG,aAAa,CAAC,+BAA+B,CAAC,CAAC;AAC5F,MAAM,MAAM,2BAA2B,GAAG,aAAa,CAAC,4BAA4B,CAAC,CAAC;AACtF,MAAM,MAAM,0BAA0B,GAAG,aAAa,CAAC,2BAA2B,CAAC,CAAC;AAEpF,MAAM,WAAW,wBAAwB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1E,0DAA0D;IAC1D,oBAAoB,CAAC,GAAG,EAAE,2BAA2B,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAEjH,4CAA4C;IAC5C,mBAAmB,CAAC,GAAG,EAAE,0BAA0B,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAE9G;;;;OAIG;IACH,sBAAsB,CACpB,GAAG,EAAE,6BAA6B,EAClC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GACjB,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAE1C,2CAA2C;IAC3C,sBAAsB,CACpB,GAAG,EAAE,6BAA6B,EAClC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GACjB,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAE1C;;;;OAIG;IACH,gBAAgB,CAAC,GAAG,EAAE,uBAAuB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAErG;;;;;OAKG;IACH,uBAAuB,CACrB,GAAG,EAAE,8BAA8B,EACnC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GACjB,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAE3C;;;;;OAKG;IACH,oBAAoB,CAAC,CAAC,GAAG,EAAE,2BAA2B,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAElH;;;;OAIG;IACH,mBAAmB,CAAC,CAAC,GAAG,EAAE,0BAA0B,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CAChH"}
+{"version":3,"file":"content-standards.d.ts","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/specialisms/content-standards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EACV,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC3B,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,8BAA8B,EAC9B,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAC/B,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC5B,MAAM,gCAAgC,CAAC;AAExC,KAAK,GAAG,CAAC,QAAQ,IAAI,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEvD,MAAM,MAAM,iCAAiC,GAAG,aAAa,CAAC,4BAA4B,CAAC,CAAC;AAC5F,MAAM,MAAM,gCAAgC,GAAG,aAAa,CAAC,2BAA2B,CAAC,CAAC;AAC1F,MAAM,MAAM,mCAAmC,GAAG,aAAa,CAAC,8BAA8B,CAAC,CAAC;AAChG,MAAM,MAAM,mCAAmC,GAAG,aAAa,CAAC,8BAA8B,CAAC,CAAC;AAChG,MAAM,MAAM,6BAA6B,GAAG,aAAa,CAAC,wBAAwB,CAAC,CAAC;AACpF,MAAM,MAAM,oCAAoC,GAAG,aAAa,CAAC,+BAA+B,CAAC,CAAC;AAClG,MAAM,MAAM,iCAAiC,GAAG,aAAa,CAAC,4BAA4B,CAAC,CAAC;AAC5F,MAAM,MAAM,gCAAgC,GAAG,aAAa,CAAC,2BAA2B,CAAC,CAAC;AAE1F,MAAM,WAAW,wBAAwB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1E,0DAA0D;IAC1D,0BAA0B,CACxB,GAAG,EAAE,2BAA2B,EAChC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GACjB,OAAO,CAAC,iCAAiC,CAAC,CAAC;IAE9C,4CAA4C;IAC5C,yBAAyB,CACvB,GAAG,EAAE,0BAA0B,EAC/B,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GACjB,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAE7C;;;;OAIG;IACH,4BAA4B,CAC1B,GAAG,EAAE,6BAA6B,EAClC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GACjB,OAAO,CAAC,mCAAmC,CAAC,CAAC;IAEhD,2CAA2C;IAC3C,4BAA4B,CAC1B,GAAG,EAAE,6BAA6B,EAClC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GACjB,OAAO,CAAC,mCAAmC,CAAC,CAAC;IAEhD;;;;OAIG;IACH,sBAAsB,CAAC,GAAG,EAAE,uBAAuB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAEjH;;;;;OAKG;IACH,6BAA6B,CAC3B,GAAG,EAAE,8BAA8B,EACnC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GACjB,OAAO,CAAC,oCAAoC,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,0BAA0B,CAAC,CACzB,GAAG,EAAE,2BAA2B,EAChC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GACjB,OAAO,CAAC,iCAAiC,CAAC,CAAC;IAE9C;;;;OAIG;IACH,yBAAyB,CAAC,CACxB,GAAG,EAAE,0BAA0B,EAC/B,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GACjB,OAAO,CAAC,gCAAgC,CAAC,CAAC;CAC9C"}

package/dist/lib/server/decisioning/specialisms/content-standards.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/specialisms/content-standards.ts"],"sourcesContent":["/**\n * ContentStandardsPlatform — `content-standards` specialism (v6.0).\n *\n * Content standards enforcement: brand safety policies, content adjacency\n * rules, and per-creative compliance verification. Adopters who claim\n * `content-standards` in `capabilities.specialisms[]` implement this\n * interface; the framework wires the 6 wire tools that make up the\n * content-standards surface.\n *\n * Two adopter shapes:\n *\n *   - **Standalone content-standards agent** (Innovid-style): runs apart\n *     from a sales agent; buyers call `list_content_standards` /\n *     `get_content_standards` / `validate_content_delivery` directly.\n *   - **Composed within a seller** (governance overlay): seller imports\n *     content-standards into its agent surface, calls `calibrate_content`\n *     internally during creative review, and surfaces violations through\n *     `sync_creatives` review state.\n *\n * Both shapes use the same interface; difference is whether the platform\n * field is populated alongside `sales` or as the only specialism.\n *\n * The two analyzer methods (`getMediaBuyArtifacts`, `getCreativeFeatures`)\n * are listed under the same surface in the framework's `GovernanceHandlers`\n * because they're content-feature reads adopters typically expose alongside\n * the policy CRUD. Optional — adopters who don't run analyzer pipelines\n * leave them undefined.\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { Account } from '../account';\nimport type { RequestContext } from '../context';\nimport type { ServerPayload } from '../../../types/server-payload';\nimport type {\n  ListContentStandardsRequest,\n  ListContentStandardsResponse,\n  GetContentStandardsRequest,\n  GetContentStandardsResponse,\n  CreateContentStandardsRequest,\n  CreateContentStandardsResponse,\n  UpdateContentStandardsRequest,\n  UpdateContentStandardsResponse,\n  CalibrateContentRequest,\n  CalibrateContentResponse,\n  ValidateContentDeliveryRequest,\n  ValidateContentDeliveryResponse,\n  GetMediaBuyArtifactsRequest,\n  GetMediaBuyArtifactsResponse,\n  GetCreativeFeaturesRequest,\n  GetCreativeFeaturesResponse,\n} from '../../../types/tools.generated';\n\ntype Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;\n\nexport type ListContentStandardsPayload = ServerPayload<ListContentStandardsResponse>;\nexport type GetContentStandardsPayload = ServerPayload<GetContentStandardsResponse>;\nexport type CreateContentStandardsPayload = ServerPayload<CreateContentStandardsResponse>;\nexport type UpdateContentStandardsPayload = ServerPayload<UpdateContentStandardsResponse>;\nexport type CalibrateContentPayload = ServerPayload<CalibrateContentResponse>;\nexport type ValidateContentDeliveryPayload = ServerPayload<ValidateContentDeliveryResponse>;\nexport type GetMediaBuyArtifactsPayload = ServerPayload<GetMediaBuyArtifactsResponse>;\nexport type GetCreativeFeaturesPayload = ServerPayload<GetCreativeFeaturesResponse>;\n\nexport interface ContentStandardsPlatform<TCtxMeta = Record<string, unknown>> {\n  /** Discover content standards published by this agent. */\n  listContentStandards(req: ListContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<ListContentStandardsPayload>;\n\n  /** Read a single content standard by id. */\n  getContentStandards(req: GetContentStandardsRequest, ctx: Ctx<TCtxMeta>): Promise<GetContentStandardsPayload>;\n\n  /**\n   * Create a new content standard. Adopter validates the policy schema\n   * and returns the persisted record. Idempotent on the buyer's\n   * `idempotency_key`.\n   */\n  createContentStandards(\n    req: CreateContentStandardsRequest,\n    ctx: Ctx<TCtxMeta>\n  ): Promise<CreateContentStandardsPayload>;\n\n  /** Update an existing content standard. */\n  updateContentStandards(\n    req: UpdateContentStandardsRequest,\n    ctx: Ctx<TCtxMeta>\n  ): Promise<UpdateContentStandardsPayload>;\n\n  /**\n   * Calibrate content against the published standards. Returns the\n   * standard's current calibration profile + any flags raised against\n   * the submitted content.\n   */\n  calibrateContent(req: CalibrateContentRequest, ctx: Ctx<TCtxMeta>): Promise<CalibrateContentPayload>;\n\n  /**\n   * Validate that a delivered media-buy / creative meets the buyer's\n   * declared content-standards. Sellers call this post-flight to confirm\n   * adjacency and policy conformance before issuing a\n   * `validate_content_delivery_artifact` to a governance agent.\n   */\n  validateContentDelivery(\n    req: ValidateContentDeliveryRequest,\n    ctx: Ctx<TCtxMeta>\n  ): Promise<ValidateContentDeliveryPayload>;\n\n  /**\n   * Read content artifacts produced during a media buy's flight (creative\n   * proofs, ad-server tags, completed log captures). Optional — adopters\n   * who don't expose artifact archival omit. Required by governance\n   * receivers running adjacency validation.\n   */\n  getMediaBuyArtifacts?(req: GetMediaBuyArtifactsRequest, ctx: Ctx<TCtxMeta>): Promise<GetMediaBuyArtifactsPayload>;\n\n  /**\n   * Read per-creative analyzed features (object detection, scene\n   * classification, transcript) the agent extracted during calibration.\n   * Optional — adopters without analyzer pipelines omit.\n   */\n  getCreativeFeatures?(req: GetCreativeFeaturesRequest, ctx: Ctx<TCtxMeta>): Promise<GetCreativeFeaturesPayload>;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/specialisms/content-standards.ts"],"sourcesContent":["/**\n * ContentStandardsPlatform — `content-standards` specialism (v6.0).\n *\n * Content standards enforcement: brand safety policies, content adjacency\n * rules, and per-creative compliance verification. Adopters who claim\n * `content-standards` in `capabilities.specialisms[]` implement this\n * interface; the framework wires the 6 wire tools that make up the\n * content-standards surface.\n *\n * Two adopter shapes:\n *\n *   - **Standalone content-standards agent** (Innovid-style): runs apart\n *     from a sales agent; buyers call `list_content_standards` /\n *     `get_content_standards` / `validate_content_delivery` directly.\n *   - **Composed within a seller** (governance overlay): seller imports\n *     content-standards into its agent surface, calls `calibrate_content`\n *     internally during creative review, and surfaces violations through\n *     `sync_creatives` review state.\n *\n * Both shapes use the same interface; difference is whether the platform\n * field is populated alongside `sales` or as the only specialism.\n *\n * The two analyzer methods (`getMediaBuyArtifacts`, `getCreativeFeatures`)\n * are listed under the same surface in the framework's `GovernanceHandlers`\n * because they're content-feature reads adopters typically expose alongside\n * the policy CRUD. Optional — adopters who don't run analyzer pipelines\n * leave them undefined.\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { Account } from '../account';\nimport type { RequestContext } from '../context';\nimport type { ServerPayload } from '../../../types/server-payload';\nimport type {\n  ListContentStandardsRequest,\n  ListContentStandardsResponse,\n  GetContentStandardsRequest,\n  GetContentStandardsResponse,\n  CreateContentStandardsRequest,\n  CreateContentStandardsResponse,\n  UpdateContentStandardsRequest,\n  UpdateContentStandardsResponse,\n  CalibrateContentRequest,\n  CalibrateContentResponse,\n  ValidateContentDeliveryRequest,\n  ValidateContentDeliveryResponse,\n  GetMediaBuyArtifactsRequest,\n  GetMediaBuyArtifactsResponse,\n  GetCreativeFeaturesRequest,\n  GetCreativeFeaturesResponse,\n} from '../../../types/tools.generated';\n\ntype Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;\n\nexport type LegacyListContentStandardsPayload = ServerPayload<ListContentStandardsResponse>;\nexport type LegacyGetContentStandardsPayload = ServerPayload<GetContentStandardsResponse>;\nexport type LegacyCreateContentStandardsPayload = ServerPayload<CreateContentStandardsResponse>;\nexport type LegacyUpdateContentStandardsPayload = ServerPayload<UpdateContentStandardsResponse>;\nexport type LegacyCalibrateContentPayload = ServerPayload<CalibrateContentResponse>;\nexport type LegacyValidateContentDeliveryPayload = ServerPayload<ValidateContentDeliveryResponse>;\nexport type LegacyGetMediaBuyArtifactsPayload = ServerPayload<GetMediaBuyArtifactsResponse>;\nexport type LegacyGetCreativeFeaturesPayload = ServerPayload<GetCreativeFeaturesResponse>;\n\nexport interface ContentStandardsPlatform<TCtxMeta = Record<string, unknown>> {\n  /** Discover content standards published by this agent. */\n  listContentStandardsLegacy(\n    req: ListContentStandardsRequest,\n    ctx: Ctx<TCtxMeta>\n  ): Promise<LegacyListContentStandardsPayload>;\n\n  /** Read a single content standard by id. */\n  getContentStandardsLegacy(\n    req: GetContentStandardsRequest,\n    ctx: Ctx<TCtxMeta>\n  ): Promise<LegacyGetContentStandardsPayload>;\n\n  /**\n   * Create a new content standard. Adopter validates the policy schema\n   * and returns the persisted record. Idempotent on the buyer's\n   * `idempotency_key`.\n   */\n  createContentStandardsLegacy(\n    req: CreateContentStandardsRequest,\n    ctx: Ctx<TCtxMeta>\n  ): Promise<LegacyCreateContentStandardsPayload>;\n\n  /** Update an existing content standard. */\n  updateContentStandardsLegacy(\n    req: UpdateContentStandardsRequest,\n    ctx: Ctx<TCtxMeta>\n  ): Promise<LegacyUpdateContentStandardsPayload>;\n\n  /**\n   * Calibrate content against the published standards. Returns the\n   * standard's current calibration profile + any flags raised against\n   * the submitted content.\n   */\n  calibrateContentLegacy(req: CalibrateContentRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyCalibrateContentPayload>;\n\n  /**\n   * Validate that a delivered media-buy / creative meets the buyer's\n   * declared content-standards. Sellers call this post-flight to confirm\n   * adjacency and policy conformance before issuing a\n   * `validate_content_delivery_artifact` to a governance agent.\n   */\n  validateContentDeliveryLegacy(\n    req: ValidateContentDeliveryRequest,\n    ctx: Ctx<TCtxMeta>\n  ): Promise<LegacyValidateContentDeliveryPayload>;\n\n  /**\n   * Read content artifacts produced during a media buy's flight (creative\n   * proofs, ad-server tags, completed log captures). Optional — adopters\n   * who don't expose artifact archival omit. Required by governance\n   * receivers running adjacency validation.\n   */\n  getMediaBuyArtifactsLegacy?(\n    req: GetMediaBuyArtifactsRequest,\n    ctx: Ctx<TCtxMeta>\n  ): Promise<LegacyGetMediaBuyArtifactsPayload>;\n\n  /**\n   * Read per-creative analyzed features (object detection, scene\n   * classification, transcript) the agent extracted during calibration.\n   * Optional — adopters without analyzer pipelines omit.\n   */\n  getCreativeFeaturesLegacy?(\n    req: GetCreativeFeaturesRequest,\n    ctx: Ctx<TCtxMeta>\n  ): Promise<LegacyGetCreativeFeaturesPayload>;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

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

@@ -27,17 +27,19 @@ import type { Account, NoAccountCtx } from '../account.mjs';
 import type { RequestContext } from '../context.mjs';
 import type { TaskHandoff } from '../async-outcome.mjs';
 import type { ServerPayload } from '../../../types/server-payload.mjs';
-import type { BuildCreativeRequest, CreativeManifest, PreviewCreativeRequest, PreviewCreativeResponse, ListCreativesRequest, ListCreativesResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse, GetCreativeDeliveryRequest, GetCreativeDeliveryResponse, CreativeAsset, BuildCreativeSuccess, BuildCreativeMultiSuccess } from '../../../types/tools.generated.mjs';
+import type { BuildCreativeRequest, CreativeManifest, PreviewCreativeRequest, PreviewCreativeResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse, GetCreativeDeliveryRequest, GetCreativeDeliveryResponse, BuildCreativeSuccess, BuildCreativeMultiSuccess } from '../../../types/tools.generated.mjs';
+import type { CanonicalCreativeAsset, CanonicalCreativeResponse, CanonicalListCreativesRequest, CanonicalListCreativesResponse } from '../../../v2/projection/creative-delivery.mjs';
 import type { SyncCreativesRow } from './sales.mjs';
-type Creative = CreativeAsset;
+type Creative = CanonicalCreativeAsset;
 type Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;
-export type PreviewCreativePayload = ServerPayload<PreviewCreativeResponse>;
-export type ListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;
-export type ListCreativesPayload = ServerPayload<ListCreativesResponse>;
-export type GetCreativeDeliveryPayload = ServerPayload<GetCreativeDeliveryResponse>;
-export type BuildCreativePayload = ServerPayload<BuildCreativeSuccess>;
-export type BuildCreativeMultiPayload = ServerPayload<BuildCreativeMultiSuccess>;
-export type BuildCreativeReturn = CreativeManifest | CreativeManifest[] | BuildCreativePayload | BuildCreativeMultiPayload;
+export type LegacyPreviewCreativePayload = ServerPayload<PreviewCreativeResponse>;
+export type LegacyListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;
+export type ListCreativesPayload = ServerPayload<CanonicalListCreativesResponse>;
+export type GetCreativeDeliveryPayload = ServerPayload<CanonicalCreativeResponse<GetCreativeDeliveryResponse>>;
+export type LegacyGetCreativeDeliveryPayload = ServerPayload<GetCreativeDeliveryResponse>;
+export type LegacyBuildCreativePayload = ServerPayload<BuildCreativeSuccess>;
+export type LegacyBuildCreativeMultiPayload = ServerPayload<BuildCreativeMultiSuccess>;
+export type LegacyBuildCreativeReturn = CreativeManifest | CreativeManifest[] | LegacyBuildCreativePayload | LegacyBuildCreativeMultiPayload;
 export interface CreativeAdServerPlatform<TCtxMeta = Record<string, unknown>> {
     /**
      * Build / retrieve creative tags. Two invocation modes per the spec:
@@ -59,7 +61,7 @@ export interface CreativeAdServerPlatform<TCtxMeta = Record<string, unknown>> {
      * that lands, slow tag-generation pipelines await in-request; status
      * changes flow via `publishStatusChange`.
      */
-    buildCreative(req: BuildCreativeRequest, ctx: Ctx<TCtxMeta>): Promise<BuildCreativeReturn>;
+    buildCreativeLegacy(req: BuildCreativeRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyBuildCreativeReturn>;
     /**
      * Preview-only variant — sandbox URL or inline HTML, expires. Always sync.
      *
@@ -67,7 +69,7 @@ export interface CreativeAdServerPlatform<TCtxMeta = Record<string, unknown>> {
      * does not carry an `account` field; narrow `ctx.account` before reading
      * `ctx_metadata` / `id`. See {@link NoAccountCtx}.
      */
-    previewCreative(req: PreviewCreativeRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<PreviewCreativePayload>;
+    previewCreativeLegacy(req: PreviewCreativeRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<LegacyPreviewCreativePayload>;
     /**
      * Format catalog. Optional because adopters who delegate format definitions
      * to a separate creative agent (declared via `capabilities.creative_agents`)
@@ -75,7 +77,7 @@ export interface CreativeAdServerPlatform<TCtxMeta = Record<string, unknown>> {
      *
      * ⚠️  NO-ACCOUNT TOOL. See `previewCreative` note above.
      */
-    listCreativeFormats?(req: ListCreativeFormatsRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<ListCreativeFormatsPayload>;
+    listCreativeFormatsLegacy?(req: ListCreativeFormatsRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<LegacyListCreativeFormatsPayload>;
     /**
      * Push creatives. Return per-creative result rows (sync fast path) OR
      * `ctx.handoffToTask(fn)` to promote to a background task (HITL —
@@ -90,7 +92,7 @@ export interface CreativeAdServerPlatform<TCtxMeta = Record<string, unknown>> {
      * graph. When `req.include_pricing`, include vendor pricing options
      * on each creative.
      */
-    listCreatives(req: ListCreativesRequest, ctx: Ctx<TCtxMeta>): Promise<ListCreativesPayload>;
+    listCreatives(req: CanonicalListCreativesRequest, ctx: Ctx<TCtxMeta>): Promise<ListCreativesPayload>;
     /**
      * Per-creative delivery actuals (impressions, spend, pacing). Sync —
      * report-running platforms with manual report cycles return the

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

@@ -27,17 +27,19 @@ import type { Account, NoAccountCtx } from '../account';
 import type { RequestContext } from '../context';
 import type { TaskHandoff } from '../async-outcome';
 import type { ServerPayload } from '../../../types/server-payload';
-import type { BuildCreativeRequest, CreativeManifest, PreviewCreativeRequest, PreviewCreativeResponse, ListCreativesRequest, ListCreativesResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse, GetCreativeDeliveryRequest, GetCreativeDeliveryResponse, CreativeAsset, BuildCreativeSuccess, BuildCreativeMultiSuccess } from '../../../types/tools.generated';
+import type { BuildCreativeRequest, CreativeManifest, PreviewCreativeRequest, PreviewCreativeResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse, GetCreativeDeliveryRequest, GetCreativeDeliveryResponse, BuildCreativeSuccess, BuildCreativeMultiSuccess } from '../../../types/tools.generated';
+import type { CanonicalCreativeAsset, CanonicalCreativeResponse, CanonicalListCreativesRequest, CanonicalListCreativesResponse } from '../../../v2/projection/creative-delivery';
 import type { SyncCreativesRow } from './sales';
-type Creative = CreativeAsset;
+type Creative = CanonicalCreativeAsset;
 type Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;
-export type PreviewCreativePayload = ServerPayload<PreviewCreativeResponse>;
-export type ListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;
-export type ListCreativesPayload = ServerPayload<ListCreativesResponse>;
-export type GetCreativeDeliveryPayload = ServerPayload<GetCreativeDeliveryResponse>;
-export type BuildCreativePayload = ServerPayload<BuildCreativeSuccess>;
-export type BuildCreativeMultiPayload = ServerPayload<BuildCreativeMultiSuccess>;
-export type BuildCreativeReturn = CreativeManifest | CreativeManifest[] | BuildCreativePayload | BuildCreativeMultiPayload;
+export type LegacyPreviewCreativePayload = ServerPayload<PreviewCreativeResponse>;
+export type LegacyListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;
+export type ListCreativesPayload = ServerPayload<CanonicalListCreativesResponse>;
+export type GetCreativeDeliveryPayload = ServerPayload<CanonicalCreativeResponse<GetCreativeDeliveryResponse>>;
+export type LegacyGetCreativeDeliveryPayload = ServerPayload<GetCreativeDeliveryResponse>;
+export type LegacyBuildCreativePayload = ServerPayload<BuildCreativeSuccess>;
+export type LegacyBuildCreativeMultiPayload = ServerPayload<BuildCreativeMultiSuccess>;
+export type LegacyBuildCreativeReturn = CreativeManifest | CreativeManifest[] | LegacyBuildCreativePayload | LegacyBuildCreativeMultiPayload;
 export interface CreativeAdServerPlatform<TCtxMeta = Record<string, unknown>> {
     /**
      * Build / retrieve creative tags. Two invocation modes per the spec:
@@ -59,7 +61,7 @@ export interface CreativeAdServerPlatform<TCtxMeta = Record<string, unknown>> {
      * that lands, slow tag-generation pipelines await in-request; status
      * changes flow via `publishStatusChange`.
      */
-    buildCreative(req: BuildCreativeRequest, ctx: Ctx<TCtxMeta>): Promise<BuildCreativeReturn>;
+    buildCreativeLegacy(req: BuildCreativeRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyBuildCreativeReturn>;
     /**
      * Preview-only variant — sandbox URL or inline HTML, expires. Always sync.
      *
@@ -67,7 +69,7 @@ export interface CreativeAdServerPlatform<TCtxMeta = Record<string, unknown>> {
      * does not carry an `account` field; narrow `ctx.account` before reading
      * `ctx_metadata` / `id`. See {@link NoAccountCtx}.
      */
-    previewCreative(req: PreviewCreativeRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<PreviewCreativePayload>;
+    previewCreativeLegacy(req: PreviewCreativeRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<LegacyPreviewCreativePayload>;
     /**
      * Format catalog. Optional because adopters who delegate format definitions
      * to a separate creative agent (declared via `capabilities.creative_agents`)
@@ -75,7 +77,7 @@ export interface CreativeAdServerPlatform<TCtxMeta = Record<string, unknown>> {
      *
      * ⚠️  NO-ACCOUNT TOOL. See `previewCreative` note above.
      */
-    listCreativeFormats?(req: ListCreativeFormatsRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<ListCreativeFormatsPayload>;
+    listCreativeFormatsLegacy?(req: ListCreativeFormatsRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<LegacyListCreativeFormatsPayload>;
     /**
      * Push creatives. Return per-creative result rows (sync fast path) OR
      * `ctx.handoffToTask(fn)` to promote to a background task (HITL —
@@ -90,7 +92,7 @@ export interface CreativeAdServerPlatform<TCtxMeta = Record<string, unknown>> {
      * graph. When `req.include_pricing`, include vendor pricing options
      * on each creative.
      */
-    listCreatives(req: ListCreativesRequest, ctx: Ctx<TCtxMeta>): Promise<ListCreativesPayload>;
+    listCreatives(req: CanonicalListCreativesRequest, ctx: Ctx<TCtxMeta>): Promise<ListCreativesPayload>;
     /**
      * Per-creative delivery actuals (impressions, spend, pacing). Sync —
      * report-running platforms with manual report cycles return the

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

@@ -1 +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,YAAY,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,EAC3B,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,MAAM,sBAAsB,GAAG,aAAa,CAAC,uBAAuB,CAAC,CAAC;AAC5E,MAAM,MAAM,0BAA0B,GAAG,aAAa,CAAC,2BAA2B,CAAC,CAAC;AACpF,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC,qBAAqB,CAAC,CAAC;AACxE,MAAM,MAAM,0BAA0B,GAAG,aAAa,CAAC,2BAA2B,CAAC,CAAC;AACpF,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC,oBAAoB,CAAC,CAAC;AACvE,MAAM,MAAM,yBAAyB,GAAG,aAAa,CAAC,yBAAyB,CAAC,CAAC;AACjF,MAAM,MAAM,mBAAmB,GAC3B,gBAAgB,GAChB,gBAAgB,EAAE,GAClB,oBAAoB,GACpB,yBAAyB,CAAC;AAE9B,MAAM,WAAW,wBAAwB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1E;;;;;;;;;;;;;;;;;;;OAmBG;IACH,aAAa,CAAC,GAAG,EAAE,oBAAoB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE3F;;;;;;OAMG;IACH,eAAe,CAAC,GAAG,EAAE,sBAAsB,EAAE,GAAG,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAE3G;;;;;;OAMG;IACH,mBAAmB,CAAC,CAClB,GAAG,EAAE,0BAA0B,EAC/B,GAAG,EAAE,YAAY,CAAC,QAAQ,CAAC,GAC1B,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAIvC;;;;;;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,oBAAoB,CAAC,CAAC;IAE5F;;;;;;;;;;;;;;;;;;OAkBG;IACH,mBAAmB,CAAC,MAAM,EAAE,0BAA0B,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CAClH"}
+{"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,YAAY,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EAGvB,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC3B,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,sBAAsB,EACtB,yBAAyB,EACzB,6BAA6B,EAC7B,8BAA8B,EAC/B,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,KAAK,QAAQ,GAAG,sBAAsB,CAAC;AACvC,KAAK,GAAG,CAAC,QAAQ,IAAI,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEvD,MAAM,MAAM,4BAA4B,GAAG,aAAa,CAAC,uBAAuB,CAAC,CAAC;AAClF,MAAM,MAAM,gCAAgC,GAAG,aAAa,CAAC,2BAA2B,CAAC,CAAC;AAC1F,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC,8BAA8B,CAAC,CAAC;AACjF,MAAM,MAAM,0BAA0B,GAAG,aAAa,CAAC,yBAAyB,CAAC,2BAA2B,CAAC,CAAC,CAAC;AAC/G,MAAM,MAAM,gCAAgC,GAAG,aAAa,CAAC,2BAA2B,CAAC,CAAC;AAC1F,MAAM,MAAM,0BAA0B,GAAG,aAAa,CAAC,oBAAoB,CAAC,CAAC;AAC7E,MAAM,MAAM,+BAA+B,GAAG,aAAa,CAAC,yBAAyB,CAAC,CAAC;AACvF,MAAM,MAAM,yBAAyB,GACjC,gBAAgB,GAChB,gBAAgB,EAAE,GAClB,0BAA0B,GAC1B,+BAA+B,CAAC;AAEpC,MAAM,WAAW,wBAAwB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1E;;;;;;;;;;;;;;;;;;;OAmBG;IACH,mBAAmB,CAAC,GAAG,EAAE,oBAAoB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAEvG;;;;;;OAMG;IACH,qBAAqB,CACnB,GAAG,EAAE,sBAAsB,EAC3B,GAAG,EAAE,YAAY,CAAC,QAAQ,CAAC,GAC1B,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAEzC;;;;;;OAMG;IACH,yBAAyB,CAAC,CACxB,GAAG,EAAE,0BAA0B,EAC/B,GAAG,EAAE,YAAY,CAAC,QAAQ,CAAC,GAC1B,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAI7C;;;;;;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,6BAA6B,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAErG;;;;;;;;;;;;;;;;;;OAkBG;IACH,mBAAmB,CAAC,MAAM,EAAE,0BAA0B,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CAClH"}

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/specialisms/creative-ad-server.ts"],"sourcesContent":["/**\n * CreativeAdServerPlatform — third creative archetype (v6.0).\n *\n * Stateful creative library + per-creative pricing + tag generation. The\n * canonical shape for creative-ad-server adopters: Innovid, Flashtalking,\n * GAM-creative, CMP-style platforms.\n *\n * Distinct from `CreativeTemplatePlatform` (stateless transform) and\n * `CreativeGenerativePlatform` (brief-driven generation):\n *\n *   - **Stateful** — adopter persists creatives in a library; `syncCreatives`\n *     pushes assets in, `listCreatives` reads them back, `buildCreative`\n *     either looks up an existing creative by id OR pushes a new one\n *   - **Pricing per creative** — vendor pricing options on each creative;\n *     `pricing_option_id` selected at activation, billed via `report_usage`\n *   - **Tag generation** — `buildCreative` returns ad-server tags (VAST,\n *     placement-specific tracking pixels, macro-substituted creative HTML)\n *     when invoked with `media_buy_id` + `package_id` context\n *   - **Per-creative delivery reports** — `get_creative_delivery` returns\n *     pacing data per creative across the library\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { Account, NoAccountCtx } from '../account';\nimport type { RequestContext } from '../context';\nimport type { TaskHandoff } from '../async-outcome';\nimport type { ServerPayload } from '../../../types/server-payload';\nimport type {\n  BuildCreativeRequest,\n  CreativeManifest,\n  PreviewCreativeRequest,\n  PreviewCreativeResponse,\n  ListCreativesRequest,\n  ListCreativesResponse,\n  ListCreativeFormatsRequest,\n  ListCreativeFormatsResponse,\n  GetCreativeDeliveryRequest,\n  GetCreativeDeliveryResponse,\n  CreativeAsset,\n  BuildCreativeSuccess,\n  BuildCreativeMultiSuccess,\n} from '../../../types/tools.generated';\nimport type { SyncCreativesRow } from './sales';\n\ntype Creative = CreativeAsset;\ntype Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;\n\nexport type PreviewCreativePayload = ServerPayload<PreviewCreativeResponse>;\nexport type ListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;\nexport type ListCreativesPayload = ServerPayload<ListCreativesResponse>;\nexport type GetCreativeDeliveryPayload = ServerPayload<GetCreativeDeliveryResponse>;\nexport type BuildCreativePayload = ServerPayload<BuildCreativeSuccess>;\nexport type BuildCreativeMultiPayload = ServerPayload<BuildCreativeMultiSuccess>;\nexport type BuildCreativeReturn =\n  | CreativeManifest\n  | CreativeManifest[]\n  | BuildCreativePayload\n  | BuildCreativeMultiPayload;\n\nexport interface CreativeAdServerPlatform<TCtxMeta = Record<string, unknown>> {\n  /**\n   * Build / retrieve creative tags. Two invocation modes per the spec:\n   *\n   *   - **Library lookup**: `req.creative_id` references an existing\n   *     creative; return the manifest with tag fields populated\n   *     (`vast_tag`, click trackers, etc.). When `req.media_buy_id` +\n   *     `req.package_id` are also set, generate placement-specific tags\n   *     with macro substitution baked in.\n   *   - **Inline build**: `req.creative_manifest` is provided directly;\n   *     transform / wrap it (similar to template archetype but with\n   *     ad-server side effects: register the creative in the library,\n   *     generate the tag, etc.).\n   *\n   * Spec defines a Submitted arm via `async-response-data.json` but the\n   * per-tool `build-creative-response.json` `oneOf` doesn't include it,\n   * so codegen produces a `BuildCreativeResponse` without Submitted —\n   * a SPEC inconsistency, tracked as adcontextprotocol/adcp#3392. Until\n   * that lands, slow tag-generation pipelines await in-request; status\n   * changes flow via `publishStatusChange`.\n   */\n  buildCreative(req: BuildCreativeRequest, ctx: Ctx<TCtxMeta>): Promise<BuildCreativeReturn>;\n\n  /**\n   * Preview-only variant — sandbox URL or inline HTML, expires. Always sync.\n   *\n   * ⚠️  NO-ACCOUNT TOOL — `ctx: NoAccountCtx<TCtxMeta>`. The wire request\n   * does not carry an `account` field; narrow `ctx.account` before reading\n   * `ctx_metadata` / `id`. See {@link NoAccountCtx}.\n   */\n  previewCreative(req: PreviewCreativeRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<PreviewCreativePayload>;\n\n  /**\n   * Format catalog. Optional because adopters who delegate format definitions\n   * to a separate creative agent (declared via `capabilities.creative_agents`)\n   * don't own them; the framework returns `UNSUPPORTED_FEATURE` when omitted.\n   *\n   * ⚠️  NO-ACCOUNT TOOL. See `previewCreative` note above.\n   */\n  listCreativeFormats?(\n    req: ListCreativeFormatsRequest,\n    ctx: NoAccountCtx<TCtxMeta>\n  ): Promise<ListCreativeFormatsPayload>;\n\n  // sync_creatives: sync OR task — `SyncCreativesResponse` has a Submitted arm.\n\n  /**\n   * Push creatives. Return per-creative result rows (sync fast path) OR\n   * `ctx.handoffToTask(fn)` to promote to a background task (HITL —\n   * brand-suitability, S&P review). `action: 'created'` for new entries,\n   * `'updated'` for replacements, `'unchanged'` when matching. Optional\n   * `status: 'pending_review'` for sync-arm rows awaiting manual review.\n   */\n  syncCreatives?(\n    creatives: Creative[],\n    ctx: Ctx<TCtxMeta>\n  ): Promise<SyncCreativesRow[] | TaskHandoff<SyncCreativesRow[]>>;\n\n  /**\n   * Read creatives from the library. Filters + pagination. When\n   * `req.include_assignments`, include the buyer's package-assignment\n   * graph. When `req.include_pricing`, include vendor pricing options\n   * on each creative.\n   */\n  listCreatives(req: ListCreativesRequest, ctx: Ctx<TCtxMeta>): Promise<ListCreativesPayload>;\n\n  /**\n   * Per-creative delivery actuals (impressions, spend, pacing). Sync —\n   * report-running platforms with manual report cycles return the\n   * latest cached actuals and emit `delivery_report` status changes\n   * via `publishStatusChange` when fresh reports are available.\n   *\n   * **Multi-id contract.** `filter.media_buy_ids` and `filter.creative_ids`\n   * are arrays — buyers may scope a delivery query to multiple buys or\n   * creatives in one call. The platform MUST iterate every supplied id\n   * and return one row per matching (creative, buy) pair. Reading only\n   * `media_buy_ids[0]` / `creative_ids[0]` silently truncates the\n   * buyer's request — a correctness bug to avoid (closes #1342).\n   *\n   * Pass-through is the framework contract: cross-creative aggregation\n   * is platform-domain knowledge (variant-level deduplication, brand\n   * mapping, attribution windows), so the framework hands the array\n   * through and the platform owns fan-out. Sellers that can't compute\n   * cross-cuts omit them; buyers fall back to per-row values.\n   */\n  getCreativeDelivery(filter: GetCreativeDeliveryRequest, ctx: Ctx<TCtxMeta>): Promise<GetCreativeDeliveryPayload>;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/specialisms/creative-ad-server.ts"],"sourcesContent":["/**\n * CreativeAdServerPlatform — third creative archetype (v6.0).\n *\n * Stateful creative library + per-creative pricing + tag generation. The\n * canonical shape for creative-ad-server adopters: Innovid, Flashtalking,\n * GAM-creative, CMP-style platforms.\n *\n * Distinct from `CreativeTemplatePlatform` (stateless transform) and\n * `CreativeGenerativePlatform` (brief-driven generation):\n *\n *   - **Stateful** — adopter persists creatives in a library; `syncCreatives`\n *     pushes assets in, `listCreatives` reads them back, `buildCreative`\n *     either looks up an existing creative by id OR pushes a new one\n *   - **Pricing per creative** — vendor pricing options on each creative;\n *     `pricing_option_id` selected at activation, billed via `report_usage`\n *   - **Tag generation** — `buildCreative` returns ad-server tags (VAST,\n *     placement-specific tracking pixels, macro-substituted creative HTML)\n *     when invoked with `media_buy_id` + `package_id` context\n *   - **Per-creative delivery reports** — `get_creative_delivery` returns\n *     pacing data per creative across the library\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { Account, NoAccountCtx } from '../account';\nimport type { RequestContext } from '../context';\nimport type { TaskHandoff } from '../async-outcome';\nimport type { ServerPayload } from '../../../types/server-payload';\nimport type {\n  BuildCreativeRequest,\n  CreativeManifest,\n  PreviewCreativeRequest,\n  PreviewCreativeResponse,\n  ListCreativesRequest,\n  ListCreativesResponse,\n  ListCreativeFormatsRequest,\n  ListCreativeFormatsResponse,\n  GetCreativeDeliveryRequest,\n  GetCreativeDeliveryResponse,\n  BuildCreativeSuccess,\n  BuildCreativeMultiSuccess,\n} from '../../../types/tools.generated';\nimport type {\n  CanonicalCreativeAsset,\n  CanonicalCreativeResponse,\n  CanonicalListCreativesRequest,\n  CanonicalListCreativesResponse,\n} from '../../../v2/projection/creative-delivery';\nimport type { SyncCreativesRow } from './sales';\n\ntype Creative = CanonicalCreativeAsset;\ntype Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;\n\nexport type LegacyPreviewCreativePayload = ServerPayload<PreviewCreativeResponse>;\nexport type LegacyListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;\nexport type ListCreativesPayload = ServerPayload<CanonicalListCreativesResponse>;\nexport type GetCreativeDeliveryPayload = ServerPayload<CanonicalCreativeResponse<GetCreativeDeliveryResponse>>;\nexport type LegacyGetCreativeDeliveryPayload = ServerPayload<GetCreativeDeliveryResponse>;\nexport type LegacyBuildCreativePayload = ServerPayload<BuildCreativeSuccess>;\nexport type LegacyBuildCreativeMultiPayload = ServerPayload<BuildCreativeMultiSuccess>;\nexport type LegacyBuildCreativeReturn =\n  | CreativeManifest\n  | CreativeManifest[]\n  | LegacyBuildCreativePayload\n  | LegacyBuildCreativeMultiPayload;\n\nexport interface CreativeAdServerPlatform<TCtxMeta = Record<string, unknown>> {\n  /**\n   * Build / retrieve creative tags. Two invocation modes per the spec:\n   *\n   *   - **Library lookup**: `req.creative_id` references an existing\n   *     creative; return the manifest with tag fields populated\n   *     (`vast_tag`, click trackers, etc.). When `req.media_buy_id` +\n   *     `req.package_id` are also set, generate placement-specific tags\n   *     with macro substitution baked in.\n   *   - **Inline build**: `req.creative_manifest` is provided directly;\n   *     transform / wrap it (similar to template archetype but with\n   *     ad-server side effects: register the creative in the library,\n   *     generate the tag, etc.).\n   *\n   * Spec defines a Submitted arm via `async-response-data.json` but the\n   * per-tool `build-creative-response.json` `oneOf` doesn't include it,\n   * so codegen produces a `BuildCreativeResponse` without Submitted —\n   * a SPEC inconsistency, tracked as adcontextprotocol/adcp#3392. Until\n   * that lands, slow tag-generation pipelines await in-request; status\n   * changes flow via `publishStatusChange`.\n   */\n  buildCreativeLegacy(req: BuildCreativeRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyBuildCreativeReturn>;\n\n  /**\n   * Preview-only variant — sandbox URL or inline HTML, expires. Always sync.\n   *\n   * ⚠️  NO-ACCOUNT TOOL — `ctx: NoAccountCtx<TCtxMeta>`. The wire request\n   * does not carry an `account` field; narrow `ctx.account` before reading\n   * `ctx_metadata` / `id`. See {@link NoAccountCtx}.\n   */\n  previewCreativeLegacy(\n    req: PreviewCreativeRequest,\n    ctx: NoAccountCtx<TCtxMeta>\n  ): Promise<LegacyPreviewCreativePayload>;\n\n  /**\n   * Format catalog. Optional because adopters who delegate format definitions\n   * to a separate creative agent (declared via `capabilities.creative_agents`)\n   * don't own them; the framework returns `UNSUPPORTED_FEATURE` when omitted.\n   *\n   * ⚠️  NO-ACCOUNT TOOL. See `previewCreative` note above.\n   */\n  listCreativeFormatsLegacy?(\n    req: ListCreativeFormatsRequest,\n    ctx: NoAccountCtx<TCtxMeta>\n  ): Promise<LegacyListCreativeFormatsPayload>;\n\n  // sync_creatives: sync OR task — `SyncCreativesResponse` has a Submitted arm.\n\n  /**\n   * Push creatives. Return per-creative result rows (sync fast path) OR\n   * `ctx.handoffToTask(fn)` to promote to a background task (HITL —\n   * brand-suitability, S&P review). `action: 'created'` for new entries,\n   * `'updated'` for replacements, `'unchanged'` when matching. Optional\n   * `status: 'pending_review'` for sync-arm rows awaiting manual review.\n   */\n  syncCreatives?(\n    creatives: Creative[],\n    ctx: Ctx<TCtxMeta>\n  ): Promise<SyncCreativesRow[] | TaskHandoff<SyncCreativesRow[]>>;\n\n  /**\n   * Read creatives from the library. Filters + pagination. When\n   * `req.include_assignments`, include the buyer's package-assignment\n   * graph. When `req.include_pricing`, include vendor pricing options\n   * on each creative.\n   */\n  listCreatives(req: CanonicalListCreativesRequest, ctx: Ctx<TCtxMeta>): Promise<ListCreativesPayload>;\n\n  /**\n   * Per-creative delivery actuals (impressions, spend, pacing). Sync —\n   * report-running platforms with manual report cycles return the\n   * latest cached actuals and emit `delivery_report` status changes\n   * via `publishStatusChange` when fresh reports are available.\n   *\n   * **Multi-id contract.** `filter.media_buy_ids` and `filter.creative_ids`\n   * are arrays — buyers may scope a delivery query to multiple buys or\n   * creatives in one call. The platform MUST iterate every supplied id\n   * and return one row per matching (creative, buy) pair. Reading only\n   * `media_buy_ids[0]` / `creative_ids[0]` silently truncates the\n   * buyer's request — a correctness bug to avoid (closes #1342).\n   *\n   * Pass-through is the framework contract: cross-creative aggregation\n   * is platform-domain knowledge (variant-level deduplication, brand\n   * mapping, attribution windows), so the framework hands the array\n   * through and the platform owns fan-out. Sellers that can't compute\n   * cross-cuts omit them; buyers fall back to per-row values.\n   */\n  getCreativeDelivery(filter: GetCreativeDeliveryRequest, ctx: Ctx<TCtxMeta>): Promise<GetCreativeDeliveryPayload>;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}