@getdial/cli 0.39.0 → 0.40.1

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
@@ -203,6 +221,7 @@ number
     .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;
@@ -224,6 +243,7 @@ number
         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,7 @@ 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 } : {}),
         });
@@ -31,6 +32,9 @@ 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(" ")}`);

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,6 +121,8 @@ 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).
@@ -131,7 +137,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, firstName, lastName, avatar, whatsappName, or whatsappAvatar).");
+        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,

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

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/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

@@ -53,12 +53,16 @@ const inputSchema = {
         .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), 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 — 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 },
@@ -79,6 +83,9 @@ export const setNumberPropertiesTool = {
                 : {}),
             ...(args.firstName !== undefined ? { firstName: args.firstName } : {}),
             ...(args.whatsappName !== undefined ? { whatsappName: args.whatsappName } : {}),
+            ...(args.callingEnabled !== undefined
+                ? { callingEnabled: args.callingEnabled }
+                : {}),
             ...(args.whatsappAvatarUrl !== undefined
                 ? { whatsappAvatar: args.whatsappAvatarUrl }
                 : {}),

package/package.json

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