agentmail 0.5.7 → 0.5.8

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.7",
-        "User-Agent": "agentmail/0.5.7",
+        "X-Fern-SDK-Version": "0.5.8",
+        "User-Agent": "agentmail/0.5.8",
         "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

@@ -1,5 +1,6 @@
 import { AgentClient } from "./api/resources/agent/client/Client.js";
 import { ApiKeysClient } from "./api/resources/apiKeys/client/Client.js";
+import { AuthClient } from "./api/resources/auth/client/Client.js";
 import { DomainsClient } from "./api/resources/domains/client/Client.js";
 import { DraftsClient } from "./api/resources/drafts/client/Client.js";
 import { InboxesClient } from "./api/resources/inboxes/client/Client.js";
@@ -25,6 +26,7 @@ export declare class AgentMailClient {
     protected _webhooks: WebhooksClient | undefined;
     protected _agent: AgentClient | undefined;
     protected _apiKeys: ApiKeysClient | undefined;
+    protected _auth: AuthClient | undefined;
     protected _domains: DomainsClient | undefined;
     protected _drafts: DraftsClient | undefined;
     protected _lists: ListsClient | undefined;
@@ -38,6 +40,7 @@ export declare class AgentMailClient {
     get webhooks(): WebhooksClient;
     get agent(): AgentClient;
     get apiKeys(): ApiKeysClient;
+    get auth(): AuthClient;
     get domains(): DomainsClient;
     get drafts(): DraftsClient;
     get lists(): ListsClient;

package/dist/cjs/Client.js

@@ -46,16 +46,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentMailClient = void 0;
 const Client_js_1 = require("./api/resources/agent/client/Client.js");
 const Client_js_2 = require("./api/resources/apiKeys/client/Client.js");
-const Client_js_3 = require("./api/resources/domains/client/Client.js");
-const Client_js_4 = require("./api/resources/drafts/client/Client.js");
-const Client_js_5 = require("./api/resources/inboxes/client/Client.js");
-const Client_js_6 = require("./api/resources/lists/client/Client.js");
-const Client_js_7 = require("./api/resources/metrics/client/Client.js");
-const Client_js_8 = require("./api/resources/organizations/client/Client.js");
-const Client_js_9 = require("./api/resources/pods/client/Client.js");
-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 Client_js_3 = require("./api/resources/auth/client/Client.js");
+const Client_js_4 = require("./api/resources/domains/client/Client.js");
+const Client_js_5 = require("./api/resources/drafts/client/Client.js");
+const Client_js_6 = require("./api/resources/inboxes/client/Client.js");
+const Client_js_7 = require("./api/resources/lists/client/Client.js");
+const Client_js_8 = require("./api/resources/metrics/client/Client.js");
+const Client_js_9 = require("./api/resources/organizations/client/Client.js");
+const Client_js_10 = require("./api/resources/pods/client/Client.js");
+const Client_js_11 = require("./api/resources/threads/client/Client.js");
+const Client_js_12 = require("./api/resources/webhooks/client/Client.js");
+const Client_js_13 = 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"));
@@ -65,15 +66,15 @@ class AgentMailClient {
     }
     get inboxes() {
         var _a;
-        return ((_a = this._inboxes) !== null && _a !== void 0 ? _a : (this._inboxes = new Client_js_5.InboxesClient(this._options)));
+        return ((_a = this._inboxes) !== null && _a !== void 0 ? _a : (this._inboxes = new Client_js_6.InboxesClient(this._options)));
     }
     get pods() {
         var _a;
-        return ((_a = this._pods) !== null && _a !== void 0 ? _a : (this._pods = new Client_js_9.PodsClient(this._options)));
+        return ((_a = this._pods) !== null && _a !== void 0 ? _a : (this._pods = new Client_js_10.PodsClient(this._options)));
     }
     get webhooks() {
         var _a;
-        return ((_a = this._webhooks) !== null && _a !== void 0 ? _a : (this._webhooks = new Client_js_11.WebhooksClient(this._options)));
+        return ((_a = this._webhooks) !== null && _a !== void 0 ? _a : (this._webhooks = new Client_js_12.WebhooksClient(this._options)));
     }
     get agent() {
         var _a;
@@ -83,33 +84,37 @@ class AgentMailClient {
         var _a;
         return ((_a = this._apiKeys) !== null && _a !== void 0 ? _a : (this._apiKeys = new Client_js_2.ApiKeysClient(this._options)));
     }
+    get auth() {
+        var _a;
+        return ((_a = this._auth) !== null && _a !== void 0 ? _a : (this._auth = new Client_js_3.AuthClient(this._options)));
+    }
     get domains() {
         var _a;
-        return ((_a = this._domains) !== null && _a !== void 0 ? _a : (this._domains = new Client_js_3.DomainsClient(this._options)));
+        return ((_a = this._domains) !== null && _a !== void 0 ? _a : (this._domains = new Client_js_4.DomainsClient(this._options)));
     }
     get drafts() {
         var _a;
-        return ((_a = this._drafts) !== null && _a !== void 0 ? _a : (this._drafts = new Client_js_4.DraftsClient(this._options)));
+        return ((_a = this._drafts) !== null && _a !== void 0 ? _a : (this._drafts = new Client_js_5.DraftsClient(this._options)));
     }
     get lists() {
         var _a;
-        return ((_a = this._lists) !== null && _a !== void 0 ? _a : (this._lists = new Client_js_6.ListsClient(this._options)));
+        return ((_a = this._lists) !== null && _a !== void 0 ? _a : (this._lists = new Client_js_7.ListsClient(this._options)));
     }
     get metrics() {
         var _a;
-        return ((_a = this._metrics) !== null && _a !== void 0 ? _a : (this._metrics = new Client_js_7.MetricsClient(this._options)));
+        return ((_a = this._metrics) !== null && _a !== void 0 ? _a : (this._metrics = new Client_js_8.MetricsClient(this._options)));
     }
     get organizations() {
         var _a;
-        return ((_a = this._organizations) !== null && _a !== void 0 ? _a : (this._organizations = new Client_js_8.OrganizationsClient(this._options)));
+        return ((_a = this._organizations) !== null && _a !== void 0 ? _a : (this._organizations = new Client_js_9.OrganizationsClient(this._options)));
     }
     get threads() {
         var _a;
-        return ((_a = this._threads) !== null && _a !== void 0 ? _a : (this._threads = new Client_js_10.ThreadsClient(this._options)));
+        return ((_a = this._threads) !== null && _a !== void 0 ? _a : (this._threads = new Client_js_11.ThreadsClient(this._options)));
     }
     get websockets() {
         var _a;
-        return ((_a = this._websockets) !== null && _a !== void 0 ? _a : (this._websockets = new Client_js_12.WebsocketsClient(this._options)));
+        return ((_a = this._websockets) !== null && _a !== void 0 ? _a : (this._websockets = new Client_js_13.WebsocketsClient(this._options)));
     }
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.

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

@@ -0,0 +1,28 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import type * as AgentMail from "../../../index.js";
+export declare namespace AuthClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class AuthClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<AuthClient.Options>;
+    constructor(options?: AuthClient.Options);
+    /**
+     * Returns the identity and scope of the authenticated credential. Useful when a client holds a pod-scoped or inbox-scoped API key and needs to discover the parent organization, pod, or inbox without prior knowledge.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail auth me
+     * ```
+     *
+     * @param {AuthClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.auth.me()
+     */
+    me(requestOptions?: AuthClient.RequestOptions): core.HttpResponsePromise<AgentMail.Identity>;
+    private __me;
+}

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

@@ -0,0 +1,114 @@
+"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.AuthClient = void 0;
+const BaseClient_js_1 = require("../../../../BaseClient.js");
+const headers_js_1 = require("../../../../core/headers.js");
+const core = __importStar(require("../../../../core/index.js"));
+const environments = __importStar(require("../../../../environments.js"));
+const handleNonStatusCodeError_js_1 = require("../../../../errors/handleNonStatusCodeError.js");
+const errors = __importStar(require("../../../../errors/index.js"));
+const serializers = __importStar(require("../../../../serialization/index.js"));
+class AuthClient {
+    constructor(options = {}) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
+    }
+    /**
+     * Returns the identity and scope of the authenticated credential. Useful when a client holds a pod-scoped or inbox-scoped API key and needs to discover the parent organization, pod, or inbox without prior knowledge.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail auth me
+     * ```
+     *
+     * @param {AuthClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.auth.me()
+     */
+    me(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__me(requestOptions));
+    }
+    __me(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Prod)
+                    .http, "/v0/auth/me"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.Identity.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                throw new errors.AgentMailError({
+                    statusCode: _response.error.statusCode,
+                    body: _response.error.body,
+                    rawResponse: _response.rawResponse,
+                });
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/auth/me");
+        });
+    }
+}
+exports.AuthClient = AuthClient;

