@getdial/cli 0.21.0 → 0.22.0

package/dist/cli.js

@@ -93,7 +93,7 @@ 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("--inbound-voice-gender <male|female>", "voice gender for inbound calls (default: female; pass male to override)")
     .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")
@@ -108,7 +108,7 @@ 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("--inbound-voice-gender <male|female>", 'voice gender for inbound calls; pass "" to clear (reverts to the default, female)')
     .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({
@@ -156,7 +156,8 @@ 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("--voice-gender <male|female>", "voice gender for the agent (default: female; pass male to override)")
+    .option("--transfer-to <e164>", "forward-to number, E.164: the agent waits for a real human (riding out hold/IVR) then cold-transfers the call here")
     .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")
@@ -170,6 +171,7 @@ const call = program
         outboundInstruction: opts.outboundInstruction,
         language: opts.language,
         voiceGender: opts.voiceGender,
+        transferTo: opts.transferTo,
         idempotencyKey: opts.idempotencyKey,
         fromNumberId: opts.fromNumberId,
         json: !!opts.json,

package/dist/commands/call/send.js

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

package/dist/lib/ops/calls.js

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

package/dist/mcp/schemas.js

@@ -25,7 +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'),
+    inboundVoiceGender: z.string().nullable().optional().describe('Voice gender for inbound calls ("male"/"female"); null → female (the default)'),
 })
     .passthrough();
 export const messageSchema = z

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

@@ -6,7 +6,8 @@ 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"),
+    voiceGender: z.enum(["male", "female"]).optional().describe("Voice gender for the agent; the default is female"),
+    transferTo: z.string().optional().describe("Forward-to number, E.164: the agent waits for a real human (riding out hold/IVR) then cold-transfers the call here. Must differ from `to` and the from number."),
     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"),
 };
@@ -26,6 +27,7 @@ export const placeCallTool = {
             outboundInstruction: args.outboundInstruction,
             language: args.language,
             voiceGender: args.voiceGender,
+            transferTo: args.transferTo,
             idempotencyKey: args.idempotencyKey,
             fromNumberId: args.fromNumberId,
         });

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

@@ -4,7 +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)"),
+    inboundVoiceGender: z.enum(["male", "female"]).optional().describe("Voice gender for inbound calls to this number; the default is female"),
     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)"),
 };

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

@@ -5,7 +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)"),
+    inboundVoiceGender: z.enum(["male", "female"]).optional().describe("Voice gender for inbound calls to this number; the default is female"),
     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 = {

package/package.json

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