agentmail 0.2.6 → 0.2.9

package/dist/llms-full.txt

@@ -1516,6 +1516,143 @@ Pod: "Marketing-Agent"
 * Explore [Domains](/custom-domains) to set up custom email domains for your pods
 
 
+# Skills
+
+> 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 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
+
+### Moltbot
+
+Install the skill using the Moltbot CLI:
+
+```bash
+moltbot skills install agentmail-to/agentmail-skills/agentmail
+```
+
+Or install via ClawdHub:
+
+```bash
+clawdhub install agentmail
+```
+
+### Claude Code
+
+Add the skill to your Claude Code configuration:
+
+```bash
+claude-code skills install agentmail-to/agentmail-skills/agentmail
+```
+
+### Cursor
+
+Install the skill in Cursor:
+
+```bash
+cursor skills install agentmail-to/agentmail-skills/agentmail
+```
+
+### Manual installation
+
+You can also manually clone the skill repository:
+
+```bash
+git clone https://github.com/agentmail-to/agentmail-skills.git ~/.skills/agentmail
+```
+
+## Configuration
+
+After installation, configure your AgentMail API key. The method varies by platform:
+
+### Environment variable
+
+Set the `AGENTMAIL_API_KEY` environment variable:
+
+```bash
+export AGENTMAIL_API_KEY="your-api-key-here"
+```
+
+### Moltbot configuration
+
+Add the API key to `~/.clawdbot/moltbot.json`:
+
+```json
+{
+  "skills": {
+    "entries": {
+      "agentmail": {
+        "enabled": true,
+        "env": {
+          "AGENTMAIL_API_KEY": "your-api-key-here"
+        }
+      }
+    }
+  }
+}
+```
+
+Get your API key from the [AgentMail Console](https://console.agentmail.to).
+
+## Features
+
+The official AgentMail skill provides comprehensive email functionality:
+
+### Inboxes
+
+Create scalable inboxes on-demand. Each inbox has a unique email address that your AI agent can use to send and receive emails.
+
+### Messages
+
+Send emails with both plain text and HTML content for best deliverability. The skill handles proper formatting and headers automatically.
+
+### Threads
+
+Threads group related messages in a conversation, making it easy to follow email chains and maintain context across multiple exchanges.
+
+### Attachments
+
+Send and receive attachments with Base64 encoding. The skill can retrieve attachments from messages or threads.
+
+### Drafts
+
+Create drafts for human-in-the-loop approval before sending. This is useful when you want to review emails before they go out.
+
+### Pods
+
+Multi-tenant isolation for SaaS platforms. Each customer gets isolated inboxes, perfect for building email-enabled applications.
+
+### Idempotency
+
+Use idempotency keys for safe retries on create operations. This prevents duplicate emails when network errors occur.
+
+### Real-time events
+
+The skill supports both WebSockets (persistent connection, no public URL needed) and webhooks (HTTP-based notifications) for real-time email notifications.
+
+## Example usage
+
+Once installed, you can ask your AI assistant to perform email tasks:
+
+* "Create a new email inbox for my project"
+* "Send an email to [john@example.com](mailto:john@example.com) about the meeting tomorrow"
+* "Check my inbox for new emails"
+* "Reply to the latest email from Sarah"
+* "Create a draft response to the support ticket"
+
+## Resources
+
+* [Official AgentMail Skill on skills.sh](https://skills.sh/agentmail-to/agentmail-skills/agentmail)
+* [AgentMail Skills Repository](https://github.com/agentmail-to/agentmail-skills)
+* [AgentMail API Reference](/api-reference)
+* [AgentMail Console](https://console.agentmail.to)
+
+
 # MCP
 
 > AgentMail's Model Context Protocol (MCP) integration
@@ -1549,6 +1686,284 @@ The AgentMail MCP server works with any MCP-compatible client, including:
 For detailed setup instructions and available tools, visit [mcp.agentmail.to](https://mcp.agentmail.to).
 
 
+# Moltbot
+
+> AgentMail's Moltbot (Clawdbot) integration
+
+## Getting started
+
+Moltbot (formerly Clawdbot) 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 Moltbot, your agent gains the ability to send and receive emails, enabling two-way email conversations alongside your existing chat channels.
+
+There are three ways to integrate AgentMail with Moltbot: using the official AgentMail skill, the AgentMail MCP server, or creating a custom skill.
+
+## Option 1: Official AgentMail Skill (Recommended)
+
+The easiest way to add email capabilities to Moltbot 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 Moltbot CLI:
+
+```bash
+moltbot skills install agentmail-to/agentmail-skills/agentmail
+```
+
+Or install via ClawdHub:
+
+```bash
+clawdhub install agentmail
+```
+
+### Configuration
+
+Add your AgentMail API key to the skill configuration in `~/.clawdbot/moltbot.json`:
+
+```json
+{
+  "skills": {
+    "entries": {
+      "agentmail": {
+        "enabled": true,
+        "env": {
+          "AGENTMAIL_API_KEY": "your-api-key-here"
+        }
+      }
+    }
+  }
+}
+```
+
+Get your API key from the [AgentMail Console](https://console.agentmail.to).
+
+### Features
+
+The official skill includes:
+
+* **Inbox management:** Create scalable inboxes on-demand with unique email addresses
+* **Message operations:** Send emails with text and HTML content for best deliverability
+* **Thread management:** Group related messages in conversations
+* **Attachments:** Send and receive attachments with Base64 encoding
+* **Drafts:** Create drafts for human-in-the-loop approval before sending
+* **Pods:** Multi-tenant isolation for SaaS platforms
+* **Idempotency:** Safe retries on create operations
+* **Real-time events:** WebSocket and webhook support for notifications
+
+### Verify installation
+
+Check that the skill is loaded:
+
+```bash
+moltbot skills list --eligible
+```
+
+You should see `agentmail` in the list of available skills.
+
+## Option 2: MCP Server
+
+An alternative way to add email capabilities to Moltbot is through the AgentMail MCP server. Moltbot supports MCP (Model Context Protocol) servers, which allows it to connect to external tools like AgentMail.
+
+### Setup
+
+1. Get your AgentMail API key from the [AgentMail Console](https://console.agentmail.to).
+
+2. Add the AgentMail MCP server to your Moltbot configuration. Edit your `~/.clawdbot/moltbot.json` file:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "agentmail": {
+        "command": "npx",
+        "args": ["-y", "@agentmail/mcp-server"],
+        "env": {
+          "AGENTMAIL_API_KEY": "your-api-key-here"
+        }
+      }
+    }
+  }
+}
+```
+
+3. Restart Moltbot to load the new MCP server:
+
+```bash
+moltbot restart
+```
+
+4. Verify the integration by asking Moltbot to list your inboxes:
+
+```
+List my AgentMail inboxes
+```
+
+### Available tools
+
+Once connected, Moltbot can use the following AgentMail tools:
+
+* **Inbox management:** Create, list, and delete inboxes
+* **Message operations:** Send, receive, and reply to emails
+* **Thread management:** Access and manage email threads
+* **Attachments:** Handle email attachments
+
+## Option 3: 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 Moltbot.
+
+### Create the skill directory
+
+Create a new skill in your Moltbot workspace:
+
+```bash
+mkdir -p ~/.clawdbot/skills/agentmail
+```
+
+### Create the skill file
+
+Create `~/.clawdbot/skills/agentmail/SKILL.md` with the following content:
+
+````markdown
+---
+name: agentmail
+description: Send and receive emails using AgentMail
+requires:
+  env:
+    - AGENTMAIL_API_KEY
+---
+
+# AgentMail Skill
+
+You can send and receive emails using the AgentMail API. Use the `exec` tool to run curl commands against the AgentMail API.
+
+## API Base URL
+
+```
+https://api.agentmail.to/v1
+```
+
+## Authentication
+
+Include your API key in the Authorization header:
+
+```
+Authorization: Bearer $AGENTMAIL_API_KEY
+```
+
+## Common Operations
+
+### List inboxes
+
+```bash
+curl -s -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
+  https://api.agentmail.to/v1/inboxes
+```
+
+### Create an inbox
+
+```bash
+curl -s -X POST -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"display_name": "My Agent"}' \
+  https://api.agentmail.to/v1/inboxes
+```
+
+### Send an email
+
+```bash
+curl -s -X POST -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "to": ["recipient@example.com"],
+    "subject": "Hello from Moltbot",
+    "text": "This email was sent by my AI assistant."
+  }' \
+  https://api.agentmail.to/v1/inboxes/{inbox_id}/messages
+```
+
+### List messages in an inbox
+
+```bash
+curl -s -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
+  https://api.agentmail.to/v1/inboxes/{inbox_id}/messages
+```
+
+### Reply to a message
+
+```bash
+curl -s -X POST -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"text": "Thanks for your email!"}' \
+  https://api.agentmail.to/v1/inboxes/{inbox_id}/messages/{message_id}/reply
+```
+````
+
+### Configure the skill
+
+Add your AgentMail API key to the skill configuration in `~/.clawdbot/moltbot.json`:
+
+```json
+{
+  "skills": {
+    "entries": {
+      "agentmail": {
+        "enabled": true,
+        "env": {
+          "AGENTMAIL_API_KEY": "your-api-key-here"
+        }
+      }
+    }
+  }
+}
+```
+
+### Verify the skill
+
+Check that the skill is loaded:
+
+```bash
+moltbot skills list --eligible
+```
+
+You should see `agentmail` in the list of available skills.
+
+## Example use cases
+
+Once AgentMail is integrated with Moltbot, you can ask your agent to:
+
+* "Create a new email inbox for my project"
+* "Check my inbox for new emails"
+* "Send an email to [john@example.com](mailto:john@example.com) about the meeting tomorrow"
+* "Reply to the latest email from Sarah"
+* "Forward the invoice email to [accounting@company.com](mailto:accounting@company.com)"
+
+## Real-time email notifications
+
+For proactive email handling, you can combine AgentMail webhooks with Moltbot's webhook support. This allows Moltbot to notify you immediately when new emails arrive.
+
+1. Set up a webhook endpoint in Moltbot (see [Moltbot webhook documentation](https://docs.molt.bot/automation/webhook))
+
+2. Register the webhook with AgentMail:
+
+```bash
+curl -X POST -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "url": "https://your-moltbot-webhook-url",
+    "events": ["message.received"]
+  }' \
+  https://api.agentmail.to/v1/webhooks
+```
+
+Now Moltbot 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)
+* [AgentMail MCP Server](https://mcp.agentmail.to)
+* [Moltbot Documentation](https://docs.molt.bot)
+* [Moltbot Skills Guide](https://docs.molt.bot/tools/skills)
+
+
 # Replit
 
 > AgentMail's Replit integration
@@ -11498,8 +11913,6 @@ components:
         - value: attachment
     type_attachments:AttachmentContentId:
       type: string
-    type_attachments:AttachmentContent:
-      type: string
     type_attachments:SendAttachment:
       type: object
       properties:
@@ -11512,9 +11925,11 @@ components:
         content_id:
           $ref: '#/components/schemas/type_attachments:AttachmentContentId'
         content:
-          $ref: '#/components/schemas/type_attachments:AttachmentContent'
-      required:
-        - content
+          type: string
+          description: Base64 encoded content of attachment.
+        url:
+          type: string
+          description: URL to the attachment.
     type_messages:SendMessageAttachments:
       type: array
       items:
@@ -11810,8 +12225,6 @@ components:
         - value: attachment
     type_attachments:AttachmentContentId:
       type: string
-    type_attachments:AttachmentContent:
-      type: string
     type_attachments:SendAttachment:
       type: object
       properties:
@@ -11824,9 +12237,11 @@ components:
         content_id:
           $ref: '#/components/schemas/type_attachments:AttachmentContentId'
         content:
-          $ref: '#/components/schemas/type_attachments:AttachmentContent'
-      required:
-        - content
+          type: string
+          description: Base64 encoded content of attachment.
+        url:
+          type: string
+          description: URL to the attachment.
     type_messages:SendMessageAttachments:
       type: array
       items:
@@ -12113,8 +12528,6 @@ components:
         - value: attachment
     type_attachments:AttachmentContentId:
       type: string
-    type_attachments:AttachmentContent:
-      type: string
     type_attachments:SendAttachment:
       type: object
       properties:
@@ -12127,9 +12540,11 @@ components:
         content_id:
           $ref: '#/components/schemas/type_attachments:AttachmentContentId'
         content:
-          $ref: '#/components/schemas/type_attachments:AttachmentContent'
-      required:
-        - content
+          type: string
+          description: Base64 encoded content of attachment.
+        url:
+          type: string
+          description: URL to the attachment.
     type_messages:SendMessageAttachments:
       type: array
       items:
@@ -12416,8 +12831,6 @@ components:
         - value: attachment
     type_attachments:AttachmentContentId:
       type: string
-    type_attachments:AttachmentContent:
-      type: string
     type_attachments:SendAttachment:
       type: object
       properties:
@@ -12430,9 +12843,11 @@ components:
         content_id:
           $ref: '#/components/schemas/type_attachments:AttachmentContentId'
         content:
-          $ref: '#/components/schemas/type_attachments:AttachmentContent'
-      required:
-        - content
+          type: string
+          description: Base64 encoded content of attachment.
+        url:
+          type: string
+          description: URL to the attachment.
     type_messages:SendMessageAttachments:
       type: array
       items:
@@ -18641,6 +19056,287 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
+# Update Webhook
+
+PATCH https://api.agentmail.to/v0/webhooks/{webhook_id}
+Content-Type: application/json
+
+Reference: https://docs.agentmail.to/api-reference/webhooks/update
+
+## OpenAPI Specification
+
+```yaml
+openapi: 3.1.1
+info:
+  title: Update Webhook
+  version: endpoint_webhooks.update
+paths:
+  /v0/webhooks/{webhook_id}:
+    patch:
+      operationId: update
+      summary: Update Webhook
+      tags:
+        - - subpackage_webhooks
+      parameters:
+        - name: webhook_id
+          in: path
+          required: true
+          schema:
+            $ref: '#/components/schemas/type_webhooks:WebhookId'
+        - name: Authorization
+          in: header
+          description: >-
+            Bearer authentication of the form `Bearer <token>`, where token is
+            your auth token.
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Response with status 200
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/type_webhooks:Webhook'
+        '400':
+          description: Error response with status 400
+          content: {}
+        '404':
+          description: Error response with status 404
+          content: {}
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/type_webhooks:UpdateWebhookRequest'
+components:
+  schemas:
+    type_webhooks:WebhookId:
+      type: string
+    type_events:InboxIds:
+      type: array
+      items:
+        type: string
+    type_events:PodIds:
+      type: array
+      items:
+        type: string
+    type_webhooks:UpdateWebhookRequest:
+      type: object
+      properties:
+        add_inbox_ids:
+          $ref: '#/components/schemas/type_events:InboxIds'
+          description: Inbox IDs to subscribe to the webhook.
+        remove_inbox_ids:
+          $ref: '#/components/schemas/type_events:InboxIds'
+          description: Inbox IDs to unsubscribe from the webhook.
+        add_pod_ids:
+          $ref: '#/components/schemas/type_events:PodIds'
+          description: Pod IDs to subscribe to the webhook.
+        remove_pod_ids:
+          $ref: '#/components/schemas/type_events:PodIds'
+          description: Pod IDs to unsubscribe from the webhook.
+    type_webhooks:Url:
+      type: string
+    type_events:EventType:
+      type: string
+      enum:
+        - value: message.received
+        - value: message.sent
+        - value: message.delivered
+        - value: message.bounced
+        - value: message.complained
+        - value: message.rejected
+        - value: domain.verified
+    type_events:EventTypes:
+      type: array
+      items:
+        $ref: '#/components/schemas/type_events:EventType'
+    type_webhooks:ClientId:
+      type: string
+    type_webhooks:Webhook:
+      type: object
+      properties:
+        webhook_id:
+          $ref: '#/components/schemas/type_webhooks:WebhookId'
+        url:
+          $ref: '#/components/schemas/type_webhooks:Url'
+        event_types:
+          $ref: '#/components/schemas/type_events:EventTypes'
+        pod_ids:
+          $ref: '#/components/schemas/type_events:PodIds'
+        inbox_ids:
+          $ref: '#/components/schemas/type_events:InboxIds'
+        secret:
+          type: string
+          description: Secret for webhook signature verification.
+        enabled:
+          type: boolean
+          description: Webhook is enabled.
+        updated_at:
+          type: string
+          format: date-time
+          description: Time at which webhook was last updated.
+        created_at:
+          type: string
+          format: date-time
+          description: Time at which webhook was created.
+        client_id:
+          $ref: '#/components/schemas/type_webhooks:ClientId'
+      required:
+        - webhook_id
+        - url
+        - secret
+        - enabled
+        - updated_at
+        - created_at
+
+```
+
+## SDK Code Examples
+
+```typescript
+import { AgentMailClient } from "agentmail";
+
+async function main() {
+    const client = new AgentMailClient({
+        environment: "https://api.agentmail.to",
+        apiKey: "YOUR_TOKEN_HERE",
+    });
+    await client.webhooks.update("webhook_id", {});
+}
+main();
+
+```
+
+```python
+from agentmail import AgentMail
+
+client = AgentMail(
+    base_url="https://api.agentmail.to",
+    api_key="YOUR_TOKEN_HERE"
+)
+
+client.webhooks.update(
+    webhook_id="webhook_id"
+)
+
+```
+
+```go
+package main
+
+import (
+	"fmt"
+	"strings"
+	"net/http"
+	"io"
+)
+
+func main() {
+
+	url := "https://api.agentmail.to/v0/webhooks/webhook_id"
+
+	payload := strings.NewReader("{}")
+
+	req, _ := http.NewRequest("PATCH", url, payload)
+
+	req.Header.Add("Authorization", "Bearer <api_key>")
+	req.Header.Add("Content-Type", "application/json")
+
+	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/webhooks/webhook_id")
+
+http = Net::HTTP.new(url.host, url.port)
+http.use_ssl = true
+
+request = Net::HTTP::Patch.new(url)
+request["Authorization"] = 'Bearer <api_key>'
+request["Content-Type"] = 'application/json'
+request.body = "{}"
+
+response = http.request(request)
+puts response.read_body
+```
+
+```java
+HttpResponse<String> response = Unirest.patch("https://api.agentmail.to/v0/webhooks/webhook_id")
+  .header("Authorization", "Bearer <api_key>")
+  .header("Content-Type", "application/json")
+  .body("{}")
+  .asString();
+```
+
+```php
+<?php
+
+$client = new \GuzzleHttp\Client();
+
+$response = $client->request('PATCH', 'https://api.agentmail.to/v0/webhooks/webhook_id', [
+  'body' => '{}',
+  'headers' => [
+    'Authorization' => 'Bearer <api_key>',
+    'Content-Type' => 'application/json',
+  ],
+]);
+
+echo $response->getBody();
+```
+
+```csharp
+var client = new RestClient("https://api.agentmail.to/v0/webhooks/webhook_id");
+var request = new RestRequest(Method.PATCH);
+request.AddHeader("Authorization", "Bearer <api_key>");
+request.AddHeader("Content-Type", "application/json");
+request.AddParameter("application/json", "{}", ParameterType.RequestBody);
+IRestResponse response = client.Execute(request);
+```
+
+```swift
+import Foundation
+
+let headers = [
+  "Authorization": "Bearer <api_key>",
+  "Content-Type": "application/json"
+]
+let parameters = [] as [String : Any]
+
+let postData = JSONSerialization.data(withJSONObject: parameters, options: [])
+
+let request = NSMutableURLRequest(url: NSURL(string: "https://api.agentmail.to/v0/webhooks/webhook_id")! as URL,
+                                        cachePolicy: .useProtocolCachePolicy,
+                                    timeoutInterval: 10.0)
+request.httpMethod = "PATCH"
+request.allHTTPHeaderFields = headers
+request.httpBody = postData as Data
+
+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()
+```
+
 # Create Webhook
 
 POST https://api.agentmail.to/v0/webhooks