package/dist/cjs/api/resources/auth/client/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/api/resources/auth/client/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

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

package/dist/cjs/api/resources/auth/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.AuthClient = void 0;
+var Client_js_1 = require("./client/Client.js");
+Object.defineProperty(exports, "AuthClient", { enumerable: true, get: function () { return Client_js_1.AuthClient; } });
+__exportStar(require("./client/index.js"), exports);

package/dist/cjs/api/resources/auth/index.d.ts

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

package/dist/cjs/api/resources/auth/index.js

@@ -0,0 +1,18 @@
+"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 __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("./client/index.js"), exports);
+__exportStar(require("./types/index.js"), exports);

package/dist/cjs/api/resources/auth/types/Identity.d.ts

@@ -0,0 +1,19 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * Identity and scope of the authenticated credential.
+ */
+export interface Identity {
+    scopeType: AgentMail.ScopeType;
+    /**
+     * ID of the most specific scope the credential is bound to.
+     * Equals inbox_id when scope_type is inbox, pod_id when pod, organization_id when organization.
+     */
+    scopeId: string;
+    organizationId: AgentMail.OrganizationId;
+    /** ID of the pod the credential is scoped to. Present when scope_type is pod or inbox. */
+    podId?: string;
+    /** ID of the inbox the credential is scoped to. Present when scope_type is inbox. */
+    inboxId?: string;
+    /** ID of the API key used to authenticate. Absent for JWT and proxy credentials. */
+    apiKeyId?: string;
+}

