agentmail 0.2.8 → 0.2.9

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "agentmail",
-        "X-Fern-SDK-Version": "0.2.8",
-        "User-Agent": "agentmail/0.2.8",
+        "X-Fern-SDK-Version": "0.2.9",
+        "User-Agent": "agentmail/0.2.9",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/api/resources/inboxes/client/Client.js

@@ -214,12 +214,10 @@ class InboxesClient {
                 contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
                 requestType: "json",
-                body: request != null
-                    ? serializers.inboxes.create.Request.jsonOrThrow(request, {
-                        unrecognizedObjectKeys: "strip",
-                        omitUndefined: true,
-                    })
-                    : undefined,
+                body: serializers.inboxes.create.Request.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                }),
                 timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
                 maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,

package/dist/cjs/api/resources/websockets/client/Client.d.ts

@@ -5,6 +5,8 @@ export declare namespace WebsocketsClient {
     type Options = BaseClientOptions;
     interface ConnectArgs {
         authToken?: string;
+        /** Additional query parameters to send with the websocket connect request. */
+        queryParams?: Record<string, unknown>;
         /** Arbitrary headers to send with the websocket connect request. */
         headers?: Record<string, string>;
         /** Enable debug mode on the websocket. Defaults to false. */

package/dist/cjs/api/resources/websockets/client/Client.js

@@ -56,7 +56,7 @@ class WebsocketsClient {
     connect() {
         return __awaiter(this, arguments, void 0, function* (args = {}) {
             var _a, _b;
-            const { authToken, headers, debug, reconnectAttempts } = args;
+            const { authToken, queryParams, headers, debug, reconnectAttempts } = args;
             const _queryParams = {
                 auth_token: authToken,
             };
@@ -65,7 +65,7 @@ class WebsocketsClient {
             const socket = new core.ReconnectingWebSocket({
                 url: core.url.join((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.AgentMailEnvironment.Production).websockets, "/v0"),
                 protocols: [],
-                queryParameters: _queryParams,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), queryParams),
                 headers: _headers,
                 options: { debug: debug !== null && debug !== void 0 ? debug : false, maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30 },
             });

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.2.8";
+export declare const SDK_VERSION = "0.2.9";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.2.8";
+exports.SDK_VERSION = "0.2.9";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "agentmail",
-        "X-Fern-SDK-Version": "0.2.8",
-        "User-Agent": "agentmail/0.2.8",
+        "X-Fern-SDK-Version": "0.2.9",
+        "User-Agent": "agentmail/0.2.9",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/esm/api/resources/inboxes/client/Client.mjs

@@ -178,12 +178,10 @@ export class InboxesClient {
                 contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
                 requestType: "json",
-                body: request != null
-                    ? serializers.inboxes.create.Request.jsonOrThrow(request, {
-                        unrecognizedObjectKeys: "strip",
-                        omitUndefined: true,
-                    })
-                    : undefined,
+                body: serializers.inboxes.create.Request.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                }),
                 timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
                 maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,

package/dist/esm/api/resources/websockets/client/Client.d.mts

@@ -5,6 +5,8 @@ export declare namespace WebsocketsClient {
     type Options = BaseClientOptions;
     interface ConnectArgs {
         authToken?: string;
+        /** Additional query parameters to send with the websocket connect request. */
+        queryParams?: Record<string, unknown>;
         /** Arbitrary headers to send with the websocket connect request. */
         headers?: Record<string, string>;
         /** Enable debug mode on the websocket. Defaults to false. */

package/dist/esm/api/resources/websockets/client/Client.mjs

@@ -20,7 +20,7 @@ export class WebsocketsClient {
     connect() {
         return __awaiter(this, arguments, void 0, function* (args = {}) {
             var _a, _b;
-            const { authToken, headers, debug, reconnectAttempts } = args;
+            const { authToken, queryParams, headers, debug, reconnectAttempts } = args;
             const _queryParams = {
                 auth_token: authToken,
             };
@@ -29,7 +29,7 @@ export class WebsocketsClient {
             const socket = new core.ReconnectingWebSocket({
                 url: core.url.join((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.AgentMailEnvironment.Production).websockets, "/v0"),
                 protocols: [],
-                queryParameters: _queryParams,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), queryParams),
                 headers: _headers,
                 options: { debug: debug !== null && debug !== void 0 ? debug : false, maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30 },
             });

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.2.8";
+export declare const SDK_VERSION = "0.2.9";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.2.8";
+export const SDK_VERSION = "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

package/dist/llms.txt

@@ -12,7 +12,9 @@
 - [Labels](https://docs.agentmail.to/labels.mdx): Learn how to use Labels to manage state, track campaigns, and filter messages for powerful agentic workflows.
 - [Attachments](https://docs.agentmail.to/attachments.mdx): Learn how to send files as attachments, and download incoming attachments from both messages and threads.
 - [Pods](https://docs.agentmail.to/documentation/core-concepts/pods.mdx): Learn how to use pods for multi-tenant email management
+- [Skills](https://docs.agentmail.to/integrations/skills.mdx): AgentMail's official skill for Moltbot, Claude Code, Cursor, and other AI assistants
 - [MCP](https://docs.agentmail.to/integrations/mcp.mdx): AgentMail's Model Context Protocol (MCP) integration
+- [Moltbot](https://docs.agentmail.to/integrations/moltbot.mdx): AgentMail's Moltbot (Clawdbot) integration
 - [Replit](https://docs.agentmail.to/integrations/replit.mdx): AgentMail's Replit integration
 - [Guide: Sending & Receiving Email](https://docs.agentmail.to/sending-receiving-email.mdx): A step-by-step guide to the practical workflow of sending initial emails and handling replies to have a full conversation.
 - [IMAP & SMTP](https://docs.agentmail.to/imap-smtp.mdx): Configure IMAP and SMTP to access your AgentMail inboxes using email clients or programmatic access.

package/package.json

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