@getdial/cli 0.43.0 → 0.44.1

package/dist/cli.js

@@ -18,6 +18,7 @@ import { runNumberPurchase } from "./commands/number/purchase.js";
 import { runNumberSet } from "./commands/number/set.js";
 import { runNumberWhatsapp } from "./commands/number/whatsapp.js";
 import { runGroupList } from "./commands/group/list.js";
+import { runLookup } from "./commands/lookup/lookup.js";
 import { runContactsList } from "./commands/contacts/list.js";
 import { runMessageSend } from "./commands/message/send.js";
 import { runMessageReply } from "./commands/message/reply.js";
@@ -337,6 +338,13 @@ program
     startingAfter: opts.startingAfter,
     json: !!opts.json,
 })));
+program
+    .command("lookup")
+    .argument("<number>", "the phone number to look up, in E.164 (e.g. +14155550123)")
+    .description("What channels a phone number can receive on, so you can pick one before sending. Works on " +
+    "any number, not just yours. GET /api/v1/lookup.")
+    .option("--json", "machine-readable output")
+    .action(async (number, opts) => process.exit(await runLookup(number, { json: !!opts.json })));
 const group = program
     .command("group")
     .description("Group conversations your lines are in (WhatsApp).");

package/dist/commands/lookup/lookup.js

@@ -0,0 +1,31 @@
+import { lookupNumber } from "../../lib/ops/lookup.js";
+import { isDialError } from "../../lib/ops/errors.js";
+import { printDialError } from "../../lib/cli-error.js";
+/** Channels in the order they are printed, with the label each one shows as. */
+const CHANNEL_LABELS = {
+    imessage: "iMessage",
+};
+export async function runLookup(number, opts) {
+    try {
+        const result = await lookupNumber(number);
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: true, ...result }));
+            return 0;
+        }
+        console.log(result.number);
+        for (const [channel, supported] of Object.entries(result.supports)) {
+            // A channel added to the API after this CLI shipped still prints, under its
+            // raw key — reporting an unknown channel is better than hiding it.
+            const label = CHANNEL_LABELS[channel] ?? channel;
+            console.log(`  ${label.padEnd(9)} ${supported ? "yes" : "no"}`);
+        }
+        return 0;
+    }
+    catch (e) {
+        // A lookup that could not be completed exits non-zero rather than printing
+        // "no": the two mean different things, and only one is worth retrying.
+        if (isDialError(e))
+            return printDialError(opts.json, e);
+        throw e;
+    }
+}

package/dist/lib/ops/lookup.js

@@ -0,0 +1,20 @@
+import { apiGet } from "../api.js";
+import { maybeAuth } from "./auth.js";
+import { DialError } from "./errors.js";
+/**
+ * Look a number up.
+ *
+ * Shared by `dial lookup` and the local MCP `lookup_number` tool, so both speak to
+ * the API through one place and inherit the saved key the same way.
+ *
+ * A lookup Dial could not complete comes back as an error (502), never as a
+ * negative verdict — so a `false` here always means the number genuinely is not
+ * reachable on that channel, and callers can treat the two differently.
+ */
+export async function lookupNumber(number) {
+    const auth = maybeAuth();
+    const res = await apiGet(`/api/v1/lookup?number=${encodeURIComponent(number)}`, auth?.apiKey);
+    if (!res.ok)
+        throw new DialError("lookup_failed", res.error, res.status);
+    return res.data;
+}

package/dist/mcp/tools/index.js

@@ -8,6 +8,7 @@ import { stopTypingTool } from "./stop-typing.js";
 import { listMessagesTool } from "./list-messages.js";
 import { listGroupsTool } from "./list-groups.js";
 import { listContactsTool } from "./list-contacts.js";
+import { lookupNumberTool } from "./lookup-number.js";
 import { placeCallTool } from "./place-call.js";
 import { listCallsTool } from "./list-calls.js";
 import { getCallTool } from "./get-call.js";
