@getdial/cli 0.44.1 → 0.46.0

package/dist/cli.js

@@ -65,6 +65,20 @@ function parseCalling(value) {
         return false;
     throw new InvalidArgumentError(`must be "on" or "off", got: ${value}`);
 }
+/**
+ * `--forward-to <e164|off>` → the number as typed, or null to stop forwarding.
+ *
+ * `off` (any case) or an empty string means "stop forwarding", sent as null.
+ * Anything else is sent as-is: the CLI never validates phone numbers locally,
+ * so the server's own 400 (invalid E.164, or the number's own number) is the
+ * one message the user sees.
+ */
+function parseForwardTo(value) {
+    const trimmed = value.trim();
+    if (trimmed === "" || trimmed.toLowerCase() === "off")
+        return null;
+    return value;
+}
 program
     .name("dial")
     .description("Dial CLI — set up your account and run the listen service.")
@@ -226,6 +240,7 @@ number
     .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("--forward-to <e164|off>", "forward inbound calls to this phone number instead of answering them with the AI voice agent. `off` stops forwarding", parseForwardTo)
     .option("--json", "machine-readable output")
     .action(async (numberArg, opts) => {
     let maxCallDurationSeconds;
@@ -250,6 +265,7 @@ number
         whatsappName: opts.whatsappName,
         whatsappAvatar: opts.whatsappAvatar,
         callingEnabled: opts.calling,
+        forwardTo: opts.forwardTo,
         json: !!opts.json,
     }));
 });

package/dist/commands/lookup/lookup.js

@@ -4,7 +4,22 @@ import { printDialError } from "../../lib/cli-error.js";
 /** Channels in the order they are printed, with the label each one shows as. */
 const CHANNEL_LABELS = {
     imessage: "iMessage",
+    whatsapp: "WhatsApp",
 };
+/**
+ * How one channel's verdict reads.
+ *
+ * Three states, not two. `null` means Dial did not answer for that channel — today only because the
+ * account holds no WhatsApp number of its own — and printing it as `no` would say the number is
+ * unreachable, which is the one thing it does not mean. A `?? "no"` here is the whole bug.
+ */
+function verdictOf(supported) {
+    if (supported === true)
+        return "yes";
+    if (supported === false)
+        return "no";
+    return "unknown";
+}
 export async function runLookup(number, opts) {
     try {
         const result = await lookupNumber(number);
@@ -17,7 +32,7 @@ export async function runLookup(number, opts) {
             // A channel added to the API after this CLI shipped still prints, under its
             // raw key — reporting an unknown channel is better than hiding it.
             const label = CHANNEL_LABELS[channel] ?? channel;
-            console.log(`  ${label.padEnd(9)} ${supported ? "yes" : "no"}`);
+            console.log(`  ${label.padEnd(9)} ${verdictOf(supported)}`);
         }
         return 0;
     }

package/dist/commands/number/list.js

@@ -19,7 +19,9 @@ export async function runNumberList(opts) {
             // 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}`);
+            // Same reasoning: marked only when set, since the default is the AI agent answering.
+            const forward = n.forwardTo ? `  forward:${n.forwardTo}` : "";
+            console.log(`${n.number}  id=${n.id}  ${n.country}${nickname}${calling}${forward}${tag}`);
         }
         return 0;
     }

package/dist/commands/number/set.js

@@ -20,6 +20,7 @@ export async function runNumberSet(opts) {
             ...(opts.lastName !== undefined ? { lastName: opts.lastName } : {}),
             ...(opts.avatar !== undefined ? { avatar: opts.avatar } : {}),
             ...(opts.callingEnabled !== undefined ? { callingEnabled: opts.callingEnabled } : {}),
+            ...(opts.forwardTo !== undefined ? { forwardTo: opts.forwardTo } : {}),
             ...(opts.whatsappName !== undefined ? { whatsappName: opts.whatsappName } : {}),
             ...(opts.whatsappAvatar !== undefined ? { whatsappAvatar: opts.whatsappAvatar } : {}),
         });
