@getdial/cli 0.27.0 → 0.29.0

package/README.md

@@ -54,6 +54,7 @@ dial wait-for message.received --field to=+14155550123
 | `dial number set <number>` | Update a number's inbound instruction. |
 | `dial message` | Send an SMS. |
 | `dial message list` | List recent messages. |
+| `dial message reply` | Reply or react to a message. |
 | `dial call` | Place an outbound AI voice call. |
 | `dial call list` | List recent calls. |
 | `dial call get <id>` | Fetch a single call — status, duration, transcript. |

package/dist/cli.js

@@ -14,6 +14,7 @@ import { runNumberList } from "./commands/number/list.js";
 import { runNumberPurchase } from "./commands/number/purchase.js";
 import { runNumberSet } from "./commands/number/set.js";
 import { runMessageSend } from "./commands/message/send.js";
+import { runMessageReply } from "./commands/message/reply.js";
 import { runMessageList } from "./commands/message/list.js";
 import { runCallSend } from "./commands/call/send.js";
 import { runCallList } from "./commands/call/list.js";
@@ -152,10 +153,15 @@ const message = program
     .option("--body <text>", "message body")
     .option("--from-number-id <id>", "phoneNumberId to send from (defaults to onboard's number)")
     .option("--media <path-or-url>", "media attachment: local file path (uploaded) or public http(s) URL (repeatable, max 10)", (v, prev = []) => [...prev, v], [])
+    .option("--force-audio-file", "send an audio attachment as a regular file attachment instead of an iMessage voice message")
     .option("--json", "machine-readable output")
     .action(async (opts) => {
-    if (!opts.to || !opts.body) {
-        console.error("error: --to and --body are required to send a message. Use `dial message list` to list, or `dial message --help` for usage.");
+    if (!opts.to) {
+        console.error("error: --to is required to send a message. Use `dial message list` to list, or `dial message --help` for usage.");
+        process.exit(2);
+    }
+    if (!opts.body && (opts.media ?? []).length === 0) {
+        console.error("error: provide --body, --media, or both — a message needs text or an attachment.");
         process.exit(2);
     }
     process.exit(await runMessageSend({
@@ -163,6 +169,25 @@ const message = program
         body: opts.body,
         fromNumberId: opts.fromNumberId,
         media: opts.media,
+        forceAudioFile: !!opts.forceAudioFile,
+        json: !!opts.json,
+    }));
+});
+message
+    .command("reply <messageId>")
+    .description("Reply or react to a message. POST /api/v1/messages/:id/reply.")
+    .option("--body <text>", "reply text (threads under the target on iMessage numbers)")
+    .option("--react <reaction>", "reaction: love|like|dislike|laugh|emphasize|question, or a single emoji")
+    .option("--json", "machine-readable output")
+    .action(async (messageId, opts) => {
+    if ((opts.body === undefined) === (opts.react === undefined)) {
+        console.error("error: provide exactly one of --body or --react. Use `dial message reply --help` for usage.");
+        process.exit(2);
+    }
+    process.exit(await runMessageReply({
+        messageId,
+        body: opts.body,
+        react: opts.react,
         json: !!opts.json,
     }));
 });

package/dist/commands/message/reply.js

@@ -0,0 +1,29 @@
+import { replyToMessage } from "../../lib/ops/messages.js";
+import { isDialError } from "../../lib/ops/errors.js";
+import { printDialError } from "../../lib/cli-error.js";
+export async function runMessageReply(opts) {
+    try {
+        const m = await replyToMessage({ messageId: opts.messageId, body: opts.body, reaction: opts.react });
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: true, message: m }));
+        }
+        else {
+            console.log(`sent.`);
+            console.log(`  channel:  ${m.channel}`);
+            console.log(`  from:     ${m.from}`);
+            console.log(`  to:       ${m.to}`);
+            console.log(`  body:     ${m.body}`);
+            if (m.reaction)
+                console.log(`  reaction: ${m.reaction}`);
+            if (m.replyToId)
+                console.log(`  replyTo:  ${m.replyToId}`);
+            console.log(`  status:   ${m.status}`);
+        }
+        return 0;
+    }
+    catch (e) {
+        if (isDialError(e))
+            return printDialError(opts.json, e);
+        throw e;
+    }
+}

