agentmail 0.5.2 → 0.5.3

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.3",
+        "User-Agent": "agentmail/0.5.3",
         "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/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/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/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/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.3";

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.3";

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.3",
+        "User-Agent": "agentmail/0.5.3",
         "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/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/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/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/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.2";
+export declare const SDK_VERSION = "0.5.3";

package/dist/esm/version.mjs

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