@struktoai/mirage-node 0.0.4 → 0.0.5

package/dist/{chunk-4GYB7DGC.js → chunk-TWRQCQWU.js}

@@ -1,15 +1,15 @@
 import {
   redactEmailConfig
-} from "./chunk-CQCTCW4S.js";
+} from "./chunk-CRC4YWXB.js";
 
 // src/resource/email/email.ts
 import {
   BaseResource,
-  PathSpec as PathSpec3,
-  ResourceName as ResourceName11,
+  PathSpec as PathSpec2,
+  ResourceName as ResourceName6,
   makeResolveGlob,
-  mountKey as mountKey4,
-  mountPrefixOf as mountPrefixOf7
+  mountKey as mountKey3,
+  mountPrefixOf as mountPrefixOf6
 } from "@struktoai/mirage-core";
 
 // src/accessor/email.ts
@@ -56,30 +56,26 @@ var EmailAccessor = class extends Accessor {
 };
 
 // src/commands/builtin/email/index.ts
-import { ResourceName as ResourceName9, makeGenericCommands } from "@struktoai/mirage-core";
+import { ResourceName as ResourceName4, makeGenericCommands } from "@struktoai/mirage-core";
 
 // src/commands/builtin/email/find.ts
 import {
-  FileType as FileType2,
-  IOResult,
-  PathSpec as PathSpec2,
   ResourceName,
   command,
-  formatRecords,
-  mountKey as mountKey3,
-  mountPrefixOf as mountPrefixOf4,
+  findGeneric,
   resolveGlobOf,
-  rstripSlash,
   specOf,
-  stripSlash as stripSlash2
+  walkFind
 } from "@struktoai/mirage-core";
 
 // src/core/email/readdir.ts
 import {
+  enoent,
   IndexEntry,
   PathSpec as PathSpecCtor,
   mountKey,
-  mountPrefixOf
+  mountPrefixOf,
+  compareCodePoints
 } from "@struktoai/mirage-core";
 
 // src/core/email/_parse.ts
