label-studio-sdk 2.0.6__py3-none-any.whl → 2.0.8__py3-none-any.whl

label_studio_sdk/projects/stats/client.py

@@ -8,7 +8,14 @@ from ...core.jsonable_encoder import jsonable_encoder
 from ...core.unchecked_base_model import construct_type
 from json.decoder import JSONDecodeError
 from ...core.api_error import ApiError
+from .types.stats_agreement_annotator_response import StatsAgreementAnnotatorResponse
+from .types.stats_data_filters_response import StatsDataFiltersResponse
+from .types.stats_finished_tasks_response import StatsFinishedTasksResponse
+from .types.stats_lead_time_response import StatsLeadTimeResponse
 from .types.stats_total_agreement_response import StatsTotalAgreementResponse
+from .types.stats_user_prediction_agreement_response import StatsUserPredictionAgreementResponse
+from .types.stats_user_review_score_response import StatsUserReviewScoreResponse
+from .types.stats_user_ground_truth_agreement_response import StatsUserGroundTruthAgreementResponse
 from ...core.client_wrapper import AsyncClientWrapper
 
 
@@ -89,6 +96,205 @@ class StatsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    def agreement_annotator(
+        self, id: int, user_id: int, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> StatsAgreementAnnotatorResponse:
+        """
+        Get agreement statistics for a specific annotator within a project.
+
+        Parameters
+        ----------
+        id : int
+
+        user_id : int
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StatsAgreementAnnotatorResponse
+            Individual annotator agreement statistics
+
+        Examples
+        --------
+        from label_studio_sdk import LabelStudio
+
+        client = LabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+        client.projects.stats.agreement_annotator(
+            id=1,
+            user_id=1,
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/stats/agreement_annotator/{jsonable_encoder(user_id)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    StatsAgreementAnnotatorResponse,
+                    construct_type(
+                        type_=StatsAgreementAnnotatorResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    def data_filters(
+        self, id: int, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> StatsDataFiltersResponse:
+        """
+        Get statistics about user data filters and their usage within a project.
+
+        Parameters
+        ----------
+        id : int
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StatsDataFiltersResponse
+            User data filter statistics
+
+        Examples
+        --------
+        from label_studio_sdk import LabelStudio
+
+        client = LabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+        client.projects.stats.data_filters(
+            id=1,
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/stats/data_filter",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    StatsDataFiltersResponse,
+                    construct_type(
+                        type_=StatsDataFiltersResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    def finished_tasks(
+        self, id: int, *, user_pk: typing.Optional[int] = None, request_options: typing.Optional[RequestOptions] = None
+    ) -> StatsFinishedTasksResponse:
+        """
+        Get statistics about finished tasks for a project.
+
+        Parameters
+        ----------
+        id : int
+
+        user_pk : typing.Optional[int]
+            User ID to filter statistics by (optional)
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StatsFinishedTasksResponse
+            Finished tasks statistics
+
+        Examples
+        --------
+        from label_studio_sdk import LabelStudio
+
+        client = LabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+        client.projects.stats.finished_tasks(
+            id=1,
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/stats/finished",
+            method="GET",
+            params={
+                "user_pk": user_pk,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    StatsFinishedTasksResponse,
+                    construct_type(
+                        type_=StatsFinishedTasksResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    def lead_time(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> StatsLeadTimeResponse:
+        """
+        Get lead time statistics across the project, including average annotation time.
+
+        Parameters
+        ----------
+        id : int
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StatsLeadTimeResponse
+            Lead time statistics
+
+        Examples
+        --------
+        from label_studio_sdk import LabelStudio
+
+        client = LabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+        client.projects.stats.lead_time(
+            id=1,
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/stats/lead_time",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    StatsLeadTimeResponse,
+                    construct_type(
+                        type_=StatsLeadTimeResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
     def total_agreement(
         self,
         id: int,
@@ -118,16 +324,647 @@ class StatsClient:
 
         Examples
         --------
-        from label_studio_sdk import LabelStudio
+        from label_studio_sdk import LabelStudio
+
+        client = LabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+        client.projects.stats.total_agreement(
+            id=1,
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/stats/total_agreement",
+            method="GET",
+            params={
+                "per_label": per_label,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    StatsTotalAgreementResponse,
+                    construct_type(
+                        type_=StatsTotalAgreementResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    def update_stats(
+        self,
+        id: int,
+        *,
+        stat_type: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.Dict[str, typing.Optional[typing.Any]]:
+        """
+        Start stats recalculation for given project
+
+        Parameters
+        ----------
+        id : int
+
+        stat_type : typing.Optional[str]
+            Stat type to recalculate. Possible values: label, stats
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.Dict[str, typing.Optional[typing.Any]]
+            Successful response returns job id
+
+        Examples
+        --------
+        from label_studio_sdk import LabelStudio
+
+        client = LabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+        client.projects.stats.update_stats(
+            id=1,
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/update-stats",
+            method="GET",
+            params={
+                "stat_type": stat_type,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.Dict[str, typing.Optional[typing.Any]],
+                    construct_type(
+                        type_=typing.Dict[str, typing.Optional[typing.Any]],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    def user_prediction_agreement(
+        self,
+        id: int,
+        user_pk: int,
+        *,
+        per_label: typing.Optional[bool] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> StatsUserPredictionAgreementResponse:
+        """
+        Get prediction agreement statistics for a specific user within a project.
+
+        Parameters
+        ----------
+        id : int
+
+        user_pk : int
+
+        per_label : typing.Optional[bool]
+            Calculate agreement per label
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StatsUserPredictionAgreementResponse
+            Individual user prediction agreement statistics
+
+        Examples
+        --------
+        from label_studio_sdk import LabelStudio
+
+        client = LabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+        client.projects.stats.user_prediction_agreement(
+            id=1,
+            user_pk=1,
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/user-stats/{jsonable_encoder(user_pk)}/prediction",
+            method="GET",
+            params={
+                "per_label": per_label,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    StatsUserPredictionAgreementResponse,
+                    construct_type(
+                        type_=StatsUserPredictionAgreementResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    def user_review_score(
+        self,
+        id: int,
+        user_pk: int,
+        *,
+        per_label: typing.Optional[bool] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> StatsUserReviewScoreResponse:
+        """
+        Get review score statistics for a specific user within a project.
+
+        Parameters
+        ----------
+        id : int
+
+        user_pk : int
+
+        per_label : typing.Optional[bool]
+            Calculate agreement per label
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StatsUserReviewScoreResponse
+            Individual user review score statistics
+
+        Examples
+        --------
+        from label_studio_sdk import LabelStudio
+
+        client = LabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+        client.projects.stats.user_review_score(
+            id=1,
+            user_pk=1,
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/user-stats/{jsonable_encoder(user_pk)}/review_score",
+            method="GET",
+            params={
+                "per_label": per_label,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    StatsUserReviewScoreResponse,
+                    construct_type(
+                        type_=StatsUserReviewScoreResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    def user_ground_truth_agreement(
+        self,
+        id: int,
+        user_pk: int,
+        *,
+        per_label: typing.Optional[bool] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> StatsUserGroundTruthAgreementResponse:
+        """
+        Get ground truth agreement statistics for a specific user within a project.
+
+        Parameters
+        ----------
+        id : int
+
+        user_pk : int
+
+        per_label : typing.Optional[bool]
+            Calculate agreement per label
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StatsUserGroundTruthAgreementResponse
+            Individual user ground truth agreement statistics
+
+        Examples
+        --------
+        from label_studio_sdk import LabelStudio
+
+        client = LabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+        client.projects.stats.user_ground_truth_agreement(
+            id=1,
+            user_pk=1,
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/users/{jsonable_encoder(user_pk)}/stats/agreement-groundtruth",
+            method="GET",
+            params={
+                "per_label": per_label,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    StatsUserGroundTruthAgreementResponse,
+                    construct_type(
+                        type_=StatsUserGroundTruthAgreementResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+
+class AsyncStatsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def iaa(
+        self,
+        id: int,
+        *,
+        expand: typing.Optional[str] = None,
+        per_label: typing.Optional[bool] = None,
+        std: typing.Optional[bool] = None,
+        task: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> StatsIaaResponse:
+        """
+        Get Inter-Annotator Agreement (IAA) matrix for a project, showing agreement between all annotators.
+
+        Parameters
+        ----------
+        id : int
+
+        expand : typing.Optional[str]
+            Comma-separated list of fields to expand
+
+        per_label : typing.Optional[bool]
+            Calculate IAA per label
+
+        std : typing.Optional[bool]
+            Include standard deviation in results
+
+        task : typing.Optional[str]
+            Comma-separated list of task IDs to filter by
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StatsIaaResponse
+            Inter-Annotator Agreement matrix
+
+        Examples
+        --------
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
+
+        client = AsyncLabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.projects.stats.iaa(
+                id=1,
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/stats/IAA",
+            method="GET",
+            params={
+                "expand": expand,
+                "per_label": per_label,
+                "std": std,
+                "task": task,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    StatsIaaResponse,
+                    construct_type(
+                        type_=StatsIaaResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    async def agreement_annotator(
+        self, id: int, user_id: int, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> StatsAgreementAnnotatorResponse:
+        """
+        Get agreement statistics for a specific annotator within a project.
+
+        Parameters
+        ----------
+        id : int
+
+        user_id : int
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StatsAgreementAnnotatorResponse
+            Individual annotator agreement statistics
+
+        Examples
+        --------
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
+
+        client = AsyncLabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.projects.stats.agreement_annotator(
+                id=1,
+                user_id=1,
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/stats/agreement_annotator/{jsonable_encoder(user_id)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    StatsAgreementAnnotatorResponse,
+                    construct_type(
+                        type_=StatsAgreementAnnotatorResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    async def data_filters(
+        self, id: int, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> StatsDataFiltersResponse:
+        """
+        Get statistics about user data filters and their usage within a project.
+
+        Parameters
+        ----------
+        id : int
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StatsDataFiltersResponse
+            User data filter statistics
+
+        Examples
+        --------
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
+
+        client = AsyncLabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.projects.stats.data_filters(
+                id=1,
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/stats/data_filter",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    StatsDataFiltersResponse,
+                    construct_type(
+                        type_=StatsDataFiltersResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    async def finished_tasks(
+        self, id: int, *, user_pk: typing.Optional[int] = None, request_options: typing.Optional[RequestOptions] = None
+    ) -> StatsFinishedTasksResponse:
+        """
+        Get statistics about finished tasks for a project.
+
+        Parameters
+        ----------
+        id : int
+
+        user_pk : typing.Optional[int]
+            User ID to filter statistics by (optional)
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StatsFinishedTasksResponse
+            Finished tasks statistics
+
+        Examples
+        --------
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
+
+        client = AsyncLabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.projects.stats.finished_tasks(
+                id=1,
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/stats/finished",
+            method="GET",
+            params={
+                "user_pk": user_pk,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    StatsFinishedTasksResponse,
+                    construct_type(
+                        type_=StatsFinishedTasksResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    async def lead_time(
+        self, id: int, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> StatsLeadTimeResponse:
+        """
+        Get lead time statistics across the project, including average annotation time.
+
+        Parameters
+        ----------
+        id : int
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StatsLeadTimeResponse
+            Lead time statistics
+
+        Examples
+        --------
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
+
+        client = AsyncLabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.projects.stats.lead_time(
+                id=1,
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/stats/lead_time",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    StatsLeadTimeResponse,
+                    construct_type(
+                        type_=StatsLeadTimeResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    async def total_agreement(
+        self,
+        id: int,
+        *,
+        per_label: typing.Optional[bool] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> StatsTotalAgreementResponse:
+        """
+        Overall or per-label total agreement across the project.
+
+        NOTE: due to an open issue in Fern, SDK clients will raise ApiError upon handling a 204 response. As a workaround, wrap call to this function in a try-except block.
+
+        Parameters
+        ----------
+        id : int
+
+        per_label : typing.Optional[bool]
+            Return agreement per label
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StatsTotalAgreementResponse
+            Total agreement
+
+        Examples
+        --------
+        import asyncio
 
-        client = LabelStudio(
+        from label_studio_sdk import AsyncLabelStudio
+
+        client = AsyncLabelStudio(
             api_key="YOUR_API_KEY",
         )
-        client.projects.stats.total_agreement(
-            id=1,
-        )
+
+
+        async def main() -> None:
+            await client.projects.stats.total_agreement(
+                id=1,
+            )
+
+
+        asyncio.run(main())
         """
-        _response = self._client_wrapper.httpx_client.request(
+        _response = await self._client_wrapper.httpx_client.request(
             f"api/projects/{jsonable_encoder(id)}/stats/total_agreement",
             method="GET",
             params={
@@ -149,47 +986,169 @@ class StatsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    async def update_stats(
+        self,
+        id: int,
+        *,
+        stat_type: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.Dict[str, typing.Optional[typing.Any]]:
+        """
+        Start stats recalculation for given project
 
-class AsyncStatsClient:
-    def __init__(self, *, client_wrapper: AsyncClientWrapper):
-        self._client_wrapper = client_wrapper
+        Parameters
+        ----------
+        id : int
 
-    async def iaa(
+        stat_type : typing.Optional[str]
+            Stat type to recalculate. Possible values: label, stats
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.Dict[str, typing.Optional[typing.Any]]
+            Successful response returns job id
+
+        Examples
+        --------
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
+
+        client = AsyncLabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.projects.stats.update_stats(
+                id=1,
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/update-stats",
+            method="GET",
+            params={
+                "stat_type": stat_type,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.Dict[str, typing.Optional[typing.Any]],
+                    construct_type(
+                        type_=typing.Dict[str, typing.Optional[typing.Any]],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    async def user_prediction_agreement(
         self,
         id: int,
+        user_pk: int,
         *,
-        expand: typing.Optional[str] = None,
         per_label: typing.Optional[bool] = None,
-        std: typing.Optional[bool] = None,
-        task: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> StatsIaaResponse:
+    ) -> StatsUserPredictionAgreementResponse:
         """
-        Get Inter-Annotator Agreement (IAA) matrix for a project, showing agreement between all annotators.
+        Get prediction agreement statistics for a specific user within a project.
 
         Parameters
         ----------
         id : int
 
-        expand : typing.Optional[str]
-            Comma-separated list of fields to expand
+        user_pk : int
 
         per_label : typing.Optional[bool]
-            Calculate IAA per label
+            Calculate agreement per label
 
-        std : typing.Optional[bool]
-            Include standard deviation in results
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
 
-        task : typing.Optional[str]
-            Comma-separated list of task IDs to filter by
+        Returns
+        -------
+        StatsUserPredictionAgreementResponse
+            Individual user prediction agreement statistics
+
+        Examples
+        --------
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
+
+        client = AsyncLabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.projects.stats.user_prediction_agreement(
+                id=1,
+                user_pk=1,
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/projects/{jsonable_encoder(id)}/user-stats/{jsonable_encoder(user_pk)}/prediction",
+            method="GET",
+            params={
+                "per_label": per_label,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    StatsUserPredictionAgreementResponse,
+                    construct_type(
+                        type_=StatsUserPredictionAgreementResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    async def user_review_score(
+        self,
+        id: int,
+        user_pk: int,
+        *,
+        per_label: typing.Optional[bool] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> StatsUserReviewScoreResponse:
+        """
+        Get review score statistics for a specific user within a project.
+
+        Parameters
+        ----------
+        id : int
+
+        user_pk : int
+
+        per_label : typing.Optional[bool]
+            Calculate agreement per label
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        StatsIaaResponse
-            Inter-Annotator Agreement matrix
+        StatsUserReviewScoreResponse
+            Individual user review score statistics
 
         Examples
         --------
@@ -203,30 +1162,28 @@ class AsyncStatsClient:
 
 
         async def main() -> None:
-            await client.projects.stats.iaa(
+            await client.projects.stats.user_review_score(
                 id=1,
+                user_pk=1,
             )
 
 
         asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            f"api/projects/{jsonable_encoder(id)}/stats/IAA",
+            f"api/projects/{jsonable_encoder(id)}/user-stats/{jsonable_encoder(user_pk)}/review_score",
             method="GET",
             params={
-                "expand": expand,
                 "per_label": per_label,
-                "std": std,
-                "task": task,
             },
             request_options=request_options,
         )
         try:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
-                    StatsIaaResponse,
+                    StatsUserReviewScoreResponse,
                     construct_type(
-                        type_=StatsIaaResponse,  # type: ignore
+                        type_=StatsUserReviewScoreResponse,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
@@ -235,32 +1192,33 @@ class AsyncStatsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    async def total_agreement(
+    async def user_ground_truth_agreement(
         self,
         id: int,
+        user_pk: int,
         *,
         per_label: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> StatsTotalAgreementResponse:
+    ) -> StatsUserGroundTruthAgreementResponse:
         """
-        Overall or per-label total agreement across the project.
-
-        NOTE: due to an open issue in Fern, SDK clients will raise ApiError upon handling a 204 response. As a workaround, wrap call to this function in a try-except block.
+        Get ground truth agreement statistics for a specific user within a project.
 
         Parameters
         ----------
         id : int
 
+        user_pk : int
+
         per_label : typing.Optional[bool]
-            Return agreement per label
+            Calculate agreement per label
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        StatsTotalAgreementResponse
-            Total agreement
+        StatsUserGroundTruthAgreementResponse
+            Individual user ground truth agreement statistics
 
         Examples
         --------
@@ -274,15 +1232,16 @@ class AsyncStatsClient:
 
 
         async def main() -> None:
-            await client.projects.stats.total_agreement(
+            await client.projects.stats.user_ground_truth_agreement(
                 id=1,
+                user_pk=1,
             )
 
 
         asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            f"api/projects/{jsonable_encoder(id)}/stats/total_agreement",
+            f"api/projects/{jsonable_encoder(id)}/users/{jsonable_encoder(user_pk)}/stats/agreement-groundtruth",
             method="GET",
             params={
                 "per_label": per_label,
@@ -292,9 +1251,9 @@ class AsyncStatsClient:
         try:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
-                    StatsTotalAgreementResponse,
+                    StatsUserGroundTruthAgreementResponse,
                     construct_type(
-                        type_=StatsTotalAgreementResponse,  # type: ignore
+                        type_=StatsUserGroundTruthAgreementResponse,  # type: ignore
                         object_=_response.json(),
                     ),
                 )