@spec fallback_version() :: version()

Returns the fallback protocol version for compatibility.

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

Get the protocol module for a given version string.

Examples

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

iex> Anubis.Protocol.Registry.get("unknown")
:error

@spec get_features(version()) :: {:ok, [atom()]} | :error

Returns the features supported by a given version.

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

@spec latest_module() :: module()

Returns the module for the latest supported protocol version.

@spec latest_version() :: version()

Returns the latest supported protocol version string.

@spec negotiate(version()) ::
  {:ok, version(), module()} | {:error, :unsupported_version, [version()]}

Negotiate the best version given a client's requested version.

MCP spec: the server picks the version, the client proposes one. If we support the requested version, use it. Otherwise, return an error with the list of supported versions.

Examples

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

iex> Anubis.Protocol.Registry.negotiate("9999-01-01")
{:error, :unsupported_version, ["2025-06-18", "2025-03-26", "2024-11-05"]}

@spec negotiate(version(), [version()]) :: {:ok, version(), module()} | :error

Negotiate version between client and server supported version lists.

Used when the server has a restricted set of supported versions. Returns the best matching version (client's preference if in server list, otherwise server's latest).

Examples

iex> Anubis.Protocol.Registry.negotiate("2025-03-26", ["2025-06-18", "2025-03-26"])
{:ok, "2025-03-26", Anubis.Protocol.V2025_03_26}

iex> Anubis.Protocol.Registry.negotiate("2024-11-05", ["2025-06-18", "2025-03-26"])
{:ok, "2025-06-18", Anubis.Protocol.V2025_06_18}

@spec progress_params_schema(version()) :: {:ok, map()} | :error

Returns the progress notification params schema for a given version.

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

@spec supported?(version()) :: boolean()

Check if a version string is supported.

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

List all supported versions in preference order (newest first).

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

Checks if a feature is supported by a protocol version.