@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.
- package/CHANGELOG.md +57 -0
- package/README.md +35 -17
- package/dist/{account-DW5N5MJ6.js → account-ZF5NEMID.js} +132 -125
- package/dist/{analytics-T2K3OWVQ.js → analytics-M7JWS67A.js} +5 -5
- package/dist/{beta-consent-O736ONE7.js → beta-consent-4Q2LZZQC.js} +4 -4
- package/dist/{billing-NTBL32EX.js → billing-LYPSX5SR.js} +78 -6
- package/dist/{chunk-N76WNJ5T.js → chunk-7PLTQHNO.js} +1 -1
- package/dist/{chunk-N4IYTFIY.js → chunk-AMTKGO37.js} +1 -1
- package/dist/{chunk-ACKKHLUH.js → chunk-CRO7PJ4I.js} +2 -2
- package/dist/chunk-DENWYJK2.js +94 -0
- package/dist/{chunk-FBLCSVIU.js → chunk-EI64VFBE.js} +47 -47
- package/dist/{chunk-ENBIMEKS.js → chunk-IB6ARI3R.js} +1 -1
- package/dist/{chunk-Q57PZJLX.js → chunk-J4SFOFMT.js} +90 -88
- package/dist/{chunk-FUX3BRYP.js → chunk-JXDEV33Z.js} +1 -1
- package/dist/{chunk-5B4T6BMN.js → chunk-L3RJU7C3.js} +44 -44
- package/dist/{chunk-KXJJFHSD.js → chunk-MIOEYSBQ.js} +1 -1
- package/dist/{chunk-R4HS2MWM.js → chunk-MWVTFTWV.js} +15 -13
- package/dist/{chunk-QW5K5DTC.js → chunk-RDKTHFQ6.js} +25 -6
- package/dist/{chunk-62YAYAUI.js → chunk-RKNW4UX4.js} +51 -9
- package/dist/{chunk-V3HHYTBY.js → chunk-UOWOKEB2.js} +1 -1
- package/dist/{chunk-HOMRAZ6S.js → chunk-UWRWZG4N.js} +2 -2
- package/dist/{chunk-A3UNS44U.js → chunk-VEMK4MJM.js} +10 -10
- package/dist/{chunk-UFHT2KZG.js → chunk-XP6S6E55.js} +2 -2
- package/dist/cli.js +33 -25
- package/dist/{comment-ATVJOTWV.js → comment-D6RSZTVK.js} +8 -8
- package/dist/{company-BRKFROPE.js → company-3Z6PXGTW.js} +11 -11
- package/dist/{config-E223SS5K.js → config-VY5MCJMN.js} +2 -2
- package/dist/{connect-XVDQ5FTT.js → connect-G2RTLV7G.js} +15 -15
- package/dist/{contact-4HOUOVD7.js → contact-QSLJCBDE.js} +8 -8
- package/dist/{contact-groups-ENA3VGGL.js → contact-groups-OITAD73K.js} +85 -85
- package/dist/{contact-import-4EKVDFPV.js → contact-import-LT7BKESC.js} +10 -10
- package/dist/core-RFTNNB6P.js +46 -0
- package/dist/{do-not-contact-S2WGHSQL.js → do-not-contact-ZA7KS5WD.js} +59 -33
- package/dist/{doctor-OFIUGRUG.js → doctor-JQT3DO6G.js} +4 -4
- package/dist/{document-MDE2WJYX.js → document-H65EXU4L.js} +1 -1
- package/dist/domain-7EX4E34B.js +70 -0
- package/dist/{draft-DD3DTXBM.js → draft-7U6H4BPF.js} +4 -4
- package/dist/{enrollment-ESCHKQ5X.js → enrollment-AZ6XGVVL.js} +40 -38
- package/dist/{examples-KAMXHRLE.js → examples-IGQJCSNL.js} +2 -2
- package/dist/{exit-codes-CYQHN4NE.js → exit-codes-ZSOLAXQO.js} +1 -1
- package/dist/{export-GUAGB7TF.js → export-OYMQXL62.js} +5 -5
- package/dist/{feed-ZC4FY4BA.js → feed-M5D4SJW7.js} +6 -6
- package/dist/{group-42ZE7K3K.js → group-UTC3YBKE.js} +6 -6
- package/dist/{inbox-2YS7CTXH.js → inbox-VSGNHSLG.js} +9 -9
- package/dist/{inboxes-5RB3BGCQ.js → inboxes-23C2MJK4.js} +6 -6
- package/dist/{incoming-ATZN6JJA.js → incoming-QVPP32K7.js} +13 -13
- package/dist/{job-WD3Z3P3Q.js → job-ZHVFFRWE.js} +10 -10
- package/dist/{login-JQ57YHEJ.js → login-6OTNXEJZ.js} +4 -4
- package/dist/mailbox-HD2UXZCA.js +405 -0
- package/dist/{message-WGS2IIDC.js → message-PIV77W47.js} +7 -7
- package/dist/{motion-BRVBJJJP.js → motion-AHYF34DP.js} +224 -149
- package/dist/{network-CODIWCJQ.js → network-RJHJFZEY.js} +5 -5
- package/dist/{notification-RLVF4NLJ.js → notification-XGR4NT3S.js} +6 -6
- package/dist/{notifications-HGEHM5KW.js → notifications-BHRWSHPR.js} +6 -6
- package/dist/{post-3GH2IPO6.js → post-Z7AVDDKA.js} +8 -8
- package/dist/{profile-6RFJQMIB.js → profile-YZNBX2RP.js} +15 -15
- package/dist/{recruiter-GK3UNS62.js → recruiter-EXM4P7X7.js} +17 -17
- package/dist/{sales-nav-SLS3ABF4.js → sales-nav-CKDSEXV2.js} +15 -15
- package/dist/{search-45WRT5T3.js → search-B7FB6674.js} +17 -17
- package/dist/{setup-5QZOM2Q2.js → setup-VZVPLJ4V.js} +5 -5
- package/dist/{team-WM3RKOQ2.js → team-PYABBUHO.js} +6 -6
- package/dist/{tier-5AMLO5KE.js → tier-PRK4WQKR.js} +4 -4
- package/dist/{unibox-TTCF7YVO.js → unibox-ZNKX2EKL.js} +34 -34
- package/dist/{webhook-UCCCSKDO.js → webhook-V74EV4E2.js} +18 -18
- package/package.json +2 -2
- 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
|
-
##
|
|
347
|
+
## Campaigns and Enrollments
|
|
348
348
|
|
|
349
|
-
A
|
|
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
|
|
351
|
+
### 1. From a template to a running Campaign
|
|
352
352
|
|
|
353
353
|
```bash
|
|
354
|
-
curviate
|
|
355
|
-
curviate
|
|
356
|
-
curviate
|
|
357
|
-
curviate
|
|
358
|
-
curviate
|
|
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
|
|
362
|
+
`curviate campaign lint` prints one line per finding, compiler style, and exits 2 on any error:
|
|
362
363
|
|
|
363
364
|
```text
|
|
364
|
-
|
|
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
|
|
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
|
|
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
|
|
375
|
-
curviate
|
|
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
|
|
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 --
|
|
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 --
|
|
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
|