agentmail 0.5.1 → 0.5.3

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/lists/types/ListEntryBase.d.mts

@@ -10,4 +10,6 @@ export interface ListEntryBase {
     entryType: AgentMail.EntryType;
     /** Time at which entry was created. */
     createdAt: Date;
+    /** Whether the entry is read-only and cannot be deleted via the API. */
+    readOnly?: boolean;
 }

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/api/resources/webhooks/client/Client.d.mts

@@ -60,6 +60,9 @@ export declare class WebhooksClient {
     create(request: AgentMail.webhooks.CreateWebhookRequest, requestOptions?: WebhooksClient.RequestOptions): core.HttpResponsePromise<AgentMail.webhooks.Webhook>;
     private __create;
     /**
+     * Update inbox or pod subscriptions, or replace the webhook's `event_types` in full when you pass a
+     * non-empty `event_types` array (see request field docs). Inbox and pod changes use add/remove lists.
+     *
      * **CLI:**
      * ```bash
      * agentmail webhooks update --webhook-id <webhook_id> --add-inbox-id <inbox_id>

package/dist/esm/api/resources/webhooks/client/Client.mjs

@@ -224,6 +224,9 @@ export class WebhooksClient {
         });
     }
     /**
+     * Update inbox or pod subscriptions, or replace the webhook's `event_types` in full when you pass a
+     * non-empty `event_types` array (see request field docs). Inbox and pod changes use add/remove lists.
+     *
      * **CLI:**
      * ```bash
      * agentmail webhooks update --webhook-id <webhook_id> --add-inbox-id <inbox_id>

package/dist/esm/api/resources/webhooks/types/CreateWebhookRequest.d.mts

@@ -1,6 +1,11 @@
 import type * as AgentMail from "../../../index.mjs";
 export interface CreateWebhookRequest {
     url: AgentMail.webhooks.Url;
+    /**
+     * Full list of event types this webhook should receive. At least one type is required. Send every type you
+     * want in this array (not incremental). See [Webhooks overview](https://docs.agentmail.to/webhooks-overview)
+     * for spam, blocked, and unauthenticated events and required permissions.
+     */
     eventTypes: AgentMail.EventTypes;
     podIds?: AgentMail.PodIds;
     inboxIds?: AgentMail.InboxIds;

package/dist/esm/api/resources/webhooks/types/UpdateWebhookRequest.d.mts

@@ -8,4 +8,13 @@ export interface UpdateWebhookRequest {
     addPodIds?: AgentMail.PodIds;
     /** Pod IDs to unsubscribe from the webhook. */
     removePodIds?: AgentMail.PodIds;
+    /**
+     * When you send a non-empty list, it replaces the webhook's subscribed event types in full (the same
+     * "set the list" behavior as create). It is not a merge or diff: include every event type you want after
+     * the update. Sending a one-element array means the webhook will only receive that one type afterward.
+     * Omit this field or send an empty array to leave event types unchanged. Clearing all types with an empty
+     * list is not supported. Subscribing to `message.received.spam`, `message.received.blocked`, or
+     * `message.received.unauthenticated` requires the matching label permission on the API key.
+     */
+    eventTypes?: AgentMail.EventTypes;
 }

package/dist/esm/serialization/resources/agent/types/AgentSignupRequest.d.mts

@@ -6,5 +6,7 @@ export declare namespace AgentSignupRequest {
     interface Raw {
         human_email: string;
         username: string;
+        source?: string | null;
+        referrer?: string | null;
     }
 }

package/dist/esm/serialization/resources/agent/types/AgentSignupRequest.mjs

@@ -3,4 +3,6 @@ import * as core from "../../../../core/index.mjs";
 export const AgentSignupRequest = core.serialization.object({
     humanEmail: core.serialization.property("human_email", core.serialization.string()),
     username: core.serialization.string(),
+    source: core.serialization.string().optional(),
+    referrer: core.serialization.string().optional(),
 });

package/dist/esm/serialization/resources/lists/types/ListEntryBase.d.mts

@@ -15,5 +15,6 @@ export declare namespace ListEntryBase {
         list_type: ListType.Raw;
         entry_type: EntryType.Raw;
         created_at: string;
+        read_only?: boolean | null;
     }
 }

package/dist/esm/serialization/resources/lists/types/ListEntryBase.mjs

@@ -12,4 +12,5 @@ export const ListEntryBase = core.serialization.object({
     listType: core.serialization.property("list_type", ListType),
     entryType: core.serialization.property("entry_type", EntryType),
     createdAt: core.serialization.property("created_at", core.serialization.date()),
+    readOnly: core.serialization.property("read_only", core.serialization.boolean().optional()),
 });

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/serialization/resources/webhooks/types/UpdateWebhookRequest.d.mts

@@ -1,6 +1,7 @@
 import type * as AgentMail from "../../../../api/index.mjs";
 import * as core from "../../../../core/index.mjs";
 import type * as serializers from "../../../index.mjs";
+import { EventTypes } from "../../events/types/EventTypes.mjs";
 import { InboxIds } from "../../events/types/InboxIds.mjs";
 import { PodIds } from "../../events/types/PodIds.mjs";
 export declare const UpdateWebhookRequest: core.serialization.ObjectSchema<serializers.webhooks.UpdateWebhookRequest.Raw, AgentMail.webhooks.UpdateWebhookRequest>;
@@ -10,5 +11,6 @@ export declare namespace UpdateWebhookRequest {
         remove_inbox_ids?: InboxIds.Raw | null;
         add_pod_ids?: PodIds.Raw | null;
         remove_pod_ids?: PodIds.Raw | null;
+        event_types?: EventTypes.Raw | null;
     }
 }

package/dist/esm/serialization/resources/webhooks/types/UpdateWebhookRequest.mjs

@@ -1,5 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as core from "../../../../core/index.mjs";
+import { EventTypes } from "../../events/types/EventTypes.mjs";
 import { InboxIds } from "../../events/types/InboxIds.mjs";
 import { PodIds } from "../../events/types/PodIds.mjs";
 export const UpdateWebhookRequest = core.serialization.object({
@@ -7,4 +8,5 @@ export const UpdateWebhookRequest = core.serialization.object({
     removeInboxIds: core.serialization.property("remove_inbox_ids", InboxIds.optional()),
     addPodIds: core.serialization.property("add_pod_ids", PodIds.optional()),
     removePodIds: core.serialization.property("remove_pod_ids", PodIds.optional()),
+    eventTypes: core.serialization.property("event_types", EventTypes.optional()),
 });

package/dist/esm/version.d.mts

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

package/dist/esm/version.mjs

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