@curviate/cli 0.57.0 → 0.58.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 (68) hide show
  1. package/CHANGELOG.md +93 -0
  2. package/README.md +9 -2
  3. package/dist/{account-IRIYB2SG.js → account-GSL6BCNX.js} +52 -16
  4. package/dist/{analytics-IRSCLVOL.js → analytics-4FUMJSMC.js} +6 -6
  5. package/dist/{beta-consent-NQVGFZL3.js → beta-consent-EC2QF6CM.js} +4 -4
  6. package/dist/billing-STRNXA4H.js +19 -0
  7. package/dist/{chunk-6OT6TS7N.js → chunk-3IL3D5IZ.js} +2 -2
  8. package/dist/{chunk-3ZQNOKEK.js → chunk-5OAJ4D65.js} +2 -2
  9. package/dist/{chunk-AMTKGO37.js → chunk-5Z3CCE5N.js} +1 -1
  10. package/dist/{billing-TCTP44ZB.js → chunk-7F6B7P32.js} +123 -12
  11. package/dist/{chunk-3B5M2RUN.js → chunk-CQHCPZ5I.js} +1 -1
  12. package/dist/{chunk-SCUTAREU.js → chunk-EWSOIFG2.js} +17 -0
  13. package/dist/{chunk-RKNW4UX4.js → chunk-JKOQX46J.js} +6 -0
  14. package/dist/{chunk-VHNF6OZD.js → chunk-JY26SUNH.js} +18 -2
  15. package/dist/{chunk-VPFV7YV3.js → chunk-KS4I4B3Z.js} +6 -6
  16. package/dist/{chunk-OE4CY3ZL.js → chunk-KUVJM5CP.js} +1 -1
  17. package/dist/{chunk-F7CLAS5Y.js → chunk-MLZSXQZC.js} +2 -2
  18. package/dist/{chunk-RXDG57B2.js → chunk-PBJZQZPO.js} +1 -1
  19. package/dist/{chunk-A6JGJGDF.js → chunk-WGGZWJPO.js} +16 -16
  20. package/dist/{chunk-AG6G3PRQ.js → chunk-WITIJCUU.js} +17 -13
  21. package/dist/{chunk-5LGKZBAY.js → chunk-XDPU2YAF.js} +4 -3
  22. package/dist/{chunk-RTT75CXE.js → chunk-XXB4MAX3.js} +86 -14
  23. package/dist/cli.js +33 -33
  24. package/dist/{comment-PNHEKGZX.js → comment-MUELYZYN.js} +8 -8
  25. package/dist/{company-OUFF23SU.js → company-5N7CXORR.js} +8 -8
  26. package/dist/{company-record-ULPDDB6L.js → company-record-HWLTP4TV.js} +95 -10
  27. package/dist/{config-U6VDNL2P.js → config-PI7JMQ2L.js} +2 -2
  28. package/dist/{connect-ICNXC37R.js → connect-NNZOOPWV.js} +11 -11
  29. package/dist/{contact-K6RIVQWU.js → contact-VNG7HRCN.js} +9 -9
  30. package/dist/{contact-groups-CNH2VB6A.js → contact-groups-6JF7VX6Q.js} +11 -11
  31. package/dist/{contact-import-FK22UTN2.js → contact-import-TMJWY2VD.js} +11 -11
  32. package/dist/core-ZRJY3HTF.js +46 -0
  33. package/dist/{do-not-contact-BQHXNHTV.js → do-not-contact-GDVIUNMT.js} +22 -20
  34. package/dist/{doctor-ZYPZF5BE.js → doctor-ZNAR5AZ2.js} +4 -4
  35. package/dist/{document-H65EXU4L.js → document-G6UND26L.js} +1 -1
  36. package/dist/{domain-HLOT6Y4A.js → domain-62YUYVDW.js} +5 -5
  37. package/dist/{draft-JGQ36JSH.js → draft-ED6RL67K.js} +5 -5
  38. package/dist/{enrollment-CF634DB4.js → enrollment-LN3Z3RC5.js} +14 -10
  39. package/dist/{examples-J4X5NEIE.js → examples-5FJS47QF.js} +2 -2
  40. package/dist/{exit-codes-P2FLCKM7.js → exit-codes-LQDMGDII.js} +1 -1
  41. package/dist/{export-ZQLDQYUZ.js → export-S6D4FEAG.js} +4 -4
  42. package/dist/{feed-RQHEDZVL.js → feed-AC7HWUCD.js} +6 -6
  43. package/dist/{group-LRMG76FN.js → group-6N37Q5ZS.js} +6 -6
  44. package/dist/{inbox-5RGG5RQG.js → inbox-JFRBROQ2.js} +6 -6
  45. package/dist/{inboxes-ZFY6ZP33.js → inboxes-IBZHZKSD.js} +6 -6
  46. package/dist/{incoming-3MJ4CP6H.js → incoming-YDRPPO24.js} +8 -8
  47. package/dist/{job-QFIUTHHT.js → job-CSRHIFZM.js} +6 -6
  48. package/dist/{login-THXWX5HZ.js → login-M7ZLOR2U.js} +2 -2
  49. package/dist/mailbox-E2K3I2VH.js +712 -0
  50. package/dist/{message-DM5OUKQS.js → message-SX6RDGWP.js} +7 -7
  51. package/dist/{motion-NKOAK7NU.js → motion-4HH3OFI6.js} +121 -16
  52. package/dist/{network-VKJUMZ2L.js → network-JQYLSQDH.js} +12 -12
  53. package/dist/{notification-XW5J6KFA.js → notification-ZAQM463D.js} +6 -6
  54. package/dist/{notifications-USYOV54R.js → notifications-N55F3DP3.js} +9 -9
  55. package/dist/{post-M2G3BK4A.js → post-SIHHJX3P.js} +8 -8
  56. package/dist/{profile-3SG64IEG.js → profile-VBHX3QGP.js} +12 -12
  57. package/dist/{recruiter-7OUGZ776.js → recruiter-7AGFKQPI.js} +9 -9
  58. package/dist/{sales-nav-HHQLLM5C.js → sales-nav-ADVFBKWB.js} +9 -9
  59. package/dist/{search-5LMSLUH4.js → search-THJFPGOH.js} +16 -16
  60. package/dist/{setup-6F4HYUSZ.js → setup-D6D7SNND.js} +4 -4
  61. package/dist/{signal-LVODDBOY.js → signal-TGSF7WEP.js} +126 -19
  62. package/dist/{team-MSOPELF6.js → team-MVNHCWJP.js} +8 -8
  63. package/dist/{tier-RXHOAQ6L.js → tier-DAF7Y2HN.js} +4 -4
  64. package/dist/{unibox-UAA6WIGZ.js → unibox-7B6B4SXB.js} +292 -14
  65. package/dist/{webhook-J2H7X766.js → webhook-NUVSTDXF.js} +12 -12
  66. package/package.json +3 -3
  67. package/dist/core-MPEBYNSL.js +0 -46
  68. package/dist/mailbox-54DPLNXA.js +0 -412
