@getdial/cli 0.3.0 → 0.4.0

package/dist/cli.js

@@ -12,6 +12,10 @@ import { runWaitFor } from "./commands/wait-for.js";
 import { runTest2faStart } from "./commands/test-2fa/start.js";
 import { runTest2faVerify } from "./commands/test-2fa/verify.js";
 import { runTest2faRun } from "./commands/test-2fa/run.js";
+import { runNumbersList } from "./commands/numbers/list.js";
+import { runNumbersProvision } from "./commands/numbers/provision.js";
+import { runSend } from "./commands/send.js";
+import { runCall } from "./commands/call.js";
 const program = new Command();
 program
     .name("dial")
@@ -79,6 +83,57 @@ test2fa
     timeoutSeconds: opts.timeout,
     json: !!opts.json,
 })));
+const numbers = program
+    .command("numbers")
+    .description("Manage your Dial phone numbers.");
+numbers
+    .command("list")
+    .description("List the numbers on your account. GET /api/v1/numbers.")
+    .option("--json", "machine-readable output")
+    .action(async (opts) => process.exit(await runNumbersList({ json: !!opts.json })));
+numbers
+    .command("provision")
+    .description("Provision an additional phone number. POST /api/v1/numbers.")
+    .option("--country <iso2>", "ISO-3166-1 alpha-2 country code (defaults to US server-side)")
+    .option("--area-code <code>", "preferred area code (US/CA)")
+    .option("--agent-id <id>", "attach to an existing agent")
+    .option("--json", "machine-readable output")
+    .action(async (opts) => process.exit(await runNumbersProvision({
+    country: opts.country,
+    areaCode: opts.areaCode,
+    agentId: opts.agentId,
+    json: !!opts.json,
+})));
+program
+    .command("send")
+    .description("Send an SMS or WhatsApp message. POST /api/v1/messages.")
+    .requiredOption("--to <e164>", "destination phone number, E.164 (e.g. +14155551234)")
+    .requiredOption("--body <text>", "message body")
+    .option("--channel <sms|whatsapp>", "channel to send on", "sms")
+    .option("--from-number-id <id>", "phone_number_id to send from (defaults to onboard's number)")
+    .option("--json", "machine-readable output")
+    .action(async (opts) => process.exit(await runSend({
+    to: opts.to,
+    body: opts.body,
+    channel: opts.channel,
+    fromNumberId: opts.fromNumberId,
+    json: !!opts.json,
+})));
+program
+    .command("call")
+    .description("Place an outbound voice call. POST /api/v1/calls.")
+    .requiredOption("--to <e164>", "destination phone number, E.164 (e.g. +14155551234)")
+    .requiredOption("--system-prompt <text>", "system prompt for the agent that will speak")
+    .option("--language <bcp47>", "BCP-47 language tag for the call", "en-US")
+    .option("--from-number-id <id>", "phone_number_id to call from (defaults to onboard's number)")
+    .option("--json", "machine-readable output")
+    .action(async (opts) => process.exit(await runCall({
+    to: opts.to,
+    systemPrompt: opts.systemPrompt,
+    language: opts.language,
+    fromNumberId: opts.fromNumberId,
+    json: !!opts.json,
+})));
 program
     .command("wait-for <event-type>")
     .description("Wait for the next matching event in the listen log (e.g. call.ended, message.received).")

package/dist/commands/call.js

