agentmail 0.5.29 → 0.5.30

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "agentmail",
-        "X-Fern-SDK-Version": "0.5.29",
-        "User-Agent": "agentmail/0.5.29",
+        "X-Fern-SDK-Version": "0.5.30",
+        "User-Agent": "agentmail/0.5.30",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/api/resources/inboxes/resources/metrics/client/Client.d.ts

@@ -53,4 +53,32 @@ export declare class MetricsClient {
      */
     queryUsage(inbox_id: AgentMail.inboxes.InboxId, request?: AgentMail.inboxes.QueryUsageRequest, requestOptions?: MetricsClient.RequestOptions): core.HttpResponsePromise<AgentMail.QueryUsageResponse>;
     private __queryUsage;
+    /**
+     * 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>
+     * ```
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.inboxes.QueryRatesRequest} request
+     * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.metrics.queryRates("inbox_id")
+     */
+    queryRates(inbox_id: AgentMail.inboxes.InboxId, request?: AgentMail.inboxes.QueryRatesRequest, requestOptions?: MetricsClient.RequestOptions): core.HttpResponsePromise<AgentMail.QueryRatesResponse>;
+    private __queryRates;
 }

package/dist/cjs/api/resources/inboxes/resources/metrics/client/Client.js

@@ -238,5 +238,103 @@ class MetricsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/inboxes/{inbox_id}/metrics/usage");
         });
     }
+    /**
+     * 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>
+     * ```
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.inboxes.QueryRatesRequest} request
+     * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.metrics.queryRates("inbox_id")
+     */
+    queryRates(inbox_id, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__queryRates(inbox_id, request, requestOptions));
+    }
+    __queryRates(inbox_id_1) {
+        return __awaiter(this, arguments, void 0, function* (inbox_id, request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { rateTypes, start, end, period, window, limit, descending } = request;
+            const _queryParams = {
+                rate_types: rateTypes != null
+                    ? (0, json_js_1.toJson)(serializers.RateTypes.jsonOrThrow(rateTypes, {
+                        unrecognizedObjectKeys: "strip",
+                        omitUndefined: true,
+                    }))
+                    : undefined,
+                start: start != null
+                    ? serializers.Start.jsonOrThrow(start, { unrecognizedObjectKeys: "strip", omitUndefined: true })
+                    : undefined,
+                end: end != null
+                    ? serializers.End.jsonOrThrow(end, { unrecognizedObjectKeys: "strip", omitUndefined: true })
+                    : undefined,
+                period,
+                window,
+                limit,
+                descending,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Prod)
+                    .http, `/v0/inboxes/${core.url.encodePathParam(serializers.inboxes.InboxId.jsonOrThrow(inbox_id, { omitUndefined: true }))}/metrics/rates`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.QueryRatesResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AgentMail.ValidationError(serializers.ValidationErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/inboxes/{inbox_id}/metrics/rates");
+        });
+    }
 }
 exports.MetricsClient = MetricsClient;

package/dist/cjs/api/resources/inboxes/resources/metrics/client/requests/QueryRatesRequest.d.ts

@@ -0,0 +1,14 @@
+import type * as AgentMail from "../../../../../../index.js";
+/**
+ * @example
+ *     {}
+ */
+export interface QueryRatesRequest {
+    rateTypes?: AgentMail.RateTypes;
+    start?: AgentMail.Start;
+    end?: AgentMail.End;
+    period?: AgentMail.RatePeriod;
+    window?: AgentMail.Window;
+    limit?: AgentMail.MetricLimit;
+    descending?: AgentMail.Descending;
+}

package/dist/cjs/api/resources/inboxes/resources/metrics/client/requests/QueryRatesRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/inboxes/resources/metrics/client/requests/index.d.ts

@@ -1,2 +1,3 @@
 export type { QueryEventsRequest } from "./QueryEventsRequest.js";
+export type { QueryRatesRequest } from "./QueryRatesRequest.js";
 export type { QueryUsageRequest } from "./QueryUsageRequest.js";

package/dist/cjs/api/resources/metrics/client/Client.d.ts

