@adcp/sdk 12.0.6 → 12.1.1

package/dist/lib/protocols/mcp-tasks.js

@@ -128,7 +128,8 @@ async function callMCPToolWithTasks(agentUrl, toolName, args, authToken, debugLo
   const modernAttempt = await (0, import_mcp_modern.tryCallModernMCPTool)(agentUrl, toolName, args, authToken, debugLogs, customHeaders, {
     ...options?.signingContext && { signingContext: options.signingContext },
     ...options?.signal && { signal: options.signal },
-    ...options?.requestTimeoutMs !== void 0 && { requestTimeoutMs: options.requestTimeoutMs }
+    ...options?.requestTimeoutMs !== void 0 && { requestTimeoutMs: options.requestTimeoutMs },
+    ...options?.fetchFn && { fetchFn: options.fetchFn }
   });
   if (modernAttempt.handled) {
     debugLogs.push({
@@ -163,7 +164,7 @@ async function callMCPToolWithTasks(agentUrl, toolName, args, authToken, debugLo
           options?.signal,
           options?.requestTimeoutMs
         ),
-        void 0,
+        options?.fetchFn,
         { signal: options?.signal, requestTimeoutMs: options?.requestTimeoutMs }
       );
     })
@@ -369,15 +370,24 @@ async function listMCPTasks(agentUrl, authToken, debugLogs = [], options = {}) {
         ...options.transportActivityContext,
         onTransportActivity: options.onTransportActivity
       },
-      () => (0, import_mcp.withCachedConnection)(agentUrl, authToken, authHeaders, debugLogs, "tasks/list", async (client) => {
-        const result = await client.experimental.tasks.listTasks();
-        debugLogs.push({
-          type: "info",
-          message: `MCP Tasks: listTasks returned ${result.tasks.length} tasks`,
-          timestamp: (/* @__PURE__ */ new Date()).toISOString()
-        });
-        return result.tasks.map((task) => mapMCPTaskToTaskInfo(task));
-      })
+      () => (0, import_mcp.withCachedConnection)(
+        agentUrl,
+        authToken,
+        authHeaders,
+        debugLogs,
+        "tasks/list",
+        async (client) => {
+          const result = await client.experimental.tasks.listTasks();
+          debugLogs.push({
+            type: "info",
+            message: `MCP Tasks: listTasks returned ${result.tasks.length} tasks`,
+            timestamp: (/* @__PURE__ */ new Date()).toISOString()
+          });
+          return result.tasks.map((task) => mapMCPTaskToTaskInfo(task));
+        },
+        options.transport?.fetchFn,
+        { requestTimeoutMs: options.transport?.requestTimeoutMs }
+      )
     )
   );
 }

