@curviate/cli 0.54.0 → 0.56.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/CHANGELOG.md +57 -0
  2. package/README.md +35 -17
  3. package/dist/{account-DW5N5MJ6.js → account-ZF5NEMID.js} +132 -125
  4. package/dist/{analytics-T2K3OWVQ.js → analytics-M7JWS67A.js} +5 -5
  5. package/dist/{beta-consent-O736ONE7.js → beta-consent-4Q2LZZQC.js} +4 -4
  6. package/dist/{billing-NTBL32EX.js → billing-LYPSX5SR.js} +78 -6
  7. package/dist/{chunk-N76WNJ5T.js → chunk-7PLTQHNO.js} +1 -1
  8. package/dist/{chunk-N4IYTFIY.js → chunk-AMTKGO37.js} +1 -1
  9. package/dist/{chunk-ACKKHLUH.js → chunk-CRO7PJ4I.js} +2 -2
  10. package/dist/chunk-DENWYJK2.js +94 -0
  11. package/dist/{chunk-FBLCSVIU.js → chunk-EI64VFBE.js} +47 -47
  12. package/dist/{chunk-ENBIMEKS.js → chunk-IB6ARI3R.js} +1 -1
  13. package/dist/{chunk-Q57PZJLX.js → chunk-J4SFOFMT.js} +90 -88
  14. package/dist/{chunk-FUX3BRYP.js → chunk-JXDEV33Z.js} +1 -1
  15. package/dist/{chunk-5B4T6BMN.js → chunk-L3RJU7C3.js} +44 -44
  16. package/dist/{chunk-KXJJFHSD.js → chunk-MIOEYSBQ.js} +1 -1
  17. package/dist/{chunk-R4HS2MWM.js → chunk-MWVTFTWV.js} +15 -13
  18. package/dist/{chunk-QW5K5DTC.js → chunk-RDKTHFQ6.js} +25 -6
  19. package/dist/{chunk-62YAYAUI.js → chunk-RKNW4UX4.js} +51 -9
  20. package/dist/{chunk-V3HHYTBY.js → chunk-UOWOKEB2.js} +1 -1
  21. package/dist/{chunk-HOMRAZ6S.js → chunk-UWRWZG4N.js} +2 -2
  22. package/dist/{chunk-A3UNS44U.js → chunk-VEMK4MJM.js} +10 -10
  23. package/dist/{chunk-UFHT2KZG.js → chunk-XP6S6E55.js} +2 -2
  24. package/dist/cli.js +33 -25
  25. package/dist/{comment-ATVJOTWV.js → comment-D6RSZTVK.js} +8 -8
  26. package/dist/{company-BRKFROPE.js → company-3Z6PXGTW.js} +11 -11
  27. package/dist/{config-E223SS5K.js → config-VY5MCJMN.js} +2 -2
  28. package/dist/{connect-XVDQ5FTT.js → connect-G2RTLV7G.js} +15 -15
  29. package/dist/{contact-4HOUOVD7.js → contact-QSLJCBDE.js} +8 -8
  30. package/dist/{contact-groups-ENA3VGGL.js → contact-groups-OITAD73K.js} +85 -85
  31. package/dist/{contact-import-4EKVDFPV.js → contact-import-LT7BKESC.js} +10 -10
  32. package/dist/core-RFTNNB6P.js +46 -0
  33. package/dist/{do-not-contact-S2WGHSQL.js → do-not-contact-ZA7KS5WD.js} +59 -33
  34. package/dist/{doctor-OFIUGRUG.js → doctor-JQT3DO6G.js} +4 -4
  35. package/dist/{document-MDE2WJYX.js → document-H65EXU4L.js} +1 -1
  36. package/dist/domain-7EX4E34B.js +70 -0
  37. package/dist/{draft-DD3DTXBM.js → draft-7U6H4BPF.js} +4 -4
  38. package/dist/{enrollment-ESCHKQ5X.js → enrollment-AZ6XGVVL.js} +40 -38
  39. package/dist/{examples-KAMXHRLE.js → examples-IGQJCSNL.js} +2 -2
  40. package/dist/{exit-codes-CYQHN4NE.js → exit-codes-ZSOLAXQO.js} +1 -1
  41. package/dist/{export-GUAGB7TF.js → export-OYMQXL62.js} +5 -5
  42. package/dist/{feed-ZC4FY4BA.js → feed-M5D4SJW7.js} +6 -6
  43. package/dist/{group-42ZE7K3K.js → group-UTC3YBKE.js} +6 -6
  44. package/dist/{inbox-2YS7CTXH.js → inbox-VSGNHSLG.js} +9 -9
  45. package/dist/{inboxes-5RB3BGCQ.js → inboxes-23C2MJK4.js} +6 -6
  46. package/dist/{incoming-ATZN6JJA.js → incoming-QVPP32K7.js} +13 -13
  47. package/dist/{job-WD3Z3P3Q.js → job-ZHVFFRWE.js} +10 -10
  48. package/dist/{login-JQ57YHEJ.js → login-6OTNXEJZ.js} +4 -4
  49. package/dist/mailbox-HD2UXZCA.js +405 -0
  50. package/dist/{message-WGS2IIDC.js → message-PIV77W47.js} +7 -7
  51. package/dist/{motion-BRVBJJJP.js → motion-AHYF34DP.js} +224 -149
  52. package/dist/{network-CODIWCJQ.js → network-RJHJFZEY.js} +5 -5
  53. package/dist/{notification-RLVF4NLJ.js → notification-XGR4NT3S.js} +6 -6
  54. package/dist/{notifications-HGEHM5KW.js → notifications-BHRWSHPR.js} +6 -6
  55. package/dist/{post-3GH2IPO6.js → post-Z7AVDDKA.js} +8 -8
  56. package/dist/{profile-6RFJQMIB.js → profile-YZNBX2RP.js} +15 -15
  57. package/dist/{recruiter-GK3UNS62.js → recruiter-EXM4P7X7.js} +17 -17
  58. package/dist/{sales-nav-SLS3ABF4.js → sales-nav-CKDSEXV2.js} +15 -15
  59. package/dist/{search-45WRT5T3.js → search-B7FB6674.js} +17 -17
  60. package/dist/{setup-5QZOM2Q2.js → setup-VZVPLJ4V.js} +5 -5
  61. package/dist/{team-WM3RKOQ2.js → team-PYABBUHO.js} +6 -6
  62. package/dist/{tier-5AMLO5KE.js → tier-PRK4WQKR.js} +4 -4
  63. package/dist/{unibox-TTCF7YVO.js → unibox-ZNKX2EKL.js} +34 -34
  64. package/dist/{webhook-UCCCSKDO.js → webhook-V74EV4E2.js} +18 -18
  65. package/package.json +2 -2
  66. package/dist/core-6VDDV2NM.js +0 -46
