@getdial/cli 0.40.0 → 0.41.0

package/dist/cli.js

@@ -216,6 +216,8 @@ number
     return n;
 })
     .option("--clear-max-call-duration", "remove the per-number call duration cap")
+    .option("--channel <imessage|whatsapp|both>", 'which display profile(s) --name and --avatar are written to; "both" sets one identity on every channel the number has, in a single call. Cannot be combined with --first-name/--last-name/--whatsapp-name/--whatsapp-avatar')
+    .option("--name <text>", 'display name for --channel (required alongside it); WhatsApp stores it verbatim (1-25 chars), iMessage splits it on the first space ("Maya Chen" -> Maya / Chen)')
     .option("--first-name <text>", 'iMessage display first name shown beside this number\'s messages (iMessage numbers only); pass "" to clear')
     .option("--last-name <text>", 'iMessage display last name (iMessage numbers only); pass "" to clear')
     .option("--avatar <path-or-url>", "iMessage avatar photo (iMessage numbers only): a local image file (jpeg/png/gif/webp, max 5 MB) to upload, or a public image URL to fetch. Replaces the current photo; photos can't be removed")
@@ -238,6 +240,8 @@ number
         inboundLanguage: opts.inboundLanguage,
         nickname: opts.nickname,
         maxCallDurationSeconds,
+        channel: opts.channel,
+        name: opts.name,
         firstName: opts.firstName,
         lastName: opts.lastName,
         avatar: opts.avatar,

package/dist/commands/number/set.js

