@curviate/cli 0.5.0 → 0.6.1

package/CHANGELOG.md

@@ -8,6 +8,31 @@ a new command or flag is a minor; a breaking command/flag/exit-code change is a
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-06-30
+
+### Added
+
+- `inbox list --unread` — filter the inbox to chats with unread messages.
+- `messages` now accepts `--before` and `--after` to page a conversation by
+  timestamp window.
+- `sync-chat --wait` — poll until a chat sync completes instead of returning
+  immediately.
+- `message new --to` and `message inmail --to` now resolve a **LinkedIn profile
+  URL or vanity slug** (e.g. `linkedin.com/in/<slug>`) to the recipient, in
+  addition to provider ids and member URNs.
+- Thread-URL `chat_id` normalization — a pasted conversation URL is normalized to
+  the underlying chat id wherever a `chat_id` is accepted.
+- Write commands that take a TEXT positional accept `-` to read the value from
+  stdin (pipe message bodies in).
+- `connect`: slim default projection + write-flag suppression + help text
+  (Invites-AX co-release).
+
+### Changed
+
+- Pagination flags are suppressed from the help output of non-list commands.
+- Updated `@curviate/sdk` dependency to `^0.4.0` (regenerated types:
+  `primary_locale` on profile, account-sync `status` field).
+
 ## [0.5.0] - 2026-06-29
 
 ### Added

package/dist/{account-47TRPUKL.js → account-O5GZNE72.js}

@@ -4,17 +4,17 @@ import {
 } from "./chunk-R3VLWLVV.js";
 import {
   streamAll
-} from "./chunk-SND3NHCT.js";
+} from "./chunk-GXTZION6.js";
 import {
   createClient,
   renderError,
   renderSuccess,
   renderUnexpectedError,
   resolveEffectiveConfig
-} from "./chunk-U6ACUNLU.js";
+} from "./chunk-47SYFQRF.js";
 import {
   GLOBAL_FLAGS
-} from "./chunk-52RZLSWP.js";
+} from "./chunk-TDYIQHQX.js";
 
 // src/commands/account.ts
 import { defineCommand } from "citty";
@@ -68,7 +68,8 @@ async function runAccountList(client, flags, out) {
       const fn = (p) => client.accounts.list(p);
       for await (const item of streamAll(fn, params, {
         maxPages,
-        onTruncated: (msg) => out.stderr.write(msg + "\n")
+        onTruncated: (n) => out.stderr.write(`Streaming truncated at ${n} page(s). Use --all --max-pages or --cursor for manual paging.
+`)
       })) {
         out.stdout.write(JSON.stringify(item) + "\n");
       }

package/dist/{chunk-U6ACUNLU.js → chunk-47SYFQRF.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   readConfig
-} from "./chunk-52RZLSWP.js";
+} from "./chunk-TDYIQHQX.js";
 
 // src/lib/resolve.ts
 var DEFAULT_BASE_URL = "https://api.curviate.com";

package/dist/chunk-CHFKVAEI.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+// src/lib/stdin.ts
+var STDIN_SENTINEL = "__curviate_stdin__";
+async function defaultReadStdin() {
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    process.stdin.on("data", (chunk) => {
+      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    });
+    process.stdin.on("end", () => {
+      const full = Buffer.concat(chunks).toString("utf8");
+      resolve(full.replace(/\n+$/, ""));
+    });
+    process.stdin.on("error", reject);
+  });
+}
+async function resolveTextOrStdin(rawText, out, readStdin) {
+  if (rawText !== "-" && rawText !== STDIN_SENTINEL) return rawText;
+  const reader = readStdin ?? defaultReadStdin;
+  const text = await reader();
+  if (!text) {
+    out.stderr.write("error: stdin: empty input\n");
+    process.exit(2);
+  }
+  return text;
+}
+
+export {
+  STDIN_SENTINEL,
+  resolveTextOrStdin
+};

package/dist/chunk-FX6VBI43.js

