agentmail 0.5.11 → 0.5.13

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

@@ -58,23 +58,29 @@ class MetricsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
+     * Counts of email events (sent, delivered, bounced, etc.) over time for
+     * the organization. Defaults to the last 24 hours; `start` must be within
+     * the last 90 days, and a future `end` is clamped to now. Omit `period`
+     * for individual event counts, or set it to sum counts into buckets of
+     * that many seconds.
+     *
      * **CLI:**
      * ```bash
      * agentmail metrics list
      * ```
      *
-     * @param {AgentMail.QueryMetricsRequest} request
+     * @param {AgentMail.QueryEventsRequest} request
      * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
      *
      * @example
-     *     await client.metrics.query()
+     *     await client.metrics.queryEvents()
      */
-    query(request = {}, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__query(request, requestOptions));
+    queryEvents(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__queryEvents(request, requestOptions));
     }
-    __query() {
+    __queryEvents() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
             const { eventTypes, start, end, period, limit, descending } = request;
@@ -99,7 +105,7 @@ class MetricsClient {
             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"),
+                    .http, "/v0/metrics/events"),
                 method: "GET",
                 headers: _headers,
                 queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
@@ -139,7 +145,93 @@ class MetricsClient {
                         });
                 }
             }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/metrics");
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/metrics/events");
+        });
+    }
+    /**
+     * Cumulative usage series for the organization. Each point is the running
+     * total of the usage type at that timestamp, not the change within the
+     * bucket. Defaults to the last 24 hours; `start` must be within the last
+     * 90 days, and a future `end` is clamped to now. The range divided by
+     * `period` must not exceed 1000 buckets.
+     *
+     * @param {AgentMail.QueryUsageRequest} request
+     * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.metrics.queryUsage()
+     */
+    queryUsage(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__queryUsage(request, requestOptions));
+    }
+    __queryUsage() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { usageTypes, start, end, period, limit, descending } = request;
+            const _queryParams = {
+                usage_types: usageTypes != null
+                    ? (0, json_js_1.toJson)(serializers.UsageTypes.jsonOrThrow(usageTypes, {
+                        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,
+                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/usage"),
+                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.QueryUsageResponse.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/usage");
         });
     }
 }

package/dist/cjs/api/resources/metrics/client/requests/{QueryMetricsRequest.d.ts → QueryEventsRequest.d.ts}

@@ -3,7 +3,7 @@ import type * as AgentMail from "../../../../index.js";
  * @example
  *     {}
  */