@@ -49,4 +49,32 @@ export declare class MetricsClient {
      */
     queryUsage(request?: AgentMail.QueryUsageRequest, requestOptions?: MetricsClient.RequestOptions): core.HttpResponsePromise<AgentMail.QueryUsageResponse>;
     private __queryUsage;
+    /**
+     * Rolling bounce and complaint rates for the organization. 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 so you can see the volume behind
+     * it. This is the number AgentMail's account moderation acts on: a
+     * warning at a 5% bounce rate and suspension at 10%, evaluated over a
+     * rolling 24 hours once at least 1,000 messages were sent in that
+     * window. 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 metrics query-rates
+     * ```
+     *
+     * @param {AgentMail.QueryRatesRequest} request
+     * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.metrics.queryRates()
+     */
+    queryRates(request?: AgentMail.QueryRatesRequest, requestOptions?: MetricsClient.RequestOptions): core.HttpResponsePromise<AgentMail.QueryRatesResponse>;
+    private __queryRates;
 }

package/dist/cjs/api/resources/metrics/client/Client.js

@@ -234,5 +234,103 @@ class MetricsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/metrics/usage");
         });
     }
+    /**
+     * Rolling bounce and complaint rates for the organization. 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 so you can see the volume behind
+     * it. This is the number AgentMail's account moderation acts on: a
+     * warning at a 5% bounce rate and suspension at 10%, evaluated over a
+     * rolling 24 hours once at least 1,000 messages were sent in that
+     * window. 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 metrics query-rates
+     * ```
+     *
+     * @param {AgentMail.QueryRatesRequest} request
+     * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.metrics.queryRates()
+     */
+    queryRates(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__queryRates(request, requestOptions));
+    }
+    __queryRates() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { rateTypes, start, end, period, window, limit, descending } = request;
+            const _queryParams = {
+                rate_types: rateTypes != null
+                    ? (0, json_js_1.toJson)(serializers.RateTypes.jsonOrThrow(rateTypes, {
+                        unrecognizedObjectKeys: "strip",
+                        omitUndefined: true,
+                    }))
+                    : undefined,
+                start: start != null
+                    ? serializers.Start.jsonOrThrow(start, { unrecognizedObjectKeys: "strip", omitUndefined: true })
+                    : undefined,
+                end: end != null
+                    ? serializers.End.jsonOrThrow(end, { unrecognizedObjectKeys: "strip", omitUndefined: true })
+                    : undefined,
+                period,
+                window,
+                limit,
+                descending,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Prod)
+                    .http, "/v0/metrics/rates"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.QueryRatesResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AgentMail.ValidationError(serializers.ValidationErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/metrics/rates");
+        });
+    }
 }
 exports.MetricsClient = MetricsClient;

package/dist/cjs/api/resources/metrics/client/requests/QueryRatesRequest.d.ts

@@ -0,0 +1,14 @@
+import type * as AgentMail from "../../../../index.js";
+/**
+ * @example
+ *     {}
+ */
+export interface QueryRatesRequest {
+    rateTypes?: AgentMail.RateTypes;
+    start?: AgentMail.Start;
+    end?: AgentMail.End;
+    period?: AgentMail.RatePeriod;
+    window?: AgentMail.Window;
+    limit?: AgentMail.MetricLimit;
+    descending?: AgentMail.Descending;
+}

package/dist/cjs/api/resources/metrics/client/requests/QueryRatesRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/metrics/client/requests/index.d.ts

@@ -1,2 +1,3 @@
 export type { QueryEventsRequest } from "./QueryEventsRequest.js";
+export type { QueryRatesRequest } from "./QueryRatesRequest.js";
 export type { QueryUsageRequest } from "./QueryUsageRequest.js";

package/dist/cjs/api/resources/metrics/types/QueryRatesResponse.d.ts

@@ -0,0 +1,5 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * Rate series grouped by rate type.
+ */
+export type QueryRatesResponse = Partial<Record<AgentMail.RateType, AgentMail.RatePoint[]>>;

