agentmail 0.0.58 → 0.0.64

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

@@ -11,7 +11,7 @@ export declare namespace Threads {
         baseUrl?: core.Supplier<string>;
         apiKey?: core.Supplier<core.BearerToken | undefined>;
         /** Additional headers to include in requests. */
-        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+        headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
     }
     interface RequestOptions {
         /** The maximum time to wait for a response in seconds. */
@@ -23,7 +23,7 @@ export declare namespace Threads {
         /** Additional query string parameters to include in the request. */
         queryParams?: Record<string, unknown>;
         /** Additional headers to include in the request. */
-        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+        headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
     }
 }
 export declare class Threads {
@@ -56,5 +56,16 @@ export declare class Threads {
      */
     getAttachment(threadId: AgentMail.ThreadId, attachmentId: AgentMail.AttachmentId, requestOptions?: Threads.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
     private __getAttachment;
+    /**
+     * @param {AgentMail.ThreadId} threadId
+     * @param {Threads.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.threads.delete("thread_id")
+     */
+    delete(threadId: AgentMail.ThreadId, requestOptions?: Threads.RequestOptions): core.HttpResponsePromise<void>;
+    private __delete;
     protected _getAuthorizationHeader(): Promise<string>;
 }

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

@@ -56,7 +56,7 @@ export class Threads {
             if (ascending != null) {
                 _queryParams["ascending"] = ascending.toString();
             }
-            var _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), 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.Production).http, "/v0/threads"),
                 method: "GET",
@@ -128,7 +128,7 @@ export class Threads {
     __get(threadId, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
-            var _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), 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.Production).http, `/v0/threads/${encodeURIComponent(serializers.ThreadId.jsonOrThrow(threadId, { omitUndefined: true }))}`),
                 method: "GET",
@@ -194,7 +194,7 @@ export class Threads {
     __getAttachment(threadId, attachmentId, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
-            var _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), 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.Production).http, `/v0/threads/${encodeURIComponent(serializers.ThreadId.jsonOrThrow(threadId, { omitUndefined: true }))}/attachments/${encodeURIComponent(serializers.AttachmentId.jsonOrThrow(attachmentId, { omitUndefined: true }))}`),
                 method: "GET",
@@ -243,6 +243,69 @@ export class Threads {
             }
         });
     }
