@agenticmail/mcp 0.7.5 → 0.7.7

package/dist/index.js

@@ -22615,7 +22615,7 @@ async function apiRequest(method, path, body, useMasterKey = false, timeoutMs =
 var toolDefinitions = [
   {
     name: "send_email",
-    description: "Send an email from the agent's mailbox. Supports multiple recipients on To and CC (comma-separated). This is the PRIMARY primitive for multi-agent coordination: kick off a thread with all participants on CC, and every local recipient is woken automatically. Each woken agent reads the thread, decides whose turn it is, and either reply-all's to contribute or stays silent. External emails are scanned for sensitive content; HIGH severity detections are BLOCKED for owner approval. You CANNOT bypass the outbound guard.",
+    description: "Send an email from the agent's mailbox. Supports multiple recipients on To and CC (comma-separated). This is the PRIMARY primitive for multi-agent coordination: kick off a thread with all participants on CC, and every local recipient is woken automatically \u2014 UNLESS you set `wake` to limit the wake-up to specific agents. Use `wake` aggressively on large threads: 15 agents on CC \xD7 every reply burns 15 Claude turns per round if every recipient wakes. Naming the single next actor cuts that to one. External emails are scanned for sensitive content; HIGH severity detections are BLOCKED for owner approval. You CANNOT bypass the outbound guard.",
     inputSchema: {
       type: "object",
       properties: {
@@ -22623,7 +22623,12 @@ var toolDefinitions = [
         subject: { type: "string", description: "Email subject line" },
         text: { type: "string", description: "Plain text body" },
         html: { type: "string", description: "HTML body (optional)" },
-        cc: { type: "string", description: 'CC recipients \u2014 the team. Comma-separated, e.g. "vesper@localhost, orion@localhost". Every local @localhost recipient is auto-woken when this email lands.' },
+        cc: { type: "string", description: 'CC recipients \u2014 the team. Comma-separated, e.g. "vesper@localhost, orion@localhost". Every local @localhost recipient is auto-woken when this email lands UNLESS you also pass `wake` to restrict.' },
+        wake: {
+          type: "array",
+          items: { type: "string" },
+          description: 'Optional. Names (or @localhost addresses) of the agents the dispatcher should give a Claude turn to when this mail lands. CC\'d agents NOT in this list still receive the email but get no Claude turn \u2014 they will see it the next time someone explicitly wakes them or they check their inbox. Use this to scope cost on large threads: send to 15 agents but wake only the 1 or 2 who need to act next. Pass an empty array `[]` for "deliver silently \u2014 wake nobody". Omit entirely to keep the default "wake everyone CC\'d" behaviour.'
+        },
         inReplyTo: { type: "string", description: "Message-ID to reply to (optional)" },
         references: {
           type: "array",
@@ -22711,27 +22716,37 @@ var toolDefinitions = [
   },
   {
     name: "reply_email",
-    description: "Reply to an email. Fetches the original message, auto-fills To, Subject (Re:), In-Reply-To, and References, then sends with quoted body. **For multi-agent thread coordination, pass `replyAll: true`** so every CC'd participant sees your contribution and stays in context \u2014 that is how the thread-as-workspace pattern works. Outbound guard applies \u2014 HIGH severity content is held for review.",
+    description: "Reply to an email. Fetches the original message, auto-fills To, Subject (Re:), In-Reply-To, and References, then sends with quoted body. **For multi-agent thread coordination, pass `replyAll: true`** so every CC'd participant sees your contribution and stays in context \u2014 that is how the thread-as-workspace pattern works. **Pass `wake` to name only the next actor(s)** so the dispatcher gives a Claude turn only to them; everyone else still receives the mail but stays asleep. Outbound guard applies \u2014 HIGH severity content is held for review.",
     inputSchema: {
       type: "object",
       properties: {
         uid: { type: "number", description: "UID of the email to reply to" },
         text: { type: "string", description: "Your reply text" },
         html: { type: "string", description: "HTML reply (optional)" },
-        replyAll: { type: "boolean", description: "Reply to all recipients (default: false)" }
+        replyAll: { type: "boolean", description: "Reply to all recipients (default: false)" },
+        wake: {
+          type: "array",
+          items: { type: "string" },
+          description: "Optional. Names of the agents who should get a Claude turn from the dispatcher when this reply lands. CC'd agents NOT in this list still receive the email but stay asleep \u2014 saves significant tokens on large threads. Pass `[]` to deliver silently. Omit to wake everyone CC'd."
+        }
       },
       required: ["uid", "text"]
     }
   },
   {
     name: "forward_email",
-    description: "Forward an email to another recipient. Outbound guard applies \u2014 HIGH severity content is held for review.",
+    description: "Forward an email to another recipient. Outbound guard applies \u2014 HIGH severity content is held for review. Pass `wake` to limit which local recipients get a Claude turn from the dispatcher when this forward lands.",
     inputSchema: {
       type: "object",
       properties: {
         uid: { type: "number", description: "UID of the email to forward" },
         to: { type: "string", description: "Recipient to forward to" },
-        text: { type: "string", description: "Additional message (optional)" }
+        text: { type: "string", description: "Additional message (optional)" },
+        wake: {
+          type: "array",
+          items: { type: "string" },
+          description: "Optional. Names of the agents who should get a Claude turn when the forward lands. Pass `[]` to deliver silently. Omit to wake everyone CC'd."
+        }
       },
       required: ["uid", "to"]
     }
@@ -22832,7 +22847,7 @@ var toolDefinitions = [
   },
   {
     name: "manage_drafts",
-    description: "List, create, update, send, or delete drafts",
+    description: "List, create, update, send, or delete drafts. On send, you can pass `wake` to limit which local recipients get a Claude turn \u2014 same semantics as send_email.",
     inputSchema: {
       type: "object",
       properties: {
@@ -22840,7 +22855,12 @@ var toolDefinitions = [
         id: { type: "string", description: "Draft ID (for update/send/delete)" },
         to: { type: "string", description: "Recipient (for create/update)" },
         subject: { type: "string", description: "Subject (for create/update)" },
-        text: { type: "string", description: "Body text (for create/update)" }
+        text: { type: "string", description: "Body text (for create/update)" },
+        wake: {
+          type: "array",
+          items: { type: "string" },
+          description: "Optional, for action=send. Names of the agents who should get a Claude turn when the drafted mail lands. Pass `[]` to deliver silently. Omit to wake everyone CC'd."
+        }
       },
       required: ["action"]
     }
@@ -23197,7 +23217,12 @@ var toolDefinitions = [
         to: { type: "string", description: "Recipient email" },
         variables: { type: "object", description: 'Variables to substitute: { name: "Alice" }' },
         cc: { type: "string", description: "CC recipients" },
-        bcc: { type: "string", description: "BCC recipients" }
+        bcc: { type: "string", description: "BCC recipients" },
+        wake: {
+          type: "array",
+          items: { type: "string" },
+          description: "Optional. Names of the agents who should get a Claude turn when this template-rendered mail lands. Pass `[]` to deliver silently. Omit to wake everyone CC'd."
+        }
       },
       required: ["id", "to"]
     }
@@ -23585,6 +23610,9 @@ async function dispatchToolCall(name, args2, useMaster) {
           ...a.encoding ? { encoding: a.encoding } : {}
         }));
       }
+      if (args2.wake !== void 0) {
+        sendBody.wake = args2.wake;
+      }
       const result = await apiRequest("POST", "/mail/send", sendBody);
       if (result?.blocked && result?.pendingId) {
         scheduleFollowUp(result.pendingId, String(args2.to), String(args2.subject || "(no subject)"), makePendingCheck(result.pendingId));
@@ -23718,6 +23746,9 @@ ${quotedBody}`;
         inReplyTo: original.messageId,
         references: refs
       };
+      if (args2.wake !== void 0) {
+        replySendBody.wake = args2.wake;
+      }
       const sendResult = await apiRequest("POST", "/mail/send", replySendBody);
       if (sendResult?.blocked && sendResult?.pendingId) {
         scheduleFollowUp(sendResult.pendingId, to, String(replySendBody.subject || "(no subject)"), makePendingCheck(sendResult.pendingId));
@@ -23766,6 +23797,9 @@ ${orig.text || ""}`;
           encoding: "base64"
         }));
       }
+      if (args2.wake !== void 0) {
+        fwdSendBody.wake = args2.wake;
+      }
       const fwdResult = await apiRequest("POST", "/mail/send", fwdSendBody);
       if (fwdResult?.blocked && fwdResult?.pendingId) {
         scheduleFollowUp(fwdResult.pendingId, String(args2.to), fwdSubject, makePendingCheck(fwdResult.pendingId));
@@ -23870,7 +23904,9 @@ ${lines.join("\n")}`;
       }
       if (args2.action === "send") {
         if (!args2.id) throw new Error("id is required");
-        const r = await apiRequest("POST", `/drafts/${args2.id}/send`);
+        const draftSendBody = {};
+        if (args2.wake !== void 0) draftSendBody.wake = args2.wake;
+        const r = await apiRequest("POST", `/drafts/${args2.id}/send`, draftSendBody);
         return `Draft sent. Message ID: ${r?.messageId ?? "unknown"}`;
       }
       if (args2.action === "delete") {
@@ -24476,12 +24512,14 @@ ${lines.join("\n\n---\n\n")}`;
 ${lines.join("\n")}`;
     }
     case "template_send": {
-      const result = await apiRequest("POST", `/templates/${args2.id}/send`, {
+      const templateBody = {
         to: args2.to,
         variables: args2.variables,
         cc: args2.cc,
         bcc: args2.bcc
-      });
+      };
+      if (args2.wake !== void 0) templateBody.wake = args2.wake;
+      const result = await apiRequest("POST", `/templates/${args2.id}/send`, templateBody);
       return `Template email sent. Message ID: ${result?.messageId ?? "unknown"}`;
     }
     case "manage_rules": {
@@ -25118,6 +25156,7 @@ var SERVER_INSTRUCTIONS = [
   '         to: "vesper@localhost",                         // primary owner of step 1',
   '         cc: "orion@localhost, claudecode@localhost",     // teammates + yourself',
   '         subject: "Build a small terminal game",',
+  '         wake: ["vesper"],                                // only Vesper gets a Claude turn',
   "         text: [",
   '           "Team \u2014",',
   '           "",',
@@ -25130,6 +25169,14 @@ var SERVER_INSTRUCTIONS = [
   '         ].join("\\n"),',
   "       })",
   "",
+  "   The `wake` parameter is the SINGLE BIGGEST TOKEN SAVER on large threads.",
+  "   Without it, every CC'd recipient burns one Claude turn deciding whether",
+  "   it is their turn. With it, only the named agents get a turn \u2014 the rest",
+  "   receive the mail in their inbox but stay asleep until you (or another",
+  "   agent) explicitly names them in a later `wake` list. Pass `wake: []`",
+  '   for "deliver silently \u2014 wake nobody". Omit `wake` entirely to keep the',
+  `   old "wake every CC'd agent" behaviour (backwards compatible).`,
+  "",
   "   The mail server pushes a wake-up to every local recipient simultaneously.",
   "   Each agent reads the thread, decides if it is THEIR turn, and either",
   "   reply-all's to contribute or stays silent. Vesper goes first because she",
@@ -25149,7 +25196,15 @@ var SERVER_INSTRUCTIONS = [
   "   To unblock a stuck agent or change direction, just reply-all into the",
   "   same thread.",
   "",
-  '4. Done when the last hand-off (or an explicit "complete" message) lands',
+  "4. **Close the thread when work is complete.** Send a wrap-up reply",
+  "   with one of these markers in the subject: `[FINAL]`, `[DONE]`,",
+  "   `[CLOSED]`, or `[WRAP]`. The dispatcher honours those markers and",
+  "   stops waking workers on any further replies to that thread. Without",
+  "   this, the cascade can keep firing as agents critique each other's",
+  "   work even after the deliverables are in. Add the marker once, the",
+  "   thread is sealed.",
+  "",
+  '5. Done when the last hand-off (or an explicit "complete" message) lands',
   "   in your inbox. Show the result to the user.",
   "",
   "Why this is right:",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/mcp",
-  "version": "0.7.5",
+  "version": "0.7.7",
   "mcpName": "io.github.agenticmail/mcp",
   "description": "MCP server for AgenticMail — give any AI client real email and SMS capabilities",
   "type": "module",