@agenticmail/api 0.3.3 → 0.5.0

package/dist/index.js

@@ -3080,6 +3080,257 @@ function parseTask(row) {
   };
 }
 
+// src/routes/sms.ts
+import { Router as Router10 } from "express";
+import {
+  SmsManager,
+  parseGoogleVoiceSms,
+  extractVerificationCode,
+  normalizePhoneNumber,
+  isValidPhoneNumber
+} from "@agenticmail/core";
+function createSmsRoutes(db, accountManager, config, gatewayManager) {
+  const router = Router10();
+  const smsManager = new SmsManager(db);
+  function getAgent(req, res) {
+    const agent = req.agent;
+    if (!agent) {
+      res.status(401).json({ error: "Authentication required" });
+      return null;
+    }
+    return agent;
+  }
+  router.get("/sms/config", (req, res) => {
+    try {
+      const agent = getAgent(req, res);
+      if (!agent) return;
+      const smsConfig = smsManager.getSmsConfig(agent.id);
+      res.json({
+        configured: !!smsConfig,
+        sms: smsConfig ?? null
+      });
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+  router.post("/sms/setup", (req, res) => {
+    try {
+      const agent = getAgent(req, res);
+      if (!agent) return;
+      const { phoneNumber, forwardingEmail, forwardingPassword } = req.body;
+      if (!phoneNumber || typeof phoneNumber !== "string") {
+        return res.status(400).json({ error: "phoneNumber is required (string)" });
+      }
+      if (!isValidPhoneNumber(phoneNumber)) {
+        return res.status(400).json({
+          error: "Invalid phone number. Provide a US number like +12125551234 or (212) 555-1234."
+        });
+      }
+      const normalized = normalizePhoneNumber(phoneNumber);
+      if (forwardingEmail && typeof forwardingEmail === "string") {
+        if (!forwardingEmail.includes("@")) {
+          return res.status(400).json({ error: "forwardingEmail must be a valid email address" });
+        }
+      }
+      const fwdEmail = typeof forwardingEmail === "string" && forwardingEmail.trim() || "";
+      let relayEmail = "";
+      try {
+        if (gatewayManager) {
+          const gwStatus = gatewayManager.getStatus?.() || gatewayManager.status?.();
+          if (gwStatus?.relay?.email) {
+            relayEmail = gwStatus.relay.email;
+          }
+        }
+        if (!relayEmail) {
+          const gwConfig = config.gateway;
+          if (gwConfig && "email" in gwConfig) relayEmail = gwConfig.email || "";
+        }
+      } catch {
+      }
+      const effectiveEmail = fwdEmail || relayEmail || agent.email || "";
+      const sameAsRelay = !fwdEmail || !!relayEmail && fwdEmail.toLowerCase() === relayEmail.toLowerCase();
+      const smsConfig = {
+        enabled: true,
+        phoneNumber: normalized,
+        forwardingEmail: effectiveEmail,
+        forwardingPassword: !sameAsRelay && typeof forwardingPassword === "string" && forwardingPassword.trim() ? forwardingPassword.trim() : void 0,
+        sameAsRelay: !!sameAsRelay,
+        provider: "google_voice",
+        configuredAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      smsManager.saveSmsConfig(agent.id, smsConfig);
+      const nextSteps = [
+        "Ensure Google Voice SMS forwarding is enabled in Settings > Messages."
+      ];
+      if (smsConfig.sameAsRelay) {
+        nextSteps.push(`SMS will be detected automatically during email polling (same Gmail: ${effectiveEmail}).`);
+      } else if (smsConfig.forwardingPassword) {
+        nextSteps.push(`SMS will be polled separately from ${effectiveEmail} (separate Gmail with credentials).`);
+      } else {
+        nextSteps.push(`WARNING: SMS forwarding email (${effectiveEmail}) differs from relay but no password provided. SMS polling will NOT work.`);
+        nextSteps.push("Provide forwardingPassword to enable SMS polling, or use the same Gmail for relay and Google Voice.");
+      }
+      res.json({
+        success: true,
+        sms: { ...smsConfig, forwardingPassword: smsConfig.forwardingPassword ? "***" : void 0 },
+        nextSteps
+      });
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+  router.post("/sms/disable", (req, res) => {
+    try {
+      const agent = getAgent(req, res);
+      if (!agent) return;
+      const existing = smsManager.getSmsConfig(agent.id);
+      if (existing) {
+        existing.enabled = false;
+        smsManager.saveSmsConfig(agent.id, existing);
+        res.json({ success: true, message: "SMS disabled" });
+      } else {
+        res.json({ success: true, message: "SMS was not configured" });
+      }
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+  router.get("/sms/messages", (req, res) => {
+    try {
+      const agent = getAgent(req, res);
+      if (!agent) return;
+      const rawDir = req.query.direction;
+      const direction = rawDir === "inbound" || rawDir === "outbound" ? rawDir : void 0;
+      const limit = Math.min(Math.max(parseInt(req.query.limit) || 20, 1), 100);
+      const offset = Math.max(parseInt(req.query.offset) || 0, 0);
+      const messages = smsManager.listMessages(agent.id, { direction, limit, offset });
+      res.json({ messages, count: messages.length });
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+  router.post("/sms/send", (req, res) => {
+    try {
+      const agent = getAgent(req, res);
+      if (!agent) return;
+      const smsConfig = smsManager.getSmsConfig(agent.id);
+      if (!smsConfig?.enabled) {
+        return res.status(400).json({
+          error: "SMS not configured or disabled. Use sms_setup first.",
+          hint: "Call agenticmail_sms_setup with your Google Voice phone number."
+        });
+      }
+      const { to, body } = req.body;
+      if (!to || typeof to !== "string") {
+        return res.status(400).json({ error: '"to" (phone number) is required' });
+      }
+      if (!body || typeof body !== "string") {
+        return res.status(400).json({ error: '"body" (message text) is required' });
+      }
+      if (body.length > 1600) {
+        return res.status(400).json({ error: "SMS body too long (max 1600 characters, ~10 SMS segments)" });
+      }
+      if (!isValidPhoneNumber(to)) {
+        return res.status(400).json({ error: 'Invalid "to" phone number' });
+      }
+      const smsRecord = smsManager.recordOutbound(agent.id, to, body, "pending");
+      res.json({
+        success: true,
+        sms: smsRecord,
+        sendInstructions: {
+          method: "browser_automation",
+          url: "https://voice.google.com",
+          steps: [
+            "Open voice.google.com in browser",
+            `Click "Send a message" or navigate to Messages`,
+            `Enter recipient: ${normalizePhoneNumber(to)}`,
+            `Type message and send`,
+            `Then call agenticmail_sms_messages to verify it was recorded`
+          ]
+        }
+      });
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+  router.post("/sms/parse-email", (req, res) => {
+    try {
+      const agent = getAgent(req, res);
+      if (!agent) return;
+      const { emailBody, emailFrom } = req.body;
+      if (!emailBody || typeof emailBody !== "string") {
+        return res.status(400).json({ error: "emailBody is required (string)" });
+      }
+      const parsed = parseGoogleVoiceSms(emailBody, emailFrom || "");
+      if (!parsed) {
+        return res.json({
+          success: false,
+          parsed: null,
+          verificationCode: null,
+          message: "Could not parse SMS from this email. It may not be a Google Voice forwarded SMS."
+        });
+      }
+      const msg = smsManager.recordInbound(agent.id, parsed);
+      const code = extractVerificationCode(parsed.body);
+      res.json({
+        success: true,
+        sms: msg,
+        verificationCode: code
+      });
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+  router.get("/sms/verification-code", (req, res) => {
+    try {
+      const agent = getAgent(req, res);
+      if (!agent) return;
+      const minutesBack = Math.min(Math.max(parseInt(req.query.minutes) || 10, 1), 1440);
+      const result = smsManager.checkForVerificationCode(agent.id, minutesBack);
+      if (result) {
+        res.json({ found: true, ...result });
+      } else {
+        res.json({
+          found: false,
+          message: `No verification codes found in the last ${minutesBack} minutes.`,
+          hint: "TIP: For fastest results, open https://voice.google.com/u/0/messages in the browser and read the code directly. Then use agenticmail_sms_record to save it. Email forwarding can be delayed 1-5 minutes."
+        });
+      }
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+  router.post("/sms/record", (req, res) => {
+    try {
+      const agent = getAgent(req, res);
+      if (!agent) return;
+      const { from, body } = req.body;
+      if (!from || typeof from !== "string") {
+        return res.status(400).json({ error: '"from" (sender phone number) is required' });
+      }
+      if (!body || typeof body !== "string") {
+        return res.status(400).json({ error: '"body" (message text) is required' });
+      }
+      const normalizedFrom = normalizePhoneNumber(from) || from.replace(/[^+\d]/g, "");
+      const msg = smsManager.recordInbound(agent.id, {
+        from: normalizedFrom,
+        body: body.trim(),
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      const code = extractVerificationCode(body);
+      res.json({
+        success: true,
+        sms: msg,
+        verificationCode: code,
+        source: "manual_record"
+      });
+    } catch (err) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+  return router;
+}
+
 // src/app.ts
 function createApp(configOverrides) {
   const config = resolveConfig(configOverrides);
@@ -3129,6 +3380,7 @@ function createApp(configOverrides) {
   app2.use("/api/agenticmail", createGatewayRoutes(gatewayManager));
   app2.use("/api/agenticmail", createFeatureRoutes(db, accountManager, config, gatewayManager));
   app2.use("/api/agenticmail", createTaskRoutes(db, accountManager, config));
+  app2.use("/api/agenticmail", createSmsRoutes(db, accountManager, config, gatewayManager));
   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.3.3",
+  "version": "0.5.0",
   "description": "REST API server for AgenticMail",
   "type": "module",
   "main": "dist/index.js",
@@ -27,7 +27,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@agenticmail/core": "^0.3.0",
+    "@agenticmail/core": "^0.5.0",
     "cors": "^2.8.5",
     "dotenv": "^16.4.7",
     "express": "^4.21.0",