@curviate/cli 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -8,6 +8,20 @@ a new command or flag is a minor; a breaking command/flag/exit-code change is a
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-06-24
+
+### Fixed
+
+- `message inmail` now requires and forwards the `--surface` flag (was silently dropped).
+- `connect respond` now requires and forwards `--shared-secret` (was silently dropped).
+- `recruiter message new` uses the correct field name `attendee_ids` (was `attendees`).
+- `recruiter job create` now forwards the full job body via JSON and scalar flags (was a no-op).
+
+### Added
+
+- `search` and `recruiter search` / `sales-navigator search` accept `--filters` for raw JSON filter objects and named filter flags (`--title`, `--company`, `--location`, `--school`, `--industry`) for common parameters.
+- `search` and `recruiter search` / `sales-navigator search` accept `--url` (profile URL filter) and `--keywords`.
+
 ## [0.1.0] - 2026-06-22
 
 ### Added

package/dist/chunk-42VUUKQ3.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+
+// src/lib/search-filters.ts
+import { readFile } from "fs/promises";
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
+var DEFAULT_FILTER_READERS = {
+  readFile: (path) => readFile(path, "utf8"),
+  readStdin
+};
+async function assembleFilters(flags, readers = DEFAULT_FILTER_READERS) {
+  let raw;
+  let source;
+  if (flags["filters-file"] !== void 0) {
+    source = `--filters-file ${flags["filters-file"]}`;
+    try {
+      raw = await readers.readFile(flags["filters-file"]);
+    } catch {
+      return { error: `cannot read ${source}` };
+    }
+  } else if (flags.filters === "-") {
+    source = "--filters - (stdin)";
+    raw = await readers.readStdin();
+  } else if (flags.filters !== void 0) {
+    source = "--filters";
+    raw = flags.filters;
+  }
+  if (raw === void 0) return { body: {} };
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return { error: `${source} is not valid JSON` };
+  }
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    return { error: `${source} must be a JSON object` };
+  }
+  return { body: parsed };
+}
+function splitCsv(value) {
+  return value.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+}
+function splitCsvNumbers(value) {
+  return splitCsv(value).map((s) => Number(s)).filter((n) => Number.isFinite(n));
+}
+
+export {
+  DEFAULT_FILTER_READERS,
+  assembleFilters,
+  splitCsv,
+  splitCsvNumbers
+};

package/dist/cli.js

