@getdial/cli 0.33.7 → 0.34.0

package/dist/cli.js

@@ -147,6 +147,9 @@ number
     return n;
 })
     .option("--clear-max-call-duration", "remove the per-number call duration cap")
+    .option("--first-name <text>", 'iMessage display first name shown beside this number\'s messages (iMessage numbers only); pass "" to clear')
+    .option("--last-name <text>", 'iMessage display last name (iMessage numbers only); pass "" to clear')
+    .option("--avatar <path-or-url>", "iMessage avatar photo (iMessage numbers only): a local image file (jpeg/png/gif/webp, max 5 MB) to upload, or a public image URL to fetch. Replaces the current photo; photos can't be removed")
     .option("--json", "machine-readable output")
     .action(async (numberArg, opts) => {
     let maxCallDurationSeconds;
@@ -163,6 +166,9 @@ number
         inboundLanguage: opts.inboundLanguage,
         nickname: opts.nickname,
         maxCallDurationSeconds,
+        firstName: opts.firstName,
+        lastName: opts.lastName,
+        avatar: opts.avatar,
         json: !!opts.json,
     }));
 });

package/dist/commands/number/set.js

@@ -14,6 +14,9 @@ export async function runNumberSet(opts) {
             ...(opts.maxCallDurationSeconds !== undefined
                 ? { maxCallDurationSeconds: opts.maxCallDurationSeconds }
                 : {}),
+            ...(opts.firstName !== undefined ? { firstName: opts.firstName } : {}),
+            ...(opts.lastName !== undefined ? { lastName: opts.lastName } : {}),
+            ...(opts.avatar !== undefined ? { avatar: opts.avatar } : {}),
         });
         if (opts.json) {
             console.log(JSON.stringify({ ok: true, number: n }));
@@ -26,6 +29,11 @@ export async function runNumberSet(opts) {
             console.log(`  inbound instruction:   ${n.inboundInstruction ?? ""}`);
             console.log(`  inbound voice gender:  ${n.inboundVoiceGender ?? ""}`);
             console.log(`  inbound language:      ${n.inboundLanguage ?? ""}`);
+            const hasIdentity = n.firstName != null || n.lastName != null || n.avatarUrl != null;
+            if (hasIdentity) {
+                console.log(`  display name:          ${[n.firstName, n.lastName].filter(Boolean).join(" ")}`);
+                console.log(`  avatar:                ${n.avatarUrl ?? ""}`);
+            }
         }
         return 0;
     }

package/dist/lib/api.js

