@spec compatible_transports(version(), [module()]) :: [module()]

Returns transport modules that support a protocol version.

@spec fallback_version() :: version()

Returns the fallback protocol version for compatibility.

@spec get_features(version()) :: [feature()]

Returns the set of features supported by a protocol version.

Delegates to the version module's supported_features/0 callback.

@spec get_module(version()) :: {:ok, module()} | :error

Returns the protocol module for a given version string.

Examples

iex> Anubis.Protocol.get_module("2025-06-18")
{:ok, Anubis.Protocol.V2025_06_18}

@spec latest_version() :: version()

Returns the latest supported protocol version.

@spec negotiate_version(version(), version()) ::
  {:ok, version()} | {:error, Anubis.MCP.Error.t()}

Negotiates protocol version between client and server versions.

Returns the best compatible version or an error if incompatible.

@spec supported_versions() :: [version()]

Returns all supported protocol versions.

@spec supports_feature?(version(), feature()) :: boolean()

Checks if a feature is supported by a protocol version.

@spec validate_client_config(version(), module(), map()) ::
  :ok | {:error, Anubis.MCP.Error.t()}

Validates client configuration for protocol compatibility.

This function checks if the client configuration is compatible with the specified protocol version, including transport and capabilities.

@spec validate_transport(version(), module()) :: :ok | {:error, Anubis.MCP.Error.t()}

Validates if a transport is compatible with a protocol version.

@spec validate_version(version()) :: :ok | {:error, Anubis.MCP.Error.t()}

Validates if a protocol version is supported.