@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.
Files changed (70) hide show
  1. package/CHANGELOG.md +72 -0
  2. package/README.md +47 -6
  3. package/dist/{account-WKQHMM7P.js → account-KGCGUYKF.js} +668 -116
  4. package/dist/analytics-HRAD4ABO.js +27 -0
  5. package/dist/beta-consent-364JI6IL.js +81 -0
  6. package/dist/billing-3SSVRS2Y.js +124 -0
  7. package/dist/{chunk-Q63IIPL2.js → chunk-25MO7BYN.js} +4 -4
  8. package/dist/{chunk-76SWLAZ6.js → chunk-2W4RN5ON.js} +59 -1
  9. package/dist/chunk-5S3MJVI5.js +22 -0
  10. package/dist/chunk-67S4JHZZ.js +339 -0
  11. package/dist/chunk-73DJ3KNE.js +54 -0
  12. package/dist/chunk-CQGDMARG.js +525 -0
  13. package/dist/{chunk-Y7K4UBFC.js → chunk-DOHBOYXN.js} +1 -1
  14. package/dist/{chunk-TSOIZBBU.js → chunk-DSGKYZDK.js} +1 -1
  15. package/dist/{chunk-YLSJ4HKU.js → chunk-ENBIMEKS.js} +26 -1
  16. package/dist/{chunk-LCGXJGPB.js → chunk-GHMRPX5H.js} +7 -1
  17. package/dist/chunk-GOICALYQ.js +28 -0
  18. package/dist/chunk-L4CIJT6F.js +144 -0
  19. package/dist/{chunk-PQWDDSV7.js → chunk-L7JH3W56.js} +1 -1
  20. package/dist/{chunk-YFXLXION.js → chunk-OE6YFYUM.js} +85 -10
  21. package/dist/chunk-PPGKQJKU.js +38 -0
  22. package/dist/{chunk-MKGVNDMJ.js → chunk-QM57YDJE.js} +13 -201
  23. package/dist/{chunk-CVMSQ3OF.js → chunk-RYWWSZUH.js} +17 -3
  24. package/dist/chunk-T6GBS5SS.js +58 -0
  25. package/dist/{chunk-AYKKXGTR.js → chunk-TE3WBPW6.js} +392 -14
  26. package/dist/chunk-UL53T4O6.js +52 -0
  27. package/dist/chunk-UWQPX4AE.js +20 -0
  28. package/dist/{chunk-OHXYFICP.js → chunk-YXVF5UST.js} +77 -4
  29. package/dist/cli.js +35 -17
  30. package/dist/{comment-7IQ6ZOJF.js → comment-5JKGNYOY.js} +90 -11
  31. package/dist/{company-RD7RDGSA.js → company-TXST2VXW.js} +65 -15
  32. package/dist/{config-EYBNYRGK.js → config-TVIQUVNK.js} +53 -4
  33. package/dist/{connect-HVXT67A6.js → connect-RBL6U4KV.js} +63 -18
  34. package/dist/contact-YAHC5QFX.js +32 -0
  35. package/dist/contact-groups-DKOIBC57.js +399 -0
  36. package/dist/contact-import-ITSJQV7K.js +336 -0
  37. package/dist/core-PWMJPPRG.js +46 -0
  38. package/dist/do-not-contact-WDYIBWYA.js +200 -0
  39. package/dist/{doctor-HUXQERLQ.js → doctor-F7JLPTED.js} +65 -11
  40. package/dist/{document-AUUCGST2.js → document-BHYAUJ6F.js} +1 -1
  41. package/dist/{draft-DFO22K6Q.js → draft-TDJJUXLH.js} +60 -14
  42. package/dist/enrollment-Q6UOKHPY.js +484 -0
  43. package/dist/{examples-64YT5V5K.js → examples-DQSVIIXZ.js} +2 -2
  44. package/dist/{exit-codes-AW6KHDDN.js → exit-codes-7DBETBDT.js} +1 -1
  45. package/dist/export-HIJSCJS6.js +96 -0
  46. package/dist/{feed-JWP6ANPI.js → feed-W56ZTA4Z.js} +13 -10
  47. package/dist/{group-SIQFJEZV.js → group-AUALYK5H.js} +18 -10
  48. package/dist/{inbox-MMIMCA5O.js → inbox-HLZR2ZPV.js} +31 -12
  49. package/dist/{inboxes-RND3D4C7.js → inboxes-IZTRD6FE.js} +14 -10
  50. package/dist/incoming-ULB2RNV4.js +218 -0
  51. package/dist/{job-ACFKBLFK.js → job-55IKS6LP.js} +65 -13
  52. package/dist/{login-ZOB5KVKQ.js → login-DPZ6CXNO.js} +13 -4
  53. package/dist/{message-OFK6UVXR.js → message-J44YKRDS.js} +9 -7
  54. package/dist/motion-SQI5F2EK.js +868 -0
  55. package/dist/network-K4QD7APQ.js +235 -0
  56. package/dist/{notification-KKGAZU7M.js → notification-SEDXZHXO.js} +38 -11
  57. package/dist/notifications-HGIBRUNQ.js +231 -0
  58. package/dist/{post-A5SBCFB2.js → post-L467SKIG.js} +92 -12
  59. package/dist/{profile-4SOOQZ4K.js → profile-A2N6RMR2.js} +79 -23
  60. package/dist/{recruiter-YN73STDP.js → recruiter-AR75RHBO.js} +132 -21
  61. package/dist/{sales-nav-JXF5RY2K.js → sales-nav-C2AYFXPV.js} +73 -18
  62. package/dist/{search-JAL242A2.js → search-Z4DZIG4X.js} +55 -23
  63. package/dist/{setup-WICWH4JG.js → setup-45BEVX6B.js} +69 -17
  64. package/dist/team-6QWY4IFP.js +450 -0
  65. package/dist/tier-2HS3BXDF.js +61 -0
  66. package/dist/unibox-DHUKG65Z.js +402 -0
  67. package/dist/{webhook-UGKVYWBC.js → webhook-Q53WUAI2.js} +273 -45
  68. package/package.json +2 -2
  69. package/dist/chunk-GQKC6E5K.js +0 -36
  70. 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` (a human enables beta in Settings, or pass `--beta` for this
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` (a human enables beta in Settings, or pass `--beta` for this
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 | No active seat, the LinkedIn account lacks the subscription, or beta consent is missing |
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
- - On the default posture nothing is refused at all: the action goes through and
671
- the same payload rides the SUCCESS body under `safety_warning` with
672
- `blocked: false`.
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