conduyt 1.79.0 → 1.81.0

package/README.md

@@ -42,8 +42,12 @@ conduyt contacts collaborators add <contactId> <userId> [--expected-revision <n>
 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 messages <channelId> [--limit 1-100] [--cursor <messageId> | --after-seq <n>]   # newest first; --after-seq = only messages committed after that seq (catch-up read, never with --cursor); each message also carries `version`; 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 chat realtime-token [--channel <id>]...   # GET /realtime/token: signed Ably token request (up to 10 --channel); { enabled: false, reason } when the account switch is off; prints accountId / userId
+conduyt chat notifications <channelId>   # GET .../notifications: { level, isDefault, notify, updatedAt, membershipId, membershipSince, membershipSeq }
+conduyt chat set-notifications <channelId> --level all|mentions|mute|default --expected-updated-at <iso|none> --expected-membership-id <id> --account-id <id> --user-id <id>   # compare-and-set, sent once; 409 stale prints the current membership and exits 1
+conduyt chat settings [--realtime on|off] [--presence on|off] [--quiet-hours HH:MM-HH:MM|none] [--digest-minutes 0|15-240]   # PATCH /settings teamChat, owner/admin only
 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
@@ -66,6 +70,7 @@ conduyt status-metadata list --stage-id <id>   # the status codes + buckets atta
 conduyt status-metadata import --file rows.json --mode replace   # set-based import (max 1000; an item key outside stageId, code, bucket, lifecycleStage, dripEligible, dripTrackName, isTerminal, notes is refused before any request); per-item errors print and exit 1; `--mode replace` with no items is refused unless `--confirm-empty-replace` (it deletes every row). Timeouts: archive 75 s, import and the Mailchimp write / action commands 60 s; on a timeout the server may have applied it, so read the state first
 conduyt integrations mailchimp settings  # the Mailchimp audience sync (API key scope integrations); `set | audiences | push | retry-unsubscribes | reconcile-statuses [--restart] | confirm-reconciliation`. Connecting is browser-only (OAuth): do it in the app
 conduyt pipelines update <id> --automation-only true   # only automations, API keys and owners / admins move or edit its cards (owner / admin key); also --color <palette hex> and --sort-order
+conduyt automations dry-run <id> [--contact <id>] [--deal <id>] [--company <id>] [--execution <id>]   # preview one trigger occurrence without side effects; --deal for a deal occurrence, --company for a company occurrence, --execution (admin or owner only) replays a stored run of this automation and supplies the company its payload carried; no test-node command exists in this CLI
 conduyt search "acme corp"              # search across the CRM
 conduyt insights summary                # run an AI insight query
 conduyt insights saved_report --report "Lead Activity" --period last_7_days   # run any saved report as a tool

package/dist/index.js

@@ -2541,18 +2541,33 @@ automations
 }));
 automations
     .command("dry-run <id>")
-    .description("Test a workflow without side effects")
+    .description("Test a workflow without side effects. A deal occurrence needs --deal and a company occurrence needs --company. --execution (admin or owner only) replays a stored run of this automation and supplies ONE fact, the company carried by that run's payload (same account, automation, trigger event, contact and deal as the preview; runs carrying a deal are hidden from API keys without the deals scope); without it, on a non-company occurrence, the preview is a synthetic sample and company rules evaluate as unknown/absent, which the response says")
     .option("--contact <id>", "run against this contact UUID")
     .option("--appointment <id>", "seed with this appointment UUID")
+    .option("--deal <id>", "the event's deal UUID: REQUIRED for a deal occurrence (400 without it), 404 for a deal you cannot see, refused (400) on any other occurrence")
+    .option("--company <id>", "the event's company UUID: REQUIRED for a company occurrence (400 without it); on any other occurrence accepted only when it equals the company the --execution payload carries")
+    .option("--execution <id>", "UUID of a stored run of THIS automation to replay (admin or owner only); supplies the company its payload carried, nothing else; it does not replace --company on a company occurrence")
     .option("--source <source>", "draft | published (default draft)")
     .option("--mode <mode>", "single | all-paths (default single)")
     .action(run(async (client, id, opts) => {
     assertUuid(id, "automation id");
+    if (opts.deal !== undefined)
+        assertUuid(opts.deal, "--deal");
+    if (opts.company !== undefined)
+        assertUuid(opts.company, "--company");
+    if (opts.execution !== undefined)
+        assertUuid(opts.execution, "--execution");
     const body = {};
     if (opts.contact !== undefined)
         body.contactId = opts.contact;
     if (opts.appointment !== undefined)
         body.appointmentId = opts.appointment;
+    if (opts.deal !== undefined)
+        body.dealId = opts.deal.trim();
+    if (opts.company !== undefined)
+        body.companyId = opts.company.trim();
+    if (opts.execution !== undefined)
+        body.executionId = opts.execution.trim();
     return client.post(`/api/v1/automations/${encodeURIComponent(id)}/dry-run${buildQuery({ source: opts.source, mode: opts.mode })}`, body);
 }));
 automations
