agentmail 0.5.1 → 0.5.2

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.5.1",
-        "User-Agent": "agentmail/0.5.1",
+        "X-Fern-SDK-Version": "0.5.2",
+        "User-Agent": "agentmail/0.5.2",
         "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/inboxes/resources/messages/client/Client.d.ts

@@ -44,6 +44,29 @@ export declare class MessagesClient {
      */
     get(inbox_id: AgentMail.inboxes.InboxId, message_id: AgentMail.MessageId, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<AgentMail.Message>;
     private __get;
+    /**
+     * Fetch metadata for up to 500 messages in one request. Missing or
+     * restricted IDs are silently omitted; compare `count` against `limit`
+     * to detect misses.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes:messages batch-get --inbox-id <inbox_id> --message-id <id1> --message-id <id2>
+     * ```
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.BatchGetMessagesRequest} request
+     * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.messages.batchGet("inbox_id", {
+     *         messageIds: ["message_ids", "message_ids"]
+     *     })
+     */
+    batchGet(inbox_id: AgentMail.inboxes.InboxId, request: AgentMail.BatchGetMessagesRequest, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<AgentMail.BatchGetMessagesResponse>;
+    private __batchGet;
     /**
      * **CLI:**
      * ```bash

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

@@ -215,6 +215,86 @@ class MessagesClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/inboxes/{inbox_id}/messages/{message_id}");
         });
     }
+    /**
+     * Fetch metadata for up to 500 messages in one request. Missing or
+     * restricted IDs are silently omitted; compare `count` against `limit`
+     * to detect misses.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes:messages batch-get --inbox-id <inbox_id> --message-id <id1> --message-id <id2>
+     * ```
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.BatchGetMessagesRequest} request
+     * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.messages.batchGet("inbox_id", {
+     *         messageIds: ["message_ids", "message_ids"]
+     *     })
+     */
+    batchGet(inbox_id, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__batchGet(inbox_id, request, requestOptions));
+    }
+    __batchGet(inbox_id, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Prod)
+                    .http, `/v0/inboxes/${core.url.encodePathParam(serializers.inboxes.InboxId.jsonOrThrow(inbox_id, { omitUndefined: true }))}/messages/batch-get`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.BatchGetMessagesRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                }),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.BatchGetMessagesResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AgentMail.ValidationError(serializers.ValidationErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v0/inboxes/{inbox_id}/messages/batch-get");
+        });
+    }
     /**
      * **CLI:**
      * ```bash

package/dist/cjs/api/resources/messages/types/BatchGetMessagesMessageIds.d.ts

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

package/dist/cjs/api/resources/messages/types/BatchGetMessagesMessageIds.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/messages/types/BatchGetMessagesRequest.d.ts

@@ -0,0 +1,4 @@
+import type * as AgentMail from "../../../index.js";
+export interface BatchGetMessagesRequest {
+    messageIds: AgentMail.BatchGetMessagesMessageIds;
+}

package/dist/cjs/api/resources/messages/types/BatchGetMessagesRequest.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/messages/types/BatchGetMessagesResponse.d.ts

@@ -0,0 +1,11 @@
+import type * as AgentMail from "../../../index.js";
+export interface BatchGetMessagesResponse {
+    limit: AgentMail.Limit;
+    count: AgentMail.Count;
+    /**
+     * Found messages. Order matches `message_ids` in the request. Body
+     * fields (`text`, `html`, `extracted_text`, `extracted_html`) are
+     * never populated; use the single-message endpoint to retrieve bodies.
+     */
+    messages: AgentMail.Message[];
+}

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

@@ -1,4 +1,7 @@
 export * from "./Addresses.js";
+export * from "./BatchGetMessagesMessageIds.js";
+export * from "./BatchGetMessagesRequest.js";
+export * from "./BatchGetMessagesResponse.js";
 export * from "./ListMessagesResponse.js";
 export * from "./Message.js";
 export * from "./MessageAttachments.js";

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

@@ -15,6 +15,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./Addresses.js"), exports);
+__exportStar(require("./BatchGetMessagesMessageIds.js"), exports);
+__exportStar(require("./BatchGetMessagesRequest.js"), exports);
+__exportStar(require("./BatchGetMessagesResponse.js"), exports);
 __exportStar(require("./ListMessagesResponse.js"), exports);
 __exportStar(require("./Message.js"), exports);
 __exportStar(require("./MessageAttachments.js"), exports);

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

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

package/dist/cjs/serialization/resources/messages/types/BatchGetMessagesRequest.d.ts

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

package/dist/cjs/serialization/resources/messages/types/BatchGetMessagesRequest.js

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

package/dist/cjs/serialization/resources/messages/types/BatchGetMessagesResponse.d.ts

