@agenticmail/mcp 0.9.6 → 0.9.8

package/dist/index.js

@@ -22672,6 +22672,7 @@ var TOOL_SETS = {
   /** Mail-server setup / onboarding wizards. */
   setup: [
     "setup_guide",
+    "setup_operator_email",
     "setup_email_relay",
     "setup_email_domain",
     "setup_gmail_alias",
@@ -23137,6 +23138,17 @@ var toolDefinitions = [
       required: ["name"]
     }
   },
+  {
+    name: "setup_operator_email",
+    description: 'Save the operator\'s notification email address for bridge-escalation alerts. When sub-agents mail a host bridge (e.g. `wake: ["codex"]`) AND no fresh host session is available for a headless resume, the dispatcher forwards a digest to this address so the operator gets a phone push (via Gmail / Apple Mail / whichever app handles their address). Master-key scoped. The host agent should call this during bootstrap after asking the operator: "what email should we alert you at when sub-agents need your attention?" \u2014 the answer is typically the operator\'s personal Gmail with mobile push enabled. Idempotent: re-running with a new address updates the config.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        email: { type: "string", description: "Operator notification email (e.g. ope@gmail.com). Pass `null` or an empty string to clear an existing setting." }
+      },
+      required: ["email"]
+    }
+  },
   {
     name: "setup_email_relay",
     description: "Configure Gmail/Outlook relay for sending real internet email (requires master API key). BEGINNER-FRIENDLY: Just needs a Gmail/Outlook email + app password. Agents send as user+agentname@gmail.com. Automatically creates a default agent (secretary) unless skipped. Best for: quick setup, personal use, no domain needed.",
@@ -23985,10 +23997,16 @@ Connected account (${result.relayResults[0].account}): ${result.relayResults.len
       const subject = origSubject.startsWith("Re:") ? origSubject : `Re: ${origSubject}`;
       const refs = Array.isArray(original.references) ? [...original.references] : [];
       if (original.messageId) refs.push(original.messageId);
+      const fmtAddrs = (arr) => (Array.isArray(arr) ? arr : []).map((a) => typeof a === "string" ? a : a?.address ?? "").filter(Boolean).join(", ");
+      const origTo = fmtAddrs(original.to);
+      const origCc = fmtAddrs(original.cc);
+      const headerLines = [`On ${original.date}, ${replyTo} wrote:`];
+      if (origTo) headerLines.push(`To: ${origTo}`);
+      if (origCc) headerLines.push(`Cc: ${origCc}`);
       const quotedBody = (original.text || "").split("\n").map((l) => `> ${l}`).join("\n");
       const fullText = `${args2.text}
 
-On ${original.date}, ${replyTo} wrote:
+${headerLines.join("\n")}
 ${quotedBody}`;
       let to = replyTo;
       let cc;
@@ -24269,6 +24287,20 @@ ${r.messages.map((m) => `  UID ${m.uid} (${m.folder})`).join("\n")}`;
         hostTag ? `  Host: ${hostTag} (this account is owned by the ${hostTag} dispatcher)` : ""
       ].filter(Boolean).join("\n");
     }
+    case "setup_operator_email": {
+      const raw = args2.email;
+      const email2 = typeof raw === "string" ? raw.trim() : "";
+      const body = email2 ? { email: email2 } : { email: null };
+      const result = await apiRequest("PATCH", "/system/operator-email", body, true);
+      if (!email2) {
+        return "Operator escalation email cleared. Bridge alerts will still be recorded as system events but no email forward will be sent.";
+      }
+      return [
+        `\u2713 Operator escalation email set to ${result?.email ?? email2}.`,
+        `When sub-agents mail a bridge inbox and no fresh host session is available for a headless resume, the dispatcher will email this address with a digest so you get a phone push.`,
+        `Re-run setup_operator_email with a new address any time to update.`
+      ].join("\n");
+    }
     case "setup_email_relay": {
       const result = await apiRequest("POST", "/gateway/relay", {
         provider: args2.provider,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/mcp",
-  "version": "0.9.6",
+  "version": "0.9.8",
   "mcpName": "io.github.agenticmail/mcp",
   "description": "MCP server for AgenticMail — give any AI client real email and SMS capabilities",
   "type": "module",
@@ -30,7 +30,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
     "zod": "^3.24.0",
-    "@agenticmail/core": "^0.9.5"
+    "@agenticmail/core": "^0.9.6"
   },
   "devDependencies": {
     "tsup": "^8.4.0",