agentmail 0.2.19 → 0.2.21

package/dist/llms-full.txt

@@ -28336,515 +28336,3 @@ let dataTask = session.dataTask(with: request as URLRequest, completionHandler:
 dataTask.resume()
 ```
 
-# AgentMail Changelog
-
-Latest API and SDK updates. [Subscribe via RSS](https://docs.agentmail.to/changelog.rss) · [Discord](https://discord.gg/hTYatWYWBc)
-
-
-***
-
-tags:
-
-* webhooks
-* new-feature
-* sdk
-
-***
-
-## Summary
-
-**Webhooks & Events** – receive email and domain events via HTTP callbacks. Subscribe to message lifecycle events (received, sent, delivered, bounced, complained, rejected) and domain verification. Use Svix headers for verification and filter by inbox or pod. Perfect for agents that need reliable, async notifications without keeping a WebSocket open.
-
-### What's new?
-
-**Webhook events:**
-
-* `message.received` - New inbound email
-* `message.sent` - Outbound message sent
-* `message.delivered` - Delivery confirmed
-* `message.bounced` - Bounce (with type and recipients)
-* `message.complained` - Spam complaint
-* `message.rejected` - Rejection (e.g. validation)
-* `domain.verified` - Domain verification succeeded
-
-**Delivery & verification:**
-
-* Svix-style headers: `svix-id`, `svix-signature`, `svix-timestamp` for verification
-* Filter by inbox or pod (up to 10 per webhook)
-* Payloads include inbox\_id, thread\_id, message\_id, timestamps, and event-specific data
-
-### Use cases
-
-Build agents that:
-
-* React to new emails, bounces, and complaints via HTTP
-* Sync email state to your database or queue
-* Trigger workflows on domain verification
-* Verify webhook signatures for security
-
-<CodeBlocks>
-  ```python title="Python"
-  from agentmail import AgentMail
-
-  client = AgentMail(api_key="your-api-key")
-
-  # in your webhook handler: verify signature and handle event
-  # (use Svix or the raw headers for verification)
-  def handle_webhook(request):
-      event_id = request.headers.get("svix-id")
-      signature = request.headers.get("svix-signature")
-      payload = request.json()
-      if payload.get("event_type") == "message.received":
-          message = payload.get("message")
-          # process new email
-      elif payload.get("event_type") == "domain.verified":
-          domain = payload.get("domain")
-          # domain is verified
-  ```
-
-  ```typescript title="TypeScript"
-  import { AgentMail } from "agentmail";
-
-  const client = new AgentMail({ apiKey: "your-api-key" });
-
-  // in your webhook handler: verify signature and handle event
-  // (use Svix or the raw headers for verification)
-  function handleWebhook(request: Request) {
-    const eventId = request.headers.get("svix-id");
-    const signature = request.headers.get("svix-signature");
-    const payload = request.json();
-    if (payload.event_type === "message.received") {
-      const message = payload.message;
-      // process new email
-    } else if (payload.event_type === "domain.verified") {
-      const domain = payload.domain;
-      // domain is verified
-    }
-  }
-  ```
-</CodeBlocks>
-
-<Note>
-  Set up and verify webhooks in our [Webhooks](https://docs.agentmail.to/webhooks/webhooks-overview) documentation.
-</Note>
-
-
-***
-
-tags:
-
-* domains-api
-* new-feature
-* sdk
-* custom-domains
-
-***
-
-## Summary
-
-Introducing **Custom Domains** – add and verify your own domains for sending and receiving email. Use DNS verification (TXT, CNAME, MX), export zone files for easy DNS setup, and control feedback (bounce and complaint) delivery. Perfect for agents that need to send from your brand's domain with full control over deliverability.
-
-### What's new?
-
-**New endpoints:**
-
-* `GET /domains` - List all domains
-* `GET /domains/{domain_id}` - Get domain details and verification records
-* `POST /domains` - Create (add) a domain
-* `DELETE /domains/{domain_id}` - Remove a domain
-* `GET /domains/{domain_id}/zone-file` - Download zone file for DNS setup
-* `POST /domains/{domain_id}/verify` - Trigger domain verification
-
-**Domain features:**
-
-* DNS verification with TXT, CNAME, and MX records
-* Verification status: NOT\_STARTED, PENDING, VERIFYING, VERIFIED, FAILED, INVALID
-* Per-record status (MISSING, INVALID, VALID) for targeted fixes
-* Zone file export for quick import at your DNS provider
-* Optional feedback (bounce/complaint) delivery per domain
-
-### Use cases
-
-Build systems where:
-
-* Agents send from your verified custom domain
-* You manage DNS in one place and sync via zone file
-* Verification status drives onboarding or monitoring
-* Bounce and complaint handling is configured per domain
-
-<CodeBlocks>
-  ```python title="Python"
-  from agentmail import AgentMail
-
-  client = AgentMail(api_key="your-api-key")
-
-  # create a domain
-  domain = client.domains.create(
-      domain="mail.example.com",
-      feedback_enabled=True
-  )
-
-  # get verification records and status
-  domain = client.domains.get(domain_id=domain.domain_id)
-  for record in domain.records:
-      print(f"{record.type} {record.name}: {record.status}")
-
-  # trigger verification after updating DNS
-  client.domains.verify(domain_id=domain.domain_id)
-  ```
-
-  ```typescript title="TypeScript"
-  import { AgentMail } from "agentmail";
-
-  const client = new AgentMail({ apiKey: "your-api-key" });
-
-  // create a domain
-  const domain = await client.domains.create({
-    domain: "mail.example.com",
-    feedbackEnabled: true,
-  });
-
-  // get verification records and status
-  const domainDetails = await client.domains.get(domain.domainId);
-  for (const record of domainDetails.records) {
-    console.log(`${record.type} ${record.name}: ${record.status}`);
-  }
-
-  // trigger verification after updating DNS
-  await client.domains.verify(domain.domainId);
-  ```
-</CodeBlocks>
-
-<Note>
-  Learn more in our [Custom Domains](https://docs.agentmail.to/guides/domains/custom-domains) and [Managing Domains](https://docs.agentmail.to/guides/domains/managing-domains) guides.
-</Note>
-
-
-***
-
-tags:
-
-* drafts-api
-* new-feature
-* sdk
-
-***
-
-## Summary
-
-Introducing the **Drafts API** – compose and manage email drafts before sending. Create drafts, update them over time, schedule send times, and send when ready. Perfect for agents that need to build messages incrementally, support reply threading, or queue emails for later delivery.
-
-### What's new?
-
-**New endpoints:**
-
-* `GET /drafts` - List all drafts (with optional filters)
-* `GET /drafts/{draft_id}` - Get a draft
-* `POST /inboxes/{inbox_id}/drafts` - Create a draft in an inbox
-* `PATCH /inboxes/{inbox_id}/drafts/{draft_id}` - Update a draft
-* `POST /inboxes/{inbox_id}/drafts/{draft_id}/send` - Send a draft
-* `DELETE /inboxes/{inbox_id}/drafts/{draft_id}` - Delete a draft
-
-**Draft features:**
-
-* Compose with to, cc, bcc, subject, plain text, and HTML body
-* Reply threading via `in_reply_to` and `references`
-* Schedule send with `send_at` for delayed delivery
-* Attachments and labels
-* List and filter drafts by inbox, labels, or time range
-
-### Use cases
-
-Build agents that:
-
-* Compose multi-step replies before sending
-* Schedule follow-up emails for optimal delivery
-* Queue outbound messages and send in batches
-* Edit drafts based on new context or user feedback
-* Maintain proper email threads with `in_reply_to`
-
-<CodeBlocks>
-  ```python title="Python"
-  from agentmail import AgentMail
-
-  client = AgentMail(api_key="your-api-key")
-
-  # create a draft in an inbox
-  draft = client.inboxes.drafts.create(
-      inbox_id="support@example.com",
-      to=["user@example.com"],
-      subject="Re: Your request",
-      text="We're looking into it.",
-      in_reply_to="<message-id@example.com>"
-  )
-
-  # update the draft
-  client.inboxes.drafts.update(
-      inbox_id="support@example.com",
-      draft_id=draft.draft_id,
-      text="We've resolved your request."
-  )
-
-  # send the draft
-  client.inboxes.drafts.send(
-      inbox_id="support@example.com",
-      draft_id=draft.draft_id
-  )
-  ```
-
-  ```typescript title="TypeScript"
-  import { AgentMail } from "agentmail";
-
-  const client = new AgentMail({ apiKey: "your-api-key" });
-
-  // create a draft in an inbox
-  const draft = await client.inboxes.drafts.create("support@example.com", {
-    to: ["user@example.com"],
-    subject: "Re: Your request",
-    text: "We're looking into it.",
-    inReplyTo: "<message-id@example.com>",
-  });
-
-  // update the draft
-  await client.inboxes.drafts.update(
-    "support@example.com",
-    draft.draftId,
-    { text: "We've resolved your request." }
-  );
-
-  // send the draft
-  await client.inboxes.drafts.send("support@example.com", draft.draftId);
-  ```
-</CodeBlocks>
-
-<Note>
-  Learn more about composing and sending in our [Drafts](https://docs.agentmail.to/core-concepts/drafts) documentation.
-</Note>
-
-
-***
-
-tags:
-
-* metrics-api
-* new-feature
-* sdk
-
-***
-
-## Summary
-
-We're excited to introduce **Metrics Endpoints** - two new powerful endpoints that give you deep insights into your email deliverability and agent performance. Track critical events like bounces, deliveries, rejections, and complaints with detailed timestamps to build smarter, self-optimizing email agents.
-
-### What's new?
-
-**New endpoints:**
-
-* `GET /metrics` - Get comprehensive metrics across all your inboxes
-* `GET /inboxes/{inbox_id}/metrics` - Get metrics for a specific inbox
-
-**Metrics tracked:**
-
-* Delivery events: sent, delivered, bounced, rejected
-* Error tracking: complaints, spam reports
-* Time-series data with detailed timestamps
-
-### Use cases
-
-Build agents that:
-
-* Monitor their own bounce rates in real-time
-* Optimize send timing based on historical performance
-* Automatically adjust behavior based on deliverability metrics
-* Pause campaigns when performance drops below thresholds
-* Implement intelligent retry strategies for better inbox placement
-
-<Note>
-  Ready to build smarter agents? Check out our [Metrics API documentation](https://docs.agentmail.to/api-reference/metrics) to get started.
-</Note>
-
-
-***
-
-tags:
-
-* websockets
-* new-feature
-* sdk
-
-***
-
-## Summary
-
-Introducing **WebSocket Streaming** - receive email events in real-time as they happen. Build reactive agents that respond instantly to new messages, deliveries, and bounces without polling. Perfect for building interactive, event-driven email experiences.
-
-### What's new?
-
-**WebSocket endpoint:**
-
-* `wss://ws.agentmail.to/v0` - Real-time event streaming
-
-**Events streamed:**
-
-* `message.received` - New inbound email detected
-* `message.sent` - Outbound email sent successfully
-* `message.delivered` - Delivery confirmed by recipient server
-* `message.bounced` - Bounce detected (permanent or temporary)
-* `message.complained` - Spam complaint received
-
-**Connection features:**
-
-* JWT-based authentication for secure connections
-* Automatic reconnection with exponential backoff
-* Event filtering by inbox for targeted subscriptions
-* Low-latency delivery (typically under 100ms)
-* Support for thousands of concurrent connections
-
-### Use cases
-
-Build agents that:
-
-* Respond to emails within seconds of receipt
-* Monitor deliverability in real-time across all inboxes
-* Trigger workflows instantly on specific events
-* Build interactive conversational email experiences
-* Scale to handle high-volume email operations
-* React to bounces and complaints immediately
-
-<CodeBlocks>
-  ```python title="Python"
-  from agentmail import AgentMail
-
-  client = AgentMail(api_key="your-api-key")
-
-  # subscribe to events for an inbox
-  async with client.websockets.subscribe(
-      inbox_id="support@example.com"
-  ) as ws:
-      async for event in ws:
-          if event.type == "message.received":
-              print(f"New email from: {event.data.from_}")
-              response = await generate_response(event.data.text)
-              await client.messages.reply(
-                  message_id=event.data.message_id,
-                  text=response
-              )
-  ```
-
-  ```typescript title="TypeScript"
-  import { AgentMail } from "agentmail";
-
-  const client = new AgentMail({ apiKey: "your-api-key" });
-
-  // subscribe to events for an inbox
-  for await (const event of client.websockets.subscribe("support@example.com")) {
-    if (event.type === "message.received") {
-      console.log("New email from:", event.data.from);
-      const response = await generateResponse(event.data.text);
-      await client.messages.reply(event.data.messageId, response);
-    }
-  }
-  ```
-</CodeBlocks>
-
-<Note>
-  Get started with [WebSocket Streaming](https://docs.agentmail.to/websockets) to build real-time email agents.
-</Note>
-
-
-***
-
-tags:
-
-* pods-api
-* new-feature
-* sdk
-* collaboration
-
-***
-
-## Summary
-
-Introducing **Pods** - team collaboration spaces for AgentMail. Share inboxes, domains, and resources across your organization while maintaining granular control. Perfect for teams building multi-agent email systems that need organized resource management.
-
-### What's new?
-
-**New endpoints:**
-
-* `POST /pods` - Create a new pod (team workspace)
-* `GET /pods` - List all pods in your organization
-* `GET /pods/{pod_id}` - Get pod details
-* `DELETE /pods/{pod_id}` - Delete a pod
-* `POST /pods/{pod_id}/inboxes` - Create inbox within a pod
-* `POST /pods/{pod_id}/domains` - Add custom domain to a pod
-* `GET /pods/{pod_id}/threads` - List threads within a pod
-* `GET /pods/{pod_id}/metrics` - Get metrics for a pod
-
-**Pod features:**
-
-* Shared inbox access across team members
-* Per-pod domain configuration
-* Isolated metrics and analytics per pod
-* Organized resource hierarchy
-
-### Use cases
-
-Build systems where:
-
-* Multiple agents share email infrastructure
-* Different teams manage their own inboxes independently
-* Resources are organized by department or project
-* Analytics are tracked per team workspace
-* Billing and usage can be attributed to specific teams
-
-<CodeBlocks>
-  ```python title="Python"
-  from agentmail import AgentMail
-
-  client = AgentMail(api_key="your-api-key")
-
-  # create a pod for your sales team
-  pod = client.pods.create(
-      name="Sales Team",
-      description="Shared resources for sales agents"
-  )
-
-  # create an inbox in the pod
-  inbox = client.pods.inboxes.create(
-      pod_id=pod.pod_id,
-      inbox_id="sales@example.com"
-  )
-
-  # list all pods
-  pods = client.pods.list()
-  for pod in pods.pods:
-      print(f"Pod: {pod.name} ({len(pod.inbox_ids)} inboxes)")
-  ```
-
-  ```typescript title="TypeScript"
-  import { AgentMail } from "agentmail";
-
-  const client = new AgentMail({ apiKey: "your-api-key" });
-
-  // create a pod for your sales team
-  const pod = await client.pods.create({
-    name: "Sales Team",
-    description: "Shared resources for sales agents",
-  });
-
-  // create an inbox in the pod
-  await client.pods.inboxes.create(pod.podId, "sales@example.com");
-
-  // list all pods
-  const { pods } = await client.pods.list();
-  for (const p of pods) {
-    console.log(`Pod: ${p.name} (${p.inboxIds?.length ?? 0} inboxes)`);
-  }
-  ```
-</CodeBlocks>
-
-<Note>
-  Learn more about organizing teams with [Pods](https://docs.agentmail.to/core-concepts/pods) in our documentation.
-</Note>
-
-

package/dist/llms.txt

@@ -42,13 +42,6 @@
 - [SOC 2 Compliance](https://docs.agentmail.to/documentation/resources/security-privacy/soc-2-compliance.mdx): AgentMail's SOC 2 Type I achievement and Type II certification progress.
 - [Spam & Virus Detection](https://docs.agentmail.to/spam-virus-detection.mdx): How AgentMail automatically scans incoming emails for spam and viruses.
 - [API Welcome](https://docs.agentmail.to/api-reference.mdx): Quick overview of the AgentMail SDK
-- [Changelog](https://docs.agentmail.to/changelog.mdx)
-- [December 22, 2025](https://docs.agentmail.to/changelog/2025/12/22.mdx)
-- [October 28, 2025](https://docs.agentmail.to/changelog/2025/10/28.mdx)
-- [October 25, 2025](https://docs.agentmail.to/changelog/2025/10/25.mdx)
-- [August 13, 2025](https://docs.agentmail.to/changelog/2025/8/13.mdx)
-- [July 20, 2025](https://docs.agentmail.to/changelog/2025/7/20.mdx)
-- [June 15, 2025](https://docs.agentmail.to/changelog/2025/6/15.mdx)
 
 ## API Docs
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agentmail",
-    "version": "0.2.19",
+    "version": "0.2.21",
     "private": false,
     "repository": {
         "type": "git",
@@ -68,7 +68,7 @@
         "msw": "2.11.2",
         "@types/node": "^18.19.70",
         "typescript": "~5.7.2",
-        "@biomejs/biome": "2.4.3"
+        "@biomejs/biome": "2.3.11"
     },
     "browser": {
         "fs": false,