agentmail 0.5.10 → 0.5.12

package/dist/cjs/serialization/resources/metrics/types/QueryUsageResponse.js

@@ -0,0 +1,41 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryUsageResponse = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+const UsagePoint_js_1 = require("./UsagePoint.js");
+const UsageType_js_1 = require("./UsageType.js");
+exports.QueryUsageResponse = core.serialization.partialRecord(UsageType_js_1.UsageType, core.serialization.list(UsagePoint_js_1.UsagePoint).optional());

package/dist/cjs/serialization/resources/metrics/types/UsagePoint.d.ts

@@ -0,0 +1,10 @@
+import type * as AgentMail from "../../../../api/index.js";
+import * as core from "../../../../core/index.js";
+import type * as serializers from "../../../index.js";
+export declare const UsagePoint: core.serialization.ObjectSchema<serializers.UsagePoint.Raw, AgentMail.UsagePoint>;
+export declare namespace UsagePoint {
+    interface Raw {
+        timestamp: string;
+        value: number;
+    }
+}

package/dist/cjs/serialization/resources/metrics/types/UsagePoint.js

@@ -0,0 +1,42 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsagePoint = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+exports.UsagePoint = core.serialization.object({
+    timestamp: core.serialization.date(),
+    value: core.serialization.number(),
+});

package/dist/cjs/serialization/resources/metrics/types/UsageType.d.ts

@@ -0,0 +1,7 @@
+import type * as AgentMail from "../../../../api/index.js";
+import * as core from "../../../../core/index.js";
+import type * as serializers from "../../../index.js";
+export declare const UsageType: core.serialization.Schema<serializers.UsageType.Raw, AgentMail.UsageType>;
+export declare namespace UsageType {
+    type Raw = "storage_bytes" | "message_count" | "thread_count" | "inbox_count" | "pod_count" | "domain_count";
+}

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

@@ -0,0 +1,46 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageType = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+exports.UsageType = core.serialization.enum_([
+    "storage_bytes",
+    "message_count",
+    "thread_count",
+    "inbox_count",
+    "pod_count",
+    "domain_count",
+]);

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

@@ -0,0 +1,8 @@
+import type * as AgentMail from "../../../../api/index.js";
+import * as core from "../../../../core/index.js";
+import type * as serializers from "../../../index.js";
+import { UsageType } from "./UsageType.js";
+export declare const UsageTypes: core.serialization.Schema<serializers.UsageTypes.Raw, AgentMail.UsageTypes>;
+export declare namespace UsageTypes {
+    type Raw = UsageType.Raw[];
+}

package/dist/cjs/serialization/resources/metrics/types/UsageTypes.js

@@ -0,0 +1,40 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageTypes = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+const UsageType_js_1 = require("./UsageType.js");
+exports.UsageTypes = core.serialization.list(UsageType_js_1.UsageType);

package/dist/cjs/serialization/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/serialization/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/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.5.10";
+export declare const SDK_VERSION = "0.5.12";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.5.10";
+exports.SDK_VERSION = "0.5.12";

package/dist/esm/BaseClient.mjs

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

package/dist/esm/api/resources/inboxes/resources/messages/client/Client.d.mts

