@curviate/cli 0.41.0 → 0.43.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/CHANGELOG.md +70 -0
  2. package/dist/{account-QZ5RYKIT.js → account-FDPUPVFB.js} +118 -29
  3. package/dist/{chunk-CBHL3QQJ.js → chunk-B5NIX4G6.js} +1 -1
  4. package/dist/{chunk-BLFGJIJJ.js → chunk-BLJGV6ST.js} +2 -2
  5. package/dist/{chunk-XP2LN6F6.js → chunk-EGDDVF3Q.js} +3 -1
  6. package/dist/{chunk-6W7364S3.js → chunk-KJ24DIAJ.js} +1 -1
  7. package/dist/{chunk-4AAKZPOM.js → chunk-OUMMWC7G.js} +76 -26
  8. package/dist/{chunk-WAE7YLO5.js → chunk-PCZH5QJA.js} +1 -1
  9. package/dist/{chunk-XDQHNUEU.js → chunk-TC4ZPUWI.js} +12 -6
  10. package/dist/{chunk-DCZR4M7G.js → chunk-UJOTQPL6.js} +1 -1
  11. package/dist/cli.js +64 -53
  12. package/dist/{comment-SYA6OKEY.js → comment-G4EXIIAQ.js} +83 -29
  13. package/dist/{company-IXQ4OFU3.js → company-2WKYM34T.js} +101 -51
  14. package/dist/{config-RUBXWFQ3.js → config-K4G3VSBA.js} +44 -9
  15. package/dist/{connect-TTA2X3KO.js → connect-GHABKXB2.js} +45 -22
  16. package/dist/{doctor-ET7XQ22E.js → doctor-ICAEETCL.js} +8 -4
  17. package/dist/examples-IJL3A6SZ.js +18 -0
  18. package/dist/{feed-556LS3CN.js → feed-XC5235UF.js} +16 -14
  19. package/dist/{group-DIIG4XQT.js → group-JDP2HVSV.js} +29 -20
  20. package/dist/{inbox-SRVTUTE6.js → inbox-W3KR65VD.js} +49 -24
  21. package/dist/{inboxes-XHZTAUQ7.js → inboxes-XYS3IRT6.js} +21 -17
  22. package/dist/{job-QNVGEM4J.js → job-OJB4VSI2.js} +109 -35
  23. package/dist/{login-YTVPIN27.js → login-OHAHNBRW.js} +7 -3
  24. package/dist/{message-2JEL6P7E.js → message-5XC7U4JC.js} +5 -5
  25. package/dist/{notification-T4SRAIJ3.js → notification-RIUSYJV6.js} +26 -16
  26. package/dist/{post-PV4UQVPO.js → post-LSEBRQYK.js} +94 -32
  27. package/dist/{profile-K5BZNGX5.js → profile-BHZPRUFU.js} +125 -44
  28. package/dist/{recruiter-OBKS4ZVL.js → recruiter-JUA4BZIC.js} +211 -68
  29. package/dist/{sales-nav-WPTMS6QF.js → sales-nav-77NP3UXV.js} +100 -42
  30. package/dist/{search-YAKZKK74.js → search-3MRQE6VC.js} +81 -40
  31. package/dist/{setup-NZQUWJYC.js → setup-BPNLAHPC.js} +9 -4
  32. package/dist/{webhook-PXSLDB2F.js → webhook-TOQUQPT4.js} +79 -31
  33. package/package.json +3 -2
@@ -0,0 +1,18 @@
1
+ #!/usr/bin/env node
2
+
3
+ // src/lib/examples.ts
4
+ import { showUsage } from "citty";
5
+ async function showUsageWithExamples(cmd, parent) {
6
+ await showUsage(cmd, parent);
7
+ const meta = typeof cmd.meta === "function" ? await cmd.meta() : await cmd.meta;
8
+ const block = (title, lines = []) => lines.length ? process.stdout.write(`${title}
9
+
10
+ ${lines.map((l) => ` ${l}`).join("\n")}
11
+
12
+ `) : void 0;
13
+ block("REQUIRES", meta?.requires);
14
+ block("EXAMPLES", meta?.examples);
15
+ }
16
+ export {
17
+ showUsageWithExamples
18
+ };
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  requireAccount
4
- } from "./chunk-BLFGJIJJ.js";
4
+ } from "./chunk-BLJGV6ST.js";
5
5
  import {
6
6
  pageDelayFromFlags,
7
7
  readCursorFlag,
@@ -14,14 +14,15 @@ import {
14
14
  resolveEffectiveConfig,
15
15
  streamAll,
16
16
  writeNdjsonItem
17
- } from "./chunk-CBHL3QQJ.js";
17
+ } from "./chunk-B5NIX4G6.js";
18
18
  import "./chunk-XZJQQJBE.js";
