@agenticmail/cli 0.5.57 → 0.5.58

package/README.md

@@ -46,7 +46,7 @@ Running `agenticmail setup` walks you through everything needed to get email wor
 
 5. **Phone number access (optional)** — set up Google Voice for SMS. Agents can receive verification codes and send texts. The wizard validates Gmail/Google Voice email matching, warns about mismatches, and collects separate credentials when needed. SMS reading prioritizes direct Google Voice web access (instant) with email forwarding as fallback.
 
-6. **OpenClaw integration** — if OpenClaw is detected, automatically registers the plugin.
+6. **OpenClaw integration** — if you opt in by running `agenticmail openclaw`, the wizard registers and configures the plugin and restarts the OpenClaw gateway. Plugin registration only happens through that explicit flow — running `agenticmail setup` alone (without the `openclaw` subcommand) won't touch your OpenClaw config.
 
 ### Relay Mode (Recommended for Getting Started)
 
@@ -444,6 +444,24 @@ npm prefix -g
 
 Update the path in `~/.openclaw/openclaw.json` accordingly.
 
+### Verifying OpenClaw plugin registration
+
+`openclaw plugins inspect agenticmail` returning `Plugin not found: agenticmail` means the plugin entry hasn't been added to your `~/.openclaw/openclaw.json`. Run `agenticmail openclaw` to register it; running plain `agenticmail setup` does NOT touch your OpenClaw config — that step only fires through the explicit `openclaw` subcommand. To verify by hand: open `~/.openclaw/openclaw.json` and check that `plugins.entries` includes an entry with `"id": "agenticmail"` plus a `"path"` pointing at `<npm prefix>/lib/node_modules/@agenticmail/openclaw`.
+
+### `cloudflared` shows up after a localhost-only install
+
+The setup wizard always downloads `cloudflared` into `~/.agenticmail/bin/` so the binary is ready when you eventually flip to domain mode. Localhost-only installs leave the binary present but unused — `agenticmail status` no longer reports it as "Secure Tunnel ✅" (V0.5.58 fix); it only surfaces a "Cloudflared CLI" line when domain mode is actually configured.
+
+### Storage API hangs / 500s
+
+`POST /storage/tables` returning success or a structured error shape:
+
+```json
+{ "ok": true, "table": "agt_<agent>_<name>", "columns": [...], "indexes": [...] }
+```
+
+Errors return JSON: `400` (missing `name`/`columns`), `409` (table already exists), `500` (DB-level error with `message` field). If you see a hang on this or any other `/storage/*` endpoint with 0.5.57 or earlier, upgrade to 0.5.58 — that version fixes a wiring bug where the storage routes called an API the underlying SQLite client doesn't expose.
+
 ### `agenticmail: command not found`
 
 If you installed locally with `npm install agenticmail`, use `npx agenticmail` instead. For a global install:

package/dist/cli.js

@@ -5592,6 +5592,29 @@ function mergePluginConfig(existing, apiUrl, masterKey, agentApiKey, pluginDir)
   return result;
 }
 async function cmdOpenClaw() {
+  const sub = process.argv.slice(3);
+  if (sub.includes("--help") || sub.includes("-h") || sub.includes("help")) {
+    log2("");
+    log2(`  ${c2.pinkBg(" \u{1F380} AgenticMail for OpenClaw ")}`);
+    log2("");
+    log2(`  ${c2.bold("Usage:")} agenticmail openclaw`);
+    log2("");
+    log2("  Interactive setup wizard for the OpenClaw plugin. Walks you");
+    log2("  through six steps:");
+    log2(`    ${c2.dim("1.")} Set up the mail server infrastructure (Stalwart)`);
+    log2(`    ${c2.dim("2.")} Create an agent email account`);
+    log2(`    ${c2.dim("3.")} Set up phone number access (Google Voice)`);
+    log2(`    ${c2.dim("4.")} Register + configure the OpenClaw plugin`);
+    log2(`    ${c2.dim("5.")} Restart the OpenClaw gateway so the plugin loads`);
+    log2(`    ${c2.dim("6.")} Verify the agent's mailbox`);
+    log2("");
+    log2(`  ${c2.bold("Flags:")}`);
+    log2(`    ${c2.green("-h, --help")}    Show this help and exit`);
+    log2("");
+    log2(`  Run ${c2.green("agenticmail --help")} for the full command list.`);
+    log2("");
+    return;
+  }
   log2("");
   log2(`  ${c2.pinkBg(" \u{1F380} AgenticMail for OpenClaw ")}`);
   log2("");
@@ -6276,6 +6299,18 @@ function printPluginSnippet(apiUrl, masterKey, agentApiKey) {
   log2(`  ${c2.dim("  }")}`);
   log2(`  ${c2.dim("}")}`);
 }
+async function isTunnelConfigured() {
+  const configPath = join(homedir(), ".agenticmail", "config.json");
+  if (!existsSync2(configPath)) return false;
+  try {
+    const config = JSON.parse(readFileSync2(configPath, "utf-8"));
+    if (config.gateway?.mode !== "domain") return false;
+    if (!config.gateway?.domain?.tunnelId && !config.gateway?.domain?.domain) return false;
+    return true;
+  } catch {
+    return false;
+  }
+}
 async function cmdStatus() {
   log2("");
   log2(`  ${c2.pinkBg(" \u{1F380} AgenticMail Status ")}`);
@@ -6284,11 +6319,23 @@ async function cmdStatus() {
   const FRIENDLY_NAMES = {
     docker: "Container Engine",
     stalwart: "Mail Server",
-    cloudflared: "Secure Tunnel"
+    // Issue #21 — `cloudflared` was previously labelled "Secure
+    // Tunnel" and shown as ✅ whenever the binary was present.
+    // The binary is downloaded as part of every setup (even
+    // localhost-only evals), so the green tick implied an active
+    // tunnel that didn't exist. Renamed to make clear we're only
+    // reporting the CLI binary's presence; the actual tunnel
+    // status is surfaced under "Email" below where the gateway
+    // mode is read.
+    cloudflared: "Cloudflared CLI"
   };
   const deps = await setup.checkDependencies();
   log2(`  ${c2.bold("Services:")}`);
   for (const dep of deps) {
+    if (dep.name === "cloudflared") {
+      const tunnelConfigured = await isTunnelConfigured();
+      if (!tunnelConfigured) continue;
+    }
     const friendly = FRIENDLY_NAMES[dep.name] ?? dep.name;
     if (dep.installed) {
       const ver = dep.version && /^\d/.test(dep.version) ? `v${dep.version}` : dep.version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/cli",
-  "version": "0.5.57",
+  "version": "0.5.58",
   "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",
@@ -28,7 +28,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@agenticmail/api": "^0.5.56",
+    "@agenticmail/api": "^0.5.58",
     "@agenticmail/core": "^0.5.0",
     "json5": "^2.2.3"
   },