@wirecat/mail-cli 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 Notable changes to `@wirecat/mail-cli`. One section per version, newest first.
 
+## 0.4.0 — 01.11.2026
+
+### Added
+
+- **`mail <profile> search messages '<query>'`** searches the profile's stored mail offline, with the query language
+  of every WireCat CLI and memo's ranking: any form of a word, `from:`, `to:`, `subject:`, `label:`, `is:unread`,
+  `has:attachment`, `content:`, `date>7d`, and `list:` for a mailing list by its List-Id or domain. Mail from a
+  suspicious sender comes after the rest (`--plain-order` keeps the words' order); `--newest`, `--exact`, `--page`.
+- **`mail <profile> messages show <ref>`** gives one email whole, with the first 4,000 characters of each
+  attachment's text (`--full`: all of it and the HTML body), and `--before-n`/`--after-n` emails of its thread, in the
+  JSON `memo messages show` gives.
+- **`mail <profile> conversations list [query]` and `conversations show <thread>`**: the threads, newest first,
+  filtered by `subject:`, `emails_count>1` or `last_email_at>7d`, and one thread's emails oldest first.
+- Each reads the profile's own mailbox only; a reference of another mailbox is refused. Over MCP they are `read`
+  commands.
+
 ## 0.3.0 — 01.11.2026
 
 ### Added

package/README.md

@@ -2,7 +2,7 @@
 
 `mail` copies your mailbox into the shared WireCat store on your computer, so you and your AI agents can search it
 and read it there. It reads over IMAP and never changes the mailbox: it does not send, move, flag or delete mail.
-It does not search or show mail itself: you read and search the stored mail in memo.
+It searches and reads what it stored, offline.
 
 [Documentation](https://github.com/WireCatLabs/mail-cli/blob/main/docs/index.md) · [Roadmap](https://github.com/WireCatLabs/mail-cli/blob/main/docs/roadmap.md) · [WireCat](https://wirecat.dev)
 
@@ -24,11 +24,12 @@ mail ya session start --address me@example.com   # finds the server, shows the s
 mail ya account check                            # logs in and lists what the server supports
 mail ya sync                                     # reads the last 30 days into the shared store
 mail ya status                                   # how far the sync is
+mail ya search messages invoice                  # search the stored mail
 mail skill install                               # optional: instructions for your AI agent
 ```
 
-Now the mail is in the store. Search and read it in [memo](https://github.com/WireCatLabs/cli-memo), for example
-`memo search mail "invoice"`. `mail` has no command to read a message.
+Now the mail is in the store. `mail ya messages show <ref>` reads a search hit whole. [memo](https://github.com/WireCatLabs/cli-memo)
+searches it together with your messages and notes: `memo search all "invoice"`.
 
 You need Node.js 22.16 or a later 22.x, or 24 or later. To try it with no install, run
 `npx @wirecat/mail-cli --help`. If `mail` is not found, `mail doctor` says why.
@@ -37,8 +38,10 @@ You need Node.js 22.16 or a later 22.x, or 24 or later. To try it with no instal
 
 - **Sync a mailbox into the shared store.** `sync` reads INBOX and Sent (All Mail on Gmail), or the folders you name,
   newest first, and skips what is already stored. `--since-time 2026-10-01` reads from local midnight of that day.
-- **Search and read the mail with memo.** `mail` only fills the store;
-  [memo](https://github.com/WireCatLabs/cli-memo) searches your mail together with your messages and notes.
+- **Search and read the stored mail.** `search messages 'from:ann@example.com has:attachment date>30d'` uses the
+  query language of every WireCat CLI, with `list:` for mailing lists; `messages show` gives an email whole with its
+  attachments' text, `conversations list|show` its threads. It reads the profile's mailbox only and asks no server.
+  [memo](https://github.com/WireCatLabs/cli-memo) searches every mailbox together with your messages and notes.
 - **Sync a big mailbox in parts.** A run stops before its deadline, keeps what it read and tells you to run it again;
   `status` shows how far it is.
 - **Check a mailbox.** `account check` shows what the server supports, `folders list` the folders with their role and
@@ -98,10 +101,10 @@ mail ya config show                            # every setting and where it came
 
 - Read-only: `mail` never sends, moves, flags or deletes mail. But memo has `memo mail delete`, which moves Gmail mail
   to Trash, so an agent with write access to memo can change mail.
-- Text and headers only: attachments are not stored.
+- Text and headers only: the text of attachments is stored, not the files, nor the original message.
 - No OAuth yet, so no Outlook or Microsoft 365, and no Google Workspace domain that turns app passwords off.
 - Gmail caps IMAP downloads at 2,500 MB a day; a new Yandex app password can take 2 to 3 hours to work.
-- `mail` has no search of its own: search and read through memo.
+- Search reads what `sync` stored: mail not synced yet is not found. Search on the server is planned.
 
 What comes next, such as OAuth sign-in, is on the
 [roadmap](https://github.com/WireCatLabs/mail-cli/blob/main/docs/roadmap.md).

package/dist/bin/mail.js

@@ -9,7 +9,7 @@ if (
   (words[0] === "--version" || words[0] === "-V") &&
   !Object.keys(process.env).some((key) => key.endsWith("_TEST_ARGV_LOG"))
 ) {
-  process.stdout.write("0.3.0\n")
+  process.stdout.write("0.4.0\n")
 } else {
   // Before the bundle compiles: the bundle's own call comes after its chunks.
   module.enableCompileCache()
@@ -29,7 +29,7 @@ if (
     })
   }
   const running = import("../bundle/mail.js")
-  const chunks = ["../bundle/all-profiles-52LCOKSL.js","../bundle/anthropic-HPW7PLTT.js","../bundle/app-server-Y7XSPVHJ.js","../bundle/bun-B7YXDIMT.js","../bundle/bun-sqlite-TTTKY7H2.js","../bundle/decode-VLI3MAXE.js","../bundle/dispatch-EUKKT3PD.js","../bundle/dist-C7LAAMNF.js","../bundle/dist-HFUVURJG.js","../bundle/echarts-POTU3SHN.js","../bundle/embed-J2DEEEUF.js","../bundle/embedder-5N56V7YJ.js","../bundle/failure-OAIC5VAP.js","../bundle/first-screen-43VLEDWZ.js","../bundle/instructions-B7AUZXPL.js","../bundle/mcp-L7SRVDRN.js","../bundle/node-KM3CUABH.js","../bundle/node-SZAO6HTA.js","../bundle/node-TLZSIHIJ.js","../bundle/node-sqlite-O34FFLRV.js","../bundle/oauth-YYTLIPJT.js","../bundle/open-SWJGI6H4.js","../bundle/openai-GYXWCQOV.js","../bundle/process-GLVWCUMK.js","../bundle/program-HW73TGIF.js","../bundle/prompt-OZLHHGCD.js","../bundle/recognize-RDQSGHC5.js","../bundle/remote-BKU5P3GK.js","../bundle/rerank-EQIXYHKB.js","../bundle/serve-S6K5HKWG.js","../bundle/server-4VRVHPQC.js","../bundle/server-WK6DRJX2.js","../bundle/sqlite-runtime-OOE455YM.js","../bundle/state-OLPOJ2TY.js","../bundle/store-6AVCPLH4.js","../bundle/store-WFV26CWY.js","../bundle/store-maintenance-command-S6235I3W.js"]
+  const chunks = ["../bundle/all-profiles-55XPXQHY.js","../bundle/anthropic-K5B6I4LB.js","../bundle/app-server-VWWLQLTZ.js","../bundle/bun-EO7AI6YP.js","../bundle/bun-sqlite-F24A4IOP.js","../bundle/decode-ON4KBMEX.js","../bundle/dispatch-EUKKT3PD.js","../bundle/dist-FMN7UZ7R.js","../bundle/dist-HFUVURJG.js","../bundle/echarts-XPA226QR.js","../bundle/embed-QERDAB73.js","../bundle/embedder-I76YT3E5.js","../bundle/failure-OAIC5VAP.js","../bundle/first-screen-EORANEAK.js","../bundle/instructions-NN3BCFIM.js","../bundle/mcp-L7SRVDRN.js","../bundle/node-2S75QJ6B.js","../bundle/node-KM3CUABH.js","../bundle/node-TLZSIHIJ.js","../bundle/node-sqlite-RC7WM3EG.js","../bundle/oauth-FUHLZCKV.js","../bundle/open-JOKT7LKY.js","../bundle/openai-U3IMQ6UI.js","../bundle/process-LKODK722.js","../bundle/program-RMLIQXCA.js","../bundle/prompt-23VYMNNB.js","../bundle/recognize-TXO3462R.js","../bundle/remote-5F4ZOASM.js","../bundle/rerank-TXSDPEFE.js","../bundle/serve-TWYECYWM.js","../bundle/server-2GEAXKX2.js","../bundle/server-3S3BKE6D.js","../bundle/sqlite-runtime-BEOBGC6K.js","../bundle/state-ERWIUTQQ.js","../bundle/store-2JO4JGQL.js","../bundle/store-4RY5UMOP.js","../bundle/store-maintenance-command-T7D4OTN7.js"]
   // After the server answers its first request, so it starts no later.
   if (serves) setTimeout(() => void Promise.allSettled(chunks.map((chunk) => import(chunk))), 2000).unref()
   await running

package/dist/bundle/{all-profiles-52LCOKSL.js → all-profiles-55XPXQHY.js}

@@ -2,18 +2,18 @@ import { createRequire as __bundleRequire } from "node:module";
 const require = __bundleRequire(import.meta.url);
 import {
   answeredWire
-} from "./chunk-Y2HGQK7A.js";
+} from "./chunk-JKHI3PH7.js";
 import {
   CALLER_META_KEY,
   PROXY_CLIENT_NAME,
   StdioServerTransport,
   callerOf,
   serveStdio
-} from "./chunk-GX2M3AOO.js";
+} from "./chunk-MGBGE2Y4.js";
 import {
   McpServer
 } from "./chunk-5D4AEUVA.js";
-import "./chunk-RMYYKBFW.js";
+import "./chunk-H7K2DN3R.js";
 import "./chunk-NPGVOZVK.js";
 import "./chunk-J3QXTBD2.js";
 import "./chunk-LQ37ALDJ.js";
@@ -23,7 +23,7 @@ import {
   __name
 } from "./chunk-ZVVMGPBJ.js";
 
-// node_modules/.pnpm/@wirecat+cli-core@0.519.0_@wirecat+cli-base@0.68.1_commander@15.0.0_esbuild@0.28.2_type_3a77a7242330d89656a32c8be893f1d1/node_modules/@wirecat/cli-core/dist/mcp/all-profiles.js
+// node_modules/.pnpm/@wirecat+cli-core@0.520.0_@wirecat+cli-base@0.68.1_commander@15.0.0_esbuild@0.28.2_type_33ccf8bfbe17590bae2f3fc544520037/node_modules/@wirecat/cli-core/dist/mcp/all-profiles.js
 import { spawn } from "node:child_process";
 import { randomUUID } from "node:crypto";
 var PROTOCOL = "2025-06-18";
@@ -257,7 +257,7 @@ var serveAllProfilesOverStdio = /* @__PURE__ */ __name(async (options, io = {})
 }, "serveAllProfilesOverStdio");
 var serveAllProfilesOverHttp = /* @__PURE__ */ __name(async (options, http) => {
   const { build, close } = allProfilesServer(options);
-  const { serveOverHttp } = await import("./serve-S6K5HKWG.js");
+  const { serveOverHttp } = await import("./serve-TWYECYWM.js");
   const listening = await serveOverHttp(build, {
     ...http,
     appName: options.command,

package/dist/bundle/{anthropic-HPW7PLTT.js → anthropic-K5B6I4LB.js}

@@ -5,11 +5,11 @@ import {
 } from "./chunk-XQUUANA2.js";
 import {
   checkedOptions
-} from "./chunk-N5WIUNOT.js";
+} from "./chunk-FFKNUVVD.js";
 import {
   messagesFor,
   systemFor
-} from "./chunk-X7TFD5SX.js";
+} from "./chunk-BHKI5OCD.js";
 import "./chunk-J3QXTBD2.js";
 import {
   array,
@@ -23,7 +23,7 @@ import {
   __name
 } from "./chunk-ZVVMGPBJ.js";
 
-// node_modules/.pnpm/@wirecat+cli-core@0.519.0_@wirecat+cli-base@0.68.1_commander@15.0.0_esbuild@0.28.2_type_3a77a7242330d89656a32c8be893f1d1/node_modules/@wirecat/cli-core/dist/models/anthropic.js
+// node_modules/.pnpm/@wirecat+cli-core@0.520.0_@wirecat+cli-base@0.68.1_commander@15.0.0_esbuild@0.28.2_type_33ccf8bfbe17590bae2f3fc544520037/node_modules/@wirecat/cli-core/dist/models/anthropic.js
 var options = strictObject({
   stop_sequences: optional(array(string()))
 });

package/dist/bundle/{app-server-Y7XSPVHJ.js → app-server-VWWLQLTZ.js}

@@ -3,43 +3,43 @@ const require = __bundleRequire(import.meta.url);
 import {
   PER_RUN,
   envelope
-} from "./chunk-QTWIZKUI.js";
+} from "./chunk-JZFIHVRB.js";
 import {
   answered,
   failed,
   registerCommands,
   runCommandForAgent,
   toolsFromCommands
-} from "./chunk-MHNEMDH3.js";
+} from "./chunk-OM4ZBLT7.js";
 import {
   mcpUrlOf
-} from "./chunk-H2JVXO5V.js";
+} from "./chunk-ORYYYM5Y.js";
 import {
   agentJson,
   skillResource
-} from "./chunk-RVIMMCHF.js";
-import "./chunk-RORC2FW7.js";
+} from "./chunk-6BR6JMCR.js";
+import "./chunk-VWHRIGYJ.js";
 import {
   appInstructions
-} from "./chunk-5LY3OS7U.js";
+} from "./chunk-EDKV6D6T.js";
 import {
   answeredWire
-} from "./chunk-Y2HGQK7A.js";
+} from "./chunk-JKHI3PH7.js";
 import {
   StdioServerTransport,
   serveStdio
-} from "./chunk-GX2M3AOO.js";
+} from "./chunk-MGBGE2Y4.js";
 import {
   McpServer
 } from "./chunk-5D4AEUVA.js";
-import "./chunk-TNQOKGJS.js";
-import "./chunk-RZCFEASJ.js";
-import "./chunk-PYIJCWCH.js";
-import "./chunk-YVIX7FHL.js";
-import "./chunk-X7TFD5SX.js";
-import "./chunk-ZIJJNH47.js";
-import "./chunk-MXUUQXMA.js";
-import "./chunk-LJDOPCPW.js";
+import "./chunk-NL5LNYGX.js";
+import "./chunk-X7AXH2IC.js";
+import "./chunk-4KLJN3LK.js";
+import "./chunk-VP5GCMHM.js";
+import "./chunk-BHKI5OCD.js";
+import "./chunk-HJEMHZRU.js";
+import "./chunk-7IYDIU4P.js";
+import "./chunk-2LP46EUH.js";
 import {
   DEFAULT_OUTPUT_BYTES,
   changesAuthorityAt,
@@ -49,34 +49,34 @@ import {
   judgedTargets,
   readOnlyLockOf,
   rootOf2 as rootOf
-} from "./chunk-FUXSKWWJ.js";
-import "./chunk-5SSFYIFF.js";
-import "./chunk-RMYYKBFW.js";
+} from "./chunk-HUB42T2Z.js";
+import "./chunk-F6JTOQIK.js";
+import "./chunk-H7K2DN3R.js";
 import "./chunk-ZD3WUGR2.js";
 import "./chunk-P7P5MNAU.js";
-import "./chunk-XQVGIW4R.js";
+import "./chunk-VWXCEEUH.js";
 import {
   mcpHttpMarker
-} from "./chunk-4UOEUEZZ.js";
-import "./chunk-VTJDEWMB.js";
-import "./chunk-I2ARI6FI.js";
-import "./chunk-4PXWXI2U.js";
-import "./chunk-DKKCQMDM.js";
-import "./chunk-FGNTGLWA.js";
-import "./chunk-KXVZ373I.js";
-import "./chunk-TLZWUADZ.js";
-import "./chunk-FX77WAQL.js";
-import "./chunk-C2THROZU.js";
+} from "./chunk-RLSGMMGC.js";
+import "./chunk-EOEYP7CJ.js";
+import "./chunk-CADRRSQK.js";
+import "./chunk-UJYCKCFR.js";
+import "./chunk-ID24SLH3.js";
+import "./chunk-5RUTHKXZ.js";
+import "./chunk-CCNHVZ3G.js";
+import "./chunk-SY3SP7EI.js";
+import "./chunk-2NZGUKYK.js";
+import "./chunk-YYTWV5GU.js";
 import "./chunk-NPGVOZVK.js";
-import "./chunk-V7NZTJKU.js";
-import "./chunk-JXYFIUVX.js";
-import "./chunk-K6SIGXRS.js";
-import "./chunk-O2F54PUO.js";
+import "./chunk-ANRI6EZY.js";
+import "./chunk-F7KAJNNK.js";
+import "./chunk-UO7X2VW4.js";
+import "./chunk-7X64JS6S.js";
 import "./chunk-QX7RCLRS.js";
 import "./chunk-D72URWJE.js";
-import "./chunk-SRMJ6LLC.js";
-import "./chunk-3RDTVH3H.js";
-import "./chunk-PL6UPJIL.js";
+import "./chunk-ZAR67WKR.js";
+import "./chunk-WFBTPZK3.js";
+import "./chunk-UZDHK26H.js";
 import "./chunk-J3QXTBD2.js";
 import {
   mcpErrorResult
@@ -89,7 +89,7 @@ import {
   __name
 } from "./chunk-ZVVMGPBJ.js";
 
-// node_modules/.pnpm/@wirecat+cli-core@0.519.0_@wirecat+cli-base@0.68.1_commander@15.0.0_esbuild@0.28.2_type_3a77a7242330d89656a32c8be893f1d1/node_modules/@wirecat/cli-core/dist/mcp/app-server.js
+// node_modules/.pnpm/@wirecat+cli-core@0.520.0_@wirecat+cli-base@0.68.1_commander@15.0.0_esbuild@0.28.2_type_33ccf8bfbe17590bae2f3fc544520037/node_modules/@wirecat/cli-core/dist/mcp/app-server.js
 var EXCLUDED = [["mcp"]];
 var createAppServer = /* @__PURE__ */ __name((command, context, options) => {
   const { app } = options;
@@ -204,7 +204,7 @@ var serveAppOverStdio = /* @__PURE__ */ __name(async (command, context, options)
 var serveAppOverHttp = /* @__PURE__ */ __name(async (command, context, options, http) => {
   const { app } = options;
   const { build } = createAppServer(command, context, options);
-  const { serveOverHttp } = await import("./serve-S6K5HKWG.js");
+  const { serveOverHttp } = await import("./serve-TWYECYWM.js");
   const listening = await serveOverHttp(build, {
     ...http,
     appName: app.command,

package/dist/bundle/{bun-B7YXDIMT.js → bun-EO7AI6YP.js}

@@ -18,12 +18,12 @@ import {
   jitCompatCheck,
   refineSqliteCodecs,
   sql
-} from "./chunk-O2F54PUO.js";
+} from "./chunk-7X64JS6S.js";
 import {
   __name
 } from "./chunk-ZVVMGPBJ.js";
 
-// node_modules/.pnpm/@wirecat+cli-core@0.519.0_@wirecat+cli-base@0.68.1_commander@15.0.0_esbuild@0.28.2_type_3a77a7242330d89656a32c8be893f1d1/node_modules/@wirecat/cli-core/dist/store/sqlite/drizzle/bun.js
+// node_modules/.pnpm/@wirecat+cli-core@0.520.0_@wirecat+cli-base@0.68.1_commander@15.0.0_esbuild@0.28.2_type_33ccf8bfbe17590bae2f3fc544520037/node_modules/@wirecat/cli-core/dist/store/sqlite/drizzle/bun.js
 import { Database } from "bun:sqlite";
 var bunSQLiteCodecs = refineSqliteCodecs({
   "integer:boolean": { normalize: booleanFromInteger },

package/dist/bundle/{bun-sqlite-TTTKY7H2.js → bun-sqlite-F24A4IOP.js}

@@ -3,7 +3,7 @@ const require = __bundleRequire(import.meta.url);
 import {
   loadVectorExtension,
   vectorExtension
-} from "./chunk-HS25KDT3.js";
+} from "./chunk-SWRNMYDL.js";
 import "./chunk-J3QXTBD2.js";
 import "./chunk-LQ37ALDJ.js";
 import {
@@ -14,7 +14,7 @@ import {
   __name
 } from "./chunk-ZVVMGPBJ.js";
 
-// node_modules/.pnpm/@wirecat+cli-core@0.519.0_@wirecat+cli-base@0.68.1_commander@15.0.0_esbuild@0.28.2_type_3a77a7242330d89656a32c8be893f1d1/node_modules/@wirecat/cli-core/dist/store/drivers/bun-sqlite.js
+// node_modules/.pnpm/@wirecat+cli-core@0.520.0_@wirecat+cli-base@0.68.1_commander@15.0.0_esbuild@0.28.2_type_33ccf8bfbe17590bae2f3fc544520037/node_modules/@wirecat/cli-core/dist/store/drivers/bun-sqlite.js
 var customised = false;
 var ownLibrary = /* @__PURE__ */ __name(async () => {
   try {

package/dist/bundle/{chunk-C6E3VFUX.js → chunk-2ADB5DSG.js}

@@ -4,7 +4,7 @@ import {
   MAX_SECRET_INPUT,
   bufferedInput,
   inputPolicy
-} from "./chunk-ZIJJNH47.js";
+} from "./chunk-HJEMHZRU.js";
 import {
   CliError
 } from "./chunk-5BVIWP3S.js";
@@ -12,7 +12,7 @@ import {
   __name
 } from "./chunk-ZVVMGPBJ.js";
 
-// node_modules/.pnpm/@wirecat+cli-core@0.519.0_@wirecat+cli-base@0.68.1_commander@15.0.0_esbuild@0.28.2_type_3a77a7242330d89656a32c8be893f1d1/node_modules/@wirecat/cli-core/dist/terminal/prompt.js
+// node_modules/.pnpm/@wirecat+cli-core@0.520.0_@wirecat+cli-base@0.68.1_commander@15.0.0_esbuild@0.28.2_type_33ccf8bfbe17590bae2f3fc544520037/node_modules/@wirecat/cli-core/dist/terminal/prompt.js
 import { createInterface } from "node:readline";
 import { Writable } from "node:stream";
 var readSecret = /* @__PURE__ */ __name(async (prompt, { input = process.stdin, output = process.stderr, echo = false, signal: givenSignal } = {}) => {