package/CHANGELOG.md CHANGED
@@ -6,6 +6,99 @@ 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.58.0] - 2026-11-18
10
+
11
+ Requires `@curviate/sdk` 0.54.0 (exact pin). The vendored OpenAPI fixture is re-copied from the SDK's (staging's document, server commit `00abf89b6`); `commands.json` regenerated; `src/schemas/documents.json` re-derived (unchanged). `campaign lint` runs the SDK 0.54.0 validator offline: `attachment_ids` on an email step and warning W23.
12
+
13
+ ### Placement tests and warm-up states
14
+
15
+ - **`mailbox test <mbx_...> --subject <s> --body-file <path|->`** runs a placement test: your exact email to 12 test inboxes at four providers, results within an hour. **`mailbox tests <mbx_...> [plt_...]`** reads the tests, a verdict per provider and the Team's allowance (10 per paid seat a month).
16
+ - `PLACEMENT_TEST_ALLOWANCE_EXHAUSTED` exits **5** (a paid seat or the new month lifts it; never retried); `PLACEMENT_TESTS_UNAVAILABLE` exits 1.
17
+ - **`campaign placement <mot_...>`**: the Campaign's weekly placement checks.
18
+ - `mailbox get` shows `warm_up.state` `waiting` with its `reason` (`reconnect_needed`, `trial`, `app_password`, `warm_up_app`, `allowance`).
19
+
20
+ ### Limit hits
21
+
22
+ - **`account safety events <acc_...> [--budget-row] [--since] [--until]`**: the actions Curviate refused at a safety limit or pause, newest first.
23
+
24
+ ### Email export
25
+
26
+ - **`analytics export --table email`** (alone, streamed or with `--job`): your Campaign email's daily counts per Mailbox, Account, Campaign, step, variant and receiving provider; no `--origin`.
27
+
28
+ ### Mailboxes from Curviate
29
+
30
+ - **`mailbox purchase list [--state]`**, **`mailbox purchase get <mpu_...>`**, **`mailbox purchase check <mpu_...>`** and **`mailbox purchase cancel <mpu_...>`** read your Team's orders and the records to add, look the records up now (once a minute), and cancel an order still waiting for its records (nothing was charged). `MAILBOX_PURCHASE_STATE_CONFLICT` exits 8: while a charge is under way it says to read the order again later, never to retry.
31
+ - **`mailbox buy --domain <d> --mailbox local:Name[:acc_...|shared] ...`** places an order, after a confirmation (`--yes` without a terminal). Owners only; an order through an API key stays under the Team's cap on Mailboxes from Curviate, which only an Owner raises in the dashboard: past it the order is refused (`SPENDING_CAP_REACHED`, exit 5) with a plain line, never retried, and nothing is ordered. Exit codes: `MAILBOX_PURCHASE_NOT_FOUND` 4, `DOMAIN_IN_USE` and `DOMAIN_IS_COMPANY_EMAIL` 2, `MAILBOX_PURCHASE_PENDING` 8, `MAILBOX_PURCHASE_TRIAL` 11, `MAILBOX_SALES_PAUSED` 1.
32
+
33
+ ### Seats, reputation and sold Mailboxes
34
+
35
+ - `account link` (a new account or a reconnect with `--account-id`) names the seat it occupies: "Account linked: acc_... (seat seat_...)"; `--json` carries `seat_id` and the deprecated `attached_seat_id`.
36
+ - `mailbox get` describes `reputation` (0 to 100, or null while gathering, never 0) and the warm-up reasons `paused_by_curviate`, `address_check` and `address_unconfirmed`.
37
+ - `mailbox remove` on a Mailbox from Curviate: Owners only, its charge stops at the period's end; `MAILBOX_STATE_CONFLICT` "still settling with billing" (exit 8) is never retried in a loop.
38
+
39
+ ### Files and Mailbox orders
40
+
41
+ - `campaign attachment upload <path>` streams the file from disk in one request (a file-backed Blob, never read whole), and refuses a file over 20 MiB before it leaves (exit 2). Its help names the Microsoft sign-in limit (about 2.2 MB in all).
42
+ - `mailbox purchase get` and `check` say what `provisioning` means (charged, being set up; a failed setup is undone in full) and what `cancelled` with `host_failed` means (the charge was undone): neither is a cue to retry or to order again.
43
+
44
+ ### Reply labels and Enrollments
45
+
46
+ - `unibox label --set` names each label's effect in one line; `mailbox get` describes `landing` (verdicts per receiving provider).
47
+ - `enrollment list` and `get` in human mode read a `same_company` skip with the Lead kept.
48
+
49
+ ### Lead imports
50
+
51
+ - `lead import --source` offers `sales_nav_account_list` (`--list-id`, `--titles` optional) and `sales_nav_company_people` (a Sales Navigator account search URL or `--filter`, plus `--titles`); a pasted account search URL picks `sales_nav_company_people`.
52
+
53
+ ### Email attachments
54
+
55
+ - **`campaign attachment upload <file>`** stores one file for an email step's `attachment_ids` (up to 20 MiB, 100 uploads per Team per 24 hours; executables, scripts and macro-enabled Office files are refused, `UNSUPPORTED_MEDIA_TYPE`); **`campaign attachment get <id>`** reads it back. `--preview` prints the request without sending it.
56
+
57
+ ### Email: Needs a fix
58
+
59
+ - **`analytics attention [--campaign <mot_...>] [--account-id <acc_...>]`**: what to fix in your email sending now, one row per problem with the command that leads to its fix.
60
+
61
+ ### Unibox conversations and email
62
+
63
+ - **`unibox conversation get <conversation_id>`**: one person on one account across LinkedIn and email, with its marks and email state. **`unibox conversation timeline <conversation_id> [--channel linkedin|email]`**: its LinkedIn messages, emails and Campaign events in one list, newest first (`--all` pages on). **`unibox conversation mark <conversation_id> --read|--unread`**.
64
+ - **`unibox email send <conversation_id> <text> (--thread <thread_id> | --subject <subject> [--mailbox <mbx_>])`**: one plain-text email to the Lead. One request; a retry after a timeout can send twice. `EMAIL_UNAVAILABLE` exits 2 and names the reason.
65
+ - **`unibox referral search <message_id> [--name]`** and **`unibox referral confirm <message_id> (--provider-id | --linkedin-url)`** for a reply labelled Referral. `NOT_A_REFERRAL` exits 2.
66
+
67
+ ### Email from a conversation: Cc, Bcc, files
68
+
69
+ - **`unibox email send --cc --bcc --attach <file>`**: at most 20 addresses in Cc and Bcc together; files at most 10, 20 MiB in all, refused before anything is sent. From a Microsoft sign-in Mailbox, files of about 2.2 MB in all go today; more is refused, nothing sent. A `recipients_refused` warning (the Cc or Bcc addresses that got nothing) is printed on stderr.
70
+ - An email whose outcome is unknown (the provider stopped answering after it had the whole email) exits **1, never 7**, and says not to send it again.
71
+
72
+ ### Billing (seats and the period)
73
+
74
+ - **`billing seats add <qty>`** (inside the spending cap: `SPENDING_CAP_REACHED` exits 5; `SPENDING_CAP_NEAR` rides the answer), **`billing seats remove <seat_id>`** (at the period end; the last paid seat is `CANCEL_IN_DASHBOARD`, exit 5) and **`billing period set annual`**. Each asks at a terminal; elsewhere it needs `--yes`, or nothing is sent. Cancelling the subscription stays the dashboard's.
75
+
76
+ ### Companies
77
+
78
+ - **`company fields --file <csv>`**: header `company_id`, then one column per field key; one request per company, in file order, stopping at the first refusal.
79
+
80
+ ### Mailboxes and Campaigns
81
+
82
+ - **`mailbox update --warm-up on --days 10|14|21|28`** and **`--warm-up off`**: Mailbox warm-up; `mailbox get` shows `warm_up` with its state and day.
83
+ - **`campaign update --one-lead-per-company`** (and `--no-one-lead-per-company`), with or without `--file`.
84
+ - **`analytics email --include breakdowns,mailboxes,domains`** and **`--forecast`**: one line per Mailbox and domain, the breakdown row counts, the forecast per day.
85
+ - Mailbox connect output never suggests sending a password through an agent: it points to the Connect request link. `--password-stdin` stays for a person at their own terminal (`--help`).
86
+
87
+ ### Signals
88
+
89
+ - **`signal watch set <account_id> on|off`** switches one Account's Signal watch (Owners and Managers); **`signal watch list`** reads every Account's state (a bare `signal watch` still does).
90
+ - **`signal actions [--lead-id] [--rule-id] [--outcome]`**: what rules did.
91
+ - **`signal rules enable|disable <rule_id>`**; **`signal rules create --enroll <mot_...>`** (enroll the person through the Account that caught the Signal) and **`--act-on-last-7-days`**.
92
+ - **`webhook create --source signal`**: the eight `signal` events.
93
+
94
+ ### Do-not-contact
95
+
96
+ - **`do-not-contact add --company <linkedin company URL>`**: nobody who works there is contacted or imported.
97
+
98
+ ### Lead imports
99
+
100
+ - `lead import --filter` help names the keys each LinkedIn source kind offers.
101
+
9
102
  ## [0.57.0] - 2026-11-18
