@adcp/sdk 8.1.0-beta.8 → 8.1.0-beta.9

package/README.md

@@ -29,9 +29,12 @@ AdCP operations are **distributed and asynchronous by default**. An agent might:
 ## Installation
 
 ```bash
-npm install @adcp/sdk
+npm install @adcp/sdk        # 7.x (current latest, AdCP 3.0)
+npm install @adcp/sdk@beta   # 8.x beta (AdCP 3.1.0-beta)
 ```
 
+Upgrading from v7? See **[MIGRATION-v8.md](./MIGRATION-v8.md)** — TL;DR is three changes for most adopters; full guide covers wire shape, type shape, and SDK behavior deltas.
+
 ### Narrow type imports (`@adcp/sdk/types/<tool>`)
 
 Adopters who only need a single AdCP tool's types can import a per-tool slice instead of the full surface. Each slice is a self-contained `.d.ts` covering the tool's `Request` / `Response` / `Success` / `Error` / `Submitted` types and every type they reference:

package/dist/lib/schemas/index.d.ts

@@ -3,18 +3,22 @@
  *
  * The generated Zod schemas in `../types/schemas.generated` cover every
  * AdCP tool — the framework-registered {@link AdcpToolMap} tools AND
- * tools like `creative_approval` / `update_rights` that ship as
- * `customTools` extensions because the spec models them as out-of-band
- * callbacks rather than MCP-registered surfaces.
+ * tools like `creative_approval`, `search_brands`, and brand verification
+ * tasks that ship as `customTools` extensions because the spec models them
+ * outside the SDK's framework-registered surface.
  *
  * This module re-exports the generated schemas plus two convenience
  * helpers for the `customTools` registration path:
  *
- *   - {@link TOOL_INPUT_SHAPES}: `toolName → inputSchema` map, ready to
- *     pass as `inputSchema` to MCP SDK's `server.registerTool()`. Uses
- *     the same tool-name keys as `AdcpServerConfig.customTools`.
+ *   - {@link TOOL_INPUT_SHAPES}: `toolName → raw Zod shape` map, ready to
+ *     pass as `inputSchema` to MCP SDK's `server.registerTool()` when the
+ *     request schema is a ZodObject.
+ *   - {@link TOOL_INPUT_SCHEMAS}: `toolName → full Zod schema` map for
+ *     custom tools whose request schema is a union/intersection and cannot
+ *     be represented as a raw shape without weakening validation.
  *   - {@link customToolFor}: sugar for registering a single custom tool
  *     with type-safe `handler` params derived from the schema's shape.
+ *   - {@link customToolForSchema}: same sugar for full Zod schemas.
  *
  * ```ts
  * import { createAdcpServer } from '@adcp/sdk/server/legacy/v5';
@@ -34,9 +38,34 @@
  * ```
  */
 import type { z } from 'zod';
+import * as schemas from '../types/schemas.generated';
+import type { KnownToolRequestSchemas } from '../utils/tool-request-schemas';
 export * from '../types/schemas.generated';
 export { TOOL_REQUEST_SCHEMAS } from '../utils/tool-request-schemas';
 type InputShape = Record<string, z.ZodType>;
