agentmail 0.5.43 → 0.5.45

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.43",
-        "User-Agent": "agentmail/0.5.43",
+        "X-Fern-SDK-Version": "0.5.45",
+        "User-Agent": "agentmail/0.5.45",
         "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,10 @@
+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;
+}

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

@@ -0,0 +1,13 @@
+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 "./AgentArmorPendingResult.js";
+export * from "./AgentArmorResult.js";
+export * from "./AgentArmorUnavailableReason.js";
+export * from "./AgentArmorUnavailableResult.js";
+export * from "./AgentArmorVerdict.js";
+export * from "./CreateAgentArmorFeedbackRequest.js";

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

@@ -0,0 +1,29 @@
+"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("./AgentArmorPendingResult.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);

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

@@ -3,6 +3,7 @@ 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 MessageSent: "message.sent";
     readonly MessageDelivered: "message.delivered";
     readonly MessageBounced: "message.bounced";

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

@@ -7,6 +7,7 @@ exports.EventType = {
     MessageReceivedSpam: "message.received.spam",
     MessageReceivedBlocked: "message.received.blocked",
     MessageReceivedUnauthenticated: "message.received.unauthenticated",
+    MessageSecurityCompleted: "message.security.completed",
     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,12 @@
+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.
+ */
+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/index.d.ts

@@ -20,6 +20,8 @@ export * from "./MessageOpenedEvent.js";
 export * from "./MessageReceivedEvent.js";
 export * from "./MessageReceivedEventType.js";
 export * from "./MessageRejectedEvent.js";
+export * from "./MessageSecurity.js";
+export * from "./MessageSecurityCompletedEvent.js";
 export * from "./MessageSentEvent.js";
 export * from "./Open.js";
 export * from "./PodIds.js";

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

@@ -36,6 +36,8 @@ __exportStar(require("./MessageOpenedEvent.js"), exports);
 __exportStar(require("./MessageReceivedEvent.js"), exports);
 __exportStar(require("./MessageReceivedEventType.js"), exports);
 __exportStar(require("./MessageRejectedEvent.js"), exports);
+__exportStar(require("./MessageSecurity.js"), exports);
+__exportStar(require("./MessageSecurityCompletedEvent.js"), exports);
 __exportStar(require("./MessageSentEvent.js"), exports);
 __exportStar(require("./Open.js"), exports);
 __exportStar(require("./PodIds.js"), exports);

package/dist/cjs/api/resources/inboxes/resources/messages/client/Client.d.ts

@@ -72,6 +72,28 @@ export declare class MessagesClient {
      */
     get(inbox_id: AgentMail.inboxes.InboxId, message_id: AgentMail.MessageId, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<AgentMail.Message>;
     private __get;
+    /**
+     * @beta This endpoint is in pre-release and may change.
+     *
+     * Tell us whether Agent Armor's verdict on a message was right. The message needs a completed result. A message
+     * accepts up to 20 pieces of feedback. Requires permission to read the message.
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.MessageId} message_id
+     * @param {AgentMail.CreateAgentArmorFeedbackRequest} request
+     * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ConflictError}
+     *
+     * @example
+     *     await client.inboxes.messages.createAgentArmorFeedback("inbox_id", "message_id", {
+     *         feedback: "correct_review"
+     *     })
+     */
+    createAgentArmorFeedback(inbox_id: AgentMail.inboxes.InboxId, message_id: AgentMail.MessageId, request: AgentMail.CreateAgentArmorFeedbackRequest, requestOptions?: MessagesClient.RequestOptions): core.HttpResponsePromise<AgentMail.AgentArmorFeedback>;
+    private __createAgentArmorFeedback;
     /**
      * Fetch metadata for up to 500 messages in one request. Missing or
      * restricted IDs are silently omitted; compare `count` against `limit`

package/dist/cjs/api/resources/inboxes/resources/messages/client/Client.js

@@ -315,6 +315,101 @@ class MessagesClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/inboxes/{inbox_id}/messages/{message_id}");
         });
     }
+    /**
+     * @beta This endpoint is in pre-release and may change.
+     *
+     * Tell us whether Agent Armor's verdict on a message was right. The message needs a completed result. A message
+     * accepts up to 20 pieces of feedback. Requires permission to read the message.
+     *
+     * @param {AgentMail.inboxes.InboxId} inbox_id
+     * @param {AgentMail.MessageId} message_id
+     * @param {AgentMail.CreateAgentArmorFeedbackRequest} request
+     * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ConflictError}
+     *
+     * @example
+     *     await client.inboxes.messages.createAgentArmorFeedback("inbox_id", "message_id", {
+     *         feedback: "correct_review"
+     *     })
+     */
+    createAgentArmorFeedback(inbox_id, message_id, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createAgentArmorFeedback(inbox_id, message_id, request, requestOptions));
+    }
+    __createAgentArmorFeedback(inbox_id, message_id, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Prod)
+                    .http, `/v0/inboxes/${core.url.encodePathParam(serializers.inboxes.InboxId.jsonOrThrow(inbox_id, { omitUndefined: true }))}/messages/${core.url.encodePathParam(serializers.MessageId.jsonOrThrow(message_id, { omitUndefined: true }))}/agent-armor/feedback`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.CreateAgentArmorFeedbackRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                }),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.AgentArmorFeedback.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AgentMail.ValidationError(serializers.ValidationErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 404:
+                        throw new AgentMail.NotFoundError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 409:
+                        throw new AgentMail.ConflictError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v0/inboxes/{inbox_id}/messages/{message_id}/agent-armor/feedback");
+        });
+    }
     /**
      * Fetch metadata for up to 500 messages in one request. Missing or
      * restricted IDs are silently omitted; compare `count` against `limit`

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

@@ -3,6 +3,8 @@ export * as accounts from "./accounts/index.js";
 export * from "./accounts/types/index.js";
 export * as agent from "./agent/index.js";
 export * from "./agent/types/index.js";
+export * as agentArmor from "./agentArmor/index.js";
+export * from "./agentArmor/types/index.js";
 export * from "./apiKeys/client/requests/index.js";
 export * as apiKeys from "./apiKeys/index.js";
 export * from "./apiKeys/types/index.js";
@@ -37,6 +39,7 @@ export * from "./messages/types/index.js";
 export * from "./metrics/client/requests/index.js";
 export * as metrics from "./metrics/index.js";
 export * from "./metrics/types/index.js";
+export * from "./organizations/errors/index.js";
 export * as organizations from "./organizations/index.js";
 export * from "./organizations/types/index.js";
 export * as pods from "./pods/index.js";