@getdial/cli 0.38.0 → 0.40.0

package/dist/cli.js

@@ -47,6 +47,22 @@ function parsePositiveInteger(value) {
     }
     return parsed;
 }
+/**
+ * `--calling <on|off>` → boolean.
+ *
+ * One flag taking an explicit value, rather than a `--calling`/`--no-calling`
+ * pair: it reads the same in a script and in a skill, and it cannot be confused
+ * with "leave unchanged" (which is what omitting the flag means). Anything other
+ * than the two spellings is an error, never quietly read as off.
+ */
+function parseCalling(value) {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "on")
+        return true;
+    if (normalized === "off")
+        return false;
+    throw new InvalidArgumentError(`must be "on" or "off", got: ${value}`);
+}
 program
     .name("dial")
     .description("Dial CLI — set up your account and run the listen service.")
@@ -166,6 +182,7 @@ number
     .option("--area-code <code>", "preferred US area code (only US numbers can be provisioned; ignored with --include-imessage)")
     .option("--include-imessage", "provision an iMessage number (pay-as-you-go only; provisioned asynchronously — poll `dial number list` until ready)")
     .option("--whatsapp", "also connect WhatsApp to the new line (beta, enabled per account). Requires --include-imessage: WhatsApp is a channel on an iMessage line")
+    .option("--calling <on|off>", 'whether calling is switched on for the new number (default: on). "off" provisions a messaging-only line with no window in which it answers a call', parseCalling)
     .option("--json", "machine-readable output")
     .action(async (opts) => process.exit(await runNumberPurchase({
     inboundInstruction: opts.inboundInstruction,
@@ -175,6 +192,7 @@ number
     areaCode: opts.areaCode,
     includeImessage: !!opts.includeImessage,
     whatsapp: !!opts.whatsapp,
+    callingEnabled: opts.calling,
     json: !!opts.json,
 })));
 number
@@ -201,6 +219,9 @@ 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("--calling <on|off>", "switch calling on or off for this number, both directions: off means inbound calls aren't connected and none can be placed from it (messaging is unaffected)", parseCalling)
     .option("--json", "machine-readable output")
     .action(async (numberArg, opts) => {
     let maxCallDurationSeconds;
@@ -220,6 +241,9 @@ number
         firstName: opts.firstName,
         lastName: opts.lastName,
         avatar: opts.avatar,
+        whatsappName: opts.whatsappName,
+        whatsappAvatar: opts.whatsappAvatar,
+        callingEnabled: opts.calling,
         json: !!opts.json,
     }));
 });

package/dist/commands/number/list.js

@@ -15,7 +15,11 @@ export async function runNumberList(opts) {
         for (const n of numbers) {
             const tag = n.id === defaultNumberId ? "  (default)" : "";
             const nickname = n.nickname ? `  "${n.nickname}"` : "";
-            console.log(`${n.number}  id=${n.id}  ${n.country}${nickname}${tag}`);
+            // Marked only when off. `--json` carries callingEnabled either way, but
+            // this line is hand-built, so without this the switch would be invisible
+            // in the CLI's default output.
+            const calling = n.callingEnabled === false ? "  calling:off" : "";
+            console.log(`${n.number}  id=${n.id}  ${n.country}${nickname}${calling}${tag}`);
         }
         return 0;
     }

package/dist/commands/number/purchase.js

