@getdial/cli 0.45.0 → 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/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/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/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.45.0",
+  "version": "0.46.0",
   "description": "Dial CLI — install, sign up, and run the local listen service.",
   "license": "MIT",
   "repository": {