conduyt 1.36.0 → 1.38.0

package/README.md

@@ -40,7 +40,13 @@ conduyt insights summary                # run an AI insight query
 conduyt insights saved_report --report "Lead Activity" --period last_7_days   # run any saved report as a tool
 conduyt insights dashboard --dashboard Floor --period today                   # run every tile of a board
 conduyt insights report_catalog                                                # what this key can run
-conduyt messages transports             # what a workflow Send SMS step can speak through today (Twilio numbers, Project Blue lines)
+conduyt messages transports             # what a workflow Send SMS step can speak through today (Twilio numbers, Project Blue lines, the WhatsApp sender)
+conduyt whatsapp status                 # WhatsApp via your Twilio: connected? from which sender
+conduyt whatsapp senders                # the senders Twilio lists for the account (ONLINE = connectable)
+conduyt whatsapp connect <senderSid>    # connect a sender (verified with Twilio first)
+conduyt whatsapp templates              # approved / pending / rejected templates with their {{n}} placeholders
+conduyt dialer voice-drop --contact <id> [--recording "Missed you"] [--if-human play]   # a call that plays a Voicemail Drop recording to a machine
+conduyt messages send-sms --contact <id> --transport whatsapp --whatsapp-template HX… --whatsapp-variables '{"1":"Alex"}' --body "…"
 conduyt privacy export <id>             # GDPR data-portability export (owner/admin)
 conduyt privacy forget <id> --confirm FORGET  # GDPR erasure — IRREVERSIBLE, owner only
 conduyt reply-capture status            # inbound reply capture: state, DNS records, provider health

package/dist/index.js

@@ -804,8 +804,34 @@ messages
 }));
 messages
     .command("transports")
-    .description("What a workflow Send SMS step can speak through today (GET /sms/transports): Twilio {connected, numbers = account number + active reps' lines, valid send_sms fromNumber values}, Project Blue {connected, lines held by active reps, valid projectBlueLineId values for smsMode project_blue}, webhook provider count, FromK.ai coming soon (automations scope)")
+    .description("What a workflow Send SMS step can speak through today (GET /sms/transports): Twilio {connected, numbers = account number + active reps' lines, valid send_sms fromNumber values}, Project Blue {connected, lines held by active reps, valid projectBlueLineId values for smsMode project_blue}, WhatsApp {connected, sender for smsMode whatsapp}, Voice drop {connected, recordings = the Voicemail Drop catalog for smsMode voice_drop}, webhook provider count, FromK.ai coming soon (automations scope)")
     .action(run(async (client) => client.get("/api/v1/sms/transports")));
+// ---- WhatsApp via Twilio (2026-09-11) ----
+const whatsapp = program.command("whatsapp").description("WhatsApp via your own Twilio account: a Meta-approved sender, approved templates for outreach, free-form replies within a contact's 24-hour window");
+whatsapp
+    .command("status")
+    .description("Connection status (GET /settings/whatsapp): connected | not_configured | twilio_required, the sender {phoneNumber, sid} (settings scope)")
+    .action(run(async (client) => client.get("/api/v1/settings/whatsapp")));
+whatsapp
+    .command("senders")
+    .description("The WhatsApp senders Twilio lists under the account's credentials, with status (only ONLINE can be connected) and which one is connected (settings scope)")
+    .action(run(async (client) => client.get("/api/v1/settings/whatsapp/senders")));
+whatsapp
+    .command("connect <senderSid>")
+    .description("Connect the account's WhatsApp sender by its Twilio sid (XE…, see `whatsapp senders`) — verified with Twilio first: on this account and ONLINE; one sender belongs to one Conduyt account (settings scope)")
+    .action(run(async (client, senderSid) => {
+    if (!/^XE[0-9a-fA-F]{32}$/.test(senderSid.trim()))
+        throw new Error("senderSid must be a Twilio WhatsApp sender SID (XE followed by 32 hex characters).");
+    return client.put("/api/v1/settings/whatsapp", { senderSid: senderSid.trim() });
+}));
+whatsapp
+    .command("disconnect")
+    .description("Forget the WhatsApp sender — workflow steps on the WhatsApp channel stop sending (settings scope)")
+    .action(run(async (client) => client.del("/api/v1/settings/whatsapp")));
+whatsapp
+    .command("templates")
+    .description("The account's WhatsApp templates (Twilio Content) with Meta's approval verdict: sid (a send-sms --whatsapp-template value), text with {{n}} placeholders, variables, approval (automations scope)")
+    .action(run(async (client) => client.get("/api/v1/sms/whatsapp/templates")));
 messages
     .command("send-sms")
     .description("Send an outbound SMS (POST /messages/sms/send) — via Twilio, or from your own Project Blue iPhone line with --transport project_blue")