@@ -17,6 +17,7 @@ export async function runNumberPurchase(opts) {
             inboundLanguage: opts.inboundLanguage,
             areaCode: opts.areaCode,
             includeImessage: opts.includeImessage,
+            callingEnabled: opts.callingEnabled,
             whatsapp: opts.whatsapp,
         });
         if (opts.json) {
@@ -27,6 +28,10 @@ export async function runNumberPurchase(opts) {
             console.log(`  number:   ${n.number}`);
             console.log(`  id:       ${n.id}`);
             console.log(`  country:  ${n.country}`);
+            // Only worth a line when it isn't the default — a messaging-only line is
+            // a surprising thing to discover later.
+            if (n.callingEnabled === false)
+                console.log(`  calling:  off (messaging only)`);
             // iMessage numbers provision asynchronously: the number is returned right
             // away in setupStatus "provisioning". Tell the user to poll before using it.
             if (opts.includeImessage) {

package/dist/commands/number/set.js

@@ -17,6 +17,9 @@ export async function runNumberSet(opts) {
             ...(opts.firstName !== undefined ? { firstName: opts.firstName } : {}),
             ...(opts.lastName !== undefined ? { lastName: opts.lastName } : {}),
             ...(opts.avatar !== undefined ? { avatar: opts.avatar } : {}),
+            ...(opts.callingEnabled !== undefined ? { callingEnabled: opts.callingEnabled } : {}),
+            ...(opts.whatsappName !== undefined ? { whatsappName: opts.whatsappName } : {}),
+            ...(opts.whatsappAvatar !== undefined ? { whatsappAvatar: opts.whatsappAvatar } : {}),
         });
         if (opts.json) {
             console.log(JSON.stringify({ ok: true, number: n }));
@@ -29,11 +32,18 @@ export async function runNumberSet(opts) {
             console.log(`  inbound instruction:   ${n.inboundInstruction ?? ""}`);
             console.log(`  inbound voice gender:  ${n.inboundVoiceGender ?? ""}`);
             console.log(`  inbound language:      ${n.inboundLanguage ?? ""}`);
+            // Always printed, not only when it changed: "is calling on?" is the
+            // question someone runs this command to settle.
+            console.log(`  calling:               ${n.callingEnabled === false ? "off" : "on"}`);
             const hasIdentity = n.firstName != null || n.lastName != null || n.avatarUrl != null;
             if (hasIdentity) {
                 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

@@ -46,6 +46,10 @@ export async function purchaseNumber(opts) {
         body.inboundVoiceGender = opts.inboundVoiceGender;
     if (opts.inboundLanguage)
         body.inboundLanguage = opts.inboundLanguage;
+    // Only sent when asked for, so the server's default (on) stays the one place
+    // that decides what an unspecified number does.
+    if (opts.callingEnabled !== undefined)
+        body.callingEnabled = opts.callingEnabled;
     // iMessage numbers ignore areaCode, so only send it for standard numbers.
     if (opts.includeImessage)
         body.capabilities = ["sms", "call", "imessage"];
@@ -117,14 +121,23 @@ export async function setNumberProperties(opts) {
         body.firstName = opts.firstName;
     if (opts.lastName !== undefined)
         body.lastName = opts.lastName;
+    if (opts.callingEnabled !== undefined)
+        body.callingEnabled = opts.callingEnabled;
+    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, calling, 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 +154,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

@@ -38,6 +38,10 @@ export const phoneNumberSchema = z
         .nullable()
         .optional()
         .describe("BCP-47 language tag inbound calls are pinned to; null → detected from the caller's country prefix per call"),
+    callingEnabled: z
+        .boolean()
+        .optional()
+        .describe("Whether calling is switched on for this number, both directions. false → inbound calls are not connected and place_call from it fails with calling_disabled; messaging is unaffected"),
     firstName: z
         .string()
         .nullable()
@@ -53,6 +57,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/purchase-number.js

@@ -25,6 +25,10 @@ const inputSchema = {
         .boolean()
         .optional()
         .describe('Provision an iMessage number (pay-as-you-go only; provisioned asynchronously — poll List Numbers until setupStatus is "ready")'),
+    callingEnabled: z
+        .boolean()
+        .optional()
+        .describe("Whether calling is switched on for the new number; omitted → true. Pass false for a messaging-only line: inbound calls are never connected and place_call from it fails, with no window in which it answers a call. Changeable later with set_number_properties."),
 };
 export const purchaseNumberTool = {
     name: "purchase_number",
@@ -43,6 +47,7 @@ export const purchaseNumberTool = {
             inboundLanguage: args.inboundLanguage,
             areaCode: args.areaCode,
             includeImessage: args.includeImessage,
+            callingEnabled: args.callingEnabled,
         }),
     }),
 };

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

@@ -44,12 +44,25 @@ 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."),
+    callingEnabled: z
+        .boolean()
+        .optional()
+        .describe("Switch calling on or off for this number, in both directions. false stops inbound calls from being connected (the caller is never answered) and makes place_call from this number fail with calling_disabled (409); messaging on the number is unaffected. Takes effect on the next call — a call already in progress is not ended. Omit to leave it unchanged."),
 };
 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, 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.",
         inputSchema,
         outputSchema: { number: phoneNumberSchema },
         annotations: { openWorldHint: true },
@@ -69,6 +82,13 @@ export const setNumberPropertiesTool = {
                 ? { maxCallDurationSeconds: args.maxCallDurationSeconds }
                 : {}),
             ...(args.firstName !== undefined ? { firstName: args.firstName } : {}),
+            ...(args.whatsappName !== undefined ? { whatsappName: args.whatsappName } : {}),
+            ...(args.callingEnabled !== undefined
+                ? { callingEnabled: args.callingEnabled }
+                : {}),
+            ...(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.40.0",
   "description": "Dial CLI — install, sign up, and run the local listen service.",
   "license": "MIT",
   "repository": {