agentmail 0.5.13 → 0.5.15

package/dist/cjs/serialization/{resources/drafts/types/CreateDraftForwardRequest.js → types/ErrorCode.js}

@@ -34,29 +34,6 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateDraftForwardRequest = void 0;
-const core = __importStar(require("../../../../core/index.js"));
-const SendAttachment_js_1 = require("../../attachments/types/SendAttachment.js");
-const DraftBcc_js_1 = require("./DraftBcc.js");
-const DraftCc_js_1 = require("./DraftCc.js");
-const DraftClientId_js_1 = require("./DraftClientId.js");
-const DraftHtml_js_1 = require("./DraftHtml.js");
-const DraftLabels_js_1 = require("./DraftLabels.js");
-const DraftReplyTo_js_1 = require("./DraftReplyTo.js");
-const DraftSendAt_js_1 = require("./DraftSendAt.js");
-const DraftSubject_js_1 = require("./DraftSubject.js");
-const DraftText_js_1 = require("./DraftText.js");
-const DraftTo_js_1 = require("./DraftTo.js");
-exports.CreateDraftForwardRequest = core.serialization.object({
-    labels: DraftLabels_js_1.DraftLabels.optional(),
-    replyTo: core.serialization.property("reply_to", DraftReplyTo_js_1.DraftReplyTo.optional()),
-    to: DraftTo_js_1.DraftTo.optional(),
-    cc: DraftCc_js_1.DraftCc.optional(),
-    bcc: DraftBcc_js_1.DraftBcc.optional(),
-    subject: DraftSubject_js_1.DraftSubject.optional(),
-    text: DraftText_js_1.DraftText.optional(),
-    html: DraftHtml_js_1.DraftHtml.optional(),
-    attachments: core.serialization.list(SendAttachment_js_1.SendAttachment).optional(),
-    sendAt: core.serialization.property("send_at", DraftSendAt_js_1.DraftSendAt.optional()),
-    clientId: core.serialization.property("client_id", DraftClientId_js_1.DraftClientId.optional()),
-});
+exports.ErrorCode = void 0;
+const core = __importStar(require("../../core/index.js"));
+exports.ErrorCode = core.serialization.string();

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

package/dist/cjs/serialization/types/ErrorDocs.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.ErrorDocs = void 0;
+const core = __importStar(require("../../core/index.js"));
+exports.ErrorDocs = core.serialization.string();

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

package/dist/cjs/serialization/types/ErrorFix.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.ErrorFix = void 0;
+const core = __importStar(require("../../core/index.js"));
+exports.ErrorFix = core.serialization.string();

package/dist/cjs/serialization/types/ErrorResponse.d.ts

@@ -1,12 +1,18 @@
 import type * as AgentMail from "../../api/index.js";
 import * as core from "../../core/index.js";
 import type * as serializers from "../index.js";
+import { ErrorCode } from "./ErrorCode.js";
+import { ErrorDocs } from "./ErrorDocs.js";
+import { ErrorFix } from "./ErrorFix.js";
 import { ErrorMessage } from "./ErrorMessage.js";
 import { ErrorName } from "./ErrorName.js";
 export declare const ErrorResponse: core.serialization.ObjectSchema<serializers.ErrorResponse.Raw, AgentMail.ErrorResponse>;
 export declare namespace ErrorResponse {
     interface Raw {
         name: ErrorName.Raw;
+        code?: ErrorCode.Raw | null;
         message: ErrorMessage.Raw;
+        fix?: ErrorFix.Raw | null;
+        docs?: ErrorDocs.Raw | null;
     }
 }

package/dist/cjs/serialization/types/ErrorResponse.js

@@ -36,9 +36,15 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ErrorResponse = void 0;
 const core = __importStar(require("../../core/index.js"));
+const ErrorCode_js_1 = require("./ErrorCode.js");
+const ErrorDocs_js_1 = require("./ErrorDocs.js");
+const ErrorFix_js_1 = require("./ErrorFix.js");
 const ErrorMessage_js_1 = require("./ErrorMessage.js");
 const ErrorName_js_1 = require("./ErrorName.js");
 exports.ErrorResponse = core.serialization.object({
     name: ErrorName_js_1.ErrorName,
+    code: ErrorCode_js_1.ErrorCode.optional(),
     message: ErrorMessage_js_1.ErrorMessage,
+    fix: ErrorFix_js_1.ErrorFix.optional(),
+    docs: ErrorDocs_js_1.ErrorDocs.optional(),
 });

