@getdial/cli 0.23.0 → 0.24.0

package/dist/cli.js

@@ -2,6 +2,7 @@
 import { Command } from "commander";
 import { VERSION } from "./lib/version.js";
 import { runDoctor } from "./commands/doctor.js";
+import { runBilling } from "./commands/billing.js";
 import { runSignup } from "./commands/signup.js";
 import { runOnboard } from "./commands/onboard.js";
 import { runListen } from "./commands/listen/index.js";
@@ -41,6 +42,11 @@ program
     .description("Report state and what to do next.")
     .option("--json", "machine-readable output")
     .action(async (opts) => process.exit(await runDoctor({ json: !!opts.json })));
+program
+    .command("billing")
+    .description("Show account billing: balance, plan, per-number mode, recent activity. GET /api/v1/billing.")
+    .option("--json", "machine-readable output")
+    .action(async (opts) => process.exit(await runBilling({ json: !!opts.json })));
 program
     .command("signup <email>")
     .description("Request an email OTP for the given address.")
@@ -94,13 +100,11 @@ number
     .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 (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("--area-code <code>", "preferred US area code (only US numbers can be provisioned)")
     .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,
 })));
@@ -110,7 +114,7 @@ number
     .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("--nickname <text>", 'human-readable label for the number, e.g. "Support line"; pass "" to clear')
-    .option("--max-call-duration <seconds>", "maximum inbound call duration cap for this number (seconds)", (v) => {
+    .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);
     if (!Number.isInteger(n) || n <= 0 || String(n) !== v.trim()) {
         console.error(`error: --max-call-duration must be a positive integer (seconds), got: ${v}`);
@@ -118,7 +122,7 @@ number
     }
     return n;
 })
-    .option("--clear-max-call-duration", "remove the per-number inbound call duration cap")
+    .option("--clear-max-call-duration", "remove the per-number call duration cap")
     .option("--json", "machine-readable output")
     .action(async (numberArg, opts) => {
     let maxCallDurationSeconds;

package/dist/commands/billing.js

@@ -0,0 +1,56 @@
+import { getBilling } from "../lib/ops/billing.js";
+import { isDialError } from "../lib/ops/errors.js";
+import { printDialError } from "../lib/cli-error.js";
+const usd = (cents) => `$${(cents / 100).toFixed(2)}`;
+export async function runBilling(opts) {
+    try {
+        const billing = await getBilling();
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: true, ...billing }));
+            return 0;
+        }
+        console.log(`balance:   ${usd(billing.balanceCents)}`);
+        if (billing.subscription) {
+            const s = billing.subscription;
+            const numbers = `${s.quantity} number${s.quantity === 1 ? "" : "s"}`;
+            const renewal = s.cancelAtPeriodEnd ? `cancels ${s.periodEnd}` : `renews ${s.periodEnd}`;
+            console.log(`plan:      subscribed (${s.interval}, ${numbers}) — ${renewal}`);
+        }
+        else {
+            console.log(`plan:      pay-as-you-go`);
+        }
+        if (billing.numbers.length > 0) {
+            console.log(`numbers:`);
+            for (const n of billing.numbers) {
+                const mode = n.mode === "FIXED" ? "subscription" : "pay-as-you-go";
+                const nick = n.nickname ? `  "${n.nickname}"` : "";
+                console.log(`  ${n.number}${nick}  ${mode}  id=${n.id}`);
+            }
+        }
+        if (billing.deposits.length > 0) {
+            console.log(`recent credits:`);
+            for (const d of billing.deposits) {
+                console.log(`  ${d.createdAt}  +${usd(d.amountCents)}  (${d.kind})`);
+            }
+        }
+        if (billing.paymentMethods.length > 0) {
+            console.log(`payment methods:`);
+            for (const p of billing.paymentMethods) {
+                const tag = p.isDefault ? "  (default)" : "";
+                if (p.type === "card") {
+                    const exp = `${String(p.expMonth).padStart(2, "0")}/${String(p.expYear).slice(-2)}`;
+                    console.log(`  ${p.brand} •••• ${p.last4}  exp ${exp}${tag}`);
+                }
+                else {
+                    console.log(`  ${p.type}${p.email ? `  ${p.email}` : ""}${tag}`);
+                }
+            }
+        }
+        return 0;
+    }
+    catch (e) {
+        if (isDialError(e))
+            return printDialError(opts.json, e);
+        throw e;
+    }
+}

package/dist/commands/number/purchase.js

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

package/dist/lib/ops/billing.js

@@ -0,0 +1,10 @@
+import { apiGet } from "../api.js";
+import { requireAuth } from "./auth.js";
+import { DialError } from "./errors.js";
+export async function getBilling() {
+    const auth = requireAuth();
+    const res = await apiGet("/api/v1/billing", auth.apiKey);
+    if (!res.ok)
+        throw new DialError("billing_failed", res.error, res.status);
+    return res.data;
+}

package/dist/lib/ops/numbers.js

@@ -13,8 +13,6 @@ export async function purchaseNumber(opts) {
     const body = { inboundInstruction: opts.inboundInstruction };
     if (opts.inboundVoiceGender)
         body.inboundVoiceGender = opts.inboundVoiceGender;
-    if (opts.country)
-        body.country = opts.country;
     if (opts.areaCode)
         body.areaCode = opts.areaCode;
     const res = await apiPost("/api/v1/numbers", body, auth.apiKey);

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

@@ -5,8 +5,7 @@ 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; 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)"),
+    areaCode: z.string().optional().describe("Preferred US area code; omitted → any available US number. Only US numbers can be provisioned at this time"),
 };
 export const purchaseNumberTool = {
     name: "purchase_number",
@@ -21,7 +20,6 @@ export const purchaseNumberTool = {
         number: await purchaseNumber({
             inboundInstruction: args.inboundInstruction,
             inboundVoiceGender: args.inboundVoiceGender,
-            country: args.country,
             areaCode: args.areaCode,
         }),
     }),

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

@@ -7,7 +7,7 @@ const inputSchema = {
     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"),
     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("Maximum inbound call duration cap for this number (seconds). Pass null to clear the cap; omit to leave it unchanged."),
+    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."),
 };
 export const setNumberPropertiesTool = {
     name: "set_number_properties",

package/package.json

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