package/dist/lib/protocols/mcp-tasks.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/protocols/mcp-tasks.ts"],"sourcesContent":["/**\n * MCP Tasks protocol integration for async tool calls.\n *\n * When an MCP server declares `capabilities.tasks.requests.tools.call`, this module\n * uses the SDK's experimental tasks API instead of custom AdCP tool calls for async\n * lifecycle management. This removes the LLM from the polling path.\n *\n * Detection: check `client.getServerCapabilities()?.tasks?.requests?.tools?.call`\n * after connection. The SDK's `isToolTask()` auto-detects per-tool `taskSupport`.\n */\n\nimport type { Client as MCPClient } from '@modelcontextprotocol/sdk/client/index.js';\nimport type { DebugLogEntry } from '../types/adcp';\nimport type { TaskInfo } from '../core/ConversationTypes';\nimport { withCachedConnection } from './mcp';\nimport { createMCPAuthHeaders } from '../auth';\nimport { withSpan, injectTraceHeaders } from '../observability/tracing';\nimport { signingContextStorage, type AgentSigningContext } from '../signing/client';\nimport { redactIdempotencyKeyInArgs } from '../utils/idempotency';\nimport { withResponseSizeLimit } from './responseSizeLimit';\nimport { withTransportDiagnostics, type TransportActivityHandler } from './transportDiagnostics';\nimport { isAbortOrTimeoutError, resolveClientRequestTimeoutMs } from './abort';\nimport { tryCallModernMCPTool } from './mcp-modern';\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\ninterface MCPTaskProtocolOptions {\n  transport?: { maxResponseBytes?: number };\n  onTransportActivity?: TransportActivityHandler;\n  transportActivityContext?: {\n    agentId: string;\n    operationId?: string;\n    taskId?: string;\n    contextId?: string;\n    idempotencyKey?: string;\n  };\n}\n\n/**\n * Track which MCP clients have had listTools() called.\n * The SDK's isToolTask() needs tool metadata from listTools() to determine\n * per-tool taskSupport. Without this, callToolStream silently degrades to\n * a synchronous tools/call (no task creation).\n */\nconst toolsListedClients = new WeakSet<MCPClient>();\n\n/**\n * Ensure tool metadata is cached in the SDK so isToolTask() works.\n * Called once per client connection when tasks are supported.\n */\nasync function ensureToolsListed(client: MCPClient, signal?: AbortSignal, requestTimeoutMs?: number): Promise<void> {\n  if (toolsListedClients.has(client)) return;\n  await client.listTools(undefined, {\n    ...(signal && { signal }),\n    ...(requestTimeoutMs !== undefined && { timeout: requestTimeoutMs }),\n  });\n  toolsListedClients.add(client);\n}\n\n/**\n * Check if an MCP server supports the Tasks protocol for tool calls.\n */\nexport function serverSupportsTasks(client: MCPClient): boolean {\n  const caps = client.getServerCapabilities();\n  return !!(caps as Record<string, any>)?.tasks?.requests?.tools?.call;\n}\n\n/**\n * Map MCP Tasks status to AdCP status.\n *\n * MCP Tasks uses underscores and British spelling; AdCP uses hyphens and American spelling.\n */\nexport function mapMCPTaskStatus(mcpStatus: string): string {\n  switch (mcpStatus) {\n    case 'working':\n      return 'working';\n    case 'input_required':\n      return 'input-required';\n    case 'completed':\n      return 'completed';\n    case 'failed':\n      return 'failed';\n    case 'cancelled':\n      return 'canceled';\n    default:\n      return mcpStatus;\n  }\n}\n\n/**\n * Map an MCP Task object to an AdCP TaskInfo.\n */\nfunction mapMCPTaskToTaskInfo(\n  task: {\n    taskId: string;\n    status: string;\n    createdAt: string;\n    lastUpdatedAt: string;\n    statusMessage?: string;\n    pollInterval?: number;\n  },\n  toolName?: string\n): TaskInfo {\n  // Project `statusMessage → TaskInfo.error` against the\n  // POST-MAPPING AdCP status (not the raw MCP-side status). MCP\n  // Tasks emits `'cancelled'` (British) and never `'rejected'` as a\n  // standard status; checking against the AdCP set after mapping\n  // catches all terminal failures uniformly. Sellers that extend\n  // MCP with custom statuses (e.g. emit `'rejected'` via spec\n  // extension) flow through unchanged via the `default` arm of\n  // {@link mapMCPTaskStatus}.\n  const adcpStatus = mapMCPTaskStatus(task.status);\n  const isTerminalFailure = adcpStatus === 'failed' || adcpStatus === 'rejected' || adcpStatus === 'canceled';\n  return {\n    taskId: task.taskId,\n    status: adcpStatus,\n    taskType: toolName ?? 'unknown',\n    createdAt: new Date(task.createdAt).getTime(),\n    updatedAt: new Date(task.lastUpdatedAt).getTime(),\n    error: isTerminalFailure ? task.statusMessage : undefined,\n  };\n}\n\n/**\n * Build auth headers for MCP connections.\n */\nfunction buildAuthHeaders(authToken?: string, customHeaders?: Record<string, string>): Record<string, string> {\n  const traceHeaders = injectTraceHeaders();\n  return {\n    ...customHeaders,\n    ...traceHeaders,\n    ...(authToken ? createMCPAuthHeaders(authToken) : {}),\n  };\n}\n\n/**\n * Redact sensitive fields from tool args before logging.\n *\n * Redacts:\n * - `push_notification_config.authentication` — webhook signing secret\n * - `idempotency_key` — retry-pattern oracle within the seller's TTL; opt-in\n *   full logging via `ADCP_LOG_IDEMPOTENCY_KEYS=1`\n */\nfunction redactArgsForLog(args: Record<string, unknown>): Record<string, unknown> {\n  let redacted: Record<string, unknown> = args;\n  if (redacted.push_notification_config) {\n    redacted = {\n      ...redacted,\n      push_notification_config: {\n        ...(redacted.push_notification_config as object),\n        authentication: '***',\n      },\n    };\n  }\n  return redactIdempotencyKeyInArgs(redacted);\n}\n\n/**\n * Validate taskId before passing to protocol methods.\n */\nfunction validateTaskId(taskId: string): void {\n  if (!taskId || typeof taskId !== 'string' || taskId.length > 256) {\n    throw new Error(`Invalid taskId: expected non-empty string (max 256 chars)`);\n  }\n}\n\n/**\n * Call an MCP tool with Tasks protocol support.\n *\n * If the server supports MCP Tasks and the tool has `taskSupport: 'optional' | 'required'`,\n * uses `callToolStream()` which handles task creation, polling, and result retrieval.\n *\n * If the server doesn't support tasks, falls back to regular `client.callTool()`.\n *\n * The stream is consumed with a timeout. If the task doesn't complete within the timeout,\n * returns a working-status response with the MCP task_id for follow-up polling.\n */\nexport async function callMCPToolWithTasks(\n  agentUrl: string,\n  toolName: string,\n  args: Record<string, unknown>,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  customHeaders?: Record<string, string>,\n  options?: {\n    workingTimeout?: number;\n    signingContext?: AgentSigningContext;\n    signal?: AbortSignal;\n    requestTimeoutMs?: number;\n  }\n): Promise<unknown> {\n  // Keep the public debug-log contract identical across modern and legacy\n  // protocol eras. Era negotiation happens after these common entries; the\n  // selected transport appends its own connection diagnostics.\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\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\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  const modernAttempt = await tryCallModernMCPTool(agentUrl, toolName, args, authToken, debugLogs, customHeaders, {\n    ...(options?.signingContext && { signingContext: options.signingContext }),\n    ...(options?.signal && { signal: options.signal }),\n    ...(options?.requestTimeoutMs !== undefined && { requestTimeoutMs: options.requestTimeoutMs }),\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  return withSpan(\n    'adcp.mcp.call_tool',\n    {\n      'adcp.tool': toolName,\n      'http.url': agentUrl,\n    },\n    async () =>\n      signingContextStorage.run(options?.signingContext, async () => {\n        const authHeaders = buildAuthHeaders(authToken, customHeaders);\n        const workingTimeout = options?.workingTimeout ?? 120_000;\n\n        return withCachedConnection(\n          agentUrl,\n          authToken,\n          authHeaders,\n          debugLogs,\n          toolName,\n          client =>\n            callToolOnClient(\n              client,\n              toolName,\n              args,\n              debugLogs,\n              workingTimeout,\n              options?.signal,\n              options?.requestTimeoutMs\n            ),\n          undefined,\n          { signal: options?.signal, requestTimeoutMs: options?.requestTimeoutMs }\n        );\n      })\n  );\n}\n\n/**\n * Call a tool on a pre-connected MCP `Client` without HTTP transport or connection caching.\n *\n * This is the in-process companion to `callMCPToolWithTasks`. It skips URL validation,\n * connection setup, OAuth refresh, and the reconnect-retry path — the caller owns the\n * client lifecycle. All other semantics (tasks protocol detection, stream handling,\n * timeout surfacing) are identical to the URL-based path.\n *\n * Use via `AgentClient.fromMCPClient()`. Not intended for direct import outside the\n * protocols directory.\n */\nexport async function callMCPToolWithClient(\n  mcpClient: MCPClient,\n  toolName: string,\n  args: Record<string, unknown>,\n  debugLogs: DebugLogEntry[] = [],\n  options?: { workingTimeout?: number; signal?: AbortSignal; requestTimeoutMs?: number }\n): Promise<unknown> {\n  debugLogs.push({\n    type: 'info',\n    message: `MCP: Calling tool ${toolName} (in-process) with args: ${JSON.stringify(redactArgsForLog(args))}`,\n    timestamp: new Date().toISOString(),\n  });\n  return callToolOnClient(\n    mcpClient,\n    toolName,\n    args,\n    debugLogs,\n    options?.workingTimeout ?? 120_000,\n    options?.signal,\n    options?.requestTimeoutMs\n  );\n}\n\n/**\n * Inner dispatch logic shared by `callMCPToolWithTasks` (URL path) and\n * `callMCPToolWithClient` (in-process path). Both paths converge here once\n * a connected `MCPClient` is in hand.\n */\nasync function callToolOnClient(\n  client: MCPClient,\n  toolName: string,\n  args: Record<string, unknown>,\n  debugLogs: DebugLogEntry[],\n  workingTimeout: number,\n  signal?: AbortSignal,\n  requestTimeoutMs?: number\n): Promise<unknown> {\n  const resolvedRequestTimeoutMs = resolveClientRequestTimeoutMs(requestTimeoutMs);\n  const requestOptions = {\n    ...(signal && { signal }),\n    ...(resolvedRequestTimeoutMs !== undefined && { timeout: resolvedRequestTimeoutMs }),\n  };\n  if (!serverSupportsTasks(client)) {\n    debugLogs.push({\n      type: 'info',\n      message: `MCP Tasks: Server does not support tasks, using standard callTool for ${toolName}`,\n      timestamp: new Date().toISOString(),\n    });\n    const response = (await client.callTool(\n      { name: toolName, arguments: args },\n      undefined,\n      requestOptions\n    )) as CallToolResponse;\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  // Ensure tool metadata is cached so the SDK's isToolTask() works correctly.\n  // Without this, callToolStream silently skips task creation for tools that\n  // declare taskSupport: 'optional' | 'required'.\n  await ensureToolsListed(client, signal, resolvedRequestTimeoutMs);\n\n  debugLogs.push({\n    type: 'info',\n    message: `MCP Tasks: Server supports tasks, using callToolStream for ${toolName}`,\n    timestamp: new Date().toISOString(),\n  });\n\n  // Use callToolStream which handles the full task lifecycle\n  const stream = client.experimental.tasks.callToolStream({ name: toolName, arguments: args }, undefined, {\n    timeout: resolvedRequestTimeoutMs ?? workingTimeout,\n    resetTimeoutOnProgress: true,\n    ...(signal && { signal }),\n  });\n\n  let capturedTaskId: string | undefined;\n  let capturedTask: { taskId: string; status: string; pollInterval?: number } | undefined;\n\n  try {\n    for await (const message of stream) {\n      switch (message.type) {\n        case 'taskCreated':\n          capturedTaskId = message.task.taskId;\n          capturedTask = message.task;\n          debugLogs.push({\n            type: 'info',\n            message: `MCP Tasks: Task created ${capturedTaskId} for ${toolName}`,\n            timestamp: new Date().toISOString(),\n          });\n          break;\n\n        case 'taskStatus':\n          capturedTask = message.task;\n          debugLogs.push({\n            type: 'info',\n            message: `MCP Tasks: Status update for ${capturedTaskId}: ${message.task.status}`,\n            timestamp: new Date().toISOString(),\n          });\n          break;\n\n        case 'result': {\n          debugLogs.push({\n            type: 'success',\n            message: `MCP: Tool ${toolName} response received (success)`,\n            timestamp: new Date().toISOString(),\n            response: message.result,\n          });\n          return message.result as CallToolResponse;\n        }\n\n        case 'error': {\n          debugLogs.push({\n            type: 'error',\n            message: `MCP Tasks: Error for ${toolName}: ${message.error.message}`,\n            timestamp: new Date().toISOString(),\n          });\n          // The MCP Tasks SDK error event may strip structured content.\n          // If we have a taskId, fetch the full result to recover adcp_error data\n          // and return it as a proper isError response for downstream unwrapping.\n          if (capturedTaskId) {\n            try {\n              const taskResult = await client.experimental.tasks.getTaskResult(\n                capturedTaskId,\n                undefined,\n                requestOptions\n              );\n              const content = taskResult?.content as Array<{ type: string; text?: string }> | undefined;\n              if (content) {\n                return {\n                  isError: true,\n                  content,\n                  structuredContent: taskResult?.structuredContent,\n                } as unknown as CallToolResponse;\n              }\n            } catch {\n              // Failed to fetch task result — fall through to throw\n            }\n          }\n          throw message.error;\n        }\n      }\n    }\n  } catch (error) {\n    if (signal?.aborted && isAbortOrTimeoutError(error)) {\n      throw error;\n    }\n    // If we timed out but have a taskId, return a working status\n    // so the caller can poll via getMCPTaskStatus/getMCPTaskResult\n    if (capturedTaskId && error instanceof Error && /timeout|timed out/i.test(error.message)) {\n      debugLogs.push({\n        type: 'info',\n        message: `MCP Tasks: Timeout for ${toolName}, returning working status with taskId ${capturedTaskId}`,\n        timestamp: new Date().toISOString(),\n      });\n\n      return {\n        structuredContent: {\n          status: 'working',\n          task_id: capturedTaskId,\n          poll_interval: capturedTask?.pollInterval,\n        },\n      };\n    }\n    if (isAbortOrTimeoutError(error)) {\n      throw error;\n    }\n    // Servers may return a synchronous tool error (e.g. VERSION_UNSUPPORTED)\n    // rather than creating a task. The Tasks SDK rejects these with a Zod\n    // validation error about a missing `task` field. When no task was\n    // captured, fall back to standard callTool so the error response\n    // reaches the caller intact.\n    const msg = error instanceof Error ? error.message : String(error);\n    if (!capturedTaskId && /Invalid task creation result/i.test(msg)) {\n      debugLogs.push({\n        type: 'info',\n        message: `MCP Tasks: Server returned synchronous response for ${toolName}, falling back to callTool`,\n        timestamp: new Date().toISOString(),\n      });\n      return (await client.callTool(\n        { name: toolName, arguments: args },\n        undefined,\n        requestOptions\n      )) as CallToolResponse;\n    }\n    throw error;\n  }\n\n  // Stream ended without result — shouldn't happen with well-behaved servers\n  if (capturedTaskId) {\n    return {\n      structuredContent: {\n        status: 'working',\n        task_id: capturedTaskId,\n        poll_interval: capturedTask?.pollInterval,\n      },\n    };\n  }\n\n  throw new Error(`MCP Tasks: callToolStream for ${toolName} ended without result or task`);\n}\n\n/**\n * Get task status via MCP Tasks protocol method (not tool call).\n *\n * Task lifecycle methods (`tasks/get`, `tasks/result`, `tasks/list`,\n * `tasks/cancel`) are MCP protocol methods, not AdCP operations.\n * `extractAdcpOperation` returns `undefined` for them, so the signing fetch\n * passes them through unsigned regardless of whether an `AgentSigningContext`\n * is present in ALS. That matches the RFC 9421 signing profile, which only\n * covers AdCP tool calls (`tools/call` / `message/send`).\n *\n * Re-throws auth errors (401) — only catches protocol capability errors.\n */\nexport async function getMCPTaskStatus(\n  agentUrl: string,\n  taskId: string,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  toolName?: string\n): Promise<TaskInfo> {\n  validateTaskId(taskId);\n  const authHeaders = buildAuthHeaders(authToken);\n\n  return withCachedConnection(agentUrl, authToken, authHeaders, debugLogs, `tasks/get:${taskId}`, async client => {\n    const result = await client.experimental.tasks.getTask(taskId);\n    debugLogs.push({\n      type: 'info',\n      message: `MCP Tasks: getTask ${taskId} → ${result.status}`,\n      timestamp: new Date().toISOString(),\n    });\n    return mapMCPTaskToTaskInfo(\n      result as {\n        taskId: string;\n        status: string;\n        createdAt: string;\n        lastUpdatedAt: string;\n        statusMessage?: string;\n        pollInterval?: number;\n      },\n      toolName\n    );\n  });\n}\n\n/**\n * Get task result via MCP Tasks protocol method (blocks until terminal).\n */\nexport async function getMCPTaskResult(\n  agentUrl: string,\n  taskId: string,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = []\n): Promise<unknown> {\n  validateTaskId(taskId);\n  const authHeaders = buildAuthHeaders(authToken);\n\n  return withCachedConnection(agentUrl, authToken, authHeaders, debugLogs, `tasks/result:${taskId}`, async client => {\n    const result = await client.experimental.tasks.getTaskResult(taskId);\n    debugLogs.push({\n      type: 'success',\n      message: `MCP Tasks: getTaskResult ${taskId} received`,\n      timestamp: new Date().toISOString(),\n    });\n    return result;\n  });\n}\n\n/**\n * List tasks via MCP Tasks protocol method.\n */\nexport async function listMCPTasks(\n  agentUrl: string,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  options: MCPTaskProtocolOptions = {}\n): Promise<TaskInfo[]> {\n  const authHeaders = buildAuthHeaders(authToken);\n\n  return withResponseSizeLimit(options.transport?.maxResponseBytes, () =>\n    withTransportDiagnostics(\n      {\n        agentId: options.transportActivityContext?.agentId ?? 'unknown-agent',\n        protocol: 'mcp',\n        tool: 'tasks/list',\n        taskType: 'tasks/list',\n        ...options.transportActivityContext,\n        onTransportActivity: options.onTransportActivity,\n      },\n      () =>\n        withCachedConnection(agentUrl, authToken, authHeaders, debugLogs, 'tasks/list', async client => {\n          const result = await client.experimental.tasks.listTasks();\n          debugLogs.push({\n            type: 'info',\n            message: `MCP Tasks: listTasks returned ${result.tasks.length} tasks`,\n            timestamp: new Date().toISOString(),\n          });\n          return result.tasks.map((task: any) => mapMCPTaskToTaskInfo(task));\n        })\n    )\n  );\n}\n\n/**\n * Cancel a task via MCP Tasks protocol method.\n */\nexport async function cancelMCPTask(\n  agentUrl: string,\n  taskId: string,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = []\n): Promise<void> {\n  validateTaskId(taskId);\n  const authHeaders = buildAuthHeaders(authToken);\n\n  await withCachedConnection(agentUrl, authToken, authHeaders, debugLogs, `tasks/cancel:${taskId}`, async client => {\n    await client.experimental.tasks.cancelTask(taskId);\n    debugLogs.push({\n      type: 'info',\n      message: `MCP Tasks: cancelTask ${taskId} succeeded`,\n      timestamp: new Date().toISOString(),\n    });\n  });\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/lib/protocols/mcp-tasks.ts"],"sourcesContent":["/**\n * MCP Tasks protocol integration for async tool calls.\n *\n * When an MCP server declares `capabilities.tasks.requests.tools.call`, this module\n * uses the SDK's experimental tasks API instead of custom AdCP tool calls for async\n * lifecycle management. This removes the LLM from the polling path.\n *\n * Detection: check `client.getServerCapabilities()?.tasks?.requests?.tools?.call`\n * after connection. The SDK's `isToolTask()` auto-detects per-tool `taskSupport`.\n */\n\nimport type { Client as MCPClient } from '@modelcontextprotocol/sdk/client/index.js';\nimport type { DebugLogEntry } from '../types/adcp';\nimport type { TaskInfo } from '../core/ConversationTypes';\nimport { withCachedConnection } from './mcp';\nimport { createMCPAuthHeaders } from '../auth';\nimport { withSpan, injectTraceHeaders } from '../observability/tracing';\nimport { signingContextStorage, type AgentSigningContext } from '../signing/client';\nimport { redactIdempotencyKeyInArgs } from '../utils/idempotency';\nimport { withResponseSizeLimit } from './responseSizeLimit';\nimport { withTransportDiagnostics, type TransportActivityHandler } from './transportDiagnostics';\nimport { isAbortOrTimeoutError, resolveClientRequestTimeoutMs } from './abort';\nimport { tryCallModernMCPTool } from './mcp-modern';\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\ninterface MCPTaskProtocolOptions {\n  transport?: { maxResponseBytes?: number; fetchFn?: typeof fetch; requestTimeoutMs?: number };\n  onTransportActivity?: TransportActivityHandler;\n  transportActivityContext?: {\n    agentId: string;\n    operationId?: string;\n    taskId?: string;\n    contextId?: string;\n    idempotencyKey?: string;\n  };\n}\n\n/**\n * Track which MCP clients have had listTools() called.\n * The SDK's isToolTask() needs tool metadata from listTools() to determine\n * per-tool taskSupport. Without this, callToolStream silently degrades to\n * a synchronous tools/call (no task creation).\n */\nconst toolsListedClients = new WeakSet<MCPClient>();\n\n/**\n * Ensure tool metadata is cached in the SDK so isToolTask() works.\n * Called once per client connection when tasks are supported.\n */\nasync function ensureToolsListed(client: MCPClient, signal?: AbortSignal, requestTimeoutMs?: number): Promise<void> {\n  if (toolsListedClients.has(client)) return;\n  await client.listTools(undefined, {\n    ...(signal && { signal }),\n    ...(requestTimeoutMs !== undefined && { timeout: requestTimeoutMs }),\n  });\n  toolsListedClients.add(client);\n}\n\n/**\n * Check if an MCP server supports the Tasks protocol for tool calls.\n */\nexport function serverSupportsTasks(client: MCPClient): boolean {\n  const caps = client.getServerCapabilities();\n  return !!(caps as Record<string, any>)?.tasks?.requests?.tools?.call;\n}\n\n/**\n * Map MCP Tasks status to AdCP status.\n *\n * MCP Tasks uses underscores and British spelling; AdCP uses hyphens and American spelling.\n */\nexport function mapMCPTaskStatus(mcpStatus: string): string {\n  switch (mcpStatus) {\n    case 'working':\n      return 'working';\n    case 'input_required':\n      return 'input-required';\n    case 'completed':\n      return 'completed';\n    case 'failed':\n      return 'failed';\n    case 'cancelled':\n      return 'canceled';\n    default:\n      return mcpStatus;\n  }\n}\n\n/**\n * Map an MCP Task object to an AdCP TaskInfo.\n */\nfunction mapMCPTaskToTaskInfo(\n  task: {\n    taskId: string;\n    status: string;\n    createdAt: string;\n    lastUpdatedAt: string;\n    statusMessage?: string;\n    pollInterval?: number;\n  },\n  toolName?: string\n): TaskInfo {\n  // Project `statusMessage → TaskInfo.error` against the\n  // POST-MAPPING AdCP status (not the raw MCP-side status). MCP\n  // Tasks emits `'cancelled'` (British) and never `'rejected'` as a\n  // standard status; checking against the AdCP set after mapping\n  // catches all terminal failures uniformly. Sellers that extend\n  // MCP with custom statuses (e.g. emit `'rejected'` via spec\n  // extension) flow through unchanged via the `default` arm of\n  // {@link mapMCPTaskStatus}.\n  const adcpStatus = mapMCPTaskStatus(task.status);\n  const isTerminalFailure = adcpStatus === 'failed' || adcpStatus === 'rejected' || adcpStatus === 'canceled';\n  return {\n    taskId: task.taskId,\n    status: adcpStatus,\n    taskType: toolName ?? 'unknown',\n    createdAt: new Date(task.createdAt).getTime(),\n    updatedAt: new Date(task.lastUpdatedAt).getTime(),\n    error: isTerminalFailure ? task.statusMessage : undefined,\n  };\n}\n\n/**\n * Build auth headers for MCP connections.\n */\nfunction buildAuthHeaders(authToken?: string, customHeaders?: Record<string, string>): Record<string, string> {\n  const traceHeaders = injectTraceHeaders();\n  return {\n    ...customHeaders,\n    ...traceHeaders,\n    ...(authToken ? createMCPAuthHeaders(authToken) : {}),\n  };\n}\n\n/**\n * Redact sensitive fields from tool args before logging.\n *\n * Redacts:\n * - `push_notification_config.authentication` — webhook signing secret\n * - `idempotency_key` — retry-pattern oracle within the seller's TTL; opt-in\n *   full logging via `ADCP_LOG_IDEMPOTENCY_KEYS=1`\n */\nfunction redactArgsForLog(args: Record<string, unknown>): Record<string, unknown> {\n  let redacted: Record<string, unknown> = args;\n  if (redacted.push_notification_config) {\n    redacted = {\n      ...redacted,\n      push_notification_config: {\n        ...(redacted.push_notification_config as object),\n        authentication: '***',\n      },\n    };\n  }\n  return redactIdempotencyKeyInArgs(redacted);\n}\n\n/**\n * Validate taskId before passing to protocol methods.\n */\nfunction validateTaskId(taskId: string): void {\n  if (!taskId || typeof taskId !== 'string' || taskId.length > 256) {\n    throw new Error(`Invalid taskId: expected non-empty string (max 256 chars)`);\n  }\n}\n\n/**\n * Call an MCP tool with Tasks protocol support.\n *\n * If the server supports MCP Tasks and the tool has `taskSupport: 'optional' | 'required'`,\n * uses `callToolStream()` which handles task creation, polling, and result retrieval.\n *\n * If the server doesn't support tasks, falls back to regular `client.callTool()`.\n *\n * The stream is consumed with a timeout. If the task doesn't complete within the timeout,\n * returns a working-status response with the MCP task_id for follow-up polling.\n */\nexport async function callMCPToolWithTasks(\n  agentUrl: string,\n  toolName: string,\n  args: Record<string, unknown>,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  customHeaders?: Record<string, string>,\n  options?: {\n    workingTimeout?: number;\n    signingContext?: AgentSigningContext;\n    signal?: AbortSignal;\n    requestTimeoutMs?: number;\n    fetchFn?: typeof fetch;\n  }\n): Promise<unknown> {\n  // Keep the public debug-log contract identical across modern and legacy\n  // protocol eras. Era negotiation happens after these common entries; the\n  // selected transport appends its own connection diagnostics.\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\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\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  const modernAttempt = await tryCallModernMCPTool(agentUrl, toolName, args, authToken, debugLogs, customHeaders, {\n    ...(options?.signingContext && { signingContext: options.signingContext }),\n    ...(options?.signal && { signal: options.signal }),\n    ...(options?.requestTimeoutMs !== undefined && { requestTimeoutMs: options.requestTimeoutMs }),\n    ...(options?.fetchFn && { fetchFn: options.fetchFn }),\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  return withSpan(\n    'adcp.mcp.call_tool',\n    {\n      'adcp.tool': toolName,\n      'http.url': agentUrl,\n    },\n    async () =>\n      signingContextStorage.run(options?.signingContext, async () => {\n        const authHeaders = buildAuthHeaders(authToken, customHeaders);\n        const workingTimeout = options?.workingTimeout ?? 120_000;\n\n        return withCachedConnection(\n          agentUrl,\n          authToken,\n          authHeaders,\n          debugLogs,\n          toolName,\n          client =>\n            callToolOnClient(\n              client,\n              toolName,\n              args,\n              debugLogs,\n              workingTimeout,\n              options?.signal,\n              options?.requestTimeoutMs\n            ),\n          options?.fetchFn,\n          { signal: options?.signal, requestTimeoutMs: options?.requestTimeoutMs }\n        );\n      })\n  );\n}\n\n/**\n * Call a tool on a pre-connected MCP `Client` without HTTP transport or connection caching.\n *\n * This is the in-process companion to `callMCPToolWithTasks`. It skips URL validation,\n * connection setup, OAuth refresh, and the reconnect-retry path — the caller owns the\n * client lifecycle. All other semantics (tasks protocol detection, stream handling,\n * timeout surfacing) are identical to the URL-based path.\n *\n * Use via `AgentClient.fromMCPClient()`. Not intended for direct import outside the\n * protocols directory.\n */\nexport async function callMCPToolWithClient(\n  mcpClient: MCPClient,\n  toolName: string,\n  args: Record<string, unknown>,\n  debugLogs: DebugLogEntry[] = [],\n  options?: { workingTimeout?: number; signal?: AbortSignal; requestTimeoutMs?: number }\n): Promise<unknown> {\n  debugLogs.push({\n    type: 'info',\n    message: `MCP: Calling tool ${toolName} (in-process) with args: ${JSON.stringify(redactArgsForLog(args))}`,\n    timestamp: new Date().toISOString(),\n  });\n  return callToolOnClient(\n    mcpClient,\n    toolName,\n    args,\n    debugLogs,\n    options?.workingTimeout ?? 120_000,\n    options?.signal,\n    options?.requestTimeoutMs\n  );\n}\n\n/**\n * Inner dispatch logic shared by `callMCPToolWithTasks` (URL path) and\n * `callMCPToolWithClient` (in-process path). Both paths converge here once\n * a connected `MCPClient` is in hand.\n */\nasync function callToolOnClient(\n  client: MCPClient,\n  toolName: string,\n  args: Record<string, unknown>,\n  debugLogs: DebugLogEntry[],\n  workingTimeout: number,\n  signal?: AbortSignal,\n  requestTimeoutMs?: number\n): Promise<unknown> {\n  const resolvedRequestTimeoutMs = resolveClientRequestTimeoutMs(requestTimeoutMs);\n  const requestOptions = {\n    ...(signal && { signal }),\n    ...(resolvedRequestTimeoutMs !== undefined && { timeout: resolvedRequestTimeoutMs }),\n  };\n  if (!serverSupportsTasks(client)) {\n    debugLogs.push({\n      type: 'info',\n      message: `MCP Tasks: Server does not support tasks, using standard callTool for ${toolName}`,\n      timestamp: new Date().toISOString(),\n    });\n    const response = (await client.callTool(\n      { name: toolName, arguments: args },\n      undefined,\n      requestOptions\n    )) as CallToolResponse;\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  // Ensure tool metadata is cached so the SDK's isToolTask() works correctly.\n  // Without this, callToolStream silently skips task creation for tools that\n  // declare taskSupport: 'optional' | 'required'.\n  await ensureToolsListed(client, signal, resolvedRequestTimeoutMs);\n\n  debugLogs.push({\n    type: 'info',\n    message: `MCP Tasks: Server supports tasks, using callToolStream for ${toolName}`,\n    timestamp: new Date().toISOString(),\n  });\n\n  // Use callToolStream which handles the full task lifecycle\n  const stream = client.experimental.tasks.callToolStream({ name: toolName, arguments: args }, undefined, {\n    timeout: resolvedRequestTimeoutMs ?? workingTimeout,\n    resetTimeoutOnProgress: true,\n    ...(signal && { signal }),\n  });\n\n  let capturedTaskId: string | undefined;\n  let capturedTask: { taskId: string; status: string; pollInterval?: number } | undefined;\n\n  try {\n    for await (const message of stream) {\n      switch (message.type) {\n        case 'taskCreated':\n          capturedTaskId = message.task.taskId;\n          capturedTask = message.task;\n          debugLogs.push({\n            type: 'info',\n            message: `MCP Tasks: Task created ${capturedTaskId} for ${toolName}`,\n            timestamp: new Date().toISOString(),\n          });\n          break;\n\n        case 'taskStatus':\n          capturedTask = message.task;\n          debugLogs.push({\n            type: 'info',\n            message: `MCP Tasks: Status update for ${capturedTaskId}: ${message.task.status}`,\n            timestamp: new Date().toISOString(),\n          });\n          break;\n\n        case 'result': {\n          debugLogs.push({\n            type: 'success',\n            message: `MCP: Tool ${toolName} response received (success)`,\n            timestamp: new Date().toISOString(),\n            response: message.result,\n          });\n          return message.result as CallToolResponse;\n        }\n\n        case 'error': {\n          debugLogs.push({\n            type: 'error',\n            message: `MCP Tasks: Error for ${toolName}: ${message.error.message}`,\n            timestamp: new Date().toISOString(),\n          });\n          // The MCP Tasks SDK error event may strip structured content.\n          // If we have a taskId, fetch the full result to recover adcp_error data\n          // and return it as a proper isError response for downstream unwrapping.\n          if (capturedTaskId) {\n            try {\n              const taskResult = await client.experimental.tasks.getTaskResult(\n                capturedTaskId,\n                undefined,\n                requestOptions\n              );\n              const content = taskResult?.content as Array<{ type: string; text?: string }> | undefined;\n              if (content) {\n                return {\n                  isError: true,\n                  content,\n                  structuredContent: taskResult?.structuredContent,\n                } as unknown as CallToolResponse;\n              }\n            } catch {\n              // Failed to fetch task result — fall through to throw\n            }\n          }\n          throw message.error;\n        }\n      }\n    }\n  } catch (error) {\n    if (signal?.aborted && isAbortOrTimeoutError(error)) {\n      throw error;\n    }\n    // If we timed out but have a taskId, return a working status\n    // so the caller can poll via getMCPTaskStatus/getMCPTaskResult\n    if (capturedTaskId && error instanceof Error && /timeout|timed out/i.test(error.message)) {\n      debugLogs.push({\n        type: 'info',\n        message: `MCP Tasks: Timeout for ${toolName}, returning working status with taskId ${capturedTaskId}`,\n        timestamp: new Date().toISOString(),\n      });\n\n      return {\n        structuredContent: {\n          status: 'working',\n          task_id: capturedTaskId,\n          poll_interval: capturedTask?.pollInterval,\n        },\n      };\n    }\n    if (isAbortOrTimeoutError(error)) {\n      throw error;\n    }\n    // Servers may return a synchronous tool error (e.g. VERSION_UNSUPPORTED)\n    // rather than creating a task. The Tasks SDK rejects these with a Zod\n    // validation error about a missing `task` field. When no task was\n    // captured, fall back to standard callTool so the error response\n    // reaches the caller intact.\n    const msg = error instanceof Error ? error.message : String(error);\n    if (!capturedTaskId && /Invalid task creation result/i.test(msg)) {\n      debugLogs.push({\n        type: 'info',\n        message: `MCP Tasks: Server returned synchronous response for ${toolName}, falling back to callTool`,\n        timestamp: new Date().toISOString(),\n      });\n      return (await client.callTool(\n        { name: toolName, arguments: args },\n        undefined,\n        requestOptions\n      )) as CallToolResponse;\n    }\n    throw error;\n  }\n\n  // Stream ended without result — shouldn't happen with well-behaved servers\n  if (capturedTaskId) {\n    return {\n      structuredContent: {\n        status: 'working',\n        task_id: capturedTaskId,\n        poll_interval: capturedTask?.pollInterval,\n      },\n    };\n  }\n\n  throw new Error(`MCP Tasks: callToolStream for ${toolName} ended without result or task`);\n}\n\n/**\n * Get task status via MCP Tasks protocol method (not tool call).\n *\n * Task lifecycle methods (`tasks/get`, `tasks/result`, `tasks/list`,\n * `tasks/cancel`) are MCP protocol methods, not AdCP operations.\n * `extractAdcpOperation` returns `undefined` for them, so the signing fetch\n * passes them through unsigned regardless of whether an `AgentSigningContext`\n * is present in ALS. That matches the RFC 9421 signing profile, which only\n * covers AdCP tool calls (`tools/call` / `message/send`).\n *\n * Re-throws auth errors (401) — only catches protocol capability errors.\n */\nexport async function getMCPTaskStatus(\n  agentUrl: string,\n  taskId: string,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  toolName?: string\n): Promise<TaskInfo> {\n  validateTaskId(taskId);\n  const authHeaders = buildAuthHeaders(authToken);\n\n  return withCachedConnection(agentUrl, authToken, authHeaders, debugLogs, `tasks/get:${taskId}`, async client => {\n    const result = await client.experimental.tasks.getTask(taskId);\n    debugLogs.push({\n      type: 'info',\n      message: `MCP Tasks: getTask ${taskId} → ${result.status}`,\n      timestamp: new Date().toISOString(),\n    });\n    return mapMCPTaskToTaskInfo(\n      result as {\n        taskId: string;\n        status: string;\n        createdAt: string;\n        lastUpdatedAt: string;\n        statusMessage?: string;\n        pollInterval?: number;\n      },\n      toolName\n    );\n  });\n}\n\n/**\n * Get task result via MCP Tasks protocol method (blocks until terminal).\n */\nexport async function getMCPTaskResult(\n  agentUrl: string,\n  taskId: string,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = []\n): Promise<unknown> {\n  validateTaskId(taskId);\n  const authHeaders = buildAuthHeaders(authToken);\n\n  return withCachedConnection(agentUrl, authToken, authHeaders, debugLogs, `tasks/result:${taskId}`, async client => {\n    const result = await client.experimental.tasks.getTaskResult(taskId);\n    debugLogs.push({\n      type: 'success',\n      message: `MCP Tasks: getTaskResult ${taskId} received`,\n      timestamp: new Date().toISOString(),\n    });\n    return result;\n  });\n}\n\n/**\n * List tasks via MCP Tasks protocol method.\n */\nexport async function listMCPTasks(\n  agentUrl: string,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  options: MCPTaskProtocolOptions = {}\n): Promise<TaskInfo[]> {\n  const authHeaders = buildAuthHeaders(authToken);\n\n  return withResponseSizeLimit(options.transport?.maxResponseBytes, () =>\n    withTransportDiagnostics(\n      {\n        agentId: options.transportActivityContext?.agentId ?? 'unknown-agent',\n        protocol: 'mcp',\n        tool: 'tasks/list',\n        taskType: 'tasks/list',\n        ...options.transportActivityContext,\n        onTransportActivity: options.onTransportActivity,\n      },\n      () =>\n        withCachedConnection(\n          agentUrl,\n          authToken,\n          authHeaders,\n          debugLogs,\n          'tasks/list',\n          async client => {\n            const result = await client.experimental.tasks.listTasks();\n            debugLogs.push({\n              type: 'info',\n              message: `MCP Tasks: listTasks returned ${result.tasks.length} tasks`,\n              timestamp: new Date().toISOString(),\n            });\n            return result.tasks.map((task: any) => mapMCPTaskToTaskInfo(task));\n          },\n          options.transport?.fetchFn,\n          { requestTimeoutMs: options.transport?.requestTimeoutMs }\n        )\n    )\n  );\n}\n\n/**\n * Cancel a task via MCP Tasks protocol method.\n */\nexport async function cancelMCPTask(\n  agentUrl: string,\n  taskId: string,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = []\n): Promise<void> {\n  validateTaskId(taskId);\n  const authHeaders = buildAuthHeaders(authToken);\n\n  await withCachedConnection(agentUrl, authToken, authHeaders, debugLogs, `tasks/cancel:${taskId}`, async client => {\n    await client.experimental.tasks.cancelTask(taskId);\n    debugLogs.push({\n      type: 'info',\n      message: `MCP Tasks: cancelTask ${taskId} succeeded`,\n      timestamp: new Date().toISOString(),\n    });\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/lib/protocols/mcp-tasks.mjs

@@ -103,7 +103,8 @@ async function callMCPToolWithTasks(agentUrl, toolName, args, authToken, debugLo
   const modernAttempt = await tryCallModernMCPTool(agentUrl, toolName, args, authToken, debugLogs, customHeaders, {
     ...options?.signingContext && { signingContext: options.signingContext },
     ...options?.signal && { signal: options.signal },
-    ...options?.requestTimeoutMs !== void 0 && { requestTimeoutMs: options.requestTimeoutMs }
+    ...options?.requestTimeoutMs !== void 0 && { requestTimeoutMs: options.requestTimeoutMs },
+    ...options?.fetchFn && { fetchFn: options.fetchFn }
   });
   if (modernAttempt.handled) {
     debugLogs.push({
@@ -138,7 +139,7 @@ async function callMCPToolWithTasks(agentUrl, toolName, args, authToken, debugLo
           options?.signal,
           options?.requestTimeoutMs
         ),
-        void 0,
+        options?.fetchFn,
         { signal: options?.signal, requestTimeoutMs: options?.requestTimeoutMs }
       );
     })
@@ -344,15 +345,24 @@ async function listMCPTasks(agentUrl, authToken, debugLogs = [], options = {}) {
         ...options.transportActivityContext,
         onTransportActivity: options.onTransportActivity
       },
-      () => withCachedConnection(agentUrl, authToken, authHeaders, debugLogs, "tasks/list", async (client) => {
-        const result = await client.experimental.tasks.listTasks();
-        debugLogs.push({
-          type: "info",
-          message: `MCP Tasks: listTasks returned ${result.tasks.length} tasks`,
-          timestamp: (/* @__PURE__ */ new Date()).toISOString()
-        });
-        return result.tasks.map((task) => mapMCPTaskToTaskInfo(task));
-      })
+      () => withCachedConnection(
+        agentUrl,
+        authToken,
+        authHeaders,
+        debugLogs,
+        "tasks/list",
+        async (client) => {
+          const result = await client.experimental.tasks.listTasks();
+          debugLogs.push({
+            type: "info",
+            message: `MCP Tasks: listTasks returned ${result.tasks.length} tasks`,
+            timestamp: (/* @__PURE__ */ new Date()).toISOString()
+          });
+          return result.tasks.map((task) => mapMCPTaskToTaskInfo(task));
+        },
+        options.transport?.fetchFn,
+        { requestTimeoutMs: options.transport?.requestTimeoutMs }
+      )
     )
   );
 }

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/protocols/mcp-tasks.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/**\n * MCP Tasks protocol integration for async tool calls.\n *\n * When an MCP server declares `capabilities.tasks.requests.tools.call`, this module\n * uses the SDK's experimental tasks API instead of custom AdCP tool calls for async\n * lifecycle management. This removes the LLM from the polling path.\n *\n * Detection: check `client.getServerCapabilities()?.tasks?.requests?.tools?.call`\n * after connection. The SDK's `isToolTask()` auto-detects per-tool `taskSupport`.\n */\n\nimport type { Client as MCPClient } from '@modelcontextprotocol/sdk/client/index.js';\nimport type { DebugLogEntry } from '../types/adcp';\nimport type { TaskInfo } from '../core/ConversationTypes';\nimport { withCachedConnection } from './mcp';\nimport { createMCPAuthHeaders } from '../auth';\nimport { withSpan, injectTraceHeaders } from '../observability/tracing';\nimport { signingContextStorage, type AgentSigningContext } from '../signing/client';\nimport { redactIdempotencyKeyInArgs } from '../utils/idempotency';\nimport { withResponseSizeLimit } from './responseSizeLimit';\nimport { withTransportDiagnostics, type TransportActivityHandler } from './transportDiagnostics';\nimport { isAbortOrTimeoutError, resolveClientRequestTimeoutMs } from './abort';\nimport { tryCallModernMCPTool } from './mcp-modern';\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\ninterface MCPTaskProtocolOptions {\n  transport?: { maxResponseBytes?: number };\n  onTransportActivity?: TransportActivityHandler;\n  transportActivityContext?: {\n    agentId: string;\n    operationId?: string;\n    taskId?: string;\n    contextId?: string;\n    idempotencyKey?: string;\n  };\n}\n\n/**\n * Track which MCP clients have had listTools() called.\n * The SDK's isToolTask() needs tool metadata from listTools() to determine\n * per-tool taskSupport. Without this, callToolStream silently degrades to\n * a synchronous tools/call (no task creation).\n */\nconst toolsListedClients = new WeakSet<MCPClient>();\n\n/**\n * Ensure tool metadata is cached in the SDK so isToolTask() works.\n * Called once per client connection when tasks are supported.\n */\nasync function ensureToolsListed(client: MCPClient, signal?: AbortSignal, requestTimeoutMs?: number): Promise<void> {\n  if (toolsListedClients.has(client)) return;\n  await client.listTools(undefined, {\n    ...(signal && { signal }),\n    ...(requestTimeoutMs !== undefined && { timeout: requestTimeoutMs }),\n  });\n  toolsListedClients.add(client);\n}\n\n/**\n * Check if an MCP server supports the Tasks protocol for tool calls.\n */\nexport function serverSupportsTasks(client: MCPClient): boolean {\n  const caps = client.getServerCapabilities();\n  return !!(caps as Record<string, any>)?.tasks?.requests?.tools?.call;\n}\n\n/**\n * Map MCP Tasks status to AdCP status.\n *\n * MCP Tasks uses underscores and British spelling; AdCP uses hyphens and American spelling.\n */\nexport function mapMCPTaskStatus(mcpStatus: string): string {\n  switch (mcpStatus) {\n    case 'working':\n      return 'working';\n    case 'input_required':\n      return 'input-required';\n    case 'completed':\n      return 'completed';\n    case 'failed':\n      return 'failed';\n    case 'cancelled':\n      return 'canceled';\n    default:\n      return mcpStatus;\n  }\n}\n\n/**\n * Map an MCP Task object to an AdCP TaskInfo.\n */\nfunction mapMCPTaskToTaskInfo(\n  task: {\n    taskId: string;\n    status: string;\n    createdAt: string;\n    lastUpdatedAt: string;\n    statusMessage?: string;\n    pollInterval?: number;\n  },\n  toolName?: string\n): TaskInfo {\n  // Project `statusMessage → TaskInfo.error` against the\n  // POST-MAPPING AdCP status (not the raw MCP-side status). MCP\n  // Tasks emits `'cancelled'` (British) and never `'rejected'` as a\n  // standard status; checking against the AdCP set after mapping\n  // catches all terminal failures uniformly. Sellers that extend\n  // MCP with custom statuses (e.g. emit `'rejected'` via spec\n  // extension) flow through unchanged via the `default` arm of\n  // {@link mapMCPTaskStatus}.\n  const adcpStatus = mapMCPTaskStatus(task.status);\n  const isTerminalFailure = adcpStatus === 'failed' || adcpStatus === 'rejected' || adcpStatus === 'canceled';\n  return {\n    taskId: task.taskId,\n    status: adcpStatus,\n    taskType: toolName ?? 'unknown',\n    createdAt: new Date(task.createdAt).getTime(),\n    updatedAt: new Date(task.lastUpdatedAt).getTime(),\n    error: isTerminalFailure ? task.statusMessage : undefined,\n  };\n}\n\n/**\n * Build auth headers for MCP connections.\n */\nfunction buildAuthHeaders(authToken?: string, customHeaders?: Record<string, string>): Record<string, string> {\n  const traceHeaders = injectTraceHeaders();\n  return {\n    ...customHeaders,\n    ...traceHeaders,\n    ...(authToken ? createMCPAuthHeaders(authToken) : {}),\n  };\n}\n\n/**\n * Redact sensitive fields from tool args before logging.\n *\n * Redacts:\n * - `push_notification_config.authentication` — webhook signing secret\n * - `idempotency_key` — retry-pattern oracle within the seller's TTL; opt-in\n *   full logging via `ADCP_LOG_IDEMPOTENCY_KEYS=1`\n */\nfunction redactArgsForLog(args: Record<string, unknown>): Record<string, unknown> {\n  let redacted: Record<string, unknown> = args;\n  if (redacted.push_notification_config) {\n    redacted = {\n      ...redacted,\n      push_notification_config: {\n        ...(redacted.push_notification_config as object),\n        authentication: '***',\n      },\n    };\n  }\n  return redactIdempotencyKeyInArgs(redacted);\n}\n\n/**\n * Validate taskId before passing to protocol methods.\n */\nfunction validateTaskId(taskId: string): void {\n  if (!taskId || typeof taskId !== 'string' || taskId.length > 256) {\n    throw new Error(`Invalid taskId: expected non-empty string (max 256 chars)`);\n  }\n}\n\n/**\n * Call an MCP tool with Tasks protocol support.\n *\n * If the server supports MCP Tasks and the tool has `taskSupport: 'optional' | 'required'`,\n * uses `callToolStream()` which handles task creation, polling, and result retrieval.\n *\n * If the server doesn't support tasks, falls back to regular `client.callTool()`.\n *\n * The stream is consumed with a timeout. If the task doesn't complete within the timeout,\n * returns a working-status response with the MCP task_id for follow-up polling.\n */\nexport async function callMCPToolWithTasks(\n  agentUrl: string,\n  toolName: string,\n  args: Record<string, unknown>,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  customHeaders?: Record<string, string>,\n  options?: {\n    workingTimeout?: number;\n    signingContext?: AgentSigningContext;\n    signal?: AbortSignal;\n    requestTimeoutMs?: number;\n  }\n): Promise<unknown> {\n  // Keep the public debug-log contract identical across modern and legacy\n  // protocol eras. Era negotiation happens after these common entries; the\n  // selected transport appends its own connection diagnostics.\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\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\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  const modernAttempt = await tryCallModernMCPTool(agentUrl, toolName, args, authToken, debugLogs, customHeaders, {\n    ...(options?.signingContext && { signingContext: options.signingContext }),\n    ...(options?.signal && { signal: options.signal }),\n    ...(options?.requestTimeoutMs !== undefined && { requestTimeoutMs: options.requestTimeoutMs }),\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  return withSpan(\n    'adcp.mcp.call_tool',\n    {\n      'adcp.tool': toolName,\n      'http.url': agentUrl,\n    },\n    async () =>\n      signingContextStorage.run(options?.signingContext, async () => {\n        const authHeaders = buildAuthHeaders(authToken, customHeaders);\n        const workingTimeout = options?.workingTimeout ?? 120_000;\n\n        return withCachedConnection(\n          agentUrl,\n          authToken,\n          authHeaders,\n          debugLogs,\n          toolName,\n          client =>\n            callToolOnClient(\n              client,\n              toolName,\n              args,\n              debugLogs,\n              workingTimeout,\n              options?.signal,\n              options?.requestTimeoutMs\n            ),\n          undefined,\n          { signal: options?.signal, requestTimeoutMs: options?.requestTimeoutMs }\n        );\n      })\n  );\n}\n\n/**\n * Call a tool on a pre-connected MCP `Client` without HTTP transport or connection caching.\n *\n * This is the in-process companion to `callMCPToolWithTasks`. It skips URL validation,\n * connection setup, OAuth refresh, and the reconnect-retry path — the caller owns the\n * client lifecycle. All other semantics (tasks protocol detection, stream handling,\n * timeout surfacing) are identical to the URL-based path.\n *\n * Use via `AgentClient.fromMCPClient()`. Not intended for direct import outside the\n * protocols directory.\n */\nexport async function callMCPToolWithClient(\n  mcpClient: MCPClient,\n  toolName: string,\n  args: Record<string, unknown>,\n  debugLogs: DebugLogEntry[] = [],\n  options?: { workingTimeout?: number; signal?: AbortSignal; requestTimeoutMs?: number }\n): Promise<unknown> {\n  debugLogs.push({\n    type: 'info',\n    message: `MCP: Calling tool ${toolName} (in-process) with args: ${JSON.stringify(redactArgsForLog(args))}`,\n    timestamp: new Date().toISOString(),\n  });\n  return callToolOnClient(\n    mcpClient,\n    toolName,\n    args,\n    debugLogs,\n    options?.workingTimeout ?? 120_000,\n    options?.signal,\n    options?.requestTimeoutMs\n  );\n}\n\n/**\n * Inner dispatch logic shared by `callMCPToolWithTasks` (URL path) and\n * `callMCPToolWithClient` (in-process path). Both paths converge here once\n * a connected `MCPClient` is in hand.\n */\nasync function callToolOnClient(\n  client: MCPClient,\n  toolName: string,\n  args: Record<string, unknown>,\n  debugLogs: DebugLogEntry[],\n  workingTimeout: number,\n  signal?: AbortSignal,\n  requestTimeoutMs?: number\n): Promise<unknown> {\n  const resolvedRequestTimeoutMs = resolveClientRequestTimeoutMs(requestTimeoutMs);\n  const requestOptions = {\n    ...(signal && { signal }),\n    ...(resolvedRequestTimeoutMs !== undefined && { timeout: resolvedRequestTimeoutMs }),\n  };\n  if (!serverSupportsTasks(client)) {\n    debugLogs.push({\n      type: 'info',\n      message: `MCP Tasks: Server does not support tasks, using standard callTool for ${toolName}`,\n      timestamp: new Date().toISOString(),\n    });\n    const response = (await client.callTool(\n      { name: toolName, arguments: args },\n      undefined,\n      requestOptions\n    )) as CallToolResponse;\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  // Ensure tool metadata is cached so the SDK's isToolTask() works correctly.\n  // Without this, callToolStream silently skips task creation for tools that\n  // declare taskSupport: 'optional' | 'required'.\n  await ensureToolsListed(client, signal, resolvedRequestTimeoutMs);\n\n  debugLogs.push({\n    type: 'info',\n    message: `MCP Tasks: Server supports tasks, using callToolStream for ${toolName}`,\n    timestamp: new Date().toISOString(),\n  });\n\n  // Use callToolStream which handles the full task lifecycle\n  const stream = client.experimental.tasks.callToolStream({ name: toolName, arguments: args }, undefined, {\n    timeout: resolvedRequestTimeoutMs ?? workingTimeout,\n    resetTimeoutOnProgress: true,\n    ...(signal && { signal }),\n  });\n\n  let capturedTaskId: string | undefined;\n  let capturedTask: { taskId: string; status: string; pollInterval?: number } | undefined;\n\n  try {\n    for await (const message of stream) {\n      switch (message.type) {\n        case 'taskCreated':\n          capturedTaskId = message.task.taskId;\n          capturedTask = message.task;\n          debugLogs.push({\n            type: 'info',\n            message: `MCP Tasks: Task created ${capturedTaskId} for ${toolName}`,\n            timestamp: new Date().toISOString(),\n          });\n          break;\n\n        case 'taskStatus':\n          capturedTask = message.task;\n          debugLogs.push({\n            type: 'info',\n            message: `MCP Tasks: Status update for ${capturedTaskId}: ${message.task.status}`,\n            timestamp: new Date().toISOString(),\n          });\n          break;\n\n        case 'result': {\n          debugLogs.push({\n            type: 'success',\n            message: `MCP: Tool ${toolName} response received (success)`,\n            timestamp: new Date().toISOString(),\n            response: message.result,\n          });\n          return message.result as CallToolResponse;\n        }\n\n        case 'error': {\n          debugLogs.push({\n            type: 'error',\n            message: `MCP Tasks: Error for ${toolName}: ${message.error.message}`,\n            timestamp: new Date().toISOString(),\n          });\n          // The MCP Tasks SDK error event may strip structured content.\n          // If we have a taskId, fetch the full result to recover adcp_error data\n          // and return it as a proper isError response for downstream unwrapping.\n          if (capturedTaskId) {\n            try {\n              const taskResult = await client.experimental.tasks.getTaskResult(\n                capturedTaskId,\n                undefined,\n                requestOptions\n              );\n              const content = taskResult?.content as Array<{ type: string; text?: string }> | undefined;\n              if (content) {\n                return {\n                  isError: true,\n                  content,\n                  structuredContent: taskResult?.structuredContent,\n                } as unknown as CallToolResponse;\n              }\n            } catch {\n              // Failed to fetch task result — fall through to throw\n            }\n          }\n          throw message.error;\n        }\n      }\n    }\n  } catch (error) {\n    if (signal?.aborted && isAbortOrTimeoutError(error)) {\n      throw error;\n    }\n    // If we timed out but have a taskId, return a working status\n    // so the caller can poll via getMCPTaskStatus/getMCPTaskResult\n    if (capturedTaskId && error instanceof Error && /timeout|timed out/i.test(error.message)) {\n      debugLogs.push({\n        type: 'info',\n        message: `MCP Tasks: Timeout for ${toolName}, returning working status with taskId ${capturedTaskId}`,\n        timestamp: new Date().toISOString(),\n      });\n\n      return {\n        structuredContent: {\n          status: 'working',\n          task_id: capturedTaskId,\n          poll_interval: capturedTask?.pollInterval,\n        },\n      };\n    }\n    if (isAbortOrTimeoutError(error)) {\n      throw error;\n    }\n    // Servers may return a synchronous tool error (e.g. VERSION_UNSUPPORTED)\n    // rather than creating a task. The Tasks SDK rejects these with a Zod\n    // validation error about a missing `task` field. When no task was\n    // captured, fall back to standard callTool so the error response\n    // reaches the caller intact.\n    const msg = error instanceof Error ? error.message : String(error);\n    if (!capturedTaskId && /Invalid task creation result/i.test(msg)) {\n      debugLogs.push({\n        type: 'info',\n        message: `MCP Tasks: Server returned synchronous response for ${toolName}, falling back to callTool`,\n        timestamp: new Date().toISOString(),\n      });\n      return (await client.callTool(\n        { name: toolName, arguments: args },\n        undefined,\n        requestOptions\n      )) as CallToolResponse;\n    }\n    throw error;\n  }\n\n  // Stream ended without result — shouldn't happen with well-behaved servers\n  if (capturedTaskId) {\n    return {\n      structuredContent: {\n        status: 'working',\n        task_id: capturedTaskId,\n        poll_interval: capturedTask?.pollInterval,\n      },\n    };\n  }\n\n  throw new Error(`MCP Tasks: callToolStream for ${toolName} ended without result or task`);\n}\n\n/**\n * Get task status via MCP Tasks protocol method (not tool call).\n *\n * Task lifecycle methods (`tasks/get`, `tasks/result`, `tasks/list`,\n * `tasks/cancel`) are MCP protocol methods, not AdCP operations.\n * `extractAdcpOperation` returns `undefined` for them, so the signing fetch\n * passes them through unsigned regardless of whether an `AgentSigningContext`\n * is present in ALS. That matches the RFC 9421 signing profile, which only\n * covers AdCP tool calls (`tools/call` / `message/send`).\n *\n * Re-throws auth errors (401) — only catches protocol capability errors.\n */\nexport async function getMCPTaskStatus(\n  agentUrl: string,\n  taskId: string,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  toolName?: string\n): Promise<TaskInfo> {\n  validateTaskId(taskId);\n  const authHeaders = buildAuthHeaders(authToken);\n\n  return withCachedConnection(agentUrl, authToken, authHeaders, debugLogs, `tasks/get:${taskId}`, async client => {\n    const result = await client.experimental.tasks.getTask(taskId);\n    debugLogs.push({\n      type: 'info',\n      message: `MCP Tasks: getTask ${taskId} → ${result.status}`,\n      timestamp: new Date().toISOString(),\n    });\n    return mapMCPTaskToTaskInfo(\n      result as {\n        taskId: string;\n        status: string;\n        createdAt: string;\n        lastUpdatedAt: string;\n        statusMessage?: string;\n        pollInterval?: number;\n      },\n      toolName\n    );\n  });\n}\n\n/**\n * Get task result via MCP Tasks protocol method (blocks until terminal).\n */\nexport async function getMCPTaskResult(\n  agentUrl: string,\n  taskId: string,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = []\n): Promise<unknown> {\n  validateTaskId(taskId);\n  const authHeaders = buildAuthHeaders(authToken);\n\n  return withCachedConnection(agentUrl, authToken, authHeaders, debugLogs, `tasks/result:${taskId}`, async client => {\n    const result = await client.experimental.tasks.getTaskResult(taskId);\n    debugLogs.push({\n      type: 'success',\n      message: `MCP Tasks: getTaskResult ${taskId} received`,\n      timestamp: new Date().toISOString(),\n    });\n    return result;\n  });\n}\n\n/**\n * List tasks via MCP Tasks protocol method.\n */\nexport async function listMCPTasks(\n  agentUrl: string,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  options: MCPTaskProtocolOptions = {}\n): Promise<TaskInfo[]> {\n  const authHeaders = buildAuthHeaders(authToken);\n\n  return withResponseSizeLimit(options.transport?.maxResponseBytes, () =>\n    withTransportDiagnostics(\n      {\n        agentId: options.transportActivityContext?.agentId ?? 'unknown-agent',\n        protocol: 'mcp',\n        tool: 'tasks/list',\n        taskType: 'tasks/list',\n        ...options.transportActivityContext,\n        onTransportActivity: options.onTransportActivity,\n      },\n      () =>\n        withCachedConnection(agentUrl, authToken, authHeaders, debugLogs, 'tasks/list', async client => {\n          const result = await client.experimental.tasks.listTasks();\n          debugLogs.push({\n            type: 'info',\n            message: `MCP Tasks: listTasks returned ${result.tasks.length} tasks`,\n            timestamp: new Date().toISOString(),\n          });\n          return result.tasks.map((task: any) => mapMCPTaskToTaskInfo(task));\n        })\n    )\n  );\n}\n\n/**\n * Cancel a task via MCP Tasks protocol method.\n */\nexport async function cancelMCPTask(\n  agentUrl: string,\n  taskId: string,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = []\n): Promise<void> {\n  validateTaskId(taskId);\n  const authHeaders = buildAuthHeaders(authToken);\n\n  await withCachedConnection(agentUrl, authToken, authHeaders, debugLogs, `tasks/cancel:${taskId}`, async client => {\n    await client.experimental.tasks.cancelTask(taskId);\n    debugLogs.push({\n      type: 'info',\n      message: `MCP Tasks: cancelTask ${taskId} succeeded`,\n      timestamp: new Date().toISOString(),\n    });\n  });\n}\n"],"mappings":"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","names":["require"]}
+{"version":3,"sources":["../../../src/lib/protocols/mcp-tasks.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/**\n * MCP Tasks protocol integration for async tool calls.\n *\n * When an MCP server declares `capabilities.tasks.requests.tools.call`, this module\n * uses the SDK's experimental tasks API instead of custom AdCP tool calls for async\n * lifecycle management. This removes the LLM from the polling path.\n *\n * Detection: check `client.getServerCapabilities()?.tasks?.requests?.tools?.call`\n * after connection. The SDK's `isToolTask()` auto-detects per-tool `taskSupport`.\n */\n\nimport type { Client as MCPClient } from '@modelcontextprotocol/sdk/client/index.js';\nimport type { DebugLogEntry } from '../types/adcp';\nimport type { TaskInfo } from '../core/ConversationTypes';\nimport { withCachedConnection } from './mcp';\nimport { createMCPAuthHeaders } from '../auth';\nimport { withSpan, injectTraceHeaders } from '../observability/tracing';\nimport { signingContextStorage, type AgentSigningContext } from '../signing/client';\nimport { redactIdempotencyKeyInArgs } from '../utils/idempotency';\nimport { withResponseSizeLimit } from './responseSizeLimit';\nimport { withTransportDiagnostics, type TransportActivityHandler } from './transportDiagnostics';\nimport { isAbortOrTimeoutError, resolveClientRequestTimeoutMs } from './abort';\nimport { tryCallModernMCPTool } from './mcp-modern';\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\ninterface MCPTaskProtocolOptions {\n  transport?: { maxResponseBytes?: number; fetchFn?: typeof fetch; requestTimeoutMs?: number };\n  onTransportActivity?: TransportActivityHandler;\n  transportActivityContext?: {\n    agentId: string;\n    operationId?: string;\n    taskId?: string;\n    contextId?: string;\n    idempotencyKey?: string;\n  };\n}\n\n/**\n * Track which MCP clients have had listTools() called.\n * The SDK's isToolTask() needs tool metadata from listTools() to determine\n * per-tool taskSupport. Without this, callToolStream silently degrades to\n * a synchronous tools/call (no task creation).\n */\nconst toolsListedClients = new WeakSet<MCPClient>();\n\n/**\n * Ensure tool metadata is cached in the SDK so isToolTask() works.\n * Called once per client connection when tasks are supported.\n */\nasync function ensureToolsListed(client: MCPClient, signal?: AbortSignal, requestTimeoutMs?: number): Promise<void> {\n  if (toolsListedClients.has(client)) return;\n  await client.listTools(undefined, {\n    ...(signal && { signal }),\n    ...(requestTimeoutMs !== undefined && { timeout: requestTimeoutMs }),\n  });\n  toolsListedClients.add(client);\n}\n\n/**\n * Check if an MCP server supports the Tasks protocol for tool calls.\n */\nexport function serverSupportsTasks(client: MCPClient): boolean {\n  const caps = client.getServerCapabilities();\n  return !!(caps as Record<string, any>)?.tasks?.requests?.tools?.call;\n}\n\n/**\n * Map MCP Tasks status to AdCP status.\n *\n * MCP Tasks uses underscores and British spelling; AdCP uses hyphens and American spelling.\n */\nexport function mapMCPTaskStatus(mcpStatus: string): string {\n  switch (mcpStatus) {\n    case 'working':\n      return 'working';\n    case 'input_required':\n      return 'input-required';\n    case 'completed':\n      return 'completed';\n    case 'failed':\n      return 'failed';\n    case 'cancelled':\n      return 'canceled';\n    default:\n      return mcpStatus;\n  }\n}\n\n/**\n * Map an MCP Task object to an AdCP TaskInfo.\n */\nfunction mapMCPTaskToTaskInfo(\n  task: {\n    taskId: string;\n    status: string;\n    createdAt: string;\n    lastUpdatedAt: string;\n    statusMessage?: string;\n    pollInterval?: number;\n  },\n  toolName?: string\n): TaskInfo {\n  // Project `statusMessage → TaskInfo.error` against the\n  // POST-MAPPING AdCP status (not the raw MCP-side status). MCP\n  // Tasks emits `'cancelled'` (British) and never `'rejected'` as a\n  // standard status; checking against the AdCP set after mapping\n  // catches all terminal failures uniformly. Sellers that extend\n  // MCP with custom statuses (e.g. emit `'rejected'` via spec\n  // extension) flow through unchanged via the `default` arm of\n  // {@link mapMCPTaskStatus}.\n  const adcpStatus = mapMCPTaskStatus(task.status);\n  const isTerminalFailure = adcpStatus === 'failed' || adcpStatus === 'rejected' || adcpStatus === 'canceled';\n  return {\n    taskId: task.taskId,\n    status: adcpStatus,\n    taskType: toolName ?? 'unknown',\n    createdAt: new Date(task.createdAt).getTime(),\n    updatedAt: new Date(task.lastUpdatedAt).getTime(),\n    error: isTerminalFailure ? task.statusMessage : undefined,\n  };\n}\n\n/**\n * Build auth headers for MCP connections.\n */\nfunction buildAuthHeaders(authToken?: string, customHeaders?: Record<string, string>): Record<string, string> {\n  const traceHeaders = injectTraceHeaders();\n  return {\n    ...customHeaders,\n    ...traceHeaders,\n    ...(authToken ? createMCPAuthHeaders(authToken) : {}),\n  };\n}\n\n/**\n * Redact sensitive fields from tool args before logging.\n *\n * Redacts:\n * - `push_notification_config.authentication` — webhook signing secret\n * - `idempotency_key` — retry-pattern oracle within the seller's TTL; opt-in\n *   full logging via `ADCP_LOG_IDEMPOTENCY_KEYS=1`\n */\nfunction redactArgsForLog(args: Record<string, unknown>): Record<string, unknown> {\n  let redacted: Record<string, unknown> = args;\n  if (redacted.push_notification_config) {\n    redacted = {\n      ...redacted,\n      push_notification_config: {\n        ...(redacted.push_notification_config as object),\n        authentication: '***',\n      },\n    };\n  }\n  return redactIdempotencyKeyInArgs(redacted);\n}\n\n/**\n * Validate taskId before passing to protocol methods.\n */\nfunction validateTaskId(taskId: string): void {\n  if (!taskId || typeof taskId !== 'string' || taskId.length > 256) {\n    throw new Error(`Invalid taskId: expected non-empty string (max 256 chars)`);\n  }\n}\n\n/**\n * Call an MCP tool with Tasks protocol support.\n *\n * If the server supports MCP Tasks and the tool has `taskSupport: 'optional' | 'required'`,\n * uses `callToolStream()` which handles task creation, polling, and result retrieval.\n *\n * If the server doesn't support tasks, falls back to regular `client.callTool()`.\n *\n * The stream is consumed with a timeout. If the task doesn't complete within the timeout,\n * returns a working-status response with the MCP task_id for follow-up polling.\n */\nexport async function callMCPToolWithTasks(\n  agentUrl: string,\n  toolName: string,\n  args: Record<string, unknown>,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  customHeaders?: Record<string, string>,\n  options?: {\n    workingTimeout?: number;\n    signingContext?: AgentSigningContext;\n    signal?: AbortSignal;\n    requestTimeoutMs?: number;\n    fetchFn?: typeof fetch;\n  }\n): Promise<unknown> {\n  // Keep the public debug-log contract identical across modern and legacy\n  // protocol eras. Era negotiation happens after these common entries; the\n  // selected transport appends its own connection diagnostics.\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\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\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  const modernAttempt = await tryCallModernMCPTool(agentUrl, toolName, args, authToken, debugLogs, customHeaders, {\n    ...(options?.signingContext && { signingContext: options.signingContext }),\n    ...(options?.signal && { signal: options.signal }),\n    ...(options?.requestTimeoutMs !== undefined && { requestTimeoutMs: options.requestTimeoutMs }),\n    ...(options?.fetchFn && { fetchFn: options.fetchFn }),\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  return withSpan(\n    'adcp.mcp.call_tool',\n    {\n      'adcp.tool': toolName,\n      'http.url': agentUrl,\n    },\n    async () =>\n      signingContextStorage.run(options?.signingContext, async () => {\n        const authHeaders = buildAuthHeaders(authToken, customHeaders);\n        const workingTimeout = options?.workingTimeout ?? 120_000;\n\n        return withCachedConnection(\n          agentUrl,\n          authToken,\n          authHeaders,\n          debugLogs,\n          toolName,\n          client =>\n            callToolOnClient(\n              client,\n              toolName,\n              args,\n              debugLogs,\n              workingTimeout,\n              options?.signal,\n              options?.requestTimeoutMs\n            ),\n          options?.fetchFn,\n          { signal: options?.signal, requestTimeoutMs: options?.requestTimeoutMs }\n        );\n      })\n  );\n}\n\n/**\n * Call a tool on a pre-connected MCP `Client` without HTTP transport or connection caching.\n *\n * This is the in-process companion to `callMCPToolWithTasks`. It skips URL validation,\n * connection setup, OAuth refresh, and the reconnect-retry path — the caller owns the\n * client lifecycle. All other semantics (tasks protocol detection, stream handling,\n * timeout surfacing) are identical to the URL-based path.\n *\n * Use via `AgentClient.fromMCPClient()`. Not intended for direct import outside the\n * protocols directory.\n */\nexport async function callMCPToolWithClient(\n  mcpClient: MCPClient,\n  toolName: string,\n  args: Record<string, unknown>,\n  debugLogs: DebugLogEntry[] = [],\n  options?: { workingTimeout?: number; signal?: AbortSignal; requestTimeoutMs?: number }\n): Promise<unknown> {\n  debugLogs.push({\n    type: 'info',\n    message: `MCP: Calling tool ${toolName} (in-process) with args: ${JSON.stringify(redactArgsForLog(args))}`,\n    timestamp: new Date().toISOString(),\n  });\n  return callToolOnClient(\n    mcpClient,\n    toolName,\n    args,\n    debugLogs,\n    options?.workingTimeout ?? 120_000,\n    options?.signal,\n    options?.requestTimeoutMs\n  );\n}\n\n/**\n * Inner dispatch logic shared by `callMCPToolWithTasks` (URL path) and\n * `callMCPToolWithClient` (in-process path). Both paths converge here once\n * a connected `MCPClient` is in hand.\n */\nasync function callToolOnClient(\n  client: MCPClient,\n  toolName: string,\n  args: Record<string, unknown>,\n  debugLogs: DebugLogEntry[],\n  workingTimeout: number,\n  signal?: AbortSignal,\n  requestTimeoutMs?: number\n): Promise<unknown> {\n  const resolvedRequestTimeoutMs = resolveClientRequestTimeoutMs(requestTimeoutMs);\n  const requestOptions = {\n    ...(signal && { signal }),\n    ...(resolvedRequestTimeoutMs !== undefined && { timeout: resolvedRequestTimeoutMs }),\n  };\n  if (!serverSupportsTasks(client)) {\n    debugLogs.push({\n      type: 'info',\n      message: `MCP Tasks: Server does not support tasks, using standard callTool for ${toolName}`,\n      timestamp: new Date().toISOString(),\n    });\n    const response = (await client.callTool(\n      { name: toolName, arguments: args },\n      undefined,\n      requestOptions\n    )) as CallToolResponse;\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  // Ensure tool metadata is cached so the SDK's isToolTask() works correctly.\n  // Without this, callToolStream silently skips task creation for tools that\n  // declare taskSupport: 'optional' | 'required'.\n  await ensureToolsListed(client, signal, resolvedRequestTimeoutMs);\n\n  debugLogs.push({\n    type: 'info',\n    message: `MCP Tasks: Server supports tasks, using callToolStream for ${toolName}`,\n    timestamp: new Date().toISOString(),\n  });\n\n  // Use callToolStream which handles the full task lifecycle\n  const stream = client.experimental.tasks.callToolStream({ name: toolName, arguments: args }, undefined, {\n    timeout: resolvedRequestTimeoutMs ?? workingTimeout,\n    resetTimeoutOnProgress: true,\n    ...(signal && { signal }),\n  });\n\n  let capturedTaskId: string | undefined;\n  let capturedTask: { taskId: string; status: string; pollInterval?: number } | undefined;\n\n  try {\n    for await (const message of stream) {\n      switch (message.type) {\n        case 'taskCreated':\n          capturedTaskId = message.task.taskId;\n          capturedTask = message.task;\n          debugLogs.push({\n            type: 'info',\n            message: `MCP Tasks: Task created ${capturedTaskId} for ${toolName}`,\n            timestamp: new Date().toISOString(),\n          });\n          break;\n\n        case 'taskStatus':\n          capturedTask = message.task;\n          debugLogs.push({\n            type: 'info',\n            message: `MCP Tasks: Status update for ${capturedTaskId}: ${message.task.status}`,\n            timestamp: new Date().toISOString(),\n          });\n          break;\n\n        case 'result': {\n          debugLogs.push({\n            type: 'success',\n            message: `MCP: Tool ${toolName} response received (success)`,\n            timestamp: new Date().toISOString(),\n            response: message.result,\n          });\n          return message.result as CallToolResponse;\n        }\n\n        case 'error': {\n          debugLogs.push({\n            type: 'error',\n            message: `MCP Tasks: Error for ${toolName}: ${message.error.message}`,\n            timestamp: new Date().toISOString(),\n          });\n          // The MCP Tasks SDK error event may strip structured content.\n          // If we have a taskId, fetch the full result to recover adcp_error data\n          // and return it as a proper isError response for downstream unwrapping.\n          if (capturedTaskId) {\n            try {\n              const taskResult = await client.experimental.tasks.getTaskResult(\n                capturedTaskId,\n                undefined,\n                requestOptions\n              );\n              const content = taskResult?.content as Array<{ type: string; text?: string }> | undefined;\n              if (content) {\n                return {\n                  isError: true,\n                  content,\n                  structuredContent: taskResult?.structuredContent,\n                } as unknown as CallToolResponse;\n              }\n            } catch {\n              // Failed to fetch task result — fall through to throw\n            }\n          }\n          throw message.error;\n        }\n      }\n    }\n  } catch (error) {\n    if (signal?.aborted && isAbortOrTimeoutError(error)) {\n      throw error;\n    }\n    // If we timed out but have a taskId, return a working status\n    // so the caller can poll via getMCPTaskStatus/getMCPTaskResult\n    if (capturedTaskId && error instanceof Error && /timeout|timed out/i.test(error.message)) {\n      debugLogs.push({\n        type: 'info',\n        message: `MCP Tasks: Timeout for ${toolName}, returning working status with taskId ${capturedTaskId}`,\n        timestamp: new Date().toISOString(),\n      });\n\n      return {\n        structuredContent: {\n          status: 'working',\n          task_id: capturedTaskId,\n          poll_interval: capturedTask?.pollInterval,\n        },\n      };\n    }\n    if (isAbortOrTimeoutError(error)) {\n      throw error;\n    }\n    // Servers may return a synchronous tool error (e.g. VERSION_UNSUPPORTED)\n    // rather than creating a task. The Tasks SDK rejects these with a Zod\n    // validation error about a missing `task` field. When no task was\n    // captured, fall back to standard callTool so the error response\n    // reaches the caller intact.\n    const msg = error instanceof Error ? error.message : String(error);\n    if (!capturedTaskId && /Invalid task creation result/i.test(msg)) {\n      debugLogs.push({\n        type: 'info',\n        message: `MCP Tasks: Server returned synchronous response for ${toolName}, falling back to callTool`,\n        timestamp: new Date().toISOString(),\n      });\n      return (await client.callTool(\n        { name: toolName, arguments: args },\n        undefined,\n        requestOptions\n      )) as CallToolResponse;\n    }\n    throw error;\n  }\n\n  // Stream ended without result — shouldn't happen with well-behaved servers\n  if (capturedTaskId) {\n    return {\n      structuredContent: {\n        status: 'working',\n        task_id: capturedTaskId,\n        poll_interval: capturedTask?.pollInterval,\n      },\n    };\n  }\n\n  throw new Error(`MCP Tasks: callToolStream for ${toolName} ended without result or task`);\n}\n\n/**\n * Get task status via MCP Tasks protocol method (not tool call).\n *\n * Task lifecycle methods (`tasks/get`, `tasks/result`, `tasks/list`,\n * `tasks/cancel`) are MCP protocol methods, not AdCP operations.\n * `extractAdcpOperation` returns `undefined` for them, so the signing fetch\n * passes them through unsigned regardless of whether an `AgentSigningContext`\n * is present in ALS. That matches the RFC 9421 signing profile, which only\n * covers AdCP tool calls (`tools/call` / `message/send`).\n *\n * Re-throws auth errors (401) — only catches protocol capability errors.\n */\nexport async function getMCPTaskStatus(\n  agentUrl: string,\n  taskId: string,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  toolName?: string\n): Promise<TaskInfo> {\n  validateTaskId(taskId);\n  const authHeaders = buildAuthHeaders(authToken);\n\n  return withCachedConnection(agentUrl, authToken, authHeaders, debugLogs, `tasks/get:${taskId}`, async client => {\n    const result = await client.experimental.tasks.getTask(taskId);\n    debugLogs.push({\n      type: 'info',\n      message: `MCP Tasks: getTask ${taskId} → ${result.status}`,\n      timestamp: new Date().toISOString(),\n    });\n    return mapMCPTaskToTaskInfo(\n      result as {\n        taskId: string;\n        status: string;\n        createdAt: string;\n        lastUpdatedAt: string;\n        statusMessage?: string;\n        pollInterval?: number;\n      },\n      toolName\n    );\n  });\n}\n\n/**\n * Get task result via MCP Tasks protocol method (blocks until terminal).\n */\nexport async function getMCPTaskResult(\n  agentUrl: string,\n  taskId: string,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = []\n): Promise<unknown> {\n  validateTaskId(taskId);\n  const authHeaders = buildAuthHeaders(authToken);\n\n  return withCachedConnection(agentUrl, authToken, authHeaders, debugLogs, `tasks/result:${taskId}`, async client => {\n    const result = await client.experimental.tasks.getTaskResult(taskId);\n    debugLogs.push({\n      type: 'success',\n      message: `MCP Tasks: getTaskResult ${taskId} received`,\n      timestamp: new Date().toISOString(),\n    });\n    return result;\n  });\n}\n\n/**\n * List tasks via MCP Tasks protocol method.\n */\nexport async function listMCPTasks(\n  agentUrl: string,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = [],\n  options: MCPTaskProtocolOptions = {}\n): Promise<TaskInfo[]> {\n  const authHeaders = buildAuthHeaders(authToken);\n\n  return withResponseSizeLimit(options.transport?.maxResponseBytes, () =>\n    withTransportDiagnostics(\n      {\n        agentId: options.transportActivityContext?.agentId ?? 'unknown-agent',\n        protocol: 'mcp',\n        tool: 'tasks/list',\n        taskType: 'tasks/list',\n        ...options.transportActivityContext,\n        onTransportActivity: options.onTransportActivity,\n      },\n      () =>\n        withCachedConnection(\n          agentUrl,\n          authToken,\n          authHeaders,\n          debugLogs,\n          'tasks/list',\n          async client => {\n            const result = await client.experimental.tasks.listTasks();\n            debugLogs.push({\n              type: 'info',\n              message: `MCP Tasks: listTasks returned ${result.tasks.length} tasks`,\n              timestamp: new Date().toISOString(),\n            });\n            return result.tasks.map((task: any) => mapMCPTaskToTaskInfo(task));\n          },\n          options.transport?.fetchFn,\n          { requestTimeoutMs: options.transport?.requestTimeoutMs }\n        )\n    )\n  );\n}\n\n/**\n * Cancel a task via MCP Tasks protocol method.\n */\nexport async function cancelMCPTask(\n  agentUrl: string,\n  taskId: string,\n  authToken?: string,\n  debugLogs: DebugLogEntry[] = []\n): Promise<void> {\n  validateTaskId(taskId);\n  const authHeaders = buildAuthHeaders(authToken);\n\n  await withCachedConnection(agentUrl, authToken, authHeaders, debugLogs, `tasks/cancel:${taskId}`, async client => {\n    await client.experimental.tasks.cancelTask(taskId);\n    debugLogs.push({\n      type: 'info',\n      message: `MCP Tasks: cancelTask ${taskId} succeeded`,\n      timestamp: new Date().toISOString(),\n    });\n  });\n}\n"],"mappings":"AAAA,SAAS,iBAAiB,2BAA2B;AACrD,SAAS,WAAW,qBAAqB;AACzC,SAAS,iBAAiB,2BAA2B;AACrD,MAAM,YAAY,cAAc,oBAAoB,YAAY,GAAG,CAAC;AACpE,MAAMA,WAAU,oBAAoB,YAAY,GAAG;AAenD,SAAS,4BAA4B;AACrC,SAAS,4BAA4B;AACrC,SAAS,UAAU,0BAA0B;AAC7C,SAAS,6BAAuD;AAChE,SAAS,kCAAkC;AAC3C,SAAS,6BAA6B;AACtC,SAAS,gCAA+D;AACxE,SAAS,uBAAuB,qCAAqC;AACrE,SAAS,4BAA4B;AA2BrC,MAAM,qBAAqB,oBAAI,QAAmB;AAMlD,eAAe,kBAAkB,QAAmB,QAAsB,kBAA0C;AAClH,MAAI,mBAAmB,IAAI,MAAM,EAAG;AACpC,QAAM,OAAO,UAAU,QAAW;AAAA,IAChC,GAAI,UAAU,EAAE,OAAO;AAAA,IACvB,GAAI,qBAAqB,UAAa,EAAE,SAAS,iBAAiB;AAAA,EACpE,CAAC;AACD,qBAAmB,IAAI,MAAM;AAC/B;AAKO,SAAS,oBAAoB,QAA4B;AAC9D,QAAM,OAAO,OAAO,sBAAsB;AAC1C,SAAO,CAAC,CAAE,MAA8B,OAAO,UAAU,OAAO;AAClE;AAOO,SAAS,iBAAiB,WAA2B;AAC1D,UAAQ,WAAW;AAAA,IACjB,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAKA,SAAS,qBACP,MAQA,UACU;AASV,QAAM,aAAa,iBAAiB,KAAK,MAAM;AAC/C,QAAM,oBAAoB,eAAe,YAAY,eAAe,cAAc,eAAe;AACjG,SAAO;AAAA,IACL,QAAQ,KAAK;AAAA,IACb,QAAQ;AAAA,IACR,UAAU,YAAY;AAAA,IACtB,WAAW,IAAI,KAAK,KAAK,SAAS,EAAE,QAAQ;AAAA,IAC5C,WAAW,IAAI,KAAK,KAAK,aAAa,EAAE,QAAQ;AAAA,IAChD,OAAO,oBAAoB,KAAK,gBAAgB;AAAA,EAClD;AACF;AAKA,SAAS,iBAAiB,WAAoB,eAAgE;AAC5G,QAAM,eAAe,mBAAmB;AACxC,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAI,YAAY,qBAAqB,SAAS,IAAI,CAAC;AAAA,EACrD;AACF;AAUA,SAAS,iBAAiB,MAAwD;AAChF,MAAI,WAAoC;AACxC,MAAI,SAAS,0BAA0B;AACrC,eAAW;AAAA,MACT,GAAG;AAAA,MACH,0BAA0B;AAAA,QACxB,GAAI,SAAS;AAAA,QACb,gBAAgB;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AACA,SAAO,2BAA2B,QAAQ;AAC5C;AAKA,SAAS,eAAe,QAAsB;AAC5C,MAAI,CAAC,UAAU,OAAO,WAAW,YAAY,OAAO,SAAS,KAAK;AAChE,UAAM,IAAI,MAAM,2DAA2D;AAAA,EAC7E;AACF;AAaA,eAAsB,qBACpB,UACA,UACA,MACA,WACA,YAA6B,CAAC,GAC9B,eACA,SAOkB;AAIlB,YAAU,KAAK;AAAA,IACb,MAAM;AAAA,IACN,SAAS;AAAA,IACT,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IAClC,SAAS,CAAC,CAAC;AAAA,IACX,SAAS,YAAY,EAAE,eAAe,MAAM,IAAI,CAAC;AAAA,IACjD,kBAAkB,gBAAgB,OAAO,KAAK,aAAa,IAAI,CAAC;AAAA,EAClE,CAAC;AAED,YAAU,KAAK;AAAA,IACb,MAAM;AAAA,IACN,SAAS,qBAAqB,QAAQ,eAAe,KAAK,UAAU,iBAAiB,IAAI,CAAC,CAAC;AAAA,IAC3F,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,EACpC,CAAC;AAED,MAAI,WAAW;AACb,cAAU,KAAK;AAAA,MACb,MAAM;AAAA,MACN,SAAS,yDAAyD,QAAQ;AAAA,MAC1E,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IACpC,CAAC;AAAA,EACH;AAEA,QAAM,gBAAgB,MAAM,qBAAqB,UAAU,UAAU,MAAM,WAAW,WAAW,eAAe;AAAA,IAC9G,GAAI,SAAS,kBAAkB,EAAE,gBAAgB,QAAQ,eAAe;AAAA,IACxE,GAAI,SAAS,UAAU,EAAE,QAAQ,QAAQ,OAAO;AAAA,IAChD,GAAI,SAAS,qBAAqB,UAAa,EAAE,kBAAkB,QAAQ,iBAAiB;AAAA,IAC5F,GAAI,SAAS,WAAW,EAAE,SAAS,QAAQ,QAAQ;AAAA,EACrD,CAAC;AACD,MAAI,cAAc,SAAS;AACzB,cAAU,KAAK;AAAA,MACb,MAAM,cAAc,UAAU,UAAU,UAAU;AAAA,MAClD,SAAS,aAAa,QAAQ,uBAAuB,cAAc,UAAU,UAAU,UAAU,SAAS;AAAA,MAC1G,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MAClC,UAAU,cAAc;AAAA,IAC1B,CAAC;AACD,WAAO,cAAc;AAAA,EACvB;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,MACE,aAAa;AAAA,MACb,YAAY;AAAA,IACd;AAAA,IACA,YACE,sBAAsB,IAAI,SAAS,gBAAgB,YAAY;AAC7D,YAAM,cAAc,iBAAiB,WAAW,aAAa;AAC7D,YAAM,iBAAiB,SAAS,kBAAkB;AAElD,aAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,YACE;AAAA,UACE;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA,SAAS;AAAA,UACT,SAAS;AAAA,QACX;AAAA,QACF,SAAS;AAAA,QACT,EAAE,QAAQ,SAAS,QAAQ,kBAAkB,SAAS,iBAAiB;AAAA,MACzE;AAAA,IACF,CAAC;AAAA,EACL;AACF;AAaA,eAAsB,sBACpB,WACA,UACA,MACA,YAA6B,CAAC,GAC9B,SACkB;AAClB,YAAU,KAAK;AAAA,IACb,MAAM;AAAA,IACN,SAAS,qBAAqB,QAAQ,4BAA4B,KAAK,UAAU,iBAAiB,IAAI,CAAC,CAAC;AAAA,IACxG,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,EACpC,CAAC;AACD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS,kBAAkB;AAAA,IAC3B,SAAS;AAAA,IACT,SAAS;AAAA,EACX;AACF;AAOA,eAAe,iBACb,QACA,UACA,MACA,WACA,gBACA,QACA,kBACkB;AAClB,QAAM,2BAA2B,8BAA8B,gBAAgB;AAC/E,QAAM,iBAAiB;AAAA,IACrB,GAAI,UAAU,EAAE,OAAO;AAAA,IACvB,GAAI,6BAA6B,UAAa,EAAE,SAAS,yBAAyB;AAAA,EACpF;AACA,MAAI,CAAC,oBAAoB,MAAM,GAAG;AAChC,cAAU,KAAK;AAAA,MACb,MAAM;AAAA,MACN,SAAS,yEAAyE,QAAQ;AAAA,MAC1F,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IACpC,CAAC;AACD,UAAM,WAAY,MAAM,OAAO;AAAA,MAC7B,EAAE,MAAM,UAAU,WAAW,KAAK;AAAA,MAClC;AAAA,MACA;AAAA,IACF;AAEA,cAAU,KAAK;AAAA,MACb,MAAM,UAAU,UAAU,UAAU;AAAA,MACpC,SAAS,aAAa,QAAQ,uBAAuB,UAAU,UAAU,UAAU,SAAS;AAAA,MAC5F,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MAClC;AAAA,IACF,CAAC;AAED,WAAO;AAAA,EACT;AAKA,QAAM,kBAAkB,QAAQ,QAAQ,wBAAwB;AAEhE,YAAU,KAAK;AAAA,IACb,MAAM;AAAA,IACN,SAAS,8DAA8D,QAAQ;AAAA,IAC/E,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,EACpC,CAAC;AAGD,QAAM,SAAS,OAAO,aAAa,MAAM,eAAe,EAAE,MAAM,UAAU,WAAW,KAAK,GAAG,QAAW;AAAA,IACtG,SAAS,4BAA4B;AAAA,IACrC,wBAAwB;AAAA,IACxB,GAAI,UAAU,EAAE,OAAO;AAAA,EACzB,CAAC;AAED,MAAI;AACJ,MAAI;AAEJ,MAAI;AACF,qBAAiB,WAAW,QAAQ;AAClC,cAAQ,QAAQ,MAAM;AAAA,QACpB,KAAK;AACH,2BAAiB,QAAQ,KAAK;AAC9B,yBAAe,QAAQ;AACvB,oBAAU,KAAK;AAAA,YACb,MAAM;AAAA,YACN,SAAS,2BAA2B,cAAc,QAAQ,QAAQ;AAAA,YAClE,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,UACpC,CAAC;AACD;AAAA,QAEF,KAAK;AACH,yBAAe,QAAQ;AACvB,oBAAU,KAAK;AAAA,YACb,MAAM;AAAA,YACN,SAAS,gCAAgC,cAAc,KAAK,QAAQ,KAAK,MAAM;AAAA,YAC/E,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,UACpC,CAAC;AACD;AAAA,QAEF,KAAK,UAAU;AACb,oBAAU,KAAK;AAAA,YACb,MAAM;AAAA,YACN,SAAS,aAAa,QAAQ;AAAA,YAC9B,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,YAClC,UAAU,QAAQ;AAAA,UACpB,CAAC;AACD,iBAAO,QAAQ;AAAA,QACjB;AAAA,QAEA,KAAK,SAAS;AACZ,oBAAU,KAAK;AAAA,YACb,MAAM;AAAA,YACN,SAAS,wBAAwB,QAAQ,KAAK,QAAQ,MAAM,OAAO;AAAA,YACnE,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,UACpC,CAAC;AAID,cAAI,gBAAgB;AAClB,gBAAI;AACF,oBAAM,aAAa,MAAM,OAAO,aAAa,MAAM;AAAA,gBACjD;AAAA,gBACA;AAAA,gBACA;AAAA,cACF;AACA,oBAAM,UAAU,YAAY;AAC5B,kBAAI,SAAS;AACX,uBAAO;AAAA,kBACL,SAAS;AAAA,kBACT;AAAA,kBACA,mBAAmB,YAAY;AAAA,gBACjC;AAAA,cACF;AAAA,YACF,QAAQ;AAAA,YAER;AAAA,UACF;AACA,gBAAM,QAAQ;AAAA,QAChB;AAAA,MACF;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AACd,QAAI,QAAQ,WAAW,sBAAsB,KAAK,GAAG;AACnD,YAAM;AAAA,IACR;AAGA,QAAI,kBAAkB,iBAAiB,SAAS,qBAAqB,KAAK,MAAM,OAAO,GAAG;AACxF,gBAAU,KAAK;AAAA,QACb,MAAM;AAAA,QACN,SAAS,0BAA0B,QAAQ,0CAA0C,cAAc;AAAA,QACnG,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MACpC,CAAC;AAED,aAAO;AAAA,QACL,mBAAmB;AAAA,UACjB,QAAQ;AAAA,UACR,SAAS;AAAA,UACT,eAAe,cAAc;AAAA,QAC/B;AAAA,MACF;AAAA,IACF;AACA,QAAI,sBAAsB,KAAK,GAAG;AAChC,YAAM;AAAA,IACR;AAMA,UAAM,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACjE,QAAI,CAAC,kBAAkB,gCAAgC,KAAK,GAAG,GAAG;AAChE,gBAAU,KAAK;AAAA,QACb,MAAM;AAAA,QACN,SAAS,uDAAuD,QAAQ;AAAA,QACxE,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MACpC,CAAC;AACD,aAAQ,MAAM,OAAO;AAAA,QACnB,EAAE,MAAM,UAAU,WAAW,KAAK;AAAA,QAClC;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,UAAM;AAAA,EACR;AAGA,MAAI,gBAAgB;AAClB,WAAO;AAAA,MACL,mBAAmB;AAAA,QACjB,QAAQ;AAAA,QACR,SAAS;AAAA,QACT,eAAe,cAAc;AAAA,MAC/B;AAAA,IACF;AAAA,EACF;AAEA,QAAM,IAAI,MAAM,iCAAiC,QAAQ,+BAA+B;AAC1F;AAcA,eAAsB,iBACpB,UACA,QACA,WACA,YAA6B,CAAC,GAC9B,UACmB;AACnB,iBAAe,MAAM;AACrB,QAAM,cAAc,iBAAiB,SAAS;AAE9C,SAAO,qBAAqB,UAAU,WAAW,aAAa,WAAW,aAAa,MAAM,IAAI,OAAM,WAAU;AAC9G,UAAM,SAAS,MAAM,OAAO,aAAa,MAAM,QAAQ,MAAM;AAC7D,cAAU,KAAK;AAAA,MACb,MAAM;AAAA,MACN,SAAS,sBAAsB,MAAM,WAAM,OAAO,MAAM;AAAA,MACxD,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IACpC,CAAC;AACD,WAAO;AAAA,MACL;AAAA,MAQA;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAKA,eAAsB,iBACpB,UACA,QACA,WACA,YAA6B,CAAC,GACZ;AAClB,iBAAe,MAAM;AACrB,QAAM,cAAc,iBAAiB,SAAS;AAE9C,SAAO,qBAAqB,UAAU,WAAW,aAAa,WAAW,gBAAgB,MAAM,IAAI,OAAM,WAAU;AACjH,UAAM,SAAS,MAAM,OAAO,aAAa,MAAM,cAAc,MAAM;AACnE,cAAU,KAAK;AAAA,MACb,MAAM;AAAA,MACN,SAAS,4BAA4B,MAAM;AAAA,MAC3C,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IACpC,CAAC;AACD,WAAO;AAAA,EACT,CAAC;AACH;AAKA,eAAsB,aACpB,UACA,WACA,YAA6B,CAAC,GAC9B,UAAkC,CAAC,GACd;AACrB,QAAM,cAAc,iBAAiB,SAAS;AAE9C,SAAO;AAAA,IAAsB,QAAQ,WAAW;AAAA,IAAkB,MAChE;AAAA,MACE;AAAA,QACE,SAAS,QAAQ,0BAA0B,WAAW;AAAA,QACtD,UAAU;AAAA,QACV,MAAM;AAAA,QACN,UAAU;AAAA,QACV,GAAG,QAAQ;AAAA,QACX,qBAAqB,QAAQ;AAAA,MAC/B;AAAA,MACA,MACE;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,OAAM,WAAU;AACd,gBAAM,SAAS,MAAM,OAAO,aAAa,MAAM,UAAU;AACzD,oBAAU,KAAK;AAAA,YACb,MAAM;AAAA,YACN,SAAS,iCAAiC,OAAO,MAAM,MAAM;AAAA,YAC7D,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,UACpC,CAAC;AACD,iBAAO,OAAO,MAAM,IAAI,CAAC,SAAc,qBAAqB,IAAI,CAAC;AAAA,QACnE;AAAA,QACA,QAAQ,WAAW;AAAA,QACnB,EAAE,kBAAkB,QAAQ,WAAW,iBAAiB;AAAA,MAC1D;AAAA,IACJ;AAAA,EACF;AACF;AAKA,eAAsB,cACpB,UACA,QACA,WACA,YAA6B,CAAC,GACf;AACf,iBAAe,MAAM;AACrB,QAAM,cAAc,iBAAiB,SAAS;AAE9C,QAAM,qBAAqB,UAAU,WAAW,aAAa,WAAW,gBAAgB,MAAM,IAAI,OAAM,WAAU;AAChH,UAAM,OAAO,aAAa,MAAM,WAAW,MAAM;AACjD,cAAU,KAAK;AAAA,MACb,MAAM;AAAA,MACN,SAAS,yBAAyB,MAAM;AAAA,MACxC,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IACpC,CAAC;AAAA,EACH,CAAC;AACH;","names":["require"]}

package/dist/lib/schemas-data/3.1/a2ui/bound-value.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.2/a2ui/bound-value.json",
+  "$id": "/schemas/3.1.5/a2ui/bound-value.json",
   "title": "A2UI Bound Value",
   "description": "A value that can be a literal or bound to a path in the data model",
   "oneOf": [

package/dist/lib/schemas-data/3.1/a2ui/component.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.2/a2ui/component.json",
+  "$id": "/schemas/3.1.5/a2ui/component.json",
   "title": "A2UI Component",
   "description": "A component in an A2UI surface",
   "type": "object",

package/dist/lib/schemas-data/3.1/a2ui/si-catalog.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.2/a2ui/si-catalog.json",
+  "$id": "/schemas/3.1.5/a2ui/si-catalog.json",
   "title": "SI Component Catalog",
   "description": "A2UI component catalog for Sponsored Intelligence",
   "definitions": {
@@ -9,7 +9,7 @@
       "description": "Text display component",
       "properties": {
         "text": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Text content to display"
         },
         "variant": {
@@ -32,7 +32,7 @@
       "description": "Interactive button component",
       "properties": {
         "label": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Button label text"
         },
         "action": {
@@ -47,7 +47,7 @@
               "type": "object",
               "description": "Context data to include with action",
               "additionalProperties": {
-                "$ref": "/schemas/3.1.2/a2ui/bound-value.json"
+                "$ref": "/schemas/3.1.5/a2ui/bound-value.json"
               }
             }
           },
@@ -65,7 +65,7 @@
           "default": "primary"
         },
         "disabled": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json"
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json"
         }
       },
       "required": [
@@ -78,11 +78,11 @@
       "description": "Hyperlink component",
       "properties": {
         "label": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Link text"
         },
         "url": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "URL to navigate to"
         },
         "external": {
@@ -101,11 +101,11 @@
       "description": "Image display component",
       "properties": {
         "src": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Image source URL"
         },
         "alt": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Alt text for accessibility"
         },
         "width": {
@@ -127,19 +127,19 @@
       "description": "Card container for grouped content",
       "properties": {
         "title": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Card title"
         },
         "subtitle": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Card subtitle"
         },
         "image": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Card image URL"
         },
         "badge": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Badge text (e.g., 'New', 'Sale')"
         },
         "action": {
@@ -152,7 +152,7 @@
             "context": {
               "type": "object",
               "additionalProperties": {
-                "$ref": "/schemas/3.1.2/a2ui/bound-value.json"
+                "$ref": "/schemas/3.1.5/a2ui/bound-value.json"
               }
             }
           },
