agentmail 0.5.45 → 0.5.46

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

@@ -36,6 +36,8 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.calendar = void 0;
+exports.files = exports.calendar = void 0;
 __exportStar(require("./calendar/client/requests/index.js"), exports);
 exports.calendar = __importStar(require("./calendar/index.js"));
+__exportStar(require("./files/client/requests/index.js"), exports);
+exports.files = __importStar(require("./files/index.js"));

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

@@ -20,6 +20,8 @@ export * as drafts from "./drafts/index.js";
 export * from "./drafts/types/index.js";
 export * as events from "./events/index.js";
 export * from "./events/types/index.js";
+export * as files from "./files/index.js";
+export * from "./files/types/index.js";
 export * as inboxEvents from "./inboxEvents/index.js";
 export * from "./inboxEvents/types/index.js";
 export * as inboxes from "./inboxes/index.js";

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

@@ -36,7 +36,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.websockets = exports.webhooks = exports.threads = exports.pods = exports.organizations = exports.metrics = exports.messages = exports.lists = exports.inboxes = exports.inboxEvents = exports.events = exports.drafts = exports.domains = exports.calendar = exports.auth = exports.attachments = exports.apps = exports.apiKeys = exports.agentArmor = exports.agent = exports.accounts = void 0;
+exports.websockets = exports.webhooks = exports.threads = exports.pods = exports.organizations = exports.metrics = exports.messages = exports.lists = exports.inboxes = exports.inboxEvents = exports.files = exports.events = exports.drafts = exports.domains = exports.calendar = exports.auth = exports.attachments = exports.apps = exports.apiKeys = exports.agentArmor = exports.agent = exports.accounts = void 0;
 exports.accounts = __importStar(require("./accounts/index.js"));
 __exportStar(require("./accounts/types/index.js"), exports);
 exports.agent = __importStar(require("./agent/index.js"));
@@ -59,6 +59,8 @@ exports.drafts = __importStar(require("./drafts/index.js"));
 __exportStar(require("./drafts/types/index.js"), exports);
 exports.events = __importStar(require("./events/index.js"));
 __exportStar(require("./events/types/index.js"), exports);
+exports.files = __importStar(require("./files/index.js"));
+__exportStar(require("./files/types/index.js"), exports);
 exports.inboxEvents = __importStar(require("./inboxEvents/index.js"));
 __exportStar(require("./inboxEvents/types/index.js"), exports);
 exports.inboxes = __importStar(require("./inboxes/index.js"));

package/dist/cjs/serialization/resources/websockets/client/socket/WebsocketsSocketResponse.d.ts

@@ -15,10 +15,12 @@ import { MessageOpenedEvent } from "../../../events/types/MessageOpenedEvent.js"
 import { MessageReceivedEvent } from "../../../events/types/MessageReceivedEvent.js";
 import { MessageRejectedEvent } from "../../../events/types/MessageRejectedEvent.js";
 import { MessageSecurityCompletedEvent } from "../../../events/types/MessageSecurityCompletedEvent.js";
+import { MessageSecurityOverrideEvent } from "../../../events/types/MessageSecurityOverrideEvent.js";
+import { MessageSecurityReviewEvent } from "../../../events/types/MessageSecurityReviewEvent.js";
 import { MessageSentEvent } from "../../../events/types/MessageSentEvent.js";
 import { Error_ } from "../../types/Error_.js";
 import { Subscribed } from "../../types/Subscribed.js";
