agentmail 0.5.44 → 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.44",
-        "User-Agent": "agentmail/0.5.44",
+        "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/exports.d.ts

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

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

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

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

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

@@ -0,0 +1,12 @@
+import type * as AgentMail from "../../../index.js";
+export interface AgentArmorCompleteResult {
+    verdict: AgentMail.AgentArmorVerdict;
+    /** A short explanation of the verdict. */
+    reason: string;
+    /** Identifies the Agent Armor release that produced the verdict. Opaque; it changes when Agent Armor is updated. */
+    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/AgentArmorCompleteResult.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/AgentArmorCompletedEventResult.d.ts

@@ -0,0 +1,7 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * 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/AgentArmorCompletedEventResult.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/AgentArmorFeedback.d.ts

@@ -0,0 +1,14 @@
+import type * as AgentMail from "../../../index.js";
+export interface AgentArmorFeedback {
+    /** ID of the feedback. */
+    feedbackId: string;
+    feedback: AgentMail.AgentArmorFeedbackValue;
+    notes?: string;
+    actor: AgentMail.AgentArmorFeedbackActor;
+    /** The verdict the feedback is about. */
+    originalVerdict: AgentMail.AgentArmorVerdict;
+    /** The Agent Armor release that produced that verdict. */
+    model: string;
+    /** When the feedback was recorded. */
+    createdAt: Date;
+}

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

@@ -0,0 +1,13 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * Who sent the feedback.
+ */
+export type AgentArmorFeedbackActor = AgentMail.AgentArmorFeedbackActor.ApiKey | AgentMail.AgentArmorFeedbackActor.Console;
+export declare namespace AgentArmorFeedbackActor {
+    interface ApiKey extends AgentMail.AgentArmorFeedbackApiKeyActor {
+        kind: "api_key";
+    }
+    interface Console extends AgentMail.AgentArmorFeedbackConsoleActor {
+        kind: "console";
+    }
+}

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

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

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

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

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

@@ -0,0 +1,19 @@
+/** Your assessment of a completed verdict. */
+export declare const AgentArmorFeedbackValue: {
+    /**
+     * The message was rightly marked `review`. */
+    readonly CorrectReview: "correct_review";
+    /**
+     * The message was marked `review` but is legitimate. */
+    readonly IncorrectReview: "incorrect_review";
+    /**
+     * The message was marked `clear` but tries to manipulate an agent. */
+    readonly MissedThreat: "missed_threat";
+    /**
+     * The message instructs an agent, and is meant to. */
+    readonly LegitimateAgentInstruction: "legitimate_agent_instruction";
+    /**
+     * The message is spam or phishing rather than an attack on an agent. */
+    readonly SpamOrPhishing: "spam_or_phishing";
+};
+export type AgentArmorFeedbackValue = (typeof AgentArmorFeedbackValue)[keyof typeof AgentArmorFeedbackValue];

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

@@ -0,0 +1,22 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentArmorFeedbackValue = void 0;
+/** Your assessment of a completed verdict. */
+exports.AgentArmorFeedbackValue = {
+    /**
+     * The message was rightly marked `review`. */
+    CorrectReview: "correct_review",
+    /**
+     * The message was marked `review` but is legitimate. */
+    IncorrectReview: "incorrect_review",
+    /**
+     * The message was marked `clear` but tries to manipulate an agent. */
+    MissedThreat: "missed_threat",
+    /**
+     * The message instructs an agent, and is meant to. */
+    LegitimateAgentInstruction: "legitimate_agent_instruction",
+    /**
+     * The message is spam or phishing rather than an attack on an agent. */
+    SpamOrPhishing: "spam_or_phishing",
+};

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/AgentArmorPendingResult.d.ts

@@ -0,0 +1,6 @@
+export interface AgentArmorPendingResult {
+    /** When the message was received. The deadline counts from here. */
+    startedAt: Date;
+    /** When the scan gives up. A result still pending then reads as `unavailable` with `deadline_exceeded`. */
+    deadlineAt: Date;
+}

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

@@ -0,0 +1,19 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * Agent Armor's result for this message. Present only on messages received while Agent Armor was on for your
+ * organization. A scan starts `pending` and usually completes within seconds. `message.security.completed` is
+ * sent only for `complete` results, so a message still `pending` at `deadline_at` reads `unavailable` with no
+ * event.
+ */
+export type AgentArmorResult = AgentMail.AgentArmorResult.Pending | AgentMail.AgentArmorResult.Complete | AgentMail.AgentArmorResult.Unavailable;
+export declare namespace AgentArmorResult {
+    interface Pending extends AgentMail.AgentArmorPendingResult {
+        status: "pending";
+    }
+    interface Complete extends AgentMail.AgentArmorCompleteResult {
+        status: "complete";
+    }
+    interface Unavailable extends AgentMail.AgentArmorUnavailableResult {
+        status: "unavailable";
+    }
+}

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

@@ -0,0 +1,25 @@
+/** Why no verdict is available. */
+export declare const AgentArmorUnavailableReason: {
+    /**
+     * The message is a delivery status notification (a bounce), which Agent Armor does not scan. */
+    readonly UnsupportedDsn: "unsupported_dsn";
+    /**
+     * The message is too large to scan. */
+    readonly PayloadTooLarge: "payload_too_large";
+    /**
+     * The message has no text to scan. */
+    readonly NoScannableContent: "no_scannable_content";
+    /**
+     * The scan could not be started. */
+    readonly EnqueueFailed: "enqueue_failed";
+    /**
+     * The scan failed. */
+    readonly ScorerFailed: "scorer_failed";
+    /**
+     * The scan request or its stored result failed validation. */
+    readonly ContractError: "contract_error";
+    /**
+     * The scan did not finish within 15 minutes of the message arriving. */
+    readonly DeadlineExceeded: "deadline_exceeded";
+};
+export type AgentArmorUnavailableReason = (typeof AgentArmorUnavailableReason)[keyof typeof AgentArmorUnavailableReason];

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

@@ -0,0 +1,28 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentArmorUnavailableReason = void 0;
+/** Why no verdict is available. */
+exports.AgentArmorUnavailableReason = {
+    /**
+     * The message is a delivery status notification (a bounce), which Agent Armor does not scan. */
+    UnsupportedDsn: "unsupported_dsn",
+    /**
+     * The message is too large to scan. */
+    PayloadTooLarge: "payload_too_large",
+    /**
+     * The message has no text to scan. */
+    NoScannableContent: "no_scannable_content",
+    /**
+     * The scan could not be started. */
+    EnqueueFailed: "enqueue_failed",
+    /**
+     * The scan failed. */
+    ScorerFailed: "scorer_failed",
+    /**
+     * The scan request or its stored result failed validation. */
+    ContractError: "contract_error",
+    /**
+     * The scan did not finish within 15 minutes of the message arriving. */
+    DeadlineExceeded: "deadline_exceeded",
+};

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * What the scan concluded. `clear` means Agent Armor found no threat. It is advisory, not a guarantee that the
+ * message is safe. `review` means the message may try to manipulate an agent: inspect it before an agent acts on it.
+ */
+export declare const AgentArmorVerdict: {
+    readonly Clear: "clear";
+    readonly Review: "review";
+};
+export type AgentArmorVerdict = (typeof AgentArmorVerdict)[keyof typeof AgentArmorVerdict];

package/dist/cjs/api/resources/agentArmor/types/AgentArmorVerdict.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.AgentArmorVerdict = void 0;
+/**
+ * What the scan concluded. `clear` means Agent Armor found no threat. It is advisory, not a guarantee that the
+ * message is safe. `review` means the message may try to manipulate an agent: inspect it before an agent acts on it.
+ */
+exports.AgentArmorVerdict = {
+    Clear: "clear",
+    Review: "review",
+};

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

@@ -0,0 +1,6 @@
+import type * as AgentMail from "../../../index.js";
+export interface CreateAgentArmorFeedbackRequest {
+    feedback: AgentMail.AgentArmorFeedbackValue;
+    /** Anything else about the verdict, up to 2,048 characters. */
+    notes?: string;
+}

package/dist/cjs/api/resources/agentArmor/types/CreateAgentArmorFeedbackRequest.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

@@ -0,0 +1,19 @@
+export * from "./AgentArmorCompletedEventResult.js";
+export * from "./AgentArmorCompleteResult.js";
+export * from "./AgentArmorFeedback.js";
+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

@@ -0,0 +1,35 @@
+"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("./AgentArmorCompletedEventResult.js"), exports);
+__exportStar(require("./AgentArmorCompleteResult.js"), exports);
+__exportStar(require("./AgentArmorFeedback.js"), exports);
+__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

@@ -3,6 +3,9 @@ export declare const EventType: {
     readonly MessageReceivedSpam: "message.received.spam";
     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

@@ -7,6 +7,9 @@ exports.EventType = {
     MessageReceivedSpam: "message.received.spam",
     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/MessageSecurity.d.ts

@@ -0,0 +1,10 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * The message an Agent Armor result is for. Fetch the message for its content.
+ */
+export interface MessageSecurity {
+    organizationId: AgentMail.OrganizationId;
+    inboxId: AgentMail.inboxes.InboxId;
+    messageId: AgentMail.MessageId;
+    agentArmor: AgentMail.AgentArmorCompletedEventResult;
+}

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

@@ -0,0 +1,13 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * 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";
+    eventType: "message.security.completed";
+    eventId: AgentMail.EventId;
+    message: AgentMail.MessageSecurity;
+}

package/dist/cjs/api/resources/events/types/MessageSecurityCompletedEvent.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/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 });