@getdial/cli 0.27.0 → 0.28.0

package/dist/cli.js

@@ -152,10 +152,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 +168,7 @@ const message = program
         body: opts.body,
         fromNumberId: opts.fromNumberId,
         media: opts.media,
+        forceAudioFile: !!opts.forceAudioFile,
         json: !!opts.json,
     }));
 });

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);

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.28.0",
   "description": "Dial CLI — install, sign up, and run the local listen service.",
   "license": "MIT",
   "repository": {