@getdial/cli 0.29.0 → 0.31.0

package/dist/cli.js

@@ -16,6 +16,8 @@ import { runNumberSet } from "./commands/number/set.js";
 import { runMessageSend } from "./commands/message/send.js";
 import { runMessageReply } from "./commands/message/reply.js";
 import { runMessageList } from "./commands/message/list.js";
+import { runTypingStart } from "./commands/typing/start.js";
+import { runTypingStop } from "./commands/typing/stop.js";
 import { runCallSend } from "./commands/call/send.js";
 import { runCallList } from "./commands/call/list.js";
 import { runCallGet } from "./commands/call/get.js";
@@ -102,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")
@@ -109,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,
@@ -118,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);
@@ -141,6 +146,7 @@ number
         number: numberArg,
         inboundInstruction: opts.inboundInstruction,
         inboundVoiceGender: opts.inboundVoiceGender,
+        inboundLanguage: opts.inboundLanguage,
         nickname: opts.nickname,
         maxCallDurationSeconds,
         json: !!opts.json,
@@ -151,7 +157,8 @@ const message = program
     .description("Send an SMS, optionally with media (MMS). POST /api/v1/messages.")
     .option("--to <e164>", "destination phone number, E.164 (e.g. +14155551234)")
     .option("--body <text>", "message body")
-    .option("--from-number-id <id>", "phoneNumberId to send from (defaults to onboard's number)")
+    .option("--from-number <ref>", "number to send from: id, owned E.164, or nickname (defaults to onboard's number; exclusive with --from-number-id)")
+    .option("--from-number-id <id>", "phoneNumberId to send from (defaults to onboard's number; exclusive with --from-number)")
     .option("--media <path-or-url>", "media attachment: local file path (uploaded) or public http(s) URL (repeatable, max 10)", (v, prev = []) => [...prev, v], [])
     .option("--force-audio-file", "send an audio attachment as a regular file attachment instead of an iMessage voice message")
     .option("--json", "machine-readable output")
@@ -167,6 +174,7 @@ const message = program
     process.exit(await runMessageSend({
         to: opts.to,
         body: opts.body,
+        fromNumber: opts.fromNumber,
         fromNumberId: opts.fromNumberId,
         media: opts.media,
         forceAudioFile: !!opts.forceAudioFile,
@@ -204,6 +212,43 @@ message
     since: opts.since,
     json: !!opts.json,
 })));
+const typing = program
+    .command("typing")
+    .description("Show or clear a typing indicator. iMessage numbers display it; SMS numbers ignore it. POST /api/v1/typing.");
+typing
+    .command("start")
+    .description("Show a typing indicator to a recipient, as if composing a message from your number.")
+    .option("--to-number <e164>", "recipient phone number, E.164 (e.g. +14155551234)")
+    .option("--from-number <ref>", "number the indicator appears from: id, owned E.164, or nickname (defaults to onboard's number)")
+    .option("--json", "machine-readable output")
+    .action(async (opts) => {
+    if (!opts.toNumber) {
+        console.error("error: --to-number is required. Use `dial typing start --help` for usage.");
+        process.exit(2);
+    }
+    process.exit(await runTypingStart({
+        toNumber: opts.toNumber,
+        fromNumber: opts.fromNumber,
+        json: !!opts.json,
+    }));
+});
+typing
+    .command("stop")
+    .description("Clear a typing indicator previously shown with `typing start`.")
+    .option("--to-number <e164>", "recipient phone number, E.164 (e.g. +14155551234)")
+    .option("--from-number <ref>", "number the indicator appears from: id, owned E.164, or nickname (defaults to onboard's number)")
+    .option("--json", "machine-readable output")
+    .action(async (opts) => {
+    if (!opts.toNumber) {
+        console.error("error: --to-number is required. Use `dial typing stop --help` for usage.");
+        process.exit(2);
+    }
+    process.exit(await runTypingStop({
+        toNumber: opts.toNumber,
+        fromNumber: opts.fromNumber,
+        json: !!opts.json,
+    }));
+});
 const call = program
     .command("call")
     .description("Place an outbound voice call. POST /api/v1/calls.")