+    /**
+     * @param {AgentMail.ThreadId} threadId
+     * @param {Threads.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.NotFoundError}
+     *
+     * @example
+     *     await client.threads.delete("thread_id")
+     */
+    delete(threadId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__delete(threadId, requestOptions));
+    }
+    __delete(threadId, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), 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.Production).http, `/v0/threads/${encodeURIComponent(serializers.ThreadId.jsonOrThrow(threadId, { omitUndefined: true }))}`),
+                method: "DELETE",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: undefined, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new AgentMail.NotFoundError(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,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AgentMailError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AgentMailTimeoutError("Timeout exceeded when calling DELETE /v0/threads/{thread_id}.");
+                case "unknown":
+                    throw new errors.AgentMailError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     _getAuthorizationHeader() {
         return __awaiter(this, void 0, void 0, function* () {
             var _a;

package/dist/esm/api/resources/threads/types/Thread.d.mts

@@ -7,16 +7,18 @@ export interface Thread {
     threadId: AgentMail.ThreadId;
     labels: AgentMail.ThreadLabels;
     timestamp: AgentMail.ThreadTimestamp;
+    receivedTimestamp: AgentMail.ThreadReceivedTimestamp;
+    sentTimestamp: AgentMail.ThreadSentTimestamp;
     senders: AgentMail.ThreadSenders;
     recipients: AgentMail.ThreadRecipients;
     subject?: AgentMail.ThreadSubject;
     preview?: AgentMail.ThreadPreview;
     attachments?: AgentMail.ThreadAttachments;
+    lastMessageId: AgentMail.ThreadLastMessageId;
     messageCount: AgentMail.ThreadMessageCount;
+    size: AgentMail.ThreadSize;
+    updatedAt: AgentMail.ThreadUpdatedAt;
+    createdAt: AgentMail.ThreadCreatedAt;
     /** Messages in thread. Ordered by `timestamp` ascending. */
     messages: AgentMail.Message[];
-    /** Time at which thread was last updated. */
-    updatedAt: Date;
-    /** Time at which thread was created. */
-    createdAt: Date;
 }

package/dist/esm/api/resources/threads/types/ThreadCreatedAt.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Time at which thread was created.
+ */
+export type ThreadCreatedAt = Date;

package/dist/esm/api/resources/threads/types/ThreadCreatedAt.mjs

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

package/dist/esm/api/resources/threads/types/ThreadItem.d.mts

@@ -7,10 +7,16 @@ export interface ThreadItem {
     threadId: AgentMail.ThreadId;
     labels: AgentMail.ThreadLabels;
     timestamp: AgentMail.ThreadTimestamp;
+    receivedTimestamp: AgentMail.ThreadReceivedTimestamp;
+    sentTimestamp: AgentMail.ThreadSentTimestamp;
     senders: AgentMail.ThreadSenders;
     recipients: AgentMail.ThreadRecipients;
     subject?: AgentMail.ThreadSubject;
     preview?: AgentMail.ThreadPreview;
     attachments?: AgentMail.ThreadAttachments;
+    lastMessageId: AgentMail.ThreadLastMessageId;
     messageCount: AgentMail.ThreadMessageCount;
+    size: AgentMail.ThreadSize;
+    updatedAt: AgentMail.ThreadUpdatedAt;
+    createdAt: AgentMail.ThreadCreatedAt;
 }

package/dist/esm/api/resources/threads/types/ThreadLastMessageId.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * ID of last message in thread.
+ */
+export type ThreadLastMessageId = string;

package/dist/esm/api/resources/threads/types/ThreadLastMessageId.mjs

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

package/dist/esm/api/resources/threads/types/ThreadReceivedTimestamp.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Timestamp of last received message.
+ */
+export type ThreadReceivedTimestamp = Date;

package/dist/esm/api/resources/threads/types/ThreadReceivedTimestamp.mjs

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

package/dist/esm/api/resources/threads/types/ThreadSentTimestamp.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Timestamp of last sent message.
+ */
+export type ThreadSentTimestamp = Date;

package/dist/esm/api/resources/threads/types/ThreadSentTimestamp.mjs

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

package/dist/esm/api/resources/threads/types/ThreadSize.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Size of thread in bytes.
+ */
+export type ThreadSize = number;

package/dist/esm/api/resources/threads/types/ThreadSize.mjs

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

package/dist/esm/api/resources/threads/types/ThreadTimestamp.d.mts

@@ -2,6 +2,6 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 /**
- * Time at which last message was sent.
+ * Timestamp of last sent or received message.
  */
 export type ThreadTimestamp = Date;

package/dist/esm/api/resources/threads/types/ThreadUpdatedAt.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Time at which thread was last updated.
+ */
+export type ThreadUpdatedAt = Date;

package/dist/esm/api/resources/threads/types/ThreadUpdatedAt.mjs

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

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

@@ -1,12 +1,18 @@
 export * from "./ThreadId.mjs";
 export * from "./ThreadLabels.mjs";
 export * from "./ThreadTimestamp.mjs";
+export * from "./ThreadReceivedTimestamp.mjs";
+export * from "./ThreadSentTimestamp.mjs";
 export * from "./ThreadSenders.mjs";
 export * from "./ThreadRecipients.mjs";
 export * from "./ThreadSubject.mjs";
 export * from "./ThreadPreview.mjs";
 export * from "./ThreadAttachments.mjs";
+export * from "./ThreadLastMessageId.mjs";
 export * from "./ThreadMessageCount.mjs";
+export * from "./ThreadSize.mjs";
+export * from "./ThreadUpdatedAt.mjs";
+export * from "./ThreadCreatedAt.mjs";
 export * from "./ThreadItem.mjs";
 export * from "./Thread.mjs";
 export * from "./ListThreadsResponse.mjs";

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

@@ -1,12 +1,18 @@
 export * from "./ThreadId.mjs";
 export * from "./ThreadLabels.mjs";
 export * from "./ThreadTimestamp.mjs";
+export * from "./ThreadReceivedTimestamp.mjs";
+export * from "./ThreadSentTimestamp.mjs";
 export * from "./ThreadSenders.mjs";
 export * from "./ThreadRecipients.mjs";
 export * from "./ThreadSubject.mjs";
 export * from "./ThreadPreview.mjs";
 export * from "./ThreadAttachments.mjs";
+export * from "./ThreadLastMessageId.mjs";
 export * from "./ThreadMessageCount.mjs";
+export * from "./ThreadSize.mjs";
+export * from "./ThreadUpdatedAt.mjs";
+export * from "./ThreadCreatedAt.mjs";
 export * from "./ThreadItem.mjs";
 export * from "./Thread.mjs";
 export * from "./ListThreadsResponse.mjs";

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

@@ -11,7 +11,7 @@ export declare namespace Webhooks {
         baseUrl?: core.Supplier<string>;
         apiKey?: core.Supplier<core.BearerToken | undefined>;
         /** Additional headers to include in requests. */
-        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+        headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
     }
     interface RequestOptions {
         /** The maximum time to wait for a response in seconds. */
@@ -23,7 +23,7 @@ export declare namespace Webhooks {
         /** Additional query string parameters to include in the request. */
         queryParams?: Record<string, unknown>;
         /** Additional headers to include in the request. */
-        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+        headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
     }
 }
 export declare class Webhooks {

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

@@ -41,7 +41,7 @@ export class Webhooks {
             if (pageToken != null) {
                 _queryParams["page_token"] = pageToken;
             }
-            var _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), 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.Production).http, "/v0/webhooks"),
                 method: "GET",
@@ -102,7 +102,7 @@ export class Webhooks {
     __get(webhookId, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
-            var _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), 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.Production).http, `/v0/webhooks/${encodeURIComponent(serializers.webhooks.WebhookId.jsonOrThrow(webhookId, { omitUndefined: true }))}`),
                 method: "GET",
@@ -179,7 +179,7 @@ export class Webhooks {
     __create(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
-            var _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), 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.Production).http, "/v0/webhooks"),
                 method: "POST",
@@ -257,7 +257,7 @@ export class Webhooks {
     __delete(webhookId, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
-            var _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), 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.Production).http, `/v0/webhooks/${encodeURIComponent(serializers.webhooks.WebhookId.jsonOrThrow(webhookId, { omitUndefined: true }))}`),
                 method: "DELETE",

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

