@agenticmail/api 0.7.21 → 0.9.0

package/README.md

@@ -8,7 +8,14 @@ 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.16
+## ✨ What's new in 0.9.0
+
+- **🧠 Agent-thread memory + thread-id resolver endpoints.** Agents persist their own per-thread judgment so the dispatcher can pre-load it into the next wake's prompt:
+  - `GET / POST / DELETE /agents/me/memory/threads/:t` — agent-key scoped; each agent only ever touches its own memory file.
+  - `GET /agents/me/thread-id?uid=42&folder=INBOX` — resolves the stable subject-only thread id for a message UID, looking up the canonical root via the dispatcher's ThreadCache when available.
+- **🎯 `wake` default flipped to "To: only".** `POST /mail/send`, `POST /drafts/:id/send`, `POST /templates/:id/send`, and the pending-outbound persistence path all derive the implicit allowlist from local recipients on the `To:` field when `wake` is omitted. CC'd local agents receive the mail without waking. New helper `deriveDefaultWakeList(to)` exported from `routes/mail.ts`. Opt back into the old behaviour with `wake: 'all'`.
+
+## ✨ Earlier — 0.7.16
 
 - **📐 Typed task contracts** — `POST /tasks/assign` and the long-poll `POST /tasks/rpc` accept an optional `outputSchema` field (JSON Schema, draft-7 subset). The schema is persisted on the task row via migration `014_task_output_schema.sql` and is rendered into the worker's wake prompt. `POST /tasks/:id/result` validates against the schema before accepting; mismatches return **400** with a flat `schemaErrors: [{ path, message }]` list. Validator lives at `src/lib/schema-validator.ts` (hand-rolled, no `ajv` dep) and supports `type`, `required`, `properties`, `items`, `enum`, `additionalProperties: false`, `minLength`/`maxLength`, `minimum`/`maximum`. Tasks without a schema keep the v0.8.x behaviour — fully back-compat.
 - **⭐ Star endpoint** — `POST /mail/messages/:uid/star` with `{ starred: boolean, folder?: string }`. Maps to IMAP's `\Flagged` flag — same on-disk bit Gmail's star uses.

package/dist/index.js

@@ -903,7 +903,8 @@ function createFeatureRoutes(db, _accountManager, config, gatewayManager) {
         return;
       }
       const agent = req.agent;
