@curviate/cli 0.18.1 → 0.20.0

package/dist/{connect-6PU7QCOL.js → connect-KWOJKCIB.js}

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  nearestSubcommand
+} from "./chunk-HOQ7EUHJ.js";
 import {
   slimInviteReceived,
   slimInviteReceivedItem,
@@ -21,11 +24,11 @@ import {
   renderSuccess,
   renderUnexpectedError,
   resolveEffectiveConfig
-} from "./chunk-M33MI53G.js";
+} from "./chunk-HDQUEFD2.js";
 import {
   GLOBAL_FLAGS,
   WRITE_FLAGS
-} from "./chunk-TMU3CSPR.js";
+} from "./chunk-DW2HCRXJ.js";
 
 // src/commands/connect.ts
 import { defineCommand } from "citty";
@@ -256,7 +259,7 @@ async function runConnectCancel(client, flags, out) {
 var connectSentCommand = defineCommand({
   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 `user.id` (native member URN \u2014 the sent-variant carries no public slug) to identify the recipient. `created_at` is the platform's own ISO-8601 timestamp (not an approximation). No total count is available; use `connect sent --all` and count client-side. A very recently sent invitation may take a few minutes to appear here (LinkedIn-side indexing)."
+    description: "Returns pending sent invitations only. Accepted and declined invitations are not returned (LinkedIn API limitation). Use `id` with `connect cancel`; use `user.id` (native member URN; the sent-variant carries no public slug) to identify the recipient. `created_at` is the platform's own ISO-8601 timestamp (not an approximation). No total count is available; use `connect sent --all` and count client-side. A very recently sent invitation may take a few minutes to appear here (LinkedIn-side indexing)."
   },
   args: { ...GLOBAL_FLAGS },
   async run({ args }) {
@@ -269,7 +272,7 @@ var connectSentCommand = defineCommand({
       profile: flags.profile
     });
     if (!cfg.apiKey) {
-      process.stderr.write("error: no API key \u2014 run `curviate login` or pass --api-key.\n");
+      process.stderr.write("error: no API key, run `curviate login` or pass --api-key.\n");
       process.exit(3);
     }
     const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
@@ -280,7 +283,7 @@ var connectSentCommand = defineCommand({
 var connectReceivedCommand = defineCommand({
   meta: {
     name: "received",
-    description: "Returns pending received invitations only \u2014 already-handled invitations are not returned. The `user.*` fields (`public_identifier`, `display_name`, `first_name`, `last_name`) identify who sent the request. Use the `id` field with `connect accept` or `connect decline`. A very recently received invitation may take a few minutes to appear here (LinkedIn-side indexing)."
+    description: "Returns pending received invitations only. Already-handled invitations are not returned. The `user.*` fields (`public_identifier`, `display_name`, `first_name`, `last_name`) identify who sent the request. Use the `id` field with `connect accept` or `connect decline`. A very recently received invitation may take a few minutes to appear here (LinkedIn-side indexing)."
   },
   args: { ...GLOBAL_FLAGS },
   async run({ args }) {
@@ -293,7 +296,7 @@ var connectReceivedCommand = defineCommand({
       profile: flags.profile
     });
     if (!cfg.apiKey) {
-      process.stderr.write("error: no API key \u2014 run `curviate login` or pass --api-key.\n");
+      process.stderr.write("error: no API key, run `curviate login` or pass --api-key.\n");
       process.exit(3);
     }
     const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
@@ -307,7 +310,7 @@ var connectAcceptCommand = defineCommand({
     ...WRITE_FLAGS,
     id: {
       type: "positional",
-      description: "Invitation id to accept \u2014 use the `id` field from `connect received`."
+      description: "Invitation id to accept. Use the `id` field from `connect received`."
     }
   },
   async run({ args }) {
@@ -320,7 +323,7 @@ var connectAcceptCommand = defineCommand({
       profile: flags.profile
     });
     if (!cfg.apiKey) {
-      process.stderr.write("error: no API key \u2014 run `curviate login` or pass --api-key.\n");
+      process.stderr.write("error: no API key, run `curviate login` or pass --api-key.\n");
       process.exit(3);
     }
     const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
@@ -334,7 +337,7 @@ var connectDeclineCommand = defineCommand({
     ...WRITE_FLAGS,
     id: {
       type: "positional",
-      description: "Invitation id to decline \u2014 use the `id` field from `connect received`."
+      description: "Invitation id to decline. Use the `id` field from `connect received`."
     }
   },
   async run({ args }) {
@@ -347,7 +350,7 @@ var connectDeclineCommand = defineCommand({
       profile: flags.profile
     });
     if (!cfg.apiKey) {
-      process.stderr.write("error: no API key \u2014 run `curviate login` or pass --api-key.\n");
+      process.stderr.write("error: no API key, run `curviate login` or pass --api-key.\n");
       process.exit(3);
     }
     const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
@@ -371,7 +374,7 @@ var connectCancelCommand = defineCommand({
       profile: flags.profile
     });
     if (!cfg.apiKey) {
-      process.stderr.write("error: no API key \u2014 run `curviate login` or pass --api-key.\n");
+      process.stderr.write("error: no API key, run `curviate login` or pass --api-key.\n");
       process.exit(3);
     }
     const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
@@ -379,6 +382,24 @@ var connectCancelCommand = defineCommand({
     await runConnectCancel(client, { ...flags, account: flags.account ?? cfg.account }, out);
   }
 });
+var CONNECT_SUBCOMMANDS = ["sent", "received", "accept", "decline", "cancel"];
+var CONNECT_USAGE = "Usage: curviate connect <id> [--note <text>]\n       curviate connect sent\n       curviate connect received\n       curviate connect accept <invitation_id>\n       curviate connect decline <invitation_id>\n       curviate connect cancel <invitation_id>\n";
+function guardBareConnectForm(id, out) {
+  const suggestion = nearestSubcommand(id, [...CONNECT_SUBCOMMANDS]);
+  if (suggestion === null) return;
+  out.stderr.write(
+    `error: \`${id}\` looks like a mistyped \`${suggestion}\` subcommand, and \`curviate connect <id>\` SENDS a connection invitation, so this is refused rather than guessed.
+`
+  );
+  out.stderr.write(`hint: did you mean \`curviate connect ${suggestion}\`?
+`);
+  out.stderr.write(
+    `hint: if \`${id}\` really is the profile you meant, pass the full profile URL (https://www.linkedin.com/in/${id}) or the provider id instead.
+`
+  );
+  out.stderr.write(CONNECT_USAGE);
+  process.exit(2);
+}
 var connectCommand = defineCommand({
   meta: {
     name: "connect",
@@ -406,11 +427,10 @@ var connectCommand = defineCommand({
   async run({ args }) {
     const flags = args;
     if (!flags.id) {
-      process.stderr.write(
-        "Usage: curviate connect <id> [--note <text>]\n       curviate connect sent\n       curviate connect received\n       curviate connect accept <invitation_id>\n       curviate connect decline <invitation_id>\n       curviate connect cancel <invitation_id>\n"
-      );
+      process.stderr.write(CONNECT_USAGE);
       process.exit(2);
     }
+    guardBareConnectForm(flags.id, buildOutputStreams());
     const cfg = await resolveEffectiveConfig({
       apiKey: flags["api-key"],
       baseUrl: flags["base-url"],
@@ -419,7 +439,7 @@ var connectCommand = defineCommand({
       profile: flags.profile
     });
     if (!cfg.apiKey) {
-      process.stderr.write("error: no API key \u2014 run `curviate login` or pass --api-key.\n");
+      process.stderr.write("error: no API key, run `curviate login` or pass --api-key.\n");
       process.exit(3);
     }
     const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
@@ -429,6 +449,7 @@ var connectCommand = defineCommand({
 });
 export {
   connectCommand,
+  guardBareConnectForm,
   runConnectAccept,
   runConnectCancel,
   runConnectDecline,

package/dist/feed-4ROKUBG5.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import {
+  pageDelayFromFlags,
+  streamAll
+} from "./chunk-EEMJDJ4W.js";
+import {
+  createClient,
+  renderError,
+  renderSuccess,
+  renderUnexpectedError,
+  resolveEffectiveConfig
+} from "./chunk-HDQUEFD2.js";
+import {
+  GLOBAL_FLAGS
+} from "./chunk-DW2HCRXJ.js";
+
+// src/commands/feed.ts
+import { defineCommand } from "citty";
+function buildOutputStreams() {
+  return {
+    stdout: { write: (s) => process.stdout.write(s) },
+    stderr: { write: (s) => process.stderr.write(s) }
+  };
+}
+function requireAccount(account, out) {
+  if (!account) {
+    out.stderr.write("error: --account is required for this command. Set it via --account, CURVIATE_ACCOUNT, or `curviate config set-account`.\n");
+    process.exit(2);
+  }
+  return account;
+}
+function rejectPreviewOnRead(preview, out) {
+  if (preview) {
+    out.stderr.write("error: --preview is only valid on write commands (mutations). Reads just run.\n");
+    process.exit(2);
+  }
+}
+function resolveOutputOpts(flags) {
+  return {
+    json: (flags.json ?? false) || !process.stdout.isTTY,
+    isTTY: process.stdout.isTTY ?? false,
+    fields: flags.fields,
+    verbose: flags.verbose ?? false
+  };
+}
+async function handleSdkError(err, outOpts, out) {
+  const { CurviateError } = await import("@curviate/sdk");
+  if (err instanceof CurviateError) {
+    const { getExitCode } = await import("./exit-codes-63JE5GM5.js");
+    renderError(err, outOpts, out);
+    process.exit(getExitCode(err.code));
+  }
+  renderUnexpectedError(err, out);
+  process.exit(1);
+}
+async function runFeedHome(client, flags, out) {
+  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 params = {};
+  if (flags.sort) params["sort"] = flags.sort;
+  if (flags.limit) params["limit"] = parseInt(flags.limit, 10);
+  if (flags.cursor) params["cursor"] = flags.cursor;
+  try {
+    if (all) {
+      const fn = (p) => ns.feed.home(p);
+      for await (const item of streamAll(fn, params, {
+        maxPages,
+        out,
+        pageDelayMs: pageDelayFromFlags(flags)
+      })) {
+        out.stdout.write(JSON.stringify(item) + "\n");
+      }
+    } else {
+      const result = await ns.feed.home(params);
+      renderSuccess(result, outOpts, out);
+    }
+  } catch (err) {
+    await handleSdkError(err, outOpts, out);
+  }
+}
+var FEED_ARGS = {
+  ...GLOBAL_FLAGS,
+  sort: {
+    type: "string",
+    description: "Sort order: recent (default, reverse-chronological, always available) or relevant (LinkedIn's ranked 'top' feed, shared throttled budget). Ignored when --cursor is supplied."
+  }
+};
+var feedHomeCommand = defineCommand({
+  meta: { name: "home", description: "Read the connected account's LinkedIn home feed as agent-actionable posts." },
+  args: FEED_ARGS,
+  async run({ args }) {
+    const flags = args;
+    const cfg = await resolveEffectiveConfig({
+      apiKey: flags["api-key"],
+      baseUrl: flags["base-url"],
+      timeout: flags.timeout,
+      account: flags.account,
+      profile: flags.profile
+    });
+    if (!cfg.apiKey) {
+      process.stderr.write("error: no API key, run `curviate login` or pass --api-key.\n");
+      process.exit(3);
+    }
+    const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
+    const out = buildOutputStreams();
+    await runFeedHome(client, { ...flags, account: flags.account ?? cfg.account }, out);
+  }
+});
+var feedCommand = defineCommand({
+  meta: { name: "feed", description: "Read the connected account's LinkedIn home feed as agent-actionable posts." },
+  subCommands: {
+    home: feedHomeCommand
+  },
+  async run() {
+    process.stderr.write(
+      "Usage: curviate feed <subcommand>\n  home [--sort recent|relevant] [--limit] [--cursor] [--all]\n"
+    );
+  }
+});
+export {
+  feedCommand,
+  runFeedHome
+};

package/dist/group-L7TQEEFN.js

@@ -0,0 +1,236 @@
+#!/usr/bin/env node
+import {
+  pageDelayFromFlags,
+  streamAll
+} from "./chunk-EEMJDJ4W.js";
+import {
+  createClient,
+  renderError,
+  renderSuccess,
+  renderUnexpectedError,
+  resolveEffectiveConfig
+} from "./chunk-HDQUEFD2.js";
+import {
+  GLOBAL_FLAGS,
+  READ_SINGLE_FLAGS
+} from "./chunk-DW2HCRXJ.js";
+
+// src/commands/group.ts
+import { defineCommand } from "citty";
+function buildOutputStreams() {
+  return {
+    stdout: { write: (s) => process.stdout.write(s) },
+    stderr: { write: (s) => process.stderr.write(s) }
+  };
+}
+function requireAccount(account, out) {
+  if (!account) {
+    out.stderr.write("error: --account is required for this command. Set it via --account, CURVIATE_ACCOUNT, or `curviate config set-account`.\n");
+    process.exit(2);
+  }
+  return account;
+}
+function rejectPreviewOnRead(preview, out) {
+  if (preview) {
+    out.stderr.write("error: --preview is only valid on write commands (mutations). Reads just run.\n");
+    process.exit(2);
+  }
+}
+function rejectAllOnNonPaginated(all, out) {
+  if (all) {
+    out.stderr.write("error: --all is not supported on non-paginated commands.\n");
+    process.exit(2);
+  }
+}
+function resolveOutputOpts(flags) {
+  return {
+    json: (flags.json ?? false) || !process.stdout.isTTY,
+    isTTY: process.stdout.isTTY ?? false,
+    fields: flags.fields,
+    verbose: flags.verbose ?? false
+  };
+}
+async function handleSdkError(err, outOpts, out) {
+  const { CurviateError } = await import("@curviate/sdk");
+  if (err instanceof CurviateError) {
+    const { getExitCode } = await import("./exit-codes-63JE5GM5.js");
+    renderError(err, outOpts, out);
+    process.exit(getExitCode(err.code));
+  }
+  renderUnexpectedError(err, out);
+  process.exit(1);
+}
+async function runGroupList(client, flags, out) {
+  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 params = {};
+  if (flags.target) params["profile"] = flags.target;
+  if (flags.limit) params["limit"] = parseInt(flags.limit, 10);
+  if (flags.cursor) params["cursor"] = flags.cursor;
+  try {
+    if (all) {
+      const fn = (p) => ns.groups.list(p);
+      for await (const item of streamAll(fn, params, {
+        maxPages,
+        out,
+        pageDelayMs: pageDelayFromFlags(flags)
+      })) {
+        out.stdout.write(JSON.stringify(item) + "\n");
+      }
+    } else {
+      const result = await ns.groups.list(params);
+      renderSuccess(result, outOpts, out);
+    }
+  } catch (err) {
+    await handleSdkError(err, outOpts, out);
+  }
+}
+async function runGroupGet(client, flags, out) {
+  rejectPreviewOnRead(flags.preview, out);
+  rejectAllOnNonPaginated(flags.all, out);
+  const accountId = requireAccount(flags.account, out);
+  const groupId = flags.groupId ?? "";
+  const ns = client.account(accountId);
+  const outOpts = resolveOutputOpts(flags);
+  try {
+    const result = await ns.groups.get(groupId);
+    renderSuccess(result, outOpts, out);
+  } catch (err) {
+    await handleSdkError(err, outOpts, out);
+  }
+}
+async function runGroupMembers(client, flags, out) {
+  rejectPreviewOnRead(flags.preview, out);
+  const accountId = requireAccount(flags.account, out);
+  const groupId = flags.groupId ?? "";
+  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 params = {};
+  if (flags.name) params["name"] = flags.name;
+  if (flags.limit) params["limit"] = parseInt(flags.limit, 10);
+  if (flags.cursor) params["cursor"] = flags.cursor;
+  try {
+    if (all) {
+      const fn = (p) => ns.groups.members(groupId, p);
+      for await (const item of streamAll(fn, params, {
+        maxPages,
+        out,
+        pageDelayMs: pageDelayFromFlags(flags)
+      })) {
+        out.stdout.write(JSON.stringify(item) + "\n");
+      }
+    } else {
+      const result = await ns.groups.members(groupId, params);
+      renderSuccess(result, outOpts, out);
+    }
+  } catch (err) {
+    await handleSdkError(err, outOpts, out);
+  }
+}
+var groupListCommand = defineCommand({
+  meta: { name: "list", description: "List the groups the connected account belongs to. Pass --target to enumerate another member's groups instead (a partial, interests-only read)." },
+  args: {
+    ...GLOBAL_FLAGS,
+    target: {
+      type: "string",
+      description: "Target another LinkedIn member's groups instead of your own: a vanity slug or full /in/{vanity} URL. Omit to enumerate your own groups (a complete read)."
+    }
+  },
+  async run({ args }) {
+    const flags = args;
+    const cfg = await resolveEffectiveConfig({
+      apiKey: flags["api-key"],
+      baseUrl: flags["base-url"],
+      timeout: flags.timeout,
+      account: flags.account,
+      profile: flags.profile
+    });
+    if (!cfg.apiKey) {
+      process.stderr.write("error: no API key, run `curviate login` or pass --api-key.\n");
+      process.exit(3);
+    }
+    const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
+    const out = buildOutputStreams();
+    await runGroupList(client, { ...flags, account: flags.account ?? cfg.account }, out);
+  }
+});
+var groupGetCommand = defineCommand({
+  meta: { name: "get", description: "Get one LinkedIn group's full detail: name, member count, description, admin contact, and write-feasibility gates." },
+  args: {
+    ...READ_SINGLE_FLAGS,
+    groupId: { type: "positional", description: "Numeric group id, or a full group URL (e.g. https://www.linkedin.com/groups/9123014/)." }
+  },
+  async run({ args }) {
+    const flags = args;
+    const cfg = await resolveEffectiveConfig({
+      apiKey: flags["api-key"],
+      baseUrl: flags["base-url"],
+      timeout: flags.timeout,
+      account: flags.account,
+      profile: flags.profile
+    });
+    if (!cfg.apiKey) {
+      process.stderr.write("error: no API key, run `curviate login` or pass --api-key.\n");
+      process.exit(3);
+    }
+    const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
+    const out = buildOutputStreams();
+    await runGroupGet(client, { ...flags, account: flags.account ?? cfg.account }, out);
+  }
+});
+var groupMembersCommand = defineCommand({
+  meta: {
+    name: "members",
+    description: "List (or search by name) a group's members: id, profile URL, name, headline, and relationship signal. Requires the connected account be a member of the group."
+  },
+  args: {
+    ...GLOBAL_FLAGS,
+    groupId: { type: "positional", description: "Numeric group id, or a full group URL." },
+    name: {
+      type: "string",
+      description: "Filter the roster by member name: prefix/substring, multi-word, case-insensitive. Omit for the full roster."
+    }
+  },
+  async run({ args }) {
+    const flags = args;
+    const cfg = await resolveEffectiveConfig({
+      apiKey: flags["api-key"],
+      baseUrl: flags["base-url"],
+      timeout: flags.timeout,
+      account: flags.account,
+      profile: flags.profile
+    });
+    if (!cfg.apiKey) {
+      process.stderr.write("error: no API key, run `curviate login` or pass --api-key.\n");
+      process.exit(3);
+    }
+    const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
+    const out = buildOutputStreams();
+    await runGroupMembers(client, { ...flags, account: flags.account ?? cfg.account }, out);
+  }
+});
+var groupCommand = defineCommand({
+  meta: { name: "group", description: "Read LinkedIn groups: your own membership list, one group's detail, and its member roster." },
+  subCommands: {
+    list: groupListCommand,
+    get: groupGetCommand,
+    members: groupMembersCommand
+  },
+  async run() {
+    process.stderr.write(
+      "Usage: curviate group <subcommand>\n  list [--target <slug>]\n  get <group_id>\n  members <group_id> [--name <filter>]\n"
+    );
+  }
+});
+export {
+  groupCommand,
+  runGroupGet,
+  runGroupList,
+  runGroupMembers
+};

package/dist/{inbox-DRJ6ENXC.js → inbox-GMGZVDTQ.js}

@@ -15,12 +15,12 @@ import {
   renderSuccess,
   renderUnexpectedError,
   resolveEffectiveConfig
-} from "./chunk-M33MI53G.js";
+} from "./chunk-HDQUEFD2.js";
 import {
   GLOBAL_FLAGS,
   READ_SINGLE_FLAGS,
   WRITE_SINGLE_FLAGS
-} from "./chunk-TMU3CSPR.js";
+} from "./chunk-DW2HCRXJ.js";
 
 // src/commands/inbox.ts
 import { defineCommand } from "citty";
@@ -189,6 +189,37 @@ async function runInboxMessages(client, flags, out) {
     await handleSdkError(err, outOpts, out);
   }
 }
+async function runInboxSearch(client, flags, out) {
+  rejectPreviewOnRead(flags.preview, out);
+  const accountId = requireAccount(flags.account, out);
+  const query = flags.query ?? "";
+  if (!query) {
+    out.stderr.write("error: <query> is required.\n");
+    process.exit(2);
+  }
+  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 params = { query, ...buildPaginationParams(flags) };
+  try {
+    if (all) {
+      const fn = (p) => ns.messaging.searchChats(p);
+      for await (const item of streamAll(fn, params, {
+        maxPages,
+        out,
+        pageDelayMs: pageDelayFromFlags(flags)
+      })) {
+        out.stdout.write(JSON.stringify(item) + "\n");
+      }
+    } else {
+      const result = await ns.messaging.searchChats(params);
+      renderSuccess(result, outOpts, out);
+    }
+  } catch (err) {
+    await handleSdkError(err, outOpts, out);
+  }
+}
 var inboxListCommand = defineCommand({
   meta: { name: "list", description: "List inbox chats." },
   args: {
@@ -210,7 +241,7 @@ var inboxListCommand = defineCommand({
       profile: flags.profile
     });
     if (!cfg.apiKey) {
-      process.stderr.write("error: no API key \u2014 run `curviate login` or pass --api-key.\n");
+      process.stderr.write("error: no API key, run `curviate login` or pass --api-key.\n");
       process.exit(3);
     }
     const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
@@ -235,7 +266,7 @@ var inboxGetCommand = defineCommand({
       profile: flags.profile
     });
     if (!cfg.apiKey) {
-      process.stderr.write("error: no API key \u2014 run `curviate login` or pass --api-key.\n");
+      process.stderr.write("error: no API key, run `curviate login` or pass --api-key.\n");
       process.exit(3);
     }
     const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
@@ -260,7 +291,7 @@ var inboxMarkReadCommand = defineCommand({
       profile: flags.profile
     });
     if (!cfg.apiKey) {
-      process.stderr.write("error: no API key \u2014 run `curviate login` or pass --api-key.\n");
+      process.stderr.write("error: no API key, run `curviate login` or pass --api-key.\n");
       process.exit(3);
     }
     const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
@@ -276,11 +307,11 @@ var inboxMessagesCommand = defineCommand({
     chatId: { type: "positional", description: "Chat ID." },
     before: {
       type: "string",
-      description: "Return messages before this timestamp (ISO-8601, UTC \u2014 Z suffix required, e.g. 2025-01-01T00:00:00Z)."
+      description: "Return messages before this timestamp (ISO-8601, UTC; Z suffix required, e.g. 2025-01-01T00:00:00Z)."
     },
     after: {
       type: "string",
-      description: "Return messages after this timestamp (ISO-8601, UTC \u2014 Z suffix required, e.g. 2025-01-01T00:00:00Z)."
+      description: "Return messages after this timestamp (ISO-8601, UTC; Z suffix required, e.g. 2025-01-01T00:00:00Z)."
     }
   },
   async run({ args }) {
@@ -293,7 +324,7 @@ var inboxMessagesCommand = defineCommand({
       profile: flags.profile
     });
     if (!cfg.apiKey) {
-      process.stderr.write("error: no API key \u2014 run `curviate login` or pass --api-key.\n");
+      process.stderr.write("error: no API key, run `curviate login` or pass --api-key.\n");
       process.exit(3);
     }
     const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
@@ -301,17 +332,43 @@ var inboxMessagesCommand = defineCommand({
     await runInboxMessages(client, { ...flags, account: flags.account ?? cfg.account }, out);
   }
 });
+var inboxSearchCommand = defineCommand({
+  meta: { name: "search", description: "Free-text search the account's own inbox (matches participant names and message content)." },
+  args: {
+    ...GLOBAL_FLAGS,
+    limit: { type: "string", description: "Number of items to return per page (1-100, default 20)." },
+    query: { type: "positional", description: "Search term (e.g. a name or a phrase from a message)." }
+  },
+  async run({ args }) {
+    const flags = args;
+    const cfg = await resolveEffectiveConfig({
+      apiKey: flags["api-key"],
+      baseUrl: flags["base-url"],
+      timeout: flags.timeout,
+      account: flags.account,
+      profile: flags.profile
+    });
+    if (!cfg.apiKey) {
+      process.stderr.write("error: no API key, run `curviate login` or pass --api-key.\n");
+      process.exit(3);
+    }
+    const client = createClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl, timeout: cfg.timeout });
+    const out = buildOutputStreams();
+    await runInboxSearch(client, { ...flags, account: flags.account ?? cfg.account }, out);
+  }
+});
 var inboxCommand = defineCommand({
   meta: { name: "inbox", description: "Read LinkedIn message inbox." },
   subCommands: {
     list: inboxListCommand,
     get: inboxGetCommand,
     "mark-read": inboxMarkReadCommand,
-    messages: inboxMessagesCommand
+    messages: inboxMessagesCommand,
+    search: inboxSearchCommand
   },
   async run() {
     process.stderr.write(
-      "Usage: curviate inbox <subcommand>\n  list\n  get <chat_id>\n  mark-read <chat_id>\n  messages <chat_id>\n"
+      "Usage: curviate inbox <subcommand>\n  list\n  get <chat_id>\n  mark-read <chat_id>\n  messages <chat_id>\n  search <query>\n"
     );
   }
 });
@@ -320,5 +377,6 @@ export {
   runInboxGet,
   runInboxList,
   runInboxMarkRead,
-  runInboxMessages
+  runInboxMessages,
+  runInboxSearch
 };