conduyt 1.11.0 → 1.14.0

package/dist/client.js

@@ -50,6 +50,9 @@ export class ConduytClient {
     patch(path, body) {
         return this.request("PATCH", path, body);
     }
+    put(path, body) {
+        return this.request("PUT", path, body);
+    }
     del(path) {
         return this.request("DELETE", path);
     }

package/dist/index.js

@@ -81,6 +81,7 @@ contacts
     .option("--last <name>", "last name")
     .option("--email <email>", "email")
     .option("--phone <phone>", "phone")
+    .option("--timezone <iana>", "IANA timezone of the lead (e.g. America/Chicago); omit to let Conduyt derive it from ZIP → phone area code → state. On update pass '' to clear the override")
     .option("--company <company>", "company name (auto-creates/links a company)")
     .option("--source <source>", "lead source (first-write-wins acquisition truth)")
     .option("--master-status <status>", "lead lifecycle status: open|won|lost|abandoned|disqualified or an account custom (terminal statuses silence all outbound automation)")
@@ -95,6 +96,8 @@ contacts
         body.email = opts.email;
     if (opts.phone !== undefined)
         body.phone = opts.phone;
+    if (opts.timezone !== undefined)
+        body.timezone = opts.timezone === "" ? null : opts.timezone;
     if (opts.company !== undefined)
         body.company = opts.company;
     if (opts.source !== undefined) {
@@ -123,6 +126,7 @@ contacts
     .option("--last <name>", "last name")
     .option("--email <email>", "email")
     .option("--phone <phone>", "phone")
+    .option("--timezone <iana>", "IANA timezone of the lead (e.g. America/Chicago); omit to let Conduyt derive it from ZIP → phone area code → state. On update pass '' to clear the override")
     .option("--company <company>", "company name (auto-creates/links a company; pass '' to clear)")
     .option("--source <source>", "correct the lead's first-touch source (normally set once at creation — update only to fix bad attribution; pass 'null' to clear)")
     .option("--master-status <status>", "lead lifecycle status: open|won|lost|abandoned|disqualified or an account custom (terminal statuses silence all outbound automation)")
@@ -138,6 +142,8 @@ contacts
         body.email = opts.email;
     if (opts.phone !== undefined)
         body.phone = opts.phone;
+    if (opts.timezone !== undefined)
+        body.timezone = opts.timezone === "" ? null : opts.timezone;
     if (opts.company !== undefined)
         body.company = opts.company;
     if (opts.source !== undefined) {
@@ -769,11 +775,13 @@ messages
 }));
 messages
     .command("send-sms")
-    .description("Send an outbound SMS via Twilio (POST /messages/sms/send)")
+    .description("Send an outbound SMS (POST /messages/sms/send) — via Twilio, or from your own Project Blue iPhone line with --transport project_blue")
     .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 — send from your assigned Project Blue iPhone line (iMessage when the lead is on Apple, SMS otherwise)")
+    .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) => {
     const body = {};
@@ -785,6 +793,10 @@ messages
         body.fromNumber = opts.from;
     if (opts.provider !== undefined)
         body.smsProviderId = opts.provider;
+    if (opts.transport !== undefined)
+        body.transport = opts.transport;
+    if (opts.idempotencyKey !== undefined)
+        body.idempotencyKey = opts.idempotencyKey;
     if (opts.json !== undefined)
         Object.assign(body, jsonArg(opts.json, "--json"));
     return client.post("/api/v1/messages/sms/send", body);
@@ -972,6 +984,10 @@ automations
     .command("schema")
     .description("Get the node/field/operator schema catalog (node types, action rules, graph shape)")
     .action(run(async (client) => client.get("/api/v1/automations/schema")));
+automations
+    .command("events")
+    .description("List trigger events with their labels, payload fields and documented scalar conditions (e.g. contact.untouched → untouchedDays: 1-365)")
+    .action(run(async (client) => client.get("/api/v1/automations/events")));
 automations
     .command("resolve")
     .description("Resolve human-readable names to UUIDs. Pass comma lists via flags and/or a full JSON body")
@@ -1827,6 +1843,34 @@ lifecycle
         throw new Error(`Invalid status name '${bad}' — 1-40 chars; letters, numbers, spaces, - and _ only.`);
     return client.patch("/api/v1/settings", { masterStatuses: clean });
 }));