package/dist/cjs/api/resources/auth/types/Identity.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/auth/types/ScopeType.d.ts

@@ -0,0 +1,7 @@
+/** The scope tier the authenticated credential is bound to. */
+export declare const ScopeType: {
+    readonly Organization: "organization";
+    readonly Pod: "pod";
+    readonly Inbox: "inbox";
+};
+export type ScopeType = (typeof ScopeType)[keyof typeof ScopeType];

package/dist/cjs/api/resources/auth/types/ScopeType.js

@@ -0,0 +1,10 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopeType = void 0;
+/** The scope tier the authenticated credential is bound to. */
+exports.ScopeType = {
+    Organization: "organization",
+    Pod: "pod",
+    Inbox: "inbox",
+};

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

@@ -0,0 +1,2 @@
+export * from "./Identity.js";
+export * from "./ScopeType.js";

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

@@ -0,0 +1,18 @@
+"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 __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("./Identity.js"), exports);
+__exportStar(require("./ScopeType.js"), exports);

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

@@ -5,6 +5,8 @@ export * as apiKeys from "./apiKeys/index.js";
 export * from "./apiKeys/types/index.js";
 export * as attachments from "./attachments/index.js";
 export * from "./attachments/types/index.js";
+export * as auth from "./auth/index.js";
+export * from "./auth/types/index.js";
 export * from "./domains/client/requests/index.js";
 export * as domains from "./domains/index.js";
 export * from "./domains/types/index.js";

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

@@ -36,7 +36,7 @@ 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.websockets = exports.webhooks = exports.threads = exports.pods = exports.organizations = exports.metrics = exports.messages = exports.lists = exports.inboxes = exports.inboxEvents = exports.events = exports.drafts = exports.domains = exports.attachments = exports.apiKeys = exports.agent = void 0;
+exports.websockets = exports.webhooks = exports.threads = exports.pods = exports.organizations = exports.metrics = exports.messages = exports.lists = exports.inboxes = exports.inboxEvents = exports.events = exports.drafts = exports.domains = exports.auth = exports.attachments = exports.apiKeys = exports.agent = void 0;
 exports.agent = __importStar(require("./agent/index.js"));
 __exportStar(require("./agent/types/index.js"), exports);
 __exportStar(require("./apiKeys/client/requests/index.js"), exports);
@@ -44,6 +44,8 @@ exports.apiKeys = __importStar(require("./apiKeys/index.js"));
 __exportStar(require("./apiKeys/types/index.js"), exports);
 exports.attachments = __importStar(require("./attachments/index.js"));
 __exportStar(require("./attachments/types/index.js"), exports);
