@getdial/cli 0.20.1 → 0.21.0

package/dist/cli.js

@@ -93,11 +93,13 @@ number
     .command("purchase")
     .description("Purchase an additional phone number. POST /api/v1/numbers.")
     .requiredOption("--inbound-instruction <text>", "system prompt for inbound calls to this number")
+    .option("--inbound-voice-gender <male|female>", "voice gender for inbound calls (defaults to the caller's language default voice)")
     .option("--country <iso2>", "ISO-3166-1 alpha-2 country code (defaults to US server-side)")
     .option("--area-code <code>", "preferred area code (US/CA)")
     .option("--json", "machine-readable output")
     .action(async (opts) => process.exit(await runNumberPurchase({
     inboundInstruction: opts.inboundInstruction,
+    inboundVoiceGender: opts.inboundVoiceGender,
     country: opts.country,
     areaCode: opts.areaCode,
     json: !!opts.json,
@@ -106,11 +108,13 @@ number
     .command("set <number>")
     .description("Update a number's properties (at least one flag). PATCH /api/v1/numbers/<id>.")
     .option("--inbound-instruction <text>", "new system prompt for inbound calls to this number")
+    .option("--inbound-voice-gender <male|female>", 'voice gender for inbound calls; pass "" to clear (→ caller-language default)')
     .option("--nickname <text>", 'human-readable label for the number, e.g. "Support line"; pass "" to clear')
     .option("--json", "machine-readable output")
     .action(async (numberArg, opts) => process.exit(await runNumberSet({
     number: numberArg,
     inboundInstruction: opts.inboundInstruction,
+    inboundVoiceGender: opts.inboundVoiceGender,
     nickname: opts.nickname,
     json: !!opts.json,
 })));
@@ -152,6 +156,7 @@ const call = program
     .option("--to <e164>", "destination phone number, E.164 (e.g. +14155551234)")
     .option("--outbound-instruction <text>", "system prompt for the agent that will speak")
     .option("--language <bcp47>", "BCP-47 language tag for the call (default: auto-detect from the destination number's country, alongside en-US)")
+    .option("--voice-gender <male|female>", "voice gender for the agent (defaults to the language's default voice)")
     .option("--idempotency-key <key>", "unique key (e.g. a UUID) making the placement idempotent: re-running with the same key returns the already-placed call instead of dialing again")
     .option("--from-number-id <id>", "phoneNumberId to call from (defaults to onboard's number)")
     .option("--json", "machine-readable output")
@@ -164,6 +169,7 @@ const call = program
         to: opts.to,
         outboundInstruction: opts.outboundInstruction,
         language: opts.language,
+        voiceGender: opts.voiceGender,
         idempotencyKey: opts.idempotencyKey,
         fromNumberId: opts.fromNumberId,
         json: !!opts.json,

package/dist/commands/call/send.js

@@ -7,6 +7,7 @@ export async function runCallSend(opts) {
             to: opts.to,
             outboundInstruction: opts.outboundInstruction,
             language: opts.language,
+            voiceGender: opts.voiceGender,
             idempotencyKey: opts.idempotencyKey,
             fromNumberId: opts.fromNumberId,
         });

package/dist/commands/number/purchase.js

@@ -5,6 +5,7 @@ export async function runNumberPurchase(opts) {
     try {
         const n = await purchaseNumber({
             inboundInstruction: opts.inboundInstruction,
+            inboundVoiceGender: opts.inboundVoiceGender,
             country: opts.country,
             areaCode: opts.areaCode,
         });

package/dist/commands/number/set.js

@@ -6,6 +6,7 @@ export async function runNumberSet(opts) {
         const n = await setNumberProperties({
             number: opts.number,
             inboundInstruction: opts.inboundInstruction,
+            ...(opts.inboundVoiceGender !== undefined ? { inboundVoiceGender: opts.inboundVoiceGender } : {}),
             ...(opts.nickname !== undefined ? { nickname: opts.nickname } : {}),
         });
         if (opts.json) {
@@ -13,10 +14,11 @@ export async function runNumberSet(opts) {
         }
         else {
             console.log(`updated.`);
-            console.log(`  number:               ${n.number}`);
-            console.log(`  id:                   ${n.id}`);
-            console.log(`  nickname:             ${n.nickname ?? ""}`);
-            console.log(`  inbound instruction:  ${n.inboundInstruction ?? ""}`);
+            console.log(`  number:                ${n.number}`);
+            console.log(`  id:                    ${n.id}`);
+            console.log(`  nickname:              ${n.nickname ?? ""}`);
+            console.log(`  inbound instruction:   ${n.inboundInstruction ?? ""}`);
+            console.log(`  inbound voice gender:  ${n.inboundVoiceGender ?? ""}`);
         }
         return 0;
     }

package/dist/lib/ops/calls.js

@@ -9,6 +9,8 @@ export async function placeCall(opts) {
         fromNumberId,
         outboundInstruction: opts.outboundInstruction,
         ...(opts.language && { language: opts.language }),
+        // Omitted → the server uses the language's default voice gender.
+        ...(opts.voiceGender ? { voiceGender: opts.voiceGender } : {}),
     }, auth.apiKey, opts.idempotencyKey ? { "idempotency-key": opts.idempotencyKey } : undefined);
     if (!res.ok)
         throw new DialError("call_failed", res.error, res.status);

package/dist/lib/ops/numbers.js

@@ -11,6 +11,8 @@ export async function listNumbers() {
 export async function purchaseNumber(opts) {
     const auth = requireAuth();
     const body = { inboundInstruction: opts.inboundInstruction };
+    if (opts.inboundVoiceGender)
+        body.inboundVoiceGender = opts.inboundVoiceGender;
     if (opts.country)
         body.country = opts.country;
     if (opts.areaCode)
@@ -24,10 +26,13 @@ export async function setNumberProperties(opts) {
     const body = {};
     if (opts.inboundInstruction !== undefined)
         body.inboundInstruction = opts.inboundInstruction;
+    // Empty string clears the override → send null (the enum API rejects "").
+    if (opts.inboundVoiceGender !== undefined)
+        body.inboundVoiceGender = opts.inboundVoiceGender || null;
     if (opts.nickname !== undefined)
         body.nickname = opts.nickname;
     if (Object.keys(body).length === 0) {
-        throw new DialError("bad_request", "Provide at least one property to update (inboundInstruction or nickname).");
+        throw new DialError("bad_request", "Provide at least one property to update (inboundInstruction, inboundVoiceGender, or nickname).");
     }
     const auth = requireAuth();
     // The REST API keys numbers by id; the CLI/tool takes the E.164 number for ergonomics,

package/dist/mcp/schemas.js

@@ -25,6 +25,7 @@ export const phoneNumberSchema = z
     nickname: z.string().nullable().optional().describe("Human-readable label for the number"),
     country: z.string().optional(),
     inboundInstruction: z.string().nullable().optional(),
+    inboundVoiceGender: z.string().nullable().optional().describe('Voice gender for inbound calls ("male"/"female"); null → caller-language default'),
 })
     .passthrough();
 export const messageSchema = z

package/dist/mcp/tools/place-call.js

@@ -6,6 +6,7 @@ const inputSchema = {
     to: z.string().min(7).describe("Destination phone number, E.164 (e.g. +14155550123)"),
     outboundInstruction: z.string().min(1).describe("System prompt for the AI voice agent on this call"),
     language: z.string().optional().describe("BCP-47 language tag for the call. Omit to auto-detect from the destination number's country (alongside en-US)."),
+    voiceGender: z.enum(["male", "female"]).optional().describe("Voice gender for the agent; defaults to the language's default voice"),
     idempotencyKey: z.string().optional().describe("Unique key (e.g. a UUID) making the placement idempotent: retrying with the same key returns the already-placed call instead of dialing again"),
     fromNumberId: z.string().optional().describe("Number id to call from; defaults to your primary number"),
 };
@@ -24,6 +25,7 @@ export const placeCallTool = {
             to: args.to,
             outboundInstruction: args.outboundInstruction,
             language: args.language,
+            voiceGender: args.voiceGender,
             idempotencyKey: args.idempotencyKey,
             fromNumberId: args.fromNumberId,
         });

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

@@ -4,6 +4,7 @@ import { purchaseNumber } from "../../lib/ops/numbers.js";
 import { phoneNumberSchema } from "../schemas.js";
 const inputSchema = {
     inboundInstruction: z.string().min(1).describe("System prompt for inbound calls to this number"),
+    inboundVoiceGender: z.enum(["male", "female"]).optional().describe("Voice gender for inbound calls to this number (defaults to the caller's language default voice)"),
     country: z.string().optional().describe("ISO-3166-1 alpha-2 country code (defaults to US server-side)"),
     areaCode: z.string().optional().describe("Preferred area code (US/CA)"),
 };
@@ -19,6 +20,7 @@ export const purchaseNumberTool = {
     run: async (args) => jsonResult({
         number: await purchaseNumber({
             inboundInstruction: args.inboundInstruction,
+            inboundVoiceGender: args.inboundVoiceGender,
             country: args.country,
             areaCode: args.areaCode,
         }),

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

@@ -5,6 +5,7 @@ import { phoneNumberSchema } from "../schemas.js";
 const inputSchema = {
     number: z.string().min(7).describe("The E.164 phone number to update (e.g. +14155550123)"),
     inboundInstruction: z.string().min(1).optional().describe("New system prompt for inbound calls to this number"),
+    inboundVoiceGender: z.enum(["male", "female"]).optional().describe("Voice gender for inbound calls to this number (defaults to the caller's language default voice)"),
     nickname: z.string().max(100).optional().describe('Human-readable label for the number, e.g. "Support line". Pass an empty string to clear it.'),
 };
 export const setNumberPropertiesTool = {
@@ -20,6 +21,7 @@ export const setNumberPropertiesTool = {
         number: await setNumberProperties({
             number: args.number,
             inboundInstruction: args.inboundInstruction,
+            ...(args.inboundVoiceGender !== undefined ? { inboundVoiceGender: args.inboundVoiceGender } : {}),
             ...(args.nickname !== undefined ? { nickname: args.nickname } : {}),
         }),
     }),

package/package.json

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