@adcp/client 2.7.1 → 3.0.0

package/bin/adcp-async-handler.js

@@ -30,9 +30,9 @@ class AsyncWebhookHandler {
    * Check if ngrok is installed
    */
   static isNgrokAvailable() {
-    return new Promise((resolve) => {
+    return new Promise(resolve => {
       const check = spawn('which', ['ngrok']);
-      check.on('close', (code) => resolve(code === 0));
+      check.on('close', code => resolve(code === 0));
     });
   }
 
@@ -61,7 +61,9 @@ class AsyncWebhookHandler {
       if (ngrokAvailable) {
         await this.startNgrok();
       } else {
-        throw new Error('ngrok is not installed. Install it with: brew install ngrok (Mac) or download from https://ngrok.com');
+        throw new Error(
+          'ngrok is not installed. Install it with: brew install ngrok (Mac) or download from https://ngrok.com'
+        );
       }
     } else {
       // Use local URL (for local agents)
@@ -150,7 +152,7 @@ class AsyncWebhookHandler {
       let ngrokStarted = false;
       let buffer = '';
 
-      this.ngrokProcess.stdout.on('data', (data) => {
+      this.ngrokProcess.stdout.on('data', data => {
         buffer += data.toString();
         const lines = buffer.split('\n');
         buffer = lines.pop() || ''; // Keep incomplete line in buffer
@@ -190,17 +192,17 @@ class AsyncWebhookHandler {
         }
       });
 
-      this.ngrokProcess.stderr.on('data', (data) => {
+      this.ngrokProcess.stderr.on('data', data => {
         if (this.debug) {
           console.error('ngrok stderr:', data.toString());
         }
       });
 
-      this.ngrokProcess.on('error', (error) => {
+      this.ngrokProcess.on('error', error => {
         reject(new Error(`Failed to start ngrok: ${error.message}`));
       });
 
-      this.ngrokProcess.on('close', (code) => {
+      this.ngrokProcess.on('close', code => {
         if (!ngrokStarted && code !== 0) {
           reject(new Error(`ngrok exited with code ${code}`));
         }
@@ -244,7 +246,7 @@ class AsyncWebhookHandler {
 
     // Close HTTP server
     if (this.server) {
-      await new Promise((resolve) => {
+      await new Promise(resolve => {
         this.server.close(() => resolve());
       });
     }

package/bin/adcp-config.js

@@ -126,10 +126,10 @@ function isAlias(str) {
 async function promptSecure(prompt, hidden = true) {
   const readline = require('readline');
 
-  return new Promise((resolve) => {
+  return new Promise(resolve => {
     const rl = readline.createInterface({
       input: process.stdin,
-      output: process.stdout
+      output: process.stdout,
     });
 
     if (hidden) {
@@ -146,7 +146,7 @@ async function promptSecure(prompt, hidden = true) {
       };
     }
 
-    rl.question(prompt, (answer) => {
+    rl.question(prompt, answer => {
       rl.close();
       if (hidden) {
         console.log(''); // New line after hidden input
@@ -165,7 +165,14 @@ async function promptSecure(prompt, hidden = true) {
  * @param {boolean} nonInteractive Skip prompts if all required args provided
  * @param {boolean} noAuth Explicitly skip auth (--no-auth flag)
  */
-async function interactiveSetup(alias, url = null, protocol = null, authToken = null, nonInteractive = false, noAuth = false) {
+async function interactiveSetup(
+  alias,
+  url = null,
+  protocol = null,
+  authToken = null,
+  nonInteractive = false,
+  noAuth = false
+) {
   // Non-interactive mode: save immediately without prompts
   if (nonInteractive && url) {
     const agentConfig = { url };
@@ -201,7 +208,7 @@ async function interactiveSetup(alias, url = null, protocol = null, authToken =
 
   // Build config
   const agentConfig = {
-    url: url
+    url: url,
   };
 
   if (protocol) {
@@ -229,5 +236,5 @@ module.exports = {
   removeAgent,
   isAlias,
   promptSecure,
-  interactiveSetup
+  interactiveSetup,
 };

package/bin/adcp.js

@@ -14,17 +14,10 @@
  *   adcp mcp https://agent.example.com/mcp create_media_buy @payload.json --auth $AGENT_TOKEN
  */
 
-const { ADCPClient, detectProtocol } = require('../dist/lib/index.js');
+const { AdCPClient, detectProtocol } = require('../dist/lib/index.js');
 const { readFileSync } = require('fs');
 const { AsyncWebhookHandler } = require('./adcp-async-handler.js');
-const {
-  getAgent,
-  listAgents,
-  isAlias,
-  interactiveSetup,
-  removeAgent,
-  getConfigPath
-} = require('./adcp-config.js');
+const { getAgent, listAgents, isAlias, interactiveSetup, removeAgent, getConfigPath } = require('./adcp-config.js');
 
 /**
  * Extract human-readable protocol message from conversation
@@ -72,7 +65,7 @@ function extractProtocolMessage(conversation, protocol) {
  * Display agent info - just calls library method
  */
 async function displayAgentInfo(agentConfig, jsonOutput) {
-  const client = new ADCPClient(agentConfig);
+  const client = new AdCPClient(agentConfig);
   const info = await client.getAgentInfo();
 
   if (jsonOutput) {
@@ -109,7 +102,7 @@ function printUsage() {
 AdCP CLI Tool - Direct Agent Communication
 
 USAGE:
-  adcp <agent-alias|url> [tool-name] [payload] [options]
+  npx @adcp/client <agent-alias|url> [tool-name] [payload] [options]
 
 ARGUMENTS:
   agent-alias|url   Saved agent alias (e.g., 'test') or full URL to agent endpoint
@@ -129,6 +122,13 @@ OPTIONS:
   --json            Output raw JSON response (default: pretty print)
   --debug           Show debug information
 
+BUILT-IN TEST AGENTS:
+  test                        AdCP public test agent (MCP, with auth)
+  test-a2a                    AdCP public test agent (A2A, with auth)
+  test-no-auth                AdCP public test agent (MCP, no auth - demonstrates errors)
+  test-a2a-no-auth            AdCP public test agent (A2A, no auth - demonstrates errors)
+  creative                    Official AdCP creative agent (MCP only)
+
 AGENT MANAGEMENT:
   --save-auth <alias> [url] [protocol] [--auth token | --no-auth]
                               Save agent configuration with an alias name
@@ -138,6 +138,17 @@ AGENT MANAGEMENT:
   --show-config               Show config file location
 
 EXAMPLES:
+  # Use built-in test agent (zero config!)
+  npx @adcp/client test
+  npx @adcp/client test get_products '{"brief":"coffee brands"}'
+  npx @adcp/client creative list_creative_formats
+
+  # Use built-in test agent with A2A protocol
+  npx @adcp/client test-a2a get_products '{"brief":"travel packages"}'
+
+  # Compare authenticated vs unauthenticated (demonstrates auth errors)
+  npx @adcp/client test-no-auth get_products '{"brief":"test"}'
+
   # Non-interactive: save with auth token
   adcp --save-auth myagent https://test-agent.adcontextprotocol.org --auth your_token
 
@@ -206,11 +217,9 @@ async function main() {
     const providedAuthToken = authFlagIndex !== -1 ? args[authFlagIndex + 1] : null;
 
     // Filter out flags to get positional args
-    const saveAuthPositional = args.slice(1).filter(arg =>
-      arg !== '--auth' &&
-      arg !== '--no-auth' &&
-      arg !== providedAuthToken
-    );
+    const saveAuthPositional = args
+      .slice(1)
+      .filter(arg => arg !== '--auth' && arg !== '--no-auth' && arg !== providedAuthToken);
 
     let alias = saveAuthPositional[0];
     let url = saveAuthPositional[1] || null;
@@ -325,11 +334,12 @@ async function main() {
   }
 
   // Filter out flag arguments to find positional arguments
-  const positionalArgs = args.filter(arg =>
-    !arg.startsWith('--') &&
-    arg !== authToken && // Don't include the auth token value
-    arg !== protocolFlag && // Don't include the protocol value
-    arg !== (timeoutIndex !== -1 ? args[timeoutIndex + 1] : null) // Don't include timeout value
+  const positionalArgs = args.filter(
+    arg =>
+      !arg.startsWith('--') &&
+      arg !== authToken && // Don't include the auth token value
+      arg !== protocolFlag && // Don't include the protocol value
+      arg !== (timeoutIndex !== -1 ? args[timeoutIndex + 1] : null) // Don't include timeout value
   );
 
   // Determine if first arg is alias or URL
@@ -341,8 +351,64 @@ async function main() {
 
   const firstArg = positionalArgs[0];
 
-  // Check if first arg is a saved alias
-  if (isAlias(firstArg)) {
+  // Built-in test helper aliases
+  const BUILT_IN_AGENTS = {
+    test: {
+      url: 'https://test-agent.adcontextprotocol.org/mcp/',
+      protocol: 'mcp',
+      auth_token: '1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ',
+      description: 'AdCP public test agent (MCP, with auth)',
+    },
+    'test-a2a': {
+      url: 'https://test-agent.adcontextprotocol.org',
+      protocol: 'a2a',
+      auth_token: '1v8tAhASaUYYp4odoQ1PnMpdqNaMiTrCRqYo9OJp6IQ',
+      description: 'AdCP public test agent (A2A, with auth)',
+    },
+    'test-no-auth': {
+      url: 'https://test-agent.adcontextprotocol.org/mcp/',
+      protocol: 'mcp',
+      description: 'AdCP public test agent (MCP, no auth - demonstrates auth errors)',
+    },
+    'test-a2a-no-auth': {
+      url: 'https://test-agent.adcontextprotocol.org',
+      protocol: 'a2a',
+      description: 'AdCP public test agent (A2A, no auth - demonstrates auth errors)',
+    },
+    creative: {
+      url: 'https://creative.adcontextprotocol.org/mcp',
+      protocol: 'mcp',
+      description: 'Official AdCP creative agent (MCP only)',
+    },
+  };
+
+  // Check if first arg is a built-in alias or saved alias
+  if (BUILT_IN_AGENTS[firstArg]) {
+    // Built-in test helper mode
+    savedAgent = BUILT_IN_AGENTS[firstArg];
+    agentUrl = savedAgent.url;
+
+    // Protocol priority: --protocol flag > built-in config
+    if (!protocol) {
+      protocol = savedAgent.protocol;
+    }
+
+    toolName = positionalArgs[1];
+    payloadArg = positionalArgs[2] || '{}';
+
+    // Use built-in auth token if not overridden and available
+    if (!authToken && savedAgent.auth_token) {
+      authToken = savedAgent.auth_token;
+    }
+
+    if (debug) {
+      console.error(`DEBUG: Using built-in agent '${firstArg}'`);
+      console.error(`  ${savedAgent.description}`);
+      console.error(`  URL: ${agentUrl}`);
+      console.error(`  Protocol: ${protocol}`);
+      console.error('');
+    }
+  } else if (isAlias(firstArg)) {
     // Alias mode - load saved agent config
     savedAgent = getAgent(firstArg);
     agentUrl = savedAgent.url;
@@ -436,7 +502,7 @@ async function main() {
     name: 'CLI Agent',
     agent_uri: agentUrl,
     protocol: protocol,
-    ...(authToken && { auth_token_env: authToken })
+    ...(authToken && { auth_token_env: authToken, requiresAuth: true }),
   };
 
   try {
@@ -477,7 +543,7 @@ async function main() {
 
       webhookHandler = new AsyncWebhookHandler({
         timeout: timeout,
-        debug: debug
+        debug: debug,
       });
 
       try {
@@ -504,12 +570,12 @@ async function main() {
     }
 
     // Create ADCP client with optional webhook configuration
-    const client = new ADCPClient(agentConfig, {
+    const client = new AdCPClient(agentConfig, {
       debug: debug,
       ...(webhookUrl && {
         webhookUrlTemplate: webhookUrl,
-        webhookSecret: 'cli-webhook-secret'
-      })
+        webhookSecret: 'cli-webhook-secret',
+      }),
     });
 
     if (debug) {
@@ -558,18 +624,25 @@ async function main() {
     if (result.success) {
       if (jsonOutput) {
         // Raw JSON output - include protocol metadata
-        console.log(JSON.stringify({
-          data: result.data,
-          metadata: {
-            taskId: result.metadata.taskId,
-            protocol: result.metadata.agent.protocol,
-            responseTimeMs: result.metadata.responseTimeMs,
-            ...(result.conversation && result.conversation.length > 0 && {
-              protocolMessage: extractProtocolMessage(result.conversation, result.metadata.agent.protocol),
-              contextId: result.metadata.taskId  // Using taskId as context identifier
-            })
-          }
-        }, null, 2));
+        console.log(
+          JSON.stringify(
+            {
+              data: result.data,
+              metadata: {
+                taskId: result.metadata.taskId,
+                protocol: result.metadata.agent.protocol,
+                responseTimeMs: result.metadata.responseTimeMs,
+                ...(result.conversation &&
+                  result.conversation.length > 0 && {
+                    protocolMessage: extractProtocolMessage(result.conversation, result.metadata.agent.protocol),
+                    contextId: result.metadata.taskId, // Using taskId as context identifier
+                  }),
+              },
+            },
+            null,
+            2
+          )
+        );
       } else {
         // Pretty output
         console.log('\n✅ SUCCESS\n');

package/dist/lib/advanced.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Advanced exports for library authors building custom protocol implementations
+ *
+ * @remarks
+ * **Most developers should use AdCPClient from the main export**, which provides:
+ * - Single-agent access via `client.agent(id)` with conversation context
+ * - Multi-agent parallel operations via `client.agents([ids])`
+ * - All AdCP tools with full type safety
+ *
+ * These low-level protocol clients are only needed if you're:
+ * - Building custom protocol handlers
+ * - Integrating AdCP with other frameworks
+ * - Implementing custom agent orchestration
+ *
+ * @example
+ * ```typescript
+ * // ❌ Don't do this - use main AdCPClient instead:
+ * import { callA2ATool } from '@adcp/client/advanced';
+ *
+ * // ✅ Do this - use the main client:
+ * import { AdCPClient } from '@adcp/client';
+ * const client = new AdCPClient([agentConfig]);
+ * const agent = client.agent('agent-id');
+ * await agent.getProducts({ brief: '...' });
+ * ```
+ */
+/**
+ * Protocol-level clients for direct protocol interaction
+ *
+ * @remarks
+ * Low-level clients for MCP and A2A protocols. Used internally by AdCPClient.
+ * Only use these if you need to build custom protocol handlers or integrations.
+ *
+ * For normal usage, prefer AdCPClient which wraps these and provides:
+ * - Automatic agent configuration
+ * - Conversation context management
+ * - Type-safe tool methods
+ * - Error handling and validation
+ */
+export { ProtocolClient, callMCPTool, callA2ATool, createMCPClient, createA2AClient } from './protocols';
+//# sourceMappingURL=advanced.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../../src/lib/advanced.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/lib/advanced.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Advanced exports for library authors building custom protocol implementations
+ *
+ * @remarks
+ * **Most developers should use AdCPClient from the main export**, which provides:
+ * - Single-agent access via `client.agent(id)` with conversation context
+ * - Multi-agent parallel operations via `client.agents([ids])`
+ * - All AdCP tools with full type safety
+ *
+ * These low-level protocol clients are only needed if you're:
+ * - Building custom protocol handlers
+ * - Integrating AdCP with other frameworks
+ * - Implementing custom agent orchestration
+ *
+ * @example
+ * ```typescript
+ * // ❌ Don't do this - use main AdCPClient instead:
+ * import { callA2ATool } from '@adcp/client/advanced';
+ *
+ * // ✅ Do this - use the main client:
+ * import { AdCPClient } from '@adcp/client';
+ * const client = new AdCPClient([agentConfig]);
+ * const agent = client.agent('agent-id');
+ * await agent.getProducts({ brief: '...' });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createA2AClient = exports.createMCPClient = exports.callA2ATool = exports.callMCPTool = exports.ProtocolClient = void 0;
+/**
+ * Protocol-level clients for direct protocol interaction
+ *
+ * @remarks
+ * Low-level clients for MCP and A2A protocols. Used internally by AdCPClient.
+ * Only use these if you need to build custom protocol handlers or integrations.
+ *
+ * For normal usage, prefer AdCPClient which wraps these and provides:
+ * - Automatic agent configuration
+ * - Conversation context management
+ * - Type-safe tool methods
+ * - Error handling and validation
+ */
+var protocols_1 = require("./protocols");
+Object.defineProperty(exports, "ProtocolClient", { enumerable: true, get: function () { return protocols_1.ProtocolClient; } });
+Object.defineProperty(exports, "callMCPTool", { enumerable: true, get: function () { return protocols_1.callMCPTool; } });
+Object.defineProperty(exports, "callA2ATool", { enumerable: true, get: function () { return protocols_1.callA2ATool; } });
+Object.defineProperty(exports, "createMCPClient", { enumerable: true, get: function () { return protocols_1.createMCPClient; } });
+Object.defineProperty(exports, "createA2AClient", { enumerable: true, get: function () { return protocols_1.createA2AClient; } });
+//# sourceMappingURL=advanced.js.map

package/dist/lib/advanced.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.js","sourceRoot":"","sources":["../../src/lib/advanced.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;AAEH;;;;;;;;;;;;GAYG;AACH,yCAAyG;AAAhG,2GAAA,cAAc,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,4GAAA,eAAe,OAAA;AAAE,4GAAA,eAAe,OAAA"}

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

@@ -5,6 +5,10 @@ import type { AgentConfig } from '../types';
 export declare function generateUUID(): string;
 /**
  * Get authentication token for an agent
+ *
+ * The auth_token_env field should contain the actual token value.
+ * For environment variable expansion, use shell substitution when calling the CLI:
+ * `--auth $MY_TOKEN` or `--auth "$MY_TOKEN"`
  */
 export declare function getAuthToken(agent: AgentConfig): string | undefined;
 /**

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

@@ -1 +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"}
+{"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;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAOnE;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

@@ -10,25 +10,24 @@ exports.createMCPAuthHeaders = createMCPAuthHeaders;
  */
 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);
+        const r = (Math.random() * 16) | 0;
+        const v = c == 'x' ? r : (r & 0x3) | 0x8;
         return v.toString(16);
     });
 }
 /**
  * Get authentication token for an agent
+ *
+ * The auth_token_env field should contain the actual token value.
+ * For environment variable expansion, use shell substitution when calling the CLI:
+ * `--auth $MY_TOKEN` or `--auth "$MY_TOKEN"`
  */
 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];
+    // Always treat auth_token_env as a direct token value
+    return agent.auth_token_env;
 }
 /**
  * Create AdCP-compliant headers
@@ -39,8 +38,8 @@ function createAdCPHeaders(authToken, isMCP = false) {
         '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}` })
+        Accept: isMCP ? 'application/json, text/event-stream' : 'application/vnd.adcp+json, application/json',
+        ...(authToken && { Authorization: `Bearer ${authToken}` }),
     };
 }
 /**
@@ -53,8 +52,8 @@ function createAuthenticatedFetch(authToken) {
             ...options,
             headers: {
                 ...headers,
-                ...(options?.headers || {})
-            }
+                ...(options?.headers || {}),
+            },
         });
     };
 }
@@ -63,7 +62,7 @@ function createAuthenticatedFetch(authToken) {
  */
 function createMCPAuthHeaders(authToken) {
     const headers = {
-        'Accept': 'application/json, text/event-stream'
+        Accept: 'application/json, text/event-stream',
     };
     if (authToken) {
         headers['x-adcp-auth'] = authToken;

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

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/auth/index.ts"],"names":[],"mappings":";;AAKA,oCAMC;AASD,oCAOC;AAKD,8CASC;AAKD,4DAYC;AAKD,oDAUC;AAvED;;GAEG;AACH,SAAgB,YAAY;IAC1B,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC;QACxE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QACzC,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;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,sDAAsD;IACtD,OAAO,KAAK,CAAC,cAAc,CAAC;AAC9B,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,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC,6CAA6C;QACrG,GAAG,CAAC,SAAS,IAAI,EAAE,aAAa,EAAE,UAAU,SAAS,EAAE,EAAE,CAAC;KAC3D,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,MAAM,EAAE,qCAAqC;KAC9C,CAAC;IAEF,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC;IACrC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -1,6 +1,6 @@
 import type { AgentConfig } from '../types';
 import { AgentClient } from './AgentClient';
-import type { ADCPClientConfig } from './ADCPClient';
+import type { SingleAgentClientConfig } from './SingleAgentClient';
 import { CreativeAgentClient } from './CreativeAgentClient';
 import type { CreativeFormat } from './CreativeAgentClient';
 import type { InputHandler, TaskOptions, TaskResult, TaskInfo } from './ConversationTypes';
@@ -12,7 +12,7 @@ export declare class AgentCollection {
     private agents;
     private config;
     private clients;
-    constructor(agents: AgentConfig[], config?: ADCPClientConfig);
+    constructor(agents: AgentConfig[], config?: SingleAgentClientConfig);
     /**
      * Execute getProducts on all agents in parallel
      */
@@ -116,7 +116,7 @@ export declare class AgentCollection {
 export declare class ADCPMultiAgentClient {
     private config;
     private agentClients;
-    constructor(agentConfigs: AgentConfig[], config?: ADCPClientConfig);
+    constructor(agentConfigs?: AgentConfig[], config?: SingleAgentClientConfig);
     /**
      * Create client by auto-discovering agent configuration
      *
@@ -139,7 +139,7 @@ export declare class ADCPMultiAgentClient {
      * });
      * ```
      */
-    static fromConfig(config?: ADCPClientConfig): ADCPMultiAgentClient;
+    static fromConfig(config?: SingleAgentClientConfig): ADCPMultiAgentClient;
     /**
      * Create client from environment variables only
      *
@@ -152,7 +152,7 @@ export declare class ADCPMultiAgentClient {
      * const client = ADCPMultiAgentClient.fromEnv();
      * ```
      */
-    static fromEnv(config?: ADCPClientConfig): ADCPMultiAgentClient;
+    static fromEnv(config?: SingleAgentClientConfig): ADCPMultiAgentClient;
     /**
      * Create client from a specific config file
      *
@@ -169,7 +169,7 @@ export declare class ADCPMultiAgentClient {
      * const client = ADCPMultiAgentClient.fromFile();
      * ```
      */
-    static fromFile(configPath?: string, config?: ADCPClientConfig): ADCPMultiAgentClient;
+    static fromFile(configPath?: string, config?: SingleAgentClientConfig): ADCPMultiAgentClient;
     /**
      * Create a simple client with minimal configuration
      *
@@ -386,6 +386,53 @@ export declare class ADCPMultiAgentClient {
      * ```
      */
     getTaskCountsByStatus(): Promise<Record<string, number>>;
+    /**
+     * Generate webhook URL for a specific agent, task type, and operation
+     *
+     * @param agentId - ID of the agent
+     * @param taskType - Type of task (e.g., 'get_products', 'media_buy_delivery')
+     * @param operationId - Operation ID for this request
+     * @returns Full webhook URL with macros replaced
+     *
+     * @example
+     * ```typescript
+     * const webhookUrl = client.getWebhookUrl('agent1', 'sync_creatives', 'op_123');
+     * // Returns: https://myapp.com/webhook/sync_creatives/agent1/op_123
+     * ```
+     */
+    getWebhookUrl(agentId: string, taskType: string, operationId: string): string;
+    /**
+     * Handle webhook from any agent (async task completion or notifications)
+     *
+     * Automatically routes webhook to the correct agent based on agent_id in payload.
+     *
+     * @param payload - Webhook payload from agent (must contain agent_id or operation_id)
+     * @param signature - Optional signature for verification (X-ADCP-Signature)
+     * @param timestamp - Optional timestamp for verification (X-ADCP-Timestamp)
+     * @returns Whether webhook was handled successfully
+     *
+     * @example
+     * ```typescript
+     * app.post('/webhook', async (req, res) => {
+     *   const signature = req.headers['x-adcp-signature'];
+     *   const timestamp = req.headers['x-adcp-timestamp'];
+     *
+     *   try {
+     *     const handled = await client.handleWebhook(req.body, signature, timestamp);
+     *     res.status(200).json({ received: handled });
+     *   } catch (error) {
+     *     res.status(401).json({ error: error.message });
+     *   }
+     * });
+     * ```
+     */
+    handleWebhook(payload: any, signature?: string, timestamp?: string | number): Promise<boolean>;
+    /**
+     * Infer agent ID from webhook payload when not explicitly provided
+     *
+     * Looks for patterns in operation_id or context_id that may contain agent information
+     */
+    private inferAgentIdFromPayload;
     /**
      * Create a creative agent client
      *
@@ -470,5 +517,5 @@ export declare class ADCPMultiAgentClient {
  * @param config - Client configuration
  * @returns Configured ADCPMultiAgentClient instance
  */
-export declare function createADCPMultiAgentClient(agents: AgentConfig[], config?: ADCPClientConfig): ADCPMultiAgentClient;
+export declare function createADCPMultiAgentClient(agents: AgentConfig[], config?: SingleAgentClientConfig): ADCPMultiAgentClient;
 //# sourceMappingURL=ADCPMultiAgentClient.d.ts.map