# This file was auto-generated by Fern from our API Definition.

import datetime as dt
import typing

from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
from ..core.request_options import RequestOptions
from .raw_client import AsyncRawExperimentsClient, RawExperimentsClient
from .types.experiment_items_response import ExperimentItemsResponse
from .types.experiments_response import ExperimentsResponse


class ExperimentsClient:
    def __init__(self, *, client_wrapper: SyncClientWrapper):
        self._raw_client = RawExperimentsClient(client_wrapper=client_wrapper)

    @property
    def with_raw_response(self) -> RawExperimentsClient:
        """
        Retrieves a raw implementation of this client that returns raw responses.

        Returns
        -------
        RawExperimentsClient
        """
        return self._raw_client

    def list(
        self,
        *,
        from_start_time: dt.datetime,
        fields: typing.Optional[str] = None,
        limit: typing.Optional[int] = None,
        score_limit: typing.Optional[int] = None,
        cursor: typing.Optional[str] = None,
        to_start_time: typing.Optional[dt.datetime] = None,
        id: typing.Optional[str] = None,
        name: typing.Optional[str] = None,
        dataset_id: typing.Optional[str] = None,
        filter: typing.Optional[str] = None,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> ExperimentsResponse:
        """
        List experiments with cursor-based pagination. Results are ordered by
        latest experiment activity descending.

        Parameters
        ----------
        from_start_time : dt.datetime
            Retrieve only experiments on or after this datetime.

        fields : typing.Optional[str]
            Comma-separated list of field groups to include. Available groups:
            `core`, `metadata`, `scores`. If omitted, `core` is returned.

        limit : typing.Optional[int]
            Number of experiments to return per page. Maximum 100, default 50.

        score_limit : typing.Optional[int]
            Number of scores to return per experiment when `fields=scores` is requested. Maximum 50, default 50.

        cursor : typing.Optional[str]
            Versioned base64url cursor from the previous response page.

        to_start_time : typing.Optional[dt.datetime]
            Retrieve only experiments before this datetime.

        id : typing.Optional[str]
            Comma-separated list of experiment IDs.

        name : typing.Optional[str]
            Comma-separated list of experiment names.

        dataset_id : typing.Optional[str]
            Comma-separated list of dataset IDs.

        filter : typing.Optional[str]
            JSON string containing an array of structured filter conditions.
            Supported columns are `id`, `name`, and `datasetId`.

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        ExperimentsResponse

        Examples
        --------
        import datetime

        from langfuse import LangfuseAPI

        client = LangfuseAPI(
            x_langfuse_sdk_name="YOUR_X_LANGFUSE_SDK_NAME",
            x_langfuse_sdk_version="YOUR_X_LANGFUSE_SDK_VERSION",
            x_langfuse_public_key="YOUR_X_LANGFUSE_PUBLIC_KEY",
            username="YOUR_USERNAME",
            password="YOUR_PASSWORD",
            base_url="https://yourhost.com/path/to/api",
        )
        client.experiments.list(
            from_start_time=datetime.datetime.fromisoformat(
                "2024-01-15 09:30:00+00:00",
            ),
        )
        """
        _response = self._raw_client.list(
            from_start_time=from_start_time,
            fields=fields,
            limit=limit,
            score_limit=score_limit,
            cursor=cursor,
            to_start_time=to_start_time,
            id=id,
            name=name,
            dataset_id=dataset_id,
            filter=filter,
            request_options=request_options,
        )
        return _response.data

    def list_items(
        self,
        *,
        from_start_time: dt.datetime,
        fields: typing.Optional[str] = None,
        limit: typing.Optional[int] = None,
        score_limit: typing.Optional[int] = None,
        cursor: typing.Optional[str] = None,
        to_start_time: typing.Optional[dt.datetime] = None,
        experiment_id: typing.Optional[str] = None,
        experiment_name: typing.Optional[str] = None,
        experiment_item_id: typing.Optional[str] = None,
        dataset_id: typing.Optional[str] = None,
        filter: typing.Optional[str] = None,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> ExperimentItemsResponse:
        """
        List experiment items with cursor-based pagination. Use this endpoint
        to export experiment item inputs, outputs, expected outputs, metadata,
        and optionally item/trace scores. Results are ordered by time
        descending.

        Parameters
        ----------
        from_start_time : dt.datetime
            Retrieve only experiment items started on or after this datetime.

        fields : typing.Optional[str]
            Comma-separated list of field groups to include. Available groups:
            `core`, `dataset`, `io`, `metadata`, `itemMetadata`,
            `experimentMetadata`, `scores`. If omitted, `core,dataset` is
            returned.

        limit : typing.Optional[int]
            Number of experiment items to return per page. Maximum 100, default 50.

        score_limit : typing.Optional[int]
            Number of scores to return per experiment item when `fields=scores` is requested. Maximum 50, default 50.

        cursor : typing.Optional[str]
            Versioned base64url cursor from the previous response page.

        to_start_time : typing.Optional[dt.datetime]
            Retrieve only experiment items started before this datetime.

        experiment_id : typing.Optional[str]
            Comma-separated list of experiment IDs.

        experiment_name : typing.Optional[str]
            Comma-separated list of experiment names.

        experiment_item_id : typing.Optional[str]
            Comma-separated list of experiment item IDs.

        dataset_id : typing.Optional[str]
            Comma-separated list of dataset IDs.

        filter : typing.Optional[str]
            JSON string containing an array of structured filter conditions.
            Supported columns are `experimentId`, `experimentName`,
            `experimentItemId`, and `datasetId`.

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        ExperimentItemsResponse

        Examples
        --------
        import datetime

        from langfuse import LangfuseAPI

        client = LangfuseAPI(
            x_langfuse_sdk_name="YOUR_X_LANGFUSE_SDK_NAME",
            x_langfuse_sdk_version="YOUR_X_LANGFUSE_SDK_VERSION",
            x_langfuse_public_key="YOUR_X_LANGFUSE_PUBLIC_KEY",
            username="YOUR_USERNAME",
            password="YOUR_PASSWORD",
            base_url="https://yourhost.com/path/to/api",
        )
        client.experiments.list_items(
            from_start_time=datetime.datetime.fromisoformat(
                "2024-01-15 09:30:00+00:00",
            ),
        )
        """
        _response = self._raw_client.list_items(
            from_start_time=from_start_time,
            fields=fields,
            limit=limit,
            score_limit=score_limit,
            cursor=cursor,
            to_start_time=to_start_time,
            experiment_id=experiment_id,
            experiment_name=experiment_name,
            experiment_item_id=experiment_item_id,
            dataset_id=dataset_id,
            filter=filter,
            request_options=request_options,
        )
        return _response.data


class AsyncExperimentsClient:
    def __init__(self, *, client_wrapper: AsyncClientWrapper):
        self._raw_client = AsyncRawExperimentsClient(client_wrapper=client_wrapper)

    @property
    def with_raw_response(self) -> AsyncRawExperimentsClient:
        """
        Retrieves a raw implementation of this client that returns raw responses.

        Returns
        -------
        AsyncRawExperimentsClient
        """
        return self._raw_client

    async def list(
        self,
        *,
        from_start_time: dt.datetime,
        fields: typing.Optional[str] = None,
        limit: typing.Optional[int] = None,
        score_limit: typing.Optional[int] = None,
        cursor: typing.Optional[str] = None,
        to_start_time: typing.Optional[dt.datetime] = None,
        id: typing.Optional[str] = None,
        name: typing.Optional[str] = None,
        dataset_id: typing.Optional[str] = None,
        filter: typing.Optional[str] = None,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> ExperimentsResponse:
        """
        List experiments with cursor-based pagination. Results are ordered by
        latest experiment activity descending.

        Parameters
        ----------
        from_start_time : dt.datetime
            Retrieve only experiments on or after this datetime.

        fields : typing.Optional[str]
            Comma-separated list of field groups to include. Available groups:
            `core`, `metadata`, `scores`. If omitted, `core` is returned.

        limit : typing.Optional[int]
            Number of experiments to return per page. Maximum 100, default 50.

        score_limit : typing.Optional[int]
            Number of scores to return per experiment when `fields=scores` is requested. Maximum 50, default 50.

        cursor : typing.Optional[str]
            Versioned base64url cursor from the previous response page.

        to_start_time : typing.Optional[dt.datetime]
            Retrieve only experiments before this datetime.

        id : typing.Optional[str]
            Comma-separated list of experiment IDs.

        name : typing.Optional[str]
            Comma-separated list of experiment names.

        dataset_id : typing.Optional[str]
            Comma-separated list of dataset IDs.

        filter : typing.Optional[str]
            JSON string containing an array of structured filter conditions.
            Supported columns are `id`, `name`, and `datasetId`.

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        ExperimentsResponse

        Examples
        --------
        import asyncio
        import datetime

        from langfuse import AsyncLangfuseAPI

        client = AsyncLangfuseAPI(
            x_langfuse_sdk_name="YOUR_X_LANGFUSE_SDK_NAME",
            x_langfuse_sdk_version="YOUR_X_LANGFUSE_SDK_VERSION",
            x_langfuse_public_key="YOUR_X_LANGFUSE_PUBLIC_KEY",
            username="YOUR_USERNAME",
            password="YOUR_PASSWORD",
            base_url="https://yourhost.com/path/to/api",
        )


        async def main() -> None:
            await client.experiments.list(
                from_start_time=datetime.datetime.fromisoformat(
                    "2024-01-15 09:30:00+00:00",
                ),
            )


        asyncio.run(main())
        """
        _response = await self._raw_client.list(
            from_start_time=from_start_time,
            fields=fields,
            limit=limit,
            score_limit=score_limit,
            cursor=cursor,
            to_start_time=to_start_time,
            id=id,
            name=name,
            dataset_id=dataset_id,
            filter=filter,
            request_options=request_options,
        )
        return _response.data

    async def list_items(
        self,
        *,
        from_start_time: dt.datetime,
        fields: typing.Optional[str] = None,
        limit: typing.Optional[int] = None,
        score_limit: typing.Optional[int] = None,
        cursor: typing.Optional[str] = None,
        to_start_time: typing.Optional[dt.datetime] = None,
        experiment_id: typing.Optional[str] = None,
        experiment_name: typing.Optional[str] = None,
        experiment_item_id: typing.Optional[str] = None,
        dataset_id: typing.Optional[str] = None,
        filter: typing.Optional[str] = None,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> ExperimentItemsResponse:
        """
        List experiment items with cursor-based pagination. Use this endpoint
        to export experiment item inputs, outputs, expected outputs, metadata,
        and optionally item/trace scores. Results are ordered by time
        descending.

        Parameters
        ----------
        from_start_time : dt.datetime
            Retrieve only experiment items started on or after this datetime.

        fields : typing.Optional[str]
            Comma-separated list of field groups to include. Available groups:
            `core`, `dataset`, `io`, `metadata`, `itemMetadata`,
            `experimentMetadata`, `scores`. If omitted, `core,dataset` is
            returned.

        limit : typing.Optional[int]
            Number of experiment items to return per page. Maximum 100, default 50.

        score_limit : typing.Optional[int]
            Number of scores to return per experiment item when `fields=scores` is requested. Maximum 50, default 50.

        cursor : typing.Optional[str]
            Versioned base64url cursor from the previous response page.

        to_start_time : typing.Optional[dt.datetime]
            Retrieve only experiment items started before this datetime.

        experiment_id : typing.Optional[str]
            Comma-separated list of experiment IDs.

        experiment_name : typing.Optional[str]
            Comma-separated list of experiment names.

        experiment_item_id : typing.Optional[str]
            Comma-separated list of experiment item IDs.

        dataset_id : typing.Optional[str]
            Comma-separated list of dataset IDs.

        filter : typing.Optional[str]
            JSON string containing an array of structured filter conditions.
            Supported columns are `experimentId`, `experimentName`,
            `experimentItemId`, and `datasetId`.

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        ExperimentItemsResponse

        Examples
        --------
        import asyncio
        import datetime

        from langfuse import AsyncLangfuseAPI

        client = AsyncLangfuseAPI(
            x_langfuse_sdk_name="YOUR_X_LANGFUSE_SDK_NAME",
            x_langfuse_sdk_version="YOUR_X_LANGFUSE_SDK_VERSION",
            x_langfuse_public_key="YOUR_X_LANGFUSE_PUBLIC_KEY",
            username="YOUR_USERNAME",
            password="YOUR_PASSWORD",
            base_url="https://yourhost.com/path/to/api",
        )


        async def main() -> None:
            await client.experiments.list_items(
                from_start_time=datetime.datetime.fromisoformat(
                    "2024-01-15 09:30:00+00:00",
                ),
            )


        asyncio.run(main())
        """
        _response = await self._raw_client.list_items(
            from_start_time=from_start_time,
            fields=fields,
            limit=limit,
            score_limit=score_limit,
            cursor=cursor,
            to_start_time=to_start_time,
            experiment_id=experiment_id,
            experiment_name=experiment_name,
            experiment_item_id=experiment_item_id,
            dataset_id=dataset_id,
            filter=filter,
            request_options=request_options,
        )
        return _response.data