agentmail 2.0.1__tar.gz → 2.0.2__tar.gz

{agentmail-2.0.1 → agentmail-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: agentmail
-Version: 2.0.1
+Version: 2.0.2
 Summary: 
 License: MIT
 Requires-Python: >=3.8,<4.0

{agentmail-2.0.1 → agentmail-2.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ dynamic = ["version"]
 
 [tool.poetry]
 name = "agentmail"
-version = "2.0.1"
+version = "2.0.2"
 description = ""
 readme = "README.md"
 authors = []

{agentmail-2.0.1 → agentmail-2.0.2}/src/agentmail/__init__.py

@@ -50,7 +50,15 @@ if typing.TYPE_CHECKING:
         webhooks,
         websockets,
     )
-    from .accounts import Account, AccountId, ListAccountsResponse, ProviderId
+    from .accounts import (
+        Account,
+        AccountId,
+        AccountStatus,
+        ListAccountsResponse,
+        ProviderId,
+        UpdateAccountRequest,
+        UpdateAccountStatus,
+    )
     from .agent import AgentSignupRequest, AgentSignupResponse, AgentVerifyRequest, AgentVerifyResponse
     from .api_keys import (
         AcceptDisclosure,
@@ -286,6 +294,7 @@ _dynamic_imports: typing.Dict[str, str] = {
     "AcceptDisclosure": ".api_keys",
     "Account": ".accounts",
     "AccountId": ".accounts",
+    "AccountStatus": ".accounts",
     "Addresses": ".messages",
     "After": ".types",
     "AgentMail": ".client",
@@ -515,6 +524,8 @@ _dynamic_imports: typing.Dict[str, str] = {
     "TrackOpens": ".messages",
     "TrackingEnabled": ".domains",
     "UnprocessableError": ".errors",
+    "UpdateAccountRequest": ".accounts",
+    "UpdateAccountStatus": ".accounts",
     "UpdateApiKeyRequest": ".api_keys",
     "UpdateDomainRequest": ".domains",
     "UpdateDraftRequest": ".drafts",
@@ -580,6 +591,7 @@ __all__ = [
     "AcceptDisclosure",
     "Account",
     "AccountId",
+    "AccountStatus",
     "Addresses",
     "After",
     "AgentMail",
@@ -809,6 +821,8 @@ __all__ = [
     "TrackOpens",
     "TrackingEnabled",
     "UnprocessableError",
+    "UpdateAccountRequest",
+    "UpdateAccountStatus",
     "UpdateApiKeyRequest",
     "UpdateDomainRequest",
     "UpdateDraftRequest",

{agentmail-2.0.1 → agentmail-2.0.2}/src/agentmail/accounts/__init__.py

@@ -6,12 +6,23 @@ import typing
 from importlib import import_module
 
 if typing.TYPE_CHECKING:
-    from .types import Account, AccountId, ListAccountsResponse, ProviderId
+    from .types import (
+        Account,
+        AccountId,
+        AccountStatus,
+        ListAccountsResponse,
+        ProviderId,
+        UpdateAccountRequest,
+        UpdateAccountStatus,
+    )
 _dynamic_imports: typing.Dict[str, str] = {
     "Account": ".types",
     "AccountId": ".types",
+    "AccountStatus": ".types",
     "ListAccountsResponse": ".types",
     "ProviderId": ".types",
+    "UpdateAccountRequest": ".types",
+    "UpdateAccountStatus": ".types",
 }
 
 
@@ -36,4 +47,12 @@ def __dir__():
     return sorted(lazy_attrs)
 
 
-__all__ = ["Account", "AccountId", "ListAccountsResponse", "ProviderId"]
+__all__ = [
+    "Account",
+    "AccountId",
+    "AccountStatus",
+    "ListAccountsResponse",
+    "ProviderId",
+    "UpdateAccountRequest",
+    "UpdateAccountStatus",
+]

agentmail-2.0.2/src/agentmail/accounts/client.py

@@ -0,0 +1,337 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.request_options import RequestOptions
+from ..types.ascending import Ascending
+from ..types.limit import Limit
+from ..types.page_token import PageToken
+from .raw_client import AsyncRawAccountsClient, RawAccountsClient
+from .types.account import Account
+from .types.account_id import AccountId
+from .types.list_accounts_response import ListAccountsResponse
+from .types.update_account_status import UpdateAccountStatus
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class AccountsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawAccountsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawAccountsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawAccountsClient
+        """
+        return self._raw_client
+
+    def list(
+        self,
+        *,
+        limit: typing.Optional[Limit] = None,
+        page_token: typing.Optional[PageToken] = None,
+        ascending: typing.Optional[Ascending] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ListAccountsResponse:
+        """
+        Lists accounts across all providers, scoped to the API key: an
+        organization key sees every account, a pod key its pod's, an inbox key
+        its inbox's. Requires `inbox_read`.
+
+        Parameters
+        ----------
+        limit : typing.Optional[Limit]
+
+        page_token : typing.Optional[PageToken]
+
+        ascending : typing.Optional[Ascending]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ListAccountsResponse
+
+        Examples
+        --------
+        from agentmail import AgentMail
+
+        client = AgentMail(
+            api_key="YOUR_API_KEY",
+        )
+        client.accounts.list()
+        """
+        _response = self._raw_client.list(
+            limit=limit, page_token=page_token, ascending=ascending, request_options=request_options
+        )
+        return _response.data
+
+    def get(self, account_id: AccountId, *, request_options: typing.Optional[RequestOptions] = None) -> Account:
+        """
+        Returns one account by ID. An account outside the key's scope is a 404.
+        Requires `inbox_read`.
+
+        Parameters
+        ----------
+        account_id : AccountId
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Account
+
+        Examples
+        --------
+        import uuid
+
+        from agentmail import AgentMail
+
+        client = AgentMail(
+            api_key="YOUR_API_KEY",
+        )
+        client.accounts.get(
+            account_id=uuid.UUID(
+                "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
+            ),
+        )
+        """
+        _response = self._raw_client.get(account_id, request_options=request_options)
+        return _response.data
+
+    def update(
+        self,
+        account_id: AccountId,
+        *,
+        status: typing.Optional[UpdateAccountStatus] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> Account:
+        """
+        Updates one account. Set `status` to `disabled` to stop the inbox from
+        signing in at the provider again, or to `enabled` to re-enable it.
+        Idempotent: disabling an already disabled account keeps its original
+        `disabled_at`, and enabling an enabled account is a no-op.
+
+        Find the `account_id` with List Accounts. An account exists only after an
+        inbox's first sign-in at a provider, so it cannot be disabled in advance.
+        A disable applies to that inbox at that provider whichever sign-in key is
+        used: the provider's next authorization ends in `access_denied`, and a code
+        issued earlier is refused with `invalid_grant`. Access tokens already
+        issued stay valid until they expire, and the provider's own session is
+        unaffected.
+
+        Requires `account_update`, which sign-in keys (`type: public_key`) cannot
+        hold, so call this with a bearer API key. An account outside the key's
+        scope is a 404. A 409 means the account changed during the write; read it
+        again and retry.
+
+        Parameters
+        ----------
+        account_id : AccountId
+
+        status : typing.Optional[UpdateAccountStatus]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Account
+
+        Examples
+        --------
+        import uuid
+
+        from agentmail import AgentMail
+
+        client = AgentMail(
+            api_key="YOUR_API_KEY",
+        )
+        client.accounts.update(
+            account_id=uuid.UUID(
+                "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
+            ),
+        )
+        """
+        _response = self._raw_client.update(account_id, status=status, request_options=request_options)
+        return _response.data
+
+
+class AsyncAccountsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawAccountsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawAccountsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawAccountsClient
+        """
+        return self._raw_client
+
+    async def list(
+        self,
+        *,
+        limit: typing.Optional[Limit] = None,
+        page_token: typing.Optional[PageToken] = None,
+        ascending: typing.Optional[Ascending] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ListAccountsResponse:
+        """
+        Lists accounts across all providers, scoped to the API key: an
+        organization key sees every account, a pod key its pod's, an inbox key
+        its inbox's. Requires `inbox_read`.
+
+        Parameters
+        ----------
+        limit : typing.Optional[Limit]
+
+        page_token : typing.Optional[PageToken]
+
+        ascending : typing.Optional[Ascending]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ListAccountsResponse
+
+        Examples
+        --------
+        import asyncio
+
+        from agentmail import AsyncAgentMail
+
+        client = AsyncAgentMail(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.accounts.list()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.list(
+            limit=limit, page_token=page_token, ascending=ascending, request_options=request_options
+        )
+        return _response.data
+
+    async def get(self, account_id: AccountId, *, request_options: typing.Optional[RequestOptions] = None) -> Account:
+        """
+        Returns one account by ID. An account outside the key's scope is a 404.
+        Requires `inbox_read`.
+
+        Parameters
+        ----------
+        account_id : AccountId
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Account
+
+        Examples
+        --------
+        import asyncio
+        import uuid
+
+        from agentmail import AsyncAgentMail
+
+        client = AsyncAgentMail(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.accounts.get(
+                account_id=uuid.UUID(
+                    "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
+                ),
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get(account_id, request_options=request_options)
+        return _response.data
+
+    async def update(
+        self,
+        account_id: AccountId,
+        *,
+        status: typing.Optional[UpdateAccountStatus] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> Account:
+        """
+        Updates one account. Set `status` to `disabled` to stop the inbox from
+        signing in at the provider again, or to `enabled` to re-enable it.
+        Idempotent: disabling an already disabled account keeps its original
+        `disabled_at`, and enabling an enabled account is a no-op.
+
+        Find the `account_id` with List Accounts. An account exists only after an
+        inbox's first sign-in at a provider, so it cannot be disabled in advance.
+        A disable applies to that inbox at that provider whichever sign-in key is
+        used: the provider's next authorization ends in `access_denied`, and a code
+        issued earlier is refused with `invalid_grant`. Access tokens already
+        issued stay valid until they expire, and the provider's own session is
+        unaffected.
+
+        Requires `account_update`, which sign-in keys (`type: public_key`) cannot
+        hold, so call this with a bearer API key. An account outside the key's
+        scope is a 404. A 409 means the account changed during the write; read it
+        again and retry.
+
+        Parameters
+        ----------
+        account_id : AccountId
+
+        status : typing.Optional[UpdateAccountStatus]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Account
+
+        Examples
+        --------
+        import asyncio
+        import uuid
+
+        from agentmail import AsyncAgentMail
+
+        client = AsyncAgentMail(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.accounts.update(
+                account_id=uuid.UUID(
+                    "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
+                ),
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.update(account_id, status=status, request_options=request_options)
+        return _response.data