@@ -141,15 +141,15 @@ var main = defineCommand({
     // ---------------------------------------------------------------------------
     profile: () => import("./profile-WXA3NC7D.js").then((m) => m.profileCommand),
     company: () => import("./company-IKVDW7MX.js").then((m) => m.companyCommand),
-    connect: () => import("./connect-HLDHFBGX.js").then((m) => m.connectCommand),
-    search: () => import("./search-LHPTHPWH.js").then((m) => m.searchCommand),
+    connect: () => import("./connect-XPXYKOII.js").then((m) => m.connectCommand),
+    search: () => import("./search-XJMVHZIZ.js").then((m) => m.searchCommand),
     inbox: () => import("./inbox-JBLYJMV2.js").then((m) => m.inboxCommand),
-    message: () => import("./message-IK7VGB63.js").then((m) => m.messageCommand),
+    message: () => import("./message-SFP2I7QE.js").then((m) => m.messageCommand),
     post: () => import("./post-EAAGVR5D.js").then((m) => m.postCommand),
     account: () => import("./account-YOW2MCZS.js").then((m) => m.accountCommand),
     webhook: () => import("./webhook-QM5LGAUF.js").then((m) => m.webhookCommand),
-    "sales-nav": () => import("./sales-nav-XGFO5I6F.js").then((m) => m.salesNavCommand),
-    recruiter: () => import("./recruiter-TGCV36EH.js").then((m) => m.recruiterCommand)
+    "sales-nav": () => import("./sales-nav-F5VK7CPD.js").then((m) => m.salesNavCommand),
+    recruiter: () => import("./recruiter-D4BO4NO4.js").then((m) => m.recruiterCommand)
   },
   async run() {
     const { runMain } = await import("citty");

package/dist/{connect-HLDHFBGX.js → connect-XPXYKOII.js}

@@ -155,11 +155,19 @@ async function runConnectRespond(client, flags, out) {
   const accountId = requireAccount(flags.account, out);
   const invitationId = flags.id ?? "";
   const action = flags.action ?? "";
+  const sharedSecret = flags["shared-secret"] ?? "";
+  if (!sharedSecret) {
+    out.stderr.write(
+      "error: --shared-secret is required. Read it from `connect received` (each item carries its per-invitation shared_secret).\n"
+    );
+    process.exit(2);
+  }
+  const body = { action, shared_secret: sharedSecret };
   if (flags.preview) {
     const preview = buildPreviewOutput({
       method: "invites.respond",
       args: { invitation_id: invitationId },
-      body: { action },
+      body,
       account: accountId
     });
     out.stdout.write(JSON.stringify(preview) + "\n");
@@ -168,7 +176,7 @@ async function runConnectRespond(client, flags, out) {
   const ns = client.account(accountId);
   const outOpts = resolveOutputOpts(flags);
   try {
-    const result = await ns.invites.respond(invitationId, { action });
+    const result = await ns.invites.respond(invitationId, body);
     renderSuccess(result, outOpts, out);
   } catch (err) {
     const { CurviateError } = await import("@curviate/sdk");
@@ -232,7 +240,10 @@ var connectSentCommand = defineCommand({
   }
 });
 var connectReceivedCommand = defineCommand({
-  meta: { name: "received", description: "List received connection invitations." },
+  meta: {
+    name: "received",
+    description: "List received connection invitations. Each item carries a shared_secret \u2014 pass it to `connect respond --shared-secret`."
+  },
   args: { ...GLOBAL_FLAGS },
   async run({ args }) {
     const flags = args;
@@ -257,7 +268,12 @@ var connectRespondCommand = defineCommand({
   args: {
     ...GLOBAL_FLAGS,
     id: { type: "positional", description: "Invitation id to respond to." },
-    action: { type: "string", description: "Response action: accept or decline.", required: true }
+    action: { type: "string", description: "Response action: accept or decline.", required: true },
+    "shared-secret": {
+      type: "string",
+      description: "Per-invitation shared secret \u2014 read it from `connect received`.",
+      required: true
+    }
   },
   async run({ args }) {
     const flags = args;

package/dist/{message-IK7VGB63.js → message-SFP2I7QE.js}

@@ -62,6 +62,8 @@ function normalizeAttachPaths(attach) {
   if (!attach) return [];
   return Array.isArray(attach) ? attach : [attach];
 }
+var INMAIL_SURFACES = ["sales_nav", "recruiter"];
+var MEMBER_URN_RE = /^urn:li:member:\d+$/;
 async function handleSdkError(err, outOpts, out) {
   const { CurviateError } = await import("@curviate/sdk");
   if (err instanceof CurviateError) {
@@ -268,11 +270,26 @@ async function runMessageAttachment(client, flags, out, isTTY) {
 }
 async function runMessageInMail(client, flags, out) {
   const accountId = requireAccount(flags.account, out);
+  const surface = flags.surface ?? "";
+  if (!INMAIL_SURFACES.includes(surface)) {
+    out.stderr.write(
+      `error: --surface is required and must be one of ${INMAIL_SURFACES.join(", ")}.
+`
+    );
+    process.exit(2);
+  }
   const recipientUrn = resolveIdentifier(flags.to ?? "");
+  if (!MEMBER_URN_RE.test(recipientUrn)) {
+    out.stderr.write(
+      "error: --to must be a LinkedIn member URN (e.g. urn:li:member:99999), not a URL or slug.\n"
+    );
+    process.exit(2);
+  }
   const subject = flags.subject ?? "";
   const text = flags.text ?? "";
   const body = {
     recipient_urn: recipientUrn,
+    surface,
     subject,
     text
   };
@@ -467,7 +484,8 @@ var messageInMailCommand = defineCommand({
   meta: { name: "inmail", description: "Send an InMail to a member." },
   args: {
     ...GLOBAL_FLAGS,
-    to: { type: "string", description: "Recipient LinkedIn URN, URL, or slug.", required: true },
+    to: { type: "string", description: "Recipient member URN (urn:li:member:<id>). Must be a URN, not a URL or slug.", required: true },
+    surface: { type: "string", description: "InMail surface: sales_nav or recruiter.", required: true },
     subject: { type: "string", description: "InMail subject line.", required: true },
     text: { type: "positional", description: "InMail body text." }
   },

package/dist/{recruiter-TGCV36EH.js → recruiter-D4BO4NO4.js}

@@ -13,6 +13,11 @@ import {
 import {
   resolveIdentifier
 } from "./chunk-BNUTM6KD.js";
+import {
+  DEFAULT_FILTER_READERS,
+  assembleFilters,
+  splitCsv
+} from "./chunk-42VUUKQ3.js";
 import {
   streamAll
 } from "./chunk-SND3NHCT.js";
@@ -29,6 +34,7 @@ import {
 
 // src/commands/recruiter.ts
 import { defineCommand } from "citty";
+import { readFile } from "fs/promises";
 function buildOutputStreams() {
   return {
     stdout: { write: (s) => process.stdout.write(s) },
@@ -69,6 +75,51 @@ async function handleSdkError(err, outOpts, out) {
   renderUnexpectedError(err, out);
   process.exit(1);
 }
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
+var DEFAULT_JOB_CREATE_READERS = {
+  readFile: (path) => readFile(path, "utf8"),
+  readStdin
+};
+async function assembleJobCreateBody(flags, readers) {
+  let base = {};
+  let raw;
+  let source;
+  if (flags["body-file"] !== void 0) {
+    source = `--body-file ${flags["body-file"]}`;
+    try {
+      raw = await readers.readFile(flags["body-file"]);
+    } catch {
+      return { error: `cannot read ${source}` };
+    }
+  } else if (flags.body === "-") {
+    source = "--body - (stdin)";
+    raw = await readers.readStdin();
+  } else if (flags.body !== void 0) {
+    return { error: "--body only accepts '-' (read JSON from stdin); use --body-file <path> for a file." };
+  }
+  if (raw !== void 0) {
+    let parsed;
+    try {
+      parsed = JSON.parse(raw);
+    } catch {
+      return { error: `${source} is not valid JSON` };
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return { error: `${source} must be a JSON object` };
+    }
+    base = parsed;
+  }
+  if (flags["job-title"] !== void 0) base["job_title"] = { text: flags["job-title"] };
+  if (flags.description !== void 0) base["description"] = flags.description;
+  if (flags["employment-type"] !== void 0) base["employment_type"] = flags["employment-type"];
+  return { body: base };
+}
 async function runRecruiterSync(client, flags, out) {
   rejectPreviewOnRead(flags.preview, out);
   const accountId = requireAccount(flags.account, out);
@@ -107,13 +158,13 @@ async function runRecruiterMessageNew(client, flags, out) {
     throw err;
   }
   const body = {
-    attendees_ids: [to],
+    attendee_ids: [to],
     text
   };
   if (flags.preview) {
     const preview = buildPreviewOutput({
       method: "recruiter.startChat",
-      args: { attendees_ids: [to] },
+      args: { attendee_ids: [to] },
       body: { ...body },
       account: accountId,
       attachments: [
@@ -154,7 +205,7 @@ async function runRecruiterProfile(client, flags, out) {
     await handleSdkError(err, outOpts, out);
   }
 }
-async function runRecruiterSearchPeople(client, flags, out) {
+async function runRecruiterSearchPeople(client, flags, out, readers = DEFAULT_FILTER_READERS) {
   rejectPreviewOnRead(flags.preview, out);
   const accountId = requireAccount(flags.account, out);
   const ns = client.account(accountId);
@@ -163,8 +214,18 @@ async function runRecruiterSearchPeople(client, flags, out) {
   const maxPages = flags["max-pages"] ? parseInt(flags["max-pages"], 10) : 100;
   const limit = flags.limit ? parseInt(flags.limit, 10) : void 0;
   const cursor = flags.cursor;
-  const body = {};
+  const assembled = await assembleFilters(flags, readers);
+  if ("error" in assembled) {
+    out.stderr.write(`error: ${assembled.error}
+`);
+    process.exit(2);
+  }
+  const body = assembled.body;
   if (flags.keywords) body["keywords"] = flags.keywords;
+  if (flags.locale) body["locale"] = flags.locale;
+  if (flags["employment-type"]) body["employment_type"] = splitCsv(flags["employment-type"]);
+  if (flags.function) body["function"] = splitCsv(flags.function);
+  if (flags["profile-language"]) body["profile_language"] = splitCsv(flags["profile-language"]);
   const params = {};
   if (limit !== void 0) params["limit"] = limit;
   if (cursor) params["cursor"] = cursor;
@@ -200,6 +261,8 @@ async function runRecruiterGetParameters(client, flags, out) {
   const outOpts = resolveOutputOpts(flags);
   const params = {};
   if (flags.type) params["type"] = flags.type;
+  if (flags.keywords) params["keywords"] = flags.keywords;
+  if (flags.limit) params["limit"] = parseInt(flags.limit, 10);
   try {
     const result = await ns.recruiter.getParameters(params);
     renderSuccess(result, outOpts, out);
@@ -353,10 +416,16 @@ async function runRecruiterListJobs(client, flags, out) {
     await handleSdkError(err, outOpts, out);
   }
 }
-async function runRecruiterCreateJob(client, flags, out) {
+async function runRecruiterCreateJob(client, flags, out, readers = DEFAULT_JOB_CREATE_READERS) {
   const accountId = requireAccount(flags.account, out);
   const outOpts = resolveOutputOpts(flags);
-  const body = {};
+  const assembled = await assembleJobCreateBody(flags, readers);
+  if ("error" in assembled) {
+    out.stderr.write(`error: ${assembled.error}
+`);
+    process.exit(2);
+  }
+  const body = assembled.body;
   if (flags.preview) {
     const preview = buildPreviewOutput({
       method: "recruiter.createJob",
@@ -561,7 +630,13 @@ var recruiterSearchPeopleCommand = defineCommand({
   meta: { name: "people", description: "Search Recruiter member profiles." },
   args: {
     ...GLOBAL_FLAGS,
-    keywords: { type: "string", description: "Keyword search string." }
+    keywords: { type: "string", description: "Keyword search string." },
+    filters: { type: "string", description: "Filter body as a JSON object (escape hatch for the full filter surface); '-' reads JSON from stdin." },
+    "filters-file": { type: "string", description: "Path to a JSON file with the filter body." },
+    locale: { type: "string", description: "Result locale, e.g. en." },
+    "employment-type": { type: "string", description: "Employment type ids (comma-separated)." },
+    function: { type: "string", description: "Job function ids (comma-separated)." },
+    "profile-language": { type: "string", description: "Profile language codes (comma-separated)." }
   },
   async run({ args }) {
     const flags = args;
@@ -585,7 +660,8 @@ 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 (e.g. LOCATION, INDUSTRY, TITLE).", required: true },
+    keywords: { type: "string", description: "Human term to resolve (e.g. Berlin)." }
   },
   async run({ args }) {
     const flags = args;
@@ -768,7 +844,14 @@ var recruiterJobsCommand = defineCommand({
 });
 var recruiterJobCreateCommand = defineCommand({
   meta: { name: "create", description: "Create a Recruiter job posting draft." },
-  args: { ...GLOBAL_FLAGS },
+  args: {
+    ...GLOBAL_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)." },
+    description: { type: "string", description: "Job description (merged over the JSON)." },
+    "employment-type": { type: "string", description: "Employment type, e.g. FULL_TIME (merged over the JSON)." }
+  },
   async run({ args }) {
     const flags = args;
     const cfg = await resolveEffectiveConfig({

package/dist/{sales-nav-XGFO5I6F.js → sales-nav-F5VK7CPD.js}

@@ -9,6 +9,12 @@ import {
 import {
   resolveIdentifier
 } from "./chunk-BNUTM6KD.js";
+import {
+  DEFAULT_FILTER_READERS,
+  assembleFilters,
+  splitCsv,
+  splitCsvNumbers
+} from "./chunk-42VUUKQ3.js";
 import {
   streamAll
 } from "./chunk-SND3NHCT.js";
@@ -80,7 +86,7 @@ async function runSalesNavSync(client, flags, out) {
     await handleSdkError(err, outOpts, out);
   }
 }
-async function runSalesNavSearchPeople(client, flags, out) {
+async function runSalesNavSearchPeople(client, flags, out, readers = DEFAULT_FILTER_READERS) {
   rejectPreviewOnRead(flags.preview, out);
   const accountId = requireAccount(flags.account, out);
   const ns = client.account(accountId);
@@ -89,8 +95,18 @@ async function runSalesNavSearchPeople(client, flags, out) {
   const maxPages = flags["max-pages"] ? parseInt(flags["max-pages"], 10) : 100;
   const limit = flags.limit ? parseInt(flags.limit, 10) : void 0;
   const cursor = flags.cursor;
-  const body = {};
+  const assembled = await assembleFilters(flags, readers);
+  if ("error" in assembled) {
+    out.stderr.write(`error: ${assembled.error}
+`);
+    process.exit(2);
+  }
+  const body = assembled.body;
   if (flags.keywords) body["keywords"] = flags.keywords;
+  if (flags["first-name"]) body["first_name"] = flags["first-name"];
+  if (flags["last-name"]) body["last_name"] = flags["last-name"];
+  if (flags.groups) body["groups"] = splitCsv(flags.groups);
+  if (flags["profile-language"]) body["profile_language"] = splitCsv(flags["profile-language"]);
   const params = {};
   if (limit !== void 0) params["limit"] = limit;
   if (cursor) params["cursor"] = cursor;
@@ -119,7 +135,7 @@ async function runSalesNavSearchPeople(client, flags, out) {
     await handleSdkError(err, outOpts, out);
   }
 }
-async function runSalesNavSearchCompanies(client, flags, out) {
+async function runSalesNavSearchCompanies(client, flags, out, readers = DEFAULT_FILTER_READERS) {
   rejectPreviewOnRead(flags.preview, out);
   const accountId = requireAccount(flags.account, out);
   const ns = client.account(accountId);
@@ -128,8 +144,17 @@ async function runSalesNavSearchCompanies(client, flags, out) {
   const maxPages = flags["max-pages"] ? parseInt(flags["max-pages"], 10) : 100;
   const limit = flags.limit ? parseInt(flags.limit, 10) : void 0;
   const cursor = flags.cursor;
-  const body = {};
+  const assembled = await assembleFilters(flags, readers);
+  if ("error" in assembled) {
+    out.stderr.write(`error: ${assembled.error}
+`);
+    process.exit(2);
+  }
+  const body = assembled.body;
   if (flags.keywords) body["keywords"] = flags.keywords;
+  if (flags.technologies) body["technologies"] = splitCsv(flags.technologies);
+  if (flags["recent-activities"]) body["recent_activities"] = splitCsv(flags["recent-activities"]);
+  if (flags["network-distance"]) body["network_distance"] = splitCsvNumbers(flags["network-distance"]);
   const params = {};
   if (limit !== void 0) params["limit"] = limit;
   if (cursor) params["cursor"] = cursor;
@@ -165,6 +190,8 @@ async function runSalesNavGetParameters(client, flags, out) {
   const outOpts = resolveOutputOpts(flags);
   const params = {};
   if (flags.type) params["type"] = flags.type;
+  if (flags.keywords) params["keywords"] = flags.keywords;
+  if (flags.limit) params["limit"] = parseInt(flags.limit, 10);
   try {
     const result = await ns.salesNavigator.getParameters(params);
     renderSuccess(result, outOpts, out);
@@ -329,7 +356,13 @@ var salesNavSearchPeopleCommand = defineCommand({
   meta: { name: "people", description: "Search Sales Navigator member profiles." },
   args: {
     ...GLOBAL_FLAGS,
-    keywords: { type: "string", description: "Keyword search string." }
+    keywords: { type: "string", description: "Keyword search string." },
+    filters: { type: "string", description: "Filter body as a JSON object (escape hatch for the full filter surface); '-' reads JSON from stdin." },
+    "filters-file": { type: "string", description: "Path to a JSON file with the filter body." },
+    "first-name": { type: "string", description: "First name to match." },
+    "last-name": { type: "string", description: "Last name to match." },
+    groups: { type: "string", description: "Group ids (comma-separated)." },
+    "profile-language": { type: "string", description: "Profile language codes (comma-separated)." }
   },
   async run({ args }) {
     const flags = args;
@@ -353,7 +386,12 @@ var salesNavSearchCompaniesCommand = defineCommand({
   meta: { name: "companies", description: "Search Sales Navigator companies." },
   args: {
     ...GLOBAL_FLAGS,
-    keywords: { type: "string", description: "Keyword search string." }
+    keywords: { type: "string", description: "Keyword search string." },
+    filters: { type: "string", description: "Filter body as a JSON object (escape hatch for the full filter surface); '-' reads JSON from stdin." },
+    "filters-file": { type: "string", description: "Path to a JSON file with the filter body." },
+    technologies: { type: "string", description: "Technology tags (comma-separated)." },
+    "recent-activities": { type: "string", description: "Recent activity ids (comma-separated)." },
+    "network-distance": { type: "string", description: "Network distance, 1-3 (comma-separated)." }
   },
   async run({ args }) {
     const flags = args;
@@ -377,7 +415,8 @@ 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 (e.g. LOCATION, INDUSTRY, TITLE).", required: true },
+    keywords: { type: "string", description: "Human term to resolve (e.g. Berlin)." }
   },
   async run({ args }) {
     const flags = args;

package/dist/{search-LHPTHPWH.js → search-XJMVHZIZ.js}

@@ -1,4 +1,10 @@
 #!/usr/bin/env node
+import {
+  DEFAULT_FILTER_READERS,
+  assembleFilters,
+  splitCsv,
+  splitCsvNumbers
+} from "./chunk-42VUUKQ3.js";
 import {
   streamAll
 } from "./chunk-SND3NHCT.js";
@@ -15,6 +21,16 @@ import {
 
 // src/commands/search.ts
 import { defineCommand } from "citty";
+var FILTER_FLAGS = {
+  filters: {
+    type: "string",
+    description: "Filter body as a JSON object (escape hatch for the full filter surface); '-' reads JSON from stdin."
+  },
+  "filters-file": {
+    type: "string",
+    description: "Path to a JSON file with the filter body."
+  }
+};
 function buildOutputStreams() {
   return {
     stdout: { write: (s) => process.stdout.write(s) },
@@ -47,22 +63,66 @@ function resolveOutputOpts(flags) {
     fields: flags.fields
   };
 }
-function buildSearchBody(flags) {
-  const body = {};
+function applyCommonSearchFlags(body, flags) {
   if (flags.keywords) body["keywords"] = flags.keywords;
   if (flags.url) body["url"] = flags.url;
   if (flags.cursor) body["cursor"] = flags.cursor;
   if (flags.limit) body["limit"] = parseInt(flags.limit, 10);
-  return body;
 }
-async function runSearchPeople(client, flags, out) {
+var NAMED_FLAG_MAPPERS = {
+  people(body, flags) {
+    if (flags.industry) body["industry"] = splitCsv(flags.industry);
+    if (flags.location) body["location"] = splitCsv(flags.location);
+    if (flags.company) body["company"] = splitCsv(flags.company);
+    if (flags["past-company"]) body["past_company"] = splitCsv(flags["past-company"]);
+    if (flags.school) body["school"] = splitCsv(flags.school);
+    if (flags["network-distance"]) body["network_distance"] = splitCsvNumbers(flags["network-distance"]);
+    if (flags["connections-of"]) body["connections_of"] = flags["connections-of"];
+    if (flags["followers-of"]) body["followers_of"] = flags["followers-of"];
+  },
+  companies(body, flags) {
+    if (flags.industry) body["industry"] = splitCsv(flags.industry);
+    if (flags.location) body["location"] = splitCsv(flags.location);
+    if (flags["network-distance"]) body["network_distance"] = splitCsvNumbers(flags["network-distance"]);
+  },
+  posts(body, flags) {
+    if (flags["sort-by"]) body["sort_by"] = flags["sort-by"];
+    if (flags["date-posted"]) body["date_posted"] = flags["date-posted"];
+    if (flags["content-type"]) body["content_type"] = flags["content-type"];
+  },
+  jobs(body, flags) {
+    if (flags.location) body["location"] = splitCsv(flags.location);
+    if (flags.industry) body["industry"] = splitCsv(flags.industry);
+    if (flags.seniority) body["seniority"] = splitCsv(flags.seniority);
+    if (flags.function) body["function"] = splitCsv(flags.function);
+    if (flags["job-type"]) body["job_type"] = splitCsv(flags["job-type"]);
+    if (flags.company) body["company"] = splitCsv(flags.company);
+    if (flags["sort-by"]) body["sort_by"] = flags["sort-by"];
+    if (flags.region) body["region"] = flags.region;
+  }
+};
+async function buildSearchBody(kind, flags, readers) {
+  const assembled = await assembleFilters(flags, readers);
+  if ("error" in assembled) return assembled;
+  const body = assembled.body;
+  applyCommonSearchFlags(body, flags);
+  NAMED_FLAG_MAPPERS[kind](body, flags);
+  return { body };
+}
+async function runSearchPeople(client, flags, out, readers = DEFAULT_FILTER_READERS) {
   rejectPreviewOnRead(flags.preview, out);
   const accountId = requireAccount(flags.account, out);
   const ns = client.account(accountId);
   const outOpts = resolveOutputOpts(flags);
   const all = flags.all ?? false;
   const maxPages = flags["max-pages"] ? parseInt(flags["max-pages"], 10) : 100;
-  const body = buildSearchBody(flags);
+  const assembled = await buildSearchBody("people", flags, readers);
+  if ("error" in assembled) {
+    out.stderr.write(`error: ${assembled.error}
+`);
+    process.exit(2);
+  }
+  const body = assembled.body;
   try {
     if (all) {
       const fn = (p) => ns.search.people(p);
@@ -87,14 +147,20 @@ async function runSearchPeople(client, flags, out) {
     process.exit(1);
   }
 }
-async function runSearchCompanies(client, flags, out) {
+async function runSearchCompanies(client, flags, out, readers = DEFAULT_FILTER_READERS) {
   rejectPreviewOnRead(flags.preview, out);
   const accountId = requireAccount(flags.account, out);
   const ns = client.account(accountId);
   const outOpts = resolveOutputOpts(flags);
   const all = flags.all ?? false;
   const maxPages = flags["max-pages"] ? parseInt(flags["max-pages"], 10) : 100;
-  const body = buildSearchBody(flags);
+  const assembled = await buildSearchBody("companies", flags, readers);
+  if ("error" in assembled) {
+    out.stderr.write(`error: ${assembled.error}
+`);
+    process.exit(2);
+  }
+  const body = assembled.body;
   try {
     if (all) {
       const fn = (p) => ns.search.companies(p);
@@ -119,14 +185,20 @@ async function runSearchCompanies(client, flags, out) {
     process.exit(1);
   }
 }
-async function runSearchPosts(client, flags, out) {
+async function runSearchPosts(client, flags, out, readers = DEFAULT_FILTER_READERS) {
   rejectPreviewOnRead(flags.preview, out);
   const accountId = requireAccount(flags.account, out);
   const ns = client.account(accountId);
   const outOpts = resolveOutputOpts(flags);
   const all = flags.all ?? false;
   const maxPages = flags["max-pages"] ? parseInt(flags["max-pages"], 10) : 100;
-  const body = buildSearchBody(flags);
+  const assembled = await buildSearchBody("posts", flags, readers);
+  if ("error" in assembled) {
+    out.stderr.write(`error: ${assembled.error}
+`);
+    process.exit(2);
+  }
+  const body = assembled.body;
   try {
     if (all) {
       const fn = (p) => ns.search.posts(p);
@@ -151,14 +223,20 @@ async function runSearchPosts(client, flags, out) {
     process.exit(1);
   }
 }
-async function runSearchJobs(client, flags, out) {
+async function runSearchJobs(client, flags, out, readers = DEFAULT_FILTER_READERS) {
   rejectPreviewOnRead(flags.preview, out);
   const accountId = requireAccount(flags.account, out);
   const ns = client.account(accountId);
   const outOpts = resolveOutputOpts(flags);
   const all = flags.all ?? false;
   const maxPages = flags["max-pages"] ? parseInt(flags["max-pages"], 10) : 100;
-  const body = buildSearchBody(flags);
+  const assembled = await buildSearchBody("jobs", flags, readers);
+  if ("error" in assembled) {
+    out.stderr.write(`error: ${assembled.error}
+`);
+    process.exit(2);
+  }
+  const body = assembled.body;
   try {
     if (all) {
       const fn = (p) => ns.search.jobs(p);
@@ -212,7 +290,16 @@ var searchPeopleCommand = defineCommand({
   args: {
     ...GLOBAL_FLAGS,
     keywords: { type: "string", description: "Full-text keyword search." },
-    url: { type: "string", description: "Pasted LinkedIn search URL (mutually exclusive with filters)." }
+    url: { type: "string", description: "Pasted LinkedIn search URL (mutually exclusive with filters)." },
+    ...FILTER_FLAGS,
+    industry: { type: "string", description: "Industry ids (comma-separated)." },
+    location: { type: "string", description: "Location ids (comma-separated)." },
+    company: { type: "string", description: "Current company ids (comma-separated)." },
+    "past-company": { type: "string", description: "Past company ids (comma-separated)." },
+    school: { type: "string", description: "School ids (comma-separated)." },
+    "network-distance": { type: "string", description: "Network distance, 1-3 (comma-separated)." },
+    "connections-of": { type: "string", description: "Member id whose connections to search." },
+    "followers-of": { type: "string", description: "Member id whose followers to search." }
   },
   async run({ args }) {
     const flags = args;
@@ -236,7 +323,12 @@ var searchCompaniesCommand = defineCommand({
   meta: { name: "companies", description: "Search LinkedIn companies." },
   args: {
     ...GLOBAL_FLAGS,
-    keywords: { type: "string", description: "Full-text keyword search." }
+    keywords: { type: "string", description: "Full-text keyword search." },
+    url: { type: "string", description: "Pasted LinkedIn search URL (mutually exclusive with filters)." },
+    ...FILTER_FLAGS,
+    industry: { type: "string", description: "Industry ids (comma-separated)." },
+    location: { type: "string", description: "Location ids (comma-separated)." },
+    "network-distance": { type: "string", description: "Network distance, 1-3 (comma-separated)." }
   },
   async run({ args }) {
     const flags = args;
@@ -260,7 +352,12 @@ var searchPostsCommand = defineCommand({
   meta: { name: "posts", description: "Search LinkedIn posts." },
   args: {
     ...GLOBAL_FLAGS,
-    keywords: { type: "string", description: "Full-text keyword search." }
+    keywords: { type: "string", description: "Full-text keyword search." },
+    url: { type: "string", description: "Pasted LinkedIn search URL (mutually exclusive with filters)." },
+    ...FILTER_FLAGS,
+    "sort-by": { type: "string", description: "Sort order (e.g. relevance, date)." },
+    "date-posted": { type: "string", description: "Date-posted window (e.g. past-day, past-week)." },
+    "content-type": { type: "string", description: "Content type (e.g. videos, images, jobs)." }
   },
   async run({ args }) {
     const flags = args;
@@ -284,7 +381,17 @@ var searchJobsCommand = defineCommand({
   meta: { name: "jobs", description: "Search LinkedIn jobs." },
   args: {
     ...GLOBAL_FLAGS,
-    keywords: { type: "string", description: "Full-text keyword search." }
+    keywords: { type: "string", description: "Full-text keyword search." },
+    url: { type: "string", description: "Pasted LinkedIn search URL (mutually exclusive with filters)." },
+    ...FILTER_FLAGS,
+    location: { type: "string", description: "Location ids (comma-separated)." },
+    industry: { type: "string", description: "Industry ids (comma-separated)." },
+    seniority: { type: "string", description: "Seniority ids (comma-separated)." },
+    function: { type: "string", description: "Job function ids (comma-separated)." },
+    "job-type": { type: "string", description: "Job type ids, e.g. F,P (comma-separated)." },
+    company: { type: "string", description: "Company ids (comma-separated)." },
+    "sort-by": { type: "string", description: "Sort order (e.g. relevance, recent)." },
+    region: { type: "string", description: "Region id." }
   },
   async run({ args }) {
     const flags = args;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curviate/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "private": false,
   "description": "Official command-line interface for the Curviate API.",
   "license": "MIT",