@adcp/sdk 5.25.1 → 6.1.0

package/dist/lib/server/pick-safe-details.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * Security primitive for the `details` field on `AdcpError` and the
+ * `Error` wire row. Adopters fronting upstream platforms (GAM, Snap,
+ * retail-media APIs, internal billing systems) often want to surface
+ * upstream error context to buyers — but raw upstream errors carry
+ * credentials, PII, internal stack traces, request IDs that leak
+ * tenant identity, and other liability surfaces that MUST NOT cross
+ * the wire boundary.
+ *
+ * `pickSafeDetails(input, allowlist, opts?)` is an explicit-allowlist
+ * sanitizer: only keys in the allowlist survive, with optional caps
+ * on depth and serialized size. Returns `undefined` when the input is
+ * not a plain object or the allowlist filter produces an empty
+ * result, so callers can spread the return into an optional `details`
+ * field without polluting it with `{}`.
+ *
+ * Adopters should call this BEFORE constructing the `AdcpError` /
+ * wire `Error` row. The framework's `normalizeError` does NOT
+ * sanitize details — it shallow-copies whatever was passed.
+ *
+ * @example
+ * ```ts
+ * import { pickSafeDetails } from '@adcp/client/server';
+ *
+ * try {
+ *   await gamClient.createOrder(req);
+ * } catch (upstreamErr) {
+ *   throw new AdcpError('UPSTREAM_REJECTED', {
+ *     recovery: 'transient',
+ *     message: 'Ad server rejected the order',
+ *     // Allowlist: only safe upstream fields cross the wire
+ *     details: pickSafeDetails(upstreamErr, [
+ *       'http_status',
+ *       'request_id',
+ *       'gam_error_code',
+ *     ]),
+ *   });
+ * }
+ * ```
+ *
+ * @public
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pickSafeDetails = pickSafeDetails;
+const DEFAULT_OPTIONS = {
+    maxDepth: 2,
+    maxSizeBytes: 2048,
+};
+/**
+ * Filter `input` to keys named in `allowlist`, depth-capped and
+ * size-capped. Returns `undefined` when the result is empty or
+ * exceeds the size cap so callers can spread the value into an
+ * optional `details` field without polluting it.
+ *
+ * Properties NOT in the allowlist are dropped silently (no warning;
+ * the design assumes the allowlist is the contract). Nested objects
+ * are recursively filtered with the SAME allowlist — there is no
+ * per-key allowlist for nested fields. Adopters who need per-level
+ * filtering should call `pickSafeDetails` recursively on each
+ * nested value.
+ *
+ * Common-sense behaviors:
+ *   - `null` / `undefined` / non-object input → `undefined`
+ *   - Empty result after filtering → `undefined`
+ *   - Arrays at the top level → `undefined` (use a wrapping object)
+ *   - Functions and Symbols are dropped
+ *   - Date / RegExp / Error / Map / Set are dropped (use a string
+ *     allowlist of primitive fields, or pre-shape the input)
+ *
+ * @public
+ */
+function pickSafeDetails(input, allowlist, opts) {
+    if (!isPlainObject(input))
+        return undefined;
+    if (allowlist.length === 0)
+        return undefined;
+    const maxDepth = opts?.maxDepth ?? DEFAULT_OPTIONS.maxDepth;
+    const maxSize = opts?.maxSizeBytes ?? DEFAULT_OPTIONS.maxSizeBytes;
+    const allowSet = new Set(allowlist);
+    const result = filterByAllowlist(input, allowSet, maxDepth);
+    if (result == null || Object.keys(result).length === 0)
+        return undefined;
+    // Size cap. Use JSON.stringify length as a UTF-8-ish proxy.
+    // Adopters who need exact byte counting should sanitize ahead of
+    // pickSafeDetails.
+    let serialized;
+    try {
+        serialized = JSON.stringify(result);
+    }
+    catch {
+        // Circular reference snuck through (shouldn't happen for plain
+        // objects but defensive). Return undefined rather than half-data.
+        return undefined;
+    }
+    if (serialized.length > maxSize)
+        return undefined;
+    return result;
+}
+function filterByAllowlist(obj, allow, remainingDepth) {
+    const out = {};
+    for (const key of Object.keys(obj)) {
+        if (!allow.has(key))
+            continue;
+        const value = obj[key];
+        const safe = sanitizeValue(value, allow, remainingDepth - 1);
+        // Drop undefined results so the caller sees only present keys.
+        if (safe !== undefined)
+            out[key] = safe;
+    }
+    return Object.keys(out).length === 0 ? null : out;
+}
+function sanitizeValue(value, allow, remainingDepth) {
+    // Primitives pass through.
+    if (value === null)
+        return null;
+    const t = typeof value;
+    if (t === 'string' || t === 'number' || t === 'boolean')
+        return value;
+    if (t === 'function' || t === 'symbol' || t === 'undefined' || t === 'bigint')
+        return undefined;
+    if (Array.isArray(value)) {
+        // Arrays don't count as a depth level — only plain objects do.
+        // Pass items through with the SAME remainingDepth so an array-of-
+        // objects gets the same nesting budget as a bare object would.
+        const mapped = value.map(v => sanitizeValue(v, allow, remainingDepth));
+        return mapped.filter(v => v !== undefined);
+    }
+    if (isPlainObject(value)) {
+        if (remainingDepth <= 0)
+            return undefined;
+        const filtered = filterByAllowlist(value, allow, remainingDepth);
+        return filtered ?? undefined;
+    }
+    // Date / RegExp / Map / Set / Error / class instances — drop.
+    // Adopters who need these should pre-shape into primitives.
+    return undefined;
+}
+function isPlainObject(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    if (Array.isArray(value))
+        return false;
+    // Only plain objects (not Date, RegExp, Map, Set, class instances).
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+//# sourceMappingURL=pick-safe-details.js.map

package/dist/lib/server/pick-safe-details.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick-safe-details.js","sourceRoot":"","sources":["../../../src/lib/server/pick-safe-details.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;;AAuDH,0CA6BC;AAzDD,MAAM,eAAe,GAAqC;IACxD,QAAQ,EAAE,CAAC;IACX,YAAY,EAAE,IAAI;CACnB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,eAAe,CAC7B,KAAc,EACd,SAA4B,EAC5B,IAA6B;IAE7B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE7C,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,eAAe,CAAC,QAAQ,CAAC;IAC5D,MAAM,OAAO,GAAG,IAAI,EAAE,YAAY,IAAI,eAAe,CAAC,YAAY,CAAC;IACnE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAEpC,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC5D,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAEzE,4DAA4D;IAC5D,iEAAiE;IACjE,mBAAmB;IACnB,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,+DAA+D;QAC/D,kEAAkE;QAClE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,OAAO;QAAE,OAAO,SAAS,CAAC;IAElD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,iBAAiB,CACxB,GAA4B,EAC5B,KAA0B,EAC1B,cAAsB;IAEtB,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC9B,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,cAAc,GAAG,CAAC,CAAC,CAAC;QAC7D,+DAA+D;QAC/D,IAAI,IAAI,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAC1C,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;AACpD,CAAC;AAED,SAAS,aAAa,CAAC,KAAc,EAAE,KAA0B,EAAE,cAAsB;IACvF,2BAA2B;IAC3B,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,CAAC,GAAG,OAAO,KAAK,CAAC;IACvB,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtE,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhG,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,+DAA+D;QAC/D,kEAAkE;QAClE,+DAA+D;QAC/D,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;QACvE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,cAAc,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QAC1C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;QACjE,OAAO,QAAQ,IAAI,SAAS,CAAC;IAC/B,CAAC;IAED,8DAA8D;IAC9D,4DAA4D;IAC5D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,oEAAoE;IACpE,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AACtD,CAAC"}

package/dist/lib/server/postgres-state-store.d.ts

@@ -9,7 +9,7 @@
  * @example
  * ```typescript
  * import { Pool } from 'pg';
- * import { PostgresStateStore, createAdcpServer, serve } from '@adcp/sdk';
+ * import { PostgresStateStore, createAdcpServer, serve } from '@adcp/sdk/server/legacy/v5';
  *
  * const pool = new Pool({ connectionString: process.env.DATABASE_URL });
  * const stateStore = new PostgresStateStore(pool);

package/dist/lib/server/postgres-state-store.js

@@ -10,7 +10,7 @@
  * @example
  * ```typescript
  * import { Pool } from 'pg';
- * import { PostgresStateStore, createAdcpServer, serve } from '@adcp/sdk';
+ * import { PostgresStateStore, createAdcpServer, serve } from '@adcp/sdk/server/legacy/v5';
  *
  * const pool = new Pool({ connectionString: process.env.DATABASE_URL });
  * const stateStore = new PostgresStateStore(pool);

package/dist/lib/server/responses.d.ts

@@ -1,6 +1,15 @@
 /**
  * Typed response builders for AdCP MCP servers.
  *
+ * @deprecated For new code, use `createAdcpServerFromPlatform` from
+ * `@adcp/sdk/server` instead — it constructs wire responses internally
+ * from your typed `DecisioningPlatform` return values, so adopters don't
+ * touch these builders. The functions below remain exported for v5
+ * adopters wiring raw MCP tool handlers (mid-migration), and for adopters
+ * shaping bespoke tools the platform interface doesn't yet model. For new
+ * v6 adopters, ignore this whole module — the framework handles wire
+ * shaping.
+ *
  * Each function takes typed data (compile-time checked against AdCP schemas)
  * and returns an MCP-compatible tool response with `content` (text summary)
  * + `structuredContent` (typed payload).
@@ -62,10 +71,12 @@ export declare function toStructuredContent(data: object): Record<string, unknow
  * `supported_protocols` lists AdCP domain protocols (media_buy, signals, governance, etc.),
  * NOT transport protocols (mcp, a2a).
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function capabilitiesResponse(data: GetAdCPCapabilitiesResponse, summary?: string): McpToolResponse;
 /**
  * Build a get_products response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function productsResponse(data: GetProductsResponse, summary?: string): McpToolResponse;
 /**
  * Build a successful create_media_buy response.
@@ -76,18 +87,22 @@ export declare function productsResponse(data: GetProductsResponse, summary?: st
  * - `valid_actions` populated from status via `validActionsForStatus()` when
  *   `status` is provided but `valid_actions` is not
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function mediaBuyResponse(data: CreateMediaBuySuccess, summary?: string): McpToolResponse;
 /**
  * Build a get_media_buy_delivery response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function deliveryResponse(data: GetMediaBuyDeliveryResponse, summary?: string): McpToolResponse;
 /**
  * Build a list_accounts response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function listAccountsResponse(data: ListAccountsResponse, summary?: string): McpToolResponse;
 /**
  * Build a list_creative_formats response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function listCreativeFormatsResponse(data: ListCreativeFormatsResponse, summary?: string): McpToolResponse;
 /**
  * Build a successful update_media_buy response.
@@ -95,34 +110,42 @@ export declare function listCreativeFormatsResponse(data: ListCreativeFormatsRes
  * When `status` is provided but `valid_actions` is not, auto-populates
  * `valid_actions` from `validActionsForStatus()`.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function updateMediaBuyResponse(data: UpdateMediaBuySuccess, summary?: string): McpToolResponse;
 /**
  * Build a get_media_buys response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function getMediaBuysResponse(data: GetMediaBuysResponse, summary?: string): McpToolResponse;
 /**
  * Build a successful provide_performance_feedback response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function performanceFeedbackResponse(data: ProvidePerformanceFeedbackSuccess, summary?: string): McpToolResponse;
 /**
  * Build a successful build_creative response (single format).
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function buildCreativeResponse(data: BuildCreativeSuccess, summary?: string): McpToolResponse;
 /**
  * Build a successful build_creative response (multi-format).
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function buildCreativeMultiResponse(data: BuildCreativeMultiSuccess, summary?: string): McpToolResponse;
 /**
  * Build a preview_creative response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function previewCreativeResponse(data: PreviewCreativeSingleResponse | PreviewCreativeBatchResponse | PreviewCreativeVariantResponse, summary?: string): McpToolResponse;
 /**
  * Build a get_creative_delivery response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function creativeDeliveryResponse(data: GetCreativeDeliveryResponse, summary?: string): McpToolResponse;
 /**
  * Build a list_creatives response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function listCreativesResponse(data: ListCreativesResponse, summary?: string): McpToolResponse;
 /**
  * Build a list_property_lists response. The governance property-list catalog
@@ -130,12 +153,14 @@ export declare function listCreativesResponse(data: ListCreativesResponse, summa
  * handlers can't accidentally emit a bare array at the top level (which the
  * storyboard runner flags as shape drift).
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function listPropertyListsResponse(data: ListPropertyListsResponse, summary?: string): McpToolResponse;
 /**
  * Build a list_collection_lists response. Companion to
  * `listPropertyListsResponse` — same `lists` wrapper shape; parallel
  * governance surface for program-level collections.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function listCollectionListsResponse(data: ListCollectionListsResponse, summary?: string): McpToolResponse;
 /**
  * Build a list_content_standards response. The response type is a union
@@ -149,24 +174,29 @@ export declare function listCollectionListsResponse(data: ListCollectionListsRes
  * `standards` is absent. Mirrors `acquireRightsResponse`'s success-first
  * discrimination pattern a few screens down.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function listContentStandardsResponse(data: ListContentStandardsResponse, summary?: string): McpToolResponse;
 /**
  * Build a get_plan_audit_logs response. Wraps the audit data array under
  * the required `plans` key — handlers that return a bare array trip the
  * storyboard runner's shape-drift hint.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function getPlanAuditLogsResponse(data: GetPlanAuditLogsResponse, summary?: string): McpToolResponse;
 /**
  * Build a successful sync_creatives response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function syncCreativesResponse(data: SyncCreativesSuccess, summary?: string): McpToolResponse;
 /**
  * Build a get_signals response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function getSignalsResponse(data: GetSignalsResponse, summary?: string): McpToolResponse;
 /**
  * Build a successful activate_signal response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function activateSignalResponse(data: ActivateSignalSuccess, summary?: string): McpToolResponse;
 /**
  * Build a cancel response for update_media_buy with action: 'cancel'.
@@ -197,6 +227,7 @@ export declare function activateSignalResponse(data: ActivateSignalSuccess, summ
  * );
  * ```
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function cancelMediaBuyResponse(input: CancelMediaBuyInput, summary?: string): McpToolResponse;
 /**
  * Build an `acquire_rights` response. Thin envelope wrapper — enforces the
@@ -209,6 +240,7 @@ export declare function cancelMediaBuyResponse(input: CancelMediaBuyInput, summa
  * `createAdcpServer({ validation: { responses: 'strict' } })` until it
  * becomes the default.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function acquireRightsResponse(data: AcquireRightsResponse, summary?: string): McpToolResponse;
 /**
  * Per-variant constructor — builds an `AcquireRightsAcquired` success response
@@ -216,20 +248,25 @@ export declare function acquireRightsResponse(data: AcquireRightsResponse, summa
  * because a coding agent typing `acquireRightsAcqu…` gets the required-fields
  * shape directly without reading a 4-variant union.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function acquireRightsAcquired(data: Omit<AcquireRightsAcquired, 'status'>, summary?: string): McpToolResponse;
 /** Per-variant constructor for the `pending_approval` branch. */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function acquireRightsPendingApproval(data: Omit<AcquireRightsPendingApproval, 'status'>, summary?: string): McpToolResponse;
 /** Per-variant constructor for the `rejected` branch. */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function acquireRightsRejected(data: Omit<AcquireRightsRejected, 'status'>, summary?: string): McpToolResponse;
 /**
  * Build a `sync_accounts` response. Thin envelope wrapper accepting the full
  * `SyncAccountsResponse` union; error payloads pass through.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function syncAccountsResponse(data: SyncAccountsResponse, summary?: string): McpToolResponse;
 /**
  * Build a sync_governance response. The spec permits two top-level shapes
  * (success / error); the type union enforces discrimination on `status`.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function syncGovernanceResponse(data: SyncGovernanceResponse, summary?: string): McpToolResponse;
 /**
  * Build a `report_usage` response. Thin envelope wrapper. Schema-level
@@ -247,6 +284,7 @@ export declare function syncGovernanceResponse(data: SyncGovernanceResponse, sum
  * reportUsage: async (params) => reportUsageResponse.acceptAll(params)
  * ```
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 export declare function reportUsageResponse(data: ReportUsageResponse, summary?: string): McpToolResponse;
 export declare namespace reportUsageResponse {
     var acceptAll: (request: ReportUsageRequest, opts?: {

package/dist/lib/server/responses.d.ts.map

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

package/dist/lib/server/responses.js

@@ -2,6 +2,15 @@
 /**
  * Typed response builders for AdCP MCP servers.
  *
+ * @deprecated For new code, use `createAdcpServerFromPlatform` from
+ * `@adcp/sdk/server` instead — it constructs wire responses internally
+ * from your typed `DecisioningPlatform` return values, so adopters don't
+ * touch these builders. The functions below remain exported for v5
+ * adopters wiring raw MCP tool handlers (mid-migration), and for adopters
+ * shaping bespoke tools the platform interface doesn't yet model. For new
+ * v6 adopters, ignore this whole module — the framework handles wire
+ * shaping.
+ *
  * Each function takes typed data (compile-time checked against AdCP schemas)
  * and returns an MCP-compatible tool response with `content` (text summary)
  * + `structuredContent` (typed payload).
@@ -86,6 +95,7 @@ function assertNoTopLevelSetup(data, builder) {
  * `supported_protocols` lists AdCP domain protocols (media_buy, signals, governance, etc.),
  * NOT transport protocols (mcp, a2a).
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function capabilitiesResponse(data, summary) {
     return {
         content: [{ type: 'text', text: summary ?? 'Agent capabilities retrieved' }],
@@ -95,6 +105,7 @@ function capabilitiesResponse(data, summary) {
 /**
  * Build a get_products response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function productsResponse(data, summary) {
     return {
         content: [{ type: 'text', text: summary ?? `Found ${data.products.length} products` }],
@@ -110,6 +121,7 @@ function productsResponse(data, summary) {
  * - `valid_actions` populated from status via `validActionsForStatus()` when
  *   `status` is provided but `valid_actions` is not
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function mediaBuyResponse(data, summary) {
     assertNoTopLevelSetup(data, 'mediaBuyResponse');
     const withDefaults = { ...data };
@@ -130,6 +142,7 @@ function mediaBuyResponse(data, summary) {
 /**
  * Build a get_media_buy_delivery response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function deliveryResponse(data, summary) {
     return {
         content: [
@@ -145,6 +158,7 @@ function deliveryResponse(data, summary) {
 /**
  * Build a list_accounts response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function listAccountsResponse(data, summary) {
     return {
         content: [{ type: 'text', text: summary ?? `Found ${data.accounts.length} accounts` }],
@@ -154,6 +168,7 @@ function listAccountsResponse(data, summary) {
 /**
  * Build a list_creative_formats response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function listCreativeFormatsResponse(data, summary) {
     return {
         content: [{ type: 'text', text: summary ?? `Found ${data.formats.length} creative formats` }],
@@ -166,6 +181,7 @@ function listCreativeFormatsResponse(data, summary) {
  * When `status` is provided but `valid_actions` is not, auto-populates
  * `valid_actions` from `validActionsForStatus()`.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function updateMediaBuyResponse(data, summary) {
     assertNoTopLevelSetup(data, 'updateMediaBuyResponse');
     const withDefaults = { ...data };
@@ -180,6 +196,7 @@ function updateMediaBuyResponse(data, summary) {
 /**
  * Build a get_media_buys response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function getMediaBuysResponse(data, summary) {
     if (Array.isArray(data.media_buys)) {
         for (const buy of data.media_buys) {
@@ -199,6 +216,7 @@ function getMediaBuysResponse(data, summary) {
 /**
  * Build a successful provide_performance_feedback response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function performanceFeedbackResponse(data, summary) {
     return {
         content: [{ type: 'text', text: summary ?? 'Performance feedback accepted' }],
@@ -208,6 +226,7 @@ function performanceFeedbackResponse(data, summary) {
 /**
  * Build a successful build_creative response (single format).
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function buildCreativeResponse(data, summary) {
     // Optional-chain the default summary — handler responses that drop
     // `format_id` still reach the wire-level schema validator (which names
@@ -222,6 +241,7 @@ function buildCreativeResponse(data, summary) {
 /**
  * Build a successful build_creative response (multi-format).
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function buildCreativeMultiResponse(data, summary) {
     const count = data.creative_manifests?.length ?? 0;
     return {
@@ -232,6 +252,7 @@ function buildCreativeMultiResponse(data, summary) {
 /**
  * Build a preview_creative response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function previewCreativeResponse(data, summary) {
     const defaultSummary = data.response_type === 'single'
         ? (() => {
@@ -252,6 +273,7 @@ function previewCreativeResponse(data, summary) {
 /**
  * Build a get_creative_delivery response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function creativeDeliveryResponse(data, summary) {
     return {
         content: [{ type: 'text', text: summary ?? `Creative delivery data for ${data.currency} report` }],
@@ -261,6 +283,7 @@ function creativeDeliveryResponse(data, summary) {
 /**
  * Build a list_creatives response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function listCreativesResponse(data, summary) {
     return {
         content: [
@@ -278,6 +301,7 @@ function listCreativesResponse(data, summary) {
  * handlers can't accidentally emit a bare array at the top level (which the
  * storyboard runner flags as shape drift).
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function listPropertyListsResponse(data, summary) {
     return {
         content: [
@@ -294,6 +318,7 @@ function listPropertyListsResponse(data, summary) {
  * `listPropertyListsResponse` — same `lists` wrapper shape; parallel
  * governance surface for program-level collections.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function listCollectionListsResponse(data, summary) {
     return {
         content: [
@@ -317,6 +342,7 @@ function listCollectionListsResponse(data, summary) {
  * `standards` is absent. Mirrors `acquireRightsResponse`'s success-first
  * discrimination pattern a few screens down.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function listContentStandardsResponse(data, summary) {
     const defaultSummary = 'standards' in data
         ? `Found ${data.standards.length} content standard${data.standards.length === 1 ? '' : 's'}`
@@ -331,6 +357,7 @@ function listContentStandardsResponse(data, summary) {
  * the required `plans` key — handlers that return a bare array trip the
  * storyboard runner's shape-drift hint.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function getPlanAuditLogsResponse(data, summary) {
     return {
         content: [
@@ -345,6 +372,7 @@ function getPlanAuditLogsResponse(data, summary) {
 /**
  * Build a successful sync_creatives response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function syncCreativesResponse(data, summary) {
     return {
         content: [
@@ -359,6 +387,7 @@ function syncCreativesResponse(data, summary) {
 /**
  * Build a get_signals response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function getSignalsResponse(data, summary) {
     return {
         content: [
@@ -370,6 +399,7 @@ function getSignalsResponse(data, summary) {
 /**
  * Build a successful activate_signal response.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function activateSignalResponse(data, summary) {
     return {
         content: [
@@ -411,6 +441,7 @@ function activateSignalResponse(data, summary) {
  * );
  * ```
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function cancelMediaBuyResponse(input, summary) {
     const cancellation = {
         canceled_at: input.canceled_at ?? new Date().toISOString(),
@@ -448,6 +479,7 @@ function cancelMediaBuyResponse(input, summary) {
  * `createAdcpServer({ validation: { responses: 'strict' } })` until it
  * becomes the default.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function acquireRightsResponse(data, summary) {
     const defaultSummary = 'errors' in data
         ? 'Rights acquisition error'
@@ -467,14 +499,17 @@ function acquireRightsResponse(data, summary) {
  * because a coding agent typing `acquireRightsAcqu…` gets the required-fields
  * shape directly without reading a 4-variant union.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function acquireRightsAcquired(data, summary) {
     return acquireRightsResponse({ ...data, status: 'acquired' }, summary);
 }
 /** Per-variant constructor for the `pending_approval` branch. */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function acquireRightsPendingApproval(data, summary) {
     return acquireRightsResponse({ ...data, status: 'pending_approval' }, summary);
 }
 /** Per-variant constructor for the `rejected` branch. */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function acquireRightsRejected(data, summary) {
     return acquireRightsResponse({ ...data, status: 'rejected' }, summary);
 }
@@ -482,6 +517,7 @@ function acquireRightsRejected(data, summary) {
  * Build a `sync_accounts` response. Thin envelope wrapper accepting the full
  * `SyncAccountsResponse` union; error payloads pass through.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function syncAccountsResponse(data, summary) {
     const defaultSummary = 'errors' in data
         ? 'Account sync error'
@@ -495,6 +531,7 @@ function syncAccountsResponse(data, summary) {
  * Build a sync_governance response. The spec permits two top-level shapes
  * (success / error); the type union enforces discrimination on `status`.
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function syncGovernanceResponse(data, summary) {
     return {
         content: [{ type: 'text', text: summary ?? 'Governance registration synced' }],
@@ -517,6 +554,7 @@ function syncGovernanceResponse(data, summary) {
  * reportUsage: async (params) => reportUsageResponse.acceptAll(params)
  * ```
  */
+/** @deprecated v6: `createAdcpServerFromPlatform` constructs wire responses from typed platform returns. Direct use is for v5 raw-handler adopters mid-migration only. */
 function reportUsageResponse(data, summary) {
     return {
         content: [