agentmail 0.5.27 → 0.5.29

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.27",
-        "User-Agent": "agentmail/0.5.27",
+        "X-Fern-SDK-Version": "0.5.29",
+        "User-Agent": "agentmail/0.5.29",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

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

@@ -11,7 +11,9 @@ export declare class AccountsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<AccountsClient.Options>;
     constructor(options?: AccountsClient.Options);
     /**
-     * Lists accounts across all providers.
+     * Lists accounts across all providers, scoped to the API key: an
+     * organization key sees every account, a pod key its pod's, an inbox key
+     * its inbox's. Requires `inbox_read`.
      *
      * @param {AgentMail.ListAccountsRequest} request
      * @param {AccountsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -24,6 +26,9 @@ export declare class AccountsClient {
     list(request?: AgentMail.ListAccountsRequest, requestOptions?: AccountsClient.RequestOptions): core.HttpResponsePromise<AgentMail.ListAccountsResponse>;
     private __list;
     /**
+     * Returns one account by ID. An account outside the key's scope is a 404.
+     * Requires `inbox_read`.
+     *
      * @param {AgentMail.AccountId} account_id
      * @param {AccountsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -34,4 +39,36 @@ export declare class AccountsClient {
      */
     get(account_id: AgentMail.AccountId, requestOptions?: AccountsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Account>;
     private __get;
+    /**
+     * Updates one account. Set `status` to `disabled` to stop the inbox from
+     * signing in at the provider again, or to `enabled` to re-enable it.
+     * Idempotent: disabling an already disabled account keeps its original
+     * `disabled_at`, and enabling an enabled account is a no-op.
+     *
+     * Find the `account_id` with List Accounts. An account exists only after an
+     * inbox's first sign-in at a provider, so it cannot be disabled in advance.
+     * A disable applies to that inbox at that provider whichever sign-in key is
+     * used: the provider's next authorization ends in `access_denied`, and a code
+     * issued earlier is refused with `invalid_grant`. Access tokens already
+     * issued stay valid until they expire, and the provider's own session is
+     * unaffected.
+     *
+     * Requires `account_update`, which sign-in keys (`type: public_key`) cannot
+     * hold, so call this with a bearer API key. An account outside the key's
+     * scope is a 404. A 409 means the account changed during the write; read it
+     * again and retry.
+     *
+     * @param {AgentMail.AccountId} account_id
+     * @param {AgentMail.UpdateAccountRequest} request
+     * @param {AccountsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ConflictError}
+     *
+     * @example
+     *     await client.accounts.update("d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", {})
+     */
+    update(account_id: AgentMail.AccountId, request: AgentMail.UpdateAccountRequest, requestOptions?: AccountsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Account>;
+    private __update;
 }

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

@@ -57,7 +57,9 @@ class AccountsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * Lists accounts across all providers.
+     * Lists accounts across all providers, scoped to the API key: an
+     * organization key sees every account, a pod key its pod's, an inbox key
+     * its inbox's. Requires `inbox_read`.
      *
      * @param {AgentMail.ListAccountsRequest} request
      * @param {AccountsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -127,6 +129,9 @@ class AccountsClient {
         });
     }
     /**
+     * Returns one account by ID. An account outside the key's scope is a 404.
+     * Requires `inbox_read`.
+     *
      * @param {AgentMail.AccountId} account_id
      * @param {AccountsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -188,5 +193,110 @@ class AccountsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/accounts/{account_id}");
         });
     }
+    /**
+     * Updates one account. Set `status` to `disabled` to stop the inbox from
+     * signing in at the provider again, or to `enabled` to re-enable it.
+     * Idempotent: disabling an already disabled account keeps its original
+     * `disabled_at`, and enabling an enabled account is a no-op.
+     *
+     * Find the `account_id` with List Accounts. An account exists only after an
+     * inbox's first sign-in at a provider, so it cannot be disabled in advance.
+     * A disable applies to that inbox at that provider whichever sign-in key is
+     * used: the provider's next authorization ends in `access_denied`, and a code
+     * issued earlier is refused with `invalid_grant`. Access tokens already
+     * issued stay valid until they expire, and the provider's own session is
+     * unaffected.
+     *
+     * Requires `account_update`, which sign-in keys (`type: public_key`) cannot
+     * hold, so call this with a bearer API key. An account outside the key's
+     * scope is a 404. A 409 means the account changed during the write; read it
+     * again and retry.
+     *
+     * @param {AgentMail.AccountId} account_id
+     * @param {AgentMail.UpdateAccountRequest} request
+     * @param {AccountsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ConflictError}
+     *
+     * @example
+     *     await client.accounts.update("d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", {})
+     */
+    update(account_id, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__update(account_id, request, requestOptions));
+    }
+    __update(account_id, request, 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/accounts/${core.url.encodePathParam(serializers.AccountId.jsonOrThrow(account_id, { omitUndefined: true }))}/update`),
+                method: "PATCH",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.UpdateAccountRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                }),
+                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.Account.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AgentMail.ValidationError(serializers.ValidationErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 404:
+                        throw new AgentMail.NotFoundError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            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,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "PATCH", "/v0/accounts/{account_id}/update");
+        });
+    }
 }
 exports.AccountsClient = AccountsClient;

package/dist/cjs/api/resources/accounts/types/Account.d.ts

@@ -16,4 +16,8 @@ export interface Account {
     lastSignedInAt: Date;
     /** Number of sign-ins at provider. */
     signInCount: number;
+    /** Present only while the account is disabled. Absent means the inbox may sign in. */
+    status?: AgentMail.AccountStatus;
+    /** Time at which the account was disabled. Present only while `status` is `disabled`. */
+    disabledAt?: Date;
 }

package/dist/cjs/api/resources/accounts/types/AccountStatus.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `disabled` refuses every new sign-in for the account until it is
+ * re-enabled. Access tokens already issued are not revoked.
+ */
+export declare const AccountStatus: {
+    readonly Disabled: "disabled";
+};
+export type AccountStatus = (typeof AccountStatus)[keyof typeof AccountStatus];

package/dist/cjs/api/resources/accounts/types/AccountStatus.js

@@ -0,0 +1,11 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountStatus = void 0;
+/**
+ * `disabled` refuses every new sign-in for the account until it is
+ * re-enabled. Access tokens already issued are not revoked.
+ */
+exports.AccountStatus = {
+    Disabled: "disabled",
+};

package/dist/cjs/api/resources/accounts/types/UpdateAccountRequest.d.ts

@@ -0,0 +1,9 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * Fields to change on the account. Fields you omit are left unchanged and
+ * unknown fields are rejected. Expects at least one field; today that is
+ * `status`.
+ */
+export interface UpdateAccountRequest {
+    status?: AgentMail.UpdateAccountStatus;
+}

package/dist/cjs/api/resources/accounts/types/UpdateAccountRequest.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/accounts/types/UpdateAccountStatus.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Status to set. `disabled` stops the inbox from signing in at the
+ * provider; `enabled` re-enables it. An enabled account reads back with no
+ * `status`.
+ */
+export declare const UpdateAccountStatus: {
+    readonly Enabled: "enabled";
+    readonly Disabled: "disabled";
+};
+export type UpdateAccountStatus = (typeof UpdateAccountStatus)[keyof typeof UpdateAccountStatus];

package/dist/cjs/api/resources/accounts/types/UpdateAccountStatus.js

@@ -0,0 +1,13 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateAccountStatus = void 0;
+/**
+ * Status to set. `disabled` stops the inbox from signing in at the
+ * provider; `enabled` re-enables it. An enabled account reads back with no
+ * `status`.
+ */
+exports.UpdateAccountStatus = {
+    Enabled: "enabled",
+    Disabled: "disabled",
+};

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

@@ -1,4 +1,7 @@
 export * from "./Account.js";
 export * from "./AccountId.js";
+export * from "./AccountStatus.js";
 export * from "./ListAccountsResponse.js";
 export * from "./ProviderId.js";
+export * from "./UpdateAccountRequest.js";
+export * from "./UpdateAccountStatus.js";

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

@@ -16,5 +16,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./Account.js"), exports);
 __exportStar(require("./AccountId.js"), exports);
+__exportStar(require("./AccountStatus.js"), exports);
 __exportStar(require("./ListAccountsResponse.js"), exports);
 __exportStar(require("./ProviderId.js"), exports);
+__exportStar(require("./UpdateAccountRequest.js"), exports);
+__exportStar(require("./UpdateAccountStatus.js"), exports);

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

@@ -78,6 +78,11 @@ export interface ApiKeyPermissions {
      * for both values.
      */
     providerShareOwner?: boolean;
+    /**
+     * Update accounts: disable or re-enable an inbox's sign-in at a provider. Reading accounts
+     * needs only `inbox_read`.
+     */
+    accountUpdate?: boolean;
     /** Read pods. */
     podRead?: boolean;
     /** Create pods. */

package/dist/cjs/api/resources/attachments/types/AttachmentResponse.d.ts

@@ -6,8 +6,10 @@ export interface AttachmentResponse {
     contentType?: AgentMail.AttachmentContentType;
     contentDisposition?: AgentMail.AttachmentContentDisposition;
     contentId?: AgentMail.AttachmentContentId;
-    /** URL to download the attachment. */
+    /** Signed HTTPS CDN URL to download the attachment bytes. Retrieve a fresh URL when needed rather than storing it permanently. */
     downloadUrl: string;
-    /** Time at which the download URL expires. */
+    /** Signed HTTPS CDN URL to download extracted plain text, when available. Omitted when no extracted text is available. Expires at the same time as download_url. */
+    textUrl?: string;
+    /** Time at which download_url and text_url (when present) expire. Retrieve the attachment again to obtain fresh URLs. */
     expiresAt: Date;
 }

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

@@ -2,6 +2,7 @@ import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClie
 import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
 import * as core from "../../../../core/index.js";
 import * as AgentMail from "../../../index.js";
+import { AccountsClient } from "../resources/accounts/client/Client.js";
 import { ApiKeysClient } from "../resources/apiKeys/client/Client.js";
 import { DraftsClient } from "../resources/drafts/client/Client.js";
 import { EventsClient } from "../resources/events/client/Client.js";
@@ -25,6 +26,7 @@ export declare class InboxesClient {
     protected _metrics: MetricsClient | undefined;
     protected _events: EventsClient | undefined;
     protected _apiKeys: ApiKeysClient | undefined;
+    protected _accounts: AccountsClient | undefined;
     constructor(options?: InboxesClient.Options);
     get threads(): ThreadsClient;
     get messages(): MessagesClient;
@@ -34,6 +36,7 @@ export declare class InboxesClient {
     get metrics(): MetricsClient;
     get events(): EventsClient;
     get apiKeys(): ApiKeysClient;
+    get accounts(): AccountsClient;
     /**
      * **CLI:**
      * ```bash

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

@@ -52,49 +52,54 @@ const handleNonStatusCodeError_js_1 = require("../../../../errors/handleNonStatu
 const errors = __importStar(require("../../../../errors/index.js"));
 const serializers = __importStar(require("../../../../serialization/index.js"));
 const AgentMail = __importStar(require("../../../index.js"));
-const Client_js_1 = require("../resources/apiKeys/client/Client.js");
-const Client_js_2 = require("../resources/drafts/client/Client.js");
-const Client_js_3 = require("../resources/events/client/Client.js");
-const Client_js_4 = require("../resources/lists/client/Client.js");
-const Client_js_5 = require("../resources/messages/client/Client.js");
-const Client_js_6 = require("../resources/metrics/client/Client.js");
-const Client_js_7 = require("../resources/threads/client/Client.js");
-const Client_js_8 = require("../resources/webhooks/client/Client.js");
+const Client_js_1 = require("../resources/accounts/client/Client.js");
+const Client_js_2 = require("../resources/apiKeys/client/Client.js");
+const Client_js_3 = require("../resources/drafts/client/Client.js");
+const Client_js_4 = require("../resources/events/client/Client.js");
+const Client_js_5 = require("../resources/lists/client/Client.js");
+const Client_js_6 = require("../resources/messages/client/Client.js");
+const Client_js_7 = require("../resources/metrics/client/Client.js");
+const Client_js_8 = require("../resources/threads/client/Client.js");
+const Client_js_9 = require("../resources/webhooks/client/Client.js");
 class InboxesClient {
     constructor(options = {}) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     get threads() {
         var _a;
-        return ((_a = this._threads) !== null && _a !== void 0 ? _a : (this._threads = new Client_js_7.ThreadsClient(this._options)));
+        return ((_a = this._threads) !== null && _a !== void 0 ? _a : (this._threads = new Client_js_8.ThreadsClient(this._options)));
     }
     get messages() {
         var _a;
-        return ((_a = this._messages) !== null && _a !== void 0 ? _a : (this._messages = new Client_js_5.MessagesClient(this._options)));
+        return ((_a = this._messages) !== null && _a !== void 0 ? _a : (this._messages = new Client_js_6.MessagesClient(this._options)));
     }
     get drafts() {
         var _a;
-        return ((_a = this._drafts) !== null && _a !== void 0 ? _a : (this._drafts = new Client_js_2.DraftsClient(this._options)));
+        return ((_a = this._drafts) !== null && _a !== void 0 ? _a : (this._drafts = new Client_js_3.DraftsClient(this._options)));
     }
     get webhooks() {
         var _a;
-        return ((_a = this._webhooks) !== null && _a !== void 0 ? _a : (this._webhooks = new Client_js_8.WebhooksClient(this._options)));
+        return ((_a = this._webhooks) !== null && _a !== void 0 ? _a : (this._webhooks = new Client_js_9.WebhooksClient(this._options)));
     }
     get lists() {
         var _a;
-        return ((_a = this._lists) !== null && _a !== void 0 ? _a : (this._lists = new Client_js_4.ListsClient(this._options)));
+        return ((_a = this._lists) !== null && _a !== void 0 ? _a : (this._lists = new Client_js_5.ListsClient(this._options)));
     }
     get metrics() {
         var _a;
-        return ((_a = this._metrics) !== null && _a !== void 0 ? _a : (this._metrics = new Client_js_6.MetricsClient(this._options)));
+        return ((_a = this._metrics) !== null && _a !== void 0 ? _a : (this._metrics = new Client_js_7.MetricsClient(this._options)));
     }
     get events() {
         var _a;
-        return ((_a = this._events) !== null && _a !== void 0 ? _a : (this._events = new Client_js_3.EventsClient(this._options)));
+        return ((_a = this._events) !== null && _a !== void 0 ? _a : (this._events = new Client_js_4.EventsClient(this._options)));
     }
     get apiKeys() {
         var _a;
-        return ((_a = this._apiKeys) !== null && _a !== void 0 ? _a : (this._apiKeys = new Client_js_1.ApiKeysClient(this._options)));
+        return ((_a = this._apiKeys) !== null && _a !== void 0 ? _a : (this._apiKeys = new Client_js_2.ApiKeysClient(this._options)));
+    }
+    get accounts() {
+        var _a;
+        return ((_a = this._accounts) !== null && _a !== void 0 ? _a : (this._accounts = new Client_js_1.AccountsClient(this._options)));
     }
     /**
      * **CLI:**

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

@@ -0,0 +1,42 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../../../BaseClient.js";
+import * as core from "../../../../../../core/index.js";
+import * as AgentMail from "../../../../../index.js";
+export declare namespace AccountsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class AccountsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<AccountsClient.Options>;
+    constructor(options?: AccountsClient.Options);
+    /**
+     * Lists accounts held by the inbox, across all providers. Requires `inbox_read`.
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.inboxes.ListAccountsRequest} request
+     * @param {AccountsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     *
+     * @example
+     *     await client.inboxes.accounts.list("inbox_id")
+     */
+    list(inbox_id: AgentMail.inboxes.InboxId, request?: AgentMail.inboxes.ListAccountsRequest, requestOptions?: AccountsClient.RequestOptions): core.HttpResponsePromise<AgentMail.ListAccountsResponse>;
+    private __list;
+    /**
+     * Returns one account held by the inbox. An account elsewhere is a 404. Requires
+     * `inbox_read`.
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.AccountId} account_id
+     * @param {AccountsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.inboxes.accounts.get("inbox_id", "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32")
+     */
+    get(inbox_id: AgentMail.inboxes.InboxId, account_id: AgentMail.AccountId, requestOptions?: AccountsClient.RequestOptions): core.HttpResponsePromise<AgentMail.Account>;
+    private __get;
+}