@curviate/cli 0.7.1 → 0.8.0

package/CHANGELOG.md

@@ -8,6 +8,26 @@ a new command or flag is a minor; a breaking command/flag/exit-code change is a
 
 ## [Unreleased]
 
+## [0.8.0] - 2026-07-02
+
+### Added
+
+- `recruiter reject-applicant` gained `--message` and `--notify-at` flags. The applicant is only notified of the rejection when `--message` is provided (the prior behavior — no notification — is unchanged when both are omitted). `--notify-at` schedules the notification (a UNIX-milliseconds timestamp) and requires `--message`; passing `--notify-at` alone, or a non-numeric value, is a usage error (exit `2`).
+- README gained dedicated "Sales Navigator" and "Recruiter" sections with numbered, runnable examples covering every in-scope command: searching and getting profiles, saving a lead, starting a chat, listing/searching Recruiter people and hiring projects, the job create → publish → checkpoint lifecycle, listing/getting applicants, downloading a resume, and rejecting an applicant with and without a notification.
+
+### Changed
+
+- **Help output cleanup:** Recruiter and Sales Navigator write commands (`add-candidate`, `add-applicant`, `reject-applicant`, `job create`/`publish`/`checkpoint`, `save-lead`, `message new`) and single-object read commands (`profile`, `project`, `applicant`, `applicant resume`) no longer advertise `--limit`/`--cursor`/`--all`/`--max-pages` in `--help` — those flags only ever applied to list/search commands, which keep them unchanged. Single-object reads keep `--fields`.
+- Corrected the `search parameters --type` flag description on both `recruiter` and `sales-nav` — it previously suggested example values (`LOCATION`, `INDUSTRY`, `TITLE`) that the API does not accept for either surface; it now lists the real accepted values.
+- Polished the `message new --to` flag description on both surfaces with the expected provider-ID format and a note that it is not resolved from a URL or slug.
+- Updated `@curviate/sdk` dependency to `^0.8.0`. No resource method signatures changed (per the SDK 0.8.0 changelog); Recruiter's job-lifecycle endpoints (applicant get/reject/resume, applicant list, job publish/checkpoint, Recruiter profile) are now fully implemented server-side instead of returning `501`.
+
+## [0.7.2] - 2026-07-01
+
+### Changed
+
+- Updated `@curviate/sdk` dependency to `^0.7.0`. The `recruiter message new` command output now reflects the aligned start-chat response `{ object, chat_id, message_id }` (the SDK dropped the `attendee_ids` echo and now surfaces `message_id`). The command sends the request unchanged (`attendees_ids` plus recruiter-specific flags); it renders the server response verbatim, so no command flags change.
+
 ## [0.7.1] - 2026-07-01
 
 ### Fixed

package/README.md