@@ -0,0 +1,221 @@
+#!/usr/bin/env node
+
+// src/lib/slim.ts
+function synthesizeCurrentPosition(workExperience) {
+  if (!Array.isArray(workExperience) || workExperience.length === 0) {
+    return null;
+  }
+  const entry = workExperience[0];
+  return {
+    title: entry["position"] ?? null,
+    company_name: entry["company"] ?? null,
+    company_id: null,
+    is_current: entry["end"] == null
+  };
+}
+function synthesizeHeadquarters(locations) {
+  if (!Array.isArray(locations)) return null;
+  const hq = locations.find(
+    (l) => l["is_headquarter"] === true
+  );
+  if (!hq) return null;
+  return {
+    city: hq["city"] ?? null,
+    country: hq["country"] ?? null,
+    area: hq["area"] ?? null
+  };
+}
+function slimProfileMe(data) {
+  const d = data !== null && data !== void 0 && typeof data === "object" ? data : {};
+  const rawOrgs = Array.isArray(d["organizations"]) ? d["organizations"] : [];
+  const organizations = rawOrgs.map((org) => ({
+    id: org["id"] ?? null,
+    mailbox_id: org["mailbox_id"] ?? null,
+    name: org["name"] ?? null
+  }));
+  const rawWE = Array.isArray(d["work_experience"]) ? d["work_experience"] : [];
+  const currentPosition = synthesizeCurrentPosition(rawWE);
+  return {
+    provider_id: d["provider_id"] ?? null,
+    first_name: d["first_name"] ?? null,
+    last_name: d["last_name"] ?? null,
+    public_identifier: d["public_identifier"] ?? null,
+    location: d["location"] ?? null,
+    email: d["email"] ?? null,
+    occupation: d["occupation"] ?? null,
+    is_premium: d["is_premium"] ?? null,
+    organizations,
+    current_position: currentPosition
+  };
+}
+function slimProfile(data) {
+  const d = data !== null && data !== void 0 && typeof data === "object" ? data : {};
+  const rawWE = Array.isArray(d["work_experience"]) ? d["work_experience"] : [];
+  const currentPosition = synthesizeCurrentPosition(rawWE);
+  return {
+    provider_id: d["provider_id"] ?? null,
+    first_name: d["first_name"] ?? null,
+    last_name: d["last_name"] ?? null,
+    headline: d["headline"] ?? null,
+    location: d["location"] ?? null,
+    occupation: d["occupation"] ?? null,
+    network_distance: d["network_distance"] ?? null,
+    public_identifier: d["public_identifier"] ?? null,
+    current_position: currentPosition
+  };
+}
+function slimInviteSentItem(item) {
+  return {
+    id: item["id"] ?? null,
+    invited_user: item["invited_user"] ?? null,
+    invited_user_id: item["invited_user_id"] ?? null,
+    invited_user_public_id: item["invited_user_public_id"] ?? null,
+    invited_user_description: item["invited_user_description"] ?? null,
+    date: item["date"] ?? null,
+    parsed_datetime: item["parsed_datetime"] ?? null,
+    invitation_text: item["invitation_text"] ?? null
+  };
+}
+function slimInviteSent(data) {
+  const d = data !== null && data !== void 0 && typeof data === "object" ? data : {};
+  const items = Array.isArray(d["items"]) ? d["items"].map(slimInviteSentItem) : [];
+  return {
+    object: d["object"] ?? null,
+    items,
+    cursor: d["cursor"] ?? null
+  };
+}
+function slimInviteReceivedItem(item) {
+  const rawSpecifics = item["specifics"] !== null && item["specifics"] !== void 0 && typeof item["specifics"] === "object" ? item["specifics"] : null;
+  const specifics = rawSpecifics !== null ? { shared_secret: rawSpecifics["shared_secret"] ?? null } : null;
+  return {
+    id: item["id"] ?? null,
+    inviter: item["inviter"] ?? null,
+    date: item["date"] ?? null,
+    parsed_datetime: item["parsed_datetime"] ?? null,
+    invitation_text: item["invitation_text"] ?? null,
+    specifics
+  };
+}
+function slimInviteReceived(data) {
+  const d = data !== null && data !== void 0 && typeof data === "object" ? data : {};
+  const items = Array.isArray(d["items"]) ? d["items"].map(slimInviteReceivedItem) : [];
+  return {
+    object: d["object"] ?? null,
+    items,
+    cursor: d["cursor"] ?? null
+  };
+}
+function slimSearchPeopleItem(item) {
+  return {
+    id: item["id"] ?? null,
+    public_identifier: item["public_identifier"] ?? null,
+    full_name: item["full_name"] ?? null,
+    headline: item["headline"] ?? null,
+    location: item["location"] ?? null,
+    network_distance: item["network_distance"] ?? null
+  };
+}
+function slimSearchPeople(data) {
+  const d = data !== null && data !== void 0 && typeof data === "object" ? data : {};
+  const items = Array.isArray(d["items"]) ? d["items"].map(slimSearchPeopleItem) : [];
+  return { ...d, items };
+}
+function slimSearchCompaniesItem(item) {
+  const result = {
+    id: item["id"] ?? null,
+    name: item["name"] ?? null,
+    location: item["location"] ?? null,
+    followers_count: item["followers_count"] ?? null
+  };
+  if (Object.prototype.hasOwnProperty.call(item, "industry")) {
+    result["industry"] = item["industry"];
+  }
+  return result;
+}
+function slimSearchCompanies(data) {
+  const d = data !== null && data !== void 0 && typeof data === "object" ? data : {};
+  const items = Array.isArray(d["items"]) ? d["items"].map(slimSearchCompaniesItem) : [];
+  return { ...d, items };
+}
+function slimSearchJobsItem(item) {
+  return {
+    job_urn: item["job_urn"] ?? null,
+    title: item["title"] ?? null,
+    location: item["location"] ?? null,
+    company_name: item["company_name"] ?? null,
+    posted_at: item["posted_at"] ?? null,
+    easy_apply: item["easy_apply"] ?? null
+  };
+}
+function slimSearchJobs(data) {
+  const d = data !== null && data !== void 0 && typeof data === "object" ? data : {};
+  const items = Array.isArray(d["items"]) ? d["items"].map(slimSearchJobsItem) : [];
+  return { ...d, items };
+}
+function slimSearchPostsItem(item) {
+  const rawAuthor = item["author"] !== null && item["author"] !== void 0 && typeof item["author"] === "object" ? item["author"] : null;
+  const author = rawAuthor !== null ? { name: rawAuthor["name"] ?? null } : null;
+  const rawText = item["text"];
+  let text;
+  if (rawText === null || rawText === void 0) {
+    text = null;
+  } else {
+    const s = String(rawText);
+    text = s.length > 200 ? s.slice(0, 200) : s;
+  }
+  return {
+    post_urn: item["post_urn"] ?? null,
+    posted_at: item["posted_at"] ?? null,
+    author,
+    text,
+    reaction_count: item["reaction_count"] ?? null,
+    comment_count: item["comment_count"] ?? null
+  };
+}
+function slimSearchPosts(data) {
+  const d = data !== null && data !== void 0 && typeof data === "object" ? data : {};
+  const items = Array.isArray(d["items"]) ? d["items"].map(slimSearchPostsItem) : [];
+  return { ...d, items };
+}
+function slimCompany(data) {
+  const d = data !== null && data !== void 0 && typeof data === "object" ? data : {};
+  const rawMessaging = d["messaging"] !== null && d["messaging"] !== void 0 && typeof d["messaging"] === "object" ? d["messaging"] : null;
+  const messaging = {
+    is_enabled: rawMessaging?.["is_enabled"] ?? false
+  };
+  const rawLocations = Array.isArray(d["locations"]) ? d["locations"] : [];
+  const headquarters = synthesizeHeadquarters(rawLocations);
+  return {
+    id: d["id"] ?? null,
+    name: d["name"] ?? null,
+    public_identifier: d["public_identifier"] ?? null,
+    profile_url: d["profile_url"] ?? null,
+    industry: d["industry"] ?? null,
+    employee_count: d["employee_count"] ?? null,
+    employee_count_range: d["employee_count_range"] ?? null,
+    website: d["website"] ?? null,
+    foundation_date: d["foundation_date"] ?? null,
+    messaging,
+    headquarters,
+    followers_count: d["followers_count"] ?? null
+  };
+}
+
+export {
+  slimProfileMe,
+  slimProfile,
+  slimInviteSentItem,
+  slimInviteSent,
+  slimInviteReceivedItem,
+  slimInviteReceived,
+  slimSearchPeopleItem,
+  slimSearchPeople,
+  slimSearchCompaniesItem,
+  slimSearchCompanies,
+  slimSearchJobsItem,
+  slimSearchJobs,
+  slimSearchPostsItem,
+  slimSearchPosts,
+  slimCompany
+};