@@ -93,6 +93,32 @@ export declare class MessagesClient {
      */
     batchGet(inbox_id: AgentMail.inboxes.InboxId, request: AgentMail.BatchGetMessagesRequest, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<AgentMail.BatchGetMessagesResponse>;
     private __batchGet;
+    /**
+     * Apply one label change to up to 50 messages in a single request. The
+     * same add_labels and remove_labels apply to every message id, and at
+     * least one of them must be provided. The update is atomic: either all
+     * resolved messages are updated or none are. Missing or restricted ids
+     * are silently excluded; compare `count` against `limit` to detect
+     * exclusions.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes:messages batch-update --inbox-id <inbox_id> --message-id <id1> --message-id <id2> --add-label read --remove-label unread
+     * ```
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.BatchUpdateMessagesRequest} request
+     * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.messages.batchUpdate("inbox_id", {
+     *         messageIds: ["message_ids", "message_ids"]
+     *     })
+     */
+    batchUpdate(inbox_id: AgentMail.inboxes.InboxId, request: AgentMail.BatchUpdateMessagesRequest, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<AgentMail.BatchUpdateMessagesResponse>;
+    private __batchUpdate;
     /**
      * **CLI:**
      * ```bash

package/dist/esm/api/resources/inboxes/resources/messages/client/Client.mjs

@@ -359,6 +359,89 @@ export class MessagesClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v0/inboxes/{inbox_id}/messages/batch-get");
         });
     }
+    /**
+     * Apply one label change to up to 50 messages in a single request. The
+     * same add_labels and remove_labels apply to every message id, and at
+     * least one of them must be provided. The update is atomic: either all
+     * resolved messages are updated or none are. Missing or restricted ids
+     * are silently excluded; compare `count` against `limit` to detect
+     * exclusions.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes:messages batch-update --inbox-id <inbox_id> --message-id <id1> --message-id <id2> --add-label read --remove-label unread
+     * ```
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.BatchUpdateMessagesRequest} request
+     * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.messages.batchUpdate("inbox_id", {
+     *         messageIds: ["message_ids", "message_ids"]
+     *     })
+     */
+    batchUpdate(inbox_id, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__batchUpdate(inbox_id, request, requestOptions));
+    }
+    __batchUpdate(inbox_id, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = 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 }))}/messages/batch-update`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.BatchUpdateMessagesRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                }),
+                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.BatchUpdateMessagesResponse.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 handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v0/inboxes/{inbox_id}/messages/batch-update");
+        });
+    }
     /**
      * **CLI:**
      * ```bash

package/dist/esm/api/resources/inboxes/resources/metrics/client/Client.d.mts

@@ -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 inbox. 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 inboxes:metrics query --inbox-id <inbox_id>
      * ```
      *
      * @param {AgentMail.inboxes.InboxId} inbox_id
-     * @param {AgentMail.inboxes.QueryMetricsRequest} request
+     * @param {AgentMail.inboxes.QueryEventsRequest} request
+     * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.metrics.queryEvents("inbox_id")
+     */
+    queryEvents(inbox_id: AgentMail.inboxes.InboxId, request?: AgentMail.inboxes.QueryEventsRequest, requestOptions?: MetricsClient.RequestOptions): core.HttpResponsePromise<AgentMail.QueryMetricsResponse>;
+    private __queryEvents;
+    /**
+     * Cumulative usage series for the inbox. Each point is the running total
+     * of the usage type at that timestamp, not the change within the bucket.
+     * Inbox-scoped queries carry `storage_bytes`, `message_count`, and
+     * `thread_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.inboxes.InboxId} inbox_id
+     * @param {AgentMail.inboxes.QueryUsageRequest} request
      * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
      *
      * @example
-     *     await client.inboxes.metrics.query("inbox_id")
+     *     await client.inboxes.metrics.queryUsage("inbox_id")
      */
-    query(inbox_id: AgentMail.inboxes.InboxId, request?: AgentMail.inboxes.QueryMetricsRequest, requestOptions?: MetricsClient.RequestOptions): core.HttpResponsePromise<AgentMail.QueryMetricsResponse>;
-    private __query;
+    queryUsage(inbox_id: AgentMail.inboxes.InboxId, request?: AgentMail.inboxes.QueryUsageRequest, requestOptions?: MetricsClient.RequestOptions): core.HttpResponsePromise<AgentMail.QueryUsageResponse>;
+    private __queryUsage;
 }

package/dist/esm/api/resources/inboxes/resources/metrics/client/Client.mjs

@@ -22,24 +22,30 @@ export class MetricsClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
+     * Counts of email events (sent, delivered, bounced, etc.) over time for
+     * the inbox. 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 inboxes:metrics query --inbox-id <inbox_id>
      * ```
      *
      * @param {AgentMail.inboxes.InboxId} inbox_id
-     * @param {AgentMail.inboxes.QueryMetricsRequest} request
+     * @param {AgentMail.inboxes.QueryEventsRequest} request
      * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
      *
      * @example
-     *     await client.inboxes.metrics.query("inbox_id")
+     *     await client.inboxes.metrics.queryEvents("inbox_id")
      */
-    query(inbox_id, request = {}, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__query(inbox_id, request, requestOptions));
+    queryEvents(inbox_id, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__queryEvents(inbox_id, request, requestOptions));
     }
-    __query(inbox_id_1) {
+    __queryEvents(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 { eventTypes, start, end, period, limit, descending } = request;
@@ -64,7 +70,7 @@ export class MetricsClient {
             const _headers = 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`),
