@agenticmail/api 0.9.25 → 0.9.26

package/dist/index.js

@@ -282,6 +282,30 @@ function closeAllSystemEventListeners() {
 }
 function createSystemEventRoutes() {
   const router = Router2();
+  router.get("/system/operator-email", requireMaster, async (_req, res) => {
+    try {
+      const { getOperatorEmail } = await import("@agenticmail/core");
+      res.json({ email: getOperatorEmail() });
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+  router.patch("/system/operator-email", requireMaster, async (req, res) => {
+    try {
+      const { setOperatorEmail } = await import("@agenticmail/core");
+      const raw = req.body && typeof req.body === "object" ? req.body.email : null;
+      const email = typeof raw === "string" ? raw : null;
+      const stored = setOperatorEmail(email);
+      res.json({ email: stored });
+    } catch (err) {
+      const msg = err.message;
+      if (msg.includes("must contain an @")) {
+        res.status(400).json({ error: msg });
+        return;
+      }
+      res.status(500).json({ error: msg });
+    }
+  });
   router.get("/system/events", requireMaster, (req, res) => {
     res.setHeader("Content-Type", "text/event-stream");
     res.setHeader("Cache-Control", "no-cache");
@@ -5326,7 +5350,7 @@ var skipped = [];
 var SKIPPED_CAP = 100;
 var SKIPPED_TTL_MS = 5 * 60 * 1e3;
 var processState = null;
-function createDispatcherActivityRoutes() {
+function createDispatcherActivityRoutes(deps = {}) {
   const router = Router13();
   router.post("/dispatcher/worker-started", requireMaster, (req, res) => {
     const body = req.body ?? {};
@@ -5490,7 +5514,7 @@ function createDispatcherActivityRoutes() {
     });
     res.json({ ok: true });
   });
-  router.post("/dispatcher/bridge-escalation", requireMaster, (req, res) => {
+  router.post("/dispatcher/bridge-escalation", requireMaster, async (req, res) => {
     const body = req.body ?? {};
     const event = {
       type: "bridge_escalation",
@@ -5505,7 +5529,43 @@ function createDispatcherActivityRoutes() {
       atMs: Date.now()
     };
     pushSystemEvent(event);
-    res.json({ ok: true, escalated: true });
+    let forwarded = false;
+    try {
+      const { getOperatorEmail } = await import("@agenticmail/core");
+      const operatorEmail = getOperatorEmail();
+      if (operatorEmail && deps.gatewayManager && deps.accountManager && event.agentName) {
+        const bridge = await deps.accountManager.getByName(event.agentName);
+        if (bridge) {
+          const subjectLine = `[AgenticMail Alert] Sub-agent needs your attention \u2014 ${event.subject ?? "(no subject)"}`;
+          const lines = [
+            `A sub-agent mailed your ${event.agentName}@localhost bridge inbox and the dispatcher could not resume a host session to handle it on your behalf.`,
+            "",
+            `Reason: ${event.reason}${event.errorMessage ? ` \u2014 ${event.errorMessage.slice(0, 160)}` : ""}`,
+            "",
+            `From:    ${event.from ?? "unknown"}`,
+            `Subject: ${event.subject ?? "(no subject)"}`,
+            `UID:     ${event.uid ?? "?"}`,
+            "",
+            event.preview ? `Preview:
+${event.preview.slice(0, 800)}` : "",
+            "",
+            `Open ${event.agentName} in the AgenticMail web UI, or run \`claude\` / \`codex\` and the next hook fire will surface this thread.`,
+            "",
+            `\u2014 AgenticMail (this address is set via setup_operator_email; reply does nothing)`
+          ].filter(Boolean).join("\n");
+          await deps.gatewayManager.routeOutbound(bridge.name, {
+            from: bridge.email,
+            to: operatorEmail,
+            subject: subjectLine,
+            text: lines
+          });
+          forwarded = true;
+        }
+      }
+    } catch (err) {
+      console.warn("[bridge-escalation] forward to operator email failed:", err.message);
+    }
+    res.json({ ok: true, escalated: true, forwarded });
   });
   router.post("/dispatcher/worker-skipped", requireMaster, (req, res) => {
     const body = req.body ?? {};
@@ -5765,7 +5825,15 @@ function createApp(configOverrides) {
   app2.use("/api/agenticmail", createSmsRoutes(db, accountManager, config, gatewayManager));
   app2.use("/api/agenticmail", createStorageRoutes(db, accountManager, config));
   app2.use("/api/agenticmail", createSystemEventRoutes());
-  app2.use("/api/agenticmail", createDispatcherActivityRoutes());
+  app2.use("/api/agenticmail", createDispatcherActivityRoutes({
+    // Wire the gateway + account manager so /dispatcher/bridge-escalation
+    // can forward a digest to the operator's notification email when
+    // no host session is available for a headless resume. See
+    // packages/core/src/operator-prefs.ts for the address source and
+    // the setup_operator_email MCP tool for how it gets configured.
+    gatewayManager,
+    accountManager
+  }));
   app2.use("/api/agenticmail", createAgentMemoryRoutes(config));
   app2.use("/api/agenticmail", (_req, res) => {
     res.status(404).json({ error: "Not found" });

package/package.json

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