conduyt 1.37.0 → 1.39.0

package/README.md

@@ -45,6 +45,7 @@ conduyt whatsapp status                 # WhatsApp via your Twilio: connected? f
 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

package/dist/index.js

@@ -804,8 +804,45 @@ 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}, WhatsApp {connected, sender for smsMode whatsapp}, 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 {connected, lines = the workspace's send-ready lines, valid fromkPhoneNumberId values for smsMode fromk} (automations scope)")
     .action(run(async (client) => client.get("/api/v1/sms/transports")));
+// ---- FromK.ai (2026-09-14): Conduyt's own texting platform as a native transport ----
+const fromk = program.command("fromk").description("FromK.ai: text through your FromK.ai workspace (its lines, credits, consent and STOP rules); Conduyt drives it with the workspace's API key (settings scope)");
+fromk
+    .command("status")
+    .description("Connection status (GET /settings/fromk): key masked, the lines snapshot with sendReady, the webhook URL to paste into FromK.ai and whether its signing secret is stored")
+    .action(run(async (client) => client.get("/api/v1/settings/fromk")));
+fromk
+    .command("connect")
+    .description("Connect or replace the workspace API key (fk_…, numbers:read + contacts:write + messages:send) — verified with FromK.ai before it is stored")
+    .option("--key <apiKey>", "FromK.ai workspace API key; omit to read FROMK_API_KEY from the environment and keep the key out of shell history")
+    .action(run(async (client, opts) => {
+    const apiKey = (opts.key ?? process.env.FROMK_API_KEY ?? "").trim();
+    if (!apiKey)
+        throw new Error("Pass --key or set FROMK_API_KEY.");
+    return client.put("/api/v1/settings/fromk", { apiKey });
+}));
+fromk
+    .command("disconnect")
+    .description("Forget the key, the signing secret, the lines and every contact link; FromK.ai workflow steps stop sending")
+    .action(run(async (client) => client.del("/api/v1/settings/fromk")));
+fromk
+    .command("lines")
+    .description("Refresh the line list from the workspace and store it as the new snapshot: each send-ready phoneNumberId is a valid --fromk-line / fromkPhoneNumberId")
+    .action(run(async (client) => client.get("/api/v1/settings/fromk/lines")));
+fromk
+    .command("webhook-secret")
+    .description("Store the signing secret of the FromK.ai webhook endpoint pointed at Conduyt (whsec_…); --clear forgets it")
+    .option("--secret <secret>", "the endpoint's signing secret; omit to read FROMK_WEBHOOK_SECRET from the environment")
+    .option("--clear", "forget the stored secret")
+    .action(run(async (client, opts) => {
+    if (opts.clear)
+        return client.del("/api/v1/settings/fromk/webhook");
+    const secret = (opts.secret ?? process.env.FROMK_WEBHOOK_SECRET ?? "").trim();
+    if (!secret)
+        throw new Error("Pass --secret or set FROMK_WEBHOOK_SECRET (or --clear).");
+    return client.put("/api/v1/settings/fromk/webhook", { secret });
+}));
 // ---- 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
@@ -834,12 +871,13 @@ whatsapp
     .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")
+    .description("Send an outbound SMS (POST /messages/sms/send) — via Twilio, from your own Project Blue iPhone line (--transport project_blue), on WhatsApp (--transport whatsapp) or through your FromK.ai workspace (--transport fromk)")
     .option("--contact <id>", "contact UUID (required)")
     .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 — 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("--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) | fromk — through your FromK.ai workspace (Settings → FromK.ai), from --fromk-line or the workspace's single send-ready line")
+    .option("--fromk-line <phoneNumberId>", "transport fromk: the FromK.ai line to send from (a send-ready phoneNumberId from `fromk status`); omit when the workspace has one send-ready line")
     .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")
@@ -860,6 +898,8 @@ messages
         body.whatsappContentSid = opts.whatsappTemplate;
     if (opts.whatsappVariables !== undefined)
         body.whatsappContentVariables = jsonArg(opts.whatsappVariables, "--whatsapp-variables");
+    if (opts.fromkLine !== undefined)
+        body.fromkPhoneNumberId = opts.fromkLine;
     if (opts.idempotencyKey !== undefined)
         body.idempotencyKey = opts.idempotencyKey;
     if (opts.json !== undefined)
@@ -1837,6 +1877,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.37.0",
+  "version": "1.39.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",