+// ---- 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"];
+lifecycle
+    .command("get-contact-columns")
+    .description("Show the account-level DEFAULT COLUMNS for the Contacts list (every user gets them merged into their own layout on their next visit; each version once). null = no account default.")
+    .action(run(async (client) => {
+    const result = (await client.get("/api/v1/settings"));
+    const raw = result?.data?.contactTableDefaults;
+    return { data: raw && typeof raw === "object" ? raw : null, columnIds: [...CONTACT_COLUMN_IDS, "custom:<fieldKey>"] };
+}));
+lifecycle
+    .command("set-contact-columns [ids...]")
+    .description("Set the account-level DEFAULT COLUMNS for the Contacts list (settings scope). Every user's saved layout gains the ids it lacks on their next visit (appended; nothing moves); the version bumps only when the set changes. Ids: the standard column ids or custom:<fieldKey>; up to 10. --clear removes the default.")
+    .option("--clear", "remove the account default (users keep what they already show)")
+    .action(run(async (client, ids, opts) => {
+    ids = ids ?? [];
+    if (ids.length === 0 && !opts.clear)
+        throw new Error("Pass at least one column id, or --clear to remove the account default.");
+    if (ids.length > 0 && opts.clear)
+        throw new Error("--clear cannot be combined with column ids.");
+    const clean = ids.map((s) => s.trim());
+    if (clean.length > 8)
+        throw new Error("At most 8 default columns (the table keeps its two anchors).");
+    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 } });
+}));
 // ---- call flows + ring groups (#25 tri-surface parity, 2026-08-23) ----
 // IVR routing graphs and their companion ring sets. Settings-scoped at the
 // API-key boundary (same tier as the rest of the Twilio setup surface): a
@@ -1845,7 +1889,7 @@ callFlows
     .command("create <name>")
     .description("Create a call flow (starts as a DRAFT)")
     .option("--phone-number <e164>", "account number this flow answers")