@@ -213,7 +258,8 @@ const call = program
     .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("--from-number <ref>", "number to call from: id, owned E.164, or nickname (defaults to onboard's number; exclusive with --from-number-id)")
+    .option("--from-number-id <id>", "phoneNumberId to call from (defaults to onboard's number; exclusive with --from-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()) {
@@ -235,6 +281,7 @@ const call = program
         voiceGender: opts.voiceGender,
         transferTo: opts.transferTo,
         idempotencyKey: opts.idempotencyKey,
+        fromNumber: opts.fromNumber,
         fromNumberId: opts.fromNumberId,
         maxCallDurationSeconds: opts.maxCallDuration,
         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/call/send.js

@@ -10,6 +10,7 @@ export async function runCallSend(opts) {
             voiceGender: opts.voiceGender,
             transferTo: opts.transferTo,
             idempotencyKey: opts.idempotencyKey,
+            fromNumber: opts.fromNumber,
             fromNumberId: opts.fromNumberId,
             maxCallDurationSeconds: opts.maxCallDurationSeconds,
         });

package/dist/commands/message/send.js

@@ -6,6 +6,7 @@ export async function runMessageSend(opts) {
         const m = await sendMessage({
             to: opts.to,
             body: opts.body,
+            fromNumber: opts.fromNumber,
             fromNumberId: opts.fromNumberId,
             media: opts.media,
             forceAudioFile: opts.forceAudioFile,

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/commands/typing/start.js

@@ -0,0 +1,20 @@
+import { setTyping } from "../../lib/ops/typing.js";
+import { isDialError } from "../../lib/ops/errors.js";
+import { printDialError } from "../../lib/cli-error.js";
+export async function runTypingStart(opts) {
+    try {
+        const result = await setTyping({ toNumber: opts.toNumber, value: true, fromNumber: opts.fromNumber });
+        if (opts.json) {
+            console.log(JSON.stringify(result));
+        }
+        else {
+            console.log(`typing indicator shown to ${opts.toNumber} (iMessage numbers only — SMS numbers ignore it).`);
+        }
+        return 0;
+    }
+    catch (e) {
+        if (isDialError(e))
+            return printDialError(opts.json, e);
+        throw e;
+    }
+}

package/dist/commands/typing/stop.js

@@ -0,0 +1,20 @@
+import { setTyping } from "../../lib/ops/typing.js";
+import { isDialError } from "../../lib/ops/errors.js";
+import { printDialError } from "../../lib/cli-error.js";
+export async function runTypingStop(opts) {
+    try {
+        const result = await setTyping({ toNumber: opts.toNumber, value: false, fromNumber: opts.fromNumber });
+        if (opts.json) {
+            console.log(JSON.stringify(result));
+        }
+        else {
+            console.log(`typing indicator cleared for ${opts.toNumber}.`);
+        }
+        return 0;
+    }
+    catch (e) {
+        if (isDialError(e))
+            return printDialError(opts.json, e);
+        throw e;
+    }
+}

package/dist/lib/ops/auth.js

@@ -16,3 +16,28 @@ export function requireFromNumberId(auth, override) {
     }
     return id;
 }
+/**
+ * Resolve a flexible from-number ref (id, owned E.164, or nickname): explicit
+ * override, else the saved default number id (an id is a valid ref), else throw.
+ */
+export function requireFromNumber(auth, override) {
+    const ref = override ?? auth.phoneNumberId;
+    if (!ref) {
+        throw new DialError("no_from_number", "No default phoneNumberId in auth. Pass --from-number <id|E.164|nickname>.");
+    }
+    return ref;
+}
+/**
+ * Pick the from-number selector field for send/call requests. `--from-number`
+ * (flexible ref) and `--from-number-id` (id only) are mutually exclusive —
+ * both given fails fast here, before any request; neither falls back to the
+ * saved default id via the legacy field.
+ */
+export function resolveFromSelector(auth, opts) {
+    if (opts.fromNumber && opts.fromNumberId) {
+        throw new DialError("from_number_conflict", "Provide only one of --from-number and --from-number-id.");
+    }
+    if (opts.fromNumber)
+        return { fromNumber: opts.fromNumber };
+    return { fromNumberId: requireFromNumberId(auth, opts.fromNumberId) };
+}

package/dist/lib/ops/calls.js

@@ -1,12 +1,12 @@
 import { apiGet, apiPost } from "../api.js";
-import { requireAuth, requireFromNumberId } from "./auth.js";
+import { requireAuth, resolveFromSelector } from "./auth.js";
 import { DialError } from "./errors.js";
 export async function placeCall(opts) {
     const auth = requireAuth();
-    const fromNumberId = requireFromNumberId(auth, opts.fromNumberId);
+    const from = resolveFromSelector(auth, opts);
     const res = await apiPost("/api/v1/calls", {
         to: opts.to,
-        fromNumberId,
+        ...from,
         outboundInstruction: opts.outboundInstruction,
         ...(opts.language && { language: opts.language }),
         // Omitted → the server uses the default voice gender (female).

package/dist/lib/ops/messages.js

@@ -1,7 +1,7 @@
 import { readFileSync } from "node:fs";
 import { basename, extname } from "node:path";
 import { apiGet, apiPost, apiPostMultipart, ApiFormData } from "../api.js";
-import { requireAuth, requireFromNumberId } from "./auth.js";
+import { requireAuth, resolveFromSelector } from "./auth.js";
 import { DialError } from "./errors.js";
 export const MAX_MEDIA_ITEMS = 10;
 // File extensions the API accepts for uploads, mapped to their MIME type
@@ -46,7 +46,7 @@ function readMediaFile(path) {
 }
 export async function sendMessage(opts) {
     const auth = requireAuth();
-    const fromNumberId = requireFromNumberId(auth, opts.fromNumberId);
+    const from = resolveFromSelector(auth, opts);
     const media = opts.media ?? [];
     if (media.length > MAX_MEDIA_ITEMS) {
         throw new DialError("too_much_media", `at most ${MAX_MEDIA_ITEMS} media items are allowed per message (got ${media.length})`);
@@ -61,7 +61,7 @@ export async function sendMessage(opts) {
         res = await apiPost("/api/v1/messages", {
             to: opts.to,
             ...(opts.body ? { body: opts.body } : {}),
-            fromNumberId,
+            ...from,
             ...(media.length ? { mediaUrls: media } : {}),
             ...(opts.forceAudioFile ? { forceAudioFile: true } : {}),
         }, auth.apiKey);
@@ -71,7 +71,8 @@ export async function sendMessage(opts) {
         form.set("to", opts.to);
         if (opts.body)
             form.set("body", opts.body);
-        form.set("fromNumberId", fromNumberId);
+        for (const [field, value] of Object.entries(from))
+            form.set(field, value);
         if (opts.forceAudioFile)
             form.set("forceAudioFile", "true");
         for (const item of media) {

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/lib/ops/typing.js

@@ -0,0 +1,16 @@
+import { apiPost } from "../api.js";
+import { requireAuth, requireFromNumber } from "./auth.js";
+import { DialError } from "./errors.js";
+/**
+ * Show or clear a typing indicator (POST /api/v1/typing). iMessage numbers
+ * display it; standard numbers have no typing concept and the server silently
+ * no-ops, so calling this unconditionally is safe.
+ */
+export async function setTyping(opts) {
+    const auth = requireAuth();
+    const fromNumber = requireFromNumber(auth, opts.fromNumber);
+    const res = await apiPost("/api/v1/typing", { toNumber: opts.toNumber, value: opts.value, fromNumber }, auth.apiKey);
+    if (!res.ok)
+        throw new DialError("typing_failed", res.error, res.status);
+    return res.data;
+}

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/index.js

@@ -3,6 +3,8 @@ import { purchaseNumberTool } from "./purchase-number.js";
 import { setNumberPropertiesTool } from "./set-number-properties.js";
 import { sendMessageTool } from "./send-message.js";
 import { replyToMessageTool } from "./reply-to-message.js";
+import { startTypingTool } from "./start-typing.js";
+import { stopTypingTool } from "./stop-typing.js";
 import { listMessagesTool } from "./list-messages.js";
 import { placeCallTool } from "./place-call.js";
 import { listCallsTool } from "./list-calls.js";
@@ -25,6 +27,8 @@ export const tools = [
     setNumberPropertiesTool,
     sendMessageTool,
     replyToMessageTool,
+    startTypingTool,
+    stopTypingTool,
     listMessagesTool,
     placeCallTool,
     listCallsTool,

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

@@ -9,6 +9,11 @@ const inputSchema = {
     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"),
+    fromNumber: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Number to call from: a phone number id, one of your numbers in E.164, or a nickname. Exclusive with fromNumberId; omit both to use your primary number"),
     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"),
 };
@@ -30,6 +35,7 @@ export const placeCallTool = {
             voiceGender: args.voiceGender,
             transferTo: args.transferTo,
             idempotencyKey: args.idempotencyKey,
+            fromNumber: args.fromNumber,
             fromNumberId: args.fromNumberId,
             maxCallDurationSeconds: args.maxCallDurationSeconds,
         });

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/send-message.js

@@ -5,6 +5,11 @@ import { messageSchema } from "../schemas.js";
 const inputSchema = {
     to: z.string().min(7).describe("Destination phone number, E.164 (e.g. +14155550123)"),
     body: z.string().optional().describe("Message body; optional when mediaUrls is given (media-only send)"),
+    fromNumber: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Number to send from: a phone number id, one of your numbers in E.164, or a nickname. Exclusive with fromNumberId; omit both to use your primary number"),
     fromNumberId: z.string().optional().describe("Number id to send from; defaults to your primary number"),
     mediaUrls: z
         .array(z.string().url())
@@ -29,6 +34,7 @@ export const sendMessageTool = {
         message: await sendMessage({
             to: args.to,
             body: args.body,
+            fromNumber: args.fromNumber,
             fromNumberId: args.fromNumberId,
             media: args.mediaUrls,
             forceAudioFile: args.forceAudioFile,

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/dist/mcp/tools/start-typing.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { jsonResult } from "../result.js";
+import { setTyping } from "../../lib/ops/typing.js";
+const inputSchema = {
+    toNumber: z.string().min(7).describe("Recipient phone number, E.164 (e.g. +14155550123)"),
+    fromNumber: z
+        .string()
+        .min(1)
+        .describe("Number the indicator appears from: a phone number id, one of your numbers in E.164, or a nickname"),
+};
+export const startTypingTool = {
+    name: "start_typing",
+    config: {
+        title: "Start typing indicator",
+        description: "Show a typing indicator to the recipient, as if someone were composing a message from your number. " +
+            "iMessage numbers display it; standard (SMS) numbers have no typing concept and silently ignore it, " +
+            "so this is safe to call unconditionally before a send. Fire-and-forget and free. " +
+            "Delivering a message or reaction clears the indicator natively on the recipient's device — " +
+            "call start_typing again after a send to keep composing, and stop_typing when you stop without sending.",
+        inputSchema,
+        outputSchema: { ok: z.boolean() },
+        annotations: { openWorldHint: true },
+    },
+    run: async (args) => jsonResult(await setTyping({
+        toNumber: args.toNumber,
+        fromNumber: args.fromNumber,
+        value: true,
+    })),
+};

package/dist/mcp/tools/stop-typing.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { jsonResult } from "../result.js";
+import { setTyping } from "../../lib/ops/typing.js";
+const inputSchema = {
+    toNumber: z.string().min(7).describe("Recipient phone number, E.164 (e.g. +14155550123)"),
+    fromNumber: z
+        .string()
+        .min(1)
+        .describe("Number the indicator appears from: a phone number id, one of your numbers in E.164, or a nickname"),
+};
+export const stopTypingTool = {
+    name: "stop_typing",
+    config: {
+        title: "Stop typing indicator",
+        description: "Clear a typing indicator previously shown with start_typing. Delivering a message or reaction " +
+            "already clears it natively on the recipient's device — call this when you stop composing " +
+            "without sending. Standard (SMS) numbers silently ignore it.",
+        inputSchema,
+        outputSchema: { ok: z.boolean() },
+        annotations: { openWorldHint: true },
+    },
+    run: async (args) => jsonResult(await setTyping({
+        toNumber: args.toNumber,
+        fromNumber: args.fromNumber,
+        value: false,
+    })),
+};

package/package.json

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