package/dist/cjs/api/resources/metrics/types/QueryRatesResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/metrics/types/RatePeriod.d.ts

@@ -0,0 +1,5 @@
+/**
+ * How often a point is sampled, as a whole number of seconds between 60
+ * and 86400. Defaults to 3600 (one point per hour).
+ */
+export type RatePeriod = number;

package/dist/cjs/api/resources/metrics/types/RatePeriod.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/metrics/types/RatePoint.d.ts

@@ -0,0 +1,12 @@
+export interface RatePoint {
+    /** End of the window the point covers; the window is the `window` seconds before it. */
+    timestamp: Date;
+    /**
+     * Bounced or complained messages divided by messages sent over the
+     * window, as a fraction (0.05 is 5%). Null when nothing was sent in
+     * the window.
+     */
+    rate?: number;
+    /** Messages sent in the window, counted per recipient. */
+    sent: number;
+}

package/dist/cjs/api/resources/metrics/types/RatePoint.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/metrics/types/RateType.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Type of rate. `bounce` is bounced messages divided by messages sent,
+ * counting permanent and transient bounces; `complaint` is spam complaints
+ * divided by messages sent.
+ */
+export declare const RateType: {
+    readonly Bounce: "bounce";
+    readonly Complaint: "complaint";
+};
+export type RateType = (typeof RateType)[keyof typeof RateType];

package/dist/cjs/api/resources/metrics/types/RateType.js

@@ -0,0 +1,13 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateType = void 0;
+/**
+ * Type of rate. `bounce` is bounced messages divided by messages sent,
+ * counting permanent and transient bounces; `complaint` is spam complaints
+ * divided by messages sent.
+ */
+exports.RateType = {
+    Bounce: "bounce",
+    Complaint: "complaint",
+};

package/dist/cjs/api/resources/metrics/types/RateTypes.d.ts

@@ -0,0 +1,5 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * List of rate types to query. Omit to query both.
+ */
+export type RateTypes = AgentMail.RateType[];

package/dist/cjs/api/resources/metrics/types/RateTypes.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/metrics/types/Window.d.ts

@@ -0,0 +1,6 @@
+/**
+ * How far back each point looks, as a whole number of seconds. Must be a
+ * whole multiple of `period`, at most 30 days (2592000). Defaults to 86400
+ * (a rolling 24-hour rate).
+ */
+export type Window = number;

package/dist/cjs/api/resources/metrics/types/Window.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/metrics/types/index.d.ts

@@ -6,8 +6,14 @@ export * from "./MetricEventTypes.js";
 export * from "./MetricLimit.js";
 export * from "./Period.js";
 export * from "./QueryMetricsResponse.js";
+export * from "./QueryRatesResponse.js";
 export * from "./QueryUsageResponse.js";
+export * from "./RatePeriod.js";
+export * from "./RatePoint.js";
+export * from "./RateType.js";
+export * from "./RateTypes.js";
 export * from "./Start.js";
 export * from "./UsagePoint.js";
 export * from "./UsageType.js";
 export * from "./UsageTypes.js";
+export * from "./Window.js";

package/dist/cjs/api/resources/metrics/types/index.js

@@ -22,8 +22,14 @@ __exportStar(require("./MetricEventTypes.js"), exports);
 __exportStar(require("./MetricLimit.js"), exports);
 __exportStar(require("./Period.js"), exports);
 __exportStar(require("./QueryMetricsResponse.js"), exports);
+__exportStar(require("./QueryRatesResponse.js"), exports);
 __exportStar(require("./QueryUsageResponse.js"), exports);
+__exportStar(require("./RatePeriod.js"), exports);
+__exportStar(require("./RatePoint.js"), exports);
+__exportStar(require("./RateType.js"), exports);
+__exportStar(require("./RateTypes.js"), exports);
 __exportStar(require("./Start.js"), exports);
 __exportStar(require("./UsagePoint.js"), exports);
 __exportStar(require("./UsageType.js"), exports);
 __exportStar(require("./UsageTypes.js"), exports);
+__exportStar(require("./Window.js"), exports);