-export declare const WebsocketsSocketResponse: core.serialization.Schema<serializers.WebsocketsSocketResponse.Raw, AgentMail.Subscribed | AgentMail.MessageReceivedEvent | AgentMail.MessageSecurityCompletedEvent | AgentMail.MessageSentEvent | AgentMail.MessageDeliveredEvent | AgentMail.MessageBouncedEvent | AgentMail.MessageComplainedEvent | AgentMail.MessageRejectedEvent | AgentMail.MessageOpenedEvent | AgentMail.DomainVerifiedEvent | AgentMail.CalendarEventCreatedEvent | AgentMail.CalendarEventUpdatedEvent | AgentMail.CalendarEventDeletedEvent | AgentMail.CalendarEventRespondedEvent | AgentMail.CalendarEventStartingEvent | AgentMail.CalendarEventEndingEvent | AgentMail.Error_>;
+export declare const WebsocketsSocketResponse: core.serialization.Schema<serializers.WebsocketsSocketResponse.Raw, AgentMail.Subscribed | AgentMail.MessageReceivedEvent | AgentMail.MessageSecurityCompletedEvent | AgentMail.MessageSecurityReviewEvent | AgentMail.MessageSecurityOverrideEvent | AgentMail.MessageSentEvent | AgentMail.MessageDeliveredEvent | AgentMail.MessageBouncedEvent | AgentMail.MessageComplainedEvent | AgentMail.MessageRejectedEvent | AgentMail.MessageOpenedEvent | AgentMail.DomainVerifiedEvent | AgentMail.CalendarEventCreatedEvent | AgentMail.CalendarEventUpdatedEvent | AgentMail.CalendarEventDeletedEvent | AgentMail.CalendarEventRespondedEvent | AgentMail.CalendarEventStartingEvent | AgentMail.CalendarEventEndingEvent | AgentMail.Error_>;
 export declare namespace WebsocketsSocketResponse {
-    type Raw = Subscribed.Raw | MessageReceivedEvent.Raw | MessageSecurityCompletedEvent.Raw | MessageSentEvent.Raw | MessageDeliveredEvent.Raw | MessageBouncedEvent.Raw | MessageComplainedEvent.Raw | MessageRejectedEvent.Raw | MessageOpenedEvent.Raw | DomainVerifiedEvent.Raw | CalendarEventCreatedEvent.Raw | CalendarEventUpdatedEvent.Raw | CalendarEventDeletedEvent.Raw | CalendarEventRespondedEvent.Raw | CalendarEventStartingEvent.Raw | CalendarEventEndingEvent.Raw | Error_.Raw;
+    type Raw = Subscribed.Raw | MessageReceivedEvent.Raw | MessageSecurityCompletedEvent.Raw | MessageSecurityReviewEvent.Raw | MessageSecurityOverrideEvent.Raw | MessageSentEvent.Raw | MessageDeliveredEvent.Raw | MessageBouncedEvent.Raw | MessageComplainedEvent.Raw | MessageRejectedEvent.Raw | MessageOpenedEvent.Raw | DomainVerifiedEvent.Raw | CalendarEventCreatedEvent.Raw | CalendarEventUpdatedEvent.Raw | CalendarEventDeletedEvent.Raw | CalendarEventRespondedEvent.Raw | CalendarEventStartingEvent.Raw | CalendarEventEndingEvent.Raw | Error_.Raw;
 }

package/dist/cjs/serialization/resources/websockets/client/socket/WebsocketsSocketResponse.js

