agentmail 0.5.38 → 0.5.40

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.38",
-        "User-Agent": "agentmail/0.5.38",
+        "X-Fern-SDK-Version": "0.5.40",
+        "User-Agent": "agentmail/0.5.40",
         "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/apiKeys/types/ApiKeyPermissions.d.ts

@@ -93,4 +93,16 @@ export interface ApiKeyPermissions {
     podUpdate?: boolean;
     /** Delete pods. */
     podDelete?: boolean;
+    /** Read inbox calendar settings. */
+    calendarRead?: boolean;
+    /** Update inbox calendar settings. */
+    calendarUpdate?: boolean;
+    /** Read calendar events, and receive `calendar.event.*` webhook and WebSocket events. */
+    calendarEventRead?: boolean;
+    /** Create calendar events. */
+    calendarEventCreate?: boolean;
+    /** Update calendar events and respond to invitations. */
+    calendarEventUpdate?: boolean;
+    /** Delete calendar events. */
+    calendarEventDelete?: boolean;
 }

package/dist/cjs/api/resources/calendar/errors/EventExpiredError.d.ts

@@ -0,0 +1,6 @@
+import type * as core from "../../../../core/index.js";
+import * as errors from "../../../../errors/index.js";
+import type * as AgentMail from "../../../index.js";
+export declare class EventExpiredError extends errors.AgentMailError {
+    constructor(body: AgentMail.ErrorResponse, rawResponse?: core.RawResponse);
+}

package/dist/cjs/api/resources/calendar/errors/EventExpiredError.js