@@ -0,0 +1,14 @@
+import type * as AgentMail from "../../../../api/index.js";
+import * as core from "../../../../core/index.js";
+import type * as serializers from "../../../index.js";
+import { Count } from "../../../types/Count.js";
+import { Limit } from "../../../types/Limit.js";
+import { Message } from "./Message.js";
+export declare const BatchGetMessagesResponse: core.serialization.ObjectSchema<serializers.BatchGetMessagesResponse.Raw, AgentMail.BatchGetMessagesResponse>;
+export declare namespace BatchGetMessagesResponse {
+    interface Raw {
+        limit: Limit.Raw;
+        count: Count.Raw;
+        messages: Message.Raw[];
+    }
+}

package/dist/cjs/serialization/resources/messages/types/BatchGetMessagesResponse.js

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

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

@@ -1,4 +1,7 @@
 export * from "./Addresses.js";
+export * from "./BatchGetMessagesMessageIds.js";
+export * from "./BatchGetMessagesRequest.js";
+export * from "./BatchGetMessagesResponse.js";
 export * from "./ListMessagesResponse.js";
 export * from "./Message.js";
 export * from "./MessageAttachments.js";

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

@@ -15,6 +15,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./Addresses.js"), exports);
+__exportStar(require("./BatchGetMessagesMessageIds.js"), exports);
+__exportStar(require("./BatchGetMessagesRequest.js"), exports);
+__exportStar(require("./BatchGetMessagesResponse.js"), exports);
 __exportStar(require("./ListMessagesResponse.js"), exports);
 __exportStar(require("./Message.js"), exports);
 __exportStar(require("./MessageAttachments.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.5.1";
+export declare const SDK_VERSION = "0.5.2";

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.1";
+exports.SDK_VERSION = "0.5.2";

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.1",
-        "User-Agent": "agentmail/0.5.1",
+        "X-Fern-SDK-Version": "0.5.2",
+        "User-Agent": "agentmail/0.5.2",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

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

@@ -44,6 +44,29 @@ export declare class MessagesClient {
      */
     get(inbox_id: AgentMail.inboxes.InboxId, message_id: AgentMail.MessageId, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<AgentMail.Message>;
     private __get;
+    /**
+     * Fetch metadata for up to 500 messages in one request. Missing or
+     * restricted IDs are silently omitted; compare `count` against `limit`
+     * to detect misses.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes:messages batch-get --inbox-id <inbox_id> --message-id <id1> --message-id <id2>
+     * ```
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.BatchGetMessagesRequest} request
+     * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.messages.batchGet("inbox_id", {
+     *         messageIds: ["message_ids", "message_ids"]
+     *     })
+     */
+    batchGet(inbox_id: AgentMail.inboxes.InboxId, request: AgentMail.BatchGetMessagesRequest, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<AgentMail.BatchGetMessagesResponse>;
+    private __batchGet;
     /**
      * **CLI:**
      * ```bash

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

@@ -179,6 +179,86 @@ export class MessagesClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v0/inboxes/{inbox_id}/messages/{message_id}");
         });
     }
+    /**
+     * Fetch metadata for up to 500 messages in one request. Missing or
+     * restricted IDs are silently omitted; compare `count` against `limit`
+     * to detect misses.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail inboxes:messages batch-get --inbox-id <inbox_id> --message-id <id1> --message-id <id2>
+     * ```
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.BatchGetMessagesRequest} request
+     * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.messages.batchGet("inbox_id", {
+     *         messageIds: ["message_ids", "message_ids"]
+     *     })
+     */
+    batchGet(inbox_id, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__batchGet(inbox_id, request, requestOptions));
+    }
+    __batchGet(inbox_id, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Prod)
+                    .http, `/v0/inboxes/${core.url.encodePathParam(serializers.inboxes.InboxId.jsonOrThrow(inbox_id, { omitUndefined: true }))}/messages/batch-get`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.BatchGetMessagesRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                }),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.BatchGetMessagesResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AgentMail.ValidationError(serializers.ValidationErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v0/inboxes/{inbox_id}/messages/batch-get");
+        });
+    }
     /**
      * **CLI:**
      * ```bash

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

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

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

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

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

@@ -0,0 +1,4 @@
+import type * as AgentMail from "../../../index.mjs";
+export interface BatchGetMessagesRequest {
+    messageIds: AgentMail.BatchGetMessagesMessageIds;
+}

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

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

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

@@ -0,0 +1,11 @@
+import type * as AgentMail from "../../../index.mjs";
+export interface BatchGetMessagesResponse {
+    limit: AgentMail.Limit;
+    count: AgentMail.Count;
+    /**
+     * Found messages. Order matches `message_ids` in the request. Body
+     * fields (`text`, `html`, `extracted_text`, `extracted_html`) are
+     * never populated; use the single-message endpoint to retrieve bodies.
+     */
+    messages: AgentMail.Message[];
+}

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

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

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

@@ -1,4 +1,7 @@
 export * from "./Addresses.mjs";
+export * from "./BatchGetMessagesMessageIds.mjs";
+export * from "./BatchGetMessagesRequest.mjs";
+export * from "./BatchGetMessagesResponse.mjs";
 export * from "./ListMessagesResponse.mjs";
 export * from "./Message.mjs";
 export * from "./MessageAttachments.mjs";

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