package/CHANGELOG.md CHANGED
@@ -6,6 +6,63 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
6
6
  Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html):
7
7
  a new command or flag is a minor; a breaking command/flag/exit-code change is a major (before 1.0.0, a minor); a fix is a patch.
8
8
 
9
+ ## [0.56.0] - 2026-11-17
10
+
11
+ Requires `@curviate/sdk` 0.52.0 (exact pin). The vendored OpenAPI fixture is re-copied from the SDK's (server commit `8c675b5b8`); `src/schemas/documents.json` and `commands.json` regenerated.
12
+
13
+ ### Email in Campaigns
14
+
15
+ - **`campaign check <id>`**: the Lead check (Leads without an email address, bounced, on the Do-not-contact list for email only, variables they lack). Stored as `lead_check` on the Campaign.
16
+ - **`campaign start|resume --skip-missing-email`**: start a Campaign with an email step although some Leads have no address (they are never enrolled).
17
+ - Campaign files take `shared_mailbox_ids`, `schedule.min_email_gap_minutes` and `settings.reply_scope` (checked offline against the vendored schema); `campaign lint` runs the email step, per-variable fallbacks (`{{lead.first_name|there}}`), `on_missing` and the changed R17/R19 rules offline through the SDK.
18
+
19
+ ### Campaign parity
20
+
21
+ - **`campaign preview --limit --cursor --all`**: preview pages over every Lead (`next_cursor`); `--all` merges every page into one answer (`--max-pages`, `--page-delay`). `--sample` stays as an alias of `--limit`.
22
+ - `enrollment get|list` print `next_action` as its sentence in human mode; `--json` keeps the object.
23
+ - `campaign lint` checks weighted variants (2 to 5, `weight` 1 to 100) and business-day waits (`5bd`) offline.
24
+
25
+ ### Do-not-contact and Leads
26
+
27
+ - **`do-not-contact add --scope everything|email_only`** and **`do-not-contact import --scope`** (the scope of every row that names none; a CSV with its own `scope` column is refused with the flag). `list` and `get` print `scope` and `how`; `--reason` takes `unsubscribed`.
28
+ - `lead get|list` print `do_not_contact` (`{scope, reason, how, at}` or `null`; `scope: email_only` is "No email").
29
+
30
+ ### Billing (read only)
31
+
32
+ - **`billing quote --seats <n> [--period monthly|annual]`**, **`billing cap`**, **`billing changes`** (paged, `--all`). Owners only. Nothing here buys or cancels.
33
+
34
+ ### Limits
35
+
36
+ - **`account warm-up on --preset gradual|custom --start --step --every`**; help and the summary line describe the day ramp (Gradual: 30% on day 1 to 100% on day 14), and `account link --warm-up` / `account connect-request create --warm-up` help follows.
37
+
38
+ ### Other
39
+
40
+ - Any `--*-stdin=VALUE` (`--password-stdin=`, `--li-at-stdin=`) is refused (exit 2) on every command, `account link` included, before anything is read or sent. A secret typed on a terminal keeps its leading spaces, so a secret typed and the same secret piped are the same bytes.
41
+
42
+ ## [0.55.0] - 2026-11-17
43
+
44
+ Requires `@curviate/sdk` 0.51.0 (exact pin). The vendored OpenAPI fixture is re-copied from the SDK's; `commands.json` regenerated.
45
+
46
+ ### Breaking: Contacts become Leads, Motions become Campaigns
47
+
48
+ - **`curviate lead ...` replaces `curviate contact ...`** (`lead list|get|create|update|delete|import|imports|export|enrich`, `lead lists ...`, `lead tags ...`). `curviate contact` is removed: it answers as an unknown command, no alias.
49
+ - Help, examples and next-call hints say Lead and Lead list; filter `--motion` is `--campaign`; `do-not-contact add --contact` is `--lead`; `account update --save-connections-as-leads` replaces `--save-connections-as-contacts`.
50
+ - Error codes `LEAD_LIMIT_REACHED`, `LEAD_NOT_ENROLLABLE`, `CAMPAIGN_NOT_STARTABLE`, `CAMPAIGN_STATUS_CONFLICT`, `ACCOUNT_NOT_IN_CAMPAIGN` replace the old five.
51
+ - **`curviate campaign ...` replaces `curviate motion ...`** (`campaign list|get|create|update|delete|start|pause|resume|archive|preview|add|remove|init|lint|voice-clip`). `curviate motion` is removed: it answers as an unknown command, no alias. `campaign lint` stays offline.
52
+ - Flags: `--motion` is `--campaign` (`enrollment`, `analytics`, `incoming`, `unibox`), `--motions` is `--campaigns`, `--motion-ids` is `--campaign-ids`, `--contact` is `--lead` (`enrollment`, `analytics events`, `campaign add|remove|preview`), `--source motion` is `--source campaign` (`webhook`), `--view motions` is `--view campaigns`, `--origin motion` is `--origin campaign`.
53
+ - Campaign files and templates: `lead_list_ids`, `settings.accounts_per_lead`, `settings.exclude.other_campaigns`, and `lead.*` conditions; the offline W17 hint says Campaign. Webhook events are `campaign.status_changed` and `campaign.custom_event`.
54
+
55
+ ### Mailboxes, domains and Team email safety
56
+
57
+ - **`mailbox list|get|update|pause|resume|remove`**: your Team's own email Mailboxes. `list` filters by `--state`, `--sends-for` (an Account id, `shared` or `none`) and `--domain`; `update` takes `--sends-for <acc_...|shared>`, `--daily-cap` and `--signature-file` (a path or `-`). A cap above 50 and a signature over 2,000 characters are refused by the API (exit 2, the message names the limit).
58
+ - **`mailbox discover <address>`**: the IMAP and SMTP settings for an address, to confirm with the person before connecting; takes no password.
59
+ - **`mailbox connect <address> --connection google_app_password|google_sign_in|microsoft_sign_in|imap_smtp`** and **`mailbox reconnect <id>`**: create a Connect request and print its link (and the administrator link where the provider needs one). `imap_smtp` takes `--imap-host --imap-port --imap-security --smtp-host --smtp-port --smtp-security`. **`--password-stdin`** (`google_app_password`, `imap_smtp`, and `reconnect`, where on a Google sign-in Mailbox it adds an app password beside the sign-in for warm-up): one line from stdin, not echoed on a terminal, sent only in the request body, never printed or shown by `--preview`; the host checks it before the answer and the Mailbox is connected in that one call, a refused password exits 8 and leaves the request open. There is no flag that takes the password as a value, so it never reaches `ps` or shell history.
60
+ - A piped `--password-stdin` or `--li-at-stdin` now drops trailing whitespace and the newline only (leading and inner spaces are kept, as they belong to a password), and refuses stdin of more than one line (exit 2). This also applies to `account link --password-stdin`. `--password-stdin=VALUE` is refused (exit 2) on `mailbox connect` and `reconnect`; the value is never echoed.
61
+ - **`account connect-request get|cancel`** read and cancel the Mailbox kinds too (`mailbox_id`, `admin_consent_url`, `error_code`).
62
+ - **`domain check <domain> [--now]`**: a sending domain's MX, SPF, DKIM, DMARC and tracking checks as last run, or run now.
63
+ - **`account safety get --team`** and **`account safety update --team --email-default-cap --email-opt-out-scope --email-opt-out-text --email-opt-out-link-text --email-opt-out-link-word`**: the Team's email defaults. `--team` here is the scope switch: bare it names your current Team, with `tnt_...` another of yours. `""` on a text flag restores the shipped default.
64
+ - New exit-code rows for the Mailbox codes: not found 4, a state that forbids it 8, past the allowance or a private Gmail address sent through sign-in 2, an administrator's approval 5; `SPENDING_CAP_REACHED` and `CANCEL_IN_DASHBOARD` 5.
65
+
9
66
  ## [0.54.0] - 2026-11-16