@@ -158,6 +158,175 @@ curviate account list --all --json \
   > accounts.csv
 ```
 
+## Sales Navigator
+
+Sales Navigator commands (`curviate sales-nav ...`) require an account with the Sales Navigator
+add-on tier attached. A call against an account without it fails with **exit code `5`** and a
+`TIER_NOT_ACTIVE` error body naming the required tier (`sales_nav`) — branch on the exit code the
+same way as example 4 above. Write commands (`save-lead`, `message new`) accept `--preview` to
+render the request without sending it.
+
+### 1. Search Sales Navigator profiles, then get one full profile
+
+```bash
+curviate sales-nav search people \
+  --keywords "VP Engineering" \
+  --account acc_1 \
+  --limit 5 \
+  | jq -r '.items[0].id' \
+  | xargs -I{} curviate sales-nav profile {} --account acc_1
+```
+
+### 2. Save a lead to a specific lead list
+
+Preview first, then send:
+
+```bash
+curviate sales-nav save-lead ACwAAA1234567 \
+  --account acc_1 \
+  --list-id 987654 \
+  --preview
+
+curviate sales-nav save-lead ACwAAA1234567 --account acc_1 --list-id 987654
+```
+
+### 3. Start a new Sales Navigator chat
+
+```bash
+curviate sales-nav message new \
+  --to ACwAAA1234567 \
+  --account acc_1 \
+  "Hi — I'd love to connect about an opportunity at our company."
+```
+
+### 4. Search Sales Navigator companies
+
+```bash
+curviate sales-nav search companies \
+  --keywords "series B fintech" \
+  --account acc_1 \
+  --limit 5 --json \
+  | jq -r '.items[] | "\(.id)\t\(.name)"'
+```
+
+## Recruiter
+
+Recruiter commands (`curviate recruiter ...`) require an account with the Recruiter add-on tier
+attached. A call against an account without it fails with **exit code `5`** and a `TIER_NOT_ACTIVE`
+error body naming the required tier (`recruiter`). Write commands (`add-candidate`,
+`add-applicant`, `reject-applicant`, `job create`/`publish`/`checkpoint`, `message new`) accept
+`--preview` to render the request without sending it.
+
+### 1. List hiring projects
+
+```bash
+curviate recruiter projects --account acc_1 --limit 20 --json \
+  | jq -r '.items[] | "\(.id)\t\(.name)"'
+```
+
+### 2. Create a job posting draft, then publish it (with the checkpoint flow)
+
+Publishing can return a verification checkpoint instead of a published job — solve it with the
+`job_id` from the publish response, then retry:
+
+```bash
+curviate recruiter job create \
+  --account acc_1 \
+  --job-title "Senior Backend Engineer" \
+  --description "Remote-first team building the core platform." \
+  --employment-type FULL_TIME \
+  --json > draft.json
+
+JOB_ID=$(jq -r '.job_id' draft.json)
+
+curviate recruiter job publish "$JOB_ID" --account acc_1 --mode FREE --json > publish.json
+
+# If publish returns a checkpoint object instead of a published job, solve it:
+if [ "$(jq -r '.object // empty' publish.json)" = "job_posting_checkpoint" ]; then
+  curviate recruiter job checkpoint "$JOB_ID" --account acc_1 --input "123456"
+fi
+```
+
+### 3. List applicants for a job, then get one applicant's detail
+
+```bash
+curviate recruiter job applicants "$JOB_ID" --account acc_1 --limit 10 --json \
+  | jq -r '.items[0].id' \
+  | xargs -I{} curviate recruiter applicant {} --account acc_1
+```
+
+### 4. Download an applicant's resume
+
+```bash
+curviate recruiter applicant resume APPLICANT_ID --account acc_1 -o resume.pdf
+```
+
+### 5. Reject an applicant, optionally notifying them
+
+The applicant is only notified when `--message` is given; omit it to reject silently.
+`--notify-at` (a UNIX-ms timestamp to schedule the notification) requires `--message`.
+
+```bash
+# Silent rejection — no notification sent
+curviate recruiter reject-applicant AEM789 \
+  --account acc_1 \
+  --hiring-project-id proj_abc \
+  --reason NOT_MEET_BASIC_QUALIFICATIONS
+
+# Rejection with a notification to the applicant
+curviate recruiter reject-applicant AEM789 \
+  --account acc_1 \
+  --hiring-project-id proj_abc \
+  --reason NOT_MEET_BASIC_QUALIFICATIONS \
+  --message "Thanks for applying — we've decided to move forward with other candidates." \
+  --preview
+```
+
+### 6. Search Recruiter people
+
+```bash
+curviate recruiter search people \
+  --keywords "senior backend engineer" \
+  --account acc_1 \
+  --limit 5 --json \
+  | jq -r '.items[] | "\(.id)\t\(.full_name // .headline)"'
+```
+
+### 7. Add a candidate to a hiring project, then promote them to applicant
+
+```bash
+curviate recruiter add-candidate AEM789 \
+  --account acc_1 \
+  --hiring-project-id proj_abc \
+  --stage UNCONTACTED
+
+# Once they've applied, move them to the applicant pool:
+curviate recruiter add-applicant AEM789 \
+  --account acc_1 \
+  --hiring-project-id proj_abc \
+  --stage CONTACTED
+```
+
+### 8. Inspect a single hiring project, then list its job postings
+
+```bash
+curviate recruiter project proj_abc --account acc_1 --json
+
+curviate recruiter jobs --account acc_1 --limit 10 --json \
+  | jq -r '.items[] | "\(.id)\t\(.title)\t\(.state)"'
+```
+
+### 9. Get a Recruiter-enriched profile, then start a chat with them
+
+```bash
+curviate recruiter profile "https://www.linkedin.com/in/example" --account acc_1 --json
+
+curviate recruiter message new \
+  --to AEM789 \
+  --account acc_1 \
+  "Hi — I came across your profile and think you'd be a great fit for a role we're hiring for."
+```
+
 ## Exit codes
 
 | Code | Meaning |

package/dist/cli.js

@@ -152,8 +152,8 @@ var main = defineCommand({
     post: () => import("./post-KBSR3ADF.js").then((m) => m.postCommand),
     account: () => import("./account-O5GZNE72.js").then((m) => m.accountCommand),
     webhook: () => import("./webhook-F6CRIISR.js").then((m) => m.webhookCommand),
-    "sales-nav": () => import("./sales-nav-LSBARRGL.js").then((m) => m.salesNavCommand),
-    recruiter: () => import("./recruiter-3JHYSZPL.js").then((m) => m.recruiterCommand)
+    "sales-nav": () => import("./sales-nav-4DYBMHKN.js").then((m) => m.salesNavCommand),
+    recruiter: () => import("./recruiter-B5UIHTIN.js").then((m) => m.recruiterCommand)
   },
   async run() {
     const { runMain } = await import("citty");

package/dist/{recruiter-3JHYSZPL.js → recruiter-B5UIHTIN.js}

@@ -29,7 +29,9 @@ import {
   resolveEffectiveConfig
 } from "./chunk-47SYFQRF.js";
 import {
-  GLOBAL_FLAGS
+  GLOBAL_FLAGS,
+  READ_SINGLE_FLAGS,
+  WRITE_FLAGS
 } from "./chunk-TDYIQHQX.js";
 
 // src/commands/recruiter.ts
@@ -368,9 +370,28 @@ async function runRecruiterRejectApplicant(client, flags, out) {
   const accountId = requireAccount(flags.account, out);
   const userId = flags.userId ?? "";
   const outOpts = resolveOutputOpts(flags);
+  if (flags["notify-at"] && !flags.message) {
+    out.stderr.write(
+      "error: --notify-at requires --message (rejection_notification.message is required to send a notification).\n"
+    );
+    process.exit(2);
+  }
+  let notifyAt;
+  if (flags["notify-at"]) {
+    notifyAt = Number(flags["notify-at"]);
+    if (!Number.isFinite(notifyAt)) {
+      out.stderr.write("error: --notify-at must be a UNIX milliseconds timestamp (a number).\n");
+      process.exit(2);
+    }
+  }
   const body = {};
   if (flags["hiring-project-id"]) body["hiring_project_id"] = flags["hiring-project-id"];
   if (flags.reason) body["reason"] = flags.reason;
+  if (flags.message) {
+    const rejectionNotification = { message: flags.message };
+    if (notifyAt !== void 0) rejectionNotification["send_notification_at"] = notifyAt;
+    body["rejection_notification"] = rejectionNotification;
+  }
   if (flags.preview) {
     const preview = buildPreviewOutput({
       method: "recruiter.rejectApplicant",
@@ -568,14 +589,19 @@ var recruiterSyncCommand = defineCommand({
   }
 });
 var recruiterMessageNewCommand = defineCommand({
-  meta: { name: "new", description: "Start a new Recruiter chat (InMail)." },
+  meta: { name: "new", description: "Start a new Recruiter chat with a member." },
   args: {
-    ...GLOBAL_FLAGS,
-    to: { type: "string", description: "Recipient provider ID.", required: true },
-    text: { type: "positional", description: "Message text." },
-    attach: { type: "string", description: "File to attach (repeatable)." },
-    voice: { type: "string", description: "Voice message file." },
-    video: { type: "string", description: "Video message file." }
+    // Write command: WRITE_FLAGS omits pagination/projection flags
+    ...WRITE_FLAGS,
+    to: {
+      type: "string",
+      description: "Recipient's LinkedIn provider ID (AE\u2026 format, e.g. from a Recruiter search result or profile). Not resolved from a URL/slug \u2014 pass the provider ID directly.",
+      required: true
+    },
+    text: { type: "positional", description: "Opening message text." },
+    attach: { type: "string", description: "File to attach (repeatable, max 7 MiB each)." },
+    voice: { type: "string", description: "Voice message file (max 7 MiB)." },
+    video: { type: "string", description: "Video message file (max 7 MiB)." }
   },
   async run({ args }) {
     const flags = args;
@@ -608,7 +634,8 @@ var recruiterMessageCommand = defineCommand({
 var recruiterProfileCommand = defineCommand({
   meta: { name: "profile", description: "Get a Recruiter enriched member profile." },
   args: {
-    ...GLOBAL_FLAGS,
+    // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
+    ...READ_SINGLE_FLAGS,
     identifier: { type: "positional", description: "LinkedIn URL, slug, or native id." }
   },
   async run({ args }) {
@@ -663,7 +690,11 @@ var recruiterSearchParametersCommand = defineCommand({
   meta: { name: "parameters", description: "Resolve Recruiter filter parameter IDs." },
   args: {
     ...GLOBAL_FLAGS,
-    type: { type: "string", description: "Parameter type (e.g. LOCATION, INDUSTRY, TITLE).", required: true },
+    type: {
+      type: "string",
+      description: "Parameter type to resolve. One of: GROUPS, DEPARTMENT, HIRING_PROJECTS, SAVED_SEARCHES, SAVED_FILTERS, DEGREE.",
+      required: true
+    },
     keywords: { type: "string", description: "Human term to resolve (e.g. Berlin)." }
   },
   async run({ args }) {
@@ -721,7 +752,8 @@ var recruiterProjectsCommand = defineCommand({
 var recruiterProjectCommand = defineCommand({
   meta: { name: "project", description: "Get a Recruiter hiring project by ID." },
   args: {
-    ...GLOBAL_FLAGS,
+    // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
+    ...READ_SINGLE_FLAGS,
     projectId: { type: "positional", description: "Recruiter project ID." }
   },
   async run({ args }) {
@@ -745,7 +777,8 @@ var recruiterProjectCommand = defineCommand({
 var recruiterAddCandidateCommand = defineCommand({
   meta: { name: "add-candidate", description: "Add a member as a candidate in a hiring project." },
   args: {
-    ...GLOBAL_FLAGS,
+    // Write command: WRITE_FLAGS omits pagination/projection flags
+    ...WRITE_FLAGS,
     userId: { type: "positional", description: "Member ID (AEM\u2026 format)." },
     "hiring-project-id": { type: "string", description: "Recruiter hiring project ID.", required: true },
     stage: { type: "string", description: "Pipeline stage (UNCONTACTED, CONTACTED, REPLIED)." }
@@ -771,7 +804,8 @@ var recruiterAddCandidateCommand = defineCommand({
 var recruiterAddApplicantCommand = defineCommand({
   meta: { name: "add-applicant", description: "Add a member as an applicant in a hiring project." },
   args: {
-    ...GLOBAL_FLAGS,
+    // Write command: WRITE_FLAGS omits pagination/projection flags
+    ...WRITE_FLAGS,
     userId: { type: "positional", description: "Member ID (AEM\u2026 format)." },
     "hiring-project-id": { type: "string", description: "Recruiter hiring project ID.", required: true },
     stage: { type: "string", description: "Pipeline stage (UNCONTACTED, CONTACTED, REPLIED)." }
@@ -797,13 +831,22 @@ var recruiterAddApplicantCommand = defineCommand({
 var recruiterRejectApplicantCommand = defineCommand({
   meta: { name: "reject-applicant", description: "Reject an applicant from a hiring project." },
   args: {
-    ...GLOBAL_FLAGS,
+    // Write command: WRITE_FLAGS omits pagination/projection flags
+    ...WRITE_FLAGS,
     userId: { type: "positional", description: "Member ID (AEM\u2026 format)." },
     "hiring-project-id": { type: "string", description: "Recruiter hiring project ID.", required: true },
     reason: {
       type: "string",
       description: "Rejection reason (NOT_MEET_BASIC_QUALIFICATIONS, NOT_IN_DESIRED_LOCATION, MORE_QUALIFIED_CANDIDATES, WITHDREW_APPLICATION, NOT_CONSIDERED_OR_REASON_NOT_SPECIFIED).",
       required: true
+    },
+    message: {
+      type: "string",
+      description: "Rejection notification text. The applicant is only notified when --message is provided; omit it to reject silently."
+    },
+    "notify-at": {
+      type: "string",
+      description: "UNIX milliseconds timestamp to schedule the notification (default: now). Requires --message."
     }
   },
   async run({ args }) {
@@ -848,7 +891,8 @@ var recruiterJobsCommand = defineCommand({
 var recruiterJobCreateCommand = defineCommand({
   meta: { name: "create", description: "Create a Recruiter job posting draft." },
   args: {
-    ...GLOBAL_FLAGS,
+    // Write command: WRITE_FLAGS omits pagination/projection flags
+    ...WRITE_FLAGS,
     "body-file": { type: "string", description: "Path to a JSON file with the full job-create body." },
     body: { type: "string", description: "Read the JSON job-create body from stdin (pass '-')." },
     "job-title": { type: "string", description: "Job title text (merged over the JSON as job_title.text)." },
@@ -876,7 +920,8 @@ var recruiterJobCreateCommand = defineCommand({
 var recruiterJobPublishCommand = defineCommand({
   meta: { name: "publish", description: "Publish a Recruiter job posting draft." },
   args: {
-    ...GLOBAL_FLAGS,
+    // Write command: WRITE_FLAGS omits pagination/projection flags
+    ...WRITE_FLAGS,
     jobId: { type: "positional", description: "Job posting ID." },
     mode: { type: "string", description: "Publish mode: FREE (default), PROMOTED, or PROMOTED_PLUS." }
   },
@@ -901,7 +946,8 @@ var recruiterJobPublishCommand = defineCommand({
 var recruiterJobCheckpointCommand = defineCommand({
   meta: { name: "checkpoint", description: "Solve a job posting publish verification checkpoint." },
   args: {
-    ...GLOBAL_FLAGS,
+    // Write command: WRITE_FLAGS omits pagination/projection flags
+    ...WRITE_FLAGS,
     jobId: { type: "positional", description: "Job posting ID." },
     input: { type: "string", description: "Verification value (OTP or email confirmation).", required: true }
   },
@@ -965,7 +1011,8 @@ var recruiterJobCommand = defineCommand({
 var recruiterApplicantResumeCommand = defineCommand({
   meta: { name: "resume", description: "Download a job applicant's resume." },
   args: {
-    ...GLOBAL_FLAGS,
+    // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
+    ...READ_SINGLE_FLAGS,
     applicantId: { type: "positional", description: "Applicant ID." },
     output: { type: "string", alias: "o", description: "Path to write the resume file." }
   },
@@ -995,7 +1042,8 @@ var recruiterApplicantResumeCommand = defineCommand({
 var recruiterApplicantCommand = defineCommand({
   meta: { name: "applicant", description: "Recruiter job applicant operations." },
   args: {
-    ...GLOBAL_FLAGS,
+    // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
+    ...READ_SINGLE_FLAGS,
     applicantId: { type: "positional", description: "Applicant ID.", required: false }
   },
   subCommands: {

package/dist/{sales-nav-LSBARRGL.js → sales-nav-4DYBMHKN.js}

@@ -26,7 +26,9 @@ import {
   resolveEffectiveConfig
 } from "./chunk-47SYFQRF.js";
 import {
-  GLOBAL_FLAGS
+  GLOBAL_FLAGS,
+  READ_SINGLE_FLAGS,
+  WRITE_FLAGS
 } from "./chunk-TDYIQHQX.js";
 
 // src/commands/sales-nav.ts
@@ -319,12 +321,17 @@ var salesNavSyncCommand = defineCommand({
 var salesNavMessageNewCommand = defineCommand({
   meta: { name: "new", description: "Start a new Sales Navigator chat." },
   args: {
-    ...GLOBAL_FLAGS,
-    to: { type: "string", description: "Recipient provider ID.", required: true },
-    text: { type: "positional", description: "Message text." },
-    attach: { type: "string", description: "File to attach (repeatable)." },
-    voice: { type: "string", description: "Voice message file." },
-    video: { type: "string", description: "Video message file." }
+    // Write command: WRITE_FLAGS omits pagination/projection flags
+    ...WRITE_FLAGS,
+    to: {
+      type: "string",
+      description: "Recipient's LinkedIn provider ID (ACw\u2026 format, e.g. from a Sales Navigator search result or profile). Not resolved from a URL/slug \u2014 pass the provider ID directly.",
+      required: true
+    },
+    text: { type: "positional", description: "Opening message text." },
+    attach: { type: "string", description: "File to attach (repeatable, max 7 MiB each)." },
+    voice: { type: "string", description: "Voice message file (max 7 MiB)." },
+    video: { type: "string", description: "Video message file (max 7 MiB)." }
   },
   async run({ args }) {
     const flags = args;
@@ -417,7 +424,11 @@ var salesNavSearchParametersCommand = defineCommand({
   meta: { name: "parameters", description: "Resolve Sales Navigator filter parameter IDs." },
   args: {
     ...GLOBAL_FLAGS,
-    type: { type: "string", description: "Parameter type (e.g. LOCATION, INDUSTRY, TITLE).", required: true },
+    type: {
+      type: "string",
+      description: "Parameter type to resolve. One of: GROUPS, SALES_INDUSTRY, DEPARTMENT, PERSONA, ACCOUNT_LISTS, LEAD_LISTS, TECHNOLOGIES, SAVED_ACCOUNTS, SAVED_SEARCHES, RECENT_SEARCHES, REGION, POSTAL_CODE.",
+      required: true
+    },
     keywords: { type: "string", description: "Human term to resolve (e.g. Berlin)." }
   },
   async run({ args }) {
@@ -455,7 +466,8 @@ var salesNavSearchCommand = defineCommand({
 var salesNavProfileCommand = defineCommand({
   meta: { name: "profile", description: "Get a Sales Navigator enriched member profile." },
   args: {
-    ...GLOBAL_FLAGS,
+    // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
+    ...READ_SINGLE_FLAGS,
     identifier: { type: "positional", description: "LinkedIn URL, slug, or native id." }
   },
   async run({ args }) {
@@ -479,7 +491,8 @@ var salesNavProfileCommand = defineCommand({
 var salesNavSaveLeadCommand = defineCommand({
   meta: { name: "save-lead", description: "Save a Sales Navigator member as a lead." },
   args: {
-    ...GLOBAL_FLAGS,
+    // Write command: WRITE_FLAGS omits pagination/projection flags
+    ...WRITE_FLAGS,
     userId: { type: "positional", description: "Sales Navigator member ID (ACw\u2026 format)." },
     "list-id": { type: "string", description: "Lead list ID to save the lead into." }
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curviate/cli",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "private": false,
   "description": "Official command-line interface for the Curviate API.",
   "license": "MIT",
@@ -40,7 +40,7 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "dependencies": {
-    "@curviate/sdk": "^0.6.0",
+    "@curviate/sdk": "^0.8.0",
     "citty": "^0.1.6"
   },
   "devDependencies": {