@getdial/cli 0.14.0 → 0.15.0

package/README.md

@@ -1,5 +1,7 @@
 # @getdial/cli
 
+[![smithery badge](https://smithery.ai/badge/getdial-ai/dial)](https://smithery.ai/servers/getdial-ai/dial)
+
 The official command-line interface for [Dial](https://getdial.ai) — a communication stack for AI agents. Provision phone numbers, send SMS, place AI voice calls, and react to inbound events, all from your terminal. The CLI wraps the [Dial REST API](https://docs.getdial.ai) so you never have to write HTTP code.
 
 ## Installation

package/dist/mcp/result.js

@@ -1,5 +1,15 @@
+/**
+ * JSON tool response. Rendered as text, and mirrored into `structuredContent` (the
+ * JSON-coerced form) for clients that validate against the tool's `outputSchema`.
+ */
 export function jsonResult(data) {
-    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    const text = JSON.stringify(data, null, 2);
+    const structured = JSON.parse(text);
+    const result = { content: [{ type: "text", text }] };
+    if (structured !== null && typeof structured === "object" && !Array.isArray(structured)) {
+        result.structuredContent = structured;
+    }
+    return result;
 }
 export function errorResult(message) {
     return { content: [{ type: "text", text: message }], isError: true };

package/dist/mcp/schemas.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+/**
+ * Reusable Zod output schemas for tool results. Inner entity objects are
+ * `.passthrough()` so extra fields aren't stripped from `structuredContent`.
+ * Mirrors the remote server's schemas so the two surfaces stay aligned.
+ */
+export const phoneNumberSchema = z
+    .object({
+    id: z.string().describe("Phone number id (pn_…)"),
+    number: z.string().describe("E.164 phone number"),
+    country: z.string().optional(),
+    inboundInstruction: z.string().nullable().optional(),
+})
+    .passthrough();
+export const messageSchema = z
+    .object({
+    id: z.string(),
+    from: z.string(),
+    to: z.string(),
+    body: z.string(),
+    channel: z.string().optional(),
+    direction: z.string().optional(),
+    status: z.string(),
+    createdAt: z.string().optional(),
+})
+    .passthrough();
+export const callSchema = z
+    .object({
+    id: z.string(),
+    from: z.string(),
+    to: z.string(),
+    direction: z.string().optional(),
+    status: z.string(),
+    duration: z.number().optional(),
+    transcript: z.string().nullable().optional(),
+    instruction: z.string().nullable().optional(),
+    createdAt: z.string().optional(),
+})
+    .passthrough();
+export const eventSchema = z
+    .object({})
+    .passthrough()
+    .describe("The matched account event; shape varies by event type");
+export const localTargetSchema = z
+    .object({
+    kind: z.string().describe('"url" or "cmd"'),
+    id: z.string().describe("Target id (URL for url targets, path for cmd targets)"),
+    target: z.object({}).passthrough(),
+})
+    .passthrough();

package/dist/mcp/tools/add-command-target.js

@@ -12,7 +12,12 @@ export const addCommandTargetTool = {
         title: "Add Command Fan-out Target",
         description: "Register an executable the local listen daemon runs once per event (event JSON as the final arg).",
         inputSchema,
-        annotations: {},
+        outputSchema: {
+            added: z.boolean().describe("False if the target was already registered"),
+            path: z.string(),
+            args: z.array(z.string()),
+        },
+        annotations: { openWorldHint: false },
     },
     run: async (args) => jsonResult(addCommandTarget({
         path: args.path,

package/dist/mcp/tools/add-url-target.js

@@ -14,7 +14,11 @@ export const addUrlTargetTool = {
         title: "Add URL Fan-out Target",
         description: "Register a loopback HTTP endpoint the local listen daemon delivers each event to.",
         inputSchema,
-        annotations: {},
+        outputSchema: {
+            added: z.boolean().describe("False if the target was already registered"),
+            url: z.string(),
+        },
+        annotations: { openWorldHint: false },
     },
     run: async (args) => jsonResult(addUrlTarget({
         url: args.url,

package/dist/mcp/tools/get-account-status.js

@@ -1,3 +1,4 @@
+import { z } from "zod";
 import { jsonResult } from "../result.js";
 import { accountStatus } from "../../lib/ops/account.js";
 export const getAccountStatusTool = {
@@ -7,6 +8,14 @@ export const getAccountStatusTool = {
         description: "Report local Dial setup state: CLI version, backend reachability, sign-in/key validity, " +
             "any pending OTP, the listen daemon state, and the recommended next step.",
         inputSchema: {},
+        outputSchema: {
+            cli: z.object({}).passthrough().describe("CLI and node versions"),
+            backend: z.object({}).passthrough().describe("Backend URL and reachability"),
+            auth: z.object({}).passthrough().describe("Sign-in and API-key state"),
+            pendingOtp: z.object({}).passthrough().describe("Any pending sign-up OTP"),
+            listen: z.object({}).passthrough().describe("Listen daemon state"),
+            nextStep: z.string().describe("Recommended next step (signup, onboard, install_listen, ready, …)"),
+        },
         annotations: { readOnlyHint: true, openWorldHint: true },
     },
     run: async () => jsonResult(await accountStatus()),

package/dist/mcp/tools/get-call.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { jsonResult } from "../result.js";
 import { getCall } from "../../lib/ops/calls.js";
+import { callSchema } from "../schemas.js";
 const inputSchema = {
     callId: z.string().min(1).describe("The call id to fetch"),
 };
@@ -10,7 +11,8 @@ export const getCallTool = {
         title: "Get Call",
         description: "Fetch a single call by id — status, duration, and transcript when available.",
         inputSchema,
+        outputSchema: { call: callSchema },
         annotations: { readOnlyHint: true, openWorldHint: true },
     },
-    run: async (args) => jsonResult(await getCall(args.callId)),
+    run: async (args) => jsonResult({ call: await getCall(args.callId) }),
 };

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

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { jsonResult } from "../result.js";
 import { listCalls } from "../../lib/ops/calls.js";
+import { callSchema } from "../schemas.js";
 const inputSchema = {
     numberId: z.string().optional().describe("Filter to a single phone number id"),
     direction: z.enum(["inbound", "outbound"]).optional().describe("Filter by direction"),
@@ -12,11 +13,14 @@ export const listCallsTool = {
         title: "List Calls",
         description: "List recent calls on your account, newest first.",
         inputSchema,
+        outputSchema: { calls: z.array(callSchema) },
         annotations: { readOnlyHint: true, openWorldHint: true },
     },
-    run: async (args) => jsonResult(await listCalls({
-        numberId: args.numberId,
-        direction: args.direction,
-        since: args.since,
-    })),
+    run: async (args) => jsonResult({
+        calls: await listCalls({
+            numberId: args.numberId,
+            direction: args.direction,
+            since: args.since,
+        }),
+    }),
 };

package/dist/mcp/tools/list-local-targets.js

@@ -1,12 +1,15 @@
+import { z } from "zod";
 import { jsonResult } from "../result.js";
 import { listLocalTargets } from "../../lib/ops/local-targets.js";
+import { localTargetSchema } from "../schemas.js";
 export const listLocalTargetsTool = {
     name: "list_local_targets",
     config: {
         title: "List Fan-out Targets",
         description: "List the local fan-out targets the listen daemon currently delivers events to.",
         inputSchema: {},
+        outputSchema: { targets: z.array(localTargetSchema) },
         annotations: { readOnlyHint: true },
     },
-    run: async () => jsonResult(listLocalTargets()),
+    run: async () => jsonResult({ targets: listLocalTargets() }),
 };

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

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { jsonResult } from "../result.js";
 import { listMessages } from "../../lib/ops/messages.js";
+import { messageSchema } from "../schemas.js";
 const inputSchema = {
     numberId: z.string().optional().describe("Filter to a single phone number id"),
     direction: z.enum(["inbound", "outbound"]).optional().describe("Filter by direction"),
@@ -12,11 +13,14 @@ export const listMessagesTool = {
         title: "List Messages",
         description: "List recent messages on your account, newest first.",
         inputSchema,
+        outputSchema: { messages: z.array(messageSchema) },
         annotations: { readOnlyHint: true, openWorldHint: true },
     },
-    run: async (args) => jsonResult(await listMessages({
-        numberId: args.numberId,
-        direction: args.direction,
-        since: args.since,
-    })),
+    run: async (args) => jsonResult({
+        messages: await listMessages({
+            numberId: args.numberId,
+            direction: args.direction,
+            since: args.since,
+        }),
+    }),
 };

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

@@ -1,11 +1,17 @@
+import { z } from "zod";
 import { jsonResult } from "../result.js";
 import { listNumbers } from "../../lib/ops/numbers.js";
+import { phoneNumberSchema } from "../schemas.js";
 export const listNumbersTool = {
     name: "list_numbers",
     config: {
         title: "List Phone Numbers",
         description: "List the phone numbers on your Dial account, with the default number id.",
         inputSchema: {},
+        outputSchema: {
+            numbers: z.array(phoneNumberSchema),
+            defaultNumberId: z.string().nullable().describe("Your primary number id, or null"),
+        },
         annotations: { readOnlyHint: true, openWorldHint: true },
     },
     run: async () => jsonResult(await listNumbers()),

package/dist/mcp/tools/listen-install.js

@@ -1,3 +1,4 @@
+import { z } from "zod";
 import { jsonResult } from "../result.js";
 import { listenInstall } from "../../lib/ops/listen.js";
 export const listenInstallTool = {
@@ -7,6 +8,11 @@ export const listenInstallTool = {
         description: "Install the background event daemon (launchd on macOS, systemd --user on Linux) so inbound " +
             "SMS and call-ended events are delivered to this machine in real time.",
         inputSchema: {},
+        outputSchema: {
+            changed: z.boolean().describe("False if the daemon was already installed"),
+            warnings: z.array(z.string()),
+            unitPath: z.string().describe("Path to the installed launchd/systemd unit"),
+        },
         annotations: {},
     },
     run: async () => jsonResult(listenInstall()),

package/dist/mcp/tools/listen-status.js

@@ -1,3 +1,4 @@
+import { z } from "zod";
 import { jsonResult } from "../result.js";
 import { listenStatus } from "../../lib/ops/listen.js";
 export const listenStatusTool = {
@@ -6,6 +7,14 @@ export const listenStatusTool = {
         title: "Listen Daemon Status",
         description: "Report the background event daemon's state (installed/running/pid) and the last few events.",
         inputSchema: {},
+        outputSchema: {
+            installed: z.boolean(),
+            running: z.boolean(),
+            pid: z.number().nullable(),
+            unitPath: z.string(),
+            lastEventAt: z.string().nullable(),
+            lastEvents: z.array(z.unknown()).describe("Up to the last 5 events from the local log"),
+        },
         annotations: { readOnlyHint: true },
     },
     run: async () => jsonResult(listenStatus()),

package/dist/mcp/tools/listen-uninstall.js

@@ -1,3 +1,4 @@
+import { z } from "zod";
 import { jsonResult } from "../result.js";
 import { listenUninstall } from "../../lib/ops/listen.js";
 export const listenUninstallTool = {
@@ -6,6 +7,7 @@ export const listenUninstallTool = {
         title: "Uninstall Listen Daemon",
         description: "Stop and remove the background event daemon from this machine.",
         inputSchema: {},
+        outputSchema: { ok: z.boolean() },
         annotations: { destructiveHint: true },
     },
     run: async () => jsonResult(listenUninstall()),

package/dist/mcp/tools/onboard.js

@@ -14,6 +14,16 @@ export const onboardTool = {
         description: "Verify the sign-up OTP and finish onboarding: saves the API key locally and optionally installs " +
             "the Dial skill into named agents. Returns the account summary (the raw API key is never returned).",
         inputSchema,
+        outputSchema: {
+            apiKeyFingerprint: z.string().describe("Last 4 chars of the saved API key"),
+            apiKeyPath: z.string().describe("Where the key was saved"),
+            accountId: z.string(),
+            phoneNumber: z.string().nullable(),
+            phoneNumberId: z.string().nullable(),
+            skills: z.array(z.object({}).passthrough()).describe("Per-agent skill install results"),
+            supervisor: z.object({}).passthrough().describe("Listen daemon availability on this machine"),
+            listenAvailable: z.boolean(),
+        },
         annotations: { openWorldHint: true },
     },
     run: async (args) => {

package/dist/mcp/tools/place-call.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { jsonResult } from "../result.js";
 import { placeCall } from "../../lib/ops/calls.js";
+import { callSchema } from "../schemas.js";
 const inputSchema = {
     to: z.string().min(7).describe("Destination phone number, E.164 (e.g. +14155550123)"),
     outboundInstruction: z.string().min(1).describe("System prompt for the AI voice agent on this call"),
@@ -14,6 +15,7 @@ export const placeCallTool = {
         description: "Place an outbound voice call handled by an AI agent. The call runs asynchronously — " +
             "use wait_for_event to block until it ends, then get_call for the transcript.",
         inputSchema,
+        outputSchema: { call: callSchema, hint: z.string().describe("Next-step guidance for tracking the call") },
         annotations: { openWorldHint: true },
     },
     run: async (args) => {

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

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { jsonResult } from "../result.js";
 import { purchaseNumber } from "../../lib/ops/numbers.js";
+import { phoneNumberSchema } from "../schemas.js";
 const inputSchema = {
     inboundInstruction: z.string().min(1).describe("System prompt for inbound calls to this number"),
     country: z.string().optional().describe("ISO-3166-1 alpha-2 country code (defaults to US server-side)"),
@@ -12,11 +13,14 @@ export const purchaseNumberTool = {
         title: "Purchase Phone Number",
         description: "Purchase an additional phone number. This spends money on the account.",
         inputSchema,
+        outputSchema: { number: phoneNumberSchema },
         annotations: { destructiveHint: true, openWorldHint: true },
     },
-    run: async (args) => jsonResult(await purchaseNumber({
-        inboundInstruction: args.inboundInstruction,
-        country: args.country,
-        areaCode: args.areaCode,
-    })),
+    run: async (args) => jsonResult({
+        number: await purchaseNumber({
+            inboundInstruction: args.inboundInstruction,
+            country: args.country,
+            areaCode: args.areaCode,
+        }),
+    }),
 };

package/dist/mcp/tools/remove-local-target.js

@@ -10,6 +10,10 @@ export const removeLocalTargetTool = {
         title: "Remove Fan-out Target",
         description: "Unregister a local fan-out target by id. Returns removed:false if no such target.",
         inputSchema,
+        outputSchema: {
+            removed: z.boolean().describe("False if no target matched the id"),
+            id: z.string(),
+        },
         annotations: { destructiveHint: true },
     },
     run: async (args) => jsonResult(removeLocalTarget(args.id)),

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

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { jsonResult } from "../result.js";
 import { sendMessage } from "../../lib/ops/messages.js";
+import { messageSchema } from "../schemas.js";
 const inputSchema = {
     to: z.string().min(7).describe("Destination phone number, E.164 (e.g. +14155550123)"),
     body: z.string().min(1).describe("Message body"),
@@ -12,11 +13,14 @@ export const sendMessageTool = {
         title: "Send SMS",
         description: "Send an SMS from one of your Dial numbers.",
         inputSchema,
+        outputSchema: { message: messageSchema },
         annotations: { openWorldHint: true },
     },
-    run: async (args) => jsonResult(await sendMessage({
-        to: args.to,
-        body: args.body,
-        fromNumberId: args.fromNumberId,
-    })),
+    run: async (args) => jsonResult({
+        message: await sendMessage({
+            to: args.to,
+            body: args.body,
+            fromNumberId: args.fromNumberId,
+        }),
+    }),
 };

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

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { jsonResult } from "../result.js";
 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"),
@@ -11,10 +12,13 @@ export const setNumberPropertiesTool = {
         title: "Set Number Properties",
         description: "Update a phone number's inbound instruction (the system prompt for inbound calls).",
         inputSchema,
+        outputSchema: { number: phoneNumberSchema },
         annotations: { openWorldHint: true },
     },
-    run: async (args) => jsonResult(await setNumberProperties({
-        number: args.number,
-        inboundInstruction: args.inboundInstruction,
-    })),
+    run: async (args) => jsonResult({
+        number: await setNumberProperties({
+            number: args.number,
+            inboundInstruction: args.inboundInstruction,
+        }),
+    }),
 };

package/dist/mcp/tools/sign-up.js

@@ -12,6 +12,10 @@ export const signUpTool = {
         description: "Request an email OTP for a Dial account. The code is emailed; finish with the onboard tool. " +
             "Stores the pending verification locally.",
         inputSchema,
+        outputSchema: {
+            verificationId: z.string().describe("Pending verification id (also stored locally)"),
+            email: z.string(),
+        },
         annotations: { openWorldHint: true },
     },
     run: async (args) => jsonResult(await signup({ email: args.email, force: args.force })),

package/dist/mcp/tools/wait-for-event.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { jsonResult } from "../result.js";
 import { waitForEvent } from "../../lib/ops/events.js";
+import { eventSchema } from "../schemas.js";
 const inputSchema = {
     eventType: z.string().min(1).describe('Event type to wait for (e.g. "call.ended", "message.received")'),
     field: z.array(z.string()).optional().describe('Exact-match filters, each "name=value" (e.g. "callId=abc")'),
@@ -14,6 +15,12 @@ export const waitForEventTool = {
         description: "Block until a matching account event arrives. Reads the local listen log when the daemon " +
             "is running, otherwise long-polls the REST API. Returns the event, or a timeout result.",
         inputSchema,
+        outputSchema: {
+            source: z.string().nullable().describe('"log", "api", or null when nothing matched'),
+            timedOut: z.boolean(),
+            event: eventSchema.nullable(),
+            line: z.string().nullable().describe("Raw matched event line, when available"),
+        },
         annotations: { readOnlyHint: true, openWorldHint: true },
     },
     run: async (args) => jsonResult(await waitForEvent({

package/package.json

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