@agenticmail/core 0.7.2 → 0.7.3

package/README.md

@@ -1,4 +1,8 @@
-# @agenticmail/core
+<p align="center">
+  <img src="https://raw.githubusercontent.com/agenticmail/agenticmail/main/docs/images/logo-200.png" alt="AgenticMail logo (pink bow)" width="180" />
+</p>
+
+<h1 align="center">@agenticmail/core</h1>
 
 Core SDK for [AgenticMail](https://github.com/agenticmail/agenticmail) — the first platform to give AI agents real email addresses and phone numbers.
 
@@ -6,6 +10,13 @@ This is the foundation layer that everything else builds on. If the API server,
 
 Every other AgenticMail package depends on this one.
 
+## ✨ What's new in 0.7.2
+
+- **`list_inbox` / `inbox_digest` consistency fix** — `MailReceiver.listEnvelopes` no longer trusts the stale cached `mailbox.exists` count and early-returns empty when an internal mail just landed. `getMailboxInfo` now issues an IMAP `NOOP` to refresh state before reading `client.mailbox`. `SEARCH` is the authoritative source; `list_inbox` and `inbox_digest` now agree.
+- **Custom outgoing headers** — the `headers` field on `SendMailOptions` is fully plumbed through to nodemailer, so callers (the API, the MCP server) can set `X-AgenticMail-Wake` and other custom headers for downstream consumers to read.
+
+The wake / thread-close / web UI features live in the API and dispatcher layers above this package; `core` provides the primitives they all share.
+
 ---
 
 ## Table of Contents

package/dist/index.cjs

@@ -1011,6 +1011,24 @@ var MailReceiver = class {
       lock.release();
     }
   }
+  /**
+   * Flag / unflag a message. IMAP uses `\Flagged` for what Gmail
+   * calls "starred" — same on-disk bit, different vocabulary. We
+   * expose it as `setStarred(uid, true|false)` so the web UI can
+   * call a single endpoint with a boolean.
+   */
+  async setStarred(uid, starred, mailbox = "INBOX") {
+    const lock = await this.client.getMailboxLock(mailbox);
+    try {
+      if (starred) {
+        await this.client.messageFlagsAdd(String(uid), ["\\Flagged"], { uid: true });
+      } else {
+        await this.client.messageFlagsRemove(String(uid), ["\\Flagged"], { uid: true });
+      }
+    } finally {
+      lock.release();
+    }
+  }
   /** Move a message to another folder */
   async moveMessage(uid, fromMailbox, toMailbox) {
     const lock = await this.client.getMailboxLock(fromMailbox);

package/dist/index.d.cts

@@ -473,6 +473,13 @@ declare class MailReceiver {
     deleteMessage(uid: number, mailbox?: string): Promise<void>;
     /** Mark a message as unseen (unread) */
     markUnseen(uid: number, mailbox?: string): Promise<void>;
+    /**
+     * Flag / unflag a message. IMAP uses `\Flagged` for what Gmail
+     * calls "starred" — same on-disk bit, different vocabulary. We
+     * expose it as `setStarred(uid, true|false)` so the web UI can
+     * call a single endpoint with a boolean.
+     */
+    setStarred(uid: number, starred: boolean, mailbox?: string): Promise<void>;
     /** Move a message to another folder */
     moveMessage(uid: number, fromMailbox: string, toMailbox: string): Promise<void>;
     /** List all IMAP folders/mailboxes */

package/dist/index.d.ts

@@ -473,6 +473,13 @@ declare class MailReceiver {
     deleteMessage(uid: number, mailbox?: string): Promise<void>;
     /** Mark a message as unseen (unread) */
     markUnseen(uid: number, mailbox?: string): Promise<void>;
+    /**
+     * Flag / unflag a message. IMAP uses `\Flagged` for what Gmail
+     * calls "starred" — same on-disk bit, different vocabulary. We
+     * expose it as `setStarred(uid, true|false)` so the web UI can
+     * call a single endpoint with a boolean.
+     */
+    setStarred(uid: number, starred: boolean, mailbox?: string): Promise<void>;
     /** Move a message to another folder */
     moveMessage(uid: number, fromMailbox: string, toMailbox: string): Promise<void>;
     /** List all IMAP folders/mailboxes */

package/dist/index.js

@@ -257,6 +257,24 @@ var MailReceiver = class {
       lock.release();
     }
   }
+  /**
+   * Flag / unflag a message. IMAP uses `\Flagged` for what Gmail
+   * calls "starred" — same on-disk bit, different vocabulary. We
+   * expose it as `setStarred(uid, true|false)` so the web UI can
+   * call a single endpoint with a boolean.
+   */
+  async setStarred(uid, starred, mailbox = "INBOX") {
+    const lock = await this.client.getMailboxLock(mailbox);
+    try {
+      if (starred) {
+        await this.client.messageFlagsAdd(String(uid), ["\\Flagged"], { uid: true });
+      } else {
+        await this.client.messageFlagsRemove(String(uid), ["\\Flagged"], { uid: true });
+      }
+    } finally {
+      lock.release();
+    }
+  }
   /** Move a message to another folder */
   async moveMessage(uid, fromMailbox, toMailbox) {
     const lock = await this.client.getMailboxLock(fromMailbox);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/core",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "Core SDK for AgenticMail — email, SMS, and phone number access for AI agents",
   "type": "module",
   "main": "dist/index.js",