@agenticmail/api 0.7.8 → 0.7.11

package/README.md

@@ -8,9 +8,9 @@ The API server for [AgenticMail](https://github.com/agenticmail/agenticmail) —
 
 This package runs a web server that handles everything: sending email and SMS, reading inboxes, managing agents, phone number access, real-time notifications, inter-agent messaging, spam filtering, outbound security scanning, and gateway configuration. Every feature in AgenticMail is accessible through this API.
 
-## ✨ What's new in 0.7.7
+## ✨ What's new in 0.7.9
 
-- **🌐 Lightweight Gmail-style web UI bundled** — `packages/api/public/index.html` is served by `express.static` at the API root. Open `http://127.0.0.1:3829/` in any browser, paste the master key, and you get a Gmail/Outlook-style three-pane email client (agents / inbox / message). Real-time SSE updates, markdown rendering, compose + reply with the new `wake` parameter as a field. Run via `agenticmail web` from the CLI.
+- **🌐 Gmail-style web UI, fully redesigned** — `packages/api/public/` ships a proper two-column Gmail layout (sidebar with Compose + folders / content pane) served by `express.static` at the API root. Every emoji replaced with an inline 24×24 vector icon library (`public/js/icons.js`). HTML shell + dedicated `styles.css` + 14 modular ES module JS files under `public/js/`. Hash router (`#/inbox`, `#/m/<uid>`), search with `from:` / `subject:` operators, real-time SSE updates, browser notifications. Run via `agenticmail web` from the CLI.
 - **Wake allowlist on `POST /mail/send`** — accept a `wake` parameter (array of agent names or comma-separated string). The API normalises it, sets an `X-AgenticMail-Wake` header on the outgoing SMTP envelope, AND surfaces it as `wakeAllowlist` on the SSE event so the dispatcher can decide which CC'd recipients to actually give a Claude turn.
 - **Shared helpers exported from `routes/mail.ts`** — `normalizeWakeList`, `wakeHeaders`, and `pushLocalRecipientWakes` so every send path (`/mail/send`, `/templates/:id/send`, `/drafts/:id/send`, `/mail/pending/:id/approve`) uses the same primitives.
 - **System events SSE** at `GET /system/events` — master-auth stream that emits `account_created` / `account_deleted` / `worker_started` / `worker_finished` events. Powers the dispatcher's zero-wait wake on newly-created agents and the `check_activity` MCP tool.

package/dist/index.js

@@ -7,8 +7,8 @@ import express from "express";
 import cors from "cors";
 import rateLimit from "express-rate-limit";
 import { fileURLToPath as fileURLToPath2 } from "url";
-import { dirname as dirname2, join as join2 } from "path";
-import { existsSync } from "fs";
+import { dirname as dirname2, join as join3 } from "path";
+import { existsSync as existsSync2 } from "fs";
 import {
   resolveConfig,
   getDatabase,
@@ -4680,15 +4680,15 @@ function createStorageRoutes(rawDb, accountManager2, config, dialect = "sqlite")
 
 // src/routes/dispatcher-activity.ts
 import { Router as Router13 } from "express";
-var ACTIVE_TTL_MS = 30 * 60 * 1e3;
+import { existsSync, readFileSync as readFileSync2, statSync } from "fs";
+import { homedir } from "os";
+import { join as join2 } from "path";
+var STALE_HEARTBEAT_MS = 90 * 1e3;
 var RECENT_TTL_MS = 2 * 60 * 1e3;
 var HARD_CAP = 256;
 var active = /* @__PURE__ */ new Map();
 var recent = /* @__PURE__ */ new Map();
 function prune(nowMs) {
-  for (const [id, w] of active) {
-    if (nowMs - w.startedAtMs > ACTIVE_TTL_MS) active.delete(id);
-  }
   for (const [id, w] of recent) {
     const t = w.endedAtMs ?? w.startedAtMs;
     if (nowMs - t > RECENT_TTL_MS) recent.delete(id);
@@ -4718,7 +4718,9 @@ function createDispatcherActivityRoutes() {
       agentEmail: typeof body.agentEmail === "string" ? body.agentEmail : void 0,
       kind: typeof body.kind === "string" ? body.kind : "unknown",
       trigger: body.trigger && typeof body.trigger === "object" ? body.trigger : void 0,
-      startedAtMs: Date.now()
+      startedAtMs: Date.now(),
+      lastHeartbeatMs: Date.now(),
+      turnCount: 0
     };
     prune(info.startedAtMs);
     active.set(info.workerId, info);
@@ -4748,7 +4750,8 @@ function createDispatcherActivityRoutes() {
       },
       endedAtMs: nowMs,
       ok: body.ok === false ? false : true,
-      resultPreview: typeof body.resultPreview === "string" ? body.resultPreview.slice(0, 240) : void 0
+      resultPreview: typeof body.resultPreview === "string" ? body.resultPreview.slice(0, 240) : void 0,
+      turnCount: typeof body.turnCount === "number" ? body.turnCount : existing?.turnCount
     };
     active.delete(body.workerId);
     recent.set(body.workerId, info);
@@ -4762,6 +4765,22 @@ function createDispatcherActivityRoutes() {
     }
     res.json({ ok: true });
   });
+  router.post("/dispatcher/worker-heartbeat", requireMaster, (req, res) => {
+    const body = req.body ?? {};
+    if (typeof body.workerId !== "string") {
+      res.status(400).json({ error: "workerId is required" });
+      return;
+    }
+    const existing = active.get(body.workerId);
+    if (!existing) {
+      res.json({ ok: true, ignored: "unknown worker" });
+      return;
+    }
+    existing.lastHeartbeatMs = Date.now();
+    if (typeof body.lastTool === "string") existing.lastTool = body.lastTool;
+    if (typeof body.turnCount === "number") existing.turnCount = body.turnCount;
+    res.json({ ok: true });
+  });
   router.get("/dispatcher/activity", requireMaster, (_req, res) => {
     const nowMs = Date.now();
     prune(nowMs);
@@ -4769,7 +4788,9 @@ function createDispatcherActivityRoutes() {
       now: nowMs,
       active: Array.from(active.values()).map((w) => ({
         ...w,
-        durationMs: nowMs - w.startedAtMs
+        durationMs: nowMs - w.startedAtMs,
+        stale: w.lastHeartbeatMs !== void 0 && nowMs - w.lastHeartbeatMs > STALE_HEARTBEAT_MS,
+        heartbeatAgeMs: w.lastHeartbeatMs !== void 0 ? nowMs - w.lastHeartbeatMs : void 0
       })),
       recent: Array.from(recent.values()).map((w) => ({
         ...w,
@@ -4777,6 +4798,35 @@ function createDispatcherActivityRoutes() {
       }))
     });
   });
+  router.get("/dispatcher/worker-log/:workerId", requireMaster, (req, res) => {
+    const rawId = String(req.params.workerId ?? "");
+    if (!rawId) {
+      res.status(400).json({ error: "workerId is required" });
+      return;
+    }
+    const lines = Math.min(Math.max(Number(req.query.lines ?? 80), 1), 1e3);
+    const safe = rawId.replace(/[^a-zA-Z0-9._-]/g, "_");
+    const path = join2(homedir(), ".agenticmail", "worker-logs", `${safe}.log`);
+    if (!existsSync(path)) {
+      res.status(404).json({ error: "no log file for that workerId" });
+      return;
+    }
+    try {
+      const raw = readFileSync2(path, "utf-8");
+      const stat = statSync(path);
+      const all = raw.split(/\r?\n/);
+      const tail = all.filter(Boolean).slice(-lines);
+      res.json({
+        workerId: rawId,
+        path,
+        bytes: stat.size,
+        lines: tail.length,
+        tail
+      });
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
   return router;
 }
 
@@ -4852,15 +4902,15 @@ function createApp(configOverrides) {
   const staticDir = (() => {
     const here = dirname2(fileURLToPath2(import.meta.url));
     const candidates = [
-      join2(here, "..", "public"),
-      join2(here, "public")
+      join3(here, "..", "public"),
+      join3(here, "public")
     ];
-    for (const c of candidates) if (existsSync(c)) return c;
+    for (const c of candidates) if (existsSync2(c)) return c;
     return null;
   })();
   if (staticDir) {
     app2.use("/", express.static(staticDir, { index: "index.html", extensions: ["html"] }));
-    app2.get("/ui", (_req, res) => res.sendFile(join2(staticDir, "index.html")));
+    app2.get("/ui", (_req, res) => res.sendFile(join3(staticDir, "index.html")));
   }
   app2.use("/api/agenticmail", createHealthRoutes(stalwart));
   app2.use("/api/agenticmail", createInboundRoutes(accountManager2, config, gatewayManager));
@@ -4889,9 +4939,9 @@ function createApp(configOverrides) {
 }
 
 // src/index.ts
-import { readFileSync as readFileSync2 } from "fs";
+import { readFileSync as readFileSync3 } from "fs";
 import { fileURLToPath as fileURLToPath3 } from "url";
-import { dirname as dirname3, join as join3 } from "path";
+import { dirname as dirname3, join as join4 } from "path";
 await prepareIntegrations();
 function getLocalIp() {
   const nets = networkInterfaces();
@@ -4906,7 +4956,7 @@ function getLocalIp() {
 var VERSION = (() => {
   try {
     const __dirname = dirname3(fileURLToPath3(import.meta.url));
-    const pkg = JSON.parse(readFileSync2(join3(__dirname, "..", "package.json"), "utf-8"));
+    const pkg = JSON.parse(readFileSync3(join4(__dirname, "..", "package.json"), "utf-8"));
     return pkg.version;
   } catch {
     return "0.5.31";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/api",
-  "version": "0.7.8",
+  "version": "0.7.11",
   "description": "REST API server for AgenticMail — email and SMS endpoints for AI agents",
   "type": "module",
   "main": "dist/index.js",

package/public/branding/claude-mark.svg

@@ -0,0 +1,2 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="73 220 158 165" fill="currentColor" aria-hidden="true"><path d="m 105.01,322.07 29.14,-16.35 0.49,-1.42 -0.49,-0.79 h -1.42 l -4.87,-0.3 -16.65,-0.45 -14.44,-0.6 -13.99,-0.75 -3.52,-0.75 -3.3,-4.35 0.34,-2.17 2.96,-1.99 4.24,0.37 9.37,0.64 14.06,0.97 10.2,0.6 15.11,1.57 h 2.4 l 0.34,-0.97 -0.82,-0.6 -0.64,-0.6 -14.55,-9.86 -15.75,-10.42 -8.25,-6 -4.46,-3.04 -2.25,-2.85 -0.97,-6.22 4.05,-4.46 5.44,0.37 1.39,0.37 5.51,4.24 11.77,9.11 15.37,11.32 2.25,1.87 0.9,-0.64 0.11,-0.45 -1.01,-1.69 -8.36,-15.11 -8.92,-15.37 -3.97,-6.37 -1.05,-3.82 c -0.37,-1.57 -0.64,-2.89 -0.64,-4.5 l 4.61,-6.26 2.55,-0.82 6.15,0.82 2.59,2.25 3.82,8.74 6.19,13.76 9.6,18.71 2.81,5.55 1.5,5.14 0.56,1.57 h 0.97 v -0.9 l 0.79,-10.54 1.46,-12.94 1.42,-16.65 0.49,-4.69 2.32,-5.62 4.61,-3.04 3.6,1.72 2.96,4.24 -0.41,2.74 -1.76,11.44 -3.45,17.92 -2.25,12 h 1.31 l 1.5,-1.5 6.07,-8.06 10.2,-12.75 4.5,-5.06 5.25,-5.59 3.37,-2.66 h 6.37 l 4.69,6.97 -2.1,7.2 -6.56,8.32 -5.44,7.05 -7.8,10.5 -4.87,8.4 0.45,0.67 1.16,-0.11 17.62,-3.75 9.52,-1.72 11.36,-1.95 5.14,2.4 0.56,2.44 -2.02,4.99 -12.15,3 -14.25,2.85 -21.22,5.02 -0.26,0.19 0.3,0.37 9.56,0.9 4.09,0.22 h 10.01 l 18.64,1.39 4.87,3.22 2.92,3.94 -0.49,3 -7.5,3.82 -10.12,-2.4 -23.62,-5.62 -8.1,-2.02 h -1.12 v 0.67 l 6.75,6.6 12.37,11.17 15.49,14.4 0.79,3.56 -1.99,2.81 -2.1,-0.3 -13.61,-10.24 -5.25,-4.61 -11.89,-10.01 h -0.79 v 1.05 l 2.74,4.01 14.47,21.75 0.75,6.67 -1.05,2.17 -3.75,1.31 -4.12,-0.75 -8.47,-11.89 -8.74,-13.39 -7.05,-12 -0.86,0.49 -4.16,44.81 -1.95,2.29 -4.5,1.72 -3.75,-2.85 -1.99,-4.61 1.99,-9.11 2.4,-11.89 1.95,-9.45 1.76,-11.74 1.05,-3.9 -0.07,-0.26 -0.86,0.11 -8.85,12.15 -13.46,18.19 -10.65,11.4 -2.55,1.01 -4.42,-2.29 0.41,-4.09 2.47,-3.64 14.74,-18.75 8.89,-11.62 5.74,-6.71 -0.04,-0.97 h -0.34 l -39.15,25.42 -6.97,0.9 -3,-2.81 0.37,-4.61 1.42,-1.5 11.77,-8.1 -0.04,0.04 z"
+       shape-rendering="optimizeQuality"/></svg>