@@ -37,6 +38,9 @@ export async function runNumberSet(opts) {
             // 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"}`);
+            // Printed alongside calling for the same reason: "who picks up?" is the
+            // other half of that question.
+            console.log(`  forward to:            ${n.forwardTo ?? "off (AI voice agent answers)"}`);
             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/lookup.js

@@ -9,7 +9,9 @@ import { DialError } from "./errors.js";
  *
  * A lookup Dial could not complete comes back as an error (502), never as a
  * negative verdict — so a `false` here always means the number genuinely is not
- * reachable on that channel, and callers can treat the two differently.
+ * reachable on that channel, and a `null` always means Dial did not answer for
+ * that channel. Neither ever means "we could not find out", and callers can
+ * treat all three differently.
  */
 export async function lookupNumber(number) {
     const auth = maybeAuth();

package/dist/lib/ops/numbers.js

@@ -127,6 +127,9 @@ export async function setNumberProperties(opts) {
         body.lastName = opts.lastName;
     if (opts.callingEnabled !== undefined)
         body.callingEnabled = opts.callingEnabled;
+    // Empty string stops forwarding → send null, the one "off" spelling on the wire.
+    if (opts.forwardTo !== undefined)
+        body.forwardTo = opts.forwardTo || null;
     if (opts.whatsappName !== undefined)
         body.whatsappName = opts.whatsappName;
     // A URL avatar goes in the JSON body; a local file forces multipart (below).
@@ -141,7 +144,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, channel with name/avatar, firstName, lastName, avatar, whatsappName, or whatsappAvatar).");
+        throw new DialError("bad_request", "Provide at least one property to update (inboundInstruction, inboundVoiceGender, inboundLanguage, nickname, maxCallDurationSeconds, calling, forwardTo, 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,
@@ -160,8 +163,10 @@ export async function setNumberProperties(opts) {
     let res;
     if (avatarFile || whatsappAvatarFile) {
         const form = new ApiFormData();
+        // A null (a clear, e.g. `--forward-to off`) goes as an empty text part —
+        // multipart has no null, and String(null) would send the word "null".
         for (const [field, value] of Object.entries(body))
-            form.set(field, String(value));
+            form.set(field, value === null ? "" : String(value));
         if (avatarFile) {
             form.append("avatar", new Blob([new Uint8Array(avatarFile.data)], { type: avatarFile.contentType }), avatarFile.name);
         }

package/dist/mcp/schemas.js

@@ -42,6 +42,11 @@ export const phoneNumberSchema = 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"),
+    forwardTo: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("E.164 number inbound calls are forwarded to instead of the AI voice agent answering, or null when the agent answers."),
     firstName: z
         .string()
         .nullable()

package/dist/mcp/tools/lookup-number.js

@@ -17,13 +17,22 @@ export const lookupNumberTool = {
             "are added over time. The answer is point-in-time, not a property of the number — someone who changes " +
             "device or turns the service off stops being reachable — so treat `true` as a strong signal for picking " +
             "a channel rather than a promise that the send will land. A lookup that fails is an error, never a " +
-            "`false`, so a `false` always means the number genuinely isn't reachable there.",
+            "`false` and never a `null`, so a `false` always means the number genuinely isn't reachable there. " +
+            "`whatsapp` is `null` when this account has no WhatsApp number of its own: a WhatsApp check is made " +
+            "from a WhatsApp line, so it is answered only for accounts that have one. `null` says something about " +
+            "the account, never about the number — do not report it as unreachable.",
         inputSchema,
         outputSchema: {
             number: z.string().describe("The number you asked about, normalized to E.164"),
             supports: z
                 .object({
                 imessage: z.boolean().describe("Whether the number can currently receive iMessage"),
+                whatsapp: z
+                    .boolean()
+                    .nullable()
+                    .describe("Whether the number can currently receive WhatsApp: true reachable, false not " +
+                    "reachable, null this account has no WhatsApp number so the check was not made. " +
+                    "null is never a failure and never means unreachable."),
             })
                 .describe("One key per channel, true when the number can be reached there"),
         },

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

@@ -66,12 +66,17 @@ const inputSchema = {
         .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."),
+    forwardTo: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("Forward inbound calls to this phone number (E.164) instead of having the AI voice agent answer; the caller is connected when that phone answers, and the call ends if it is busy or doesn't answer. null stops forwarding. Ignored while calling is off. Omitted leaves 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, 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.',
+        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), a phone to forward inbound calls to instead of the AI voice agent (forwardTo), 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 },
@@ -97,6 +102,7 @@ export const setNumberPropertiesTool = {
             ...(args.callingEnabled !== undefined
                 ? { callingEnabled: args.callingEnabled }
                 : {}),
+            ...(args.forwardTo !== undefined ? { forwardTo: args.forwardTo } : {}),
             ...(args.whatsappAvatarUrl !== undefined
                 ? { whatsappAvatar: args.whatsappAvatarUrl }
                 : {}),

package/package.json

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