@agenticmail/mcp 0.7.3 → 0.7.5

package/README.md

@@ -1,4 +1,8 @@
-# @agenticmail/mcp
+<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/mcp</h1>
 
 The MCP (Model Context Protocol) server for [AgenticMail](https://github.com/agenticmail/agenticmail) — gives any MCP-compatible AI client full email and SMS capabilities.
 

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) {
@@ -24945,6 +24994,69 @@ ${lines.join("\n")}`;
 import { setTelemetryVersion } from "@agenticmail/core";
 import { createServer } from "http";
 import { randomUUID } from "crypto";
+
+// src/coerce.ts
+function coerceToArray(value, itemKind) {
+  if (Array.isArray(value)) return value;
+  if (typeof value !== "string") return value;
+  const trimmed = value.trim();
+  if (trimmed.startsWith("[")) {
+    try {
+      const parsed = JSON.parse(trimmed);
+      if (Array.isArray(parsed)) return parsed;
+    } catch {
+      return value;
+    }
+  }
+  if (itemKind === "number" || itemKind === "integer" || itemKind === "string") {
+    const parts = trimmed.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+    if (itemKind === "number" || itemKind === "integer") {
+      return parts.map((s) => {
+        const n = Number(s);
+        return Number.isNaN(n) ? s : n;
+      });
+    }
+    return parts;
+  }
+  return value;
+}
+function coerceToObject(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) return value;
+  if (typeof value !== "string") return value;
+  const trimmed = value.trim();
+  if (!trimmed.startsWith("{")) return value;
+  try {
+    const parsed = JSON.parse(trimmed);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) return parsed;
+  } catch {
+  }
+  return value;
+}
+function coerceToNumber(value) {
+  if (typeof value === "number") return value;
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (trimmed === "") return value;
+    const n = Number(trimmed);
+    if (!Number.isNaN(n)) return n;
+  }
+  return value;
+}
+function coerceToBoolean(value) {
+  if (typeof value === "boolean") return value;
+  if (typeof value === "string") {
+    const v = value.trim().toLowerCase();
+    if (v === "true" || v === "yes" || v === "1") return true;
+    if (v === "false" || v === "no" || v === "0") return false;
+  }
+  if (typeof value === "number") {
+    if (value === 1) return true;
+    if (value === 0) return false;
+  }
+  return value;
+}
+
+// src/index.ts
 setTelemetryVersion("0.5.55");
 function jsonSchemaToZod(schema, topLevel = false) {
   if (!schema || typeof schema !== "object") return topLevel ? {} : external_exports.any();
@@ -24952,16 +25064,18 @@ function jsonSchemaToZod(schema, topLevel = false) {
   if (schema.type === "string") {
     result = schema.enum?.length ? external_exports.enum(schema.enum) : external_exports.string();
   } else if (schema.type === "number" || schema.type === "integer") {
-    result = external_exports.number();
+    result = external_exports.preprocess(coerceToNumber, external_exports.number());
   } else if (schema.type === "boolean") {
-    result = external_exports.boolean();
+    result = external_exports.preprocess(coerceToBoolean, external_exports.boolean());
   } else if (schema.type === "array") {
     const hasItems = !!schema.items && typeof schema.items === "object" && Object.keys(schema.items).length > 0;
-    result = external_exports.array(hasItems ? jsonSchemaToZod(schema.items, false) : external_exports.any());
+    const inner = external_exports.array(hasItems ? jsonSchemaToZod(schema.items, false) : external_exports.any());
+    const itemKind = schema.items?.type;
+    result = external_exports.preprocess((v) => coerceToArray(v, itemKind), inner);
   } else if (schema.type === "object") {
     if (!schema.properties || Object.keys(schema.properties).length === 0) {
       if (topLevel) return {};
-      result = external_exports.record(external_exports.string(), external_exports.any());
+      result = external_exports.preprocess(coerceToObject, external_exports.record(external_exports.string(), external_exports.any()));
     } else {
       const shape = {};
       const required2 = new Set(schema.required ?? []);
@@ -24971,7 +25085,7 @@ function jsonSchemaToZod(schema, topLevel = false) {
         shape[key] = child;
       }
       if (topLevel) return shape;
-      result = external_exports.object(shape);
+      result = external_exports.preprocess(coerceToObject, external_exports.object(shape));
     }
   } else {
     result = external_exports.any();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/mcp",
-  "version": "0.7.3",
+  "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",