@adcp/client 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ad Context Protocol
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,166 @@
+# @adcp/client
+
+[![npm version](https://badge.fury.io/js/@adcp%2Fclient.svg)](https://badge.fury.io/js/@adcp%2Fclient)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+[![Documentation](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://your-org.github.io/adcp-client/)
+
+Official TypeScript/JavaScript client for the **Ad Context Protocol (AdCP)**. Seamlessly communicate with advertising agents using MCP and A2A protocols.
+
+## Installation
+
+```bash
+npm install @adcp/client
+```
+
+## Quick Start
+
+```typescript
+import { ADCPClient } from '@adcp/client';
+
+// Simple setup with direct URL
+const client = ADCPClient.simple('https://agent.example.com/mcp/', {
+  authToken: 'your-auth-token'
+});
+
+// Execute a task
+const result = await client.executeTask('get_products', {
+  brief: 'Looking for premium coffee advertising',
+  promoted_offering: 'Artisan coffee blends'
+});
+
+if (result.success) {
+  console.log('Products:', result.data.products);
+} else {
+  console.error('Error:', result.error);
+}
+```
+
+## Key Features
+
+- **🔗 Unified Interface** - Single API for MCP and A2A protocols
+- **⚡ Async Support** - Handle long-running tasks with webhooks and deferrals
+- **🔐 Built-in Auth** - Bearer tokens and API key support
+- **🛡️ Type Safe** - Full TypeScript with comprehensive types
+- **📊 Production Ready** - Circuit breakers, retries, and validation
+
+## Async Execution Model
+
+Handle complex async patterns with ease:
+
+```typescript
+// Configure input handler for interactive tasks
+const client = ADCPClient.simple('https://agent.example.com', {
+  authToken: 'token',
+  inputHandler: async (request) => {
+    // Handle 'input-required' status
+    if (request.type === 'user_approval') {
+      const approved = await getUserApproval(request.data);
+      return { approved };
+    }
+    // Defer for human review
+    return { defer: true };
+  }
+});
+
+// Long-running server task (returns immediately)
+const result = await client.executeTask('analyze_campaign', {
+  campaign_id: '12345'
+});
+
+if (result.status === 'submitted') {
+  // Task running on server, will notify via webhook
+  console.log('Task ID:', result.submitted.taskId);
+  console.log('Webhook:', result.submitted.webhookUrl);
+}
+
+// Client-deferred task (needs human input)
+if (result.status === 'deferred') {
+  // Save continuation for later
+  const continuation = result.deferred;
+  
+  // ... later, after human provides input ...
+  const finalResult = await client.resumeDeferredTask(
+    continuation,
+    { approved: true, budget: 50000 }
+  );
+}
+```
+
+## Multi-Agent Support
+
+```typescript
+import { ADCPMultiAgentClient } from '@adcp/client';
+
+const client = new ADCPMultiAgentClient([
+  { 
+    id: 'agent1',
+    name: 'MCP Agent',
+    agent_uri: 'https://agent1.example.com/mcp/',
+    protocol: 'mcp',
+    requiresAuth: true,
+    auth_token_env: 'AGENT1_TOKEN'
+  },
+  {
+    id: 'agent2', 
+    name: 'A2A Agent',
+    agent_uri: 'https://agent2.example.com',
+    protocol: 'a2a'
+  }
+]);
+
+// Execute on specific agent
+const result = await client.executeTask('agent1', 'get_products', params);
+
+// Execute on all agents in parallel
+const results = await client.executeTaskOnAll('get_products', params);
+```
+
+## Documentation
+
+- 📚 **[Full Documentation](https://your-org.github.io/adcp-client/)** - Complete guides and API reference
+- 🚀 **[Getting Started Guide](https://your-org.github.io/adcp-client/getting-started)** - Step-by-step tutorial
+- 🔄 **[Async Patterns](https://your-org.github.io/adcp-client/async-patterns)** - Handle complex async flows
+- 📖 **[API Reference](https://your-org.github.io/adcp-client/api)** - Generated from TypeDoc
+- 💡 **[Examples](./examples/)** - Real-world usage examples
+
+## Examples
+
+```bash
+# Clone for full examples
+git clone https://github.com/your-org/adcp-client
+cd adcp-client/examples
+
+# Run examples
+npx tsx basic-usage.ts
+npx tsx async-patterns.ts
+npx tsx multi-agent.ts
+```
+
+## Testing UI
+
+The package includes an interactive testing framework:
+
+```bash
+# Install and run locally
+git clone https://github.com/your-org/adcp-client
+cd adcp-client
+npm install
+npm run dev
+
+# Open http://localhost:8080
+```
+
+## Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT - see [LICENSE](./LICENSE) for details.
+
+## Links
+
+- [AdCP Specification](https://adcontextprotocol.org)
+- [Issue Tracker](https://github.com/your-org/adcp-client/issues)
+- [npm Package](https://www.npmjs.com/package/@adcp/client)

package/dist/lib/agents/index.generated.d.ts

@@ -0,0 +1,147 @@
+import type { AgentConfig } from '../types';
+import type { GetProductsRequest, GetProductsResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse, CreateMediaBuyRequest, CreateMediaBuyResponse, SyncCreativesRequest, SyncCreativesResponse, ListCreativesRequest, ListCreativesResponse, UpdateMediaBuyRequest, UpdateMediaBuyResponse, GetMediaBuyDeliveryRequest, GetMediaBuyDeliveryResponse, ListAuthorizedPropertiesRequest, ListAuthorizedPropertiesResponse, ProvidePerformanceFeedbackRequest, ProvidePerformanceFeedbackResponse, GetSignalsRequest, GetSignalsResponse, ActivateSignalRequest, ActivateSignalResponse } from '../types/tools.generated';
+interface ToolResponse<T> {
+    success: true;
+    data: T;
+    agent: {
+        id: string;
+        name: string;
+        protocol: 'mcp' | 'a2a';
+    };
+    responseTimeMs: number;
+    timestamp: string;
+    debugLogs?: any[];
+}
+interface ToolError {
+    success: false;
+    error: string;
+    agent: {
+        id: string;
+        name: string;
+        protocol: 'mcp' | 'a2a';
+    };
+    responseTimeMs: number;
+    timestamp: string;
+    debugLogs?: any[];
+}
+type ToolResult<T> = ToolResponse<T> | ToolError;
+/**
+ * Single agent operations with full type safety
+ */
+export declare class Agent {
+    private config;
+    private client;
+    constructor(config: AgentConfig, client: any);
+    private callTool;
+    /**
+     * Official AdCP get_products tool schema
+     * Official AdCP get_products tool schema
+     */
+    getProducts(params: GetProductsRequest): Promise<ToolResult<GetProductsResponse>>;
+    /**
+     * Official AdCP list_creative_formats tool schema
+     * Official AdCP list_creative_formats tool schema
+     */
+    listCreativeFormats(params: ListCreativeFormatsRequest): Promise<ToolResult<ListCreativeFormatsResponse>>;
+    /**
+     * Official AdCP create_media_buy tool schema
+     * Official AdCP create_media_buy tool schema
+     */
+    createMediaBuy(params: CreateMediaBuyRequest): Promise<ToolResult<CreateMediaBuyResponse>>;
+    /**
+     * Official AdCP sync_creatives tool schema
+     * Official AdCP sync_creatives tool schema
+     */
+    syncCreatives(params: SyncCreativesRequest): Promise<ToolResult<SyncCreativesResponse>>;
+    /**
+     * Official AdCP list_creatives tool schema
+     * Official AdCP list_creatives tool schema
+     */
+    listCreatives(params: ListCreativesRequest): Promise<ToolResult<ListCreativesResponse>>;
+    /**
+     * Official AdCP update_media_buy tool schema
+     * Official AdCP update_media_buy tool schema
+     */
+    updateMediaBuy(params: UpdateMediaBuyRequest): Promise<ToolResult<UpdateMediaBuyResponse>>;
+    /**
+     * Official AdCP get_media_buy_delivery tool schema
+     * Official AdCP get_media_buy_delivery tool schema
+     */
+    getMediaBuyDelivery(params: GetMediaBuyDeliveryRequest): Promise<ToolResult<GetMediaBuyDeliveryResponse>>;
+    /**
+     * Official AdCP list_authorized_properties tool schema
+     * Official AdCP list_authorized_properties tool schema
+     */
+    listAuthorizedProperties(params: ListAuthorizedPropertiesRequest): Promise<ToolResult<ListAuthorizedPropertiesResponse>>;
+    /**
+     * Official AdCP provide_performance_feedback tool schema
+     * Official AdCP provide_performance_feedback tool schema
+     */
+    providePerformanceFeedback(params: ProvidePerformanceFeedbackRequest): Promise<ToolResult<ProvidePerformanceFeedbackResponse>>;
+    /**
+     * Official AdCP get_signals tool schema
+     * Official AdCP get_signals tool schema
+     */
+    getSignals(params: GetSignalsRequest): Promise<ToolResult<GetSignalsResponse>>;
+    /**
+     * Official AdCP activate_signal tool schema
+     * Official AdCP activate_signal tool schema
+     */
+    activateSignal(params: ActivateSignalRequest): Promise<ToolResult<ActivateSignalResponse>>;
+}
+/**
+ * Multi-agent operations with full type safety
+ */
+export declare class AgentCollection {
+    private configs;
+    private client;
+    constructor(configs: AgentConfig[], client: any);
+    private callToolOnAll;
+    /**
+     * Official AdCP get_products tool schema (across multiple agents)
+     * Official AdCP get_products tool schema
+     */
+    getProducts(params: GetProductsRequest): Promise<ToolResult<GetProductsResponse>[]>;
+    /**
+     * Official AdCP list_creative_formats tool schema (across multiple agents)
+     * Official AdCP list_creative_formats tool schema
+     */
+    listCreativeFormats(params: ListCreativeFormatsRequest): Promise<ToolResult<ListCreativeFormatsResponse>[]>;
+    /**
+     * Official AdCP sync_creatives tool schema (across multiple agents)
+     * Official AdCP sync_creatives tool schema
+     */
+    syncCreatives(params: SyncCreativesRequest): Promise<ToolResult<SyncCreativesResponse>[]>;
+    /**
+     * Official AdCP list_creatives tool schema (across multiple agents)
+     * Official AdCP list_creatives tool schema
+     */
+    listCreatives(params: ListCreativesRequest): Promise<ToolResult<ListCreativesResponse>[]>;
+    /**
+     * Official AdCP get_media_buy_delivery tool schema (across multiple agents)
+     * Official AdCP get_media_buy_delivery tool schema
+     */
+    getMediaBuyDelivery(params: GetMediaBuyDeliveryRequest): Promise<ToolResult<GetMediaBuyDeliveryResponse>[]>;
+    /**
+     * Official AdCP list_authorized_properties tool schema (across multiple agents)
+     * Official AdCP list_authorized_properties tool schema
+     */
+    listAuthorizedProperties(params: ListAuthorizedPropertiesRequest): Promise<ToolResult<ListAuthorizedPropertiesResponse>[]>;
+    /**
+     * Official AdCP provide_performance_feedback tool schema (across multiple agents)
+     * Official AdCP provide_performance_feedback tool schema
+     */
+    providePerformanceFeedback(params: ProvidePerformanceFeedbackRequest): Promise<ToolResult<ProvidePerformanceFeedbackResponse>[]>;
+    /**
+     * Official AdCP get_signals tool schema (across multiple agents)
+     * Official AdCP get_signals tool schema
+     */
+    getSignals(params: GetSignalsRequest): Promise<ToolResult<GetSignalsResponse>[]>;
+    /**
+     * Official AdCP activate_signal tool schema (across multiple agents)
+     * Official AdCP activate_signal tool schema
+     */
+    activateSignal(params: ActivateSignalRequest): Promise<ToolResult<ActivateSignalResponse>[]>;
+}
+export {};
+//# sourceMappingURL=index.generated.d.ts.map

package/dist/lib/agents/index.generated.d.ts.map

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

package/dist/lib/agents/index.generated.js

@@ -0,0 +1,218 @@
+"use strict";
+// Generated Agent Classes
+// Auto-generated from AdCP tool definitions
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentCollection = exports.Agent = void 0;
+const protocols_1 = require("../protocols");
+const validation_1 = require("../validation");
+const utils_1 = require("../utils");
+/**
+ * Single agent operations with full type safety
+ */
+class Agent {
+    config;
+    client;
+    constructor(config, client // Will be AdCPClient
+    ) {
+        this.config = config;
+        this.client = client;
+    }
+    async callTool(toolName, params) {
+        const startTime = Date.now();
+        const debugLogs = [];
+        try {
+            (0, validation_1.validateAgentUrl)(this.config.agent_uri);
+            const circuitBreaker = (0, utils_1.getCircuitBreaker)(this.config.id);
+            const result = await circuitBreaker.call(async () => {
+                return await protocols_1.ProtocolClient.callTool(this.config, toolName, params, debugLogs);
+            });
+            return {
+                success: true,
+                data: result,
+                agent: {
+                    id: this.config.id,
+                    name: this.config.name,
+                    protocol: this.config.protocol
+                },
+                responseTimeMs: Date.now() - startTime,
+                timestamp: new Date().toISOString(),
+                debugLogs
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                success: false,
+                error: errorMessage,
+                agent: {
+                    id: this.config.id,
+                    name: this.config.name,
+                    protocol: this.config.protocol
+                },
+                responseTimeMs: Date.now() - startTime,
+                timestamp: new Date().toISOString(),
+                debugLogs
+            };
+        }
+    }
+    /**
+     * Official AdCP get_products tool schema
+     * Official AdCP get_products tool schema
+     */
+    async getProducts(params) {
+        return this.callTool('get_products', params);
+    }
+    /**
+     * Official AdCP list_creative_formats tool schema
+     * Official AdCP list_creative_formats tool schema
+     */
+    async listCreativeFormats(params) {
+        return this.callTool('list_creative_formats', params);
+    }
+    /**
+     * Official AdCP create_media_buy tool schema
+     * Official AdCP create_media_buy tool schema
+     */
+    async createMediaBuy(params) {
+        return this.callTool('create_media_buy', params);
+    }
+    /**
+     * Official AdCP sync_creatives tool schema
+     * Official AdCP sync_creatives tool schema
+     */
+    async syncCreatives(params) {
+        return this.callTool('sync_creatives', params);
+    }
+    /**
+     * Official AdCP list_creatives tool schema
+     * Official AdCP list_creatives tool schema
+     */
+    async listCreatives(params) {
+        return this.callTool('list_creatives', params);
+    }
+    /**
+     * Official AdCP update_media_buy tool schema
+     * Official AdCP update_media_buy tool schema
+     */
+    async updateMediaBuy(params) {
+        return this.callTool('update_media_buy', params);
+    }
+    /**
+     * Official AdCP get_media_buy_delivery tool schema
+     * Official AdCP get_media_buy_delivery tool schema
+     */
+    async getMediaBuyDelivery(params) {
+        return this.callTool('get_media_buy_delivery', params);
+    }
+    /**
+     * Official AdCP list_authorized_properties tool schema
+     * Official AdCP list_authorized_properties tool schema
+     */
+    async listAuthorizedProperties(params) {
+        return this.callTool('list_authorized_properties', params);
+    }
+    /**
+     * Official AdCP provide_performance_feedback tool schema
+     * Official AdCP provide_performance_feedback tool schema
+     */
+    async providePerformanceFeedback(params) {
+        return this.callTool('provide_performance_feedback', params);
+    }
+    /**
+     * Official AdCP get_signals tool schema
+     * Official AdCP get_signals tool schema
+     */
+    async getSignals(params) {
+        return this.callTool('get_signals', params);
+    }
+    /**
+     * Official AdCP activate_signal tool schema
+     * Official AdCP activate_signal tool schema
+     */
+    async activateSignal(params) {
+        return this.callTool('activate_signal', params);
+    }
+}
+exports.Agent = Agent;
+/**
+ * Multi-agent operations with full type safety
+ */
+class AgentCollection {
+    configs;
+    client;
+    constructor(configs, client // Will be AdCPClient
+    ) {
+        this.configs = configs;
+        this.client = client;
+    }
+    async callToolOnAll(toolName, params) {
+        const agents = this.configs.map(config => new Agent(config, this.client));
+        const promises = agents.map(agent => agent.callTool(toolName, params));
+        return Promise.all(promises);
+    }
+    /**
+     * Official AdCP get_products tool schema (across multiple agents)
+     * Official AdCP get_products tool schema
+     */
+    async getProducts(params) {
+        return this.callToolOnAll('get_products', params);
+    }
+    /**
+     * Official AdCP list_creative_formats tool schema (across multiple agents)
+     * Official AdCP list_creative_formats tool schema
+     */
+    async listCreativeFormats(params) {
+        return this.callToolOnAll('list_creative_formats', params);
+    }
+    /**
+     * Official AdCP sync_creatives tool schema (across multiple agents)
+     * Official AdCP sync_creatives tool schema
+     */
+    async syncCreatives(params) {
+        return this.callToolOnAll('sync_creatives', params);
+    }
+    /**
+     * Official AdCP list_creatives tool schema (across multiple agents)
+     * Official AdCP list_creatives tool schema
+     */
+    async listCreatives(params) {
+        return this.callToolOnAll('list_creatives', params);
+    }
+    /**
+     * Official AdCP get_media_buy_delivery tool schema (across multiple agents)
+     * Official AdCP get_media_buy_delivery tool schema
+     */
+    async getMediaBuyDelivery(params) {
+        return this.callToolOnAll('get_media_buy_delivery', params);
+    }
+    /**
+     * Official AdCP list_authorized_properties tool schema (across multiple agents)
+     * Official AdCP list_authorized_properties tool schema
+     */
+    async listAuthorizedProperties(params) {
+        return this.callToolOnAll('list_authorized_properties', params);
+    }
+    /**
+     * Official AdCP provide_performance_feedback tool schema (across multiple agents)
+     * Official AdCP provide_performance_feedback tool schema
+     */
+    async providePerformanceFeedback(params) {
+        return this.callToolOnAll('provide_performance_feedback', params);
+    }
+    /**
+     * Official AdCP get_signals tool schema (across multiple agents)
+     * Official AdCP get_signals tool schema
+     */
+    async getSignals(params) {
+        return this.callToolOnAll('get_signals', params);
+    }
+    /**
+     * Official AdCP activate_signal tool schema (across multiple agents)
+     * Official AdCP activate_signal tool schema
+     */
+    async activateSignal(params) {
+        return this.callToolOnAll('activate_signal', params);
+    }
+}
+exports.AgentCollection = AgentCollection;
+//# sourceMappingURL=index.generated.js.map

package/dist/lib/agents/index.generated.js.map

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

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

@@ -0,0 +1,22 @@
+import type { AgentConfig } from '../types';
+/**
+ * Generate UUID for request tracking
+ */
+export declare function generateUUID(): string;
+/**
+ * Get authentication token for an agent
+ */
+export declare function getAuthToken(agent: AgentConfig): string | undefined;
+/**
+ * Create AdCP-compliant headers
+ */
+export declare function createAdCPHeaders(authToken?: string, isMCP?: boolean): Record<string, string>;
+/**
+ * Create an authenticated fetch function for A2A client
+ */
+export declare function createAuthenticatedFetch(authToken: string): (url: string | URL | Request, options?: RequestInit) => Promise<Response>;
+/**
+ * Create MCP authentication headers
+ */
+export declare function createMCPAuthHeaders(authToken?: string): Record<string, string>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAanE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASpG;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,IAC1C,KAAK,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,UAAU,WAAW,uBAWjE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAU/E"}

package/dist/lib/auth/index.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateUUID = generateUUID;
+exports.getAuthToken = getAuthToken;
+exports.createAdCPHeaders = createAdCPHeaders;
+exports.createAuthenticatedFetch = createAuthenticatedFetch;
+exports.createMCPAuthHeaders = createMCPAuthHeaders;
+/**
+ * Generate UUID for request tracking
+ */
+function generateUUID() {
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+        const r = Math.random() * 16 | 0;
+        const v = c == 'x' ? r : (r & 0x3 | 0x8);
+        return v.toString(16);
+    });
+}
+/**
+ * Get authentication token for an agent
+ */
+function getAuthToken(agent) {
+    if (!agent.requiresAuth || !agent.auth_token_env) {
+        return undefined;
+    }
+    // If auth_token_env looks like a direct token (not an env var name), use it directly
+    // Base64-like tokens are typically 40+ chars and contain mixed case/symbols
+    if (agent.auth_token_env.length > 20 && !agent.auth_token_env.match(/^[A-Z_][A-Z0-9_]*$/)) {
+        return agent.auth_token_env;
+    }
+    // Otherwise, look up the environment variable
+    return process.env[agent.auth_token_env];
+}
+/**
+ * Create AdCP-compliant headers
+ */
+function createAdCPHeaders(authToken, isMCP = false) {
+    return {
+        'Content-Type': isMCP ? 'application/json' : 'application/vnd.adcp+json',
+        'AdCP-Version': '1.0',
+        'AdCP-Request-ID': generateUUID(),
+        'User-Agent': 'AdCP-Testing-Framework/1.0.0',
+        'Accept': isMCP ? 'application/json, text/event-stream' : 'application/vnd.adcp+json, application/json',
+        ...(authToken && { 'Authorization': `Bearer ${authToken}` })
+    };
+}
+/**
+ * Create an authenticated fetch function for A2A client
+ */
+function createAuthenticatedFetch(authToken) {
+    return async (url, options) => {
+        const headers = createAdCPHeaders(authToken);
+        return fetch(url, {
+            ...options,
+            headers: {
+                ...headers,
+                ...(options?.headers || {})
+            }
+        });
+    };
+}
+/**
+ * Create MCP authentication headers
+ */
+function createMCPAuthHeaders(authToken) {
+    const headers = {
+        'Accept': 'application/json, text/event-stream'
+    };
+    if (authToken) {
+        headers['x-adcp-auth'] = authToken;
+    }
+    return headers;
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/auth/index.ts"],"names":[],"mappings":";;AAKA,oCAMC;AAKD,oCAaC;AAKD,8CASC;AAKD,4DAYC;AAKD,oDAUC;AAzED;;GAEG;AACH,SAAgB,YAAY;IAC1B,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,UAAS,CAAC;QACvE,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QACzC,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,KAAkB;IAC7C,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QACjD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,qFAAqF;IACrF,4EAA4E;IAC5E,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC1F,OAAO,KAAK,CAAC,cAAc,CAAC;IAC9B,CAAC;IAED,8CAA8C;IAC9C,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,SAAkB,EAAE,QAAiB,KAAK;IAC1E,OAAO;QACL,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,2BAA2B;QACxE,cAAc,EAAE,KAAK;QACrB,iBAAiB,EAAE,YAAY,EAAE;QACjC,YAAY,EAAE,8BAA8B;QAC5C,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC,6CAA6C;QACvG,GAAG,CAAC,SAAS,IAAI,EAAE,eAAe,EAAE,UAAU,SAAS,EAAE,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,wBAAwB,CAAC,SAAiB;IACxD,OAAO,KAAK,EAAE,GAA2B,EAAE,OAAqB,EAAE,EAAE;QAClE,MAAM,OAAO,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAE7C,OAAO,KAAK,CAAC,GAAG,EAAE;YAChB,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,GAAG,OAAO;gBACV,GAAG,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;aAC5B;SACF,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,SAAkB;IACrD,MAAM,OAAO,GAA2B;QACtC,QAAQ,EAAE,qCAAqC;KAChD,CAAC;IAEF,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC;IACrC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}