agentmail 0.4.18 → 0.4.19

package/dist/llms.txt

@@ -30,7 +30,7 @@
 - [Guide: Multi-Tenancy](https://docs.agentmail.to/multi-tenancy.mdx): 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.mdx): A step-by-step guide to configuring your custom domain with AgentMail for enhanced branding and trust.
 - [Managing Your Domains](https://docs.agentmail.to/managing-domains.mdx): Learn how to manage your custom domains effectively using AgentMail's API for enhanced deliverability and reputation management.
-- [Webhooks Overview](https://docs.agentmail.to/overview.mdx): Learn how to use Webhooks to build responsive, event-driven email agents with AgentMail.
+- [Webhooks Overview](https://docs.agentmail.to/webhooks-overview.mdx): Learn how to use Webhooks to build responsive, event-driven email agents with AgentMail.
 - [Webhook Events](https://docs.agentmail.to/events.mdx)
 - [Webhook Setup Guide](https://docs.agentmail.to/webhook-setup.mdx): A comprehensive guide to setting up webhooks with ngrok and AgentMail, including account creation, inbox setup, and code examples.
 - [Verifying Webhooks](https://docs.agentmail.to/webhook-verification.mdx): Learn how to verify webhook signatures to secure your webhook endpoints and prevent spoofed requests.
@@ -72,6 +72,7 @@
 - [How do I prevent duplicate sends?](https://docs.agentmail.to/knowledge-base/preventing-duplicate-sends.mdx): Use idempotency to avoid sending the same email twice.
 - [Why is my domain not verifying?](https://docs.agentmail.to/knowledge-base/domain-not-verifying.mdx): What to do when your domain verification is stuck.
 - [Why are my emails bouncing?](https://docs.agentmail.to/knowledge-base/emails-bouncing.mdx): Diagnose and resolve email bounce issues.
+- [Why are my emails not showing up?](https://docs.agentmail.to/knowledge-base/inbound-emails-missing.mdx): The most common reason inbound emails go missing is that the sender's domain isn't authenticated.
 - [DNS Guide: Cloudflare](https://docs.agentmail.to/knowledge-base/dns-cloudflare.mdx): Step-by-step instructions for adding AgentMail DNS records in Cloudflare.
 - [DNS Guide: GoDaddy](https://docs.agentmail.to/knowledge-base/dns-godaddy.mdx): Step-by-step instructions for adding AgentMail DNS records in GoDaddy.
 - [DNS Guide: Route 53 (AWS)](https://docs.agentmail.to/knowledge-base/dns-route53.mdx): Step-by-step instructions for adding AgentMail DNS records in AWS Route 53.
@@ -191,3 +192,10 @@
 The raw OpenAPI 3.1 specification for this API is available at:
 - [OpenAPI JSON](https://docs.agentmail.to/openapi.json)
 - [OpenAPI YAML](https://docs.agentmail.to/openapi.yaml)
+
+
+## AsyncAPI Specification
+
+The raw AsyncAPI 2.6.0 specification for the WebSocket channels is available at:
+- [AsyncAPI JSON](https://docs.agentmail.to/asyncapi.json)
+- [AsyncAPI YAML](https://docs.agentmail.to/asyncapi.yaml)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agentmail",
-    "version": "0.4.18",
+    "version": "0.4.19",
     "private": false,
     "repository": {
         "type": "git",
@@ -132,6 +132,17 @@
             },
             "default": "./dist/cjs/api/resources/inboxes/resources/drafts/exports.js"
         },
+        "./inboxes/events": {
+            "import": {
+                "types": "./dist/esm/api/resources/inboxes/resources/events/exports.d.mts",
+                "default": "./dist/esm/api/resources/inboxes/resources/events/exports.mjs"
+            },
+            "require": {
+                "types": "./dist/cjs/api/resources/inboxes/resources/events/exports.d.ts",
+                "default": "./dist/cjs/api/resources/inboxes/resources/events/exports.js"
+            },
+            "default": "./dist/cjs/api/resources/inboxes/resources/events/exports.js"
+        },
         "./inboxes/lists": {
             "import": {
                 "types": "./dist/esm/api/resources/inboxes/resources/lists/exports.d.mts",

package/reference.md

@@ -80,7 +80,7 @@ await client.inboxes.list();
 
 **CLI:**
 ```bash
-agentmail inboxes retrieve --inbox-id <inbox_id>
+agentmail inboxes get --inbox-id <inbox_id>
 ```
 </dd>
 </dl>
@@ -421,7 +421,7 @@ await client.pods.list();
 
 **CLI:**
 ```bash
-agentmail pods retrieve --pod-id <pod_id>
+agentmail pods get --pod-id <pod_id>
 ```
 </dd>
 </dl>
@@ -686,7 +686,7 @@ await client.webhooks.list();
 
 **CLI:**
 ```bash
-agentmail webhooks retrieve --webhook-id <webhook_id>
+agentmail webhooks get --webhook-id <webhook_id>
 ```
 </dd>
 </dl>
@@ -1379,7 +1379,7 @@ await client.domains.list();
 
 **CLI:**
 ```bash
-agentmail domains retrieve --domain-id <domain_id>
+agentmail domains get --domain-id <domain_id>
 ```
 </dd>
 </dl>
@@ -1853,7 +1853,7 @@ await client.drafts.list();
 
 **CLI:**
 ```bash
-agentmail drafts retrieve --draft-id <draft_id>
+agentmail drafts get --draft-id <draft_id>
 ```
 </dd>
 </dl>
@@ -2291,7 +2291,7 @@ await client.inboxes.drafts.list("inbox_id");
 
 **CLI:**
 ```bash
-agentmail inboxes:drafts retrieve --inbox-id <inbox_id> --draft-id <draft_id>
+agentmail inboxes:drafts get --inbox-id <inbox_id> --draft-id <draft_id>
 ```
 </dd>
 </dl>
@@ -2741,6 +2741,83 @@ await client.inboxes.drafts.send("inbox_id", "draft_id", {});
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+## Inboxes Events
+<details><summary><code>client.inboxes.events.<a href="/src/api/resources/inboxes/resources/events/client/Client.ts">list</a>(inbox_id, { ...params }) -> AgentMail.ListInboxEventsResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+List label change events for an inbox. Returns events in reverse chronological order by default. Use for IMAP UID projection or audit logging.
+
+**CLI:**
+```bash
+agentmail inboxes:events list --inbox-id <inbox_id>
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.inboxes.events.list("inbox_id");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**inbox_id:** `AgentMail.InboxId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.inboxes.ListInboxEventsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `EventsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -2850,7 +2927,7 @@ await client.inboxes.lists.list("inbox_id", "send", "allow");
 
 **CLI:**
 ```bash
-agentmail inboxes:lists retrieve --inbox-id <inbox_id> --direction <direction> --type <type> --entry <entry>
+agentmail inboxes:lists get --inbox-id <inbox_id> --direction <direction> --type <type> --entry <entry>
 ```
 </dd>
 </dl>
@@ -3197,7 +3274,7 @@ await client.inboxes.messages.list("inbox_id");
 
 **CLI:**
 ```bash
-agentmail inboxes:messages retrieve --inbox-id <inbox_id> --message-id <message_id>
+agentmail inboxes:messages get --inbox-id <inbox_id> --message-id <message_id>
 ```
 </dd>
 </dl>
@@ -4055,7 +4132,7 @@ await client.inboxes.threads.list("inbox_id");
 
 **CLI:**
 ```bash
-agentmail inboxes:threads retrieve --inbox-id <inbox_id> --thread-id <thread_id>
+agentmail inboxes:threads get --inbox-id <inbox_id> --thread-id <thread_id>
 ```
 </dd>
 </dl>
@@ -4457,7 +4534,7 @@ await client.lists.list("send", "allow");
 
 **CLI:**
 ```bash
-agentmail lists retrieve --direction <direction> --type <type> --entry <entry>
+agentmail lists get --direction <direction> --type <type> --entry <entry>
 ```
 </dd>
 </dl>
@@ -4771,7 +4848,12 @@ await client.metrics.query();
 <dl>
 <dd>
 
-Get the current organization.
+Returns the organization for the authenticated API key (usage limits, counts, and billing metadata).
+
+**CLI:**
+```bash
+agentmail organizations get
+```
 </dd>
 </dl>
 </dd>
@@ -5126,7 +5208,7 @@ await client.pods.domains.list("pod_id");
 
 **CLI:**
 ```bash
-agentmail pods:domains retrieve --pod-id <pod_id> --domain-id <domain_id>
+agentmail pods:domains get --pod-id <pod_id> --domain-id <domain_id>
 ```
 </dd>
 </dl>
@@ -5656,7 +5738,7 @@ await client.pods.drafts.list("pod_id");
 
 **CLI:**
 ```bash
-agentmail pods:drafts retrieve --pod-id <pod_id> --draft-id <draft_id>
+agentmail pods:drafts get --pod-id <pod_id> --draft-id <draft_id>
 ```
 </dd>
 </dl>
@@ -5887,7 +5969,7 @@ await client.pods.inboxes.list("pod_id");
 
 **CLI:**
 ```bash
-agentmail pods:inboxes retrieve --pod-id <pod_id> --inbox-id <inbox_id>
+agentmail pods:inboxes get --pod-id <pod_id> --inbox-id <inbox_id>
 ```
 </dd>
 </dl>
@@ -6284,7 +6366,7 @@ await client.pods.lists.list("pod_id", "send", "allow");
 
 **CLI:**
 ```bash
-agentmail pods:lists retrieve --pod-id <pod_id> --direction <direction> --type <type> --entry <entry>
+agentmail pods:lists get --pod-id <pod_id> --direction <direction> --type <type> --entry <entry>
 ```
 </dd>
 </dl>
@@ -6706,7 +6788,7 @@ await client.pods.threads.list("pod_id");
 
 **CLI:**
 ```bash
-agentmail pods:threads retrieve --pod-id <pod_id> --thread-id <thread_id>
+agentmail pods:threads get --pod-id <pod_id> --thread-id <thread_id>
 ```
 </dd>
 </dl>
@@ -7092,7 +7174,7 @@ await client.threads.list();
 
 **CLI:**
 ```bash
-agentmail threads retrieve --thread-id <thread_id>
+agentmail threads get --thread-id <thread_id>
 ```
 </dd>
 </dl>
@@ -7158,7 +7240,7 @@ await client.threads.get("thread_id");
 
 **CLI:**
 ```bash
-agentmail threads retrieve-attachment --thread-id <thread_id> --attachment-id <attachment_id>
+agentmail threads get-attachment --thread-id <thread_id> --attachment-id <attachment_id>
 ```
 </dd>
 </dl>