conduyt 1.62.0 → 1.64.0

package/README.md

@@ -32,7 +32,15 @@ The saved config lives at `~/.conduyt/config.json` and is written owner-only (`c
 ```bash
 conduyt whoami                          # show the authenticated user
 conduyt contacts list --limit 25        # list contacts (supports --cursor, --query)
-conduyt contacts get <id>               # fetch one contact
+conduyt contacts get <id>               # fetch one contact (carries `revision`)
+conduyt contacts update <id> --first Ann --expected-revision <n>   # PATCH; a contact changed since revision n is refused: 409 contact_changed, exit 1, code and current revision printed
+conduyt contacts collaborators add <contactId> <userId> [--expected-revision <n>]      # POST /contacts/{id}/collaborators; prints { added, revision }
+conduyt contacts collaborators remove <contactId> <userId> [--expected-revision <n>]   # DELETE with a body; prints { removed, revision }; 404 when not a collaborator
+conduyt chat channels                   # GET /chat/channels: your channels; also CREATES your auto-channel memberships the first time
+conduyt chat unread                     # GET /chat/unread: per channel { channelId, unread, soundUnread, newestSeq, latestSeq }
+conduyt chat messages <channelId> [--limit 1-100] [--cursor <messageId>]   # newest first; prints { data, hasMore, nextCursor }; every message carries `seq`; does not move the read marker; a 403 "Not a member of this channel" is retried once after `chat channels`
+conduyt chat mark-read <channelId> <messageId>   # readUpTo: marker moves to that message's seq, forward only (older or foreign message = no-op, exit 0); prints the channel's newest message; same one-retry membership bootstrap
+conduyt notifications list [--page n] [--per-page 1-200]   # prints { data, meta }: meta.latestByType = { type: { latest, count } } over the last 24 h, next to unreadCount / unreadByType
 conduyt deals list --pipeline <id>      # list deals
 conduyt deals list --health-summary --pipeline <id>   # Pipeline health strip for the filtered set (totalOpenDeals, atRiskValue, checks[]); add --health-check stale --health-limit 20 for one check's deals, --health-cursor <nextCursor> to page, --health-rows-only for just the page
 conduyt deals health --pipeline <id> --check needs_action   # GET /deals/inspection: the six checks over open deals; --check adds its deals, --cursor/--offset pages

package/dist/client.js

@@ -57,7 +57,14 @@ export class ConduytClient {
             // STAGE_REQUIREMENTS 422 carries lostReasonOptions) keep the context —
             // same principle as `structured` above, bounded against huge bodies.
             if (json && typeof json === "object" && json.error) {
-                const extras = Object.fromEntries(Object.entries(json).filter(([k]) => k !== "error"));
+                // Scalars first (code, revision), nested objects last: a 409 contact_changed also carries the whole current
+                // `contact`, and the bound below may cut that, never the code or the current revision.
+                const isScalar = (v) => v === null || typeof v !== "object";
+                const entries = Object.entries(json).filter(([k]) => k !== "error");
+                const extras = Object.fromEntries([
+                    ...entries.filter(([, v]) => isScalar(v)),
+                    ...entries.filter(([, v]) => !isScalar(v)),
+                ]);
                 if (Object.keys(extras).length > 0) {
                     msg = `${msg} ${JSON.stringify(extras).slice(0, 1000)}`;
                 }
@@ -78,8 +85,9 @@ export class ConduytClient {
     put(path, body, opts) {
         return this.request("PUT", path, body, opts);
     }
-    del(path) {
-        return this.request("DELETE", path);
+    /** `body` is for the few DELETE routes that take one (contact collaborators with an --expected-revision pin). */
+    del(path, body) {
+        return this.request("DELETE", path, body);
     }
     /** A POST whose body comes back as text (a CSV or XLSX export), not JSON. */
     async postText(path, body) {

package/dist/index.js

@@ -9,6 +9,8 @@ import { splitList, stageRulePatch, validateCardFields, validateRuleChange } fro
 import { ARCHIVE_PIPELINE_TIMEOUT_MS, MAILCHIMP_ADMIN_TIMEOUT_MS, STATUS_METADATA_IMPORT_TIMEOUT_MS, PIPELINE_COLORS, boolFlag, intFlag, isoDate, lifecycleStage as lifecycleStageArg, MAX_PIPELINE_ROT_DAYS, MIN_PIPELINE_ROT_DAYS, pipelineColor, settingsRevision, slug as slugArg, uuid as uuidOf, uuidList, validateImportItems, validateStatusMetadataBody } from "./pipeline-settings.js";
 import { saveConfig, resolveConfig, configPath } from "./config.js";
 import { print, fail, unwrap } from "./output.js";
+/** the contact save revision bound (catalog: integer 0..2147483647) */
+const CONTACT_REVISION_MAX = 2147483647;
 // Exit cleanly when a downstream pipe closes early (e.g. `conduyt deals list |
 // head`). Without this, the stdout write after the reader is gone throws an
 // unhandled EPIPE and prints a Node stack trace — broken-pipe is normal Unix
@@ -77,7 +79,7 @@ contacts
     .action(run(async (client, opts) => client.get(`/api/v1/contacts${buildQuery({ limit: opts.limit, cursor: opts.cursor, query: opts.query, master_status: opts.masterStatus, exclude_master_status: opts.excludeMasterStatus })}`)));
 contacts
     .command("get <id>")
-    .description("Get a single contact by id")
+    .description("Get a single contact by id (includes `revision`: pass it as --expected-revision on `contacts update` / `contacts collaborators`)")
     .action(run(async (client, id) => client.get(`/api/v1/contacts/${encodeURIComponent(id)}`)));
 contacts
     .command("create")
@@ -135,10 +137,13 @@ contacts
     .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)")
+    .option("--expected-revision <n>", "the contact's `revision` as you read it (contacts get / list; 0-2147483647): a contact changed since is refused with 409 contact_changed, nothing is written, exit 1 with the code and the current revision printed")
     .option("--json <json>", "full JSON body, merged over the flags above (for any field)")
     .action(run(async (client, id, opts) => {
     assertUuid(id, "contact id");
     const body = {};
+    if (opts.expectedRevision !== undefined)
+        body.expectedRevision = intFlag(opts.expectedRevision, "--expected-revision", 0, CONTACT_REVISION_MAX);
     if (opts.first !== undefined)
         body.firstName = opts.first;
     if (opts.last !== undefined)
@@ -175,6 +180,25 @@ contacts
     assertContactSource(body.source, { allowNull: true });
     return client.patch(`/api/v1/contacts/${encodeURIComponent(id)}`, body);
 }));
+const collaborators = contacts.command("collaborators").description("Team members collaborating on a contact");
+for (const [verb, method] of [["add", "post"], ["remove", "del"]]) {
+    collaborators
+        .command(`${verb} <contactId> <userId>`)
+        .description(verb === "add"
+        ? "Add a team member as a collaborator (POST /contacts/{id}/collaborators; needs edit authority). Prints { added, revision } with the contact's NEW revision. A stale --expected-revision is 409 contact_changed (exit 1, code and current revision printed); 409 without a code: already a collaborator"
+        : "Remove a collaborator (DELETE /contacts/{id}/collaborators with a body; needs edit authority). Prints { removed, revision } with the contact's NEW revision. A stale --expected-revision is 409 contact_changed (exit 1, code and current revision printed); 404 when the user is not a collaborator")
+        .option("--expected-revision <n>", "the contact's `revision` as you read it (0-2147483647); omit for no pin")
+        .action(run(async (client, contactId, userId, opts) => {
+        assertUuid(contactId, "contact id");
+        if (userId.trim() === "")
+            throw new Error("userId must not be blank.");
+        const body = { userId };
+        if (opts.expectedRevision !== undefined)
+            body.expectedRevision = intFlag(opts.expectedRevision, "--expected-revision", 0, CONTACT_REVISION_MAX);
+        const path = `/api/v1/contacts/${encodeURIComponent(contactId)}/collaborators`;
+        return method === "post" ? client.post(path, body) : client.del(path, body);
+    }));
+}
 contacts
     .command("delete <id>")
     .description("Delete a contact by id (soft-delete; retained for audit, the contact's deals are unaffected)")
@@ -3265,6 +3289,66 @@ ai
         Object.assign(body, jsonArg(opts.json, "--json"));
     return client.post("/api/v1/ai/enrich-contact", body);
 }));
+// ---- team chat (app 10-09, live sha 3869c79ba) ----
+const chat = program.command("chat").description("Team chat: unread vector, messages (each carries `seq`), read acknowledgement");
+/** The messages route's membership refusal (403 "Not a member of this channel"); any other 403 (a permission) is not this one. */
+function isMembershipRefusal(err) {
+    return err instanceof Error && /\b403\b/.test(err.message) && /Not a member of this channel/.test(err.message);
+}
+/** `chat unread` lists AUTO channels the caller has no membership row in yet; the messages route answers 403 for them until GET /chat/channels
+ *  creates it. On that one refusal: call /chat/channels ONCE, retry ONCE. A second refusal, or a 403 for any other reason, is the caller's. */
+async function withChatMembership(client, read) {
+    try {
+        return await read();
+    }
+    catch (err) {
+        if (!isMembershipRefusal(err))
+            throw err;
+        await client.get("/api/v1/chat/channels");
+        return read();
+    }
+}
+chat
+    .command("channels")
+    .description("GET /chat/channels: your channels (id, name, kind, members, last message). SIDE EFFECT: also creates your memberships in the account's auto channels (needs-a-hand, new-leads, wins) the first time. `chat messages` and `chat mark-read` do this once for you on a 403 'Not a member of this channel'")
+    .action(run(async (client) => client.get("/api/v1/chat/channels")));
+chat
+    .command("unread")
+    .description("GET /chat/unread: per channel { channelId, unread, soundUnread, newestSeq, latestSeq }; a row can be an AUTO channel you have not opened yet (no membership row: reading it first answers 403, which `chat messages` / `chat mark-read` recover from once). unread is the badge count (auto channels 0 by design); soundUnread counts every channel; newestSeq = seq of the newest message not written by you (null = none), latestSeq the same including panic cards. Read-only")
+    .action(run(async (client) => client.get("/api/v1/chat/unread")));
+chat
+    .command("messages <channelId>")
+    .description("List a channel's messages, newest first (GET /chat/channels/{id}/messages); every message carries `seq`, its commit-ordered position in the channel. Prints { data, hasMore, nextCursor }. Needs channel membership (else 403). Does NOT move your read marker: use `chat mark-read`. On a 403 'Not a member of this channel' it calls GET /chat/channels once and retries ONCE (a second refusal or any other 403 exits 1 as is)")
+    .option("--limit <n>", "messages per page, 1-100 (default 50)")
+    .option("--cursor <messageId>", "nextCursor from the previous page (a message UUID)")
+    .action(run(async (client, channelId, opts) => {
+    assertUuid(channelId, "channel id");
+    const limit = opts.limit !== undefined ? intFlag(opts.limit, "--limit", 1, 100) : undefined;
+    const cursor = opts.cursor !== undefined ? uuidOf(opts.cursor, "--cursor") : undefined;
+    // the live route answers { data: { data, hasMore, nextCursor } }: print() unwraps the outer envelope, leaving { data, hasMore, nextCursor }
+    return withChatMembership(client, () => client.get(`/api/v1/chat/channels/${encodeURIComponent(channelId)}/messages${buildQuery({ limit, cursor })}`));
+}));
+chat
+    .command("mark-read <channelId> <messageId>")
+    .description("Acknowledge the channel as read up to one message you were served (GET /chat/channels/{id}/messages?readUpTo=<messageId>&limit=1). The marker moves to that message's seq and only FORWARD: an older message, or one outside this channel, is a no-op (still exit 0: re-check `chat unread`); a malformed id is refused here; a 403 'Not a member of this channel' is retried ONCE after GET /chat/channels (a second refusal or any other 403 exits 1). Prints the channel's newest message, not a confirmation of the move")
+    .action(run(async (client, channelId, messageId) => {
+    assertUuid(channelId, "channel id");
+    const readUpTo = uuidOf(messageId, "message id");
+    return withChatMembership(client, () => client.get(`/api/v1/chat/channels/${encodeURIComponent(channelId)}/messages${buildQuery({ limit: 1, readUpTo })}`));
+}));
+// ---- notifications (read side; meta.latestByType, app 10-09) ----
+const notifications = program.command("notifications").description("Your in-app notifications");
+notifications
+    .command("list")
+    .description("List your notifications (GET /notifications). Prints { data, meta } whole: meta carries page, per_page, total, unreadCount, unreadByType { type: n } and latestByType { type: { latest, count } } (per type over the last 24 h: newest createdAt as an ISO string and the row count, read state ignored)")
+    .option("--page <n>", "page number (default 1)")
+    .option("--per-page <n>", "results per page, 1-200 (default 50)")
+    .action(run(async (client, opts) => {
+    const page = opts.page !== undefined ? intFlag(opts.page, "--page", 1, 1_000_000) : undefined;
+    const per_page = opts.perPage !== undefined ? intFlag(opts.perPage, "--per-page", 1, 200) : undefined;
+    // the live route answers { data: { data, meta } }: print() unwraps the outer envelope, leaving { data, meta }
+    return client.get(`/api/v1/notifications${buildQuery({ page, per_page })}`);
+}));
 // ---- raw escape hatch ----
 program
     .command("api <method> <path>")

package/package.json

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