+exports.auth = __importStar(require("./auth/index.js"));
+__exportStar(require("./auth/types/index.js"), exports);
 __exportStar(require("./domains/client/requests/index.js"), exports);
 exports.domains = __importStar(require("./domains/index.js"));
 __exportStar(require("./domains/types/index.js"), exports);

package/dist/cjs/serialization/resources/auth/index.d.ts

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

package/dist/cjs/serialization/resources/auth/index.js

@@ -0,0 +1,17 @@
+"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 __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("./types/index.js"), exports);

package/dist/cjs/serialization/resources/auth/types/Identity.d.ts

@@ -0,0 +1,16 @@
+import type * as AgentMail from "../../../../api/index.js";
+import * as core from "../../../../core/index.js";
+import type * as serializers from "../../../index.js";
+import { OrganizationId } from "../../../types/OrganizationId.js";
+import { ScopeType } from "./ScopeType.js";
+export declare const Identity: core.serialization.ObjectSchema<serializers.Identity.Raw, AgentMail.Identity>;
+export declare namespace Identity {
+    interface Raw {
+        scope_type: ScopeType.Raw;
+        scope_id: string;
+        organization_id: OrganizationId.Raw;
+        pod_id?: string | null;
+        inbox_id?: string | null;
+        api_key_id?: string | null;
+    }
+}

package/dist/cjs/serialization/resources/auth/types/Identity.js

@@ -0,0 +1,48 @@
+"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.Identity = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+const OrganizationId_js_1 = require("../../../types/OrganizationId.js");
+const ScopeType_js_1 = require("./ScopeType.js");
+exports.Identity = core.serialization.object({
+    scopeType: core.serialization.property("scope_type", ScopeType_js_1.ScopeType),
+    scopeId: core.serialization.property("scope_id", core.serialization.string()),
+    organizationId: core.serialization.property("organization_id", OrganizationId_js_1.OrganizationId),
+    podId: core.serialization.property("pod_id", core.serialization.string().optional()),
+    inboxId: core.serialization.property("inbox_id", core.serialization.string().optional()),
+    apiKeyId: core.serialization.property("api_key_id", core.serialization.string().optional()),
+});

package/dist/cjs/serialization/resources/auth/types/ScopeType.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 ScopeType: core.serialization.Schema<serializers.ScopeType.Raw, AgentMail.ScopeType>;
+export declare namespace ScopeType {
+    type Raw = "organization" | "pod" | "inbox";
+}

package/dist/cjs/serialization/resources/auth/types/ScopeType.js

@@ -0,0 +1,39 @@
+"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.ScopeType = void 0;
+const core = __importStar(require("../../../../core/index.js"));
+exports.ScopeType = core.serialization.enum_(["organization", "pod", "inbox"]);

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

@@ -0,0 +1,2 @@
+export * from "./Identity.js";
+export * from "./ScopeType.js";

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

@@ -0,0 +1,18 @@
+"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 __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("./Identity.js"), exports);
+__exportStar(require("./ScopeType.js"), exports);

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

@@ -4,6 +4,8 @@ export * as apiKeys from "./apiKeys/index.js";
 export * from "./apiKeys/types/index.js";
 export * as attachments from "./attachments/index.js";
 export * from "./attachments/types/index.js";
+export * as auth from "./auth/index.js";
+export * from "./auth/types/index.js";
 export * as domains from "./domains/index.js";
 export * from "./domains/types/index.js";
 export * as drafts from "./drafts/index.js";

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

@@ -36,13 +36,15 @@ 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.websockets = exports.webhooks = exports.threads = exports.pods = exports.organizations = exports.metrics = exports.messages = exports.lists = exports.inboxes = exports.inboxEvents = exports.events = exports.drafts = exports.domains = exports.attachments = exports.apiKeys = exports.agent = void 0;
+exports.websockets = exports.webhooks = exports.threads = exports.pods = exports.organizations = exports.metrics = exports.messages = exports.lists = exports.inboxes = exports.inboxEvents = exports.events = exports.drafts = exports.domains = exports.auth = exports.attachments = exports.apiKeys = exports.agent = void 0;
 exports.agent = __importStar(require("./agent/index.js"));
 __exportStar(require("./agent/types/index.js"), exports);
 exports.apiKeys = __importStar(require("./apiKeys/index.js"));
 __exportStar(require("./apiKeys/types/index.js"), exports);
 exports.attachments = __importStar(require("./attachments/index.js"));
 __exportStar(require("./attachments/types/index.js"), exports);