@@ -177,27 +177,27 @@
       "description": "Product display card (SI-specific)",
       "properties": {
         "title": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Product name"
         },
         "price": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Price display string"
         },
         "image": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Product image URL"
         },
         "description": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Product description"
         },
         "badge": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Badge text (e.g., 'Best Seller')"
         },
         "ctaLabel": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "CTA button label"
         },
         "action": {
@@ -209,7 +209,7 @@
             "context": {
               "type": "object",
               "additionalProperties": {
-                "$ref": "/schemas/3.1.2/a2ui/bound-value.json"
+                "$ref": "/schemas/3.1.5/a2ui/bound-value.json"
               }
             }
           },
@@ -228,7 +228,7 @@
       "description": "Data-bound list component",
       "properties": {
         "items": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Path to array in data model"
         },
         "template": {
@@ -245,7 +245,7 @@
           ]
         },
         "emptyMessage": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Message to show when list is empty"
         },
         "layout": {
@@ -349,11 +349,11 @@
           "description": "Integration type"
         },
         "label": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Button label"
         },
         "url": {
-          "$ref": "/schemas/3.1.2/a2ui/bound-value.json",
+          "$ref": "/schemas/3.1.5/a2ui/bound-value.json",
           "description": "Integration endpoint URL"
         },
         "highlighted": {

package/dist/lib/schemas-data/3.1/a2ui/surface.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.2/a2ui/surface.json",
+  "$id": "/schemas/3.1.5/a2ui/surface.json",
   "title": "A2UI Surface",
   "description": "A contiguous UI region containing components",
   "type": "object",
@@ -18,7 +18,7 @@
       "type": "array",
       "description": "Flat list of components (adjacency list structure)",
       "items": {
-        "$ref": "/schemas/3.1.2/a2ui/component.json"
+        "$ref": "/schemas/3.1.5/a2ui/component.json"
       }
     },
     "rootId": {

package/dist/lib/schemas-data/3.1/a2ui/user-action.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/3.1.2/a2ui/user-action.json",
+  "$id": "/schemas/3.1.5/a2ui/user-action.json",
   "title": "A2UI User Action",
   "description": "User interaction event sent from client to agent",
   "type": "object",