10
103
 
11
104
  Requires `@curviate/sdk` 0.53.0 (exact pin). The vendored OpenAPI fixture is re-copied from the SDK's (production document, server commit `c8b370ae4`); `commands.json` regenerated; `src/schemas/documents.json` re-derived (unchanged).
package/README.md CHANGED
@@ -356,6 +356,7 @@ curviate campaign lint --file campaign.json
356
356
  curviate campaign create --file campaign.json --json
357
357
  curviate campaign preview mot_1 --limit 3 --json # rendered messages and the budget projection; spends nothing (--all: every Lead)
358
358
  curviate campaign check mot_1 --json # with an email step: the Lead check start needs
359
+ curviate campaign placement mot_1 # the weekly placement checks of its email steps
359
360
  curviate campaign start mot_1 --json # --skip-missing-email: start without the Leads lacking an address
360
361
  ```
361
362
 
@@ -639,9 +640,15 @@ curviate mailbox discover anna@acme.example # IMAP and SMTP settin
639
640
  curviate mailbox connect anna@acme.example --connection google_sign_in # prints the sign-in link
640
641
  printf '%s' "$APP_PASSWORD" | curviate mailbox connect anna@gmail.com --connection google_app_password --password-stdin
641
642
  printf '%s' "$APP_PASSWORD" | curviate mailbox reconnect mbx_... --password-stdin
643
+ curviate mailbox test mbx_... --subject "Quick question" --body-file body.txt # a placement test: where it lands, per provider
644
+ curviate mailbox tests mbx_... # its tests and the Team's allowance
645
+ curviate mailbox purchase list # orders of Mailboxes from Curviate; purchase check <id> looks the records up now
642
646
  curviate domain check acme.example --now # MX, SPF, DKIM, DMARC, tracking
643
647
  curviate account safety get --team # the Team's email defaults
644
648
  curviate account safety update --team --email-default-cap 40 --email-opt-out-link-word Abmelden
649
+ curviate analytics attention # Needs a fix: each problem with the command to its fix
650
+ curviate campaign attachment upload pricing.pdf --json # {"id":"cat_..."}: put it in an email step's attachment_ids
651
+ curviate unibox timeline cnv_... # one person's LinkedIn messages and emails in one list
645
652
  ```
