@adcp/client 3.7.1 → 3.8.0

package/dist/lib/core/SingleAgentClient.d.ts

@@ -1,9 +1,32 @@
 import type { AgentConfig } from '../types';
-import type { GetProductsRequest, GetProductsResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse, CreateMediaBuyRequest, UpdateMediaBuyRequest, UpdateMediaBuyResponse, SyncCreativesRequest, SyncCreativesResponse, ListCreativesRequest, ListCreativesResponse, GetMediaBuyDeliveryRequest, GetMediaBuyDeliveryResponse, ListAuthorizedPropertiesRequest, ListAuthorizedPropertiesResponse, ProvidePerformanceFeedbackRequest, ProvidePerformanceFeedbackResponse, GetSignalsRequest, GetSignalsResponse, ActivateSignalRequest, ActivateSignalResponse, PreviewCreativeRequest, PreviewCreativeResponse, Format } from '../types/tools.generated';
+import type { GetProductsRequest, GetProductsResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse, CreateMediaBuyRequest, UpdateMediaBuyRequest, UpdateMediaBuyResponse, SyncCreativesRequest, SyncCreativesResponse, ListCreativesRequest, ListCreativesResponse, GetMediaBuyDeliveryRequest, GetMediaBuyDeliveryResponse, ProvidePerformanceFeedbackRequest, ProvidePerformanceFeedbackResponse, GetSignalsRequest, GetSignalsResponse, ActivateSignalRequest, ActivateSignalResponse, PreviewCreativeRequest, PreviewCreativeResponse, Format, GetAdCPCapabilitiesRequest, GetAdCPCapabilitiesResponse } from '../types/tools.generated';
 import type { MCPWebhookPayload, CreateMediaBuyResponse } from '../types/core.generated';
 import type { Task as A2ATask, TaskStatusUpdateEvent } from '@a2a-js/sdk';
 import type { InputHandler, TaskOptions, TaskResult, ConversationConfig, TaskInfo } from './ConversationTypes';
 import type { Activity, AsyncHandlerConfig } from './AsyncHandler';
+import type { AdcpCapabilities } from '../utils/capabilities';
+/**
+ * Error class for v3 feature compatibility issues
+ *
+ * Note: The library no longer throws this error for get_products calls with
+ * unsupported v3 features. Instead, it returns an empty result (semantically
+ * "no products match this filter"). This error class is exported for use in
+ * custom validation logic or other scenarios.
+ *
+ * @example
+ * ```typescript
+ * // Custom validation before making requests
+ * const capabilities = await client.getCapabilities();
+ * if (params.property_list && !capabilities.features.propertyListFiltering) {
+ *   throw new UnsupportedFeatureError('property_list', capabilities.version);
+ * }
+ * ```
+ */
+export declare class UnsupportedFeatureError extends Error {
+    readonly feature: string;
+    readonly serverVersion: 'v2' | 'v3';
+    constructor(feature: string, serverVersion: 'v2' | 'v3', message?: string);
+}
 /**
  * Configuration for SingleAgentClient (and multi-agent client)
  */
