agentmail 0.5.2 → 0.5.4

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.2",
-        "User-Agent": "agentmail/0.5.2",
+        "X-Fern-SDK-Version": "0.5.4",
+        "User-Agent": "agentmail/0.5.4",
         "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/agent/client/Client.d.ts

@@ -42,7 +42,7 @@ export declare class AgentClient {
      *
      * On success, the organization is upgraded from `agent_unverified` to `agent_verified`, the send allowlist is removed, and free plan entitlements are applied.
      *
-     * The OTP expires after 24 hours and allows a maximum of 10 attempts.
+     * The OTP expires after 24 hours and allows a maximum of 10 attempts. If you run into any difficulties receiving the OTP code, you can also create an account on [console.agentmail.to](https://console.agentmail.to) using the human email address you provided to verify your account.
      *
      * **CLI:**
      * ```bash

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

@@ -144,7 +144,7 @@ class AgentClient {
      *
      * On success, the organization is upgraded from `agent_unverified` to `agent_verified`, the send allowlist is removed, and free plan entitlements are applied.
      *
-     * The OTP expires after 24 hours and allows a maximum of 10 attempts.
+     * The OTP expires after 24 hours and allows a maximum of 10 attempts. If you run into any difficulties receiving the OTP code, you can also create an account on [console.agentmail.to](https://console.agentmail.to) using the human email address you provided to verify your account.
      *
      * **CLI:**
      * ```bash

package/dist/cjs/api/resources/agent/types/AgentSignupRequest.d.ts

@@ -6,4 +6,16 @@ export interface AgentSignupRequest {
     humanEmail: string;
     /** Username for the auto-created inbox (e.g. "my-agent" creates my-agent@agentmail.to). */
     username: string;
+    /**
+     * The SDK, framework, or platform issuing this sign-up (e.g. `agentmail-python`, `agentmail-cli`, `agentmail-mcp`).
+     * Identifies the caller — answers "who is signing up".
+     * Max 2048 characters.
+     */
+    source?: string;
+    /**
+     * The channel that drove this sign-up — where the agent or its developer discovered AgentMail
+     * (e.g. `agent.email`, a partner URL, a campaign tag). Answers "where did this sign-up come from".
+     * Max 2048 characters.
+     */
+    referrer?: string;
 }

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

@@ -88,11 +88,10 @@ export declare class InboxesClient {
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ValidationError}
      *
      * @example
-     *     await client.inboxes.update("inbox_id", {
-     *         displayName: "display_name"
-     *     })
+     *     await client.inboxes.update("inbox_id", {})
      */
     update(inbox_id: AgentMail.inboxes.InboxId, request: AgentMail.inboxes.UpdateInboxRequest, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.Inbox>;
     private __update;

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

@@ -302,11 +302,10 @@ class InboxesClient {
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ValidationError}
      *
      * @example
-     *     await client.inboxes.update("inbox_id", {
-     *         displayName: "display_name"
-     *     })
+     *     await client.inboxes.update("inbox_id", {})
      */
     update(inbox_id, request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__update(inbox_id, request, requestOptions));
@@ -356,6 +355,14 @@ class InboxesClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
+                    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,

package/dist/cjs/api/resources/inboxes/types/CreateInboxRequest.d.ts

@@ -6,4 +6,6 @@ export interface CreateInboxRequest {
     domain?: string;
     displayName?: AgentMail.inboxes.DisplayName;
     clientId?: AgentMail.inboxes.ClientId;
+    /** Custom metadata to attach to the inbox. */
+    metadata?: AgentMail.inboxes.Metadata;
 }

package/dist/cjs/api/resources/inboxes/types/Inbox.d.ts

@@ -5,6 +5,8 @@ export interface Inbox {
     email: AgentMail.inboxes.Email;
     displayName?: AgentMail.inboxes.DisplayName;
     clientId?: AgentMail.inboxes.ClientId;
+    /** Custom metadata attached to the inbox. */
+    metadata?: AgentMail.inboxes.Metadata;
     /** Time at which inbox was last updated. */
     updatedAt: Date;
     /** Time at which inbox was created. */

package/dist/cjs/api/resources/inboxes/types/Metadata.d.ts

@@ -0,0 +1,6 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * Custom key-value pairs attached to the inbox. Up to 256 keys. Keys and
+ * string values are each limited to 256 characters.
+ */
+export type Metadata = Record<string, AgentMail.inboxes.MetadataValue>;

package/dist/cjs/api/resources/inboxes/types/Metadata.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/inboxes/types/MetadataValue.d.ts

@@ -0,0 +1,4 @@
+/**
+ * A metadata value. May be a string, number, or boolean.
+ */
+export type MetadataValue = string | number | boolean;

package/dist/cjs/api/resources/inboxes/types/MetadataValue.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/inboxes/types/UpdateInboxRequest.d.ts

@@ -1,4 +1,11 @@
 import type * as AgentMail from "../../../index.js";
 export interface UpdateInboxRequest {
-    displayName: AgentMail.inboxes.DisplayName;
+    displayName?: AgentMail.inboxes.DisplayName;
+    /**
+     * Metadata to merge into the inbox's existing metadata. Keys you include
+     * are added or overwritten; keys you omit are left unchanged. To remove a
+     * single key, send it with a null value. To clear all metadata, send
+     * `metadata` as null. Provide at least one of `display_name` or `metadata`.
+     */
+    metadata?: AgentMail.inboxes.Metadata;
 }

package/dist/cjs/api/resources/inboxes/types/index.d.ts

@@ -5,4 +5,6 @@ export * from "./Email.js";
 export * from "./Inbox.js";
 export * from "./InboxId.js";
 export * from "./ListInboxesResponse.js";
+export * from "./Metadata.js";
+export * from "./MetadataValue.js";
 export * from "./UpdateInboxRequest.js";

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

@@ -21,4 +21,6 @@ __exportStar(require("./Email.js"), exports);
 __exportStar(require("./Inbox.js"), exports);
 __exportStar(require("./InboxId.js"), exports);
 __exportStar(require("./ListInboxesResponse.js"), exports);
+__exportStar(require("./Metadata.js"), exports);
+__exportStar(require("./MetadataValue.js"), exports);
 __exportStar(require("./UpdateInboxRequest.js"), exports);

package/dist/cjs/api/resources/lists/types/ListEntryBase.d.ts

@@ -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/cjs/api/resources/pods/resources/inboxes/client/Client.d.ts

@@ -75,9 +75,7 @@ export declare class InboxesClient {
      * @throws {@link AgentMail.NotFoundError}
      *
      * @example
-     *     await client.pods.inboxes.update("pod_id", "inbox_id", {
-     *         displayName: "display_name"
-     *     })
+     *     await client.pods.inboxes.update("pod_id", "inbox_id", {})
      */
     update(pod_id: AgentMail.pods.PodId, inbox_id: AgentMail.inboxes.InboxId, request: AgentMail.inboxes.UpdateInboxRequest, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.Inbox>;
     private __update;

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

@@ -286,9 +286,7 @@ class InboxesClient {
      * @throws {@link AgentMail.NotFoundError}
      *
      * @example
-     *     await client.pods.inboxes.update("pod_id", "inbox_id", {
-     *         displayName: "display_name"
-     *     })
+     *     await client.pods.inboxes.update("pod_id", "inbox_id", {})
      */
     update(pod_id, inbox_id, request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__update(pod_id, inbox_id, request, requestOptions));

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

@@ -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/cjs/api/resources/webhooks/client/Client.js

@@ -260,6 +260,9 @@ 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/cjs/api/resources/webhooks/types/CreateWebhookRequest.d.ts

@@ -1,6 +1,11 @@
 import type * as AgentMail from "../../../index.js";
 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/cjs/api/resources/webhooks/types/UpdateWebhookRequest.d.ts

@@ -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/cjs/serialization/resources/agent/types/AgentSignupRequest.d.ts

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

package/dist/cjs/serialization/resources/agent/types/AgentSignupRequest.js

@@ -39,4 +39,6 @@ const core = __importStar(require("../../../../core/index.js"));
 exports.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/cjs/serialization/resources/inboxes/types/CreateInboxRequest.d.ts

@@ -3,6 +3,7 @@ import * as core from "../../../../core/index.js";
 import type * as serializers from "../../../index.js";
 import { ClientId } from "./ClientId.js";
 import { DisplayName } from "./DisplayName.js";
+import { Metadata } from "./Metadata.js";
 export declare const CreateInboxRequest: core.serialization.ObjectSchema<serializers.inboxes.CreateInboxRequest.Raw, AgentMail.inboxes.CreateInboxRequest>;
 export declare namespace CreateInboxRequest {
     interface Raw {
@@ -10,5 +11,6 @@ export declare namespace CreateInboxRequest {
         domain?: string | null;
         display_name?: DisplayName.Raw | null;
         client_id?: ClientId.Raw | null;
+        metadata?: Metadata.Raw | null;
     }
 }

package/dist/cjs/serialization/resources/inboxes/types/CreateInboxRequest.js

@@ -38,9 +38,11 @@ exports.CreateInboxRequest = void 0;
 const core = __importStar(require("../../../../core/index.js"));
 const ClientId_js_1 = require("./ClientId.js");
 const DisplayName_js_1 = require("./DisplayName.js");
+const Metadata_js_1 = require("./Metadata.js");
 exports.CreateInboxRequest = core.serialization.object({
     username: core.serialization.string().optional(),
     domain: core.serialization.string().optional(),
     displayName: core.serialization.property("display_name", DisplayName_js_1.DisplayName.optional()),
     clientId: core.serialization.property("client_id", ClientId_js_1.ClientId.optional()),
+    metadata: Metadata_js_1.Metadata.optional(),
 });

package/dist/cjs/serialization/resources/inboxes/types/Inbox.d.ts

@@ -6,6 +6,7 @@ import { ClientId } from "./ClientId.js";
 import { DisplayName } from "./DisplayName.js";
 import { Email } from "./Email.js";
 import { InboxId } from "./InboxId.js";
+import { Metadata } from "./Metadata.js";
 export declare const Inbox: core.serialization.ObjectSchema<serializers.inboxes.Inbox.Raw, AgentMail.inboxes.Inbox>;
 export declare namespace Inbox {
     interface Raw {
@@ -14,6 +15,7 @@ export declare namespace Inbox {
         email: Email.Raw;
         display_name?: DisplayName.Raw | null;
         client_id?: ClientId.Raw | null;
+        metadata?: Metadata.Raw | null;
         updated_at: string;
         created_at: string;
     }

package/dist/cjs/serialization/resources/inboxes/types/Inbox.js

@@ -41,12 +41,14 @@ const ClientId_js_1 = require("./ClientId.js");
 const DisplayName_js_1 = require("./DisplayName.js");
 const Email_js_1 = require("./Email.js");
 const InboxId_js_1 = require("./InboxId.js");
+const Metadata_js_1 = require("./Metadata.js");
 exports.Inbox = core.serialization.object({
     podId: core.serialization.property("pod_id", PodId_js_1.PodId),
     inboxId: core.serialization.property("inbox_id", InboxId_js_1.InboxId),
     email: Email_js_1.Email,
     displayName: core.serialization.property("display_name", DisplayName_js_1.DisplayName.optional()),
     clientId: core.serialization.property("client_id", ClientId_js_1.ClientId.optional()),
+    metadata: Metadata_js_1.Metadata.optional(),
     updatedAt: core.serialization.property("updated_at", core.serialization.date()),
     createdAt: core.serialization.property("created_at", core.serialization.date()),
 });

package/dist/cjs/serialization/resources/inboxes/types/Metadata.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 { MetadataValue } from "./MetadataValue.js";
+export declare const Metadata: core.serialization.Schema<serializers.inboxes.Metadata.Raw, AgentMail.inboxes.Metadata>;
+export declare namespace Metadata {
+    type Raw = Record<string, MetadataValue.Raw>;
+}

package/dist/cjs/serialization/resources/inboxes/types/Metadata.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.Metadata = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+const MetadataValue_js_1 = require("./MetadataValue.js");
+exports.Metadata = core.serialization.record(core.serialization.string(), MetadataValue_js_1.MetadataValue);

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

package/dist/cjs/serialization/resources/inboxes/types/MetadataValue.js

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

package/dist/cjs/serialization/resources/inboxes/types/UpdateInboxRequest.d.ts

@@ -2,9 +2,11 @@ import type * as AgentMail from "../../../../api/index.js";
 import * as core from "../../../../core/index.js";
 import type * as serializers from "../../../index.js";
 import { DisplayName } from "./DisplayName.js";
+import { Metadata } from "./Metadata.js";
 export declare const UpdateInboxRequest: core.serialization.ObjectSchema<serializers.inboxes.UpdateInboxRequest.Raw, AgentMail.inboxes.UpdateInboxRequest>;
 export declare namespace UpdateInboxRequest {
     interface Raw {
-        display_name: DisplayName.Raw;
+        display_name?: DisplayName.Raw | null;
+        metadata?: Metadata.Raw | null;
     }
 }

package/dist/cjs/serialization/resources/inboxes/types/UpdateInboxRequest.js

@@ -37,6 +37,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateInboxRequest = void 0;
 const core = __importStar(require("../../../../core/index.js"));
 const DisplayName_js_1 = require("./DisplayName.js");
+const Metadata_js_1 = require("./Metadata.js");
 exports.UpdateInboxRequest = core.serialization.object({
-    displayName: core.serialization.property("display_name", DisplayName_js_1.DisplayName),
+    displayName: core.serialization.property("display_name", DisplayName_js_1.DisplayName.optional()),
+    metadata: Metadata_js_1.Metadata.optional(),
 });

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

@@ -5,4 +5,6 @@ export * from "./Email.js";
 export * from "./Inbox.js";
 export * from "./InboxId.js";
 export * from "./ListInboxesResponse.js";
+export * from "./Metadata.js";
+export * from "./MetadataValue.js";
 export * from "./UpdateInboxRequest.js";

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

@@ -21,4 +21,6 @@ __exportStar(require("./Email.js"), exports);
 __exportStar(require("./Inbox.js"), exports);
 __exportStar(require("./InboxId.js"), exports);
 __exportStar(require("./ListInboxesResponse.js"), exports);
+__exportStar(require("./Metadata.js"), exports);
+__exportStar(require("./MetadataValue.js"), exports);
 __exportStar(require("./UpdateInboxRequest.js"), exports);

package/dist/cjs/serialization/resources/lists/types/ListEntryBase.d.ts

@@ -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/cjs/serialization/resources/lists/types/ListEntryBase.js

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

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

@@ -1,6 +1,7 @@
 import type * as AgentMail from "../../../../api/index.js";
 import * as core from "../../../../core/index.js";
 import type * as serializers from "../../../index.js";
+import { EventTypes } from "../../events/types/EventTypes.js";
 import { InboxIds } from "../../events/types/InboxIds.js";
 import { PodIds } from "../../events/types/PodIds.js";
 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/cjs/serialization/resources/webhooks/types/UpdateWebhookRequest.js

@@ -36,6 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateWebhookRequest = void 0;
 const core = __importStar(require("../../../../core/index.js"));
+const EventTypes_js_1 = require("../../events/types/EventTypes.js");
 const InboxIds_js_1 = require("../../events/types/InboxIds.js");
 const PodIds_js_1 = require("../../events/types/PodIds.js");
 exports.UpdateWebhookRequest = core.serialization.object({
@@ -43,4 +44,5 @@ exports.UpdateWebhookRequest = core.serialization.object({
     removeInboxIds: core.serialization.property("remove_inbox_ids", InboxIds_js_1.InboxIds.optional()),
     addPodIds: core.serialization.property("add_pod_ids", PodIds_js_1.PodIds.optional()),
     removePodIds: core.serialization.property("remove_pod_ids", PodIds_js_1.PodIds.optional()),
+    eventTypes: core.serialization.property("event_types", EventTypes_js_1.EventTypes.optional()),
 });

package/dist/cjs/version.d.ts

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

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.2";
+exports.SDK_VERSION = "0.5.4";

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.2",
-        "User-Agent": "agentmail/0.5.2",
+        "X-Fern-SDK-Version": "0.5.4",
+        "User-Agent": "agentmail/0.5.4",
         "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/agent/client/Client.d.mts

@@ -42,7 +42,7 @@ export declare class AgentClient {
      *
      * On success, the organization is upgraded from `agent_unverified` to `agent_verified`, the send allowlist is removed, and free plan entitlements are applied.
      *
-     * The OTP expires after 24 hours and allows a maximum of 10 attempts.
+     * The OTP expires after 24 hours and allows a maximum of 10 attempts. If you run into any difficulties receiving the OTP code, you can also create an account on [console.agentmail.to](https://console.agentmail.to) using the human email address you provided to verify your account.
      *
      * **CLI:**
      * ```bash

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

@@ -108,7 +108,7 @@ export class AgentClient {
      *
      * On success, the organization is upgraded from `agent_unverified` to `agent_verified`, the send allowlist is removed, and free plan entitlements are applied.
      *
-     * The OTP expires after 24 hours and allows a maximum of 10 attempts.
+     * The OTP expires after 24 hours and allows a maximum of 10 attempts. If you run into any difficulties receiving the OTP code, you can also create an account on [console.agentmail.to](https://console.agentmail.to) using the human email address you provided to verify your account.
      *
      * **CLI:**
      * ```bash

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

@@ -6,4 +6,16 @@ export interface AgentSignupRequest {
     humanEmail: string;
     /** Username for the auto-created inbox (e.g. "my-agent" creates my-agent@agentmail.to). */
     username: string;
+    /**
+     * The SDK, framework, or platform issuing this sign-up (e.g. `agentmail-python`, `agentmail-cli`, `agentmail-mcp`).
+     * Identifies the caller — answers "who is signing up".
+     * Max 2048 characters.
+     */
+    source?: string;
+    /**
+     * The channel that drove this sign-up — where the agent or its developer discovered AgentMail
+     * (e.g. `agent.email`, a partner URL, a campaign tag). Answers "where did this sign-up come from".
+     * Max 2048 characters.
+     */
+    referrer?: string;
 }

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

@@ -88,11 +88,10 @@ export declare class InboxesClient {
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ValidationError}
      *
      * @example
-     *     await client.inboxes.update("inbox_id", {
-     *         displayName: "display_name"
-     *     })
+     *     await client.inboxes.update("inbox_id", {})
      */
     update(inbox_id: AgentMail.inboxes.InboxId, request: AgentMail.inboxes.UpdateInboxRequest, requestOptions?: InboxesClient.RequestOptions): core.HttpResponsePromise<AgentMail.inboxes.Inbox>;
     private __update;