@mailkite/cli 0.2.0 → 0.3.0

package/README.md

@@ -55,7 +55,7 @@ mailkite domains verify "$ID" --json | jq -e '.status=="verified"'
 | Group | Commands |
 | --- | --- |
 | Auth | `login`, `signup`, `logout`, `whoami` |
-| Send | `send` |
+| Send | `send`, `agent`, `route` |
 | Domains | `domains list\|add\|get\|verify\|rm`, `dns <id> [--provider]` |
 | Webhooks | `webhook set\|rm\|test\|show`, `secret get\|rotate`, `verify-webhook` |
 | Receiving | `messages list\|get\|tail`, `routes list\|create`, `deliveries retry` |

package/cli.mjs

@@ -217,6 +217,45 @@ commands.send = async ({ flags }) => {
   out(res, flags, (r) => console.log(green("✓ ") + `Sent — id ${bold(r.id)}, status ${r.status}`));
 };
 
+// Send a message straight to an inbox agent and print its reply. Defaults to the account's
+// default agent; --route-id / --address pick a specific one, --model overrides the model.
+commands.agent = async ({ _, flags }) => {
+  const mk = client(flags);
+  const text = await need(_[0] || flags.text, "text", "Message to the agent: ");
+  const message = { text };
+  if (flags.subject) message.subject = flags.subject;
+  if (flags.from) message.from = flags.from;
+  if (flags["route-id"]) message.routeId = flags["route-id"];
+  if (flags.address) message.address = flags.address;
+  if (flags.model) message.model = flags.model;
+  let res;
+  try { res = await mk.agent(message); }
+  catch (e) { return die(e instanceof MailKiteError ? `Agent failed (${e.status}): ${e.message}` : e.message); }
+  out(res, flags, (r) => { if (r.ok) console.log(r.text || dim("(no reply)")); else die(r.error || "agent run failed"); });
+};
+
+// Route a message to one of your registered routes (by id or address), running its action.
+commands.route = async ({ _, flags }) => {
+  const mk = client(flags);
+  const from = await need(flags.from, "from", "From: ");
+  const message = { from };
+  if (flags["route-id"]) message.routeId = flags["route-id"];
+  if (flags.address) message.address = flags.address;
+  if (!message.routeId && !message.address) {
+    const target = await need(_[0] || "", "route", "Route id (rte_…) or address it matches: ");
+    if (target.startsWith("rte_")) message.routeId = target; else message.address = target;
+  }
+  if (flags.subject) message.subject = flags.subject;
+  let text = flags.text;
+  if (flags.file) text = readFileSync(flags.file, "utf8");
+  if (text) message.text = text;
+  if (flags.html) message.html = flags.html;
+  let res;
+  try { res = await mk.route(message); }
+  catch (e) { return die(e instanceof MailKiteError ? `Route failed (${e.status}): ${e.message}` : e.message); }
+  out(res, flags, (r) => console.log(green("✓ ") + `Routed — id ${bold(r.id)}, action ${r.action}`));
+};
+
 commands.domains = async ({ _, flags }) => {
   const sub = _[0] || "list";
   const mk = client(flags);
@@ -512,6 +551,10 @@ ${bold("AUTH")}
 ${bold("SEND")}
   send             Send a message  (--from --to --subject [--html|--text|--file] [--cc --bcc --reply-to --in-reply-to])
 
+${bold("AGENTS")}
+  agent <text>     Message an inbox agent and print its reply  ([--route-id|--address] [--model --subject --from])
+  route            Route a message to a registered route  (--route-id <id>|--address <addr> --from [--subject --text|--file --html])
+
 ${bold("DOMAINS & DNS")}
   domains list                 List your domains
   domains add <domain>         Add a domain you own; prints the DNS records to set

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mailkite/cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "MailKite command-line client — sign in, add domains, set DNS + webhooks, send mail, and tail inbound messages from your terminal. Built on the MailKite Node SDK.",
   "type": "module",
   "bin": {
@@ -30,11 +30,11 @@
   "homepage": "https://mailkite.dev/docs/cli",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/fijiwebdesign/mailkite.git",
+    "url": "git+https://github.com/mailkite/mailkite.git",
     "directory": "sdks/cli"
   },
   "license": "MIT",
   "dependencies": {
-    "mailkite": "^0.2.0"
+    "mailkite": "^0.3.0"
   }
 }