-      const wakeList = normalizeWakeList(req.body?.wake);
+      const explicitWake = normalizeWakeList(req.body?.wake);
+      const wakeList = req.body?.wake === void 0 ? deriveDefaultWakeList(draft.to_addr) : explicitWake;
       const customHeaders = wakeHeaders(wakeList);
       let persistedAttachments;
       if (draft.attachments) {
@@ -1189,7 +1190,8 @@ function createFeatureRoutes(db, _accountManager, config, gatewayManager) {
         return;
       }
       const applyVars = (text, vars2) => text.replace(/\{\{(\w+)\}\}/g, (m, key) => vars2[key] ?? m);
-      const wakeList = normalizeWakeList(wake);
+      const explicitWake = normalizeWakeList(wake);
+      const wakeList = wake === void 0 ? deriveDefaultWakeList(to) : explicitWake;
       const customHeaders = wakeHeaders(wakeList);
       const vars = variables && typeof variables === "object" ? variables : {};
       const renderedSubject = applyVars(template.subject || "(no subject)", vars);
@@ -1799,13 +1801,29 @@ function normalizeMessageId(id) {
   if (!id) return "";
   return id.trim().replace(/^<+|>+$/g, "").toLowerCase();
 }
+var WAKE_ALL_SENTINEL = "__wake_all__";
 function normalizeWakeList(value) {
   if (value === void 0 || value === null) return void 0;
+  if (value === "all" || value === WAKE_ALL_SENTINEL) return void 0;
   const strip = (s) => s.trim().replace(/@localhost$/i, "").toLowerCase();
   if (Array.isArray(value)) return value.map((v) => strip(String(v))).filter(Boolean);
   if (typeof value === "string") return value.split(",").map(strip).filter(Boolean);
   return void 0;
 }
+function deriveDefaultWakeList(toField) {
+  if (!toField) return void 0;
+  const arr = Array.isArray(toField) ? toField : String(toField).split(",");
+  const localNames = [];
+  for (const raw of arr) {
+    const addr = String(raw).trim().toLowerCase();
+    if (!addr.endsWith("@localhost")) continue;
+    const m = addr.match(/<([^>]+)>/);
+    const bare = m ? m[1].trim() : addr;
+    const name = bare.replace(/@localhost$/i, "");
+    if (name) localNames.push(name);
+  }
+  return localNames.length > 0 ? localNames : void 0;
+}
 function wakeHeaders(wakeList) {
   if (wakeList === void 0) return {};
   return { "X-AgenticMail-Wake": wakeList.join(", ") };
@@ -1933,7 +1951,8 @@ function createMailRoutes(accountManager2, config, db, gatewayManager) {
           const pendingId = crypto.randomUUID();
           const ownerName2 = agent.metadata?.ownerName;
           const fromName2 = ownerName2 ? `${agent.name} from ${ownerName2}` : agent.name;
-          const wakeListForPersist = normalizeWakeList(wake);
+          const explicitWakeForPersist = normalizeWakeList(wake);
+          const wakeListForPersist = wake === void 0 ? deriveDefaultWakeList(to) : explicitWakeForPersist;
           const mailOptions = {
             to,
             subject,
@@ -2016,7 +2035,8 @@ function createMailRoutes(accountManager2, config, db, gatewayManager) {
       }
       const ownerName = agent.metadata?.ownerName;
       const fromName = ownerName ? `${agent.name} from ${ownerName}` : agent.name;
-      const wakeList = normalizeWakeList(wake);
+      const explicitWake = normalizeWakeList(wake);
+      const wakeList = wake === void 0 ? deriveDefaultWakeList(to) : explicitWake;
       const customHeaders = wakeHeaders(wakeList);
       const mailOpts = {
         to,
@@ -5196,6 +5216,91 @@ function createDispatcherActivityRoutes() {
   return router;
 }
 
+// src/routes/agent-memory.ts
+import { Router as Router14 } from "express";
+import {
+  AgentMemoryStore,
+  threadIdFor,
+  ThreadCache
+} from "@agenticmail/core";
+function createAgentMemoryRoutes(config) {
+  const router = Router14();
+  const memoryStore = new AgentMemoryStore();
+  const threadCache = new ThreadCache();
+  router.get("/agents/me/memory/threads/:t", requireAgent, async (req, res, next) => {
+    try {
+      const t = String(req.params.t);
+      const memory = memoryStore.read(req.agent.id, t);
+      if (!memory) {
+        res.status(404).json({ error: "No memory for this thread" });
+        return;
+      }
+      res.json(memory);
+    } catch (err) {
+      next(err);
+    }
+  });
+  router.post("/agents/me/memory/threads/:t", requireAgent, async (req, res, next) => {
+    try {
+      const t = String(req.params.t);
+      const { summary, commitments, openQuestions, lastAction, lastUid } = req.body ?? {};
+      if (!summary && !commitments && !openQuestions && !lastAction && lastUid === void 0) {
+        res.status(400).json({ error: "At least one field is required (summary, commitments, openQuestions, lastAction, or lastUid)" });
+        return;
+      }
+      memoryStore.write(req.agent.id, t, {
+        summary: typeof summary === "string" ? summary : void 0,
+        commitments: Array.isArray(commitments) ? commitments.map(String) : void 0,
+        openQuestions: Array.isArray(openQuestions) ? openQuestions.map(String) : void 0,
+        lastAction: typeof lastAction === "string" ? lastAction : void 0,
+        lastUid: typeof lastUid === "number" ? lastUid : void 0
+      });
+      res.json({ ok: true, threadId: t });
+    } catch (err) {
+      next(err);
+    }
+  });
+  router.delete("/agents/me/memory/threads/:t", requireAgent, async (req, res, next) => {
+    try {
+      memoryStore.delete(req.agent.id, String(req.params.t));
+      res.json({ ok: true });
+    } catch (err) {
+      next(err);
+    }
+  });
+  router.get("/agents/me/thread-id", requireAgent, async (req, res, next) => {
+    try {
+      const uid = parseInt(String(req.query.uid ?? ""), 10);
+      if (isNaN(uid) || uid < 1) {
+        res.status(400).json({ error: "uid query param is required" });
+        return;
+      }
+      const folder = req.query.folder || "INBOX";
+      const password = getAgentPassword(req.agent);
+      const receiver = await getReceiver(req.agent.stalwartPrincipal, password, config);
+      const envs = await receiver.listEnvelopes(folder, { limit: 1, offset: 0 });
+      const envelope = envs.find((e) => e.uid === uid) ?? (await receiver.listEnvelopes(folder, { limit: 200, offset: 0 })).find((e) => e.uid === uid);
+      if (!envelope) {
+        res.status(404).json({ error: `No message with UID ${uid} in folder ${folder}` });
+        return;
+      }
+      const subject = envelope.subject ?? "";
+      const senderAddr = envelope.from?.[0]?.address ?? "";
+      const provisional = threadIdFor({ subject, rootFromAddr: senderAddr });
+      const existing = threadCache.read(provisional);
+      if (existing) {
+        const canonical = threadIdFor({ subject, rootFromAddr: existing.rootFromAddr });
+        res.json({ threadId: canonical, rootFromAddr: existing.rootFromAddr, subject: existing.subject });
+        return;
+      }
+      res.json({ threadId: provisional, rootFromAddr: senderAddr, subject });
+    } catch (err) {
+      next(err);
+    }
+  });
+  return router;
+}
+
 // src/app.ts
 var integrationRouteFactoryPromise = (async () => {
   try {
@@ -5296,6 +5401,7 @@ function createApp(configOverrides) {
   app2.use("/api/agenticmail", createStorageRoutes(db, accountManager2, config));
   app2.use("/api/agenticmail", createSystemEventRoutes());
   app2.use("/api/agenticmail", createDispatcherActivityRoutes());
+  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.7.21",
+  "version": "0.9.0",
   "description": "REST API server for AgenticMail — email and SMS endpoints for AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -28,7 +28,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@agenticmail/core": "^0.7.0",
+    "@agenticmail/core": "^0.9.0",
     "cors": "^2.8.5",
     "dotenv": "^16.4.7",
     "express": "^4.21.0",
@@ -36,7 +36,7 @@
     "uuid": "^11.1.0"
   },
   "optionalDependencies": {
-    "@agenticmail/claudecode": "^0.1.0"
+    "@agenticmail/claudecode": "^0.2.0"
   },
   "devDependencies": {
     "@types/cors": "^2.8.17",