agentmail 0.4.14 → 0.4.16

package/README.md

@@ -10,10 +10,12 @@ The Agentmail TypeScript library provides convenient access to the Agentmail API
 - [Installation](#installation)
 - [Reference](#reference)
 - [Usage](#usage)
+- [Environments](#environments)
 - [Request and Response Types](#request-and-response-types)
 - [Exception Handling](#exception-handling)
 - [Binary Response](#binary-response)
 - [Advanced](#advanced)
+  - [Subpackage Exports](#subpackage-exports)
   - [Additional Headers](#additional-headers)
   - [Additional Query String Parameters](#additional-query-string-parameters)
   - [Retries](#retries)
@@ -21,6 +23,7 @@ The Agentmail TypeScript library provides convenient access to the Agentmail API
   - [Aborting Requests](#aborting-requests)
   - [Access Raw Response Data](#access-raw-response-data)
   - [Logging](#logging)
+  - [Custom Fetch](#custom-fetch)
   - [Runtime Compatibility](#runtime-compatibility)
 - [Contributing](#contributing)
 
@@ -45,6 +48,18 @@ const client = new AgentMailClient({ apiKey: "YOUR_API_KEY" });
 await client.inboxes.create(undefined);
 ```
 
+## Environments
+
+This SDK allows you to configure different environments for API requests.
+
+```typescript
+import { AgentMailClient, AgentMailEnvironment } from "agentmail";
+
+const client = new AgentMailClient({
+    environment: AgentMailEnvironment.Prod,
+});
+```
+
 ## Request and Response Types
 
 The SDK exports all request and response types as TypeScript interfaces. Simply import them with the
@@ -469,6 +484,16 @@ const text = new TextDecoder().decode(bytes);
 
 ## Advanced
 
+### Subpackage Exports
+
+This SDK supports direct imports of subpackage clients, which allows JavaScript bundlers to tree-shake and include only the imported subpackage code. This results in much smaller bundle sizes.
+
+```typescript
+import { InboxesClient } from 'agentmail/inboxes';
+
+const client = new InboxesClient({...});
+```
+
 ### Additional Headers
 
 If you would like to send additional headers as part of the request, use the `headers` request option.
@@ -619,6 +644,26 @@ const logger: logging.ILogger = {
 </details>
 
 
+### Custom Fetch
+
+The SDK provides a low-level `fetch` method for making custom HTTP requests while still
+benefiting from SDK-level configuration like authentication, retries, timeouts, and logging.
+This is useful for calling API endpoints not yet supported in the SDK.
+
+```typescript
+const response = await client.fetch("/v1/custom/endpoint", {
+    method: "GET",
+}, {
+    timeoutInSeconds: 30,
+    maxRetries: 3,
+    headers: {
+        "X-Custom-Header": "custom-value",
+    },
+});
+
+const data = await response.json();
+```
+
 ### Runtime Compatibility
 
 
@@ -633,19 +678,6 @@ The SDK works in the following runtimes:
 - Bun 1.0+
 - React Native
 
-### Customizing Fetch Client
-
-The SDK provides a way for you to customize the underlying HTTP client / Fetch function. If you're running in an
-unsupported environment, this provides a way for you to break glass and ensure the SDK works.
-
-```typescript
-import { AgentMailClient } from "agentmail";
-
-const client = new AgentMailClient({
-    ...
-    fetcher: // provide your implementation here
-});
-```
 
 ## Contributing
 
@@ -655,4 +687,4 @@ otherwise they would be overwritten upon the next generated release. Feel free t
 a proof of concept, but know that we will not be able to merge it as-is. We suggest opening
 an issue first to discuss with us!
 
-On the other hand, contributions to the README are always very welcome!
+On the other hand, contributions to the README are always very welcome!

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.4.14",
-        "User-Agent": "agentmail/0.4.14",
+        "X-Fern-SDK-Version": "0.4.16",
+        "User-Agent": "agentmail/0.4.16",
         "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/Client.d.ts

@@ -12,6 +12,7 @@ import { WebhooksClient } from "./api/resources/webhooks/client/Client.js";
 import { WebsocketsClient } from "./api/resources/websockets/client/Client.js";
 import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
 import { type NormalizedClientOptionsWithAuth } from "./BaseClient.js";
+import * as core from "./core/index.js";
 export declare namespace AgentMailClient {
     type Options = BaseClientOptions;
     interface RequestOptions extends BaseRequestOptions {
@@ -44,4 +45,15 @@ export declare class AgentMailClient {
     get organizations(): OrganizationsClient;
     get threads(): ThreadsClient;
     get websockets(): WebsocketsClient;
+    /**
+     * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
+     * This is useful for making requests to endpoints not yet supported in the SDK.
+     * The input can be a URL string, URL object, or Request object. Relative paths are resolved against the configured base URL.
+     *
+     * @param {Request | string | URL} input - The URL, path, or Request object.
+     * @param {RequestInit} init - Standard fetch RequestInit options.
+     * @param {core.PassthroughRequest.RequestOptions} requestOptions - Per-request overrides (timeout, retries, headers, abort signal).
+     * @returns {Promise<Response>} A standard Response object.
+     */
+    fetch(input: Request | string | URL, init?: RequestInit, requestOptions?: core.PassthroughRequest.RequestOptions): Promise<Response>;
 }

package/dist/cjs/Client.js

@@ -1,5 +1,47 @@
 "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;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentMailClient = void 0;
 const Client_js_1 = require("./api/resources/agent/client/Client.js");
@@ -15,6 +57,8 @@ const Client_js_10 = require("./api/resources/threads/client/Client.js");
 const Client_js_11 = require("./api/resources/webhooks/client/Client.js");
 const Client_js_12 = require("./api/resources/websockets/client/Client.js");
 const BaseClient_js_1 = require("./BaseClient.js");
+const core = __importStar(require("./core/index.js"));
+const environments = __importStar(require("./environments.js"));
 class AgentMailClient {
     constructor(options = {}) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
@@ -67,5 +111,35 @@ class AgentMailClient {
         var _a;
         return ((_a = this._websockets) !== null && _a !== void 0 ? _a : (this._websockets = new Client_js_12.WebsocketsClient(this._options)));
     }
+    /**
+     * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
+     * This is useful for making requests to endpoints not yet supported in the SDK.
+     * The input can be a URL string, URL object, or Request object. Relative paths are resolved against the configured base URL.
+     *
+     * @param {Request | string | URL} input - The URL, path, or Request object.
+     * @param {RequestInit} init - Standard fetch RequestInit options.
+     * @param {core.PassthroughRequest.RequestOptions} requestOptions - Per-request overrides (timeout, retries, headers, abort signal).
+     * @returns {Promise<Response>} A standard Response object.
+     */
+    fetch(input, init, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            return core.makePassthroughRequest(input, init, {
+                baseUrl: (_a = this._options.baseUrl) !== null && _a !== void 0 ? _a : (() => __awaiter(this, void 0, void 0, function* () {
+                    var _a;
+                    const env = yield core.Supplier.get(this._options.environment);
+                    return typeof env === "string"
+                        ? env
+                        : ((_a = env === null || env === void 0 ? void 0 : env.http) !== null && _a !== void 0 ? _a : environments.AgentMailEnvironment.Prod.http);
+                })),
+                headers: this._options.headers,
+                timeoutInSeconds: this._options.timeoutInSeconds,
+                maxRetries: this._options.maxRetries,
+                fetch: this._options.fetch,
+                logging: this._options.logging,
+                getAuthHeaders: () => __awaiter(this, void 0, void 0, function* () { return (yield this._options.authProvider.getAuthRequest()).headers; }),
+            }, requestOptions);
+        });
+    }
 }
 exports.AgentMailClient = AgentMailClient;

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

@@ -11,12 +11,19 @@ export declare class AgentClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<AgentClient.Options>;
     constructor(options?: AgentClient.Options);
     /**
-     * Create a new agent organization with an inbox and API key. A 6-digit OTP is sent to the human's email for verification.
+     * Create a new agent organization with an inbox and API key. This endpoint is for signing up for the first time. If you've already signed up, you're all set — just use your existing API key.
+     *
+     * A 6-digit OTP is sent to the human's email for verification.
      *
      * This endpoint is idempotent. Calling it again with the same `human_email` will rotate the API key and resend the OTP if expired.
      *
      * The returned API key has limited permissions until the organization is verified via the verify endpoint.
      *
+     * **CLI:**
+     * ```bash
+     * agentmail agent sign-up --human-email user@example.com --username my-agent
+     * ```
+     *
      * @param {AgentMail.AgentSignupRequest} request
      * @param {AgentClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -37,6 +44,11 @@ export declare class AgentClient {
      *
      * The OTP expires after 24 hours and allows a maximum of 10 attempts.
      *
+     * **CLI:**
+     * ```bash
+     * agentmail agent verify --otp-code 123456
+     * ```
+     *
      * @param {AgentMail.AgentVerifyRequest} request
      * @param {AgentClient.RequestOptions} requestOptions - Request-specific configuration.
      *

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

@@ -57,12 +57,19 @@ class AgentClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * Create a new agent organization with an inbox and API key. A 6-digit OTP is sent to the human's email for verification.
+     * Create a new agent organization with an inbox and API key. This endpoint is for signing up for the first time. If you've already signed up, you're all set — just use your existing API key.
+     *
+     * A 6-digit OTP is sent to the human's email for verification.
      *
      * This endpoint is idempotent. Calling it again with the same `human_email` will rotate the API key and resend the OTP if expired.
      *
      * The returned API key has limited permissions until the organization is verified via the verify endpoint.
      *
+     * **CLI:**
+     * ```bash
+     * agentmail agent sign-up --human-email user@example.com --username my-agent
+     * ```
+     *
      * @param {AgentMail.AgentSignupRequest} request
      * @param {AgentClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -139,6 +146,11 @@ class AgentClient {
      *
      * The OTP expires after 24 hours and allows a maximum of 10 attempts.
      *
+     * **CLI:**
+     * ```bash
+     * agentmail agent verify --otp-code 123456
+     * ```
+     *
      * @param {AgentMail.AgentVerifyRequest} request
      * @param {AgentClient.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/cjs/api/resources/agent/exports.d.ts

@@ -0,0 +1,2 @@
+export { AgentClient } from "./client/Client.js";
+export * from "./client/index.js";

package/dist/cjs/api/resources/agent/exports.js

@@ -0,0 +1,21 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentClient = void 0;
+var Client_js_1 = require("./client/Client.js");
+Object.defineProperty(exports, "AgentClient", { enumerable: true, get: function () { return Client_js_1.AgentClient; } });
+__exportStar(require("./client/index.js"), exports);

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

@@ -11,6 +11,11 @@ export declare class ApiKeysClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<ApiKeysClient.Options>;
     constructor(options?: ApiKeysClient.Options);
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail api-keys list
+     * ```
+     *
      * @param {AgentMail.ListApiKeysRequest} request
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -20,19 +25,27 @@ export declare class ApiKeysClient {
     list(request?: AgentMail.ListApiKeysRequest, requestOptions?: ApiKeysClient.RequestOptions): core.HttpResponsePromise<AgentMail.ListApiKeysResponse>;
     private __list;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail api-keys create --name "My Key"
+     * ```
+     *
      * @param {AgentMail.CreateApiKeyRequest} request
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
      *
      * @example
-     *     await client.apiKeys.create({
-     *         name: "name"
-     *     })
+     *     await client.apiKeys.create({})
      */
     create(request: AgentMail.CreateApiKeyRequest, requestOptions?: ApiKeysClient.RequestOptions): core.HttpResponsePromise<AgentMail.CreateApiKeyResponse>;
     private __create;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail api-keys delete --api-key-id <api_key_id>
+     * ```
+     *
      * @param {AgentMail.ApiKeyId} api_key_id
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
      *

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

@@ -57,6 +57,11 @@ class ApiKeysClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail api-keys list
+     * ```
+     *
      * @param {AgentMail.ListApiKeysRequest} request
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -112,15 +117,18 @@ class ApiKeysClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail api-keys create --name "My Key"
+     * ```
+     *
      * @param {AgentMail.CreateApiKeyRequest} request
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.ValidationError}
      *
      * @example
-     *     await client.apiKeys.create({
-     *         name: "name"
-     *     })
+     *     await client.apiKeys.create({})
      */
     create(request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));
@@ -182,6 +190,11 @@ class ApiKeysClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail api-keys delete --api-key-id <api_key_id>
+     * ```
+     *
      * @param {AgentMail.ApiKeyId} api_key_id
      * @param {ApiKeysClient.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/cjs/api/resources/apiKeys/exports.d.ts

@@ -0,0 +1,2 @@
+export { ApiKeysClient } from "./client/Client.js";
+export * from "./client/index.js";

package/dist/cjs/api/resources/apiKeys/exports.js

@@ -0,0 +1,21 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiKeysClient = void 0;
+var Client_js_1 = require("./client/Client.js");
+Object.defineProperty(exports, "ApiKeysClient", { enumerable: true, get: function () { return Client_js_1.ApiKeysClient; } });
+__exportStar(require("./client/index.js"), exports);

package/dist/cjs/api/resources/apiKeys/types/CreateApiKeyRequest.d.ts

@@ -1,5 +1,5 @@
 import type * as AgentMail from "../../../index.js";
 export interface CreateApiKeyRequest {
-    name: AgentMail.Name;
+    name?: AgentMail.Name;
     permissions?: AgentMail.ApiKeyPermissions;
 }

package/dist/cjs/api/resources/attachments/exports.d.ts

@@ -0,0 +1 @@
+export * from "./index.js";

package/dist/cjs/api/resources/attachments/exports.js

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./index.js"), exports);

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

@@ -11,6 +11,11 @@ export declare class DomainsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<DomainsClient.Options>;
     constructor(options?: DomainsClient.Options);
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains list
+     * ```
+     *
      * @param {AgentMail.ListDomainsRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -20,6 +25,11 @@ export declare class DomainsClient {
     list(request?: AgentMail.ListDomainsRequest, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<AgentMail.ListDomainsResponse>;
     private __list;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains retrieve --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -31,11 +41,21 @@ export declare class DomainsClient {
     get(domain_id: AgentMail.DomainId, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Domain>;
     private __get;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains get-zone-file --domain-id <domain_id>
+     * ```
+     *
      * @throws {@link AgentMail.NotFoundError}
      */
     getZoneFile(domain_id: AgentMail.DomainId, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
     private __getZoneFile;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains create --domain example.com
+     * ```
+     *
      * @param {AgentMail.CreateDomainRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -50,6 +70,11 @@ export declare class DomainsClient {
     create(request: AgentMail.CreateDomainRequest, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Domain>;
     private __create;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains update --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {AgentMail.UpdateDomainRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -62,6 +87,11 @@ export declare class DomainsClient {
     update(domain_id: AgentMail.DomainId, request: AgentMail.UpdateDomainRequest, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Domain>;
     private __update;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains delete --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -73,6 +103,11 @@ export declare class DomainsClient {
     delete(domain_id: AgentMail.DomainId, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<void>;
     private __delete;
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains verify --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *

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

@@ -57,6 +57,11 @@ class DomainsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains list
+     * ```
+     *
      * @param {AgentMail.ListDomainsRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -112,6 +117,11 @@ class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains retrieve --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -174,6 +184,11 @@ class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains get-zone-file --domain-id <domain_id>
+     * ```
+     *
      * @throws {@link AgentMail.NotFoundError}
      */
     getZoneFile(domain_id, requestOptions) {
@@ -222,6 +237,11 @@ class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains create --domain example.com
+     * ```
+     *
      * @param {AgentMail.CreateDomainRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -293,6 +313,11 @@ class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains update --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {AgentMail.UpdateDomainRequest} request
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -362,6 +387,11 @@ class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains delete --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -415,6 +445,11 @@ class DomainsClient {
         });
     }
     /**
+     * **CLI:**
+     * ```bash
+     * agentmail domains verify --domain-id <domain_id>
+     * ```
+     *
      * @param {AgentMail.DomainId} domain_id
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/cjs/api/resources/domains/exports.d.ts

@@ -0,0 +1,2 @@
+export { DomainsClient } from "./client/Client.js";
+export * from "./client/index.js";

package/dist/cjs/api/resources/domains/exports.js

@@ -0,0 +1,21 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DomainsClient = void 0;
+var Client_js_1 = require("./client/Client.js");
+Object.defineProperty(exports, "DomainsClient", { enumerable: true, get: function () { return Client_js_1.DomainsClient; } });
+__exportStar(require("./client/index.js"), exports);