+exports.auth = __importStar(require("./auth/index.js"));
+__exportStar(require("./auth/types/index.js"), exports);
 exports.domains = __importStar(require("./domains/index.js"));
 __exportStar(require("./domains/types/index.js"), exports);
 exports.drafts = __importStar(require("./drafts/index.js"));

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.5.7";
+export declare const SDK_VERSION = "0.5.8";

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

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.7",
-        "User-Agent": "agentmail/0.5.7",
+        "X-Fern-SDK-Version": "0.5.8",
+        "User-Agent": "agentmail/0.5.8",
         "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/Client.d.mts

@@ -1,5 +1,6 @@
 import { AgentClient } from "./api/resources/agent/client/Client.mjs";
 import { ApiKeysClient } from "./api/resources/apiKeys/client/Client.mjs";
+import { AuthClient } from "./api/resources/auth/client/Client.mjs";
 import { DomainsClient } from "./api/resources/domains/client/Client.mjs";
 import { DraftsClient } from "./api/resources/drafts/client/Client.mjs";
 import { InboxesClient } from "./api/resources/inboxes/client/Client.mjs";
@@ -25,6 +26,7 @@ export declare class AgentMailClient {
     protected _webhooks: WebhooksClient | undefined;
     protected _agent: AgentClient | undefined;
     protected _apiKeys: ApiKeysClient | undefined;
+    protected _auth: AuthClient | undefined;
     protected _domains: DomainsClient | undefined;
     protected _drafts: DraftsClient | undefined;
     protected _lists: ListsClient | undefined;
@@ -38,6 +40,7 @@ export declare class AgentMailClient {
     get webhooks(): WebhooksClient;
     get agent(): AgentClient;
     get apiKeys(): ApiKeysClient;
+    get auth(): AuthClient;
     get domains(): DomainsClient;
     get drafts(): DraftsClient;
     get lists(): ListsClient;

package/dist/esm/Client.mjs

@@ -10,6 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { AgentClient } from "./api/resources/agent/client/Client.mjs";
 import { ApiKeysClient } from "./api/resources/apiKeys/client/Client.mjs";
+import { AuthClient } from "./api/resources/auth/client/Client.mjs";
 import { DomainsClient } from "./api/resources/domains/client/Client.mjs";
 import { DraftsClient } from "./api/resources/drafts/client/Client.mjs";
 import { InboxesClient } from "./api/resources/inboxes/client/Client.mjs";
@@ -47,6 +48,10 @@ export class AgentMailClient {
         var _a;
         return ((_a = this._apiKeys) !== null && _a !== void 0 ? _a : (this._apiKeys = new ApiKeysClient(this._options)));
     }
+    get auth() {
+        var _a;
+        return ((_a = this._auth) !== null && _a !== void 0 ? _a : (this._auth = new AuthClient(this._options)));
+    }
     get domains() {
         var _a;
         return ((_a = this._domains) !== null && _a !== void 0 ? _a : (this._domains = new DomainsClient(this._options)));

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

@@ -0,0 +1,28 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.mjs";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import * as core from "../../../../core/index.mjs";
+import type * as AgentMail from "../../../index.mjs";
+export declare namespace AuthClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class AuthClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<AuthClient.Options>;
+    constructor(options?: AuthClient.Options);
+    /**
+     * Returns the identity and scope of the authenticated credential. Useful when a client holds a pod-scoped or inbox-scoped API key and needs to discover the parent organization, pod, or inbox without prior knowledge.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail auth me
+     * ```
+     *
+     * @param {AuthClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.auth.me()
+     */
+    me(requestOptions?: AuthClient.RequestOptions): core.HttpResponsePromise<AgentMail.Identity>;
+    private __me;
+}

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

@@ -0,0 +1,77 @@
+// This file was auto-generated by Fern from our API Definition.
+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());
+    });
+};
+import { normalizeClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import { mergeHeaders } from "../../../../core/headers.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as environments from "../../../../environments.mjs";
+import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCodeError.mjs";
+import * as errors from "../../../../errors/index.mjs";
+import * as serializers from "../../../../serialization/index.mjs";
+export class AuthClient {
+    constructor(options = {}) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+    /**
+     * Returns the identity and scope of the authenticated credential. Useful when a client holds a pod-scoped or inbox-scoped API key and needs to discover the parent organization, pod, or inbox without prior knowledge.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail auth me
+     * ```
+     *
+     * @param {AuthClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.auth.me()
+     */
+    me(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__me(requestOptions));
+    }
+    __me(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Prod)
+                    .http, "/v0/auth/me"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.Identity.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                throw new errors.AgentMailError({
+                    statusCode: _response.error.statusCode,
+                    body: _response.error.body,
+                    rawResponse: _response.rawResponse,
+                });
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v0/auth/me");
+        });
+    }
+}

