@getdial/cli 0.30.0 → 0.31.0

package/dist/cli.js

@@ -104,6 +104,7 @@ number
     .requiredOption("--inbound-instruction <text>", "system prompt for inbound calls to this number")
     .requiredOption("--explicit-programmatic-consent <text>", "required attestation that the account holder consented to provisioning this number programmatically (stored on the number)")
     .option("--inbound-voice-gender <male|female>", "voice gender for inbound calls (default: female; pass male to override)")
+    .option("--inbound-language <bcp47>", "language tag inbound calls are pinned to (default: detect from the caller's country prefix, alongside en-US)")
     .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("--json", "machine-readable output")
@@ -111,6 +112,7 @@ number
     inboundInstruction: opts.inboundInstruction,
     explicitProgrammaticConsent: opts.explicitProgrammaticConsent,
     inboundVoiceGender: opts.inboundVoiceGender,
+    inboundLanguage: opts.inboundLanguage,
     areaCode: opts.areaCode,
     includeImessage: !!opts.includeImessage,
     json: !!opts.json,
@@ -120,6 +122,7 @@ 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 (reverts to the default, female)')
+    .option("--inbound-language <bcp47>", 'language tag inbound calls are pinned to; pass "" to clear (reverts to detecting from the caller\'s country prefix)')
     .option("--nickname <text>", 'human-readable label for the number, e.g. "Support line"; pass "" to clear')
     .option("--max-call-duration <seconds>", "call duration cap for this number, in seconds, applied as a hard ceiling to both inbound and outbound calls (the smallest of the per-number, account, and per-call caps wins)", (v) => {
     const n = parseInt(v, 10);
@@ -143,6 +146,7 @@ number
         number: numberArg,
         inboundInstruction: opts.inboundInstruction,
         inboundVoiceGender: opts.inboundVoiceGender,
+        inboundLanguage: opts.inboundLanguage,
         nickname: opts.nickname,
         maxCallDurationSeconds,
         json: !!opts.json,

package/dist/commands/billing.js

@@ -19,6 +19,9 @@ export async function runBilling(opts) {
         else {
             console.log(`plan:      pay-as-you-go`);
         }
+        if (billing.numbersReleaseAt) {
+            console.log(`at risk:   balance is negative — all numbers release ${billing.numbersReleaseAt} for non-payment (top up to keep them)`);
+        }
         if (billing.numbers.length > 0) {
             console.log(`numbers:`);
             for (const n of billing.numbers) {

package/dist/commands/number/purchase.js

@@ -7,6 +7,7 @@ export async function runNumberPurchase(opts) {
             inboundInstruction: opts.inboundInstruction,
             explicitProgrammaticConsent: opts.explicitProgrammaticConsent,
             inboundVoiceGender: opts.inboundVoiceGender,
+            inboundLanguage: opts.inboundLanguage,
             areaCode: opts.areaCode,
             includeImessage: opts.includeImessage,
         });

package/dist/commands/number/set.js

@@ -7,6 +7,7 @@ export async function runNumberSet(opts) {
             number: opts.number,
             inboundInstruction: opts.inboundInstruction,
             ...(opts.inboundVoiceGender !== undefined ? { inboundVoiceGender: opts.inboundVoiceGender } : {}),
+            ...(opts.inboundLanguage !== undefined ? { inboundLanguage: opts.inboundLanguage } : {}),
             ...(opts.nickname !== undefined ? { nickname: opts.nickname } : {}),
             ...(opts.maxCallDurationSeconds !== undefined ? { maxCallDurationSeconds: opts.maxCallDurationSeconds } : {}),
         });
@@ -20,6 +21,7 @@ export async function runNumberSet(opts) {
             console.log(`  nickname:              ${n.nickname ?? ""}`);
             console.log(`  inbound instruction:   ${n.inboundInstruction ?? ""}`);
             console.log(`  inbound voice gender:  ${n.inboundVoiceGender ?? ""}`);
+            console.log(`  inbound language:      ${n.inboundLanguage ?? ""}`);
         }
         return 0;
     }

package/dist/lib/ops/numbers.js

@@ -16,6 +16,8 @@ export async function purchaseNumber(opts) {
     };
     if (opts.inboundVoiceGender)
         body.inboundVoiceGender = opts.inboundVoiceGender;
+    if (opts.inboundLanguage)
+        body.inboundLanguage = opts.inboundLanguage;
     // iMessage numbers ignore areaCode, so only send it for standard numbers.
     if (opts.includeImessage)
         body.capabilities = ["sms", "call", "imessage"];
@@ -33,12 +35,14 @@ export async function setNumberProperties(opts) {
     // Empty string clears the override → send null (the enum API rejects "").
     if (opts.inboundVoiceGender !== undefined)
         body.inboundVoiceGender = opts.inboundVoiceGender || null;
+    if (opts.inboundLanguage !== undefined)
+        body.inboundLanguage = opts.inboundLanguage || null;
     if (opts.nickname !== undefined)
         body.nickname = opts.nickname;
     if (opts.maxCallDurationSeconds !== undefined)
         body.maxCallDurationSeconds = opts.maxCallDurationSeconds;
     if (Object.keys(body).length === 0) {
-        throw new DialError("bad_request", "Provide at least one property to update (inboundInstruction, inboundVoiceGender, nickname, or maxCallDurationSeconds).");
+        throw new DialError("bad_request", "Provide at least one property to update (inboundInstruction, inboundVoiceGender, inboundLanguage, nickname, or maxCallDurationSeconds).");
     }
     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

@@ -26,6 +26,7 @@ export const phoneNumberSchema = z
     country: z.string().optional(),
     inboundInstruction: z.string().nullable().optional(),
     inboundVoiceGender: z.string().nullable().optional().describe('Voice gender for inbound calls ("male"/"female"); null → female (the default)'),
+    inboundLanguage: z.string().nullable().optional().describe("BCP-47 language tag inbound calls are pinned to; null → detected from the caller's country prefix per call"),
 })
     .passthrough();
 export const messageSchema = z

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

@@ -6,6 +6,7 @@ const inputSchema = {
     inboundInstruction: z.string().min(1).describe("System prompt for inbound calls to this number"),
     explicitProgrammaticConsent: z.string().min(1).max(2000).describe("Required attestation (max 2000 chars) that the account holder consented to provisioning this number programmatically; stored on the number"),
     inboundVoiceGender: z.enum(["male", "female"]).optional().describe("Voice gender for inbound calls to this number; the default is female"),
+    inboundLanguage: z.string().optional().describe("BCP-47 language tag pinning inbound calls to this number to one language (e.g. es-ES); omitted → the language is detected from the caller's country prefix on each call (plus en-US)"),
     areaCode: z.string().optional().describe("Preferred US area code; omitted → any available US number. Only US numbers can be provisioned at this time. Ignored for iMessage numbers"),
     includeImessage: z.boolean().optional().describe('Provision an iMessage number (pay-as-you-go only; provisioned asynchronously — poll List Numbers until setupStatus is "ready")'),
 };
@@ -23,6 +24,7 @@ export const purchaseNumberTool = {
             inboundInstruction: args.inboundInstruction,
             explicitProgrammaticConsent: args.explicitProgrammaticConsent,
             inboundVoiceGender: args.inboundVoiceGender,
+            inboundLanguage: args.inboundLanguage,
             areaCode: args.areaCode,
             includeImessage: args.includeImessage,
         }),

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