+type InputSchema = z.ZodType;
+type ShapeOf<T> = T extends {
+    shape: infer TShape extends InputShape;
+} ? TShape : never;
+type ToolInputShapes = {
+    [K in keyof KnownToolRequestSchemas]: ShapeOf<KnownToolRequestSchemas[K]>;
+} & {
+    creative_approval: typeof schemas.CreativeApprovalRequestSchema.shape;
+    search_brands: typeof schemas.SearchBrandsRequestSchema.shape;
+    verify_brand_claims: typeof schemas.VerifyBrandClaimsRequestBulkSchema.shape;
+} & {
+    readonly [toolName: string]: Readonly<InputShape> | undefined;
+};
+type ToolInputSchemas = {
+    [K in keyof KnownToolRequestSchemas]: KnownToolRequestSchemas[K];
+} & {
+    creative_approval: typeof schemas.CreativeApprovalRequestSchema;
+    search_brands: typeof schemas.SearchBrandsRequestSchema;
+    verify_brand_claim: typeof schemas.VerifyBrandClaimRequestSchema;
+    verify_brand_claims: typeof schemas.VerifyBrandClaimsRequestBulkSchema;
+} & {
+    readonly [toolName: string]: InputSchema | undefined;
+};
 /**
  * Map of every known AdCP tool name to its Zod input shape — i.e., the
  * `.shape` of its request schema, ready to pass as `inputSchema` to MCP
@@ -46,16 +75,34 @@ type InputShape = Record<string, z.ZodType>;
  * registered with the framework (get_products, create_media_buy,
  * sync_catalogs, check_governance, comply_test_controller, all five
  * *_collection_list tools, validate_property_delivery, acquire_rights,
- * et al.) PLUS the two tools the spec models as customTool-only
- * extensions — `creative_approval` and `update_rights` — so sellers
- * don't have to hand-author shapes for those either.
+ * et al.) PLUS shape-compatible custom surfaces such as `creative_approval`,
+ * `search_brands`, and `verify_brand_claims` so sellers don't have to
+ * hand-author shapes for those either.
+ *
+ * `verify_brand_claim` is intentionally not present here: its request schema
+ * is an envelope intersected with a claim-variant union, so use
+ * {@link TOOL_INPUT_SCHEMAS} with {@link customToolForSchema} to preserve the
+ * discriminated union at validation time.
+ *
+ * Known tool names retain exact `.shape` field types for IDE completion and
+ * handler inference. Arbitrary string lookups return `undefined` until callers
+ * narrow the tool name to a known key.
  *
  * If a future AdCP release adds a new tool with a generated request
  * schema, add its entry here (or to `TOOL_REQUEST_SCHEMAS` if it's
  * framework-registrable) — CI's `ci:schema-check` catches missing
  * map entries by diffing against the generated schemas.
  */
-export declare const TOOL_INPUT_SHAPES: Readonly<Record<string, Readonly<InputShape>>>;
+export declare const TOOL_INPUT_SHAPES: Readonly<ToolInputShapes>;
+/**
+ * Map of known AdCP tool names to their full generated Zod request schemas.
+ *
+ * Prefer {@link TOOL_INPUT_SHAPES} when registering a shape-compatible tool
+ * with `registerTool()`. Use this map for union/intersection request schemas,
+ * notably `verify_brand_claim`, where a raw shape would lose the correlation
+ * between `claim_type` and the corresponding `claim` payload.
+ */
+export declare const TOOL_INPUT_SCHEMAS: Readonly<ToolInputSchemas>;
 /**
  * Register a custom tool with MCP-compatible `inputSchema` + handler
  * wiring. Returns an object shaped for
@@ -73,4 +120,15 @@ export declare function customToolFor<TShape extends InputShape>(name: string, d
     inputSchema: TShape;
     handler: (args: z.input<z.ZodObject<TShape>>, extra?: unknown) => unknown | Promise<unknown>;
 };
+/**
+ * Register a custom tool whose MCP `inputSchema` is a full Zod schema rather
+ * than a raw shape. Use this for request schemas with top-level unions or
+ * intersections, where `.shape` would either be unavailable or would weaken
+ * runtime validation.
+ */
+export declare function customToolForSchema<TSchema extends InputSchema>(name: string, description: string, inputSchema: TSchema, handler: (args: z.input<TSchema>, extra?: unknown) => unknown | Promise<unknown>): {
+    description: string;
+    inputSchema: TSchema;
+    handler: (args: z.input<TSchema>, extra?: unknown) => unknown | Promise<unknown>;
+};
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;AAQ5C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAS3E,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,MAAM,SAAS,UAAU,EACrD,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAC3F;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9F,CAOA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/schemas/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/schemas/index.js

@@ -4,18 +4,22 @@
  *
  * The generated Zod schemas in `../types/schemas.generated` cover every
  * AdCP tool — the framework-registered {@link AdcpToolMap} tools AND
- * tools like `creative_approval` / `update_rights` that ship as
- * `customTools` extensions because the spec models them as out-of-band
- * callbacks rather than MCP-registered surfaces.
+ * tools like `creative_approval`, `search_brands`, and brand verification
+ * tasks that ship as `customTools` extensions because the spec models them
+ * outside the SDK's framework-registered surface.
  *
  * This module re-exports the generated schemas plus two convenience
  * helpers for the `customTools` registration path:
  *