package/dist/{chunk-SND3NHCT.js → chunk-GXTZION6.js}

@@ -32,9 +32,8 @@ async function* streamAll(fn, params, opts = {}) {
     cursor = page.cursor;
     if (!cursor) break;
     if (pageCount >= maxPages) {
-      const msg = `Streaming truncated at ${maxPages} page(s) \u2014 more results may exist. Increase --max-pages or use --cursor / --limit for manual paging.`;
       if (opts.onTruncated) {
-        opts.onTruncated(msg);
+        opts.onTruncated(pageCount, cursor !== null && cursor !== void 0);
       }
       break;
     }

package/dist/{chunk-BNUTM6KD.js → chunk-SZB3CFRZ.js}

@@ -27,7 +27,14 @@ function resolveIdentifier(raw) {
 function stripTrailingSlash(s) {
   return s.endsWith("/") ? s.slice(0, -1) : s;
 }
+var MESSAGING_THREAD_URL_RE = /messaging\/thread\/([^/?]+)/;
+function normalizeChatId(raw) {
+  const match = MESSAGING_THREAD_URL_RE.exec(raw);
+  if (match?.[1]) return match[1];
+  return raw;
+}
 
 export {
-  resolveIdentifier
+  resolveIdentifier,
+  normalizeChatId
 };

package/dist/{chunk-52RZLSWP.js → chunk-TDYIQHQX.js}

@@ -197,6 +197,17 @@ var WRITE_FLAGS = {
   preview: GLOBAL_FLAGS.preview,
   verbose: GLOBAL_FLAGS.verbose
 };
+var READ_SINGLE_FLAGS = {
+  "api-key": GLOBAL_FLAGS["api-key"],
+  profile: GLOBAL_FLAGS.profile,
+  account: GLOBAL_FLAGS.account,
+  "base-url": GLOBAL_FLAGS["base-url"],
+  timeout: GLOBAL_FLAGS.timeout,
+  json: GLOBAL_FLAGS.json,
+  fields: GLOBAL_FLAGS.fields,
+  preview: GLOBAL_FLAGS.preview,
+  verbose: GLOBAL_FLAGS.verbose
+};
 
 export {
   getConfigPath,
@@ -207,5 +218,6 @@ export {
   removeProfile,
   updateProfileField,
   GLOBAL_FLAGS,
-  WRITE_FLAGS
+  WRITE_FLAGS,
+  READ_SINGLE_FLAGS
 };

package/dist/cli.js

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  STDIN_SENTINEL
+} from "./chunk-CHFKVAEI.js";
 
 // src/cli.ts
 import { defineCommand } from "citty";
@@ -108,8 +111,9 @@ async function dispatch(root, rawArgs) {
     if (unknown !== null) {
       usageError(`unknown flag \`${unknown}\`.`);
     }
+    const processedLeafArgs = leafArgs.map((a) => a === "-" ? STDIN_SENTINEL : a);
     const leafToRun = { ...leaf, subCommands: void 0 };
-    await runCommand(leafToRun, { rawArgs: leafArgs });
+    await runCommand(leafToRun, { rawArgs: processedLeafArgs });
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
     const code = err?.code;
@@ -134,22 +138,22 @@ var main = defineCommand({
   // Subcommand registry — names and descriptions are static for help rendering;
   // the handler implementation is loaded lazily on first invocation.
   subCommands: {
-    login: () => import("./login-UJQGIP7S.js").then((m) => m.loginCommand),
-    config: () => import("./config-6PNGYL5E.js").then((m) => m.configCommand),
+    login: () => import("./login-POKHNDYX.js").then((m) => m.loginCommand),
+    config: () => import("./config-2GBLD4GN.js").then((m) => m.configCommand),
     // ---------------------------------------------------------------------------
     // Noun groups — lazy-loaded on first invocation.
     // ---------------------------------------------------------------------------
-    profile: () => import("./profile-CUVVESMY.js").then((m) => m.profileCommand),
-    company: () => import("./company-4MUABENR.js").then((m) => m.companyCommand),
-    connect: () => import("./connect-ZXD7P5CA.js").then((m) => m.connectCommand),
-    search: () => import("./search-M4WK3PDC.js").then((m) => m.searchCommand),
-    inbox: () => import("./inbox-ME4TXGFV.js").then((m) => m.inboxCommand),
-    message: () => import("./message-O7QN2L6Q.js").then((m) => m.messageCommand),
-    post: () => import("./post-VDQF23WS.js").then((m) => m.postCommand),
-    account: () => import("./account-47TRPUKL.js").then((m) => m.accountCommand),
-    webhook: () => import("./webhook-2SSNW25K.js").then((m) => m.webhookCommand),
-    "sales-nav": () => import("./sales-nav-UL2H6J6V.js").then((m) => m.salesNavCommand),
-    recruiter: () => import("./recruiter-QKJKOWD7.js").then((m) => m.recruiterCommand)
+    profile: () => import("./profile-4IPEB7MN.js").then((m) => m.profileCommand),
+    company: () => import("./company-WH2ZETTP.js").then((m) => m.companyCommand),
+    connect: () => import("./connect-YUJ2T5CN.js").then((m) => m.connectCommand),
+    search: () => import("./search-ONCNS43D.js").then((m) => m.searchCommand),
+    inbox: () => import("./inbox-YV6GPRG6.js").then((m) => m.inboxCommand),
+    message: () => import("./message-YRMLMHK7.js").then((m) => m.messageCommand),
+    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-7UEBT3JZ.js").then((m) => m.recruiterCommand)
   },
   async run() {
     const { runMain } = await import("citty");

package/dist/{company-4MUABENR.js → company-WH2ZETTP.js}

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
-import {
-  slimCompany
-} from "./chunk-5NS2G4WQ.js";
 import {
   resolveIdentifier
-} from "./chunk-BNUTM6KD.js";
+} from "./chunk-SZB3CFRZ.js";
+import {
+  slimCompany
+} from "./chunk-FX6VBI43.js";
 import {
   createClient,
   renderError,
   renderSuccess,
   renderUnexpectedError,
   resolveEffectiveConfig
-} from "./chunk-U6ACUNLU.js";
+} from "./chunk-47SYFQRF.js";
 import {
   GLOBAL_FLAGS
-} from "./chunk-52RZLSWP.js";
+} from "./chunk-TDYIQHQX.js";
 
 // src/commands/company.ts
 import { defineCommand } from "citty";

package/dist/{config-6PNGYL5E.js → config-2GBLD4GN.js}

@@ -7,7 +7,7 @@ import {
   renameProfile,
   setActiveProfile,
   updateProfileField
-} from "./chunk-52RZLSWP.js";
+} from "./chunk-TDYIQHQX.js";
 
 // src/commands/config.ts
 import { defineCommand } from "citty";

package/dist/{connect-ZXD7P5CA.js → connect-YUJ2T5CN.js}

@@ -4,20 +4,27 @@ import {
 } from "./chunk-R3VLWLVV.js";
 import {
   resolveIdentifier
-} from "./chunk-BNUTM6KD.js";
+} from "./chunk-SZB3CFRZ.js";
 import {
   streamAll
-} from "./chunk-SND3NHCT.js";
+} from "./chunk-GXTZION6.js";
+import {
+  slimInviteReceived,
+  slimInviteReceivedItem,
+  slimInviteSent,
+  slimInviteSentItem
+} from "./chunk-FX6VBI43.js";
 import {
   createClient,
   renderError,
   renderSuccess,
   renderUnexpectedError,
   resolveEffectiveConfig
-} from "./chunk-U6ACUNLU.js";
+} from "./chunk-47SYFQRF.js";
 import {
-  GLOBAL_FLAGS
-} from "./chunk-52RZLSWP.js";
+  GLOBAL_FLAGS,
+  WRITE_FLAGS
+} from "./chunk-TDYIQHQX.js";
 
 // src/commands/connect.ts
 import { defineCommand } from "citty";