package/dist/cjs/api/resources/pods/resources/metrics/client/Client.d.ts

@@ -53,4 +53,32 @@ export declare class MetricsClient {
      */
     queryUsage(pod_id: AgentMail.pods.PodId, request?: AgentMail.pods.QueryUsageRequest, requestOptions?: MetricsClient.RequestOptions): core.HttpResponsePromise<AgentMail.QueryUsageResponse>;
     private __queryUsage;
+    /**
+     * Rolling bounce and complaint rates for the pod. 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 pod view shows which pods 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 pods metrics query-rates --pod-id <pod_id>
+     * ```
+     *
+     * @param {AgentMail.pods.PodId} pod_id
+     * @param {AgentMail.pods.QueryRatesRequest} request
+     * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.pods.metrics.queryRates("pod_id")
+     */
+    queryRates(pod_id: AgentMail.pods.PodId, request?: AgentMail.pods.QueryRatesRequest, requestOptions?: MetricsClient.RequestOptions): core.HttpResponsePromise<AgentMail.QueryRatesResponse>;
+    private __queryRates;
 }

package/dist/cjs/api/resources/pods/resources/metrics/client/Client.js

@@ -238,5 +238,103 @@ class MetricsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/pods/{pod_id}/metrics/usage");
         });
     }
+    /**
+     * Rolling bounce and complaint rates for the pod. 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 pod view shows which pods 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 pods metrics query-rates --pod-id <pod_id>
+     * ```
+     *
+     * @param {AgentMail.pods.PodId} pod_id
+     * @param {AgentMail.pods.QueryRatesRequest} request
+     * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.pods.metrics.queryRates("pod_id")
+     */
+    queryRates(pod_id, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__queryRates(pod_id, request, requestOptions));
+    }
+    __queryRates(pod_id_1) {
+        return __awaiter(this, arguments, void 0, function* (pod_id, request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { rateTypes, start, end, period, window, limit, descending } = request;
+            const _queryParams = {
+                rate_types: rateTypes != null
+                    ? (0, json_js_1.toJson)(serializers.RateTypes.jsonOrThrow(rateTypes, {
+                        unrecognizedObjectKeys: "strip",
+                        omitUndefined: true,
+                    }))
+                    : undefined,
+                start: start != null
+                    ? serializers.Start.jsonOrThrow(start, { unrecognizedObjectKeys: "strip", omitUndefined: true })
+                    : undefined,
+                end: end != null
+                    ? serializers.End.jsonOrThrow(end, { unrecognizedObjectKeys: "strip", omitUndefined: true })
+                    : undefined,
+                period,
+                window,
+                limit,
+                descending,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Prod)
+                    .http, `/v0/pods/${core.url.encodePathParam(serializers.pods.PodId.jsonOrThrow(pod_id, { omitUndefined: true }))}/metrics/rates`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.QueryRatesResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AgentMail.ValidationError(serializers.ValidationErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/pods/{pod_id}/metrics/rates");
+        });
+    }
 }
 exports.MetricsClient = MetricsClient;

package/dist/cjs/api/resources/pods/resources/metrics/client/requests/QueryRatesRequest.d.ts

@@ -0,0 +1,14 @@
+import type * as AgentMail from "../../../../../../index.js";
+/**
+ * @example
+ *     {}
+ */
+export interface QueryRatesRequest {
+    rateTypes?: AgentMail.RateTypes;
+    start?: AgentMail.Start;
+    end?: AgentMail.End;
+    period?: AgentMail.RatePeriod;
+    window?: AgentMail.Window;
+    limit?: AgentMail.MetricLimit;
+    descending?: AgentMail.Descending;
+}

package/dist/cjs/api/resources/pods/resources/metrics/client/requests/QueryRatesRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/pods/resources/metrics/client/requests/index.d.ts

@@ -1,2 +1,3 @@
 export type { QueryEventsRequest } from "./QueryEventsRequest.js";
+export type { QueryRatesRequest } from "./QueryRatesRequest.js";
 export type { QueryUsageRequest } from "./QueryUsageRequest.js";