@curviate/cli 0.48.0 → 0.50.0-next.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 +72 -0
- package/README.md +47 -6
- package/dist/{account-WKQHMM7P.js → account-KGCGUYKF.js} +668 -116
- package/dist/analytics-HRAD4ABO.js +27 -0
- package/dist/beta-consent-364JI6IL.js +81 -0
- package/dist/billing-3SSVRS2Y.js +124 -0
- package/dist/{chunk-Q63IIPL2.js → chunk-25MO7BYN.js} +4 -4
- package/dist/{chunk-76SWLAZ6.js → chunk-2W4RN5ON.js} +59 -1
- package/dist/chunk-5S3MJVI5.js +22 -0
- package/dist/chunk-67S4JHZZ.js +339 -0
- package/dist/chunk-73DJ3KNE.js +54 -0
- package/dist/chunk-CQGDMARG.js +525 -0
- package/dist/{chunk-Y7K4UBFC.js → chunk-DOHBOYXN.js} +1 -1
- package/dist/{chunk-TSOIZBBU.js → chunk-DSGKYZDK.js} +1 -1
- package/dist/{chunk-YLSJ4HKU.js → chunk-ENBIMEKS.js} +26 -1
- package/dist/{chunk-LCGXJGPB.js → chunk-GHMRPX5H.js} +7 -1
- package/dist/chunk-GOICALYQ.js +28 -0
- package/dist/chunk-L4CIJT6F.js +144 -0
- package/dist/{chunk-PQWDDSV7.js → chunk-L7JH3W56.js} +1 -1
- package/dist/{chunk-YFXLXION.js → chunk-OE6YFYUM.js} +85 -10
- package/dist/chunk-PPGKQJKU.js +38 -0
- package/dist/{chunk-MKGVNDMJ.js → chunk-QM57YDJE.js} +13 -201
- package/dist/{chunk-CVMSQ3OF.js → chunk-RYWWSZUH.js} +17 -3
- package/dist/chunk-T6GBS5SS.js +58 -0
- package/dist/{chunk-AYKKXGTR.js → chunk-TE3WBPW6.js} +392 -14
- package/dist/chunk-UL53T4O6.js +52 -0
- package/dist/chunk-UWQPX4AE.js +20 -0
- package/dist/{chunk-OHXYFICP.js → chunk-YXVF5UST.js} +77 -4
- package/dist/cli.js +35 -17
- package/dist/{comment-7IQ6ZOJF.js → comment-5JKGNYOY.js} +90 -11
- package/dist/{company-RD7RDGSA.js → company-TXST2VXW.js} +65 -15
- package/dist/{config-EYBNYRGK.js → config-TVIQUVNK.js} +53 -4
- package/dist/{connect-HVXT67A6.js → connect-RBL6U4KV.js} +63 -18
- package/dist/contact-YAHC5QFX.js +32 -0
- package/dist/contact-groups-DKOIBC57.js +399 -0
- package/dist/contact-import-ITSJQV7K.js +336 -0
- package/dist/core-PWMJPPRG.js +46 -0
- package/dist/do-not-contact-WDYIBWYA.js +200 -0
- package/dist/{doctor-HUXQERLQ.js → doctor-F7JLPTED.js} +65 -11
- package/dist/{document-AUUCGST2.js → document-BHYAUJ6F.js} +1 -1
- package/dist/{draft-DFO22K6Q.js → draft-TDJJUXLH.js} +60 -14
- package/dist/enrollment-Q6UOKHPY.js +484 -0
- package/dist/{examples-64YT5V5K.js → examples-DQSVIIXZ.js} +2 -2
- package/dist/{exit-codes-AW6KHDDN.js → exit-codes-7DBETBDT.js} +1 -1
- package/dist/export-HIJSCJS6.js +96 -0
- package/dist/{feed-JWP6ANPI.js → feed-W56ZTA4Z.js} +13 -10
- package/dist/{group-SIQFJEZV.js → group-AUALYK5H.js} +18 -10
- package/dist/{inbox-MMIMCA5O.js → inbox-HLZR2ZPV.js} +31 -12
- package/dist/{inboxes-RND3D4C7.js → inboxes-IZTRD6FE.js} +14 -10
- package/dist/incoming-ULB2RNV4.js +218 -0
- package/dist/{job-ACFKBLFK.js → job-55IKS6LP.js} +65 -13
- package/dist/{login-ZOB5KVKQ.js → login-DPZ6CXNO.js} +13 -4
- package/dist/{message-OFK6UVXR.js → message-J44YKRDS.js} +9 -7
- package/dist/motion-SQI5F2EK.js +868 -0
- package/dist/network-K4QD7APQ.js +235 -0
- package/dist/{notification-KKGAZU7M.js → notification-SEDXZHXO.js} +38 -11
- package/dist/notifications-HGIBRUNQ.js +231 -0
- package/dist/{post-A5SBCFB2.js → post-L467SKIG.js} +92 -12
- package/dist/{profile-4SOOQZ4K.js → profile-A2N6RMR2.js} +79 -23
- package/dist/{recruiter-YN73STDP.js → recruiter-AR75RHBO.js} +132 -21
- package/dist/{sales-nav-JXF5RY2K.js → sales-nav-C2AYFXPV.js} +73 -18
- package/dist/{search-JAL242A2.js → search-Z4DZIG4X.js} +55 -23
- package/dist/{setup-WICWH4JG.js → setup-45BEVX6B.js} +69 -17
- package/dist/team-6QWY4IFP.js +450 -0
- package/dist/tier-2HS3BXDF.js +61 -0
- package/dist/unibox-DHUKG65Z.js +402 -0
- package/dist/{webhook-UGKVYWBC.js → webhook-Q53WUAI2.js} +273 -45
- package/package.json +2 -2
- package/dist/chunk-GQKC6E5K.js +0 -36
- package/dist/core-6XYGUNAY.js +0 -46
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,78 @@ 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
|
+
## Unreleased
|
|
10
|
+
|
|
11
|
+
Requires the next `@curviate/sdk` (a commit pin on the SDK PR build until it is published; `check:sdk-pin` refuses a publish until the pin is a version). The vendored OpenAPI fixture is re-copied from the SDK's, regenerated from the deployed staging document.
|
|
12
|
+
|
|
13
|
+
### Added
|
|
14
|
+
|
|
15
|
+
- `curviate account update --save-connections-as-contacts` (and `--no-save-connections-as-contacts`): whether the Account's Connections are saved as Contacts (Automate). `account get` shows `save_connections_as_contacts` and `save_connections_paused_reason` (`contact_limit_reached`).
|
|
16
|
+
- `curviate contact list|export|update|delete --connected-account` takes several Accounts (repeat the flag, or a comma list, up to 50): Connections of any of them.
|
|
17
|
+
- `contact get|list --json` carries the read-only `company_linkedin_url`; `account get --json` carries `save_connections_as_contacts` and `save_connections_paused_reason` when the API sends them (Automate); `analytics events` and `account overview` items carry `person_name` for a direct action.
|
|
18
|
+
|
|
19
|
+
### Changed
|
|
20
|
+
|
|
21
|
+
- Owners and Managers: `team update` (rename; `--billing-owner` stays Owners only), `team invites create|list|resend|revoke` (a Manager invites Members only), `team logo set|remove` and `team remove` (a Manager removes Members) say so in their help and errors; the `team` group reads "Owners and Managers manage".
|
|
22
|
+
- `team members` `name` falls back to the member's email.
|
|
23
|
+
|
|
24
|
+
## [0.49.0] - 2026-10-22
|
|
25
|
+
|
|
26
|
+
A minor: Motions and Enrollments arrive as top-level groups. Requires
|
|
27
|
+
`@curviate/sdk` 0.44.0 (exact pin). The vendored OpenAPI fixture is re-copied
|
|
28
|
+
from the SDK's fixture.
|
|
29
|
+
|
|
30
|
+
### Added
|
|
31
|
+
|
|
32
|
+
- `curviate motion`: `list`, `get` (with `--version` for one Sequence
|
|
33
|
+
version), `create --file`, `update --file [--if-revision <n>]`, `start`,
|
|
34
|
+
`pause`, `resume`, `archive`, `delete`, `preview [--sample | --contact]`,
|
|
35
|
+
`add` and `remove` (`--contact`, sent in requests of up to 1000 ids, in
|
|
36
|
+
order; a failed request stops the run and reports what was sent), and two
|
|
37
|
+
offline commands: `lint --file` and `init --template [--output]`.
|
|
38
|
+
- A Motion file is checked before anything is sent: its fields against the
|
|
39
|
+
published schema, its Sequence with the SDK's `validateSequence`. Sequence
|
|
40
|
+
findings print one per line, `<file>:<line>:<col> error R12 <path>: <message>.
|
|
41
|
+
<hint> -> <docs_url>`, the same as `curviate motion lint`.
|
|
42
|
+
- `curviate motion get` output is a Motion file: `motion create --file -` and
|
|
43
|
+
`motion update <id> --file -` accept it, dropping the keys Curviate sets with a
|
|
44
|
+
warning naming each.
|
|
45
|
+
- `curviate motion update --if-revision <n>`: refused with `SEQUENCE_CONFLICT`
|
|
46
|
+
(exit 2) when someone saved the Sequence since; the message names the newer
|
|
47
|
+
revision and who saved it.
|
|
48
|
+
- `curviate motion init --template` writes `connect-and-converse`,
|
|
49
|
+
`engage-then-connect` or `nurture-connections` (which follows up only when the
|
|
50
|
+
first message was seen) in this machine's timezone.
|
|
51
|
+
- `curviate enrollment`: `list` (filters `--motion`, `--contact`, `--status`,
|
|
52
|
+
`--step`, `--version`, `--done-step` with `--outcome`, `--reason`,
|
|
53
|
+
`--variant`, `--relationship`), `get`, `pause`, `resume [--at]`, `retry`,
|
|
54
|
+
`stop`, `event <id> <name>`, `reassign --account`, and `bulk --action` over
|
|
55
|
+
`--id` or `--motion` with the list filters.
|
|
56
|
+
- `curviate enrollment retry` retries only a failed Step (a repeat never sends a
|
|
57
|
+
delivered message again), then waits for the re-run (`--wait-timeout <ms>`, default
|
|
58
|
+
600000) and prints its outcome, reason and message.
|
|
59
|
+
- In human output, each Enrollment reason reads `<code>: <message>` (skip,
|
|
60
|
+
finish and every history entry); `--json` keeps the API's code and message
|
|
61
|
+
keys.
|
|
62
|
+
- `curviate webhook create --source motion` and `--motion-ids`.
|
|
63
|
+
|
|
64
|
+
### Changed
|
|
65
|
+
|
|
66
|
+
- `curviate webhook create`: `--account-ids` is optional for every source;
|
|
67
|
+
omitted, the webhook covers every account you can operate, now and later.
|
|
68
|
+
- `curviate enrollment resume --at` is a jump: it re-enters the named Step even
|
|
69
|
+
when that Step already sent. Use `curviate enrollment retry` for a failed Step.
|
|
70
|
+
- Exit codes for the new error codes: `SEQUENCE_INVALID`, `SEQUENCE_CONFLICT`,
|
|
71
|
+
`NOTHING_TO_RETRY`, `MOTION_STATUS_CONFLICT`, `ENROLLMENT_NOT_ACTIVE` and the
|
|
72
|
+
other Motion refusals exit 2; `STEP_IN_FLIGHT` exits 7 (read again in a
|
|
73
|
+
minute); `TIER_REQUIRED` and the team-role codes exit 5; a request timeout
|
|
74
|
+
exits 7.
|
|
75
|
+
|
|
76
|
+
### Deprecated
|
|
77
|
+
|
|
78
|
+
- `curviate enrollment signal` is an alias of `curviate enrollment event`,
|
|
79
|
+
accepted until 2027-01-19.
|
|
80
|
+
|
|
9
81
|
## [0.48.0] - 2026-10-19
|
|
10
82
|
|
|
11
83
|
A breaking minor (pre-1.0): the LinkedIn commands move under `curviate core`.
|
package/README.md
CHANGED
|
@@ -83,6 +83,13 @@ curviate --api-key <your-api-key> account list
|
|
|
83
83
|
> history. Prefer `curviate login` or the `CURVIATE_API_KEY` environment
|
|
84
84
|
> variable; reserve `--api-key` for one-off, low-trust contexts.
|
|
85
85
|
|
|
86
|
+
**Teams.** A key works in one Team, or in all of your Teams. With a key for
|
|
87
|
+
all your Teams, every call names the Team it acts in: `--team <team_id>`, then
|
|
88
|
+
`CURVIATE_TEAM`, then the profile's `team` (which `curviate setup` stores when
|
|
89
|
+
you pick "All my Teams"). The CLI sends it as `X-Curviate-Team`. A Team key acts
|
|
90
|
+
only in its own Team, so leave the Team unset with one. `curviate doctor`
|
|
91
|
+
reports the key's scope and checks the Team against your Teams.
|
|
92
|
+
|
|
86
93
|
Get your API key from the [Curviate dashboard](https://app.curviate.com).
|
|
87
94
|
|
|
88
95
|
## Usage
|
|
@@ -309,6 +316,40 @@ curviate core draft list --account none --all --json
|
|
|
309
316
|
|
|
310
317
|
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.
|
|
311
318
|
|
|
319
|
+
## Motions and Enrollments
|
|
320
|
+
|
|
321
|
+
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.
|
|
322
|
+
|
|
323
|
+
### 1. From a template to a running Motion
|
|
324
|
+
|
|
325
|
+
```bash
|
|
326
|
+
curviate motion init --template connect-and-converse --output motion.json # offline; fill contact_list_ids and account_ids
|
|
327
|
+
curviate motion lint --file motion.json # offline: the rules the API applies
|
|
328
|
+
curviate motion create --file motion.json --json
|
|
329
|
+
curviate motion preview mot_1 --sample 3 --json # rendered messages and the budget projection; spends nothing
|
|
330
|
+
curviate motion start mot_1 --json
|
|
331
|
+
```
|
|
332
|
+
|
|
333
|
+
`curviate motion lint` prints one line per finding, compiler style, and exits 2 on any error:
|
|
334
|
+
|
|
335
|
+
```text
|
|
336
|
+
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
|
|
337
|
+
```
|
|
338
|
+
|
|
339
|
+
`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.
|
|
340
|
+
|
|
341
|
+
### 2. Find and fix Enrollments
|
|
342
|
+
|
|
343
|
+
```bash
|
|
344
|
+
curviate enrollment list --motion mot_1 --done-step opener --outcome failed --json
|
|
345
|
+
curviate enrollment retry enr_1 --json # only a failed Step; waits for the re-run and prints its outcome
|
|
346
|
+
curviate enrollment bulk --action retry --motion mot_1 --done-step opener --outcome failed --json
|
|
347
|
+
curviate enrollment pause enr_1 --json
|
|
348
|
+
curviate enrollment resume enr_1 --json # lifts your pause
|
|
349
|
+
```
|
|
350
|
+
|
|
351
|
+
`curviate enrollment resume <id> --at <step>` is a jump, not a retry: it re-enters that Step even when it already sent. `curviate enrollment retry` never sends a delivered message again.
|
|
352
|
+
|
|
312
353
|
## Sales Navigator
|
|
313
354
|
|
|
314
355
|
Sales Navigator commands (`curviate core sales-nav ...`) are **beta**: this surface has not been
|
|
@@ -319,7 +360,7 @@ paid seat entitles every command here. What these commands do need is the Linked
|
|
|
319
360
|
own Sales Navigator subscription. A refusal is **exit code `5`** with one of three codes in
|
|
320
361
|
the JSON body: `NO_ACTIVE_SEAT` (no Curviate seat covers the account, fix it in billing),
|
|
321
362
|
`LINKEDIN_FEATURE_NOT_SUBSCRIBED` (the LinkedIn account lacks the subscription, fix it on
|
|
322
|
-
LinkedIn) or `BETA_NOT_ENABLED` (
|
|
363
|
+
LinkedIn) or `BETA_NOT_ENABLED` (an Owner enables beta with `curviate beta update --enabled true`, or pass `--beta` for this
|
|
323
364
|
call). Branch on the exit code the same way as example 4 above, and read the code for the
|
|
324
365
|
remedy. Write commands (`curviate core sales-nav save-lead`, `curviate core sales-nav save-account`, `curviate core sales-nav message new`) accept `--preview` to
|
|
325
366
|
render the request without sending it.
|
|
@@ -419,7 +460,7 @@ entitles every command here. What these commands do need is the LinkedIn account
|
|
|
419
460
|
subscription. A refusal is **exit code `5`** with one of three codes in the JSON body:
|
|
420
461
|
`NO_ACTIVE_SEAT` (no Curviate seat covers the account, fix it in billing),
|
|
421
462
|
`LINKEDIN_FEATURE_NOT_SUBSCRIBED` (the LinkedIn account lacks the subscription, fix it on
|
|
422
|
-
LinkedIn) or `BETA_NOT_ENABLED` (
|
|
463
|
+
LinkedIn) or `BETA_NOT_ENABLED` (an Owner enables beta with `curviate beta update --enabled true`, or pass `--beta` for this
|
|
423
464
|
call). The surface is project-centric: most
|
|
424
465
|
operations are scoped to a hiring project id. Write commands (`curviate core recruiter save-candidate`, `curviate core recruiter project update`,
|
|
425
466
|
`curviate core recruiter project-job create`, `curviate core recruiter project-job update`, `curviate core recruiter job create`,
|
|
@@ -620,7 +661,7 @@ curviate core inbox get 2-AbCdEf== --account acc_1 --mode cache_only --json
|
|
|
620
661
|
| 2 | Usage / argument error |
|
|
621
662
|
| 3 | Authentication or authorization failure |
|
|
622
663
|
| 4 | Resource not found |
|
|
623
|
-
| 5 |
|
|
664
|
+
| 5 | Someone must act first: no active seat, the LinkedIn account lacks the subscription, beta consent is missing, the plan is below the Tier the action needs, or a teammate with the right role (or the Account's own person) must do it |
|
|
624
665
|
| 6 | Rate limited |
|
|
625
666
|
| 7 | Transient platform error (retry likely to succeed) |
|
|
626
667
|
| 8 | Account or connection state blocks the request |
|
|
@@ -667,9 +708,9 @@ rather than parsing the message:
|
|
|
667
708
|
LinkedIn regrants on its own schedule. Null-check it before scheduling on it.
|
|
668
709
|
- `safetyHint.parameter` is addressable on the safety policy, so an agent can
|
|
669
710
|
choose between waiting, escalating and reconfiguring without reading prose.
|
|
670
|
-
-
|
|
671
|
-
the
|
|
672
|
-
|
|
711
|
+
- A limit is always enforced: at the ceiling, or outside the activity window,
|
|
712
|
+
the action is refused with this error. Nothing is sent and nothing rides a
|
|
713
|
+
success body.
|
|
673
714
|
|
|
674
715
|
A `429` that carries `budgetRow` under `PLATFORM_RATE_LIMIT` is a third thing:
|
|
675
716
|
that row is PAUSED because LinkedIn refused a recent call on it. The pause is
|