@agenticmail/mcp 0.7.4 → 0.7.5

package/dist/index.js

@@ -22395,6 +22395,12 @@ var TOOL_SETS = {
     // back. Essential enough that paying its tokens at every spawn beats
     // making the agent discover it via request_tools.
     "wait_for_email",
+    // check_activity is the dispatcher visibility primitive: see which
+    // agents the dispatcher has woken right now (or in the last 2 min)
+    // and how long they have been running. The host uses it to answer
+    // "did the agent I just emailed actually start working?" without
+    // having to wait for a reply or send an acknowledgment.
+    "check_activity",
     "check_tasks"
   ],
   /** Less-common mail operations. */
@@ -23227,6 +23233,17 @@ var toolDefinitions = [
       required: ["action"]
     }
   },
+  {
+    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.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        agent: { type: "string", description: "Filter to a specific agent by name (case-insensitive). Omit to see every active and recently-finished worker." },
+        includeRecent: { type: "boolean", description: "Include workers that finished in the last ~2 minutes (default: true). Set false to see only currently-running workers." }
+      }
+    }
+  },
   {
     name: "check_tasks",
     description: "Check for pending tasks assigned to you (or a specific agent) or tasks you assigned to others",
@@ -24519,6 +24536,38 @@ ${r.agents.map(
       }
       throw new Error("Invalid action. Use: list_inactive, cleanup, or set_persistent");
     }
+    case "check_activity": {
+      const r = await apiRequest("GET", "/dispatcher/activity", void 0, true);
+      const filterAgent = typeof args2.agent === "string" ? args2.agent.toLowerCase() : "";
+      const includeRecent = args2.includeRecent !== false;
+      const matchesFilter = (w) => !filterAgent || (w.agentName ?? "").toLowerCase().includes(filterAgent);
+      const activeList = Array.isArray(r?.active) ? r.active.filter(matchesFilter) : [];
+      const recentList = includeRecent && Array.isArray(r?.recent) ? r.recent.filter(matchesFilter) : [];
+      if (activeList.length === 0 && recentList.length === 0) {
+        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 fmt = (w, prefix) => {
+        const dur = w.durationMs ? `${(w.durationMs / 1e3).toFixed(1)}s` : "?";
+        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}`;
+      };
+      const lines = [];
+      if (activeList.length > 0) {
+        lines.push(`Active workers (${activeList.length}):`);
+        for (const w of activeList) lines.push(fmt(w, "\u25CF"));
+      }
+      if (recentList.length > 0) {
+        if (lines.length > 0) lines.push("");
+        lines.push(`Recently finished (last 2 min, ${recentList.length}):`);
+        for (const w of recentList) lines.push(fmt(w, "\u25CB"));
+      }
+      return lines.join("\n");
+    }
     case "check_tasks": {
       let endpoint = args2.direction === "outgoing" ? "/tasks/assigned" : "/tasks/pending";
       if (args2.direction !== "outgoing" && args2.assignee) {

package/package.json

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