@adcp/sdk 12.1.1 → 13.0.0-rc.0

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

@@ -18,14 +18,15 @@ 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 { CreativeAsset, CreativeManifest, BuildCreativeRequest, BuildCreativeSuccess, BuildCreativeMultiSuccess, PreviewCreativeRequest, PreviewCreativeResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse } from '../../../types/tools.generated.mjs';
+import type { CreativeManifest, BuildCreativeRequest, BuildCreativeSuccess, BuildCreativeMultiSuccess, PreviewCreativeRequest, PreviewCreativeResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse } from '../../../types/tools.generated.mjs';
+import type { CanonicalCreativeAsset } 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 BuildCreativePayload = ServerPayload<BuildCreativeSuccess>;
-export type BuildCreativeMultiPayload = ServerPayload<BuildCreativeMultiSuccess>;
-export type PreviewCreativePayload = ServerPayload<PreviewCreativeResponse>;
-export type ListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;
+export type LegacyBuildCreativePayload = ServerPayload<BuildCreativeSuccess>;
+export type LegacyBuildCreativeMultiPayload = ServerPayload<BuildCreativeMultiSuccess>;
+export type LegacyPreviewCreativePayload = ServerPayload<PreviewCreativeResponse>;
+export type LegacyListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;
 /**
  * Adopter return shape for `buildCreative`. Discriminated by the wire
  * spec's Single vs Multi response arms — pick whichever matches the
@@ -51,7 +52,7 @@ export type ListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsRespon
  * multi-format request, is an adopter contract violation that surfaces
  * as schema-validation failure on the wire response.
  */
-export type BuildCreativeReturn = CreativeManifest | CreativeManifest[] | BuildCreativePayload | BuildCreativeMultiPayload;
+export type LegacyBuildCreativeReturn = CreativeManifest | CreativeManifest[] | LegacyBuildCreativePayload | LegacyBuildCreativeMultiPayload;
 export type { SyncCreativesRow };
 /**
  * Creative-builder agent. Produces creatives from buyer inputs — equally
@@ -98,7 +99,7 @@ export interface CreativeBuilderPlatform<TCtxMeta = Record<string, unknown>> {
      * `BuildCreativeMultiPayload` payload when you need to set
      * `sandbox` / `expires_at` / `preview`.
      */
