agentmail 0.5.34 → 0.5.36

package/dist/cjs/wrapper/WebsocketsClient.js

@@ -57,31 +57,49 @@ exports.WebsocketsClient = void 0;
 const Client_js_1 = require("../api/resources/websockets/client/Client.js");
 const core = __importStar(require("../core/index.js"));
 const environments = __importStar(require("../environments.js"));
+const version_js_1 = require("../version.js");
+const reconnect_js_1 = require("./reconnect.js");
+// The generated client's default. Always passed explicitly: auto-reconnect has to know the generated
+// socket's exact retry budget to take over before it runs out.
+const DEFAULT_RECONNECT_ATTEMPTS = 30;
+// Lets the server tell SDK releases apart on the handshake (Node only; browsers cannot set handshake
+// headers). Caller-supplied headers win.
+const SDK_HEADERS = { "X-Fern-SDK-Name": "agentmail", "X-Fern-SDK-Version": version_js_1.SDK_VERSION };
 class WebsocketsClient extends Client_js_1.WebsocketsClient {
-    constructor(options, getPaymentCredentials) {
+    constructor(options, getPaymentCredentials, reconnectPolicy = reconnect_js_1.DEFAULT_RECONNECT_POLICY) {
         super(options);
         this._getPaymentCredentials = getPaymentCredentials;
+        this._reconnectPolicy = reconnectPolicy;
     }
     connect() {
         const _super = Object.create(null, {
             connect: { get: () => super.connect }
         });
         return __awaiter(this, arguments, void 0, function* (args = {}) {
-            var _a, _b, _c;
-            const { waitForOpen = true } = args, rest = __rest(args, ["waitForOpen"]);
-            let connectArgs = rest;
+            var _a, _b, _c, _d;
+            const { waitForOpen = true, autoReconnect = true } = args, rest = __rest(args, ["waitForOpen", "autoReconnect"]);
+            const reconnectAttempts = (_a = rest.reconnectAttempts) !== null && _a !== void 0 ? _a : DEFAULT_RECONNECT_ATTEMPTS;
+            let connectArgs = Object.assign(Object.assign({}, rest), { reconnectAttempts, headers: Object.assign(Object.assign({}, SDK_HEADERS), rest.headers) });
             if (this._getPaymentCredentials) {
-                const wsUrl = core.url.join((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.AgentMailEnvironment.Prod).websockets, "/v0");
+                const wsUrl = 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)
+                    .websockets, "/v0");
                 const credentials = yield this._getPaymentCredentials(wsUrl);
-                connectArgs = Object.assign(Object.assign({}, rest), { queryParams: Object.assign(Object.assign({}, credentials), rest.queryParams) });
+                connectArgs = Object.assign(Object.assign({}, connectArgs), { queryParams: Object.assign(Object.assign({}, credentials), rest.queryParams) });
             }
             else if (!rest.apiKey) {
-                const apiKey = (_c = (yield core.Supplier.get(this._options.apiKey))) !== null && _c !== void 0 ? _c : process.env.AGENTMAIL_API_KEY;
-                connectArgs = Object.assign(Object.assign({}, rest), { apiKey });
+                const apiKey = (_d = (yield core.Supplier.get(this._options.apiKey))) !== null && _d !== void 0 ? _d : process.env.AGENTMAIL_API_KEY;
+                connectArgs = Object.assign(Object.assign({}, connectArgs), { apiKey });
             }
             const socket = yield _super.connect.call(this, connectArgs);
             if (waitForOpen)
                 yield socket.waitForOpen();
+            if (autoReconnect && reconnectAttempts > 0) {
+                (0, reconnect_js_1.enableAutoReconnect)(socket, {
+                    maxRetries: reconnectAttempts,
+                    abortSignal: rest.abortSignal,
+                    policy: this._reconnectPolicy,
+                });
+            }
             return socket;
         });
     }

package/dist/cjs/wrapper/reconnect.d.ts