@@ -11,7 +11,7 @@ export declare namespace Websockets {
         baseUrl?: core.Supplier<string>;
         apiKey?: core.Supplier<core.BearerToken | undefined>;
         /** Additional headers to include in requests. */
-        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+        headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
     }
     interface ConnectArgs {
         authToken?: string | undefined;

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

@@ -12,6 +12,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import * as environments from "../../../../environments.mjs";
 import * as core from "../../../../core/index.mjs";
+import { mergeOnlyDefinedHeaders, mergeHeaders } from "../../../../core/headers.mjs";
 import { WebsocketsSocket } from "./Socket.mjs";
 import * as errors from "../../../../errors/index.mjs";
 export class Websockets {
@@ -26,7 +27,7 @@ export class Websockets {
             if (authToken != null) {
                 _queryParams["auth_token"] = authToken;
             }
-            let _headers = Object.assign({}, headers);
+            let _headers = mergeHeaders(mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), headers);
             const socket = new core.ReconnectingWebSocket({
                 url: core.url.join((_a = (yield core.Supplier.get(this._options["baseUrl"]))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options["environment"]))) !== null && _b !== void 0 ? _b : environments.AgentMailEnvironment.Production).websockets, "/v0"),
                 protocols: [],

package/dist/esm/core/fetcher/Fetcher.d.mts

@@ -6,7 +6,7 @@ export declare namespace Fetcher {
         url: string;
         method: string;
         contentType?: string;
-        headers?: Record<string, string | Supplier<string | undefined> | undefined>;
+        headers?: Record<string, string | Supplier<string | null | undefined> | null | undefined>;
         queryParameters?: Record<string, unknown>;
         body?: unknown;
         timeoutMs?: number;

package/dist/esm/core/fetcher/requestWithRetries.mjs

@@ -11,21 +11,57 @@ const INITIAL_RETRY_DELAY = 1000; // in milliseconds
 const MAX_RETRY_DELAY = 60000; // in milliseconds
 const DEFAULT_MAX_RETRIES = 2;
 const JITTER_FACTOR = 0.2; // 20% random jitter
-function addJitter(delay) {
-    // Generate a random value between -JITTER_FACTOR and +JITTER_FACTOR
-    const jitterMultiplier = 1 + (Math.random() * 2 - 1) * JITTER_FACTOR;
+function addPositiveJitter(delay) {
+    // Generate a random value between 0 and +JITTER_FACTOR
+    const jitterMultiplier = 1 + Math.random() * JITTER_FACTOR;
     return delay * jitterMultiplier;
 }
+function addSymmetricJitter(delay) {
+    // Generate a random value in a JITTER_FACTOR-sized percentage range around delay
+    const jitterMultiplier = 1 + (Math.random() - 0.5) * JITTER_FACTOR;
+    return delay * jitterMultiplier;
+}
+function getRetryDelayFromHeaders(response, retryAttempt) {
+    // Check for Retry-After header first (RFC 7231), with no jitter
+    const retryAfter = response.headers.get("Retry-After");
+    if (retryAfter) {
+        // Parse as number of seconds...
+        const retryAfterSeconds = parseInt(retryAfter, 10);
+        if (!isNaN(retryAfterSeconds) && retryAfterSeconds > 0) {
+            return Math.min(retryAfterSeconds * 1000, MAX_RETRY_DELAY);
+        }
+        // ...or as an HTTP date; both are valid
+        const retryAfterDate = new Date(retryAfter);
+        if (!isNaN(retryAfterDate.getTime())) {
+            const delay = retryAfterDate.getTime() - Date.now();
+            if (delay > 0) {
+                return Math.min(Math.max(delay, 0), MAX_RETRY_DELAY);
+            }
+        }
+    }
+    // Then check for industry-standard X-RateLimit-Reset header, with positive jitter
+    const rateLimitReset = response.headers.get("X-RateLimit-Reset");
+    if (rateLimitReset) {
+        const resetTime = parseInt(rateLimitReset, 10);
+        if (!isNaN(resetTime)) {
+            // Assume Unix timestamp in epoch seconds
+            const delay = resetTime * 1000 - Date.now();
+            if (delay > 0) {
+                return addPositiveJitter(Math.min(delay, MAX_RETRY_DELAY));
+            }
+        }
+    }
+    // Fall back to exponential backoff, with symmetric jitter
+    return addSymmetricJitter(Math.min(INITIAL_RETRY_DELAY * Math.pow(2, retryAttempt), MAX_RETRY_DELAY));
+}
 export function requestWithRetries(requestFn_1) {
     return __awaiter(this, arguments, void 0, function* (requestFn, maxRetries = DEFAULT_MAX_RETRIES) {
         let response = yield requestFn();
         for (let i = 0; i < maxRetries; ++i) {
             if ([408, 429].includes(response.status) || response.status >= 500) {
-                // Calculate base delay using exponential backoff (in milliseconds)
-                const baseDelay = Math.min(INITIAL_RETRY_DELAY * Math.pow(2, i), MAX_RETRY_DELAY);
-                // Add jitter to the delay
-                const delayWithJitter = addJitter(baseDelay);
-                yield new Promise((resolve) => setTimeout(resolve, delayWithJitter));
+                // Get delay with appropriate jitter applied
+                const delay = getRetryDelayFromHeaders(response, i);
+                yield new Promise((resolve) => setTimeout(resolve, delay));
                 response = yield requestFn();
             }
             else {

package/dist/esm/core/headers.d.mts

@@ -1,3 +1,3 @@
 import * as core from "./index.mjs";
-export declare function mergeHeaders(...headersArray: (Record<string, string | core.Supplier<string | undefined> | undefined> | undefined)[]): Record<string, string | core.Supplier<string | undefined>>;
-export declare function mergeOnlyDefinedHeaders(...headersArray: (Record<string, string | core.Supplier<string | undefined> | undefined> | undefined)[]): Record<string, string | core.Supplier<string | undefined>>;
+export declare function mergeHeaders(...headersArray: (Record<string, string | core.Supplier<string | null | undefined> | null | undefined> | null | undefined)[]): Record<string, string | core.Supplier<string | null | undefined>>;
+export declare function mergeOnlyDefinedHeaders(...headersArray: (Record<string, string | core.Supplier<string | null | undefined> | null | undefined> | null | undefined)[]): Record<string, string | core.Supplier<string | null | undefined>>;

package/dist/esm/core/websocket/ws.d.mts

@@ -7,7 +7,7 @@ export declare namespace ReconnectingWebSocket {
         url: string;
         protocols?: string | string[];
         options?: ReconnectingWebSocket.Options;
-        headers?: Record<string, string>;
+        headers?: Record<string, unknown>;
         queryParameters?: Record<string, string | string[] | object | object[] | null | undefined>;
     }
     type Options = {

package/dist/esm/serialization/resources/messages/types/Message.d.mts

@@ -18,6 +18,11 @@ import { MessagePreview } from "./MessagePreview.mjs";
 import { MessageText } from "./MessageText.mjs";
 import { MessageHtml } from "./MessageHtml.mjs";
 import { MessageAttachments } from "./MessageAttachments.mjs";
+import { MessageInReplyTo } from "./MessageInReplyTo.mjs";
+import { MessageReferences } from "./MessageReferences.mjs";
+import { MessageSize } from "./MessageSize.mjs";
+import { MessageUpdatedAt } from "./MessageUpdatedAt.mjs";
+import { MessageCreatedAt } from "./MessageCreatedAt.mjs";
 export declare const Message: core.serialization.ObjectSchema<serializers.Message.Raw, AgentMail.Message>;
 export declare namespace Message {
     interface Raw {
@@ -36,9 +41,10 @@ export declare namespace Message {
         text?: MessageText.Raw | null;
         html?: MessageHtml.Raw | null;
         attachments?: MessageAttachments.Raw | null;
-        in_reply_to?: string | null;
-        references?: string[] | null;
-        updated_at: string;
-        created_at: string;
+        in_reply_to?: MessageInReplyTo.Raw | null;
+        references?: MessageReferences.Raw | null;
+        size: MessageSize.Raw;
+        updated_at: MessageUpdatedAt.Raw;
+        created_at: MessageCreatedAt.Raw;
     }
 }

package/dist/esm/serialization/resources/messages/types/Message.mjs

@@ -16,6 +16,11 @@ import { MessagePreview } from "./MessagePreview.mjs";
 import { MessageText } from "./MessageText.mjs";
 import { MessageHtml } from "./MessageHtml.mjs";
 import { MessageAttachments } from "./MessageAttachments.mjs";
+import { MessageInReplyTo } from "./MessageInReplyTo.mjs";
+import { MessageReferences } from "./MessageReferences.mjs";
+import { MessageSize } from "./MessageSize.mjs";
+import { MessageUpdatedAt } from "./MessageUpdatedAt.mjs";
+import { MessageCreatedAt } from "./MessageCreatedAt.mjs";
 export const Message = core.serialization.object({
     inboxId: core.serialization.property("inbox_id", InboxId),
     threadId: core.serialization.property("thread_id", ThreadId),
@@ -32,8 +37,9 @@ export const Message = core.serialization.object({
     text: MessageText.optional(),
     html: MessageHtml.optional(),
     attachments: MessageAttachments.optional(),
-    inReplyTo: core.serialization.property("in_reply_to", core.serialization.string().optional()),
-    references: core.serialization.list(core.serialization.string()).optional(),
-    updatedAt: core.serialization.property("updated_at", core.serialization.date()),
-    createdAt: core.serialization.property("created_at", core.serialization.date()),
+    inReplyTo: core.serialization.property("in_reply_to", MessageInReplyTo.optional()),
+    references: MessageReferences.optional(),
+    size: MessageSize,
+    updatedAt: core.serialization.property("updated_at", MessageUpdatedAt),
+    createdAt: core.serialization.property("created_at", MessageCreatedAt),
 });

package/dist/esm/serialization/resources/messages/types/MessageCreatedAt.d.mts

@@ -0,0 +1,10 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as serializers from "../../../index.mjs";
+import * as AgentMail from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+export declare const MessageCreatedAt: core.serialization.Schema<serializers.MessageCreatedAt.Raw, AgentMail.MessageCreatedAt>;
+export declare namespace MessageCreatedAt {
+    type Raw = string;
+}

package/dist/esm/serialization/resources/messages/types/MessageCreatedAt.mjs

@@ -0,0 +1,5 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as core from "../../../../core/index.mjs";
+export const MessageCreatedAt = core.serialization.date();

package/dist/esm/serialization/resources/messages/types/MessageInReplyTo.d.mts

@@ -0,0 +1,10 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as serializers from "../../../index.mjs";
+import * as AgentMail from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+export declare const MessageInReplyTo: core.serialization.Schema<serializers.MessageInReplyTo.Raw, AgentMail.MessageInReplyTo>;
+export declare namespace MessageInReplyTo {
+    type Raw = string;
+}

package/dist/esm/serialization/resources/messages/types/MessageInReplyTo.mjs

@@ -0,0 +1,5 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as core from "../../../../core/index.mjs";
+export const MessageInReplyTo = core.serialization.string();

package/dist/esm/serialization/resources/messages/types/MessageItem.d.mts

@@ -16,6 +16,11 @@ import { MessageBcc } from "./MessageBcc.mjs";
 import { MessageSubject } from "./MessageSubject.mjs";
 import { MessagePreview } from "./MessagePreview.mjs";
 import { MessageAttachments } from "./MessageAttachments.mjs";
+import { MessageInReplyTo } from "./MessageInReplyTo.mjs";
+import { MessageReferences } from "./MessageReferences.mjs";
+import { MessageSize } from "./MessageSize.mjs";
+import { MessageUpdatedAt } from "./MessageUpdatedAt.mjs";
+import { MessageCreatedAt } from "./MessageCreatedAt.mjs";
 export declare const MessageItem: core.serialization.ObjectSchema<serializers.MessageItem.Raw, AgentMail.MessageItem>;
 export declare namespace MessageItem {
     interface Raw {
@@ -31,5 +36,10 @@ export declare namespace MessageItem {
         subject?: MessageSubject.Raw | null;
         preview?: MessagePreview.Raw | null;
         attachments?: MessageAttachments.Raw | null;
+        in_reply_to?: MessageInReplyTo.Raw | null;
+        references?: MessageReferences.Raw | null;
+        size: MessageSize.Raw;
+        updated_at: MessageUpdatedAt.Raw;
+        created_at: MessageCreatedAt.Raw;
     }
 }