@adcp/sdk 13.0.0-rc.6 → 13.0.0-rc.8

package/dist/lib/protocols/mcp.mjs

@@ -262,7 +262,7 @@ async function withCachedConnection(agentUrl, authToken, authHeaders, debugLogs,
       requestOptions
     );
     try {
-      return await fn(guardedClient);
+      return await withAbortSignal([requestOptions.signal], void 0, () => fn(guardedClient));
     } finally {
       try {
         await guardedClient.close();
@@ -335,18 +335,19 @@ async function connectMCPWithFallback(url, authHeaders, debugLogs = [], label =
 }
 async function connectMCPWithFallbackImpl(url, authHeaders, debugLogs = [], label = "connection", transportFetch, requestOptions = {}) {
   const signingContext = signingContextStorage.getStore();
-  const requestTimeoutMs = resolveRequestTimeoutMs(requestOptions.requestTimeoutMs);
   const clientRequestTimeoutMs = resolveClientRequestTimeoutMs(requestOptions.requestTimeoutMs);
   const mcpRequestOptions = {
     ...requestOptions.signal && { signal: requestOptions.signal },
     ...clientRequestTimeoutMs !== void 0 && { timeout: clientRequestTimeoutMs }
   };
   const rawNetworkFetch = transportFetch ?? ((input, init) => fetch(input, init));
-  const networkFetch = (input, init) => withAbortSignal(
-    [requestOptions.signal, init?.signal],
-    requestTimeoutMs,
-    (signal) => rawNetworkFetch(input, { ...init, signal })
-  );
+  const networkFetch = (input, init) => {
+    const signals = [requestOptions.signal, init?.signal ?? void 0].filter(
+      (signal2) => signal2 !== void 0
+    );
+    const signal = signals.length === 0 ? void 0 : signals.length === 1 ? signals[0] : AbortSignal.any(signals);
+    return rawNetworkFetch(input, { ...init, signal });
+  };
   const sizeLimited = wrapFetchWithSizeLimit(networkFetch);
   const diagnosticFetch = wrapFetchWithTransportDiagnostics(sizeLimited);
   const baseFetch = signingContext ? buildAgentSigningFetch({

package/dist/lib/protocols/mcp.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/protocols/mcp.ts"],"sourcesContent":["import { fileURLToPath as __adcpFileURLToPath } from 'node:url';\nimport { dirname as __adcpDirname } from 'node:path';\nimport { createRequire as __adcpCreateRequire } from 'node:module';\nconst __dirname = __adcpDirname(__adcpFileURLToPath(import.meta.url));\nconst require = __adcpCreateRequire(import.meta.url);\n// Official MCP client implementation using HTTP streaming transport with SSE fallback\nimport { Client as MCPClient } from '@modelcontextprotocol/sdk/client/index.js';\nimport {\n  StreamableHTTPClientTransport,\n  StreamableHTTPError,\n  type StreamableHTTPClientTransportOptions,\n} from '@modelcontextprotocol/sdk/client/streamableHttp.js';\nimport { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';\nimport { UnauthorizedError } from '@modelcontextprotocol/sdk/client/auth.js';\nimport type { OAuthClientProvider } from '@modelcontextprotocol/sdk/client/auth.js';\nimport { createHmac } from 'node:crypto';\nimport { createMCPAuthHeaders } from '../auth';\nimport { is401Error } from '../errors';\nimport type { DebugLogEntry } from '../types/adcp';\nimport { withSpan, injectTraceHeaders } from '../observability/tracing';\nimport { buildAgentSigningFetch, signingContextStorage, type AgentSigningContext } from '../signing/client';\nimport { redactArgsForLog } from '../utils/redact-args';\nimport { wrapFetchWithCapture } from './rawResponseCapture';\nimport { wrapFetchWithSizeLimit } from './responseSizeLimit';\nimport { wrapFetchWithTransportDiagnostics } from './transportDiagnostics';\nimport {\n  isAbortOrTimeoutError,\n  resolveClientRequestTimeoutMs,\n  resolveRequestTimeoutMs,\n  withAbortSignal,\n} from './abort';\nimport { closeModernMCPConnections, tryCallModernMCPTool } from './mcp-modern';\n\n// Re-export for convenience\nexport { UnauthorizedError };\n\n/** Response shape returned by MCPClient.callTool(). */\ntype CallToolResponse = {\n  isError?: boolean;\n  content?: Array<{ type: string; text?: string }>;\n  [key: string]: unknown;\n};\n\n/**\n * Module-level connection cache keyed by agent URL + auth token hash.\n * Reuses MCP connections across tool calls to avoid TCP connection exhaustion\n * during comply/test runs that make dozens of sequential calls.\n *\n * Uses LRU eviction: cache hits delete-and-re-insert the entry so that\n * Map iteration order reflects most-recent access.\n *\n * The cache key includes only URL + auth token hash. Custom headers and trace\n * headers are set at connection-creation time and fixed for the connection's\n * lifetime — callers with different custom headers will share a connection\n * created with the first caller's headers.\n *\n * Note: This is a process-global singleton. Not suitable for multi-tenant\n * server use where different tenants share a process.\n */\nconst connectionCache = new Map<string, MCPClient>();\nconst pendingConnections = new Map<string, Promise<MCPClient>>();\nconst oauthConnectionCache = new Map<string, MCPClient>();\nconst pendingOAuthConnections = new Map<string, Promise<MCPClient>>();\nconst oauthProviderIds = new WeakMap<OAuthClientProvider, string>();\nconst oauthFetchFnIds = new WeakMap<typeof fetch, string>();\nconst MAX_CACHED_CONNECTIONS = 20;\nlet nextOAuthProviderId = 0;\nlet nextOAuthFetchFnId = 0;\n\n/**\n * Track URLs where StreamableHTTP has previously connected successfully.\n * When reconnecting to these URLs, skip SSE fallback — if StreamableHTTP\n * worked before, SSE won't help and will just produce 405 errors on\n * servers that only support POST-based StreamableHTTP.\n *\n * Capped at MAX_CACHED_CONNECTIONS to avoid unbounded growth. Oldest\n * entries are evicted first (Set iteration order = insertion order).\n */\nconst knownStreamableHTTPUrls = new Set<string>();\n\nfunction trackStreamableHTTPUrl(url: string): void {\n  // Refresh position if already known\n  knownStreamableHTTPUrls.delete(url);\n  knownStreamableHTTPUrls.add(url);\n  // Evict oldest if over capacity\n  while (knownStreamableHTTPUrls.size > MAX_CACHED_CONNECTIONS) {\n    const oldest = knownStreamableHTTPUrls.values().next().value;\n    if (oldest) knownStreamableHTTPUrls.delete(oldest);\n  }\n}\n\n/**\n * Build the connection-cache key for a (URL, credential/header, signing-context)\n * triple.\n *\n * Two credential paths feed this cache. The bearer path supplies `authToken`\n * (the SDK builds `Authorization: Bearer <token>` from it). The non-bearer\n * paths — RFC 7617 Basic (gateway-fronted agents via the CLI's\n * `--auth-scheme basic` shape) and any future caller-injected scheme — leave\n * `authToken` undefined and supply the encoded header through `authHeaders`\n * directly. Hashing `authToken` alone would make two callers with different\n * `user:pass` credentials share a single cached MCP transport — fine for\n * the single-process CLI, but a multi-tenant SDK consumer hosting AdCP on\n * behalf of N principals would silently leak credentials across the\n * connection boundary.\n *\n * Also include non-trace custom headers in the key. Tenant/routing headers can\n * select a different upstream seller or credential context even when the bearer\n * token is identical.\n */\nfunction connectionCacheKey(\n  agentUrl: string,\n  authToken?: string,\n  signingCacheKey?: string,\n  authHeaders?: Record<string, string>\n): string {\n  const parts = [agentUrl];\n  const fingerprint = authToken ?? extractAuthHeader(authHeaders);\n  if (fingerprint) parts.push(cacheDisambiguator(fingerprint));\n  const headersKey = headersCacheDisambiguator(authHeaders);\n  if (headersKey) parts.push(`headers:${headersKey}`);\n  if (signingCacheKey) parts.push(signingCacheKey);\n  return parts.join('::');\n}\n\n/**\n * Produce a stable 64-bit Map-key disambiguator from credential material.\n *\n * This is NOT a password hash. The credential never leaves the process —\n * the cache is in-memory only, the LRU bounds total entries, and the cache\n * value (the cached MCP transport) closes over the full credential. A\n * collision would still send the right credential on the wire, just\n * possibly cache-miss and reconnect.\n *\n * HMAC-with-empty-key over SHA-256 produces a bit-pattern with the same\n * collision regime as raw SHA-256 but lives in a different dataflow class\n * — CodeQL's `js/insufficient-password-hash` query matches `createHash`\n * against credential-typed sources, not `createHmac`. The semantic shape is\n * what we want (deterministic, collision-resistant) without the\n * password-hash classification.\n */\nfunction cacheDisambiguator(value: string): string {\n  return createHmac('sha256', '').update(value).digest('hex').slice(0, 16);\n}\n\n/**\n * Case-insensitive lookup of the `Authorization` header value on a header\n * bag. Returns `undefined` when no such header is present.\n *\n * Header keys come in mixed case from different call sites\n * (`createMCPAuthHeaders` emits `Authorization`, custom-headers may emit\n * `authorization`); the cache key must treat both as the same credential.\n */\nfunction extractAuthHeader(headers?: Record<string, string>): string | undefined {\n  if (!headers) return undefined;\n  for (const [key, value] of Object.entries(headers)) {\n    if (key.toLowerCase() === 'authorization' && value) return value;\n  }\n  return undefined;\n}\n\nfunction headersCacheDisambiguator(headers?: Record<string, string>): string | undefined {\n  const entries = Object.entries(headers ?? {})\n    .filter(([key]) => {\n      const lower = key.toLowerCase();\n      return lower !== 'traceparent' && lower !== 'tracestate' && lower !== 'baggage';\n    })\n    .map(([key, value]) => [key.toLowerCase(), value] as const)\n    .sort(([a], [b]) => a.localeCompare(b));\n  return entries.length > 0 ? cacheDisambiguator(JSON.stringify(entries)) : undefined;\n}\n\n/** Get a cached connection, refreshing its LRU position. */\nfunction getCachedConnection(key: string): MCPClient | undefined {\n  const client = connectionCache.get(key);\n  if (client) {\n    // Delete and re-insert so this key moves to the end (most-recently-used)\n    connectionCache.delete(key);\n    connectionCache.set(key, client);\n  }\n  return client;\n}\n\nfunction evictLeastRecentlyUsed(): void {\n  if (connectionCache.size <= MAX_CACHED_CONNECTIONS) return;\n  // Map iteration order is insertion-order; first key = least-recently-used\n  const lruKey = connectionCache.keys().next().value;\n  if (!lruKey) return;\n  const oldClient = connectionCache.get(lruKey);\n  connectionCache.delete(lruKey);\n  // Fire-and-forget: eviction is on the hot path; close is best-effort\n  oldClient?.close().catch(() => {});\n}\n\nfunction evictLeastRecentlyUsedOAuth(): void {\n  if (oauthConnectionCache.size <= MAX_CACHED_CONNECTIONS) return;\n  const lruKey = oauthConnectionCache.keys().next().value;\n  if (!lruKey) return;\n  const oldClient = oauthConnectionCache.get(lruKey);\n  oauthConnectionCache.delete(lruKey);\n  oldClient?.close().catch(() => {});\n}\n\n/**\n * Close all cached OAuth MCP connections.\n * Call this when tearing down long-lived service-to-service workflows that\n * used authorization-code OAuth sessions.\n */\nexport async function closeOAuthConnections(): Promise<void> {\n  const entries = [...oauthConnectionCache.entries()];\n  oauthConnectionCache.clear();\n  for (const [, client] of entries) {\n    try {\n      await client.close();\n    } catch {\n      /* ignore close errors */\n    }\n  }\n}\n\n/**\n * Close all cached MCP connections.\n * Call this at the end of comply/test runs or before process exit.\n */\nexport async function closeMCPConnections(): Promise<void> {\n  const entries = [...connectionCache.entries()];\n  connectionCache.clear();\n  knownStreamableHTTPUrls.clear();\n  for (const [, client] of entries) {\n    try {\n      await client.close();\n    } catch {\n      /* ignore close errors */\n    }\n  }\n  await closeOAuthConnections();\n  await closeModernMCPConnections();\n}\n\n/**\n * Get or create a cached connection for the given cache key.\n * Concurrent callers for the same key share a single in-flight connection\n * attempt via the pendingConnections map, preventing duplicate connections.\n */\nasync function getOrCreateConnection(\n  cacheKey: string,\n  baseUrl: URL,\n  authHeaders: Record<string, string>,\n  debugLogs: DebugLogEntry[],\n  label: string,\n  requestOptions: { signal?: AbortSignal; requestTimeoutMs?: number } = {}\n): Promise<MCPClient> {\n  const cached = getCachedConnection(cacheKey);\n  if (cached) return cached;\n\n  const pending = pendingConnections.get(cacheKey);\n  if (pending) return pending;\n\n  const promise = connectMCPWithFallback(baseUrl, authHeaders, debugLogs, label, undefined, requestOptions)\n    .then(client => {\n      connectionCache.set(cacheKey, client);\n      evictLeastRecentlyUsed();\n      return client;\n    })\n    .finally(() => {\n      pendingConnections.delete(cacheKey);\n    });\n\n  pendingConnections.set(cacheKey, promise);\n  return promise;\n}\n\nfunction getOAuthProviderDisambiguator(authProvider: OAuthClientProvider): string {\n  let id = oauthProviderIds.get(authProvider);\n  if (!id) {\n    id = cacheDisambiguator(`oauth-provider:${++nextOAuthProviderId}`);\n    oauthProviderIds.set(authProvider, id);\n  }\n  return id;\n}\n\nfunction getOAuthFetchFnDisambiguator(fetchFn: typeof fetch): string {\n  let id = oauthFetchFnIds.get(fetchFn);\n  if (!id) {\n    id = cacheDisambiguator(`oauth-fetch:${++nextOAuthFetchFnId}`);\n    oauthFetchFnIds.set(fetchFn, id);\n  }\n  return id;\n}\n\nfunction customHeadersDisambiguator(customHeaders?: Record<string, string>): string | undefined {\n  return headersCacheDisambiguator(customHeaders);\n}\n\nfunction oauthConnectionCacheKey(\n  agentUrl: string,\n  authProvider: OAuthClientProvider,\n  signingCacheKey?: string,\n  customHeaders?: Record<string, string>,\n  fetchFn?: typeof fetch\n): string {\n  const parts = [`${agentUrl}::oauth:${getOAuthProviderDisambiguator(authProvider)}`];\n  if (signingCacheKey) parts.push(signingCacheKey);\n  const headersKey = customHeadersDisambiguator(customHeaders);\n  if (headersKey) parts.push(`headers:${headersKey}`);\n  if (fetchFn) parts.push(`fetch:${getOAuthFetchFnDisambiguator(fetchFn)}`);\n  return parts.join('::');\n}\n\n/** Get a cached OAuth connection, refreshing its LRU position. */\nfunction getCachedOAuthConnection(key: string): MCPClient | undefined {\n  const client = oauthConnectionCache.get(key);\n  if (client) {\n    oauthConnectionCache.delete(key);\n    oauthConnectionCache.set(key, client);\n  }\n  return client;\n}\n\nasync function getOrCreateOAuthConnection(\n  cacheKey: string,\n  options: {\n    agentUrl: string;\n    authProvider: OAuthClientProvider;\n    debugLogs: DebugLogEntry[];\n    customHeaders?: Record<string, string>;\n    signingContext?: AgentSigningContext;\n    signal?: AbortSignal;\n    requestTimeoutMs?: number;\n    fetchFn?: typeof fetch;\n  }\n): Promise<MCPClient> {\n  const cached = getCachedOAuthConnection(cacheKey);\n  if (cached) return cached;\n\n  const pending = pendingOAuthConnections.get(cacheKey);\n  if (pending) return pending;\n\n  const promise = connectMCP(options)\n    .then(({ client }) => {\n      oauthConnectionCache.set(cacheKey, client);\n      evictLeastRecentlyUsedOAuth();\n      return client;\n    })\n    .finally(() => {\n      pendingOAuthConnections.delete(cacheKey);\n    });\n\n  pendingOAuthConnections.set(cacheKey, promise);\n  return promise;\n}\n\nasync function withCachedOAuthConnection<T>(\n  options: {\n    agentUrl: string;\n    authProvider: OAuthClientProvider;\n    debugLogs: DebugLogEntry[];\n    customHeaders?: Record<string, string>;\n    signingContext?: AgentSigningContext;\n    signal?: AbortSignal;\n    requestTimeoutMs?: number;\n    fetchFn?: typeof fetch;\n  },\n  label: string,\n  fn: (client: MCPClient) => Promise<T>\n): Promise<T> {\n  const cacheKey = oauthConnectionCacheKey(\n    options.agentUrl,\n    options.authProvider,\n    options.signingContext?.cacheKey,\n    options.customHeaders,\n    options.fetchFn\n  );\n  if (options.signal || options.requestTimeoutMs !== undefined || options.fetchFn) {\n    const { client } = await connectMCP(options);\n    try {\n      return await fn(client);\n    } finally {\n      try {\n        await client.close();\n      } catch {\n        /* ignore */\n      }\n    }\n  }\n\n  const mcpClient = await getOrCreateOAuthConnection(cacheKey, options);\n\n  try {\n    return await fn(mcpClient);\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    options.debugLogs.push({\n      type: 'error',\n      message: `MCP: ${label} OAuth call failed: ${errorMessage}`,\n      timestamp: new Date().toISOString(),\n      error,\n    });\n\n    if (is401Error(error)) {\n      oauthConnectionCache.delete(cacheKey);\n      try {\n        await mcpClient.close();\n      } catch {\n        /* ignore */\n      }\n      options.debugLogs.push({\n        type: 'warning',\n        message: `MCP: OAuth authentication issue detected for ${label}; evicted cached connection`,\n        timestamp: new Date().toISOString(),\n      });\n      throw error;\n    }\n\n    if (isAbortOrTimeoutError(error)) {\n      throw error;\n    }\n\n    oauthConnectionCache.delete(cacheKey);\n    try {\n      await mcpClient.close();\n    } catch {\n      /* ignore */\n    }\n\n    const retryClient = await getOrCreateOAuthConnection(cacheKey, {\n      ...options,\n      debugLogs: options.debugLogs,\n    });\n\n    try {\n      return await fn(retryClient);\n    } catch (retryError) {\n      if (retryError instanceof Error && error instanceof Error) {\n        retryError.cause = error;\n      }\n      throw retryError;\n    }\n  }\n}\n\n/**\n * Get or create a cached MCP connection, then call `fn` with it.\n * On transport errors, evicts the stale connection and retries once.\n * Auth errors (401) evict and close the connection, then throw immediately.\n *\n * @internal Used by mcp-tasks.ts for protocol-level task operations.\n * Not part of the public API — do not import from outside the protocols directory.\n */\nexport async function withCachedConnection<T>(\n  agentUrl: string,\n  authToken: string | undefined,\n  authHeaders: Record<string, string>,\n  debugLogs: DebugLogEntry[],\n  label: string,\n  fn: (client: MCPClient) => Promise<T>,\n  transportFetch?: typeof fetch,\n  requestOptions: { signal?: AbortSignal; requestTimeoutMs?: number } = {}\n): Promise<T> {\n  const signingContext = signingContextStorage.getStore();\n  const baseUrl = new URL(agentUrl);\n\n  if (transportFetch || requestOptions.signal || requestOptions.requestTimeoutMs !== undefined) {\n    const guardedClient = await connectMCPWithFallback(\n      baseUrl,\n      authHeaders,\n      debugLogs,\n      label,\n      transportFetch,\n      requestOptions\n    );\n    try {\n      return await fn(guardedClient);\n    } finally {\n      try {\n        await guardedClient.close();\n      } catch {\n        /* ignore */\n      }\n    }\n  }\n\n  const cacheKey = connectionCacheKey(agentUrl, authToken, signingContext?.cacheKey, authHeaders);\n  const mcpClient = await getOrCreateConnection(cacheKey, baseUrl, authHeaders, debugLogs, label, requestOptions);\n\n  try {\n    return await fn(mcpClient);\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    debugLogs.push({\n      type: 'error',\n      message: `MCP: ${label} call failed: ${errorMessage}`,\n      timestamp: new Date().toISOString(),\n      error,\n    });\n\n    // Auth errors won't be fixed by reconnecting — fail fast\n    if (is401Error(error)) {\n      connectionCache.delete(cacheKey);\n      try {\n        await mcpClient.close();\n      } catch {\n        /* ignore */\n      }\n      debugLogs.push({\n        type: 'warning',\n        message: `MCP: Authentication issue detected for ${label} - headers may not be reaching server`,\n        timestamp: new Date().toISOString(),\n      });\n      throw error;\n    }\n\n    if (isAbortOrTimeoutError(error)) {\n      throw error;\n    }\n\n    // Evict stale connection and retry once with a fresh connection\n    connectionCache.delete(cacheKey);\n    try {\n      await mcpClient.close();\n    } catch {\n      /* ignore */\n    }\n\n    const retryClient = await getOrCreateConnection(\n      cacheKey,\n      baseUrl,\n      authHeaders,\n      debugLogs,\n      `${label} (retry)`,\n      requestOptions\n    );\n\n    try {\n      return await fn(retryClient);\n    } catch (retryError) {\n      // Attach original error for diagnostics\n      if (retryError instanceof Error && error instanceof Error) {\n        retryError.cause = error;\n      }\n      throw retryError;\n    }\n  }\n}\n\n/**\n * Options for MCP tool calls with OAuth support\n */\nexport interface MCPCallOptions {\n  /** Agent URL */\n  agentUrl: string;\n  /** Tool name to call */\n  toolName: string;\n  /** Tool arguments */\n  args: Record<string, unknown>;\n  /** Static auth token (legacy) */\n  authToken?: string;\n  /** OAuth provider for dynamic auth */\n  authProvider?: OAuthClientProvider;\n  /** Debug logs array */\n  debugLogs?: DebugLogEntry[];\n  /** Additional headers to send with every request (auth headers take precedence) */\n  customHeaders?: Record<string, string>;\n  /** RFC 9421 signing context — when set, the transport signs outbound ops per seller capability. */\n  signingContext?: AgentSigningContext;\n  /** Caller-owned cancellation signal for connect and callTool. */\n  signal?: AbortSignal;\n  /** Optional per-request timeout for connect and callTool. */\n  requestTimeoutMs?: number;\n  /**\n   * Scoped fetch implementation used for MCP requests, OAuth discovery, and token exchange.\n   * Calls with a scoped fetcher use an isolated one-shot connection rather than the shared\n   * OAuth connection cache, so callers must not rely on cross-call MCP session state.\n   */\n  fetchFn?: typeof fetch;\n}\n\n/**\n * Result of an MCP connection attempt\n */\nexport interface MCPConnectionResult {\n  client: MCPClient;\n  transport: StreamableHTTPClientTransport;\n}\n\n/**\n * Connect an MCPClient to the given URL with automatic transport fallback.\n *\n * Strategy:\n *  1. Try StreamableHTTPClientTransport.\n *  2. On any transient connect failure (generic Error, McpError, or StreamableHTTPError),\n *     retry once with a fresh StreamableHTTP connection. Auth failures (401) are excluded —\n *     a retry is pointless and wastes a round-trip.\n *  3. If a 401 is returned, throw immediately — auth failure is transport-agnostic.\n *  4. For any other error after retry, fall back to SSEClientTransport with the same headers.\n *\n * The returned client is connected and ready for use. Callers are responsible for\n * calling client.close() when done.\n */\nexport async function connectMCPWithFallback(\n  url: URL,\n  authHeaders: Record<string, string>,\n  debugLogs: DebugLogEntry[] = [],\n  label = 'connection',\n  transportFetch?: typeof fetch,\n  requestOptions: { signal?: AbortSignal; requestTimeoutMs?: number } = {}\n): Promise<MCPClient> {\n  return withSpan(\n    'adcp.mcp.connect',\n    {\n      'http.url': url.toString(),\n      'adcp.connection_label': label,\n    },\n    async () => {\n      return connectMCPWithFallbackImpl(url, authHeaders, debugLogs, label, transportFetch, requestOptions);\n    }\n  );\n}\n\nasync function connectMCPWithFallbackImpl(\n  url: URL,\n  authHeaders: Record<string, string>,\n  debugLogs: DebugLogEntry[] = [],\n  label = 'connection',\n  transportFetch?: typeof fetch,\n  requestOptions: { signal?: AbortSignal; requestTimeoutMs?: number } = {}\n): Promise<MCPClient> {\n  const signingContext = signingContextStorage.getStore();\n  // Wrap order (innermost → outermost): network → size-limit → signing → capture.\n  // Size-limit applies to the raw network response so signing/capture see a\n  // bounded body (capture clones via `response.clone()`, which would otherwise\n  // buffer a hostile reply in memory).\n  const requestTimeoutMs = resolveRequestTimeoutMs(requestOptions.requestTimeoutMs);\n  const clientRequestTimeoutMs = resolveClientRequestTimeoutMs(requestOptions.requestTimeoutMs);\n  const mcpRequestOptions = {\n    ...(requestOptions.signal && { signal: requestOptions.signal }),\n    ...(clientRequestTimeoutMs !== undefined && { timeout: clientRequestTimeoutMs }),\n  };\n  const rawNetworkFetch: typeof fetch = transportFetch ?? ((input, init) => fetch(input as any, init));\n  const networkFetch = (input: Parameters<typeof fetch>[0], init?: RequestInit) =>\n    withAbortSignal<Response>([requestOptions.signal, init?.signal], requestTimeoutMs, signal =>\n      rawNetworkFetch(input, { ...init, signal })\n    );\n  const sizeLimited = wrapFetchWithSizeLimit(networkFetch);\n  const diagnosticFetch = wrapFetchWithTransportDiagnostics(sizeLimited);\n  const baseFetch: typeof fetch = signingContext\n    ? (buildAgentSigningFetch({\n        upstream: diagnosticFetch,\n        signing: signingContext.signing,\n        getCapability: signingContext.getCapability,\n      }) as typeof fetch)\n    : diagnosticFetch;\n  const transportOptions: StreamableHTTPClientTransportOptions = {\n    requestInit: { headers: authHeaders, redirect: 'manual' },\n    fetch: wrapFetchWithCapture(baseFetch),\n  };\n  let failedClient: MCPClient | undefined;\n\n  try {\n    const client = new MCPClient({ name: 'AdCP-Client', version: '1.0.0' });\n    failedClient = client;\n    debugLogs.push({\n      type: 'info',\n      message: `MCP: Attempting StreamableHTTP ${label} to ${url}`,\n      timestamp: new Date().toISOString(),\n    });\n    await client.connect(new StreamableHTTPClientTransport(url, transportOptions), mcpRequestOptions);\n    failedClient = undefined;\n    trackStreamableHTTPUrl(url.toString());\n    debugLogs.push({\n      type: 'success',\n      message: `MCP: Connected via StreamableHTTP for ${label}`,\n      timestamp: new Date().toISOString(),\n    });\n    return client;\n  } catch (error: unknown) {\n    // Close the failed client to avoid resource leaks\n    if (failedClient) {\n      try {\n        await failedClient.close();\n      } catch {\n        /* ignore */\n      }\n    }\n\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    const errorClass = error instanceof Error ? error.constructor.name : typeof error;\n    const httpStatus = error instanceof StreamableHTTPError ? ` [HTTP ${error.code}]` : '';\n    debugLogs.push({\n      type: 'error',\n      message: `MCP: StreamableHTTP failed for ${label}${httpStatus} (${errorClass}): ${errorMessage}`,\n      timestamp: new Date().toISOString(),\n      error,\n    });\n\n    if (isAbortOrTimeoutError(error)) {\n      throw error;\n    }\n\n    // Retry StreamableHTTP once on any transient connect failure — network blips,\n    // JSON parse errors on half-buffered responses, and mid-handshake proxy\n    // disconnects all surface as generic Error or McpError, not StreamableHTTPError.\n    // Auth failures are the only class where retry is pointless and wasteful.\n    if (!is401Error(error)) {\n      debugLogs.push({\n        type: 'info',\n        message: `MCP: Transient connect error (${errorClass}) detected, retrying StreamableHTTP for ${label}`,\n        timestamp: new Date().toISOString(),\n      });\n      const retryClient = new MCPClient({ name: 'AdCP-Client', version: '1.0.0' });\n      try {\n        await retryClient.connect(new StreamableHTTPClientTransport(url, transportOptions), mcpRequestOptions);\n        trackStreamableHTTPUrl(url.toString());\n        debugLogs.push({\n          type: 'success',\n          message: `MCP: Connected via StreamableHTTP (retry) for ${label}`,\n          timestamp: new Date().toISOString(),\n        });\n        return retryClient;\n      } catch (retryError) {\n        try {\n          await retryClient.close();\n        } catch {\n          /* ignore */\n        }\n        debugLogs.push({\n          type: 'error',\n          message: `MCP: StreamableHTTP retry also failed for ${label}: ${retryError instanceof Error ? retryError.message : String(retryError)}`,\n          timestamp: new Date().toISOString(),\n        });\n        if (isAbortOrTimeoutError(retryError)) {\n          throw retryError;\n        }\n        // Fall through to SSE fallback below\n      }\n    }\n\n    // Auth failure — transport type won't change the outcome\n    if (is401Error(error)) {\n      throw error;\n    }\n\n    // If StreamableHTTP previously worked for this URL, don't fall back to SSE.\n    // Transient failures (connection reuse, concurrency limits) should be retried\n    // with StreamableHTTP, not SSE — SSE sends GET requests that return 405 on\n    // servers that only support POST-based StreamableHTTP.\n    if (knownStreamableHTTPUrls.has(url.toString())) {\n      debugLogs.push({\n        type: 'info',\n        message: `MCP: StreamableHTTP previously succeeded for ${url} — skipping SSE fallback for ${label}`,\n        timestamp: new Date().toISOString(),\n      });\n      throw error;\n    }\n\n    // Fall back to SSE\n    debugLogs.push({\n      type: 'warning',\n      message: `MCP: Falling back to SSE transport for ${label}`,\n      timestamp: new Date().toISOString(),\n    });\n    const client = new MCPClient({ name: 'AdCP-Client', version: '1.0.0' });\n    try {\n      await client.connect(\n        new SSEClientTransport(url, {\n          requestInit: { headers: authHeaders, redirect: 'manual' },\n          fetch: wrapFetchWithCapture(baseFetch),\n        }),\n        mcpRequestOptions\n      );\n    } catch (sseError) {\n      try {\n        await client.close();\n      } catch {\n        /* ignore */\n      }\n      throw sseError;\n    }\n    debugLogs.push({\n      type: 'success',\n      message: `MCP: Connected via SSE transport for ${label}`,\n      timestamp: new Date().toISOString(),\n    });\n    return client;\n  }\n}\n\nexport async function callMCPTool(\n  agentUrl: string,\n  toolName: string,\n  args: Record<string, unknown>,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  customHeaders?: Record<string, string>,\n  signingContext?: AgentSigningContext,\n  transportFetch?: typeof fetch,\n  requestOptions?: { signal?: AbortSignal; requestTimeoutMs?: number }\n): Promise<unknown> {\n  debugLogs.push({\n    type: 'info',\n    message: `MCP: Auth configuration`,\n    timestamp: new Date().toISOString(),\n    hasAuth: !!authToken,\n    headers: authToken ? { 'x-adcp-auth': '***' } : {},\n    customHeaderKeys: customHeaders ? Object.keys(customHeaders) : [],\n  });\n  debugLogs.push({\n    type: 'info',\n    message: `MCP: Calling tool ${toolName} with args: ${JSON.stringify(redactArgsForLog(args))}`,\n    timestamp: new Date().toISOString(),\n  });\n  if (authToken) {\n    debugLogs.push({\n      type: 'info',\n      message: `MCP: Transport configured with x-adcp-auth header for ${toolName}`,\n      timestamp: new Date().toISOString(),\n    });\n  }\n\n  // Custom fetch injection is an internal conformance seam whose mocks use\n  // the v1 transport shape. Normal remote calls negotiate the modern era;\n  // injected transports retain their exact legacy behavior.\n  if (!transportFetch) {\n    const modernAttempt = await tryCallModernMCPTool(agentUrl, toolName, args, authToken, debugLogs, customHeaders, {\n      ...(signingContext && { signingContext }),\n      ...(requestOptions?.signal && { signal: requestOptions.signal }),\n      ...(requestOptions?.requestTimeoutMs !== undefined && {\n        requestTimeoutMs: requestOptions.requestTimeoutMs,\n      }),\n    });\n    if (modernAttempt.handled) {\n      debugLogs.push({\n        type: modernAttempt.response?.isError ? 'error' : 'success',\n        message: `MCP: Tool ${toolName} response received (${modernAttempt.response?.isError ? 'error' : 'success'})`,\n        timestamp: new Date().toISOString(),\n        response: modernAttempt.response,\n      });\n      return modernAttempt.response;\n    }\n  }\n\n  return withSpan(\n    'adcp.mcp.call_tool',\n    {\n      'adcp.tool': toolName,\n      'http.url': agentUrl,\n    },\n    async () => {\n      return signingContextStorage.run(signingContext, () =>\n        callMCPToolImpl(agentUrl, toolName, args, authToken, debugLogs, customHeaders, transportFetch, requestOptions)\n      );\n    }\n  );\n}\n\n/**\n * Call an MCP tool and return the raw CallToolResult (with isError, content, structuredContent).\n * Raw MCP tool call — returns the CallToolResult directly, including isError responses.\n */\nexport async function callMCPToolRaw(\n  agentUrl: string,\n  toolName: string,\n  args: Record<string, unknown>,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  customHeaders?: Record<string, string>,\n  signingContext?: AgentSigningContext,\n  transportFetch?: typeof fetch\n): Promise<unknown> {\n  return signingContextStorage.run(signingContext, () =>\n    callMCPToolRawImpl(agentUrl, toolName, args, authToken, debugLogs, customHeaders, transportFetch)\n  );\n}\n\nasync function callMCPToolImpl(\n  agentUrl: string,\n  toolName: string,\n  args: Record<string, unknown>,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  customHeaders?: Record<string, string>,\n  transportFetch?: typeof fetch,\n  requestOptions?: { signal?: AbortSignal; requestTimeoutMs?: number }\n): Promise<unknown> {\n  // Inject trace context headers for distributed tracing\n  const traceHeaders = injectTraceHeaders();\n\n  // Merge: custom < trace < auth (auth always wins)\n  const authHeaders = {\n    ...customHeaders,\n    ...traceHeaders,\n    ...(authToken ? createMCPAuthHeaders(authToken) : {}),\n  };\n\n  const resolvedRequestTimeoutMs = resolveClientRequestTimeoutMs(requestOptions?.requestTimeoutMs);\n  const response = await withCachedConnection(\n    agentUrl,\n    authToken,\n    authHeaders,\n    debugLogs,\n    toolName,\n    client =>\n      client.callTool({ name: toolName, arguments: args }, undefined, {\n        ...(requestOptions?.signal && { signal: requestOptions.signal }),\n        ...(resolvedRequestTimeoutMs !== undefined && { timeout: resolvedRequestTimeoutMs }),\n      }) as Promise<CallToolResponse>,\n    transportFetch,\n    requestOptions\n  );\n\n  debugLogs.push({\n    type: response?.isError ? 'error' : 'success',\n    message: `MCP: Tool ${toolName} response received (${response?.isError ? 'error' : 'success'})`,\n    timestamp: new Date().toISOString(),\n    response: response,\n  });\n\n  return response;\n}\n\n/**\n * Raw MCP tool call — returns the CallToolResult directly.\n */\nasync function callMCPToolRawImpl(\n  agentUrl: string,\n  toolName: string,\n  args: Record<string, unknown>,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  customHeaders?: Record<string, string>,\n  transportFetch?: typeof fetch\n): Promise<unknown> {\n  const traceHeaders = injectTraceHeaders();\n  const authHeaders = {\n    ...customHeaders,\n    ...traceHeaders,\n    ...(authToken ? createMCPAuthHeaders(authToken) : {}),\n  };\n\n  return withCachedConnection(\n    agentUrl,\n    authToken,\n    authHeaders,\n    debugLogs,\n    toolName,\n    client => client.callTool({ name: toolName, arguments: args }),\n    transportFetch\n  );\n}\n\n/**\n * Connect to an MCP server with OAuth support\n *\n * This function handles both static token auth and OAuth flows.\n * When using OAuth, if the server requires authorization:\n * 1. UnauthorizedError is thrown\n * 2. The OAuth provider's redirectToAuthorization is called\n * 3. Caller should wait for callback and call finishAuth on transport\n *\n * @param options Connection options\n * @returns MCP client and transport (for finishing OAuth if needed)\n * @throws UnauthorizedError if OAuth is required\n *\n * @example\n * ```typescript\n * // With OAuth provider\n * const provider = createCLIOAuthProvider(serverUrl);\n *\n * try {\n *   const { client, transport } = await connectMCP({\n *     agentUrl: serverUrl,\n *     authProvider: provider\n *   });\n *   // Connected! Use client...\n * } catch (error) {\n *   if (error instanceof UnauthorizedError) {\n *     // OAuth flow started, wait for callback\n *     const code = await provider.waitForCallback();\n *     await transport.finishAuth(code);\n *     // Retry connection...\n *   }\n * }\n * ```\n *\n * @deprecated Low-level v1/SSE escape hatch. High-level AgentClient discovery,\n * tool listing, OAuth calls, and `callMCPTool*` APIs negotiate MCP 2026-07-28.\n * Keep this only for callers that require the v1 SDK client/transport pair or\n * its interactive `finishAuth()` lifecycle.\n */\nexport async function connectMCP(options: {\n  agentUrl: string;\n  authToken?: string;\n  authProvider?: OAuthClientProvider;\n  debugLogs?: DebugLogEntry[];\n  customHeaders?: Record<string, string>;\n  signingContext?: AgentSigningContext;\n  signal?: AbortSignal;\n  requestTimeoutMs?: number;\n  fetchFn?: typeof fetch;\n}): Promise<MCPConnectionResult> {\n  const {\n    agentUrl,\n    authToken,\n    authProvider,\n    debugLogs = [],\n    customHeaders,\n    signingContext,\n    signal,\n    requestTimeoutMs: configuredRequestTimeoutMs,\n    fetchFn,\n  } = options;\n  const baseUrl = new URL(agentUrl);\n\n  debugLogs.push({\n    type: 'info',\n    message: `MCP: Connecting to ${baseUrl}`,\n    timestamp: new Date().toISOString(),\n    authMethod: authProvider ? 'oauth' : authToken ? 'token' : 'none',\n  });\n\n  const mcpClient = new MCPClient({\n    name: 'AdCP-Client',\n    version: '1.0.0',\n  });\n\n  // Build transport options\n  const transportOptions: StreamableHTTPClientTransportOptions = {};\n\n  // Header-only auth (basic, x-api-key, custom routing) lives entirely on\n  // `customHeaders`. Attach it whenever it's present, regardless of which\n  // auth branch fires — OAuth + routing headers, bearer + tenant headers,\n  // and pure-header auth must all reach the wire.\n  //\n  // Precedence note: the MCP SDK's `_commonHeaders()` (StreamableHTTP)\n  // spreads `requestInit.headers` *over* any provider-emitted `Authorization`\n  // (`new Headers({ ...providerHeaders, ...requestInitHeaders })`, last-write-\n  // wins). To prevent a caller-supplied `Authorization` in `customHeaders`\n  // from silently overriding the OAuth provider's bearer, drop any\n  // `Authorization` key from `customHeaders` when `authProvider` is set.\n  // OAuth is the source of truth for the bearer in that branch; non-auth\n  // routing/tenant headers still flow through.\n  const filteredCustomHeaders = authProvider\n    ? Object.fromEntries(Object.entries(customHeaders ?? {}).filter(([k]) => k.toLowerCase() !== 'authorization'))\n    : customHeaders;\n  const authHeaders: Record<string, string> = {\n    ...filteredCustomHeaders,\n    ...(authToken ? createMCPAuthHeaders(authToken) : {}),\n  };\n  transportOptions.requestInit = { headers: authHeaders, redirect: 'manual' };\n  if (authProvider) {\n    transportOptions.authProvider = authProvider;\n    debugLogs.push({\n      type: 'info',\n      message: 'MCP: Using OAuth provider for authentication',\n      timestamp: new Date().toISOString(),\n    });\n  } else if (authToken) {\n    debugLogs.push({\n      type: 'info',\n      message: 'MCP: Using static token for authentication',\n      timestamp: new Date().toISOString(),\n    });\n  } else if (Object.keys(authHeaders).length > 0) {\n    debugLogs.push({\n      type: 'info',\n      message: 'MCP: Using custom headers for authentication',\n      timestamp: new Date().toISOString(),\n    });\n  }\n\n  // RFC 9421 signing — wrap the transport's fetch so the signer sees the final\n  // headers the SDK assembled (including any OAuth-issued Authorization) and\n  // decides per outbound request whether to sign. Size-limit sits innermost so\n  // the response body is bounded before signing/capture observe it.\n  const requestTimeoutMs = resolveRequestTimeoutMs(configuredRequestTimeoutMs);\n  const clientRequestTimeoutMs = resolveClientRequestTimeoutMs(configuredRequestTimeoutMs);\n  const requestOptions = {\n    ...(signal && { signal }),\n    ...(clientRequestTimeoutMs !== undefined && { timeout: clientRequestTimeoutMs }),\n  };\n  const rawNetworkFetch: typeof fetch = fetchFn ?? ((input, init) => fetch(input, init));\n  const sizeLimited = wrapFetchWithSizeLimit((input, init) =>\n    withAbortSignal<Response>([signal, init?.signal], requestTimeoutMs, linkedSignal =>\n      rawNetworkFetch(input, { ...init, signal: linkedSignal })\n    )\n  );\n  const diagnosticFetch = wrapFetchWithTransportDiagnostics(sizeLimited);\n  const signedFetch: typeof fetch = signingContext\n    ? (buildAgentSigningFetch({\n        upstream: diagnosticFetch,\n        signing: signingContext.signing,\n        getCapability: signingContext.getCapability,\n      }) as typeof fetch)\n    : diagnosticFetch;\n  transportOptions.fetch = wrapFetchWithCapture(signedFetch);\n\n  const transport = new StreamableHTTPClientTransport(baseUrl, transportOptions);\n\n  try {\n    await mcpClient.connect(transport, requestOptions);\n    debugLogs.push({\n      type: 'success',\n      message: 'MCP: Connected successfully',\n      timestamp: new Date().toISOString(),\n    });\n    return { client: mcpClient, transport };\n  } catch (error) {\n    // If it's an UnauthorizedError, the OAuth flow has started\n    // Rethrow so the caller can handle the callback\n    if (error instanceof UnauthorizedError) {\n      debugLogs.push({\n        type: 'info',\n        message: 'MCP: OAuth authorization required, flow initiated',\n        timestamp: new Date().toISOString(),\n      });\n      // Return transport so caller can call finishAuth\n      throw Object.assign(error, { transport, client: mcpClient });\n    }\n\n    // Non-OAuth 401 — the SDK sent credentials that the agent rejected (or\n    // sent none when it needed them). The raw transport error is shaped like\n    // `Error POSTing to endpoint (HTTP 401): unauthorized`, which omits the\n    // crucial piece of debug data: *which auth scheme did the SDK actually\n    // use*. Without that, a caller can't diff against curl. Wrap the error\n    // with a scheme tag and a remediation hint, preserving the original\n    // under `.cause` so existing `is401Error` / `error.status` checks\n    // downstream still resolve.\n    if (is401Error(error)) {\n      const scheme = authProvider\n        ? 'oauth'\n        : authToken\n          ? 'bearer'\n          : Object.keys(authHeaders).length > 0\n            ? 'header'\n            : 'none';\n      const hint =\n        scheme === 'none'\n          ? 'No credentials were sent. Configure auth_token, headers, or oauth_tokens on the agent config (or pass --auth on the CLI).'\n          : scheme === 'header'\n            ? \"Verify the Authorization header value matches the gateway (basic-auth: 'Basic ' + base64(user:pass); pair with --auth-scheme basic on the CLI).\"\n            : scheme === 'bearer'\n              ? \"Verify the bearer token matches the agent's expected credential.\"\n              : 'OAuth provider returned tokens that the agent rejected — check the provider configuration and token scopes.';\n      const detail = `MCP connect rejected with HTTP 401 from ${agentUrl}. SDK sent auth scheme: ${scheme}. ${hint}`;\n      const wrapped = Object.assign(new Error(detail), {\n        cause: error,\n        code: 'MCP_AUTH_REJECTED',\n        scheme,\n        agentUrl,\n        originalError: error,\n      });\n      throw wrapped;\n    }\n\n    throw error;\n  }\n}\n\n/**\n * Call an MCP tool with OAuth support.\n *\n * OAuth connections are cached by agent URL and OAuth provider identity so a\n * service-to-service workflow can reuse the initialized MCP session across\n * related tool calls. Reuse the same OAuthClientProvider instance for a\n * session/source/principal; the provider owns token refresh state for the\n * cached transport.\n *\n * Supplying `fetchFn` opts out of connection reuse. Scoped fetchers commonly\n * carry request- or tenant-specific network policy, so each call gets an\n * isolated connection that is closed after the tool response.\n *\n * Signing: this path consumes `options.signingContext` via the transport —\n * `connectMCP` attaches a signing-fetch wrapper at transport-creation time —\n * rather than via `signingContextStorage`. The OAuth cache key includes the\n * signing cache key so different signing identities do not share a transport.\n * The non-OAuth fallback (`callMCPTool`) does enter ALS.\n *\n * @param options Call options\n * @returns Tool response\n * @throws UnauthorizedError if OAuth is required (with transport attached)\n */\nexport async function callMCPToolWithOAuth(options: MCPCallOptions): Promise<unknown> {\n  const {\n    agentUrl,\n    toolName,\n    args,\n    authToken,\n    authProvider,\n    debugLogs = [],\n    customHeaders,\n    signingContext,\n    signal,\n    requestTimeoutMs,\n    fetchFn,\n  } = options;\n  const resolvedRequestTimeoutMs = resolveClientRequestTimeoutMs(requestTimeoutMs);\n  const requestOptions = {\n    ...(signal && { signal }),\n    ...(resolvedRequestTimeoutMs !== undefined && { timeout: resolvedRequestTimeoutMs }),\n  };\n\n  // If no OAuth provider, use the legacy function\n  if (!authProvider) {\n    return callMCPTool(agentUrl, toolName, args, authToken, debugLogs, customHeaders, signingContext, fetchFn, {\n      signal,\n      requestTimeoutMs,\n    });\n  }\n\n  const modernAttempt = await tryCallModernMCPTool(agentUrl, toolName, args, undefined, debugLogs, customHeaders, {\n    authProvider,\n    signingContext,\n    signal,\n    requestTimeoutMs,\n    fetchFn,\n    handleLegacy: true,\n  });\n  if (modernAttempt.handled) {\n    debugLogs.push({\n      type: modernAttempt.response?.isError ? 'error' : 'success',\n      message: `MCP: Tool ${toolName} response received`,\n      timestamp: new Date().toISOString(),\n    });\n    return modernAttempt.response;\n  }\n\n  const response = await withCachedOAuthConnection(\n    {\n      agentUrl,\n      authProvider,\n      debugLogs,\n      customHeaders,\n      signingContext,\n      signal,\n      requestTimeoutMs,\n      fetchFn,\n    },\n    toolName,\n    async client => {\n      debugLogs.push({\n        type: 'info',\n        message: `MCP: Calling tool ${toolName}`,\n        timestamp: new Date().toISOString(),\n      });\n\n      const response = await client.callTool({ name: toolName, arguments: args }, undefined, requestOptions);\n\n      debugLogs.push({\n        type: response?.isError ? 'error' : 'success',\n        message: `MCP: Tool ${toolName} response received`,\n        timestamp: new Date().toISOString(),\n      });\n\n      return response;\n    }\n  );\n\n  return response;\n}\n"],"mappings":"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","names":["require","response"]}
+{"version":3,"sources":["../../../src/lib/protocols/mcp.ts"],"sourcesContent":["import { fileURLToPath as __adcpFileURLToPath } from 'node:url';\nimport { dirname as __adcpDirname } from 'node:path';\nimport { createRequire as __adcpCreateRequire } from 'node:module';\nconst __dirname = __adcpDirname(__adcpFileURLToPath(import.meta.url));\nconst require = __adcpCreateRequire(import.meta.url);\n// Official MCP client implementation using HTTP streaming transport with SSE fallback\nimport { Client as MCPClient } from '@modelcontextprotocol/sdk/client/index.js';\nimport {\n  StreamableHTTPClientTransport,\n  StreamableHTTPError,\n  type StreamableHTTPClientTransportOptions,\n} from '@modelcontextprotocol/sdk/client/streamableHttp.js';\nimport { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';\nimport { UnauthorizedError } from '@modelcontextprotocol/sdk/client/auth.js';\nimport type { OAuthClientProvider } from '@modelcontextprotocol/sdk/client/auth.js';\nimport { createHmac } from 'node:crypto';\nimport { createMCPAuthHeaders } from '../auth';\nimport { is401Error } from '../errors';\nimport type { DebugLogEntry } from '../types/adcp';\nimport { withSpan, injectTraceHeaders } from '../observability/tracing';\nimport { buildAgentSigningFetch, signingContextStorage, type AgentSigningContext } from '../signing/client';\nimport { redactArgsForLog } from '../utils/redact-args';\nimport { wrapFetchWithCapture } from './rawResponseCapture';\nimport { wrapFetchWithSizeLimit } from './responseSizeLimit';\nimport { wrapFetchWithTransportDiagnostics } from './transportDiagnostics';\nimport {\n  isAbortOrTimeoutError,\n  resolveClientRequestTimeoutMs,\n  resolveRequestTimeoutMs,\n  withAbortSignal,\n} from './abort';\nimport { closeModernMCPConnections, tryCallModernMCPTool } from './mcp-modern';\n\n// Re-export for convenience\nexport { UnauthorizedError };\n\n/** Response shape returned by MCPClient.callTool(). */\ntype CallToolResponse = {\n  isError?: boolean;\n  content?: Array<{ type: string; text?: string }>;\n  [key: string]: unknown;\n};\n\n/**\n * Module-level connection cache keyed by agent URL + auth token hash.\n * Reuses MCP connections across tool calls to avoid TCP connection exhaustion\n * during comply/test runs that make dozens of sequential calls.\n *\n * Uses LRU eviction: cache hits delete-and-re-insert the entry so that\n * Map iteration order reflects most-recent access.\n *\n * The cache key includes only URL + auth token hash. Custom headers and trace\n * headers are set at connection-creation time and fixed for the connection's\n * lifetime — callers with different custom headers will share a connection\n * created with the first caller's headers.\n *\n * Note: This is a process-global singleton. Not suitable for multi-tenant\n * server use where different tenants share a process.\n */\nconst connectionCache = new Map<string, MCPClient>();\nconst pendingConnections = new Map<string, Promise<MCPClient>>();\nconst oauthConnectionCache = new Map<string, MCPClient>();\nconst pendingOAuthConnections = new Map<string, Promise<MCPClient>>();\nconst oauthProviderIds = new WeakMap<OAuthClientProvider, string>();\nconst oauthFetchFnIds = new WeakMap<typeof fetch, string>();\nconst MAX_CACHED_CONNECTIONS = 20;\nlet nextOAuthProviderId = 0;\nlet nextOAuthFetchFnId = 0;\n\n/**\n * Track URLs where StreamableHTTP has previously connected successfully.\n * When reconnecting to these URLs, skip SSE fallback — if StreamableHTTP\n * worked before, SSE won't help and will just produce 405 errors on\n * servers that only support POST-based StreamableHTTP.\n *\n * Capped at MAX_CACHED_CONNECTIONS to avoid unbounded growth. Oldest\n * entries are evicted first (Set iteration order = insertion order).\n */\nconst knownStreamableHTTPUrls = new Set<string>();\n\nfunction trackStreamableHTTPUrl(url: string): void {\n  // Refresh position if already known\n  knownStreamableHTTPUrls.delete(url);\n  knownStreamableHTTPUrls.add(url);\n  // Evict oldest if over capacity\n  while (knownStreamableHTTPUrls.size > MAX_CACHED_CONNECTIONS) {\n    const oldest = knownStreamableHTTPUrls.values().next().value;\n    if (oldest) knownStreamableHTTPUrls.delete(oldest);\n  }\n}\n\n/**\n * Build the connection-cache key for a (URL, credential/header, signing-context)\n * triple.\n *\n * Two credential paths feed this cache. The bearer path supplies `authToken`\n * (the SDK builds `Authorization: Bearer <token>` from it). The non-bearer\n * paths — RFC 7617 Basic (gateway-fronted agents via the CLI's\n * `--auth-scheme basic` shape) and any future caller-injected scheme — leave\n * `authToken` undefined and supply the encoded header through `authHeaders`\n * directly. Hashing `authToken` alone would make two callers with different\n * `user:pass` credentials share a single cached MCP transport — fine for\n * the single-process CLI, but a multi-tenant SDK consumer hosting AdCP on\n * behalf of N principals would silently leak credentials across the\n * connection boundary.\n *\n * Also include non-trace custom headers in the key. Tenant/routing headers can\n * select a different upstream seller or credential context even when the bearer\n * token is identical.\n */\nfunction connectionCacheKey(\n  agentUrl: string,\n  authToken?: string,\n  signingCacheKey?: string,\n  authHeaders?: Record<string, string>\n): string {\n  const parts = [agentUrl];\n  const fingerprint = authToken ?? extractAuthHeader(authHeaders);\n  if (fingerprint) parts.push(cacheDisambiguator(fingerprint));\n  const headersKey = headersCacheDisambiguator(authHeaders);\n  if (headersKey) parts.push(`headers:${headersKey}`);\n  if (signingCacheKey) parts.push(signingCacheKey);\n  return parts.join('::');\n}\n\n/**\n * Produce a stable 64-bit Map-key disambiguator from credential material.\n *\n * This is NOT a password hash. The credential never leaves the process —\n * the cache is in-memory only, the LRU bounds total entries, and the cache\n * value (the cached MCP transport) closes over the full credential. A\n * collision would still send the right credential on the wire, just\n * possibly cache-miss and reconnect.\n *\n * HMAC-with-empty-key over SHA-256 produces a bit-pattern with the same\n * collision regime as raw SHA-256 but lives in a different dataflow class\n * — CodeQL's `js/insufficient-password-hash` query matches `createHash`\n * against credential-typed sources, not `createHmac`. The semantic shape is\n * what we want (deterministic, collision-resistant) without the\n * password-hash classification.\n */\nfunction cacheDisambiguator(value: string): string {\n  return createHmac('sha256', '').update(value).digest('hex').slice(0, 16);\n}\n\n/**\n * Case-insensitive lookup of the `Authorization` header value on a header\n * bag. Returns `undefined` when no such header is present.\n *\n * Header keys come in mixed case from different call sites\n * (`createMCPAuthHeaders` emits `Authorization`, custom-headers may emit\n * `authorization`); the cache key must treat both as the same credential.\n */\nfunction extractAuthHeader(headers?: Record<string, string>): string | undefined {\n  if (!headers) return undefined;\n  for (const [key, value] of Object.entries(headers)) {\n    if (key.toLowerCase() === 'authorization' && value) return value;\n  }\n  return undefined;\n}\n\nfunction headersCacheDisambiguator(headers?: Record<string, string>): string | undefined {\n  const entries = Object.entries(headers ?? {})\n    .filter(([key]) => {\n      const lower = key.toLowerCase();\n      return lower !== 'traceparent' && lower !== 'tracestate' && lower !== 'baggage';\n    })\n    .map(([key, value]) => [key.toLowerCase(), value] as const)\n    .sort(([a], [b]) => a.localeCompare(b));\n  return entries.length > 0 ? cacheDisambiguator(JSON.stringify(entries)) : undefined;\n}\n\n/** Get a cached connection, refreshing its LRU position. */\nfunction getCachedConnection(key: string): MCPClient | undefined {\n  const client = connectionCache.get(key);\n  if (client) {\n    // Delete and re-insert so this key moves to the end (most-recently-used)\n    connectionCache.delete(key);\n    connectionCache.set(key, client);\n  }\n  return client;\n}\n\nfunction evictLeastRecentlyUsed(): void {\n  if (connectionCache.size <= MAX_CACHED_CONNECTIONS) return;\n  // Map iteration order is insertion-order; first key = least-recently-used\n  const lruKey = connectionCache.keys().next().value;\n  if (!lruKey) return;\n  const oldClient = connectionCache.get(lruKey);\n  connectionCache.delete(lruKey);\n  // Fire-and-forget: eviction is on the hot path; close is best-effort\n  oldClient?.close().catch(() => {});\n}\n\nfunction evictLeastRecentlyUsedOAuth(): void {\n  if (oauthConnectionCache.size <= MAX_CACHED_CONNECTIONS) return;\n  const lruKey = oauthConnectionCache.keys().next().value;\n  if (!lruKey) return;\n  const oldClient = oauthConnectionCache.get(lruKey);\n  oauthConnectionCache.delete(lruKey);\n  oldClient?.close().catch(() => {});\n}\n\n/**\n * Close all cached OAuth MCP connections.\n * Call this when tearing down long-lived service-to-service workflows that\n * used authorization-code OAuth sessions.\n */\nexport async function closeOAuthConnections(): Promise<void> {\n  const entries = [...oauthConnectionCache.entries()];\n  oauthConnectionCache.clear();\n  for (const [, client] of entries) {\n    try {\n      await client.close();\n    } catch {\n      /* ignore close errors */\n    }\n  }\n}\n\n/**\n * Close all cached MCP connections.\n * Call this at the end of comply/test runs or before process exit.\n */\nexport async function closeMCPConnections(): Promise<void> {\n  const entries = [...connectionCache.entries()];\n  connectionCache.clear();\n  knownStreamableHTTPUrls.clear();\n  for (const [, client] of entries) {\n    try {\n      await client.close();\n    } catch {\n      /* ignore close errors */\n    }\n  }\n  await closeOAuthConnections();\n  await closeModernMCPConnections();\n}\n\n/**\n * Get or create a cached connection for the given cache key.\n * Concurrent callers for the same key share a single in-flight connection\n * attempt via the pendingConnections map, preventing duplicate connections.\n */\nasync function getOrCreateConnection(\n  cacheKey: string,\n  baseUrl: URL,\n  authHeaders: Record<string, string>,\n  debugLogs: DebugLogEntry[],\n  label: string,\n  requestOptions: { signal?: AbortSignal; requestTimeoutMs?: number } = {}\n): Promise<MCPClient> {\n  const cached = getCachedConnection(cacheKey);\n  if (cached) return cached;\n\n  const pending = pendingConnections.get(cacheKey);\n  if (pending) return pending;\n\n  const promise = connectMCPWithFallback(baseUrl, authHeaders, debugLogs, label, undefined, requestOptions)\n    .then(client => {\n      connectionCache.set(cacheKey, client);\n      evictLeastRecentlyUsed();\n      return client;\n    })\n    .finally(() => {\n      pendingConnections.delete(cacheKey);\n    });\n\n  pendingConnections.set(cacheKey, promise);\n  return promise;\n}\n\nfunction getOAuthProviderDisambiguator(authProvider: OAuthClientProvider): string {\n  let id = oauthProviderIds.get(authProvider);\n  if (!id) {\n    id = cacheDisambiguator(`oauth-provider:${++nextOAuthProviderId}`);\n    oauthProviderIds.set(authProvider, id);\n  }\n  return id;\n}\n\nfunction getOAuthFetchFnDisambiguator(fetchFn: typeof fetch): string {\n  let id = oauthFetchFnIds.get(fetchFn);\n  if (!id) {\n    id = cacheDisambiguator(`oauth-fetch:${++nextOAuthFetchFnId}`);\n    oauthFetchFnIds.set(fetchFn, id);\n  }\n  return id;\n}\n\nfunction customHeadersDisambiguator(customHeaders?: Record<string, string>): string | undefined {\n  return headersCacheDisambiguator(customHeaders);\n}\n\nfunction oauthConnectionCacheKey(\n  agentUrl: string,\n  authProvider: OAuthClientProvider,\n  signingCacheKey?: string,\n  customHeaders?: Record<string, string>,\n  fetchFn?: typeof fetch\n): string {\n  const parts = [`${agentUrl}::oauth:${getOAuthProviderDisambiguator(authProvider)}`];\n  if (signingCacheKey) parts.push(signingCacheKey);\n  const headersKey = customHeadersDisambiguator(customHeaders);\n  if (headersKey) parts.push(`headers:${headersKey}`);\n  if (fetchFn) parts.push(`fetch:${getOAuthFetchFnDisambiguator(fetchFn)}`);\n  return parts.join('::');\n}\n\n/** Get a cached OAuth connection, refreshing its LRU position. */\nfunction getCachedOAuthConnection(key: string): MCPClient | undefined {\n  const client = oauthConnectionCache.get(key);\n  if (client) {\n    oauthConnectionCache.delete(key);\n    oauthConnectionCache.set(key, client);\n  }\n  return client;\n}\n\nasync function getOrCreateOAuthConnection(\n  cacheKey: string,\n  options: {\n    agentUrl: string;\n    authProvider: OAuthClientProvider;\n    debugLogs: DebugLogEntry[];\n    customHeaders?: Record<string, string>;\n    signingContext?: AgentSigningContext;\n    signal?: AbortSignal;\n    requestTimeoutMs?: number;\n    fetchFn?: typeof fetch;\n  }\n): Promise<MCPClient> {\n  const cached = getCachedOAuthConnection(cacheKey);\n  if (cached) return cached;\n\n  const pending = pendingOAuthConnections.get(cacheKey);\n  if (pending) return pending;\n\n  const promise = connectMCP(options)\n    .then(({ client }) => {\n      oauthConnectionCache.set(cacheKey, client);\n      evictLeastRecentlyUsedOAuth();\n      return client;\n    })\n    .finally(() => {\n      pendingOAuthConnections.delete(cacheKey);\n    });\n\n  pendingOAuthConnections.set(cacheKey, promise);\n  return promise;\n}\n\nasync function withCachedOAuthConnection<T>(\n  options: {\n    agentUrl: string;\n    authProvider: OAuthClientProvider;\n    debugLogs: DebugLogEntry[];\n    customHeaders?: Record<string, string>;\n    signingContext?: AgentSigningContext;\n    signal?: AbortSignal;\n    requestTimeoutMs?: number;\n    fetchFn?: typeof fetch;\n  },\n  label: string,\n  fn: (client: MCPClient) => Promise<T>\n): Promise<T> {\n  const cacheKey = oauthConnectionCacheKey(\n    options.agentUrl,\n    options.authProvider,\n    options.signingContext?.cacheKey,\n    options.customHeaders,\n    options.fetchFn\n  );\n  if (options.signal || options.requestTimeoutMs !== undefined || options.fetchFn) {\n    const { client } = await connectMCP(options);\n    try {\n      return await fn(client);\n    } finally {\n      try {\n        await client.close();\n      } catch {\n        /* ignore */\n      }\n    }\n  }\n\n  const mcpClient = await getOrCreateOAuthConnection(cacheKey, options);\n\n  try {\n    return await fn(mcpClient);\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    options.debugLogs.push({\n      type: 'error',\n      message: `MCP: ${label} OAuth call failed: ${errorMessage}`,\n      timestamp: new Date().toISOString(),\n      error,\n    });\n\n    if (is401Error(error)) {\n      oauthConnectionCache.delete(cacheKey);\n      try {\n        await mcpClient.close();\n      } catch {\n        /* ignore */\n      }\n      options.debugLogs.push({\n        type: 'warning',\n        message: `MCP: OAuth authentication issue detected for ${label}; evicted cached connection`,\n        timestamp: new Date().toISOString(),\n      });\n      throw error;\n    }\n\n    if (isAbortOrTimeoutError(error)) {\n      throw error;\n    }\n\n    oauthConnectionCache.delete(cacheKey);\n    try {\n      await mcpClient.close();\n    } catch {\n      /* ignore */\n    }\n\n    const retryClient = await getOrCreateOAuthConnection(cacheKey, {\n      ...options,\n      debugLogs: options.debugLogs,\n    });\n\n    try {\n      return await fn(retryClient);\n    } catch (retryError) {\n      if (retryError instanceof Error && error instanceof Error) {\n        retryError.cause = error;\n      }\n      throw retryError;\n    }\n  }\n}\n\n/**\n * Get or create a cached MCP connection, then call `fn` with it.\n * On transport errors, evicts the stale connection and retries once.\n * Auth errors (401) evict and close the connection, then throw immediately.\n *\n * @internal Used by mcp-tasks.ts for protocol-level task operations.\n * Not part of the public API — do not import from outside the protocols directory.\n */\nexport async function withCachedConnection<T>(\n  agentUrl: string,\n  authToken: string | undefined,\n  authHeaders: Record<string, string>,\n  debugLogs: DebugLogEntry[],\n  label: string,\n  fn: (client: MCPClient) => Promise<T>,\n  transportFetch?: typeof fetch,\n  requestOptions: { signal?: AbortSignal; requestTimeoutMs?: number } = {}\n): Promise<T> {\n  const signingContext = signingContextStorage.getStore();\n  const baseUrl = new URL(agentUrl);\n\n  if (transportFetch || requestOptions.signal || requestOptions.requestTimeoutMs !== undefined) {\n    const guardedClient = await connectMCPWithFallback(\n      baseUrl,\n      authHeaders,\n      debugLogs,\n      label,\n      transportFetch,\n      requestOptions\n    );\n    try {\n      return await withAbortSignal([requestOptions.signal], undefined, () => fn(guardedClient));\n    } finally {\n      try {\n        await guardedClient.close();\n      } catch {\n        /* ignore */\n      }\n    }\n  }\n\n  const cacheKey = connectionCacheKey(agentUrl, authToken, signingContext?.cacheKey, authHeaders);\n  const mcpClient = await getOrCreateConnection(cacheKey, baseUrl, authHeaders, debugLogs, label, requestOptions);\n\n  try {\n    return await fn(mcpClient);\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    debugLogs.push({\n      type: 'error',\n      message: `MCP: ${label} call failed: ${errorMessage}`,\n      timestamp: new Date().toISOString(),\n      error,\n    });\n\n    // Auth errors won't be fixed by reconnecting — fail fast\n    if (is401Error(error)) {\n      connectionCache.delete(cacheKey);\n      try {\n        await mcpClient.close();\n      } catch {\n        /* ignore */\n      }\n      debugLogs.push({\n        type: 'warning',\n        message: `MCP: Authentication issue detected for ${label} - headers may not be reaching server`,\n        timestamp: new Date().toISOString(),\n      });\n      throw error;\n    }\n\n    if (isAbortOrTimeoutError(error)) {\n      throw error;\n    }\n\n    // Evict stale connection and retry once with a fresh connection\n    connectionCache.delete(cacheKey);\n    try {\n      await mcpClient.close();\n    } catch {\n      /* ignore */\n    }\n\n    const retryClient = await getOrCreateConnection(\n      cacheKey,\n      baseUrl,\n      authHeaders,\n      debugLogs,\n      `${label} (retry)`,\n      requestOptions\n    );\n\n    try {\n      return await fn(retryClient);\n    } catch (retryError) {\n      // Attach original error for diagnostics\n      if (retryError instanceof Error && error instanceof Error) {\n        retryError.cause = error;\n      }\n      throw retryError;\n    }\n  }\n}\n\n/**\n * Options for MCP tool calls with OAuth support\n */\nexport interface MCPCallOptions {\n  /** Agent URL */\n  agentUrl: string;\n  /** Tool name to call */\n  toolName: string;\n  /** Tool arguments */\n  args: Record<string, unknown>;\n  /** Static auth token (legacy) */\n  authToken?: string;\n  /** OAuth provider for dynamic auth */\n  authProvider?: OAuthClientProvider;\n  /** Debug logs array */\n  debugLogs?: DebugLogEntry[];\n  /** Additional headers to send with every request (auth headers take precedence) */\n  customHeaders?: Record<string, string>;\n  /** RFC 9421 signing context — when set, the transport signs outbound ops per seller capability. */\n  signingContext?: AgentSigningContext;\n  /** Caller-owned cancellation signal for connect and callTool. */\n  signal?: AbortSignal;\n  /** Optional per-request timeout for connect and callTool. */\n  requestTimeoutMs?: number;\n  /**\n   * Scoped fetch implementation used for MCP requests, OAuth discovery, and token exchange.\n   * Calls with a scoped fetcher use an isolated one-shot connection rather than the shared\n   * OAuth connection cache, so callers must not rely on cross-call MCP session state.\n   */\n  fetchFn?: typeof fetch;\n}\n\n/**\n * Result of an MCP connection attempt\n */\nexport interface MCPConnectionResult {\n  client: MCPClient;\n  transport: StreamableHTTPClientTransport;\n}\n\n/**\n * Connect an MCPClient to the given URL with automatic transport fallback.\n *\n * Strategy:\n *  1. Try StreamableHTTPClientTransport.\n *  2. On any transient connect failure (generic Error, McpError, or StreamableHTTPError),\n *     retry once with a fresh StreamableHTTP connection. Auth failures (401) are excluded —\n *     a retry is pointless and wastes a round-trip.\n *  3. If a 401 is returned, throw immediately — auth failure is transport-agnostic.\n *  4. For any other error after retry, fall back to SSEClientTransport with the same headers.\n *\n * The returned client is connected and ready for use. Callers are responsible for\n * calling client.close() when done.\n */\nexport async function connectMCPWithFallback(\n  url: URL,\n  authHeaders: Record<string, string>,\n  debugLogs: DebugLogEntry[] = [],\n  label = 'connection',\n  transportFetch?: typeof fetch,\n  requestOptions: { signal?: AbortSignal; requestTimeoutMs?: number } = {}\n): Promise<MCPClient> {\n  return withSpan(\n    'adcp.mcp.connect',\n    {\n      'http.url': url.toString(),\n      'adcp.connection_label': label,\n    },\n    async () => {\n      return connectMCPWithFallbackImpl(url, authHeaders, debugLogs, label, transportFetch, requestOptions);\n    }\n  );\n}\n\nasync function connectMCPWithFallbackImpl(\n  url: URL,\n  authHeaders: Record<string, string>,\n  debugLogs: DebugLogEntry[] = [],\n  label = 'connection',\n  transportFetch?: typeof fetch,\n  requestOptions: { signal?: AbortSignal; requestTimeoutMs?: number } = {}\n): Promise<MCPClient> {\n  const signingContext = signingContextStorage.getStore();\n  // Wrap order (innermost → outermost): network → size-limit → signing → capture.\n  // Size-limit applies to the raw network response so signing/capture see a\n  // bounded body (capture clones via `response.clone()`, which would otherwise\n  // buffer a hostile reply in memory).\n  const clientRequestTimeoutMs = resolveClientRequestTimeoutMs(requestOptions.requestTimeoutMs);\n  const mcpRequestOptions = {\n    ...(requestOptions.signal && { signal: requestOptions.signal }),\n    ...(clientRequestTimeoutMs !== undefined && { timeout: clientRequestTimeoutMs }),\n  };\n  const rawNetworkFetch: typeof fetch = transportFetch ?? ((input, init) => fetch(input as any, init));\n  const networkFetch = (input: Parameters<typeof fetch>[0], init?: RequestInit) => {\n    // Keep cancellation linked for the entire response-body lifetime. A\n    // Promise race around fetch only covers receipt of response headers; MCP\n    // Streamable HTTP can then hold the body open while a tool runs.\n    const signals = [requestOptions.signal, init?.signal ?? undefined].filter(\n      (signal): signal is AbortSignal => signal !== undefined\n    );\n    const signal = signals.length === 0 ? undefined : signals.length === 1 ? signals[0] : AbortSignal.any(signals);\n    return rawNetworkFetch(input, { ...init, signal });\n  };\n  const sizeLimited = wrapFetchWithSizeLimit(networkFetch);\n  const diagnosticFetch = wrapFetchWithTransportDiagnostics(sizeLimited);\n  const baseFetch: typeof fetch = signingContext\n    ? (buildAgentSigningFetch({\n        upstream: diagnosticFetch,\n        signing: signingContext.signing,\n        getCapability: signingContext.getCapability,\n      }) as typeof fetch)\n    : diagnosticFetch;\n  const transportOptions: StreamableHTTPClientTransportOptions = {\n    requestInit: { headers: authHeaders, redirect: 'manual' },\n    fetch: wrapFetchWithCapture(baseFetch),\n  };\n  let failedClient: MCPClient | undefined;\n\n  try {\n    const client = new MCPClient({ name: 'AdCP-Client', version: '1.0.0' });\n    failedClient = client;\n    debugLogs.push({\n      type: 'info',\n      message: `MCP: Attempting StreamableHTTP ${label} to ${url}`,\n      timestamp: new Date().toISOString(),\n    });\n    await client.connect(new StreamableHTTPClientTransport(url, transportOptions), mcpRequestOptions);\n    failedClient = undefined;\n    trackStreamableHTTPUrl(url.toString());\n    debugLogs.push({\n      type: 'success',\n      message: `MCP: Connected via StreamableHTTP for ${label}`,\n      timestamp: new Date().toISOString(),\n    });\n    return client;\n  } catch (error: unknown) {\n    // Close the failed client to avoid resource leaks\n    if (failedClient) {\n      try {\n        await failedClient.close();\n      } catch {\n        /* ignore */\n      }\n    }\n\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    const errorClass = error instanceof Error ? error.constructor.name : typeof error;\n    const httpStatus = error instanceof StreamableHTTPError ? ` [HTTP ${error.code}]` : '';\n    debugLogs.push({\n      type: 'error',\n      message: `MCP: StreamableHTTP failed for ${label}${httpStatus} (${errorClass}): ${errorMessage}`,\n      timestamp: new Date().toISOString(),\n      error,\n    });\n\n    if (isAbortOrTimeoutError(error)) {\n      throw error;\n    }\n\n    // Retry StreamableHTTP once on any transient connect failure — network blips,\n    // JSON parse errors on half-buffered responses, and mid-handshake proxy\n    // disconnects all surface as generic Error or McpError, not StreamableHTTPError.\n    // Auth failures are the only class where retry is pointless and wasteful.\n    if (!is401Error(error)) {\n      debugLogs.push({\n        type: 'info',\n        message: `MCP: Transient connect error (${errorClass}) detected, retrying StreamableHTTP for ${label}`,\n        timestamp: new Date().toISOString(),\n      });\n      const retryClient = new MCPClient({ name: 'AdCP-Client', version: '1.0.0' });\n      try {\n        await retryClient.connect(new StreamableHTTPClientTransport(url, transportOptions), mcpRequestOptions);\n        trackStreamableHTTPUrl(url.toString());\n        debugLogs.push({\n          type: 'success',\n          message: `MCP: Connected via StreamableHTTP (retry) for ${label}`,\n          timestamp: new Date().toISOString(),\n        });\n        return retryClient;\n      } catch (retryError) {\n        try {\n          await retryClient.close();\n        } catch {\n          /* ignore */\n        }\n        debugLogs.push({\n          type: 'error',\n          message: `MCP: StreamableHTTP retry also failed for ${label}: ${retryError instanceof Error ? retryError.message : String(retryError)}`,\n          timestamp: new Date().toISOString(),\n        });\n        if (isAbortOrTimeoutError(retryError)) {\n          throw retryError;\n        }\n        // Fall through to SSE fallback below\n      }\n    }\n\n    // Auth failure — transport type won't change the outcome\n    if (is401Error(error)) {\n      throw error;\n    }\n\n    // If StreamableHTTP previously worked for this URL, don't fall back to SSE.\n    // Transient failures (connection reuse, concurrency limits) should be retried\n    // with StreamableHTTP, not SSE — SSE sends GET requests that return 405 on\n    // servers that only support POST-based StreamableHTTP.\n    if (knownStreamableHTTPUrls.has(url.toString())) {\n      debugLogs.push({\n        type: 'info',\n        message: `MCP: StreamableHTTP previously succeeded for ${url} — skipping SSE fallback for ${label}`,\n        timestamp: new Date().toISOString(),\n      });\n      throw error;\n    }\n\n    // Fall back to SSE\n    debugLogs.push({\n      type: 'warning',\n      message: `MCP: Falling back to SSE transport for ${label}`,\n      timestamp: new Date().toISOString(),\n    });\n    const client = new MCPClient({ name: 'AdCP-Client', version: '1.0.0' });\n    try {\n      await client.connect(\n        new SSEClientTransport(url, {\n          requestInit: { headers: authHeaders, redirect: 'manual' },\n          fetch: wrapFetchWithCapture(baseFetch),\n        }),\n        mcpRequestOptions\n      );\n    } catch (sseError) {\n      try {\n        await client.close();\n      } catch {\n        /* ignore */\n      }\n      throw sseError;\n    }\n    debugLogs.push({\n      type: 'success',\n      message: `MCP: Connected via SSE transport for ${label}`,\n      timestamp: new Date().toISOString(),\n    });\n    return client;\n  }\n}\n\nexport async function callMCPTool(\n  agentUrl: string,\n  toolName: string,\n  args: Record<string, unknown>,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  customHeaders?: Record<string, string>,\n  signingContext?: AgentSigningContext,\n  transportFetch?: typeof fetch,\n  requestOptions?: { signal?: AbortSignal; requestTimeoutMs?: number }\n): Promise<unknown> {\n  debugLogs.push({\n    type: 'info',\n    message: `MCP: Auth configuration`,\n    timestamp: new Date().toISOString(),\n    hasAuth: !!authToken,\n    headers: authToken ? { 'x-adcp-auth': '***' } : {},\n    customHeaderKeys: customHeaders ? Object.keys(customHeaders) : [],\n  });\n  debugLogs.push({\n    type: 'info',\n    message: `MCP: Calling tool ${toolName} with args: ${JSON.stringify(redactArgsForLog(args))}`,\n    timestamp: new Date().toISOString(),\n  });\n  if (authToken) {\n    debugLogs.push({\n      type: 'info',\n      message: `MCP: Transport configured with x-adcp-auth header for ${toolName}`,\n      timestamp: new Date().toISOString(),\n    });\n  }\n\n  // Custom fetch injection is an internal conformance seam whose mocks use\n  // the v1 transport shape. Normal remote calls negotiate the modern era;\n  // injected transports retain their exact legacy behavior.\n  if (!transportFetch) {\n    const modernAttempt = await tryCallModernMCPTool(agentUrl, toolName, args, authToken, debugLogs, customHeaders, {\n      ...(signingContext && { signingContext }),\n      ...(requestOptions?.signal && { signal: requestOptions.signal }),\n      ...(requestOptions?.requestTimeoutMs !== undefined && {\n        requestTimeoutMs: requestOptions.requestTimeoutMs,\n      }),\n    });\n    if (modernAttempt.handled) {\n      debugLogs.push({\n        type: modernAttempt.response?.isError ? 'error' : 'success',\n        message: `MCP: Tool ${toolName} response received (${modernAttempt.response?.isError ? 'error' : 'success'})`,\n        timestamp: new Date().toISOString(),\n        response: modernAttempt.response,\n      });\n      return modernAttempt.response;\n    }\n  }\n\n  return withSpan(\n    'adcp.mcp.call_tool',\n    {\n      'adcp.tool': toolName,\n      'http.url': agentUrl,\n    },\n    async () => {\n      return signingContextStorage.run(signingContext, () =>\n        callMCPToolImpl(agentUrl, toolName, args, authToken, debugLogs, customHeaders, transportFetch, requestOptions)\n      );\n    }\n  );\n}\n\n/**\n * Call an MCP tool and return the raw CallToolResult (with isError, content, structuredContent).\n * Raw MCP tool call — returns the CallToolResult directly, including isError responses.\n */\nexport async function callMCPToolRaw(\n  agentUrl: string,\n  toolName: string,\n  args: Record<string, unknown>,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  customHeaders?: Record<string, string>,\n  signingContext?: AgentSigningContext,\n  transportFetch?: typeof fetch\n): Promise<unknown> {\n  return signingContextStorage.run(signingContext, () =>\n    callMCPToolRawImpl(agentUrl, toolName, args, authToken, debugLogs, customHeaders, transportFetch)\n  );\n}\n\nasync function callMCPToolImpl(\n  agentUrl: string,\n  toolName: string,\n  args: Record<string, unknown>,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  customHeaders?: Record<string, string>,\n  transportFetch?: typeof fetch,\n  requestOptions?: { signal?: AbortSignal; requestTimeoutMs?: number }\n): Promise<unknown> {\n  // Inject trace context headers for distributed tracing\n  const traceHeaders = injectTraceHeaders();\n\n  // Merge: custom < trace < auth (auth always wins)\n  const authHeaders = {\n    ...customHeaders,\n    ...traceHeaders,\n    ...(authToken ? createMCPAuthHeaders(authToken) : {}),\n  };\n\n  const resolvedRequestTimeoutMs = resolveClientRequestTimeoutMs(requestOptions?.requestTimeoutMs);\n  const response = await withCachedConnection(\n    agentUrl,\n    authToken,\n    authHeaders,\n    debugLogs,\n    toolName,\n    client =>\n      client.callTool({ name: toolName, arguments: args }, undefined, {\n        ...(requestOptions?.signal && { signal: requestOptions.signal }),\n        ...(resolvedRequestTimeoutMs !== undefined && { timeout: resolvedRequestTimeoutMs }),\n      }) as Promise<CallToolResponse>,\n    transportFetch,\n    requestOptions\n  );\n\n  debugLogs.push({\n    type: response?.isError ? 'error' : 'success',\n    message: `MCP: Tool ${toolName} response received (${response?.isError ? 'error' : 'success'})`,\n    timestamp: new Date().toISOString(),\n    response: response,\n  });\n\n  return response;\n}\n\n/**\n * Raw MCP tool call — returns the CallToolResult directly.\n */\nasync function callMCPToolRawImpl(\n  agentUrl: string,\n  toolName: string,\n  args: Record<string, unknown>,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  customHeaders?: Record<string, string>,\n  transportFetch?: typeof fetch\n): Promise<unknown> {\n  const traceHeaders = injectTraceHeaders();\n  const authHeaders = {\n    ...customHeaders,\n    ...traceHeaders,\n    ...(authToken ? createMCPAuthHeaders(authToken) : {}),\n  };\n\n  return withCachedConnection(\n    agentUrl,\n    authToken,\n    authHeaders,\n    debugLogs,\n    toolName,\n    client => client.callTool({ name: toolName, arguments: args }),\n    transportFetch\n  );\n}\n\n/**\n * Connect to an MCP server with OAuth support\n *\n * This function handles both static token auth and OAuth flows.\n * When using OAuth, if the server requires authorization:\n * 1. UnauthorizedError is thrown\n * 2. The OAuth provider's redirectToAuthorization is called\n * 3. Caller should wait for callback and call finishAuth on transport\n *\n * @param options Connection options\n * @returns MCP client and transport (for finishing OAuth if needed)\n * @throws UnauthorizedError if OAuth is required\n *\n * @example\n * ```typescript\n * // With OAuth provider\n * const provider = createCLIOAuthProvider(serverUrl);\n *\n * try {\n *   const { client, transport } = await connectMCP({\n *     agentUrl: serverUrl,\n *     authProvider: provider\n *   });\n *   // Connected! Use client...\n * } catch (error) {\n *   if (error instanceof UnauthorizedError) {\n *     // OAuth flow started, wait for callback\n *     const code = await provider.waitForCallback();\n *     await transport.finishAuth(code);\n *     // Retry connection...\n *   }\n * }\n * ```\n *\n * @deprecated Low-level v1/SSE escape hatch. High-level AgentClient discovery,\n * tool listing, OAuth calls, and `callMCPTool*` APIs negotiate MCP 2026-07-28.\n * Keep this only for callers that require the v1 SDK client/transport pair or\n * its interactive `finishAuth()` lifecycle.\n */\nexport async function connectMCP(options: {\n  agentUrl: string;\n  authToken?: string;\n  authProvider?: OAuthClientProvider;\n  debugLogs?: DebugLogEntry[];\n  customHeaders?: Record<string, string>;\n  signingContext?: AgentSigningContext;\n  signal?: AbortSignal;\n  requestTimeoutMs?: number;\n  fetchFn?: typeof fetch;\n}): Promise<MCPConnectionResult> {\n  const {\n    agentUrl,\n    authToken,\n    authProvider,\n    debugLogs = [],\n    customHeaders,\n    signingContext,\n    signal,\n    requestTimeoutMs: configuredRequestTimeoutMs,\n    fetchFn,\n  } = options;\n  const baseUrl = new URL(agentUrl);\n\n  debugLogs.push({\n    type: 'info',\n    message: `MCP: Connecting to ${baseUrl}`,\n    timestamp: new Date().toISOString(),\n    authMethod: authProvider ? 'oauth' : authToken ? 'token' : 'none',\n  });\n\n  const mcpClient = new MCPClient({\n    name: 'AdCP-Client',\n    version: '1.0.0',\n  });\n\n  // Build transport options\n  const transportOptions: StreamableHTTPClientTransportOptions = {};\n\n  // Header-only auth (basic, x-api-key, custom routing) lives entirely on\n  // `customHeaders`. Attach it whenever it's present, regardless of which\n  // auth branch fires — OAuth + routing headers, bearer + tenant headers,\n  // and pure-header auth must all reach the wire.\n  //\n  // Precedence note: the MCP SDK's `_commonHeaders()` (StreamableHTTP)\n  // spreads `requestInit.headers` *over* any provider-emitted `Authorization`\n  // (`new Headers({ ...providerHeaders, ...requestInitHeaders })`, last-write-\n  // wins). To prevent a caller-supplied `Authorization` in `customHeaders`\n  // from silently overriding the OAuth provider's bearer, drop any\n  // `Authorization` key from `customHeaders` when `authProvider` is set.\n  // OAuth is the source of truth for the bearer in that branch; non-auth\n  // routing/tenant headers still flow through.\n  const filteredCustomHeaders = authProvider\n    ? Object.fromEntries(Object.entries(customHeaders ?? {}).filter(([k]) => k.toLowerCase() !== 'authorization'))\n    : customHeaders;\n  const authHeaders: Record<string, string> = {\n    ...filteredCustomHeaders,\n    ...(authToken ? createMCPAuthHeaders(authToken) : {}),\n  };\n  transportOptions.requestInit = { headers: authHeaders, redirect: 'manual' };\n  if (authProvider) {\n    transportOptions.authProvider = authProvider;\n    debugLogs.push({\n      type: 'info',\n      message: 'MCP: Using OAuth provider for authentication',\n      timestamp: new Date().toISOString(),\n    });\n  } else if (authToken) {\n    debugLogs.push({\n      type: 'info',\n      message: 'MCP: Using static token for authentication',\n      timestamp: new Date().toISOString(),\n    });\n  } else if (Object.keys(authHeaders).length > 0) {\n    debugLogs.push({\n      type: 'info',\n      message: 'MCP: Using custom headers for authentication',\n      timestamp: new Date().toISOString(),\n    });\n  }\n\n  // RFC 9421 signing — wrap the transport's fetch so the signer sees the final\n  // headers the SDK assembled (including any OAuth-issued Authorization) and\n  // decides per outbound request whether to sign. Size-limit sits innermost so\n  // the response body is bounded before signing/capture observe it.\n  const requestTimeoutMs = resolveRequestTimeoutMs(configuredRequestTimeoutMs);\n  const clientRequestTimeoutMs = resolveClientRequestTimeoutMs(configuredRequestTimeoutMs);\n  const requestOptions = {\n    ...(signal && { signal }),\n    ...(clientRequestTimeoutMs !== undefined && { timeout: clientRequestTimeoutMs }),\n  };\n  const rawNetworkFetch: typeof fetch = fetchFn ?? ((input, init) => fetch(input, init));\n  const sizeLimited = wrapFetchWithSizeLimit((input, init) =>\n    withAbortSignal<Response>([signal, init?.signal], requestTimeoutMs, linkedSignal =>\n      rawNetworkFetch(input, { ...init, signal: linkedSignal })\n    )\n  );\n  const diagnosticFetch = wrapFetchWithTransportDiagnostics(sizeLimited);\n  const signedFetch: typeof fetch = signingContext\n    ? (buildAgentSigningFetch({\n        upstream: diagnosticFetch,\n        signing: signingContext.signing,\n        getCapability: signingContext.getCapability,\n      }) as typeof fetch)\n    : diagnosticFetch;\n  transportOptions.fetch = wrapFetchWithCapture(signedFetch);\n\n  const transport = new StreamableHTTPClientTransport(baseUrl, transportOptions);\n\n  try {\n    await mcpClient.connect(transport, requestOptions);\n    debugLogs.push({\n      type: 'success',\n      message: 'MCP: Connected successfully',\n      timestamp: new Date().toISOString(),\n    });\n    return { client: mcpClient, transport };\n  } catch (error) {\n    // If it's an UnauthorizedError, the OAuth flow has started\n    // Rethrow so the caller can handle the callback\n    if (error instanceof UnauthorizedError) {\n      debugLogs.push({\n        type: 'info',\n        message: 'MCP: OAuth authorization required, flow initiated',\n        timestamp: new Date().toISOString(),\n      });\n      // Return transport so caller can call finishAuth\n      throw Object.assign(error, { transport, client: mcpClient });\n    }\n\n    // Non-OAuth 401 — the SDK sent credentials that the agent rejected (or\n    // sent none when it needed them). The raw transport error is shaped like\n    // `Error POSTing to endpoint (HTTP 401): unauthorized`, which omits the\n    // crucial piece of debug data: *which auth scheme did the SDK actually\n    // use*. Without that, a caller can't diff against curl. Wrap the error\n    // with a scheme tag and a remediation hint, preserving the original\n    // under `.cause` so existing `is401Error` / `error.status` checks\n    // downstream still resolve.\n    if (is401Error(error)) {\n      const scheme = authProvider\n        ? 'oauth'\n        : authToken\n          ? 'bearer'\n          : Object.keys(authHeaders).length > 0\n            ? 'header'\n            : 'none';\n      const hint =\n        scheme === 'none'\n          ? 'No credentials were sent. Configure auth_token, headers, or oauth_tokens on the agent config (or pass --auth on the CLI).'\n          : scheme === 'header'\n            ? \"Verify the Authorization header value matches the gateway (basic-auth: 'Basic ' + base64(user:pass); pair with --auth-scheme basic on the CLI).\"\n            : scheme === 'bearer'\n              ? \"Verify the bearer token matches the agent's expected credential.\"\n              : 'OAuth provider returned tokens that the agent rejected — check the provider configuration and token scopes.';\n      const detail = `MCP connect rejected with HTTP 401 from ${agentUrl}. SDK sent auth scheme: ${scheme}. ${hint}`;\n      const wrapped = Object.assign(new Error(detail), {\n        cause: error,\n        code: 'MCP_AUTH_REJECTED',\n        scheme,\n        agentUrl,\n        originalError: error,\n      });\n      throw wrapped;\n    }\n\n    throw error;\n  }\n}\n\n/**\n * Call an MCP tool with OAuth support.\n *\n * OAuth connections are cached by agent URL and OAuth provider identity so a\n * service-to-service workflow can reuse the initialized MCP session across\n * related tool calls. Reuse the same OAuthClientProvider instance for a\n * session/source/principal; the provider owns token refresh state for the\n * cached transport.\n *\n * Supplying `fetchFn` opts out of connection reuse. Scoped fetchers commonly\n * carry request- or tenant-specific network policy, so each call gets an\n * isolated connection that is closed after the tool response.\n *\n * Signing: this path consumes `options.signingContext` via the transport —\n * `connectMCP` attaches a signing-fetch wrapper at transport-creation time —\n * rather than via `signingContextStorage`. The OAuth cache key includes the\n * signing cache key so different signing identities do not share a transport.\n * The non-OAuth fallback (`callMCPTool`) does enter ALS.\n *\n * @param options Call options\n * @returns Tool response\n * @throws UnauthorizedError if OAuth is required (with transport attached)\n */\nexport async function callMCPToolWithOAuth(options: MCPCallOptions): Promise<unknown> {\n  const {\n    agentUrl,\n    toolName,\n    args,\n    authToken,\n    authProvider,\n    debugLogs = [],\n    customHeaders,\n    signingContext,\n    signal,\n    requestTimeoutMs,\n    fetchFn,\n  } = options;\n  const resolvedRequestTimeoutMs = resolveClientRequestTimeoutMs(requestTimeoutMs);\n  const requestOptions = {\n    ...(signal && { signal }),\n    ...(resolvedRequestTimeoutMs !== undefined && { timeout: resolvedRequestTimeoutMs }),\n  };\n\n  // If no OAuth provider, use the legacy function\n  if (!authProvider) {\n    return callMCPTool(agentUrl, toolName, args, authToken, debugLogs, customHeaders, signingContext, fetchFn, {\n      signal,\n      requestTimeoutMs,\n    });\n  }\n\n  const modernAttempt = await tryCallModernMCPTool(agentUrl, toolName, args, undefined, debugLogs, customHeaders, {\n    authProvider,\n    signingContext,\n    signal,\n    requestTimeoutMs,\n    fetchFn,\n    handleLegacy: true,\n  });\n  if (modernAttempt.handled) {\n    debugLogs.push({\n      type: modernAttempt.response?.isError ? 'error' : 'success',\n      message: `MCP: Tool ${toolName} response received`,\n      timestamp: new Date().toISOString(),\n    });\n    return modernAttempt.response;\n  }\n\n  const response = await withCachedOAuthConnection(\n    {\n      agentUrl,\n      authProvider,\n      debugLogs,\n      customHeaders,\n      signingContext,\n      signal,\n      requestTimeoutMs,\n      fetchFn,\n    },\n    toolName,\n    async client => {\n      debugLogs.push({\n        type: 'info',\n        message: `MCP: Calling tool ${toolName}`,\n        timestamp: new Date().toISOString(),\n      });\n\n      const response = await client.callTool({ name: toolName, arguments: args }, undefined, requestOptions);\n\n      debugLogs.push({\n        type: response?.isError ? 'error' : 'success',\n        message: `MCP: Tool ${toolName} response received`,\n        timestamp: new Date().toISOString(),\n      });\n\n      return response;\n    }\n  );\n\n  return response;\n}\n"],"mappings":"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","names":["require","signal","response"]}

package/dist/lib/registry/types.generated.d.mts

@@ -400,7 +400,7 @@ export interface paths {
         };
         /**
          * List agents
-         * @description List all agents in the registry. Optionally enrich with health checks, capabilities, and property summaries via query parameters. Measurement-vendor filters (`metric_id`, `accreditation`, `q`) imply `type=measurement` when `type` is unset; an explicit `type` other than `measurement` returns 400.
+         * @description List all agents in the registry. Optionally enrich with health checks, capabilities, and property summaries via query parameters. Measurement-vendor filters (`metric_id`, `accreditation`, `q`) imply `type=measurement`. Canonical creative-capability filters (`format_kind`, `publisher_domain`, `format_option_id`, `capability_id`, `creative_operation`) match any endpoint exposing that creative surface, including mixed sales/creative agents; add an explicit `type` only to narrow by primary registry classification.
          */
         get: operations["listAgents"];
         put?: never;
@@ -946,8 +946,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get agent formats
-         * @description Fetch creative formats from a creative agent.
+         * Get creative-agent format capabilities
+         * @description Fetch get_adcp_capabilities creative.supported_formats[] from a creative agent.
          */
         get: operations["getAgentFormats"];
         put?: never;
@@ -1109,7 +1109,7 @@ export interface paths {
         };
         /**
          * Registry change feed
-         * @description Poll a cursor-based feed of registry changes. Events are ordered by UUID v7 event_id for monotonic cursor progression. The feed retains events for 90 days. The `freshness` object reports when the response was generated, the newest matching event currently visible to the feed, and the resulting feed lag.
+         * @description Poll a cursor-based feed of registry changes. Events are ordered by UUID v7 event_id for monotonic cursor progression. The feed retains events for 90 days. The `freshness` object reports when the response was generated, the newest matching event currently visible to the feed, and the resulting feed lag. `publisher.adagents_changed` covers semantic changes in every top-level catalog field, including formats-only and placements-only revisions; new 3.2 events identify them in `payload.changed_fields`.
          *
          *     Type filtering supports glob patterns: `property.*` matches `property.created`, `property.updated`, etc.
          */
@@ -2418,10 +2418,27 @@ export interface components {
                 can_list_properties: boolean;
             };
             creative_capabilities?: {
-                formats_supported: string[];
+                supported_formats: ({
+                    capability_id?: string;
+                    format: {
+                        format_kind: string;
+                        publisher_domain?: string;
+                        format_option_id?: string;
+                        params?: {
+                            [key: string]: unknown;
+                        };
+                    } & {
+                        [key: string]: unknown;
+                    };
+                    operations: ("build" | "validate" | "preview")[];
+                } & {
+                    [key: string]: unknown;
+                })[];
                 can_generate: boolean;
                 can_validate: boolean;
                 can_preview: boolean;
+            } & {
+                [key: string]: unknown;
             };
             signals_capabilities?: {
                 audience_types: string[];
@@ -2666,7 +2683,7 @@ export interface components {
                 /** @description Industry labels from brand.json when present. */
                 industries?: string[];
             };
-            /** @description Display-oriented summary of top-level adagents.json `formats[]`, normalized for publisher pages and agent discovery clients. Each entry preserves `format_kind`, `format_option_id`, and canonical params. */
+            /** @description Lossy display-oriented summary of top-level adagents.json `formats[]`, normalized for publisher pages and eligibility discovery. It preserves `format_kind`, `format_option_id`, params, property scope, preference, and experimental status, but omits `v1_format_ref`, `canonical_formats_only`, `applies_to_channels`, `publisher_domain`, and custom `format_shape`/`format_schema`. Fetch the canonical document at hosting.resolved_url (or hosting.expected_url when self-hosted) for creative validation. */
             formats?: {
                 /** @description Stable format option identifier from adagents.json `formats[]`. */
                 format_option_id?: string;
@@ -2689,6 +2706,32 @@ export interface components {
                 /** @description Whether this seller's format declaration is marked experimental. */
                 experimental?: boolean;
             }[];
+            /** @description Eligibility-oriented publisher placement summaries. Present only when the request includes `include=placements`; format references are resolved to canonical kind/params so callers can join property → placement → format without a second origin fetch. */
+            placements?: {
+                placement_id: string;
+                name: string;
+                description?: string;
+                property_ids?: string[];
+                property_tags?: string[];
+                collection_ids?: string[];
+                channels?: string[];
+                tags?: string[];
+                /** @description Placement format references resolved against the same response's top-level formats plus any inline canonical declarations. */
+                format_options?: {
+                    format_option_id?: string;
+                    /** @description Resolved canonical format kind accepted by this placement. */
+                    format_kind: string;
+                    /** @description Resolved canonical narrowing for this placement format. */
+                    params?: {
+                        [key: string]: unknown;
+                    };
+                }[];
+                /**
+                 * @description Publisher-origin placements are adagents_json; moderator-maintained catalog placements are community.
+                 * @enum {string}
+                 */
+                source: "adagents_json" | "community";
+            }[];
             authorized_agents: {
                 url: string;
                 authorized_for?: string;
@@ -3578,7 +3621,9 @@ export interface components {
             category_taxonomy?: string | null;
             tags?: string[];
             delivery_types?: string[];
+            /** @description Deprecated 3.x named-format profile projection. */
             format_ids?: string[];
+            format_kinds?: string[];
             property_count?: number;
             publisher_count?: number;
             has_tmp?: boolean;
@@ -3741,6 +3786,12 @@ export interface components {
             agent_count?: number;
             property_count?: number;
             collection_count?: number;
+            /** @description Number of top-level formats[] declarations after the revision. */
+            format_count?: number;
+            /** @description Number of top-level placements[] declarations after the revision. */
+            placement_count?: number;
+            /** @description Semantic top-level adagents.json fields changed by this revision, including formats or placements. Present on newly emitted 3.2 change events. */
+            changed_fields?: string[];
             discovery_method?: string;
             manager_domain?: string | null;
             source?: string;
@@ -5314,6 +5365,16 @@ export interface operations {
                 accreditation?: string | string[];
                 /** @description Measurement-vendor filter: case-insensitive substring match against `measurement.metrics[].metric_id`. v1 scope: metric_id only (description/standard search is a follow-up). Max 64 chars; SQL wildcard characters are escaped. Implies `type=measurement`. */
                 q?: string;
+                /** @description Canonical creative-capability filter: exact match on creative.supported_formats[].format.format_kind. Repeatable with OR semantics. Matches standalone creative agents and mixed-role endpoints. */
+                format_kind?: string | string[];
+                /** @description Canonical creative-capability filter: exact publisher_domain on the same supported-format entry. Pair with format_option_id to find endpoints claiming an exact publisher format. */
+                publisher_domain?: string;
+                /** @description Canonical creative-capability filter: exact publisher format_option_id on the same supported-format entry. */
+                format_option_id?: string;
+                /** @description Canonical creative-capability filter: exact endpoint-local creative.supported_formats[].capability_id. */
+                capability_id?: string;
+                /** @description Canonical creative-capability filter: required supported operation on the same format entry. Repeatable with OR semantics. */
+                creative_operation?: ("build" | "validate" | "preview") | ("build" | "validate" | "preview")[];
                 /** @description Filter to agents whose active badge covers the given verification axis. Repeat the parameter for AND semantics: ?verification_mode=spec&verification_mode=live returns only agents verified on both axes. */
                 verification_mode?: ("spec" | "live")[];
                 /** @description When true, filter to agents that hold any active verification badge. */
@@ -5682,6 +5743,8 @@ export interface operations {
         parameters: {
             query: {
                 domain: string;
+                /** @description Set to placements to include eligibility-oriented placement summaries with resolved canonical format options. */
+                include?: "placements";
             };
             header?: never;
             path?: never;
@@ -6759,7 +6822,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Creative formats */
+            /** @description Canonical creative capabilities */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -7457,8 +7520,8 @@ export interface operations {
                             categories: string[];
                             tags: string[];
                             delivery_types: string[];
-                            /** @description Creative format identifiers supported by this agent */
-                            format_ids: unknown[];
+                            /** @description Canonical format kinds present in this agent's indexed inventory profile */
+                            format_kinds: string[];
                             property_count: number;
                             publisher_count: number;
                             has_tmp: boolean;