10
67
 
11
68
  ### `tier` stops printing `pending` and `early access`
package/README.md CHANGED
@@ -344,49 +344,50 @@ curviate core draft list --account none --all --json
344
344
 
345
345
  A scheduled post that fails to publish becomes a `failed` Draft with a `failure` code; any `curviate core draft update` on it clears the failure. Failed `outcome_unknown` means the post may be live: check the account's posts before retrying.
346
346
 
347
- ## Motions and Enrollments
347
+ ## Campaigns and Enrollments
348
348
 
349
- A Motion runs one Sequence for the Contacts of your Contact lists, from its sending accounts, paced on a schedule. It is created as a draft and does nothing until you start it. An Enrollment is one Contact in one Motion on one account. Both belong to your team: `--account` is never read from your config for them.
349
+ A Campaign runs one Sequence for the Leads of your Lead lists, from its sending accounts, paced on a schedule. It is created as a draft and does nothing until you start it. An Enrollment is one Lead in one Campaign on one account. Both belong to your team: `--account` is never read from your config for them.
350
350
 
351
- ### 1. From a template to a running Motion
351
+ ### 1. From a template to a running Campaign
352
352
 
353
353
  ```bash
354
- curviate motion init --template connect-and-converse --output motion.json # offline; fill contact_list_ids and account_ids
355
- curviate motion lint --file motion.json # offline: the rules the API applies
356
- curviate motion create --file motion.json --json
357
- curviate motion preview mot_1 --sample 3 --json # rendered messages and the budget projection; spends nothing
358
- curviate motion start mot_1 --json
354
+ curviate campaign init --template connect-and-converse --output campaign.json # offline; fill lead_list_ids and account_ids
355
+ curviate campaign lint --file campaign.json # offline: the rules the API applies
356
+ curviate campaign create --file campaign.json --json
357
+ curviate campaign preview mot_1 --limit 3 --json # rendered messages and the budget projection; spends nothing (--all: every Lead)
358
+ curviate campaign check mot_1 --json # with an email step: the Lead check start needs
359
+ curviate campaign start mot_1 --json # --skip-missing-email: start without the Leads lacking an address
359
360
  ```