@@ -1,4 +1,7 @@
 export * from "./Addresses.mjs";
+export * from "./BatchGetMessagesMessageIds.mjs";
+export * from "./BatchGetMessagesRequest.mjs";
+export * from "./BatchGetMessagesResponse.mjs";
 export * from "./ListMessagesResponse.mjs";
 export * from "./Message.mjs";
 export * from "./MessageAttachments.mjs";

package/dist/esm/serialization/resources/messages/types/BatchGetMessagesMessageIds.d.mts

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

package/dist/esm/serialization/resources/messages/types/BatchGetMessagesMessageIds.mjs

@@ -0,0 +1,4 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../../../core/index.mjs";
+import { MessageId } from "./MessageId.mjs";
+export const BatchGetMessagesMessageIds = core.serialization.list(MessageId);

package/dist/esm/serialization/resources/messages/types/BatchGetMessagesRequest.d.mts

@@ -0,0 +1,10 @@
+import type * as AgentMail from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+import type * as serializers from "../../../index.mjs";
+import { BatchGetMessagesMessageIds } from "./BatchGetMessagesMessageIds.mjs";
+export declare const BatchGetMessagesRequest: core.serialization.ObjectSchema<serializers.BatchGetMessagesRequest.Raw, AgentMail.BatchGetMessagesRequest>;
+export declare namespace BatchGetMessagesRequest {
+    interface Raw {
+        message_ids: BatchGetMessagesMessageIds.Raw;
+    }
+}

package/dist/esm/serialization/resources/messages/types/BatchGetMessagesRequest.mjs

@@ -0,0 +1,6 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../../../core/index.mjs";
+import { BatchGetMessagesMessageIds } from "./BatchGetMessagesMessageIds.mjs";
+export const BatchGetMessagesRequest = core.serialization.object({
+    messageIds: core.serialization.property("message_ids", BatchGetMessagesMessageIds),
+});

package/dist/esm/serialization/resources/messages/types/BatchGetMessagesResponse.d.mts

@@ -0,0 +1,14 @@
+import type * as AgentMail from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+import type * as serializers from "../../../index.mjs";
+import { Count } from "../../../types/Count.mjs";
+import { Limit } from "../../../types/Limit.mjs";
+import { Message } from "./Message.mjs";
+export declare const BatchGetMessagesResponse: core.serialization.ObjectSchema<serializers.BatchGetMessagesResponse.Raw, AgentMail.BatchGetMessagesResponse>;
+export declare namespace BatchGetMessagesResponse {
+    interface Raw {
+        limit: Limit.Raw;
+        count: Count.Raw;
+        messages: Message.Raw[];
+    }
+}

package/dist/esm/serialization/resources/messages/types/BatchGetMessagesResponse.mjs

@@ -0,0 +1,10 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../../../core/index.mjs";
+import { Count } from "../../../types/Count.mjs";
+import { Limit } from "../../../types/Limit.mjs";
+import { Message } from "./Message.mjs";
+export const BatchGetMessagesResponse = core.serialization.object({
+    limit: Limit,
+    count: Count,
+    messages: core.serialization.list(Message),
+});

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

@@ -1,4 +1,7 @@
 export * from "./Addresses.mjs";
+export * from "./BatchGetMessagesMessageIds.mjs";
+export * from "./BatchGetMessagesRequest.mjs";
+export * from "./BatchGetMessagesResponse.mjs";
 export * from "./ListMessagesResponse.mjs";
 export * from "./Message.mjs";
 export * from "./MessageAttachments.mjs";

package/dist/esm/serialization/resources/messages/types/index.mjs

@@ -1,4 +1,7 @@
 export * from "./Addresses.mjs";
+export * from "./BatchGetMessagesMessageIds.mjs";
+export * from "./BatchGetMessagesRequest.mjs";
+export * from "./BatchGetMessagesResponse.mjs";
 export * from "./ListMessagesResponse.mjs";
 export * from "./Message.mjs";
 export * from "./MessageAttachments.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.5.1";
+export declare const SDK_VERSION = "0.5.2";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.5.1";
+export const SDK_VERSION = "0.5.2";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agentmail",
-    "version": "0.5.1",
+    "version": "0.5.2",
     "private": false,
     "repository": {
         "type": "git",

package/reference.md

@@ -3330,6 +3330,86 @@ await client.inboxes.messages.get("inbox_id", "message_id");
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.inboxes.messages.<a href="/src/api/resources/inboxes/resources/messages/client/Client.ts">batchGet</a>(inbox_id, { ...params }) -> AgentMail.BatchGetMessagesResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Fetch metadata for up to 500 messages in one request. Missing or
+restricted IDs are silently omitted; compare `count` against `limit`
+to detect misses.
+
+**CLI:**
+```bash
+agentmail inboxes:messages batch-get --inbox-id <inbox_id> --message-id <id1> --message-id <id2>
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.inboxes.messages.batchGet("inbox_id", {
+    messageIds: ["message_ids", "message_ids"]
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**inbox_id:** `AgentMail.InboxId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.BatchGetMessagesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `MessagesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>