@agenticmail/cli 0.9.35 → 0.9.37

package/dist/cli.js

@@ -4927,6 +4927,75 @@ var NON_INTERACTIVE = false;
 function nonInteractiveDefault(value) {
   return NON_INTERACTIVE ? value : null;
 }
+async function cmdSetupRelay() {
+  const args = process.argv.slice(3);
+  if (args.some((a) => a === "--help" || a === "-h" || a === "help")) {
+    log2("");
+    log2(`  ${c2.pinkBg(" \u{1F380} agenticmail setup-relay ")}`);
+    log2("");
+    log2(`  ${c2.bold("Usage:")} agenticmail setup-relay`);
+    log2("");
+    log2(`  Adds (or updates) the Gmail / Outlook / custom relay AgenticMail uses`);
+    log2(`  to send mail to the public internet. Run this YOURSELF \u2014 never paste`);
+    log2(`  the Gmail app password into an agent's chat (it would end up in the`);
+    log2(`  LLM's context / logs / conversation history).`);
+    log2("");
+    log2(`  Password input is hidden (raw-mode stdin). The agent never sees it.`);
+    log2("");
+    log2(`  Prereq: AgenticMail already bootstrapped (run \`agenticmail setup\` first).`);
+    log2("");
+    return;
+  }
+  const configPath = join(homedir(), ".agenticmail", "config.json");
+  if (!existsSync2(configPath)) {
+    log2("");
+    fail2(`AgenticMail isn't set up yet \u2014 no config at ${c2.dim(configPath)}`);
+    log2(`  Run ${c2.cyan("agenticmail setup")} first, then come back to add the relay.`);
+    log2("");
+    process.exit(1);
+  }
+  let config;
+  try {
+    config = JSON.parse(readFileSync2(configPath, "utf-8"));
+  } catch (err) {
+    log2("");
+    fail2(`Could not read ${configPath}: ${err.message}`);
+    log2("");
+    process.exit(1);
+  }
+  log2("");
+  log2(`   ${c2.bold("\u{1F380} AgenticMail \u2014 set up Gmail relay")} `);
+  log2("");
+  log2(`  ${c2.dim("This command runs entirely in your terminal. The password")}`);
+  log2(`  ${c2.dim("input is hidden and never leaves this process \u2014 your agent")}`);
+  log2(`  ${c2.dim("doesn't see it.")}`);
+  log2("");
+  try {
+    const result = await setupRelay(config);
+    if (!result.success) {
+      log2("");
+      fail2("Relay setup did not complete \u2014 see messages above.");
+      process.exit(1);
+    }
+    log2("");
+    ok2("Gmail relay configured.");
+    log2("");
+    log2(`  ${c2.bold("Next:")} point bridge-escalation alerts at your personal email:`);
+    log2("");
+    log2(`    ${c2.cyan("Option A")} \u2014 tell your host agent: "set my operator notification email to <you@gmail.com>"`);
+    log2(`    ${c2.cyan("Option B")} \u2014 open the web UI \u2192 click your avatar \u2192 ${c2.bold("Alert email")} \u2192 type, Save`);
+    log2("");
+    log2(`  ${c2.dim("Either path writes ~/.agenticmail/operator-prefs.json \u2014 the dispatcher")}`);
+    log2(`  ${c2.dim("forwards a digest there when sub-agents mail your bridge and the")}`);
+    log2(`  ${c2.dim("dispatcher can't resume your host session.")}`);
+    log2("");
+  } catch (err) {
+    log2("");
+    fail2(`Setup-relay failed: ${err.message}`);
+    log2("");
+    process.exit(1);
+  }
+}
 async function cmdSetup() {
   const setupArgs = process.argv.slice(3);
   if (setupArgs.some((a) => a === "--help" || a === "-h" || a === "help")) {
@@ -7392,6 +7461,13 @@ switch (command) {
       process.exit(1);
     });
     break;
+  case "setup-relay":
+  case "relay":
+    cmdSetupRelay().catch((err) => {
+      console.error(err);
+      process.exit(1);
+    });
+    break;
   case "start":
     cmdStart().catch((err) => {
       console.error(err);

package/dist/public/index.html

@@ -63,6 +63,8 @@
       <div class="profile-menu-section">Inboxes</div>
       <div id="profile-menu-list"></div>
       <div class="profile-menu-divider"></div>
+      <div id="profile-menu-operator-email"></div>
+      <div class="profile-menu-divider"></div>
       <div class="profile-menu-footer">
         <a id="signout-link">Sign out</a>
       </div>

package/dist/public/js/api.js

@@ -37,6 +37,25 @@ export async function apiPut(path, body, opts = {}) {
   return await r.json();
 }
 
+export async function apiPatch(path, body, opts = {}) {
+  const r = await fetch(`${API_URL}/api/agenticmail${path}`, {
+    method: 'PATCH',
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${opts.agentKey ?? state.masterKey}`,
+    },
+    body: JSON.stringify(body),
+  });
+  if (!r.ok) {
+    // Try to surface the server's error body so the UI can show
+    // "operator email must contain an @" instead of a bare 400.
+    let detail = '';
+    try { const j = await r.json(); detail = j?.error ? `: ${j.error}` : ''; } catch { /* ignore */ }
+    throw new Error(`${r.status} ${path}${detail}`);
+  }
+  return await r.json();
+}
+
 /**
  * Fetch an attachment with auth and trigger a browser download.
  *

package/dist/public/js/profile.js

@@ -16,9 +16,10 @@
 // The selected host persists in localStorage so the operator's view
 // preference survives reloads and across browser tabs.
 import { state } from './state.js';
-import { escapeHtml } from './utils.js';
+import { escapeHtml, toast } from './utils.js';
 import { avatarHtml, isBridgeAgent } from './avatar.js';
 import { icon } from './icons.js';
+import { apiGet, apiPatch } from './api.js';
 
 /**
  * Host registry mirrors the one in avatar.js. Kept duplicated rather
@@ -339,8 +340,131 @@ export function bindHostSwitcher() {
   });
 }
 
+/**
+ * Operator notification email — show + edit in the profile menu.
+ *
+ * The dispatcher emails this address when a sub-agent mails a host
+ * bridge AND no fresh host session is available for a headless
+ * resume. Wired to `GET / PATCH /system/operator-email` (the same
+ * endpoints the `setup_operator_email` MCP tool uses, so changes
+ * from the UI and changes from a host agent stay in sync).
+ *
+ * Two states:
+ *   1. Display: shows the current email or "Not set", with a small
+ *      "Edit" pencil. Clicking the pencil swaps to state 2.
+ *   2. Edit: <input> + Save / Cancel buttons. Save fires PATCH,
+ *      shows a toast, and re-renders state 1.
+ *
+ * Cached value: `operatorEmail` lives on `state.operatorEmail` so a
+ * re-render of the profile menu doesn't refetch every time.
+ */
+
+async function loadOperatorEmail() {
+  try {
+    const r = await apiGet('/system/operator-email');
+    state.operatorEmail = (typeof r?.email === 'string' && r.email) ? r.email : null;
+  } catch (err) {
+    // 404 / 500 on older servers — degrade silently to "not set".
+    state.operatorEmail = null;
+  }
+  renderOperatorEmail();
+}
+
+function renderOperatorEmail() {
+  const slot = document.getElementById('profile-menu-operator-email');
+  if (!slot) return;
+  const value = state.operatorEmail;
+  const editing = slot.dataset.mode === 'edit';
+
+  if (editing) {
+    slot.innerHTML = `
+      <div class="profile-menu-section">Alert email</div>
+      <div class="operator-email-edit">
+        <input
+          type="email"
+          id="operator-email-input"
+          class="operator-email-input"
+          placeholder="you@example.com"
+          value="${escapeHtml(value ?? '')}" />
+        <div class="operator-email-actions">
+          <button class="operator-email-btn operator-email-btn-primary" id="operator-email-save">Save</button>
+          <button class="operator-email-btn" id="operator-email-cancel">Cancel</button>
+          ${value ? `<button class="operator-email-btn operator-email-btn-danger" id="operator-email-clear" title="Clear — no email forward">Clear</button>` : ''}
+        </div>
+        <div class="operator-email-hint">
+          Dispatcher emails this address when sub-agents mail your host bridge and the resume can't run (no fresh session, expired token). Phone push via your normal mail app.
+        </div>
+      </div>
+    `;
+    const input = document.getElementById('operator-email-input');
+    input?.focus();
+    input?.select();
+    document.getElementById('operator-email-save')?.addEventListener('click', () => saveOperatorEmail(input?.value ?? ''));
+    document.getElementById('operator-email-cancel')?.addEventListener('click', () => {
+      slot.dataset.mode = '';
+      renderOperatorEmail();
+    });
+    document.getElementById('operator-email-clear')?.addEventListener('click', () => saveOperatorEmail(''));
+    input?.addEventListener('keydown', (e) => {
+      if (e.key === 'Enter') saveOperatorEmail(input.value);
+      if (e.key === 'Escape') { slot.dataset.mode = ''; renderOperatorEmail(); }
+    });
+    return;
+  }
+
+  slot.innerHTML = `
+    <div class="profile-menu-section">Alert email</div>
+    <div class="operator-email-display" id="operator-email-display">
+      <div class="operator-email-value ${value ? '' : 'is-empty'}">
+        ${value ? escapeHtml(value) : 'Not set — sub-agent escalations stay in the web UI only'}
+      </div>
+      <button class="operator-email-edit-btn" id="operator-email-edit" title="${value ? 'Change' : 'Set up'}">
+        ${icon('compose', { size: 14 })}
+      </button>
+    </div>
+  `;
+  document.getElementById('operator-email-edit')?.addEventListener('click', () => {
+    slot.dataset.mode = 'edit';
+    renderOperatorEmail();
+  });
+}
+
+async function saveOperatorEmail(raw) {
+  const trimmed = String(raw ?? '').trim();
+  try {
+    // Server canonicalises (trims) and validates (must contain @ when
+    // non-empty). Empty string = clear, server stores null. We mirror
+    // the server's canonical value back into state so a refresh
+    // shows exactly what was persisted.
+    const r = await apiPatch('/system/operator-email', { email: trimmed || null });
+    state.operatorEmail = (typeof r?.email === 'string' && r.email) ? r.email : null;
+    toast(state.operatorEmail ? `Alerts now route to ${state.operatorEmail}` : 'Alert email cleared.');
+    const slot = document.getElementById('profile-menu-operator-email');
+    if (slot) slot.dataset.mode = '';
+    renderOperatorEmail();
+  } catch (err) {
+    toast(`Could not save: ${err.message.replace(/^\d+\s+\S+:\s*/, '')}`, true);
+  }
+}
+
+/** Lazy-load on first profile-menu open — keeps the initial page
+ *  load free of an extra round-trip. Subsequent opens use the
+ *  cached value in state.operatorEmail. */
+let operatorEmailHydrated = false;
+export function hydrateOperatorEmail() {
+  if (operatorEmailHydrated) {
+    renderOperatorEmail();
+    return;
+  }
+  operatorEmailHydrated = true;
+  void loadOperatorEmail();
+}
+
 export function toggleProfileMenu(e) {
   if (e) e.stopPropagation();
+  // Lazy-hydrate the operator email block the first time the menu
+  // opens (idempotent for subsequent opens — re-renders from cache).
+  hydrateOperatorEmail();
   document.getElementById('profile-menu').classList.toggle('open');
 }
 export function closeProfileMenu() {

package/dist/public/js/state.js

@@ -48,6 +48,16 @@ export const state = {
    * `state.agents` so no UI work is needed when a new bridge appears.
    */
   activeHost: localStorage.getItem('agenticmail.activeHost') || 'all',
+  /**
+   * Operator's notification email address (or null when not set).
+   * Hydrated lazily on first profile-menu open via
+   * `GET /system/operator-email`. Used by the dispatcher's
+   * bridge-escalation path to forward digests when a sub-agent
+   * mails a bridge and no host session is resumable. See
+   * packages/core/src/operator-prefs.ts for the storage and
+   * profile.js for the in-menu edit affordance.
+   */
+  operatorEmail: null,
 };
 
 export const API_URL = window.location.origin;

package/dist/public/styles.css

@@ -446,6 +446,109 @@ a { color: var(--accent-strong); }
 }
 .profile-menu-footer a:hover { text-decoration: underline; }
 
+/* ─── Operator notification email — display + inline edit ──────────
+ *
+ * Lives between the inbox list and the Sign out footer. Two states:
+ *  - Display: current address (or "Not set" placeholder) + pencil
+ *  - Edit:    <input> + Save / Cancel / Clear buttons + hint copy
+ *
+ * Visual weight is deliberately understated — this is a "set once,
+ * forget" knob, not a primary action. */
+.operator-email-display {
+  padding: 6px 20px 10px;
+  display: flex; align-items: center; gap: 8px;
+  font-size: 13px;
+}
+.operator-email-value {
+  flex: 1;
+  color: var(--ink);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.operator-email-value.is-empty {
+  color: var(--muted);
+  font-style: italic;
+  font-size: 12px;
+}
+.operator-email-edit-btn {
+  background: transparent;
+  border: none;
+  cursor: pointer;
+  color: var(--muted);
+  padding: 4px;
+  border-radius: 4px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+.operator-email-edit-btn:hover {
+  background: var(--bg-hover);
+  color: var(--ink);
+}
+.operator-email-edit {
+  padding: 4px 20px 12px;
+}
+.operator-email-input {
+  width: 100%;
+  padding: 8px 10px;
+  border: 1px solid var(--line);
+  border-radius: 6px;
+  background: var(--bg);
+  color: var(--ink);
+  font-size: 13px;
+  font-family: inherit;
+  box-sizing: border-box;
+}
+.operator-email-input:focus {
+  outline: none;
+  border-color: var(--accent-strong);
+}
+.operator-email-actions {
+  display: flex;
+  gap: 6px;
+  margin-top: 8px;
+}
+.operator-email-btn {
+  padding: 6px 12px;
+  border: 1px solid var(--line);
+  border-radius: 6px;
+  background: var(--bg);
+  color: var(--ink);
+  font-size: 12px;
+  font-weight: 500;
+  cursor: pointer;
+  transition: background 120ms, border-color 120ms;
+}
+.operator-email-btn:hover { background: var(--bg-hover); }
+.operator-email-btn-primary {
+  background: var(--accent-strong);
+  color: white;
+  border-color: var(--accent-strong);
+}
+.operator-email-btn-primary:hover {
+  background: var(--accent-strong);
+  opacity: 0.9;
+}
+.operator-email-btn-danger {
+  margin-left: auto;
+  color: #b91c1c;
+  border-color: transparent;
+}
+.operator-email-btn-danger:hover {
+  background: #fee2e2;
+}
+.operator-email-hint {
+  margin-top: 8px;
+  font-size: 11px;
+  color: var(--muted);
+  line-height: 1.45;
+}
+@media (prefers-color-scheme: dark) {
+  .operator-email-btn-danger { color: #fca5a5; }
+  .operator-email-btn-danger:hover { background: #2a1717; }
+}
+
 /* ─── Avatars ──────────────────────────────────────────────────────── */
 .avatar {
   width: 32px; height: 32px; border-radius: 50%;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/cli",
-  "version": "0.9.35",
+  "version": "0.9.37",
   "description": "Email and SMS infrastructure for AI agents — the first platform to give agents real email addresses and phone numbers",
   "type": "module",
   "main": "dist/index.js",
@@ -31,7 +31,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@agenticmail/api": "^0.9.26",
+    "@agenticmail/api": "^0.9.27",
     "@agenticmail/core": "^0.9.7",
     "json5": "^2.2.3"
   },