agentmail 0.1.19 → 0.2.1

package/README.md

@@ -5,6 +5,26 @@
 
 The Agentmail TypeScript library provides convenient access to the Agentmail APIs from TypeScript.
 
+## Table of Contents
+
+- [Installation](#installation)
+- [Reference](#reference)
+- [Usage](#usage)
+- [Request and Response Types](#request-and-response-types)
+- [Exception Handling](#exception-handling)
+- [Pagination](#pagination)
+- [Advanced](#advanced)
+  - [Additional Headers](#additional-headers)
+  - [Additional Query String Parameters](#additional-query-string-parameters)
+  - [Retries](#retries)
+  - [Timeouts](#timeouts)
+  - [Aborting Requests](#aborting-requests)
+  - [Access Raw Response Data](#access-raw-response-data)
+  - [Logging](#logging)
+  - [Runtime Compatibility](#runtime-compatibility)
+- [Contributing](#contributing)
+- [Binary Response](#binary-response)
+
 ## Installation
 
 ```sh

package/dist/cjs/BaseClient.js

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

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

@@ -0,0 +1,13 @@
+import type * as AgentMail from "../../../index.js";
+export interface AttachmentResponse {
+    attachmentId: AgentMail.AttachmentId;
+    filename?: AgentMail.AttachmentFilename;
+    size: AgentMail.AttachmentSize;
+    contentType?: AgentMail.AttachmentContentType;
+    contentDisposition?: AgentMail.AttachmentContentDisposition;
+    contentId?: AgentMail.AttachmentContentId;
+    /** URL to download the attachment. */
+    downloadUrl: string;
+    /** Time at which the download URL expires. */
+    expiresAt: Date;
+}

package/dist/cjs/api/resources/attachments/types/AttachmentResponse.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/attachments/types/index.d.ts

@@ -5,5 +5,6 @@ export * from "./AttachmentContentId.js";
 export * from "./AttachmentContentType.js";
 export * from "./AttachmentFilename.js";
 export * from "./AttachmentId.js";
+export * from "./AttachmentResponse.js";
 export * from "./AttachmentSize.js";
 export * from "./SendAttachment.js";

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

@@ -21,5 +21,6 @@ __exportStar(require("./AttachmentContentId.js"), exports);
 __exportStar(require("./AttachmentContentType.js"), exports);
 __exportStar(require("./AttachmentFilename.js"), exports);
 __exportStar(require("./AttachmentId.js"), exports);
+__exportStar(require("./AttachmentResponse.js"), exports);
 __exportStar(require("./AttachmentSize.js"), exports);
 __exportStar(require("./SendAttachment.js"), exports);

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

@@ -36,9 +36,17 @@ export declare class MessagesClient {
     get(inbox_id: AgentMail.inboxes.InboxId, message_id: AgentMail.MessageId, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<AgentMail.Message>;
     private __get;
     /**
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.MessageId} message_id
+     * @param {AgentMail.AttachmentId} attachment_id
+     * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.inboxes.messages.getAttachment("inbox_id", "message_id", "attachment_id")
      */
-    getAttachment(inbox_id: AgentMail.inboxes.InboxId, message_id: AgentMail.MessageId, attachment_id: AgentMail.AttachmentId, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    getAttachment(inbox_id: AgentMail.inboxes.InboxId, message_id: AgentMail.MessageId, attachment_id: AgentMail.AttachmentId, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<AgentMail.AttachmentResponse>;
     private __getAttachment;
     /**
      * @throws {@link AgentMail.NotFoundError}

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

@@ -232,7 +232,15 @@ class MessagesClient {
         });
     }
     /**
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.MessageId} message_id
+     * @param {AgentMail.AttachmentId} attachment_id
+     * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.inboxes.messages.getAttachment("inbox_id", "message_id", "attachment_id")
      */
     getAttachment(inbox_id, message_id, attachment_id, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__getAttachment(inbox_id, message_id, attachment_id, requestOptions));
@@ -247,7 +255,6 @@ class MessagesClient {
                 method: "GET",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                responseType: "binary-response",
                 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,
@@ -255,7 +262,16 @@ class MessagesClient {
                 logging: this._options.logging,
             });
             if (_response.ok) {
-                return { data: _response.body, rawResponse: _response.rawResponse };
+                return {
+                    data: serializers.AttachmentResponse.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) {

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

@@ -36,9 +36,17 @@ export declare class ThreadsClient {
     get(inbox_id: AgentMail.inboxes.InboxId, thread_id: AgentMail.ThreadId, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Thread>;
     private __get;
     /**
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.ThreadId} thread_id
+     * @param {AgentMail.AttachmentId} attachment_id
+     * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.inboxes.threads.getAttachment("inbox_id", "thread_id", "attachment_id")
      */
-    getAttachment(inbox_id: AgentMail.inboxes.InboxId, thread_id: AgentMail.ThreadId, attachment_id: AgentMail.AttachmentId, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    getAttachment(inbox_id: AgentMail.inboxes.InboxId, thread_id: AgentMail.ThreadId, attachment_id: AgentMail.AttachmentId, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<AgentMail.AttachmentResponse>;
     private __getAttachment;
     /**
      * @param {AgentMail.inboxes.InboxId} inbox_id

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

@@ -232,7 +232,15 @@ class ThreadsClient {
         });
     }
     /**
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.ThreadId} thread_id
+     * @param {AgentMail.AttachmentId} attachment_id
+     * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.inboxes.threads.getAttachment("inbox_id", "thread_id", "attachment_id")
      */
     getAttachment(inbox_id, thread_id, attachment_id, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__getAttachment(inbox_id, thread_id, attachment_id, requestOptions));
@@ -247,7 +255,6 @@ class ThreadsClient {
                 method: "GET",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                responseType: "binary-response",
                 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,
@@ -255,7 +262,16 @@ class ThreadsClient {
                 logging: this._options.logging,
             });
             if (_response.ok) {
-                return { data: _response.body, rawResponse: _response.rawResponse };
+                return {
+                    data: serializers.AttachmentResponse.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) {

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

@@ -36,8 +36,16 @@ export declare class ThreadsClient {
     get(pod_id: AgentMail.pods.PodId, thread_id: AgentMail.ThreadId, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Thread>;
     private __get;
     /**
+     * @param {AgentMail.pods.PodId} pod_id
+     * @param {AgentMail.ThreadId} thread_id
+     * @param {AgentMail.AttachmentId} attachment_id
+     * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.pods.threads.getAttachment("pod_id", "thread_id", "attachment_id")
      */
-    getAttachment(pod_id: AgentMail.pods.PodId, thread_id: AgentMail.ThreadId, attachment_id: AgentMail.AttachmentId, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    getAttachment(pod_id: AgentMail.pods.PodId, thread_id: AgentMail.ThreadId, attachment_id: AgentMail.AttachmentId, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<AgentMail.AttachmentResponse>;
     private __getAttachment;
 }

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

@@ -232,7 +232,15 @@ class ThreadsClient {
         });
     }
     /**
+     * @param {AgentMail.pods.PodId} pod_id
+     * @param {AgentMail.ThreadId} thread_id
+     * @param {AgentMail.AttachmentId} attachment_id
+     * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.pods.threads.getAttachment("pod_id", "thread_id", "attachment_id")
      */
     getAttachment(pod_id, thread_id, attachment_id, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__getAttachment(pod_id, thread_id, attachment_id, requestOptions));
@@ -247,7 +255,6 @@ class ThreadsClient {
                 method: "GET",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                responseType: "binary-response",
                 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,
@@ -255,7 +262,16 @@ class ThreadsClient {
                 logging: this._options.logging,
             });
             if (_response.ok) {
-                return { data: _response.body, rawResponse: _response.rawResponse };
+                return {
+                    data: serializers.AttachmentResponse.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) {

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

@@ -34,8 +34,15 @@ export declare class ThreadsClient {
     get(thread_id: AgentMail.ThreadId, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Thread>;
     private __get;
     /**
+     * @param {AgentMail.ThreadId} thread_id
+     * @param {AgentMail.AttachmentId} attachment_id
+     * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.threads.getAttachment("thread_id", "attachment_id")
      */
-    getAttachment(thread_id: AgentMail.ThreadId, attachment_id: AgentMail.AttachmentId, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    getAttachment(thread_id: AgentMail.ThreadId, attachment_id: AgentMail.AttachmentId, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<AgentMail.AttachmentResponse>;
     private __getAttachment;
 }

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

@@ -230,7 +230,14 @@ class ThreadsClient {
         });
     }
     /**
+     * @param {AgentMail.ThreadId} thread_id
+     * @param {AgentMail.AttachmentId} attachment_id
+     * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.threads.getAttachment("thread_id", "attachment_id")
      */
     getAttachment(thread_id, attachment_id, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__getAttachment(thread_id, attachment_id, requestOptions));
@@ -245,7 +252,6 @@ class ThreadsClient {
                 method: "GET",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                responseType: "binary-response",
                 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,
@@ -253,7 +259,16 @@ class ThreadsClient {
                 logging: this._options.logging,
             });
             if (_response.ok) {
-                return { data: _response.body, rawResponse: _response.rawResponse };
+                return {
+                    data: serializers.AttachmentResponse.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) {

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

@@ -0,0 +1,22 @@
+import type * as AgentMail from "../../../../api/index.js";
+import * as core from "../../../../core/index.js";
+import type * as serializers from "../../../index.js";
+import { AttachmentContentDisposition } from "./AttachmentContentDisposition.js";
+import { AttachmentContentId } from "./AttachmentContentId.js";
+import { AttachmentContentType } from "./AttachmentContentType.js";
+import { AttachmentFilename } from "./AttachmentFilename.js";
+import { AttachmentId } from "./AttachmentId.js";
+import { AttachmentSize } from "./AttachmentSize.js";
+export declare const AttachmentResponse: core.serialization.ObjectSchema<serializers.AttachmentResponse.Raw, AgentMail.AttachmentResponse>;
+export declare namespace AttachmentResponse {
+    interface Raw {
+        attachment_id: AttachmentId.Raw;
+        filename?: AttachmentFilename.Raw | null;
+        size: AttachmentSize.Raw;
+        content_type?: AttachmentContentType.Raw | null;
+        content_disposition?: AttachmentContentDisposition.Raw | null;
+        content_id?: AttachmentContentId.Raw | null;
+        download_url: string;
+        expires_at: string;
+    }
+}

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

@@ -0,0 +1,54 @@
+"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.AttachmentResponse = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+const AttachmentContentDisposition_js_1 = require("./AttachmentContentDisposition.js");
+const AttachmentContentId_js_1 = require("./AttachmentContentId.js");
+const AttachmentContentType_js_1 = require("./AttachmentContentType.js");
+const AttachmentFilename_js_1 = require("./AttachmentFilename.js");
+const AttachmentId_js_1 = require("./AttachmentId.js");
+const AttachmentSize_js_1 = require("./AttachmentSize.js");
+exports.AttachmentResponse = core.serialization.object({
+    attachmentId: core.serialization.property("attachment_id", AttachmentId_js_1.AttachmentId),
+    filename: AttachmentFilename_js_1.AttachmentFilename.optional(),
+    size: AttachmentSize_js_1.AttachmentSize,
+    contentType: core.serialization.property("content_type", AttachmentContentType_js_1.AttachmentContentType.optional()),
+    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()),
+    expiresAt: core.serialization.property("expires_at", core.serialization.date()),
+});

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

@@ -5,5 +5,6 @@ export * from "./AttachmentContentId.js";
 export * from "./AttachmentContentType.js";
 export * from "./AttachmentFilename.js";
 export * from "./AttachmentId.js";
+export * from "./AttachmentResponse.js";
 export * from "./AttachmentSize.js";
 export * from "./SendAttachment.js";

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

@@ -21,5 +21,6 @@ __exportStar(require("./AttachmentContentId.js"), exports);
 __exportStar(require("./AttachmentContentType.js"), exports);
 __exportStar(require("./AttachmentFilename.js"), exports);
 __exportStar(require("./AttachmentId.js"), exports);
+__exportStar(require("./AttachmentResponse.js"), exports);
 __exportStar(require("./AttachmentSize.js"), exports);
 __exportStar(require("./SendAttachment.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.1.19";
+export declare const SDK_VERSION = "0.2.1";

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.1.19";
+exports.SDK_VERSION = "0.2.1";

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.1.19",
-        "User-Agent": "agentmail/0.1.19",
+        "X-Fern-SDK-Version": "0.2.1",
+        "User-Agent": "agentmail/0.2.1",
         "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

@@ -0,0 +1,13 @@
+import type * as AgentMail from "../../../index.mjs";
+export interface AttachmentResponse {
+    attachmentId: AgentMail.AttachmentId;
+    filename?: AgentMail.AttachmentFilename;
+    size: AgentMail.AttachmentSize;
+    contentType?: AgentMail.AttachmentContentType;
+    contentDisposition?: AgentMail.AttachmentContentDisposition;
+    contentId?: AgentMail.AttachmentContentId;
+    /** URL to download the attachment. */
+    downloadUrl: string;
+    /** Time at which the download URL expires. */
+    expiresAt: Date;
+}

package/dist/esm/api/resources/attachments/types/AttachmentResponse.mjs

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

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

@@ -5,5 +5,6 @@ export * from "./AttachmentContentId.mjs";
 export * from "./AttachmentContentType.mjs";
 export * from "./AttachmentFilename.mjs";
 export * from "./AttachmentId.mjs";
+export * from "./AttachmentResponse.mjs";
 export * from "./AttachmentSize.mjs";
 export * from "./SendAttachment.mjs";

package/dist/esm/api/resources/attachments/types/index.mjs

@@ -5,5 +5,6 @@ export * from "./AttachmentContentId.mjs";
 export * from "./AttachmentContentType.mjs";
 export * from "./AttachmentFilename.mjs";
 export * from "./AttachmentId.mjs";
+export * from "./AttachmentResponse.mjs";
 export * from "./AttachmentSize.mjs";
 export * from "./SendAttachment.mjs";

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

@@ -36,9 +36,17 @@ export declare class MessagesClient {
     get(inbox_id: AgentMail.inboxes.InboxId, message_id: AgentMail.MessageId, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<AgentMail.Message>;
     private __get;
     /**
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.MessageId} message_id
+     * @param {AgentMail.AttachmentId} attachment_id
+     * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.inboxes.messages.getAttachment("inbox_id", "message_id", "attachment_id")
      */
-    getAttachment(inbox_id: AgentMail.inboxes.InboxId, message_id: AgentMail.MessageId, attachment_id: AgentMail.AttachmentId, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    getAttachment(inbox_id: AgentMail.inboxes.InboxId, message_id: AgentMail.MessageId, attachment_id: AgentMail.AttachmentId, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<AgentMail.AttachmentResponse>;
     private __getAttachment;
     /**
      * @throws {@link AgentMail.NotFoundError}

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

@@ -196,7 +196,15 @@ export class MessagesClient {
         });
     }
     /**
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.MessageId} message_id
+     * @param {AgentMail.AttachmentId} attachment_id
+     * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.inboxes.messages.getAttachment("inbox_id", "message_id", "attachment_id")
      */
     getAttachment(inbox_id, message_id, attachment_id, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__getAttachment(inbox_id, message_id, attachment_id, requestOptions));
@@ -211,7 +219,6 @@ export class MessagesClient {
                 method: "GET",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                responseType: "binary-response",
                 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,
@@ -219,7 +226,16 @@ export class MessagesClient {
                 logging: this._options.logging,
             });
             if (_response.ok) {
-                return { data: _response.body, rawResponse: _response.rawResponse };
+                return {
+                    data: serializers.AttachmentResponse.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) {

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

@@ -36,9 +36,17 @@ export declare class ThreadsClient {
     get(inbox_id: AgentMail.inboxes.InboxId, thread_id: AgentMail.ThreadId, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Thread>;
     private __get;
     /**
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.ThreadId} thread_id
+     * @param {AgentMail.AttachmentId} attachment_id
+     * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.inboxes.threads.getAttachment("inbox_id", "thread_id", "attachment_id")
      */
-    getAttachment(inbox_id: AgentMail.inboxes.InboxId, thread_id: AgentMail.ThreadId, attachment_id: AgentMail.AttachmentId, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    getAttachment(inbox_id: AgentMail.inboxes.InboxId, thread_id: AgentMail.ThreadId, attachment_id: AgentMail.AttachmentId, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<AgentMail.AttachmentResponse>;
     private __getAttachment;
     /**
      * @param {AgentMail.inboxes.InboxId} inbox_id

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

@@ -196,7 +196,15 @@ export class ThreadsClient {
         });
     }
     /**
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.ThreadId} thread_id
+     * @param {AgentMail.AttachmentId} attachment_id
+     * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.inboxes.threads.getAttachment("inbox_id", "thread_id", "attachment_id")
      */
     getAttachment(inbox_id, thread_id, attachment_id, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__getAttachment(inbox_id, thread_id, attachment_id, requestOptions));
@@ -211,7 +219,6 @@ export class ThreadsClient {
                 method: "GET",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                responseType: "binary-response",
                 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,
@@ -219,7 +226,16 @@ export class ThreadsClient {
                 logging: this._options.logging,
             });
             if (_response.ok) {
-                return { data: _response.body, rawResponse: _response.rawResponse };
+                return {
+                    data: serializers.AttachmentResponse.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) {

package/dist/esm/api/resources/pods/resources/threads/client/Client.d.mts

@@ -36,8 +36,16 @@ export declare class ThreadsClient {
     get(pod_id: AgentMail.pods.PodId, thread_id: AgentMail.ThreadId, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Thread>;
     private __get;
     /**
+     * @param {AgentMail.pods.PodId} pod_id
+     * @param {AgentMail.ThreadId} thread_id
+     * @param {AgentMail.AttachmentId} attachment_id
+     * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
      * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.pods.threads.getAttachment("pod_id", "thread_id", "attachment_id")
      */
-    getAttachment(pod_id: AgentMail.pods.PodId, thread_id: AgentMail.ThreadId, attachment_id: AgentMail.AttachmentId, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    getAttachment(pod_id: AgentMail.pods.PodId, thread_id: AgentMail.ThreadId, attachment_id: AgentMail.AttachmentId, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<AgentMail.AttachmentResponse>;
     private __getAttachment;
 }