@@ -88,12 +88,22 @@ async function apiRequest(method, path, body, apiKey, extraHeaders) {
 }
 /** POST a multipart/form-data body (file uploads). fetch sets the boundary header itself. */
 export async function apiPostMultipart(path, form, apiKey) {
+    return sendMultipart("POST", path, form, apiKey);
+}
+/** PATCH a multipart/form-data body (e.g. a number's avatar upload). fetch sets the boundary header itself. */
+export async function apiPatchMultipart(path, form, apiKey) {
+    return sendMultipart("PATCH", path, form, apiKey);
+}
+async function sendMultipart(method, path, form, apiKey) {
     const url = `${baseUrl()}${path}`;
+    // No content-type here on purpose: undici's fetch sets the multipart boundary.
+    // The user-agent must still be set (server request logs key off it — the
+    // POST path once regressed by dropping it, see the git history).
     const headers = applyRefParamsHeader({ "user-agent": USER_AGENT });
     if (apiKey)
         headers.authorization = `Bearer ${apiKey}`;
     try {
-        const res = await undiciFetch(url, { method: "POST", headers, body: form });
+        const res = await undiciFetch(url, { method, headers, body: form });
         return toResult(res.status, await res.text());
     }
     catch (err) {

package/dist/lib/ops/numbers.js

@@ -1,6 +1,34 @@
-import { apiGet, apiPost, apiPatch } from "../api.js";
+import { readFileSync } from "node:fs";
+import { basename, extname } from "node:path";
+import { apiGet, apiPost, apiPatch, apiPatchMultipart, ApiFormData, } from "../api.js";
 import { maybeAuth } from "./auth.js";
 import { DialError } from "./errors.js";
+// Image types the avatar upload accepts, keyed by file extension.
+const AVATAR_EXT_CONTENT_TYPE = {
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    png: "image/png",
+    gif: "image/gif",
+    webp: "image/webp",
+};
+function isHttpUrl(value) {
+    return /^https?:\/\//i.test(value);
+}
+/** Read a local avatar image and resolve its MIME type from the extension. */
+function readAvatarFile(path) {
+    const ext = extname(path).slice(1).toLowerCase();
+    const contentType = AVATAR_EXT_CONTENT_TYPE[ext];
+    if (!contentType) {
+        const supported = Object.keys(AVATAR_EXT_CONTENT_TYPE).join(", ");
+        throw new DialError("unsupported_avatar", `unsupported avatar file extension ".${ext}" (${path}). Supported: ${supported}`);
+    }
+    try {
+        return { data: readFileSync(path), contentType, name: basename(path) };
+    }
+    catch (err) {
+        throw new DialError("avatar_read_failed", `could not read avatar file ${path}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
 export async function listNumbers() {
     const auth = maybeAuth();
     const res = await apiGet("/api/v1/numbers", auth?.apiKey);
@@ -41,8 +69,18 @@ export async function setNumberProperties(opts) {
         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, inboundLanguage, nickname, or maxCallDurationSeconds).");
+    if (opts.firstName !== undefined)
+        body.firstName = opts.firstName;
+    if (opts.lastName !== undefined)
+        body.lastName = opts.lastName;
+    // A URL avatar goes in the JSON body; a local file forces multipart (below).
+    // Read + validate the file up front, before any API round-trip, so a bad
+    // path or unsupported type fails fast.
+    const avatarFile = opts.avatar !== undefined && !isHttpUrl(opts.avatar) ? readAvatarFile(opts.avatar) : null;
+    if (opts.avatar !== undefined && !avatarFile)
+        body.avatarUrl = opts.avatar;
+    if (Object.keys(body).length === 0 && !avatarFile) {
+        throw new DialError("bad_request", "Provide at least one property to update (inboundInstruction, inboundVoiceGender, inboundLanguage, nickname, maxCallDurationSeconds, firstName, lastName, or avatar).");
     }
     const auth = maybeAuth();
     // The REST API keys numbers by id; the CLI/tool takes the E.164 number for ergonomics,
@@ -55,7 +93,20 @@ export async function setNumberProperties(opts) {
         const known = list.data.numbers.map((n) => n.number).join(", ") || "(none)";
         throw new DialError("number_not_found", `No phone number ${opts.number} on your account. Yours: ${known}.`);
     }
-    const res = await apiPatch(`/api/v1/numbers/${match.id}`, body, auth?.apiKey);
+    const path = `/api/v1/numbers/${match.id}`;
+    // A local avatar file forces a multipart PATCH: every scalar field goes in as a
+    // text part alongside the uploaded `avatar` file. Otherwise a plain JSON PATCH.
+    let res;
+    if (avatarFile) {
+        const form = new ApiFormData();
+        for (const [field, value] of Object.entries(body))
+            form.set(field, String(value));
+        form.append("avatar", new Blob([new Uint8Array(avatarFile.data)], { type: avatarFile.contentType }), avatarFile.name);
+        res = await apiPatchMultipart(path, form, auth?.apiKey);
+    }
+    else {
+        res = await apiPatch(path, body, auth?.apiKey);
+    }
     if (!res.ok)
         throw new DialError("update_failed", res.error, res.status);
     return res.data.number;

package/dist/mcp/schemas.js

@@ -38,6 +38,21 @@ export const phoneNumberSchema = z
         .nullable()
         .optional()
         .describe("BCP-47 language tag inbound calls are pinned to; null → detected from the caller's country prefix per call"),
+    firstName: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("iMessage display first name; null on numbers without iMessage"),
+    lastName: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("iMessage display last name; null on numbers without iMessage"),
+    avatarUrl: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("URL of the number's iMessage avatar photo; null when unset or not an iMessage number"),
 })
     .passthrough();
 export const messageSchema = z

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

@@ -29,12 +29,27 @@ const inputSchema = {
         .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."),
+    firstName: z
+        .string()
+        .max(30)
+        .optional()
+        .describe("iMessage display first name shown beside this number's messages in recipients' Messages apps. iMessage numbers only. Pass an empty string to clear it."),
+    lastName: z
+        .string()
+        .max(30)
+        .optional()
+        .describe("iMessage display last name. iMessage numbers only. Pass an empty string to clear it."),
+    avatarUrl: z
+        .string()
+        .url()
+        .optional()
+        .describe("Public image URL to set as the number's iMessage avatar photo (the server downloads it). jpeg/png/gif/webp, max 5 MB. iMessage numbers only. The photo can be replaced but not removed."),
 };
 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), inbound voice gender, inbound language, 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, nickname, and — for iMessage numbers — its display identity (firstName, lastName, avatarUrl shown beside its messages). Provide at least one.",
         inputSchema,
         outputSchema: { number: phoneNumberSchema },
         annotations: { openWorldHint: true },
@@ -53,6 +68,9 @@ export const setNumberPropertiesTool = {
             ...(args.maxCallDurationSeconds !== undefined
                 ? { maxCallDurationSeconds: args.maxCallDurationSeconds }
                 : {}),
+            ...(args.firstName !== undefined ? { firstName: args.firstName } : {}),
+            ...(args.lastName !== undefined ? { lastName: args.lastName } : {}),
+            ...(args.avatarUrl !== undefined ? { avatar: args.avatarUrl } : {}),
         }),
     }),
 };

package/package.json

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