@@ -122,6 +118,7 @@ function fromParsed(parsed, headersOnly) {
   const references = typeof refsRaw === "string" ? refsRaw.split(/\s+/).filter((s) => s !== "") : refsRaw ?? [];
   return {
     from: toAddr(parsed.from?.value[0]),
+    reply_to: toAddrList(parsed.replyTo),
     to: toAddrList(parsed.to),
     cc: toAddrList(parsed.cc),
     subject: parsed.subject ?? "",
@@ -153,18 +150,35 @@ async function parseWithPayloads(raw) {
 }
 
 // src/core/email/_client.ts
-async function listFolders(accessor) {
+function internalDateOf(value) {
+  if (value === void 0) return "";
+  if (typeof value === "string") return value;
+  return value.toISOString();
+}
+async function listFolderEntries(accessor) {
   const imap = await accessor.getImap();
   const tree = await imap.list();
-  return tree.map((m) => m.pathAsListed);
+  return tree.map((m) => ({ name: m.pathAsListed, specialUse: m.specialUse ?? null }));
+}
+async function listFolders(accessor) {
+  return (await listFolderEntries(accessor)).map((entry) => entry.name);
+}
+async function lockMailbox(imap, folder) {
+  try {
+    return await imap.getMailboxLock(folder);
+  } catch (error) {
+    const answered = error.responseText !== void 0;
+    if (answered) throw new Error(`no such mailbox '${folder}'`);
+    throw error;
+  }
 }
 async function listMessageUids(accessor, folder, searchCriteria = "ALL", maxResults = null) {
   const imap = await accessor.getImap();
-  const lock = await imap.getMailboxLock(folder);
+  const lock = await lockMailbox(imap, folder);
   try {
     const query = parseSearchCriteria(searchCriteria);
     const uidsRaw = await imap.search(query, { uid: true });
-    if (uidsRaw === false) return [];
+    if (uidsRaw === false) throw new Error(`IMAP rejected the search: ${searchCriteria}`);
     const uids = uidsRaw.map((n) => String(n));
     if (maxResults !== null && uids.length > maxResults) {
       return uids.slice(uids.length - maxResults);
@@ -174,58 +188,119 @@ async function listMessageUids(accessor, folder, searchCriteria = "ALL", maxResu
     lock.release();
   }
 }
-function parseSearchCriteria(criteria) {
-  if (criteria === "ALL" || criteria === "") return { all: true };
-  const out = {};
-  const tokens = tokenizeCriteria(criteria);
-  let i = 0;
-  while (i < tokens.length) {
-    const tok = (tokens[i] ?? "").toUpperCase();
-    if (tok === "UNSEEN") {
-      out.unseen = true;
-      i += 1;
-      continue;
+var FLAG_KEYS = {
+  SEEN: "seen",
+  ANSWERED: "answered",
+  FLAGGED: "flagged",
+  DRAFT: "draft",
+  DELETED: "deleted"
+};
+var TEXT_KEYS = {
+  BODY: "body",
+  TEXT: "text",
+  SUBJECT: "subject",
+  FROM: "from",
+  TO: "to"
+};
+var DATE_KEYS = {
+  ON: "on",
+  SINCE: "since",
+  BEFORE: "before",
+  SENTON: "sentOn",
+  SENTSINCE: "sentSince",
+  SENTBEFORE: "sentBefore"
+};
+function andQueries(left, right) {
+  const collides = Object.keys(right).some((key) => key in left);
+  if (!collides) return { ...left, ...right };
+  return { not: { or: [{ not: left }, { not: right }] } };
+}
+var CriteriaParser = class {
+  constructor(tokens) {
+    this.tokens = tokens;
+  }
+  tokens;
+  index = 0;
+  peek() {
+    return this.tokens[this.index];
+  }
+  take() {
+    const token = this.peek();
+    if (token === void 0) throw new Error("email: truncated IMAP search criteria");
+    this.index += 1;
+    return token;
+  }
+  atEnd() {
+    return this.index >= this.tokens.length;
+  }
+  /** One or more keys juxtaposed, which IMAP reads as AND. */
+  parseSequence(stopAtParen = false) {
+    let query = null;
+    while (!this.atEnd()) {
+      if (stopAtParen && this.peek() === ")") break;
+      const next = this.parseKey();
+      query = query === null ? next : andQueries(query, next);
     }
-    if (tok === "TEXT" || tok === "SUBJECT" || tok === "FROM" || tok === "TO" || tok === "SINCE" || tok === "BEFORE") {
-      const v = tokens[i + 1] ?? "";
-      if (tok === "TEXT") out.text = v;
-      else if (tok === "SUBJECT") out.subject = v;
-      else if (tok === "FROM") out.from = v;
-      else if (tok === "TO") out.to = v;
-      else if (tok === "SINCE") {
-        const d = parseImapDate(v);
-        if (d !== null) out.since = d;
-      } else {
-        const d = parseImapDate(v);
-        if (d !== null) out.before = d;
-      }
-      i += 2;
-      continue;
+    return query ?? { all: true };
+  }
+  parseKey() {
+    const token = this.take();
+    if (token === "(") {
+      const inner = this.parseSequence(true);
+      if (this.peek() !== ")") throw new Error("email: unbalanced IMAP search criteria");
+      this.index += 1;
+      return inner;
+    }
+    const word = token.toUpperCase();
+    if (word === "ALL") return { all: true };
+    if (word === "NOT") return { not: this.parseKey() };
+    if (word === "OR") return { or: [this.parseKey(), this.parseKey()] };
+    if (word === "UNSEEN") return { seen: false };
+    const flag = FLAG_KEYS[word];
+    if (flag !== void 0) return { [flag]: true };
+    const textKey = TEXT_KEYS[word];
+    if (textKey !== void 0) return { [textKey]: this.take() };
+    const dateKey = DATE_KEYS[word];
+    if (dateKey !== void 0) {
+      const parsed = parseImapDate(this.take());
+      if (parsed === null) throw new Error(`email: bad date in IMAP search criteria: ${token}`);
+      return { [dateKey]: parsed };
     }
-    i += 1;
+    throw new Error(`email: unsupported IMAP search key '${token}'`);
   }
-  return out;
+};
+function parseSearchCriteria(criteria) {
+  if (criteria === "ALL" || criteria === "") return { all: true };
+  return new CriteriaParser(tokenizeCriteria(criteria)).parseSequence();
 }
 function tokenizeCriteria(criteria) {
   const tokens = [];
   let i = 0;
   while (i < criteria.length) {
-    if (criteria[i] === " ") {
+    const char = criteria.charAt(i);
+    if (char === " ") {
+      i += 1;
+      continue;
+    }
+    if (char === "(" || char === ")") {
+      tokens.push(char);
       i += 1;
       continue;
     }
-    if (criteria[i] === '"') {
-      const end2 = criteria.indexOf('"', i + 1);
-      if (end2 === -1) {
-        tokens.push(criteria.slice(i + 1));
-        break;
+    if (char === '"') {
+      let value = "";
+      let j = i + 1;
+      while (j < criteria.length && criteria.charAt(j) !== '"') {
+        if (criteria.charAt(j) === "\\" && j + 1 < criteria.length) j += 1;
+        value += criteria.charAt(j);
+        j += 1;
       }
-      tokens.push(criteria.slice(i + 1, end2));
-      i = end2 + 1;
+      tokens.push(value);
+      i = j + 1;
       continue;
     }
-    let end = criteria.indexOf(" ", i);
-    if (end === -1) end = criteria.length;
+    let end = i;
+    while (end < criteria.length && !" ()".includes(criteria.charAt(end))) end += 1;
     tokens.push(criteria.slice(i, end));
     i = end;
   }
@@ -250,15 +325,35 @@ function parseImapDate(s) {
   };
   const day = Number.parseInt(m[1] ?? "0", 10);
   const monKey = (m[2] ?? "").slice(0, 1).toUpperCase() + (m[2] ?? "").slice(1).toLowerCase();
-  const mon = months[monKey] ?? 0;
+  const mon = months[monKey];
   const year = Number.parseInt(m[3] ?? "1970", 10);
-  return new Date(Date.UTC(year, mon, day));
+  if (mon === void 0) return null;
+  const value = new Date(Date.UTC(year, mon, day));
+  if (value.getUTCMonth() !== mon || value.getUTCDate() !== day) return null;
+  return value;
+}
+async function fetchRawMessage(accessor, folder, uid) {
+  const imap = await accessor.getImap();
+  const lock = await lockMailbox(imap, folder);
+  try {
+    const msg = await imap.fetchOne(uid, { source: true, uid: true }, { uid: true });
+    if (msg === false) {
+      throw new Error(`email: uid ${uid} not found in ${folder}`);
+    }
+    return msg.source instanceof Buffer ? new Uint8Array(msg.source) : new Uint8Array(0);
+  } finally {
+    lock.release();
+  }
 }
 async function fetchMessage(accessor, folder, uid) {
   const imap = await accessor.getImap();
-  const lock = await imap.getMailboxLock(folder);
+  const lock = await lockMailbox(imap, folder);
   try {
-    const msg = await imap.fetchOne(uid, { source: true, flags: true, uid: true }, { uid: true });
+    const msg = await imap.fetchOne(
+      uid,
+      { source: true, flags: true, uid: true, internalDate: true },
+      { uid: true }
+    );
     if (msg === false) {
       throw new Error(`email: uid ${uid} not found in ${folder}`);
     }
@@ -267,7 +362,8 @@ async function fetchMessage(accessor, folder, uid) {
     return {
       ...parsed,
       uid,
-      flags: msg.flags !== void 0 ? [...msg.flags] : []
+      flags: msg.flags !== void 0 ? [...msg.flags] : [],
+      internalDate: internalDateOf(msg.internalDate)
     };
   } finally {
     lock.release();
@@ -276,18 +372,23 @@ async function fetchMessage(accessor, folder, uid) {
 async function fetchHeaders(accessor, folder, uids) {
   if (uids.length === 0) return [];
   const imap = await accessor.getImap();
-  const lock = await imap.getMailboxLock(folder);
+  const lock = await lockMailbox(imap, folder);
   try {
     const results = [];
     for (const uid of uids) {
-      const msg = await imap.fetchOne(uid, { source: true, flags: true, uid: true }, { uid: true });
+      const msg = await imap.fetchOne(
+        uid,
+        { source: true, flags: true, uid: true, internalDate: true },
+        { uid: true }
+      );
       if (msg === false) continue;
       const source = msg.source instanceof Buffer ? new Uint8Array(msg.source) : new Uint8Array(0);
       const parsed = await parseRfc822(source);
       results.push({
         ...parsed,
         uid,
-        flags: msg.flags !== void 0 ? [...msg.flags] : []
+        flags: msg.flags !== void 0 ? [...msg.flags] : [],
+        internalDate: internalDateOf(msg.internalDate)
       });
     }
     return results;
@@ -297,7 +398,7 @@ async function fetchHeaders(accessor, folder, uids) {
 }
 async function fetchAttachment(accessor, folder, uid, filename) {
   const imap = await accessor.getImap();
-  const lock = await imap.getMailboxLock(folder);
+  const lock = await lockMailbox(imap, folder);
   try {
     const msg = await imap.fetchOne(uid, { source: true }, { uid: true });
     if (msg === false) return null;
@@ -317,10 +418,28 @@ async function listFolders2(accessor) {
   return listFolders(accessor);
 }
 
+// src/core/email/render.ts
+var encoder = new TextEncoder();
+function messageDocument(message) {
+  const body = { ...message };
+  delete body.internalDate;
+  return body;
+}
+function messageJsonText(message) {
+  return JSON.stringify(messageDocument(message));
+}
+function messageJsonBytes(message) {
+  return encoder.encode(messageJsonText(message));
+}
+function messagesJsonBytes(messages) {
+  return encoder.encode(JSON.stringify(messages.map((m) => messageDocument(m))));
+}
+
 // src/core/email/readdir.ts
 var TITLE_MAX = 80;
 var UNSAFE = /[^\w\s\-.]/g;
 var MULTI_UNDERSCORE = /_+/g;
+var EPOCH_DATE = "1970-01-01";
 function sanitize(text) {
   if (text.trim() === "") return "No_Subject";
   let cleaned = text.replace(UNSAFE, "_").replace(/ /g, "_");
@@ -331,19 +450,43 @@ function sanitize(text) {
 function msgFilename(subject, uid) {
   return `${sanitize(subject)}__${uid}.email.json`;
 }
-function dateFromHeader(dateStr) {
-  if (dateStr === "") return "1970-01-01";
-  const d = new Date(dateStr);
-  if (Number.isNaN(d.getTime())) return "1970-01-01";
-  const yyyy = d.getUTCFullYear().toString().padStart(4, "0");
-  const mm = (d.getUTCMonth() + 1).toString().padStart(2, "0");
-  const dd = d.getUTCDate().toString().padStart(2, "0");
-  return `${yyyy}-${mm}-${dd}`;
+var NAMED_ZONES = {
+  UT: 0,
+  UTC: 0,
+  GMT: 0,
+  Z: 0,
+  EST: -300,
+  EDT: -240,
+  CST: -360,
+  CDT: -300,
+  MST: -420,
+  MDT: -360,
+  PST: -480,
+  PDT: -420
+};
+function statedOffset(value) {
+  const numeric = /([+-])(\d{2}):?(\d{2})\s*$/.exec(value);
+  if (numeric !== null) {
+    const sign = numeric[1] === "-" ? -1 : 1;
+    return sign * (Number(numeric[2]) * 60 + Number(numeric[3]));
+  }
+  const named = /([A-Z]{1,3})\s*$/.exec(value.toUpperCase());
+  return NAMED_ZONES[named?.[1] ?? ""] ?? null;
+}
+function ymd(year, month, day) {
+  return `${year.toString().padStart(4, "0")}-${month.toString().padStart(2, "0")}-${day.toString().padStart(2, "0")}`;
+}
+function parseDate(value) {
+  if (value.trim() === "") return null;
+  const d = new Date(value);
+  if (Number.isNaN(d.getTime())) return null;
+  const offset = statedOffset(value);
+  if (offset === null) return ymd(d.getFullYear(), d.getMonth() + 1, d.getDate());
+  const shifted = new Date(d.getTime() + offset * 6e4);
+  return ymd(shifted.getUTCFullYear(), shifted.getUTCMonth() + 1, shifted.getUTCDate());
 }
-function enoent(p) {
-  const e = new Error(`ENOENT: ${p}`);
-  e.code = "ENOENT";
-  return e;
+function dateBucket(message) {
+  return parseDate(message.date) ?? parseDate(message.internalDate) ?? EPOCH_DATE;
 }
 async function readdir(accessor, path, index) {
   const prefix = mountPrefixOf(path.virtual, path.resourcePath);
@@ -377,12 +520,13 @@ async function readdir(accessor, path, index) {
       if (cached.entries !== void 0 && cached.entries !== null) return cached.entries;
     }
     if (index === void 0) throw enoent(path.virtual);
+    if (!(await listFolders2(accessor)).includes(folderName)) throw enoent(path.virtual);
     const maxMessages = accessor.config.maxMessages;
     const uids = await listMessageUids(accessor, folderName, "ALL", maxMessages);
     const headersList = await fetchHeaders(accessor, folderName, uids);
     const dateGroups = /* @__PURE__ */ new Map();
     for (const hdr of headersList) {
-      const dateStr = dateFromHeader(hdr.date);
+      const dateStr = dateBucket(hdr);
       let bucket = dateGroups.get(dateStr);
       if (bucket === void 0) {
         bucket = [];
@@ -390,7 +534,7 @@ async function readdir(accessor, path, index) {
       }
       bucket.push(hdr);
     }
-    const sortedDates = [...dateGroups.keys()].sort().reverse();
+    const sortedDates = [...dateGroups.keys()].sort(compareCodePoints).reverse();
     const dateEntries = [];
     for (const dateStr of sortedDates) {
       const dateEntry = new IndexEntry({
@@ -409,7 +553,8 @@ async function readdir(accessor, path, index) {
           id: uid,
           name: subject,
           resourceType: "email/message",
-          vfsName: filename
+          vfsName: filename,
+          size: messageJsonBytes(hdr).byteLength
         });
         msgEntries.push([filename, msgEntry]);
         const attachments = hdr.attachments;
@@ -462,27 +607,15 @@ async function readdir(accessor, path, index) {
 }
 
 // src/core/email/stat.ts
-import { FileStat, FileType, PathSpec, mountKey as mountKey2, mountPrefixOf as mountPrefixOf2 } from "@struktoai/mirage-core";
-function guessType(name) {
-  const lower = name.toLowerCase();
-  if (lower.endsWith(".json") || lower.endsWith(".email.json")) return FileType.JSON;
-  if (lower.endsWith(".csv")) return FileType.CSV;
-  if (lower.endsWith(".png")) return FileType.IMAGE_PNG;
-  if (lower.endsWith(".jpg") || lower.endsWith(".jpeg")) return FileType.IMAGE_JPEG;
-  if (lower.endsWith(".gif")) return FileType.IMAGE_GIF;
-  if (lower.endsWith(".zip")) return FileType.ZIP;
-  if (lower.endsWith(".gz") || lower.endsWith(".gzip")) return FileType.GZIP;
-  if (lower.endsWith(".pdf")) return FileType.PDF;
-  if (lower.endsWith(".txt") || lower.endsWith(".md") || lower.endsWith(".log")) {
-    return FileType.TEXT;
-  }
-  return FileType.BINARY;
-}
-function enoent2(p) {
-  const e = new Error(`ENOENT: ${p}`);
-  e.code = "ENOENT";
-  return e;
-}
+import {
+  FileStat,
+  FileType,
+  PathSpec,
+  enoent as enoent2,
+  guessType,
+  mountKey as mountKey2,
+  mountPrefixOf as mountPrefixOf2
+} from "@struktoai/mirage-core";
 async function stat(accessor, path, index) {
   const prefix = mountPrefixOf2(path.virtual, path.resourcePath);
   const key = path.resourcePath;
@@ -545,18 +678,7 @@ async function stat(accessor, path, index) {
 }
 
 // src/core/email/read.ts
-import { gnuDirname, mountPrefixOf as mountPrefixOf3, stripSlash } from "@struktoai/mirage-core";
-var ENC = new TextEncoder();
-function enoent3(p) {
-  const e = new Error(`ENOENT: ${p}`);
-  e.code = "ENOENT";
-  return e;
-}
-function eisdir(p) {
-  const e = new Error(`EISDIR: ${p}`);
-  e.code = "EISDIR";
-  return e;
-}
+import { eisdir, enoent as enoent3, gnuDirname, mountPrefixOf as mountPrefixOf3, stripSlash } from "@struktoai/mirage-core";
 async function read(accessor, path, index) {
   const prefix = mountPrefixOf3(path.virtual, path.resourcePath);
   const key = path.resourcePath;
@@ -586,7 +708,7 @@ async function read(accessor, path, index) {
   const folder = prefix !== "" ? parts[1] ?? "" : parts[0] ?? "";
   const uid = result.entry.id;
   const msg = await fetchMessage(accessor, folder, uid);
-  return ENC.encode(JSON.stringify(msg));
+  return messageJsonBytes(msg);
 }
 
 // src/commands/builtin/email/io.ts
@@ -634,78 +756,32 @@ function metadataProvision(_accessor, _paths, _texts, _opts) {
 }
 
 // src/commands/builtin/email/find.ts
-import { fnmatch } from "@struktoai/mirage-core";
-import { findSizeMtimeError, invalidFindArg } from "@struktoai/mirage-core";
 var resolveGlob = resolveGlobOf(EMAIL_IO);
-async function walk(accessor, path, index, maxDepth, depth) {
-  if (maxDepth !== null && depth > maxDepth) return [];
-  let children;
-  try {
-    children = await readdir(accessor, path, index ?? void 0);
-  } catch {
-    return [];
-  }
-  const results = [];
-  for (const child of children) {
-    const trimmed = rstripSlash(child);
-    results.push(trimmed);
-    const childSpec = new PathSpec2({
-      virtual: trimmed,
-      directory: trimmed,
-      resolved: false,
-      resourcePath: mountKey3(trimmed, mountPrefixOf4(path.virtual, path.resourcePath))
-    });
-    let st;
-    try {
-      st = await stat(accessor, childSpec, index ?? void 0);
-    } catch {
-      continue;
-    }
-    if (st.type === FileType2.DIRECTORY) {
-      const sub = await walk(accessor, childSpec, index, maxDepth, depth + 1);
-      results.push(...sub);
-    }
-  }
-  return results;
-}
-async function findCommand(accessor, paths, _texts, opts) {
-  const resolved = await resolveGlob(accessor, paths, opts.index ?? void 0);
-  const p0 = resolved[0] ?? new PathSpec2({
-    virtual: "/",
-    directory: "/",
-    resolved: false,
-    resourcePath: ""
-  });
-  const nameFlag = typeof opts.flags.name === "string" ? opts.flags.name : null;
-  const inameFlag = typeof opts.flags.iname === "string" ? opts.flags.iname : null;
-  const maxDepthRaw = typeof opts.flags.maxdepth === "string" ? opts.flags.maxdepth : null;
-  const minDepthRaw = typeof opts.flags.mindepth === "string" ? opts.flags.mindepth : null;
-  const maxDepth = maxDepthRaw !== null ? Number.parseInt(maxDepthRaw, 10) : null;
-  const minDepth = minDepthRaw !== null ? Number.parseInt(minDepthRaw, 10) : null;
-  if (maxDepthRaw !== null && Number.isNaN(maxDepth))
-    return invalidFindArg(maxDepthRaw, "-maxdepth");
-  if (minDepthRaw !== null && Number.isNaN(minDepth))
-    return invalidFindArg(minDepthRaw, "-mindepth");
-  const sizeFlag = typeof opts.flags.size === "string" ? opts.flags.size : null;
-  const mtimeFlag = typeof opts.flags.mtime === "string" ? opts.flags.mtime : null;
-  const sizeMtimeErr = findSizeMtimeError(sizeFlag, mtimeFlag);
-  if (sizeMtimeErr !== null) return sizeMtimeErr;
-  const allPaths = await walk(accessor, p0, opts.index, maxDepth, 0);
-  const searchKey = stripSlash2(p0.mountPath);
-  const baseDepth = searchKey === "" ? -1 : searchKey.split("/").length - 1;
-  const results = [];
-  for (const p of [...allPaths].sort()) {
-    const stripped = p.startsWith(mountPrefixOf4(p0.virtual, p0.resourcePath)) ? p.slice(mountPrefixOf4(p0.virtual, p0.resourcePath).length) : p;
-    const trimmed = stripSlash2(stripped);
-    const depth = trimmed === "" ? -1 : trimmed.split("/").length - (baseDepth + 2);
-    if (minDepth !== null && depth < minDepth) continue;
-    const entryName = p.split("/").pop() ?? p;
-    if (nameFlag !== null && !fnmatch(entryName, nameFlag)) continue;
-    if (inameFlag !== null && !fnmatch(entryName.toLowerCase(), inameFlag.toLowerCase())) continue;
-    results.push(p);
-  }
-  const out = formatRecords(results);
-  return [out, new IOResult()];
+async function findCommand(accessor, paths, texts, opts) {
+  const idx = opts.index ?? void 0;
+  const resolved = await resolveGlob(accessor, paths, idx);
+  const dirEmpty = async (spec) => (await readdir(accessor, spec, idx)).length === 0;
+  return findGeneric(
+    resolved,
+    texts,
+    opts,
+    (root, options) => walkFind(
+      root,
+      {
+        readdir: (spec, i) => readdir(accessor, spec, i),
+        stat: async (spec, i) => {
+          const st = await stat(accessor, spec, i);
+          const overlay = opts.ns?.statOverlay;
+          return overlay !== void 0 ? overlay(spec.virtual, st) : st;
+        },
+        links: opts.ns?.links ?? null
+      },
+      options,
+      idx
+    ),
+    void 0,
+    dirEmpty
+  );
 }
 var EMAIL_FIND = command({
   name: "find",
@@ -715,142 +791,24 @@ var EMAIL_FIND = command({
   provision: metadataProvision
 });
 
-// src/commands/builtin/email/email_forward.ts
-import {
-  CommandSpec,
-  IOResult as IOResult2,
-  OperandKind,
-  Option,
-  ResourceName as ResourceName2,
-  command as command2
-} from "@struktoai/mirage-core";
-
-// src/core/email/send.ts
-import { loadOptionalPeer as loadOptionalPeer3 } from "@struktoai/mirage-core";
-var transporterCache = /* @__PURE__ */ new WeakMap();
-async function getTransporter(config) {
-  const existing = transporterCache.get(config);
-  if (existing !== void 0) return existing;
-  const mod = await loadOptionalPeer3(
-    () => import("nodemailer"),
-    { feature: "email send/reply/forward", packageName: "nodemailer" }
-  );
-  const transporter = mod.createTransport({
-    host: config.smtpHost,
-    port: config.smtpPort,
-    secure: config.smtpPort === 465,
-    auth: { user: config.username, pass: config.password }
-  });
-  transporterCache.set(config, transporter);
-  return transporter;
-}
-async function sendMessage(config, to, subject, body) {
-  const t = await getTransporter(config);
-  await t.sendMail({ from: config.username, to, subject, text: body });
-  return { status: "sent", to, subject };
-}
-async function replyMessage(config, original, body) {
-  const t = await getTransporter(config);
-  const refs = [...original.references];
-  if (original.message_id !== "") refs.push(original.message_id);
-  const subject = `Re: ${original.subject}`;
-  await t.sendMail({
-    from: config.username,
-    to: original.from.email,
-    subject,
-    text: body,
-    inReplyTo: original.message_id,
-    references: refs
-  });
-  return { status: "sent", to: original.from.email, subject };
-}
-async function replyAllMessage(config, original, body) {
-  const t = await getTransporter(config);
-  const all = /* @__PURE__ */ new Set();
-  if (original.from.email !== "") all.add(original.from.email);
-  for (const r of original.to) if (r.email !== "") all.add(r.email);
-  for (const r of original.cc) if (r.email !== "") all.add(r.email);
-  all.delete(config.username);
-  const recipients = [...all].sort();
-  const refs = [...original.references];
-  if (original.message_id !== "") refs.push(original.message_id);
-  const subject = `Re: ${original.subject}`;
-  await t.sendMail({
-    from: config.username,
-    to: recipients,
-    subject,
-    text: body,
-    inReplyTo: original.message_id,
-    references: refs
-  });
-  return { status: "sent", to: recipients, subject };
-}
-async function forwardMessage(config, original, to) {
-  const t = await getTransporter(config);
-  const subject = `Fwd: ${original.subject}`;
-  const fwdBody = `---------- Forwarded message ----------
-From: ${original.from.name} <${original.from.email}>
-Date: ${original.date}
-Subject: ${original.subject}
-
-` + original.body_text;
-  await t.sendMail({ from: config.username, to, subject, text: fwdBody });
-  return { status: "sent", to, subject };
-}
-
-// src/commands/builtin/email/email_forward.ts
-var ENC2 = new TextEncoder();
-var SPEC = new CommandSpec({
-  options: [
-    new Option({ long: "--uid", valueKind: OperandKind.TEXT }),
-    new Option({ long: "--folder", valueKind: OperandKind.TEXT }),
-    new Option({ long: "--to", valueKind: OperandKind.TEXT })
-  ]
-});
-async function emailForwardCommand(accessor, _paths, _texts, opts) {
-  const uid = typeof opts.flags.uid === "string" ? opts.flags.uid : "";
-  const folder = typeof opts.flags.folder === "string" ? opts.flags.folder : "";
-  const to = typeof opts.flags.to === "string" ? opts.flags.to : "";
-  if (uid === "") {
-    return [null, new IOResult2({ exitCode: 2, stderr: ENC2.encode("--uid is required\n") })];
-  }
-  if (folder === "") {
-    return [null, new IOResult2({ exitCode: 2, stderr: ENC2.encode("--folder is required\n") })];
-  }
-  if (to === "") {
-    return [null, new IOResult2({ exitCode: 2, stderr: ENC2.encode("--to is required\n") })];
-  }
-  const original = await fetchMessage(accessor, folder, uid);
-  const result = await forwardMessage(accessor.config, original, to);
-  const out = ENC2.encode(JSON.stringify(result));
-  return [out, new IOResult2()];
-}
-var EMAIL_FORWARD = command2({
-  name: "himalaya message forward",
-  resource: ResourceName2.EMAIL,
-  spec: SPEC,
-  fn: emailForwardCommand,
-  write: true
-});
-
 // src/commands/builtin/email/grep.ts
 import {
-  IOResult as IOResult3,
-  ResourceName as ResourceName3,
-  command as command3,
+  IOResult,
+  ResourceName as ResourceName2,
+  command as command2,
   compilePattern,
   grepGeneric,
   grepLines,
-  mountPrefixOf as mountPrefixOf5,
+  mountPrefixOf as mountPrefixOf4,
   prefixAggregate,
   resolveGlobOf as resolveGlobOf2,
   specOf as specOf2
 } from "@struktoai/mirage-core";
 
 // src/core/email/scope.ts
-import { stripSlash as stripSlash3 } from "@struktoai/mirage-core";
+import { stripSlash as stripSlash2 } from "@struktoai/mirage-core";
 function detectScope(path) {
-  const key = stripSlash3(path.mountPath);
+  const key = stripSlash2(path.mountPath);
   if (key === "") {
     return { useNative: false, folder: null, resourcePath: "/" };
   }
@@ -868,25 +826,6 @@ function detectScope(path) {
 }
 
 // src/core/email/search.ts
-var TITLE_MAX2 = 80;
-var UNSAFE2 = /[^\w\s\-.]/g;
-var MULTI_UNDERSCORE2 = /_+/g;
-function sanitize2(text) {
-  if (text.trim() === "") return "No_Subject";
-  let cleaned = text.replace(UNSAFE2, "_").replace(/ /g, "_");
-  cleaned = cleaned.replace(MULTI_UNDERSCORE2, "_").replace(/^_+|_+$/g, "");
-  if (cleaned.length > TITLE_MAX2) cleaned = `${cleaned.slice(0, TITLE_MAX2 - 3)}...`;
-  return cleaned;
-}
-function dateFromHeader2(dateStr) {
-  if (dateStr === "") return "1970-01-01";
-  const d = new Date(dateStr);
-  if (Number.isNaN(d.getTime())) return "1970-01-01";
-  const yyyy = d.getUTCFullYear().toString().padStart(4, "0");
-  const mm = (d.getUTCMonth() + 1).toString().padStart(2, "0");
-  const dd = d.getUTCDate().toString().padStart(2, "0");
-  return `${yyyy}-${mm}-${dd}`;
-}
 function buildSearchCriteria(opts) {
   const parts = [];
   if (opts.unseen === true) parts.push("UNSEEN");
@@ -915,8 +854,8 @@ async function searchMessages(accessor, folder, opts = {}, maxResults = null) {
   return listMessageUids(accessor, folder, criteria, maxResults);
 }
 function buildVfsPath(prefix, folder, msg) {
-  const dateStr = dateFromHeader2(msg.date);
-  const subject = sanitize2(msg.subject !== "" ? msg.subject : "No Subject");
+  const dateStr = dateBucket(msg);
+  const subject = sanitize(msg.subject !== "" ? msg.subject : "No Subject");
   const filename = `${subject}__${msg.uid}.email.json`;
   return [prefix, folder, dateStr, filename].filter((p) => p !== "").join("/");
 }
@@ -927,7 +866,7 @@ async function searchAndFormat(accessor, scope, pattern, prefix, maxResults = nu
   const pairs = [];
   for (const uid of uids) {
     const msg = await fetchMessage(accessor, folder, uid);
-    const msgText = JSON.stringify(msg);
+    const msgText = messageJsonText(msg);
     const vfsPath = buildVfsPath(prefix, folder, msg);
     pairs.push([vfsPath, msgText]);
   }
@@ -936,7 +875,7 @@ async function searchAndFormat(accessor, scope, pattern, prefix, maxResults = nu
 
 // src/commands/builtin/email/grep.ts
 var resolveGlob2 = resolveGlobOf2(EMAIL_IO);
-var ENC3 = new TextEncoder();
+var ENC = new TextEncoder();
 async function* emailStream(accessor, p, index) {
   yield await read(accessor, p, index);
 }
@@ -971,7 +910,7 @@ async function grepCommand(accessor, paths, texts, opts) {
     pattern = getPattern(texts, opts.flags);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
-    return [null, new IOResult3({ exitCode: 2, stderr: ENC3.encode(`${msg}
+    return [null, new IOResult({ exitCode: 2, stderr: ENC.encode(`${msg}
 `) })];
   }
   const f = parseFlags(opts.flags);
@@ -980,7 +919,7 @@ async function grepCommand(accessor, paths, texts, opts) {
     if (first !== void 0) {
       const scope = detectScope(first);
       if (scope.useNative && !pattern.includes("\n")) {
-        const filePrefix = mountPrefixOf5(first.virtual, first.resourcePath) !== "" ? mountPrefixOf5(first.virtual, first.resourcePath) : "";
+        const filePrefix = mountPrefixOf4(first.virtual, first.resourcePath) !== "" ? mountPrefixOf4(first.virtual, first.resourcePath) : "";
         const pairs = await searchAndFormat(accessor, scope, pattern, filePrefix, f.maxCount ?? 50);
         const lines = [];
         for (const [vfsPath, msgText] of pairs) {
@@ -992,9 +931,9 @@ async function grepCommand(accessor, paths, texts, opts) {
           );
           for (const line of matched) lines.push(`${vfsPath}:${line}`);
         }
-        if (lines.length === 0) return [new Uint8Array(0), new IOResult3({ exitCode: 1 })];
-        const out = ENC3.encode(lines.join("\n") + "\n");
-        return [out, new IOResult3()];
+        if (lines.length === 0) return [new Uint8Array(0), new IOResult({ exitCode: 1 })];
+        const out = ENC.encode(lines.join("\n") + "\n");
+        return [out, new IOResult()];
       }
     }
   }
@@ -1011,110 +950,31 @@ async function grepCommand(accessor, paths, texts, opts) {
     (p) => emailStream(accessor, p, opts.index ?? void 0)
   );
 }
-var EMAIL_GREP = command3({
+var EMAIL_GREP = command2({
   name: "grep",
-  resource: ResourceName3.EMAIL,
+  resource: ResourceName2.EMAIL,
   spec: specOf2("grep"),
   fn: grepCommand,
   aggregate: prefixAggregate,
   provision: fileReadProvision
 });
 
-// src/commands/builtin/email/email_read.ts
-import {
-  CommandSpec as CommandSpec2,
-  IOResult as IOResult4,
-  OperandKind as OperandKind2,
-  Option as Option2,
-  ResourceName as ResourceName4,
-  command as command4
-} from "@struktoai/mirage-core";
-var ENC4 = new TextEncoder();
-var SPEC2 = new CommandSpec2({
-  options: [
-    new Option2({ long: "--uid", valueKind: OperandKind2.TEXT }),
-    new Option2({ long: "--folder", valueKind: OperandKind2.TEXT })
-  ]
-});
-async function emailReadCommand(accessor, _paths, _texts, opts) {
-  const uid = typeof opts.flags.uid === "string" ? opts.flags.uid : "";
-  const folder = typeof opts.flags.folder === "string" ? opts.flags.folder : "";
-  if (uid === "") {
-    return [null, new IOResult4({ exitCode: 2, stderr: ENC4.encode("--uid is required\n") })];
-  }
-  if (folder === "") {
-    return [null, new IOResult4({ exitCode: 2, stderr: ENC4.encode("--folder is required\n") })];
-  }
-  const processed = await fetchMessage(accessor, folder, uid);
-  const out = ENC4.encode(JSON.stringify(processed));
-  return [out, new IOResult4()];
-}
-var EMAIL_READ = command4({
-  name: "himalaya message read",
-  resource: ResourceName4.EMAIL,
-  spec: SPEC2,
-  fn: emailReadCommand
-});
-
-// src/commands/builtin/email/email_reply.ts
-import {
-  CommandSpec as CommandSpec3,
-  IOResult as IOResult5,
-  OperandKind as OperandKind3,
-  Option as Option3,
-  ResourceName as ResourceName5,
-  command as command5
-} from "@struktoai/mirage-core";
-var ENC5 = new TextEncoder();
-var SPEC3 = new CommandSpec3({
-  options: [
-    new Option3({ long: "--uid", valueKind: OperandKind3.TEXT }),
-    new Option3({ long: "--folder", valueKind: OperandKind3.TEXT }),
-    new Option3({ long: "--body", valueKind: OperandKind3.TEXT }),
-    new Option3({ long: "--all" })
-  ]
-});
-async function emailReplyCommand(accessor, _paths, _texts, opts) {
-  const uid = typeof opts.flags.uid === "string" ? opts.flags.uid : "";
-  const folder = typeof opts.flags.folder === "string" ? opts.flags.folder : "";
-  const body = typeof opts.flags.body === "string" ? opts.flags.body : "";
-  if (uid === "") {
-    return [null, new IOResult5({ exitCode: 2, stderr: ENC5.encode("--uid is required\n") })];
-  }
-  if (folder === "") {
-    return [null, new IOResult5({ exitCode: 2, stderr: ENC5.encode("--folder is required\n") })];
-  }
-  if (body === "") {
-    return [null, new IOResult5({ exitCode: 2, stderr: ENC5.encode("--body is required\n") })];
-  }
-  const original = await fetchMessage(accessor, folder, uid);
-  const result = opts.flags.all === true ? await replyAllMessage(accessor.config, original, body) : await replyMessage(accessor.config, original, body);
-  const out = ENC5.encode(JSON.stringify(result));
-  return [out, new IOResult5()];
-}
-var EMAIL_REPLY = command5({
-  name: "himalaya message reply",
-  resource: ResourceName5.EMAIL,
-  spec: SPEC3,
-  fn: emailReplyCommand,
-  write: true
-});
-
 // src/commands/builtin/email/rg.ts
 import {
-  IOResult as IOResult6,
-  ResourceName as ResourceName6,
-  command as command6,
+  FlagView,
+  IOResult as IOResult2,
+  ResourceName as ResourceName3,
+  command as command3,
   compilePattern as compilePattern2,
   grepLines as grepLines2,
-  mountPrefixOf as mountPrefixOf6,
+  mountPrefixOf as mountPrefixOf5,
   patternArg,
   resolveGlobOf as resolveGlobOf3,
   rgGeneric,
   specOf as specOf3
 } from "@struktoai/mirage-core";
 var resolveGlob3 = resolveGlobOf3(EMAIL_IO);
-var ENC6 = new TextEncoder();
+var ENC2 = new TextEncoder();
 async function* emailStream2(accessor, p, index) {
   yield await read(accessor, p, index);
 }
@@ -1123,18 +983,19 @@ async function rgCommand(accessor, paths, texts, opts) {
   if (pattern === null) {
     return [
       null,
-      new IOResult6({ exitCode: 2, stderr: ENC6.encode("rg: usage: rg [flags] pattern [path]\n") })
+      new IOResult2({ exitCode: 2, stderr: ENC2.encode("rg: usage: rg [flags] pattern [path]\n") })
     ];
   }
-  const ignoreCase = opts.flags.i === true;
-  const invert = opts.flags.v === true;
-  const lineNumbers = opts.flags.n === true;
-  const countOnly = opts.flags.c === true;
-  const filesOnly = opts.flags.args_l === true || opts.flags.l === true;
-  const wholeWord = opts.flags.w === true;
-  const fixedString = opts.flags.F === true;
-  const onlyMatching = opts.flags.o === true;
-  const maxCount = typeof opts.flags.m === "string" ? Number.parseInt(opts.flags.m, 10) : null;
+  const fl = new FlagView(opts.flags, specOf3("rg"));
+  const ignoreCase = fl.asBool("i");
+  const invert = fl.asBool("v");
+  const lineNumbers = fl.asBool("n");
+  const countOnly = fl.asBool("c");
+  const filesOnly = fl.asBool("args_l");
+  const wholeWord = fl.asBool("w");
+  const fixedString = fl.asBool("F");
+  const onlyMatching = fl.asBool("o");
+  const maxCount = fl.asInt("m") ?? null;
   const pat = compilePattern2(pattern, ignoreCase, fixedString, wholeWord);
   const lineOpts = {
     invert,
@@ -1149,16 +1010,16 @@ async function rgCommand(accessor, paths, texts, opts) {
     if (first !== void 0) {
       const scope = detectScope(first);
       if (scope.useNative && !pattern.includes("\n")) {
-        const filePrefix = mountPrefixOf6(first.virtual, first.resourcePath) !== "" ? mountPrefixOf6(first.virtual, first.resourcePath) : "";
+        const filePrefix = mountPrefixOf5(first.virtual, first.resourcePath) !== "" ? mountPrefixOf5(first.virtual, first.resourcePath) : "";
         const pairs = await searchAndFormat(accessor, scope, pattern, filePrefix, maxCount ?? 50);
         const lines = [];
         for (const [vfsPath, msgText] of pairs) {
           const matched = grepLines2(vfsPath, [msgText], pat, lineOpts);
           for (const line of matched) lines.push(`${vfsPath}:${line}`);
         }
-        if (lines.length === 0) return [new Uint8Array(0), new IOResult6({ exitCode: 1 })];
-        const out = ENC6.encode(lines.join("\n") + "\n");
-        return [out, new IOResult6()];
+        if (lines.length === 0) return [new Uint8Array(0), new IOResult2({ exitCode: 1 })];
+        const out = ENC2.encode(lines.join("\n") + "\n");
+        return [out, new IOResult2()];
       }
     }
   }
@@ -1174,129 +1035,27 @@ async function rgCommand(accessor, paths, texts, opts) {
     (p) => emailStream2(accessor, p, opts.index ?? void 0)
   );
 }
-var EMAIL_RG = command6({
+var EMAIL_RG = command3({
   name: "rg",
-  resource: ResourceName6.EMAIL,
+  resource: ResourceName3.EMAIL,
   spec: specOf3("rg"),
   fn: rgCommand
 });
 
-// src/commands/builtin/email/email_send.ts
-import {
-  CommandSpec as CommandSpec4,
-  IOResult as IOResult7,
-  OperandKind as OperandKind4,
-  Option as Option4,
-  ResourceName as ResourceName7,
-  command as command7
-} from "@struktoai/mirage-core";
-var ENC7 = new TextEncoder();
-var SPEC4 = new CommandSpec4({
-  options: [
-    new Option4({ long: "--to", valueKind: OperandKind4.TEXT }),
-    new Option4({ long: "--subject", valueKind: OperandKind4.TEXT }),
-    new Option4({ long: "--body", valueKind: OperandKind4.TEXT })
-  ]
-});
-async function emailSendCommand(accessor, _paths, _texts, opts) {
-  const to = typeof opts.flags.to === "string" ? opts.flags.to : "";
-  const subject = typeof opts.flags.subject === "string" ? opts.flags.subject : "";
-  const body = typeof opts.flags.body === "string" ? opts.flags.body : "";
-  if (to === "") {
-    return [null, new IOResult7({ exitCode: 2, stderr: ENC7.encode("--to is required\n") })];
-  }
-  if (subject === "") {
-    return [null, new IOResult7({ exitCode: 2, stderr: ENC7.encode("--subject is required\n") })];
-  }
-  if (body === "") {
-    return [null, new IOResult7({ exitCode: 2, stderr: ENC7.encode("--body is required\n") })];
-  }
-  const result = await sendMessage(accessor.config, to, subject, body);
-  const out = ENC7.encode(JSON.stringify(result));
-  return [out, new IOResult7()];
-}
-var EMAIL_SEND = command7({
-  name: "himalaya message send",
-  resource: ResourceName7.EMAIL,
-  spec: SPEC4,
-  fn: emailSendCommand,
-  write: true
-});
-
-// src/commands/builtin/email/email_triage.ts
-import {
-  CommandSpec as CommandSpec5,
-  IOResult as IOResult8,
-  OperandKind as OperandKind5,
-  Option as Option5,
-  ResourceName as ResourceName8,
-  command as command8
-} from "@struktoai/mirage-core";
-var ENC8 = new TextEncoder();
-var SPEC5 = new CommandSpec5({
-  options: [
-    new Option5({ long: "--folder", valueKind: OperandKind5.TEXT }),
-    new Option5({ long: "--max", valueKind: OperandKind5.TEXT }),
-    new Option5({ long: "--unseen" }),
-    new Option5({ long: "--subject", valueKind: OperandKind5.TEXT }),
-    new Option5({ long: "--from", valueKind: OperandKind5.TEXT }),
-    new Option5({ long: "--to", valueKind: OperandKind5.TEXT }),
-    new Option5({ long: "--body", valueKind: OperandKind5.TEXT }),
-    new Option5({ long: "--since", valueKind: OperandKind5.TEXT }),
-    new Option5({ long: "--before", valueKind: OperandKind5.TEXT })
-  ]
-});
-async function emailTriageCommand(accessor, _paths, _texts, opts) {
-  const folder = typeof opts.flags.folder === "string" ? opts.flags.folder : "INBOX";
-  const maxResults = typeof opts.flags.max === "string" ? Number.parseInt(opts.flags.max, 10) : 20;
-  const uids = await searchMessages(
-    accessor,
-    folder,
-    {
-      text: typeof opts.flags.body === "string" ? opts.flags.body : null,
-      subject: typeof opts.flags.subject === "string" ? opts.flags.subject : null,
-      fromAddr: typeof opts.flags.from === "string" ? opts.flags.from : null,
-      toAddr: typeof opts.flags.to === "string" ? opts.flags.to : null,
-      since: typeof opts.flags.since === "string" ? opts.flags.since : null,
-      before: typeof opts.flags.before === "string" ? opts.flags.before : null,
-      unseen: opts.flags.unseen === true
-    },
-    maxResults
-  );
-  if (uids.length === 0) {
-    const out2 = ENC8.encode("[]");
-    return [out2, new IOResult8()];
-  }
-  const headers = await fetchHeaders(accessor, folder, uids);
-  const out = ENC8.encode(JSON.stringify(headers));
-  return [out, new IOResult8()];
-}
-var EMAIL_TRIAGE = command8({
-  name: "himalaya envelope list",
-  resource: ResourceName8.EMAIL,
-  spec: SPEC5,
-  fn: emailTriageCommand
-});
-
 // src/commands/builtin/email/index.ts
 var EMAIL_OVERRIDES = /* @__PURE__ */ new Set(["find", "grep", "rg"]);
 var EMAIL_COMMANDS = [
-  ...makeGenericCommands(ResourceName9.EMAIL, EMAIL_IO, {
+  ...makeGenericCommands(ResourceName4.EMAIL, EMAIL_IO, {
     overrides: EMAIL_OVERRIDES
   }),
   ...EMAIL_FIND,
   ...EMAIL_GREP,
-  ...EMAIL_RG,
-  ...EMAIL_SEND,
-  ...EMAIL_REPLY,
-  ...EMAIL_FORWARD,
-  ...EMAIL_TRIAGE,
-  ...EMAIL_READ
+  ...EMAIL_RG
 ];
 
 // src/ops/email/index.ts
-import { ResourceName as ResourceName10, makeGenericOps } from "@struktoai/mirage-core";
-var EMAIL_OPS = makeGenericOps(ResourceName10.EMAIL, EMAIL_IO);
+import { ResourceName as ResourceName5, makeGenericOps } from "@struktoai/mirage-core";
+var EMAIL_OPS = makeGenericOps(ResourceName5.EMAIL, EMAIL_IO);
 
 // src/resource/email/prompt.ts
 var EMAIL_PROMPT = `{prefix}
@@ -1307,19 +1066,20 @@ var EMAIL_PROMPT = `{prefix}
         <attachment-filename>
   Folders include: INBOX, Sent, Drafts, etc. cat shows email as JSON.
 
-  Read commands:
-    himalaya envelope list --folder INBOX --unseen        # id/from/subject/date
-    himalaya message read --folder INBOX --uid <uid>     # one message as JSON`;
-var EMAIL_WRITE_PROMPT = `  Write commands:
-    himalaya message send --to "to@email.com" --subject "Hi" --body "..."
-    himalaya message reply --folder INBOX --uid <uid> --body "..." [--all]
-    himalaya message forward --folder INBOX --uid <uid> --to "to@email.com"`;
+  To act on mail (list/read/send/reply/forward), use the himalaya CLI
+  if installed: himalaya --help`;
+var EMAIL_WRITE_PROMPT = `  Sending mail goes through the himalaya CLI if installed:
+    himalaya message send --to "to@email.com" --subject "Hi" --body "..."`;
 
 // src/resource/email/email.ts
 var resolveGlob4 = makeResolveGlob(readdir);
 var EmailResource = class extends BaseResource {
-  kind = ResourceName11.EMAIL;
+  kind = ResourceName6.EMAIL;
   cachesReads = true;
+  // Every listed file carries an exact size: .email.json is rendered at
+  // readdir from the full message source the listing already fetches, and an
+  // attachment's size is its decoded payload length.
+  sizesAlwaysKnown = true;
   indexTtl = 86400;
   prompt = EMAIL_PROMPT;
   config;
@@ -1334,6 +1094,7 @@ var EmailResource = class extends BaseResource {
   }
   async close() {
     await this.accessor.close();
+    await super.close();
   }
   commands() {
     return EMAIL_COMMANDS;
@@ -1352,12 +1113,12 @@ var EmailResource = class extends BaseResource {
   }
   glob(paths, prefix = "") {
     const effective = prefix !== "" ? paths.map(
-      (p) => mountPrefixOf7(p.virtual, p.resourcePath) !== "" ? p : new PathSpec3({
+      (p) => mountPrefixOf6(p.virtual, p.resourcePath) !== "" ? p : new PathSpec2({
         virtual: p.virtual,
         directory: p.directory,
         ...p.pattern !== null ? { pattern: p.pattern } : {},
         resolved: p.resolved,
-        resourcePath: mountKey4(p.virtual, prefix)
+        resourcePath: mountKey3(p.virtual, prefix)
       })
     ) : paths;
     return resolveGlob4(this.accessor, effective, this.index);
@@ -1375,10 +1136,18 @@ var EmailResource = class extends BaseResource {
 
 export {
   EmailAccessor,
+  parseRfc822,
+  listFolderEntries,
+  listMessageUids,
+  fetchRawMessage,
+  fetchMessage,
+  fetchHeaders,
+  messageJsonBytes,
+  messagesJsonBytes,
   EMAIL_COMMANDS,
   EMAIL_OPS,
   EMAIL_PROMPT,
   EMAIL_WRITE_PROMPT,
   EmailResource
 };
-//# sourceMappingURL=chunk-4GYB7DGC.js.map
+//# sourceMappingURL=chunk-TWRQCQWU.js.map