@@ -0,0 +1,22 @@
+import type { WebsocketsSocket } from "../api/resources/websockets/client/Socket.js";
+export interface ReconnectPolicy {
+    baseDelayMs: number;
+    maxDelayMs: number;
+    /** How long a connection must stay open before the backoff starts over. */
+    stableAfterMs: number;
+}
+export declare const DEFAULT_RECONNECT_POLICY: ReconnectPolicy;
+/** Exponential backoff with full jitter: uniform in [0, min(maxDelayMs, baseDelayMs * 2^attempt)). */
+export declare function backoffDelay(attempt: number, policy: ReconnectPolicy, random?: () => number): number;
+export interface AutoReconnectOptions {
+    /** The generated socket's own retry budget (`reconnectAttempts`). */
+    maxRetries: number;
+    abortSignal?: AbortSignal;
+    policy: ReconnectPolicy;
+}
+/**
+ * Keeps `socket` connected and subscribed: re-sends every subscription on each reconnect, takes over
+ * reconnecting whenever the generated socket gives up, and stops on close(), abort, or a terminal
+ * handshake refusal.
+ */
+export declare function enableAutoReconnect(socket: WebsocketsSocket, options: AutoReconnectOptions): void;

package/dist/cjs/wrapper/reconnect.js

@@ -0,0 +1,246 @@
+"use strict";
+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;
+    };
+})();
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RECONNECT_POLICY = void 0;
+exports.backoffDelay = backoffDelay;
+exports.enableAutoReconnect = enableAutoReconnect;
+const index_js_1 = require("../core/index.js");
+const Events = __importStar(require("../core/websocket/events.js"));
+exports.DEFAULT_RECONNECT_POLICY = { baseDelayMs: 1000, maxDelayMs: 60000, stableAfterMs: 5000 };
+/** Exponential backoff with full jitter: uniform in [0, min(maxDelayMs, baseDelayMs * 2^attempt)). */
+function backoffDelay(attempt, policy, random = Math.random) {
+    return random() * Math.min(policy.maxDelayMs, policy.baseDelayMs * Math.pow(2, attempt));
+}
+const { OPEN, CLOSING, CLOSED } = index_js_1.ReconnectingWebSocket.ReadyState;
+// ws reports a refused handshake as "Unexpected server response: <status>". Browsers expose no status,
+// so there every refusal looks transient and is retried on the capped backoff.
+const HANDSHAKE_STATUS = /^Unexpected server response: (\d{3})\b/;
+// Refusals that retrying with the same credentials cannot fix. 402 comes from the x402/MPP proxies,
+// whose payment credential is minted once per connect() call and reused on reconnects. The server
+// also answers 403 when the organization is at its connection cap, which a retry could outlast.
+const TERMINAL_FAILURES = new Map([
+    ["401", "WebSocket authentication failed (401): the API key is missing, invalid, or was deleted."],
+    [
+        "402",
+        "WebSocket payment required (402): the payment credential minted by connect() is no longer accepted; open a new socket with client.websockets.connect() to pay again.",
+    ],
+    [
+        "403",
+        "WebSocket authentication failed (403): the API key is invalid or was deleted, or the organization is at its WebSocket connection limit.",
+    ],
+]);
+/**
+ * Keeps `socket` connected and subscribed: re-sends every subscription on each reconnect, takes over
+ * reconnecting whenever the generated socket gives up, and stops on close(), abort, or a terminal
+ * handshake refusal.
+ */
+function enableAutoReconnect(socket, options) {
+    const { maxRetries, abortSignal, policy } = options;
+    const rws = socket.socket;
+    const sendSubscribe = socket.sendSubscribe.bind(socket);
+    const closeSocket = rws.close.bind(rws);
+    const reconnectSocket = rws.reconnect.bind(rws);
+    // Keyed by canonical JSON, in the order last sent. The server keeps one subscription per target and
+    // the last filter sent for it, so a new message takes its targets out of every earlier one: a
+    // replay can never put back a filter the caller has since changed.
+    const subscriptions = new Map();
+    // Keys already sent on the current connection, e.g. by the user's own open handler.
+    const sentOnConnection = new Set();
+    let opened = rws.readyState === OPEN;
+    let openedAt = opened ? Date.now() : undefined;
+    let stopped = false;
+    let attempt = 0;
+    let timer;
+    let emitting = false;
+    const isStopped = () => stopped || (abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted) === true;
+    const cancelTimer = () => {
+        clearTimeout(timer);
+        timer = undefined;
+    };
+    const stop = () => {
+        stopped = true;
+        cancelTimer();
+    };
+    const emitError = (message) => {
+        var _a;
+        const event = new Events.ErrorEvent(new Error(message), rws);
+        emitting = true;
+        try {
+            (_a = rws.onerror) === null || _a === void 0 ? void 0 : _a.call(rws, event);
+            rws.dispatchEvent(event);
+        }
+        finally {
+            emitting = false;
+        }
+    };
+    const scheduleReconnect = () => {
+        cancelTimer();
+        timer = setTimeout(() => {
+            timer = undefined;
+            if (isStopped())
+                return;
+            // reconnect() on a socket that is not CLOSED closes it with 1000 and then never connects.
+            if (rws.readyState === CLOSED)
+                reconnectSocket();
+            else if (rws.readyState === CLOSING)
+                scheduleReconnect();
+        }, backoffDelay(attempt++, policy));
+    };
+    rws.addEventListener("open", () => {
+        cancelTimer();
+        openedAt = Date.now();
+        if (!opened) {
+            opened = true;
+            return;
+        }
+        for (const [key, message] of subscriptions) {
+            if (isStopped() || rws.readyState !== OPEN)
+                return;
+            if (sentOnConnection.has(key))
+                continue;
+            try {
+                sendSubscribe(message);
+                sentOnConnection.add(key);
+            }
+            catch (error) {
+                emitError(`Failed to re-subscribe after reconnecting: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    });
+    rws.addEventListener("close", (event) => {
+        sentOnConnection.clear();
+        if (openedAt !== undefined && Date.now() - openedAt >= policy.stableAfterMs)
+            attempt = 0;
+        openedAt = undefined;
+        if (isStopped())
+            return;
+        if (event.code !== 1000) {
+            // The generated socket retries these closes itself, up to maxRetries times.
+            if (rws.retryCount < maxRetries)
+                return;
+            // It has just scheduled its last retry. If that one fails too, it keeps its connect lock
+            // and ignores reconnect() for good, so cancel it and take over.
+            closeSocket();
+        }
+        scheduleReconnect();
+    });
+    rws.addEventListener("error", (event) => {
+        var _a;
+        if (emitting || isStopped())
+            return;
+        const status = (_a = HANDSHAKE_STATUS.exec(event.message)) === null || _a === void 0 ? void 0 : _a[1];
+        const failure = status === undefined ? undefined : TERMINAL_FAILURES.get(status);
+        if (failure === undefined)
+            return;
+        stop();
+        emitError(`${failure} Not reconnecting.`);
+    });
+    abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.addEventListener("abort", stop, { once: true });
+    // Patched on the generated socket so WebsocketsSocket.close()/connect() and direct
+    // socket.socket.close()/reconnect() calls all count as the user's intent.
+    rws.close = (code, reason) => {
+        stop();
+        subscriptions.clear();
+        closeSocket(code, reason);
+    };
+    rws.reconnect = (code, reason) => {
+        stopped = false;
+        attempt = 0;
+        cancelTimer();
+        reconnectSocket(code, reason);
+    };
+    socket.sendSubscribe = (message) => {
+        sendSubscribe(message);
+        const recorded = JSON.parse(JSON.stringify(message));
+        const covered = new Set(targetsOf(recorded));
+        const kept = [...subscriptions].flatMap(([key, cached]) => {
+            const remaining = withoutTargets(cached, covered);
+            if (remaining === undefined)
+                return [];
+            return [[remaining === cached ? key : subscriptionKey(remaining), remaining]];
+        });
+        const key = subscriptionKey(recorded);
+        subscriptions.clear();
+        for (const [keptKey, keptMessage] of kept)
+            if (keptKey !== key)
+                subscriptions.set(keptKey, keptMessage);
+        subscriptions.set(key, recorded);
+        sentOnConnection.add(key);
+    };
+}
+// What a subscribe message sets on the server: one subscription per inbox and per pod it names, or the
+// credential's own scope when it names neither. That default resolves server-side to an inbox, pod or
+// organization the SDK cannot see, so it is tracked as its own target.
+function targetsOf(message) {
+    var _a, _b;
+    if (message.inboxIds === undefined && message.podIds === undefined)
+        return ["default"];
+    return [...((_a = message.inboxIds) !== null && _a !== void 0 ? _a : []).map((id) => `inbox:${id}`), ...((_b = message.podIds) !== null && _b !== void 0 ? _b : []).map((id) => `pod:${id}`)];
+}
+// `message` without the covered targets; undefined once none of its targets is left.
+function withoutTargets(message, covered) {
+    const targets = targetsOf(message);
+    if (!targets.some((target) => covered.has(target)))
+        return message;
+    if (targets.every((target) => covered.has(target)))
+        return undefined;
+    const { inboxIds, podIds } = message, rest = __rest(message, ["inboxIds", "podIds"]);
+    const keptInboxIds = inboxIds === null || inboxIds === void 0 ? void 0 : inboxIds.filter((id) => !covered.has(`inbox:${id}`));
+    const keptPodIds = podIds === null || podIds === void 0 ? void 0 : podIds.filter((id) => !covered.has(`pod:${id}`));
+    return Object.assign(Object.assign(Object.assign({}, rest), ((keptInboxIds === null || keptInboxIds === void 0 ? void 0 : keptInboxIds.length) ? { inboxIds: keptInboxIds } : {})), ((keptPodIds === null || keptPodIds === void 0 ? void 0 : keptPodIds.length) ? { podIds: keptPodIds } : {}));
+}
+// Canonical JSON (sorted object keys), so the same subscription written in a different key order dedupes.
+function subscriptionKey(message) {
+    return JSON.stringify(message, (_key, value) => {
+        if (value === null || typeof value !== "object" || Array.isArray(value))
+            return value;
+        const sorted = {};
+        for (const key of Object.keys(value).sort()) {
+            sorted[key] = value[key];
+        }
+        return sorted;
+    });
+}

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.34",
-        "User-Agent": "agentmail/0.5.34",
+        "X-Fern-SDK-Version": "0.5.36",
+        "User-Agent": "agentmail/0.5.36",
         "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/apps/client/Client.mjs

@@ -37,10 +37,16 @@ export class AppsClient {
     __list() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { limit, pageToken } = request;
+            const { limit, pageToken, category } = request;
             const _queryParams = {
                 limit,
                 page_token: pageToken,
+                category: category != null
+                    ? serializers.AppCategory.jsonOrThrow(category, {
+                        unrecognizedObjectKeys: "strip",
+                        omitUndefined: true,
+                    })
+                    : undefined,
             };
             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);

package/dist/esm/api/resources/apps/client/requests/ListAppsRequest.d.mts

@@ -6,4 +6,6 @@ import type * as AgentMail from "../../../../index.mjs";
 export interface ListAppsRequest {
     limit?: AgentMail.Limit;
     pageToken?: AgentMail.PageToken;
+    /** Only apps in this category. A filtered page can hold fewer than `limit` apps while more remain, so page until `next_page_token` is absent. A `page_token` works only with the `category` it was returned for. */
+    category?: AgentMail.AppCategory;
 }

package/dist/esm/api/resources/apps/types/App.d.mts

@@ -11,6 +11,8 @@ export interface App {
     logoUrl?: string;
     termsUrl?: string;
     privacyUrl?: string;
+    /** Kinds of app, up to 3. Omitted when the app sets none. */
+    categories?: AgentMail.AppCategory[];
     /** Maximum number of accounts your organization may sign up at this app. Omitted when the app sets no limit. 0 means the app has paused new sign-ups; existing accounts keep signing in. */
     ownerSignupLimit?: number;
 }

package/dist/esm/api/resources/apps/types/AppCategory.d.mts

@@ -0,0 +1,20 @@
+/** Kind of app. */
+export declare const AppCategory: {
+    readonly Ai: "ai";
+    readonly Search: "search";
+    readonly Scraping: "scraping";
+    readonly Browser: "browser";
+    readonly Data: "data";
+    readonly DeveloperTools: "developer-tools";
+    readonly Communication: "communication";
+    readonly Productivity: "productivity";
+    readonly Payments: "payments";
+    readonly Finance: "finance";
+    readonly Commerce: "commerce";
+    readonly Marketing: "marketing";
+    readonly Analytics: "analytics";
+    readonly Security: "security";
+    readonly Infrastructure: "infrastructure";
+    readonly Other: "other";
+};
+export type AppCategory = (typeof AppCategory)[keyof typeof AppCategory];

package/dist/esm/api/resources/apps/types/AppCategory.mjs

@@ -0,0 +1,20 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Kind of app. */
+export const AppCategory = {
+    Ai: "ai",
+    Search: "search",
+    Scraping: "scraping",
+    Browser: "browser",
+    Data: "data",
+    DeveloperTools: "developer-tools",
+    Communication: "communication",
+    Productivity: "productivity",
+    Payments: "payments",
+    Finance: "finance",
+    Commerce: "commerce",
+    Marketing: "marketing",
+    Analytics: "analytics",
+    Security: "security",
+    Infrastructure: "infrastructure",
+    Other: "other",
+};

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

@@ -1,4 +1,5 @@
 export * from "./App.mjs";
+export * from "./AppCategory.mjs";
 export * from "./AppId.mjs";
 export * from "./ConnectAccepted.mjs";
 export * from "./ConnectAppBody.mjs";

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

@@ -1,4 +1,5 @@
 export * from "./App.mjs";
+export * from "./AppCategory.mjs";
 export * from "./AppId.mjs";
 export * from "./ConnectAccepted.mjs";
 export * from "./ConnectAppBody.mjs";

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

@@ -110,12 +110,16 @@ export declare class InboxesClient {
      * agentmail inboxes update --inbox-id <inbox_id> --display-name "Updated Name"
      * ```
      *
+     * To pause an inbox, set `status` to `paused`; set it back to `active` to
+     * resume. See [Pausing an inbox](/inboxes#pausing-an-inbox).
+     *
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {AgentMail.inboxes.UpdateInboxRequest} request
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.NotFoundError}
      * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.ConflictError}
      *
      * @example
      *     await client.inboxes.update("inbox_id", {})

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

@@ -357,12 +357,16 @@ export class InboxesClient {
      * agentmail inboxes update --inbox-id <inbox_id> --display-name "Updated Name"
      * ```
      *
+     * To pause an inbox, set `status` to `paused`; set it back to `active` to
+     * resume. See [Pausing an inbox](/inboxes#pausing-an-inbox).
+     *
      * @param {AgentMail.inboxes.InboxId} inbox_id
      * @param {AgentMail.inboxes.UpdateInboxRequest} request
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.NotFoundError}
      * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.ConflictError}
      *
      * @example
      *     await client.inboxes.update("inbox_id", {})
@@ -423,6 +427,14 @@ export class InboxesClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
+                    case 409:
+                        throw new AgentMail.ConflictError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
                     default:
                         throw new errors.AgentMailError({
                             statusCode: _response.error.statusCode,

package/dist/esm/api/resources/inboxes/types/CreateInboxRequest.d.mts

@@ -10,6 +10,8 @@ export interface CreateInboxRequest {
     domain?: string;
     displayName?: AgentMail.inboxes.DisplayName;
     clientId?: AgentMail.inboxes.ClientId;
+    /** Set `paused` to create the inbox paused. */
+    status?: AgentMail.inboxes.InboxStatus;
     /** Custom metadata to attach to the inbox. */
     metadata?: AgentMail.inboxes.Metadata;
 }

package/dist/esm/api/resources/inboxes/types/Inbox.d.mts

@@ -5,6 +5,12 @@ export interface Inbox {
     email: AgentMail.inboxes.Email;
     displayName?: AgentMail.inboxes.DisplayName;
     clientId?: AgentMail.inboxes.ClientId;
+    /**
+     * `paused` when the inbox is paused. Omitted when the inbox is active.
+     * Treat any value other than `paused` as an inbox that sends and
+     * receives normally.
+     */
+    status?: AgentMail.inboxes.InboxStatus;
     /** Custom metadata attached to the inbox. */
     metadata?: AgentMail.inboxes.Metadata;
     /** Time at which inbox was last updated. */

package/dist/esm/api/resources/inboxes/types/InboxStatus.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Whether the inbox sends and receives mail. `paused` stops both: sends
+ * return `403` with code `inbox_paused`, and incoming mail is not
+ * delivered and not bounced, then or on resume. Mail already in the inbox,
+ * its drafts, and its API keys are kept. Set `active` to resume.
+ */
+export declare const InboxStatus: {
+    readonly Active: "active";
+    readonly Paused: "paused";
+};
+export type InboxStatus = (typeof InboxStatus)[keyof typeof InboxStatus];

package/dist/esm/api/resources/inboxes/types/InboxStatus.mjs

@@ -0,0 +1,11 @@
+// This file was auto-generated by Fern from our API Definition.
+/**
+ * Whether the inbox sends and receives mail. `paused` stops both: sends
+ * return `403` with code `inbox_paused`, and incoming mail is not
+ * delivered and not bounced, then or on resume. Mail already in the inbox,
+ * its drafts, and its API keys are kept. Set `active` to resume.
+ */
+export const InboxStatus = {
+    Active: "active",
+    Paused: "paused",
+};

package/dist/esm/api/resources/inboxes/types/UpdateInboxRequest.d.mts

@@ -1,13 +1,19 @@
 import type * as AgentMail from "../../../index.mjs";
 export interface UpdateInboxRequest {
     displayName?: AgentMail.inboxes.DisplayName;
+    /**
+     * `paused` stops the inbox sending and receiving mail; `active` resumes
+     * it. Mail that arrived while the inbox was paused is not delivered on
+     * resume.
+     */
+    status?: AgentMail.inboxes.InboxStatus;
     /**
      * 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. Sending an empty object is rejected; use null to
-     * clear. Each update must include at least one of `display_name` or
-     * `metadata`.
+     * clear. Each update must include at least one of `display_name`,
+     * `status`, or `metadata`.
      */
     metadata?: AgentMail.inboxes.UpdateMetadata | null;
 }

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

@@ -6,6 +6,7 @@ export * from "./DisplayName.mjs";
 export * from "./Email.mjs";
 export * from "./Inbox.mjs";
 export * from "./InboxId.mjs";
+export * from "./InboxStatus.mjs";
 export * from "./ListInboxesResponse.mjs";
 export * from "./Metadata.mjs";
 export * from "./MetadataValue.mjs";

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

@@ -6,6 +6,7 @@ export * from "./DisplayName.mjs";
 export * from "./Email.mjs";
 export * from "./Inbox.mjs";
 export * from "./InboxId.mjs";
+export * from "./InboxStatus.mjs";
 export * from "./ListInboxesResponse.mjs";
 export * from "./Metadata.mjs";
 export * from "./MetadataValue.mjs";

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

@@ -96,6 +96,7 @@ export declare class InboxesClient {
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ConflictError}
      *
      * @example
      *     await client.pods.inboxes.update("pod_id", "inbox_id", {})

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

@@ -344,6 +344,7 @@ export class InboxesClient {
      * @param {InboxesClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ConflictError}
      *
      * @example
      *     await client.pods.inboxes.update("pod_id", "inbox_id", {})
@@ -396,6 +397,14 @@ export class InboxesClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
+                    case 409:
+                        throw new AgentMail.ConflictError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
                     default:
                         throw new errors.AgentMailError({
                             statusCode: _response.error.statusCode,

package/dist/esm/serialization/resources/apps/types/App.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 { AppCategory } from "./AppCategory.mjs";
 import { AppId } from "./AppId.mjs";
 export declare const App: core.serialization.ObjectSchema<serializers.App.Raw, AgentMail.App>;
 export declare namespace App {
@@ -12,6 +13,7 @@ export declare namespace App {
         logo_url?: string | null;
         terms_url?: string | null;
         privacy_url?: string | null;
+        categories?: AppCategory.Raw[] | null;
         owner_signup_limit?: number | null;
     }
 }

package/dist/esm/serialization/resources/apps/types/App.mjs

@@ -1,5 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as core from "../../../../core/index.mjs";
+import { AppCategory } from "./AppCategory.mjs";
 import { AppId } from "./AppId.mjs";
 export const App = core.serialization.object({
     appId: core.serialization.property("app_id", AppId),
@@ -9,5 +10,6 @@ export const App = core.serialization.object({
     logoUrl: core.serialization.property("logo_url", core.serialization.string().optional()),
     termsUrl: core.serialization.property("terms_url", core.serialization.string().optional()),
     privacyUrl: core.serialization.property("privacy_url", core.serialization.string().optional()),
+    categories: core.serialization.list(AppCategory).optional(),
     ownerSignupLimit: core.serialization.property("owner_signup_limit", core.serialization.number().optional()),
 });

package/dist/esm/serialization/resources/apps/types/AppCategory.d.mts

@@ -0,0 +1,7 @@
+import type * as AgentMail from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+import type * as serializers from "../../../index.mjs";
+export declare const AppCategory: core.serialization.Schema<serializers.AppCategory.Raw, AgentMail.AppCategory>;
+export declare namespace AppCategory {
+    type Raw = "ai" | "search" | "scraping" | "browser" | "data" | "developer-tools" | "communication" | "productivity" | "payments" | "finance" | "commerce" | "marketing" | "analytics" | "security" | "infrastructure" | "other";
+}