-export interface QueryMetricsRequest {
+export interface QueryEventsRequest {
     eventTypes?: AgentMail.MetricEventTypes;
     start?: AgentMail.Start;
     end?: AgentMail.End;

package/dist/cjs/api/resources/metrics/client/requests/QueryEventsRequest.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/QueryUsageRequest.d.ts

@@ -0,0 +1,13 @@
+import type * as AgentMail from "../../../../index.js";
+/**
+ * @example
+ *     {}
+ */
+export interface QueryUsageRequest {
+    usageTypes?: AgentMail.UsageTypes;
+    start?: AgentMail.Start;
+    end?: AgentMail.End;
+    period?: AgentMail.Period;
+    limit?: AgentMail.MetricLimit;
+    descending?: AgentMail.Descending;
+}

package/dist/cjs/api/resources/metrics/client/requests/QueryUsageRequest.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 +1,2 @@
-export type { QueryMetricsRequest } from "./QueryMetricsRequest.js";
+export type { QueryEventsRequest } from "./QueryEventsRequest.js";
+export type { QueryUsageRequest } from "./QueryUsageRequest.js";

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

@@ -1,11 +1,14 @@
 /** Type of metric event. */
 export declare const MetricEventType: {
+    readonly MessageReceived: "message.received";
+    readonly MessageReceivedSpam: "message.received.spam";
+    readonly MessageReceivedBlocked: "message.received.blocked";
+    readonly MessageReceivedUnauthenticated: "message.received.unauthenticated";
     readonly MessageSent: "message.sent";
     readonly MessageDelivered: "message.delivered";
     readonly MessageBounced: "message.bounced";
-    readonly MessageDelayed: "message.delayed";
-    readonly MessageRejected: "message.rejected";
     readonly MessageComplained: "message.complained";
-    readonly MessageReceived: "message.received";
+    readonly MessageRejected: "message.rejected";
+    readonly DomainVerified: "domain.verified";
 };
 export type MetricEventType = (typeof MetricEventType)[keyof typeof MetricEventType];

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

@@ -4,11 +4,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MetricEventType = void 0;
 /** Type of metric event. */
 exports.MetricEventType = {
+    MessageReceived: "message.received",
+    MessageReceivedSpam: "message.received.spam",
+    MessageReceivedBlocked: "message.received.blocked",
+    MessageReceivedUnauthenticated: "message.received.unauthenticated",
     MessageSent: "message.sent",
     MessageDelivered: "message.delivered",
     MessageBounced: "message.bounced",
-    MessageDelayed: "message.delayed",
-    MessageRejected: "message.rejected",
     MessageComplained: "message.complained",
-    MessageReceived: "message.received",
+    MessageRejected: "message.rejected",
+    DomainVerified: "domain.verified",
 };

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

@@ -1,4 +1,4 @@
 /**
- * Period in number of seconds for the query.
+ * Size of each time bucket as a whole number of seconds, between 1 and 86400.
  */
-export type Period = string;
+export type Period = number;

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

@@ -0,0 +1,5 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * Cumulative usage series grouped by usage type.
+ */
+export type QueryUsageResponse = Partial<Record<AgentMail.UsageType, AgentMail.UsagePoint[]>>;

package/dist/cjs/api/resources/metrics/types/QueryUsageResponse.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/UsagePoint.d.ts

@@ -0,0 +1,6 @@
+export interface UsagePoint {
+    /** Timestamp of the point. */
+    timestamp: Date;
+    /** Cumulative value of the usage metric at the timestamp. */
+    value: number;
+}

package/dist/cjs/api/resources/metrics/types/UsagePoint.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/UsageType.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Type of usage metric. Inbox-scoped queries carry `storage_bytes`,
+ * `message_count`, and `thread_count`; pod-scoped queries add `inbox_count`
+ * and `domain_count`; organization-scoped queries add `pod_count`.
+ */
+export declare const UsageType: {
+    readonly StorageBytes: "storage_bytes";
+    readonly MessageCount: "message_count";
+    readonly ThreadCount: "thread_count";
+    readonly InboxCount: "inbox_count";
+    readonly PodCount: "pod_count";
+    readonly DomainCount: "domain_count";
+};
+export type UsageType = (typeof UsageType)[keyof typeof UsageType];

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

@@ -0,0 +1,17 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageType = void 0;
+/**
+ * Type of usage metric. Inbox-scoped queries carry `storage_bytes`,
+ * `message_count`, and `thread_count`; pod-scoped queries add `inbox_count`
+ * and `domain_count`; organization-scoped queries add `pod_count`.
+ */
+exports.UsageType = {
+    StorageBytes: "storage_bytes",
+    MessageCount: "message_count",
+    ThreadCount: "thread_count",
+    InboxCount: "inbox_count",
+    PodCount: "pod_count",
+    DomainCount: "domain_count",
+};

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

@@ -0,0 +1,5 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * List of usage metric types to query. Omit to query every type valid for the scope.
+ */
+export type UsageTypes = AgentMail.UsageType[];

package/dist/cjs/api/resources/metrics/types/UsageTypes.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,4 +6,8 @@ export * from "./MetricEventTypes.js";
 export * from "./MetricLimit.js";
 export * from "./Period.js";
 export * from "./QueryMetricsResponse.js";
+export * from "./QueryUsageResponse.js";
 export * from "./Start.js";
+export * from "./UsagePoint.js";
+export * from "./UsageType.js";
+export * from "./UsageTypes.js";

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

@@ -22,4 +22,8 @@ __exportStar(require("./MetricEventTypes.js"), exports);
 __exportStar(require("./MetricLimit.js"), exports);
 __exportStar(require("./Period.js"), exports);
 __exportStar(require("./QueryMetricsResponse.js"), exports);
+__exportStar(require("./QueryUsageResponse.js"), exports);
 __exportStar(require("./Start.js"), exports);
+__exportStar(require("./UsagePoint.js"), exports);
+__exportStar(require("./UsageType.js"), exports);
+__exportStar(require("./UsageTypes.js"), exports);

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

@@ -9,6 +9,7 @@ import { InboxesClient } from "../resources/inboxes/client/Client.js";
 import { ListsClient } from "../resources/lists/client/Client.js";
 import { MetricsClient } from "../resources/metrics/client/Client.js";
 import { ThreadsClient } from "../resources/threads/client/Client.js";
+import { WebhooksClient } from "../resources/webhooks/client/Client.js";
 export declare namespace PodsClient {
     type Options = BaseClientOptions;
     interface RequestOptions extends BaseRequestOptions {
@@ -19,6 +20,7 @@ export declare class PodsClient {
     protected _inboxes: InboxesClient | undefined;
     protected _threads: ThreadsClient | undefined;
     protected _drafts: DraftsClient | undefined;
+    protected _webhooks: WebhooksClient | undefined;
     protected _domains: DomainsClient | undefined;
     protected _lists: ListsClient | undefined;
     protected _metrics: MetricsClient | undefined;
@@ -27,6 +29,7 @@ export declare class PodsClient {
     get inboxes(): InboxesClient;
     get threads(): ThreadsClient;
     get drafts(): DraftsClient;
+    get webhooks(): WebhooksClient;
     get domains(): DomainsClient;
     get lists(): ListsClient;
     get metrics(): MetricsClient;

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

@@ -59,6 +59,7 @@ const Client_js_4 = require("../resources/inboxes/client/Client.js");
 const Client_js_5 = require("../resources/lists/client/Client.js");
 const Client_js_6 = require("../resources/metrics/client/Client.js");
 const Client_js_7 = require("../resources/threads/client/Client.js");
+const Client_js_8 = require("../resources/webhooks/client/Client.js");
 class PodsClient {
     constructor(options = {}) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
@@ -75,6 +76,10 @@ class PodsClient {
         var _a;
         return ((_a = this._drafts) !== null && _a !== void 0 ? _a : (this._drafts = new Client_js_3.DraftsClient(this._options)));
     }
+    get webhooks() {
+        var _a;
+        return ((_a = this._webhooks) !== null && _a !== void 0 ? _a : (this._webhooks = new Client_js_8.WebhooksClient(this._options)));
+    }
     get domains() {
         var _a;
         return ((_a = this._domains) !== null && _a !== void 0 ? _a : (this._domains = new Client_js_2.DomainsClient(this._options)));

package/dist/cjs/api/resources/pods/resources/index.d.ts

@@ -12,3 +12,5 @@ export * from "./metrics/client/requests/index.js";
 export * as metrics from "./metrics/index.js";
 export * from "./threads/client/requests/index.js";
 export * as threads from "./threads/index.js";
+export * from "./webhooks/client/requests/index.js";
+export * as webhooks from "./webhooks/index.js";

package/dist/cjs/api/resources/pods/resources/index.js

@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.threads = exports.metrics = exports.lists = exports.inboxes = exports.drafts = exports.domains = exports.apiKeys = void 0;
+exports.webhooks = exports.threads = exports.metrics = exports.lists = exports.inboxes = exports.drafts = exports.domains = exports.apiKeys = void 0;
 __exportStar(require("./apiKeys/client/requests/index.js"), exports);
 exports.apiKeys = __importStar(require("./apiKeys/index.js"));
 __exportStar(require("./domains/client/requests/index.js"), exports);
@@ -51,3 +51,5 @@ __exportStar(require("./metrics/client/requests/index.js"), exports);
 exports.metrics = __importStar(require("./metrics/index.js"));
 __exportStar(require("./threads/client/requests/index.js"), exports);
 exports.threads = __importStar(require("./threads/index.js"));
+__exportStar(require("./webhooks/client/requests/index.js"), exports);
+exports.webhooks = __importStar(require("./webhooks/index.js"));

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

@@ -11,20 +11,46 @@ export declare class MetricsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<MetricsClient.Options>;
     constructor(options?: MetricsClient.Options);
     /**
+     * Counts of email events (sent, delivered, bounced, etc.) over time for
+     * the pod. Defaults to the last 24 hours; `start` must be within the last
+     * 90 days, and a future `end` is clamped to now. Omit `period` for
+     * individual event counts, or set it to sum counts into buckets of that
+     * many seconds.
+     *
      * **CLI:**
      * ```bash
      * agentmail pods:metrics query --pod-id <pod_id>
      * ```
      *
      * @param {AgentMail.pods.PodId} pod_id
-     * @param {AgentMail.pods.QueryMetricsRequest} request
+     * @param {AgentMail.pods.QueryEventsRequest} request
+     * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.pods.metrics.queryEvents("pod_id")
+     */
+    queryEvents(pod_id: AgentMail.pods.PodId, request?: AgentMail.pods.QueryEventsRequest, requestOptions?: MetricsClient.RequestOptions): core.HttpResponsePromise<AgentMail.QueryMetricsResponse>;
+    private __queryEvents;
+    /**
+     * Cumulative usage series for the pod. Each point is the running total of
+     * the usage type at that timestamp, not the change within the bucket.
+     * Pod-scoped queries carry every usage type except `pod_count`; requested
+     * types that don't apply to the scope are ignored. Defaults to the last
+     * 24 hours; `start` must be within the last 90 days, and a future `end`
+     * is clamped to now. The range divided by `period` must not exceed 1000
+     * buckets.
+     *
+     * @param {AgentMail.pods.PodId} pod_id
+     * @param {AgentMail.pods.QueryUsageRequest} request
      * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
      *
      * @example
-     *     await client.pods.metrics.query("pod_id")
+     *     await client.pods.metrics.queryUsage("pod_id")
      */
-    query(pod_id: AgentMail.pods.PodId, request?: AgentMail.pods.QueryMetricsRequest, requestOptions?: MetricsClient.RequestOptions): core.HttpResponsePromise<AgentMail.QueryMetricsResponse>;
-    private __query;
+    queryUsage(pod_id: AgentMail.pods.PodId, request?: AgentMail.pods.QueryUsageRequest, requestOptions?: MetricsClient.RequestOptions): core.HttpResponsePromise<AgentMail.QueryUsageResponse>;
+    private __queryUsage;
 }

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

@@ -58,24 +58,30 @@ class MetricsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
+     * Counts of email events (sent, delivered, bounced, etc.) over time for
+     * the pod. Defaults to the last 24 hours; `start` must be within the last
+     * 90 days, and a future `end` is clamped to now. Omit `period` for
+     * individual event counts, or set it to sum counts into buckets of that
+     * many seconds.
+     *
      * **CLI:**
      * ```bash
      * agentmail pods:metrics query --pod-id <pod_id>
      * ```
      *
      * @param {AgentMail.pods.PodId} pod_id
-     * @param {AgentMail.pods.QueryMetricsRequest} request
+     * @param {AgentMail.pods.QueryEventsRequest} request
      * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
      *
      * @example
-     *     await client.pods.metrics.query("pod_id")
+     *     await client.pods.metrics.queryEvents("pod_id")
      */
-    query(pod_id, request = {}, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__query(pod_id, request, requestOptions));
+    queryEvents(pod_id, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__queryEvents(pod_id, request, requestOptions));
     }
-    __query(pod_id_1) {
+    __queryEvents(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 { eventTypes, start, end, period, limit, descending } = request;
@@ -100,7 +106,7 @@ class MetricsClient {
             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`),
+                    .http, `/v0/pods/${core.url.encodePathParam(serializers.pods.PodId.jsonOrThrow(pod_id, { omitUndefined: true }))}/metrics/events`),
                 method: "GET",
                 headers: _headers,
                 queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
@@ -140,7 +146,96 @@ class MetricsClient {
                         });
                 }
             }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/pods/{pod_id}/metrics");
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/pods/{pod_id}/metrics/events");
+        });
+    }
+    /**
+     * Cumulative usage series for the pod. Each point is the running total of
+     * the usage type at that timestamp, not the change within the bucket.
+     * Pod-scoped queries carry every usage type except `pod_count`; requested
+     * types that don't apply to the scope are ignored. Defaults to the last
+     * 24 hours; `start` must be within the last 90 days, and a future `end`
+     * is clamped to now. The range divided by `period` must not exceed 1000
+     * buckets.
+     *
+     * @param {AgentMail.pods.PodId} pod_id
+     * @param {AgentMail.pods.QueryUsageRequest} request
+     * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.pods.metrics.queryUsage("pod_id")
+     */
+    queryUsage(pod_id, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__queryUsage(pod_id, request, requestOptions));
+    }
+    __queryUsage(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 { usageTypes, start, end, period, limit, descending } = request;
+            const _queryParams = {
+                usage_types: usageTypes != null
+                    ? (0, json_js_1.toJson)(serializers.UsageTypes.jsonOrThrow(usageTypes, {
+                        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,
+                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/usage`),
+                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.QueryUsageResponse.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/usage");
         });
     }
 }

package/dist/cjs/api/resources/pods/resources/metrics/client/requests/{QueryMetricsRequest.d.ts → QueryEventsRequest.d.ts}

@@ -3,7 +3,7 @@ import type * as AgentMail from "../../../../../../index.js";
  * @example
  *     {}
  */
-export interface QueryMetricsRequest {
+export interface QueryEventsRequest {
     eventTypes?: AgentMail.MetricEventTypes;
     start?: AgentMail.Start;
     end?: AgentMail.End;

package/dist/cjs/api/resources/pods/resources/metrics/client/requests/QueryEventsRequest.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/QueryUsageRequest.d.ts

@@ -0,0 +1,13 @@
+import type * as AgentMail from "../../../../../../index.js";
+/**
+ * @example
+ *     {}
+ */
+export interface QueryUsageRequest {
+    usageTypes?: AgentMail.UsageTypes;
+    start?: AgentMail.Start;
+    end?: AgentMail.End;
+    period?: AgentMail.Period;
+    limit?: AgentMail.MetricLimit;
+    descending?: AgentMail.Descending;
+}

package/dist/cjs/api/resources/pods/resources/metrics/client/requests/QueryUsageRequest.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 +1,2 @@
-export type { QueryMetricsRequest } from "./QueryMetricsRequest.js";
+export type { QueryEventsRequest } from "./QueryEventsRequest.js";
+export type { QueryUsageRequest } from "./QueryUsageRequest.js";