@adcp/client 3.0.3 → 3.2.0

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

@@ -0,0 +1,331 @@
+"use strict";
+/**
+ * Response Unwrapper
+ *
+ * Extracts raw AdCP responses from protocol wrappers (MCP/A2A).
+ * Follows canonical A2A response format per AdCP specification.
+ */
+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.unwrapProtocolResponse = unwrapProtocolResponse;
+exports.isAdcpError = isAdcpError;
+exports.isAdcpSuccess = isAdcpSuccess;
+const zod_1 = require("zod");
+/**
+ * Standard error codes for response unwrapping
+ */
+const ERROR_CODES = {
+    MCP_ERROR: 'mcp_error',
+    INVALID_RESPONSE: 'invalid_response',
+    UNKNOWN: 'unknown',
+};
+const schemas = __importStar(require("../types/schemas.generated"));
+/**
+ * Map of AdCP tool names to their Zod response schemas
+ *
+ * TYPE SAFETY TRADE-OFF ANALYSIS:
+ *
+ * Current approach: All schemas cast to `z.ZodSchema<AdCPResponse>` (union type)
+ *
+ * Why we keep this approach:
+ * 1. Simplicity - Single map type is easy to maintain and extend
+ * 2. Runtime validation - Zod schemas provide full validation regardless of type
+ * 3. Return type accuracy - unwrapProtocolResponse returns `AdCPResponse` union anyway
+ * 4. Minimal type loss - The specific schema validates correctly at runtime
+ *
+ * Alternative considered (function overloads):
+ * ```typescript
+ * function unwrapProtocolResponse(response: any, toolName: 'get_products'): GetProductsResponse;
+ * function unwrapProtocolResponse(response: any, toolName: 'create_media_buy'): CreateMediaBuyResponse;
+ * // ... 13 overloads total
+ * ```
+ *
+ * Why we don't use overloads:
+ * 1. High maintenance burden - 13+ overload signatures to maintain
+ * 2. Fragile - Easy to forget updating overloads when adding tools
+ * 3. Limited benefit - Caller still needs type guards to narrow union
+ * 4. Optional toolName - toolName parameter is optional, overloads don't help
+ *
+ * Alternative considered (mapped types):
+ * ```typescript
+ * type ToolSchemaMap = {
+ *   [K in keyof typeof TOOL_RESPONSE_SCHEMAS]: z.ZodSchema<Extract<AdCPResponse, { ... }>>
+ * }
+ * ```
+ *
+ * Why we don't use mapped types:
+ * 1. Complexity - Requires discriminated union detection logic
+ * 2. Fragile - AdCP responses don't all have discriminator fields
+ * 3. Minimal benefit - Still returns union type, needs type guards at call site
+ *
+ * Conclusion: Current approach provides best balance of simplicity, maintainability,
+ * and runtime safety. TypeScript types are validated by Zod at runtime anyway.
+ */
+const TOOL_RESPONSE_SCHEMAS = {
+    get_products: schemas.GetProductsResponseSchema,
+    list_creative_formats: schemas.ListCreativeFormatsResponseSchema,
+    create_media_buy: schemas.CreateMediaBuyResponseSchema,
+    update_media_buy: schemas.UpdateMediaBuyResponseSchema,
+    sync_creatives: schemas.SyncCreativesResponseSchema, // Manually defined discriminated union
+    list_creatives: schemas.ListCreativesResponseSchema,
+    get_media_buy_delivery: schemas.GetMediaBuyDeliveryResponseSchema,
+    list_authorized_properties: schemas.ListAuthorizedPropertiesResponseSchema,
+    provide_performance_feedback: schemas.ProvidePerformanceFeedbackResponseSchema,
+    build_creative: schemas.BuildCreativeResponseSchema,
+    preview_creative: schemas.PreviewCreativeResponseSchema, // Manually defined discriminated union
+    get_signals: schemas.GetSignalsResponseSchema,
+    activate_signal: schemas.ActivateSignalResponseSchema,
+};
+/**
+ * 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.
+ * @returns Raw AdCP response data matching schema exactly
+ * @throws {Error} If response doesn't match expected schema for the tool
+ */
+function unwrapProtocolResponse(protocolResponse, toolName, protocol) {
+    if (!protocolResponse) {
+        throw new Error('Protocol response is null or undefined');
+    }
+    // Extract response from protocol wrapper
+    let unwrapped;
+    if (protocol === 'mcp') {
+        unwrapped = unwrapMCPResponse(protocolResponse);
+    }
+    else if (protocol === 'a2a') {
+        unwrapped = unwrapA2AResponse(protocolResponse);
+    }
+    else {
+        // Auto-detect protocol if not specified
+        if (isMCPResponse(protocolResponse)) {
+            unwrapped = unwrapMCPResponse(protocolResponse);
+        }
+        else if (isA2AResponse(protocolResponse)) {
+            unwrapped = unwrapA2AResponse(protocolResponse);
+        }
+        else {
+            throw new Error('Unable to extract AdCP response from protocol wrapper');
+        }
+    }
+    // Validate response against schema if tool name provided
+    if (toolName) {
+        const schema = TOOL_RESPONSE_SCHEMAS[toolName];
+        if (schema) {
+            // Create wrapper schema that preserves protocol metadata
+            // We use z.intersection to combine the validated response with optional _message field
+            const wrapperSchema = zod_1.z.intersection(schema, zod_1.z.object({ _message: zod_1.z.string().optional() }));
+            const result = wrapperSchema.safeParse(unwrapped);
+            if (!result.success) {
+                throw new Error(`Response validation failed for ${toolName}: ${result.error.message}`);
+            }
+            return result.data;
+        }
+    }
+    // Return unwrapped response (no validation)
+    return unwrapped;
+}
+/**
+ * Check if response is MCP format
+ */
+function isMCPResponse(response) {
+    return 'structuredContent' in response || 'isError' in response || 'content' in response;
+}
+/**
+ * Check if response is A2A format
+ */
+function isA2AResponse(response) {
+    return 'result' in response || 'error' in response;
+}
+/**
+ * Unwrap MCP response - all MCP logic in one place
+ */
+function unwrapMCPResponse(response) {
+    // MCP error response
+    if (response.isError === true) {
+        const errorContent = Array.isArray(response.content)
+            ? response.content.find((c) => c.type === 'text')?.text
+            : response.content?.text || 'Unknown error';
+        return {
+            errors: [
+                {
+                    code: ERROR_CODES.MCP_ERROR,
+                    message: errorContent || 'MCP tool call failed',
+                },
+            ],
+        };
+    }
+    // MCP success response with structuredContent
+    if (response.structuredContent !== undefined && response.structuredContent !== null) {
+        const data = response.structuredContent;
+        // Extract text messages from content field (parallel to A2A TextParts)
+        const textMessages = [];
+        if (response.content && Array.isArray(response.content)) {
+            for (const item of response.content) {
+                if (item.type === 'text' && item.text) {
+                    textMessages.push(item.text);
+                }
+            }
+        }
+        // Include text messages if present (same pattern as A2A)
+        if (textMessages.length > 0) {
+            return {
+                ...data,
+                _message: textMessages.join('\n'),
+            };
+        }
+        return data;
+    }
+    // MCP text content fallback (try parsing as JSON)
+    if (response.content && Array.isArray(response.content)) {
+        const textContent = response.content.find((c) => c.type === 'text');
+        if (textContent?.text) {
+            try {
+                return JSON.parse(textContent.text);
+            }
+            catch {
+                // Include snippet of text for debugging (max 100 chars)
+                const snippet = textContent.text.length > 100 ? textContent.text.substring(0, 100) + '...' : textContent.text;
+                return {
+                    errors: [
+                        {
+                            code: ERROR_CODES.INVALID_RESPONSE,
+                            message: `Response does not contain structured AdCP data. Text content: "${snippet}"`,
+                        },
+                    ],
+                };
+            }
+        }
+    }
+    throw new Error('Invalid MCP response format');
+}
+/**
+ * Unwrap A2A response
+ *
+ * NOTE: This function should only be called when status is "completed".
+ * Intermediate statuses ("working", "submitted", "input-required") are handled
+ * at the response level (not in artifacts) and should not reach this function.
+ *
+ * A2A response flow:
+ * - Intermediate: { status: "working", message: "..." } - NO artifacts yet
+ * - Completed: { status: "completed", result: { artifacts: [...] } } - Parse artifacts here
+ */
+function unwrapA2AResponse(response) {
+    // Validate that we're not processing intermediate statuses
+    // Task status check: only completed tasks should reach artifact extraction
+    if (response.result?.status?.state && response.result.status.state !== 'completed') {
+        throw new Error(`Cannot unwrap A2A response with intermediate status: ${response.result.status.state}. ` +
+            'Only completed responses should be unwrapped.');
+    }
+    // A2A error response (JSON-RPC error)
+    if (response.error) {
+        return {
+            errors: [
+                {
+                    code: response.error.code?.toString() || ERROR_CODES.UNKNOWN,
+                    message: response.error.message || 'A2A JSON-RPC error occurred',
+                    ...(response.error.data && { data: response.error.data }),
+                },
+            ],
+        };
+    }
+    // A2A completed response - simple requirements per AdCP spec:
+    // - MUST have result.artifacts array with at least one completed artifact
+    // - Completed artifact MUST have at least one DataPart (kind: 'data') with the AdCP response
+    // - MAY have TextParts (kind: 'text') with optional messages
+    const artifacts = response.result?.artifacts;
+    if (!Array.isArray(artifacts) || artifacts.length === 0) {
+        throw new Error('A2A completed response must have at least one artifact');
+    }
+    // Take last artifact (conversational protocols append artifacts over time)
+    // Note: A2A artifacts don't have a status field - only Tasks have status.
+    // If the Task status is "completed", all artifacts in result.artifacts are completed.
+    const artifact = artifacts[artifacts.length - 1];
+    if (!artifact) {
+        throw new Error('A2A completed response must have at least one artifact');
+    }
+    if (!artifact.parts || !Array.isArray(artifact.parts)) {
+        throw new Error('A2A artifact missing parts array');
+    }
+    // Extract DataPart (required) and TextParts (optional)
+    // Get last data part to be consistent with taking last artifact in conversational protocol
+    const dataParts = artifact.parts.filter((p) => p.kind === 'data');
+    const dataPart = dataParts[dataParts.length - 1];
+    if (!dataPart?.data) {
+        throw new Error('A2A completed response must have a DataPart with AdCP data');
+    }
+    const textParts = artifact.parts.filter((p) => p.kind === 'text' && p.text).map((p) => p.text);
+    // Unwrap nested response field if present (some agents wrap AdCP responses)
+    let data = dataPart.data;
+    if (data?.response && typeof data.response === 'object' && !Array.isArray(data.response)) {
+        data = data.response;
+    }
+    // Return data with optional message
+    if (textParts.length > 0) {
+        return {
+            ...data,
+            _message: textParts.join('\n'),
+        };
+    }
+    return data;
+}
+/**
+ * Check if a response is an AdCP error response
+ */
+function isAdcpError(response) {
+    return Array.isArray(response?.errors) && response.errors.length > 0;
+}
+/**
+ * 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.
+ */
+function isAdcpSuccess(response, taskName) {
+    // First check if it's an error response
+    if (isAdcpError(response)) {
+        return false;
+    }
+    // Try to validate with Zod schema if available
+    const schema = TOOL_RESPONSE_SCHEMAS[taskName];
+    if (schema) {
+        const result = schema.safeParse(response);
+        return result.success;
+    }
+    // Unknown task - can't validate, assume success if no errors
+    return true;
+}
+//# sourceMappingURL=response-unwrapper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"response-unwrapper.js","sourceRoot":"","sources":["../../../src/lib/utils/response-unwrapper.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkHH,wDA6CC;AA2KD,kCAEC;AAQD,sCAeC;AAjWD,6BAAwB;AAExB;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,SAAS,EAAE,WAAW;IACtB,gBAAgB,EAAE,kBAAkB;IACpC,OAAO,EAAE,SAAS;CACV,CAAC;AACX,oEAAsD;AAoCtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,qBAAqB,GAA8C;IACvE,YAAY,EAAE,OAAO,CAAC,yBAAsD;IAC5E,qBAAqB,EAAE,OAAO,CAAC,iCAA8D;IAC7F,gBAAgB,EAAE,OAAO,CAAC,4BAAyD;IACnF,gBAAgB,EAAE,OAAO,CAAC,4BAAyD;IACnF,cAAc,EAAE,OAAO,CAAC,2BAAkC,EAAE,uCAAuC;IACnG,cAAc,EAAE,OAAO,CAAC,2BAAwD;IAChF,sBAAsB,EAAE,OAAO,CAAC,iCAA8D;IAC9F,0BAA0B,EAAE,OAAO,CAAC,sCAAmE;IACvG,4BAA4B,EAAE,OAAO,CAAC,wCAAqE;IAC3G,cAAc,EAAE,OAAO,CAAC,2BAAwD;IAChF,gBAAgB,EAAE,OAAO,CAAC,6BAAoC,EAAE,uCAAuC;IACvG,WAAW,EAAE,OAAO,CAAC,wBAAqD;IAC1E,eAAe,EAAE,OAAO,CAAC,4BAAyD;CACnF,CAAC;AAEF;;;;;;;;GAQG;AACH,SAAgB,sBAAsB,CACpC,gBAAqB,EACrB,QAAiB,EACjB,QAAwB;IAExB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,yCAAyC;IACzC,IAAI,SAAc,CAAC;IACnB,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,SAAS,GAAG,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IAClD,CAAC;SAAM,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QAC9B,SAAS,GAAG,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IAClD,CAAC;SAAM,CAAC;QACN,wCAAwC;QACxC,IAAI,aAAa,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACpC,SAAS,GAAG,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,aAAa,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC3C,SAAS,GAAG,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,yDAAyD;IACzD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,MAAM,EAAE,CAAC;YACX,yDAAyD;YACzD,uFAAuF;YACvF,MAAM,aAAa,GAAG,OAAC,CAAC,YAAY,CAAC,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;YAE5F,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAClD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACzF,CAAC;YAED,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,QAAa;IAClC,OAAO,mBAAmB,IAAI,QAAQ,IAAI,SAAS,IAAI,QAAQ,IAAI,SAAS,IAAI,QAAQ,CAAC;AAC3F,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,QAAa;IAClC,OAAO,QAAQ,IAAI,QAAQ,IAAI,OAAO,IAAI,QAAQ,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,QAAa;IACtC,qBAAqB;IACrB,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;YAClD,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,IAAI;YAC5D,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,IAAI,eAAe,CAAC;QAE9C,OAAO;YACL,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,WAAW,CAAC,SAAS;oBAC3B,OAAO,EAAE,YAAY,IAAI,sBAAsB;iBAChD;aACF;SACF,CAAC;IACJ,CAAC;IAED,8CAA8C;IAC9C,IAAI,QAAQ,CAAC,iBAAiB,KAAK,SAAS,IAAI,QAAQ,CAAC,iBAAiB,KAAK,IAAI,EAAE,CAAC;QACpF,MAAM,IAAI,GAAG,QAAQ,CAAC,iBAAiB,CAAC;QAExC,uEAAuE;QACvE,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,IAAI,QAAQ,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACxD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACpC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBACtC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;QAED,yDAAyD;QACzD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO;gBACL,GAAG,IAAI;gBACP,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;aAClC,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kDAAkD;IAClD,IAAI,QAAQ,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QACzE,IAAI,WAAW,EAAE,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACP,wDAAwD;gBACxD,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC;gBAE9G,OAAO;oBACL,MAAM,EAAE;wBACN;4BACE,IAAI,EAAE,WAAW,CAAC,gBAAgB;4BAClC,OAAO,EAAE,kEAAkE,OAAO,GAAG;yBACtF;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,iBAAiB,CAAC,QAAa;IACtC,2DAA2D;IAC3D,2EAA2E;IAC3E,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QACnF,MAAM,IAAI,KAAK,CACb,wDAAwD,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI;YACtF,+CAA+C,CAClD,CAAC;IACJ,CAAC;IACD,sCAAsC;IACtC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO;YACL,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,WAAW,CAAC,OAAO;oBAC5D,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,IAAI,6BAA6B;oBAChE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;iBAC1D;aACF;SACF,CAAC;IACJ,CAAC;IAED,8DAA8D;IAC9D,0EAA0E;IAC1E,6FAA6F;IAC7F,6DAA6D;IAE7D,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC7C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,2EAA2E;IAC3E,0EAA0E;IAC1E,sFAAsF;IACtF,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,uDAAuD;IACvD,2FAA2F;IAC3F,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjD,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEzG,4EAA4E;IAC5E,IAAI,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IACzB,IAAI,IAAI,EAAE,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzF,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,oCAAoC;IACpC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,GAAG,IAAI;YACP,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;SAC/B,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,QAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;AACvE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,QAAa,EAAE,QAAgB;IAC3D,wCAAwC;IACxC,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+CAA+C;IAC/C,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC1C,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,6DAA6D;IAC7D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/version.d.ts