@@ -50,6 +50,8 @@ const MessageOpenedEvent_js_1 = require("../../../events/types/MessageOpenedEven
 const MessageReceivedEvent_js_1 = require("../../../events/types/MessageReceivedEvent.js");
 const MessageRejectedEvent_js_1 = require("../../../events/types/MessageRejectedEvent.js");
 const MessageSecurityCompletedEvent_js_1 = require("../../../events/types/MessageSecurityCompletedEvent.js");
+const MessageSecurityOverrideEvent_js_1 = require("../../../events/types/MessageSecurityOverrideEvent.js");
+const MessageSecurityReviewEvent_js_1 = require("../../../events/types/MessageSecurityReviewEvent.js");
 const MessageSentEvent_js_1 = require("../../../events/types/MessageSentEvent.js");
 const Error__js_1 = require("../../types/Error_.js");
 const Subscribed_js_1 = require("../../types/Subscribed.js");
@@ -57,6 +59,8 @@ exports.WebsocketsSocketResponse = core.serialization.undiscriminatedUnion([
     Subscribed_js_1.Subscribed,
     MessageReceivedEvent_js_1.MessageReceivedEvent,
     MessageSecurityCompletedEvent_js_1.MessageSecurityCompletedEvent,
+    MessageSecurityReviewEvent_js_1.MessageSecurityReviewEvent,
+    MessageSecurityOverrideEvent_js_1.MessageSecurityOverrideEvent,
     MessageSentEvent_js_1.MessageSentEvent,
     MessageDeliveredEvent_js_1.MessageDeliveredEvent,
     MessageBouncedEvent_js_1.MessageBouncedEvent,

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.5.45";
+export declare const SDK_VERSION = "0.5.46";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.5.45";
+exports.SDK_VERSION = "0.5.46";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "agentmail",
-        "X-Fern-SDK-Version": "0.5.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/esm/api/resources/agentArmor/types/AgentArmorCompleteResult.d.mts

@@ -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/esm/api/resources/agentArmor/types/AgentArmorCompletedEventResult.d.mts

@@ -1,6 +1,6 @@
 import type * as AgentMail from "../../../index.mjs";
 /**
- * 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/esm/api/resources/agentArmor/types/AgentArmorManualOverride.d.mts

@@ -0,0 +1,15 @@
+import type * as AgentMail from "../../../index.mjs";
+/**
+ * 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/esm/api/resources/agentArmor/types/AgentArmorManualOverride.mjs

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

package/dist/esm/api/resources/agentArmor/types/AgentArmorReleaseActor.d.mts

@@ -0,0 +1,13 @@
+import type * as AgentMail from "../../../index.mjs";
+/**
+ * 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/esm/api/resources/agentArmor/types/AgentArmorReleaseActor.mjs

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

package/dist/esm/api/resources/agentArmor/types/AgentArmorReleaseApiKeyActor.d.mts

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

package/dist/esm/api/resources/agentArmor/types/AgentArmorReleaseApiKeyActor.mjs

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

package/dist/esm/api/resources/agentArmor/types/AgentArmorReleaseConsoleActor.d.mts

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

package/dist/esm/api/resources/agentArmor/types/AgentArmorReleaseConsoleActor.mjs

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

package/dist/esm/api/resources/agentArmor/types/ReleaseAgentArmorMessageRequest.d.mts

@@ -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/esm/api/resources/agentArmor/types/ReleaseAgentArmorMessageRequest.mjs

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

package/dist/esm/api/resources/agentArmor/types/ReleaseAgentArmorMessageResponse.d.mts

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

package/dist/esm/api/resources/agentArmor/types/ReleaseAgentArmorMessageResponse.mjs

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

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

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

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

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

package/dist/esm/api/resources/apiKeys/types/ApiKeyPermissions.d.mts

@@ -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/esm/api/resources/events/types/EventType.d.mts

@@ -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/esm/api/resources/events/types/EventType.mjs

@@ -5,6 +5,8 @@ export const 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/esm/api/resources/events/types/MessageSecurityCompletedEvent.d.mts

@@ -1,8 +1,9 @@
 import type * as AgentMail from "../../../index.mjs";
 /**
- * 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/esm/api/resources/events/types/MessageSecurityOverride.d.mts

@@ -0,0 +1,10 @@
+import type * as AgentMail from "../../../index.mjs";
+/**
+ * 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/esm/api/resources/events/types/MessageSecurityOverride.mjs

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

package/dist/esm/api/resources/events/types/MessageSecurityOverrideEvent.d.mts

@@ -0,0 +1,13 @@
+import type * as AgentMail from "../../../index.mjs";
+/**
+ * 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/esm/api/resources/events/types/MessageSecurityOverrideEvent.mjs

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

package/dist/esm/api/resources/events/types/MessageSecurityReviewEvent.d.mts

@@ -0,0 +1,13 @@
+import type * as AgentMail from "../../../index.mjs";
+/**
+ * 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/esm/api/resources/events/types/MessageSecurityReviewEvent.mjs

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

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

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

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

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

package/dist/esm/api/resources/files/errors/FileForbiddenError.d.mts

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

package/dist/esm/api/resources/files/errors/FileForbiddenError.mjs

@@ -0,0 +1,17 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as errors from "../../../../errors/index.mjs";
+export 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;
+    }
+}

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

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

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

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

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

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

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

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export * from "./index.mjs";

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

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

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

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

package/dist/esm/api/resources/files/types/CreateFileRequest.d.mts

@@ -0,0 +1,12 @@
+import type * as AgentMail from "../../../index.mjs";
+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/esm/api/resources/files/types/CreateFileRequest.mjs

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

package/dist/esm/api/resources/files/types/CreateFileResponse.d.mts

@@ -0,0 +1,7 @@
+import type * as AgentMail from "../../../index.mjs";
+/**
+ * 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/esm/api/resources/files/types/CreateFileResponse.mjs

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

package/dist/esm/api/resources/files/types/FileContentType.d.mts

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

package/dist/esm/api/resources/files/types/FileContentType.mjs

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

package/dist/esm/api/resources/files/types/FileExpiresAt.d.mts

@@ -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/esm/api/resources/files/types/FileExpiresAt.mjs

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

package/dist/esm/api/resources/files/types/FileId.d.mts

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

package/dist/esm/api/resources/files/types/FileId.mjs

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

package/dist/esm/api/resources/files/types/FileItem.d.mts

@@ -0,0 +1,20 @@
+import type * as AgentMail from "../../../index.mjs";
+/**
+ * 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/esm/api/resources/files/types/FileItem.mjs

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

package/dist/esm/api/resources/files/types/FileName.d.mts

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

package/dist/esm/api/resources/files/types/FileName.mjs

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

package/dist/esm/api/resources/files/types/FilePath.d.mts

@@ -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/esm/api/resources/files/types/FilePath.mjs

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

package/dist/esm/api/resources/files/types/FileSha256.d.mts

@@ -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/esm/api/resources/files/types/FileSha256.mjs

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

package/dist/esm/api/resources/files/types/FileSize.d.mts

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

package/dist/esm/api/resources/files/types/FileSize.mjs

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

package/dist/esm/api/resources/files/types/FileStatus.d.mts

@@ -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/esm/api/resources/files/types/FileStatus.mjs

@@ -0,0 +1,9 @@
+// This file was auto-generated by Fern from our API Definition.
+/**
+ * `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 const FileStatus = {
+    Pending: "pending",
+    Ready: "ready",
+};

package/dist/esm/api/resources/files/types/FileUpload.d.mts

@@ -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/esm/api/resources/files/types/FileUpload.mjs

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

package/dist/esm/api/resources/files/types/File_.d.mts

@@ -0,0 +1,14 @@
+import type * as AgentMail from "../../../index.mjs";
+/**
+ * A file. A `ready` file returned to a caller with the `file_read` permission carries a signed `download_url`.
+ */
+export interface File_ extends AgentMail.FileItem {
+    /**
+     * A signed URL that downloads the file's bytes, named by `name`. No API key is needed to use it, so treat it
+     * as a secret. It works until `download_expires_at`, at most an hour, even after the file is deleted. Get the
+     * file again for a fresh one.
+     */
+    downloadUrl?: string;
+    /** When `download_url` stops working. Never after the file's own expiry. */
+    downloadExpiresAt?: Date;
+}