@@ -44,7 +51,8 @@ function resolveOutputOpts(flags) {
   return {
     json: (flags.json ?? false) || !process.stdout.isTTY,
     isTTY: process.stdout.isTTY ?? false,
-    fields: flags.fields
+    fields: flags.fields,
+    verbose: flags.verbose ?? false
   };
 }
 async function runConnectSend(client, flags, out) {
@@ -96,13 +104,15 @@ async function runConnectSent(client, flags, out) {
       const fn = (p) => ns.invites.listSent(p);
       for await (const item of streamAll(fn, params, {
         maxPages,
-        onTruncated: (msg) => out.stderr.write(msg + "\n")
+        onTruncated: (n) => out.stderr.write(`Streaming truncated at ${n} page(s). Use --all --max-pages or --cursor for manual paging.
+`)
       })) {
-        out.stdout.write(JSON.stringify(item) + "\n");
+        const projected = !flags.verbose ? slimInviteSentItem(item) : item;
+        out.stdout.write(JSON.stringify(projected) + "\n");
       }
     } else {
       const result = await ns.invites.listSent(params);
-      renderSuccess(result, outOpts, out);
+      renderSuccess(result, { ...outOpts, slim: slimInviteSent }, out);
     }
   } catch (err) {
     const { CurviateError } = await import("@curviate/sdk");
@@ -132,13 +142,15 @@ async function runConnectReceived(client, flags, out) {
       const fn = (p) => ns.invites.listReceived(p);
       for await (const item of streamAll(fn, params, {
         maxPages,
-        onTruncated: (msg) => out.stderr.write(msg + "\n")
+        onTruncated: (n) => out.stderr.write(`Streaming truncated at ${n} page(s). Use --all --max-pages or --cursor for manual paging.
+`)
       })) {
-        out.stdout.write(JSON.stringify(item) + "\n");
+        const projected = !flags.verbose ? slimInviteReceivedItem(item) : item;
+        out.stdout.write(JSON.stringify(projected) + "\n");
       }
     } else {
       const result = await ns.invites.listReceived(params);
-      renderSuccess(result, outOpts, out);
+      renderSuccess(result, { ...outOpts, slim: slimInviteReceived }, out);
     }
   } catch (err) {
     const { CurviateError } = await import("@curviate/sdk");
@@ -219,7 +231,10 @@ async function runConnectCancel(client, flags, out) {
   }
 }
 var connectSentCommand = defineCommand({
-  meta: { name: "sent", description: "List sent connection invitations." },
+  meta: {
+    name: "sent",
+    description: "Returns pending sent invitations only \u2014 accepted and declined invitations are not returned (LinkedIn API limitation). Use `id` with `connect cancel`; use `invited_user_public_id` or `invited_user_id` with `curviate profile`. `parsed_datetime` is approximate \u2014 derived from LinkedIn's relative date label; invitations sharing a label get the same computed time. No total count is available; use `connect sent --all` and count client-side."
+  },
   args: { ...GLOBAL_FLAGS },
   async run({ args }) {
     const flags = args;
@@ -242,7 +257,7 @@ var connectSentCommand = defineCommand({
 var connectReceivedCommand = defineCommand({
   meta: {
     name: "received",
-    description: "List received connection invitations. Each item carries a shared_secret \u2014 pass it to `connect respond --shared-secret`."
+    description: "Returns pending received invitations only \u2014 already-handled invitations are not returned. The `inviter.*` fields identify who sent the request. `specifics.shared_secret` is required for `connect respond`."
   },
   args: { ...GLOBAL_FLAGS },
   async run({ args }) {
@@ -266,12 +281,15 @@ var connectReceivedCommand = defineCommand({
 var connectRespondCommand = defineCommand({
   meta: { name: "respond", description: "Accept or decline a received invitation." },
   args: {
-    ...GLOBAL_FLAGS,
-    id: { type: "positional", description: "Invitation id to respond to." },
+    ...WRITE_FLAGS,
+    id: {
+      type: "positional",
+      description: "Invitation id to respond to \u2014 use the `id` field from `connect received`."
+    },
     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`.",
+      description: "Per-invitation shared secret \u2014 use `specifics.shared_secret` from the same `connect received` item.",
       required: true
     }
   },
@@ -296,7 +314,7 @@ var connectRespondCommand = defineCommand({
 var connectCancelCommand = defineCommand({
   meta: { name: "cancel", description: "Cancel a sent invitation." },
   args: {
-    ...GLOBAL_FLAGS,
+    ...WRITE_FLAGS,
     id: { type: "positional", description: "Invitation id to cancel." }
   },
   async run({ args }) {
@@ -318,11 +336,21 @@ var connectCancelCommand = defineCommand({
   }
 });
 var connectCommand = defineCommand({
-  meta: { name: "connect", description: "Send or manage connection invitations." },
+  meta: {
+    name: "connect",
+    description: "Send or manage connection invitations. Connection requests may take 10\u201330 seconds to appear in the recipient's received list (LinkedIn propagation delay)."
+  },
   args: {
-    ...GLOBAL_FLAGS,
-    id: { type: "positional", description: "Member identifier (URL, slug, or URN).", required: false },
-    note: { type: "string", description: "Optional invitation note (\u2264300 characters)." }
+    ...WRITE_FLAGS,
+    id: {
+      type: "positional",
+      description: "Recipient's LinkedIn URL, public slug, or provider_id (ACoAAA\u2026 from `curviate profile`). LinkedIn URN (`urn:li:member:N`) also accepted but the numeric member ID is not exposed by this API.",
+      required: false
+    },
+    note: {
+      type: "string",
+      description: "Personalized message shown to the recipient alongside the connection request (\u2264300 chars; LinkedIn cap). Omit to send a generic note. Personalized messages increase acceptance rates."
+    }
   },
   subCommands: {
     sent: connectSentCommand,