agentmail 0.5.15 → 0.5.17

package/dist/llms.txt

@@ -46,13 +46,14 @@
 - [WebSockets](https://docs.agentmail.to/websockets.md): Learn how to use WebSockets for instant email notifications without webhooks or polling.
 - [WebSockets Quickstart](https://docs.agentmail.to/websockets/quickstart.md): Get started with real-time email event streaming
 - [Email Deliverability](https://docs.agentmail.to/email-deliverability.md): Learn the strategies and best practices for maximizing your email deliverability with AgentMail.
-- [Idempotent Requests](https://docs.agentmail.to/idempotency.md): A guide to using the client_id parameter in AgentMail to prevent duplicate resources and safely retry API requests.
+- [Idempotent Requests](https://docs.agentmail.to/idempotency.md): A guide to preventing duplicate resources with client_id and preventing duplicate email sends with the Idempotency-Key header.
 - [Example: Event-Driven Agent](https://docs.agentmail.to/webhook-agent.md): A step-by-step guide to building a sophisticated agent that performs proactive outreach and uses webhooks for inbound message processing.
 - [Auto-Reply Email Agent](https://docs.agentmail.to/documentation/examples/auto-reply-agent.md): Build a simple agent that automatically responds to incoming emails with personalized messages
 - [Smart Email Labeling Agent](https://docs.agentmail.to/documentation/examples/smart-labeling-agent.md): Build an AI-powered agent that automatically classifies and labels incoming emails across multiple dimensions
 - [Sales Agent with WebSocket](https://docs.agentmail.to/sales-agent-websocket.md): A step-by-step guide to building an AI-powered sales agent that uses WebSocket for real-time email processing without polling or webhooks.
 - [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.
@@ -116,9 +117,6 @@
 - API Reference > Inboxes > Messages [Reply To Message](https://docs.agentmail.to/api-reference/inboxes/messages/reply.md)
 - API Reference > Inboxes > Messages [Reply All Message](https://docs.agentmail.to/api-reference/inboxes/messages/reply-all.md)
 - API Reference > Inboxes > Messages [Forward Message](https://docs.agentmail.to/api-reference/inboxes/messages/forward.md)
-- API Reference > Inboxes > Messages [Create Draft Reply](https://docs.agentmail.to/api-reference/inboxes/messages/draft-reply.md)
-- API Reference > Inboxes > Messages [Create Draft Reply All](https://docs.agentmail.to/api-reference/inboxes/messages/draft-reply-all.md)
-- API Reference > Inboxes > Messages [Create Draft Forward](https://docs.agentmail.to/api-reference/inboxes/messages/draft-forward.md)
 - API Reference > Inboxes > Drafts [List Drafts](https://docs.agentmail.to/api-reference/inboxes/drafts/list.md)
 - API Reference > Inboxes > Drafts [Get Draft](https://docs.agentmail.to/api-reference/inboxes/drafts/get.md)
 - API Reference > Inboxes > Drafts [Get Attachment](https://docs.agentmail.to/api-reference/inboxes/drafts/get-attachment.md)

package/package.json

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

package/reference.md

@@ -1295,6 +1295,356 @@ await client.apiKeys.delete("api_key_id");
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.apiKeys.<a href="/src/api/resources/apiKeys/client/Client.ts">listPublicKeys</a>({ ...params }) -> AgentMail.ListPublicKeysResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+List only public-key credentials visible to the bearer caller's scope.
+Bearer credentials are never returned, even though both credential types
+share storage and pagination indexes. Requires `api_key_read`.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.apiKeys.listPublicKeys();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.ListPublicKeysRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ApiKeysClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.apiKeys.<a href="/src/api/resources/apiKeys/client/Client.ts">createPublicKey</a>({ ...params }) -> AgentMail.PublicKeyCredential</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Register a public P-256 JWK using an existing AgentMail bearer API key
+with `api_key_create`. Re-registering the same JWK creates a new
+credential ID; it does not replace or recover an earlier credential.
+The private key must never be sent to AgentMail.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.apiKeys.createPublicKey({
+    publicKey: {
+        kty: "EC",
+        crv: "P-256",
+        x: "blackcurrant...............................",
+        y: "blackcurrant..............................."
+    }
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.CreatePublicKeyRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ApiKeysClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.apiKeys.<a href="/src/api/resources/apiKeys/client/Client.ts">updatePublicKeyName</a>(api_key_id, { ...params }) -> AgentMail.PublicKeyCredential</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Rename the credential. All security-relevant fields are immutable.
+Requires `api_key_update`.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.apiKeys.updatePublicKeyName("d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", {
+    name: "x"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**api_key_id:** `string` — Public-key credential ID returned by registration.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.UpdatePublicKeyNameRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ApiKeysClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.apiKeys.<a href="/src/api/resources/apiKeys/client/Client.ts">revokePublicKey</a>(api_key_id) -> void</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Permanently revoke one public-key credential. This hard-deletes the
+credential; repeating the request returns not found. Requires
+`api_key_delete`.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.apiKeys.revokePublicKey("d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**api_key_id:** `string` — Public-key credential ID returned by registration.
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ApiKeysClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.apiKeys.<a href="/src/api/resources/apiKeys/client/Client.ts">revokeAllAgentIdSignInKeys</a>({ ...params }) -> AgentMail.RevokeAllAgentIdSignInKeysResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Invalidate every current public-key credential in the caller's
+organization by advancing its AgentID key generation. The caller must be
+organization-scoped and either have `api_key_delete` or, for a verified
+self-serve agent organization, use an unrestricted unmanaged bearer
+credential. No request body is accepted.
+
+`Idempotency-Key` is required and must be a UUID. Reusing the same UUID
+returns the original permanent receipt without advancing the generation
+again. A new UUID performs a new generation advance.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.apiKeys.revokeAllAgentIdSignInKeys({
+    idempotencyKey: "Idempotency-Key"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentMail.RevokeAllAgentIdSignInKeysRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ApiKeysClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -4833,7 +5183,7 @@ await client.inboxes.threads.update("inbox_id", "thread_id", {});
 </dl>
 </details>
 
-<details><summary><code>client.inboxes.threads.<a href="/src/api/resources/inboxes/resources/threads/client/Client.ts">delete</a>(inbox_id, thread_id, { ...params }) -> void</code></summary>
+<details><summary><code>client.inboxes.threads.<a href="/src/api/resources/inboxes/resources/threads/client/Client.ts">delete</a>(inbox_id, thread_id) -> void</code></summary>
 <dl>
 <dd>
 
@@ -4845,7 +5195,7 @@ await client.inboxes.threads.update("inbox_id", "thread_id", {});
 <dl>
 <dd>
 
-Moves the thread to trash by adding a trash label to all messages. If the thread is already in trash, it will be permanently deleted. Use `permanent=true` to force permanent deletion.
+Permanently deletes a thread and all of its messages.
 
 **CLI:**
 ```bash
@@ -4897,14 +5247,6 @@ await client.inboxes.threads.delete("inbox_id", "thread_id");
 <dl>
 <dd>
 
-**request:** `AgentMail.inboxes.DeleteThreadRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
 **requestOptions:** `ThreadsClient.RequestOptions` 
     
 </dd>
@@ -8107,7 +8449,7 @@ await client.pods.threads.update("pod_id", "thread_id", {});
 </dl>
 </details>
 
-<details><summary><code>client.pods.threads.<a href="/src/api/resources/pods/resources/threads/client/Client.ts">delete</a>(pod_id, thread_id, { ...params }) -> void</code></summary>
+<details><summary><code>client.pods.threads.<a href="/src/api/resources/pods/resources/threads/client/Client.ts">delete</a>(pod_id, thread_id) -> void</code></summary>
 <dl>
 <dd>
 
@@ -8119,7 +8461,7 @@ await client.pods.threads.update("pod_id", "thread_id", {});
 <dl>
 <dd>
 
-Moves the thread to trash by adding a trash label to all messages. If the thread is already in trash, it will be permanently deleted. Use `permanent=true` to force permanent deletion.
+Permanently deletes a thread and all of its messages.
 
 **CLI:**
 ```bash
@@ -8171,14 +8513,6 @@ await client.pods.threads.delete("pod_id", "thread_id");
 <dl>
 <dd>
 
-**request:** `AgentMail.pods.DeleteThreadRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
 **requestOptions:** `ThreadsClient.RequestOptions` 
     
 </dd>
@@ -8928,7 +9262,7 @@ await client.threads.update("thread_id", {});
 </dl>
 </details>
 
-<details><summary><code>client.threads.<a href="/src/api/resources/threads/client/Client.ts">delete</a>(thread_id, { ...params }) -> void</code></summary>
+<details><summary><code>client.threads.<a href="/src/api/resources/threads/client/Client.ts">delete</a>(thread_id) -> void</code></summary>
 <dl>
 <dd>
 
@@ -8940,7 +9274,7 @@ await client.threads.update("thread_id", {});
 <dl>
 <dd>
 
-Moves the thread to trash by adding a trash label to all messages. If the thread is already in trash, it will be permanently deleted. Use `permanent=true` to force permanent deletion.
+Permanently deletes a thread and all of its messages.
 
 **CLI:**
 ```bash
@@ -8984,14 +9318,6 @@ await client.threads.delete("thread_id");
 <dl>
 <dd>
 
-**request:** `AgentMail.DeleteThreadRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
 **requestOptions:** `ThreadsClient.RequestOptions` 
     
 </dd>

package/dist/cjs/api/resources/inboxes/resources/threads/client/requests/DeleteThreadRequest.d.ts

@@ -1,8 +0,0 @@
-/**
- * @example
- *     {}
- */
-export interface DeleteThreadRequest {
-    /** If true, permanently delete the thread instead of moving to trash. */
-    permanent?: boolean;
-}

package/dist/cjs/api/resources/pods/resources/threads/client/requests/DeleteThreadRequest.d.ts

@@ -1,8 +0,0 @@
-/**
- * @example
- *     {}
- */
-export interface DeleteThreadRequest {
-    /** If true, permanently delete the thread instead of moving to trash. */
-    permanent?: boolean;
-}

package/dist/cjs/api/resources/threads/client/requests/DeleteThreadRequest.d.ts

@@ -1,8 +0,0 @@
-/**
- * @example
- *     {}
- */
-export interface DeleteThreadRequest {
-    /** If true, permanently delete the thread instead of moving to trash. */
-    permanent?: boolean;
-}

package/dist/esm/api/resources/inboxes/resources/threads/client/requests/DeleteThreadRequest.d.mts

@@ -1,8 +0,0 @@
-/**
- * @example
- *     {}
- */
-export interface DeleteThreadRequest {
-    /** If true, permanently delete the thread instead of moving to trash. */
-    permanent?: boolean;
-}

package/dist/esm/api/resources/pods/resources/threads/client/requests/DeleteThreadRequest.d.mts

@@ -1,8 +0,0 @@
-/**
- * @example
- *     {}
- */
-export interface DeleteThreadRequest {
-    /** If true, permanently delete the thread instead of moving to trash. */
-    permanent?: boolean;
-}

package/dist/esm/api/resources/threads/client/requests/DeleteThreadRequest.d.mts

@@ -1,8 +0,0 @@
-/**
- * @example
- *     {}
- */
-export interface DeleteThreadRequest {
-    /** If true, permanently delete the thread instead of moving to trash. */
-    permanent?: boolean;
-}