agenta 0.36.5__py3-none-any.whl → 0.37.1__py3-none-any.whl

agenta/client/{vault → backend/vault}/client.py

@@ -90,7 +90,13 @@ class VaultClient:
 
         Examples
         --------
-        from agenta import AgentaApi, HeaderDto, ProviderKeyDto, SecretDto
+        from agenta import (
+            AgentaApi,
+            HeaderDto,
+            SecretDto,
+            StandardProviderDto,
+            StandardProviderSettingsDto,
+        )
 
         client = AgentaApi(
             api_key="YOUR_API_KEY",
@@ -99,9 +105,12 @@ class VaultClient:
         client.vault.create_secret(
             header=HeaderDto(),
             secret=SecretDto(
-                data=ProviderKeyDto(
-                    provider="openai",
-                    key="key",
+                kind="provider_key",
+                data=StandardProviderDto(
+                    kind="openai",
+                    provider=StandardProviderSettingsDto(
+                        key="key",
+                    ),
                 ),
             ),
         )
@@ -414,7 +423,13 @@ class AsyncVaultClient:
         --------
         import asyncio
 
-        from agenta import AsyncAgentaApi, HeaderDto, ProviderKeyDto, SecretDto
+        from agenta import (
+            AsyncAgentaApi,
+            HeaderDto,
+            SecretDto,
+            StandardProviderDto,
+            StandardProviderSettingsDto,
+        )
 
         client = AsyncAgentaApi(
             api_key="YOUR_API_KEY",
@@ -426,9 +441,12 @@ class AsyncVaultClient:
             await client.vault.create_secret(
                 header=HeaderDto(),
                 secret=SecretDto(
-                    data=ProviderKeyDto(
-                        provider="openai",
-                        key="key",
+                    kind="provider_key",
+                    data=StandardProviderDto(
+                        kind="openai",
+                        provider=StandardProviderSettingsDto(
+                            key="key",
+                        ),
                     ),
                 ),
             )

agenta/client/backend/workspace/__init__.py

@@ -0,0 +1 @@
+# This file was auto-generated by Fern from our API Definition.

agenta/client/backend/workspace/client.py

@@ -0,0 +1,405 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.client_wrapper import SyncClientWrapper
+import typing
+from ..core.request_options import RequestOptions
+from ..types.workspace import Workspace
+from ..core.pydantic_utilities import parse_obj_as
+from json.decoder import JSONDecodeError
+from ..core.api_error import ApiError
+from ..core.jsonable_encoder import jsonable_encoder
+from ..errors.unprocessable_entity_error import UnprocessableEntityError
+from ..types.http_validation_error import HttpValidationError
+from ..core.client_wrapper import AsyncClientWrapper
+
+
+class WorkspaceClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def get_workspace(
+        self, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[Workspace]:
+        """
+        Get workspace details.
+
+        Returns details about the workspace associated with the user's session.
+
+        Returns:
+            Workspace: The details of the workspace.
+
+        Raises:
+            HTTPException: If the user does not have permission to perform this action.
+
+        Parameters
+        ----------
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[Workspace]
+            Successful Response
+
+        Examples
+        --------
+        from agenta import AgentaApi
+
+        client = AgentaApi(
+            api_key="YOUR_API_KEY",
+            base_url="https://yourhost.com/path/to/api",
+        )
+        client.workspace.get_workspace()
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "workspaces",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[Workspace],
+                    parse_obj_as(
+                        type_=typing.List[Workspace],  # 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 get_all_workspace_roles(
+        self, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[typing.Dict[str, str]]:
+        """
+        Get all workspace roles.
+
+        Returns a list of all available workspace roles.
+
+        Returns:
+            List[WorkspaceRoleResponse]: A list of WorkspaceRole objects representing the available workspace roles.
+
+        Raises:
+            HTTPException: If an error occurs while retrieving the workspace roles.
+
+        Parameters
+        ----------
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[typing.Dict[str, str]]
+            Successful Response
+
+        Examples
+        --------
+        from agenta import AgentaApi
+
+        client = AgentaApi(
+            api_key="YOUR_API_KEY",
+            base_url="https://yourhost.com/path/to/api",
+        )
+        client.workspace.get_all_workspace_roles()
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "workspaces/roles",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[typing.Dict[str, str]],
+                    parse_obj_as(
+                        type_=typing.List[typing.Dict[str, str]],  # 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 remove_user_from_workspace(
+        self,
+        workspace_id: str,
+        *,
+        email: str,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.Optional[typing.Any]:
+        """
+        Remove a user from a workspace.
+
+        Args:
+            email (str): The email address of the user to be removed
+            workspace_id (str): The ID of the workspace.
+
+        Parameters
+        ----------
+        workspace_id : str
+
+        email : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.Optional[typing.Any]
+            Successful Response
+
+        Examples
+        --------
+        from agenta import AgentaApi
+
+        client = AgentaApi(
+            api_key="YOUR_API_KEY",
+            base_url="https://yourhost.com/path/to/api",
+        )
+        client.workspace.remove_user_from_workspace(
+            workspace_id="workspace_id",
+            email="email",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"workspaces/{jsonable_encoder(workspace_id)}/users",
+            method="DELETE",
+            params={
+                "email": email,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.Optional[typing.Any],
+                    parse_obj_as(
+                        type_=typing.Optional[typing.Any],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            type_=HttpValidationError,  # 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 AsyncWorkspaceClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def get_workspace(
+        self, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[Workspace]:
+        """
+        Get workspace details.
+
+        Returns details about the workspace associated with the user's session.
+
+        Returns:
+            Workspace: The details of the workspace.
+
+        Raises:
+            HTTPException: If the user does not have permission to perform this action.
+
+        Parameters
+        ----------
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[Workspace]
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from agenta import AsyncAgentaApi
+
+        client = AsyncAgentaApi(
+            api_key="YOUR_API_KEY",
+            base_url="https://yourhost.com/path/to/api",
+        )
+
+
+        async def main() -> None:
+            await client.workspace.get_workspace()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "workspaces",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[Workspace],
+                    parse_obj_as(
+                        type_=typing.List[Workspace],  # 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 get_all_workspace_roles(
+        self, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[typing.Dict[str, str]]:
+        """
+        Get all workspace roles.
+
+        Returns a list of all available workspace roles.
+
+        Returns:
+            List[WorkspaceRoleResponse]: A list of WorkspaceRole objects representing the available workspace roles.
+
+        Raises:
+            HTTPException: If an error occurs while retrieving the workspace roles.
+
+        Parameters
+        ----------
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[typing.Dict[str, str]]
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from agenta import AsyncAgentaApi
+
+        client = AsyncAgentaApi(
+            api_key="YOUR_API_KEY",
+            base_url="https://yourhost.com/path/to/api",
+        )
+
+
+        async def main() -> None:
+            await client.workspace.get_all_workspace_roles()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "workspaces/roles",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[typing.Dict[str, str]],
+                    parse_obj_as(
+                        type_=typing.List[typing.Dict[str, str]],  # 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 remove_user_from_workspace(
+        self,
+        workspace_id: str,
+        *,
+        email: str,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.Optional[typing.Any]:
+        """
+        Remove a user from a workspace.
+
+        Args:
+            email (str): The email address of the user to be removed
+            workspace_id (str): The ID of the workspace.
+
+        Parameters
+        ----------
+        workspace_id : str
+
+        email : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.Optional[typing.Any]
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from agenta import AsyncAgentaApi
+
+        client = AsyncAgentaApi(
+            api_key="YOUR_API_KEY",
+            base_url="https://yourhost.com/path/to/api",
+        )
+
+
+        async def main() -> None:
+            await client.workspace.remove_user_from_workspace(
+                workspace_id="workspace_id",
+                email="email",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"workspaces/{jsonable_encoder(workspace_id)}/users",
+            method="DELETE",
+            params={
+                "email": email,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.Optional[typing.Any],
+                    parse_obj_as(
+                        type_=typing.Optional[typing.Any],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            type_=HttpValidationError,  # 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)

agenta/client/client.py

@@ -2,54 +2,54 @@
 
 import typing
 import httpx
-from .core.client_wrapper import SyncClientWrapper
-from .admin.client import AdminClient
-from .vault.client import VaultClient
-from .access_control.client import AccessControlClient
-from .scopes.client import ScopesClient
-from .apps.client import AppsClient
-from .variants.client import VariantsClient
-from .evaluations.client import EvaluationsClient
-from .human_evaluations.client import HumanEvaluationsClient
-from .evaluators.client import EvaluatorsClient
-from .testsets.client import TestsetsClient
-from .containers.client import ContainersClient
-from .environments.client import EnvironmentsClient
-from .bases.client import BasesClient
-from .configs.client import ConfigsClient
-from .observability.client import ObservabilityClient
-from .core.request_options import RequestOptions
-from .types.list_api_keys_response import ListApiKeysResponse
-from .core.pydantic_utilities import parse_obj_as
+from .backend.core.client_wrapper import SyncClientWrapper
+from .backend.admin.client import AdminClient
+from .backend.vault.client import VaultClient
+from .backend.access_control.client import AccessControlClient
+from .backend.scopes.client import ScopesClient
+from .backend.apps.client import AppsClient
+from .backend.variants.client import VariantsClient
+from .backend.evaluations.client import EvaluationsClient
+from .backend.human_evaluations.client import HumanEvaluationsClient
+from .backend.evaluators.client import EvaluatorsClient
+from .backend.testsets.client import TestsetsClient
+from .backend.containers.client import ContainersClient
+from .backend.environments.client import EnvironmentsClient
+from .backend.bases.client import BasesClient
+from .backend.configs.client import ConfigsClient
+from .backend.observability.client import ObservabilityClient
+from .backend.core.request_options import RequestOptions
+from .backend.types.list_api_keys_response import ListApiKeysResponse
+from .backend.core.pydantic_utilities import parse_obj_as
 from json.decoder import JSONDecodeError
-from .core.api_error import ApiError
-from .core.jsonable_encoder import jsonable_encoder
-from .errors.unprocessable_entity_error import UnprocessableEntityError
-from .types.http_validation_error import HttpValidationError
-from .types.organization import Organization
-from .types.organization_output import OrganizationOutput
-from .types.invite_request import InviteRequest
-from .core.serialization import convert_and_respect_annotation_metadata
-from .types.workspace_response import WorkspaceResponse
+from .backend.core.api_error import ApiError
+from .backend.core.jsonable_encoder import jsonable_encoder
+from .backend.errors.unprocessable_entity_error import UnprocessableEntityError
+from .backend.types.http_validation_error import HttpValidationError
+from .backend.types.organization import Organization
+from .backend.types.organization_output import OrganizationOutput
+from .backend.types.invite_request import InviteRequest
+from .backend.core.serialization import convert_and_respect_annotation_metadata
+from .backend.types.workspace_response import WorkspaceResponse
 import datetime as dt
-from .types.workspace_role_response import WorkspaceRoleResponse
-from .types.permission import Permission
-from .core.client_wrapper import AsyncClientWrapper
-from .admin.client import AsyncAdminClient
-from .vault.client import AsyncVaultClient
-from .access_control.client import AsyncAccessControlClient
-from .scopes.client import AsyncScopesClient
-from .apps.client import AsyncAppsClient
-from .variants.client import AsyncVariantsClient
-from .evaluations.client import AsyncEvaluationsClient
-from .human_evaluations.client import AsyncHumanEvaluationsClient
-from .evaluators.client import AsyncEvaluatorsClient
-from .testsets.client import AsyncTestsetsClient
-from .containers.client import AsyncContainersClient
-from .environments.client import AsyncEnvironmentsClient
-from .bases.client import AsyncBasesClient
-from .configs.client import AsyncConfigsClient
-from .observability.client import AsyncObservabilityClient
+from .backend.types.workspace_role_response import WorkspaceRoleResponse
+from .backend.types.permission import Permission
+from .backend.core.client_wrapper import AsyncClientWrapper
+from .backend.admin.client import AsyncAdminClient
+from .backend.vault.client import AsyncVaultClient
+from .backend.access_control.client import AsyncAccessControlClient
+from .backend.scopes.client import AsyncScopesClient
+from .backend.apps.client import AsyncAppsClient
+from .backend.variants.client import AsyncVariantsClient
+from .backend.evaluations.client import AsyncEvaluationsClient
+from .backend.human_evaluations.client import AsyncHumanEvaluationsClient
+from .backend.evaluators.client import AsyncEvaluatorsClient
+from .backend.testsets.client import AsyncTestsetsClient
+from .backend.containers.client import AsyncContainersClient
+from .backend.environments.client import AsyncEnvironmentsClient
+from .backend.bases.client import AsyncBasesClient
+from .backend.configs.client import AsyncConfigsClient
+from .backend.observability.client import AsyncObservabilityClient
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)

agenta/client/types/provider_key_dto.py~feat_model-registry

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
+import pydantic
+
+
+class StandardProviderSettingsDto(UniversalBaseModel):
+    key: str
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(
+            extra="allow", frozen=True
+        )  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

agenta/client/types/provider_kind.py~feat_model-registry

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+StandardProviderKind = typing.Union[
+    typing.Literal[
+        "openai",
+        "cohere",
+        "anyscale",
+        "deepinfra",
+        "alephalpha",
+        "groq",
+        "mistralai",
+        "anthropic",
+        "perplexityai",
+        "togetherai",
+        "openrouter",
+        "gemini",
+    ],
+    typing.Any,
+]

agenta/sdk/__init__.py

@@ -2,7 +2,7 @@ from typing import Optional, Callable, Any
 
 from .utils.preinit import PreInitObject  # always the first import!
 
-import agenta.client.types as client_types  # pylint: disable=wrong-import-order
+import agenta.client.backend.types as client_types  # pylint: disable=wrong-import-order
 
 from .types import (
     DictInput,