@@ -0,0 +1,72 @@
+import { readAuth } from "../lib/state.js";
+import { apiPost } from "../lib/api.js";
+export async function runCall(opts) {
+    const auth = readAuth();
+    if (!auth) {
+        fail(opts.json, "not_signed_in", "Not signed in. Run `dial signup` and `dial onboard` first.");
+        return 1;
+    }
+    const fromNumberId = opts.fromNumberId ?? auth.phone_number_id;
+    if (!fromNumberId) {
+        fail(opts.json, "no_from_number", "No default phone_number_id in auth. Pass --from-number-id <id>.");
+        return 1;
+    }
+    const res = await apiPost("/api/v1/calls", {
+        to: opts.to,
+        from_number_id: fromNumberId,
+        system_prompt: opts.systemPrompt,
+        language: opts.language,
+    }, auth.api_key);
+    if (!res.ok) {
+        fail(opts.json, "call_failed", res.error, { status: res.status });
+        return 2;
+    }
+    const c = res.data.call;
+    const waitCmd = `dial wait-for call.ended -f call_id=${c.id} --json`;
+    const followUpQuestion = "Want me to wait for the call to finish and report back (duration, final status, transcript)?";
+    if (opts.json) {
+        console.log(JSON.stringify({
+            ok: true,
+            call: c,
+            agent_hint: {
+                action: "ask_user_about_waiting",
+                kind: "post_call_followup",
+                question: followUpQuestion,
+                wait_command: waitCmd,
+                on_yes: waitCmd,
+                on_no: null,
+                use_structured_tool_if_available: true,
+            },
+        }));
+    }
+    else {
+        console.log(`call initiated.`);
+        console.log(`  from:      ${c.from}`);
+        console.log(`  to:        ${c.to}`);
+        console.log(`  status:    ${c.status}`);
+        console.log(`  call id:   ${c.id}`);
+        console.log(`  twilio:    ${c.sid}`);
+        if (c.retellCallId)
+            console.log(`  retell:    ${c.retellCallId}`);
+        console.log(``);
+        console.log(`The call has been dispatched. To learn when it ends (duration, final`);
+        console.log(`status, transcript availability), wait for the call.ended event:`);
+        console.log(``);
+        console.log(`    ${waitCmd}`);
+        console.log(``);
+        console.log(`Suggestion: ask the user whether they'd like you to wait for the call`);
+        console.log(`to finish and report back, e.g.`);
+        console.log(``);
+        console.log(`    "${followUpQuestion}"`);
+        console.log(``);
+        console.log(`If yes → run the wait-for above and report when it returns.`);
+        console.log(`If no  → you're done; they can run the wait-for themselves later.`);
+    }
+    return 0;
+}
+function fail(json, code, message, extra) {
+    if (json)
+        console.log(JSON.stringify({ ok: false, code, message, ...extra }));
+    else
+        console.error(message);
+}

package/dist/commands/numbers/list.js

@@ -0,0 +1,35 @@
+import { readAuth } from "../../lib/state.js";
+import { apiGet } from "../../lib/api.js";
+export async function runNumbersList(opts) {
+    const auth = readAuth();
+    if (!auth) {
+        fail(opts.json, "not_signed_in", "Not signed in. Run `dial signup` and `dial onboard` first.");
+        return 1;
+    }
+    const res = await apiGet("/api/v1/numbers", auth.api_key);
+    if (!res.ok) {
+        fail(opts.json, "list_failed", res.error, { status: res.status });
+        return 2;
+    }
+    const numbers = res.data.numbers ?? [];
+    if (opts.json) {
+        console.log(JSON.stringify({ ok: true, numbers, default_number_id: auth.phone_number_id ?? null }));
+        return 0;
+    }
+    if (numbers.length === 0) {
+        console.log("no phone numbers. provision one with `dial numbers provision`.");
+        return 0;
+    }
+    for (const n of numbers) {
+        const tag = n.id === auth.phone_number_id ? "  (default)" : "";
+        const agent = n.agent ? `  agent=${n.agent.name}` : "";
+        console.log(`${n.number}  id=${n.id}  ${n.country}${agent}${tag}`);
+    }
+    return 0;
+}
+function fail(json, code, message, extra) {
+    if (json)
+        console.log(JSON.stringify({ ok: false, code, message, ...extra }));
+    else
+        console.error(message);
+}

package/dist/commands/numbers/provision.js

@@ -0,0 +1,38 @@
+import { readAuth } from "../../lib/state.js";
+import { apiPost } from "../../lib/api.js";
+export async function runNumbersProvision(opts) {
+    const auth = readAuth();
+    if (!auth) {
+        fail(opts.json, "not_signed_in", "Not signed in. Run `dial signup` and `dial onboard` first.");
+        return 1;
+    }
+    const body = {};
+    if (opts.country)
+        body.country = opts.country;
+    if (opts.areaCode)
+        body.area_code = opts.areaCode;
+    if (opts.agentId)
+        body.agent_id = opts.agentId;
+    const res = await apiPost("/api/v1/numbers", body, auth.api_key);
+    if (!res.ok) {
+        fail(opts.json, "provision_failed", res.error, { status: res.status });
+        return 2;
+    }
+    const n = res.data.number;
+    if (opts.json) {
+        console.log(JSON.stringify({ ok: true, number: n }));
+    }
+    else {
+        console.log(`provisioned.`);
+        console.log(`  number:   ${n.number}`);
+        console.log(`  id:       ${n.id}`);
+        console.log(`  country:  ${n.country}`);
+    }
+    return 0;
+}
+function fail(json, code, message, extra) {
+    if (json)
+        console.log(JSON.stringify({ ok: false, code, message, ...extra }));
+    else
+        console.error(message);
+}