@@ -83,6 +106,7 @@ export declare class SingleAgentClient {
     private normalizedAgent;
     private discoveredEndpoint?;
     private canonicalBaseUrl?;
+    private cachedCapabilities?;
     constructor(agent: AgentConfig, config?: SingleAgentClientConfig);
     /**
      * Ensure MCP endpoint is discovered (lazy initialization)
@@ -251,8 +275,32 @@ export declare class SingleAgentClient {
     verifyWebhookSignature(payload: any, signature: string, timestamp: string | number): boolean;
     /**
      * Execute task and call appropriate handler on completion
+     *
+     * Automatically adapts requests for v2 servers and normalizes responses.
      */
     private executeAndHandle;
+    /**
+     * Adapt request parameters for the detected server version
+     *
+     * Converts v3-style requests to v2 format when talking to v2 servers.
+     */
+    private adaptRequestForServerVersion;
+    /**
+     * Normalize response to v3 format
+     *
+     * Converts v2 responses to v3 structure for consistent API surface.
+     */
+    private normalizeResponseToV3;
+    /**
+     * Check if request uses v3 features that the server doesn't support
+     *
+     * Returns an early empty result if the request requires v3 features
+     * that the server doesn't support. This treats "products matching unsupported
+     * capability" as an empty result set rather than an error.
+     *
+     * @returns TaskResult with empty data if v3 features are unsupported, null to proceed normally
+     */
+    private getEarlyResultForUnsupportedFeatures;
     /**
      * Discover available advertising products
      *
@@ -331,14 +379,6 @@ export declare class SingleAgentClient {
      * @param options - Task execution options
      */
     getMediaBuyDelivery(params: GetMediaBuyDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<GetMediaBuyDeliveryResponse>>;
-    /**
-     * List authorized properties
-     *
-     * @param params - Property listing parameters
-     * @param inputHandler - Handler for clarification requests
-     * @param options - Task execution options
-     */
-    listAuthorizedProperties(params: ListAuthorizedPropertiesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ListAuthorizedPropertiesResponse>>;
     /**
      * Provide performance feedback
      *
@@ -363,6 +403,14 @@ export declare class SingleAgentClient {
      * @param options - Task execution options
      */
     activateSignal(params: ActivateSignalRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ActivateSignalResponse>>;
+    /**
+     * Get AdCP capabilities
+     *
+     * @param params - Capabilities request parameters
+     * @param inputHandler - Handler for clarification requests
+     * @param options - Task execution options
+     */
+    getAdcpCapabilities(params: GetAdCPCapabilitiesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<GetAdCPCapabilitiesResponse>>;
     /**
      * Execute any task by name with type safety
      *
@@ -618,6 +666,37 @@ export declare class SingleAgentClient {
             parameters?: string[];
         }>;
     }>;
+    /**
+     * Get agent capabilities, including AdCP version support
+     *
+     * For v3 servers, calls get_adcp_capabilities tool.
+     * For v2 servers, builds synthetic capabilities from available tools.
+     *
+     * @returns Promise resolving to normalized capabilities object
+     *
+     * @example
+     * ```typescript
+     * const capabilities = await client.getCapabilities();
+     *
+     * console.log(`Server version: ${capabilities.version}`);
+     * console.log(`Protocols: ${capabilities.protocols.join(', ')}`);
+     *
+     * if (capabilities.features.propertyListFiltering) {
+     *   // Use v3 property list features
+     * }
+     * ```
+     */
+    getCapabilities(): Promise<AdcpCapabilities>;
+    /**
+     * Detect server AdCP version
+     *
+     * @returns 'v2' or 'v3' based on server capabilities
+     */
+    detectServerVersion(): Promise<'v2' | 'v3'>;
+    /**
+     * Check if server supports a specific AdCP major version
+     */
+    supportsVersion(version: 2 | 3): Promise<boolean>;
     /**
      * Query a creative agent to discover available creative formats
      *
@@ -656,7 +735,20 @@ export declare class SingleAgentClient {
      */
     private validateRequest;
     /**
-     * Get request schema for a given task type
+     * Get request schema for a given task type.
+     *
+     * Note: Schema validation is not available for all task types. The following
+     * tasks use complex discriminated unions that cannot be represented in Zod
+     * without significant runtime overhead:
+     *
+     * - `get_products`: Uses conditional fields based on brief vs proposal_id
+     * - `update_media_buy`: Uses conditional package update operations
+     *
+     * For these tasks, TypeScript compile-time checking is still enforced via
+     * the generated types, but runtime validation falls back to basic type checks.
+     * Invalid requests will still be rejected by the server with descriptive errors.
+     *
+     * @internal
      */
     private getRequestSchema;
 }

package/dist/lib/core/SingleAgentClient.d.ts.map

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

package/dist/lib/core/SingleAgentClient.js

@@ -34,7 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SingleAgentClient = void 0;
+exports.SingleAgentClient = exports.UnsupportedFeatureError = void 0;
 exports.createSingleAgentClient = createSingleAgentClient;
 const zod_1 = require("zod");
 const schemas = __importStar(require("../types/schemas.generated"));
@@ -42,6 +42,39 @@ const TaskExecutor_1 = require("./TaskExecutor");
 const AsyncHandler_1 = require("./AsyncHandler");
 const response_unwrapper_1 = require("../utils/response-unwrapper");
 const crypto = __importStar(require("crypto"));
+const capabilities_1 = require("../utils/capabilities");
+const creative_adapter_1 = require("../utils/creative-adapter");
+const format_renders_1 = require("../utils/format-renders");
+const preview_normalizer_1 = require("../utils/preview-normalizer");
+const pricing_adapter_1 = require("../utils/pricing-adapter");
+/**
+ * Error class for v3 feature compatibility issues
+ *
+ * Note: The library no longer throws this error for get_products calls with
+ * unsupported v3 features. Instead, it returns an empty result (semantically
+ * "no products match this filter"). This error class is exported for use in
+ * custom validation logic or other scenarios.
+ *
+ * @example
+ * ```typescript
+ * // Custom validation before making requests
+ * const capabilities = await client.getCapabilities();
+ * if (params.property_list && !capabilities.features.propertyListFiltering) {
+ *   throw new UnsupportedFeatureError('property_list', capabilities.version);
+ * }
+ * ```
+ */
+class UnsupportedFeatureError extends Error {
+    feature;
+    serverVersion;
+    constructor(feature, serverVersion, message) {
+        super(message || `Feature '${feature}' requires AdCP v3 but server is ${serverVersion}`);
+        this.feature = feature;
+        this.serverVersion = serverVersion;
+        this.name = 'UnsupportedFeatureError';
+    }
+}
+exports.UnsupportedFeatureError = UnsupportedFeatureError;
 /**
  * Internal single-agent client implementation
  *
@@ -64,6 +97,7 @@ class SingleAgentClient {
     normalizedAgent;
     discoveredEndpoint; // Cache discovered MCP endpoint
     canonicalBaseUrl; // Cache canonical base URL (from agent card or stripped /mcp)
+    cachedCapabilities; // Cache detected server capabilities
     constructor(agent, config = {}) {
         this.agent = agent;
         this.config = config;
@@ -594,12 +628,25 @@ class SingleAgentClient {
     }
     /**
      * Execute task and call appropriate handler on completion
+     *
+     * Automatically adapts requests for v2 servers and normalizes responses.
      */
     async executeAndHandle(taskType, handlerName, params, inputHandler, options) {
         // Validate request params against schema
         this.validateRequest(taskType, params);
+        // Check for v3 features used against v2 servers - return empty result if unsupported
+        const earlyResult = await this.getEarlyResultForUnsupportedFeatures(taskType, params);
+        if (earlyResult) {
+            return earlyResult;
+        }
         const agent = await this.ensureEndpointDiscovered();
-        const result = await this.executor.executeTask(agent, taskType, params, inputHandler, options);
+        // Adapt request for v2 servers if needed
+        const adaptedParams = await this.adaptRequestForServerVersion(taskType, params);
+        const result = await this.executor.executeTask(agent, taskType, adaptedParams, inputHandler, options);
+        // Normalize response to v3 format
+        if (result.success && result.data) {
+            result.data = this.normalizeResponseToV3(taskType, result.data);
+        }
         // Call handler if task completed successfully and handler is configured
         if (result.status === 'completed' && result.success && this.asyncHandler) {
             const handler = this.config.handlers?.[handlerName];
@@ -617,6 +664,106 @@ class SingleAgentClient {
         }
         return result;
     }
+    /**
+     * Adapt request parameters for the detected server version
+     *
+     * Converts v3-style requests to v2 format when talking to v2 servers.
+     */
+    async adaptRequestForServerVersion(taskType, params) {
+        // Get server version (cached after first call)
+        const version = await this.detectServerVersion();
+        // If server is v3, no adaptation needed
+        if (version === 'v3') {
+            return params;
+        }
+        // Adapt v3 requests for v2 servers
+        switch (taskType) {
+            case 'create_media_buy':
+                return (0, creative_adapter_1.adaptCreateMediaBuyRequestForV2)(params);
+            case 'update_media_buy':
+                return (0, creative_adapter_1.adaptUpdateMediaBuyRequestForV2)(params);
+            default:
+                return params;
+        }
+    }
+    /**
+     * Normalize response to v3 format
+     *
+     * Converts v2 responses to v3 structure for consistent API surface.
+     */
+    normalizeResponseToV3(taskType, data) {
+        switch (taskType) {
+            case 'get_products':
+                return (0, pricing_adapter_1.normalizeGetProductsResponse)(data);
+            case 'list_creative_formats':
+                return (0, format_renders_1.normalizeFormatsResponse)(data);
+            case 'preview_creative':
+                return (0, preview_normalizer_1.normalizePreviewCreativeResponse)(data);
+            case 'create_media_buy':
+            case 'update_media_buy':
+                return (0, creative_adapter_1.normalizeMediaBuyResponse)(data);
+            default:
+                return data;
+        }
+    }
+    /**
+     * Check if request uses v3 features that the server doesn't support
+     *
+     * Returns an early empty result if the request requires v3 features
+     * that the server doesn't support. This treats "products matching unsupported
+     * capability" as an empty result set rather than an error.
+     *
+     * @returns TaskResult with empty data if v3 features are unsupported, null to proceed normally
+     */
+    async getEarlyResultForUnsupportedFeatures(taskType, params) {
+        // Only check for tasks that have v3-specific features
+        if (taskType !== 'get_products') {
+            return null;
+        }
+        // Get capabilities to check what the server supports
+        const capabilities = await this.getCapabilities();
+        // If server is v3, all features are supported - proceed normally
+        if (capabilities.version === 'v3') {
+            return null;
+        }
+        // Check for v3-only features that would make this query return empty results
+        const usesUnsupportedFeature = 
+        // property_list requires propertyListFiltering
+        (params.property_list && !capabilities.features.propertyListFiltering) ||
+            // required_features: content_standards requires contentStandards
+            (params.filters?.required_features?.includes('content_standards') && !capabilities.features.contentStandards) ||
+            // required_features: property_list_filtering requires propertyListFiltering
+            (params.filters?.required_features?.includes('property_list_filtering') &&
+                !capabilities.features.propertyListFiltering);
+        if (!usesUnsupportedFeature) {
+            return null; // Proceed normally
+        }
+        // Log warning about v2 downgrade
+        console.warn(`[AdCP] v3-only features not supported by server "${this.agent.id}" (${capabilities.version}). Returning empty results.`);
+        // Return empty result - semantically "no products match this filter"
+        const emptyResponse = {
+            products: [],
+            property_list_applied: false,
+        };
+        return {
+            success: true,
+            status: 'completed',
+            data: emptyResponse,
+            metadata: {
+                taskId: `early_${Date.now()}`,
+                taskName: taskType,
+                agent: {
+                    id: this.agent.id,
+                    name: this.agent.name,
+                    protocol: this.normalizedAgent.protocol,
+                },
+                responseTimeMs: 0,
+                timestamp: new Date().toISOString(),
+                clarificationRounds: 0,
+                status: 'completed',
+            },
+        };
+    }
     // ====== MEDIA BUY TASKS ======
     /**
      * Discover available advertising products
@@ -743,16 +890,6 @@ class SingleAgentClient {
     async getMediaBuyDelivery(params, inputHandler, options) {
         return this.executeAndHandle('get_media_buy_delivery', 'onGetMediaBuyDeliveryStatusChange', params, inputHandler, options);
     }
-    /**
-     * List authorized properties
-     *
-     * @param params - Property listing parameters
-     * @param inputHandler - Handler for clarification requests
-     * @param options - Task execution options
-     */
-    async listAuthorizedProperties(params, inputHandler, options) {
-        return this.executeAndHandle('list_authorized_properties', 'onListAuthorizedPropertiesStatusChange', params, inputHandler, options);
-    }
     /**
      * Provide performance feedback
      *
@@ -784,6 +921,18 @@ class SingleAgentClient {
     async activateSignal(params, inputHandler, options) {
         return this.executeAndHandle('activate_signal', 'onActivateSignalStatusChange', params, inputHandler, options);
     }
+    // ====== PROTOCOL TASKS ======
+    /**
+     * Get AdCP capabilities
+     *
+     * @param params - Capabilities request parameters
+     * @param inputHandler - Handler for clarification requests
+     * @param options - Task execution options
+     */
+    async getAdcpCapabilities(params, inputHandler, options) {
+        const agent = await this.ensureEndpointDiscovered();
+        return this.executor.executeTask(agent, 'get_adcp_capabilities', params, inputHandler, options);
+    }
     // ====== GENERIC TASK EXECUTION ======
     /**
      * Execute any task by name with type safety
@@ -1224,6 +1373,73 @@ class SingleAgentClient {
         }
         throw new Error(`Unsupported protocol: ${this.normalizedAgent.protocol}`);
     }
+    /**
+     * Get agent capabilities, including AdCP version support
+     *
+     * For v3 servers, calls get_adcp_capabilities tool.
+     * For v2 servers, builds synthetic capabilities from available tools.
+     *
+     * @returns Promise resolving to normalized capabilities object
+     *
+     * @example
+     * ```typescript
+     * const capabilities = await client.getCapabilities();
+     *
+     * console.log(`Server version: ${capabilities.version}`);
+     * console.log(`Protocols: ${capabilities.protocols.join(', ')}`);
+     *
+     * if (capabilities.features.propertyListFiltering) {
+     *   // Use v3 property list features
+     * }
+     * ```
+     */
+    async getCapabilities() {
+        // Return cached if available
+        if (this.cachedCapabilities) {
+            return this.cachedCapabilities;
+        }
+        // First get tool list to support both detection methods
+        const agentInfo = await this.getAgentInfo();
+        const tools = agentInfo.tools.map(t => ({
+            name: t.name,
+            description: t.description,
+        }));
+        // Check if agent supports get_adcp_capabilities (v3)
+        const hasCapabilitiesTool = tools.some(t => t.name === 'get_adcp_capabilities');
+        if (hasCapabilitiesTool) {
+            try {
+                // Call get_adcp_capabilities tool
+                const agent = await this.ensureEndpointDiscovered();
+                const result = await this.executor.executeTask(agent, 'get_adcp_capabilities', {}, undefined);
+                if (result.success && result.data) {
+                    this.cachedCapabilities = (0, capabilities_1.parseCapabilitiesResponse)(result.data);
+                    return this.cachedCapabilities;
+                }
+            }
+            catch {
+                // Fall through to synthetic capabilities
+            }
+        }
+        // Build synthetic capabilities from tool list (v2)
+        this.cachedCapabilities = (0, capabilities_1.buildSyntheticCapabilities)(tools);
+        return this.cachedCapabilities;
+    }
+    /**
+     * Detect server AdCP version
+     *
+     * @returns 'v2' or 'v3' based on server capabilities
+     */
+    async detectServerVersion() {
+        const capabilities = await this.getCapabilities();
+        return capabilities.version;
+    }
+    /**
+     * Check if server supports a specific AdCP major version
+     */
+    async supportsVersion(version) {
+        const capabilities = await this.getCapabilities();
+        return capabilities.majorVersions.includes(version);
+    }
     // ====== STATIC HELPER METHODS ======
     /**
      * Query a creative agent to discover available creative formats
@@ -1299,19 +1515,30 @@ class SingleAgentClient {
         }
     }
     /**
-     * Get request schema for a given task type
+     * Get request schema for a given task type.
+     *
+     * Note: Schema validation is not available for all task types. The following
+     * tasks use complex discriminated unions that cannot be represented in Zod
+     * without significant runtime overhead:
+     *
+     * - `get_products`: Uses conditional fields based on brief vs proposal_id
+     * - `update_media_buy`: Uses conditional package update operations
+     *
+     * For these tasks, TypeScript compile-time checking is still enforced via
+     * the generated types, but runtime validation falls back to basic type checks.
+     * Invalid requests will still be rejected by the server with descriptive errors.
+     *
+     * @internal
      */
     getRequestSchema(taskType) {
-        // Only include schemas that exist in generated schemas
         const schemaMap = {
-            get_products: schemas.GetProductsRequestSchema,
+            // get_products: excluded - complex discriminated unions (brief vs proposal_id)
             list_creative_formats: schemas.ListCreativeFormatsRequestSchema,
             create_media_buy: schemas.CreateMediaBuyRequestSchema,
-            update_media_buy: schemas.UpdateMediaBuyRequestSchema,
+            // update_media_buy: excluded - complex discriminated unions (package operations)
             sync_creatives: schemas.SyncCreativesRequestSchema,
             list_creatives: schemas.ListCreativesRequestSchema,
             get_media_buy_delivery: schemas.GetMediaBuyDeliveryRequestSchema,
-            list_authorized_properties: schemas.ListAuthorizedPropertiesRequestSchema,
             get_signals: schemas.GetSignalsRequestSchema,
             activate_signal: schemas.ActivateSignalRequestSchema,
         };