@@ -14,6 +14,8 @@ export async function runNumberSet(opts) {
             ...(opts.maxCallDurationSeconds !== undefined
                 ? { maxCallDurationSeconds: opts.maxCallDurationSeconds }
                 : {}),
+            ...(opts.channel !== undefined ? { channel: opts.channel } : {}),
+            ...(opts.name !== undefined ? { name: opts.name } : {}),
             ...(opts.firstName !== undefined ? { firstName: opts.firstName } : {}),
             ...(opts.lastName !== undefined ? { lastName: opts.lastName } : {}),
             ...(opts.avatar !== undefined ? { avatar: opts.avatar } : {}),

package/dist/lib/ops/numbers.js

@@ -117,6 +117,10 @@ export async function setNumberProperties(opts) {
         body.nickname = opts.nickname;
     if (opts.maxCallDurationSeconds !== undefined)
         body.maxCallDurationSeconds = opts.maxCallDurationSeconds;
+    if (opts.channel !== undefined)
+        body.channel = opts.channel;
+    if (opts.name !== undefined)
+        body.name = opts.name;
     if (opts.firstName !== undefined)
         body.firstName = opts.firstName;
     if (opts.lastName !== undefined)
@@ -137,7 +141,7 @@ export async function setNumberProperties(opts) {
     if (opts.whatsappAvatar !== undefined && !whatsappAvatarFile)
         body.whatsappAvatarUrl = opts.whatsappAvatar;
     if (Object.keys(body).length === 0 && !avatarFile && !whatsappAvatarFile) {
-        throw new DialError("bad_request", "Provide at least one property to update (inboundInstruction, inboundVoiceGender, inboundLanguage, nickname, maxCallDurationSeconds, calling, firstName, lastName, avatar, whatsappName, or whatsappAvatar).");
+        throw new DialError("bad_request", "Provide at least one property to update (inboundInstruction, inboundVoiceGender, inboundLanguage, nickname, maxCallDurationSeconds, calling, channel with name/avatar, firstName, lastName, avatar, whatsappName, or whatsappAvatar).");
     }
     const auth = maybeAuth();
     // The REST API keys numbers by id; the CLI/tool takes the E.164 number for ergonomics,

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

@@ -38,7 +38,7 @@ const inputSchema = {
     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."),
+        .describe("Send a lone audio attachment as a regular file instead of a voice message — an iMessage voice message on iMessage numbers, a WhatsApp voice note on WhatsApp numbers. No effect on standard numbers or non-audio media."),
 };
 export const sendMessageTool = {
     name: "send_message",
@@ -47,7 +47,8 @@ export const sendMessageTool = {
         description: "Send a message from one of your Dial numbers — to a phone number, or into a group conversation — " +
             "optionally with media attachments (MMS). On an iMessage number, a single audio attachment is " +
             "delivered as a voice message unless forceAudioFile is true. " +
-            "Address it with exactly one of to or groupId. WhatsApp sends are text-only.",
+            "Address it with exactly one of to or groupId. A WhatsApp number sends text and a single " +
+            "attachment (a caption is allowed only with an image or video).",
         inputSchema,
         outputSchema: { message: messageSchema },
         annotations: { openWorldHint: true },

package/dist/mcp/tools/set-number-properties.js

@@ -29,6 +29,15 @@ const inputSchema = {
         .nullable()
         .optional()
         .describe("Call duration cap for this number, in seconds, applied as a hard ceiling to both inbound and outbound calls (the smallest of the per-number, account, and per-call caps wins). On a free account (no top-up or subscription yet) a value above 300 is rejected with 400. Pass null to clear the cap; omit to leave it unchanged."),
+    channel: z
+        .enum(["imessage", "whatsapp", "both"])
+        .optional()
+        .describe('Which display profile(s) `name` and `avatarUrl` are written to: "imessage", "whatsapp", or "both". Use this when the number should present the same identity everywhere — one call instead of two, validated against every targeted channel before any of them is written, so the profiles cannot drift apart. Cannot be combined with firstName/lastName/whatsappName/whatsappAvatarUrl.'),
+    name: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('The display name to set on the channel(s) `channel` names; requires `channel`. WhatsApp stores it verbatim (1-25 chars); iMessage has no single-name field, so it is split on the first space — "Ana Lee" becomes firstName "Ana", lastName "Lee".'),
     firstName: z
         .string()
         .max(30)
@@ -62,7 +71,7 @@ export const setNumberPropertiesTool = {
     name: "set_number_properties",
     config: {
         title: "Set Number Properties",
-        description: "Update a phone number's properties: its inbound instruction (the system prompt for inbound calls), inbound voice gender, inbound language, nickname, whether calling is switched on at all (callingEnabled), and — for iMessage numbers — its display identity (firstName, lastName, avatarUrl), and for WhatsApp-ready numbers its WhatsApp identity (whatsappName, whatsappAvatarUrl). Provide at least one.",
+        description: 'Update a phone number\'s properties: its inbound instruction (the system prompt for inbound calls), inbound voice gender, inbound language, nickname, whether calling is switched on at all (callingEnabled), and its display identity. For the display identity prefer `channel` ("imessage", "whatsapp", or "both") with `name`/`avatarUrl` — one call that keeps every channel\'s profile identical. The per-channel fields remain for when the profiles differ: firstName/lastName/avatarUrl for iMessage, whatsappName/whatsappAvatarUrl for WhatsApp-ready numbers. Provide at least one property, and don\'t mix `channel` with the per-channel fields.',
         inputSchema,
         outputSchema: { number: phoneNumberSchema },
         annotations: { openWorldHint: true },
@@ -81,6 +90,8 @@ export const setNumberPropertiesTool = {
             ...(args.maxCallDurationSeconds !== undefined
                 ? { maxCallDurationSeconds: args.maxCallDurationSeconds }
                 : {}),
+            ...(args.channel !== undefined ? { channel: args.channel } : {}),
+            ...(args.name !== undefined ? { name: args.name } : {}),
             ...(args.firstName !== undefined ? { firstName: args.firstName } : {}),
             ...(args.whatsappName !== undefined ? { whatsappName: args.whatsappName } : {}),
             ...(args.callingEnabled !== undefined

package/package.json

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