@getdial/cli 0.29.0 → 0.30.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";
@@ -151,7 +153,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 +170,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 +208,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 +254,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 +277,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/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/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/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/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/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/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.30.0",
   "description": "Dial CLI — install, sign up, and run the local listen service.",
   "license": "MIT",
   "repository": {