conduyt 1.41.0 → 1.42.0

package/dist/index.js

@@ -1877,6 +1877,65 @@ program
 }));
 // ---- dialer ----
 const dialer = program.command("dialer").description("Dialer operations");
+// ---- curated agent statuses (#71, 2026-09-15) ----
+const AGENT_STATUS_CODES = ["available", "break", "lunch", "meeting", "training", "offline"];
+const FIXED_AGENT_STATUS_CODES = ["available", "offline"];
+const MAX_AGENT_STATUS_LABEL = 24;
+function agentStatusCodeArg(raw) {
+    const code = raw.trim().toLowerCase();
+    if (!AGENT_STATUS_CODES.includes(code))
+        throw new Error(`'${raw}' is not a dialer status — one of ${AGENT_STATUS_CODES.join(", ")}.`);
+    return code;
+}
+async function readAgentStatusesConfig(client) {
+    const current = (await client.get("/api/v1/settings"));
+    const stored = current?.data?.agentStatuses ?? {};
+    const labels = Object.fromEntries(Object.entries(stored.labels ?? {}).filter((e) => typeof e[1] === "string"));
+    const hidden = Array.isArray(stored.hidden) ? stored.hidden.filter((c) => typeof c === "string") : [];
+    return { labels, hidden };
+}
+dialer
+    .command("statuses")
+    .description("List the account's curated dialer statuses (GET /dialer/agent-statuses): Available, Break, Lunch, Meeting, Training, Offline. Each carries a FIXED basis the dialer runs on (available = takes inbound calls and Smart Dialing hand-outs; break = signed in, not ringable; offline = signed out), the label reps see, and whether admins hid it from the softphone menu. Rename with `dialer rename-status`, hide/show with `dialer hide-status` / `dialer show-status`; Available and Offline can never be hidden. Reports bucket by basis.")
+    .action(run(async (client) => client.get("/api/v1/dialer/agent-statuses")));
+dialer
+    .command("rename-status <code> <label>")
+    .description(`Rename a curated dialer status for this account (settings scope): e.g. \`rename-status break "Short break"\`. Pass \`default\` as the label to restore the built-in name. Labels are 1–${MAX_AGENT_STATUS_LABEL} characters; two visible statuses cannot share a label (422). Codes: ${AGENT_STATUS_CODES.join(", ")}. The other labels and the hidden list stay as they are.`)
+    .action(run(async (client, codeRaw, labelRaw) => {
+    const code = agentStatusCodeArg(codeRaw);
+    const label = labelRaw.trim();
+    if (!label)
+        throw new Error("The label must not be blank; pass 'default' to restore the built-in name.");
+    if (label.length > MAX_AGENT_STATUS_LABEL)
+        throw new Error(`Labels are at most ${MAX_AGENT_STATUS_LABEL} characters.`);
+    const next = await readAgentStatusesConfig(client);
+    if (label.toLowerCase() === "default")
+        delete next.labels[code];
+    else
+        next.labels[code] = label;
+    return patchGeneralSettings(client, { agentStatuses: next });
+}));
+dialer
+    .command("hide-status <code>")
+    .description(`Hide a curated dialer status from the softphone menu (settings scope). Available and Offline cannot be hidden; a rep already on a hidden status keeps it until they change. Codes: ${AGENT_STATUS_CODES.join(", ")}.`)
+    .action(run(async (client, codeRaw) => {
+    const code = agentStatusCodeArg(codeRaw);
+    if (FIXED_AGENT_STATUS_CODES.includes(code))
+        throw new Error(`'${code}' cannot be hidden — every rep needs it.`);
+    const next = await readAgentStatusesConfig(client);
+    if (!next.hidden.includes(code))
+        next.hidden.push(code);
+    return patchGeneralSettings(client, { agentStatuses: next });
+}));
+dialer
+    .command("show-status <code>")
+    .description(`Put a hidden curated dialer status back in the softphone menu (settings scope). Codes: ${AGENT_STATUS_CODES.join(", ")}.`)
+    .action(run(async (client, codeRaw) => {
+    const code = agentStatusCodeArg(codeRaw);
+    const next = await readAgentStatusesConfig(client);
+    next.hidden = next.hidden.filter((c) => c !== code);
+    return patchGeneralSettings(client, { agentStatuses: next });
+}));
 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)")
@@ -1952,6 +2011,26 @@ replyCapture
     return client.del("/api/v1/email-domains/reply-capture");
 }));
 // ---- lifecycle (master lead status + intake deals) ----
