agentmail 0.5.29 → 0.5.31

package/dist/esm/serialization/resources/metrics/types/RateTypes.d.mts

@@ -0,0 +1,8 @@
+import type * as AgentMail from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+import type * as serializers from "../../../index.mjs";
+import { RateType } from "./RateType.mjs";
+export declare const RateTypes: core.serialization.Schema<serializers.RateTypes.Raw, AgentMail.RateTypes>;
+export declare namespace RateTypes {
+    type Raw = RateType.Raw[];
+}

package/dist/esm/serialization/resources/metrics/types/RateTypes.mjs

@@ -0,0 +1,4 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../../../core/index.mjs";
+import { RateType } from "./RateType.mjs";
+export const RateTypes = core.serialization.list(RateType);

package/dist/esm/serialization/resources/metrics/types/Window.d.mts

@@ -0,0 +1,7 @@
+import type * as AgentMail from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+import type * as serializers from "../../../index.mjs";
+export declare const Window: core.serialization.Schema<serializers.Window.Raw, AgentMail.Window>;
+export declare namespace Window {
+    type Raw = number;
+}

package/dist/esm/serialization/resources/metrics/types/Window.mjs

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../../../core/index.mjs";
+export const Window = core.serialization.number();

package/dist/esm/serialization/resources/metrics/types/index.d.mts

@@ -6,8 +6,14 @@ export * from "./MetricEventTypes.mjs";
 export * from "./MetricLimit.mjs";
 export * from "./Period.mjs";
 export * from "./QueryMetricsResponse.mjs";
+export * from "./QueryRatesResponse.mjs";
 export * from "./QueryUsageResponse.mjs";
+export * from "./RatePeriod.mjs";
+export * from "./RatePoint.mjs";
+export * from "./RateType.mjs";
+export * from "./RateTypes.mjs";
 export * from "./Start.mjs";
 export * from "./UsagePoint.mjs";
 export * from "./UsageType.mjs";
 export * from "./UsageTypes.mjs";
+export * from "./Window.mjs";

package/dist/esm/serialization/resources/metrics/types/index.mjs

@@ -6,8 +6,14 @@ export * from "./MetricEventTypes.mjs";
 export * from "./MetricLimit.mjs";
 export * from "./Period.mjs";
 export * from "./QueryMetricsResponse.mjs";
+export * from "./QueryRatesResponse.mjs";
 export * from "./QueryUsageResponse.mjs";
+export * from "./RatePeriod.mjs";
+export * from "./RatePoint.mjs";
+export * from "./RateType.mjs";
+export * from "./RateTypes.mjs";
 export * from "./Start.mjs";
 export * from "./UsagePoint.mjs";
 export * from "./UsageType.mjs";
 export * from "./UsageTypes.mjs";
+export * from "./Window.mjs";

package/dist/esm/serialization/resources/webhooks/types/UpdateInboxWebhookRequest.d.mts

@@ -6,5 +6,6 @@ export declare const UpdateInboxWebhookRequest: core.serialization.ObjectSchema<
 export declare namespace UpdateInboxWebhookRequest {
     interface Raw {
         event_types?: UpdateWebhookEventTypes.Raw | null;
+        enabled?: boolean | null;
     }
 }

package/dist/esm/serialization/resources/webhooks/types/UpdateInboxWebhookRequest.mjs

@@ -3,4 +3,5 @@ import * as core from "../../../../core/index.mjs";
 import { UpdateWebhookEventTypes } from "./UpdateWebhookEventTypes.mjs";
 export const UpdateInboxWebhookRequest = core.serialization.object({
     eventTypes: core.serialization.property("event_types", UpdateWebhookEventTypes.optional()),
+    enabled: core.serialization.boolean().optional(),
 });

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.5.29";
+export declare const SDK_VERSION = "0.5.31";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.5.29";
+export const SDK_VERSION = "0.5.31";

package/dist/llms.txt