@@ -3922,7 +3937,7 @@ ai
     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");
+const chat = program.command("chat").description("Team chat: unread vector, messages (each carries `seq` and `version`), read acknowledgement, realtime token, per-channel notification level, Team Chat 2.0 settings");
 /** 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);
@@ -3942,23 +3957,27 @@ async function withChatMembership(client, 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'")
+    .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'. Team Chat 2.0 rows also carry mentionCount (unread @mentions of you), notify (your stored level: all, mentions, mute, or null = default), updatedAt (when notify last changed, null = never), membershipId, membershipSince and membershipSeq")
     .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")
+    .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. Team Chat 2.0 adds per row mentions (unread @mentions of you), notify, updatedAt, membershipId (null = no membership row), membershipSince and membershipSeq, and per response teamChatRealtime (the account's realtime switch) and membershipSeqHigh. 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)")
+    .description("List a channel's messages, newest first (GET /chat/channels/{id}/messages); every message carries `seq`, its commit-ordered position in the channel. Every message also carries `version`, a server counter bumped on every update (edit, delete, reaction, pin, claim, handoff). 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)")
+    .option("--after-seq <n>", "only messages committed after this seq (the realtime catch-up read), a whole number 0-999999999; given once, never with --cursor; hasMore then means more follow this page (re-read the latest page)")
     .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;
+    const afterSeq = opts.afterSeq !== undefined ? intFlag(opts.afterSeq, "--after-seq", 0, 999_999_999) : undefined;
+    if (afterSeq !== undefined && cursor !== undefined)
+        throw new Error("--after-seq and --cursor cannot be combined.");
     // 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 })}`));
+    return withChatMembership(client, () => client.get(`/api/v1/chat/channels/${encodeURIComponent(channelId)}/messages${buildQuery({ limit, cursor, afterSeq })}`));
 }));
 chat
     .command("mark-read <channelId> <messageId>")
@@ -3968,6 +3987,83 @@ chat
     const readUpTo = uuidOf(messageId, "message id");
     return withChatMembership(client, () => client.get(`/api/v1/chat/channels/${encodeURIComponent(channelId)}/messages${buildQuery({ limit: 1, readUpTo })}`));
 }));
+chat
+    .command("realtime-token")
+    .description("GET /realtime/token: a signed Ably token request for the Team Chat 2.0 realtime pipe, scoped to your user channel, the presence channel (only with realtimePresence on) and the chat channels you belong to (the 100 most recently active, plus any --channel). Prints { enabled: true, tokenRequest, accountId, userId, channels, presence, expiresAt }, or { enabled: false, reason } when the account switch (settings.teamChat.realtime) is off or the provider is unconfigured. accountId and userId are what `chat set-notifications` needs. The token is short-lived: do not log it. Errors exit 1 with the status and message: 403 'Not an active member of this account', 400 'channel must be a channel id', 429 'Too many token requests'")
+    .option("--channel <channelId>", "a channel to include, repeatable up to 10 times (each a UUID; sent as repeated channel=)", (v, prev = []) => [...prev, v])
+    .action(run(async (client, opts) => {
+    const ids = (opts.channel ?? []).map((c) => uuidOf(c, "--channel"));
+    if (ids.length > 10)
+        throw new Error("--channel may be given at most 10 times.");
+    const qs = new URLSearchParams();
+    for (const id of ids)
+        qs.append("channel", id);
+    return client.get(`/api/v1/realtime/token${qs.size > 0 ? `?${qs}` : ""}`);
+}));
+chat
+    .command("notifications <channelId>")
+    .description("GET /chat/channels/{id}/notifications: your notification level for one channel. Prints { level, isDefault, notify, updatedAt, membershipId, membershipSince, membershipSeq }: level is the effective level (all = every message pushes, mentions = only @mentions of you, mute = nothing but a direct @mention), notify the STORED value (null = the kind's default), updatedAt its version (null = never set). `chat set-notifications` needs updatedAt and membershipId. Members only: a 403 'Not a member of this channel' is retried ONCE after GET /chat/channels, like the other reads")
+    .action(run(async (client, channelId) => {
+    assertUuid(channelId, "channel id");
+    return withChatMembership(client, () => client.get(`/api/v1/chat/channels/${encodeURIComponent(channelId)}/notifications`));
+}));
+chat
+    .command("set-notifications <channelId>")
+    .description("PATCH /chat/channels/{id}/notifications: set your notification level, compare-and-set against what you last read (run `chat notifications` first). --level all|mentions|mute|default (default = the kind's default); --expected-updated-at <iso|none> is the updatedAt you read (none = it was null); --expected-membership-id the membershipId you read; --account-id and --user-id are yours (from `chat realtime-token`; another person's are refused 403 identity_mismatch). Sent once, never retried. Every refusal exits 1 with the status, the API's message and its code: 409 stale prints the CURRENT membership ({ code: stale, current: { notify, updatedAt, membershipId, membershipSince, membershipSeq } }; a different membershipId means you were removed and re-added; nothing was changed), 404 not_a_member, 403 identity_mismatch or 'Not a member of this channel', 400 for a bad level, expectedUpdatedAt or expectedMembershipId. Takes effect only while the account's realtime switch is on")
+    .requiredOption("--level <level>", "all, mentions, mute or default")
+    .requiredOption("--expected-updated-at <iso|none>", "the updatedAt you last read (an ISO date), or none when it was null")
+    .requiredOption("--expected-membership-id <id>", "the membershipId you last read (a UUID)")
+    .requiredOption("--account-id <id>", "your account id (a UUID)")
+    .requiredOption("--user-id <id>", "your user id (a UUID)")
+    .action(run(async (client, channelId, opts) => {
+    assertUuid(channelId, "channel id");
+    const level = opts.level.trim().toLowerCase();
+    if (!["all", "mentions", "mute", "default"].includes(level))
+        throw new Error(`--level takes all, mentions, mute or default (got '${opts.level}').`);
+    const raw = opts.expectedUpdatedAt.trim();
+    if (raw.toLowerCase() !== "none" && Number.isNaN(Date.parse(raw)))
+        throw new Error(`--expected-updated-at takes the updatedAt you read (an ISO date) or none (got '${opts.expectedUpdatedAt}').`);
+    return client.patch(`/api/v1/chat/channels/${encodeURIComponent(channelId)}/notifications`, {
+        level,
+        expectedUpdatedAt: raw.toLowerCase() === "none" ? null : raw,
+        expectedMembershipId: uuidOf(opts.expectedMembershipId, "--expected-membership-id"),
+        accountId: uuidOf(opts.accountId, "--account-id"),
+        userId: uuidOf(opts.userId, "--user-id"),
+    });
+}));
+chat
+    .command("settings")
+    .description("Change the account's Team Chat 2.0 settings (PATCH /settings, settings.teamChat). OWNER / ADMIN ONLY (403 forbidden 'Only an owner or admin can change Team Chat realtime delivery'). Pass at least one: --realtime on|off (instant delivery over the realtime pipe; off = the chat polls; account default off), --presence on|off (online/away over the pipe; needs realtime), --quiet-hours <HH:MM-HH:MM|none> (account timezone; the end may be earlier than the start to cross midnight; needs realtime), --digest-minutes <0|15-240> (missed-message email digest window, 0 = off, default 30; needs realtime). Sends the settings revision it read; a 409 re-reads once, then exits 1 with the current settings. 422 names an invalid field")
+    .option("--realtime <on|off>", "Team Chat realtime delivery")
+    .option("--presence <on|off>", "realtime presence (needs realtime)")
+    .option("--quiet-hours <window>", "HH:MM-HH:MM in the account timezone, or none")
+    .option("--digest-minutes <n>", "0 (off) or 15-240")
+    .action(run(async (client, opts) => {
+    const teamChat = {};
+    if (opts.realtime !== undefined)
+        teamChat.realtime = onOffArg(opts.realtime, "--realtime");
+    if (opts.presence !== undefined)
+        teamChat.realtimePresence = onOffArg(opts.presence, "--presence");
+    if (opts.quietHours !== undefined) {
+        const w = opts.quietHours.trim();
+        const m = /^(([01]\d|2[0-3]):[0-5]\d)-(([01]\d|2[0-3]):[0-5]\d)$/.exec(w);
+        if (w.toLowerCase() === "none")
+            teamChat.quietHours = null;
+        else if (m)
+            teamChat.quietHours = { start: m[1], end: m[3] };
+        else
+            throw new Error(`--quiet-hours takes HH:MM-HH:MM (24-hour) or none (got '${opts.quietHours}').`);
+    }
+    if (opts.digestMinutes !== undefined) {
+        const n = intFlag(opts.digestMinutes, "--digest-minutes", 0, 240);
+        if (n !== 0 && n < 15)
+            throw new Error("--digest-minutes is 0 (off) or 15-240.");
+        teamChat.digestMinutes = n;
+    }
+    if (Object.keys(teamChat).length === 0)
+        throw new Error("nothing to change: pass at least one of --realtime, --presence, --quiet-hours, --digest-minutes");
+    return patchGeneralSettings(client, { teamChat });
+}));
 // ---- notifications (read side; meta.latestByType, app 10-09) ----
 const notifications = program.command("notifications").description("Your in-app notifications");
 notifications

package/package.json

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