360
361
 
361
- `curviate motion lint` prints one line per finding, compiler style, and exits 2 on any error:
362
+ `curviate campaign lint` prints one line per finding, compiler style, and exits 2 on any error:
362
363
 
363
364
  ```text
364
- motion.json:7:32 error R12 pause.wait: must be a duration between 1m and 365d: a number then m, h or d, like 30d. Use a duration between 1m and 365d, for example 1d. -> https://docs.curviate.com/reference/sequence-rules#r12
365
+ campaign.json:7:32 error R12 pause.wait: must be a duration between 1m and 365d: a number then m, h or d, like 30d, or business days from 1bd to 250bd. Use a duration between 1m and 365d, for example 1d. -> https://docs.curviate.com/reference/sequence-rules#r12
365
366
  ```
366
367
 
367
- `curviate motion create` and `curviate motion update` check the same way before anything is sent. `curviate motion get mot_1 --json` prints a file `curviate motion update mot_1 --file -` accepts as is; add `--if-revision <n>` to refuse the save when someone changed the Sequence since you read it.
368
+ `curviate campaign create` and `curviate campaign update` check the same way before anything is sent. `curviate campaign get mot_1 --json` prints a file `curviate campaign update mot_1 --file -` accepts as is; add `--if-revision <n>` to refuse the save when someone changed the Sequence since you read it.
368
369
 