@@ -0,0 +1,54 @@
+"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.EventExpiredError = void 0;
+const errors = __importStar(require("../../../../errors/index.js"));
+class EventExpiredError extends errors.AgentMailError {
+    constructor(body, rawResponse) {
+        super({
+            message: "EventExpiredError",
+            statusCode: 410,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = this.constructor.name;
+    }
+}
+exports.EventExpiredError = EventExpiredError;

package/dist/cjs/api/resources/calendar/errors/ForbiddenError.d.ts

@@ -0,0 +1,6 @@
+import type * as core from "../../../../core/index.js";
+import * as errors from "../../../../errors/index.js";
+import type * as AgentMail from "../../../index.js";
+export declare class ForbiddenError extends errors.AgentMailError {
+    constructor(body: AgentMail.ErrorResponse, rawResponse?: core.RawResponse);
+}

package/dist/cjs/api/resources/calendar/errors/ForbiddenError.js

@@ -0,0 +1,54 @@
+"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.ForbiddenError = void 0;
+const errors = __importStar(require("../../../../errors/index.js"));
+class ForbiddenError extends errors.AgentMailError {
+    constructor(body, rawResponse) {
+        super({
+            message: "ForbiddenError",
+            statusCode: 403,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = this.constructor.name;
+    }
+}
+exports.ForbiddenError = ForbiddenError;

package/dist/cjs/api/resources/calendar/errors/PayloadTooLargeError.d.ts

@@ -0,0 +1,6 @@
+import type * as core from "../../../../core/index.js";
+import * as errors from "../../../../errors/index.js";
+import type * as AgentMail from "../../../index.js";
+export declare class PayloadTooLargeError extends errors.AgentMailError {
+    constructor(body: AgentMail.ErrorResponse, rawResponse?: core.RawResponse);
+}

package/dist/cjs/api/resources/calendar/errors/PayloadTooLargeError.js

@@ -0,0 +1,54 @@
+"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.PayloadTooLargeError = void 0;
+const errors = __importStar(require("../../../../errors/index.js"));
+class PayloadTooLargeError extends errors.AgentMailError {
+    constructor(body, rawResponse) {
+        super({
+            message: "PayloadTooLargeError",
+            statusCode: 413,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = this.constructor.name;
+    }
+}
+exports.PayloadTooLargeError = PayloadTooLargeError;

package/dist/cjs/api/resources/calendar/errors/PreconditionFailedError.d.ts

@@ -0,0 +1,6 @@
+import type * as core from "../../../../core/index.js";
+import * as errors from "../../../../errors/index.js";
+import type * as AgentMail from "../../../index.js";
+export declare class PreconditionFailedError extends errors.AgentMailError {
+    constructor(body: AgentMail.PreconditionFailedErrorResponse, rawResponse?: core.RawResponse);
+}

package/dist/cjs/api/resources/calendar/errors/PreconditionFailedError.js

@@ -0,0 +1,54 @@
+"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.PreconditionFailedError = void 0;
+const errors = __importStar(require("../../../../errors/index.js"));
+class PreconditionFailedError extends errors.AgentMailError {
+    constructor(body, rawResponse) {
+        super({
+            message: "PreconditionFailedError",
+            statusCode: 412,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = this.constructor.name;
+    }
+}
+exports.PreconditionFailedError = PreconditionFailedError;

package/dist/cjs/api/resources/calendar/errors/RateLimitError.d.ts

@@ -0,0 +1,6 @@
+import type * as core from "../../../../core/index.js";
+import * as errors from "../../../../errors/index.js";
+import type * as AgentMail from "../../../index.js";
+export declare class RateLimitError extends errors.AgentMailError {
+    constructor(body: AgentMail.ErrorResponse, rawResponse?: core.RawResponse);
+}

package/dist/cjs/api/resources/calendar/errors/RateLimitError.js

@@ -0,0 +1,54 @@
+"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.RateLimitError = void 0;
+const errors = __importStar(require("../../../../errors/index.js"));
+class RateLimitError extends errors.AgentMailError {
+    constructor(body, rawResponse) {
+        super({
+            message: "RateLimitError",
+            statusCode: 429,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = this.constructor.name;
+    }
+}
+exports.RateLimitError = RateLimitError;

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

@@ -0,0 +1,5 @@
+export * from "./EventExpiredError.js";
+export * from "./ForbiddenError.js";
+export * from "./PayloadTooLargeError.js";
+export * from "./PreconditionFailedError.js";
+export * from "./RateLimitError.js";

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

@@ -0,0 +1,21 @@
+"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("./EventExpiredError.js"), exports);
+__exportStar(require("./ForbiddenError.js"), exports);
+__exportStar(require("./PayloadTooLargeError.js"), exports);
+__exportStar(require("./PreconditionFailedError.js"), exports);
+__exportStar(require("./RateLimitError.js"), exports);

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

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

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

@@ -0,0 +1,18 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./index.js"), exports);

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

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

package/dist/cjs/api/resources/calendar/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("./errors/index.js"), exports);
+__exportStar(require("./types/index.js"), exports);

package/dist/cjs/api/resources/calendar/types/Attendee.d.ts

@@ -0,0 +1,18 @@
+import type * as AgentMail from "../../../index.js";
+export interface Attendee {
+    /** Email address of the attendee. Stored in lowercase. Must be unique within the event. */
+    email: string;
+    /** Display name of the attendee. At most 256 characters. */
+    name?: string;
+    /** Response status. Defaults to `needs_action`. */
+    status?: AgentMail.AttendeeStatus;
+    /** Defaults to `required`. */
+    role?: AgentMail.AttendeeRole;
+    /**
+     * Comment the attendee sent with their response. At most 4,096 UTF-8 bytes; on create or
+     * update, a longer comment is dropped rather than rejected.
+     */
+    comment?: string;
+    /** Time at which the attendee last responded. */
+    respondedAt?: Date;
+}

package/dist/cjs/api/resources/calendar/types/Attendee.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/calendar/types/AttendeeRole.d.ts

@@ -0,0 +1,6 @@
+/** Whether the attendee's presence is required. */
+export declare const AttendeeRole: {
+    readonly Required: "required";
+    readonly Optional: "optional";
+};
+export type AttendeeRole = (typeof AttendeeRole)[keyof typeof AttendeeRole];

package/dist/cjs/api/resources/calendar/types/AttendeeRole.js

@@ -0,0 +1,9 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttendeeRole = void 0;
+/** Whether the attendee's presence is required. */
+exports.AttendeeRole = {
+    Required: "required",
+    Optional: "optional",
+};

package/dist/cjs/api/resources/calendar/types/AttendeeStatus.d.ts

@@ -0,0 +1,8 @@
+/** The attendee's response to the invitation. */
+export declare const AttendeeStatus: {
+    readonly NeedsAction: "needs_action";
+    readonly Accepted: "accepted";
+    readonly Declined: "declined";
+    readonly Tentative: "tentative";
+};
+export type AttendeeStatus = (typeof AttendeeStatus)[keyof typeof AttendeeStatus];

package/dist/cjs/api/resources/calendar/types/AttendeeStatus.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.AttendeeStatus = void 0;
+/** The attendee's response to the invitation. */
+exports.AttendeeStatus = {
+    NeedsAction: "needs_action",
+    Accepted: "accepted",
+    Declined: "declined",
+    Tentative: "tentative",
+};

package/dist/cjs/api/resources/calendar/types/Calendar.d.ts

@@ -0,0 +1,24 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * An inbox's calendar. Every inbox has exactly one calendar; it exists from the moment the inbox
+ * does and is deleted with it.
+ */
+export interface Calendar {
+    inboxId: AgentMail.inboxes.InboxId;
+    /**
+     * Default time zone for events created without a `timezone`. Defaults to `UTC`. Changing it
+     * does not move existing events.
+     */
+    timezone: AgentMail.IanaTimezone;
+    /** Number of one-off and recurring events on the calendar. Each recurring event counts once. */
+    eventCount: number;
+    /** Time at which the calendar was created. The calendar exists from the moment the inbox does, so this is the inbox's creation time. */
+    createdAt: Date;
+    /** Time at which the calendar was last updated. */
+    updatedAt: Date;
+    /**
+     * The calendar's current version, also sent as the `ETag` response header. Send it in
+     * `If-Match` to make an update conditional.
+     */
+    etag: string;
+}

package/dist/cjs/api/resources/calendar/types/Calendar.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/calendar/types/CalendarConsistency.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Read consistency. `eventual` (default) reads from the region that serves your request and may
+ * lag a write made moments earlier by up to a few seconds. `primary` reads from the primary region
+ * and always reflects every completed write.
+ */
+export declare const CalendarConsistency: {
+    readonly Eventual: "eventual";
+    readonly Primary: "primary";
+};
+export type CalendarConsistency = (typeof CalendarConsistency)[keyof typeof CalendarConsistency];

package/dist/cjs/api/resources/calendar/types/CalendarConsistency.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.CalendarConsistency = void 0;
+/**
+ * Read consistency. `eventual` (default) reads from the region that serves your request and may
+ * lag a write made moments earlier by up to a few seconds. `primary` reads from the primary region
+ * and always reflects every completed write.
+ */
+exports.CalendarConsistency = {
+    Eventual: "eventual",
+    Primary: "primary",
+};

package/dist/cjs/api/resources/calendar/types/CalendarEvent.d.ts

@@ -0,0 +1,75 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * A calendar event. The same shape is used by every response, list item and webhook. `kind` says
+ * whether it is a one-off event, the definition of a recurring series, or one date of a series.
+ */
+export interface CalendarEvent {
+    eventId: AgentMail.CalendarEventId;
+    kind: AgentMail.CalendarEventKind;
+    /** For `instance` events, the UUID of the series this date belongs to. */
+    seriesId?: string;
+    /** For `instance` events, the date's start as the series rule generated it, before any edit. */
+    originalStart?: AgentMail.WallTime;
+    /** For `instance` events, `original_start` as a UTC instant. */
+    originalStartAt?: Date;
+    /** For `instance` events, `true` when this date was edited or moved, individually or by a `mode=future` change. */
+    isException?: boolean;
+    /** Title of the event. */
+    title: string;
+    /** Description of the event. Omitted from agenda and instance list items. */
+    description?: string;
+    /** Location of the event. */
+    location?: string;
+    /** Your own JSON value for the event, usually an object. Never sent to attendees. Omitted from agenda and instance list items. */
+    metadata?: unknown;
+    status: AgentMail.CalendarEventStatus;
+    /** Whether this is an all-day event. */
+    allDay: boolean;
+    /** Local start time in `timezone`. For all-day events, the first day. */
+    start: AgentMail.WallTime;
+    /** Local end time in `timezone`. For all-day events, the last day (inclusive). */
+    end: AgentMail.WallTime;
+    timezone: AgentMail.IanaTimezone;
+    durationMode: AgentMail.DurationMode;
+    /** Length of the event, in milliseconds for timed events and in days for all-day events. */
+    durationValue: number;
+    /** Start as a UTC instant. This is when `calendar.event.starting` is due. */
+    startAt: Date;
+    /** End as a UTC instant. This is when `calendar.event.ending` is due. */
+    endAt: Date;
+    /** For `series` events, the recurrence. */
+    recurrence?: AgentMail.Recurrence;
+    /** Attendees of the event. Omitted from agenda and instance list items; `attendee_count` is always present. */
+    attendees?: AgentMail.Attendee[];
+    /** Number of attendees. */
+    attendeeCount: number;
+    /** iCalendar UID of the event. Invitations about this event carry the same UID. */
+    uid: string;
+    /**
+     * iCalendar SEQUENCE number. It increases when a change to a one-off or series event affects
+     * what attendees see (time, status, title, description, location, recurrence or attendees).
+     * A change to a dated event increases it only when the change is sent with `send_invites`.
+     */
+    sequence: number;
+    source: AgentMail.CalendarEventSource;
+    /** Email address of the organizer. For `api` events, the inbox. */
+    organizerEmail?: string;
+    /** For `email` events, the ID of the message whose invitation last created or updated the event. */
+    originMessageId?: string;
+    /**
+     * Present on `single` and `series` events, except agenda items and
+     * `calendar.event.starting` and `calendar.event.ending` payloads, which omit it.
+     */
+    resourceRevision?: AgentMail.ResourceRevision;
+    /** Time at which the event (or, for a date, the definition governing it) was created. */
+    createdAt: Date;
+    /** Time at which the event (or, for a date, the definition governing it) was last updated. */
+    updatedAt: Date;
+    /**
+     * The event's or date's current version, also sent as the `ETag` response header. Send it in
+     * `If-Match` to make an update, delete or response conditional. Present on Get, Create,
+     * Update, Delete and Respond responses; list items and webhooks omit it. Treat it as opaque:
+     * a dated event's `etag` (`"occ-..."`) is not derived from `resource_revision`.
+     */
+    etag?: string;
+}

package/dist/cjs/api/resources/calendar/types/CalendarEvent.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/calendar/types/CalendarEventId.d.ts

@@ -0,0 +1,7 @@
+/**
+ * ID of a calendar event. A one-off or recurring event is addressed by its UUID. One date of a
+ * recurring event is addressed by a dated ID, `<uuid>_<slot>`: `<uuid>_t20261015T090000` for a
+ * timed date (the original wall-clock start in the event's time zone) or `<uuid>_d20261015` for an
+ * all-day date. Dated IDs are stable: moving a date keeps its original ID.
+ */
+export type CalendarEventId = string;

package/dist/cjs/api/resources/calendar/types/CalendarEventId.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });