@wirecat/cli-core 0.534.0 → 0.536.0

package/CHANGELOG.md

@@ -7,6 +7,22 @@ shape of this file.
 
 ## Unreleased
 
+## 0.536.0 — 01.11.2026
+
+### Fixed
+
+- **A server mail search that ran out of time says so.** When the server's own deadline cut a search or the read of
+  its finds short, `searchMailServer` reported `search.server-failed` (`provider_unavailable`), as if the server had
+  refused. It now reports `search.server-timeout` (`timeout`), as when `--server-time` ends it, so a caller knows to
+  give it more time.
+
+## 0.535.0 — 01.11.2026
+
+### Added
+
+- **`syncMail` takes `saveCoverage: false`** for a spot read, such as a CLI storing the copy of a message it just
+  sent: the mail is saved, and the coverage that memo reports for the archive stays what the last full run set.
+
 ## 0.534.0 — 01.11.2026
 
 ### Added

package/dist/mail/server-search.js

@@ -18,6 +18,12 @@ const refusal = {
     no_words: "--backend server needs words, people, a subject, a date or a state to send to the server",
 };
 const BOUND = Symbol("bound");
+/** A call the server's own deadline cut short is the time bound's, as one cut by --server-time is. */
+const failureOf = (error) => error instanceof CliError && error.code === "rate_limited"
+    ? "rate_limited"
+    : error instanceof CliError && error.code === "timeout"
+        ? "time_or_abort_bound"
+        : "search_failed";
 /** The newest first: a server's UIDs grow as mail arrives in the folder. */
 const newest = (uids, count) => [...uids].sort((one, other) => Number(other) - Number(one)).slice(0, count);
 /**
@@ -112,7 +118,7 @@ export const searchMailServer = async (store, mailbox, access, request) => {
                 if (!open)
                     return;
                 pending.delete(call);
-                fail(call, error instanceof CliError && error.code === "rate_limited" ? "rate_limited" : "search_failed");
+                fail(call, failureOf(error));
             }
         }));
         if (!open)
@@ -143,10 +149,7 @@ export const searchMailServer = async (store, mailbox, access, request) => {
     });
     let outcome;
     try {
-        outcome = await Promise.race([
-            run().then(() => "done", () => "failed"),
-            bound,
-        ]);
+        outcome = await Promise.race([run().then(() => "done", failureOf), bound]);
     }
     finally {
         open = false;
@@ -158,12 +161,13 @@ export const searchMailServer = async (store, mailbox, access, request) => {
         throw openFailure;
     if (unsupported)
         return skip("unsupported");
+    const ended = outcome === BOUND || outcome === "done" ? "time_or_abort_bound" : outcome;
     for (const call of pending)
-        fail(call, outcome === "failed" ? "search_failed" : "time_or_abort_bound");
+        fail(call, ended);
     if (outcome !== "done" || (fresh.length > 0 && raws === undefined)) {
         // What was found but not read in time is the archive's to answer: none of it is claimed as the server's.
         if (pending.size === 0)
-            fail(null, outcome === "failed" ? "search_failed" : "time_or_abort_bound");
+            fail(null, ended);
         for (const item of fresh)
             sources.delete(sourceKey(item.threadId, item.messageId));
         report.returned = sources.size;

package/dist/mail/sync.d.ts

@@ -89,6 +89,8 @@ export interface MailSyncOptions {
     retryAttachments?: boolean;
     /** List every message in the window, not only those an earlier run left: proves deletions, refreshes labels. */
     rescan?: boolean;
+    /** `false` for a spot read, like the copy of a sent message: the run leaves the saved coverage as the last full run set it. */
+    saveCoverage?: boolean;
     /** A window smaller than this is listed whole every run: it costs seconds and keeps flags and deletions current. */
     resumeFrom?: number;
     /** Runs after the mail is saved, so chats and mail still waiting for vectors are indexed; its answer is `indexed`. */

package/dist/mail/sync.js

@@ -141,7 +141,7 @@ export const syncMail = async (source, store, options) => {
             : {}),
     };
 };
-const syncRound = async (source, store, { account, since, max = 200, maxBodyChars = MAX_BODY_CHARS, maxAttachmentChars = MAX_ATTACHMENT_CHARS, now = Date.now, ages, loadEngine = importEngine, retryAttachments = false, rescan = false, resumeFrom = RESUME_FROM, index, signal, }, plan) => {
+const syncRound = async (source, store, { account, since, max = 200, maxBodyChars = MAX_BODY_CHARS, maxAttachmentChars = MAX_ATTACHMENT_CHARS, now = Date.now, ages, loadEngine = importEngine, retryAttachments = false, rescan = false, saveCoverage = true, resumeFrom = RESUME_FROM, index, signal, }, plan) => {
     if (retryAttachments)
         return retryUnread({
             store,
@@ -777,7 +777,7 @@ const syncRound = async (source, store, { account, since, max = 200, maxBodyChar
         state: complete ? "window" : "partial",
         identity: account.mode === "imap" ? "message-id-or-uidvalidity-folder-uid" : "gmail-message-id",
     };
-    if (!snapshot)
+    if (!snapshot && saveCoverage)
         await store.sync.setSyncState(key, "mail_coverage", JSON.stringify(coverage));
     const tagging = tagger.outcome();
     await settleRuleTags(store, accountId, rules, tagging);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.534.0",
+  "version": "0.536.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",