646
653
 
647
654
  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.
@@ -718,11 +725,11 @@ curviate core inbox get 2-AbCdEf== --account acc_1 --mode cache_only --json
718
725
  | Code | Meaning |
719
726
  |------|---------|
720
727
  | 0 | Success |
721
- | 1 | Unexpected error |
728
+ | 1 | Unexpected error; also an email whose outcome is unknown (it may have been sent: never send it again) |
722
729
  | 2 | Usage / argument error |
723
730
  | 3 | Authentication or authorization failure |
724
731
  | 4 | Resource not found |
725
- | 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 |
732
+ | 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, the month's placement tests are used (a paid seat adds 10), or a teammate with the right role (or the Account's own person) must do it |
726
733
  | 6 | Rate limited |
727
734
  | 7 | Transient platform error (retry likely to succeed) |
728
735
  | 8 | Account or connection state blocks the request |
@@ -14,25 +14,25 @@ import {
14
14
  grammarParams,
15
15
  renderOverview,
16
16
  windowParams
17
- } from "./chunk-RTT75CXE.js";
17
+ } from "./chunk-XXB4MAX3.js";
18
+ import "./chunk-PPGKQJKU.js";
18
19
  import {
19
20
  print,
20
21
  table
21
22
  } from "./chunk-5S3MJVI5.js";
22
- import "./chunk-PPGKQJKU.js";
23
23
  import {
24
24
  fail,
25
25
  listFlag,
26
26
  outputOpts,
27
27
  rootClient,
28
28
  usage
29
- } from "./chunk-3ZQNOKEK.js";
30
- import {
31
- intFlag
32
- } from "./chunk-NNV2OYEF.js";
29
+ } from "./chunk-5OAJ4D65.js";
33
30
  import {
34
31
  buildPreviewOutput
35
32
  } from "./chunk-TCUYH5GO.js";
33
+ import {
34
+ intFlag
35
+ } from "./chunk-NNV2OYEF.js";
36
36
  import {
37
37
  pageDelayFromFlags,
38
38
  readCursorFlag,
@@ -41,7 +41,7 @@ import {
41
41
  readablePage,
42
42
  rejectPaginationModifiersWithoutAll,
43
43
  streamAll
44
- } from "./chunk-OE4CY3ZL.js";
44
+ } from "./chunk-KUVJM5CP.js";
45
45
  import {
46
46
  isJsonMode,
47
47
  renderError,
@@ -57,7 +57,7 @@ import {
57
57
  import {
58
58
  createClient,
59
59
  resolveEffectiveConfig
60
- } from "./chunk-RXDG57B2.js";
60
+ } from "./chunk-PBJZQZPO.js";
61
61
  import {
62
62
  GLOBAL_FLAGS,
63
63
  READ_SINGLE_FLAGS,
@@ -67,11 +67,11 @@ import {
67
67
  } from "./chunk-QLKGOIWS.js";
68
68
  import {
69
69
  DESCRIPTIONS
70
- } from "./chunk-5LGKZBAY.js";
70
+ } from "./chunk-XDPU2YAF.js";
71
71
  import {
72
72
  parseDocument,
73
73
  readFileFlag
74
- } from "./chunk-RKNW4UX4.js";
74
+ } from "./chunk-JKOQX46J.js";
75
75
  import "./chunk-FDJMAF7D.js";
76
76
  import {
77
77
  defaultReadStdin,
@@ -79,7 +79,7 @@ import {
79
79
  } from "./chunk-ZYURL5VK.js";
80
80
  import {
81
81
  AUTH_NEEDED
82
- } from "./chunk-SCUTAREU.js";
82
+ } from "./chunk-EWSOIFG2.js";
83
83
 
84
84
  // src/commands/account-insights.ts
85
85
  import { defineCommand } from "citty";
@@ -293,6 +293,41 @@ async function updateTeam(f) {
293
293
  await fail(err, f);
294
294
  }
295
295
  }