package/dist/esm/api/resources/auth/client/index.d.mts

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/auth/client/index.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/auth/exports.d.mts

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

package/dist/esm/api/resources/auth/exports.mjs

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+export { AuthClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/auth/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./client/index.mjs";
+export * from "./types/index.mjs";

package/dist/esm/api/resources/auth/index.mjs

@@ -0,0 +1,2 @@
+export * from "./client/index.mjs";
+export * from "./types/index.mjs";

package/dist/esm/api/resources/auth/types/Identity.d.mts

@@ -0,0 +1,19 @@
+import type * as AgentMail from "../../../index.mjs";
+/**
+ * Identity and scope of the authenticated credential.
+ */
+export interface Identity {
+    scopeType: AgentMail.ScopeType;
+    /**
+     * ID of the most specific scope the credential is bound to.
+     * Equals inbox_id when scope_type is inbox, pod_id when pod, organization_id when organization.
+     */
+    scopeId: string;
+    organizationId: AgentMail.OrganizationId;
+    /** ID of the pod the credential is scoped to. Present when scope_type is pod or inbox. */
+    podId?: string;
+    /** ID of the inbox the credential is scoped to. Present when scope_type is inbox. */
+    inboxId?: string;
+    /** ID of the API key used to authenticate. Absent for JWT and proxy credentials. */
+    apiKeyId?: string;
+}

package/dist/esm/api/resources/auth/types/Identity.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/auth/types/ScopeType.d.mts

@@ -0,0 +1,7 @@
+/** The scope tier the authenticated credential is bound to. */
+export declare const ScopeType: {
+    readonly Organization: "organization";
+    readonly Pod: "pod";
+    readonly Inbox: "inbox";
+};
+export type ScopeType = (typeof ScopeType)[keyof typeof ScopeType];

package/dist/esm/api/resources/auth/types/ScopeType.mjs

@@ -0,0 +1,7 @@
+// This file was auto-generated by Fern from our API Definition.
+/** The scope tier the authenticated credential is bound to. */
+export const ScopeType = {
+    Organization: "organization",
+    Pod: "pod",
+    Inbox: "inbox",
+};

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

@@ -0,0 +1,2 @@
+export * from "./Identity.mjs";
+export * from "./ScopeType.mjs";

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

@@ -0,0 +1,2 @@
+export * from "./Identity.mjs";
+export * from "./ScopeType.mjs";

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

@@ -5,6 +5,8 @@ export * as apiKeys from "./apiKeys/index.mjs";
 export * from "./apiKeys/types/index.mjs";
 export * as attachments from "./attachments/index.mjs";
 export * from "./attachments/types/index.mjs";
+export * as auth from "./auth/index.mjs";
+export * from "./auth/types/index.mjs";
 export * from "./domains/client/requests/index.mjs";
 export * as domains from "./domains/index.mjs";
 export * from "./domains/types/index.mjs";

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

@@ -5,6 +5,8 @@ export * as apiKeys from "./apiKeys/index.mjs";
 export * from "./apiKeys/types/index.mjs";
 export * as attachments from "./attachments/index.mjs";
 export * from "./attachments/types/index.mjs";
+export * as auth from "./auth/index.mjs";
+export * from "./auth/types/index.mjs";
 export * from "./domains/client/requests/index.mjs";
 export * as domains from "./domains/index.mjs";
 export * from "./domains/types/index.mjs";

package/dist/esm/serialization/resources/auth/index.d.mts

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

package/dist/esm/serialization/resources/auth/index.mjs

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

package/dist/esm/serialization/resources/auth/types/Identity.d.mts

@@ -0,0 +1,16 @@
+import type * as AgentMail from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+import type * as serializers from "../../../index.mjs";
+import { OrganizationId } from "../../../types/OrganizationId.mjs";
+import { ScopeType } from "./ScopeType.mjs";
+export declare const Identity: core.serialization.ObjectSchema<serializers.Identity.Raw, AgentMail.Identity>;
+export declare namespace Identity {
+    interface Raw {
+        scope_type: ScopeType.Raw;
+        scope_id: string;
+        organization_id: OrganizationId.Raw;
+        pod_id?: string | null;
+        inbox_id?: string | null;
+        api_key_id?: string | null;
+    }
+}

package/dist/esm/serialization/resources/auth/types/Identity.mjs

@@ -0,0 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../../../core/index.mjs";
+import { OrganizationId } from "../../../types/OrganizationId.mjs";
+import { ScopeType } from "./ScopeType.mjs";
+export const Identity = core.serialization.object({
+    scopeType: core.serialization.property("scope_type", ScopeType),
+    scopeId: core.serialization.property("scope_id", core.serialization.string()),
+    organizationId: core.serialization.property("organization_id", OrganizationId),
+    podId: core.serialization.property("pod_id", core.serialization.string().optional()),
+    inboxId: core.serialization.property("inbox_id", core.serialization.string().optional()),
+    apiKeyId: core.serialization.property("api_key_id", core.serialization.string().optional()),
+});

package/dist/esm/serialization/resources/auth/types/ScopeType.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 ScopeType: core.serialization.Schema<serializers.ScopeType.Raw, AgentMail.ScopeType>;
+export declare namespace ScopeType {
+    type Raw = "organization" | "pod" | "inbox";
+}

package/dist/esm/serialization/resources/auth/types/ScopeType.mjs

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../../../core/index.mjs";
+export const ScopeType = core.serialization.enum_(["organization", "pod", "inbox"]);

package/dist/esm/serialization/resources/auth/types/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./Identity.mjs";
+export * from "./ScopeType.mjs";

package/dist/esm/serialization/resources/auth/types/index.mjs

@@ -0,0 +1,2 @@
+export * from "./Identity.mjs";
+export * from "./ScopeType.mjs";

package/dist/esm/serialization/resources/index.d.mts

@@ -4,6 +4,8 @@ export * as apiKeys from "./apiKeys/index.mjs";
 export * from "./apiKeys/types/index.mjs";
 export * as attachments from "./attachments/index.mjs";
 export * from "./attachments/types/index.mjs";
+export * as auth from "./auth/index.mjs";
+export * from "./auth/types/index.mjs";
 export * as domains from "./domains/index.mjs";
 export * from "./domains/types/index.mjs";
 export * as drafts from "./drafts/index.mjs";

package/dist/esm/serialization/resources/index.mjs

@@ -4,6 +4,8 @@ export * as apiKeys from "./apiKeys/index.mjs";
 export * from "./apiKeys/types/index.mjs";
 export * as attachments from "./attachments/index.mjs";
 export * from "./attachments/types/index.mjs";
+export * as auth from "./auth/index.mjs";
+export * from "./auth/types/index.mjs";
 export * as domains from "./domains/index.mjs";
 export * from "./domains/types/index.mjs";
 export * as drafts from "./drafts/index.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.5.7";
+export declare const SDK_VERSION = "0.5.8";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.5.7";
+export const SDK_VERSION = "0.5.8";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agentmail",
-    "version": "0.5.7",
+    "version": "0.5.8",
     "private": false,
     "repository": {
         "type": "git",
@@ -88,6 +88,17 @@
             },
             "default": "./dist/cjs/api/resources/apiKeys/exports.js"
         },
+        "./auth": {
+            "import": {
+                "types": "./dist/esm/api/resources/auth/exports.d.mts",
+                "default": "./dist/esm/api/resources/auth/exports.mjs"
+            },
+            "require": {
+                "types": "./dist/cjs/api/resources/auth/exports.d.ts",
+                "default": "./dist/cjs/api/resources/auth/exports.js"
+            },
+            "default": "./dist/cjs/api/resources/auth/exports.js"
+        },
         "./domains": {
             "import": {
                 "types": "./dist/esm/api/resources/domains/exports.d.mts",

package/reference.md

@@ -1295,6 +1295,67 @@ await client.apiKeys.delete("api_key_id");
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+## Auth
+<details><summary><code>client.auth.<a href="/src/api/resources/auth/client/Client.ts">me</a>() -> AgentMail.Identity</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns the identity and scope of the authenticated credential. Useful when a client holds a pod-scoped or inbox-scoped API key and needs to discover the parent organization, pod, or inbox without prior knowledge.
+
+**CLI:**
+```bash
+agentmail auth me
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.auth.me();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**requestOptions:** `AuthClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>