agentmail 0.5.10 → 0.5.12

package/dist/llms.txt

@@ -6,7 +6,6 @@
 
 - For clean Markdown of any page, append `.md` to the page URL
 - For a complete documentation index, see https://docs.agentmail.to/llms.txt
-- For full documentation content in one file, see https://docs.agentmail.to/llms-full.txt
 - For section-specific indexes, append `/llms.txt` to any section URL
 - For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.agentmail.to/_mcp/server
 

package/package.json

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

package/reference.md

@@ -3553,6 +3553,89 @@ await client.inboxes.messages.batchGet("inbox_id", {
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.inboxes.messages.<a href="/src/api/resources/inboxes/resources/messages/client/Client.ts">batchUpdate</a>(inbox_id, { ...params }) -> AgentMail.BatchUpdateMessagesResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Apply one label change to up to 50 messages in a single request. The
+same add_labels and remove_labels apply to every message id, and at
+least one of them must be provided. The update is atomic: either all
+resolved messages are updated or none are. Missing or restricted ids
+are silently excluded; compare `count` against `limit` to detect
+exclusions.
+
+**CLI:**
+```bash
+agentmail inboxes:messages batch-update --inbox-id <inbox_id> --message-id <id1> --message-id <id2> --add-label read --remove-label unread
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.inboxes.messages.batchUpdate("inbox_id", {
+    messageIds: ["message_ids", "message_ids"]
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**inbox_id:** `AgentMail.InboxId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.BatchUpdateMessagesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `MessagesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -4192,7 +4275,7 @@ await client.inboxes.messages.forward("inbox_id", "message_id", {});
 </details>
 
 ## Inboxes Metrics
-<details><summary><code>client.inboxes.metrics.<a href="/src/api/resources/inboxes/resources/metrics/client/Client.ts">query</a>(inbox_id, { ...params }) -> AgentMail.QueryMetricsResponse</code></summary>
+<details><summary><code>client.inboxes.metrics.<a href="/src/api/resources/inboxes/resources/metrics/client/Client.ts">queryEvents</a>(inbox_id, { ...params }) -> AgentMail.QueryMetricsResponse</code></summary>
 <dl>
 <dd>
 
@@ -4204,6 +4287,12 @@ await client.inboxes.messages.forward("inbox_id", "message_id", {});
 <dl>
 <dd>
 
+Counts of email events (sent, delivered, bounced, etc.) over time for
+the inbox. Defaults to the last 24 hours; `start` must be within the
+last 90 days, and a future `end` is clamped to now. Omit `period` for
+individual event counts, or set it to sum counts into buckets of that
+many seconds.
+
 **CLI:**
 ```bash
 agentmail inboxes:metrics query --inbox-id <inbox_id>
@@ -4222,7 +4311,7 @@ agentmail inboxes:metrics query --inbox-id <inbox_id>
 <dd>
 
 ```typescript
-await client.inboxes.metrics.query("inbox_id");
+await client.inboxes.metrics.queryEvents("inbox_id");
 
 ```
 </dd>
@@ -4246,7 +4335,84 @@ await client.inboxes.metrics.query("inbox_id");
 <dl>
 <dd>
 
-**request:** `AgentMail.inboxes.QueryMetricsRequest` 
+**request:** `AgentMail.inboxes.QueryEventsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `MetricsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.inboxes.metrics.<a href="/src/api/resources/inboxes/resources/metrics/client/Client.ts">queryUsage</a>(inbox_id, { ...params }) -> AgentMail.QueryUsageResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Cumulative usage series for the inbox. Each point is the running total
+of the usage type at that timestamp, not the change within the bucket.
+Inbox-scoped queries carry `storage_bytes`, `message_count`, and
+`thread_count`; requested types that don't apply to the scope are
+ignored. Defaults to the last 24 hours; `start` must be within the
+last 90 days, and a future `end` is clamped to now. The range divided
+by `period` must not exceed 1000 buckets.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.inboxes.metrics.queryUsage("inbox_id");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**inbox_id:** `AgentMail.InboxId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.inboxes.QueryUsageRequest` 
     
 </dd>
 </dl>
@@ -5073,7 +5239,7 @@ await client.lists.delete("send", "allow", "entry");
 </details>
 
 ## Metrics
-<details><summary><code>client.metrics.<a href="/src/api/resources/metrics/client/Client.ts">query</a>({ ...params }) -> AgentMail.QueryMetricsResponse</code></summary>
+<details><summary><code>client.metrics.<a href="/src/api/resources/metrics/client/Client.ts">queryEvents</a>({ ...params }) -> AgentMail.QueryMetricsResponse</code></summary>
 <dl>
 <dd>
 
@@ -5085,6 +5251,12 @@ await client.lists.delete("send", "allow", "entry");
 <dl>
 <dd>
 
+Counts of email events (sent, delivered, bounced, etc.) over time for
+the organization. Defaults to the last 24 hours; `start` must be within
+the last 90 days, and a future `end` is clamped to now. Omit `period`
+for individual event counts, or set it to sum counts into buckets of
+that many seconds.
+
 **CLI:**
 ```bash
 agentmail metrics list
@@ -5103,7 +5275,7 @@ agentmail metrics list
 <dd>
 
 ```typescript
-await client.metrics.query();
+await client.metrics.queryEvents();
 
 ```
 </dd>
@@ -5119,7 +5291,74 @@ await client.metrics.query();
 <dl>
 <dd>
 
-**request:** `AgentMail.QueryMetricsRequest` 
+**request:** `AgentMail.QueryEventsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `MetricsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.metrics.<a href="/src/api/resources/metrics/client/Client.ts">queryUsage</a>({ ...params }) -> AgentMail.QueryUsageResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Cumulative usage series for the organization. Each point is the running
+total of the usage type at that timestamp, not the change within the
+bucket. Defaults to the last 24 hours; `start` must be within the last
+90 days, and a future `end` is clamped to now. The range divided by
+`period` must not exceed 1000 buckets.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.metrics.queryUsage();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.QueryUsageRequest` 
     
 </dd>
 </dl>
@@ -6926,7 +7165,7 @@ await client.pods.lists.delete("pod_id", "send", "allow", "entry");
 </details>
 
 ## Pods Metrics
-<details><summary><code>client.pods.metrics.<a href="/src/api/resources/pods/resources/metrics/client/Client.ts">query</a>(pod_id, { ...params }) -> AgentMail.QueryMetricsResponse</code></summary>
+<details><summary><code>client.pods.metrics.<a href="/src/api/resources/pods/resources/metrics/client/Client.ts">queryEvents</a>(pod_id, { ...params }) -> AgentMail.QueryMetricsResponse</code></summary>
 <dl>
 <dd>
 
@@ -6938,6 +7177,12 @@ await client.pods.lists.delete("pod_id", "send", "allow", "entry");
 <dl>
 <dd>
 
+Counts of email events (sent, delivered, bounced, etc.) over time for
+the pod. Defaults to the last 24 hours; `start` must be within the last
+90 days, and a future `end` is clamped to now. Omit `period` for
+individual event counts, or set it to sum counts into buckets of that
+many seconds.
+
 **CLI:**
 ```bash
 agentmail pods:metrics query --pod-id <pod_id>
@@ -6956,7 +7201,84 @@ agentmail pods:metrics query --pod-id <pod_id>
 <dd>
 
 ```typescript
-await client.pods.metrics.query("pod_id");
+await client.pods.metrics.queryEvents("pod_id");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**pod_id:** `AgentMail.PodId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.pods.QueryEventsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `MetricsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.pods.metrics.<a href="/src/api/resources/pods/resources/metrics/client/Client.ts">queryUsage</a>(pod_id, { ...params }) -> AgentMail.QueryUsageResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Cumulative usage series for the pod. Each point is the running total of
+the usage type at that timestamp, not the change within the bucket.
+Pod-scoped queries carry every usage type except `pod_count`; requested
+types that don't apply to the scope are ignored. Defaults to the last
+24 hours; `start` must be within the last 90 days, and a future `end`
+is clamped to now. The range divided by `period` must not exceed 1000
+buckets.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.pods.metrics.queryUsage("pod_id");
 
 ```
 </dd>
@@ -6980,7 +7302,7 @@ await client.pods.metrics.query("pod_id");
 <dl>
 <dd>
 
-**request:** `AgentMail.pods.QueryMetricsRequest` 
+**request:** `AgentMail.pods.QueryUsageRequest` 
     
 </dd>
 </dl>