369
370
  ### Voice notes in a Sequence
370
371
 
371
- A `voice.send` step plays an uploaded clip instead of text. Upload the file once, then put its id in the Sequence. Nothing reaches LinkedIn until you start the Motion.
372
+ A `voice.send` step plays an uploaded clip instead of text. Upload the file once, then put its id in the Sequence. Nothing reaches LinkedIn until you start the Campaign.
372
373
 
373
374
  ```bash
374
- curviate motion voice-clip upload intro.mp3 --json # {"id":"vc_...","duration_ms":42010,...}: 1 to 120 s, up to 20 MiB, 100 uploads per Team per 24 hours
375
- curviate motion voice-clip get vc_01J8Z3K9P0Q1R2S3T4V5W6X7Y8
375
+ curviate campaign voice-clip upload intro.mp3 --json # {"id":"vc_...","duration_ms":42010,...}: 1 to 120 s, up to 20 MiB, 100 uploads per Team per 24 hours
376
+ curviate campaign voice-clip get vc_01J8Z3K9P0Q1R2S3T4V5W6X7Y8
376
377
  ```
377
378
 
378
379
  ```json
379
380
  { "id": "voice", "do": "voice.send", "with": { "clip_id": "vc_01J8Z3K9P0Q1R2S3T4V5W6X7Y8", "fallback": "Hi, thanks for connecting." }, "next": "end" }
380
381
  ```
381
382
 