19
19
  import {
20
20
  createClient
21
- } from "./chunk-DCZR4M7G.js";
21
+ } from "./chunk-UJOTQPL6.js";
22
22
  import {
23
- GLOBAL_FLAGS
24
- } from "./chunk-XDQHNUEU.js";
23
+ GLOBAL_FLAGS,
24
+ readOnly
25
+ } from "./chunk-TC4ZPUWI.js";
25
26
 
26
27
  // src/commands/feed.ts
27
28
  import { defineCommand } from "citty";
@@ -31,12 +32,6 @@ function buildOutputStreams() {
31
32
  stderr: { write: (s) => process.stderr.write(s) }
32
33
  };
33
34
  }
34
- function rejectPreviewOnRead(preview, out) {
35
- if (preview) {
36
- out.stderr.write("error: --preview is only valid on write commands (mutations). Reads just run.\n");
37
- process.exit(2);
38
- }
39
- }
40
35
  function resolveOutputOpts(flags) {
41
36
  return {
42
37
  json: (flags.json ?? false) || !process.stdout.isTTY,
@@ -56,7 +51,6 @@ async function handleSdkError(err, outOpts, out) {
56
51
  process.exit(1);
57
52
  }
58
53
  async function runFeedHome(client, flags, out) {
59
- rejectPreviewOnRead(flags.preview, out);
60
54
  rejectPaginationModifiersWithoutAll(flags, out);
61
55
  const accountId = await requireAccount(client, flags, out);
62
56
  const ns = client.account(accountId);
@@ -88,14 +82,22 @@ async function runFeedHome(client, flags, out) {
88
82
  }
89
83
  }
90
84
  var FEED_ARGS = {
91
- ...GLOBAL_FLAGS,
85
+ ...readOnly(GLOBAL_FLAGS),
92
86
  sort: {
93
87
  type: "string",
94
88
  description: "Sort order: recent (default, reverse-chronological, always available) or relevant (LinkedIn's ranked 'top' feed, shared throttled budget). Ignored when --cursor is supplied."
95
89
  }
96
90
  };
97
91
  var feedHomeCommand = defineCommand({
98
- meta: { name: "home", description: "Read the connected account's LinkedIn home feed as agent-actionable posts." },
92
+ meta: {
93
+ name: "home",
94
+ description: "Read the connected account's LinkedIn home feed as agent-actionable posts. On the default recent sort the feed is an index: each post's text is null and only the author's name resolves, so fetch a body with `curviate post get <id>`. --sort relevant fills text and engagement.",
95
+ examples: [
96
+ "curviate feed home",
97
+ "curviate feed home --sort relevant",
98
+ "curviate feed home --all --max-pages 3"
99
+ ]
100
+ },
99
101
  args: FEED_ARGS,
100
102
  async run({ args }) {
101
103
  const flags = args;
@@ -4,7 +4,7 @@ import {
4
4
  } from "./chunk-UEAX6KUB.js";
5
5
  import {
6
6
  requireAccount
7
- } from "./chunk-BLFGJIJJ.js";
7
+ } from "./chunk-BLJGV6ST.js";
8
8
  import {
9
9
  pageDelayFromFlags,
10
10
  readCursorFlag,
@@ -18,15 +18,16 @@ import {
18
18
  resolveEffectiveConfig,
19
19
  streamAll,
20
20
  writeNdjsonItem
21
- } from "./chunk-CBHL3QQJ.js";
21
+ } from "./chunk-B5NIX4G6.js";
22
22
  import "./chunk-XZJQQJBE.js";
23
23
  import {
24
24
  createClient
25
- } from "./chunk-DCZR4M7G.js";
25
+ } from "./chunk-UJOTQPL6.js";
26
26
  import {
27
27
  GLOBAL_FLAGS,
28
- READ_SINGLE_FLAGS
29
- } from "./chunk-XDQHNUEU.js";
28
+ READ_SINGLE_FLAGS,
29
+ readOnly
30
+ } from "./chunk-TC4ZPUWI.js";
30
31
 
31
32
  // src/commands/group.ts
32
33
  import { defineCommand } from "citty";
@@ -36,12 +37,6 @@ function buildOutputStreams() {
36
37
  stderr: { write: (s) => process.stderr.write(s) }
37
38
  };
38
39
  }
39
- function rejectPreviewOnRead(preview, out) {
40
- if (preview) {
41
- out.stderr.write("error: --preview is only valid on write commands (mutations). Reads just run.\n");
42
- process.exit(2);
43
- }
44
- }
45
40
  function rejectAllOnNonPaginated(all, out) {
46
41
  if (all) {
47
42
  out.stderr.write("error: --all is not supported on non-paginated commands.\n");
@@ -67,7 +62,6 @@ async function handleSdkError(err, outOpts, out) {
67
62
  process.exit(1);
68
63
  }
69
64
  async function runGroupList(client, flags, out) {
70
- rejectPreviewOnRead(flags.preview, out);
71
65
  rejectPaginationModifiersWithoutAll(flags, out);
72
66
  const accountId = await requireAccount(client, flags, out);
73
67
  const ns = client.account(accountId);
@@ -99,7 +93,6 @@ async function runGroupList(client, flags, out) {
99
93
  }
100
94
  }
101
95
  async function runGroupGet(client, flags, out) {
102
- rejectPreviewOnRead(flags.preview, out);
103
96
  rejectAllOnNonPaginated(flags.all, out);
104
97
  const accountId = await requireAccount(client, flags, out);
105
98
  const groupId = normalizeGroupId(flags.groupId ?? "");
@@ -114,7 +107,6 @@ async function runGroupGet(client, flags, out) {
114
107
  }
115
108
  }
116
109
  async function runGroupMembers(client, flags, out) {
117
- rejectPreviewOnRead(flags.preview, out);
118
110
  rejectPaginationModifiersWithoutAll(flags, out);
119
111
  const accountId = await requireAccount(client, flags, out);
120
112
  const groupId = normalizeGroupId(flags.groupId ?? "");
@@ -147,9 +139,16 @@ async function runGroupMembers(client, flags, out) {
147
139
  }
148
140
  }
149
141
  var groupListCommand = defineCommand({
150
- 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)." },
142
+ meta: {
143
+ name: "list",
144
+ description: "List the groups the connected account belongs to. Pass --target to enumerate another member's groups instead (a partial, interests-only read).",
145
+ examples: [
146
+ "curviate group list",
147
+ "curviate group list --target janesmith"
148
+ ]
149
+ },
151
150
  args: {
152
- ...GLOBAL_FLAGS,
151
+ ...readOnly(GLOBAL_FLAGS),
153
152
  target: {
154
153
  type: "string",
155
154
  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)."
@@ -174,9 +173,15 @@ var groupListCommand = defineCommand({
174
173
  }
175
174
  });
176
175
  var groupGetCommand = defineCommand({
177
- meta: { name: "get", description: "Get one LinkedIn group's full detail: name, member count, description, admin contact, and write-feasibility gates." },
176
+ meta: {
177
+ name: "get",
178
+ description: "Get one LinkedIn group's full detail: name, member count, description, admin contact, and write-feasibility gates.",
179
+ examples: [
180
+ "curviate group get 12345678"
181
+ ]
182
+ },
178
183
  args: {
179
- ...READ_SINGLE_FLAGS,
184
+ ...readOnly(READ_SINGLE_FLAGS),
180
185
  groupId: { type: "positional", description: "Numeric group id, or a full group URL (e.g. https://www.linkedin.com/groups/9123014/)." }
181
186
  },
182
187
  async run({ args }) {
@@ -200,10 +205,14 @@ var groupGetCommand = defineCommand({
200
205
  var groupMembersCommand = defineCommand({
201
206
  meta: {
202
207
  name: "members",
203
- 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."
208
+ 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.",
209
+ examples: [
210
+ "curviate group members 12345678",
211
+ "curviate group members 12345678 --name sophie"
212
+ ]
204
213
  },
205
214
  args: {
206
- ...GLOBAL_FLAGS,
215
+ ...readOnly(GLOBAL_FLAGS),
207
216
  groupId: { type: "positional", description: "Numeric group id, or a full group URL." },
208
217
  name: {
209
218
  type: "string",
@@ -8,7 +8,7 @@ import {
8
8
  } from "./chunk-UEAX6KUB.js";
9
9
  import {
10
10
  requireAccount
11
- } from "./chunk-BLFGJIJJ.js";
11
+ } from "./chunk-BLJGV6ST.js";
12
12
  import {
13
13
  buildPreviewOutput
14
14
  } from "./chunk-TCUYH5GO.js";
@@ -25,16 +25,17 @@ import {
25
25
  resolveEffectiveConfig,
26
26
  streamAll,
27
27
  writeNdjsonItem
28
- } from "./chunk-CBHL3QQJ.js";
28
+ } from "./chunk-B5NIX4G6.js";
29
29
  import "./chunk-XZJQQJBE.js";
30
30
  import {
31
31
  createClient
32
- } from "./chunk-DCZR4M7G.js";
32
+ } from "./chunk-UJOTQPL6.js";
33
33
  import {
34
34
  GLOBAL_FLAGS,
35
35
  READ_SINGLE_FLAGS,
36
- WRITE_SINGLE_FLAGS
37
- } from "./chunk-XDQHNUEU.js";
36
+ WRITE_SINGLE_FLAGS,
37
+ readOnly
38
+ } from "./chunk-TC4ZPUWI.js";
38
39
 
39
40
  // src/commands/inbox.ts
40
41
  import { defineCommand } from "citty";
@@ -44,12 +45,6 @@ function buildOutputStreams() {
44
45
  stderr: { write: (s) => process.stderr.write(s) }
45
46
  };
46
47
  }
47
- function rejectPreviewOnRead(preview, out) {
48
- if (preview) {
49
- out.stderr.write("error: --preview is only valid on write commands (mutations). Reads just run.\n");
50
- process.exit(2);
51
- }
52
- }
53
48
  function rejectAllOnNonPaginated(all, out) {
54
49
  if (all) {
55
50
  out.stderr.write("error: --all is not supported on non-paginated commands.\n");
@@ -110,7 +105,6 @@ async function handleSdkError(err, outOpts, out) {
110
105
  process.exit(1);
111
106
  }
112
107
  async function runInboxList(client, flags, out) {
113
- rejectPreviewOnRead(flags.preview, out);
114
108
  rejectPaginationModifiersWithoutAll(flags, out);
115
109
  const accountId = await requireAccount(client, flags, out);
116
110
  const ns = client.account(accountId);
@@ -146,7 +140,6 @@ async function runInboxList(client, flags, out) {
146
140
  }
147
141
  }
148
142
  async function runInboxGet(client, flags, out) {
149
- rejectPreviewOnRead(flags.preview, out);
150
143
  rejectAllOnNonPaginated(flags.all, out);
151
144
  const retrieval = parseRetrievalFlags(flags);
152
145
  if (!retrieval.ok) {
@@ -185,7 +178,6 @@ async function runInboxMarkRead(client, flags, out) {
185
178
  }
186
179
  }
187
180
  async function runInboxMessages(client, flags, out) {
188
- rejectPreviewOnRead(flags.preview, out);
189
181
  rejectPaginationModifiersWithoutAll(flags, out);
190
182
  const retrieval = parseRetrievalFlags(flags);
191
183
  if (!retrieval.ok) {
@@ -240,7 +232,6 @@ async function runInboxMessages(client, flags, out) {
240
232
  }
241
233
  }
242
234
  async function runInboxSearch(client, flags, out) {
243
- rejectPreviewOnRead(flags.preview, out);
244
235
  rejectPaginationModifiersWithoutAll(flags, out);
245
236
  const accountId = await requireAccount(client, flags, out);
246
237
  const query = flags.query ?? "";
@@ -280,9 +271,17 @@ async function runInboxSearch(client, flags, out) {
280
271
  }
281
272
  }
282
273
  var inboxListCommand = defineCommand({
283
- meta: { name: "list", description: "List inbox chats." },
274
+ meta: {
275
+ name: "list",
276
+ description: "List inbox chats.",
277
+ examples: [
278
+ "curviate inbox list",
279
+ "curviate inbox list --unread",
280
+ "curviate inbox list --inbox archived --all"
281
+ ]
282
+ },
284
283
  args: {
285
- ...GLOBAL_FLAGS,
284
+ ...readOnly(GLOBAL_FLAGS),
286
285
  limit: { type: "string", description: "Number of items to return per page (1-25, default 20)." },
287
286
  unread: {
288
287
  type: "boolean",
@@ -313,10 +312,16 @@ var inboxListCommand = defineCommand({
313
312
  }
314
313
  });
315
314
  var inboxGetCommand = defineCommand({
316
- meta: { name: "get", description: "Get details of a single chat." },
315
+ meta: {
316
+ name: "get",
317
+ description: "Get details of a single chat.",
318
+ examples: [
319
+ "curviate inbox get 2-YTQ3ODU3Njgt"
320
+ ]
321
+ },
317
322
  args: {
318
323
  // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
319
- ...READ_SINGLE_FLAGS,
324
+ ...readOnly(READ_SINGLE_FLAGS),
320
325
  ...RETRIEVAL_FLAGS,
321
326
  chatId: { type: "positional", description: "Chat ID." }
322
327
  },
@@ -339,7 +344,13 @@ var inboxGetCommand = defineCommand({
339
344
  }
340
345
  });
341
346
  var inboxMarkReadCommand = defineCommand({
342
- meta: { name: "mark-read", description: "Mark a chat as read." },
347
+ meta: {
348
+ name: "mark-read",
349
+ description: "Mark a chat as read.",
350
+ examples: [
351
+ "curviate inbox mark-read 2-YTQ3ODU3Njgt"
352
+ ]
353
+ },
343
354
  args: {
344
355
  // Write command: WRITE_SINGLE_FLAGS omits pagination flags, keeps --fields
345
356
  ...WRITE_SINGLE_FLAGS,
@@ -364,9 +375,17 @@ var inboxMarkReadCommand = defineCommand({
364
375
  }
365
376
  });
366
377
  var inboxMessagesCommand = defineCommand({
367
- meta: { name: "messages", description: "List messages in a chat. A very recent send/delete may take a few minutes to appear or clear here (LinkedIn-side indexing); `message get <chat_id> <message_id>` reflects it immediately. `--mode cache_only` is answered only for an unfiltered, uncursored first page of a chat whose whole message set fits in that one page (`--limit`, at most 25), and only after a walk of the chat reached its end: any unfiltered page fetched from LinkedIn (such as `--mode live` without `--all`) restarts that walk, and `--all` walks to the end and closes it. A read carrying `--before`, `--after` or `--cursor` is never served from the store." },
378
+ meta: {
379
+ name: "messages",
380
+ description: "List messages in a chat. A very recent send/delete may take a few minutes to appear or clear here (LinkedIn-side indexing); `message get <chat_id> <message_id>` reflects it immediately. `--mode cache_only` is answered only for an unfiltered, uncursored first page of a chat whose whole message set fits in that one page (`--limit`, at most 25), and only after a walk of the chat reached its end: any unfiltered page fetched from LinkedIn (such as `--mode live` without `--all`) restarts that walk, and `--all` walks to the end and closes it. A read carrying `--before`, `--after` or `--cursor` is never served from the store.",
381
+ examples: [
382
+ "curviate inbox messages 2-YTQ3ODU3Njgt",
383
+ "curviate inbox messages 2-YTQ3ODU3Njgt --limit 20",
384
+ "curviate inbox messages 2-YTQ3ODU3Njgt --after 2026-06-01T00:00:00Z"
385
+ ]
386
+ },
368
387
  args: {
369
- ...GLOBAL_FLAGS,
388
+ ...readOnly(GLOBAL_FLAGS),
370
389
  ...RETRIEVAL_FLAGS,
371
390
  limit: { type: "string", description: "Number of items to return per page (1-25, default 20)." },
372
391
  chatId: { type: "positional", description: "Chat ID." },
@@ -398,9 +417,15 @@ var inboxMessagesCommand = defineCommand({
398
417
  }
399
418
  });
400
419
  var inboxSearchCommand = defineCommand({
401
- meta: { name: "search", description: "Free-text search the account's own inbox (matches participant names and message content)." },
420
+ meta: {
421
+ name: "search",
422
+ description: "Free-text search the account's own inbox (matches participant names and message content).",
423
+ examples: [
424
+ "curviate inbox search sophie"
425
+ ]
426
+ },
402
427
  args: {
403
- ...GLOBAL_FLAGS,
428
+ ...readOnly(GLOBAL_FLAGS),
404
429
  limit: { type: "string", description: "Number of items to return per page (1-100, default 20)." },
405
430
  query: { type: "positional", description: "Search term (e.g. a name or a phrase from a message)." }
406
431
  },
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  requireAccount
4
- } from "./chunk-BLFGJIJJ.js";
4
+ } from "./chunk-BLJGV6ST.js";
5
5
  import {
6
6
  pageDelayFromFlags,
7
7
  readCursorFlag,
@@ -15,15 +15,16 @@ import {
15
15
  resolveEffectiveConfig,
16
16
  streamAll,
17
17
  writeNdjsonItem
18
- } from "./chunk-CBHL3QQJ.js";
18
+ } from "./chunk-B5NIX4G6.js";
19
19
  import "./chunk-XZJQQJBE.js";
20
20
  import {
21
21
  createClient
22
- } from "./chunk-DCZR4M7G.js";
22
+ } from "./chunk-UJOTQPL6.js";
23
23
  import {
24
24
  GLOBAL_FLAGS,
25
- READ_SINGLE_FLAGS
26
- } from "./chunk-XDQHNUEU.js";
25
+ READ_SINGLE_FLAGS,
26
+ readOnly
27
+ } from "./chunk-TC4ZPUWI.js";
27
28
 
28
29
  // src/commands/inboxes.ts
29
30
  import { defineCommand } from "citty";
@@ -33,12 +34,6 @@ function buildOutputStreams() {
33
34
  stderr: { write: (s) => process.stderr.write(s) }
34
35
  };
35
36
  }
36
- function rejectPreviewOnRead(preview, out) {
37
- if (preview) {
38
- out.stderr.write("error: --preview is only valid on write commands (mutations). Reads just run.\n");
39
- process.exit(2);
40
- }
41
- }
42
37
  function rejectAllOnNonPaginated(all, out) {
43
38
  if (all) {
44
39
  out.stderr.write("error: --all is not supported on non-paginated commands.\n");
@@ -74,7 +69,6 @@ function validateLimitRange(raw, out) {
74
69
  }
75
70
  }
76
71
  async function runInboxesList(client, flags, out) {
77
- rejectPreviewOnRead(flags.preview, out);
78
72
  rejectAllOnNonPaginated(flags.all, out);
79
73
  const accountId = await requireAccount(client, flags, out);
80
74
  const ns = client.account(accountId);
@@ -91,7 +85,6 @@ async function runInboxesList(client, flags, out) {
91
85
  }
92
86
  }
93
87
  async function runInboxesChats(client, flags, out) {
94
- rejectPreviewOnRead(flags.preview, out);
95
88
  rejectPaginationModifiersWithoutAll(flags, out);
96
89
  const accountId = await requireAccount(client, flags, out);
97
90
  const inboxId = flags.inboxId ?? "";
@@ -124,11 +117,18 @@ async function runInboxesChats(client, flags, out) {
124
117
  }
125
118
  }
126
119
  var inboxesListCommand = defineCommand({
127
- meta: { name: "list", description: "Discover the account's inboxes (personal + company pages)." },
120
+ meta: {
121
+ name: "list",
122
+ description: "Discover the account's inboxes (personal + company pages).",
123
+ examples: [
124
+ "curviate inboxes list",
125
+ "curviate inboxes list --kind company"
126
+ ]
127
+ },
128
128
  args: {
129
129
  // Single-object-shaped read: READ_SINGLE_FLAGS omits pagination flags
130
130
  // (this response carries no cursor, every inbox comes back in one call).
131
- ...READ_SINGLE_FLAGS,
131
+ ...readOnly(READ_SINGLE_FLAGS),
132
132
  kind: {
133
133
  type: "string",
134
134
  description: "Filter to only personal or only company inboxes: personal | company. Omit to list both."
@@ -159,10 +159,14 @@ var inboxesListCommand = defineCommand({
159
159
  var inboxesChatsCommand = defineCommand({
160
160
  meta: {
161
161
  name: "chats",
162
- description: "List an inbox's conversations. Each chat id is send-ready: reply with `message send <chat_id> \"<text>\"`. A company inbox's chat id (e.g. COMPANY_83734124_2-...) sends AS THE PAGE, no separate flag needed. Company inboxes are reply-only and cannot start a new conversation."
162
+ description: "List an inbox's conversations. Each chat id is send-ready: reply with `message send <chat_id> \"<text>\"`. A company inbox's chat id (e.g. COMPANY_83734124_2-...) sends AS THE PAGE, no separate flag needed. Company inboxes are reply-only and cannot start a new conversation.",
163
+ examples: [
164
+ "curviate inboxes chats CLASSIC_PRIMARY",
165
+ "curviate inboxes chats COMPANY_1234567_PRIMARY --limit 10"
166
+ ]
163
167
  },
164
168
  args: {
165
- ...GLOBAL_FLAGS,
169
+ ...readOnly(GLOBAL_FLAGS),
166
170
  limit: { type: "string", description: "Number of items to return per page (1-25, default 20)." },
167
171
  inboxId: { type: "positional", description: "Inbox id from `inboxes list` (e.g. CLASSIC_PRIMARY or COMPANY_83734124_PRIMARY)." }
168
172
  },