carlyemail 0.1.0 → 0.2.0

package/README.md

@@ -36,6 +36,15 @@ npm install -g carlyemail
 | `delete <inbox> --yes` | Delete an inbox and its mail |
 | `send --from <i> --to <a> --subject <s> --text <t>` | Send an email |
 | `messages <inbox>` | List messages |
+| `read <inbox> <id>` | Read one message in full |
+| `search <inbox> <text>` | Search messages |
+| `threads <inbox>` | List conversations |
+| `reply <inbox> <id> --text <t>` | Reply to the sender (`--all` to copy everyone) |
+| `drafts <inbox>` | List drafts |
+| `draft <inbox> --to <a> --text <t>` | Write a draft without sending |
+| `send-draft <inbox> <id>` | Send a draft written earlier |
+| `webhooks` | List webhook endpoints |
+| `domains` | List custom domains, with their DNS records |
 | `plan` | Current plan, with usage against every limit |
 | `upgrade <plan>` | A Stripe checkout link |
 | `billing` | Invoices, card changes, cancellation |

package/carlyemail.js

@@ -17,7 +17,7 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 
-export const VERSION = "0.1.0";
+export const VERSION = "0.2.0";
 
 const DEFAULT_API = "https://api.carlyemail.com";
 const CONFIG_DIR = join(homedir(), ".carlyemail");
@@ -341,6 +341,181 @@ define("messages", "List messages in an inbox", "carlyemail messages me@carlyema
   });
 });
 
