@ai-sdk/mcp 2.0.68 → 2.0.70

package/dist/mcp-stdio/index.js

@@ -19,6 +19,7 @@ const RequestSchema = z.object({
 /** @see https://modelcontextprotocol.io/specification/2025-06-18/client/elicitation */
 const ElicitationCapabilitySchema = z.object({ applyDefaults: z.optional(z.boolean()) }).loose();
 const ServerCapabilitiesSchema = z.looseObject({
+	events: z.looseObject({ listChanged: z.boolean().nullish() }).nullish(),
 	experimental: z.optional(z.object({}).loose()),
 	logging: z.optional(z.object({}).loose()),
 	completions: z.optional(z.object({}).loose()),

package/dist/mcp-stdio/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/tool/types.ts","../../src/tool/json-rpc-message.ts","../../src/error/mcp-client-error.ts","../../src/tool/mcp-stdio/get-environment.ts","../../src/tool/mcp-stdio/create-child-process.ts","../../src/tool/mcp-stdio/mcp-stdio-transport.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport type { JSONObject } from '@ai-sdk/provider';\nimport type { FlexibleSchema, Tool } from '@ai-sdk/provider-utils';\n\nexport const LATEST_PROTOCOL_VERSION = '2026-07-28';\nexport const LATEST_LEGACY_PROTOCOL_VERSION = '2025-11-25';\nexport const SUPPORTED_PROTOCOL_VERSIONS = [\n  LATEST_PROTOCOL_VERSION,\n  LATEST_LEGACY_PROTOCOL_VERSION,\n  '2025-06-18',\n  '2025-03-26',\n  '2024-11-05',\n];\n\nexport type McpProviderMetadata = {\n  clientName?: string;\n  title?: string;\n  toolName?: string;\n  annotations?: McpToolAnnotations;\n  app?: JSONObject;\n};\n\n/**\n * Behavioral hints reported by an MCP server for a tool.\n *\n * These annotations are untrusted unless the server itself is trusted.\n *\n * @see https://modelcontextprotocol.io/specification/2026-07-28/schema#toolannotations\n */\nexport type McpToolAnnotations = {\n  title?: string;\n  readOnlyHint?: boolean;\n  destructiveHint?: boolean;\n  idempotentHint?: boolean;\n  openWorldHint?: boolean;\n};\n\n/** MCP tool metadata - keys should follow MCP _meta key format specification */\nconst ToolMetaSchema = z.optional(z.record(z.string(), z.unknown()));\nexport type ToolMeta = z.infer<typeof ToolMetaSchema>;\n\nexport type ToolSchemas =\n  | Record<\n      string,\n      {\n        inputSchema: FlexibleSchema<JSONObject | unknown>;\n        outputSchema?: FlexibleSchema<JSONObject | unknown>;\n      }\n    >\n  | 'automatic'\n  | undefined;\n\n/** Base MCP tool type with execute and _meta */\ntype McpToolBase<INPUT = unknown, OUTPUT = CallToolResult> = Tool<\n  INPUT,\n  OUTPUT\n> &\n  Required<Pick<Tool<INPUT, OUTPUT>, 'execute'>> & {\n    _meta?: ToolMeta;\n  };\n\nexport type McpToolSet<TOOL_SCHEMAS extends ToolSchemas = 'automatic'> =\n  TOOL_SCHEMAS extends Record<\n    string,\n    { inputSchema: FlexibleSchema<any>; outputSchema?: FlexibleSchema<any> }\n  >\n    ? {\n        [K in keyof TOOL_SCHEMAS]: TOOL_SCHEMAS[K] extends {\n          inputSchema: FlexibleSchema<infer INPUT>;\n          outputSchema: FlexibleSchema<infer OUTPUT>;\n        }\n          ? McpToolBase<INPUT, OUTPUT>\n          : TOOL_SCHEMAS[K] extends {\n                inputSchema: FlexibleSchema<infer INPUT>;\n              }\n            ? McpToolBase<INPUT, CallToolResult>\n            : never;\n      }\n    : Record<string, McpToolBase<unknown, CallToolResult>>;\n\nconst ClientOrServerImplementationSchema = z.looseObject({\n  name: z.string(),\n  version: z.string(),\n  title: z.optional(z.string()),\n});\n\n// Maps to `Implementation` in the MCP specification\nexport type Configuration = z.infer<typeof ClientOrServerImplementationSchema>;\n\nexport const BaseParamsSchema = z.looseObject({\n  _meta: z.optional(z.object({}).loose()),\n});\ntype BaseParams = z.infer<typeof BaseParamsSchema>;\nexport const ResultSchema = BaseParamsSchema.extend({\n  resultType: z.optional(z.string()),\n});\n\nexport const RequestSchema = z.object({\n  method: z.string(),\n  params: z.optional(BaseParamsSchema),\n});\nexport type Request = z.infer<typeof RequestSchema>;\nexport type RequestOptions = {\n  signal?: AbortSignal;\n  timeout?: number;\n  maxTotalTimeout?: number;\n};\n\nexport type Notification = z.infer<typeof RequestSchema>;\n\n/** @see https://modelcontextprotocol.io/specification/2025-06-18/client/elicitation */\nconst ElicitationCapabilitySchema = z\n  .object({\n    applyDefaults: z.optional(z.boolean()),\n  })\n  .loose();\n\nconst ServerCapabilitiesSchema = z.looseObject({\n  experimental: z.optional(z.object({}).loose()),\n  logging: z.optional(z.object({}).loose()),\n  completions: z.optional(z.object({}).loose()),\n  prompts: z.optional(\n    z.looseObject({\n      listChanged: z.optional(z.boolean()),\n    }),\n  ),\n  resources: z.optional(\n    z.looseObject({\n      subscribe: z.optional(z.boolean()),\n      listChanged: z.optional(z.boolean()),\n    }),\n  ),\n  tools: z.optional(\n    z.looseObject({\n      listChanged: z.optional(z.boolean()),\n    }),\n  ),\n  elicitation: z.optional(ElicitationCapabilitySchema),\n});\n\nexport type ServerCapabilities = z.infer<typeof ServerCapabilitiesSchema>;\nexport const ClientCapabilitiesSchema = z\n  .object({\n    elicitation: z.optional(ElicitationCapabilitySchema),\n  })\n  .loose();\n\nexport type ClientCapabilities = z.infer<typeof ClientCapabilitiesSchema>;\nexport type ElicitationCapability = z.infer<typeof ElicitationCapabilitySchema>;\n\nexport const DiscoverResultSchema = ResultSchema.extend({\n  supportedVersions: z.array(z.string()),\n  capabilities: ServerCapabilitiesSchema,\n  instructions: z.optional(z.string()),\n  ttlMs: z.optional(z.number()),\n  cacheScope: z.optional(z.union([z.literal('public'), z.literal('private')])),\n});\nexport type DiscoverResult = z.infer<typeof DiscoverResultSchema>;\n\nexport const InitializeResultSchema = ResultSchema.extend({\n  protocolVersion: z.string(),\n  capabilities: ServerCapabilitiesSchema,\n  serverInfo: ClientOrServerImplementationSchema,\n  instructions: z.optional(z.string()),\n});\nexport type InitializeResult = z.infer<typeof InitializeResultSchema>;\n\nexport type PaginatedRequest = Request & {\n  params?: BaseParams & {\n    cursor?: string;\n  };\n};\n\nconst PaginatedResultSchema = ResultSchema.extend({\n  nextCursor: z.optional(z.string()),\n});\n\nconst ToolSchema = z\n  .object({\n    name: z.string(),\n    /**\n     * @see https://modelcontextprotocol.io/specification/2025-11-25/server/tools#tool\n     */\n    title: z.optional(z.string()),\n    description: z.optional(z.string()),\n    inputSchema: z.looseObject({\n      type: z.optional(z.unknown()),\n      properties: z.optional(z.object({}).loose()),\n    }),\n    /**\n     * @see https://modelcontextprotocol.io/specification/2025-06-18/server/tools#output-schema\n     */\n    outputSchema: z.optional(z.object({}).loose()),\n    annotations: z.optional(\n      z\n        .object({\n          title: z.optional(z.string()),\n          readOnlyHint: z.optional(z.boolean()),\n          destructiveHint: z.optional(z.boolean()),\n          idempotentHint: z.optional(z.boolean()),\n          openWorldHint: z.optional(z.boolean()),\n        })\n        .loose(),\n    ),\n    _meta: ToolMetaSchema,\n  })\n  .loose();\nexport type MCPTool = z.infer<typeof ToolSchema>;\nexport const ListToolsResultSchema = PaginatedResultSchema.extend({\n  tools: z.array(ToolSchema),\n});\nexport type ListToolsResult = z.infer<typeof ListToolsResultSchema>;\n\nconst TextContentSchema = z\n  .object({\n    type: z.literal('text'),\n    text: z.string(),\n  })\n  .loose();\nconst ImageContentSchema = z\n  .object({\n    type: z.literal('image'),\n    data: z.base64(),\n    mimeType: z.string(),\n  })\n  .loose();\nexport const ResourceSchema = z\n  .object({\n    uri: z.string(),\n    name: z.string(),\n    title: z.optional(z.string()),\n    description: z.optional(z.string()),\n    mimeType: z.optional(z.string()),\n    size: z.optional(z.number()),\n  })\n  .loose();\nexport type MCPResource = z.infer<typeof ResourceSchema>;\n\nexport const ListResourcesResultSchema = PaginatedResultSchema.extend({\n  resources: z.array(ResourceSchema),\n});\nexport type ListResourcesResult = z.infer<typeof ListResourcesResultSchema>;\n\nconst ResourceContentsSchema = z\n  .object({\n    /**\n     * The URI of this resource.\n     */\n    uri: z.string(),\n    /**\n     * Optional display name of the resource content.\n     */\n    name: z.optional(z.string()),\n    /**\n     * Optional human readable title.\n     */\n    title: z.optional(z.string()),\n    /**\n     * The MIME type of this resource, if known.\n     */\n    mimeType: z.optional(z.string()),\n  })\n  .loose();\nconst TextResourceContentsSchema = ResourceContentsSchema.extend({\n  text: z.string(),\n});\nconst BlobResourceContentsSchema = ResourceContentsSchema.extend({\n  blob: z.base64(),\n});\nconst EmbeddedResourceSchema = z\n  .object({\n    type: z.literal('resource'),\n    resource: z.union([TextResourceContentsSchema, BlobResourceContentsSchema]),\n  })\n  .loose();\nconst ResourceLinkContentSchema = z\n  .object({\n    type: z.literal('resource_link'),\n    uri: z.string(),\n    name: z.string(),\n    description: z.optional(z.string()),\n    mimeType: z.optional(z.string()),\n  })\n  .loose();\nconst UnknownContentSchema = z\n  .object({ type: z.string() })\n  .loose()\n  .refine(\n    content =>\n      !['text', 'image', 'resource', 'resource_link'].includes(content.type),\n    { message: 'Known content types must match their schema' },\n  );\n\nconst CallToolResultWithContentSchema = ResultSchema.extend({\n  content: z.array(\n    z.union([\n      TextContentSchema,\n      ImageContentSchema,\n      EmbeddedResourceSchema,\n      ResourceLinkContentSchema,\n      UnknownContentSchema,\n    ]),\n  ),\n  /**\n   * @see https://modelcontextprotocol.io/specification/2026-07-28/server/tools#structured-content\n   */\n  structuredContent: z.optional(z.unknown()),\n  isError: z.boolean().default(false).optional(),\n});\n\nconst CallToolResultWithStructuredContentSchema = ResultSchema.extend({\n  content: z.never().optional(),\n  structuredContent: z.json(),\n  isError: z.boolean().default(false).optional(),\n})\n  .transform(\n    (result): z.infer<typeof CallToolResultWithContentSchema> => ({\n      ...result,\n      content: [\n        {\n          type: 'text',\n          text: JSON.stringify(result.structuredContent),\n        },\n      ],\n    }),\n  )\n  .pipe(CallToolResultWithContentSchema);\n\nexport const CallToolResultSchema = CallToolResultWithContentSchema.or(\n  CallToolResultWithStructuredContentSchema,\n).or(\n  ResultSchema.extend({\n    toolResult: z.unknown().nonoptional(),\n  }),\n);\nexport type CallToolResult = z.infer<typeof CallToolResultSchema>;\n\nconst ResourceTemplateSchema = z\n  .object({\n    uriTemplate: z.string(),\n    name: z.string(),\n    title: z.optional(z.string()),\n    description: z.optional(z.string()),\n    mimeType: z.optional(z.string()),\n  })\n  .loose();\n\nexport const ListResourceTemplatesResultSchema = ResultSchema.extend({\n  resourceTemplates: z.array(ResourceTemplateSchema),\n});\nexport type ListResourceTemplatesResult = z.infer<\n  typeof ListResourceTemplatesResultSchema\n>;\n\nexport const ReadResourceResultSchema = ResultSchema.extend({\n  contents: z.array(\n    z.union([TextResourceContentsSchema, BlobResourceContentsSchema]),\n  ),\n});\nexport type ReadResourceResult = z.infer<typeof ReadResourceResultSchema>;\n\n// Completions\nconst PromptReferenceSchema = z\n  .object({\n    type: z.literal('ref/prompt'),\n    name: z.string(),\n  })\n  .loose();\n\nconst ResourceReferenceSchema = z\n  .object({\n    type: z.literal('ref/resource'),\n    uri: z.string(),\n  })\n  .loose();\n\nconst CompletionArgumentSchema = z\n  .object({\n    name: z.string(),\n    value: z.string(),\n  })\n  .loose();\n\nexport const CompleteRequestParamsSchema = BaseParamsSchema.extend({\n  ref: z.union([PromptReferenceSchema, ResourceReferenceSchema]),\n  argument: CompletionArgumentSchema,\n  context: z.optional(\n    z\n      .object({\n        arguments: z.record(z.string(), z.string()),\n      })\n      .loose(),\n  ),\n});\nexport type CompleteRequestParams = z.infer<typeof CompleteRequestParamsSchema>;\n\nexport const CompleteResultSchema = ResultSchema.extend({\n  completion: z\n    .object({\n      values: z.array(z.string()).max(100),\n      total: z.optional(z.number().int()),\n      hasMore: z.optional(z.boolean()),\n    })\n    .loose(),\n});\nexport type CompleteResult = z.infer<typeof CompleteResultSchema>;\n\n// Prompts\nconst PromptArgumentSchema = z\n  .object({\n    name: z.string(),\n    description: z.optional(z.string()),\n    required: z.optional(z.boolean()),\n  })\n  .loose();\n\nexport const PromptSchema = z\n  .object({\n    name: z.string(),\n    title: z.optional(z.string()),\n    description: z.optional(z.string()),\n    arguments: z.optional(z.array(PromptArgumentSchema)),\n  })\n  .loose();\nexport type MCPPrompt = z.infer<typeof PromptSchema>;\n\nexport const ListPromptsResultSchema = PaginatedResultSchema.extend({\n  prompts: z.array(PromptSchema),\n});\nexport type ListPromptsResult = z.infer<typeof ListPromptsResultSchema>;\n\nconst PromptMessageSchema = z\n  .object({\n    role: z.union([z.literal('user'), z.literal('assistant')]),\n    content: z.union([\n      TextContentSchema,\n      ImageContentSchema,\n      EmbeddedResourceSchema,\n      ResourceLinkContentSchema,\n    ]),\n  })\n  .loose();\nexport type MCPPromptMessage = z.infer<typeof PromptMessageSchema>;\n\nexport const GetPromptResultSchema = ResultSchema.extend({\n  description: z.optional(z.string()),\n  messages: z.array(PromptMessageSchema),\n});\nexport type GetPromptResult = z.infer<typeof GetPromptResultSchema>;\n\nconst ElicitationRequestParamsSchema = BaseParamsSchema.extend({\n  message: z.string(),\n  requestedSchema: z.unknown(),\n});\n\nexport const ElicitationRequestSchema = RequestSchema.extend({\n  method: z.literal('elicitation/create'),\n  params: ElicitationRequestParamsSchema,\n});\n\nexport type ElicitationRequest = z.infer<typeof ElicitationRequestSchema>;\n\nexport const ElicitResultSchema = ResultSchema.extend({\n  action: z.union([\n    z.literal('accept'),\n    z.literal('decline'),\n    z.literal('cancel'),\n  ]),\n  content: z.optional(z.record(z.string(), z.unknown())),\n});\n\nexport type ElicitResult = z.infer<typeof ElicitResultSchema>;\n","import { parseJSON } from '@ai-sdk/provider-utils';\nimport { z } from 'zod/v4';\nimport { BaseParamsSchema, RequestSchema, ResultSchema } from './types';\n\nconst JSONRPC_VERSION = '2.0';\n\nconst JSONRPCRequestSchema = z\n  .object({\n    jsonrpc: z.literal(JSONRPC_VERSION),\n    id: z.union([z.string(), z.number().int()]),\n  })\n  .merge(RequestSchema)\n  .strict();\n\nexport type JSONRPCRequest = z.infer<typeof JSONRPCRequestSchema>;\n\nconst JSONRPCResponseSchema = z\n  .object({\n    jsonrpc: z.literal(JSONRPC_VERSION),\n    id: z.union([z.string(), z.number().int()]),\n    result: ResultSchema,\n  })\n  .strict();\n\nexport type JSONRPCResponse = z.infer<typeof JSONRPCResponseSchema>;\n\nconst JSONRPCErrorSchema = z\n  .object({\n    jsonrpc: z.literal(JSONRPC_VERSION),\n    id: z.optional(z.union([z.string(), z.number().int()])),\n    error: z.object({\n      code: z.number().int(),\n      message: z.string(),\n      data: z.optional(z.unknown()),\n    }),\n  })\n  .strict();\n\nexport type JSONRPCError = z.infer<typeof JSONRPCErrorSchema>;\n\nconst JSONRPCNotificationSchema = z\n  .object({\n    jsonrpc: z.literal(JSONRPC_VERSION),\n  })\n  .merge(\n    z.object({\n      method: z.string(),\n      params: z.optional(BaseParamsSchema),\n    }),\n  )\n  .strict();\n\nexport type JSONRPCNotification = z.infer<typeof JSONRPCNotificationSchema>;\n\nexport const JSONRPCMessageSchema = z.union([\n  JSONRPCRequestSchema,\n  JSONRPCNotificationSchema,\n  JSONRPCResponseSchema,\n  JSONRPCErrorSchema,\n]);\n\nexport type JSONRPCMessage = z.infer<typeof JSONRPCMessageSchema>;\n\nexport function validateJSONRPCMessage(message: unknown): JSONRPCMessage {\n  return JSONRPCMessageSchema.parse(message);\n}\n\nexport async function parseJSONRPCMessage(\n  text: string,\n): Promise<JSONRPCMessage> {\n  return validateJSONRPCMessage(await parseJSON({ text }));\n}\n","import { AISDKError } from '@ai-sdk/provider';\n\nconst name = 'AI_MCPClientError';\nconst marker = `vercel.ai.error.${name}`;\nconst symbol = Symbol.for(marker);\n\n/**\n * An error occurred with the MCP client.\n */\nexport class MCPClientError extends AISDKError {\n  private readonly [symbol] = true;\n  readonly data?: unknown;\n\n  /**\n   * JSON-RPC error code from the server response, per the JSON-RPC 2.0\n   * spec (e.g. `-32601` method-not-found, `-32602` invalid-params, or\n   * MCP-specific codes such as `-32002` resource-not-found). This is the\n   * application-level error code populated from `error.code` in the\n   * server's JSON-RPC error payload. Distinct from `statusCode`, which\n   * is the HTTP transport status.\n   */\n  readonly code?: number;\n\n  /**\n   * HTTP status code from the failed response, when the error originated\n   * from an HTTP-based transport. Undefined for stdio transport\n   * errors and for failures that do not have an associated response\n   * status (e.g. network errors, abort). Distinct from `code`, which is\n   * the JSON-RPC application error code.\n   */\n  readonly statusCode?: number;\n\n  /**\n   * URL of the MCP endpoint the failing request was sent to, when the\n   * error originated from an HTTP transport failure.\n   */\n  readonly url?: string;\n\n  /**\n   * Body of the failing HTTP response, decoded as text, when available.\n   * Undefined when the body could not be read or the error did not have\n   * an associated response.\n   */\n  readonly responseBody?: string;\n\n  constructor({\n    name = 'MCPClientError',\n    message,\n    cause,\n    data,\n    code,\n    statusCode,\n    url,\n    responseBody,\n  }: {\n    name?: string;\n    message: string;\n    cause?: unknown;\n    data?: unknown;\n    code?: number;\n    statusCode?: number;\n    url?: string;\n    responseBody?: string;\n  }) {\n    super({ name, message, cause });\n    this.data = data;\n    this.code = code;\n    this.statusCode = statusCode;\n    this.url = url;\n    this.responseBody = responseBody;\n  }\n\n  static isInstance(error: unknown): error is MCPClientError {\n    return AISDKError.hasMarker(error, marker);\n  }\n}\n","/**\n * Constructs the environment variables for the child process.\n *\n * @param customEnv - Custom environment variables to merge with default environment variables.\n * @returns The environment variables for the child process.\n */\nexport function getEnvironment(\n  customEnv?: Record<string, string>,\n): Record<string, string> {\n  const isWindows = globalThis.process.platform === 'win32';\n  const DEFAULT_INHERITED_ENV_VARS = isWindows\n    ? [\n        'APPDATA',\n        'HOMEDRIVE',\n        'HOMEPATH',\n        'LOCALAPPDATA',\n        'PATH',\n        'PROCESSOR_ARCHITECTURE',\n        'SYSTEMDRIVE',\n        'SYSTEMROOT',\n        'TEMP',\n        'USERNAME',\n        'USERPROFILE',\n      ]\n    : ['HOME', 'LOGNAME', 'PATH', 'SHELL', 'TERM', 'USER'];\n\n  const env: Record<string, string> = customEnv ? { ...customEnv } : {};\n  const customEnvKeys = new Set(\n    Object.keys(env).map(key => (isWindows ? key.toUpperCase() : key)),\n  );\n\n  for (const key of DEFAULT_INHERITED_ENV_VARS) {\n    if (customEnvKeys.has(key)) {\n      continue;\n    }\n\n    const value = globalThis.process.env[key];\n    if (value === undefined) {\n      continue;\n    }\n\n    if (value.startsWith('()')) {\n      continue;\n    }\n\n    env[key] = value;\n  }\n\n  return env;\n}\n","import type { ChildProcess } from 'node:child_process';\nimport spawn from 'cross-spawn';\nimport { getEnvironment } from './get-environment';\nimport type { StdioConfig } from './mcp-stdio-transport';\n\nexport function createChildProcess(\n  config: StdioConfig,\n  signal: AbortSignal,\n): ChildProcess {\n  if (\n    globalThis.process.platform === 'win32' &&\n    [config.command, ...(config.args ?? [])].some(value => /[\\r\\n]/.test(value))\n  ) {\n    throw new TypeError(\n      'Stdio MCP commands and arguments must not contain line breaks on Windows.',\n    );\n  }\n\n  return spawn(config.command, config.args ?? [], {\n    env: getEnvironment(config.env),\n    stdio: ['pipe', 'pipe', config.stderr ?? 'inherit'],\n    shell: false,\n    signal,\n    windowsHide: globalThis.process.platform === 'win32' && isElectron(),\n    cwd: config.cwd,\n  });\n}\n\nfunction isElectron() {\n  return 'type' in globalThis.process;\n}\n","import type { ChildProcess, IOType } from 'node:child_process';\nimport type { Stream } from 'node:stream';\nimport { parseJSONRPCMessage, type JSONRPCMessage } from '../json-rpc-message';\nimport type { MCPTransport } from '../mcp-transport';\nimport { MCPClientError } from '../../error/mcp-client-error';\nimport { createChildProcess } from './create-child-process';\n\nexport interface StdioConfig {\n  command: string;\n  args?: string[];\n  env?: Record<string, string>;\n  stderr?: IOType | Stream | number;\n  cwd?: string;\n}\n\nexport class StdioMCPTransport implements MCPTransport {\n  readonly supportsProtocolVersionDiscovery = true;\n  private process?: ChildProcess;\n  private abortController: AbortController = new AbortController();\n  private readBuffer: ReadBuffer = new ReadBuffer();\n  private serverParams: StdioConfig;\n\n  onclose?: () => void;\n  onerror?: (error: unknown) => void;\n  onmessage?: (message: JSONRPCMessage) => void;\n\n  constructor(server: StdioConfig) {\n    this.serverParams = server;\n  }\n\n  async start(): Promise<void> {\n    if (this.process) {\n      throw new MCPClientError({\n        message: 'StdioMCPTransport already started.',\n      });\n    }\n\n    return new Promise((resolve, reject) => {\n      try {\n        const process = createChildProcess(\n          this.serverParams,\n          this.abortController.signal,\n        );\n\n        this.process = process;\n\n        this.process.on('error', error => {\n          if (error.name === 'AbortError') {\n            this.onclose?.();\n            return;\n          }\n\n          reject(error);\n          this.onerror?.(error);\n        });\n\n        this.process.on('spawn', () => {\n          resolve();\n        });\n\n        this.process.on('close', _code => {\n          this.process = undefined;\n          this.onclose?.();\n        });\n\n        this.process.stdin?.on('error', error => {\n          this.onerror?.(error);\n        });\n\n        this.process.stdout?.on('data', chunk => {\n          this.readBuffer.append(chunk);\n          void this.processReadBuffer();\n        });\n\n        this.process.stdout?.on('error', error => {\n          this.onerror?.(error);\n        });\n      } catch (error) {\n        reject(error);\n        this.onerror?.(error);\n      }\n    });\n  }\n\n  private async processReadBuffer() {\n    while (true) {\n      const line = this.readBuffer.readLine();\n      if (line === null) {\n        break;\n      }\n\n      try {\n        const message = await deserializeMessage(line);\n        this.onmessage?.(message);\n      } catch (error) {\n        this.onerror?.(error as Error);\n      }\n    }\n  }\n\n  async close(): Promise<void> {\n    this.abortController.abort();\n    this.process = undefined;\n    this.readBuffer.clear();\n  }\n\n  send(message: JSONRPCMessage): Promise<void> {\n    return new Promise(resolve => {\n      if (!this.process?.stdin) {\n        throw new MCPClientError({\n          message: 'StdioClientTransport not connected',\n        });\n      }\n\n      const json = serializeMessage(message);\n      if (this.process.stdin.write(json)) {\n        resolve();\n      } else {\n        this.process.stdin.once('drain', resolve);\n      }\n    });\n  }\n}\n\nclass ReadBuffer {\n  private buffer?: Buffer;\n\n  append(chunk: Buffer): void {\n    this.buffer = this.buffer ? Buffer.concat([this.buffer, chunk]) : chunk;\n  }\n\n  readLine(): string | null {\n    if (!this.buffer) return null;\n\n    const index = this.buffer.indexOf('\\n');\n    if (index === -1) {\n      return null;\n    }\n\n    const line = this.buffer.toString('utf8', 0, index);\n    this.buffer = this.buffer.subarray(index + 1);\n    return line;\n  }\n\n  clear(): void {\n    this.buffer = undefined;\n  }\n}\n\nfunction serializeMessage(message: JSONRPCMessage): string {\n  return JSON.stringify(message) + '\\n';\n}\n\nexport async function deserializeMessage(\n  line: string,\n): Promise<JSONRPCMessage> {\n  return parseJSONRPCMessage(line);\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/tool/types.ts","../../src/tool/json-rpc-message.ts","../../src/error/mcp-client-error.ts","../../src/tool/mcp-stdio/get-environment.ts","../../src/tool/mcp-stdio/create-child-process.ts","../../src/tool/mcp-stdio/mcp-stdio-transport.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport type { JSONObject } from '@ai-sdk/provider';\nimport type { FlexibleSchema, Tool } from '@ai-sdk/provider-utils';\n\nexport const LATEST_PROTOCOL_VERSION = '2026-07-28';\nexport const LATEST_LEGACY_PROTOCOL_VERSION = '2025-11-25';\nexport const SUPPORTED_PROTOCOL_VERSIONS = [\n  LATEST_PROTOCOL_VERSION,\n  LATEST_LEGACY_PROTOCOL_VERSION,\n  '2025-06-18',\n  '2025-03-26',\n  '2024-11-05',\n];\n\nexport type McpProviderMetadata = {\n  clientName?: string;\n  title?: string;\n  toolName?: string;\n  annotations?: McpToolAnnotations;\n  app?: JSONObject;\n};\n\n/**\n * Behavioral hints reported by an MCP server for a tool.\n *\n * These annotations are untrusted unless the server itself is trusted.\n *\n * @see https://modelcontextprotocol.io/specification/2026-07-28/schema#toolannotations\n */\nexport type McpToolAnnotations = {\n  title?: string;\n  readOnlyHint?: boolean;\n  destructiveHint?: boolean;\n  idempotentHint?: boolean;\n  openWorldHint?: boolean;\n};\n\n/** MCP tool metadata - keys should follow MCP _meta key format specification */\nconst ToolMetaSchema = z.optional(z.record(z.string(), z.unknown()));\nexport type ToolMeta = z.infer<typeof ToolMetaSchema>;\n\nexport type ToolSchemas =\n  | Record<\n      string,\n      {\n        inputSchema: FlexibleSchema<JSONObject | unknown>;\n        outputSchema?: FlexibleSchema<JSONObject | unknown>;\n      }\n    >\n  | 'automatic'\n  | undefined;\n\n/** Base MCP tool type with execute and _meta */\ntype McpToolBase<INPUT = unknown, OUTPUT = CallToolResult> = Tool<\n  INPUT,\n  OUTPUT\n> &\n  Required<Pick<Tool<INPUT, OUTPUT>, 'execute'>> & {\n    _meta?: ToolMeta;\n  };\n\nexport type McpToolSet<TOOL_SCHEMAS extends ToolSchemas = 'automatic'> =\n  TOOL_SCHEMAS extends Record<\n    string,\n    { inputSchema: FlexibleSchema<any>; outputSchema?: FlexibleSchema<any> }\n  >\n    ? {\n        [K in keyof TOOL_SCHEMAS]: TOOL_SCHEMAS[K] extends {\n          inputSchema: FlexibleSchema<infer INPUT>;\n          outputSchema: FlexibleSchema<infer OUTPUT>;\n        }\n          ? McpToolBase<INPUT, OUTPUT>\n          : TOOL_SCHEMAS[K] extends {\n                inputSchema: FlexibleSchema<infer INPUT>;\n              }\n            ? McpToolBase<INPUT, CallToolResult>\n            : never;\n      }\n    : Record<string, McpToolBase<unknown, CallToolResult>>;\n\nconst ClientOrServerImplementationSchema = z.looseObject({\n  name: z.string(),\n  version: z.string(),\n  title: z.optional(z.string()),\n});\n\n// Maps to `Implementation` in the MCP specification\nexport type Configuration = z.infer<typeof ClientOrServerImplementationSchema>;\n\nexport const BaseParamsSchema = z.looseObject({\n  _meta: z.optional(z.object({}).loose()),\n});\ntype BaseParams = z.infer<typeof BaseParamsSchema>;\nexport const ResultSchema = BaseParamsSchema.extend({\n  resultType: z.optional(z.string()),\n});\n\nexport const RequestSchema = z.object({\n  method: z.string(),\n  params: z.optional(BaseParamsSchema),\n});\nexport type Request = z.infer<typeof RequestSchema>;\nexport type RequestOptions = {\n  signal?: AbortSignal;\n  timeout?: number;\n  maxTotalTimeout?: number;\n};\n\nexport type Notification = z.infer<typeof RequestSchema>;\n\n/** @see https://modelcontextprotocol.io/specification/2025-06-18/client/elicitation */\nconst ElicitationCapabilitySchema = z\n  .object({\n    applyDefaults: z.optional(z.boolean()),\n  })\n  .loose();\n\nconst ServerCapabilitiesSchema = z.looseObject({\n  events: z.looseObject({ listChanged: z.boolean().nullish() }).nullish(),\n  experimental: z.optional(z.object({}).loose()),\n  logging: z.optional(z.object({}).loose()),\n  completions: z.optional(z.object({}).loose()),\n  prompts: z.optional(\n    z.looseObject({\n      listChanged: z.optional(z.boolean()),\n    }),\n  ),\n  resources: z.optional(\n    z.looseObject({\n      subscribe: z.optional(z.boolean()),\n      listChanged: z.optional(z.boolean()),\n    }),\n  ),\n  tools: z.optional(\n    z.looseObject({\n      listChanged: z.optional(z.boolean()),\n    }),\n  ),\n  elicitation: z.optional(ElicitationCapabilitySchema),\n});\n\nexport type ServerCapabilities = z.infer<typeof ServerCapabilitiesSchema>;\nexport const ClientCapabilitiesSchema = z\n  .object({\n    elicitation: z.optional(ElicitationCapabilitySchema),\n  })\n  .loose();\n\nexport type ClientCapabilities = z.infer<typeof ClientCapabilitiesSchema>;\nexport type ElicitationCapability = z.infer<typeof ElicitationCapabilitySchema>;\n\nexport const DiscoverResultSchema = ResultSchema.extend({\n  supportedVersions: z.array(z.string()),\n  capabilities: ServerCapabilitiesSchema,\n  instructions: z.optional(z.string()),\n  ttlMs: z.optional(z.number()),\n  cacheScope: z.optional(z.union([z.literal('public'), z.literal('private')])),\n});\nexport type DiscoverResult = z.infer<typeof DiscoverResultSchema>;\n\nexport const InitializeResultSchema = ResultSchema.extend({\n  protocolVersion: z.string(),\n  capabilities: ServerCapabilitiesSchema,\n  serverInfo: ClientOrServerImplementationSchema,\n  instructions: z.optional(z.string()),\n});\nexport type InitializeResult = z.infer<typeof InitializeResultSchema>;\n\nexport type PaginatedRequest = Request & {\n  params?: BaseParams & {\n    cursor?: string;\n  };\n};\n\nconst PaginatedResultSchema = ResultSchema.extend({\n  nextCursor: z.optional(z.string()),\n});\n\nconst ToolSchema = z\n  .object({\n    name: z.string(),\n    /**\n     * @see https://modelcontextprotocol.io/specification/2025-11-25/server/tools#tool\n     */\n    title: z.optional(z.string()),\n    description: z.optional(z.string()),\n    inputSchema: z.looseObject({\n      type: z.optional(z.unknown()),\n      properties: z.optional(z.object({}).loose()),\n    }),\n    /**\n     * @see https://modelcontextprotocol.io/specification/2025-06-18/server/tools#output-schema\n     */\n    outputSchema: z.optional(z.object({}).loose()),\n    annotations: z.optional(\n      z\n        .object({\n          title: z.optional(z.string()),\n          readOnlyHint: z.optional(z.boolean()),\n          destructiveHint: z.optional(z.boolean()),\n          idempotentHint: z.optional(z.boolean()),\n          openWorldHint: z.optional(z.boolean()),\n        })\n        .loose(),\n    ),\n    _meta: ToolMetaSchema,\n  })\n  .loose();\nexport type MCPTool = z.infer<typeof ToolSchema>;\nexport const ListToolsResultSchema = PaginatedResultSchema.extend({\n  tools: z.array(ToolSchema),\n});\nexport type ListToolsResult = z.infer<typeof ListToolsResultSchema>;\n\nconst TextContentSchema = z\n  .object({\n    type: z.literal('text'),\n    text: z.string(),\n  })\n  .loose();\nconst ImageContentSchema = z\n  .object({\n    type: z.literal('image'),\n    data: z.base64(),\n    mimeType: z.string(),\n  })\n  .loose();\nexport const ResourceSchema = z\n  .object({\n    uri: z.string(),\n    name: z.string(),\n    title: z.optional(z.string()),\n    description: z.optional(z.string()),\n    mimeType: z.optional(z.string()),\n    size: z.optional(z.number()),\n  })\n  .loose();\nexport type MCPResource = z.infer<typeof ResourceSchema>;\n\nexport const ListResourcesResultSchema = PaginatedResultSchema.extend({\n  resources: z.array(ResourceSchema),\n});\nexport type ListResourcesResult = z.infer<typeof ListResourcesResultSchema>;\n\nconst ResourceContentsSchema = z\n  .object({\n    /**\n     * The URI of this resource.\n     */\n    uri: z.string(),\n    /**\n     * Optional display name of the resource content.\n     */\n    name: z.optional(z.string()),\n    /**\n     * Optional human readable title.\n     */\n    title: z.optional(z.string()),\n    /**\n     * The MIME type of this resource, if known.\n     */\n    mimeType: z.optional(z.string()),\n  })\n  .loose();\nconst TextResourceContentsSchema = ResourceContentsSchema.extend({\n  text: z.string(),\n});\nconst BlobResourceContentsSchema = ResourceContentsSchema.extend({\n  blob: z.base64(),\n});\nconst EmbeddedResourceSchema = z\n  .object({\n    type: z.literal('resource'),\n    resource: z.union([TextResourceContentsSchema, BlobResourceContentsSchema]),\n  })\n  .loose();\nconst ResourceLinkContentSchema = z\n  .object({\n    type: z.literal('resource_link'),\n    uri: z.string(),\n    name: z.string(),\n    description: z.optional(z.string()),\n    mimeType: z.optional(z.string()),\n  })\n  .loose();\nconst UnknownContentSchema = z\n  .object({ type: z.string() })\n  .loose()\n  .refine(\n    content =>\n      !['text', 'image', 'resource', 'resource_link'].includes(content.type),\n    { message: 'Known content types must match their schema' },\n  );\n\nconst CallToolResultWithContentSchema = ResultSchema.extend({\n  content: z.array(\n    z.union([\n      TextContentSchema,\n      ImageContentSchema,\n      EmbeddedResourceSchema,\n      ResourceLinkContentSchema,\n      UnknownContentSchema,\n    ]),\n  ),\n  /**\n   * @see https://modelcontextprotocol.io/specification/2026-07-28/server/tools#structured-content\n   */\n  structuredContent: z.optional(z.unknown()),\n  isError: z.boolean().default(false).optional(),\n});\n\nconst CallToolResultWithStructuredContentSchema = ResultSchema.extend({\n  content: z.never().optional(),\n  structuredContent: z.json(),\n  isError: z.boolean().default(false).optional(),\n})\n  .transform(\n    (result): z.infer<typeof CallToolResultWithContentSchema> => ({\n      ...result,\n      content: [\n        {\n          type: 'text',\n          text: JSON.stringify(result.structuredContent),\n        },\n      ],\n    }),\n  )\n  .pipe(CallToolResultWithContentSchema);\n\nexport const CallToolResultSchema = CallToolResultWithContentSchema.or(\n  CallToolResultWithStructuredContentSchema,\n).or(\n  ResultSchema.extend({\n    toolResult: z.unknown().nonoptional(),\n  }),\n);\nexport type CallToolResult = z.infer<typeof CallToolResultSchema>;\n\nconst ResourceTemplateSchema = z\n  .object({\n    uriTemplate: z.string(),\n    name: z.string(),\n    title: z.optional(z.string()),\n    description: z.optional(z.string()),\n    mimeType: z.optional(z.string()),\n  })\n  .loose();\n\nexport const ListResourceTemplatesResultSchema = ResultSchema.extend({\n  resourceTemplates: z.array(ResourceTemplateSchema),\n});\nexport type ListResourceTemplatesResult = z.infer<\n  typeof ListResourceTemplatesResultSchema\n>;\n\nexport const ReadResourceResultSchema = ResultSchema.extend({\n  contents: z.array(\n    z.union([TextResourceContentsSchema, BlobResourceContentsSchema]),\n  ),\n});\nexport type ReadResourceResult = z.infer<typeof ReadResourceResultSchema>;\n\n// Completions\nconst PromptReferenceSchema = z\n  .object({\n    type: z.literal('ref/prompt'),\n    name: z.string(),\n  })\n  .loose();\n\nconst ResourceReferenceSchema = z\n  .object({\n    type: z.literal('ref/resource'),\n    uri: z.string(),\n  })\n  .loose();\n\nconst CompletionArgumentSchema = z\n  .object({\n    name: z.string(),\n    value: z.string(),\n  })\n  .loose();\n\nexport const CompleteRequestParamsSchema = BaseParamsSchema.extend({\n  ref: z.union([PromptReferenceSchema, ResourceReferenceSchema]),\n  argument: CompletionArgumentSchema,\n  context: z.optional(\n    z\n      .object({\n        arguments: z.record(z.string(), z.string()),\n      })\n      .loose(),\n  ),\n});\nexport type CompleteRequestParams = z.infer<typeof CompleteRequestParamsSchema>;\n\nexport const CompleteResultSchema = ResultSchema.extend({\n  completion: z\n    .object({\n      values: z.array(z.string()).max(100),\n      total: z.optional(z.number().int()),\n      hasMore: z.optional(z.boolean()),\n    })\n    .loose(),\n});\nexport type CompleteResult = z.infer<typeof CompleteResultSchema>;\n\n// Prompts\nconst PromptArgumentSchema = z\n  .object({\n    name: z.string(),\n    description: z.optional(z.string()),\n    required: z.optional(z.boolean()),\n  })\n  .loose();\n\nexport const PromptSchema = z\n  .object({\n    name: z.string(),\n    title: z.optional(z.string()),\n    description: z.optional(z.string()),\n    arguments: z.optional(z.array(PromptArgumentSchema)),\n  })\n  .loose();\nexport type MCPPrompt = z.infer<typeof PromptSchema>;\n\nexport const ListPromptsResultSchema = PaginatedResultSchema.extend({\n  prompts: z.array(PromptSchema),\n});\nexport type ListPromptsResult = z.infer<typeof ListPromptsResultSchema>;\n\nconst PromptMessageSchema = z\n  .object({\n    role: z.union([z.literal('user'), z.literal('assistant')]),\n    content: z.union([\n      TextContentSchema,\n      ImageContentSchema,\n      EmbeddedResourceSchema,\n      ResourceLinkContentSchema,\n    ]),\n  })\n  .loose();\nexport type MCPPromptMessage = z.infer<typeof PromptMessageSchema>;\n\nexport const GetPromptResultSchema = ResultSchema.extend({\n  description: z.optional(z.string()),\n  messages: z.array(PromptMessageSchema),\n});\nexport type GetPromptResult = z.infer<typeof GetPromptResultSchema>;\n\nconst ElicitationRequestParamsSchema = BaseParamsSchema.extend({\n  message: z.string(),\n  requestedSchema: z.unknown(),\n});\n\nexport const ElicitationRequestSchema = RequestSchema.extend({\n  method: z.literal('elicitation/create'),\n  params: ElicitationRequestParamsSchema,\n});\n\nexport type ElicitationRequest = z.infer<typeof ElicitationRequestSchema>;\n\nexport const ElicitResultSchema = ResultSchema.extend({\n  action: z.union([\n    z.literal('accept'),\n    z.literal('decline'),\n    z.literal('cancel'),\n  ]),\n  content: z.optional(z.record(z.string(), z.unknown())),\n});\n\nexport type ElicitResult = z.infer<typeof ElicitResultSchema>;\n","import { parseJSON } from '@ai-sdk/provider-utils';\nimport { z } from 'zod/v4';\nimport { BaseParamsSchema, RequestSchema, ResultSchema } from './types';\n\nconst JSONRPC_VERSION = '2.0';\n\nconst JSONRPCRequestSchema = z\n  .object({\n    jsonrpc: z.literal(JSONRPC_VERSION),\n    id: z.union([z.string(), z.number().int()]),\n  })\n  .merge(RequestSchema)\n  .strict();\n\nexport type JSONRPCRequest = z.infer<typeof JSONRPCRequestSchema>;\n\nconst JSONRPCResponseSchema = z\n  .object({\n    jsonrpc: z.literal(JSONRPC_VERSION),\n    id: z.union([z.string(), z.number().int()]),\n    result: ResultSchema,\n  })\n  .strict();\n\nexport type JSONRPCResponse = z.infer<typeof JSONRPCResponseSchema>;\n\nconst JSONRPCErrorSchema = z\n  .object({\n    jsonrpc: z.literal(JSONRPC_VERSION),\n    id: z.optional(z.union([z.string(), z.number().int()])),\n    error: z.object({\n      code: z.number().int(),\n      message: z.string(),\n      data: z.optional(z.unknown()),\n    }),\n  })\n  .strict();\n\nexport type JSONRPCError = z.infer<typeof JSONRPCErrorSchema>;\n\nconst JSONRPCNotificationSchema = z\n  .object({\n    jsonrpc: z.literal(JSONRPC_VERSION),\n  })\n  .merge(\n    z.object({\n      method: z.string(),\n      params: z.optional(BaseParamsSchema),\n    }),\n  )\n  .strict();\n\nexport type JSONRPCNotification = z.infer<typeof JSONRPCNotificationSchema>;\n\nexport const JSONRPCMessageSchema = z.union([\n  JSONRPCRequestSchema,\n  JSONRPCNotificationSchema,\n  JSONRPCResponseSchema,\n  JSONRPCErrorSchema,\n]);\n\nexport type JSONRPCMessage = z.infer<typeof JSONRPCMessageSchema>;\n\nexport function validateJSONRPCMessage(message: unknown): JSONRPCMessage {\n  return JSONRPCMessageSchema.parse(message);\n}\n\nexport async function parseJSONRPCMessage(\n  text: string,\n): Promise<JSONRPCMessage> {\n  return validateJSONRPCMessage(await parseJSON({ text }));\n}\n","import { AISDKError } from '@ai-sdk/provider';\n\nconst name = 'AI_MCPClientError';\nconst marker = `vercel.ai.error.${name}`;\nconst symbol = Symbol.for(marker);\n\n/**\n * An error occurred with the MCP client.\n */\nexport class MCPClientError extends AISDKError {\n  private readonly [symbol] = true;\n  readonly data?: unknown;\n\n  /**\n   * JSON-RPC error code from the server response, per the JSON-RPC 2.0\n   * spec (e.g. `-32601` method-not-found, `-32602` invalid-params, or\n   * MCP-specific codes such as `-32002` resource-not-found). This is the\n   * application-level error code populated from `error.code` in the\n   * server's JSON-RPC error payload. Distinct from `statusCode`, which\n   * is the HTTP transport status.\n   */\n  readonly code?: number;\n\n  /**\n   * HTTP status code from the failed response, when the error originated\n   * from an HTTP-based transport. Undefined for stdio transport\n   * errors and for failures that do not have an associated response\n   * status (e.g. network errors, abort). Distinct from `code`, which is\n   * the JSON-RPC application error code.\n   */\n  readonly statusCode?: number;\n\n  /**\n   * URL of the MCP endpoint the failing request was sent to, when the\n   * error originated from an HTTP transport failure.\n   */\n  readonly url?: string;\n\n  /**\n   * Body of the failing HTTP response, decoded as text, when available.\n   * Undefined when the body could not be read or the error did not have\n   * an associated response.\n   */\n  readonly responseBody?: string;\n\n  constructor({\n    name = 'MCPClientError',\n    message,\n    cause,\n    data,\n    code,\n    statusCode,\n    url,\n    responseBody,\n  }: {\n    name?: string;\n    message: string;\n    cause?: unknown;\n    data?: unknown;\n    code?: number;\n    statusCode?: number;\n    url?: string;\n    responseBody?: string;\n  }) {\n    super({ name, message, cause });\n    this.data = data;\n    this.code = code;\n    this.statusCode = statusCode;\n    this.url = url;\n    this.responseBody = responseBody;\n  }\n\n  static isInstance(error: unknown): error is MCPClientError {\n    return AISDKError.hasMarker(error, marker);\n  }\n}\n","/**\n * Constructs the environment variables for the child process.\n *\n * @param customEnv - Custom environment variables to merge with default environment variables.\n * @returns The environment variables for the child process.\n */\nexport function getEnvironment(\n  customEnv?: Record<string, string>,\n): Record<string, string> {\n  const isWindows = globalThis.process.platform === 'win32';\n  const DEFAULT_INHERITED_ENV_VARS = isWindows\n    ? [\n        'APPDATA',\n        'HOMEDRIVE',\n        'HOMEPATH',\n        'LOCALAPPDATA',\n        'PATH',\n        'PROCESSOR_ARCHITECTURE',\n        'SYSTEMDRIVE',\n        'SYSTEMROOT',\n        'TEMP',\n        'USERNAME',\n        'USERPROFILE',\n      ]\n    : ['HOME', 'LOGNAME', 'PATH', 'SHELL', 'TERM', 'USER'];\n\n  const env: Record<string, string> = customEnv ? { ...customEnv } : {};\n  const customEnvKeys = new Set(\n    Object.keys(env).map(key => (isWindows ? key.toUpperCase() : key)),\n  );\n\n  for (const key of DEFAULT_INHERITED_ENV_VARS) {\n    if (customEnvKeys.has(key)) {\n      continue;\n    }\n\n    const value = globalThis.process.env[key];\n    if (value === undefined) {\n      continue;\n    }\n\n    if (value.startsWith('()')) {\n      continue;\n    }\n\n    env[key] = value;\n  }\n\n  return env;\n}\n","import type { ChildProcess } from 'node:child_process';\nimport spawn from 'cross-spawn';\nimport { getEnvironment } from './get-environment';\nimport type { StdioConfig } from './mcp-stdio-transport';\n\nexport function createChildProcess(\n  config: StdioConfig,\n  signal: AbortSignal,\n): ChildProcess {\n  if (\n    globalThis.process.platform === 'win32' &&\n    [config.command, ...(config.args ?? [])].some(value => /[\\r\\n]/.test(value))\n  ) {\n    throw new TypeError(\n      'Stdio MCP commands and arguments must not contain line breaks on Windows.',\n    );\n  }\n\n  return spawn(config.command, config.args ?? [], {\n    env: getEnvironment(config.env),\n    stdio: ['pipe', 'pipe', config.stderr ?? 'inherit'],\n    shell: false,\n    signal,\n    windowsHide: globalThis.process.platform === 'win32' && isElectron(),\n    cwd: config.cwd,\n  });\n}\n\nfunction isElectron() {\n  return 'type' in globalThis.process;\n}\n","import type { ChildProcess, IOType } from 'node:child_process';\nimport type { Stream } from 'node:stream';\nimport { parseJSONRPCMessage, type JSONRPCMessage } from '../json-rpc-message';\nimport type { MCPTransport } from '../mcp-transport';\nimport { MCPClientError } from '../../error/mcp-client-error';\nimport { createChildProcess } from './create-child-process';\n\nexport interface StdioConfig {\n  command: string;\n  args?: string[];\n  env?: Record<string, string>;\n  stderr?: IOType | Stream | number;\n  cwd?: string;\n}\n\nexport class StdioMCPTransport implements MCPTransport {\n  readonly supportsProtocolVersionDiscovery = true;\n  private process?: ChildProcess;\n  private abortController: AbortController = new AbortController();\n  private readBuffer: ReadBuffer = new ReadBuffer();\n  private serverParams: StdioConfig;\n\n  onclose?: () => void;\n  onerror?: (error: unknown) => void;\n  onmessage?: (message: JSONRPCMessage) => void;\n\n  constructor(server: StdioConfig) {\n    this.serverParams = server;\n  }\n\n  async start(): Promise<void> {\n    if (this.process) {\n      throw new MCPClientError({\n        message: 'StdioMCPTransport already started.',\n      });\n    }\n\n    return new Promise((resolve, reject) => {\n      try {\n        const process = createChildProcess(\n          this.serverParams,\n          this.abortController.signal,\n        );\n\n        this.process = process;\n\n        this.process.on('error', error => {\n          if (error.name === 'AbortError') {\n            this.onclose?.();\n            return;\n          }\n\n          reject(error);\n          this.onerror?.(error);\n        });\n\n        this.process.on('spawn', () => {\n          resolve();\n        });\n\n        this.process.on('close', _code => {\n          this.process = undefined;\n          this.onclose?.();\n        });\n\n        this.process.stdin?.on('error', error => {\n          this.onerror?.(error);\n        });\n\n        this.process.stdout?.on('data', chunk => {\n          this.readBuffer.append(chunk);\n          void this.processReadBuffer();\n        });\n\n        this.process.stdout?.on('error', error => {\n          this.onerror?.(error);\n        });\n      } catch (error) {\n        reject(error);\n        this.onerror?.(error);\n      }\n    });\n  }\n\n  private async processReadBuffer() {\n    while (true) {\n      const line = this.readBuffer.readLine();\n      if (line === null) {\n        break;\n      }\n\n      try {\n        const message = await deserializeMessage(line);\n        this.onmessage?.(message);\n      } catch (error) {\n        this.onerror?.(error as Error);\n      }\n    }\n  }\n\n  async close(): Promise<void> {\n    this.abortController.abort();\n    this.process = undefined;\n    this.readBuffer.clear();\n  }\n\n  send(message: JSONRPCMessage): Promise<void> {\n    return new Promise(resolve => {\n      if (!this.process?.stdin) {\n        throw new MCPClientError({\n          message: 'StdioClientTransport not connected',\n        });\n      }\n\n      const json = serializeMessage(message);\n      if (this.process.stdin.write(json)) {\n        resolve();\n      } else {\n        this.process.stdin.once('drain', resolve);\n      }\n    });\n  }\n}\n\nclass ReadBuffer {\n  private buffer?: Buffer;\n\n  append(chunk: Buffer): void {\n    this.buffer = this.buffer ? Buffer.concat([this.buffer, chunk]) : chunk;\n  }\n\n  readLine(): string | null {\n    if (!this.buffer) return null;\n\n    const index = this.buffer.indexOf('\\n');\n    if (index === -1) {\n      return null;\n    }\n\n    const line = this.buffer.toString('utf8', 0, index);\n    this.buffer = this.buffer.subarray(index + 1);\n    return line;\n  }\n\n  clear(): void {\n    this.buffer = undefined;\n  }\n}\n\nfunction serializeMessage(message: JSONRPCMessage): string {\n  return JSON.stringify(message) + '\\n';\n}\n\nexport async function deserializeMessage(\n  line: string,\n): Promise<JSONRPCMessage> {\n  return parseJSONRPCMessage(line);\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/mcp",
-  "version": "2.0.68",
+  "version": "2.0.70",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -31,8 +31,8 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.23",
-    "@ai-sdk/provider-utils": "5.0.55",
+    "@ai-sdk/provider": "4.0.24",
+    "@ai-sdk/provider-utils": "5.0.56",
     "cross-spawn": "^7.0.6",
     "pkce-challenge": "^5.0.1"
   },
@@ -43,7 +43,7 @@
     "@vercel/ai-tsconfig": "0.0.0",
     "tsdown": "^0.23.0",
     "typescript": "6.0.3",
-    "vitest": "^4.1.6",
+    "vitest": "^4.1.11",
     "zod": "3.25.76"
   },
   "peerDependencies": {

package/src/index.ts

@@ -46,6 +46,30 @@ export {
   AuthorizationServerMismatchError,
 } from './error/oauth-error';
 export { MCPClientError } from './error/mcp-client-error';
+export type { ManagedMCPClient as Experimental_ManagedMCPClient } from './tool/mcp-client';
+export type {
+  MCPEventsAdapter as Experimental_MCPEventsAdapter,
+  ManagedSubscribeInput as Experimental_ManagedSubscribeInput,
+  ManagedSubscription as Experimental_ManagedSubscription,
+  ManagedMCPEvents as Experimental_ManagedMCPEvents,
+} from './tool/mcp-events-adapter';
+export {
+  createMCPEventWebhook as experimental_createMCPEventWebhook,
+  type MCPEventWebhookOptions as Experimental_MCPEventWebhookOptions,
+} from './tool/mcp-event-webhook';
+export type {
+  MCPEvent as Experimental_MCPEvent,
+  MCPEventControl as Experimental_MCPEventControl,
+  MCPEventDefinition as Experimental_MCPEventDefinition,
+  MCPEventStore as Experimental_MCPEventStore,
+  MCPEventSubscription as Experimental_MCPEventSubscription,
+  MCPEventSubscriptionInfo as Experimental_MCPEventSubscriptionInfo,
+  MCPEvents as Experimental_MCPEvents,
+  MCPEventsConfig as Experimental_MCPEventsConfig,
+  ListEventsResult as Experimental_ListEventsResult,
+  SubscribeEventOptions as Experimental_SubscribeEventOptions,
+  SubscribeEventResult as Experimental_SubscribeEventResult,
+} from './tool/mcp-event-types';
 export type {
   OAuthAuthorizationServerInformation,
   OAuthClientProvider,

package/src/tool/mcp-client.ts

@@ -13,6 +13,13 @@ import {
   type ToolResultOutput,
 } from '@ai-sdk/provider-utils';
 import type { z } from 'zod/v4';
+import { createMCPEvents } from './mcp-events';
+import {
+  createManagedMCPEvents,
+  type ManagedMCPEvents,
+  type MCPEventsAdapter,
+} from './mcp-events-adapter';
+import type { MCPEvents, MCPEventsConfig } from './mcp-event-types';
 import { MCPClientError } from '../error/mcp-client-error';
 import type {
   JSONRPCError,
@@ -235,6 +242,8 @@ function mcpToModelOutput({
 }
 
 export interface MCPClientConfig {
+  /** Experimental events: choose a private durable store or a managed adapter. */
+  experimental_events?: MCPEventsConfig;
   /** Transport configuration for connecting to the MCP server */
   transport: MCPTransportConfig | MCPTransport;
   /**
@@ -286,15 +295,36 @@ export interface MCPClientConfig {
   capabilities?: ClientCapabilities;
 }
 
-export async function createMCPClient(
+export type ManagedMCPClient = Omit<MCPClient, 'experimental_events'> & {
+  readonly experimental_events: ManagedMCPEvents;
+};
+
+export function createMCPClient(
+  config: MCPClientConfig & {
+    experimental_events: { adapter: MCPEventsAdapter };
+  },
+): Promise<ManagedMCPClient>;
+export function createMCPClient(
+  config: MCPClientConfig & {
+    experimental_events?: { adapter?: never };
+  },
+): Promise<MCPClient>;
+export function createMCPClient(
   config: MCPClientConfig,
-): Promise<MCPClient> {
+): Promise<MCPClient | ManagedMCPClient>;
+export async function createMCPClient(config: MCPClientConfig): Promise<
+  Omit<MCPClient, 'experimental_events'> & {
+    readonly experimental_events: MCPEvents | ManagedMCPEvents;
+  }
+> {
   const client = new DefaultMCPClient(config);
   await client.init();
   return client;
 }
 
 export interface MCPClient {
+  /** Experimental event discovery and webhook subscription lifecycle. */
+  readonly experimental_events: MCPEvents;
   /**
    * Information about the connected MCP server, as reported during initialization.
    * @see https://modelcontextprotocol.io/specification/2025-11-25/schema#implementation
@@ -399,11 +429,12 @@ export interface MCPClient {
  * This client is meant to be used to communicate with a single server. To communicate and fetch tools across multiple servers, it's recommended to create a new client instance per server.
  *
  * Not supported:
- * - Accepting notifications
+ * - Accepting in-band notifications (webhook events use a separate HTTP handler)
  * - Automatic session persistence for Streamable HTTP transport
  * - Resumable SSE streams
  */
-class DefaultMCPClient implements MCPClient {
+class DefaultMCPClient implements Omit<MCPClient, 'experimental_events'> {
+  readonly experimental_events: MCPEvents | ManagedMCPEvents;
   private transport: MCPTransport;
   private protocolVersionDiscovery: boolean;
   private onUncaughtError?: (error: unknown) => void;
@@ -434,6 +465,7 @@ class DefaultMCPClient implements MCPClient {
   ) => Promise<ElicitResult> | ElicitResult;
 
   constructor({
+    experimental_events: events,
     transport: transportConfig,
     name,
     clientName = name ?? 'ai-sdk-mcp-client',
@@ -445,6 +477,15 @@ class DefaultMCPClient implements MCPClient {
     initializationOptions,
     protocolVersionDiscovery = true,
   }: MCPClientConfig) {
+    if (
+      events?.adapter !== undefined &&
+      (events.store !== undefined || events.validateArguments !== undefined)
+    ) {
+      throw new MCPClientError({
+        message:
+          'Configure experimental_events with either an adapter or a store, not both. Managed adapters own argument validation.',
+      });
+    }
     this.onUncaughtError = onUncaughtError;
     this.maxRetries = prepareMaxRetries(maxRetries);
     this.clientCapabilities = capabilities ?? {};
@@ -481,6 +522,14 @@ class DefaultMCPClient implements MCPClient {
       name: clientName,
       version,
     };
+    const directEvents = createMCPEvents({
+      request: args => this.request(args),
+      store: events?.store,
+      validateArguments: events?.validateArguments,
+    });
+    this.experimental_events = events?.adapter
+      ? createManagedMCPEvents(events.adapter, directEvents.list)
+      : directEvents;
   }
 
   get serverInfo(): Configuration {
@@ -714,6 +763,15 @@ class DefaultMCPClient implements MCPClient {
           });
         }
         break;
+      case 'events/list':
+      case 'events/subscribe':
+      case 'events/unsubscribe':
+        if (!this.serverCapabilities.events) {
+          throw new MCPClientError({
+            message: 'Server does not support events',
+          });
+        }
+        break;
       case 'tools/list':
       case 'tools/call':
         if (!this.serverCapabilities.tools) {

package/src/tool/mcp-event-signature.ts

@@ -0,0 +1,79 @@
+import {
+  convertBase64ToUint8Array,
+  convertUint8ArrayToBase64,
+} from '@ai-sdk/provider-utils';
+import { MCPClientError } from '../error/mcp-client-error';
+
+export function createMCPEventSecret(): string {
+  return `whsec_${convertUint8ArrayToBase64(crypto.getRandomValues(new Uint8Array(32)))}`;
+}
+
+export function decodeMCPEventSecret(secret: string): Uint8Array {
+  const encoded = secret.slice(6);
+  if (!secret.startsWith('whsec_') || !/^[A-Za-z0-9+/]+={0,2}$/.test(encoded)) {
+    throw new MCPClientError({ message: 'Invalid MCP event signing secret' });
+  }
+  const bytes = convertBase64ToUint8Array(encoded);
+  if (bytes.length < 24 || bytes.length > 64) {
+    throw new MCPClientError({
+      message: 'MCP event signing secrets must contain 24–64 random bytes',
+    });
+  }
+  return bytes;
+}
+
+/** Standard Webhooks v1: authenticate the exact body bytes using Web Crypto. */
+export async function verifyMCPEventSignature({
+  headers,
+  body,
+  secret,
+}: {
+  headers: Headers;
+  body: Uint8Array;
+  secret: string;
+}): Promise<boolean> {
+  const id = headers.get('webhook-id');
+  const timestamp = headers.get('webhook-timestamp');
+  const signatures = headers.get('webhook-signature');
+  if (
+    !id ||
+    !timestamp ||
+    !signatures ||
+    !/^\d+$/.test(timestamp) ||
+    Math.abs(Date.now() / 1000 - Number(timestamp)) > 300
+  ) {
+    return false;
+  }
+
+  const key = await crypto.subtle.importKey(
+    'raw',
+    new Uint8Array(decodeMCPEventSecret(secret)),
+    { name: 'HMAC', hash: 'SHA-256' },
+    false,
+    ['verify'],
+  );
+  const prefix = new TextEncoder().encode(`${id}.${timestamp}.`);
+  const message = new Uint8Array(prefix.length + body.length);
+  message.set(prefix);
+  message.set(body, prefix.length);
+
+  for (const signature of signatures.split(' ')) {
+    const [version, value] = signature.split(',');
+    if (version !== 'v1' || !value) continue;
+    try {
+      if (
+        await crypto.subtle.verify(
+          'HMAC',
+          key,
+          new Uint8Array(convertBase64ToUint8Array(value)),
+          message,
+        )
+      ) {
+        return true;
+      }
+    } catch {
+      // A malformed signature must not hide another valid rotation signature.
+    }
+  }
+  return false;
+}

package/src/tool/mcp-event-types.ts

@@ -0,0 +1,151 @@
+import type { JSONObject } from '@ai-sdk/provider';
+import type { MCPEventsAdapter } from './mcp-events-adapter';
+import { z } from 'zod/v4';
+import { ResultSchema, type RequestOptions } from './types';
+
+const JsonSchemaSchema = z.union([
+  z.boolean(),
+  z.record(z.string(), z.unknown()),
+]);
+
+export const MCPEventDefinitionSchema = z.looseObject({
+  name: z.string().min(1),
+  description: z.string().nullish(),
+  delivery: z.array(z.enum(['webhook', 'poll', 'push'])).min(1),
+  inputSchema: JsonSchemaSchema,
+  payloadSchema: JsonSchemaSchema,
+});
+export type MCPEventDefinition = z.infer<typeof MCPEventDefinitionSchema>;
+
+export const ListEventsResultSchema = ResultSchema.extend({
+  events: z.array(MCPEventDefinitionSchema),
+  nextCursor: z.string().nullish(),
+});
+export type ListEventsResult = z.infer<typeof ListEventsResultSchema>;
+
+export const SubscribeEventResultSchema = ResultSchema.extend({
+  id: z.string().min(1),
+  refreshBefore: z.iso.datetime({ offset: true }).nullable(),
+  cursor: z
+    .string()
+    .nullish()
+    .transform(cursor => cursor ?? null),
+  truncated: z.boolean(),
+});
+export type SubscribeEventResult = z.infer<typeof SubscribeEventResultSchema>;
+
+export const MCPEventSchema = z.looseObject({
+  eventId: z.string().min(1),
+  name: z.string().min(1),
+  timestamp: z.iso.datetime({ offset: true }),
+  data: z.record(z.string(), z.unknown()),
+  cursor: z.string().nullish(),
+});
+export type MCPEvent = z.infer<typeof MCPEventSchema>;
+
+export const MCPEventControlSchema = z
+  .discriminatedUnion('type', [
+    z.looseObject({ type: z.literal('gap'), cursor: z.string() }),
+    z.looseObject({
+      type: z.literal('terminated'),
+      error: z.looseObject({
+        code: z.number().int(),
+        message: z.string(),
+        data: z.unknown().nullish(),
+      }),
+    }),
+  ])
+  .transform(control =>
+    control.type === 'gap' ? { ...control, truncated: true as const } : control,
+  );
+export type MCPEventControl = z.infer<typeof MCPEventControlSchema>;
+
+/** Persisted privately by the application, including the signing secret. */
+export type MCPEventSubscription = {
+  key: string;
+  id?: string;
+  name: string;
+  arguments: JSONObject;
+  definition: MCPEventDefinition;
+  delivery: { mode: 'webhook'; url: string; secret: string };
+  refreshBefore?: string | null;
+  cursor: string | null;
+  truncated: boolean;
+  ttlMs?: number | null;
+  maxAgeMs?: number;
+  status: 'pending' | 'active';
+};
+
+/** Subscription metadata safe to pass to event handlers; excludes the secret. */
+export type MCPEventSubscriptionInfo = {
+  id: string;
+  name: string;
+  arguments: JSONObject;
+  delivery: { mode: 'webhook'; url: string };
+  refreshBefore: string | null;
+};
+
+/**
+ * Use durable, private storage scoped to one MCP server and authenticated
+ * principal. update must atomically merge only the supplied fields. Never
+ * expose these records to a browser: delivery.secret authenticates webhooks.
+ */
+export interface MCPEventStore {
+  get(key: string): Promise<MCPEventSubscription | undefined>;
+  getById(id: string): Promise<MCPEventSubscription | undefined>;
+  set(subscription: MCPEventSubscription): Promise<void>;
+  update(key: string, patch: Partial<MCPEventSubscription>): Promise<void>;
+  delete(key: string): Promise<void>;
+}
+
+export type MCPEventsConfig =
+  | {
+      store: MCPEventStore;
+      adapter?: never;
+      /**
+       * Optionally validate subscription arguments using an application schema or
+       * the server's inputSchema. Throw to reject before persisting or subscribing.
+       */
+      validateArguments?: (args: {
+        definition: MCPEventDefinition;
+        arguments: JSONObject;
+      }) => void | PromiseLike<void>;
+    }
+  | {
+      adapter: MCPEventsAdapter;
+      store?: never;
+      validateArguments?: never;
+    };
+
+export type SubscribeEventOptions = {
+  name: string;
+  arguments?: JSONObject;
+  delivery: {
+    mode: 'webhook';
+    /** HTTPS callback served by createMCPEventWebhook before subscribing. */
+    url: string;
+    /** Development only: allow HTTP callbacks to literal loopback addresses. */
+    allowInsecureLocalhost?: boolean;
+    /** Generated securely when omitted; persisted before the subscribe request. */
+    secret?: string;
+  };
+  cursor?: string | null;
+  ttlMs?: number | null;
+  maxAgeMs?: number;
+  options?: RequestOptions;
+};
+
+type MCPEventSubscriptionOptions = (
+  | { id: string; key?: never }
+  | { key: string; id?: never }
+) & { options?: RequestOptions };
+
+export interface MCPEvents {
+  list(options?: {
+    params?: { cursor?: string };
+    options?: RequestOptions;
+  }): Promise<ListEventsResult>;
+  subscribe(options: SubscribeEventOptions): Promise<SubscribeEventResult>;
+  refresh(options: MCPEventSubscriptionOptions): Promise<SubscribeEventResult>;
+  unsubscribe(options: MCPEventSubscriptionOptions): Promise<void>;
+}