@@ -1,20 +1,28 @@
 /**
  * AdCP client library version
  */
-export declare const LIBRARY_VERSION = "2.7.2";
+export declare const LIBRARY_VERSION = "3.1.0";
 /**
  * AdCP specification version this library is compatible with
  */
-export declare const ADCP_VERSION = "2.4.0";
+export declare const ADCP_VERSION = "v2.5";
 /**
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "2.7.2";
-    readonly adcp: "2.4.0";
+    readonly library: "3.1.0";
+    readonly adcp: "v2.5";
     readonly compatible: true;
-    readonly generatedAt: "2025-11-09T11:35:59.460Z";
+    readonly generatedAt: "2025-11-23T13:15:41.727Z";
 };
+/**
+ * Get the AdCP specification version this library is built for
+ */
+export declare function getAdcpVersion(): string;
+/**
+ * Get the library version
+ */
+export declare function getLibraryVersion(): string;
 /**
  * Check if this library version is compatible with a given AdCP version
  */

package/dist/lib/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAI7D"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,YAAY,SAAS,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAI7D"}

package/dist/lib/version.js

@@ -3,24 +3,38 @@
 // This file is auto-generated by sync-version.ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION_INFO = exports.ADCP_VERSION = exports.LIBRARY_VERSION = void 0;