package/dist/commands/message/send.js

@@ -3,7 +3,13 @@ import { isDialError } from "../../lib/ops/errors.js";
 import { printDialError } from "../../lib/cli-error.js";
 export async function runMessageSend(opts) {
     try {
-        const m = await sendMessage({ to: opts.to, body: opts.body, fromNumberId: opts.fromNumberId, media: opts.media });
+        const m = await sendMessage({
+            to: opts.to,
+            body: opts.body,
+            fromNumberId: opts.fromNumberId,
+            media: opts.media,
+            forceAudioFile: opts.forceAudioFile,
+        });
         if (opts.json) {
             console.log(JSON.stringify({ ok: true, message: m }));
         }

package/dist/lib/ops/messages.js

@@ -58,13 +58,22 @@ export async function sendMessage(opts) {
     const hasFiles = media.some((m) => !isHttpUrl(m));
     let res;
     if (!hasFiles) {
-        res = await apiPost("/api/v1/messages", { to: opts.to, body: opts.body, fromNumberId, ...(media.length ? { mediaUrls: media } : {}) }, auth.apiKey);
+        res = await apiPost("/api/v1/messages", {
+            to: opts.to,
+            ...(opts.body ? { body: opts.body } : {}),
+            fromNumberId,
+            ...(media.length ? { mediaUrls: media } : {}),
+            ...(opts.forceAudioFile ? { forceAudioFile: true } : {}),
+        }, auth.apiKey);
     }
     else {
         const form = new ApiFormData();
         form.set("to", opts.to);
-        form.set("body", opts.body);
+        if (opts.body)
+            form.set("body", opts.body);
         form.set("fromNumberId", fromNumberId);
+        if (opts.forceAudioFile)
+            form.set("forceAudioFile", "true");
         for (const item of media) {
             if (isHttpUrl(item)) {
                 form.append("mediaUrls", item);
@@ -95,3 +104,17 @@ export async function listMessages(opts) {
         throw new DialError("list_failed", res.error, res.status);
     return res.data.messages ?? [];
 }
+export async function replyToMessage(opts) {
+    const auth = requireAuth();
+    // No `to`/`fromNumberId`: the server derives both from the target message —
+    // the reply stays in the conversation the target is part of.
+    const payload = {};
+    if (opts.body !== undefined)
+        payload.body = opts.body;
+    if (opts.reaction !== undefined)
+        payload.reaction = opts.reaction;
+    const res = await apiPost(`/api/v1/messages/${encodeURIComponent(opts.messageId)}/reply`, payload, auth.apiKey);
+    if (!res.ok)
+        throw new DialError("reply_failed", res.error, res.status);
+    return res.data.message;
+}

package/dist/mcp/schemas.js

@@ -38,6 +38,8 @@ export const messageSchema = z
     direction: z.string().optional(),
     status: statusSchema,
     statusError: z.string().nullish().describe("Failure reason when status is undelivered/failed"),
+    replyToId: z.string().nullish().describe("Id of the message this one replies or reacts to; null for ordinary messages"),
+    reaction: z.string().nullish().describe("The reaction this message carries (a reaction name or an emoji); null otherwise"),
     createdAt: z.string().optional(),
 })
     .passthrough();

package/dist/mcp/tools/index.js

@@ -2,6 +2,7 @@ import { listNumbersTool } from "./list-numbers.js";
 import { purchaseNumberTool } from "./purchase-number.js";
 import { setNumberPropertiesTool } from "./set-number-properties.js";
 import { sendMessageTool } from "./send-message.js";
+import { replyToMessageTool } from "./reply-to-message.js";
 import { listMessagesTool } from "./list-messages.js";
 import { placeCallTool } from "./place-call.js";
 import { listCallsTool } from "./list-calls.js";
@@ -23,6 +24,7 @@ export const tools = [
     purchaseNumberTool,
     setNumberPropertiesTool,
     sendMessageTool,
+    replyToMessageTool,
     listMessagesTool,
     placeCallTool,
     listCallsTool,

package/dist/mcp/tools/reply-to-message.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { jsonResult } from "../result.js";
+import { replyToMessage } from "../../lib/ops/messages.js";
+import { messageSchema } from "../schemas.js";
+const inputSchema = {
+    messageId: z
+        .string()
+        .describe("Id of the message to reply or react to (from list_messages or a message.received event)"),
+    body: z.string().optional().describe("Reply text; on an iMessage number it threads under the target message"),
+    reaction: z
+        .string()
+        .optional()
+        .describe("Reaction to send instead of a body: love, like, dislike, laugh, emphasize, question, or a single emoji"),
+};
+export const replyToMessageTool = {
+    name: "reply_to_message",
+    config: {
+        title: "Reply to a message",
+        description: "Reply in-thread or react to an existing message. The reply goes out from the Dial number the target message belongs to, to the other party — no from/to needed. Provide exactly one of body or reaction. On iMessage numbers replies thread and reactions are native; recipients that can only receive SMS get an emoji reaction as a regular text, and named reactions are rejected.",
+        inputSchema,
+        outputSchema: { message: messageSchema },
+        annotations: { openWorldHint: true },
+    },
+    run: async (args) => jsonResult({
+        message: await replyToMessage({
+            messageId: args.messageId,
+            body: args.body,
+            reaction: args.reaction,
+        }),
+    }),
+};

package/dist/mcp/tools/send-message.js

@@ -1,17 +1,26 @@
 import { z } from "zod";
 import { jsonResult } from "../result.js";
-import { sendMessage } from "../../lib/ops/messages.js";
+import { sendMessage, MAX_MEDIA_ITEMS } from "../../lib/ops/messages.js";
 import { messageSchema } from "../schemas.js";
 const inputSchema = {
     to: z.string().min(7).describe("Destination phone number, E.164 (e.g. +14155550123)"),
-    body: z.string().min(1).describe("Message body"),
+    body: z.string().optional().describe("Message body; optional when mediaUrls is given (media-only send)"),
     fromNumberId: z.string().optional().describe("Number id to send from; defaults to your primary number"),
+    mediaUrls: z
+        .array(z.string().url())
+        .max(MAX_MEDIA_ITEMS)
+        .optional()
+        .describe("Publicly reachable http(s) URLs of media to attach (MMS); Dial mirrors and re-hosts them"),
+    forceAudioFile: z
+        .boolean()
+        .optional()
+        .describe("Send an audio attachment as a regular file attachment instead of an iMessage voice message. No effect on standard numbers or non-audio media."),
 };
 export const sendMessageTool = {
     name: "send_message",
     config: {
-        title: "Send SMS",
-        description: "Send an SMS from one of your Dial numbers.",
+        title: "Send message",
+        description: "Send a message from one of your Dial numbers, optionally with media attachments (MMS). On an iMessage number, a single audio attachment is delivered as a voice message unless forceAudioFile is true.",
         inputSchema,
         outputSchema: { message: messageSchema },
         annotations: { openWorldHint: true },
@@ -21,6 +30,8 @@ export const sendMessageTool = {
             to: args.to,
             body: args.body,
             fromNumberId: args.fromNumberId,
+            media: args.mediaUrls,
+            forceAudioFile: args.forceAudioFile,
         }),
     }),
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getdial/cli",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "description": "Dial CLI — install, sign up, and run the local listen service.",
   "license": "MIT",
   "repository": {