agenta 0.36.5__tar.gz → 0.37.0__tar.gz

{agenta-0.36.5 → agenta-0.37.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: agenta
-Version: 0.36.5
+Version: 0.37.0
 Summary: The SDK for agenta is an open-source LLMOps platform.
 Keywords: LLMOps,LLM,evaluation,prompt engineering
 Author: Mahmoud Mabrouk
@@ -15,20 +15,16 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries
-Requires-Dist: cachetools (>=5.3.3,<6.0.0)
-Requires-Dist: docker (>=6.1.1,<8.0.0)
 Requires-Dist: fastapi (>=0.100.0)
 Requires-Dist: httpx (>=0.24,<0.28)
 Requires-Dist: importlib-metadata (>=8.0.0,<9.0)
 Requires-Dist: litellm (>=1.48.0,<2.0.0)
 Requires-Dist: opentelemetry-api (==1.27.0)
-Requires-Dist: opentelemetry-exporter-otlp (==1.27.0)
+Requires-Dist: opentelemetry-exporter-otlp-proto-http (==1.27.0)
 Requires-Dist: opentelemetry-sdk (==1.27.0)
-Requires-Dist: posthog (>=3.1.0,<4.0.0)
 Requires-Dist: pydantic (>=2)
 Requires-Dist: python-dotenv (>=1.0.0,<2.0.0)
 Requires-Dist: pyyaml (>=6.0.2,<7.0.0)
-Requires-Dist: questionary (>=1.10,<3.0)
 Requires-Dist: toml (>=0.10.2,<0.11.0)
 Project-URL: Documentation, https://docs.agenta.ai
 Project-URL: Homepage, https://agenta.ai

{agenta-0.36.5 → agenta-0.37.0}/agenta/__init__.py

@@ -2,7 +2,7 @@ from typing import Any, Callable, Optional
 
 from .sdk.utils.preinit import PreInitObject
 
-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 .sdk.types import (
     MCField,
@@ -27,7 +27,6 @@ from .sdk.tracing.conventions import Reference
 from .sdk.decorators.routing import entrypoint, app, route
 from .sdk.agenta_init import Config, AgentaSingleton, init as _init
 from .sdk.utils.costs import calculate_token_usage
-from .sdk.client import Agenta
 from .sdk.litellm import litellm as callbacks
 from .sdk.managers.apps import AppManager
 from .sdk.managers.vault import VaultManager

{agenta-0.36.5 → agenta-0.37.0}/agenta/client/__init__.py

@@ -1,6 +1,6 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from .types import (
+from .backend.types import (
     AccountResponse,
     AgentaNodeDto,
     AgentaNodeDtoNodesValue,
@@ -83,8 +83,6 @@ from .types import (
     ProjectRequest,
     ProjectScope,
     ProjectsResponse,
-    ProviderKeyDto,
-    ProviderKind,
     Reference,
     ReferenceDto,
     ReferenceRequestModel,
@@ -123,8 +121,8 @@ from .types import (
     WorkspaceRole,
     WorkspaceRoleResponse,
 )
-from .errors import UnprocessableEntityError
-from . import (
+from .backend.errors import UnprocessableEntityError
+from .backend import (
     access_control,
     admin,
     apps,
@@ -142,9 +140,9 @@ from . import (
     vault,
 )
 from .client import AgentaApi, AsyncAgentaApi
-from .containers import ContainerTemplatesResponse
-from .observability import Format, QueryAnalyticsResponse, QueryTracesResponse
-from .variants import AddVariantFromBaseAndConfigResponse
+from .backend.containers import ContainerTemplatesResponse
+from .backend.observability import Format, QueryAnalyticsResponse, QueryTracesResponse
+from .backend.variants import AddVariantFromBaseAndConfigResponse
 
 __all__ = [
     "AccountResponse",
@@ -234,8 +232,6 @@ __all__ = [
     "ProjectRequest",
     "ProjectScope",
     "ProjectsResponse",
-    "ProviderKeyDto",
-    "ProviderKind",
     "QueryAnalyticsResponse",
     "QueryTracesResponse",
     "Reference",

{agenta-0.36.5/agenta/client → agenta-0.37.0/agenta/client/backend}/admin/client.py

@@ -118,6 +118,7 @@ class AdminClient:
             },
             organization_memberships={
                 "key": OrganizationMembershipRequest(
+                    role="owner",
                     is_demo=True,
                     user_ref=Reference(),
                     organization_ref=Reference(),
@@ -390,6 +391,7 @@ class AsyncAdminClient:
                 },
                 organization_memberships={
                     "key": OrganizationMembershipRequest(
+                        role="owner",
                         is_demo=True,
                         user_ref=Reference(),
                         organization_ref=Reference(),

agenta-0.37.0/agenta/client/backend/api_keys/client.py

@@ -0,0 +1,531 @@
+# 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.list_api_keys_response import ListApiKeysResponse
+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 ApiKeysClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def list_api_keys(
+        self, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[ListApiKeysResponse]:
+        """
+        List all API keys associated with the authenticated user.
+
+        Args:
+            request (Request): The incoming request object.
+
+        Returns:
+            List[ListAPIKeysResponse]: A list of API Keys associated with the user.
+
+        Parameters
+        ----------
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[ListApiKeysResponse]
+            Successful Response
+
+        Examples
+        --------
+        from agenta import AgentaApi
+
+        client = AgentaApi(
+            api_key="YOUR_API_KEY",
+            base_url="https://yourhost.com/path/to/api",
+        )
+        client.api_keys.list_api_keys()
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "keys",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[ListApiKeysResponse],
+                    parse_obj_as(
+                        type_=typing.List[ListApiKeysResponse],  # 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 create_api_key(
+        self, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> str:
+        """
+        Creates an API key for a user.
+
+        Args:
+            request (Request): The request object containing the user ID in the request state.
+
+        Returns:
+            str: The created API key.
+
+        Parameters
+        ----------
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        str
+            Successful Response
+
+        Examples
+        --------
+        from agenta import AgentaApi
+
+        client = AgentaApi(
+            api_key="YOUR_API_KEY",
+            base_url="https://yourhost.com/path/to/api",
+        )
+        client.api_keys.create_api_key()
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "keys",
+            method="POST",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    str,
+                    parse_obj_as(
+                        type_=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 delete_api_key(
+        self,
+        key_prefix: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.Dict[str, typing.Optional[typing.Any]]:
+        """
+        Delete an API key with the given key prefix for the authenticated user.
+
+        Args:
+            key_prefix (str): The prefix of the API key to be deleted.
+            request (Request): The incoming request object.
+
+        Returns:
+            dict: A dictionary containing a success message upon successful deletion.
+
+        Raises:
+            HTTPException: If the API key is not found or does not belong to the user.
+
+        Parameters
+        ----------
+        key_prefix : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.Dict[str, 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.api_keys.delete_api_key(
+            key_prefix="key_prefix",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"keys/{jsonable_encoder(key_prefix)}",
+            method="DELETE",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.Dict[str, typing.Optional[typing.Any]],
+                    parse_obj_as(
+                        type_=typing.Dict[str, 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)
+
+    def validate_api_key(
+        self,
+        key_prefix: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> bool:
+        """
+        This Function is called by the CLI and is used to validate an API key provided by a user in agenta init setup.
+        Returns:
+            bool: True. If the request reaches this point, the API key is valid.
+
+        Parameters
+        ----------
+        key_prefix : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        bool
+            Successful Response
+
+        Examples
+        --------
+        from agenta import AgentaApi
+
+        client = AgentaApi(
+            api_key="YOUR_API_KEY",
+            base_url="https://yourhost.com/path/to/api",
+        )
+        client.api_keys.validate_api_key(
+            key_prefix="key_prefix",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"keys/{jsonable_encoder(key_prefix)}/validate",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    bool,
+                    parse_obj_as(
+                        type_=bool,  # 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 AsyncApiKeysClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def list_api_keys(
+        self, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[ListApiKeysResponse]:
+        """
+        List all API keys associated with the authenticated user.
+
+        Args:
+            request (Request): The incoming request object.
+
+        Returns:
+            List[ListAPIKeysResponse]: A list of API Keys associated with the user.
+
+        Parameters
+        ----------
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[ListApiKeysResponse]
+            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.api_keys.list_api_keys()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "keys",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[ListApiKeysResponse],
+                    parse_obj_as(
+                        type_=typing.List[ListApiKeysResponse],  # 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 create_api_key(
+        self, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> str:
+        """
+        Creates an API key for a user.
+
+        Args:
+            request (Request): The request object containing the user ID in the request state.
+
+        Returns:
+            str: The created API key.
+
+        Parameters
+        ----------
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        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.api_keys.create_api_key()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "keys",
+            method="POST",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    str,
+                    parse_obj_as(
+                        type_=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 delete_api_key(
+        self,
+        key_prefix: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.Dict[str, typing.Optional[typing.Any]]:
+        """
+        Delete an API key with the given key prefix for the authenticated user.
+
+        Args:
+            key_prefix (str): The prefix of the API key to be deleted.
+            request (Request): The incoming request object.
+
+        Returns:
+            dict: A dictionary containing a success message upon successful deletion.
+
+        Raises:
+            HTTPException: If the API key is not found or does not belong to the user.
+
+        Parameters
+        ----------
+        key_prefix : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.Dict[str, 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.api_keys.delete_api_key(
+                key_prefix="key_prefix",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"keys/{jsonable_encoder(key_prefix)}",
+            method="DELETE",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.Dict[str, typing.Optional[typing.Any]],
+                    parse_obj_as(
+                        type_=typing.Dict[str, 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)
+
+    async def validate_api_key(
+        self,
+        key_prefix: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> bool:
+        """
+        This Function is called by the CLI and is used to validate an API key provided by a user in agenta init setup.
+        Returns:
+            bool: True. If the request reaches this point, the API key is valid.
+
+        Parameters
+        ----------
+        key_prefix : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        bool
+            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.api_keys.validate_api_key(
+                key_prefix="key_prefix",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"keys/{jsonable_encoder(key_prefix)}/validate",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    bool,
+                    parse_obj_as(
+                        type_=bool,  # 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)