@agenticmail/mcp 0.7.7 → 0.7.8

package/README.md

@@ -8,6 +8,15 @@ The MCP (Model Context Protocol) server for [AgenticMail](https://github.com/age
 
 When connected, your AI agent can send emails and texts, check inboxes, reply to messages, receive verification codes, manage contacts, schedule emails, assign tasks to other agents, and more — all through natural language. The server provides 62 tools that cover every email, SMS, and agent management operation.
 
+## ✨ What's new in 0.7.7
+
+- **`wake` parameter on every send tool** — `send_email`, `reply_email`, `forward_email`, `template_send`, `manage_drafts(send)` all accept `wake: ["alice", "bob"]` (or comma-separated string). The dispatcher gives a Claude turn only to listed agents; the rest still receive the mail but stay asleep. Single biggest token saver on multi-agent threads.
+- **`check_activity` tool** (in the `essential` set) — see which agents the dispatcher has woken right now, what they're working on, how long they've been running, plus a preview of recently-finished work. Answers "did the agent I just emailed actually start working?" without waiting for a reply.
+- **Thread-close markers** — put `[FINAL]`, `[DONE]`, `[CLOSED]`, or `[WRAP]` in a subject to tell the dispatcher this thread is sealed; no more wakes on any reply to it. The wake prompt teaches agents to add these markers when they sign off the work.
+- **LLM-tolerant input coercion** — `batch_mark_read({ uids: "[1,2,3,4]" })`, `wait_for_email({ timeout: "120" })`, `manage_drafts({ where: '{"id":"abc"}' })`, `manage_pending({ allowSensitive: "true" })` all now just work. Strings get parsed before zod validates. No more "expected array, received string" retries.
+- **Server `instructions` field** sent on `initialize` — every connecting MCP client (Claude Code, ChatGPT, Cursor, Grok…) gets the coordination protocol in context before they touch any tool. Provider-agnostic.
+- **`wait_for_email` filters** — block on a specific reply, not just "any new event". Supports `from`, `subject`, `inReplyTo`, `participants`, `includeTasks`.
+
 ## Install
 
 ```bash

package/dist/index.js

@@ -22401,6 +22401,11 @@ var TOOL_SETS = {
     // "did the agent I just emailed actually start working?" without
     // having to wait for a reply or send an acknowledgment.
     "check_activity",
+    // tail_worker complements check_activity: when a worker has been
+    // running a long time or shows up as stale, tail_worker gives you
+    // the running log of what it actually did — every tool call, every
+    // result. Paired with check_activity so they ship in the same tier.
+    "tail_worker",
     "check_tasks"
   ],
   /** Less-common mail operations. */
@@ -23258,9 +23263,21 @@ var toolDefinitions = [
       required: ["action"]
     }
   },
+  {
+    name: "tail_worker",
+    description: "Tail the log of a running (or recently-finished) dispatcher worker. Use this when check_activity shows a worker has been running a long time or is marked stale, and you want to see what it is actually doing \u2014 every tool call, tool result, and assistant chunk is logged as a one-liner. Returns the last N lines (default 80). The workerId comes from check_activity output. Requires master key.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        workerId: { type: "string", description: "Worker id from check_activity output." },
+        lines: { type: "number", description: "How many trailing log lines to return. Default 80, max 1000." }
+      },
+      required: ["workerId"]
+    }
+  },
   {
     name: "check_activity",
-    description: "Check which agents are currently being woken by the dispatcher (right now or in the last 2 minutes). Use this when you sent mail to a teammate and want to know if they have actually started working, or to audit the live multi-agent state. Returns active workers with the agent name, what triggered the wake (mail UID + subject, or task id), how long they have been running, and a preview of the most recent finished work. Requires master key \u2014 the host session has it; subagents normally do not.",
+    description: "Check which agents are currently being woken by the dispatcher. Use this when you sent mail to a teammate and want to know if they have actually started working, or to audit the live multi-agent state. Returns active workers with the agent name, what triggered the wake (mail UID + subject, or task id), how long they have been running, the most recent tool they invoked, how many tool calls they have made, a `stale` flag (true if the dispatcher has not heartbeated in 90s+), and a preview of recently-finished work. Workers may run for hours \u2014 there is no auto-eviction; staleness is just a hint. Requires master key.",
     inputSchema: {
       type: "object",
       properties: {
@@ -24574,6 +24591,15 @@ ${r.agents.map(
       }
       throw new Error("Invalid action. Use: list_inactive, cleanup, or set_persistent");
     }
+    case "tail_worker": {
+      if (!args2.workerId) throw new Error("workerId is required");
+      const lines = typeof args2.lines === "number" ? args2.lines : 80;
+      const r = await apiRequest("GET", `/dispatcher/worker-log/${encodeURIComponent(String(args2.workerId))}?lines=${lines}`, void 0, true);
+      if (!r?.tail || !Array.isArray(r.tail)) return `No log found for worker ${args2.workerId}.`;
+      if (r.tail.length === 0) return `Worker ${args2.workerId} has no log entries yet.`;
+      return `Worker ${args2.workerId} log (last ${r.lines} of ${r.bytes} bytes):
+${r.tail.join("\n")}`;
+    }
     case "check_activity": {
       const r = await apiRequest("GET", "/dispatcher/activity", void 0, true);
       const filterAgent = typeof args2.agent === "string" ? args2.agent.toLowerCase() : "";
@@ -24585,14 +24611,24 @@ ${r.agents.map(
         if (filterAgent) return `No dispatcher activity for "${args2.agent}" right now or in the last 2 minutes. Either the agent has not been woken on this thread yet, the dispatcher is not running, or mail to them is still in flight.`;
         return "No dispatcher activity right now or in the last 2 minutes. If you just sent mail and expected an agent to wake, give it a moment \u2014 the dispatcher subscribes to /system/events for sub-second wake. If nothing happens for 30s, check that the dispatcher process is running (`pm2 list`) and that the recipient is a real local agent (`list_agents`).";
       }
+      const fmtDur = (ms) => {
+        if (ms < 6e4) return `${(ms / 1e3).toFixed(1)}s`;
+        if (ms < 36e5) return `${Math.floor(ms / 6e4)}m${Math.floor(ms % 6e4 / 1e3)}s`;
+        return `${Math.floor(ms / 36e5)}h${Math.floor(ms % 36e5 / 6e4)}m`;
+      };
       const fmt = (w, prefix) => {
-        const dur = w.durationMs ? `${(w.durationMs / 1e3).toFixed(1)}s` : "?";
+        const dur = w.durationMs ? fmtDur(w.durationMs) : "?";
         const trig = w.trigger?.subject ? ` \u2014 ${String(w.trigger.subject).slice(0, 60)}` : w.trigger?.taskId ? ` \u2014 task ${String(w.trigger.taskId).slice(0, 8)}` : "";
         const from = w.trigger?.from ? ` (from ${w.trigger.from})` : "";
         const preview = w.resultPreview ? `
       \u2192 ${String(w.resultPreview).slice(0, 140).replace(/\s+/g, " ").trim()}` : "";
-        const status = w.endedAtMs ? w.ok === false ? "failed" : "finished" : "running";
-        return `  ${prefix} ${w.agentName} [${w.kind}] ${status} ${dur}${trig}${from}${preview}`;
+        let status = w.endedAtMs ? w.ok === false ? "failed" : "finished" : "running";
+        if (!w.endedAtMs && w.stale) status = "running (stale heartbeat)";
+        const turns = !w.endedAtMs && typeof w.turnCount === "number" ? ` \xB7 ${w.turnCount} tool calls` : "";
+        const tool = !w.endedAtMs && w.lastTool ? ` \xB7 last tool: ${w.lastTool}` : "";
+        const idHint = !w.endedAtMs ? `
+      id: ${w.workerId}  (use tail_worker for the log)` : "";
+        return `  ${prefix} ${w.agentName} [${w.kind}] ${status} ${dur}${turns}${tool}${trig}${from}${preview}${idHint}`;
       };
       const lines = [];
       if (activeList.length > 0) {

package/package.json

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