@getdial/cli 0.28.0 → 0.30.0

package/README.md

@@ -54,6 +54,7 @@ dial wait-for message.received --field to=+14155550123
 | `dial number set <number>` | Update a number's inbound instruction. |
 | `dial message` | Send an SMS. |
 | `dial message list` | List recent messages. |
+| `dial message reply` | Reply or react to a message. |
 | `dial call` | Place an outbound AI voice call. |
 | `dial call list` | List recent calls. |
 | `dial call get <id>` | Fetch a single call — status, duration, transcript. |

package/dist/cli.js

@@ -14,7 +14,10 @@ import { runNumberList } from "./commands/number/list.js";
 import { runNumberPurchase } from "./commands/number/purchase.js";
 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";
@@ -150,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")
@@ -166,12 +170,31 @@ 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,
         json: !!opts.json,
     }));
 });
+message
+    .command("reply <messageId>")
+    .description("Reply or react to a message. POST /api/v1/messages/:id/reply.")
+    .option("--body <text>", "reply text (threads under the target on iMessage numbers)")
+    .option("--react <reaction>", "reaction: love|like|dislike|laugh|emphasize|question, or a single emoji")
+    .option("--json", "machine-readable output")
+    .action(async (messageId, opts) => {
+    if ((opts.body === undefined) === (opts.react === undefined)) {
+        console.error("error: provide exactly one of --body or --react. Use `dial message reply --help` for usage.");
+        process.exit(2);
+    }
+    process.exit(await runMessageReply({
+        messageId,
+        body: opts.body,
+        react: opts.react,
+        json: !!opts.json,
+    }));
+});
 message
     .command("list")
     .description("List recent messages on your account. GET /api/v1/messages.")
@@ -185,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.")
@@ -194,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()) {
@@ -216,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/reply.js

@@ -0,0 +1,29 @@
+import { replyToMessage } from "../../lib/ops/messages.js";
+import { isDialError } from "../../lib/ops/errors.js";
+import { printDialError } from "../../lib/cli-error.js";
+export async function runMessageReply(opts) {
+    try {
+        const m = await replyToMessage({ messageId: opts.messageId, body: opts.body, reaction: opts.react });
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: true, message: m }));
+        }
+        else {
+            console.log(`sent.`);
+            console.log(`  channel:  ${m.channel}`);
+            console.log(`  from:     ${m.from}`);
+            console.log(`  to:       ${m.to}`);
+            console.log(`  body:     ${m.body}`);
+            if (m.reaction)
+                console.log(`  reaction: ${m.reaction}`);
+            if (m.replyToId)
+                console.log(`  replyTo:  ${m.replyToId}`);
+            console.log(`  status:   ${m.status}`);
+        }
+        return 0;
+    }
+    catch (e) {
+        if (isDialError(e))
+            return printDialError(opts.json, e);
+        throw e;
+    }
+}

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) {
@@ -104,3 +105,17 @@ export async function listMessages(opts) {
         throw new DialError("list_failed", res.error, res.status);
     return res.data.messages ?? [];
 }
+export async function replyToMessage(opts) {
+    const auth = requireAuth();
+    // No `to`/`fromNumberId`: the server derives both from the target message —
+    // the reply stays in the conversation the target is part of.
+    const payload = {};
+    if (opts.body !== undefined)
+        payload.body = opts.body;
+    if (opts.reaction !== undefined)
+        payload.reaction = opts.reaction;
+    const res = await apiPost(`/api/v1/messages/${encodeURIComponent(opts.messageId)}/reply`, payload, auth.apiKey);
+    if (!res.ok)
+        throw new DialError("reply_failed", res.error, res.status);
+    return res.data.message;
+}

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

@@ -38,6 +38,8 @@ export const messageSchema = z
     direction: z.string().optional(),
     status: statusSchema,
     statusError: z.string().nullish().describe("Failure reason when status is undelivered/failed"),
+    replyToId: z.string().nullish().describe("Id of the message this one replies or reacts to; null for ordinary messages"),
+    reaction: z.string().nullish().describe("The reaction this message carries (a reaction name or an emoji); null otherwise"),
     createdAt: z.string().optional(),
 })
     .passthrough();

package/dist/mcp/tools/index.js

@@ -2,6 +2,9 @@ import { listNumbersTool } from "./list-numbers.js";
 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";
@@ -23,6 +26,9 @@ export const tools = [
     purchaseNumberTool,
     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/reply-to-message.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { jsonResult } from "../result.js";
+import { replyToMessage } from "../../lib/ops/messages.js";
+import { messageSchema } from "../schemas.js";
+const inputSchema = {
+    messageId: z
+        .string()
+        .describe("Id of the message to reply or react to (from list_messages or a message.received event)"),
+    body: z.string().optional().describe("Reply text; on an iMessage number it threads under the target message"),
+    reaction: z
+        .string()
+        .optional()
+        .describe("Reaction to send instead of a body: love, like, dislike, laugh, emphasize, question, or a single emoji"),
+};
+export const replyToMessageTool = {
+    name: "reply_to_message",
+    config: {
+        title: "Reply to a message",
+        description: "Reply in-thread or react to an existing message. The reply goes out from the Dial number the target message belongs to, to the other party — no from/to needed. Provide exactly one of body or reaction. On iMessage numbers replies thread and reactions are native; recipients that can only receive SMS get an emoji reaction as a regular text, and named reactions are rejected.",
+        inputSchema,
+        outputSchema: { message: messageSchema },
+        annotations: { openWorldHint: true },
+    },
+    run: async (args) => jsonResult({
+        message: await replyToMessage({
+            messageId: args.messageId,
+            body: args.body,
+            reaction: args.reaction,
+        }),
+    }),
+};

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.28.0",
+  "version": "0.30.0",
   "description": "Dial CLI — install, sign up, and run the local listen service.",
   "license": "MIT",
   "repository": {