agentmail 0.5.28 → 0.5.30

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";

package/dist/cjs/api/resources/webhooks/types/UpdateInboxWebhookRequest.d.ts

@@ -1,7 +1,16 @@
 import type * as AgentMail from "../../../index.js";
 /**
- * Update an inbox-scoped webhook. It is fixed to its inbox, so only `event_types` can change.
+ * Update an inbox-scoped webhook. It is fixed to its inbox, so only `event_types` and `enabled` can
+ * change.
  */
 export interface UpdateInboxWebhookRequest {
     eventTypes?: AgentMail.webhooks.UpdateWebhookEventTypes;
+    /**
+     * Set to true to re-enable a webhook that was disabled after repeated failed deliveries, or false
+     * to disable it. Events that occurred while the webhook was disabled are not redelivered.
+     * Re-enabling a webhook subscribed to `message.received.spam`, `message.received.blocked`, or
+     * `message.received.unauthenticated` (or to every event type, with no filter) requires the
+     * matching label permissions on the API key.
+     */
+    enabled?: boolean;
 }

package/dist/cjs/api/resources/webhooks/types/UpdatePodWebhookRequest.d.ts

@@ -1,7 +1,7 @@
 import type * as AgentMail from "../../../index.js";
 /**
- * Update a pod-scoped webhook. You can adjust which inboxes within the pod it listens to and replace
- * its `event_types`, but not the pod scope itself.
+ * Update a pod-scoped webhook. You can adjust which inboxes within the pod it listens to, replace
+ * its `event_types`, and set `enabled`, but not change the pod scope itself.
  */
 export interface UpdatePodWebhookRequest extends AgentMail.webhooks.UpdateInboxWebhookRequest {
     /**

package/dist/cjs/api/resources/webhooks/types/Webhook.d.ts

@@ -5,6 +5,17 @@ export interface Webhook {
     eventTypes?: AgentMail.EventTypes;
     podIds?: AgentMail.PodIds;
     inboxIds?: AgentMail.InboxIds;
+    /**
+     * ID of the pod the webhook belongs to: the pod it was created in, or the pod of the inbox it
+     * belongs to. Absent for an organization webhook and on some inbox webhooks. This is not the
+     * list of pods it receives events for; see `pod_ids`.
+     */
+    podId?: string;
+    /**
+     * ID of the inbox the webhook belongs to, if it was created for an inbox. This is not the list
+     * of inboxes it receives events for; see `inbox_ids`.
+     */
+    inboxId?: string;
     /** Secret for webhook signature verification. */
     secret: string;
     /** Webhook is enabled. */

package/dist/cjs/serialization/resources/attachments/types/AttachmentResponse.d.ts

@@ -17,6 +17,7 @@ export declare namespace AttachmentResponse {
         content_disposition?: AttachmentContentDisposition.Raw | null;
         content_id?: AttachmentContentId.Raw | null;
         download_url: string;
+        text_url?: string | null;
         expires_at: string;
     }
 }

package/dist/cjs/serialization/resources/attachments/types/AttachmentResponse.js

@@ -50,5 +50,6 @@ exports.AttachmentResponse = core.serialization.object({
     contentDisposition: core.serialization.property("content_disposition", AttachmentContentDisposition_js_1.AttachmentContentDisposition.optional()),
     contentId: core.serialization.property("content_id", AttachmentContentId_js_1.AttachmentContentId.optional()),
     downloadUrl: core.serialization.property("download_url", core.serialization.string()),
+    textUrl: core.serialization.property("text_url", core.serialization.string().optional()),
     expiresAt: core.serialization.property("expires_at", core.serialization.date()),
 });

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

@@ -0,0 +1,9 @@
+import type * as AgentMail from "../../../../api/index.js";
+import * as core from "../../../../core/index.js";
+import type * as serializers from "../../../index.js";
+import { RatePoint } from "./RatePoint.js";
+import { RateType } from "./RateType.js";
+export declare const QueryRatesResponse: core.serialization.Schema<serializers.QueryRatesResponse.Raw, AgentMail.QueryRatesResponse>;
+export declare namespace QueryRatesResponse {
+    type Raw = Record<RateType.Raw, RatePoint.Raw[] | null | undefined>;
+}

package/dist/cjs/serialization/resources/metrics/types/QueryRatesResponse.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.QueryRatesResponse = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+const RatePoint_js_1 = require("./RatePoint.js");
+const RateType_js_1 = require("./RateType.js");
+exports.QueryRatesResponse = core.serialization.partialRecord(RateType_js_1.RateType, core.serialization.list(RatePoint_js_1.RatePoint).optional());

package/dist/cjs/serialization/resources/metrics/types/RatePeriod.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 RatePeriod: core.serialization.Schema<serializers.RatePeriod.Raw, AgentMail.RatePeriod>;
+export declare namespace RatePeriod {
+    type Raw = number;
+}

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

@@ -0,0 +1,39 @@
+"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.RatePeriod = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+exports.RatePeriod = core.serialization.number();

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

@@ -0,0 +1,11 @@
+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 RatePoint: core.serialization.ObjectSchema<serializers.RatePoint.Raw, AgentMail.RatePoint>;
+export declare namespace RatePoint {
+    interface Raw {
+        timestamp: string;
+        rate?: number | null;
+        sent: number;
+    }
+}

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