@@ -39,6 +39,7 @@
 - [AgentID Sign-In](https://docs.agentmail.to/agentid-sign-in.md): Connect an inbox to a provider, authorize a pending AgentID sign-in, and manage sign-in keys with the AgentMail API and CLI.
 - [AgentID Public-Key Authentication](https://docs.agentmail.to/agentid-public-key-authentication.md): Register a public P-256 key, choose its scope and permissions, and manage it through the current AgentMail API Keys endpoints.
 - [Guide: Sending & Receiving Email](https://docs.agentmail.to/sending-receiving-email.md): A step-by-step guide to the practical workflow of sending initial emails and handling replies to have a full conversation.
+- [Reply & Attachment Extraction](https://docs.agentmail.to/reply-extraction.md): AgentMail strips quoted history and boilerplate from every message into extracted_text and extracted_html, and extracts plain text from PDF, Word, Excel, and text attachments. No Talon or reply-parsing library required.
 - [IMAP & SMTP](https://docs.agentmail.to/imap-smtp.md): Configure IMAP and SMTP to access your AgentMail inboxes using email clients or programmatic access.
 - [Guide: Multi-Tenancy](https://docs.agentmail.to/multi-tenancy.md): How to use pods, scoped API keys, and webhook filtering to build multi-tenant email on AgentMail.
 - [Using Custom Domains](https://docs.agentmail.to/custom-domains.md): A step-by-step guide to configuring your custom domain with AgentMail for enhanced branding and trust.
@@ -59,10 +60,10 @@
 - [Live AgentMail Examples](https://docs.agentmail.to/documentation/examples/live-agent-mail-examples.md)
 - [Frequently Asked Questions (FAQ)](https://docs.agentmail.to/faq.md): Find answers to common questions about AgentMail, from core concepts to best practices and security.
 - [Error Reference](https://docs.agentmail.to/errors.md): Every AgentMail API error code, what it means, and how to fix it.
-- [Email Reply Extraction with Talon](https://docs.agentmail.to/talon-reply-extraction.md): Learn how to use Talon to extract new content from email replies, removing quoted text with 93.8% accuracy.
 - [Join the AgentMail Community](https://docs.agentmail.to/community.md): Connect with the AgentMail team and developers, share what you're building, and get support.
 - [Support](https://docs.agentmail.to/support.md): Get help with AgentMail through our support channels.
 - [Understanding Email Authentication (SPF, DKIM, DMARC)](https://docs.agentmail.to/email-protocols.md): Learn why we ask for DNS records and what SPF, DKIM, and DMARC are.
+- [24-hour Message Expiry](https://docs.agentmail.to/message-expiry.md): Optional 24-hour message access expiry for your organization. Contact us about early access.
 - [SOC 2 Compliance](https://docs.agentmail.to/documentation/resources/security-privacy/soc-2-compliance.md): AgentMail's completed 2025 SOC 2 Type II audit and 2026 annual audit underway with A-LIGN.
 - [Spam & Virus Detection](https://docs.agentmail.to/spam-virus-detection.md): How AgentMail automatically scans incoming emails for spam and viruses.
 - [API Welcome](https://docs.agentmail.to/api-reference.md): Quick overview of the AgentMail SDK
@@ -98,6 +99,7 @@
 ## API Docs
 
 - API Reference > Agent [Sign Up](https://docs.agentmail.to/api-reference/agent/sign-up.md)
+- API Reference > Agent [Attach Human](https://docs.agentmail.to/api-reference/agent/attach-human.md)
 - API Reference > Agent [Verify](https://docs.agentmail.to/api-reference/agent/verify.md)
 - API Reference > Inboxes [List Inboxes](https://docs.agentmail.to/api-reference/inboxes/list.md)
 - API Reference > Inboxes [Search Inboxes](https://docs.agentmail.to/api-reference/inboxes/search.md)
@@ -145,6 +147,7 @@
 - API Reference > Inboxes > Lists [Delete List Entry](https://docs.agentmail.to/api-reference/inboxes/lists/delete.md)
 - API Reference > Inboxes > Metrics [Query Events](https://docs.agentmail.to/api-reference/inboxes/metrics/query-events.md)
 - API Reference > Inboxes > Metrics [Query Usage](https://docs.agentmail.to/api-reference/inboxes/metrics/query-usage.md)
+- API Reference > Inboxes > Metrics [Query Rates](https://docs.agentmail.to/api-reference/inboxes/metrics/query-rates.md)
 - API Reference > Inboxes > Events [List Inbox Events](https://docs.agentmail.to/api-reference/inboxes/events/list.md)
 - API Reference > Inboxes > API Keys [List API Keys](https://docs.agentmail.to/api-reference/inboxes/api-keys/list.md)
 - API Reference > Inboxes > API Keys [Create API Key](https://docs.agentmail.to/api-reference/inboxes/api-keys/create.md)
@@ -191,6 +194,7 @@
 - API Reference > Lists [Delete List Entry](https://docs.agentmail.to/api-reference/lists/delete.md)
 - API Reference > Metrics [Query Events](https://docs.agentmail.to/api-reference/metrics/query-events.md)
 - API Reference > Metrics [Query Usage](https://docs.agentmail.to/api-reference/metrics/query-usage.md)
+- API Reference > Metrics [Query Rates](https://docs.agentmail.to/api-reference/metrics/query-rates.md)
 - API Reference > API Keys [List API Keys](https://docs.agentmail.to/api-reference/api-keys/list.md)
 - API Reference > API Keys [Get API Key](https://docs.agentmail.to/api-reference/api-keys/get.md)
 - API Reference > API Keys [Create API Key](https://docs.agentmail.to/api-reference/api-keys/create.md)
@@ -243,6 +247,7 @@
 - API Reference > Pods > Lists [Delete List Entry](https://docs.agentmail.to/api-reference/pods/lists/delete.md)
 - API Reference > Pods > Metrics [Query Events](https://docs.agentmail.to/api-reference/pods/metrics/query-events.md)
 - API Reference > Pods > Metrics [Query Usage](https://docs.agentmail.to/api-reference/pods/metrics/query-usage.md)
+- API Reference > Pods > Metrics [Query Rates](https://docs.agentmail.to/api-reference/pods/metrics/query-rates.md)
 - API Reference > Pods > API Keys [List API Keys](https://docs.agentmail.to/api-reference/pods/api-keys/list.md)
 - API Reference > Pods > API Keys [Create API Key](https://docs.agentmail.to/api-reference/pods/api-keys/create.md)
 - API Reference > Pods > API Keys [Update API Key](https://docs.agentmail.to/api-reference/pods/api-keys/update.md)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agentmail",
-    "version": "0.5.29",
+    "version": "0.5.31",
     "private": false,
     "repository": {
         "type": "git",

package/reference.md

@@ -1464,6 +1464,8 @@ Create a new agent organization with an inbox and API key. This endpoint is for
 
 A 6-digit OTP is sent to the human's email for verification.
 
+`human_email` is optional. Without it, the inbox can receive email but cannot send to anyone until a human is attached with the attach human endpoint. There is also no way to recover the API key, so store it durably. Calling sign-up again without `human_email` creates a new organization, which needs a different `username`: the original username stays with the lost organization's inbox.
+
 This endpoint is idempotent. Calling it again with the same `human_email` will rotate the API key and resend the OTP if expired.
 
 The returned API key has limited permissions until the organization is verified via the verify endpoint.
@@ -1487,7 +1489,6 @@ agentmail agent sign-up --human-email user@example.com --username my-agent
 
 ```typescript
 await client.agent.signUp({
-    humanEmail: "human_email",
     username: "username"
 });
 
@@ -1521,6 +1522,84 @@ await client.agent.signUp({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agent.<a href="/src/api/resources/agent/client/Client.ts">attachHuman</a>({ ...params }) -> AgentMail.AgentAttachHumanResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Attach a human to an unverified agent organization. A 6-digit OTP is sent to the human's email, which you then submit to the verify endpoint.
+
+Use it after signing up without a `human_email`. Once the human is attached, the organization can send email to that human only, and verification lifts the remaining restrictions. For up to 5 minutes after attaching, sends to the human can still be rejected with a `429` daily send limit error while the API key's cached limits catch up. Wait and retry.
+
+Calling it again with the same `human_email` does not rotate the API key. It resends the OTP if it was never delivered, or issues a new one if it expired. While the current OTP is still valid, calling it again keeps that OTP and its attempt count. If all 10 attempts are used up, wait until the OTP expires, 24 hours after it was issued, then call it again for a new one.
+
+Calling it with a different `human_email` replaces the attached human and sends the new human an OTP. An organization can replace its human at most 2 times.
+
+Only available until the organization is verified.
+
+**CLI:**
+```bash
+agentmail agent attach-human --human-email user@example.com
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agent.attachHuman({
+    humanEmail: "human_email"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.AgentAttachHumanRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -1541,7 +1620,7 @@ Verify an agent organization using the 6-digit OTP sent to the human's email dur
 
 On success, the organization is upgraded from `agent_unverified` to `agent_verified`, the send allowlist is removed, and free plan entitlements are applied.
 
-The OTP expires after 24 hours and allows a maximum of 10 attempts. If you run into any difficulties receiving the OTP code, you can also create an account on [console.agentmail.to](https://console.agentmail.to) using the human email address you provided to verify your account.
+The OTP expires after 24 hours and allows a maximum of 10 attempts. If the OTP expired, call the attach human endpoint with the same `human_email` to get a new one without rotating the API key. Once all 10 attempts are used, even the correct OTP is rejected, and attach human keeps returning the same OTP until it expires, so wait for it to expire before asking for a new one. An organization that signed up without a `human_email` has no OTP until a human is attached. If you run into any difficulties receiving the OTP code, you can also create an account on [console.agentmail.to](https://console.agentmail.to) using the human email address you provided to verify your account.
 
 **CLI:**
 ```bash
@@ -5373,6 +5452,91 @@ await client.inboxes.metrics.queryUsage("inbox_id");
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.inboxes.metrics.<a href="/src/api/resources/inboxes/resources/metrics/client/Client.ts">queryRates</a>(inbox_id, { ...params }) -> AgentMail.QueryRatesResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Rolling bounce and complaint rates for the inbox. At each `period`
+grid point, the bounced (or complained) messages over the preceding
+`window` divided by the messages sent over the same window, with the
+send count alongside. Account moderation evaluates the organization-wide
+rate, so use the organization endpoint to see the number it acts on;
+the inbox view shows which inboxes contribute. Defaults to the rolling
+24-hour rate sampled hourly over the last day; `start` must be within
+the last 90 days, `window` must be a whole multiple of `period`, and
+the range plus window divided by `period` must not exceed 1000
+buckets.
+
+**CLI:**
+```bash
+agentmail inboxes metrics query-rates --inbox-id <inbox_id>
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.inboxes.metrics.queryRates("inbox_id");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**inbox_id:** `AgentMail.InboxId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.inboxes.QueryRatesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `MetricsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -6855,6 +7019,84 @@ await client.metrics.queryUsage();
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.metrics.<a href="/src/api/resources/metrics/client/Client.ts">queryRates</a>({ ...params }) -> AgentMail.QueryRatesResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Rolling bounce and complaint rates for the organization. At each
+`period` grid point, the bounced (or complained) messages over the
+preceding `window` divided by the messages sent over the same window,
+with the send count alongside so you can see the volume behind
+it. This is the number AgentMail's account moderation acts on: a
+warning at a 5% bounce rate and suspension at 10%, evaluated over a
+rolling 24 hours once at least 1,000 messages were sent in that
+window. Defaults to the rolling 24-hour rate sampled hourly over the
+last day; `start` must be within the last 90 days, `window` must be a
+whole multiple of `period`, and the range plus window divided by
+`period` must not exceed 1000 buckets.
+
+**CLI:**
+```bash
+agentmail metrics query-rates
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.metrics.queryRates();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.QueryRatesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `MetricsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -9103,6 +9345,91 @@ await client.pods.metrics.queryUsage("pod_id");
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.pods.metrics.<a href="/src/api/resources/pods/resources/metrics/client/Client.ts">queryRates</a>(pod_id, { ...params }) -> AgentMail.QueryRatesResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Rolling bounce and complaint rates for the pod. At each `period` grid
+point, the bounced (or complained) messages over the preceding
+`window` divided by the messages sent over the same window, with the
+send count alongside. Account moderation evaluates the organization-wide
+rate, so use the organization endpoint to see the number it acts on;
+the pod view shows which pods contribute. Defaults to the rolling
+24-hour rate sampled hourly over the last day; `start` must be within
+the last 90 days, `window` must be a whole multiple of `period`, and
+the range plus window divided by `period` must not exceed 1000
+buckets.
+
+**CLI:**
+```bash
+agentmail pods metrics query-rates --pod-id <pod_id>
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.pods.metrics.queryRates("pod_id");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**pod_id:** `AgentMail.PodId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.pods.QueryRatesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `MetricsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>