296
+ var eventsCmd = defineCommand3({
297
+ meta: {
298
+ name: "events",
299
+ description: "One Account's limit hits, newest first: each entry is an action Curviate refused at a safety limit or pause (blocked true), or a pause lifted early. Filter by --budget-row, --since and --until. A read: no LinkedIn call, one API call per page.",
300
+ risk: "read",
301
+ seeAlso: ["curviate account safety get", "curviate account safety update"],
302
+ examples: ["curviate account safety events acc_YOUR_ACCOUNT_ID", "curviate account safety events acc_YOUR_ACCOUNT_ID --budget-row profile_views --since 2026-11-01T00:00:00Z"]
303
+ },
304
+ args: {
305
+ ...readOnly(READ_SINGLE_FLAGS),
306
+ accountId: ACCOUNT_REQUIRED,
307
+ "budget-row": { type: "string", description: "Only hits on this budget row, for example profile_views." },
308
+ since: { type: "string", description: "Only hits at or after this time (ISO 8601)." },
309
+ until: { type: "string", description: "Only hits before this time (ISO 8601)." },
310
+ limit: { type: "string", description: "Hits per page (1 to 100)." },
311
+ cursor: { type: "string", description: "The cursor from the previous page." }
312
+ },
313
+ async run({ args }) {
314
+ const f = args;
315
+ const params = {};
316
+ for (const [flag, key] of [["budget-row", "budget_row"], ["since", "since"], ["until", "until"], ["cursor", "cursor"]]) {
317
+ const v = f[flag];
318
+ if (v === void 0) continue;
319
+ if (v.trim() === "") usage(`--${flag} was given an empty value.`);
320
+ params[key] = v;
321
+ }
322
+ if (f.limit !== void 0) params["limit"] = intFlag("limit", f.limit, 1, 100);
323
+ const c = await rootClient(f);
324
+ try {
325
+ renderSuccess(await c.accounts.listSafetyEvents(String(f.accountId ?? ""), params), outputOpts(f), process);
326
+ } catch (err) {
327
+ await fail(err, f);
328
+ }
329
+ }
330
+ });
296
331
  var updateCmd = defineCommand3({
297
332
  meta: {
298
333
  name: "update",
@@ -354,8 +389,8 @@ var updateCmd = defineCommand3({
354
389
  }
355
390
  });
356
391
  var accountSafetyCommand = defineCommand3({
357
- meta: { name: "safety", description: "Read or change one Account's safety policy (limits per budget row, Active hours, the Activity level), or with --team your Team's email defaults." },
358
- subCommands: { get: getCmd, update: updateCmd },
392
+ meta: { name: "safety", description: "Read or change one Account's safety policy (limits per budget row, Active hours, the Activity level), read its limit hits (events), or with --team your Team's email defaults." },
393
+ subCommands: { get: getCmd, update: updateCmd, events: eventsCmd },
359
394
  async run() {
360
395
  process.stderr.write("Usage: curviate account safety get|update <account> | --team\n");
361
396
  }
@@ -688,7 +723,7 @@ var connectRequestCommand = defineCommand4({
688
723
  meta: { name: "connect-request", description: "Connect a LinkedIn account without any credential passing through you: create a request, give the person its link, read it until done." },
689
724
  subCommands: { create: createCmd, get: getCmd2, cancel: cancelCmd },
690
725
  async run() {
691
- const { showHelp } = await import("./examples-J4X5NEIE.js");
726
+ const { showHelp } = await import("./examples-5FJS47QF.js");
692
727
  await showHelp(connectRequestCommand, ["curviate", "account", "connect-request"]);
693
728
  }
694
729
  });
@@ -719,7 +754,7 @@ function resolveOutputOpts(flags) {
719
754
  async function handleError(err, outOpts, out) {
720
755
  const { CurviateError } = await import("@curviate/sdk");
721
756
  if (err instanceof CurviateError) {
722
- const { getExitCode } = await import("./exit-codes-P2FLCKM7.js");
757
+ const { getExitCode } = await import("./exit-codes-LQDMGDII.js");
723
758
  renderError(err, outOpts, out);
724
759
  process.exit(getExitCode(err));
725
760
  }
@@ -1004,7 +1039,8 @@ function resolveCredentialIO(io) {
1004
1039
  }
1005
1040
  function printConnected(result, ctx) {
1006
1041
  const r = result;
1007
- ctx.out.stderr.write(`Account ${ctx.successVerb}: ${r.account_id ?? ""}
1042
+ const seat = result.seat_id;
1043
+ ctx.out.stderr.write(`Account ${ctx.successVerb}: ${r.account_id ?? ""}${seat ? ` (seat ${seat})` : ""}
1008
1044
  `);
1009
1045
  if (r.contract_selected === false) {
1010
1046
  ctx.out.stderr.write("note: the account is connected, but the Recruiter contract you named was not selected. Check the account in your dashboard.\n");
@@ -6,16 +6,16 @@ import {
6
6
  grammarParams,
7
7
  renderOverview,
8
8
  windowParams
9
- } from "./chunk-RTT75CXE.js";
10
- import "./chunk-5S3MJVI5.js";
9
+ } from "./chunk-XXB4MAX3.js";
11
10
  import "./chunk-PPGKQJKU.js";
12
- import "./chunk-3ZQNOKEK.js";
11
+ import "./chunk-5S3MJVI5.js";
12
+ import "./chunk-5OAJ4D65.js";
13
13
  import "./chunk-NNV2OYEF.js";
14
- import "./chunk-OE4CY3ZL.js";
14
+ import "./chunk-KUVJM5CP.js";
15
15
  import "./chunk-QM57YDJE.js";
16
- import "./chunk-RXDG57B2.js";
16
+ import "./chunk-PBJZQZPO.js";
17
17
  import "./chunk-QLKGOIWS.js";
18
- import "./chunk-5LGKZBAY.js";
18
+ import "./chunk-XDPU2YAF.js";
19
19
  import "./chunk-ZYURL5VK.js";
20
20
  export {
21
21
  GRAMMAR_ARGS,
@@ -4,14 +4,14 @@ import {
4
4
  outputOpts,
5
5
  rootClient,
6
6
  usage
7
- } from "./chunk-3ZQNOKEK.js";
7
+ } from "./chunk-5OAJ4D65.js";
8
8
  import {
9
9
  buildPreviewOutput
10
10
  } from "./chunk-TCUYH5GO.js";
11
11
  import {
12
12
  renderSuccess
13
13
  } from "./chunk-QM57YDJE.js";
14
- import "./chunk-RXDG57B2.js";
14
+ import "./chunk-PBJZQZPO.js";
15
15
  import {
16
16
  READ_SINGLE_FLAGS,
17
17
  WRITE_SINGLE_FLAGS,
@@ -19,7 +19,7 @@ import {
19
19
  } from "./chunk-QLKGOIWS.js";
20
20
  import {
21
21
  DESCRIPTIONS
22
- } from "./chunk-5LGKZBAY.js";
22
+ } from "./chunk-XDPU2YAF.js";
23
23
  import "./chunk-ZYURL5VK.js";
24
24
 
25
25
  // src/commands/beta-consent.ts
@@ -72,7 +72,7 @@ var betaCommand = defineCommand({
72
72
  meta: { name: "beta", description: DESCRIPTIONS.beta },
73
73
  subCommands: { status: statusCmd, update: updateCmd },
74
74
  async run() {
75
- const { showHelp } = await import("./examples-J4X5NEIE.js");
75
+ const { showHelp } = await import("./examples-5FJS47QF.js");
76
76
  await showHelp(betaCommand, ["curviate", "beta"]);
77
77
  }
78
78
  });
@@ -0,0 +1,19 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ billingCommand,
4
+ confirmMoney
5
+ } from "./chunk-7F6B7P32.js";
6
+ import "./chunk-GOICALYQ.js";
7
+ import "./chunk-5OAJ4D65.js";
8
+ import "./chunk-TCUYH5GO.js";
9
+ import "./chunk-NNV2OYEF.js";
10
+ import "./chunk-KUVJM5CP.js";
11
+ import "./chunk-QM57YDJE.js";
12
+ import "./chunk-PBJZQZPO.js";
13
+ import "./chunk-QLKGOIWS.js";
14
+ import "./chunk-XDPU2YAF.js";
15
+ import "./chunk-ZYURL5VK.js";
16
+ export {
17
+ billingCommand,
18
+ confirmMoney
19
+ };
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  fail,
4
4
  outputOpts
5
- } from "./chunk-3ZQNOKEK.js";
5
+ } from "./chunk-5OAJ4D65.js";
6
6
 
7
7
  // src/lib/chunks.ts
8
8
  async function sendInChunks(ids, size, send, f) {
@@ -32,7 +32,7 @@ async function sendChunked(chunks, send, f, unit) {
32
32
  `);
33
33
  return fail(err, f);
34
34
  }
35
- const { getExitCode } = await import("./exit-codes-P2FLCKM7.js");
35
+ const { getExitCode } = await import("./exit-codes-LQDMGDII.js");
36
36
  const e = err.toJSON();
37
37
  if (outputOpts(f).json) process.stdout.write(JSON.stringify({ error: e, progress }) + "\n");
38
38
  process.stderr.write(
@@ -6,7 +6,7 @@ import {
6
6
  import {
7
7
  createClient,
8
8
  resolveEffectiveConfig
9
- } from "./chunk-RXDG57B2.js";
9
+ } from "./chunk-PBJZQZPO.js";
10
10
 
11
11
  // src/lib/root-command.ts
12
12
  var outputOpts = (f) => ({
@@ -35,7 +35,7 @@ async function rootClient(f) {
35
35
  async function fail(err, f) {
36
36
  const { CurviateError } = await import("@curviate/sdk");
37
37
  if (err instanceof CurviateError) {
38
- const { getExitCode } = await import("./exit-codes-P2FLCKM7.js");
38
+ const { getExitCode } = await import("./exit-codes-LQDMGDII.js");
39
39
  renderError(err, outputOpts(f), process);
40
40
  process.exit(getExitCode(err));
41
41
  }
@@ -3,7 +3,7 @@ import {
3
3
  parseDocument,
4
4
  readFileFlag,
5
5
  readStdinCapped
6
- } from "./chunk-RKNW4UX4.js";
6
+ } from "./chunk-JKOQX46J.js";
7
7
  import {
8
8
  isStdinToken
9
9
  } from "./chunk-ZYURL5VK.js";
@@ -7,13 +7,13 @@ import {
7
7
  outputOpts,
8
8
  rootClient,
9
9
  usage
10
- } from "./chunk-3ZQNOKEK.js";
11
- import {
12
- intFlag
13
- } from "./chunk-NNV2OYEF.js";
10
+ } from "./chunk-5OAJ4D65.js";
14
11
  import {
15
12
  buildPreviewOutput
16
13
  } from "./chunk-TCUYH5GO.js";
14
+ import {
15
+ intFlag
16
+ } from "./chunk-NNV2OYEF.js";
17
17
  import {
18
18
  pageDelayFromFlags,
19
19
  readCursorFlag,
@@ -21,14 +21,14 @@ import {
21
21
  readablePage,
22
22
  rejectPaginationModifiersWithoutAll,
23
23
  streamAll
24
- } from "./chunk-OE4CY3ZL.js";
24
+ } from "./chunk-KUVJM5CP.js";
25
25
  import {
26
26
  renderSuccess,
27
27
  writeNdjsonItem
28
28
  } from "./chunk-QM57YDJE.js";
29
29
  import {
30
30
  downloadBinary
31
- } from "./chunk-RXDG57B2.js";
31
+ } from "./chunk-PBJZQZPO.js";
32
32
  import {
33
33
  GLOBAL_FLAGS,
34
34
  READ_SINGLE_FLAGS,
@@ -37,8 +37,7 @@ import {
37
37
  } from "./chunk-QLKGOIWS.js";
38
38
  import {
39
39
  DESCRIPTIONS
40
- } from "./chunk-5LGKZBAY.js";
41
- import "./chunk-ZYURL5VK.js";
40
+ } from "./chunk-XDPU2YAF.js";
42
41
 
43
42
  // src/commands/billing.ts
44
43
  import { defineCommand } from "citty";
@@ -119,9 +118,9 @@ async function runPdf(c, f) {
119
118
  process.stderr.write(`Invoice ${number}: ${bytes.length} bytes${f.output === "-" ? "" : ` written to ${f.output}`}.
120
119
  `);
121
120
  }
122
- async function confirmMoney(f, question) {
121
+ async function confirmMoney(f, question, priceHint = "Read the price first with `curviate billing quote`.") {
123
122
  if (f.yes) return true;
124
- if (!process.stdin.isTTY) usage("this charges money: pass --yes to confirm (no terminal to ask at). Read the price first with `curviate billing quote`.");
123
+ if (!process.stdin.isTTY) usage(`this charges money: pass --yes to confirm (no terminal to ask at). ${priceHint}`);
125
124
  process.stderr.write(`${question} [y/N] `);
126
125
  const answer = await new Promise((resolve) => {
127
126
  process.stdin.setEncoding("utf8");
@@ -235,14 +234,126 @@ var changesCmd = defineCommand({
235
234
  args: { ...readOnly(GLOBAL_FLAGS) },
236
235
  run: online(runChanges)
237
236
  });
237
+ async function runSeatsAdd(f) {
238
+ const qty = intFlag("qty", f.qty ?? usage("how many seats? `curviate billing seats add <qty>`, 1 to 50."), 1, 50);
239
+ const body = { qty };
240
+ if (f.preview) return void process.stdout.write(JSON.stringify(buildPreviewOutput({ method: "accounts.addSeats", args: {}, body })) + "\n");
241
+ const c = await rootClient(f);
242
+ if (!await confirmMoney(f, `Buy ${qty} seat${qty === 1 ? "" : "s"} now? Each costs the price of its step (\`curviate billing quote\`); a yearly plan charges today.`)) return;
243
+ try {
244
+ renderSuccess(await c.accounts.addSeats(body), outputOpts(f), process);
245
+ } catch (err) {
246
+ await fail(err, f);
247
+ }
248
+ }
249
+ async function runSeatsRemove(f) {
250
+ const seatId = (f.seatId ?? "").trim() || usage("which seat? `curviate billing seats remove <seat_id>` (`curviate account seats` lists them).");
251
+ if (f.preview) return void process.stdout.write(JSON.stringify(buildPreviewOutput({ method: "accounts.cancelSeat", args: { seat_id: seatId }, body: {} })) + "\n");
252
+ const c = await rootClient(f);
253
+ if (!await confirmMoney(f, `Remove seat ${seatId} at the end of the current period? Its Account disconnects then.`)) return;
254
+ try {
255
+ renderSuccess(await c.accounts.cancelSeat(seatId), outputOpts(f), process);
256
+ } catch (err) {
257
+ await fail(err, f);
258
+ }
259
+ }
260
+ async function runPeriodSet(f) {
261
+ if (f.to !== "annual") usage("`curviate billing period set annual`: the one switch is monthly to yearly; there is no switch back.");
262
+ if (f.preview) return void process.stdout.write(JSON.stringify(buildPreviewOutput({ method: "billing.switchPeriod", args: {}, body: { to: "annual" } })) + "\n");
263
+ const c = await rootClient(f);
264
+ if (!await confirmMoney(f, "Switch to yearly billing at your next renewal? The renewal bills the whole year; there is no switch back to monthly.")) return;
265
+ try {
266
+ renderSuccess(await c.billing.switchPeriod(), outputOpts(f), process);
267
+ } catch (err) {
268
+ await fail(err, f);
269
+ }
270
+ }
271
+ var YES = { yes: { type: "boolean", description: "Confirm without a prompt (needed when no terminal can ask)." } };
272
+ var seatsAddCmd = defineCommand({
273
+ meta: {
274
+ name: "add",
275
+ description: "Buy seats now, inside your Team's spending cap: each seat costs the price of the step it falls in (`curviate billing quote`); a monthly plan prorates on the next invoice, a yearly plan charges today. This charges money: it asks first at a terminal; elsewhere pass --yes. An add past the spending cap is refused (SPENDING_CAP_REACHED) and buys nothing; from 80% of the cap the answer carries a SPENDING_CAP_NEAR notice. Only an Owner raises the cap, in the dashboard. Owners only.",
276
+ risk: "write",
277
+ rules: {
278
+ changes: "The subscription's seat count, and the bill.",
279
+ visible_to: "Your Team's Owners (the bill, the change log).",
280
+ budget_rows: [],
281
+ retry: "Never blind: every call buys the seats it asks for. After a timeout, read `curviate account seats` first.",
282
+ undo: "`curviate billing seats remove <seat_id>`, at the end of the period."
283
+ },
284
+ errors: {
285
+ SPENDING_CAP_REACHED: "the add would pass your Team's spending cap; nothing was bought. An Owner raises the cap in Settings, Billing.",
286
+ INSUFFICIENT_ROLE: "only an Owner buys seats."
287
+ },
288
+ seeAlso: ["curviate billing quote", "curviate billing cap", "curviate account seats"],
289
+ examples: ["curviate billing seats add 2", "curviate billing seats add 1 --yes --json"]
290
+ },
291
+ args: { ...WRITE_SINGLE_FLAGS, qty: { type: "positional", description: "How many seats to buy, 1 to 50." }, ...YES },
292
+ run: async ({ args }) => runSeatsAdd(args)
293
+ });
294
+ var seatsRemoveCmd = defineCommand({
295
+ meta: {
296
+ name: "remove",
297
+ description: "Remove one seat at the end of the current period, never checked against the spending cap. Asks first at a terminal; elsewhere pass --yes. Your Team's last paid seat is refused (CANCEL_IN_DASHBOARD): removing it cancels the subscription, which an Owner does in the dashboard. Owners only.",
298
+ risk: "write",
299
+ rules: {
300
+ changes: "The seat ends at the period end; the renewal bills one seat fewer.",
301
+ visible_to: "Your Team's Owners; the Account on the seat disconnects when it ends.",
302
+ budget_rows: [],
303
+ retry: "Safe: a seat already scheduled answers with its date.",
304
+ undo: "Keep the seat in the dashboard before the period ends."
305
+ },
306
+ errors: { CANCEL_IN_DASHBOARD: "the last paid seat: an Owner cancels in the dashboard.", INSUFFICIENT_ROLE: "only an Owner removes seats." },
307
+ seeAlso: ["curviate account seats", "curviate billing changes"],
308
+ examples: ["curviate billing seats remove seat_YOUR_SEAT_ID"]
309
+ },
310
+ args: { ...WRITE_SINGLE_FLAGS, seatId: { type: "positional", description: "The seat (seat_...), from `curviate account seats`." }, ...YES },
311
+ run: async ({ args }) => runSeatsRemove(args)
312
+ });
313
+ var seatsCmd = defineCommand({
314
+ meta: { name: "seats", description: "Buy seats inside the spending cap, or remove one at the end of the period. Cancelling the subscription is the dashboard's." },
315
+ subCommands: { add: seatsAddCmd, remove: seatsRemoveCmd },
316
+ async run() {
317
+ const { showHelp } = await import("./examples-5FJS47QF.js");
318
+ await showHelp(seatsCmd, ["curviate", "billing", "seats"]);
319
+ }
320
+ });
321
+ var periodSetCmd = defineCommand({
322
+ meta: {
323
+ name: "set",
324
+ description: "Switch a monthly subscription to yearly billing at its next renewal, for the same seats at the yearly price. Nothing is charged now; the renewal bills the full year. There is no switch back. Asks first at a terminal; elsewhere pass --yes. Owners only.",
325
+ risk: "write",
326
+ rules: {
327
+ changes: "The billing period, from the next renewal.",
328
+ visible_to: "Your Team's Owners.",
329
+ budget_rows: [],
330
+ retry: "Safe: a second call while the switch is pending changes nothing.",
331
+ undo: "None: there is no switch back to monthly."
332
+ },
333
+ errors: { INVALID_REQUEST: "already billed yearly.", INSUFFICIENT_ROLE: "only an Owner switches the period." },
334
+ examples: ["curviate billing period set annual"]
335
+ },
336
+ args: { ...WRITE_SINGLE_FLAGS, to: { type: "positional", description: "annual (the one switch)." }, ...YES },
337
+ run: async ({ args }) => runPeriodSet(args)
338
+ });
339
+ var periodCmd = defineCommand({
340
+ meta: { name: "period", description: "Your billing period: switch monthly to yearly." },
341
+ subCommands: { set: periodSetCmd },
342
+ async run() {
343
+ const { showHelp } = await import("./examples-5FJS47QF.js");
344
+ await showHelp(periodCmd, ["curviate", "billing", "period"]);
345
+ }
346
+ });
238
347
  var billingCommand = defineCommand({
239
348
  meta: { name: "billing", description: DESCRIPTIONS.billing },
240
- subCommands: { quote: quoteCmd, cap: capCmd, changes: changesCmd, invoices: invoicesCmd, price: priceCmd },
349
+ subCommands: { quote: quoteCmd, cap: capCmd, changes: changesCmd, invoices: invoicesCmd, price: priceCmd, seats: seatsCmd, period: periodCmd },
241
350
  async run() {
242
- const { showHelp } = await import("./examples-J4X5NEIE.js");
351
+ const { showHelp } = await import("./examples-5FJS47QF.js");
243
352
  await showHelp(billingCommand, ["curviate", "billing"]);
244
353
  }
245
354
  });
355
+
246
356
  export {
357
+ confirmMoney,
247
358
  billingCommand
248
359
  };
@@ -4,7 +4,7 @@ import {
4
4
  } from "./chunk-UEAX6KUB.js";
5
5
  import {
6
6
  readableId
7
- } from "./chunk-OE4CY3ZL.js";
7
+ } from "./chunk-KUVJM5CP.js";
8
8
 
9
9
  // src/lib/member-id.ts
10
10
  var MEMBER_PROVIDER_ID_RE = /^A[CDE][A-Za-z0-9_-]{4,}$/;
@@ -207,6 +207,20 @@ var EXIT_CODE_MAP = {
207
207
  MAILBOX_LIMIT_REACHED: 2,
208
208
  MAILBOX_APP_PASSWORD_REQUIRED: 2,
209
209
  MAILBOX_ADMIN_APPROVAL_REQUIRED: 5,
210
+ // Placement tests: the monthly allowance comes with paid seats (5, a seat or the new month lifts it, never a
211
+ // wait of minutes, so not 6); tests that cannot run at all today are "not available" (1, as PLATFORM_NOT_IMPLEMENTED).
212
+ PLACEMENT_TEST_ALLOWANCE_EXHAUSTED: 5,
213
+ PLACEMENT_TESTS_UNAVAILABLE: 1,
214
+ // Mailboxes from Curviate: a missing order is 4; a domain refused as named never succeeds as sent (2); an order
215
+ // already waiting on the domain is a state (8); a trial Team cannot order (11, billing); orders paused is "not
216
+ // available" (1).
217
+ MAILBOX_PURCHASE_NOT_FOUND: 4,
218
+ DOMAIN_IN_USE: 2,
219
+ DOMAIN_IS_COMPANY_EMAIL: 2,
220
+ MAILBOX_PURCHASE_PENDING: 8,
221
+ MAILBOX_PURCHASE_STATE_CONFLICT: 8,
222
+ MAILBOX_PURCHASE_TRIAL: 11,
223
+ MAILBOX_SALES_PAUSED: 1,
210
224
  // Seat calls: only an Owner raises the spending cap or cancels in the dashboard (5, someone else acts first).
211
225
  SPENDING_CAP_REACHED: 5,
212
226
  CANCEL_IN_DASHBOARD: 5,
@@ -235,6 +249,8 @@ var EXIT_CODE_MAP = {
235
249
  LEAD_NOT_ENROLLABLE: 2,
236
250
  CHAT_NOT_ONE_TO_ONE: 2,
237
251
  REPLY_NOT_LABELLABLE: 2,
252
+ NOT_A_REFERRAL: 2,
253
+ EMAIL_UNAVAILABLE: 2,
238
254
  STEP_IN_FLIGHT: 7,
239
255
  // Voice clips: the file is empty, not audio, undecodable or outside 1 to 120 seconds; it never succeeds as sent.
240
256
  VOICE_CLIP_INVALID: 2,
@@ -243,6 +259,7 @@ var EXIT_CODE_MAP = {
243
259
  };
244
260
  function getExitCode(error) {
245
261
  if (typeof error === "string") return EXIT_CODE_MAP[error] ?? 1;
262
+ if (error.outcomeUnknown === true) return 1;
246
263
  if (error.code === "INTERNAL" && error.httpStatus === void 0 && error.retryLikelyToSucceed === true) return 7;
247
264
  return EXIT_CODE_MAP[error.code] ?? 1;
248
265
  }