agentmail 0.5.45 → 0.5.46

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.45",
-        "User-Agent": "agentmail/0.5.45",
+        "X-Fern-SDK-Version": "0.5.46",
+        "User-Agent": "agentmail/0.5.46",
         "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/agentArmor/types/AgentArmorCompleteResult.d.ts

@@ -7,4 +7,6 @@ export interface AgentArmorCompleteResult {
     model: string;
     /** When the scan finished. */
     completedAt: Date;
+    /** Present on a `review` held in hold mode that someone released. */
+    manualOverride?: AgentMail.AgentArmorManualOverride;
 }

package/dist/cjs/api/resources/agentArmor/types/AgentArmorCompletedEventResult.d.ts

@@ -1,6 +1,6 @@
 import type * as AgentMail from "../../../index.js";
 /**
- * The result in a `message.security.completed` event, which is always `complete`.
+ * The result in a `message.security.completed` or `message.security.review` event, which is always `complete`.
  */
 export interface AgentArmorCompletedEventResult extends AgentMail.AgentArmorCompleteResult {
     status: "complete";

package/dist/cjs/api/resources/agentArmor/types/AgentArmorManualOverride.d.ts

@@ -0,0 +1,15 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * The record of a release of a message Agent Armor held for review.
+ */
+export interface AgentArmorManualOverride {
+    /** ID of the release, and the `event_id` of its `message.security.override` event. */
+    overrideId: string;
+    actor: AgentMail.AgentArmorReleaseActor;
+    /** Why it was released, as given by whoever released it. */
+    reason: string;
+    /** The verdict that held the message. */
+    originalVerdict: "review";
+    /** When it was released. */
+    releasedAt: Date;
+}

package/dist/cjs/api/resources/agentArmor/types/AgentArmorManualOverride.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/agentArmor/types/AgentArmorReleaseActor.d.ts

@@ -0,0 +1,13 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * Who released the message.
+ */
+export type AgentArmorReleaseActor = AgentMail.AgentArmorReleaseActor.ApiKey | AgentMail.AgentArmorReleaseActor.Console;
+export declare namespace AgentArmorReleaseActor {
+    interface ApiKey extends AgentMail.AgentArmorReleaseApiKeyActor {
+        kind: "api_key";
+    }
+    interface Console extends AgentMail.AgentArmorReleaseConsoleActor {
+        kind: "console";
+    }
+}

package/dist/cjs/api/resources/agentArmor/types/AgentArmorReleaseActor.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/agentArmor/types/AgentArmorReleaseApiKeyActor.d.ts

@@ -0,0 +1,4 @@
+export interface AgentArmorReleaseApiKeyActor {
+    /** The API key that released it. */
+    apiKeyId: string;
+}

package/dist/cjs/api/resources/agentArmor/types/AgentArmorReleaseApiKeyActor.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/agentArmor/types/AgentArmorReleaseConsoleActor.d.ts

@@ -0,0 +1 @@
+export type AgentArmorReleaseConsoleActor = {};

package/dist/cjs/api/resources/agentArmor/types/AgentArmorReleaseConsoleActor.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/agentArmor/types/ReleaseAgentArmorMessageRequest.d.ts

@@ -0,0 +1,4 @@
+export interface ReleaseAgentArmorMessageRequest {
+    /** Why the message is safe to release, up to 2,048 characters and not blank. Recorded on the message. */
+    reason: string;
+}

package/dist/cjs/api/resources/agentArmor/types/ReleaseAgentArmorMessageRequest.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/agentArmor/types/ReleaseAgentArmorMessageResponse.d.ts

@@ -0,0 +1,4 @@
+import type * as AgentMail from "../../../index.js";
+export interface ReleaseAgentArmorMessageResponse {
+    manualOverride: AgentMail.AgentArmorManualOverride;
+}

package/dist/cjs/api/resources/agentArmor/types/ReleaseAgentArmorMessageResponse.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/agentArmor/types/index.d.ts

@@ -5,9 +5,15 @@ export * from "./AgentArmorFeedbackActor.js";
 export * from "./AgentArmorFeedbackApiKeyActor.js";
 export * from "./AgentArmorFeedbackConsoleActor.js";
 export * from "./AgentArmorFeedbackValue.js";
+export * from "./AgentArmorManualOverride.js";
 export * from "./AgentArmorPendingResult.js";
+export * from "./AgentArmorReleaseActor.js";
+export * from "./AgentArmorReleaseApiKeyActor.js";
+export * from "./AgentArmorReleaseConsoleActor.js";
 export * from "./AgentArmorResult.js";
 export * from "./AgentArmorUnavailableReason.js";
 export * from "./AgentArmorUnavailableResult.js";
 export * from "./AgentArmorVerdict.js";
 export * from "./CreateAgentArmorFeedbackRequest.js";
+export * from "./ReleaseAgentArmorMessageRequest.js";
+export * from "./ReleaseAgentArmorMessageResponse.js";

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

@@ -21,9 +21,15 @@ __exportStar(require("./AgentArmorFeedbackActor.js"), exports);
 __exportStar(require("./AgentArmorFeedbackApiKeyActor.js"), exports);
 __exportStar(require("./AgentArmorFeedbackConsoleActor.js"), exports);
 __exportStar(require("./AgentArmorFeedbackValue.js"), exports);
+__exportStar(require("./AgentArmorManualOverride.js"), exports);
 __exportStar(require("./AgentArmorPendingResult.js"), exports);
+__exportStar(require("./AgentArmorReleaseActor.js"), exports);
+__exportStar(require("./AgentArmorReleaseApiKeyActor.js"), exports);
+__exportStar(require("./AgentArmorReleaseConsoleActor.js"), exports);
 __exportStar(require("./AgentArmorResult.js"), exports);
 __exportStar(require("./AgentArmorUnavailableReason.js"), exports);
 __exportStar(require("./AgentArmorUnavailableResult.js"), exports);
 __exportStar(require("./AgentArmorVerdict.js"), exports);
 __exportStar(require("./CreateAgentArmorFeedbackRequest.js"), exports);
+__exportStar(require("./ReleaseAgentArmorMessageRequest.js"), exports);
+__exportStar(require("./ReleaseAgentArmorMessageResponse.js"), exports);

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

@@ -20,6 +20,11 @@ export interface ApiKeyPermissions {
     messageUpdate?: boolean;
     /** Delete messages. Also required to delete threads. */
     messageDelete?: boolean;
+    /**
+     * Release mail Agent Armor holds for review. Opt-in: no key has it unless it was granted explicitly, even one
+     * without a `permissions` object. See [Permissions](/permissions#agent-armor).
+     */
+    agentArmorRelease?: boolean;
     /** Access messages labeled spam. */
     labelSpamRead?: boolean;
     /** Access messages labeled blocked. */
@@ -105,4 +110,12 @@ export interface ApiKeyPermissions {
     calendarEventUpdate?: boolean;
     /** Delete calendar events. */
     calendarEventDelete?: boolean;
+    /** List and get Agent Drive files, with their download URLs. */
+    fileRead?: boolean;
+    /** Upload Agent Drive files (Create File and Complete File). */
+    fileCreate?: boolean;
+    /** Update Agent Drive files. Reserved; no endpoint uses it yet. */
+    fileUpdate?: boolean;
+    /** Delete Agent Drive files. */
+    fileDelete?: boolean;
 }

package/dist/cjs/api/resources/events/types/EventType.d.ts

@@ -4,6 +4,8 @@ export declare const EventType: {
     readonly MessageReceivedBlocked: "message.received.blocked";
     readonly MessageReceivedUnauthenticated: "message.received.unauthenticated";
     readonly MessageSecurityCompleted: "message.security.completed";
+    readonly MessageSecurityReview: "message.security.review";
+    readonly MessageSecurityOverride: "message.security.override";
     readonly MessageSent: "message.sent";
     readonly MessageDelivered: "message.delivered";
     readonly MessageBounced: "message.bounced";

package/dist/cjs/api/resources/events/types/EventType.js

@@ -8,6 +8,8 @@ exports.EventType = {
     MessageReceivedBlocked: "message.received.blocked",
     MessageReceivedUnauthenticated: "message.received.unauthenticated",
     MessageSecurityCompleted: "message.security.completed",
+    MessageSecurityReview: "message.security.review",
+    MessageSecurityOverride: "message.security.override",
     MessageSent: "message.sent",
     MessageDelivered: "message.delivered",
     MessageBounced: "message.bounced",

package/dist/cjs/api/resources/events/types/MessageSecurityCompletedEvent.d.ts

@@ -1,8 +1,9 @@
 import type * as AgentMail from "../../../index.js";
 /**
- * Agent Armor reached a verdict on a received message. Sent only for `complete` results: an `unavailable` result
- * sends no event. Sent once per message and inbox; `event_id` is stable, so use it to deduplicate. Not sent for
- * messages labeled `spam`, `blocked`, `unauthenticated`, or `trash`: read those through the API.
+ * Agent Armor reached a verdict on a received message. Sent only in monitor mode, and only for `complete` results:
+ * an `unavailable` result sends no event. Sent once per message and inbox; `event_id` is stable, so use it to
+ * deduplicate. Not sent for messages labeled `spam`, `blocked`, `unauthenticated`, or `trash`: read those through
+ * the API.
  */
 export interface MessageSecurityCompletedEvent {
     type: "event";

package/dist/cjs/api/resources/events/types/MessageSecurityOverride.d.ts

@@ -0,0 +1,10 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * The message someone released, and the record of the release. Fetch the message for its content.
+ */
+export interface MessageSecurityOverride {
+    organizationId: AgentMail.OrganizationId;
+    inboxId: AgentMail.inboxes.InboxId;
+    messageId: AgentMail.MessageId;
+    manualOverride: AgentMail.AgentArmorManualOverride;
+}

package/dist/cjs/api/resources/events/types/MessageSecurityOverride.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/events/types/MessageSecurityOverrideEvent.d.ts

@@ -0,0 +1,13 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * Someone released a message Agent Armor held for review. Its `message.received` is sent to your agents as well,
+ * and the two can arrive in either order.
+ * Sent once per message and inbox; `event_id` is stable. Not sent for messages labeled `spam`, `blocked`,
+ * `unauthenticated`, or `trash`.
+ */
+export interface MessageSecurityOverrideEvent {
+    type: "event";
+    eventType: "message.security.override";
+    eventId: AgentMail.EventId;
+    message: AgentMail.MessageSecurityOverride;
+}

package/dist/cjs/api/resources/events/types/MessageSecurityOverrideEvent.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/events/types/MessageSecurityReviewEvent.d.ts

@@ -0,0 +1,13 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * In hold mode, Agent Armor held a received message for review: your agents are not sent its `message.received`
+ * until someone releases it. The message carries the `agent-armor-held` label until then. Sent once per message and
+ * inbox; `event_id` is stable. Not sent for messages labeled `spam`, `blocked`, `unauthenticated`, or `trash`: list
+ * held mail by the `agent-armor-held` label instead.
+ */
+export interface MessageSecurityReviewEvent {
+    type: "event";
+    eventType: "message.security.review";
+    eventId: AgentMail.EventId;
+    message: AgentMail.MessageSecurity;
+}

package/dist/cjs/api/resources/events/types/MessageSecurityReviewEvent.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/events/types/index.d.ts

@@ -22,6 +22,9 @@ export * from "./MessageReceivedEventType.js";
 export * from "./MessageRejectedEvent.js";
 export * from "./MessageSecurity.js";
 export * from "./MessageSecurityCompletedEvent.js";
+export * from "./MessageSecurityOverride.js";
+export * from "./MessageSecurityOverrideEvent.js";
+export * from "./MessageSecurityReviewEvent.js";
 export * from "./MessageSentEvent.js";
 export * from "./Open.js";
 export * from "./PodIds.js";

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

@@ -38,6 +38,9 @@ __exportStar(require("./MessageReceivedEventType.js"), exports);
 __exportStar(require("./MessageRejectedEvent.js"), exports);
 __exportStar(require("./MessageSecurity.js"), exports);
 __exportStar(require("./MessageSecurityCompletedEvent.js"), exports);
+__exportStar(require("./MessageSecurityOverride.js"), exports);
+__exportStar(require("./MessageSecurityOverrideEvent.js"), exports);
+__exportStar(require("./MessageSecurityReviewEvent.js"), exports);
 __exportStar(require("./MessageSentEvent.js"), exports);
 __exportStar(require("./Open.js"), exports);
 __exportStar(require("./PodIds.js"), exports);

package/dist/cjs/api/resources/files/errors/FileForbiddenError.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 FileForbiddenError extends errors.AgentMailError {
+    constructor(body: AgentMail.ErrorResponse, rawResponse?: core.RawResponse);
+}

package/dist/cjs/api/resources/files/errors/FileForbiddenError.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.FileForbiddenError = void 0;
+const errors = __importStar(require("../../../../errors/index.js"));
+class FileForbiddenError extends errors.AgentMailError {
+    constructor(body, rawResponse) {
+        super({
+            message: "FileForbiddenError",
+            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.FileForbiddenError = FileForbiddenError;

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

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

package/dist/cjs/api/resources/files/errors/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("./FileForbiddenError.js"), exports);

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

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

package/dist/cjs/api/resources/files/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/files/index.d.ts

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

package/dist/cjs/api/resources/files/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/files/types/CreateFileRequest.d.ts

@@ -0,0 +1,12 @@
+import type * as AgentMail from "../../../index.js";
+export interface CreateFileRequest {
+    path: AgentMail.FilePath;
+    size: AgentMail.FileSize;
+    sha256: AgentMail.FileSha256;
+    contentType?: AgentMail.FileContentType;
+    /**
+     * When the file expires, in the future. Rounded up to a whole second and returned in UTC. On a retry, send
+     * the `expires_at` the first response returned.
+     */
+    expiresAt?: AgentMail.FileExpiresAt;
+}

package/dist/cjs/api/resources/files/types/CreateFileRequest.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/files/types/CreateFileResponse.d.ts

@@ -0,0 +1,7 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * The created file. A pending file carries `upload`; a create that returns an existing `ready` file does not.
+ */
+export interface CreateFileResponse extends AgentMail.File_ {
+    upload?: AgentMail.FileUpload;
+}

package/dist/cjs/api/resources/files/types/CreateFileResponse.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/files/types/FileContentType.d.ts

@@ -0,0 +1,4 @@
+/**
+ * The file's MIME type, such as `application/pdf`. Defaults to `application/octet-stream`.
+ */
+export type FileContentType = string;

package/dist/cjs/api/resources/files/types/FileContentType.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/files/types/FileExpiresAt.d.ts

@@ -0,0 +1,5 @@
+/**
+ * When the file expires. After it, the file is gone from get and list and its path is free; its bytes are
+ * deleted soon after. Absent for a file that never expires.
+ */
+export type FileExpiresAt = Date;

package/dist/cjs/api/resources/files/types/FileExpiresAt.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/files/types/FileId.d.ts

@@ -0,0 +1,4 @@
+/**
+ * ID of the file. A UUID.
+ */
+export type FileId = string;

package/dist/cjs/api/resources/files/types/FileId.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/files/types/FileItem.d.ts

@@ -0,0 +1,20 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * A file, as a list returns it.
+ */
+export interface FileItem {
+    fileId: AgentMail.FileId;
+    inboxId: AgentMail.inboxes.InboxId;
+    email: AgentMail.inboxes.Email;
+    path: AgentMail.FilePath;
+    name: AgentMail.FileName;
+    size: AgentMail.FileSize;
+    contentType: AgentMail.FileContentType;
+    sha256: AgentMail.FileSha256;
+    status: AgentMail.FileStatus;
+    /** When the file was created. */
+    createdAt: Date;
+    /** When the file last changed, such as when its upload was completed. */
+    updatedAt: Date;
+    expiresAt?: AgentMail.FileExpiresAt;
+}

package/dist/cjs/api/resources/files/types/FileItem.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/files/types/FileName.d.ts

@@ -0,0 +1,4 @@
+/**
+ * The path's last segment. A download saves under this name.
+ */
+export type FileName = string;

package/dist/cjs/api/resources/files/types/FileName.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/files/types/FilePath.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Where the file lives in its inbox's drive, such as `reports/q3.pdf`. Unique within the inbox. Segments are
+ * separated by `/`, with no leading or trailing `/`, no empty, `.` or `..` segment, no `\` and no control or
+ * invisible characters. At most 1,024 bytes, and at most 255 bytes per segment. Stored in Unicode NFC, so two
+ * spellings of one name are one path. Case is kept.
+ */
+export type FilePath = string;

package/dist/cjs/api/resources/files/types/FilePath.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/files/types/FileSha256.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The base64 encoding of the file's 32-byte SHA-256 digest, as S3's `x-amz-checksum-sha256` takes it (44
+ * characters, ending in `=`). S3 refuses an upload whose bytes don't match.
+ */
+export type FileSha256 = string;

package/dist/cjs/api/resources/files/types/FileSha256.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/files/types/FileSize.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Size of the file in bytes. At most 104,857,600 (100 MiB).
+ */
+export type FileSize = number;

package/dist/cjs/api/resources/files/types/FileSize.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/files/types/FileStatus.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `pending` until its bytes are uploaded and the upload is completed, then `ready`. Only a `ready` file has a
+ * download URL. A pending file is deleted if it isn't completed within a day.
+ */
+export declare const FileStatus: {
+    readonly Pending: "pending";
+    readonly Ready: "ready";
+};
+export type FileStatus = (typeof FileStatus)[keyof typeof FileStatus];

package/dist/cjs/api/resources/files/types/FileStatus.js

@@ -0,0 +1,12 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileStatus = void 0;
+/**
+ * `pending` until its bytes are uploaded and the upload is completed, then `ready`. Only a `ready` file has a
+ * download URL. A pending file is deleted if it isn't completed within a day.
+ */
+exports.FileStatus = {
+    Pending: "pending",
+    Ready: "ready",
+};

package/dist/cjs/api/resources/files/types/FileUpload.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Where to upload a pending file's bytes: one HTTP `PUT` to `url` with exactly `headers` and the file's bytes as
+ * the body. Every header is signed, so S3 refuses the upload if any is missing or different, and refuses bytes
+ * whose size or SHA-256 doesn't match the file. Then call Complete File.
+ */
+export interface FileUpload {
+    /** Always `PUT`. */
+    method: "PUT";
+    /** The presigned S3 URL. No API key is needed to use it. */
+    url: string;
+    /** The headers to send with the `PUT`, exactly as given. */
+    headers: Record<string, string>;
+    /** When `url` stops working, at most an hour after it was issued. Send the identical create request again for a fresh one. */
+    expiresAt: Date;
+}

package/dist/cjs/api/resources/files/types/FileUpload.js

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