- *   - {@link TOOL_INPUT_SHAPES}: `toolName → inputSchema` map, ready to
- *     pass as `inputSchema` to MCP SDK's `server.registerTool()`. Uses
- *     the same tool-name keys as `AdcpServerConfig.customTools`.
+ *   - {@link TOOL_INPUT_SHAPES}: `toolName → raw Zod shape` map, ready to
+ *     pass as `inputSchema` to MCP SDK's `server.registerTool()` when the
+ *     request schema is a ZodObject.
+ *   - {@link TOOL_INPUT_SCHEMAS}: `toolName → full Zod schema` map for
+ *     custom tools whose request schema is a union/intersection and cannot
+ *     be represented as a raw shape without weakening validation.
  *   - {@link customToolFor}: sugar for registering a single custom tool
  *     with type-safe `handler` params derived from the schema's shape.
+ *   - {@link customToolForSchema}: same sugar for full Zod schemas.
  *
  * ```ts
  * import { createAdcpServer } from '@adcp/sdk/server/legacy/v5';
@@ -71,17 +75,16 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOOL_INPUT_SHAPES = exports.TOOL_REQUEST_SCHEMAS = void 0;
+exports.TOOL_INPUT_SCHEMAS = exports.TOOL_INPUT_SHAPES = exports.TOOL_REQUEST_SCHEMAS = void 0;
 exports.customToolFor = customToolFor;
+exports.customToolForSchema = customToolForSchema;
 const schemas = __importStar(require("../types/schemas.generated"));
 const tool_request_schemas_1 = require("../utils/tool-request-schemas");
 __exportStar(require("../types/schemas.generated"), exports);
 var tool_request_schemas_2 = require("../utils/tool-request-schemas");
 Object.defineProperty(exports, "TOOL_REQUEST_SCHEMAS", { enumerable: true, get: function () { return tool_request_schemas_2.TOOL_REQUEST_SCHEMAS; } });
 function shapeOf(s) {
-    if (!s)
-        return undefined;
-    const candidate = s.shape;
+    const candidate = s?.shape;
     return candidate && typeof candidate === 'object' ? candidate : undefined;
 }
 /**
@@ -93,9 +96,18 @@ function shapeOf(s) {
  * registered with the framework (get_products, create_media_buy,
  * sync_catalogs, check_governance, comply_test_controller, all five
  * *_collection_list tools, validate_property_delivery, acquire_rights,
- * et al.) PLUS the two tools the spec models as customTool-only
- * extensions — `creative_approval` and `update_rights` — so sellers
- * don't have to hand-author shapes for those either.
+ * et al.) PLUS shape-compatible custom surfaces such as `creative_approval`,
+ * `search_brands`, and `verify_brand_claims` so sellers don't have to
+ * hand-author shapes for those either.
+ *
+ * `verify_brand_claim` is intentionally not present here: its request schema
+ * is an envelope intersected with a claim-variant union, so use
+ * {@link TOOL_INPUT_SCHEMAS} with {@link customToolForSchema} to preserve the
+ * discriminated union at validation time.
+ *
+ * Known tool names retain exact `.shape` field types for IDE completion and
+ * handler inference. Arbitrary string lookups return `undefined` until callers
+ * narrow the tool name to a known key.
  *
  * If a future AdCP release adds a new tool with a generated request
  * schema, add its entry here (or to `TOOL_REQUEST_SCHEMAS` if it's
@@ -103,12 +115,31 @@ function shapeOf(s) {
  * map entries by diffing against the generated schemas.
  */
 exports.TOOL_INPUT_SHAPES = Object.freeze({
-    ...Object.fromEntries(Object.entries(tool_request_schemas_1.TOOL_REQUEST_SCHEMAS).flatMap(([k, s]) => {
+    ...Object.fromEntries(Object.entries(tool_request_schemas_1.TOOL_REQUEST_SCHEMAS).map(([k, s]) => {
         const shape = shapeOf(s);
-        return shape ? [[k, shape]] : [];
+        if (!shape) {
+            throw new Error(`TOOL_REQUEST_SCHEMAS["${k}"] has no .shape — schema must be a ZodObject (use merge() not and())`);
+        }
+        return [k, shape];
     })),
     creative_approval: schemas.CreativeApprovalRequestSchema.shape,
-    update_rights: schemas.UpdateRightsRequestSchema.shape,
+    search_brands: schemas.SearchBrandsRequestSchema.shape,
+    verify_brand_claims: schemas.VerifyBrandClaimsRequestBulkSchema.shape,
+});
+/**
+ * Map of known AdCP tool names to their full generated Zod request schemas.
+ *
+ * Prefer {@link TOOL_INPUT_SHAPES} when registering a shape-compatible tool
+ * with `registerTool()`. Use this map for union/intersection request schemas,
+ * notably `verify_brand_claim`, where a raw shape would lose the correlation
+ * between `claim_type` and the corresponding `claim` payload.
+ */
+exports.TOOL_INPUT_SCHEMAS = Object.freeze({
+    ...tool_request_schemas_1.TOOL_REQUEST_SCHEMAS,
+    creative_approval: schemas.CreativeApprovalRequestSchema,
+    search_brands: schemas.SearchBrandsRequestSchema,
+    verify_brand_claim: schemas.VerifyBrandClaimRequestSchema,
+    verify_brand_claims: schemas.VerifyBrandClaimsRequestBulkSchema,
 });
 /**
  * Register a custom tool with MCP-compatible `inputSchema` + handler
@@ -130,4 +161,14 @@ function customToolFor(name, description, inputSchema, handler) {
     void name;
     return { description, inputSchema, handler };
 }
+/**
+ * Register a custom tool whose MCP `inputSchema` is a full Zod schema rather
+ * than a raw shape. Use this for request schemas with top-level unions or
+ * intersections, where `.shape` would either be unavailable or would weaken
+ * runtime validation.
+ */
+function customToolForSchema(name, description, inputSchema, handler) {
+    void name;
+    return { description, inputSchema, handler };
+}
 //# sourceMappingURL=index.js.map

package/dist/lib/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/schemas/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0DH,sCAgBC;AAvED,oEAAsD;AACtD,wEAAqE;AAErE,6DAA2C;AAC3C,sEAAqE;AAA5D,4HAAA,oBAAoB,OAAA;AAI7B,SAAS,OAAO,CAAC,CAAU;IACzB,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,MAAM,SAAS,GAAI,CAA4B,CAAC,KAAK,CAAC;IACtD,OAAO,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5E,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,iBAAiB,GAAmD,MAAM,CAAC,MAAM,CAAC;IAC7F,GAAG,MAAM,CAAC,WAAW,CACnB,MAAM,CAAC,OAAO,CAAC,2CAAoB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;QACtD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,CAAC,CAAC,CACH;IACD,iBAAiB,EAAE,OAAO,CAAC,6BAA6B,CAAC,KAAK;IAC9D,aAAa,EAAE,OAAO,CAAC,yBAAyB,CAAC,KAAK;CACvD,CAAC,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,SAAgB,aAAa,CAC3B,IAAY,EACZ,WAAmB,EACnB,WAAmB,EACnB,OAA4F;IAM5F,yEAAyE;IACzE,wEAAwE;IACxE,uEAAuE;IACvE,8DAA8D;IAC9D,KAAK,IAAI,CAAC;IACV,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/schemas/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+GH,sCAgBC;AAQD,kDAYC;AAhJD,oEAAsD;AACtD,wEAAqE;AAGrE,6DAA2C;AAC3C,sEAAqE;AAA5D,4HAAA,oBAAoB,OAAA;AA0B7B,SAAS,OAAO,CAAmC,CAAgB;IACjE,MAAM,SAAS,GAAG,CAAC,EAAE,KAAK,CAAC;IAC3B,OAAO,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5E,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACU,QAAA,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7C,GAAG,MAAM,CAAC,WAAW,CACnB,MAAM,CAAC,OAAO,CAAC,2CAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,yBAAyB,CAAC,uEAAuE,CAClG,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,CAAC,EAAE,KAAK,CAAU,CAAC;IAC7B,CAAC,CAAC,CACH;IACD,iBAAiB,EAAE,OAAO,CAAC,6BAA6B,CAAC,KAAK;IAC9D,aAAa,EAAE,OAAO,CAAC,yBAAyB,CAAC,KAAK;IACtD,mBAAmB,EAAE,OAAO,CAAC,kCAAkC,CAAC,KAAK;CACtE,CAA8B,CAAC;AAEhC;;;;;;;GAOG;AACU,QAAA,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9C,GAAG,2CAAoB;IACvB,iBAAiB,EAAE,OAAO,CAAC,6BAA6B;IACxD,aAAa,EAAE,OAAO,CAAC,yBAAyB;IAChD,kBAAkB,EAAE,OAAO,CAAC,6BAA6B;IACzD,mBAAmB,EAAE,OAAO,CAAC,kCAAkC;CAChE,CAA+B,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,SAAgB,aAAa,CAC3B,IAAY,EACZ,WAAmB,EACnB,WAAmB,EACnB,OAA4F;IAM5F,yEAAyE;IACzE,wEAAwE;IACxE,uEAAuE;IACvE,8DAA8D;IAC9D,KAAK,IAAI,CAAC;IACV,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CACjC,IAAY,EACZ,WAAmB,EACnB,WAAoB,EACpB,OAAgF;IAMhF,KAAK,IAAI,CAAC;IACV,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC"}

package/dist/lib/schemas-data/v2.5/_provenance.json

@@ -4,5 +4,5 @@
   "source_sha": "4e553ad955f83b49c7d221ab5c3ff78237ad02e3",
   "source_tarball_sha256": "580656d6466ef9f0d1119985e6726c2efea718dc671e2ad30957fcb2fd54af0f",
   "upstream_adcp_version": "2.5.3",
-  "synced_at": "2026-05-24T02:00:56.766Z"
+  "synced_at": "2026-05-24T20:49:31.609Z"
 }

package/dist/lib/server/create-adcp-server.d.ts

@@ -58,6 +58,7 @@ import type { AcquireRightsAcquired, AcquireRightsPendingApproval, AcquireRights
 import type { GetProductsResponse, CreateMediaBuySuccess, CreateMediaBuyResponse, UpdateMediaBuySuccess, UpdateMediaBuyResponse, GetMediaBuysResponse, GetMediaBuyDeliveryResponse, ListAccountsResponse, ListCreativeFormatsResponse, ProvidePerformanceFeedbackSuccess, ProvidePerformanceFeedbackResponse, BuildCreativeSuccess, BuildCreativeMultiSuccess, BuildCreativeResponse, GetCreativeDeliveryResponse, ListCreativesResponse, SyncCreativesSuccess, SyncCreativesResponse, GetSignalsResponse, ActivateSignalSuccess, ActivateSignalResponse, GetAdCPCapabilitiesResponse, CreatePropertyListResponse, UpdatePropertyListResponse, GetPropertyListResponse, ListPropertyListsResponse, DeletePropertyListResponse, CreateCollectionListResponse, UpdateCollectionListResponse, GetCollectionListResponse, ListCollectionListsResponse, DeleteCollectionListResponse, SyncPlansResponse, CheckGovernanceResponse, ReportPlanOutcomeResponse, GetPlanAuditLogsResponse, SIGetOfferingResponse, SIInitiateSessionResponse, SISendMessageResponse, SITerminateSessionResponse, SyncEventSourcesSuccess, SyncEventSourcesResponse, LogEventSuccess, LogEventResponse, SyncAudiencesSuccess, SyncAudiencesResponse, SyncCatalogsSuccess, SyncCatalogsResponse, SyncAccountsSuccess, SyncAccountsResponse, SyncGovernanceSuccess, SyncGovernanceResponse, GetAccountFinancialsSuccess, GetAccountFinancialsResponse, GetCreativeFeaturesResponse, ReportUsageResponse, PreviewCreativeResponse, AccountReference, BrandReference, ListContentStandardsResponse, GetContentStandardsResponse, CreateContentStandardsResponse, UpdateContentStandardsResponse, CalibrateContentResponse, ValidateContentDeliveryResponse, GetMediaBuyArtifactsResponse } from '../types/tools.generated';
 import type { MediaBuyFeatures, AccountCapabilities, CreativeCapabilities } from '../utils/capabilities';
 import type { MediaChannel } from '../types/tools.generated';
+import type { ServerPayload } from '../types/server-payload';
 export interface AdcpLogger {
     debug(message: string, data?: Record<string, unknown>): void;
     info(message: string, data?: Record<string, unknown>): void;
@@ -186,267 +187,267 @@ export declare function requireSessionKey<TAccount = unknown>(ctx: HandlerContex
 export interface AdcpToolMap {
     get_products: {
         params: z.input<typeof GetProductsRequestSchema>;
-        result: GetProductsResponse;
+        result: ServerPayload<GetProductsResponse>;
         response: GetProductsResponse;
     };
     create_media_buy: {
         params: z.input<typeof CreateMediaBuyRequestSchema>;
-        result: CreateMediaBuySuccess;
+        result: ServerPayload<CreateMediaBuySuccess>;
         response: CreateMediaBuyResponse;
     };
     update_media_buy: {
         params: z.input<typeof UpdateMediaBuyRequestSchema>;
-        result: UpdateMediaBuySuccess;
+        result: ServerPayload<UpdateMediaBuySuccess>;
         response: UpdateMediaBuyResponse;
     };
     get_media_buys: {
         params: z.input<typeof GetMediaBuysRequestSchema>;
-        result: GetMediaBuysResponse;
+        result: ServerPayload<GetMediaBuysResponse>;
         response: GetMediaBuysResponse;
     };
     get_media_buy_delivery: {
         params: z.input<typeof GetMediaBuyDeliveryRequestSchema>;
-        result: GetMediaBuyDeliveryResponse;
+        result: ServerPayload<GetMediaBuyDeliveryResponse>;
         response: GetMediaBuyDeliveryResponse;
     };
     provide_performance_feedback: {
         params: z.input<typeof ProvidePerformanceFeedbackRequestSchema>;
-        result: ProvidePerformanceFeedbackSuccess;
+        result: ServerPayload<ProvidePerformanceFeedbackSuccess>;
         response: ProvidePerformanceFeedbackResponse;
     };
     list_creative_formats: {
         params: z.input<typeof ListCreativeFormatsRequestSchema>;
-        result: ListCreativeFormatsResponse;
+        result: ServerPayload<ListCreativeFormatsResponse>;
         response: ListCreativeFormatsResponse;
     };
     build_creative: {
         params: z.input<typeof BuildCreativeRequestSchema>;
-        result: BuildCreativeSuccess | BuildCreativeMultiSuccess;
+        result: ServerPayload<BuildCreativeSuccess> | ServerPayload<BuildCreativeMultiSuccess>;
         response: BuildCreativeResponse;
     };
     preview_creative: {
         params: z.input<typeof PreviewCreativeRequestSchema>;
-        result: PreviewCreativeResponse;
+        result: ServerPayload<PreviewCreativeResponse>;
         response: PreviewCreativeResponse;
     };
     get_creative_delivery: {
         params: z.input<typeof GetCreativeDeliveryRequestSchema>;
-        result: GetCreativeDeliveryResponse;
+        result: ServerPayload<GetCreativeDeliveryResponse>;
         response: GetCreativeDeliveryResponse;
     };
     list_creatives: {
         params: z.input<typeof ListCreativesRequestSchema>;
-        result: ListCreativesResponse;
+        result: ServerPayload<ListCreativesResponse>;
         response: ListCreativesResponse;
     };
     sync_creatives: {
         params: z.input<typeof SyncCreativesRequestSchema>;
-        result: SyncCreativesSuccess;
+        result: ServerPayload<SyncCreativesSuccess>;
         response: SyncCreativesResponse;
     };
     get_signals: {
         params: z.input<typeof GetSignalsRequestSchema>;
-        result: GetSignalsResponse;
+        result: ServerPayload<GetSignalsResponse>;
         response: GetSignalsResponse;
     };
     activate_signal: {
         params: z.input<typeof ActivateSignalRequestSchema>;
-        result: ActivateSignalSuccess;
+        result: ServerPayload<ActivateSignalSuccess>;
         response: ActivateSignalResponse;
     };
     list_accounts: {
         params: z.input<typeof ListAccountsRequestSchema>;
-        result: ListAccountsResponse;
+        result: ServerPayload<ListAccountsResponse>;
         response: ListAccountsResponse;
     };
     sync_accounts: {
         params: z.input<typeof SyncAccountsRequestSchema>;
-        result: SyncAccountsSuccess;
+        result: ServerPayload<SyncAccountsSuccess>;
         response: SyncAccountsResponse;
     };
     sync_governance: {
         params: z.input<typeof SyncGovernanceRequestSchema>;
-        result: SyncGovernanceSuccess;
+        result: ServerPayload<SyncGovernanceSuccess>;
         response: SyncGovernanceResponse;
     };
     get_account_financials: {
         params: z.input<typeof GetAccountFinancialsRequestSchema>;
-        result: GetAccountFinancialsSuccess;
+        result: ServerPayload<GetAccountFinancialsSuccess>;
         response: GetAccountFinancialsResponse;
     };
     report_usage: {
         params: z.input<typeof ReportUsageRequestSchema>;
-        result: ReportUsageResponse;
+        result: ServerPayload<ReportUsageResponse>;
         response: ReportUsageResponse;
     };
     sync_event_sources: {
         params: z.input<typeof SyncEventSourcesRequestSchema>;
-        result: SyncEventSourcesSuccess;
+        result: ServerPayload<SyncEventSourcesSuccess>;
         response: SyncEventSourcesResponse;
     };
     log_event: {
         params: z.input<typeof LogEventRequestSchema>;
-        result: LogEventSuccess;
+        result: ServerPayload<LogEventSuccess>;
         response: LogEventResponse;
     };
     sync_audiences: {
         params: z.input<typeof SyncAudiencesRequestSchema>;
-        result: SyncAudiencesSuccess;
+        result: ServerPayload<SyncAudiencesSuccess>;
         response: SyncAudiencesResponse;
     };
     sync_catalogs: {
         params: z.input<typeof SyncCatalogsRequestSchema>;
-        result: SyncCatalogsSuccess;
+        result: ServerPayload<SyncCatalogsSuccess>;
         response: SyncCatalogsResponse;
     };
     create_property_list: {
         params: z.input<typeof CreatePropertyListRequestSchema>;
-        result: CreatePropertyListResponse;
+        result: ServerPayload<CreatePropertyListResponse>;
         response: CreatePropertyListResponse;
     };
     update_property_list: {
         params: z.input<typeof UpdatePropertyListRequestSchema>;
-        result: UpdatePropertyListResponse;
+        result: ServerPayload<UpdatePropertyListResponse>;
         response: UpdatePropertyListResponse;
     };
     get_property_list: {
         params: z.input<typeof GetPropertyListRequestSchema>;
-        result: GetPropertyListResponse;
+        result: ServerPayload<GetPropertyListResponse>;
         response: GetPropertyListResponse;
     };
     list_property_lists: {
         params: z.input<typeof ListPropertyListsRequestSchema>;
-        result: ListPropertyListsResponse;
+        result: ServerPayload<ListPropertyListsResponse>;
         response: ListPropertyListsResponse;
     };
     delete_property_list: {
         params: z.input<typeof DeletePropertyListRequestSchema>;
-        result: DeletePropertyListResponse;
+        result: ServerPayload<DeletePropertyListResponse>;
         response: DeletePropertyListResponse;
     };
     create_collection_list: {
         params: z.input<typeof CreateCollectionListRequestSchema>;
-        result: CreateCollectionListResponse;
+        result: ServerPayload<CreateCollectionListResponse>;
         response: CreateCollectionListResponse;
     };
     update_collection_list: {
         params: z.input<typeof UpdateCollectionListRequestSchema>;
-        result: UpdateCollectionListResponse;
+        result: ServerPayload<UpdateCollectionListResponse>;
         response: UpdateCollectionListResponse;
     };
     get_collection_list: {
         params: z.input<typeof GetCollectionListRequestSchema>;
-        result: GetCollectionListResponse;
+        result: ServerPayload<GetCollectionListResponse>;
         response: GetCollectionListResponse;
     };
     list_collection_lists: {
         params: z.input<typeof ListCollectionListsRequestSchema>;
-        result: ListCollectionListsResponse;
+        result: ServerPayload<ListCollectionListsResponse>;
         response: ListCollectionListsResponse;
     };
     delete_collection_list: {
         params: z.input<typeof DeleteCollectionListRequestSchema>;
-        result: DeleteCollectionListResponse;
+        result: ServerPayload<DeleteCollectionListResponse>;
         response: DeleteCollectionListResponse;
     };
     list_content_standards: {
         params: z.input<typeof ListContentStandardsRequestSchema>;
-        result: ListContentStandardsResponse;
+        result: ServerPayload<ListContentStandardsResponse>;
         response: ListContentStandardsResponse;
     };
     get_content_standards: {
         params: z.input<typeof GetContentStandardsRequestSchema>;
-        result: GetContentStandardsResponse;
+        result: ServerPayload<GetContentStandardsResponse>;
         response: GetContentStandardsResponse;
     };
     create_content_standards: {
         params: z.input<typeof CreateContentStandardsRequestSchema>;
-        result: CreateContentStandardsResponse;
+        result: ServerPayload<CreateContentStandardsResponse>;
         response: CreateContentStandardsResponse;
     };
     update_content_standards: {
         params: z.input<typeof UpdateContentStandardsRequestSchema>;
-        result: UpdateContentStandardsResponse;
+        result: ServerPayload<UpdateContentStandardsResponse>;
         response: UpdateContentStandardsResponse;
     };
     calibrate_content: {
         params: z.input<typeof CalibrateContentRequestSchema>;
-        result: CalibrateContentResponse;
+        result: ServerPayload<CalibrateContentResponse>;
         response: CalibrateContentResponse;
     };
     validate_content_delivery: {
         params: z.input<typeof ValidateContentDeliveryRequestSchema>;
-        result: ValidateContentDeliveryResponse;
+        result: ServerPayload<ValidateContentDeliveryResponse>;
         response: ValidateContentDeliveryResponse;
     };
     get_media_buy_artifacts: {
         params: z.input<typeof GetMediaBuyArtifactsRequestSchema>;
-        result: GetMediaBuyArtifactsResponse;
+        result: ServerPayload<GetMediaBuyArtifactsResponse>;
         response: GetMediaBuyArtifactsResponse;
     };
     get_creative_features: {
         params: z.input<typeof GetCreativeFeaturesRequestSchema>;
-        result: GetCreativeFeaturesResponse;
+        result: ServerPayload<GetCreativeFeaturesResponse>;
         response: GetCreativeFeaturesResponse;
     };
     sync_plans: {
         params: z.input<typeof SyncPlansRequestSchema>;
-        result: SyncPlansResponse;
+        result: ServerPayload<SyncPlansResponse>;
         response: SyncPlansResponse;
     };
     check_governance: {
         params: z.input<typeof CheckGovernanceRequestSchema>;
-        result: CheckGovernanceResponse;
+        result: ServerPayload<CheckGovernanceResponse>;
         response: CheckGovernanceResponse;
     };
     report_plan_outcome: {
         params: z.input<typeof ReportPlanOutcomeRequestSchema>;
-        result: ReportPlanOutcomeResponse;
+        result: ServerPayload<ReportPlanOutcomeResponse>;
         response: ReportPlanOutcomeResponse;
     };
     get_plan_audit_logs: {
         params: z.input<typeof GetPlanAuditLogsRequestSchema>;
-        result: GetPlanAuditLogsResponse;
+        result: ServerPayload<GetPlanAuditLogsResponse>;
         response: GetPlanAuditLogsResponse;
     };
     si_get_offering: {
         params: z.input<typeof SIGetOfferingRequestSchema>;
-        result: SIGetOfferingResponse;
+        result: ServerPayload<SIGetOfferingResponse>;
         response: SIGetOfferingResponse;
     };
     si_initiate_session: {
         params: z.input<typeof SIInitiateSessionRequestSchema>;
-        result: SIInitiateSessionResponse;
+        result: ServerPayload<SIInitiateSessionResponse>;
         response: SIInitiateSessionResponse;
     };
     si_send_message: {
         params: z.input<typeof SISendMessageRequestSchema>;
-        result: SISendMessageResponse;
+        result: ServerPayload<SISendMessageResponse>;
         response: SISendMessageResponse;
     };
     si_terminate_session: {
         params: z.input<typeof SITerminateSessionRequestSchema>;
-        result: SITerminateSessionResponse;
+        result: ServerPayload<SITerminateSessionResponse>;
         response: SITerminateSessionResponse;
     };
     get_brand_identity: {
         params: z.input<typeof GetBrandIdentityRequestSchema>;
-        result: GetBrandIdentitySuccess;
+        result: ServerPayload<GetBrandIdentitySuccess>;
         response: GetBrandIdentitySuccess;
     };
     get_rights: {
         params: z.input<typeof GetRightsRequestSchema>;
-        result: GetRightsSuccess;
+        result: ServerPayload<GetRightsSuccess>;
         response: GetRightsSuccess;
     };
     acquire_rights: {
         params: z.input<typeof AcquireRightsRequestSchema>;
-        result: AcquireRightsAcquired | AcquireRightsPendingApproval | AcquireRightsRejected;
+        result: ServerPayload<AcquireRightsAcquired> | ServerPayload<AcquireRightsPendingApproval> | ServerPayload<AcquireRightsRejected>;
         response: AcquireRightsAcquired | AcquireRightsPendingApproval | AcquireRightsRejected;
     };
     update_rights: {
         params: z.input<typeof UpdateRightsRequestSchema>;
-        result: UpdateRightsSuccess;
+        result: ServerPayload<UpdateRightsSuccess>;
         response: UpdateRightsResponse;
     };
 }