agentmail 0.2.14 → 0.2.16

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.14",
-        "User-Agent": "agentmail/0.2.14",
+        "X-Fern-SDK-Version": "0.2.16",
+        "User-Agent": "agentmail/0.2.16",
         "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/websockets/client/Client.d.ts

@@ -4,7 +4,7 @@ import { WebsocketsSocket } from "./Socket.js";
 export declare namespace WebsocketsClient {
     type Options = BaseClientOptions;
     interface ConnectArgs {
-        apiKey: string;
+        apiKey?: string;
         /** Additional query parameters to send with the websocket connect request. */
         queryParams?: Record<string, unknown>;
         /** Arbitrary headers to send with the websocket connect request. */
@@ -18,5 +18,5 @@ export declare namespace WebsocketsClient {
 export declare class WebsocketsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<WebsocketsClient.Options>;
     constructor(options?: WebsocketsClient.Options);
-    connect(args: WebsocketsClient.ConnectArgs): Promise<WebsocketsSocket>;
+    connect(args?: WebsocketsClient.ConnectArgs): Promise<WebsocketsSocket>;
 }

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

@@ -53,8 +53,8 @@ class WebsocketsClient {
     constructor(options = {}) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
-    connect(args) {
-        return __awaiter(this, void 0, void 0, function* () {
+    connect() {
+        return __awaiter(this, arguments, void 0, function* (args = {}) {
             var _a, _b;
             const { apiKey, queryParams, headers, debug, reconnectAttempts } = args;
             const _queryParams = {

package/dist/cjs/environments.d.ts

@@ -11,5 +11,9 @@ export declare const AgentMailEnvironment: {
         readonly http: "https://x402.api.agentmail.to";
         readonly websockets: "wss://x402.ws.agentmail.to";
     };
+    readonly EuProd: {
+        readonly http: "https://api.agentmail.eu";
+        readonly websockets: "wss://ws.agentmail.eu";
+    };
 };
-export type AgentMailEnvironment = typeof AgentMailEnvironment.Prod | typeof AgentMailEnvironment.ProdX402;
+export type AgentMailEnvironment = typeof AgentMailEnvironment.Prod | typeof AgentMailEnvironment.ProdX402 | typeof AgentMailEnvironment.EuProd;

package/dist/cjs/environments.js

@@ -11,4 +11,8 @@ exports.AgentMailEnvironment = {
         http: "https://x402.api.agentmail.to",
         websockets: "wss://x402.ws.agentmail.to",
     },
+    EuProd: {
+        http: "https://api.agentmail.eu",
+        websockets: "wss://ws.agentmail.eu",
+    },
 };

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.2.14";
+export declare const SDK_VERSION = "0.2.16";

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.14";
+exports.SDK_VERSION = "0.2.16";

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.14",
-        "User-Agent": "agentmail/0.2.14",
+        "X-Fern-SDK-Version": "0.2.16",
+        "User-Agent": "agentmail/0.2.16",
         "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/websockets/client/Client.d.mts

@@ -4,7 +4,7 @@ import { WebsocketsSocket } from "./Socket.mjs";
 export declare namespace WebsocketsClient {
     type Options = BaseClientOptions;
     interface ConnectArgs {
-        apiKey: string;
+        apiKey?: string;
         /** Additional query parameters to send with the websocket connect request. */
         queryParams?: Record<string, unknown>;
         /** Arbitrary headers to send with the websocket connect request. */
@@ -18,5 +18,5 @@ export declare namespace WebsocketsClient {
 export declare class WebsocketsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<WebsocketsClient.Options>;
     constructor(options?: WebsocketsClient.Options);
-    connect(args: WebsocketsClient.ConnectArgs): Promise<WebsocketsSocket>;
+    connect(args?: WebsocketsClient.ConnectArgs): Promise<WebsocketsSocket>;
 }

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

@@ -17,8 +17,8 @@ export class WebsocketsClient {
     constructor(options = {}) {
         this._options = normalizeClientOptionsWithAuth(options);
     }
-    connect(args) {
-        return __awaiter(this, void 0, void 0, function* () {
+    connect() {
+        return __awaiter(this, arguments, void 0, function* (args = {}) {
             var _a, _b;
             const { apiKey, queryParams, headers, debug, reconnectAttempts } = args;
             const _queryParams = {

package/dist/esm/environments.d.mts

@@ -11,5 +11,9 @@ export declare const AgentMailEnvironment: {
         readonly http: "https://x402.api.agentmail.to";
         readonly websockets: "wss://x402.ws.agentmail.to";
     };
+    readonly EuProd: {
+        readonly http: "https://api.agentmail.eu";
+        readonly websockets: "wss://ws.agentmail.eu";
+    };
 };
-export type AgentMailEnvironment = typeof AgentMailEnvironment.Prod | typeof AgentMailEnvironment.ProdX402;
+export type AgentMailEnvironment = typeof AgentMailEnvironment.Prod | typeof AgentMailEnvironment.ProdX402 | typeof AgentMailEnvironment.EuProd;

package/dist/esm/environments.mjs

@@ -8,4 +8,8 @@ export const AgentMailEnvironment = {
         http: "https://x402.api.agentmail.to",
         websockets: "wss://x402.ws.agentmail.to",
     },
+    EuProd: {
+        http: "https://api.agentmail.eu",
+        websockets: "wss://ws.agentmail.eu",
+    },
 };

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.2.14";
+export declare const SDK_VERSION = "0.2.16";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.2.14";
+export const SDK_VERSION = "0.2.16";

package/dist/llms-full.txt

@@ -4593,6 +4593,59 @@ main();
 ***
 
 
+***
+
+title: WebSockets Quickstart
+subtitle: Get started with real-time email event streaming
+slug: websockets/quickstart
+---------------------------
+
+```typescript title="TypeScript"
+import { AgentMailClient } from "agentmail";
+
+const client = new AgentMailClient();
+
+async function main() {
+  const socket = await client.websockets.connect({
+    apiKey: process.env.AGENTMAIL_API_KEY,
+  });
+
+  socket.on("message", async (event) => {
+    if (event.type === "subscribed") {
+      console.log("Subscribed to", event.inboxIds);
+    } else if (event.eventType === "message.received") {
+      console.log(`Received message from: ${event.message.from}`);
+    }
+  });
+
+  await socket.waitForOpen();
+
+  socket.sendSubscribe({
+    type: "subscribe",
+    inboxIds: ["my-agent@agentmail.to"],
+  });
+}
+
+main();
+```
+
+```python title="Python"
+from agentmail import AgentMail, MessageReceivedEvent, Subscribe, Subscribed
+
+client = AgentMail()
+
+with client.websockets.connect() as socket:
+    socket.send_subscribe(Subscribe(inbox_ids=["my-agent@agentmail.to"]))
+
+    for event in socket:
+        if isinstance(event, Subscribed):
+            print(f"Subscribed to {event.inbox_ids}")
+        elif isinstance(event, MessageReceivedEvent):
+            msg = event.message
+            print(f"Received message from: {msg.from_}")
+```
+
+
 ***
 
 title: Email Deliverability
@@ -21826,7 +21879,7 @@ channels:
         query:
           type: object
           properties:
-            auth_token:
+            api_key:
               type: string
     publish:
       operationId: websockets-publish

package/dist/llms.txt

@@ -26,6 +26,7 @@
 - [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.
 - [WebSockets](https://docs.agentmail.to/websockets.mdx): Learn how to use WebSockets for instant email notifications without webhooks or polling.
+- [WebSockets Quickstart](https://docs.agentmail.to/websockets/quickstart.mdx): Get started with real-time email event streaming
 - [Email Deliverability](https://docs.agentmail.to/email-deliverability.mdx): Learn the strategies and best practices for maximizing your email deliverability with AgentMail.
 - [Idempotent Requests](https://docs.agentmail.to/idempotency.mdx): A guide to using the client_id parameter in AgentMail to prevent duplicate resources and safely retry API requests.
 - [Example: Event-Driven Agent](https://docs.agentmail.to/webhook-agent.mdx): A step-by-step guide to building a sophisticated agent that performs proactive outreach and uses webhooks for inbound message processing.

package/package.json

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