package/dist/commands/onboard.js

@@ -9,6 +9,7 @@ const LISTEN_RATIONALE = "The background notification listening service runs on
     "Without it the agent is send-only: it can place outbound calls and send messages, but it has no way to know when something arrives at your Dial number. " +
     "It can always be installed later with `dial listen install`.";
 const PRESENTATION_HINT = "When you ask the user, describe it as \"the background notification listening service.\" Don't expose technical details (launchd, plists, daemons, systemd units) — that's not how to talk about it to a non-technical user.";
+const FINALIZATION_HINT = "To finalize onboarding, ask the user this question before continuing with any other task. If the user's original request was something else (e.g. \"call X\", \"send Y\"), briefly pause that task, ask the question, get an answer, then resume.";
 export async function runOnboard(opts) {
     let verificationId = opts.verificationId;
     let email = null;
@@ -62,9 +63,11 @@ export async function runOnboard(opts) {
             listen: { installed: false, auto_installed: false },
             agent_hint: {
                 action: "ask_user",
+                kind: "onboarding_finalization",
                 question: LISTEN_QUESTION,
                 rationale: LISTEN_RATIONALE,
                 presentation: PRESENTATION_HINT,
+                finalization_note: FINALIZATION_HINT,
                 use_structured_tool_if_available: true,
                 on_yes: "dial listen install",
                 on_no: null,
@@ -77,19 +80,24 @@ export async function runOnboard(opts) {
         if (res.data.phone_number)
             console.log(`  phone number: ${res.data.phone_number}`);
         console.log(``);
-        console.log(`The background notification listening service is not running yet.`);
-        console.log(`${LISTEN_RATIONALE}`);
+        console.log(`Onboarding finalization (required):`);
         console.log(``);
-        console.log(`If you are an agent, ask the user now:`);
+        console.log(FINALIZATION_HINT);
+        console.log(``);
+        console.log(`Ask the user:`);
         console.log(``);
         console.log(`    "${LISTEN_QUESTION}"`);
         console.log(``);
-        console.log(PRESENTATION_HINT);
+        console.log(`Background: ${LISTEN_RATIONALE}`);
+        console.log(``);
+        console.log(`Phrasing rules: ${PRESENTATION_HINT}`);
         console.log(``);
-        console.log(`Use your ask-user / clarification tool if you have one; otherwise just ask in your regular reply and wait for the answer.`);
+        console.log(`Use your structured ask-user / clarification tool if you have one;`);
+        console.log(`otherwise ask in your regular reply and wait for the answer.`);
         console.log(``);
-        console.log(`If yes:  run \`dial listen install\``);
-        console.log(`If no:   leave it off — install later with \`dial listen install\``);
+        console.log(`After the user answers:`);
+        console.log(`  yes → run \`dial listen install\`, then resume the original task.`);
+        console.log(`  no  → resume the original task. They can install later with \`dial listen install\`.`);
     }
     return 0;
 }

package/dist/commands/send.js

@@ -0,0 +1,43 @@
+import { readAuth } from "../lib/state.js";
+import { apiPost } from "../lib/api.js";
+export async function runSend(opts) {
+    const auth = readAuth();
+    if (!auth) {
+        fail(opts.json, "not_signed_in", "Not signed in. Run `dial signup` and `dial onboard` first.");
+        return 1;
+    }
+    const fromNumberId = opts.fromNumberId ?? auth.phone_number_id;
+    if (!fromNumberId) {
+        fail(opts.json, "no_from_number", "No default phone_number_id in auth. Pass --from-number-id <id>.");
+        return 1;
+    }
+    if (opts.channel !== "sms" && opts.channel !== "whatsapp") {
+        fail(opts.json, "bad_channel", `--channel must be sms or whatsapp, got "${opts.channel}".`);
+        return 1;
+    }
+    const res = await apiPost("/api/v1/messages", { to: opts.to, body: opts.body, channel: opts.channel, from_number_id: fromNumberId }, auth.api_key);
+    if (!res.ok) {
+        fail(opts.json, "send_failed", res.error, { status: res.status });
+        return 2;
+    }
+    const m = res.data.message;
+    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}`);
+        console.log(`  status:   ${m.status}`);
+        console.log(`  sid:      ${m.sid}`);
+    }
+    return 0;
+}
+function fail(json, code, message, extra) {
+    if (json)
+        console.log(JSON.stringify({ ok: false, code, message, ...extra }));
+    else
+        console.error(message);
+}

package/package.json

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