@agenticmail/core 0.7.2 → 0.7.4

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,18 @@ 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.4
+
+- **⭐ `MailReceiver.setStarred(uid, starred, mailbox?)`** — toggles IMAP's `\Flagged` flag via `messageFlagsAdd` / `messageFlagsRemove`. Same on-disk bit Gmail's star uses. Underpins the new `POST /mail/messages/:uid/star` route in `@agenticmail/api`.
+- **📐 Task `output_schema` column** — migration `014_task_output_schema.sql` adds an optional `output_schema TEXT` column to `agent_tasks`. Stores the assigner-supplied JSON Schema for typed task contracts. `NULL` means "no schema, accept anything", fully back-compat with the v0.8.x task model.
+
+## ✨ Earlier — 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);
@@ -3470,6 +3488,17 @@ CREATE INDEX IF NOT EXISTS idx_pending_outbound_agent ON pending_outbound(agent_
   "013_pending_notification_id.sql": `
 ALTER TABLE pending_outbound ADD COLUMN notification_message_id TEXT;
 CREATE INDEX IF NOT EXISTS idx_pending_notification ON pending_outbound(notification_message_id);
+`,
+  "014_task_output_schema.sql": `
+-- Typed task contracts: when an assigner cares about the shape of the
+-- deliverable, they can attach a JSON Schema describing what
+-- submit_result must look like. The API validates against it before
+-- accepting the result, so workers can't return free-form prose when
+-- a structured object was requested.
+--
+-- Column is optional; NULL means "no schema, accept anything" (the
+-- v0.8.x behaviour, fully back-compat).
+ALTER TABLE agent_tasks ADD COLUMN output_schema TEXT;
 `
 };
 function runMigrations(database) {

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);
@@ -2712,6 +2730,17 @@ CREATE INDEX IF NOT EXISTS idx_pending_outbound_agent ON pending_outbound(agent_
   "013_pending_notification_id.sql": `
 ALTER TABLE pending_outbound ADD COLUMN notification_message_id TEXT;
 CREATE INDEX IF NOT EXISTS idx_pending_notification ON pending_outbound(notification_message_id);
+`,
+  "014_task_output_schema.sql": `
+-- Typed task contracts: when an assigner cares about the shape of the
+-- deliverable, they can attach a JSON Schema describing what
+-- submit_result must look like. The API validates against it before
+-- accepting the result, so workers can't return free-form prose when
+-- a structured object was requested.
+--
+-- Column is optional; NULL means "no schema, accept anything" (the
+-- v0.8.x behaviour, fully back-compat).
+ALTER TABLE agent_tasks ADD COLUMN output_schema TEXT;
 `
 };
 function runMigrations(database) {

package/package.json

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