382
- `fallback` is required and has no variables: it is sent as text when the audio cannot go. For A/B, use `variants: [{ "id": "a", "clip_id": "vc_..." }, { "id": "b", "clip_id": "vc_..." }]` with a shared `with.fallback`, and no text. `curviate motion lint` checks the shape (`R13` a malformed `clip_id`, `R19` no `fallback`); a `clip_id` that is not a clip of your Team is refused when the Motion is saved. `VOICE_CLIP_INVALID` (exit 2) names the reason an upload was refused: not audio, unreadable, under 1 or over 120 seconds; a clip is never shortened. Over 20 MiB is `PAYLOAD_TOO_LARGE`; the 101st upload in 24 hours is `RATE_LIMIT_TENANT` (exit 6, `Retry-After`). A clip no Sequence uses is deleted 30 days after its upload.
383
+ `fallback` is required and has no variables: it is sent as text when the audio cannot go. For variants, use `variants: [{ "id": "a", "clip_id": "vc_..." }, { "id": "b", "clip_id": "vc_..." }]` with a shared `with.fallback`, and no text. `curviate campaign lint` checks the shape (`R13` a malformed `clip_id`, `R19` no `fallback`); a `clip_id` that is not a clip of your Team is refused when the Campaign is saved. `VOICE_CLIP_INVALID` (exit 2) names the reason an upload was refused: not audio, unreadable, under 1 or over 120 seconds; a clip is never shortened. Over 20 MiB is `PAYLOAD_TOO_LARGE`; the 101st upload in 24 hours is `RATE_LIMIT_TENANT` (exit 6, `Retry-After`). A clip no Sequence uses is deleted 30 days after its upload.
383
384
 
384
385
  ### 2. Find and fix Enrollments
385
386
 
386
387
  ```bash
387
- curviate enrollment list --motion mot_1 --done-step opener --outcome failed --json
388
+ curviate enrollment list --campaign mot_1 --done-step opener --outcome failed --json
388
389
  curviate enrollment retry enr_1 --json # only a failed Step; waits for the re-run and prints its outcome
389
- curviate enrollment bulk --action retry --motion mot_1 --done-step opener --outcome failed --json
390
+ curviate enrollment bulk --action retry --campaign mot_1 --done-step opener --outcome failed --json
390
391
  curviate enrollment pause enr_1 --json
391
392
  curviate enrollment resume enr_1 --json # lifts your pause
392
393
  ```
@@ -628,6 +629,23 @@ curviate core recruiter jobs --account acc_1 --limit 10 --json \
628
629
  curviate core recruiter job get "https://www.linkedin.com/jobs/view/4428113858" --account acc_1 --json
629
630
  ```
630
631
 
632
+ ## Mailboxes and email safety
633
+
634
+ ```bash
635
+ curviate mailbox list --state paused # your Team's own email Mailboxes
636
+ curviate mailbox update mbx_... --sends-for acc_... --daily-cap 40 --signature-file signature.txt
637
+ curviate mailbox pause mbx_... # resume, remove likewise
638
+ curviate mailbox discover anna@acme.example # IMAP and SMTP settings to confirm
639
+ curviate mailbox connect anna@acme.example --connection google_sign_in # prints the sign-in link
640
+ printf '%s' "$APP_PASSWORD" | curviate mailbox connect anna@gmail.com --connection google_app_password --password-stdin
641
+ printf '%s' "$APP_PASSWORD" | curviate mailbox reconnect mbx_... --password-stdin
642
+ curviate domain check acme.example --now # MX, SPF, DKIM, DMARC, tracking
643
+ curviate account safety get --team # the Team's email defaults
644
+ curviate account safety update --team --email-default-cap 40 --email-opt-out-link-word Abmelden
645
+ ```
646
+
647
+ A password goes in only through `--password-stdin` (one line, never echoed, sent only in the request body), never as a flag value. A Mailbox sends only for the Account it is linked to, or for any Account when it is `shared`. The daily cap is at most 50; the API refuses more and says so.
648
+
631
649
  ## Retrieval modes
632
650
 
633
651
  Some reads can be answered from the copy Curviate already holds instead of