@@ -813,7 +839,9 @@ messages
     .option("--body <text>", "SMS body, 1-1600 chars (required)")
     .option("--from <number>", "from number — must be an account-owned Twilio number/agent DID")
     .option("--provider <id>", "smsProviderId UUID")
-    .option("--transport <transport>", "twilio (default) | project_blue — send from your assigned Project Blue iPhone line (iMessage when the lead is on Apple, SMS otherwise)")
+    .option("--transport <transport>", "twilio (default) | project_blue — your assigned Project Blue iPhone line (iMessage when the lead is on Apple, SMS otherwise) | whatsapp — the account's WhatsApp sender (free-form only within 24 hours of the lead's last WhatsApp message, else an approved template via --whatsapp-template)")
+    .option("--whatsapp-template <sid>", "transport whatsapp: an APPROVED template (Twilio Content SID HX…, see `whatsapp templates`); Conduyt reads it from Twilio at send time and records its text with the variables in place")
+    .option("--whatsapp-variables <json>", 'transport whatsapp with a template: placeholder number → value as JSON, e.g. {"1":"Alex"}')
     .option("--idempotency-key <key>", "operation key (8-200 chars) for at-most-once sends: reuse the SAME key when retrying a send whose outcome you did not see")
     .option("--json <json>", "full JSON body, merged over the flags")
     .action(run(async (client, opts) => {
@@ -828,6 +856,10 @@ messages
         body.smsProviderId = opts.provider;
     if (opts.transport !== undefined)
         body.transport = opts.transport;
+    if (opts.whatsappTemplate !== undefined)
+        body.whatsappContentSid = opts.whatsappTemplate;
+    if (opts.whatsappVariables !== undefined)
+        body.whatsappContentVariables = jsonArg(opts.whatsappVariables, "--whatsapp-variables");
     if (opts.idempotencyKey !== undefined)
         body.idempotencyKey = opts.idempotencyKey;
     if (opts.json !== undefined)
@@ -1805,6 +1837,23 @@ program
 }));
 // ---- dialer ----
 const dialer = program.command("dialer").description("Dialer operations");
+dialer
+    .command("voice-drop")
+    .description("Place a voice drop to a contact (POST /calls/voice-drop): an outbound Twilio call with answering-machine detection that plays one of the account's Voicemail Drop recordings (Settings → Twilio → Voicemail Drop; names from `messages transports` voiceDrop.recordings) when a machine answers, and hangs up quietly when a person answers unless --if-human play. Governed like a call: calls-tier consent (a texting STOP does not block it, a DNC or litigator row does), calling hours, one live call per lead. Placed from your own Twilio line (else the account number) unless --from names a number the account owns. Returns 202 with the Call row; the outcome lands on it through the voice webhooks (disposition voicemail_drop = played to a machine, voice_drop_human = a person answered, voice_drop_live = played to a person). Refusals carry a code (dnc, litigator, calling_window, active_call, voice_drop_recording_missing, voice_drop_not_configured); 429 and 502 are safe to retry (dialer scope)")
+    .requiredOption("--contact <id>", "contact UUID (the drop calls the contact's primary number)")
+    .option("--recording <name>", "a Voicemail Drop template name; omit for the default recording")
+    .option("--from <number>", "caller ID the account owns (E.164); omit for your own line")
+    .option("--if-human <rule>", "hang_up (default) | play — what the call does when a person answers")
+    .action(run(async (client, opts) => {
+    const body = { contactId: opts.contact };
+    if (opts.recording !== undefined)
+        body.recording = opts.recording;
+    if (opts.from !== undefined)
+        body.fromNumber = opts.from;
+    if (opts.ifHuman !== undefined)
+        body.onHuman = opts.ifHuman;
+    return client.post("/api/v1/calls/voice-drop", body);
+}));
 dialer
     .command("sync-local-presence")
     .description("Reconcile the Local Presence pool from Twilio. Only adopts numbers whose Twilio FriendlyName contains a standalone 'LP' (or 'LocalPres'), that are voice-capable, and that are US +1 E.164 — first 50 sorted matches; pool entries that no longer match are REMOVED. Name the number in Twilio first, then sync. Requires settings:edit")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conduyt",
-  "version": "1.36.0",
+  "version": "1.38.0",
   "description": "Command-line interface for Conduyt CRM — manage contacts, deals, pipelines, and run insight queries from your terminal.",
   "type": "module",
   "main": "dist/index.js",