agentmail 2.0.3__tar.gz → 2.0.4__tar.gz

{agentmail-2.0.3 → agentmail-2.0.4}/PKG-INFO

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

{agentmail-2.0.3 → agentmail-2.0.4}/pyproject.toml

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

{agentmail-2.0.3 → agentmail-2.0.4}/src/agentmail/__init__.py

@@ -246,11 +246,17 @@ if typing.TYPE_CHECKING:
         MetricLimit,
         Period,
         QueryMetricsResponse,
+        QueryRatesResponse,
         QueryUsageResponse,
+        RatePeriod,
+        RatePoint,
+        RateType,
+        RateTypes,
         Start,
         UsagePoint,
         UsageType,
         UsageTypes,
+        Window,
     )
     from .organizations import Organization
     from .providers import (
@@ -471,7 +477,12 @@ _dynamic_imports: typing.Dict[str, str] = {
     "PublicKeyStatus": ".api_keys",
     "Query": ".types",
     "QueryMetricsResponse": ".metrics",
+    "QueryRatesResponse": ".metrics",
     "QueryUsageResponse": ".metrics",
+    "RatePeriod": ".metrics",
+    "RatePoint": ".metrics",
+    "RateType": ".metrics",
+    "RateTypes": ".metrics",
     "RawMessageResponse": ".messages",
     "Recipient": ".events",
     "RecordStatus": ".domains",
@@ -543,6 +554,7 @@ _dynamic_imports: typing.Dict[str, str] = {
     "ValidationErrorResponse": ".types",
     "VerificationRecord": ".domains",
     "VerificationStatus": ".domains",
+    "Window": ".metrics",
     "__version__": ".version",
     "accounts": ".accounts",
     "agent": ".agent",
@@ -768,7 +780,12 @@ __all__ = [
     "PublicKeyStatus",
     "Query",
     "QueryMetricsResponse",
+    "QueryRatesResponse",
     "QueryUsageResponse",
+    "RatePeriod",
+    "RatePoint",
+    "RateType",
+    "RateTypes",
     "RawMessageResponse",
     "Recipient",
     "RecordStatus",
@@ -840,6 +857,7 @@ __all__ = [
     "ValidationErrorResponse",
     "VerificationRecord",
     "VerificationStatus",
+    "Window",
     "__version__",
     "accounts",
     "agent",

{agentmail-2.0.3 → agentmail-2.0.4}/src/agentmail/core/client_wrapper.py

@@ -28,12 +28,12 @@ class BaseClientWrapper:
         import platform
 
         headers: typing.Dict[str, str] = {
-            "User-Agent": "agentmail/2.0.3",
+            "User-Agent": "agentmail/2.0.4",
             "X-Fern-Language": "Python",
             "X-Fern-Runtime": f"python/{platform.python_version()}",
             "X-Fern-Platform": f"{platform.system().lower()}/{platform.release()}",
             "X-Fern-SDK-Name": "agentmail",
-            "X-Fern-SDK-Version": "2.0.3",
+            "X-Fern-SDK-Version": "2.0.4",
             **(self.get_custom_headers() or {}),
         }
         api_key = self._get_api_key()

{agentmail-2.0.3 → agentmail-2.0.4}/src/agentmail/inboxes/metrics/client.py

@@ -10,9 +10,13 @@ from ...metrics.types.metric_event_types import MetricEventTypes
 from ...metrics.types.metric_limit import MetricLimit
 from ...metrics.types.period import Period
 from ...metrics.types.query_metrics_response import QueryMetricsResponse
+from ...metrics.types.query_rates_response import QueryRatesResponse
 from ...metrics.types.query_usage_response import QueryUsageResponse
+from ...metrics.types.rate_period import RatePeriod
+from ...metrics.types.rate_types import RateTypes
 from ...metrics.types.start import Start
 from ...metrics.types.usage_types import UsageTypes
+from ...metrics.types.window import Window
 from ..types.inbox_id import InboxId
 from .raw_client import AsyncRawMetricsClient, RawMetricsClient
 
@@ -169,6 +173,85 @@ class MetricsClient:
         )
         return _response.data
 
+    def query_rates(
+        self,
+        inbox_id: InboxId,
+        *,
+        rate_types: typing.Optional[RateTypes] = None,
+        start: typing.Optional[Start] = None,
+        end: typing.Optional[End] = None,
+        period: typing.Optional[RatePeriod] = None,
+        window: typing.Optional[Window] = None,
+        limit: typing.Optional[MetricLimit] = None,
+        descending: typing.Optional[Descending] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> QueryRatesResponse:
+        """
+        Rolling bounce and complaint rates for the inbox. At each `period`
+        grid point, the bounced (or complained) messages over the preceding
+        `window` divided by the messages sent over the same window, with the
+        send count alongside. Account moderation evaluates the organization-wide
+        rate, so use the organization endpoint to see the number it acts on;
+        the inbox view shows which inboxes contribute. Defaults to the rolling
+        24-hour rate sampled hourly over the last day; `start` must be within
+        the last 90 days, `window` must be a whole multiple of `period`, and
+        the range plus window divided by `period` must not exceed 1000
+        buckets.
+
+        **CLI:**
+        ```bash
+        agentmail inboxes metrics query-rates --inbox-id <inbox_id>
+        ```
+
+        Parameters
+        ----------
+        inbox_id : InboxId
+
+        rate_types : typing.Optional[RateTypes]
+
+        start : typing.Optional[Start]
+
+        end : typing.Optional[End]
+
+        period : typing.Optional[RatePeriod]
+
+        window : typing.Optional[Window]
+
+        limit : typing.Optional[MetricLimit]
+
+        descending : typing.Optional[Descending]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        QueryRatesResponse
+
+        Examples
+        --------
+        from agentmail import AgentMail
+
+        client = AgentMail(
+            api_key="YOUR_API_KEY",
+        )
+        client.inboxes.metrics.query_rates(
+            inbox_id="inbox_id",
+        )
+        """
+        _response = self._raw_client.query_rates(
+            inbox_id,
+            rate_types=rate_types,
+            start=start,
+            end=end,
+            period=period,
+            window=window,
+            limit=limit,
+            descending=descending,
+            request_options=request_options,
+        )
+        return _response.data
+
 
 class AsyncMetricsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
@@ -337,3 +420,90 @@ class AsyncMetricsClient:
             request_options=request_options,
         )
         return _response.data
+
+    async def query_rates(
+        self,
+        inbox_id: InboxId,
+        *,
+        rate_types: typing.Optional[RateTypes] = None,
+        start: typing.Optional[Start] = None,
+        end: typing.Optional[End] = None,
+        period: typing.Optional[RatePeriod] = None,
+        window: typing.Optional[Window] = None,
+        limit: typing.Optional[MetricLimit] = None,
+        descending: typing.Optional[Descending] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> QueryRatesResponse:
+        """
+        Rolling bounce and complaint rates for the inbox. At each `period`
+        grid point, the bounced (or complained) messages over the preceding
+        `window` divided by the messages sent over the same window, with the
+        send count alongside. Account moderation evaluates the organization-wide
+        rate, so use the organization endpoint to see the number it acts on;
+        the inbox view shows which inboxes contribute. Defaults to the rolling
+        24-hour rate sampled hourly over the last day; `start` must be within
+        the last 90 days, `window` must be a whole multiple of `period`, and
+        the range plus window divided by `period` must not exceed 1000
+        buckets.
+
+        **CLI:**
+        ```bash
+        agentmail inboxes metrics query-rates --inbox-id <inbox_id>
+        ```
+
+        Parameters
+        ----------
+        inbox_id : InboxId
+
+        rate_types : typing.Optional[RateTypes]
+
+        start : typing.Optional[Start]
+
+        end : typing.Optional[End]
+
+        period : typing.Optional[RatePeriod]
+
+        window : typing.Optional[Window]
+
+        limit : typing.Optional[MetricLimit]
+
+        descending : typing.Optional[Descending]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        QueryRatesResponse
+
+        Examples
+        --------
+        import asyncio
+
+        from agentmail import AsyncAgentMail
+
+        client = AsyncAgentMail(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.inboxes.metrics.query_rates(
+                inbox_id="inbox_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.query_rates(
+            inbox_id,
+            rate_types=rate_types,
+            start=start,
+            end=end,
+            period=period,
+            window=window,
+            limit=limit,
+            descending=descending,
+            request_options=request_options,
+        )
+        return _response.data

{agentmail-2.0.3 → agentmail-2.0.4}/src/agentmail/inboxes/metrics/raw_client.py

@@ -18,9 +18,13 @@ from ...metrics.types.metric_event_types import MetricEventTypes
 from ...metrics.types.metric_limit import MetricLimit
 from ...metrics.types.period import Period
 from ...metrics.types.query_metrics_response import QueryMetricsResponse
+from ...metrics.types.query_rates_response import QueryRatesResponse
 from ...metrics.types.query_usage_response import QueryUsageResponse
+from ...metrics.types.rate_period import RatePeriod
+from ...metrics.types.rate_types import RateTypes
 from ...metrics.types.start import Start
 from ...metrics.types.usage_types import UsageTypes
+from ...metrics.types.window import Window
 from ...types.validation_error_response import ValidationErrorResponse
 from ..types.inbox_id import InboxId
 from pydantic import ValidationError as pydantic_ValidationError
@@ -209,6 +213,106 @@ class RawMetricsClient:
             )
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
+    def query_rates(
+        self,
+        inbox_id: InboxId,
+        *,
+        rate_types: typing.Optional[RateTypes] = None,
+        start: typing.Optional[Start] = None,
+        end: typing.Optional[End] = None,
+        period: typing.Optional[RatePeriod] = None,
+        window: typing.Optional[Window] = None,
+        limit: typing.Optional[MetricLimit] = None,
+        descending: typing.Optional[Descending] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[QueryRatesResponse]:
+        """
+        Rolling bounce and complaint rates for the inbox. At each `period`
+        grid point, the bounced (or complained) messages over the preceding
+        `window` divided by the messages sent over the same window, with the
+        send count alongside. Account moderation evaluates the organization-wide
+        rate, so use the organization endpoint to see the number it acts on;
+        the inbox view shows which inboxes contribute. Defaults to the rolling
+        24-hour rate sampled hourly over the last day; `start` must be within
+        the last 90 days, `window` must be a whole multiple of `period`, and
+        the range plus window divided by `period` must not exceed 1000
+        buckets.
+
+        **CLI:**
+        ```bash
+        agentmail inboxes metrics query-rates --inbox-id <inbox_id>
+        ```
+
+        Parameters
+        ----------
+        inbox_id : InboxId
+
+        rate_types : typing.Optional[RateTypes]
+
+        start : typing.Optional[Start]
+
+        end : typing.Optional[End]
+
+        period : typing.Optional[RatePeriod]
+
+        window : typing.Optional[Window]
+
+        limit : typing.Optional[MetricLimit]
+
+        descending : typing.Optional[Descending]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[QueryRatesResponse]
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v0/inboxes/{jsonable_encoder(inbox_id)}/metrics/rates",
+            base_url=self._client_wrapper.get_environment().http,
+            method="GET",
+            params={
+                "rate_types": rate_types,
+                "start": serialize_datetime(start) if start is not None else None,
+                "end": serialize_datetime(end) if end is not None else None,
+                "period": period,
+                "window": window,
+                "limit": limit,
+                "descending": descending,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    QueryRatesResponse,
+                    construct_type(
+                        type_=QueryRatesResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise errors_validation_error_ValidationError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ValidationErrorResponse,
+                        construct_type(
+                            type_=ValidationErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except pydantic_ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
 
 class AsyncRawMetricsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
@@ -392,3 +496,103 @@ class AsyncRawMetricsClient:
                 status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
             )
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def query_rates(
+        self,
+        inbox_id: InboxId,
+        *,
+        rate_types: typing.Optional[RateTypes] = None,
+        start: typing.Optional[Start] = None,
+        end: typing.Optional[End] = None,
+        period: typing.Optional[RatePeriod] = None,
+        window: typing.Optional[Window] = None,
+        limit: typing.Optional[MetricLimit] = None,
+        descending: typing.Optional[Descending] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[QueryRatesResponse]:
+        """
+        Rolling bounce and complaint rates for the inbox. At each `period`
+        grid point, the bounced (or complained) messages over the preceding
+        `window` divided by the messages sent over the same window, with the
+        send count alongside. Account moderation evaluates the organization-wide
+        rate, so use the organization endpoint to see the number it acts on;
+        the inbox view shows which inboxes contribute. Defaults to the rolling
+        24-hour rate sampled hourly over the last day; `start` must be within
+        the last 90 days, `window` must be a whole multiple of `period`, and
+        the range plus window divided by `period` must not exceed 1000
+        buckets.
+
+        **CLI:**
+        ```bash
+        agentmail inboxes metrics query-rates --inbox-id <inbox_id>
+        ```
+
+        Parameters
+        ----------
+        inbox_id : InboxId
+
+        rate_types : typing.Optional[RateTypes]
+
+        start : typing.Optional[Start]
+
+        end : typing.Optional[End]
+
+        period : typing.Optional[RatePeriod]
+
+        window : typing.Optional[Window]
+
+        limit : typing.Optional[MetricLimit]
+
+        descending : typing.Optional[Descending]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[QueryRatesResponse]
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v0/inboxes/{jsonable_encoder(inbox_id)}/metrics/rates",
+            base_url=self._client_wrapper.get_environment().http,
+            method="GET",
+            params={
+                "rate_types": rate_types,
+                "start": serialize_datetime(start) if start is not None else None,
+                "end": serialize_datetime(end) if end is not None else None,
+                "period": period,
+                "window": window,
+                "limit": limit,
+                "descending": descending,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    QueryRatesResponse,
+                    construct_type(
+                        type_=QueryRatesResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise errors_validation_error_ValidationError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ValidationErrorResponse,
+                        construct_type(
+                            type_=ValidationErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except pydantic_ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)

{agentmail-2.0.3 → agentmail-2.0.4}/src/agentmail/inboxes/webhooks/client.py

@@ -224,6 +224,7 @@ class WebhooksClient:
         webhook_id: WebhookId,
         *,
         event_types: typing.Optional[UpdateWebhookEventTypes] = OMIT,
+        enabled: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Webhook:
         """
@@ -240,6 +241,13 @@ class WebhooksClient:
 
         event_types : typing.Optional[UpdateWebhookEventTypes]
 
+        enabled : typing.Optional[bool]
+            Set to true to re-enable a webhook that was disabled after repeated failed deliveries, or false
+            to disable it. Events that occurred while the webhook was disabled are not redelivered.
+            Re-enabling a webhook subscribed to `message.received.spam`, `message.received.blocked`, or
+            `message.received.unauthenticated` (or to every event type, with no filter) requires the
+            matching label permissions on the API key.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -260,7 +268,7 @@ class WebhooksClient:
         )
         """
         _response = self._raw_client.update(
-            inbox_id, webhook_id, event_types=event_types, request_options=request_options
+            inbox_id, webhook_id, event_types=event_types, enabled=enabled, request_options=request_options
         )
         return _response.data
 
@@ -583,6 +591,7 @@ class AsyncWebhooksClient:
         webhook_id: WebhookId,
         *,
         event_types: typing.Optional[UpdateWebhookEventTypes] = OMIT,
+        enabled: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Webhook:
         """
@@ -599,6 +608,13 @@ class AsyncWebhooksClient:
 
         event_types : typing.Optional[UpdateWebhookEventTypes]
 
+        enabled : typing.Optional[bool]
+            Set to true to re-enable a webhook that was disabled after repeated failed deliveries, or false
+            to disable it. Events that occurred while the webhook was disabled are not redelivered.
+            Re-enabling a webhook subscribed to `message.received.spam`, `message.received.blocked`, or
+            `message.received.unauthenticated` (or to every event type, with no filter) requires the
+            matching label permissions on the API key.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -627,7 +643,7 @@ class AsyncWebhooksClient:
         asyncio.run(main())
         """
         _response = await self._raw_client.update(
-            inbox_id, webhook_id, event_types=event_types, request_options=request_options
+            inbox_id, webhook_id, event_types=event_types, enabled=enabled, request_options=request_options
         )
         return _response.data
 

{agentmail-2.0.3 → agentmail-2.0.4}/src/agentmail/inboxes/webhooks/raw_client.py

@@ -299,6 +299,7 @@ class RawWebhooksClient:
         webhook_id: WebhookId,
         *,
         event_types: typing.Optional[UpdateWebhookEventTypes] = OMIT,
+        enabled: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[Webhook]:
         """
@@ -315,6 +316,13 @@ class RawWebhooksClient:
 
         event_types : typing.Optional[UpdateWebhookEventTypes]
 
+        enabled : typing.Optional[bool]
+            Set to true to re-enable a webhook that was disabled after repeated failed deliveries, or false
+            to disable it. Events that occurred while the webhook was disabled are not redelivered.
+            Re-enabling a webhook subscribed to `message.received.spam`, `message.received.blocked`, or
+            `message.received.unauthenticated` (or to every event type, with no filter) requires the
+            matching label permissions on the API key.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -328,6 +336,7 @@ class RawWebhooksClient:
             method="PATCH",
             json={
                 "event_types": event_types,
+                "enabled": enabled,
             },
             request_options=request_options,
             omit=OMIT,
@@ -767,6 +776,7 @@ class AsyncRawWebhooksClient:
         webhook_id: WebhookId,
         *,
         event_types: typing.Optional[UpdateWebhookEventTypes] = OMIT,
+        enabled: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[Webhook]:
         """
@@ -783,6 +793,13 @@ class AsyncRawWebhooksClient:
 
         event_types : typing.Optional[UpdateWebhookEventTypes]
 
+        enabled : typing.Optional[bool]
+            Set to true to re-enable a webhook that was disabled after repeated failed deliveries, or false
+            to disable it. Events that occurred while the webhook was disabled are not redelivered.
+            Re-enabling a webhook subscribed to `message.received.spam`, `message.received.blocked`, or
+            `message.received.unauthenticated` (or to every event type, with no filter) requires the
+            matching label permissions on the API key.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -796,6 +813,7 @@ class AsyncRawWebhooksClient:
             method="PATCH",
             json={
                 "event_types": event_types,
+                "enabled": enabled,
             },
             request_options=request_options,
             omit=OMIT,

{agentmail-2.0.3 → agentmail-2.0.4}/src/agentmail/metrics/__init__.py

@@ -15,11 +15,17 @@ if typing.TYPE_CHECKING:
         MetricLimit,
         Period,
         QueryMetricsResponse,
+        QueryRatesResponse,
         QueryUsageResponse,
+        RatePeriod,
+        RatePoint,
+        RateType,
+        RateTypes,
         Start,
         UsagePoint,
         UsageType,
         UsageTypes,
+        Window,
     )
 _dynamic_imports: typing.Dict[str, str] = {
     "Descending": ".types",
@@ -30,11 +36,17 @@ _dynamic_imports: typing.Dict[str, str] = {
     "MetricLimit": ".types",
     "Period": ".types",
     "QueryMetricsResponse": ".types",
+    "QueryRatesResponse": ".types",
     "QueryUsageResponse": ".types",
+    "RatePeriod": ".types",
+    "RatePoint": ".types",
+    "RateType": ".types",
+    "RateTypes": ".types",
     "Start": ".types",
     "UsagePoint": ".types",
     "UsageType": ".types",
     "UsageTypes": ".types",
+    "Window": ".types",
 }
 
 
@@ -68,9 +80,15 @@ __all__ = [
     "MetricLimit",
     "Period",
     "QueryMetricsResponse",
+    "QueryRatesResponse",
     "QueryUsageResponse",
+    "RatePeriod",
+    "RatePoint",
+    "RateType",
+    "RateTypes",
     "Start",
     "UsagePoint",
     "UsageType",
     "UsageTypes",
+    "Window",
 ]