conduyt 1.41.0 → 1.43.0

package/dist/index.js

@@ -180,6 +180,123 @@ contacts
     return client.del(`/api/v1/contacts/${encodeURIComponent(id)}`);
 }));
 // ---- deals ----
+contacts
+    .command("delete-matching")
+    .description("Soft-delete EVERY contact a list filter matches, across pages (#73): the contacts page's \"Select all N matching\" action. Give the same filter you would give `contacts list` (or --filter with a JSON object of list query parameters) plus --expected, the total that filter showed; the server re-counts and refuses (409) when the set moved, so you never delete rows you did not look at. Contacts with an upcoming appointment are kept and reported. The command repeats the call until the server reports done. Requires contacts:delete.")
+    .option("--search <text>", "free-text search")
+    .option("--tag <name>", "one tag")
+    .option("--tags <names>", "comma-separated tags")
+    .option("--source <source>", "lead source")
+    .option("--assigned-to <userId>", "assignee user id")
+    .option("--smart-view <id>", "Smart View id")
+    .option("--smart-list <id>", "Smart List id")
+    .option("--import-id <id>", "import job id")
+    .option("--master-status <statuses>", "comma-separated lead statuses to include")
+    .option("--filter <json>", "a JSON object of list query parameters (merged over the flags above)")
+    .requiredOption("--expected <n>", "the total the list showed for this filter")
+    .option("--yes", "skip the typed confirmation (scripts)")
+    .action(run(async (client, opts) => {
+    const filter = {};
+    if (typeof opts.search === "string")
+        filter.search = opts.search;
+    if (typeof opts.tag === "string")
+        filter.tag = opts.tag;
+    if (typeof opts.tags === "string")
+        filter.tags = opts.tags;
+    if (typeof opts.source === "string")
+        filter.source = opts.source;
+    if (typeof opts.assignedTo === "string")
+        filter.assigned_to = opts.assignedTo;
+    if (typeof opts.smartView === "string")
+        filter.smart_view = opts.smartView;
+    if (typeof opts.smartList === "string")
+        filter.smartListId = opts.smartList;
+    if (typeof opts.importId === "string")
+        filter.import_id = opts.importId;
+    if (typeof opts.masterStatus === "string")
+        filter.master_status = opts.masterStatus.split(",").map((s) => s.trim()).filter(Boolean);
+    if (typeof opts.filter === "string") {
+        let parsed;
+        try {
+            parsed = JSON.parse(opts.filter);
+        }
+        catch {
+            throw new Error("--filter must be a JSON object of list query parameters.");
+        }
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+            throw new Error("--filter must be a JSON object of list query parameters.");
+        for (const [k, v] of Object.entries(parsed)) {
+            if (typeof v === "string" || (Array.isArray(v) && v.every((x) => typeof x === "string")))
+                filter[k] = v;
+            else
+                throw new Error(`--filter.${k} must be a string or an array of strings.`);
+        }
+    }
+    const hasValue = Object.values(filter).some((v) => (Array.isArray(v) ? v.some((x) => x.trim()) : v.trim()));
+    if (!hasValue)
+        throw new Error("Narrow the delete with at least one filter value; deleting every contact is not a bulk action.");
+    const expected = Number(opts.expected);
+    if (!Number.isInteger(expected) || expected < 1)
+        throw new Error("--expected must be the positive whole number the list showed for this filter.");
+    if (!opts.yes) {
+        const { createInterface } = await import("node:readline/promises");
+        const rl = createInterface({ input: process.stdin, output: process.stderr });
+        const answer = (await rl.question(`Delete all ${expected} contacts matching this filter? Type the number ${expected} to confirm: `)).trim();
+        rl.close();
+        if (answer !== String(expected))
+            throw new Error("Cancelled: the typed number did not match.");
+    }
+    // The first call freezes the set on the server (409 when the count moved or when shared rows are not
+    // yours to delete); every later pass sends back the ids the server returned, never the filter again.
+    let body = { filter, expectedTotal: expected };
+    let deleted = 0;
+    let skipped = 0;
+    let kept = 0;
+    let last = {};
+    // A continuation that fails for a retryable reason (429 honouring retryAfter, a 5xx, a network error) is
+    // retried with the SAME ids so committed progress is never stranded.
+    const postWithRetry = async (payload) => {
+        for (let attempt = 0;; attempt++) {
+            try {
+                return (await client.post("/api/v1/bulk/contacts/delete-matching", payload));
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                const status = Number(/^Conduyt API (\d{3})/.exec(msg)?.[1] ?? 0);
+                const retryable = "ids" in payload && (status === 429 || status >= 500 || status === 0);
+                if (!retryable || attempt >= 5)
+                    throw err;
+                const retryAfter = Number(/"retryAfter":(\d+)/.exec(msg)?.[1] ?? 0);
+                await new Promise((r) => setTimeout(r, status === 429 ? Math.max(5, Math.min(60, retryAfter)) * 1000 : 2000 * (attempt + 1)));
+            }
+        }
+    };
+    for (let pass = 0; pass < 200; pass++) {
+        const res = await postWithRetry(body);
+        const d = (res?.data ?? res);
+        last = d;
+        deleted += Number(d.deleted ?? 0);
+        skipped += Number(d.skipped ?? 0);
+        kept += Number(d.keptWithAppointments ?? 0);
+        const remainingIds = Array.isArray(d.remainingIds) ? d.remainingIds : [];
+        if (d.done || remainingIds.length === 0)
+            break;
+        if (!d.busy && Number(d.deleted ?? 0) === 0)
+            break;
+        if (d.busy)
+            await new Promise((r) => setTimeout(r, 1500));
+        body = { ids: remainingIds, continuation: d.continuation ?? null };
+    }
+    const remaining = Number(last.remaining ?? 0);
+    return {
+        deleted,
+        skipped,
+        keptWithAppointments: kept,
+        done: last.done === true,
+        remaining,
+        ...(remaining > 0 ? { note: "the run stopped before finishing; run the same command again (with the new --expected) to delete the rest" } : {}),
+    };
+}));
 const deals = program.command("deals").description("Manage deals");
 deals
     .command("list")
@@ -1877,6 +1994,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 +2128,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 +2203,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 +2215,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 +2247,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 +2271,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 +2292,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 +2320,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.43.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",