@getdial/cli 0.15.2 → 0.16.0

package/dist/cli.js

@@ -96,12 +96,14 @@ number
 })));
 number
     .command("set <number>")
-    .description("Update a number's inbound instruction. PATCH /api/v1/numbers/<id>.")
-    .requiredOption("--inbound-instruction <text>", "new system prompt for inbound calls to this 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("--nickname <text>", 'human-readable label for the number, e.g. "Support line"; pass "" to clear')
     .option("--json", "machine-readable output")
     .action(async (numberArg, opts) => process.exit(await runNumberSet({
     number: numberArg,
     inboundInstruction: opts.inboundInstruction,
+    nickname: opts.nickname,
     json: !!opts.json,
 })));
 const message = program

package/dist/commands/listen/install.js

@@ -1,8 +1,5 @@
 import { readAuth } from "../../lib/state.js";
-import { installSupervised, supervisorAvailability } from "../../lib/supervisor/index.js";
-function resolveDialPath() {
-    return process.env.DIAL_BIN_OVERRIDE ?? process.argv[1] ?? "dial";
-}
+import { installSupervised, resolveListenCommand, supervisorAvailability } from "../../lib/supervisor/index.js";
 export async function runListenInstall(opts) {
     const auth = readAuth();
     if (!auth) {
@@ -21,7 +18,7 @@ export async function runListenInstall(opts) {
         return 2;
     }
     try {
-        const result = installSupervised(resolveDialPath());
+        const result = installSupervised(resolveListenCommand());
         if (opts.json)
             console.log(JSON.stringify({ ok: true, changed: result.changed, unit_path: result.unitPath, warnings: result.warnings }));
         else {

package/dist/commands/number/list.js

@@ -14,7 +14,8 @@ export async function runNumberList(opts) {
         }
         for (const n of numbers) {
             const tag = n.id === defaultNumberId ? "  (default)" : "";
-            console.log(`${n.number}  id=${n.id}  ${n.country}${tag}`);
+            const nickname = n.nickname ? `  "${n.nickname}"` : "";
+            console.log(`${n.number}  id=${n.id}  ${n.country}${nickname}${tag}`);
         }
         return 0;
     }

package/dist/commands/number/set.js

@@ -3,7 +3,11 @@ import { isDialError } from "../../lib/ops/errors.js";
 import { printDialError } from "../../lib/cli-error.js";
 export async function runNumberSet(opts) {
     try {
-        const n = await setNumberProperties({ number: opts.number, inboundInstruction: opts.inboundInstruction });
+        const n = await setNumberProperties({
+            number: opts.number,
+            inboundInstruction: opts.inboundInstruction,
+            ...(opts.nickname !== undefined ? { nickname: opts.nickname } : {}),
+        });
         if (opts.json) {
             console.log(JSON.stringify({ ok: true, number: n }));
         }
@@ -11,6 +15,7 @@ export async function runNumberSet(opts) {
             console.log(`updated.`);
             console.log(`  number:               ${n.number}`);
             console.log(`  id:                   ${n.id}`);
+            console.log(`  nickname:             ${n.nickname ?? ""}`);
             console.log(`  inbound instruction:  ${n.inboundInstruction ?? ""}`);
         }
         return 0;

package/dist/lib/cli-error.js

@@ -6,6 +6,7 @@ const EXIT_1_CODES = new Set([
     "number_not_found",
     "not_found",
     "no_pending_signup",
+    "bad_request",
 ]);
 /**
  * Print a DialError the way the generic REST commands always have — `--json` emits

package/dist/lib/ops/listen.js

@@ -1,11 +1,8 @@
 import { readFileSync } from "node:fs";
-import { installSupervised, uninstallSupervised, supervisorStatus, supervisorAvailability, lastEventAtFromLog, } from "../supervisor/index.js";
+import { installSupervised, uninstallSupervised, supervisorStatus, supervisorAvailability, lastEventAtFromLog, resolveListenCommand, } from "../supervisor/index.js";
 import { paths } from "../paths.js";
 import { requireAuth } from "./auth.js";
 import { DialError } from "./errors.js";
-function resolveDialPath() {
-    return process.env.DIAL_BIN_OVERRIDE ?? process.argv[1] ?? "dial";
-}
 export function listenInstall() {
     requireAuth();
     const supervisor = supervisorAvailability();
@@ -13,7 +10,7 @@ export function listenInstall() {
         throw new DialError("supervisor_unavailable", supervisor.reason);
     }
     try {
-        return installSupervised(resolveDialPath());
+        return installSupervised(resolveListenCommand());
     }
     catch (err) {
         throw new DialError("install_failed", err instanceof Error ? err.message : String(err));

package/dist/lib/ops/numbers.js

@@ -21,6 +21,14 @@ export async function purchaseNumber(opts) {
     return res.data.number;
 }
 export async function setNumberProperties(opts) {
+    const body = {};
+    if (opts.inboundInstruction !== undefined)
+        body.inboundInstruction = opts.inboundInstruction;
+    if (opts.nickname !== undefined)
+        body.nickname = opts.nickname;
+    if (Object.keys(body).length === 0) {
+        throw new DialError("bad_request", "Provide at least one property to update (inboundInstruction or nickname).");
+    }
     const auth = requireAuth();
     // The REST API keys numbers by id; the CLI/tool takes the E.164 number for ergonomics,
     // so resolve it to its id first.
@@ -32,7 +40,7 @@ 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}`, { inboundInstruction: opts.inboundInstruction }, auth.apiKey);
+    const res = await apiPatch(`/api/v1/numbers/${match.id}`, body, auth.apiKey);
     if (!res.ok)
         throw new DialError("update_failed", res.error, res.status);
     return res.data.number;

package/dist/lib/supervisor/index.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync, statSync } from "node:fs";
 import { userInfo } from "node:os";
+import { dirname, join } from "node:path";
 import { paths } from "../paths.js";
 import { logger } from "../log.js";
 import { LAUNCHD_LABEL, launchctlBootoutSilent, launchctlLoad, launchctlStatus, launchctlUnload, launchdPlistPath, renderLaunchdPlist, writeLaunchdPlist } from "./launchd.js";
@@ -33,13 +34,45 @@ export function supervisorAvailability() {
     }
     return { available: true };
 }
-export function installSupervised(programPath) {
+/**
+ * Builds the argv the supervised listen daemon is launched with, baked into
+ * the launchd plist / systemd unit. Pure so it can be unit-tested without a
+ * real process or filesystem.
+ *
+ * - `override` (DIAL_BIN_OVERRIDE) always wins, for tests and packaging.
+ * - When the current process was launched from npm's ephemeral npx cache
+ *   (`~/.npm/_npx/<hash>/…`, e.g. `npx @getdial/cli mcp`), baking that script
+ *   path into a long-lived unit is fragile: the cache can be garbage-collected
+ *   and the daemon would then point at a path that no longer exists. Re-invoke
+ *   through `npx @getdial/cli listen` so each launch re-resolves the CLI.
+ * - Otherwise launch the running script directly (`<dial> listen`).
+ */
+export function buildListenArgs(input) {
+    if (input.override)
+        return [input.override, "listen"];
+    if (/[/\\]_npx[/\\]/.test(input.scriptPath)) {
+        const npx = join(input.nodeDir, "npx");
+        return [input.npxExists ? npx : "npx", "-y", "@getdial/cli", "listen"];
+    }
+    return [input.scriptPath || "dial", "listen"];
+}
+/** Resolves {@link buildListenArgs} against the live process/environment. */
+export function resolveListenCommand() {
+    const nodeDir = dirname(process.execPath);
+    return buildListenArgs({
+        override: process.env.DIAL_BIN_OVERRIDE,
+        scriptPath: process.argv[1] ?? "",
+        nodeDir,
+        npxExists: existsSync(join(nodeDir, "npx")),
+    });
+}
+export function installSupervised(programArgs) {
     const platform = currentPlatform();
     const p = paths();
     if (platform === "darwin") {
         const xml = renderLaunchdPlist({
             label: LAUNCHD_LABEL,
-            programPath,
+            programArgs,
             stdoutPath: p.listenOutLog,
             stderrPath: p.listenErrLog,
         });
@@ -52,7 +85,7 @@ export function installSupervised(programPath) {
         return { changed, warnings: [], unitPath: path };
     }
     else {
-        const unit = renderSystemdUnit({ programPath });
+        const unit = renderSystemdUnit({ programArgs });
         const { path, changed } = writeSystemdUnit(unit);
         systemctlEnableAndStart();
         const warnings = [];

package/dist/lib/supervisor/launchd.js

@@ -35,6 +35,7 @@ export function renderLaunchdPlist(params) {
     // so we must prepend the directory of the currently running node (e.g. nvm's bin dir)
     // so the shebang can resolve. Falls back to /usr/local/bin which is where Homebrew puts node.
     const nodeDir = dirname(process.execPath);
+    const programArguments = params.programArgs.map((arg) => `    <string>${arg}</string>`).join("\n");
     return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
@@ -43,8 +44,7 @@ export function renderLaunchdPlist(params) {
   <string>${params.label}</string>
   <key>ProgramArguments</key>
   <array>
-    <string>${params.programPath}</string>
-    <string>listen</string>
+${programArguments}
   </array>
   <key>RunAtLoad</key>
   <true/>

package/dist/lib/supervisor/systemd.js

@@ -27,7 +27,7 @@ Wants=network-online.target
 [Service]
 Type=simple
 Environment="PATH=${nodeDir}:/usr/local/bin:/usr/bin:/bin"
-ExecStart=${params.programPath} listen
+ExecStart=${params.programArgs.join(" ")}
 Restart=on-failure
 RestartSec=10
 

package/dist/mcp/schemas.js

@@ -22,6 +22,7 @@ export const phoneNumberSchema = z
     .object({
     id: z.string().describe("Phone number id (pn_…)"),
     number: z.string().describe("E.164 phone number"),
+    nickname: z.string().nullable().optional().describe("Human-readable label for the number"),
     country: z.string().optional(),
     inboundInstruction: z.string().nullable().optional(),
 })

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

@@ -4,13 +4,14 @@ import { setNumberProperties } from "../../lib/ops/numbers.js";
 import { phoneNumberSchema } from "../schemas.js";
 const inputSchema = {
     number: z.string().min(7).describe("The E.164 phone number to update (e.g. +14155550123)"),
-    inboundInstruction: z.string().min(1).describe("New system prompt for inbound calls to this number"),
+    inboundInstruction: z.string().min(1).optional().describe("New system prompt for inbound calls to this number"),
+    nickname: z.string().max(100).optional().describe('Human-readable label for the number, e.g. "Support line". Pass an empty string to clear it.'),
 };
 export const setNumberPropertiesTool = {
     name: "set_number_properties",
     config: {
         title: "Set Number Properties",
-        description: "Update a phone number's inbound instruction (the system prompt for inbound calls).",
+        description: "Update a phone number's properties: its inbound instruction (the system prompt for inbound calls) and/or its nickname. Provide at least one.",
         inputSchema,
         outputSchema: { number: phoneNumberSchema },
         annotations: { openWorldHint: true },
@@ -19,6 +20,7 @@ export const setNumberPropertiesTool = {
         number: await setNumberProperties({
             number: args.number,
             inboundInstruction: args.inboundInstruction,
+            ...(args.nickname !== undefined ? { nickname: args.nickname } : {}),
         }),
     }),
 };

package/package.json

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