-    .option("--graph <json>", "initial flow graph (node/edge JSON)")
+    .option("--graph <json>", "initial flow graph (node/edge JSON) Kinds: entry, greeting, agent, group (queue.repeatRing = queue mode), menu (options[{digit,label,next}]), function (functionId, timeoutSeconds 2-8, next/failNext), set_attributes (assignments[{key,value}]), branch (attribute, op, value, next/elseNext), timing (hours, timezone, next/closedNext), voicemail, forward, hangup; every branch must reach an ending.")
     .action(run(async (client, name, opts) => {
     const body = { name };
     if (opts.phoneNumber !== undefined)
@@ -1859,7 +1903,7 @@ callFlows
     .description("Update the DRAFT (published behavior changes only on the next publish)")
     .option("--name <name>", "new name")
     .option("--phone-number <e164>", "new number")
-    .option("--graph <json>", "replacement draft graph (node/edge JSON) — REQUIRES --expected-draft-revision")
+    .option("--graph <json>", "replacement draft graph (node/edge JSON) — REQUIRES --expected-draft-revision. Kinds: entry, greeting, agent, group (queue.repeatRing = queue mode), menu (options[{digit,label,next}]), function (functionId, timeoutSeconds 2-8, next/failNext), set_attributes (assignments[{key,value}]), branch (attribute, op, value, next/elseNext), timing (hours, timezone, next/closedNext), voicemail, forward, hangup; every branch must reach an ending")
     .option("--expected-draft-revision <n>", "draftRevision from your last `call-flows get` read (REQUIRED with --graph; the API 428s without it — it is graph-specific, so calls/publish never invalidate it)")
     .action(run(async (client, id, opts) => {
     assertUuid(id, "call flow id");
@@ -1916,6 +1960,46 @@ callFlows
     .command("simulate <id>")
     .description('"If someone calls right now, who picks up?" — DRAFT graph vs LIVE availability, no side effects')
     .action(run(async (client, id) => { assertUuid(id, "call flow id"); return client.post(`/api/v1/call-flows/${encodeURIComponent(id)}/simulate`, {}); }));
+// #32 Call Flows function endpoints (Amazon Connect "Invoke Lambda" parity): the
+// HTTPS endpoints a flow's "Call a function" step may invoke mid-call.
+const callFlowFunctions = callFlows.command("functions").description("Function endpoints a \"Call a function\" step can invoke mid-call (settings scope; admin to change)");
+callFlowFunctions
+    .command("list")
+    .description("List the account's function endpoints")
+    .action(run(async (client) => client.get("/api/v1/call-flows/functions")));
+callFlowFunctions
+    .command("create <name>")
+    .description("Register a function endpoint. Conduyt POSTs a signed JSON call snapshot (X-Conduyt-Signature = sha256 HMAC of `${timestamp}.${body}`, X-Conduyt-Timestamp, Idempotency-Key); reply 200 with a JSON object — top-level strings/numbers/booleans become call attributes. https + public host only, no redirects, 2-8 s timeout")
+    .requiredOption("--url <https-url>", "HTTPS endpoint (ports 443/8443)")
+    .requiredOption("--secret <secret>", "HMAC signing secret (16-200 chars) the endpoint verifies with")
+    .action(run(async (client, name, opts) => client.post("/api/v1/call-flows/functions", { name, url: opts.url, secret: opts.secret })));
+callFlowFunctions
+    .command("update <id>")
+    .description("Rename, change the URL, or rotate the secret")
+    .option("--name <name>", "new name")
+    .option("--url <https-url>", "new HTTPS endpoint")
+    .option("--secret <secret>", "new signing secret (rotation)")
+    .action(run(async (client, id, opts) => {
+    assertUuid(id, "function id");
+    const body = {};
+    if (opts.name !== undefined)
+        body.name = opts.name;
+    if (opts.url !== undefined)
+        body.url = opts.url;
+    if (opts.secret !== undefined)
+        body.secret = opts.secret;
+    if (Object.keys(body).length === 0)
+        throw new Error("Nothing to update. Pass at least one flag.");
+    return client.patch(`/api/v1/call-flows/functions/${encodeURIComponent(id)}`, body);
+}));
+callFlowFunctions
+    .command("delete <id>")
+    .description("Remove a function endpoint (409 while a PUBLISHED flow still calls it)")
+    .action(run(async (client, id) => { assertUuid(id, "function id"); return client.del(`/api/v1/call-flows/functions/${encodeURIComponent(id)}`); }));
+callFlowFunctions
+    .command("test <id>")
+    .description("Send a real signed test call (callSid TEST, sample caller) and report status, latency and the attributes it would save")
+    .action(run(async (client, id) => { assertUuid(id, "function id"); return client.post(`/api/v1/call-flows/functions/${encodeURIComponent(id)}/test`, {}); }));
 callFlows
     .command("roster")
     .description("Routing roster: members with DIDs + live availability")
@@ -2026,6 +2110,104 @@ ringGroups
     }
     return client.post("/api/v1/ring-groups/release-number", body);
 }));
+// ---------------------------------------------------------------------------
+// Smart Views + Smart Dialing (#53). The dial-enabled Smart Views are the
+// Smart Dialing priorities: agents dial them one lead at a time, top to
+// bottom. Dialing settings + reorder are admin-only in the API.
+// ---------------------------------------------------------------------------
+const smartViews = program.command("smart-views").description("Smart Views and their Smart Dialing priorities");
+smartViews
+    .command("list")
+    .description("List Smart Views in sidebar order (= Smart Dialing priority) with lead counts and dialing settings")
+    .option("--dialing", "only the dial-enabled views (the Smart Dialing priorities)")
+    .action(run(async (client, opts) => {
+    const views = (await client.get("/api/v1/smart-views"));
+    const rows = Array.isArray(views) ? views : [];
+    const sorted = [...rows].sort((a, b) => Number(a.sortPosition ?? 0) - Number(b.sortPosition ?? 0));
+    return opts.dialing ? sorted.filter((v) => v.dialEnabled === true) : sorted;
+}));
+smartViews
+    .command("dialing <id>")
+    .description("Change one Smart View's Smart Dialing settings (PATCH — only the flags you pass change)")
+    .option("--enable", "make this view a Smart Dialing priority")
+    .option("--disable", "stop dialing this view")
+    .option("--max-attempts <n>", "stop after N calls to a lead, ever (1-20)")
+    .option("--per-day <n>", "most calls to one lead per account-local day (1-20); pass 'none' to remove the daily cap")
+    .option("--cooldown <minutes>", "minutes to wait between calls to the same lead (0-10080)")
+    .option("--schedule <json>", 'retry schedule JSON, e.g. \'[{"attemptNumber":1,"delayMinutes":0},{"attemptNumber":2,"delayMinutes":60}]\'')
+    .action(run(async (client, id, opts) => {
+    assertUuid(id, "smart view id");
+    if (opts.enable && opts.disable)
+        throw new Error("Pass --enable or --disable, not both.");
+    const body = {};
+    if (opts.enable)
+        body.dialEnabled = true;
+    if (opts.disable)
+        body.dialEnabled = false;
+    const intFlag = (raw, flag, min, max) => {
+        if (raw === undefined)
+            return undefined;
+        const n = Number(raw);
+        if (!Number.isInteger(n) || n < min || n > max)
+            throw new Error(`${flag} must be an integer between ${min} and ${max}.`);
+        return n;
+    };
+    const maxAttempts = intFlag(opts.maxAttempts, "--max-attempts", 1, 20);
+    if (maxAttempts !== undefined)
+        body.maxDialAttempts = maxAttempts;
+    if (opts.perDay !== undefined) {
+        body.maxDialAttemptsPerDay = opts.perDay.trim().toLowerCase() === "none" ? null : intFlag(opts.perDay, "--per-day", 1, 20);
+    }
+    const cooldown = intFlag(opts.cooldown, "--cooldown", 0, 10080);
+    if (cooldown !== undefined)
+        body.dialCooldownMinutes = cooldown;
+    if (opts.schedule !== undefined) {
+        let parsed;
+        try {
+            parsed = JSON.parse(opts.schedule);
+        }
+        catch {
+            throw new Error("--schedule must be valid JSON.");
+        }
+        if (!Array.isArray(parsed) || parsed.length === 0 || parsed.length > 20)
+            throw new Error("--schedule must be a JSON array of 1-20 steps.");
+        for (const step of parsed) {
+            if (!step || !Number.isInteger(step.attemptNumber) || Number(step.attemptNumber) < 1 || !Number.isInteger(step.delayMinutes) || Number(step.delayMinutes) < 0) {
+                throw new Error("Each --schedule step needs attemptNumber (>= 1) and delayMinutes (>= 0).");
+            }
+        }
+        body.dialSchedule = parsed;
+    }
+    if (Object.keys(body).length === 0)
+        throw new Error("Nothing to change. Pass --enable/--disable, --max-attempts, --per-day, --cooldown or --schedule.");
+    return client.patch(`/api/v1/smart-views/${encodeURIComponent(id)}`, body);
+}));
+smartViews
+    .command("dial-order [ids...]")
+    .description("No ids: show the Smart Dialing priorities, uncapped (every dial-enabled view in dial order + candidates). With ids: set the priority order — every dial-enabled view id, first = dialed first (the server keeps non-priority views in their slots)")
+    .action(run(async (client, ids) => {
+    if (!ids || ids.length === 0)
+        return client.get("/api/v1/smart-views/dial-order");
+    if (ids.length > 2000)
+        throw new Error("Pass at most 2000 Smart View ids.");
+    if (new Set(ids).size !== ids.length)
+        throw new Error("Smart View ids must not repeat.");
+    for (const id of ids)
+        assertUuid(id, "smart view id");
+    return client.patch("/api/v1/smart-views/dial-order", { order: ids });
+}));
+smartViews
+    .command("reorder <ids...>")
+    .description("Set the SIDEBAR order of Smart Views. Pass EVERY view id; views left out keep a stale position. For the dialing priority use dial-order")
+    .action(run(async (client, ids) => {
+    if (ids.length === 0 || ids.length > 200)
+        throw new Error("Pass 1-200 Smart View ids.");
+    if (new Set(ids).size !== ids.length)
+        throw new Error("Smart View ids must not repeat.");
+    for (const id of ids)
+        assertUuid(id, "smart view id");
+    return client.patch("/api/v1/smart-views/reorder", { order: ids });
+}));
 program.parseAsync(process.argv).catch(fail);
 // helpers
 // Parse a --json / --stages style argument, throwing a clear CLI error (caught
@@ -2064,6 +2246,44 @@ function assertFiniteValue(v) {
 // The path is also URL-encoded at the call site as defence in depth. The regex
 // is inlined (not a module-level const) so it isn't in the temporal dead zone
 // when an action callback runs during program.parse().
+const projectBlue = program.command("project-blue").description("Project Blue: dedicated iPhone lines (iMessage/SMS + FaceTime Audio), one line per agent (settings scope)");
+projectBlue
+    .command("status")
+    .description("Connection status (key masked) + current line assignments")
+    .action(run(async (client) => client.get("/api/v1/settings/project-blue")));
+projectBlue
+    .command("connect")
+    .description("Connect or replace the account's Project Blue API key — verified with the vendor before it is stored")
+    .option("--key <apiKey>", "Project Blue API key (proj_…); omit to read PROJECT_BLUE_API_KEY from the environment and keep the key out of shell history")
+    .action(run(async (client, opts) => {
+    const apiKey = (opts.key ?? process.env.PROJECT_BLUE_API_KEY ?? "").trim();
+    if (!apiKey)
+        throw new Error("Pass --key or set PROJECT_BLUE_API_KEY.");
+    return client.put("/api/v1/settings/project-blue", { apiKey });
+}));
+projectBlue
+    .command("disconnect")
+    .description("Forget the API key and release every agent's line")
+    .action(run(async (client) => client.del("/api/v1/settings/project-blue")));
+projectBlue
+    .command("lines")
+    .description("LIVE line inventory from the vendor with each line's assigned agent, plus assignments the vendor no longer lists (orphaned)")
+    .action(run(async (client) => client.get("/api/v1/settings/project-blue/lines")));
+projectBlue
+    .command("assign <lineId> <userId>")
+    .description("Give a line to an agent (one line per agent, one agent per line — prior holders are released and reported)")
+    .action(run(async (client, lineId, userId) => {
+    assertUuid(lineId, "line id");
+    assertUuid(userId, "user id");
+    return client.put(`/api/v1/settings/project-blue/lines/${encodeURIComponent(lineId)}`, { userId });
+}));
+projectBlue
+    .command("release <lineId>")
+    .description("Release a line from whoever holds it")
+    .action(run(async (client, lineId) => {
+    assertUuid(lineId, "line id");
+    return client.put(`/api/v1/settings/project-blue/lines/${encodeURIComponent(lineId)}`, { userId: null });
+}));
 function assertUuid(id, label = "id") {
     const uuidRe = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
     if (!uuidRe.test(id.trim())) {

package/package.json

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