@getdial/cli 0.25.2 → 0.26.0

package/dist/cli.js

@@ -99,13 +99,17 @@ 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")
+    .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("--area-code <code>", "preferred US area code (only US numbers can be provisioned)")
+    .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")
     .action(async (opts) => process.exit(await runNumberPurchase({
     inboundInstruction: opts.inboundInstruction,
+    explicitProgrammaticConsent: opts.explicitProgrammaticConsent,
     inboundVoiceGender: opts.inboundVoiceGender,
     areaCode: opts.areaCode,
+    includeImessage: !!opts.includeImessage,
     json: !!opts.json,
 })));
 number

package/dist/commands/number/purchase.js

@@ -5,8 +5,10 @@ export async function runNumberPurchase(opts) {
     try {
         const n = await purchaseNumber({
             inboundInstruction: opts.inboundInstruction,
+            explicitProgrammaticConsent: opts.explicitProgrammaticConsent,
             inboundVoiceGender: opts.inboundVoiceGender,
             areaCode: opts.areaCode,
+            includeImessage: opts.includeImessage,
         });
         if (opts.json) {
             console.log(JSON.stringify({ ok: true, number: n }));
@@ -16,6 +18,11 @@ export async function runNumberPurchase(opts) {
             console.log(`  number:   ${n.number}`);
             console.log(`  id:       ${n.id}`);
             console.log(`  country:  ${n.country}`);
+            // iMessage numbers provision asynchronously: the number is returned right
+            // away in setupStatus "provisioning". Tell the user to poll before using it.
+            if (opts.includeImessage) {
+                console.log(`  status:   ${n.setupStatus ?? "provisioning"} — run \`dial number list\` until it's "ready" before sending or calling from it.`);
+            }
         }
         return 0;
     }

package/dist/lib/api.js

@@ -1,6 +1,10 @@
 import { request } from "undici";
 import { logger } from "./log.js";
+import { VERSION } from "./version.js";
 const DEFAULT_BASE = "https://api.getdial.ai";
+// Identifies the CLI on every request, so server-side request logs attribute
+// provisioning (and everything else) to the client + version that made the call.
+const USER_AGENT = `@getdial/cli/${VERSION}`;
 export function baseUrl() {
     return process.env.DIAL_API_URL ?? DEFAULT_BASE;
 }
@@ -15,7 +19,7 @@ export async function apiPatch(path, body, apiKey) {
 }
 async function apiRequest(method, path, body, apiKey, extraHeaders) {
     const url = `${baseUrl()}${path}`;
-    const headers = { "content-type": "application/json", ...(extraHeaders ?? {}) };
+    const headers = { "content-type": "application/json", "user-agent": USER_AGENT, ...(extraHeaders ?? {}) };
     if (apiKey)
         headers.authorization = `Bearer ${apiKey}`;
     try {

package/dist/lib/ops/numbers.js

@@ -10,10 +10,16 @@ export async function listNumbers() {
 }
 export async function purchaseNumber(opts) {
     const auth = requireAuth();
-    const body = { inboundInstruction: opts.inboundInstruction };
+    const body = {
+        inboundInstruction: opts.inboundInstruction,
+        explicitProgrammaticConsent: opts.explicitProgrammaticConsent,
+    };
     if (opts.inboundVoiceGender)
         body.inboundVoiceGender = opts.inboundVoiceGender;
-    if (opts.areaCode)
+    // iMessage numbers ignore areaCode, so only send it for standard numbers.
+    if (opts.includeImessage)
+        body.capabilities = ["sms", "call", "imessage"];
+    else if (opts.areaCode)
         body.areaCode = opts.areaCode;
     const res = await apiPost("/api/v1/numbers", body, auth.apiKey);
     if (!res.ok)

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

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

package/package.json

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