package/dist/cjs/serialization/types/ValidationErrorResponse.d.ts

@@ -1,11 +1,19 @@
 import type * as AgentMail from "../../api/index.js";
 import * as core from "../../core/index.js";
 import type * as serializers from "../index.js";
+import { ErrorCode } from "./ErrorCode.js";
+import { ErrorDocs } from "./ErrorDocs.js";
+import { ErrorFix } from "./ErrorFix.js";
+import { ErrorMessage } from "./ErrorMessage.js";
 import { ErrorName } from "./ErrorName.js";
 export declare const ValidationErrorResponse: core.serialization.ObjectSchema<serializers.ValidationErrorResponse.Raw, AgentMail.ValidationErrorResponse>;
 export declare namespace ValidationErrorResponse {
     interface Raw {
         name: ErrorName.Raw;
+        code?: ErrorCode.Raw | null;
+        message?: ErrorMessage.Raw | null;
         errors?: unknown;
+        fix?: ErrorFix.Raw | null;
+        docs?: ErrorDocs.Raw | null;
     }
 }

package/dist/cjs/serialization/types/ValidationErrorResponse.js

@@ -36,8 +36,16 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ValidationErrorResponse = void 0;
 const core = __importStar(require("../../core/index.js"));
+const ErrorCode_js_1 = require("./ErrorCode.js");
+const ErrorDocs_js_1 = require("./ErrorDocs.js");
+const ErrorFix_js_1 = require("./ErrorFix.js");
+const ErrorMessage_js_1 = require("./ErrorMessage.js");
 const ErrorName_js_1 = require("./ErrorName.js");
 exports.ValidationErrorResponse = core.serialization.object({
     name: ErrorName_js_1.ErrorName,
+    code: ErrorCode_js_1.ErrorCode.optional(),
+    message: ErrorMessage_js_1.ErrorMessage.optional(),
     errors: core.serialization.unknown(),
+    fix: ErrorFix_js_1.ErrorFix.optional(),
+    docs: ErrorDocs_js_1.ErrorDocs.optional(),
 });

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

@@ -2,6 +2,9 @@ export * from "./After.js";
 export * from "./Ascending.js";
 export * from "./Before.js";
 export * from "./Count.js";
+export * from "./ErrorCode.js";
+export * from "./ErrorDocs.js";
+export * from "./ErrorFix.js";
 export * from "./ErrorMessage.js";
 export * from "./ErrorName.js";
 export * from "./ErrorResponse.js";

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

@@ -18,6 +18,9 @@ __exportStar(require("./After.js"), exports);
 __exportStar(require("./Ascending.js"), exports);
 __exportStar(require("./Before.js"), exports);
 __exportStar(require("./Count.js"), exports);