+exports.getAdcpVersion = getAdcpVersion;
+exports.getLibraryVersion = getLibraryVersion;
 exports.isCompatibleWith = isCompatibleWith;
 /**
  * AdCP client library version
  */
-exports.LIBRARY_VERSION = '2.7.2';
+exports.LIBRARY_VERSION = '3.1.0';
 /**
  * AdCP specification version this library is compatible with
  */
-exports.ADCP_VERSION = '2.4.0';
+exports.ADCP_VERSION = 'v2.5';
 /**
  * Full version information
  */
 exports.VERSION_INFO = {
-    library: '2.7.2',
-    adcp: '2.4.0',
+    library: '3.1.0',
+    adcp: 'v2.5',
     compatible: true,
-    generatedAt: '2025-11-09T11:35:59.460Z',
+    generatedAt: '2025-11-23T13:15:41.727Z',
 };
+/**
+ * Get the AdCP specification version this library is built for
+ */
+function getAdcpVersion() {
+    return exports.ADCP_VERSION;
+}
+/**
+ * Get the library version
+ */
+function getLibraryVersion() {
+    return exports.LIBRARY_VERSION;
+}
 /**
  * Check if this library version is compatible with a given AdCP version
  */

package/dist/lib/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,iDAAiD;;;AAyBjD,4CAIC;AA3BD;;GAEG;AACU,QAAA,eAAe,GAAG,OAAO,CAAC;AAEvC;;GAEG;AACU,QAAA,YAAY,GAAG,OAAO,CAAC;AAEpC;;GAEG;AACU,QAAA,YAAY,GAAG;IAC1B,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,OAAO;IACb,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,0BAA0B;CAC/B,CAAC;AAEX;;GAEG;AACH,SAAgB,gBAAgB,CAAC,WAAmB;IAClD,yCAAyC;IACzC,iEAAiE;IACjE,OAAO,WAAW,KAAK,oBAAY,CAAC;AACtC,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,iDAAiD;;;AAyBjD,wCAEC;AAKD,8CAEC;AAKD,4CAIC;AAzCD;;GAEG;AACU,QAAA,eAAe,GAAG,OAAO,CAAC;AAEvC;;GAEG;AACU,QAAA,YAAY,GAAG,MAAM,CAAC;AAEnC;;GAEG;AACU,QAAA,YAAY,GAAG;IAC1B,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,0BAA0B;CAC/B,CAAC;AAEX;;GAEG;AACH,SAAgB,cAAc;IAC5B,OAAO,oBAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,uBAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,WAAmB;IAClD,yCAAyC;IACzC,iEAAiE;IACjE,OAAO,WAAW,KAAK,oBAAY,CAAC;AACtC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adcp/client",
-  "version": "3.0.3",
+  "version": "3.2.0",
   "description": "AdCP client library with protocol support for MCP and A2A, includes testing framework",
   "main": "dist/lib/index.js",
   "types": "dist/lib/index.d.ts",
