@adcp/sdk 5.23.0

package/dist/lib/utils/request-normalizer.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * Request parameter normalization for backward compatibility.
+ *
+ * Converts deprecated field names and shapes so callers written against
+ * earlier schema versions keep working. Each conversion emits a one-time
+ * deprecation warning via warnOnce().
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePackageParams = normalizePackageParams;
+exports.normalizeRequestParams = normalizeRequestParams;
+const compat_1 = require("../types/compat");
+const deprecation_1 = require("./deprecation");
+const idempotency_1 = require("./idempotency");
+/**
+ * Normalize a single package's params for backward compatibility.
+ *
+ * Handles:
+ * - context.buyer_ref → buyer_ref (pre-4.15 servers require top-level buyer_ref)
+ * - optimization_goal (scalar) → optimization_goals (array)
+ * - catalog (scalar object) → catalogs (array)
+ */
+function normalizePackageParams(pkg) {
+    if (!pkg || typeof pkg !== 'object')
+        return pkg;
+    const normalized = { ...pkg };
+    // context.buyer_ref → buyer_ref (backward compat for pre-4.15 AdCP servers)
+    // AdCP 4.15 moved buyer_ref into context, but older servers still require it
+    // at the top level. Copy it back so requests validate on both old and new servers.
+    if (normalized.context?.buyer_ref && !normalized.buyer_ref) {
+        normalized.buyer_ref = normalized.context.buyer_ref;
+    }
+    // optimization_goal (scalar) → optimization_goals (array)
+    if (normalized.optimization_goal && !normalized.optimization_goals?.length) {
+        (0, deprecation_1.warnOnce)('optimization_goal', 'PackageRequest.optimization_goal is deprecated. Use optimization_goals (array) instead.');
+        normalized.optimization_goals = [normalized.optimization_goal];
+    }
+    delete normalized.optimization_goal;
+    // catalog (scalar) → catalogs (array)
+    if (normalized.catalog && !normalized.catalogs?.length) {
+        (0, deprecation_1.warnOnce)('catalog', 'PackageRequest.catalog is deprecated. Use catalogs (array) instead.');
+        normalized.catalogs = [normalized.catalog];
+    }
+    delete normalized.catalog;
+    return normalized;
+}
+/**
+ * Normalize request params for backward compatibility.
+ *
+ * Infers missing fields that can be derived from deprecated params so callers
+ * written against older schema versions keep working.
+ */
+function normalizeRequestParams(taskType, params, opts = {}) {
+    if (!params) {
+        return params;
+    }
+    let normalized = { ...params };
+    // ── idempotency_key auto-generation ──
+    // Tasks that mutate state require a caller-supplied idempotency_key per
+    // AdCP spec. When the caller omits one, mint a fresh UUID v4. Most buyer
+    // code never needs to track keys of its own — retries via a kept-around
+    // key are the less-common path, and those callers supply their own.
+    // `opts.skipIdempotencyAutoInject` disables this for compliance testing.
+    // MUTATING_TASKS is derived from the Zod request schemas at module load
+    // so this stays in sync with the upstream spec — no hand-maintained list.
+    if (!opts.skipIdempotencyAutoInject &&
+        idempotency_1.MUTATING_TASKS.has(taskType) &&
+        (typeof normalized.idempotency_key !== 'string' || normalized.idempotency_key.length === 0)) {
+        normalized.idempotency_key = (0, idempotency_1.generateIdempotencyKey)();
+    }
+    // ── Universal shims (all tools) ──
+    // Always delete deprecated fields, even when the new field already exists,
+    // to prevent Zod strict validation failures on unknown keys.
+    // account_id (bare string) → account: { account_id }
+    if (typeof normalized.account_id === 'string' && !normalized.account) {
+        (0, deprecation_1.warnOnce)('account_id', 'account_id is deprecated. Use account: { account_id } instead.');
+        normalized.account = { account_id: normalized.account_id };
+    }
+    delete normalized.account_id;
+    // campaign_ref → buyer_campaign_ref
+    if (normalized.campaign_ref && !normalized.buyer_campaign_ref) {
+        (0, deprecation_1.warnOnce)('campaign_ref', 'campaign_ref is deprecated. Use buyer_campaign_ref instead.');
+        normalized.buyer_campaign_ref = normalized.campaign_ref;
+    }
+    delete normalized.campaign_ref;
+    // ── brand_manifest → brand (get_products, create_media_buy) ──
+    // update_media_buy has no brand field in either v2 or v3 — excluded deliberately.
+    // Derive brand from brand_manifest when only the manifest is supplied.
+    // brand takes precedence if both are supplied.
+    // brand_manifest is preserved — agents may still require it.
+    if (taskType === 'get_products' || taskType === 'create_media_buy') {
+        if (normalized.brand_manifest && !normalized.brand) {
+            const brand = (0, compat_1.brandManifestToBrandReference)(normalized.brand_manifest);
+            if (brand) {
+                normalized.brand = brand;
+            }
+        }
+    }
+    // ── account inference (create_media_buy) ──
+    // Derive account from brand when not provided so callers that pre-date
+    // the required account field keep working.
+    // sandbox is intentionally omitted: the normalizer cannot infer sandbox
+    // intent from brand alone. Callers that need sandbox must provide account explicitly.
+    if (taskType === 'create_media_buy' && !normalized.account && normalized.brand?.domain) {
+        (0, deprecation_1.warnOnce)('account_from_brand', 'create_media_buy: account is required. Inferring from brand for backward compatibility.');
+        normalized.account = {
+            brand: normalized.brand,
+            operator: normalized.brand.domain,
+        };
+    }
+    // ── context.buyer_ref → buyer_ref (create_media_buy, update_media_buy) ──
+    // AdCP 4.15 moved buyer_ref into context, but pre-4.15 servers still require
+    // it at the top level. Copy it back so requests validate on both old and new servers.
+    if ((taskType === 'create_media_buy' || taskType === 'update_media_buy') &&
+        normalized.context?.buyer_ref &&
+        !normalized.buyer_ref) {
+        normalized.buyer_ref = normalized.context.buyer_ref;
+    }
+    // ── Package normalization (create_media_buy, update_media_buy) ──
+    if ((taskType === 'create_media_buy' || taskType === 'update_media_buy') && Array.isArray(normalized.packages)) {
+        normalized.packages = normalized.packages.map(normalizePackageParams);
+    }
+    // ── activate_signal: field normalization ──
+    if (taskType === 'activate_signal') {
+        if (normalized.deployments && !normalized.destinations) {
+            (0, deprecation_1.warnOnce)('deployments', 'deployments is deprecated. Use destinations instead.');
+            normalized.destinations = normalized.deployments;
+        }
+        delete normalized.deployments;
+        if (normalized.signal_id && !normalized.signal_agent_segment_id) {
+            (0, deprecation_1.warnOnce)('signal_id', 'signal_id is deprecated. Use signal_agent_segment_id instead.');
+            normalized.signal_agent_segment_id = normalized.signal_id;
+        }
+        delete normalized.signal_id;
+        if (normalized.destination && !normalized.destinations) {
+            (0, deprecation_1.warnOnce)('destination', 'destination (singular) is deprecated. Use destinations (array) instead.');
+            normalized.destinations = [normalized.destination];
+        }
+        delete normalized.destination;
+        if (normalized.options) {
+            (0, deprecation_1.warnOnce)('activate_signal.options', 'activate_signal: options is not part of the AdCP spec and will be removed.');
+        }
+        delete normalized.options;
+    }
+    // ── get_signals: deliver_to → destinations ──
+    if (taskType === 'get_signals') {
+        if (normalized.deliver_to && !normalized.destinations) {
+            (0, deprecation_1.warnOnce)('deliver_to', 'deliver_to is deprecated. Use destinations and countries instead.');
+            normalized.destinations = normalized.deliver_to;
+        }
+        delete normalized.deliver_to;
+    }
+    // ── get_products-specific normalization ──
+    if (taskType === 'get_products') {
+        // Infer buying_mode from brief presence if not supplied
+        if (!normalized.buying_mode) {
+            normalized.buying_mode = normalized.brief ? 'brief' : 'wholesale';
+        }
+        // Strip removed v2 fields that would fail strict validation
+        for (const removed of ['feedback', 'product_ids', 'proposal_id']) {
+            if (removed in normalized) {
+                (0, deprecation_1.warnOnce)(`get_products.${removed}`, `GetProductsRequest.${removed} has been removed in v3.`);
+                delete normalized[removed];
+            }
+        }
+        // Convert legacy product_selectors (v3 beta / v2 era) → catalog so strict validation passes.
+        // catalog takes precedence if both are supplied.
+        if (normalized.product_selectors && !normalized.catalog) {
+            normalized.catalog = (0, compat_1.promotedProductsToCatalog)(normalized.product_selectors);
+        }
+        delete normalized.product_selectors;
+    }
+    return normalized;
+}
+//# sourceMappingURL=request-normalizer.js.map