@@ -35,6 +36,7 @@ export const tools = [
     listMessagesTool,
     listGroupsTool,
     listContactsTool,
+    lookupNumberTool,
     placeCallTool,
     listCallsTool,
     getCallTool,

package/dist/mcp/tools/list-groups.js

@@ -8,7 +8,7 @@ export const listGroupsTool = {
         title: "List Groups",
         description: "List the group conversations your lines are in. A group is a conversation that isn't a phone " +
             "number, so it has an id of its own: pass it as groupId to send_message, or to list_messages to " +
-            "read that conversation. Groups exist on WhatsApp lines. " +
+            "read that conversation. Groups exist on WhatsApp lines and iMessage numbers. " +
             "A group's name can be null — it is read live from the line holding the conversation, so a line " +
             "that can't answer in time yields a null name rather than hiding the group. " +
             "There is no join event: list again to see a group your line was just added to.",

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

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { jsonResult } from "../result.js";
+import { lookupNumber } from "../../lib/ops/lookup.js";
+const inputSchema = {
+    number: z
+        .string()
+        .describe("The phone number to look up, in E.164 — e.g. +14155550123. Any number, not just your own."),
+};
+export const lookupNumberTool = {
+    name: "lookup_number",
+    config: {
+        title: "Look Up A Number",
+        description: "Check what channels a phone number can receive on, before sending to it. Works on ANY number in the " +
+            "world — it doesn't have to be one of your numbers, and you don't have to have messaged it before. " +
+            "`supports` describes the number you asked about, not your own line: each key is a channel and the " +
+            "boolean says whether that number can be reached there. Read the channels you need by name, since more " +
+            "are added over time. The answer is point-in-time, not a property of the number — someone who changes " +
+            "device or turns the service off stops being reachable — so treat `true` as a strong signal for picking " +
+            "a channel rather than a promise that the send will land. A lookup that fails is an error, never a " +
+            "`false`, so a `false` always means the number genuinely isn't reachable there.",
+        inputSchema,
+        outputSchema: {
+            number: z.string().describe("The number you asked about, normalized to E.164"),
+            supports: z
+                .object({
+                imessage: z.boolean().describe("Whether the number can currently receive iMessage"),
+            })
+                .describe("One key per channel, true when the number can be reached there"),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    },
+    run: async (args) => jsonResult(await lookupNumber(args.number)),
+};

package/dist/mcp/tools/send-message.js

@@ -12,7 +12,7 @@ const inputSchema = {
         .string()
         .min(1)
         .optional()
-        .describe("A group conversation to send into (see list_groups), instead of a to number. The sending line comes from the group, so no from-number is needed. Provide exactly one of to or groupId"),
+        .describe("A group conversation to send into (see list_groups), instead of a to number. The sending line comes from the group, so no from-number is needed, and neither is channel — the group already knows which one it is on, and naming a different one is refused. Provide exactly one of to or groupId"),
     channel: z
         .enum(["imessage", "whatsapp"])
         .optional()
@@ -48,7 +48,8 @@ export const sendMessageTool = {
             "optionally with media attachments (MMS). On an iMessage number, a single audio attachment is " +
             "delivered as a voice message unless forceAudioFile is true. " +
             "Address it with exactly one of to or groupId. A WhatsApp number sends text and a single " +
-            "attachment (a caption is allowed only with an image or video).",
+            "attachment (a caption is allowed only with an image or video); a WhatsApp group is text-only, " +
+            "while an iMessage group takes media like any other iMessage conversation.",
         inputSchema,
         outputSchema: { message: messageSchema },
         annotations: { openWorldHint: true },

package/dist/mcp/tools/tool-names.js

@@ -31,6 +31,7 @@ export const OPERATIONAL_TOOL_NAMES = [
     "list_messages",
     "list_groups",
     "list_contacts",
+    "lookup_number",
     "place_call",
     "list_calls",
     "get_call",

package/package.json

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