+                    .http, `/v0/inboxes/${core.url.encodePathParam(serializers.inboxes.InboxId.jsonOrThrow(inbox_id, { omitUndefined: true }))}/metrics/events`),
                 method: "GET",
                 headers: _headers,
                 queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
@@ -104,7 +110,96 @@ export class MetricsClient {
                         });
                 }
             }
-            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v0/inboxes/{inbox_id}/metrics");
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v0/inboxes/{inbox_id}/metrics/events");
+        });
+    }
+    /**
+     * Cumulative usage series for the inbox. Each point is the running total
+     * of the usage type at that timestamp, not the change within the bucket.
+     * Inbox-scoped queries carry `storage_bytes`, `message_count`, and
+     * `thread_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.inboxes.InboxId} inbox_id
+     * @param {AgentMail.inboxes.QueryUsageRequest} request
+     * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.metrics.queryUsage("inbox_id")
+     */
+    queryUsage(inbox_id, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__queryUsage(inbox_id, request, requestOptions));
+    }
+    __queryUsage(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 { usageTypes, start, end, period, limit, descending } = request;
+            const _queryParams = {
+                usage_types: usageTypes != null
+                    ? 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 = 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/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 handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v0/inboxes/{inbox_id}/metrics/usage");
         });
     }
 }

package/dist/esm/api/resources/{pods/resources/metrics/client/requests/QueryMetricsRequest.d.mts → inboxes/resources/metrics/client/requests/QueryEventsRequest.d.mts}

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

package/dist/esm/api/resources/inboxes/resources/metrics/client/requests/QueryUsageRequest.d.mts

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

package/dist/esm/api/resources/inboxes/resources/metrics/client/requests/index.d.mts

@@ -1 +1,2 @@
-export type { QueryMetricsRequest } from "./QueryMetricsRequest.mjs";
+export type { QueryEventsRequest } from "./QueryEventsRequest.mjs";
+export type { QueryUsageRequest } from "./QueryUsageRequest.mjs";

package/dist/esm/api/resources/messages/types/BatchUpdateMessagesMessageIds.d.mts

@@ -0,0 +1,8 @@
+import type * as AgentMail from "../../../index.mjs";
+/**
+ * IDs of messages to update. Maximum 50 ids per request. Duplicates are
+ * rejected with a validation error. IDs not found in the inbox (including
+ * cross-inbox or permission-restricted) are silently excluded from the
+ * update; callers detect exclusions by comparing `count` against `limit`.
+ */
+export type BatchUpdateMessagesMessageIds = AgentMail.MessageId[];

package/dist/esm/api/resources/messages/types/BatchUpdateMessagesRequest.d.mts

@@ -0,0 +1,8 @@
+import type * as AgentMail from "../../../index.mjs";
+export interface BatchUpdateMessagesRequest {
+    messageIds: AgentMail.BatchUpdateMessagesMessageIds;
+    /** Label or labels to add to every message. */
+    addLabels?: AgentMail.UpdateMessageLabels;
+    /** Label or labels to remove from every message. */
+    removeLabels?: AgentMail.UpdateMessageLabels;
+}

package/dist/esm/api/resources/messages/types/BatchUpdateMessagesRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/messages/types/BatchUpdateMessagesResponse.d.mts

@@ -0,0 +1,11 @@
+import type * as AgentMail from "../../../index.mjs";
+export interface BatchUpdateMessagesResponse {
+    limit: AgentMail.Limit;
+    count: AgentMail.Count;
+    /**
+     * Updated messages with their new labels. Order matches `message_ids`
+     * in the request. Excluded ids are omitted, so `count` may be less than
+     * `limit`.
+     */
+    updates: AgentMail.UpdateMessageResponse[];
+}

package/dist/esm/api/resources/messages/types/BatchUpdateMessagesResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/messages/types/index.d.mts

@@ -2,6 +2,9 @@ export * from "./Addresses.mjs";
 export * from "./BatchGetMessagesMessageIds.mjs";
 export * from "./BatchGetMessagesRequest.mjs";
 export * from "./BatchGetMessagesResponse.mjs";
+export * from "./BatchUpdateMessagesMessageIds.mjs";
+export * from "./BatchUpdateMessagesRequest.mjs";
+export * from "./BatchUpdateMessagesResponse.mjs";
 export * from "./ListMessagesResponse.mjs";
 export * from "./Message.mjs";
 export * from "./MessageAttachments.mjs";