agentmail 0.3.8 → 0.4.0

package/dist/llms-full.txt

@@ -205,107 +205,6 @@ Get your API key from the [Console](https://console.agentmail.to) and replace `a
   ```
 </CodeBlocks>
 
-## Copy for Cursor / Claude
-
-Copy one of the blocks below into Cursor or Claude for a complete, working AgentMail integration. Each block includes setup, API reference, error handling, rate limiting, and idempotency guidance.
-
-<CodeBlocks>
-  ```python title="Python"
-  """
-  AgentMail Python Quickstart — copy into Cursor/Claude for instant setup.
-
-  Setup: pip install agentmail python-dotenv. Set AGENTMAIL_API_KEY in .env.
-
-  API reference:
-  - inboxes.create(username?, domain?, display_name?, client_id?) — client_id for idempotent retries
-  - messages.send(inbox_id, to, subject, text, html?, cc?, bcc?, reply_to?, attachments?)
-  - messages.list(inbox_id, limit?, page_token?, labels?) — receive emails; use extracted_text/extracted_html for reply content
-
-  Errors: SDK raises on 4xx/5xx. Inspect error.body.message or str(e).
-  Rate limit: 429 with Retry-After header. Implement exponential backoff for retries.
-  Idempotency: Pass client_id to inboxes.create() to safely retry without duplicates.
-  """
-  import os
-  from dotenv import load_dotenv
-  from agentmail import AgentMail
-
-  load_dotenv()
-  client = AgentMail(api_key=os.getenv("AGENTMAIL_API_KEY"))
-
-  # Create inbox (client_id enables safe retries)
-  inbox = client.inboxes.create(client_id="my-agent-inbox-v1")
-
-  # Send email
-  try:
-      client.inboxes.messages.send(
-          inbox.inbox_id,
-          to="recipient@example.com",
-          subject="Hello from AgentMail",
-          text="Plain text body",
-          html="<p>HTML body</p>",
-      )
-  except Exception as e:
-      # Handle validation, not found, rate limit (429), etc.
-      print(f"Send failed: {e}")
-      raise
-
-  # Receive messages
-  for msg in client.inboxes.messages.list(inbox.inbox_id, limit=10).messages:
-      print(msg.subject, msg.extracted_text or msg.text)
-  ```
-
-  ```typescript title="TypeScript"
-  /**
-   * AgentMail TypeScript Quickstart — copy into Cursor/Claude for instant setup.
-   *
-   * Setup: npm install agentmail dotenv. Set AGENTMAIL_API_KEY in .env.
-   *
-   * API reference:
-   * - inboxes.create({ username?, domain?, displayName?, clientId? }) — clientId for idempotent retries
-   * - messages.send(inboxId, { to, subject, text, html?, cc?, bcc?, replyTo?, attachments? })
-   * - messages.list(inboxId, { limit?, pageToken?, labels? }) — receive; use extractedText/extractedHtml for reply content
-   *
-   * Errors: SDK throws on 4xx/5xx. Check error.body?.message.
-   * Rate limit: 429 with Retry-After header. Use exponential backoff for retries.
-   * Idempotency: Pass clientId to inboxes.create() to safely retry without duplicates.
-   */
-  import { AgentMailClient } from "agentmail";
-  import "dotenv/config";
-
-  const client = new AgentMailClient({
-    apiKey: process.env.AGENTMAIL_API_KEY!,
-  });
-
-  async function main() {
-    // Create inbox (clientId enables safe retries)
-    const inbox = await client.inboxes.create({
-      clientId: "my-agent-inbox-v1",
-    });
-
-    try {
-      await client.inboxes.messages.send(inbox.inboxId, {
-        to: "recipient@example.com",
-        subject: "Hello from AgentMail",
-        text: "Plain text body",
-        html: "<p>HTML body</p>",
-      });
-    } catch (error: unknown) {
-      // Handle validation, not found, rate limit (429), etc.
-      const msg = (error as { body?: { message?: string } })?.body?.message ?? String(error);
-      throw new Error(`Send failed: ${msg}`);
-    }
-
-    // Receive messages
-    const res = await client.inboxes.messages.list(inbox.inboxId, { limit: 10 });
-    for (const msg of res.messages) {
-      console.log(msg.subject, msg.extractedText ?? msg.text);
-    }
-  }
-
-  main();
-  ```
-</CodeBlocks>
-
 <Tip>
   When receiving emails, messages include `extracted_text` and `extracted_html`
   for reply content without quoted history.
@@ -1806,30 +1705,30 @@ title: Skills
 subtitle: Add AgentMail to AI coding assistants with the official skill
 slug: integrations/skills
 description: >-
-AgentMail's official skill for OpenClaw, Claude Code, Cursor, and other AI
+AgentMail's official skill for Moltbot, Claude Code, Cursor, and other AI
 assistants
 ----------
 
 ## Getting started
 
-AgentMail provides an official skill that can be installed on AI coding assistants and agents that support the [AgentSkills](https://skills.sh) format. This includes OpenClaw, Claude Code, Cursor, Codex, and other compatible tools.
+AgentMail provides an official skill that can be installed on AI coding assistants and agents that support the [AgentSkills](https://skills.sh) format. This includes Moltbot, Claude Code, Cursor, Codex, and other compatible tools.
 
 The skill is available at [skills.sh/agentmail-to/agentmail-skills/agentmail](https://skills.sh/agentmail-to/agentmail-skills/agentmail).
 
 ## Installation
 
-### OpenClaw
+### Moltbot
 
-Install the skill using the OpenClaw CLI:
+Install the skill using the Moltbot CLI:
 
 ```bash
-openclaw skills install agentmail-to/agentmail-skills/agentmail
+moltbot skills install agentmail-to/agentmail-skills/agentmail
 ```
 
-Or install via ClawHub:
+Or install via ClawdHub:
 
 ```bash
-npx clawhub@latest install agentmail
+clawdhub install agentmail
 ```
 
 ### Claude Code
@@ -1868,9 +1767,9 @@ Set the `AGENTMAIL_API_KEY` environment variable:
 export AGENTMAIL_API_KEY="your-api-key-here"
 ```
 
-### OpenClaw configuration
+### Moltbot configuration
 
-Add the API key to `~/.openclaw/openclaw.json`:
+Add the API key to `~/.clawdbot/moltbot.json`:
 
 ```json
 {
@@ -1957,13 +1856,7 @@ The Model Context Protocol (MCP) is an open standard that enables AI application
 
 ### Setup
 
-Install with:
-
-```bash
-npx @smithery/cli@latest mcp add agentmail
-```
-
-Configure your API key when prompted. Get your key from the [AgentMail Console](https://console.agentmail.to). For more details, visit [mcp.agentmail.to](https://mcp.agentmail.to).
+To get started with the AgentMail MCP server, visit [mcp.agentmail.to](https://mcp.agentmail.to) for installation instructions and configuration details.
 
 ## Features
 
@@ -1988,25 +1881,25 @@ For detailed setup instructions and available tools, visit [mcp.agentmail.to](ht
 
 ***
 
-title: OpenClaw
-subtitle: Give your OpenClaw agent its own email inbox
+title: Openclaw
+subtitle: Give your Openclaw agent its own email inbox
 slug: integrations/openclaw
-description: AgentMail's OpenClaw integration
+description: AgentMail's Openclaw integration
 ---------------------------------------------
 
 ## Getting started
 
-OpenClaw (formerly Moltbot) is an open-source AI personal assistant that runs on your own devices and integrates with messaging platforms like WhatsApp, Telegram, Discord, and Slack. By adding AgentMail to OpenClaw, your agent gains the ability to send and receive emails, enabling two-way email conversations alongside your existing chat channels.
+Openclaw (formerly Moltbot) is an open-source AI personal assistant that runs on your own devices and integrates with messaging platforms like WhatsApp, Telegram, Discord, and Slack. By adding AgentMail to Openclaw, your agent gains the ability to send and receive emails, enabling two-way email conversations alongside your existing chat channels.
 
-There are two ways to integrate AgentMail with OpenClaw: using the official AgentMail skill or creating a custom skill.
+There are two ways to integrate AgentMail with Openclaw: using the official AgentMail skill or creating a custom skill.
 
 ## Option 1: Official AgentMail Skill (Recommended)
 
-The easiest way to add email capabilities to OpenClaw is by installing the official AgentMail skill from [skills.sh](https://skills.sh/agentmail-to/agentmail-skills/agentmail). This skill is maintained by the AgentMail team and provides comprehensive email functionality.
+The easiest way to add email capabilities to Openclaw is by installing the official AgentMail skill from [skills.sh](https://skills.sh/agentmail-to/agentmail-skills/agentmail). This skill is maintained by the AgentMail team and provides comprehensive email functionality.
 
 ### Installation
 
-Install the skill using the OpenClaw CLI:
+Install the skill using the Openclaw CLI:
 
 ```bash
 openclaw skills install agentmail-to/agentmail-skills/agentmail
@@ -2064,11 +1957,11 @@ You should see `agentmail` in the list of available skills.
 
 ## Option 2: Custom Skill
 
-For more control over the integration, you can create a custom AgentMail skill. Skills are directories containing a `SKILL.md` file with instructions for OpenClaw.
+For more control over the integration, you can create a custom AgentMail skill. Skills are directories containing a `SKILL.md` file with instructions for Openclaw.
 
 ### Create the skill directory
 
-Create a new skill in your OpenClaw workspace:
+Create a new skill in your Openclaw workspace:
 
 ```bash
 mkdir -p ~/.openclaw/skills/agentmail
@@ -2130,10 +2023,10 @@ curl -s -X POST -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
     "to": ["recipient@example.com"],
-    "subject": "Hello from OpenClaw",
+    "subject": "Hello from Openclaw",
     "text": "This email was sent by my AI assistant."
   }' \
-  https://api.agentmail.to/v0/inboxes/{inbox_id}/messages/send
+  https://api.agentmail.to/v0/inboxes/{inbox_id}/messages
 ```
 
 ### List messages in an inbox
@@ -2184,7 +2077,7 @@ You should see `agentmail` in the list of available skills.
 
 ## Example use cases
 
-Once AgentMail is integrated with OpenClaw, you can ask your agent to:
+Once AgentMail is integrated with Openclaw, you can ask your agent to:
 
 * "Create a new email inbox for my project"
 * "Check my inbox for new emails"
@@ -2194,9 +2087,9 @@ Once AgentMail is integrated with OpenClaw, you can ask your agent to:
 
 ## Real-time email notifications
 
-For proactive email handling, you can combine AgentMail webhooks with OpenClaw's webhook support. This allows OpenClaw to notify you immediately when new emails arrive.
+For proactive email handling, you can combine AgentMail webhooks with Openclaw's webhook support. This allows Openclaw to notify you immediately when new emails arrive.
 
-1. Set up a webhook endpoint in OpenClaw (see [OpenClaw webhook documentation](https://docs.openclaw.ai/automation/webhook))
+1. Set up a webhook endpoint in Openclaw (see [Openclaw webhook documentation](https://docs.openclaw.ai/automation/webhook))
 
 2. Register the webhook with AgentMail:
 
@@ -2210,14 +2103,14 @@ curl -X POST -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
   https://api.agentmail.to/v0/webhooks
 ```
 
-Now OpenClaw will be notified whenever a new email arrives, allowing it to proactively inform you or take action.
+Now Openclaw will be notified whenever a new email arrives, allowing it to proactively inform you or take action.
 
 ## Resources
 
 * [Official AgentMail Skill](https://skills.sh/agentmail-to/agentmail-skills/agentmail)
 * [AgentMail API Reference](/api-reference)
-* [OpenClaw Documentation](https://docs.openclaw.ai)
-* [OpenClaw Skills Guide](https://docs.openclaw.ai/tools/skills)
+* [Openclaw Documentation](https://docs.openclaw.ai)
+* [Openclaw Skills Guide](https://docs.openclaw.ai/tools/skills)
 
 
 ***
@@ -2748,6 +2641,10 @@ Configure IMAP and SMTP to access your AgentMail inboxes using email clients
 or programmatic access.
 -----------------------
 
+<Callout intent="warn" title="IMAP is Under Development">
+  IMAP support is currently under development and will be available in the coming weeks. The documentation below describes the planned functionality. SMTP is fully available today.
+</Callout>
+
 AgentMail supports standard IMAP and SMTP protocols, allowing you to connect using traditional email clients or integrate with existing systems that rely on these protocols.
 
 ## What are IMAP and SMTP?
@@ -8751,7 +8648,8 @@ and get support.
 </Callout>
 
 
- ---
+***
+
 title: Support
 slug: support
 description: Get help with AgentMail through our support channels.
@@ -10411,6 +10309,11 @@ paths:
           required: false
           schema:
             $ref: '#/components/schemas/type_:IncludeBlocked'
+        - name: include_trash
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:IncludeTrash'
         - name: Authorization
           in: header
           description: Bearer authentication
@@ -10477,6 +10380,10 @@ components:
       type: boolean
       description: Include blocked in results.
       title: IncludeBlocked
+    type_:IncludeTrash:
+      type: boolean
+      description: Include trash in results.
+      title: IncludeTrash
     type_:Count:
       type: integer
       description: Number of items returned.
@@ -11949,6 +11856,11 @@ paths:
           required: false
           schema:
             $ref: '#/components/schemas/type_:IncludeBlocked'
+        - name: include_trash
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:IncludeTrash'
         - name: Authorization
           in: header
           description: Bearer authentication
@@ -12015,6 +11927,10 @@ components:
       type: boolean
       description: Include blocked in results.
       title: IncludeBlocked
+    type_:IncludeTrash:
+      type: boolean
+      description: Include trash in results.
+      title: IncludeTrash
     type_:Count:
       type: integer
       description: Number of items returned.
@@ -18185,8 +18101,8 @@ client = AgentMail(
 
 client.inboxes.metrics.get(
     inbox_id="inbox_id",
-    start_timestamp=datetime.fromisoformat("2024-01-15T09:30:00Z"),
-    end_timestamp=datetime.fromisoformat("2024-01-15T09:30:00Z")
+    start_timestamp=datetime.fromisoformat("2024-01-15T09:30:00+00:00"),
+    end_timestamp=datetime.fromisoformat("2024-01-15T09:30:00+00:00")
 )
 
 ```
@@ -27194,8 +27110,8 @@ client = AgentMail(
 )
 
 client.metrics.list(
-    start_timestamp=datetime.fromisoformat("2024-01-15T09:30:00Z"),
-    end_timestamp=datetime.fromisoformat("2024-01-15T09:30:00Z")
+    start_timestamp=datetime.fromisoformat("2024-01-15T09:30:00+00:00"),
+    end_timestamp=datetime.fromisoformat("2024-01-15T09:30:00+00:00")
 )
 
 ```
@@ -30105,6 +30021,11 @@ paths:
           required: false
           schema:
             $ref: '#/components/schemas/type_:IncludeBlocked'
+        - name: include_trash
+          in: query
+          required: false
+          schema:
+            $ref: '#/components/schemas/type_:IncludeTrash'
         - name: Authorization
           in: header
           description: Bearer authentication
@@ -30171,6 +30092,10 @@ components:
       type: boolean
       description: Include blocked in results.
       title: IncludeBlocked
+    type_:IncludeTrash:
+      type: boolean
+      description: Include trash in results.
+      title: IncludeTrash
     type_:Count:
       type: integer
       description: Number of items returned.
@@ -33155,6 +33080,318 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+# Get Domain
+
+GET https://api.agentmail.to/v0/pods/{pod_id}/domains/{domain_id}
+
+Reference: https://docs.agentmail.to/api-reference/pods/domains/get
+
+## OpenAPI Specification
+
+```yaml
+openapi: 3.1.0
+info:
+  title: api
+  version: 1.0.0
+paths:
+  /v0/pods/{pod_id}/domains/{domain_id}:
+    get:
+      operationId: get
+      summary: Get Domain
+      tags:
+        - subpackage_pods.subpackage_pods/domains
+      parameters:
+        - name: pod_id
+          in: path
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_pods:PodId'
+        - name: domain_id
+          in: path
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_domains:DomainId'
+        - name: Authorization
+          in: header
+          description: Bearer authentication
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Response with status 200
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/type_domains:Domain'
+        '404':
+          description: Error response with status 404
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/type_:ErrorResponse'
+servers:
+  - url: https://api.agentmail.to
+  - url: https://x402.api.agentmail.to
+  - url: https://mpp.api.agentmail.to
+  - url: https://api.agentmail.eu
+components:
+  schemas:
+    type_pods:PodId:
+      type: string
+      description: ID of pod.
+      title: PodId
+    type_domains:DomainId:
+      type: string
+      description: The name of the domain. (e.g., " your-domain.com")
+      title: DomainId
+    type_domains:VerificationStatus:
+      type: string
+      enum:
+        - NOT_STARTED
+        - PENDING
+        - INVALID
+        - FAILED
+        - VERIFYING
+        - VERIFIED
+      title: VerificationStatus
+    type_domains:FeedbackEnabled:
+      type: boolean
+      description: Bounce and complaint notifications are sent to your inboxes.
+      title: FeedbackEnabled
+    type_domains:RecordType:
+      type: string
+      enum:
+        - TXT
+        - CNAME
+        - MX
+      title: RecordType
+    type_domains:RecordStatus:
+      type: string
+      enum:
+        - MISSING
+        - INVALID
+        - VALID
+      title: RecordStatus
+    type_domains:VerificationRecord:
+      type: object
+      properties:
+        type:
+          $ref: '#/components/schemas/type_domains:RecordType'
+          description: The type of the DNS record.
+        name:
+          type: string
+          description: The name or host of the record.
+        value:
+          type: string
+          description: The value of the record.
+        status:
+          $ref: '#/components/schemas/type_domains:RecordStatus'
+          description: The verification status of this specific record.
+        priority:
+          type: integer
+          description: The priority of the MX record.
+      required:
+        - type
+        - name
+        - value
+        - status
+      title: VerificationRecord
+    type_domains:ClientId:
+      type: string
+      description: Client ID of domain.
+      title: ClientId
+    type_domains:Domain:
+      type: object
+      properties:
+        pod_id:
+          $ref: '#/components/schemas/type_pods:PodId'
+        domain_id:
+          $ref: '#/components/schemas/type_domains:DomainId'
+        status:
+          $ref: '#/components/schemas/type_domains:VerificationStatus'
+          description: The verification status of the domain.
+        feedback_enabled:
+          $ref: '#/components/schemas/type_domains:FeedbackEnabled'
+        records:
+          type: array
+          items:
+            $ref: '#/components/schemas/type_domains:VerificationRecord'
+          description: A list of DNS records required to verify the domain.
+        client_id:
+          $ref: '#/components/schemas/type_domains:ClientId'
+        updated_at:
+          type: string
+          format: date-time
+          description: Time at which the domain was last updated.
+        created_at:
+          type: string
+          format: date-time
+          description: Time at which the domain was created.
+      required:
+        - domain_id
+        - status
+        - feedback_enabled
+        - records
+        - updated_at
+        - created_at
+      title: Domain
+    type_:ErrorName:
+      type: string
+      description: Name of error.
+      title: ErrorName
+    type_:ErrorMessage:
+      type: string
+      description: Error message.
+      title: ErrorMessage
+    type_:ErrorResponse:
+      type: object
+      properties:
+        name:
+          $ref: '#/components/schemas/type_:ErrorName'
+        message:
+          $ref: '#/components/schemas/type_:ErrorMessage'
+      required:
+        - name
+        - message
+      title: ErrorResponse
+  securitySchemes:
+    Bearer:
+      type: http
+      scheme: bearer
+
+```
+
+## SDK Code Examples
+
+```typescript
+import { AgentMailClient } from "agentmail";
+
+async function main() {
+    const client = new AgentMailClient({
+        apiKey: "YOUR_TOKEN_HERE",
+    });
+    await client.pods.domains.get("pod_id", "domain_id");
+}
+main();
+
+```
+
+```python
+from agentmail import AgentMail
+
+client = AgentMail(
+    api_key="YOUR_TOKEN_HERE"
+)
+
+client.pods.domains.get(
+    pod_id="pod_id",
+    domain_id="domain_id"
+)
+
+```
+
+```go
+package main
+
+import (
+	"fmt"
+	"net/http"
+	"io"
+)
+
+func main() {
+
+	url := "https://api.agentmail.to/v0/pods/pod_id/domains/domain_id"
+
+	req, _ := http.NewRequest("GET", url, nil)
+
+	req.Header.Add("Authorization", "Bearer <api_key>")
+
+	res, _ := http.DefaultClient.Do(req)
+
+	defer res.Body.Close()
+	body, _ := io.ReadAll(res.Body)
+
+	fmt.Println(res)
+	fmt.Println(string(body))
+
+}
+```
+
+```ruby
+require 'uri'
+require 'net/http'
+
+url = URI("https://api.agentmail.to/v0/pods/pod_id/domains/domain_id")
+
+http = Net::HTTP.new(url.host, url.port)
+http.use_ssl = true
+
+request = Net::HTTP::Get.new(url)
+request["Authorization"] = 'Bearer <api_key>'
+
+response = http.request(request)
+puts response.read_body
+```
+
+```java
+import com.mashape.unirest.http.HttpResponse;
+import com.mashape.unirest.http.Unirest;
+
+HttpResponse<String> response = Unirest.get("https://api.agentmail.to/v0/pods/pod_id/domains/domain_id")
+  .header("Authorization", "Bearer <api_key>")
+  .asString();
+```
+
+```php
+<?php
+require_once('vendor/autoload.php');
+
+$client = new \GuzzleHttp\Client();
+
+$response = $client->request('GET', 'https://api.agentmail.to/v0/pods/pod_id/domains/domain_id', [
+  'headers' => [
+    'Authorization' => 'Bearer <api_key>',
+  ],
+]);
+
+echo $response->getBody();
+```
+
+```csharp
+using RestSharp;
+
+var client = new RestClient("https://api.agentmail.to/v0/pods/pod_id/domains/domain_id");
+var request = new RestRequest(Method.GET);
+request.AddHeader("Authorization", "Bearer <api_key>");
+IRestResponse response = client.Execute(request);
+```
+
+```swift
+import Foundation
+
+let headers = ["Authorization": "Bearer <api_key>"]
+
+let request = NSMutableURLRequest(url: NSURL(string: "https://api.agentmail.to/v0/pods/pod_id/domains/domain_id")! as URL,
+                                        cachePolicy: .useProtocolCachePolicy,
+                                    timeoutInterval: 10.0)
+request.httpMethod = "GET"
+request.allHTTPHeaderFields = headers
+
+let session = URLSession.shared
+let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
+  if (error != nil) {
+    print(error as Any)
+  } else {
+    let httpResponse = response as? HTTPURLResponse
+    print(httpResponse)
+  }
+})
+
+dataTask.resume()
+```
+
 # Delete Domain
 
 DELETE https://api.agentmail.to/v0/pods/{pod_id}/domains/{domain_id}