@getdial/cli 0.38.0 → 0.39.0

package/dist/cli.js

@@ -201,6 +201,8 @@ number
     .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")
+    .option("--whatsapp-name <text>", "WhatsApp display name shown to recipients (WhatsApp-ready numbers only): 1-25 chars, no reserved marks. The call blocks until WhatsApp applies it")
+    .option("--whatsapp-avatar <path-or-url>", "WhatsApp avatar photo (WhatsApp-ready numbers only): a local image file or public URL. Square jpeg/png between 192x192 and 640x640 (not resized)")
     .option("--json", "machine-readable output")
     .action(async (numberArg, opts) => {
     let maxCallDurationSeconds;
@@ -220,6 +222,8 @@ number
         firstName: opts.firstName,
         lastName: opts.lastName,
         avatar: opts.avatar,
+        whatsappName: opts.whatsappName,
+        whatsappAvatar: opts.whatsappAvatar,
         json: !!opts.json,
     }));
 });

package/dist/commands/number/set.js

@@ -17,6 +17,8 @@ export async function runNumberSet(opts) {
             ...(opts.firstName !== undefined ? { firstName: opts.firstName } : {}),
             ...(opts.lastName !== undefined ? { lastName: opts.lastName } : {}),
             ...(opts.avatar !== undefined ? { avatar: opts.avatar } : {}),
+            ...(opts.whatsappName !== undefined ? { whatsappName: opts.whatsappName } : {}),
+            ...(opts.whatsappAvatar !== undefined ? { whatsappAvatar: opts.whatsappAvatar } : {}),
         });
         if (opts.json) {
             console.log(JSON.stringify({ ok: true, number: n }));
@@ -34,6 +36,10 @@ export async function runNumberSet(opts) {
                 console.log(`  display name:          ${[n.firstName, n.lastName].filter(Boolean).join(" ")}`);
                 console.log(`  avatar:                ${n.avatarUrl ?? ""}`);
             }
+            if (n.whatsappName != null || n.whatsappAvatarUrl != null) {
+                console.log(`  whatsapp name:         ${n.whatsappName ?? ""}`);
+                console.log(`  whatsapp avatar:       ${n.whatsappAvatarUrl ?? ""}`);
+            }
         }
         return 0;
     }

package/dist/lib/ops/numbers.js

@@ -117,14 +117,21 @@ export async function setNumberProperties(opts) {
         body.firstName = opts.firstName;
     if (opts.lastName !== undefined)
         body.lastName = opts.lastName;
+    if (opts.whatsappName !== undefined)
+        body.whatsappName = opts.whatsappName;
     // A URL avatar goes in the JSON body; a local file forces multipart (below).
     // Read + validate the file up front, before any API round-trip, so a bad
     // path or unsupported type fails fast.
     const avatarFile = opts.avatar !== undefined && !isHttpUrl(opts.avatar) ? readAvatarFile(opts.avatar) : null;
     if (opts.avatar !== undefined && !avatarFile)
         body.avatarUrl = opts.avatar;
-    if (Object.keys(body).length === 0 && !avatarFile) {
-        throw new DialError("bad_request", "Provide at least one property to update (inboundInstruction, inboundVoiceGender, inboundLanguage, nickname, maxCallDurationSeconds, firstName, lastName, or avatar).");
+    const whatsappAvatarFile = opts.whatsappAvatar !== undefined && !isHttpUrl(opts.whatsappAvatar)
+        ? readAvatarFile(opts.whatsappAvatar)
+        : null;
+    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, 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,
@@ -141,11 +148,18 @@ export async function setNumberProperties(opts) {
     // A local avatar file forces a multipart PATCH: every scalar field goes in as a
     // text part alongside the uploaded `avatar` file. Otherwise a plain JSON PATCH.
     let res;
-    if (avatarFile) {
+    if (avatarFile || whatsappAvatarFile) {
         const form = new ApiFormData();
         for (const [field, value] of Object.entries(body))
             form.set(field, String(value));
-        form.append("avatar", new Blob([new Uint8Array(avatarFile.data)], { type: avatarFile.contentType }), avatarFile.name);
+        if (avatarFile) {
+            form.append("avatar", new Blob([new Uint8Array(avatarFile.data)], { type: avatarFile.contentType }), avatarFile.name);
+        }
+        if (whatsappAvatarFile) {
+            form.append("whatsappAvatar", new Blob([new Uint8Array(whatsappAvatarFile.data)], {
+                type: whatsappAvatarFile.contentType,
+            }), whatsappAvatarFile.name);
+        }
         res = await apiPatchMultipart(path, form, auth?.apiKey);
     }
     else {

package/dist/mcp/schemas.js

@@ -53,6 +53,16 @@ export const phoneNumberSchema = z
         .nullable()
         .optional()
         .describe("URL of the number's iMessage avatar photo; null when unset or not an iMessage number"),
+    whatsappName: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("WhatsApp display name; null on numbers without a WhatsApp track"),
+    whatsappAvatarUrl: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("URL of the number's WhatsApp avatar; null when unset"),
 })
     .passthrough();
 /**

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

@@ -44,12 +44,21 @@ const inputSchema = {
         .url()
         .optional()
         .describe("Public image URL to set as the number's iMessage avatar photo (the server downloads it). jpeg/png/gif/webp, max 5 MB. iMessage numbers only. The photo can be replaced but not removed."),
+    whatsappName: z
+        .string()
+        .optional()
+        .describe("WhatsApp display name shown to recipients. 1-25 chars, no reserved verification marks. WhatsApp-ready numbers only; the call blocks until WhatsApp applies it."),
+    whatsappAvatarUrl: z
+        .string()
+        .url()
+        .optional()
+        .describe("Public image URL to set as the number's WhatsApp avatar (the server downloads it). Square jpeg or png between 192x192 and 640x640 (not resized). WhatsApp-ready numbers only."),
 };
 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, and — for iMessage numbers — its display identity (firstName, lastName, avatarUrl shown beside its messages). 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, and — for iMessage numbers — its display identity (firstName, lastName, avatarUrl), and for WhatsApp-ready numbers its WhatsApp identity (whatsappName, whatsappAvatarUrl). Provide at least one.",
         inputSchema,
         outputSchema: { number: phoneNumberSchema },
         annotations: { openWorldHint: true },
@@ -69,6 +78,10 @@ export const setNumberPropertiesTool = {
                 ? { maxCallDurationSeconds: args.maxCallDurationSeconds }
                 : {}),
             ...(args.firstName !== undefined ? { firstName: args.firstName } : {}),
+            ...(args.whatsappName !== undefined ? { whatsappName: args.whatsappName } : {}),
+            ...(args.whatsappAvatarUrl !== undefined
+                ? { whatsappAvatar: args.whatsappAvatarUrl }
+                : {}),
             ...(args.lastName !== undefined ? { lastName: args.lastName } : {}),
             ...(args.avatarUrl !== undefined ? { avatar: args.avatarUrl } : {}),
         }),

package/package.json

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