+// ---- general settings writes (09-15) ----
+// PATCH /api/v1/settings refuses a general-settings change without the settingsRevision the editor loaded
+// (400 expected_settings_revision_required) and answers 409 when another save landed first. Every general
+// write below reads the revision first and sends it; a 409 is re-raised with the current settings so the
+// caller re-derives the change instead of overwriting a newer save.
+async function patchGeneralSettings(client, body) {
+    const read = async () => (await client.get("/api/v1/settings"));
+    const before = await read();
+    const expectedSettingsRevision = typeof before?.data?.settingsRevision === "string" ? before.data.settingsRevision : null;
+    try {
+        return await client.patch("/api/v1/settings", { ...body, ...(expectedSettingsRevision ? { expectedSettingsRevision } : {}) });
+    }
+    catch (err) {
+        if (err instanceof Error && /^Conduyt API 409/.test(err.message)) {
+            const current = await read();
+            throw new Error(`${err.message} — the account settings changed since revision ${expectedSettingsRevision ?? "?"} was read; re-run the command (current: ${JSON.stringify(current?.data ?? null).slice(0, 1500)})`);
+        }
+        throw err;
+    }
+}
 const lifecycle = program
     .command("lifecycle")
     .description("Lifecycle settings: lead master statuses, intake-deal creation, how the tenant works leads, and lost propagation");
@@ -2007,7 +2086,7 @@ lifecycle
     .action(run(async (client, mode) => {
     if (mode !== "pipeline" && mode !== "status")
         throw new Error("mode must be 'pipeline' or 'status'.");
-    return client.patch("/api/v1/settings", { dealWorkingMode: mode });
+    return patchGeneralSettings(client, { dealWorkingMode: mode });
 }));
 lifecycle
     .command("set-lost-propagation")
@@ -2019,7 +2098,7 @@ lifecycle
         throw new Error("Pass either --enable or --disable, not both.");
     if (opts.enable === undefined && opts.disable === undefined)
         throw new Error("Pass --enable or --disable.");
-    return client.patch("/api/v1/settings", { lostPropagation: { enabled: Boolean(opts.enable) } });
+    return patchGeneralSettings(client, { lostPropagation: { enabled: Boolean(opts.enable) } });
 }));
 lifecycle
     .command("set-intake-deals")
@@ -2051,7 +2130,7 @@ lifecycle
         }
         body.reInbound = opts.reInbound;
     }
-    return client.patch("/api/v1/settings", { intakeDeals: body });
+    return patchGeneralSettings(client, { intakeDeals: body });
 }));
 lifecycle
     .command("set-master-statuses [statuses...]")
@@ -2075,7 +2154,7 @@ lifecycle
     const bad = clean.find((s) => s.length > 40 || !/^[a-z0-9][a-z0-9 _-]*$/i.test(s));
     if (bad)
         throw new Error(`Invalid status name '${bad}' — 1-40 chars; letters, numbers, spaces, - and _ only.`);
-    return client.patch("/api/v1/settings", { masterStatuses: clean });
+    return patchGeneralSettings(client, { masterStatuses: clean });
 }));
 lifecycle
     .command("set-disposition-status <disposition> <status>")
@@ -2096,7 +2175,7 @@ lifecycle
         delete next[d];
     else
         next[d] = st;
-    return client.patch("/api/v1/settings", { callDispositions: { statusMap: next } });
+    return patchGeneralSettings(client, { callDispositions: { statusMap: next } });
 }));
 // ---- account default columns for the Contacts list (tri-surface parity, 2026-09-03) ----
 const CONTACT_COLUMN_IDS = ["name", "email", "phone", "company", "source", "tags", "score", "intent", "stage", "createdAt", "lastActivity", "assignedTo", "address", "city", "state", "zip"];
@@ -2124,7 +2203,10 @@ lifecycle
     const bad = clean.find((id) => !CONTACT_COLUMN_IDS.includes(id) && !/^custom:[A-Za-z0-9_][A-Za-z0-9_.-]{0,99}$/.test(id));
     if (bad)
         throw new Error(`Unknown column id '${bad}' — one of ${CONTACT_COLUMN_IDS.join(", ")} or custom:<fieldKey>.`);
-    return client.patch("/api/v1/settings", { contactTableDefaults: { columns: clean } });
+    // the defaults row carries its own revision token ("0" before the first save); the API refuses the write without it
+    const current = (await client.get("/api/v1/settings"));
+    const rev = current?.data?.contactTableDefaults?.revision;
+    return client.patch("/api/v1/settings", { contactTableDefaults: { columns: clean, expectedRevision: typeof rev === "string" && rev ? rev : "0" } });
 }));
 // ---- call flows + ring groups (#25 tri-surface parity, 2026-08-23) ----
 // IVR routing graphs and their companion ring sets. Settings-scoped at the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conduyt",
-  "version": "1.41.0",
+  "version": "1.42.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",