@@ -0,0 +1,43 @@
+"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.RatePoint = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+exports.RatePoint = core.serialization.object({
+    timestamp: core.serialization.date(),
+    rate: core.serialization.number().optional(),
+    sent: core.serialization.number(),
+});

package/dist/cjs/serialization/resources/metrics/types/RateType.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 RateType: core.serialization.Schema<serializers.RateType.Raw, AgentMail.RateType>;
+export declare namespace RateType {
+    type Raw = "bounce" | "complaint";
+}

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

@@ -0,0 +1,39 @@
+"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.RateType = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+exports.RateType = core.serialization.enum_(["bounce", "complaint"]);

package/dist/cjs/serialization/resources/metrics/types/RateTypes.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 { RateType } from "./RateType.js";
+export declare const RateTypes: core.serialization.Schema<serializers.RateTypes.Raw, AgentMail.RateTypes>;
+export declare namespace RateTypes {
+    type Raw = RateType.Raw[];
+}

package/dist/cjs/serialization/resources/metrics/types/RateTypes.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.RateTypes = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+const RateType_js_1 = require("./RateType.js");
+exports.RateTypes = core.serialization.list(RateType_js_1.RateType);

package/dist/cjs/serialization/resources/metrics/types/Window.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 Window: core.serialization.Schema<serializers.Window.Raw, AgentMail.Window>;
+export declare namespace Window {
+    type Raw = number;
+}

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

@@ -0,0 +1,39 @@
+"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.Window = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+exports.Window = core.serialization.number();

package/dist/cjs/serialization/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/serialization/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/serialization/resources/webhooks/types/UpdateInboxWebhookRequest.d.ts

@@ -6,5 +6,6 @@ export declare const UpdateInboxWebhookRequest: core.serialization.ObjectSchema<
 export declare namespace UpdateInboxWebhookRequest {
     interface Raw {
         event_types?: UpdateWebhookEventTypes.Raw | null;
+        enabled?: boolean | null;
     }
 }

package/dist/cjs/serialization/resources/webhooks/types/UpdateInboxWebhookRequest.js

@@ -39,4 +39,5 @@ const core = __importStar(require("../../../../core/index.js"));
 const UpdateWebhookEventTypes_js_1 = require("./UpdateWebhookEventTypes.js");
 exports.UpdateInboxWebhookRequest = core.serialization.object({
     eventTypes: core.serialization.property("event_types", UpdateWebhookEventTypes_js_1.UpdateWebhookEventTypes.optional()),
+    enabled: core.serialization.boolean().optional(),
 });

package/dist/cjs/serialization/resources/webhooks/types/Webhook.d.ts

@@ -15,6 +15,8 @@ export declare namespace Webhook {
         event_types?: EventTypes.Raw | null;
         pod_ids?: PodIds.Raw | null;
         inbox_ids?: InboxIds.Raw | null;
+        pod_id?: string | null;
+        inbox_id?: string | null;
         secret: string;
         enabled: boolean;
         updated_at: string;

package/dist/cjs/serialization/resources/webhooks/types/Webhook.js

@@ -48,6 +48,8 @@ exports.Webhook = core.serialization.object({
     eventTypes: core.serialization.property("event_types", EventTypes_js_1.EventTypes.optional()),
     podIds: core.serialization.property("pod_ids", PodIds_js_1.PodIds.optional()),
     inboxIds: core.serialization.property("inbox_ids", InboxIds_js_1.InboxIds.optional()),
+    podId: core.serialization.property("pod_id", core.serialization.string().optional()),
+    inboxId: core.serialization.property("inbox_id", core.serialization.string().optional()),
     secret: core.serialization.string(),
     enabled: core.serialization.boolean(),
     updatedAt: core.serialization.property("updated_at", core.serialization.date()),

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.5.28";
+export declare const SDK_VERSION = "0.5.30";

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.28";
+exports.SDK_VERSION = "0.5.30";

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.28",
-        "User-Agent": "agentmail/0.5.28",
+        "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/esm/api/resources/attachments/types/AttachmentResponse.d.mts

@@ -6,8 +6,10 @@ export interface AttachmentResponse {
     contentType?: AgentMail.AttachmentContentType;
     contentDisposition?: AgentMail.AttachmentContentDisposition;
     contentId?: AgentMail.AttachmentContentId;
-    /** URL to download the attachment. */
+    /** Signed HTTPS CDN URL to download the attachment bytes. Retrieve a fresh URL when needed rather than storing it permanently. */
     downloadUrl: string;
-    /** Time at which the download URL expires. */
+    /** Signed HTTPS CDN URL to download extracted plain text, when available. Omitted when no extracted text is available. Expires at the same time as download_url. */
+    textUrl?: string;
+    /** Time at which download_url and text_url (when present) expire. Retrieve the attachment again to obtain fresh URLs. */
     expiresAt: Date;
 }

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

@@ -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/esm/api/resources/inboxes/resources/metrics/client/Client.mjs

@@ -202,4 +202,102 @@ export class MetricsClient {
             return 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
+                    ? 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 = 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 handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v0/inboxes/{inbox_id}/metrics/rates");
+        });
+    }
 }