@getdial/cli 0.21.1 → 0.23.0

package/dist/cli.js

@@ -110,14 +110,33 @@ 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) => {
+    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}`);
+        process.exit(2);
+    }
+    return n;
+})
+    .option("--clear-max-call-duration", "remove the per-number inbound call duration cap")
     .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,
-})));
+    .action(async (numberArg, opts) => {
+    let maxCallDurationSeconds;
+    if (opts.clearMaxCallDuration) {
+        maxCallDurationSeconds = null;
+    }
+    else if (opts.maxCallDuration !== undefined) {
+        maxCallDurationSeconds = opts.maxCallDuration;
+    }
+    process.exit(await runNumberSet({
+        number: numberArg,
+        inboundInstruction: opts.inboundInstruction,
+        inboundVoiceGender: opts.inboundVoiceGender,
+        nickname: opts.nickname,
+        maxCallDurationSeconds,
+        json: !!opts.json,
+    }));
+});
 const message = program
     .command("message")
     .description("Send an SMS. POST /api/v1/messages.")
@@ -157,8 +176,17 @@ const call = program
     .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 (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("--max-call-duration <seconds>", "maximum call duration cap (seconds); call is terminated when this limit is reached", (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}`);
+        process.exit(2);
+    }
+    return n;
+})
     .option("--json", "machine-readable output")
     .action(async (opts) => {
     if (!opts.to || !opts.outboundInstruction) {
@@ -170,8 +198,10 @@ const call = program
         outboundInstruction: opts.outboundInstruction,
         language: opts.language,
         voiceGender: opts.voiceGender,
+        transferTo: opts.transferTo,
         idempotencyKey: opts.idempotencyKey,
         fromNumberId: opts.fromNumberId,
+        maxCallDurationSeconds: opts.maxCallDuration,
         json: !!opts.json,
     }));
 });

package/dist/commands/call/send.js

@@ -8,8 +8,10 @@ export async function runCallSend(opts) {
             outboundInstruction: opts.outboundInstruction,
             language: opts.language,
             voiceGender: opts.voiceGender,
+            transferTo: opts.transferTo,
             idempotencyKey: opts.idempotencyKey,
             fromNumberId: opts.fromNumberId,
+            maxCallDurationSeconds: opts.maxCallDurationSeconds,
         });
         const waitCmd = `dial wait-for call.ended -f callId=${c.id} --json`;
         const followUpQuestion = "Want me to wait for the call to finish and report back (duration, final status, transcript)?";

package/dist/commands/number/set.js

@@ -8,6 +8,7 @@ export async function runNumberSet(opts) {
             inboundInstruction: opts.inboundInstruction,
             ...(opts.inboundVoiceGender !== undefined ? { inboundVoiceGender: opts.inboundVoiceGender } : {}),
             ...(opts.nickname !== undefined ? { nickname: opts.nickname } : {}),
+            ...(opts.maxCallDurationSeconds !== undefined ? { maxCallDurationSeconds: opts.maxCallDurationSeconds } : {}),
         });
         if (opts.json) {
             console.log(JSON.stringify({ ok: true, number: n }));

package/dist/lib/ops/calls.js

@@ -11,6 +11,8 @@ export async function placeCall(opts) {
         ...(opts.language && { language: opts.language }),
         // Omitted → the server uses the default voice gender (female).
         ...(opts.voiceGender ? { voiceGender: opts.voiceGender } : {}),
+        ...(opts.transferTo ? { transferTo: opts.transferTo } : {}),
+        ...(opts.maxCallDurationSeconds !== undefined ? { maxCallDurationSeconds: opts.maxCallDurationSeconds } : {}),
     }, 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

@@ -31,8 +31,10 @@ export async function setNumberProperties(opts) {
         body.inboundVoiceGender = opts.inboundVoiceGender || 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, or nickname).");
+        throw new DialError("bad_request", "Provide at least one property to update (inboundInstruction, inboundVoiceGender, 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/tools/place-call.js

@@ -7,8 +7,10 @@ const inputSchema = {
     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; 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"),
+    maxCallDurationSeconds: z.number().int().positive().optional().describe("Maximum call duration cap (seconds); the call is terminated when this limit is reached"),
 };
 export const placeCallTool = {
     name: "place_call",
@@ -26,8 +28,10 @@ export const placeCallTool = {
             outboundInstruction: args.outboundInstruction,
             language: args.language,
             voiceGender: args.voiceGender,
+            transferTo: args.transferTo,
             idempotencyKey: args.idempotencyKey,
             fromNumberId: args.fromNumberId,
+            maxCallDurationSeconds: args.maxCallDurationSeconds,
         });
         return jsonResult({
             call,

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

@@ -7,6 +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."),
 };
 export const setNumberPropertiesTool = {
     name: "set_number_properties",
@@ -23,6 +24,7 @@ export const setNumberPropertiesTool = {
             inboundInstruction: args.inboundInstruction,
             ...(args.inboundVoiceGender !== undefined ? { inboundVoiceGender: args.inboundVoiceGender } : {}),
             ...(args.nickname !== undefined ? { nickname: args.nickname } : {}),
+            ...(args.maxCallDurationSeconds !== undefined ? { maxCallDurationSeconds: args.maxCallDurationSeconds } : {}),
         }),
     }),
 };

package/package.json

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