+__exportStar(require("./ErrorCode.js"), exports);
+__exportStar(require("./ErrorDocs.js"), exports);
+__exportStar(require("./ErrorFix.js"), exports);
 __exportStar(require("./ErrorMessage.js"), exports);
 __exportStar(require("./ErrorName.js"), exports);
 __exportStar(require("./ErrorResponse.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.5.13";
+export declare const SDK_VERSION = "0.5.15";

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.13";
+exports.SDK_VERSION = "0.5.15";

package/dist/esm/BaseClient.d.mts

@@ -28,6 +28,9 @@ export interface BaseRequestOptions {
     /** Additional headers to include in the request. */
     headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
 }
+export interface BaseIdempotentRequestOptions {
+    idempotencyKey?: string | undefined;
+}
 export type NormalizedClientOptions<T extends BaseClientOptions = BaseClientOptions> = T & {
     logging: core.logging.Logger;
     authProvider?: core.AuthProvider;

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.13",
-        "User-Agent": "agentmail/0.5.13",
+        "X-Fern-SDK-Version": "0.5.15",
+        "User-Agent": "agentmail/0.5.15",
         "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/errors/ConflictError.d.mts

@@ -0,0 +1,6 @@
+import type * as core from "../../core/index.mjs";
+import * as errors from "../../errors/index.mjs";
+import type * as AgentMail from "../index.mjs";
+export declare class ConflictError extends errors.AgentMailError {
+    constructor(body: AgentMail.ErrorResponse, rawResponse?: core.RawResponse);
+}

package/dist/esm/api/errors/ConflictError.mjs

@@ -0,0 +1,17 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as errors from "../../errors/index.mjs";
+export class ConflictError extends errors.AgentMailError {
+    constructor(body, rawResponse) {
+        super({
+            message: "ConflictError",
+            statusCode: 409,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = this.constructor.name;
+    }
+}

package/dist/esm/api/errors/index.d.mts

@@ -1,3 +1,4 @@
+export * from "./ConflictError.mjs";
 export * from "./IsTakenError.mjs";
 export * from "./NotFoundError.mjs";
 export * from "./UnprocessableError.mjs";

package/dist/esm/api/errors/index.mjs

@@ -1,3 +1,4 @@
+export * from "./ConflictError.mjs";
 export * from "./IsTakenError.mjs";
 export * from "./NotFoundError.mjs";
 export * from "./UnprocessableError.mjs";

package/dist/esm/api/resources/drafts/types/CreateDraftRequest.d.mts

@@ -1,4 +1,19 @@
 import type * as AgentMail from "../../../index.mjs";
+/**
+ * Body for creating a draft. Supports plain, reply, reply-all, and forward
+ * drafts:
+ *
+ * - **Plain draft:** supply `to`, `subject`, `text`, etc.
+ * - **Reply:** set `in_reply_to` to a message ID. Recipients, subject, and
+ *   threading are derived from that message. Set `reply_all` to address the
+ *   whole thread (you then cannot also pass `to`, `cc`, or `bcc`).
+ * - **Forward:** set `forward_of` to a message ID. The subject and threading
+ *   are derived from the source message, whose body and attachments are
+ *   merged in at send time.
+ *
+ * `in_reply_to` and `forward_of` are mutually exclusive, and reading the
+ * referenced message requires `message_read` permission.
+ */
 export interface CreateDraftRequest {
     labels?: AgentMail.DraftLabels;
     replyTo?: AgentMail.DraftReplyTo;
@@ -11,6 +26,8 @@ export interface CreateDraftRequest {
     /** Attachments to include in draft. */
     attachments?: AgentMail.SendAttachment[];
     inReplyTo?: AgentMail.DraftInReplyTo;
+    forwardOf?: AgentMail.DraftForwardOf;
+    replyAll?: AgentMail.DraftReplyAll;
     sendAt?: AgentMail.DraftSendAt;
     clientId?: AgentMail.DraftClientId;
 }

package/dist/esm/api/resources/drafts/types/UpdateDraftRequest.d.mts

@@ -1,11 +1,25 @@
 import type * as AgentMail from "../../../index.mjs";
+/**
+ * Edit fields on an existing draft. A draft's kind (plain, reply, or forward)
+ * is fixed at creation and cannot be changed here. Omitting a field leaves it
+ * unchanged; passing `null` (or `[]` for a recipient field) clears it. Pass
+ * `send_at` to schedule or reschedule the draft, or `null` to un-schedule it.
+ */
 export interface UpdateDraftRequest {
-    replyTo?: AgentMail.DraftReplyTo;
-    to?: AgentMail.DraftTo;
-    cc?: AgentMail.DraftCc;
-    bcc?: AgentMail.DraftBcc;
-    subject?: AgentMail.DraftSubject;
-    text?: AgentMail.DraftText;
-    html?: AgentMail.DraftHtml;
-    sendAt?: AgentMail.DraftSendAt;
+    replyTo?: AgentMail.DraftReplyTo | null;
+    to?: AgentMail.DraftTo | null;
+    cc?: AgentMail.DraftCc | null;
+    bcc?: AgentMail.DraftBcc | null;
+    subject?: AgentMail.DraftSubject | null;
+    text?: AgentMail.DraftText | null;
+    html?: AgentMail.DraftHtml | null;
+    /** Attachments to add to the draft. */
+    addAttachments?: AgentMail.SendAttachment[];
+    /** IDs of attachments to remove from the draft. */
+    removeAttachments?: AgentMail.AttachmentId[];
+    /** Label or labels to add to the draft. */
+    addLabels?: AgentMail.DraftLabels;
+    /** Label or labels to remove from the draft. */
+    removeLabels?: AgentMail.DraftLabels;
+    sendAt?: AgentMail.DraftSendAt | null;
 }

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

@@ -1,6 +1,3 @@
-export * from "./CreateDraftForwardRequest.mjs";
-export * from "./CreateDraftReplyAllRequest.mjs";
-export * from "./CreateDraftReplyRequest.mjs";
 export * from "./CreateDraftRequest.mjs";
 export * from "./Draft.mjs";
 export * from "./DraftAttachments.mjs";

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

@@ -1,6 +1,3 @@
-export * from "./CreateDraftForwardRequest.mjs";
-export * from "./CreateDraftReplyAllRequest.mjs";
-export * from "./CreateDraftReplyRequest.mjs";
 export * from "./CreateDraftRequest.mjs";
 export * from "./Draft.mjs";
 export * from "./DraftAttachments.mjs";

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

@@ -1,4 +1,4 @@
-import type { BaseClientOptions, BaseRequestOptions } from "../../../../../../BaseClient.mjs";
+import type { BaseClientOptions, BaseIdempotentRequestOptions, BaseRequestOptions } from "../../../../../../BaseClient.mjs";
 import { type NormalizedClientOptionsWithAuth } from "../../../../../../BaseClient.mjs";
 import * as core from "../../../../../../core/index.mjs";
 import * as AgentMail from "../../../../../index.mjs";
@@ -6,6 +6,8 @@ export declare namespace DraftsClient {
     type Options = BaseClientOptions;
     interface RequestOptions extends BaseRequestOptions {
     }
+    interface IdempotentRequestOptions extends RequestOptions, BaseIdempotentRequestOptions {
+    }
 }
 export declare class DraftsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<DraftsClient.Options>;
@@ -63,6 +65,12 @@ export declare class DraftsClient {
     getAttachment(inbox_id: AgentMail.inboxes.InboxId, draft_id: AgentMail.DraftId, attachment_id: AgentMail.AttachmentId, requestOptions?: DraftsClient.RequestOptions): core.HttpResponsePromise<AgentMail.AttachmentResponse>;
     private __getAttachment;
     /**
+     * Create a draft. Supply `in_reply_to` to create a reply draft (with
+     * `reply_all` to address the whole thread), whose recipients, subject, and
+     * threading are derived from the referenced message, or `forward_of` to
+     * create a forward draft, which derives the subject, threading, and
+     * forwarded content from the source but keeps recipients caller-supplied.
+     *
      * **CLI:**
      * ```bash
      * agentmail inboxes:drafts create --inbox-id <inbox_id> --to recipient@example.com --subject "Draft subject" --text "Draft body"
@@ -72,6 +80,7 @@ export declare class DraftsClient {
      * @param {AgentMail.CreateDraftRequest} request
      * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AgentMail.ValidationError}
      * @throws {@link AgentMail.NotFoundError}
      *
      * @example
@@ -80,6 +89,10 @@ export declare class DraftsClient {
     create(inbox_id: AgentMail.inboxes.InboxId, request: AgentMail.CreateDraftRequest, requestOptions?: DraftsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Draft>;
     private __create;
     /**
+     * Edit fields on an existing draft. Passing `null` clears a field (or `[]`
+     * for a recipient field); `send_at: null` un-schedules a scheduled draft.
+     * A draft that is already being sent cannot be edited.
+     *
      * **CLI:**
      * ```bash
      * agentmail inboxes:drafts update --inbox-id <inbox_id> --draft-id <draft_id> --subject "Updated subject"
@@ -90,7 +103,9 @@ export declare class DraftsClient {
      * @param {AgentMail.UpdateDraftRequest} request
      * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AgentMail.ValidationError}
      * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ConflictError}
      *
      * @example
      *     await client.inboxes.drafts.update("inbox_id", "draft_id", {})
@@ -123,15 +138,16 @@ export declare class DraftsClient {
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {AgentMail.DraftId} draft_id
      * @param {AgentMail.UpdateMessageRequest} request
-     * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.
+     * @param {DraftsClient.IdempotentRequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.NotFoundError}
      * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.ConflictError}
      * @throws {@link AgentMail.MessageRejectedError}
      *
      * @example
      *     await client.inboxes.drafts.send("inbox_id", "draft_id", {})
      */
-    send(inbox_id: AgentMail.inboxes.InboxId, draft_id: AgentMail.DraftId, request: AgentMail.UpdateMessageRequest, requestOptions?: DraftsClient.RequestOptions): core.HttpResponsePromise<AgentMail.SendMessageResponse>;
+    send(inbox_id: AgentMail.inboxes.InboxId, draft_id: AgentMail.DraftId, request: AgentMail.UpdateMessageRequest, requestOptions?: DraftsClient.IdempotentRequestOptions): core.HttpResponsePromise<AgentMail.SendMessageResponse>;
     private __send;
 }

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

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { normalizeClientOptionsWithAuth } from "../../../../../../BaseClient.mjs";
-import { mergeHeaders } from "../../../../../../core/headers.mjs";
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../../../core/headers.mjs";
 import * as core from "../../../../../../core/index.mjs";
 import { toJson } from "../../../../../../core/json.mjs";
 import * as environments from "../../../../../../environments.mjs";
@@ -245,6 +245,12 @@ export class DraftsClient {
         });
     }
     /**
+     * Create a draft. Supply `in_reply_to` to create a reply draft (with
+     * `reply_all` to address the whole thread), whose recipients, subject, and
+     * threading are derived from the referenced message, or `forward_of` to
+     * create a forward draft, which derives the subject, threading, and
+     * forwarded content from the source but keeps recipients caller-supplied.
+     *
      * **CLI:**
      * ```bash
      * agentmail inboxes:drafts create --inbox-id <inbox_id> --to recipient@example.com --subject "Draft subject" --text "Draft body"
@@ -254,6 +260,7 @@ export class DraftsClient {
      * @param {AgentMail.CreateDraftRequest} request
      * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AgentMail.ValidationError}
      * @throws {@link AgentMail.NotFoundError}
      *
      * @example
@@ -299,6 +306,14 @@ export class DraftsClient {
             }
             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);
                     case 404:
                         throw new AgentMail.NotFoundError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -319,6 +334,10 @@ export class DraftsClient {
         });
     }
     /**
+     * Edit fields on an existing draft. Passing `null` clears a field (or `[]`
+     * for a recipient field); `send_at: null` un-schedules a scheduled draft.
+     * A draft that is already being sent cannot be edited.
+     *
      * **CLI:**
      * ```bash
      * agentmail inboxes:drafts update --inbox-id <inbox_id> --draft-id <draft_id> --subject "Updated subject"
@@ -329,7 +348,9 @@ export class DraftsClient {
      * @param {AgentMail.UpdateDraftRequest} request
      * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AgentMail.ValidationError}
      * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ConflictError}
      *
      * @example
      *     await client.inboxes.drafts.update("inbox_id", "draft_id", {})
@@ -374,6 +395,14 @@ export class DraftsClient {
             }
             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);
                     case 404:
                         throw new AgentMail.NotFoundError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -382,6 +411,14 @@ export class DraftsClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
+                    case 409:
+                        throw new AgentMail.ConflictError(serializers.ErrorResponse.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,
@@ -461,10 +498,11 @@ export class DraftsClient {
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {AgentMail.DraftId} draft_id
      * @param {AgentMail.UpdateMessageRequest} request
-     * @param {DraftsClient.RequestOptions} requestOptions - Request-specific configuration.
+     * @param {DraftsClient.IdempotentRequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.NotFoundError}
      * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.ConflictError}
      * @throws {@link AgentMail.MessageRejectedError}
      *
      * @example
@@ -477,7 +515,7 @@ export class DraftsClient {
         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 _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "Idempotency-Key": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.idempotencyKey }), 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 }))}/drafts/${core.url.encodePathParam(serializers.DraftId.jsonOrThrow(draft_id, { omitUndefined: true }))}/send`),
@@ -526,6 +564,14 @@ export class DraftsClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
+                    case 409:
+                        throw new AgentMail.ConflictError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
                     case 403:
                         throw new AgentMail.MessageRejectedError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",