@curviate/cli 0.24.3 → 0.25.0

package/CHANGELOG.md

@@ -8,6 +8,27 @@ a new command or flag is a minor; a breaking command/flag/exit-code change is a
 
 ## [Unreleased]
 
+## [0.25.0] - 2026-08-29
+
+### Added
+
+- **`inbox list --inbox <folder>` selects which inbox folder to read.**
+  Accepts the six folders the endpoint supports: `primary` (the default),
+  `inmail`, `archived`, `spam`, `jobs`, `starred`. Without the flag the
+  behaviour is unchanged, and the parameter is omitted from the request
+  rather than sent explicitly.
+
+  Previously `inbox list` could only ever read `primary`, which left
+  archived conversations unreachable from the CLI at any `--limit` and at
+  any pagination depth; on a test account, 34 archived chats were absent
+  from a full walk of the inbox. `inmail` and `starred` are alternate
+  views over conversations `primary` already returns, so for those the
+  flag is a filter rather than a way to reach anything new.
+
+  An unrecognised value fails before any network call, with exit code 2
+  and a message naming the accepted values. The flag composes with
+  `--all` and `--cursor`, so a folder can be walked to exhaustion.
+
 ## [0.24.3] - 2026-08-29
 
 ### Fixed

package/README.md

@@ -122,6 +122,16 @@ curviate inbox list --json --all --account acc_1 \
   | jq -c 'select(.unread_count > 0) | {chat_id: .id, sender: (.user.display_name // .last_message.sender_id), preview: .last_message.text[0:80]}'
 ```
 
+`inbox list` reads one folder per call, `primary` by default. An archived chat never appears
+in a `primary` walk, no matter the `--limit` or how far `--cursor`/`--all` page through it;
+pass `--inbox archived` to reach it. `inmail` and `starred` are alternate views over chats
+`primary` already returns, useful as a narrower filter rather than for reachability. All six
+values: `primary`, `inmail`, `archived`, `spam`, `jobs`, `starred`.
+
+```bash
+curviate inbox list --json --all --account acc_1 --inbox archived
+```
+
 ### 3. Warm up a prospect by reacting to their recent posts
 
 Read recent posts from a profile, then react to each, useful for ambient warm-up before outreach.

package/dist/cli.js

@@ -345,7 +345,7 @@ var main = defineCommand({
     job: () => import("./job-3HU7KQQI.js").then((m) => m.jobCommand),
     connect: () => import("./connect-5TMGM326.js").then((m) => m.connectCommand),
     search: () => import("./search-SYWHOM5J.js").then((m) => m.searchCommand),
-    inbox: () => import("./inbox-ER3N3OX3.js").then((m) => m.inboxCommand),
+    inbox: () => import("./inbox-R5OSZWTG.js").then((m) => m.inboxCommand),
     inboxes: () => import("./inboxes-6XMIABRX.js").then((m) => m.inboxesCommand),
     message: () => import("./message-GA7D3A6Y.js").then((m) => m.messageCommand),
     post: () => import("./post-QAVRVRON.js").then((m) => m.postCommand),

package/dist/{inbox-ER3N3OX3.js → inbox-R5OSZWTG.js}

@@ -79,6 +79,15 @@ function validateLimitRange(raw, out) {
     process.exit(2);
   }
 }
+var INBOX_FOLDERS = ["primary", "inmail", "archived", "spam", "jobs", "starred"];
+function validateInboxFolder(raw, out) {
+  if (raw === void 0) return;
+  if (!INBOX_FOLDERS.includes(raw)) {
+    out.stderr.write(`error: --inbox must be one of: ${INBOX_FOLDERS.join(", ")}. Got "${raw}".
+`);
+    process.exit(2);
+  }
+}
 async function handleSdkError(err, outOpts, out) {
   const { CurviateError } = await import("@curviate/sdk");
   if (err instanceof CurviateError) {
@@ -98,9 +107,13 @@ async function runInboxList(client, flags, out) {
   const maxPages = flags["max-pages"] ? parseInt(flags["max-pages"], 10) : 100;
   const params = buildPaginationParams(flags);
   validateLimitRange(flags.limit, out);
+  validateInboxFolder(flags.inbox, out);
   if (flags.unread !== void 0) {
     params.unread = flags.unread;
   }
+  if (flags.inbox !== void 0) {
+    params.inbox = flags.inbox;
+  }
   try {
     if (all) {
       const fn = (p) => ns.messaging.listChats(p);
@@ -227,6 +240,10 @@ var inboxListCommand = defineCommand({
       type: "boolean",
       description: "Show unread chats only (--no-unread for read-only; omit for all)."
       // No default -> three-way semantics: undefined when omitted, true for --unread, false for --no-unread
+    },
+    inbox: {
+      type: "string",
+      description: "Which inbox folder to list chats from: primary, inmail, archived, spam, jobs, starred. Default primary."
     }
   },
   async run({ args }) {

package/package.json

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