package/dist/lib/utils/request-normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-normalizer.js","sourceRoot":"","sources":["../../../src/lib/utils/request-normalizer.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils/response-schemas.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Canonical map of AdCP tool names to their Zod response schemas.
+ *
+ * Shared by response-unwrapper (runtime parsing) and testing/client
+ * (compliance validation) so the two never diverge.
+ */
+import { z } from 'zod';
+export declare const TOOL_RESPONSE_SCHEMAS: Partial<Record<string, z.ZodType>>;
+//# sourceMappingURL=response-schemas.d.ts.map

package/dist/lib/utils/response-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-schemas.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/response-schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAgGpE,CAAC"}

package/dist/lib/utils/response-schemas.js

@@ -0,0 +1,129 @@
+"use strict";
+/**
+ * Canonical map of AdCP tool names to their Zod response schemas.
+ *
+ * Shared by response-unwrapper (runtime parsing) and testing/client
+ * (compliance validation) so the two never diverge.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_RESPONSE_SCHEMAS = void 0;
+const zod_1 = require("zod");
+const schemas = __importStar(require("../types/schemas.generated"));
+const sync_creatives_1 = require("../validation/sync-creatives");
+exports.TOOL_RESPONSE_SCHEMAS = {
+    // Product discovery & media buy
+    get_products: schemas.GetProductsResponseSchema,
+    create_media_buy: schemas.CreateMediaBuyResponseSchema,
+    update_media_buy: schemas.UpdateMediaBuyResponseSchema,
+    get_media_buys: schemas.GetMediaBuysResponseSchema,
+    get_media_buy_delivery: schemas.GetMediaBuyDeliveryResponseSchema,
+    provide_performance_feedback: schemas.ProvidePerformanceFeedbackResponseSchema,
+    // Creative
+    list_creative_formats: schemas.ListCreativeFormatsResponseSchema,
+    build_creative: schemas.BuildCreativeResponseSchema,
+    preview_creative: schemas.PreviewCreativeResponseSchema,
+    // Override the generated schema — it degrades creatives[] to a bare
+    // record because the JSON Schema inlines the item shape. The strict
+    // variant carries the per-item validator so the pipeline catches drift.
+    sync_creatives: sync_creatives_1.SyncCreativesResponseStrictSchema,
+    list_creatives: schemas.ListCreativesResponseSchema,
+    get_creative_delivery: schemas.GetCreativeDeliveryResponseSchema,
+    // Signals
+    get_signals: schemas.GetSignalsResponseSchema,
+    activate_signal: schemas.ActivateSignalResponseSchema,
+    // Account & audience
+    sync_accounts: schemas.SyncAccountsResponseSchema,
+    list_accounts: schemas.ListAccountsResponseSchema,
+    sync_governance: schemas.SyncGovernanceResponseSchema,
+    sync_audiences: schemas.SyncAudiencesResponseSchema,
+    report_usage: schemas.ReportUsageResponseSchema,
+    get_account_financials: schemas.GetAccountFinancialsResponseSchema,
+    // Catalogs & events
+    sync_catalogs: schemas.SyncCatalogsResponseSchema,
+    sync_event_sources: schemas.SyncEventSourcesResponseSchema,
+    log_event: schemas.LogEventResponseSchema,
+    get_media_buy_artifacts: schemas.GetMediaBuyArtifactsResponseSchema,
+    // Creative (additional)
+    get_creative_features: schemas.GetCreativeFeaturesResponseSchema,
+    // Governance — property lists & content standards
+    create_property_list: schemas.CreatePropertyListResponseSchema,
+    get_property_list: schemas.GetPropertyListResponseSchema,
+    update_property_list: schemas.UpdatePropertyListResponseSchema,
+    list_property_lists: schemas.ListPropertyListsResponseSchema,
+    delete_property_list: schemas.DeletePropertyListResponseSchema,
+    list_content_standards: schemas.ListContentStandardsResponseSchema,
+    get_content_standards: schemas.GetContentStandardsResponseSchema,
+    create_content_standards: schemas.CreateContentStandardsResponseSchema,
+    update_content_standards: schemas.UpdateContentStandardsResponseSchema,
+    calibrate_content: schemas.CalibrateContentResponseSchema,
+    validate_content_delivery: schemas.ValidateContentDeliveryResponseSchema,
+    // Collection lists
+    create_collection_list: schemas.CreateCollectionListResponseSchema,
+    update_collection_list: schemas.UpdateCollectionListResponseSchema,
+    get_collection_list: schemas.GetCollectionListResponseSchema,
+    list_collection_lists: schemas.ListCollectionListsResponseSchema,
+    delete_collection_list: schemas.DeleteCollectionListResponseSchema,
+    // Campaign governance
+    sync_plans: schemas.SyncPlansResponseSchema,
+    check_governance: schemas.CheckGovernanceResponseSchema,
+    report_plan_outcome: schemas.ReportPlanOutcomeResponseSchema,
+    get_plan_audit_logs: schemas.GetPlanAuditLogsResponseSchema,
+    // Sponsored Intelligence
+    si_get_offering: schemas.SIGetOfferingResponseSchema,
+    si_initiate_session: schemas.SIInitiateSessionResponseSchema,
+    si_send_message: schemas.SISendMessageResponseSchema,
+    si_terminate_session: schemas.SITerminateSessionResponseSchema,
+    // Capabilities
+    get_adcp_capabilities: schemas.GetAdCPCapabilitiesResponseSchema,
+    // Test controller
+    comply_test_controller: schemas.ComplyTestControllerResponseSchema,
+    // Property governance
+    validate_property_delivery: schemas.ValidatePropertyDeliveryResponseSchema,
+    // Brand rights
+    get_brand_identity: schemas.GetBrandIdentityResponseSchema,
+    get_rights: schemas.GetRightsResponseSchema,
+    acquire_rights: schemas.AcquireRightsResponseSchema,
+    // Brand rights — no schema definitions yet for these tools
+    update_rights: zod_1.z.union([
+        zod_1.z.object({ rights_id: zod_1.z.string() }).passthrough(),
+        zod_1.z.object({ errors: zod_1.z.array(schemas.ErrorSchema) }).passthrough(),
+    ]),
+    creative_approval: zod_1.z.union([
+        zod_1.z.object({ decision: zod_1.z.string() }).passthrough(),
+        zod_1.z.object({ errors: zod_1.z.array(schemas.ErrorSchema) }).passthrough(),
+    ]),
+};
+//# sourceMappingURL=response-schemas.js.map

package/dist/lib/utils/response-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-schemas.js","sourceRoot":"","sources":["../../../src/lib/utils/response-schemas.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils/response-unwrapper.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Response Unwrapper
+ *
+ * Extracts raw AdCP responses from protocol wrappers (MCP/A2A).
+ * Follows canonical A2A response format per AdCP specification.
+ */
+import type { GetProductsResponse, ListCreativeFormatsResponse, CreateMediaBuyResponse, SyncCreativesResponse, ListCreativesResponse, UpdateMediaBuyResponse, GetMediaBuysResponse, GetMediaBuyDeliveryResponse, ProvidePerformanceFeedbackResponse, BuildCreativeResponse, PreviewCreativeResponse, GetSignalsResponse, ActivateSignalResponse } from '../types/tools.generated';
+/**
+ * Union type of all possible AdCP responses
+ * Each response type is a discriminated union of success | error
+ */
+export type AdCPResponse = GetProductsResponse | ListCreativeFormatsResponse | CreateMediaBuyResponse | SyncCreativesResponse | ListCreativesResponse | UpdateMediaBuyResponse | GetMediaBuysResponse | GetMediaBuyDeliveryResponse | ProvidePerformanceFeedbackResponse | BuildCreativeResponse | PreviewCreativeResponse | GetSignalsResponse | ActivateSignalResponse;
+/**
+ * Extract raw AdCP response from protocol wrapper
+ *
+ * @param protocolResponse - Raw response from MCP or A2A protocol
+ * @param toolName - Optional AdCP tool name for validation
+ * @param protocol - Protocol type ('mcp' or 'a2a'), if known. If not provided, will auto-detect.
+ * @param options - Optional validation behavior overrides
+ * @returns Raw AdCP response data matching schema exactly
+ * @throws {Error} If response doesn't match expected schema for the tool
+ */
+export declare function unwrapProtocolResponse(protocolResponse: any, toolName?: string, protocol?: 'mcp' | 'a2a', options?: {
+    filterInvalidProducts?: boolean;
+}): AdCPResponse & {
+    _message?: string;
+};
+/**
+ * MCP response extraction provenance. Set as a non-enumerable `_extraction_path`
+ * property on the unwrapped object so the storyboard runner can surface it in
+ * its runner-output contract without leaking into JSON-serialized or spread
+ * responses. See `src/lib/testing/storyboard/types.ts` → `RunnerExtractionPath`.
+ */
+export type McpExtractionPath = 'structured_content' | 'text_fallback' | 'error' | 'none';
+export declare const EXTRACTION_PATH_KEY: "_extraction_path";
+/**
+ * Read the extraction path from an unwrapped AdCP response, or `undefined`
+ * if the response did not originate from an MCP unwrap path.
+ */
+export declare function readExtractionPath(data: unknown): McpExtractionPath | undefined;
+/**
+ * Check if a response is an AdCP error response.
+ * Recognizes both `{ adcp_error: { code: string } }` (MCP structured errors)
+ * and `{ errors: [{ code, message }] }` (legacy/A2A format).
+ */
+export declare function isAdcpError(response: any): boolean;
+/**
+ * Check if a response is an AdCP success response for a specific task
+ *
+ * Uses Zod schemas to validate the response structure matches the expected
+ * success response format for the given task.
+ */
+export declare function isAdcpSuccess(response: any, taskName: string): boolean;
+//# sourceMappingURL=response-unwrapper.d.ts.map

package/dist/lib/utils/response-unwrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-unwrapper.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/response-unwrapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,KAAK,EACV,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,2BAA2B,EAC3B,kCAAkC,EAClC,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAGlC;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,mBAAmB,GACnB,2BAA2B,GAC3B,sBAAsB,GACtB,qBAAqB,GACrB,qBAAqB,GACrB,sBAAsB,GACtB,oBAAoB,GACpB,2BAA2B,GAC3B,kCAAkC,GAClC,qBAAqB,GACrB,uBAAuB,GACvB,kBAAkB,GAClB,sBAAsB,CAAC;AAE3B;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,GAAG,EACrB,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,EACxB,OAAO,CAAC,EAAE;IAAE,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5C,YAAY,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CA0FtC;AAyDD;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,GAAG,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1F,eAAO,MAAM,mBAAmB,EAAG,kBAA2B,CAAC;AAuI/D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAI/E;AAoFD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAIlD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAgBtE"}