@@ -66,10 +66,8 @@
     "prepublishOnly": "npm run clean && (test -f src/lib/types/tools.generated.ts || npm run sync-schemas) && (test -f src/lib/types/tools.generated.ts || npm run generate-types) && npm run build:lib && node --test test/lib/adcp-client.test.js test/lib/validation.test.js test/lib/zod-schemas.test.js",
     "docs": "typedoc",
     "docs:watch": "typedoc --watch",
-    "docs:serve": "cd docs && make serve",
-    "docs:serve-simple": "echo '📚 Docs available at: file://'$(pwd)'/docs/index.html' && echo '🐳 For live preview: npm run docs:serve (Docker)' && echo '📦 Alternative: npx http-server docs -p 4000'",
-    "docs:build": "npm run docs && cd docs && make build",
-    "docs:install": "cd docs && make install",
+    "docs:serve": "npx http-server docs -p 4000 -o",
+    "docs:open": "open docs/api/index.html || xdg-open docs/api/index.html || start docs/api/index.html",
     "ci:validate": "node scripts/ci-validate.js",
     "ci:quick": "npm run format:check && npm run typecheck && npm run build:lib && npm test",
     "ci:schema-check": "npm run sync-schemas && npm run generate-types && git diff --exit-code src/lib/types/ src/lib/agents/ || (echo '⚠️  Generated files are out of sync. Run: npm run sync-schemas && npm run generate-types' && exit 1)",
@@ -149,7 +147,8 @@
     "node": ">=18.0.0"
   },
   "overrides": {
-    "@types/glob": "^8.1.0"
+    "@types/glob": "^8.1.0",
+    "js-yaml": "^4.1.1"
   },
-  "adcp_version": "2.4.0"
+  "adcp_version": "v2.5"
 }