+define("read", "Read one message in full", "carlyemail read me@carlyemail.com '<id@host>'", async (ctx) => {
+  const [inbox, id] = ctx.positional;
+  if (!inbox || !id) throw new UsageError("carlyemail read <inbox> <message-id>");
+  const m = await request(
+    ctx.config,
+    "GET",
+    `/v0/inboxes/${encodeURIComponent(inbox)}/messages/${encodeURIComponent(id)}`
+  );
+  emit(ctx, m, () => {
+    ctx.print(`${dim("from")}     ${m.from ?? "?"}`);
+    ctx.print(`${dim("to")}       ${(m.to || []).join(", ")}`);
+    ctx.print(`${dim("date")}     ${(m.timestamp || "").replace("T", " ").slice(0, 19)}`);
+    ctx.print(`${dim("subject")}  ${bold(m.subject || "(no subject)")}`);
+    if (m.labels?.length) ctx.print(`${dim("labels")}   ${m.labels.join(", ")}`);
+    if (m.attachments?.length) {
+      ctx.print(`${dim("files")}    ${m.attachments.map((a) => a.filename ?? a.attachment_id).join(", ")}`);
+    }
+    ctx.print("");
+    // `text` is the body as sent; `extracted_text` has the quoted reply chain
+    // stripped. Print the full one — a person reading a single message asked
+    // for the message, not our opinion of the interesting part of it.
+    ctx.print(m.text || m.preview || dim("(no text body)"));
+  });
+});
+
+define("search", "Search messages in an inbox", 'carlyemail search me@carlyemail.com "invoice"', async (ctx) => {
+  const [inbox, ...terms] = ctx.positional;
+  const query = terms.join(" ") || ctx.flags.query;
+  if (!inbox || !query) throw new UsageError('carlyemail search <inbox> "what to look for"');
+  const out = await request(
+    ctx.config,
+    "GET",
+    // `q`, not `query` — the parameter name comes from the OpenAPI spec, and
+    // guessing it produced a 422 that looked like a CLI bug.
+    `/v0/inboxes/${encodeURIComponent(inbox)}/messages/search?q=${encodeURIComponent(query)}`
+  );
+  emit(ctx, out, () => {
+    if (!out.messages?.length) {
+      ctx.print(dim(`nothing matching ${JSON.stringify(query)}`));
+      return;
+    }
+    for (const m of out.messages) {
+      ctx.print(`${dim((m.timestamp || "").slice(0, 10))}  ${bold(m.subject || "(no subject)")}`);
+      ctx.print(`${" ".repeat(12)}${dim(m.message_id ?? "")}`);
+    }
+  });
+});
+
+define("threads", "List conversations in an inbox", "carlyemail threads me@carlyemail.com", async (ctx) => {
+  const inbox = ctx.positional[0];
+  if (!inbox) throw new UsageError("carlyemail threads <inbox>");
+  const out = await request(ctx.config, "GET", `/v0/inboxes/${encodeURIComponent(inbox)}/threads`);
+  emit(ctx, out, () => {
+    if (!out.threads?.length) {
+      ctx.print(dim("no conversations"));
+      return;
+    }
+    for (const t of out.threads) {
+      const count = t.message_count ? dim(` (${t.message_count})`) : "";
+      ctx.print(`${bold(t.subject || "(no subject)")}${count}`);
+      ctx.print(`  ${dim(t.thread_id)}  ${dim((t.senders || []).join(", "))}`);
+    }
+  });
+});
+
+define("reply", "Reply to a message", 'carlyemail reply me@x.com "<id@host>" --text "On it"', async (ctx) => {
+  const [inbox, id] = ctx.positional;
+  if (!inbox || !id) throw new UsageError("carlyemail reply <inbox> <message-id> --text ...");
+  const body = {
+    text: typeof ctx.flags.text === "string" ? ctx.flags.text : undefined,
+    html: typeof ctx.flags.html === "string" ? ctx.flags.html : undefined,
+  };
+  if (body.text === undefined && body.html === undefined) {
+    throw new UsageError("--text or --html is required");
+  }
+  // reply-all is opt-in. Quietly copying everyone on the original thread is
+  // the kind of default that sends an agent's message to people the caller
+  // never saw.
+  const route = ctx.flags["all"] ? "reply-all" : "reply";
+  const sent = await request(
+    ctx.config,
+    "POST",
+    `/v0/inboxes/${encodeURIComponent(inbox)}/messages/${encodeURIComponent(id)}/${route}`,
+    { body }
+  );
+  emit(ctx, sent, () => ctx.print(ok(`replied  ${dim(sent.message_id ?? "")}`)));
+});
+
+define("drafts", "List drafts in an inbox", "carlyemail drafts me@carlyemail.com", async (ctx) => {
+  const inbox = ctx.positional[0];
+  if (!inbox) throw new UsageError("carlyemail drafts <inbox>");
+  const out = await request(ctx.config, "GET", `/v0/inboxes/${encodeURIComponent(inbox)}/drafts`);
+  emit(ctx, out, () => {
+    if (!out.drafts?.length) {
+      ctx.print(dim("no drafts"));
+      return;
+    }
+    for (const d of out.drafts) {
+      ctx.print(`${bold(d.subject || "(no subject)")}  ${dim(`to ${(d.to || []).join(", ")}`)}`);
+      ctx.print(`  ${dim(d.draft_id)}`);
+    }
+  });
+});
+
+define(
+  "draft",
+  "Write a draft without sending it",
+  'carlyemail draft me@x.com --to you@y.com --subject Hi --text "..."',
+  async (ctx) => {
+    const inbox = ctx.positional[0];
+    if (!inbox) throw new UsageError("carlyemail draft <inbox> --to ... --text ...");
+    const body = {
+      to: required(ctx.flags, "to").split(",").map((s) => s.trim()),
+      subject: typeof ctx.flags.subject === "string" ? ctx.flags.subject : undefined,
+      text: typeof ctx.flags.text === "string" ? ctx.flags.text : undefined,
+    };
+    const d = await request(
+      ctx.config,
+      "POST",
+      `/v0/inboxes/${encodeURIComponent(inbox)}/drafts`,
+      { body }
+    );
+    emit(ctx, d, () => {
+      ctx.print(ok(`draft ${d.draft_id}`));
+      ctx.print(arrow(`send it with:  carlyemail send-draft ${inbox} ${d.draft_id}`));
+    });
+  }
+);
+
+define("send-draft", "Send a draft that was written earlier", "carlyemail send-draft me@x.com dft_123", async (ctx) => {
+  const [inbox, id] = ctx.positional;
+  if (!inbox || !id) throw new UsageError("carlyemail send-draft <inbox> <draft-id>");
+  const sent = await request(
+    ctx.config,
+    "POST",
+    `/v0/inboxes/${encodeURIComponent(inbox)}/drafts/${encodeURIComponent(id)}/send`
+  );
+  emit(ctx, sent, () => ctx.print(ok(`sent  ${dim(sent.message_id ?? "")}`)));
+});
+
+define("webhooks", "List webhook endpoints", "carlyemail webhooks", async (ctx) => {
+  const out = await request(ctx.config, "GET", "/v0/webhooks");
+  emit(ctx, out, () => {
+    if (!out.webhooks?.length) {
+      ctx.print(dim("no webhooks"));
+      return;
+    }
+    for (const w of out.webhooks) {
+      ctx.print(`${w.enabled === false ? dim("(disabled) ") : ""}${bold(w.url)}`);
+      ctx.print(`  ${dim(w.webhook_id)}  ${dim((w.event_types || []).join(", "))}`);
+    }
+  });
+});
+
+define("domains", "List custom sending domains", "carlyemail domains", async (ctx) => {
+  const out = await request(ctx.config, "GET", "/v0/domains");
+  emit(ctx, out, () => {
+    if (!out.domains?.length) {
+      ctx.print(dim("no custom domains — mail sends from carlyemail.com"));
+      return;
+    }
+    for (const d of out.domains) {
+      const mark = d.status === "VERIFIED" ? paint(32, "✓") : dim("…");
+      ctx.print(`${mark} ${bold(d.domain)}  ${dim(d.status)}`);
+      // Unverified domains are the common case people get stuck on, and the
+      // records are the whole answer, so print them rather than a doc link.
+      if (d.status !== "VERIFIED") {
+        for (const r of d.records || []) {
+          ctx.print(`    ${dim(r.type)}  ${r.name}  ${dim("→")}  ${r.value}`);
+        }
+      }
+    }
+  });
+});
+
 define("plan", "Show the current plan and its limits", "carlyemail plan", async (ctx) => {
   const [billing, org] = await Promise.all([
     request(ctx.config, "GET", "/v0/billing"),

package/package.json

@@ -1,8 +1,16 @@
 {
   "name": "carlyemail",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Real email inboxes your agent can send, receive and reply from.",
-  "keywords": ["email", "agent", "ai", "inbox", "smtp", "mcp", "cli"],
+  "keywords": [
+    "email",
+    "agent",
+    "ai",
+    "inbox",
+    "smtp",
+    "mcp",
+    "cli"
+  ],
   "homepage": "https://carlyemail.com",
   "bugs": "https://docs.carlyemail.com/support",
   "repository": {
@@ -17,7 +25,11 @@
     "carlyemail": "./carlyemail.js"
   },
   "exports": "./carlyemail.js",
-  "files": ["carlyemail.js", "README.md", "LICENSE"],
+  "files": [
+    "carlyemail.js",
+    "README.md",
+    "LICENSE"
+  ],
   "engines": {
     "node": ">=18"
   },