@@ -6,6 +6,7 @@ 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; the default is female"),
+    inboundLanguage: z.string().optional().describe("BCP-47 language tag pinning inbound calls to this number to one language (e.g. es-ES). Pass an empty string to clear it (reverts to detecting the language from the caller's country prefix per call)."),
     nickname: z.string().max(100).optional().describe('Human-readable label for the number, e.g. "Support line". Pass an empty string to clear it.'),
     maxCallDurationSeconds: z.number().int().positive().nullable().optional().describe("Call duration cap for this number, in seconds, applied as a hard ceiling to both inbound and outbound calls (the smallest of the per-number, account, and per-call caps wins). Pass null to clear the cap; omit to leave it unchanged."),
 };
@@ -13,7 +14,7 @@ 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) and/or its nickname. 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, and/or its nickname. Provide at least one.",
         inputSchema,
         outputSchema: { number: phoneNumberSchema },
         annotations: { openWorldHint: true },
@@ -23,6 +24,7 @@ export const setNumberPropertiesTool = {
             number: args.number,
             inboundInstruction: args.inboundInstruction,
             ...(args.inboundVoiceGender !== undefined ? { inboundVoiceGender: args.inboundVoiceGender } : {}),
+            ...(args.inboundLanguage !== undefined ? { inboundLanguage: args.inboundLanguage } : {}),
             ...(args.nickname !== undefined ? { nickname: args.nickname } : {}),
             ...(args.maxCallDurationSeconds !== undefined ? { maxCallDurationSeconds: args.maxCallDurationSeconds } : {}),
         }),

package/package.json

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