-    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. Optional because generative-only adopters that don't render
@@ -111,7 +112,7 @@ export interface CreativeBuilderPlatform<TCtxMeta = Record<string, unknown>> {
      * when `accounts.resolve(undefined)` returned null. Narrow before reading
      * `ctx.account.ctx_metadata`. See {@link NoAccountCtx}.
      */
-    previewCreative?(req: PreviewCreativeRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<PreviewCreativePayload>;
+    previewCreativeLegacy?(req: PreviewCreativeRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<LegacyPreviewCreativePayload>;
     /**
      * Format catalog. Buyers call `list_creative_formats` to discover the
      * formats this agent supports. Optional because adopters who declare
@@ -135,7 +136,7 @@ export interface CreativeBuilderPlatform<TCtxMeta = Record<string, unknown>> {
      * claiming only creative specialisms (`creative-template`, `creative-
      * generative`, `creative-ad-server`) without a sales platform attached.
      */
-    listCreativeFormats?(req: ListCreativeFormatsRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<ListCreativeFormatsPayload>;
+    listCreativeFormatsLegacy?(req: ListCreativeFormatsRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<LegacyListCreativeFormatsPayload>;
     /**
      * Refine a prior generation. `taskId` references a prior submission.
      * Sync — refinement is a mutation on existing state, not a new task
@@ -143,7 +144,7 @@ export interface CreativeBuilderPlatform<TCtxMeta = Record<string, unknown>> {
      * re-calling `buildCreative` with different inputs and don't carry
      * generation state across calls.
      */
-    refineCreative?(taskId: string, refinement: RefinementMessage, ctx: Ctx<TCtxMeta>): Promise<CreativeManifest>;
+    refineCreativeLegacy?(taskId: string, refinement: RefinementMessage, ctx: Ctx<TCtxMeta>): Promise<CreativeManifest>;
     /**
      * Sync review surface. Stateless platforms typically auto-approve;
      * adopters needing mandatory pre-persist review return

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

@@ -18,14 +18,15 @@ 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 { CreativeAsset, CreativeManifest, BuildCreativeRequest, BuildCreativeSuccess, BuildCreativeMultiSuccess, PreviewCreativeRequest, PreviewCreativeResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse } from '../../../types/tools.generated';
+import type { CreativeManifest, BuildCreativeRequest, BuildCreativeSuccess, BuildCreativeMultiSuccess, PreviewCreativeRequest, PreviewCreativeResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse } from '../../../types/tools.generated';
+import type { CanonicalCreativeAsset } from '../../../v2/projection/creative-delivery';
 import type { SyncCreativesRow } from './sales';
-type Creative = CreativeAsset;
+type Creative = CanonicalCreativeAsset;
 type Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;
-export type BuildCreativePayload = ServerPayload<BuildCreativeSuccess>;
-export type BuildCreativeMultiPayload = ServerPayload<BuildCreativeMultiSuccess>;
-export type PreviewCreativePayload = ServerPayload<PreviewCreativeResponse>;
-export type ListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;
+export type LegacyBuildCreativePayload = ServerPayload<BuildCreativeSuccess>;
+export type LegacyBuildCreativeMultiPayload = ServerPayload<BuildCreativeMultiSuccess>;
+export type LegacyPreviewCreativePayload = ServerPayload<PreviewCreativeResponse>;
+export type LegacyListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;
 /**
  * Adopter return shape for `buildCreative`. Discriminated by the wire
  * spec's Single vs Multi response arms — pick whichever matches the
@@ -51,7 +52,7 @@ export type ListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsRespon
  * multi-format request, is an adopter contract violation that surfaces
  * as schema-validation failure on the wire response.
  */
-export type BuildCreativeReturn = CreativeManifest | CreativeManifest[] | BuildCreativePayload | BuildCreativeMultiPayload;
+export type LegacyBuildCreativeReturn = CreativeManifest | CreativeManifest[] | LegacyBuildCreativePayload | LegacyBuildCreativeMultiPayload;
 export type { SyncCreativesRow };
 /**
  * Creative-builder agent. Produces creatives from buyer inputs — equally
@@ -98,7 +99,7 @@ export interface CreativeBuilderPlatform<TCtxMeta = Record<string, unknown>> {
      * `BuildCreativeMultiPayload` payload when you need to set
      * `sandbox` / `expires_at` / `preview`.
      */
-    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. Optional because generative-only adopters that don't render
@@ -111,7 +112,7 @@ export interface CreativeBuilderPlatform<TCtxMeta = Record<string, unknown>> {
      * when `accounts.resolve(undefined)` returned null. Narrow before reading
      * `ctx.account.ctx_metadata`. See {@link NoAccountCtx}.
      */
-    previewCreative?(req: PreviewCreativeRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<PreviewCreativePayload>;
+    previewCreativeLegacy?(req: PreviewCreativeRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<LegacyPreviewCreativePayload>;
     /**
      * Format catalog. Buyers call `list_creative_formats` to discover the
      * formats this agent supports. Optional because adopters who declare
@@ -135,7 +136,7 @@ export interface CreativeBuilderPlatform<TCtxMeta = Record<string, unknown>> {
      * claiming only creative specialisms (`creative-template`, `creative-
      * generative`, `creative-ad-server`) without a sales platform attached.
      */
-    listCreativeFormats?(req: ListCreativeFormatsRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<ListCreativeFormatsPayload>;
+    listCreativeFormatsLegacy?(req: ListCreativeFormatsRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<LegacyListCreativeFormatsPayload>;
     /**
      * Refine a prior generation. `taskId` references a prior submission.
      * Sync — refinement is a mutation on existing state, not a new task
@@ -143,7 +144,7 @@ export interface CreativeBuilderPlatform<TCtxMeta = Record<string, unknown>> {
      * re-calling `buildCreative` with different inputs and don't carry
      * generation state across calls.
      */
-    refineCreative?(taskId: string, refinement: RefinementMessage, ctx: Ctx<TCtxMeta>): Promise<CreativeManifest>;
+    refineCreativeLegacy?(taskId: string, refinement: RefinementMessage, ctx: Ctx<TCtxMeta>): Promise<CreativeManifest>;
     /**
      * Sync review surface. Stateless platforms typically auto-approve;
      * adopters needing mandatory pre-persist review return

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

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

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/specialisms/creative.ts"],"sourcesContent":["/**\n * Creative specialism platform interfaces (v2 dual-method shape).\n *\n * Three creative archetypes:\n *   - CreativeTemplatePlatform: stateless transform (AudioStack, Celtra)\n *   - CreativeGenerativePlatform: brief-to-creative (DALL-E-style)\n *   - CreativeAdServerPlatform: stateful library + tags (Innovid, GAM-creative; v1.1)\n *\n * `buildCreative` and `syncCreatives` each have sync OR task variants;\n * adopter implements exactly one per pair. `validatePlatform()` enforces\n * exactly-one at construction time.\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  CreativeAsset,\n  CreativeManifest,\n  BuildCreativeRequest,\n  BuildCreativeSuccess,\n  BuildCreativeMultiSuccess,\n  PreviewCreativeRequest,\n  PreviewCreativeResponse,\n  ListCreativeFormatsRequest,\n  ListCreativeFormatsResponse,\n} from '../../../types/tools.generated';\nimport type { SyncCreativesRow } from './sales';\n\ntype Creative = CreativeAsset;\ntype Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;\n\nexport type BuildCreativePayload = ServerPayload<BuildCreativeSuccess>;\nexport type BuildCreativeMultiPayload = ServerPayload<BuildCreativeMultiSuccess>;\nexport type PreviewCreativePayload = ServerPayload<PreviewCreativeResponse>;\nexport type ListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;\n\n/**\n * Adopter return shape for `buildCreative`. Discriminated by the wire\n * spec's Single vs Multi response arms — pick whichever matches the\n * request the framework dispatched:\n *\n *   - **Single manifest, no metadata**: return a `CreativeManifest`\n *     directly. Framework wraps as `{ creative_manifest: <manifest> }`.\n *     Use this for single-format requests (`target_format_id`) when\n *     you don't need to set `sandbox` / `expires_at` / `preview`.\n *   - **Multi-format manifests, no metadata**: return a\n *     `CreativeManifest[]`. Framework wraps as\n *     `{ creative_manifests: [...] }`. Use this for multi-format\n *     requests (`target_format_ids`) when you don't need rich metadata.\n *   - **Fully-shaped envelope**: return a `BuildCreativePayload` (single)\n *     or `BuildCreativeMultiPayload` (multi) with `sandbox` /\n *     `expires_at` / `preview` populated. Framework passes through\n *     unchanged. Detected by the presence of `creative_manifest` (single\n *     envelope) or `creative_manifests` (multi envelope) at the top level.\n *\n * Adopters route on `req.target_format_ids` (multi) vs `req.target_format_id`\n * (single) and return the matching arm. Returning a `CreativeManifest[]`\n * for a single-format request, or a single `CreativeManifest` for a\n * multi-format request, is an adopter contract violation that surfaces\n * as schema-validation failure on the wire response.\n */\nexport type BuildCreativeReturn =\n  | CreativeManifest\n  | CreativeManifest[]\n  | BuildCreativePayload\n  | BuildCreativeMultiPayload;\n\n// Re-export SyncCreativesRow so creative-specialism adopters don't need to\n// reach into the sales module to import the shared row type.\nexport type { SyncCreativesRow };\n\n// ---------------------------------------------------------------------------\n// CreativeBuilderPlatform — produces creatives (template-driven OR generative)\n// ---------------------------------------------------------------------------\n\n/**\n * Creative-builder agent. Produces creatives from buyer inputs — equally\n * suited to template-driven dynamic creative platforms (Bannerflow,\n * Celtra), brief-to-creative AI agents (Pencil, Omneky, AdCreative.ai),\n * and hybrids that mix both modes. The wire shape doesn't distinguish\n * \"transform a template\" from \"generate from a brief\" — both produce a\n * `CreativeManifest` from a `BuildCreativeRequest`. The previous v6\n * preview separated them into `CreativeTemplatePlatform` and\n * `CreativeGenerativePlatform`, but every interface field is the same;\n * the only meaningful difference was whether `refineCreative` was\n * supported, which is now optional on the unified shape.\n *\n * Spec defines a Submitted arm via `async-response-data.json`\n * (`BuildCreativeAsyncSubmitted`) but the per-tool\n * `build-creative-response.json` `oneOf` doesn't include it — a SPEC\n * inconsistency tracked as adcontextprotocol/adcp#3392. Until the spec\n * rolls Submitted into the `oneOf`, slow operations (TTS, audio mixing,\n * long-running generation) await in-request; status changes surface via\n * `publishStatusChange` on `resource_type: 'creative'`.\n *\n * Both `creative-template` and `creative-generative` specialism claims\n * map to this interface in `RequiredPlatformsFor<S>` — the discovery\n * distinction is preserved at the buyer-facing spec level (so buyers\n * filtering for \"AI brief-to-creative\" still find generative agents)\n * while implementation surface stays unified.\n *\n * Adopters that ALSO want library + tag generation + delivery reporting\n * (i.e., a full ad server on top of the builder) declare\n * `CreativeAdServerPlatform` instead. Multi-archetype omni agents\n * (rare in the wild) front each archetype as a separate tenant via\n * `TenantRegistry`.\n */\nexport interface CreativeBuilderPlatform<TCtxMeta = Record<string, unknown>> {\n  /**\n   * Build the creative. Single method covers template-driven transform\n   * (`req.template_id` + asset slots), brief-to-creative generation\n   * (`req.brief`), and any hybrid the platform supports — adopters\n   * route internally on `req` shape.\n   *\n   * Return shape is discriminated; see {@link BuildCreativeReturn}:\n   * single `CreativeManifest`, `CreativeManifest[]` for multi-format\n   * requests, OR a fully-shaped `BuildCreativePayload` /\n   * `BuildCreativeMultiPayload` payload when you need to set\n   * `sandbox` / `expires_at` / `preview`.\n   */\n  buildCreative(req: BuildCreativeRequest, ctx: Ctx<TCtxMeta>): Promise<BuildCreativeReturn>;\n\n  /**\n   * Preview-only variant — sandbox URL or inline HTML, expires. Always\n   * sync. Optional because generative-only adopters that don't render\n   * preview ahead of generation can omit it; the framework returns\n   * `UNSUPPORTED_FEATURE` to buyers calling `preview_creative` against\n   * a platform that didn't wire this.\n   *\n   * ⚠️  NO-ACCOUNT TOOL — `ctx: NoAccountCtx<TCtxMeta>`. The wire request\n   * does not carry an `account` field, so `ctx.account` may be `undefined`\n   * when `accounts.resolve(undefined)` returned null. Narrow before reading\n   * `ctx.account.ctx_metadata`. See {@link NoAccountCtx}.\n   */\n  previewCreative?(req: PreviewCreativeRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<PreviewCreativePayload>;\n\n  /**\n   * Format catalog. Buyers call `list_creative_formats` to discover the\n   * formats this agent supports. Optional because adopters who declare\n   * their formats via `capabilities.creative_agents` (delegating to a\n   * separate creative agent) don't own format definitions; the framework\n   * surfaces `UNSUPPORTED_FEATURE` when omitted.\n   *\n   * ⚠️  NO-ACCOUNT TOOL — `ctx: NoAccountCtx<TCtxMeta>`. The wire request\n   * does not carry an `account` field. The framework dispatches with\n   * `ctx.account === undefined` for `'explicit'`-resolution adopters that\n   * don't return a synthetic singleton from `accounts.resolve(undefined)`.\n   * Format catalogs are typically publisher-wide; if yours is per-tenant\n   * (Bannerflow / Celtra-style multi-tenant catalogs), return a synthetic\n   * account from `accounts.resolve(undefined)` keyed on\n   * `ctx.authInfo.clientId` and narrow `ctx.account` inside the handler.\n   *\n   * **Precedence:** when an adopter ALSO wires `SalesPlatform.listCreativeFormats`\n   * on the same platform, the sales-side handler wins (mediaBuy domain\n   * registers before creative). Don't wire both — pick the surface that\n   * matches your specialism. This creative-side wiring exists for adopters\n   * claiming only creative specialisms (`creative-template`, `creative-\n   * generative`, `creative-ad-server`) without a sales platform attached.\n   */\n  listCreativeFormats?(\n    req: ListCreativeFormatsRequest,\n    ctx: NoAccountCtx<TCtxMeta>\n  ): Promise<ListCreativeFormatsPayload>;\n\n  /**\n   * Refine a prior generation. `taskId` references a prior submission.\n   * Sync — refinement is a mutation on existing state, not a new task\n   * creation. Optional because pure template platforms iterate by\n   * re-calling `buildCreative` with different inputs and don't carry\n   * generation state across calls.\n   */\n  refineCreative?(taskId: string, refinement: RefinementMessage, ctx: Ctx<TCtxMeta>): Promise<CreativeManifest>;\n\n  /**\n   * Sync review surface. Stateless platforms typically auto-approve;\n   * adopters needing mandatory pre-persist review return\n   * `ctx.handoffToTask(fn)` to defer to a background task. Unified\n   * hybrid shape — return rows OR `ctx.handoffToTask(fn)`.\n   */\n  syncCreatives?(\n    creatives: Creative[],\n    ctx: Ctx<TCtxMeta>\n  ): Promise<SyncCreativesRow[] | TaskHandoff<SyncCreativesRow[]>>;\n}\n\n/**\n * @deprecated Use `CreativeBuilderPlatform` — the unified interface\n * covering both template-driven and brief-to-creative agents. The\n * v6 preview's separation of `CreativeTemplatePlatform` and\n * `CreativeGenerativePlatform` had no meaningful interface\n * distinction; this alias preserves source compatibility for one\n * release while adopters migrate. Will be removed in a future\n * release.\n */\nexport type CreativeTemplatePlatform<TCtxMeta = Record<string, unknown>> = CreativeBuilderPlatform<TCtxMeta>;\n\n/**\n * @deprecated Use `CreativeBuilderPlatform` — the unified interface\n * covering both template-driven and brief-to-creative agents. See\n * `CreativeTemplatePlatform` deprecation note. Will be removed in a\n * future release.\n */\nexport type CreativeGenerativePlatform<TCtxMeta = Record<string, unknown>> = CreativeBuilderPlatform<TCtxMeta>;\n\n// ---------------------------------------------------------------------------\n// Shared shapes\n// ---------------------------------------------------------------------------\n\nexport interface RefinementMessage {\n  /** Free-text instruction from the buyer. */\n  message: string;\n  /** Optional structured changes (e.g., \"make headline say X\"). */\n  changes?: Record<string, unknown>;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/specialisms/creative.ts"],"sourcesContent":["/**\n * Creative specialism platform interfaces (v2 dual-method shape).\n *\n * Three creative archetypes:\n *   - CreativeTemplatePlatform: stateless transform (AudioStack, Celtra)\n *   - CreativeGenerativePlatform: brief-to-creative (DALL-E-style)\n *   - CreativeAdServerPlatform: stateful library + tags (Innovid, GAM-creative; v1.1)\n *\n * `buildCreative` and `syncCreatives` each have sync OR task variants;\n * adopter implements exactly one per pair. `validatePlatform()` enforces\n * exactly-one at construction time.\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  CreativeManifest,\n  BuildCreativeRequest,\n  BuildCreativeSuccess,\n  BuildCreativeMultiSuccess,\n  PreviewCreativeRequest,\n  PreviewCreativeResponse,\n  ListCreativeFormatsRequest,\n  ListCreativeFormatsResponse,\n} from '../../../types/tools.generated';\nimport type { CanonicalCreativeAsset } from '../../../v2/projection/creative-delivery';\nimport type { SyncCreativesRow } from './sales';\n\ntype Creative = CanonicalCreativeAsset;\ntype Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;\n\nexport type LegacyBuildCreativePayload = ServerPayload<BuildCreativeSuccess>;\nexport type LegacyBuildCreativeMultiPayload = ServerPayload<BuildCreativeMultiSuccess>;\nexport type LegacyPreviewCreativePayload = ServerPayload<PreviewCreativeResponse>;\nexport type LegacyListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;\n\n/**\n * Adopter return shape for `buildCreative`. Discriminated by the wire\n * spec's Single vs Multi response arms — pick whichever matches the\n * request the framework dispatched:\n *\n *   - **Single manifest, no metadata**: return a `CreativeManifest`\n *     directly. Framework wraps as `{ creative_manifest: <manifest> }`.\n *     Use this for single-format requests (`target_format_id`) when\n *     you don't need to set `sandbox` / `expires_at` / `preview`.\n *   - **Multi-format manifests, no metadata**: return a\n *     `CreativeManifest[]`. Framework wraps as\n *     `{ creative_manifests: [...] }`. Use this for multi-format\n *     requests (`target_format_ids`) when you don't need rich metadata.\n *   - **Fully-shaped envelope**: return a `BuildCreativePayload` (single)\n *     or `BuildCreativeMultiPayload` (multi) with `sandbox` /\n *     `expires_at` / `preview` populated. Framework passes through\n *     unchanged. Detected by the presence of `creative_manifest` (single\n *     envelope) or `creative_manifests` (multi envelope) at the top level.\n *\n * Adopters route on `req.target_format_ids` (multi) vs `req.target_format_id`\n * (single) and return the matching arm. Returning a `CreativeManifest[]`\n * for a single-format request, or a single `CreativeManifest` for a\n * multi-format request, is an adopter contract violation that surfaces\n * as schema-validation failure on the wire response.\n */\nexport type LegacyBuildCreativeReturn =\n  | CreativeManifest\n  | CreativeManifest[]\n  | LegacyBuildCreativePayload\n  | LegacyBuildCreativeMultiPayload;\n\n// Re-export SyncCreativesRow so creative-specialism adopters don't need to\n// reach into the sales module to import the shared row type.\nexport type { SyncCreativesRow };\n\n// ---------------------------------------------------------------------------\n// CreativeBuilderPlatform — produces creatives (template-driven OR generative)\n// ---------------------------------------------------------------------------\n\n/**\n * Creative-builder agent. Produces creatives from buyer inputs — equally\n * suited to template-driven dynamic creative platforms (Bannerflow,\n * Celtra), brief-to-creative AI agents (Pencil, Omneky, AdCreative.ai),\n * and hybrids that mix both modes. The wire shape doesn't distinguish\n * \"transform a template\" from \"generate from a brief\" — both produce a\n * `CreativeManifest` from a `BuildCreativeRequest`. The previous v6\n * preview separated them into `CreativeTemplatePlatform` and\n * `CreativeGenerativePlatform`, but every interface field is the same;\n * the only meaningful difference was whether `refineCreative` was\n * supported, which is now optional on the unified shape.\n *\n * Spec defines a Submitted arm via `async-response-data.json`\n * (`BuildCreativeAsyncSubmitted`) but the per-tool\n * `build-creative-response.json` `oneOf` doesn't include it — a SPEC\n * inconsistency tracked as adcontextprotocol/adcp#3392. Until the spec\n * rolls Submitted into the `oneOf`, slow operations (TTS, audio mixing,\n * long-running generation) await in-request; status changes surface via\n * `publishStatusChange` on `resource_type: 'creative'`.\n *\n * Both `creative-template` and `creative-generative` specialism claims\n * map to this interface in `RequiredPlatformsFor<S>` — the discovery\n * distinction is preserved at the buyer-facing spec level (so buyers\n * filtering for \"AI brief-to-creative\" still find generative agents)\n * while implementation surface stays unified.\n *\n * Adopters that ALSO want library + tag generation + delivery reporting\n * (i.e., a full ad server on top of the builder) declare\n * `CreativeAdServerPlatform` instead. Multi-archetype omni agents\n * (rare in the wild) front each archetype as a separate tenant via\n * `TenantRegistry`.\n */\nexport interface CreativeBuilderPlatform<TCtxMeta = Record<string, unknown>> {\n  /**\n   * Build the creative. Single method covers template-driven transform\n   * (`req.template_id` + asset slots), brief-to-creative generation\n   * (`req.brief`), and any hybrid the platform supports — adopters\n   * route internally on `req` shape.\n   *\n   * Return shape is discriminated; see {@link BuildCreativeReturn}:\n   * single `CreativeManifest`, `CreativeManifest[]` for multi-format\n   * requests, OR a fully-shaped `BuildCreativePayload` /\n   * `BuildCreativeMultiPayload` payload when you need to set\n   * `sandbox` / `expires_at` / `preview`.\n   */\n  buildCreativeLegacy(req: BuildCreativeRequest, ctx: Ctx<TCtxMeta>): Promise<LegacyBuildCreativeReturn>;\n\n  /**\n   * Preview-only variant — sandbox URL or inline HTML, expires. Always\n   * sync. Optional because generative-only adopters that don't render\n   * preview ahead of generation can omit it; the framework returns\n   * `UNSUPPORTED_FEATURE` to buyers calling `preview_creative` against\n   * a platform that didn't wire this.\n   *\n   * ⚠️  NO-ACCOUNT TOOL — `ctx: NoAccountCtx<TCtxMeta>`. The wire request\n   * does not carry an `account` field, so `ctx.account` may be `undefined`\n   * when `accounts.resolve(undefined)` returned null. Narrow before reading\n   * `ctx.account.ctx_metadata`. See {@link NoAccountCtx}.\n   */\n  previewCreativeLegacy?(\n    req: PreviewCreativeRequest,\n    ctx: NoAccountCtx<TCtxMeta>\n  ): Promise<LegacyPreviewCreativePayload>;\n\n  /**\n   * Format catalog. Buyers call `list_creative_formats` to discover the\n   * formats this agent supports. Optional because adopters who declare\n   * their formats via `capabilities.creative_agents` (delegating to a\n   * separate creative agent) don't own format definitions; the framework\n   * surfaces `UNSUPPORTED_FEATURE` when omitted.\n   *\n   * ⚠️  NO-ACCOUNT TOOL — `ctx: NoAccountCtx<TCtxMeta>`. The wire request\n   * does not carry an `account` field. The framework dispatches with\n   * `ctx.account === undefined` for `'explicit'`-resolution adopters that\n   * don't return a synthetic singleton from `accounts.resolve(undefined)`.\n   * Format catalogs are typically publisher-wide; if yours is per-tenant\n   * (Bannerflow / Celtra-style multi-tenant catalogs), return a synthetic\n   * account from `accounts.resolve(undefined)` keyed on\n   * `ctx.authInfo.clientId` and narrow `ctx.account` inside the handler.\n   *\n   * **Precedence:** when an adopter ALSO wires `SalesPlatform.listCreativeFormats`\n   * on the same platform, the sales-side handler wins (mediaBuy domain\n   * registers before creative). Don't wire both — pick the surface that\n   * matches your specialism. This creative-side wiring exists for adopters\n   * claiming only creative specialisms (`creative-template`, `creative-\n   * generative`, `creative-ad-server`) without a sales platform attached.\n   */\n  listCreativeFormatsLegacy?(\n    req: ListCreativeFormatsRequest,\n    ctx: NoAccountCtx<TCtxMeta>\n  ): Promise<LegacyListCreativeFormatsPayload>;\n\n  /**\n   * Refine a prior generation. `taskId` references a prior submission.\n   * Sync — refinement is a mutation on existing state, not a new task\n   * creation. Optional because pure template platforms iterate by\n   * re-calling `buildCreative` with different inputs and don't carry\n   * generation state across calls.\n   */\n  refineCreativeLegacy?(taskId: string, refinement: RefinementMessage, ctx: Ctx<TCtxMeta>): Promise<CreativeManifest>;\n\n  /**\n   * Sync review surface. Stateless platforms typically auto-approve;\n   * adopters needing mandatory pre-persist review return\n   * `ctx.handoffToTask(fn)` to defer to a background task. Unified\n   * hybrid shape — return rows OR `ctx.handoffToTask(fn)`.\n   */\n  syncCreatives?(\n    creatives: Creative[],\n    ctx: Ctx<TCtxMeta>\n  ): Promise<SyncCreativesRow[] | TaskHandoff<SyncCreativesRow[]>>;\n}\n\n/**\n * @deprecated Use `CreativeBuilderPlatform` — the unified interface\n * covering both template-driven and brief-to-creative agents. The\n * v6 preview's separation of `CreativeTemplatePlatform` and\n * `CreativeGenerativePlatform` had no meaningful interface\n * distinction; this alias preserves source compatibility for one\n * release while adopters migrate. Will be removed in a future\n * release.\n */\nexport type CreativeTemplatePlatform<TCtxMeta = Record<string, unknown>> = CreativeBuilderPlatform<TCtxMeta>;\n\n/**\n * @deprecated Use `CreativeBuilderPlatform` — the unified interface\n * covering both template-driven and brief-to-creative agents. See\n * `CreativeTemplatePlatform` deprecation note. Will be removed in a\n * future release.\n */\nexport type CreativeGenerativePlatform<TCtxMeta = Record<string, unknown>> = CreativeBuilderPlatform<TCtxMeta>;\n\n// ---------------------------------------------------------------------------\n// Shared shapes\n// ---------------------------------------------------------------------------\n\nexport interface RefinementMessage {\n  /** Free-text instruction from the buyer. */\n  message: string;\n  /** Optional structured changes (e.g., \"make headline say X\"). */\n  changes?: Record<string, unknown>;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

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

@@ -63,17 +63,27 @@ import type { Account, NoAccountCtx } from '../account.mjs';
 import type { RequestContext } from '../context.mjs';
 import type { TaskHandoff } from '../async-outcome.mjs';
 import type { RequireCacheScopeWhenProducts, ServerPayload } from '../../../types/server-payload.mjs';
-import type { GetProductsRequest, GetProductsResponse, CreateMediaBuyRequest, CreateMediaBuySuccess, UpdateMediaBuyRequest, UpdateMediaBuySuccess, GetMediaBuysRequest, GetMediaBuysResponse, GetMediaBuyDeliveryRequest, GetMediaBuyDeliveryResponse, ProvidePerformanceFeedbackRequest, ProvidePerformanceFeedbackSuccess, ListCreativeFormatsRequest, ListCreativeFormatsResponse, ListCreativesRequest, ListCreativesResponse, SyncCatalogsRequest, SyncCatalogsSuccess, LogEventRequest, LogEventSuccess, SyncEventSourcesRequest, SyncEventSourcesSuccess, SyncCreativesError, SyncCreativesSuccess, CreativeAsset } from '../../../types/tools.generated.mjs';
-type Creative = CreativeAsset;
+import type { GetProductsResponse, CreateMediaBuySuccess, UpdateMediaBuySuccess, GetMediaBuysRequest, GetMediaBuysResponse, GetMediaBuyDeliveryRequest, GetMediaBuyDeliveryResponse, ProvidePerformanceFeedbackRequest, ProvidePerformanceFeedbackSuccess, ListCreativeFormatsRequest, ListCreativeFormatsResponse, ListCreativesResponse, SyncCatalogsRequest, SyncCatalogsSuccess, LogEventRequest, LogEventSuccess, SyncEventSourcesRequest, SyncEventSourcesSuccess, SyncCreativesError, SyncCreativesSuccess } from '../../../types/tools.generated.mjs';
+import type { CanonicalCreativeAsset, CanonicalCreateMediaBuyRequest, CanonicalCreativeResponse, CanonicalGetProductsRequest, CanonicalListCreativesRequest, CanonicalListCreativesResponse, CanonicalProduct, CanonicalUpdateMediaBuyRequest } from '../../../v2/projection/creative-delivery.mjs';
+type Creative = CanonicalCreativeAsset;
 type Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;
-export type GetProductsPayload = RequireCacheScopeWhenProducts<ServerPayload<GetProductsResponse>>;
-export type CreateMediaBuyPayload = ServerPayload<CreateMediaBuySuccess>;
-export type UpdateMediaBuyPayload = ServerPayload<UpdateMediaBuySuccess>;
-export type GetMediaBuyDeliveryPayload = ServerPayload<GetMediaBuyDeliveryResponse>;
-export type GetMediaBuysPayload = ServerPayload<GetMediaBuysResponse>;
+type CanonicalGetProductsPayload = Omit<ServerPayload<CanonicalCreativeResponse<GetProductsResponse>>, 'products'> & {
+    products?: CanonicalProduct[];
+};
+export type GetProductsPayload = RequireCacheScopeWhenProducts<CanonicalGetProductsPayload>;
+export type CreateMediaBuyPayload = ServerPayload<CanonicalCreativeResponse<CreateMediaBuySuccess>>;
+export type UpdateMediaBuyPayload = ServerPayload<CanonicalCreativeResponse<UpdateMediaBuySuccess>>;
+export type GetMediaBuyDeliveryPayload = ServerPayload<CanonicalCreativeResponse<GetMediaBuyDeliveryResponse>>;
+export type GetMediaBuysPayload = ServerPayload<CanonicalCreativeResponse<GetMediaBuysResponse>>;
 export type ProvidePerformanceFeedbackPayload = ServerPayload<ProvidePerformanceFeedbackSuccess>;
-export type ListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;
-export type ListCreativesPayload = ServerPayload<ListCreativesResponse>;
+export type LegacyListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;
+export type ListCreativesPayload = ServerPayload<CanonicalListCreativesResponse>;
+export type LegacyGetProductsPayload = RequireCacheScopeWhenProducts<ServerPayload<GetProductsResponse>>;
+export type LegacyCreateMediaBuyPayload = ServerPayload<CreateMediaBuySuccess>;
+export type LegacyUpdateMediaBuyPayload = ServerPayload<UpdateMediaBuySuccess>;
+export type LegacyGetMediaBuyDeliveryPayload = ServerPayload<GetMediaBuyDeliveryResponse>;
+export type LegacyGetMediaBuysPayload = ServerPayload<GetMediaBuysResponse>;
+export type LegacyListCreativesPayload = ServerPayload<ListCreativesResponse>;
 export type SyncCreativesSuccessPayload = ServerPayload<SyncCreativesSuccess>;
 export type SyncCreativesErrorPayload = ServerPayload<SyncCreativesError>;
 export type SyncCreativesPayload = SyncCreativesSuccessPayload | SyncCreativesErrorPayload;
@@ -92,7 +102,7 @@ export type UpdateMediaBuyHandlerResult = UpdateMediaBuyPayload | TaskHandoff<Up
 export type SyncCreativesHandlerResult = SyncCreativesRow[] | TaskHandoff<SyncCreativesRow[]>;
 export interface SalesPlatform<TCtxMeta = Record<string, unknown>> {
     /** Catalog discovery: return products directly or hand off curated discovery to a background task. */
-    getProducts?(req: GetProductsRequest, ctx: Ctx<TCtxMeta>): Promise<GetProductsHandlerResult>;
+    getProducts?(req: CanonicalGetProductsRequest, ctx: Ctx<TCtxMeta>): Promise<GetProductsHandlerResult>;
     /**
      * 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
@@ -139,14 +149,14 @@ export interface SalesPlatform<TCtxMeta = Record<string, unknown>> {
      * }
      * ```
      */
-    createMediaBuy?(req: CreateMediaBuyRequest, ctx: Ctx<TCtxMeta>): Promise<CreateMediaBuyHandlerResult>;
+    createMediaBuy?(req: CanonicalCreateMediaBuyRequest, ctx: Ctx<TCtxMeta>): Promise<CreateMediaBuyHandlerResult>;
     /**
      * Update a media buy. Return the patched buy immediately (sync fast path)
      * OR `ctx.handoffToTask(fn)` when the upstream activation or approval flow
      * must continue in the background. The framework owns task registration,
      * caller scoping, polling, and completion webhooks on the handoff path.
      */
-    updateMediaBuy?(buyId: string, patch: UpdateMediaBuyRequest, ctx: Ctx<TCtxMeta>): Promise<UpdateMediaBuyHandlerResult>;
+    updateMediaBuy?(buyId: string, patch: CanonicalUpdateMediaBuyRequest, ctx: Ctx<TCtxMeta>): Promise<UpdateMediaBuyHandlerResult>;
     /**
      * Push creatives. Return the array of wire success rows (sync fast
      * path) OR `ctx.handoffToTask(fn)` to defer to a background task
@@ -250,8 +260,8 @@ export interface SalesPlatform<TCtxMeta = Record<string, unknown>> {
     getMediaBuys?(req: GetMediaBuysRequest, ctx: Ctx<TCtxMeta>): Promise<GetMediaBuysPayload>;
     /** Accept buyer-side performance signals on a media buy / creative. */
     providePerformanceFeedback?(req: ProvidePerformanceFeedbackRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<ProvidePerformanceFeedbackPayload>;
-    listCreativeFormats?(req: ListCreativeFormatsRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<ListCreativeFormatsPayload>;
-    listCreatives?(req: ListCreativesRequest, ctx: Ctx<TCtxMeta>): Promise<ListCreativesPayload>;
+    listCreativeFormatsLegacy?(req: ListCreativeFormatsRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<LegacyListCreativeFormatsPayload>;
+    listCreatives?(req: CanonicalListCreativesRequest, ctx: Ctx<TCtxMeta>): Promise<ListCreativesPayload>;
     syncCatalogs?(req: SyncCatalogsRequest, ctx: Ctx<TCtxMeta>): Promise<SyncCatalogsPayload>;
     logEvent?(req: LogEventRequest, ctx: Ctx<TCtxMeta>): Promise<LogEventPayload>;
     syncEventSources?(req: SyncEventSourcesRequest, ctx: Ctx<TCtxMeta>): Promise<SyncEventSourcesPayload>;
@@ -288,5 +298,5 @@ export type SalesCorePlatform<TCtxMeta = Record<string, unknown>> = Required<Pic
  *
  * @public
  */
-export type SalesIngestionPlatform<TCtxMeta = Record<string, unknown>> = Pick<SalesPlatform<TCtxMeta>, 'syncCreatives' | 'syncCatalogs' | 'syncEventSources' | 'logEvent' | 'listCreativeFormats' | 'listCreatives' | 'providePerformanceFeedback'>;
+export type SalesIngestionPlatform<TCtxMeta = Record<string, unknown>> = Pick<SalesPlatform<TCtxMeta>, 'syncCreatives' | 'syncCatalogs' | 'syncEventSources' | 'logEvent' | 'listCreativeFormatsLegacy' | 'listCreatives' | 'providePerformanceFeedback'>;
 export {};

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

@@ -63,17 +63,27 @@ import type { Account, NoAccountCtx } from '../account';
 import type { RequestContext } from '../context';
 import type { TaskHandoff } from '../async-outcome';
 import type { RequireCacheScopeWhenProducts, ServerPayload } from '../../../types/server-payload';
-import type { GetProductsRequest, GetProductsResponse, CreateMediaBuyRequest, CreateMediaBuySuccess, UpdateMediaBuyRequest, UpdateMediaBuySuccess, GetMediaBuysRequest, GetMediaBuysResponse, GetMediaBuyDeliveryRequest, GetMediaBuyDeliveryResponse, ProvidePerformanceFeedbackRequest, ProvidePerformanceFeedbackSuccess, ListCreativeFormatsRequest, ListCreativeFormatsResponse, ListCreativesRequest, ListCreativesResponse, SyncCatalogsRequest, SyncCatalogsSuccess, LogEventRequest, LogEventSuccess, SyncEventSourcesRequest, SyncEventSourcesSuccess, SyncCreativesError, SyncCreativesSuccess, CreativeAsset } from '../../../types/tools.generated';
-type Creative = CreativeAsset;
+import type { GetProductsResponse, CreateMediaBuySuccess, UpdateMediaBuySuccess, GetMediaBuysRequest, GetMediaBuysResponse, GetMediaBuyDeliveryRequest, GetMediaBuyDeliveryResponse, ProvidePerformanceFeedbackRequest, ProvidePerformanceFeedbackSuccess, ListCreativeFormatsRequest, ListCreativeFormatsResponse, ListCreativesResponse, SyncCatalogsRequest, SyncCatalogsSuccess, LogEventRequest, LogEventSuccess, SyncEventSourcesRequest, SyncEventSourcesSuccess, SyncCreativesError, SyncCreativesSuccess } from '../../../types/tools.generated';
+import type { CanonicalCreativeAsset, CanonicalCreateMediaBuyRequest, CanonicalCreativeResponse, CanonicalGetProductsRequest, CanonicalListCreativesRequest, CanonicalListCreativesResponse, CanonicalProduct, CanonicalUpdateMediaBuyRequest } from '../../../v2/projection/creative-delivery';
+type Creative = CanonicalCreativeAsset;
 type Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;
-export type GetProductsPayload = RequireCacheScopeWhenProducts<ServerPayload<GetProductsResponse>>;
-export type CreateMediaBuyPayload = ServerPayload<CreateMediaBuySuccess>;
-export type UpdateMediaBuyPayload = ServerPayload<UpdateMediaBuySuccess>;
-export type GetMediaBuyDeliveryPayload = ServerPayload<GetMediaBuyDeliveryResponse>;
-export type GetMediaBuysPayload = ServerPayload<GetMediaBuysResponse>;
+type CanonicalGetProductsPayload = Omit<ServerPayload<CanonicalCreativeResponse<GetProductsResponse>>, 'products'> & {
+    products?: CanonicalProduct[];
+};
+export type GetProductsPayload = RequireCacheScopeWhenProducts<CanonicalGetProductsPayload>;
+export type CreateMediaBuyPayload = ServerPayload<CanonicalCreativeResponse<CreateMediaBuySuccess>>;
+export type UpdateMediaBuyPayload = ServerPayload<CanonicalCreativeResponse<UpdateMediaBuySuccess>>;
+export type GetMediaBuyDeliveryPayload = ServerPayload<CanonicalCreativeResponse<GetMediaBuyDeliveryResponse>>;
+export type GetMediaBuysPayload = ServerPayload<CanonicalCreativeResponse<GetMediaBuysResponse>>;
 export type ProvidePerformanceFeedbackPayload = ServerPayload<ProvidePerformanceFeedbackSuccess>;
-export type ListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;
-export type ListCreativesPayload = ServerPayload<ListCreativesResponse>;
+export type LegacyListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;
+export type ListCreativesPayload = ServerPayload<CanonicalListCreativesResponse>;
+export type LegacyGetProductsPayload = RequireCacheScopeWhenProducts<ServerPayload<GetProductsResponse>>;
+export type LegacyCreateMediaBuyPayload = ServerPayload<CreateMediaBuySuccess>;
+export type LegacyUpdateMediaBuyPayload = ServerPayload<UpdateMediaBuySuccess>;
+export type LegacyGetMediaBuyDeliveryPayload = ServerPayload<GetMediaBuyDeliveryResponse>;
+export type LegacyGetMediaBuysPayload = ServerPayload<GetMediaBuysResponse>;
+export type LegacyListCreativesPayload = ServerPayload<ListCreativesResponse>;
 export type SyncCreativesSuccessPayload = ServerPayload<SyncCreativesSuccess>;
 export type SyncCreativesErrorPayload = ServerPayload<SyncCreativesError>;
 export type SyncCreativesPayload = SyncCreativesSuccessPayload | SyncCreativesErrorPayload;
@@ -92,7 +102,7 @@ export type UpdateMediaBuyHandlerResult = UpdateMediaBuyPayload | TaskHandoff<Up
 export type SyncCreativesHandlerResult = SyncCreativesRow[] | TaskHandoff<SyncCreativesRow[]>;
 export interface SalesPlatform<TCtxMeta = Record<string, unknown>> {
     /** Catalog discovery: return products directly or hand off curated discovery to a background task. */
-    getProducts?(req: GetProductsRequest, ctx: Ctx<TCtxMeta>): Promise<GetProductsHandlerResult>;
+    getProducts?(req: CanonicalGetProductsRequest, ctx: Ctx<TCtxMeta>): Promise<GetProductsHandlerResult>;
     /**
      * 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
@@ -139,14 +149,14 @@ export interface SalesPlatform<TCtxMeta = Record<string, unknown>> {
      * }
      * ```
      */
-    createMediaBuy?(req: CreateMediaBuyRequest, ctx: Ctx<TCtxMeta>): Promise<CreateMediaBuyHandlerResult>;
+    createMediaBuy?(req: CanonicalCreateMediaBuyRequest, ctx: Ctx<TCtxMeta>): Promise<CreateMediaBuyHandlerResult>;
     /**
      * Update a media buy. Return the patched buy immediately (sync fast path)
      * OR `ctx.handoffToTask(fn)` when the upstream activation or approval flow
      * must continue in the background. The framework owns task registration,
      * caller scoping, polling, and completion webhooks on the handoff path.
      */
-    updateMediaBuy?(buyId: string, patch: UpdateMediaBuyRequest, ctx: Ctx<TCtxMeta>): Promise<UpdateMediaBuyHandlerResult>;
+    updateMediaBuy?(buyId: string, patch: CanonicalUpdateMediaBuyRequest, ctx: Ctx<TCtxMeta>): Promise<UpdateMediaBuyHandlerResult>;
     /**
      * Push creatives. Return the array of wire success rows (sync fast
      * path) OR `ctx.handoffToTask(fn)` to defer to a background task
@@ -250,8 +260,8 @@ export interface SalesPlatform<TCtxMeta = Record<string, unknown>> {
     getMediaBuys?(req: GetMediaBuysRequest, ctx: Ctx<TCtxMeta>): Promise<GetMediaBuysPayload>;
     /** Accept buyer-side performance signals on a media buy / creative. */
     providePerformanceFeedback?(req: ProvidePerformanceFeedbackRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<ProvidePerformanceFeedbackPayload>;
-    listCreativeFormats?(req: ListCreativeFormatsRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<ListCreativeFormatsPayload>;
-    listCreatives?(req: ListCreativesRequest, ctx: Ctx<TCtxMeta>): Promise<ListCreativesPayload>;
+    listCreativeFormatsLegacy?(req: ListCreativeFormatsRequest, ctx: NoAccountCtx<TCtxMeta>): Promise<LegacyListCreativeFormatsPayload>;
+    listCreatives?(req: CanonicalListCreativesRequest, ctx: Ctx<TCtxMeta>): Promise<ListCreativesPayload>;
     syncCatalogs?(req: SyncCatalogsRequest, ctx: Ctx<TCtxMeta>): Promise<SyncCatalogsPayload>;
     logEvent?(req: LogEventRequest, ctx: Ctx<TCtxMeta>): Promise<LogEventPayload>;
     syncEventSources?(req: SyncEventSourcesRequest, ctx: Ctx<TCtxMeta>): Promise<SyncEventSourcesPayload>;
@@ -288,6 +298,6 @@ export type SalesCorePlatform<TCtxMeta = Record<string, unknown>> = Required<Pic
  *
  * @public
  */
-export type SalesIngestionPlatform<TCtxMeta = Record<string, unknown>> = Pick<SalesPlatform<TCtxMeta>, 'syncCreatives' | 'syncCatalogs' | 'syncEventSources' | 'logEvent' | 'listCreativeFormats' | 'listCreatives' | 'providePerformanceFeedback'>;
+export type SalesIngestionPlatform<TCtxMeta = Record<string, unknown>> = Pick<SalesPlatform<TCtxMeta>, 'syncCreatives' | 'syncCatalogs' | 'syncEventSources' | 'logEvent' | 'listCreativeFormatsLegacy' | 'listCreatives' | 'providePerformanceFeedback'>;
 export {};
 //# sourceMappingURL=sales.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sales.d.ts","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/specialisms/sales.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sales.d.ts","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/specialisms/sales.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;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,6BAA6B,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAClG,OAAO,KAAK,EAEV,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,iCAAiC,EACjC,iCAAiC,EACjC,0BAA0B,EAC1B,2BAA2B,EAE3B,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,sBAAsB,EACtB,8BAA8B,EAC9B,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,EAC7B,8BAA8B,EAC9B,gBAAgB,EAChB,8BAA8B,EAC/B,MAAM,0CAA0C,CAAC;AAElD,KAAK,QAAQ,GAAG,sBAAsB,CAAC;AACvC,KAAK,GAAG,CAAC,QAAQ,IAAI,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEvD,KAAK,2BAA2B,GAAG,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,mBAAmB,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG;IACnH,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC/B,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,6BAA6B,CAAC,2BAA2B,CAAC,CAAC;AAC5F,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC,yBAAyB,CAAC,qBAAqB,CAAC,CAAC,CAAC;AACpG,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC,yBAAyB,CAAC,qBAAqB,CAAC,CAAC,CAAC;AACpG,MAAM,MAAM,0BAA0B,GAAG,aAAa,CAAC,yBAAyB,CAAC,2BAA2B,CAAC,CAAC,CAAC;AAC/G,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC,yBAAyB,CAAC,oBAAoB,CAAC,CAAC,CAAC;AACjG,MAAM,MAAM,iCAAiC,GAAG,aAAa,CAAC,iCAAiC,CAAC,CAAC;AACjG,MAAM,MAAM,gCAAgC,GAAG,aAAa,CAAC,2BAA2B,CAAC,CAAC;AAC1F,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC,8BAA8B,CAAC,CAAC;AACjF,MAAM,MAAM,wBAAwB,GAAG,6BAA6B,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC,CAAC;AACzG,MAAM,MAAM,2BAA2B,GAAG,aAAa,CAAC,qBAAqB,CAAC,CAAC;AAC/E,MAAM,MAAM,2BAA2B,GAAG,aAAa,CAAC,qBAAqB,CAAC,CAAC;AAC/E,MAAM,MAAM,gCAAgC,GAAG,aAAa,CAAC,2BAA2B,CAAC,CAAC;AAC1F,MAAM,MAAM,yBAAyB,GAAG,aAAa,CAAC,oBAAoB,CAAC,CAAC;AAC5E,MAAM,MAAM,0BAA0B,GAAG,aAAa,CAAC,qBAAqB,CAAC,CAAC;AAC9E,MAAM,MAAM,2BAA2B,GAAG,aAAa,CAAC,oBAAoB,CAAC,CAAC;AAC9E,MAAM,MAAM,yBAAyB,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAC;AAC1E,MAAM,MAAM,oBAAoB,GAAG,2BAA2B,GAAG,yBAAyB,CAAC;AAC3F,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC;AACrE,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;AAC7D,MAAM,MAAM,uBAAuB,GAAG,aAAa,CAAC,uBAAuB,CAAC,CAAC;AAE7E;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AACzE,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,GAAG,WAAW,CAAC,kBAAkB,CAAC,CAAC;AAC5F,MAAM,MAAM,2BAA2B,GAAG,qBAAqB,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;AACrG,MAAM,MAAM,2BAA2B,GAAG,qBAAqB,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;AACrG,MAAM,MAAM,0BAA0B,GAAG,gBAAgB,EAAE,GAAG,WAAW,CAAC,gBAAgB,EAAE,CAAC,CAAC;AAE9F,MAAM,WAAW,aAAa,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA8B/D,sGAAsG;IACtG,WAAW,CAAC,CAAC,GAAG,EAAE,2BAA2B,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAItG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACH,cAAc,CAAC,CAAC,GAAG,EAAE,8BAA8B,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAG/G;;;;;OAKG;IACH,cAAc,CAAC,CACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,8BAA8B,EACrC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GACjB,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAIxC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,aAAa,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAI/F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0DG;IACH,mBAAmB,CAAC,CAAC,MAAM,EAAE,0BAA0B,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAelH;;;;;;;;;;;;;;OAcG;IACH,YAAY,CAAC,CAAC,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAc1F,uEAAuE;IACvE,0BAA0B,CAAC,CACzB,GAAG,EAAE,iCAAiC,EACtC,GAAG,EAAE,YAAY,CAAC,QAAQ,CAAC,GAC1B,OAAO,CAAC,iCAAiC,CAAC,CAAC;IAW9C,yBAAyB,CAAC,CACxB,GAAG,EAAE,0BAA0B,EAC/B,GAAG,EAAE,YAAY,CAAC,QAAQ,CAAC,GAC1B,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAQ7C,aAAa,CAAC,CAAC,GAAG,EAAE,6BAA6B,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAOtG,YAAY,CAAC,CAAC,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAO1F,QAAQ,CAAC,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAM9E,gBAAgB,CAAC,CAAC,GAAG,EAAE,uBAAuB,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACvG;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,iBAAiB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,QAAQ,CAC1E,IAAI,CACF,aAAa,CAAC,QAAQ,CAAC,EACvB,aAAa,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,qBAAqB,GAAG,cAAc,CAC7F,CACF,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,sBAAsB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,CAC3E,aAAa,CAAC,QAAQ,CAAC,EACrB,eAAe,GACf,cAAc,GACd,kBAAkB,GAClB,UAAU,GACV,2BAA2B,GAC3B,eAAe,GACf,4BAA4B,CAC/B,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/specialisms/sales.ts"],"sourcesContent":["/**\n * SalesPlatform — sales specialism platform interface.\n *\n * **Unified hybrid shape.** `get_products`, `create_media_buy`, and `sync_creatives` use a\n * single method each. The method returns the wire success arm (sync fast\n * path) OR `ctx.handoffToTask(fn)` to promote the call to a background\n * task (HITL slow path). Branch per-call — the same method handles\n * programmatic remnant, guaranteed inventory, curated discovery, and hybrid\n * sellers. Every other tool is sync-only:\n *\n *   - `get_products` — sync OR `ctx.handoffToTask(...)` for curated brief/refine flows.\n *   - `create_media_buy` — sync OR `ctx.handoffToTask(...)`.\n *   - `update_media_buy` — sync only. Re-approval flows that need HITL run\n *     out-of-band; `publishStatusChange` carries the result.\n *   - `sync_creatives` — sync OR `ctx.handoffToTask(...)`.\n *   - `get_media_buy_delivery` — sync only.\n *\n * Sync-only tools that need long-running semantics use `publishStatusChange`\n * (see `status-changes.ts`) — that's the spec-aligned channel for tools\n * whose wire response unions don't define a Submitted arm.\n *\n * Each method either returns the value or throws `AdcpError` for structured\n * rejection. Generic thrown errors map to `SERVICE_UNAVAILABLE`.\n *\n * **Method groups** — implement the group(s) matching your specialism:\n *\n * | Group | Methods | Claim when |\n * |---|---|---|\n * | Core sales (required) | `getProducts`, `updateMediaBuy`, `getMediaBuyDelivery` | Any `sales-*` specialism |\n * | Core sales (unified hybrid) | `createMediaBuy` | Any `sales-*` specialism |\n * | Core sales (unified hybrid) | `syncCreatives` | Any `sales-*` specialism |\n * | Read / feedback | `getMediaBuys`, `providePerformanceFeedback`, `listCreativeFormats`, `listCreatives` | Most sellers; optional |\n * | Retail-media extensions | `syncCatalogs`, `logEvent`, `syncEventSources` | `sales-catalog-driven`, `sales-retail-media` |\n *\n * New adopters implementing a non-retail seller (GAM, FreeWheel, a social\n * platform) only need the three core-required methods plus `createMediaBuy`\n * and `syncCreatives`. The retail-media extension methods (`syncCatalogs`,\n * `logEvent`, `syncEventSources`) are unnecessary unless you claim\n * `sales-catalog-driven` or `sales-retail-media`.\n *\n * **No-account tools (`providePerformanceFeedback`, `listCreativeFormats`):**\n * the wire requests for these two tools don't carry an `account` field, so\n * `ctx.account` may be `undefined` when `accounts.resolution === 'explicit'`.\n * Three safe patterns:\n *\n * 1. **`'derived'` resolution** — `accounts.resolve(undefined)` returns a\n *    singleton; `ctx.account` is always set. Best for single-tenant\n *    deployers.\n * 2. **Don't implement the method** — the framework returns\n *    `UNSUPPORTED_FEATURE`; buyers using the merge-seam custom handler or\n *    external creative agents still receive a response.\n * 3. **Explicit-mode with defensive read** — cast `ctx.account as Account |\n *    undefined` and derive the account from the request body (e.g., via a\n *    `media_buy_id` lookup), or throw `AdcpError('ACCOUNT_NOT_FOUND')`.\n *    Full `resolveAccount(undefined, { authInfo, toolName })` support for\n *    explicit-mode lands in rc.1.\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 { RequireCacheScopeWhenProducts, ServerPayload } from '../../../types/server-payload';\nimport type {\n  GetProductsRequest,\n  GetProductsResponse,\n  CreateMediaBuyRequest,\n  CreateMediaBuySuccess,\n  UpdateMediaBuyRequest,\n  UpdateMediaBuySuccess,\n  GetMediaBuysRequest,\n  GetMediaBuysResponse,\n  GetMediaBuyDeliveryRequest,\n  GetMediaBuyDeliveryResponse,\n  ProvidePerformanceFeedbackRequest,\n  ProvidePerformanceFeedbackSuccess,\n  ListCreativeFormatsRequest,\n  ListCreativeFormatsResponse,\n  ListCreativesRequest,\n  ListCreativesResponse,\n  SyncCatalogsRequest,\n  SyncCatalogsSuccess,\n  LogEventRequest,\n  LogEventSuccess,\n  SyncEventSourcesRequest,\n  SyncEventSourcesSuccess,\n  SyncCreativesError,\n  SyncCreativesSuccess,\n  CreativeAsset,\n} from '../../../types/tools.generated';\n\ntype Creative = CreativeAsset;\ntype Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;\n\nexport type GetProductsPayload = RequireCacheScopeWhenProducts<ServerPayload<GetProductsResponse>>;\nexport type CreateMediaBuyPayload = ServerPayload<CreateMediaBuySuccess>;\nexport type UpdateMediaBuyPayload = ServerPayload<UpdateMediaBuySuccess>;\nexport type GetMediaBuyDeliveryPayload = ServerPayload<GetMediaBuyDeliveryResponse>;\nexport type GetMediaBuysPayload = ServerPayload<GetMediaBuysResponse>;\nexport type ProvidePerformanceFeedbackPayload = ServerPayload<ProvidePerformanceFeedbackSuccess>;\nexport type ListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;\nexport type ListCreativesPayload = ServerPayload<ListCreativesResponse>;\nexport type SyncCreativesSuccessPayload = ServerPayload<SyncCreativesSuccess>;\nexport type SyncCreativesErrorPayload = ServerPayload<SyncCreativesError>;\nexport type SyncCreativesPayload = SyncCreativesSuccessPayload | SyncCreativesErrorPayload;\nexport type SyncCatalogsPayload = ServerPayload<SyncCatalogsSuccess>;\nexport type LogEventPayload = ServerPayload<LogEventSuccess>;\nexport type SyncEventSourcesPayload = ServerPayload<SyncEventSourcesSuccess>;\n\n/**\n * Wire success-row shape for `sync_creatives`. Returning the array of these\n * rows from `syncCreatives` is what adopters write — the framework wraps\n * with `{ creatives: [...] }` to form `SyncCreativesSuccess`.\n */\nexport type SyncCreativesRow = SyncCreativesSuccess['creatives'][number];\nexport type GetProductsHandlerResult = GetProductsPayload | TaskHandoff<GetProductsPayload>;\nexport type CreateMediaBuyHandlerResult = CreateMediaBuyPayload | TaskHandoff<CreateMediaBuyPayload>;\nexport type UpdateMediaBuyHandlerResult = UpdateMediaBuyPayload | TaskHandoff<UpdateMediaBuyPayload>;\nexport type SyncCreativesHandlerResult = SyncCreativesRow[] | TaskHandoff<SyncCreativesRow[]>;\n\nexport interface SalesPlatform<TCtxMeta = Record<string, unknown>> {\n  // **Method shape — all optional, enforced per-specialism.** Every method on\n  // `SalesPlatform` is declared optional so the type accommodates non-media-\n  // buy walled gardens (sales-social, audience-sync, sales-proposal-mode)\n  // that don't accept inbound media buys but compose ingestion methods on\n  // this same surface. Compile-time enforcement of \"you claimed\n  // sales-non-guaranteed, therefore you MUST implement getProducts /\n  // createMediaBuy / updateMediaBuy / getMediaBuyDelivery / getMediaBuys\"\n  // moves up to `RequiredPlatformsFor<S>` — see the {@link SalesCorePlatform}\n  // type alias and the per-specialism mapping in `platform.ts`. Runtime\n  // enforcement is preserved: the dispatcher returns `UNSUPPORTED_FEATURE`\n  // for tools whose method is absent, and `validateSpecialismRequiredTools`\n  // throws / warns when a specialism's required tools aren't implemented.\n  //\n  // Adopters who implement the full media-buy surface keep working — their\n  // implementation is a superset of every per-specialism requirement.\n  // Adopters who only do ingestion (e.g. a Meta CAPI integration claiming\n  // `sales-social`) drop the 5 core stubs without compile errors.\n\n  // ── get_products: unified hybrid shape ────────────────────────────\n  // get_products is a CATALOG LOOKUP — fast read against the seller's\n  // existing inventory. rc8 allows curated brief/refine lookups to return a\n  // Submitted arm when the seller needs async enrichment. Adopters express\n  // that by returning ctx.handoffToTask(fn); the framework owns task_id\n  // allocation, polling state, and optional completion webhook delivery.\n  //\n  // Wholesale catalog dumps remain sync: if the seller cannot serve the\n  // full catalog directly, it should maintain an internal cache and return\n  // the current catalog view instead of turning wholesale discovery into a\n  // long-running operation.\n  /** Catalog discovery: return products directly or hand off curated discovery to a background task. */\n  getProducts?(req: GetProductsRequest, ctx: Ctx<TCtxMeta>): Promise<GetProductsHandlerResult>;\n\n  // ── create_media_buy: unified hybrid shape ──────────────────────────\n\n  /**\n   * Create a media buy. Return the wire success-arm shape (sync fast path)\n   * OR `ctx.handoffToTask(fn)` to promote the call to a background task\n   * (HITL slow path). Adopters can branch per-call: hybrid sellers route\n   * programmatic remnant sync, guaranteed inventory through HITL, all\n   * from the same method.\n   *\n   * Buyers pattern-match on the wire response shape (`media_buy_id` on\n   * the immediate response → sync; `task_id` + `status: 'submitted'` →\n   * poll `tasks_get` or receive webhook). Predictable per request,\n   * dynamic per call.\n   *\n   * Status changes flow via `publishStatusChange(...)` regardless of\n   * which path was taken.\n   *\n   * The handoff function's return value is persisted as JSONB in the\n   * task registry. Postgres-backed registries cap row size at 4MB —\n   * offload large payloads to blob storage and return references.\n   *\n   * @example Sync-only adopter (no HITL inventory)\n   * ```ts\n   * createMediaBuy: async (req, ctx) => {\n   *   return await this.commitSync(req);\n   * }\n   * ```\n   *\n   * @example HITL-only adopter (every call goes through trafficker review)\n   * ```ts\n   * createMediaBuy: async (req, ctx) => {\n   *   return ctx.handoffToTask(async (taskCtx) => {\n   *     await taskCtx.update({ message: 'Awaiting trafficker' });\n   *     return await this.runHITL(req);\n   *   });\n   * }\n   * ```\n   *\n   * @example Hybrid adopter (programmatic + guaranteed in same tenant)\n   * ```ts\n   * createMediaBuy: async (req, ctx) => {\n   *   if (this.requiresHITL(req)) {\n   *     return ctx.handoffToTask(async (taskCtx) => await this.runHITL(req));\n   *   }\n   *   return await this.commitSync(req);\n   * }\n   * ```\n   */\n  createMediaBuy?(req: CreateMediaBuyRequest, ctx: Ctx<TCtxMeta>): Promise<CreateMediaBuyHandlerResult>;\n\n  // ── update_media_buy: unified hybrid shape\n  /**\n   * Update a media buy. Return the patched buy immediately (sync fast path)\n   * OR `ctx.handoffToTask(fn)` when the upstream activation or approval flow\n   * must continue in the background. The framework owns task registration,\n   * caller scoping, polling, and completion webhooks on the handoff path.\n   */\n  updateMediaBuy?(\n    buyId: string,\n    patch: UpdateMediaBuyRequest,\n    ctx: Ctx<TCtxMeta>\n  ): Promise<UpdateMediaBuyHandlerResult>;\n\n  // ── sync_creatives: unified hybrid shape ────────────────────────────\n\n  /**\n   * Push creatives. Return the array of wire success rows (sync fast\n   * path) OR `ctx.handoffToTask(fn)` to defer to a background task\n   * (HITL slow path — manual review, brand-suitability gates, etc.).\n   * Hybrid: branch per-batch — auto-approve simple creatives sync,\n   * route everything else to HITL.\n   *\n   * Each row carries `action` (CRUD outcome) and optional `status`\n   * (review state). Buyers see mixed `approved` / `pending_review`\n   * rows on the sync path; subsequent review changes flow via\n   * `publishStatusChange(...)`.\n   *\n   * @example Hybrid adopter\n   * ```ts\n   * syncCreatives: async (creatives, ctx) => {\n   *   if (creatives.some(c => this.needsReview(c))) {\n   *     return ctx.handoffToTask(async (taskCtx) => {\n   *       return await this.reviewAndPersist(creatives);\n   *     });\n   *   }\n   *   return creatives.map(c => ({ creative_id: c.creative_id, action: 'created', status: 'approved' }));\n   * }\n   * ```\n   */\n  syncCreatives?(creatives: Creative[], ctx: Ctx<TCtxMeta>): Promise<SyncCreativesHandlerResult>;\n\n  // ── get_media_buy_delivery: sync only ───────────────────────────────\n\n  /**\n   * Per-media-buy delivery actuals (impressions, spend, pacing,\n   * conversions). Sync — report-running platforms with manual report\n   * cycles return the latest cached actuals and emit `delivery_report`\n   * status changes via `publishStatusChange` when fresh reports are\n   * available.\n   *\n   * **Multi-id contract.** `filter.media_buy_ids` is an array — buyers\n   * routinely request delivery for multiple buys in one call. The\n   * platform MUST iterate every id and return one element per id in\n   * `media_buy_deliveries[]`. Implementations that read only\n   * `media_buy_ids[0]` silently truncate the buyer's request — a\n   * correctness bug that has bitten multiple adopters (closes #1342).\n   *\n   * Pass-through is the framework contract: the platform owns fan-out\n   * because `aggregated_totals` requires platform-domain knowledge —\n   * `reach` (cross-buy dedup capability), `new_to_brand_rate` (weighted\n   * across buys, not a per-buy average), and `frequency` (depends on\n   * dedup) cannot be synthesized correctly by a naive framework loop.\n   * Sellers that can't compute the cross-buy fields omit them and emit\n   * the safely-summable fields (`impressions`, `spend`, `clicks`,\n   * `media_buy_count`); buyers fall back to per-buy values when needed.\n   *\n   * Recommended pattern — prefer the upstream's native multi-id query\n   * over a per-id loop. Most reporting APIs (GAM ReportService's\n   * `WHERE LINE_ITEM_ID IN (...)`, TTD, DV360, Magnite, PubMatic, retail\n   * media) take an id list in one round-trip; iterating one-id-at-a-time\n   * is an N-roundtrip pattern that triggers upstream rate limits on\n   * 50-buy reports.\n   *\n   * ```ts\n   * getMediaBuyDelivery: async (req, ctx) => {\n   *   const ids = req.media_buy_ids ?? [];\n   *   // Native multi-id: one upstream round-trip.\n   *   const rows = await this.upstream.report({\n   *     mediaBuyIds: ids,\n   *     start: req.start_date,\n   *     end: req.end_date,\n   *   });\n   *   return {\n   *     reporting_period: { start, end },\n   *     currency: 'USD',\n   *     media_buy_deliveries: rows,\n   *     aggregated_totals: this.upstream.aggregate(rows),\n   *   };\n   * }\n   * ```\n   *\n   * **Single-id fallback** — only if your upstream is genuinely single-id:\n   *\n   * ```ts\n   * const deliveries = await Promise.all(ids.map(id => fetchOne(id, ctx)));\n   * ```\n   *\n   * When `media_buy_ids` is omitted, return a paginated set of\n   * accessible media buys per the wire schema. `status_filter`\n   * defaults to `['active']` when omitted; honor the filter in your\n   * iteration.\n   */\n  getMediaBuyDelivery?(filter: GetMediaBuyDeliveryRequest, ctx: Ctx<TCtxMeta>): Promise<GetMediaBuyDeliveryPayload>;\n\n  // ── get_media_buys: sync only — REQUIRED ──────────────────────────────\n  // Read tool — buyers fetch a list of their media buys (often filtered by\n  // status / time window). Required because:\n  //   1. Every seller needs to support reading back what they created.\n  //   2. Idempotent retries depend on it (replay safe-by-design).\n  //   3. The 6.2 patch-decomposition redesign needs single-id reads;\n  //      `getMediaBuys` is the foundation.\n  //   4. Framework auto-stores returned media buys for hydration on\n  //      subsequent updateMediaBuy calls (see `hydratePackagesWithProducts`\n  //      pattern in `from-platform.ts`).\n  //\n  // Proposal-mode adopters (write-only via push channels) return an empty\n  // `media_buys: []` array — that's a valid response.\n  /**\n   * List media buys this account owns. Filter + pagination per the wire shape.\n   *\n   * **Multi-id contract.** `req.media_buy_ids` is an array — buyers\n   * routinely request a specific set of buys in one call. The platform\n   * MUST iterate every id and return one element per id in the response\n   * `media_buys[]` array. Reading only `media_buy_ids[0]` silently\n   * truncates the buyer's request — same correctness bug that #1342\n   * documented for `getMediaBuyDelivery`. Same recommended pattern: prefer\n   * an upstream multi-id query (one round-trip), fall back to per-id loop\n   * only when the upstream is single-id-only.\n   *\n   * When `media_buy_ids` is omitted, return a paginated set of accessible\n   * buys filtered by `status_filter` (defaults to `['active']`).\n   */\n  getMediaBuys?(req: GetMediaBuysRequest, ctx: Ctx<TCtxMeta>): Promise<GetMediaBuysPayload>;\n\n  // ── provide_performance_feedback: sync only ─────────────────────────\n  // Write tool — buyers report aggregate creative-level performance\n  // (impressions, clicks, conversions) to help the seller's optimizer learn.\n  // Optional because not every sales agent runs an optimizer, but every\n  // buyer expects to be able to call it. Framework returns UNSUPPORTED_FEATURE\n  // when omitted.\n  //\n  // ⚠️  NO-ACCOUNT TOOL — `ctx: NoAccountCtx<TCtxMeta>`. The wire request\n  // does not carry an `account` field. `ctx.account` may be `undefined` for\n  // `'explicit'`-resolution adopters; narrow before reading\n  // `ctx.account.ctx_metadata`. See {@link NoAccountCtx} and the\n  // `SalesPlatform` JSDoc (\"No-account tools\") for safe patterns.\n  /** Accept buyer-side performance signals on a media buy / creative. */\n  providePerformanceFeedback?(\n    req: ProvidePerformanceFeedbackRequest,\n    ctx: NoAccountCtx<TCtxMeta>\n  ): Promise<ProvidePerformanceFeedbackPayload>;\n\n  // ── list_creative_formats: sync only ────────────────────────────────\n  // Discovery tool — buyers query what creative formats this seller\n  // accepts. Optional because sellers that delegate to external\n  // `creative_agents` (declared in `capabilities.creative_agents[]`) don't\n  // own format definitions; framework can resolve from the declared agents.\n  // Self-hosted sellers (own creative library) implement this directly.\n  //\n  // ⚠️  NO-ACCOUNT TOOL — `ctx: NoAccountCtx<TCtxMeta>`. See\n  // `providePerformanceFeedback` note above.\n  listCreativeFormats?(\n    req: ListCreativeFormatsRequest,\n    ctx: NoAccountCtx<TCtxMeta>\n  ): Promise<ListCreativeFormatsPayload>;\n\n  // ── list_creatives: sync only ───────────────────────────────────────\n  // Read tool — buyers query the seller's creative library. Optional\n  // because most sales adopters delegate creative state to the\n  // `creative_agents` declared in capabilities; ad-server-style sales\n  // platforms implement directly. Note: also lives on `CreativeAdServerPlatform.listCreatives`\n  // for the standalone-creative-agent shape.\n  listCreatives?(req: ListCreativesRequest, ctx: Ctx<TCtxMeta>): Promise<ListCreativesPayload>;\n\n  // ── sync_catalogs: sync only ────────────────────────────────────────\n  // Retail-media catalog sync. Buyers push product catalogs (SKUs, ASINs,\n  // store-ids) for `sales-catalog-driven` agents (Amazon, Criteo, Citrusad,\n  // Walmart Connect, Shopify ad surfaces). Optional — non-retail sales\n  // adopters omit. Idempotent on the buyer's `idempotency_key`.\n  syncCatalogs?(req: SyncCatalogsRequest, ctx: Ctx<TCtxMeta>): Promise<SyncCatalogsPayload>;\n\n  // ── log_event: sync only ────────────────────────────────────────────\n  // Conversion / engagement event logging. Buyers post events tied to\n  // a `media_buy_id` for performance attribution. Used by retail-media\n  // (post-purchase events) and conversion-tracked sales (Snap pixel,\n  // Meta CAPI, LinkedIn conversions API). Optional.\n  logEvent?(req: LogEventRequest, ctx: Ctx<TCtxMeta>): Promise<LogEventPayload>;\n\n  // ── sync_event_sources: sync only ──────────────────────────────────\n  // Register conversion event sources (websites, apps, offline pixel\n  // IDs) so subsequent `log_event` calls can be attributed correctly.\n  // Optional — adopters who don't expose conversion tracking omit.\n  syncEventSources?(req: SyncEventSourcesRequest, ctx: Ctx<TCtxMeta>): Promise<SyncEventSourcesPayload>;\n}\n\n/**\n * Names the **core sales surface** — bidding + media-buy lifecycle. Required\n * for `sales-*` specialisms that own pricing/pacing\n * (`sales-non-guaranteed`, `sales-guaranteed`, `sales-broadcast-tv`,\n * `sales-streaming-tv`, `sales-exchange`, `sales-catalog-driven`,\n * `sales-retail-media`).\n *\n * Walled-garden specialisms whose value surface is asset ingestion\n * (`sales-social`, the `audience-sync` track, pure conversion-tracking\n * adopters) DON'T need to implement these — see {@link SalesIngestionPlatform}.\n *\n * Used by `RequiredPlatformsFor<S>` to pick the right slice of `SalesPlatform`\n * per claimed specialism.\n *\n * @public\n */\nexport type SalesCorePlatform<TCtxMeta = Record<string, unknown>> = Required<\n  Pick<\n    SalesPlatform<TCtxMeta>,\n    'getProducts' | 'createMediaBuy' | 'updateMediaBuy' | 'getMediaBuyDelivery' | 'getMediaBuys'\n  >\n>;\n\n/**\n * Names the **asset-ingestion surface** — sync surfaces for creatives,\n * audiences (via {@link import('./audiences').AudiencePlatform}), catalogs,\n * events, plus the read/feedback tools. Walled-garden specialisms\n * (`sales-social`) live here.\n *\n * Every method is optional individually. Adopters claiming `sales-social`\n * pick whichever ingestion surfaces apply (typically `syncCreatives` +\n * `logEvent` + `syncEventSources`); the rest stay omitted.\n *\n * Used by `RequiredPlatformsFor<S>` so claiming `sales-social` only requires\n * this slice of `SalesPlatform`, not the full {@link SalesCorePlatform}.\n *\n * @public\n */\nexport type SalesIngestionPlatform<TCtxMeta = Record<string, unknown>> = Pick<\n  SalesPlatform<TCtxMeta>,\n  | 'syncCreatives'\n  | 'syncCatalogs'\n  | 'syncEventSources'\n  | 'logEvent'\n  | 'listCreativeFormats'\n  | 'listCreatives'\n  | 'providePerformanceFeedback'\n>;\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/specialisms/sales.ts"],"sourcesContent":["/**\n * SalesPlatform — sales specialism platform interface.\n *\n * **Unified hybrid shape.** `get_products`, `create_media_buy`, and `sync_creatives` use a\n * single method each. The method returns the wire success arm (sync fast\n * path) OR `ctx.handoffToTask(fn)` to promote the call to a background\n * task (HITL slow path). Branch per-call — the same method handles\n * programmatic remnant, guaranteed inventory, curated discovery, and hybrid\n * sellers. Every other tool is sync-only:\n *\n *   - `get_products` — sync OR `ctx.handoffToTask(...)` for curated brief/refine flows.\n *   - `create_media_buy` — sync OR `ctx.handoffToTask(...)`.\n *   - `update_media_buy` — sync only. Re-approval flows that need HITL run\n *     out-of-band; `publishStatusChange` carries the result.\n *   - `sync_creatives` — sync OR `ctx.handoffToTask(...)`.\n *   - `get_media_buy_delivery` — sync only.\n *\n * Sync-only tools that need long-running semantics use `publishStatusChange`\n * (see `status-changes.ts`) — that's the spec-aligned channel for tools\n * whose wire response unions don't define a Submitted arm.\n *\n * Each method either returns the value or throws `AdcpError` for structured\n * rejection. Generic thrown errors map to `SERVICE_UNAVAILABLE`.\n *\n * **Method groups** — implement the group(s) matching your specialism:\n *\n * | Group | Methods | Claim when |\n * |---|---|---|\n * | Core sales (required) | `getProducts`, `updateMediaBuy`, `getMediaBuyDelivery` | Any `sales-*` specialism |\n * | Core sales (unified hybrid) | `createMediaBuy` | Any `sales-*` specialism |\n * | Core sales (unified hybrid) | `syncCreatives` | Any `sales-*` specialism |\n * | Read / feedback | `getMediaBuys`, `providePerformanceFeedback`, `listCreativeFormats`, `listCreatives` | Most sellers; optional |\n * | Retail-media extensions | `syncCatalogs`, `logEvent`, `syncEventSources` | `sales-catalog-driven`, `sales-retail-media` |\n *\n * New adopters implementing a non-retail seller (GAM, FreeWheel, a social\n * platform) only need the three core-required methods plus `createMediaBuy`\n * and `syncCreatives`. The retail-media extension methods (`syncCatalogs`,\n * `logEvent`, `syncEventSources`) are unnecessary unless you claim\n * `sales-catalog-driven` or `sales-retail-media`.\n *\n * **No-account tools (`providePerformanceFeedback`, `listCreativeFormats`):**\n * the wire requests for these two tools don't carry an `account` field, so\n * `ctx.account` may be `undefined` when `accounts.resolution === 'explicit'`.\n * Three safe patterns:\n *\n * 1. **`'derived'` resolution** — `accounts.resolve(undefined)` returns a\n *    singleton; `ctx.account` is always set. Best for single-tenant\n *    deployers.\n * 2. **Don't implement the method** — the framework returns\n *    `UNSUPPORTED_FEATURE`; buyers using the merge-seam custom handler or\n *    external creative agents still receive a response.\n * 3. **Explicit-mode with defensive read** — cast `ctx.account as Account |\n *    undefined` and derive the account from the request body (e.g., via a\n *    `media_buy_id` lookup), or throw `AdcpError('ACCOUNT_NOT_FOUND')`.\n *    Full `resolveAccount(undefined, { authInfo, toolName })` support for\n *    explicit-mode lands in rc.1.\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 { RequireCacheScopeWhenProducts, ServerPayload } from '../../../types/server-payload';\nimport type {\n  GetProductsRequest,\n  GetProductsResponse,\n  CreateMediaBuySuccess,\n  UpdateMediaBuySuccess,\n  GetMediaBuysRequest,\n  GetMediaBuysResponse,\n  GetMediaBuyDeliveryRequest,\n  GetMediaBuyDeliveryResponse,\n  ProvidePerformanceFeedbackRequest,\n  ProvidePerformanceFeedbackSuccess,\n  ListCreativeFormatsRequest,\n  ListCreativeFormatsResponse,\n  ListCreativesRequest,\n  ListCreativesResponse,\n  SyncCatalogsRequest,\n  SyncCatalogsSuccess,\n  LogEventRequest,\n  LogEventSuccess,\n  SyncEventSourcesRequest,\n  SyncEventSourcesSuccess,\n  SyncCreativesError,\n  SyncCreativesSuccess,\n} from '../../../types/tools.generated';\nimport type {\n  CanonicalCreativeAsset,\n  CanonicalCreateMediaBuyRequest,\n  CanonicalCreativeResponse,\n  CanonicalGetProductsRequest,\n  CanonicalListCreativesRequest,\n  CanonicalListCreativesResponse,\n  CanonicalProduct,\n  CanonicalUpdateMediaBuyRequest,\n} from '../../../v2/projection/creative-delivery';\n\ntype Creative = CanonicalCreativeAsset;\ntype Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;\n\ntype CanonicalGetProductsPayload = Omit<ServerPayload<CanonicalCreativeResponse<GetProductsResponse>>, 'products'> & {\n  products?: CanonicalProduct[];\n};\nexport type GetProductsPayload = RequireCacheScopeWhenProducts<CanonicalGetProductsPayload>;\nexport type CreateMediaBuyPayload = ServerPayload<CanonicalCreativeResponse<CreateMediaBuySuccess>>;\nexport type UpdateMediaBuyPayload = ServerPayload<CanonicalCreativeResponse<UpdateMediaBuySuccess>>;\nexport type GetMediaBuyDeliveryPayload = ServerPayload<CanonicalCreativeResponse<GetMediaBuyDeliveryResponse>>;\nexport type GetMediaBuysPayload = ServerPayload<CanonicalCreativeResponse<GetMediaBuysResponse>>;\nexport type ProvidePerformanceFeedbackPayload = ServerPayload<ProvidePerformanceFeedbackSuccess>;\nexport type LegacyListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;\nexport type ListCreativesPayload = ServerPayload<CanonicalListCreativesResponse>;\nexport type LegacyGetProductsPayload = RequireCacheScopeWhenProducts<ServerPayload<GetProductsResponse>>;\nexport type LegacyCreateMediaBuyPayload = ServerPayload<CreateMediaBuySuccess>;\nexport type LegacyUpdateMediaBuyPayload = ServerPayload<UpdateMediaBuySuccess>;\nexport type LegacyGetMediaBuyDeliveryPayload = ServerPayload<GetMediaBuyDeliveryResponse>;\nexport type LegacyGetMediaBuysPayload = ServerPayload<GetMediaBuysResponse>;\nexport type LegacyListCreativesPayload = ServerPayload<ListCreativesResponse>;\nexport type SyncCreativesSuccessPayload = ServerPayload<SyncCreativesSuccess>;\nexport type SyncCreativesErrorPayload = ServerPayload<SyncCreativesError>;\nexport type SyncCreativesPayload = SyncCreativesSuccessPayload | SyncCreativesErrorPayload;\nexport type SyncCatalogsPayload = ServerPayload<SyncCatalogsSuccess>;\nexport type LogEventPayload = ServerPayload<LogEventSuccess>;\nexport type SyncEventSourcesPayload = ServerPayload<SyncEventSourcesSuccess>;\n\n/**\n * Wire success-row shape for `sync_creatives`. Returning the array of these\n * rows from `syncCreatives` is what adopters write — the framework wraps\n * with `{ creatives: [...] }` to form `SyncCreativesSuccess`.\n */\nexport type SyncCreativesRow = SyncCreativesSuccess['creatives'][number];\nexport type GetProductsHandlerResult = GetProductsPayload | TaskHandoff<GetProductsPayload>;\nexport type CreateMediaBuyHandlerResult = CreateMediaBuyPayload | TaskHandoff<CreateMediaBuyPayload>;\nexport type UpdateMediaBuyHandlerResult = UpdateMediaBuyPayload | TaskHandoff<UpdateMediaBuyPayload>;\nexport type SyncCreativesHandlerResult = SyncCreativesRow[] | TaskHandoff<SyncCreativesRow[]>;\n\nexport interface SalesPlatform<TCtxMeta = Record<string, unknown>> {\n  // **Method shape — all optional, enforced per-specialism.** Every method on\n  // `SalesPlatform` is declared optional so the type accommodates non-media-\n  // buy walled gardens (sales-social, audience-sync, sales-proposal-mode)\n  // that don't accept inbound media buys but compose ingestion methods on\n  // this same surface. Compile-time enforcement of \"you claimed\n  // sales-non-guaranteed, therefore you MUST implement getProducts /\n  // createMediaBuy / updateMediaBuy / getMediaBuyDelivery / getMediaBuys\"\n  // moves up to `RequiredPlatformsFor<S>` — see the {@link SalesCorePlatform}\n  // type alias and the per-specialism mapping in `platform.ts`. Runtime\n  // enforcement is preserved: the dispatcher returns `UNSUPPORTED_FEATURE`\n  // for tools whose method is absent, and `validateSpecialismRequiredTools`\n  // throws / warns when a specialism's required tools aren't implemented.\n  //\n  // Adopters who implement the full media-buy surface keep working — their\n  // implementation is a superset of every per-specialism requirement.\n  // Adopters who only do ingestion (e.g. a Meta CAPI integration claiming\n  // `sales-social`) drop the 5 core stubs without compile errors.\n\n  // ── get_products: unified hybrid shape ────────────────────────────\n  // get_products is a CATALOG LOOKUP — fast read against the seller's\n  // existing inventory. rc8 allows curated brief/refine lookups to return a\n  // Submitted arm when the seller needs async enrichment. Adopters express\n  // that by returning ctx.handoffToTask(fn); the framework owns task_id\n  // allocation, polling state, and optional completion webhook delivery.\n  //\n  // Wholesale catalog dumps remain sync: if the seller cannot serve the\n  // full catalog directly, it should maintain an internal cache and return\n  // the current catalog view instead of turning wholesale discovery into a\n  // long-running operation.\n  /** Catalog discovery: return products directly or hand off curated discovery to a background task. */\n  getProducts?(req: CanonicalGetProductsRequest, ctx: Ctx<TCtxMeta>): Promise<GetProductsHandlerResult>;\n\n  // ── create_media_buy: unified hybrid shape ──────────────────────────\n\n  /**\n   * Create a media buy. Return the wire success-arm shape (sync fast path)\n   * OR `ctx.handoffToTask(fn)` to promote the call to a background task\n   * (HITL slow path). Adopters can branch per-call: hybrid sellers route\n   * programmatic remnant sync, guaranteed inventory through HITL, all\n   * from the same method.\n   *\n   * Buyers pattern-match on the wire response shape (`media_buy_id` on\n   * the immediate response → sync; `task_id` + `status: 'submitted'` →\n   * poll `tasks_get` or receive webhook). Predictable per request,\n   * dynamic per call.\n   *\n   * Status changes flow via `publishStatusChange(...)` regardless of\n   * which path was taken.\n   *\n   * The handoff function's return value is persisted as JSONB in the\n   * task registry. Postgres-backed registries cap row size at 4MB —\n   * offload large payloads to blob storage and return references.\n   *\n   * @example Sync-only adopter (no HITL inventory)\n   * ```ts\n   * createMediaBuy: async (req, ctx) => {\n   *   return await this.commitSync(req);\n   * }\n   * ```\n   *\n   * @example HITL-only adopter (every call goes through trafficker review)\n   * ```ts\n   * createMediaBuy: async (req, ctx) => {\n   *   return ctx.handoffToTask(async (taskCtx) => {\n   *     await taskCtx.update({ message: 'Awaiting trafficker' });\n   *     return await this.runHITL(req);\n   *   });\n   * }\n   * ```\n   *\n   * @example Hybrid adopter (programmatic + guaranteed in same tenant)\n   * ```ts\n   * createMediaBuy: async (req, ctx) => {\n   *   if (this.requiresHITL(req)) {\n   *     return ctx.handoffToTask(async (taskCtx) => await this.runHITL(req));\n   *   }\n   *   return await this.commitSync(req);\n   * }\n   * ```\n   */\n  createMediaBuy?(req: CanonicalCreateMediaBuyRequest, ctx: Ctx<TCtxMeta>): Promise<CreateMediaBuyHandlerResult>;\n\n  // ── update_media_buy: unified hybrid shape\n  /**\n   * Update a media buy. Return the patched buy immediately (sync fast path)\n   * OR `ctx.handoffToTask(fn)` when the upstream activation or approval flow\n   * must continue in the background. The framework owns task registration,\n   * caller scoping, polling, and completion webhooks on the handoff path.\n   */\n  updateMediaBuy?(\n    buyId: string,\n    patch: CanonicalUpdateMediaBuyRequest,\n    ctx: Ctx<TCtxMeta>\n  ): Promise<UpdateMediaBuyHandlerResult>;\n\n  // ── sync_creatives: unified hybrid shape ────────────────────────────\n\n  /**\n   * Push creatives. Return the array of wire success rows (sync fast\n   * path) OR `ctx.handoffToTask(fn)` to defer to a background task\n   * (HITL slow path — manual review, brand-suitability gates, etc.).\n   * Hybrid: branch per-batch — auto-approve simple creatives sync,\n   * route everything else to HITL.\n   *\n   * Each row carries `action` (CRUD outcome) and optional `status`\n   * (review state). Buyers see mixed `approved` / `pending_review`\n   * rows on the sync path; subsequent review changes flow via\n   * `publishStatusChange(...)`.\n   *\n   * @example Hybrid adopter\n   * ```ts\n   * syncCreatives: async (creatives, ctx) => {\n   *   if (creatives.some(c => this.needsReview(c))) {\n   *     return ctx.handoffToTask(async (taskCtx) => {\n   *       return await this.reviewAndPersist(creatives);\n   *     });\n   *   }\n   *   return creatives.map(c => ({ creative_id: c.creative_id, action: 'created', status: 'approved' }));\n   * }\n   * ```\n   */\n  syncCreatives?(creatives: Creative[], ctx: Ctx<TCtxMeta>): Promise<SyncCreativesHandlerResult>;\n\n  // ── get_media_buy_delivery: sync only ───────────────────────────────\n\n  /**\n   * Per-media-buy delivery actuals (impressions, spend, pacing,\n   * conversions). Sync — report-running platforms with manual report\n   * cycles return the latest cached actuals and emit `delivery_report`\n   * status changes via `publishStatusChange` when fresh reports are\n   * available.\n   *\n   * **Multi-id contract.** `filter.media_buy_ids` is an array — buyers\n   * routinely request delivery for multiple buys in one call. The\n   * platform MUST iterate every id and return one element per id in\n   * `media_buy_deliveries[]`. Implementations that read only\n   * `media_buy_ids[0]` silently truncate the buyer's request — a\n   * correctness bug that has bitten multiple adopters (closes #1342).\n   *\n   * Pass-through is the framework contract: the platform owns fan-out\n   * because `aggregated_totals` requires platform-domain knowledge —\n   * `reach` (cross-buy dedup capability), `new_to_brand_rate` (weighted\n   * across buys, not a per-buy average), and `frequency` (depends on\n   * dedup) cannot be synthesized correctly by a naive framework loop.\n   * Sellers that can't compute the cross-buy fields omit them and emit\n   * the safely-summable fields (`impressions`, `spend`, `clicks`,\n   * `media_buy_count`); buyers fall back to per-buy values when needed.\n   *\n   * Recommended pattern — prefer the upstream's native multi-id query\n   * over a per-id loop. Most reporting APIs (GAM ReportService's\n   * `WHERE LINE_ITEM_ID IN (...)`, TTD, DV360, Magnite, PubMatic, retail\n   * media) take an id list in one round-trip; iterating one-id-at-a-time\n   * is an N-roundtrip pattern that triggers upstream rate limits on\n   * 50-buy reports.\n   *\n   * ```ts\n   * getMediaBuyDelivery: async (req, ctx) => {\n   *   const ids = req.media_buy_ids ?? [];\n   *   // Native multi-id: one upstream round-trip.\n   *   const rows = await this.upstream.report({\n   *     mediaBuyIds: ids,\n   *     start: req.start_date,\n   *     end: req.end_date,\n   *   });\n   *   return {\n   *     reporting_period: { start, end },\n   *     currency: 'USD',\n   *     media_buy_deliveries: rows,\n   *     aggregated_totals: this.upstream.aggregate(rows),\n   *   };\n   * }\n   * ```\n   *\n   * **Single-id fallback** — only if your upstream is genuinely single-id:\n   *\n   * ```ts\n   * const deliveries = await Promise.all(ids.map(id => fetchOne(id, ctx)));\n   * ```\n   *\n   * When `media_buy_ids` is omitted, return a paginated set of\n   * accessible media buys per the wire schema. `status_filter`\n   * defaults to `['active']` when omitted; honor the filter in your\n   * iteration.\n   */\n  getMediaBuyDelivery?(filter: GetMediaBuyDeliveryRequest, ctx: Ctx<TCtxMeta>): Promise<GetMediaBuyDeliveryPayload>;\n\n  // ── get_media_buys: sync only — REQUIRED ──────────────────────────────\n  // Read tool — buyers fetch a list of their media buys (often filtered by\n  // status / time window). Required because:\n  //   1. Every seller needs to support reading back what they created.\n  //   2. Idempotent retries depend on it (replay safe-by-design).\n  //   3. The 6.2 patch-decomposition redesign needs single-id reads;\n  //      `getMediaBuys` is the foundation.\n  //   4. Framework auto-stores returned media buys for hydration on\n  //      subsequent updateMediaBuy calls (see `hydratePackagesWithProducts`\n  //      pattern in `from-platform.ts`).\n  //\n  // Proposal-mode adopters (write-only via push channels) return an empty\n  // `media_buys: []` array — that's a valid response.\n  /**\n   * List media buys this account owns. Filter + pagination per the wire shape.\n   *\n   * **Multi-id contract.** `req.media_buy_ids` is an array — buyers\n   * routinely request a specific set of buys in one call. The platform\n   * MUST iterate every id and return one element per id in the response\n   * `media_buys[]` array. Reading only `media_buy_ids[0]` silently\n   * truncates the buyer's request — same correctness bug that #1342\n   * documented for `getMediaBuyDelivery`. Same recommended pattern: prefer\n   * an upstream multi-id query (one round-trip), fall back to per-id loop\n   * only when the upstream is single-id-only.\n   *\n   * When `media_buy_ids` is omitted, return a paginated set of accessible\n   * buys filtered by `status_filter` (defaults to `['active']`).\n   */\n  getMediaBuys?(req: GetMediaBuysRequest, ctx: Ctx<TCtxMeta>): Promise<GetMediaBuysPayload>;\n\n  // ── provide_performance_feedback: sync only ─────────────────────────\n  // Write tool — buyers report aggregate creative-level performance\n  // (impressions, clicks, conversions) to help the seller's optimizer learn.\n  // Optional because not every sales agent runs an optimizer, but every\n  // buyer expects to be able to call it. Framework returns UNSUPPORTED_FEATURE\n  // when omitted.\n  //\n  // ⚠️  NO-ACCOUNT TOOL — `ctx: NoAccountCtx<TCtxMeta>`. The wire request\n  // does not carry an `account` field. `ctx.account` may be `undefined` for\n  // `'explicit'`-resolution adopters; narrow before reading\n  // `ctx.account.ctx_metadata`. See {@link NoAccountCtx} and the\n  // `SalesPlatform` JSDoc (\"No-account tools\") for safe patterns.\n  /** Accept buyer-side performance signals on a media buy / creative. */\n  providePerformanceFeedback?(\n    req: ProvidePerformanceFeedbackRequest,\n    ctx: NoAccountCtx<TCtxMeta>\n  ): Promise<ProvidePerformanceFeedbackPayload>;\n\n  // ── list_creative_formats: sync only ────────────────────────────────\n  // Discovery tool — buyers query what creative formats this seller\n  // accepts. Optional because sellers that delegate to external\n  // `creative_agents` (declared in `capabilities.creative_agents[]`) don't\n  // own format definitions; framework can resolve from the declared agents.\n  // Self-hosted sellers (own creative library) implement this directly.\n  //\n  // ⚠️  NO-ACCOUNT TOOL — `ctx: NoAccountCtx<TCtxMeta>`. See\n  // `providePerformanceFeedback` note above.\n  listCreativeFormatsLegacy?(\n    req: ListCreativeFormatsRequest,\n    ctx: NoAccountCtx<TCtxMeta>\n  ): Promise<LegacyListCreativeFormatsPayload>;\n\n  // ── list_creatives: sync only ───────────────────────────────────────\n  // Read tool — buyers query the seller's creative library. Optional\n  // because most sales adopters delegate creative state to the\n  // `creative_agents` declared in capabilities; ad-server-style sales\n  // platforms implement directly. Note: also lives on `CreativeAdServerPlatform.listCreatives`\n  // for the standalone-creative-agent shape.\n  listCreatives?(req: CanonicalListCreativesRequest, ctx: Ctx<TCtxMeta>): Promise<ListCreativesPayload>;\n\n  // ── sync_catalogs: sync only ────────────────────────────────────────\n  // Retail-media catalog sync. Buyers push product catalogs (SKUs, ASINs,\n  // store-ids) for `sales-catalog-driven` agents (Amazon, Criteo, Citrusad,\n  // Walmart Connect, Shopify ad surfaces). Optional — non-retail sales\n  // adopters omit. Idempotent on the buyer's `idempotency_key`.\n  syncCatalogs?(req: SyncCatalogsRequest, ctx: Ctx<TCtxMeta>): Promise<SyncCatalogsPayload>;\n\n  // ── log_event: sync only ────────────────────────────────────────────\n  // Conversion / engagement event logging. Buyers post events tied to\n  // a `media_buy_id` for performance attribution. Used by retail-media\n  // (post-purchase events) and conversion-tracked sales (Snap pixel,\n  // Meta CAPI, LinkedIn conversions API). Optional.\n  logEvent?(req: LogEventRequest, ctx: Ctx<TCtxMeta>): Promise<LogEventPayload>;\n\n  // ── sync_event_sources: sync only ──────────────────────────────────\n  // Register conversion event sources (websites, apps, offline pixel\n  // IDs) so subsequent `log_event` calls can be attributed correctly.\n  // Optional — adopters who don't expose conversion tracking omit.\n  syncEventSources?(req: SyncEventSourcesRequest, ctx: Ctx<TCtxMeta>): Promise<SyncEventSourcesPayload>;\n}\n\n/**\n * Names the **core sales surface** — bidding + media-buy lifecycle. Required\n * for `sales-*` specialisms that own pricing/pacing\n * (`sales-non-guaranteed`, `sales-guaranteed`, `sales-broadcast-tv`,\n * `sales-streaming-tv`, `sales-exchange`, `sales-catalog-driven`,\n * `sales-retail-media`).\n *\n * Walled-garden specialisms whose value surface is asset ingestion\n * (`sales-social`, the `audience-sync` track, pure conversion-tracking\n * adopters) DON'T need to implement these — see {@link SalesIngestionPlatform}.\n *\n * Used by `RequiredPlatformsFor<S>` to pick the right slice of `SalesPlatform`\n * per claimed specialism.\n *\n * @public\n */\nexport type SalesCorePlatform<TCtxMeta = Record<string, unknown>> = Required<\n  Pick<\n    SalesPlatform<TCtxMeta>,\n    'getProducts' | 'createMediaBuy' | 'updateMediaBuy' | 'getMediaBuyDelivery' | 'getMediaBuys'\n  >\n>;\n\n/**\n * Names the **asset-ingestion surface** — sync surfaces for creatives,\n * audiences (via {@link import('./audiences').AudiencePlatform}), catalogs,\n * events, plus the read/feedback tools. Walled-garden specialisms\n * (`sales-social`) live here.\n *\n * Every method is optional individually. Adopters claiming `sales-social`\n * pick whichever ingestion surfaces apply (typically `syncCreatives` +\n * `logEvent` + `syncEventSources`); the rest stay omitted.\n *\n * Used by `RequiredPlatformsFor<S>` so claiming `sales-social` only requires\n * this slice of `SalesPlatform`, not the full {@link SalesCorePlatform}.\n *\n * @public\n */\nexport type SalesIngestionPlatform<TCtxMeta = Record<string, unknown>> = Pick<\n  SalesPlatform<TCtxMeta>,\n  | 'syncCreatives'\n  | 'syncCatalogs'\n  | 'syncEventSources'\n  | 'logEvent'\n  | 'listCreativeFormatsLegacy'\n  | 'listCreatives'\n  | 'providePerformanceFeedback'\n>;\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/lib/server/index.d.mts

@@ -16,10 +16,10 @@ export type { OperationalPlatform, OperationalContext } from './operational-plat
 export { pickWireSpecFields, scrubExtensions, WIRE_SPEC_FIELDS } from './wire-safe.mjs';
 export type { WireSafe, WireSpecRequestName, ScrubExtensionsOptions } from './wire-safe.mjs';
 export type { RequireCacheScopeWhenProducts, ServerPayload } from '../types/server-payload.mjs';
-export type { ActivateSignalPayload, AcquireRightsAcquiredPayload, AcquireRightsPayload, AcquireRightsPendingApprovalPayload, AcquireRightsRejectedPayload, BuildCreativeMultiPayload, BuildCreativePayload, CalibrateContentPayload, CheckGovernancePayload, CreateCollectionListPayload, CreateContentStandardsPayload, CreateMediaBuyPayload, CreatePropertyListPayload, CreativeApprovalPayload, CreativeApprovedPayload, CreativePendingReviewPayload, CreativeRejectedPayload, DeleteCollectionListPayload, DeletePropertyListPayload, GetAccountFinancialsPayload, GetAccountFinancialsSuccessPayload, GetAdCPCapabilitiesPayload, GetBrandIdentityPayload, GetCollectionListPayload, GetContentStandardsPayload, GetCreativeDeliveryPayload, GetCreativeFeaturesPayload, GetMediaBuyArtifactsPayload, GetMediaBuyDeliveryPayload, GetMediaBuysPayload, GetPlanAuditLogsPayload, GetProductsPayload, GetPropertyListPayload, GetRightsPayload, GetRightsResponsePayload, GetSignalsPayload, ListAccountsPayload, ListCollectionListsPayload, ListContentStandardsPayload, ListCreativeFormatsPayload, ListCreativeFormatsResponsePayload, ListCreativeFormatsServerPayload, ListCreativesPayload, ListPropertyListsPayload, LogEventPayload, PreviewCreativePayload, ProvidePerformanceFeedbackPayload, ReportPlanOutcomePayload, ReportUsagePayload, SIGetOfferingPayload, SIInitiateSessionPayload, SISendMessagePayload, SITerminateSessionPayload, SyncAccountsPayload, SyncAccountsSuccessPayload, SyncAudiencesPayload, SyncCatalogsPayload, SyncCreativesErrorPayload, SyncCreativesPayload, SyncCreativesSuccessPayload, SyncEventSourcesPayload, SyncGovernancePayload, SyncGovernanceSuccessPayload, SyncPlansPayload, UpdateCollectionListPayload, UpdateContentStandardsPayload, UpdateMediaBuyPayload, UpdatePropertyListPayload, UpdateRightsPayload, ValidateContentDeliveryPayload, } from '../types/server-payload-aliases.mjs';
+export type { ActivateSignalPayload, AcquireRightsAcquiredPayload as LegacyAcquireRightsAcquiredPayload, AcquireRightsPayload as LegacyAcquireRightsPayload, AcquireRightsPendingApprovalPayload as LegacyAcquireRightsPendingApprovalPayload, AcquireRightsRejectedPayload as LegacyAcquireRightsRejectedPayload, BuildCreativeMultiPayload as LegacyBuildCreativeMultiPayload, BuildCreativePayload as LegacyBuildCreativePayload, CalibrateContentPayload as LegacyCalibrateContentPayload, CheckGovernancePayload, CreateCollectionListPayload, CreateContentStandardsPayload as LegacyCreateContentStandardsPayload, CreateMediaBuyPayload as LegacyCreateMediaBuyPayload, CreatePropertyListPayload, CreativeApprovalPayload, CreativeApprovedPayload, CreativePendingReviewPayload, CreativeRejectedPayload, DeleteCollectionListPayload, DeletePropertyListPayload, GetAccountFinancialsPayload, GetAccountFinancialsSuccessPayload, GetAdCPCapabilitiesPayload, GetBrandIdentityPayload, GetCollectionListPayload, GetContentStandardsPayload as LegacyGetContentStandardsPayload, GetCreativeDeliveryPayload as LegacyGetCreativeDeliveryPayload, GetCreativeFeaturesPayload as LegacyGetCreativeFeaturesPayload, GetMediaBuyArtifactsPayload as LegacyGetMediaBuyArtifactsPayload, GetMediaBuyDeliveryPayload as LegacyGetMediaBuyDeliveryPayload, GetMediaBuysPayload as LegacyGetMediaBuysPayload, GetPlanAuditLogsPayload, GetProductsPayload as LegacyGetProductsPayload, GetPropertyListPayload, GetRightsPayload as LegacyGetRightsPayload, GetRightsResponsePayload as LegacyGetRightsResponsePayload, GetSignalsPayload, ListAccountsPayload, ListCollectionListsPayload, ListContentStandardsPayload as LegacyListContentStandardsPayload, ListCreativeFormatsPayload as LegacyListCreativeFormatsPayload, ListCreativeFormatsResponsePayload as LegacyListCreativeFormatsResponsePayload, ListCreativeFormatsServerPayload as LegacyListCreativeFormatsServerPayload, ListCreativesPayload as LegacyListCreativesPayload, ListPropertyListsPayload, LogEventPayload, PreviewCreativePayload as LegacyPreviewCreativePayload, ProvidePerformanceFeedbackPayload, ReportPlanOutcomePayload, ReportUsagePayload, SIGetOfferingPayload, SIInitiateSessionPayload, SISendMessagePayload, SITerminateSessionPayload, SyncAccountsPayload, SyncAccountsSuccessPayload, SyncAudiencesPayload, SyncCatalogsPayload, SyncCreativesErrorPayload, SyncCreativesPayload, SyncCreativesSuccessPayload, SyncEventSourcesPayload, SyncGovernancePayload, SyncGovernanceSuccessPayload, SyncPlansPayload, UpdateCollectionListPayload, UpdateContentStandardsPayload as LegacyUpdateContentStandardsPayload, UpdateMediaBuyPayload as LegacyUpdateMediaBuyPayload, UpdatePropertyListPayload, UpdateRightsPayload as LegacyUpdateRightsPayload, ValidateContentDeliveryPayload as LegacyValidateContentDeliveryPayload, } from '../types/server-payload-aliases.mjs';
 export { assertNoExampleTlds } from './example-tld-guard.mjs';
 export type { AssertNoExampleTldsOptions } from './example-tld-guard.mjs';
-export { capabilitiesResponse, productsResponse, mediaBuyResponse, deliveryResponse, listAccountsResponse, listCreativeFormatsResponse, updateMediaBuyResponse, getMediaBuysResponse, performanceFeedbackResponse, buildCreativeResponse, buildCreativeMultiResponse, previewCreativeResponse, creativeDeliveryResponse, listCreativesResponse, listPropertyListsResponse, listCollectionListsResponse, listContentStandardsResponse, getPlanAuditLogsResponse, syncCreativesResponse, getSignalsResponse, activateSignalResponse, cancelMediaBuyResponse, acquireRightsResponse, acquireRightsAcquired, acquireRightsPendingApproval, acquireRightsRejected, updateRightsResponse, updateRightsSuccess, creativeApprovalResponse, creativeApprovalApproved, creativeApprovalRejected, creativeApprovalPendingReview, creativeApprovalError, syncAccountsResponse, syncGovernanceResponse, reportUsageResponse, toStructuredContent, } from './responses.mjs';
+export { capabilitiesResponse as legacyCapabilitiesResponse, productsResponse as legacyProductsResponse, mediaBuyResponse as legacyMediaBuyResponse, deliveryResponse as legacyDeliveryResponse, listAccountsResponse as legacyListAccountsResponse, listCreativeFormatsResponse as legacyListCreativeFormatsResponse, updateMediaBuyResponse as legacyUpdateMediaBuyResponse, getMediaBuysResponse as legacyGetMediaBuysResponse, performanceFeedbackResponse as legacyPerformanceFeedbackResponse, buildCreativeResponse as legacyBuildCreativeResponse, buildCreativeMultiResponse as legacyBuildCreativeMultiResponse, previewCreativeResponse as legacyPreviewCreativeResponse, creativeDeliveryResponse as legacyCreativeDeliveryResponse, listCreativesResponse as legacyListCreativesResponse, listPropertyListsResponse as legacyListPropertyListsResponse, listCollectionListsResponse as legacyListCollectionListsResponse, listContentStandardsResponse as legacyListContentStandardsResponse, getPlanAuditLogsResponse as legacyGetPlanAuditLogsResponse, syncCreativesResponse as legacySyncCreativesResponse, getSignalsResponse as legacyGetSignalsResponse, activateSignalResponse as legacyActivateSignalResponse, cancelMediaBuyResponse as legacyCancelMediaBuyResponse, acquireRightsResponse as legacyAcquireRightsResponse, acquireRightsAcquired as legacyAcquireRightsAcquired, acquireRightsPendingApproval as legacyAcquireRightsPendingApproval, acquireRightsRejected as legacyAcquireRightsRejected, updateRightsResponse as legacyUpdateRightsResponse, updateRightsSuccess as legacyUpdateRightsSuccess, creativeApprovalResponse as legacyCreativeApprovalResponse, creativeApprovalApproved as legacyCreativeApprovalApproved, creativeApprovalRejected as legacyCreativeApprovalRejected, creativeApprovalPendingReview as legacyCreativeApprovalPendingReview, creativeApprovalError as legacyCreativeApprovalError, syncAccountsResponse as legacySyncAccountsResponse, syncGovernanceResponse as legacySyncGovernanceResponse, reportUsageResponse as legacyReportUsageResponse, toStructuredContent, } from './responses.mjs';
 export type { McpToolResponse } from './responses.mjs';
 export { validActionsForStatus } from './media-buy-helpers.mjs';
 export type { ValidAction, CancelMediaBuyInput } from './media-buy-helpers.mjs';
@@ -56,7 +56,7 @@ export type { AdcpMcpResourceDefinition, McpAppResourceCsp, McpAppResourcePermis
 export { requireSessionKey, ADCP_PRE_TRANSPORT, ADCP_SIGNED_REQUESTS_STATE, ADCP_INSTRUCTIONS_FN, } from './create-adcp-server.mjs';
 export type { SessionContext, OnInstructionsError, MaybePromise, BridgeMarker } from './create-adcp-server.mjs';
 export type { AdcpServer, AdcpServerComplianceApi, AdcpServerTransport, AdcpTestRequest, AdcpTestToolsCallRequest, AdcpTestResponse, } from './adcp-server.mjs';
-export type { AdcpServerConfig, WebhooksConfig, AdcpToolMap, AdcpServerToolName, AdcpCapabilitiesConfig, AdcpCapabilitiesOverrides, AdcpCustomToolConfig, McpAppUiMeta, McpAppMeta, AdcpLogger, SignedRequestsConfig, AdcpPreTransport, AdcpSignedRequestsState, HandlerContext, SessionKeyContext, MediaBuyHandlers, SignalsHandlers, CreativeHandlers, GovernanceHandlers, AccountHandlers, EventTrackingHandlers, SponsoredIntelligenceHandlers, ResolveAccountContext, } from './create-adcp-server.mjs';
+export type { AdcpServerConfig as LegacyAdcpServerConfig, WebhooksConfig, AdcpToolMap as LegacyAdcpToolMap, AdcpServerToolName, AdcpCapabilitiesConfig, AdcpCapabilitiesOverrides, AdcpCustomToolConfig as LegacyAdcpCustomToolConfig, McpAppUiMeta, McpAppMeta, AdcpLogger, SignedRequestsConfig, AdcpPreTransport, AdcpSignedRequestsState, HandlerContext as LegacyHandlerContext, SessionKeyContext, MediaBuyHandlers as LegacyMediaBuyHandlers, SignalsHandlers as LegacySignalsHandlers, CreativeHandlers as LegacyCreativeHandlers, GovernanceHandlers as LegacyGovernanceHandlers, AccountHandlers as LegacyAccountHandlers, EventTrackingHandlers as LegacyEventTrackingHandlers, SponsoredIntelligenceHandlers as LegacySponsoredIntelligenceHandlers, ResolveAccountContext as LegacyResolveAccountContext, } from './create-adcp-server.mjs';
 export { DEFAULT_REPORTING_CAPABILITIES } from './product-defaults.mjs';
 export { isSandboxRequest, mergeSeededProductsIntoResponse, filterValidSeededProducts, filterValidSeededCreatives, filterValidSeededMediaBuys, filterValidSeededAccounts, filterValidSeededAccountFinancials, filterValidSeededCreativeFormats, mergeSeededCreativesIntoResponse, mergeSeededMediaBuysIntoResponse, mergeSeededAccountsIntoResponse, mergeSeededCreativeFormatsIntoResponse, pickSeededAccountFinancialsForRequest, replaceAccountFinancialsIfSeeded, bridgeFromTestControllerStore, bridgeFromSessionStore, } from './test-controller-bridge.mjs';
 export type { TestControllerBridge, TestControllerBridgeContext, BridgeFromSessionStoreOptions, SeededCreative, SeededMediaBuy, SeededAccountFinancials, } from './test-controller-bridge.mjs';