@struktoai/mirage-node 0.0.2-alpha.0 → 0.0.3-alpha.0

package/dist/{chunk-OYJXYJTE.js → chunk-DTAY7LPC.js}

@@ -1,11 +1,11 @@
 import {
   redactEmailConfig
-} from "./chunk-H74QYTN7.js";
+} from "./chunk-B2ZOKNN4.js";
 
 // src/resource/email/email.ts
 import {
-  PathSpec as PathSpec7,
-  RAMIndexCacheStore,
+  BaseResource,
+  PathSpec as PathSpec4,
   ResourceName as ResourceName25
 } from "@struktoai/mirage-core";
 
@@ -34,7 +34,12 @@ var EmailAccessor = class extends Accessor {
       await client.connect();
       return client;
     })();
-    return this.clientPromise;
+    try {
+      return await this.clientPromise;
+    } catch (err) {
+      this.clientPromise = null;
+      throw err;
+    }
   }
   async close() {
     if (this.clientPromise === null) return;
@@ -48,46 +53,27 @@ var EmailAccessor = class extends Accessor {
 };
 
 // src/commands/builtin/email/basename.ts
-import {
-  IOResult,
-  ResourceName,
-  command,
-  specOf
-} from "@struktoai/mirage-core";
-var ENC = new TextEncoder();
-function basenameOf(p) {
-  const trimmed = p.replace(/\/+$/, "");
-  const idx = trimmed.lastIndexOf("/");
-  return idx === -1 ? trimmed : trimmed.slice(idx + 1);
-}
-function basenameCommand(_accessor, _paths, texts, _opts) {
-  const lines = texts.map((t) => basenameOf(t));
-  const out = ENC.encode(lines.join("\n") + "\n");
-  return [out, new IOResult()];
-}
+import { ResourceName, command, specOf, basenameFn } from "@struktoai/mirage-core";
 var EMAIL_BASENAME = command({
   name: "basename",
   resource: ResourceName.EMAIL,
   spec: specOf("basename"),
-  fn: basenameCommand
+  fn: basenameFn
 });
 
 // src/commands/builtin/email/cat.ts
 import {
-  AsyncLineIterator,
-  IOResult as IOResult2,
   ResourceName as ResourceName2,
+  catGeneric,
   command as command2,
-  resolveSource,
-  specOf as specOf2,
-  wrapBytes
+  specOf as specOf2
 } from "@struktoai/mirage-core";
 
 // src/core/email/glob.ts
-import { PathSpec as PathSpecCtor2 } from "@struktoai/mirage-core";
+import { PathSpec as PathSpecCtor2, rstripSlash } from "@struktoai/mirage-core";
 
 // src/core/email/readdir.ts
-import { IndexEntry, PathSpec as PathSpecCtor } from "@struktoai/mirage-core";
+import { IndexEntry, PathSpec as PathSpecCtor, stripSlash } from "@struktoai/mirage-core";
 
 // src/core/email/_parse.ts
 import { loadOptionalPeer as loadOptionalPeer2 } from "@struktoai/mirage-core";
@@ -157,7 +143,7 @@ async function parseWithPayloads(raw) {
 async function listFolders(accessor) {
   const imap = await accessor.getImap();
   const tree = await imap.list();
-  return tree.map((m) => m.path);
+  return tree.map((m) => m.pathAsListed);
 }
 async function listMessageUids(accessor, folder, searchCriteria = "ALL", maxResults = null) {
   const imap = await accessor.getImap();
@@ -351,7 +337,7 @@ async function readdir(accessor, path, index) {
   const raw = path.pattern !== null ? path.directory : path.original;
   let p = raw;
   if (prefix !== "" && p.startsWith(prefix)) p = p.slice(prefix.length) || "/";
-  const key = p.replace(/^\/+|\/+$/g, "");
+  const key = stripSlash(p);
   const virtualKey = key !== "" ? `${prefix}/${key}` : prefix !== "" ? prefix : "/";
   const parts = key === "" ? [] : key.split("/");
   const depth = parts.length;
@@ -462,11 +448,8 @@ async function readdir(accessor, path, index) {
 }
 
 // src/core/email/glob.ts
+import { fnmatch } from "@struktoai/mirage-core";
 var SCOPE_ERROR = 1e3;
-function fnmatch(name, pattern) {
-  const re = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\?/g, ".").replace(/\*/g, ".*");
-  return new RegExp(`^${re}$`).test(name);
-}
 async function resolveGlob(accessor, paths, index) {
   const result = [];
   for (const p of paths) {
@@ -478,7 +461,7 @@ async function resolveGlob(accessor, paths, index) {
       const entries = await readdir(accessor, p, index);
       const matched = [];
       for (const entry of entries) {
-        const trimmed = entry.replace(/\/+$/, "");
+        const trimmed = rstripSlash(entry);
         const base = trimmed.split("/").pop() ?? trimmed;
         if (!fnmatch(base, p.pattern)) continue;
         matched.push(PathSpecCtor2.fromStrPath(trimmed, p.prefix));
@@ -493,7 +476,8 @@ async function resolveGlob(accessor, paths, index) {
 }
 
 // src/core/email/read.ts
-var ENC2 = new TextEncoder();
+import { gnuDirname, stripSlash as stripSlash2 } from "@struktoai/mirage-core";
+var ENC = new TextEncoder();
 function enoent2(p) {
   const e = new Error(`ENOENT: ${p}`);
   e.code = "ENOENT";
@@ -504,17 +488,11 @@ function eisdir(p) {
   e.code = "EISDIR";
   return e;
 }
-function dirname(p) {
-  const norm = p.replace(/\/+$/, "");
-  const idx = norm.lastIndexOf("/");
-  if (idx <= 0) return "/";
-  return norm.slice(0, idx);
-}
 async function read(accessor, path, index) {
   const prefix = path.prefix;
   let p = path.original;
   if (prefix !== "" && p.startsWith(prefix)) p = p.slice(prefix.length) || "/";
-  const key = p.replace(/^\/+|\/+$/g, "");
+  const key = stripSlash2(p);
   if (index === void 0) throw enoent2(path.original);
   const virtualKey = prefix !== "" ? `${prefix}/${key}` : `/${key}`;
   const result = await index.get(virtualKey);
@@ -524,24 +502,93 @@ async function read(accessor, path, index) {
     throw eisdir(path.original);
   }
   if (rt === "email/attachment") {
-    const parentKey = dirname(virtualKey);
+    const parentKey = gnuDirname(virtualKey);
     const parentResult = await index.get(parentKey);
     if (parentResult.entry === void 0 || parentResult.entry === null) {
       throw enoent2(path.original);
     }
     const uid2 = parentResult.entry.id;
-    const parts2 = virtualKey.replace(/^\/+|\/+$/g, "").split("/");
+    const parts2 = stripSlash2(virtualKey).split("/");
     const folder2 = prefix !== "" ? parts2[1] ?? "" : parts2[0] ?? "";
     const filename = result.entry.vfsName !== "" ? result.entry.vfsName : result.entry.name;
     const data = await fetchAttachment(accessor, folder2, uid2, filename);
     if (data === null) throw enoent2(path.original);
     return data;
   }
-  const parts = virtualKey.replace(/^\/+|\/+$/g, "").split("/");
+  const parts = stripSlash2(virtualKey).split("/");
   const folder = prefix !== "" ? parts[1] ?? "" : parts[0] ?? "";
   const uid = result.entry.id;
   const msg = await fetchMessage(accessor, folder, uid);
-  return ENC2.encode(JSON.stringify(msg));
+  return ENC.encode(JSON.stringify(msg));
+}
+
+// src/core/email/stat.ts
+import { FileStat, FileType, stripSlash as stripSlash3 } 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 enoent3(p) {
+  const e = new Error(`ENOENT: ${p}`);
+  e.code = "ENOENT";
+  return e;
+}
+async function stat(accessor, path, index) {
+  const prefix = path.prefix;
+  let p = path.original;
+  if (prefix !== "" && p.startsWith(prefix)) p = p.slice(prefix.length) || "/";
+  const key = stripSlash3(p);
+  if (key === "") return new FileStat({ name: "/", type: FileType.DIRECTORY });
+  if (index === void 0) throw enoent3(path.original);
+  const virtualKey = prefix !== "" ? `${prefix}/${key}` : `/${key}`;
+  const result = await index.get(virtualKey);
+  if (result.entry === void 0 || result.entry === null) {
+    if (!key.includes("/")) {
+      const folders = await listFolders2(accessor);
+      if (folders.includes(key)) return new FileStat({ name: key, type: FileType.DIRECTORY });
+      throw enoent3(path.original);
+    }
+    throw enoent3(path.original);
+  }
+  const rt = result.entry.resourceType;
+  const vfsName = result.entry.vfsName !== "" ? result.entry.vfsName : result.entry.name;
+  if (rt === "email/folder") return new FileStat({ name: vfsName, type: FileType.DIRECTORY });
+  if (rt === "email/date") return new FileStat({ name: vfsName, type: FileType.DIRECTORY });
+  if (rt === "email/message") {
+    return new FileStat({
+      name: vfsName,
+      type: FileType.JSON,
+      size: result.entry.size,
+      extra: { uid: result.entry.id }
+    });
+  }
+  if (rt === "email/attachment_dir") {
+    return new FileStat({
+      name: vfsName,
+      type: FileType.DIRECTORY,
+      extra: { uid: result.entry.id }
+    });
+  }
+  if (rt === "email/attachment") {
+    return new FileStat({
+      name: vfsName,
+      type: guessType(vfsName),
+      size: result.entry.size,
+      extra: { attachment_id: result.entry.id }
+    });
+  }
+  return new FileStat({ name: vfsName, type: FileType.JSON, extra: { uid: result.entry.id } });
 }
 
 // src/commands/builtin/email/provision.ts
@@ -576,37 +623,18 @@ function metadataProvision(_accessor, _paths, _texts, _opts) {
 }
 
 // src/commands/builtin/email/cat.ts
-var ENC3 = new TextEncoder();
-async function* numberLinesStream(source) {
-  let num = 1;
-  const lineIter = new AsyncLineIterator(source);
-  for await (const line of lineIter) {
-    yield ENC3.encode(`     ${String(num)}	`);
-    yield line;
-    yield ENC3.encode("\n");
-    num += 1;
-  }
-}
-async function catCommand(accessor, paths, _texts, opts) {
-  const nFlag = opts.flags.n === true;
-  if (paths.length > 0) {
-    const resolved = await resolveGlob(accessor, paths, opts.index ?? void 0);
-    const first = resolved[0];
-    if (first === void 0) return [null, new IOResult2()];
-    const data = await read(accessor, first, opts.index ?? void 0);
-    const io = new IOResult2({ reads: { [first.stripPrefix]: data }, cache: [first.stripPrefix] });
-    if (nFlag) return [numberLinesStream(wrapBytes(data)), io];
-    return [data, io];
-  }
-  try {
-    const source = resolveSource(opts.stdin, "cat: missing operand");
-    if (nFlag) return [numberLinesStream(source), new IOResult2()];
-    return [source, new IOResult2()];
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    return [null, new IOResult2({ exitCode: 1, stderr: ENC3.encode(`${msg}
-`) })];
-  }
+async function* emailStream(accessor, p, index) {
+  yield await read(accessor, p, index);
+}
+async function catCommand(accessor, paths, texts, opts) {
+  const resolved = paths.length > 0 ? await resolveGlob(accessor, paths, opts.index ?? void 0) : [];
+  return catGeneric(
+    resolved,
+    texts,
+    opts,
+    (p) => stat(accessor, p, opts.index ?? void 0),
+    (p) => emailStream(accessor, p, opts.index ?? void 0)
+  );
 }
 var EMAIL_CAT = command2({
   name: "cat",
@@ -617,45 +645,27 @@ var EMAIL_CAT = command2({
 });
 
 // src/commands/builtin/email/dirname.ts
-import {
-  IOResult as IOResult3,
-  ResourceName as ResourceName3,
-  command as command3,
-  specOf as specOf3
-} from "@struktoai/mirage-core";
-var ENC4 = new TextEncoder();
-function dirnameOf(p) {
-  const trimmed = p.replace(/\/+$/, "");
-  const idx = trimmed.lastIndexOf("/");
-  if (idx === -1) return ".";
-  if (idx === 0) return "/";
-  return trimmed.slice(0, idx);
-}
-function dirnameCommand(_accessor, _paths, texts, _opts) {
-  const lines = texts.map((t) => dirnameOf(t));
-  const out = ENC4.encode(lines.join("\n") + "\n");
-  return [out, new IOResult3()];
-}
+import { ResourceName as ResourceName3, command as command3, specOf as specOf3, dirnameFn } from "@struktoai/mirage-core";
 var EMAIL_DIRNAME = command3({
   name: "dirname",
   resource: ResourceName3.EMAIL,
   spec: specOf3("dirname"),
-  fn: dirnameCommand
+  fn: dirnameFn
 });
 
 // src/commands/builtin/email/find.ts
 import {
-  IOResult as IOResult4,
+  IOResult,
   PathSpec,
   ResourceName as ResourceName4,
   command as command4,
-  specOf as specOf4
+  specOf as specOf4,
+  rstripSlash as rstripSlash2,
+  stripSlash as stripSlash4,
+  formatRecords
 } from "@struktoai/mirage-core";
-var ENC5 = new TextEncoder();
-function fnmatch2(name, pattern) {
-  const re = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\?/g, ".").replace(/\*/g, ".*");
-  return new RegExp(`^${re}$`).test(name);
-}
+import { fnmatch as fnmatch2 } from "@struktoai/mirage-core";
+import { findSizeMtimeError, invalidFindArg } from "@struktoai/mirage-core";
 async function walk(accessor, path, index, maxDepth, depth) {
   if (maxDepth !== null && depth > maxDepth) return [];
   let children;
@@ -667,7 +677,7 @@ async function walk(accessor, path, index, maxDepth, depth) {
   const results = [];
   for (const child of children) {
     const isFolder = child.endsWith("/");
-    const trimmed = isFolder ? child.replace(/\/+$/, "") : child;
+    const trimmed = isFolder ? rstripSlash2(child) : child;
     results.push(trimmed);
     if (isFolder) {
       const childSpec = new PathSpec({
@@ -696,13 +706,21 @@ async function findCommand(accessor, paths, _texts, opts) {
   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 = p0.stripPrefix.replace(/^\/+|\/+$/g, "");
+  const searchKey = stripSlash4(p0.stripPrefix);
   const baseDepth = searchKey === "" ? -1 : searchKey.split("/").length - 1;
   const results = [];
   for (const p of [...allPaths].sort()) {
     const stripped = p.startsWith(p0.prefix) ? p.slice(p0.prefix.length) : p;
-    const trimmed = stripped.replace(/^\/+|\/+$/g, "");
+    const trimmed = stripSlash4(stripped);
     const depth = trimmed === "" ? -1 : trimmed.split("/").length - (baseDepth + 2);
     if (minDepth !== null && depth < minDepth) continue;
     const entryName = p.split("/").pop() ?? p;
@@ -710,8 +728,8 @@ async function findCommand(accessor, paths, _texts, opts) {
     if (inameFlag !== null && !fnmatch2(entryName.toLowerCase(), inameFlag.toLowerCase())) continue;
     results.push(p);
   }
-  const out = ENC5.encode(results.join("\n"));
-  return [out, new IOResult4()];
+  const out = formatRecords(results);
+  return [out, new IOResult()];
 }
 var EMAIL_FIND = command4({
   name: "find",
@@ -724,7 +742,7 @@ var EMAIL_FIND = command4({
 // src/commands/builtin/email/email_forward.ts
 import {
   CommandSpec,
-  IOResult as IOResult5,
+  IOResult as IOResult2,
   OperandKind,
   Option,
   ResourceName as ResourceName5,
@@ -805,7 +823,7 @@ Subject: ${original.subject}
 }
 
 // src/commands/builtin/email/email_forward.ts
-var ENC6 = new TextEncoder();
+var ENC2 = new TextEncoder();
 var SPEC = new CommandSpec({
   options: [
     new Option({ long: "--uid", valueKind: OperandKind.TEXT }),
@@ -818,18 +836,18 @@ async function emailForwardCommand(accessor, _paths, _texts, opts) {
   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 IOResult5({ exitCode: 2, stderr: ENC6.encode("--uid is required\n") })];
+    return [null, new IOResult2({ exitCode: 2, stderr: ENC2.encode("--uid is required\n") })];
   }
   if (folder === "") {
-    return [null, new IOResult5({ exitCode: 2, stderr: ENC6.encode("--folder is required\n") })];
+    return [null, new IOResult2({ exitCode: 2, stderr: ENC2.encode("--folder is required\n") })];
   }
   if (to === "") {
-    return [null, new IOResult5({ exitCode: 2, stderr: ENC6.encode("--to is required\n") })];
+    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 = ENC6.encode(JSON.stringify(result));
-  return [out, new IOResult5()];
+  const out = ENC2.encode(JSON.stringify(result));
+  return [out, new IOResult2()];
 }
 var EMAIL_FORWARD = command5({
   name: "email-forward",
@@ -841,7 +859,7 @@ var EMAIL_FORWARD = command5({
 
 // src/commands/builtin/email/grep.ts
 import {
-  IOResult as IOResult6,
+  IOResult as IOResult3,
   PathSpec as PathSpec2,
   ResourceName as ResourceName6,
   command as command6,
@@ -852,83 +870,16 @@ import {
   grepStream,
   prefixAggregate,
   quietMatch,
-  resolveSource as resolveSource2,
+  resolveSource,
   specOf as specOf5,
-  yieldBytes
+  yieldBytes,
+  formatRecords as formatRecords2
 } from "@struktoai/mirage-core";
 
-// src/core/email/stat.ts
-import { FileStat, FileType } 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 enoent3(p) {
-  const e = new Error(`ENOENT: ${p}`);
-  e.code = "ENOENT";
-  return e;
-}
-async function stat(accessor, path, index) {
-  const prefix = path.prefix;
-  let p = path.original;
-  if (prefix !== "" && p.startsWith(prefix)) p = p.slice(prefix.length) || "/";
-  const key = p.replace(/^\/+|\/+$/g, "");
-  if (key === "") return new FileStat({ name: "/", type: FileType.DIRECTORY });
-  if (index === void 0) throw enoent3(path.original);
-  const virtualKey = prefix !== "" ? `${prefix}/${key}` : `/${key}`;
-  const result = await index.get(virtualKey);
-  if (result.entry === void 0 || result.entry === null) {
-    if (!key.includes("/")) {
-      const folders = await listFolders2(accessor);
-      if (folders.includes(key)) return new FileStat({ name: key, type: FileType.DIRECTORY });
-      throw enoent3(path.original);
-    }
-    throw enoent3(path.original);
-  }
-  const rt = result.entry.resourceType;
-  const vfsName = result.entry.vfsName !== "" ? result.entry.vfsName : result.entry.name;
-  if (rt === "email/folder") return new FileStat({ name: vfsName, type: FileType.DIRECTORY });
-  if (rt === "email/date") return new FileStat({ name: vfsName, type: FileType.DIRECTORY });
-  if (rt === "email/message") {
-    return new FileStat({
-      name: vfsName,
-      type: FileType.JSON,
-      size: result.entry.size,
-      extra: { uid: result.entry.id }
-    });
-  }
-  if (rt === "email/attachment_dir") {
-    return new FileStat({
-      name: vfsName,
-      type: FileType.DIRECTORY,
-      extra: { uid: result.entry.id }
-    });
-  }
-  if (rt === "email/attachment") {
-    return new FileStat({
-      name: vfsName,
-      type: guessType(vfsName),
-      size: result.entry.size,
-      extra: { attachment_id: result.entry.id }
-    });
-  }
-  return new FileStat({ name: vfsName, type: FileType.JSON, extra: { uid: result.entry.id } });
-}
-
 // src/core/email/scope.ts
+import { stripSlash as stripSlash5 } from "@struktoai/mirage-core";
 function detectScope(path) {
-  const key = path.stripPrefix.replace(/^\/+|\/+$/g, "");
+  const key = stripSlash5(path.stripPrefix);
   if (key === "") {
     return { useNative: false, folder: null, resourcePath: "/" };
   }
@@ -1013,7 +964,7 @@ async function searchAndFormat(accessor, scope, pattern, prefix, maxResults = nu
 }
 
 // src/commands/builtin/email/grep.ts
-var ENC7 = new TextEncoder();
+var ENC3 = new TextEncoder();
 var DEC = new TextDecoder("utf-8", { fatal: false });
 function parseFlags(flags) {
   const toInt = (v) => typeof v === "string" ? Number.parseInt(v, 10) : null;
@@ -1050,7 +1001,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 IOResult6({ exitCode: 2, stderr: ENC7.encode(`${msg}
+    return [null, new IOResult3({ exitCode: 2, stderr: ENC3.encode(`${msg}
 `) })];
   }
   const f = parseFlags(opts.flags);
@@ -1072,13 +1023,13 @@ 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 IOResult6({ exitCode: 1 })];
-        const out = ENC7.encode(lines.join("\n") + "\n");
-        return [out, new IOResult6()];
+        if (lines.length === 0) return [new Uint8Array(0), new IOResult3({ exitCode: 1 })];
+        const out = ENC3.encode(lines.join("\n") + "\n");
+        return [out, new IOResult3()];
       }
     }
     const resolved = await resolveGlob(accessor, paths, opts.index ?? void 0);
-    if (resolved.length === 0) return [new Uint8Array(0), new IOResult6({ exitCode: 1 })];
+    if (resolved.length === 0) return [new Uint8Array(0), new IOResult3({ exitCode: 1 })];
     const filePrefix = resolved[0]?.prefix ?? "";
     const readdirFn = async (path) => {
       const spec = new PathSpec2({
@@ -1110,7 +1061,7 @@ async function grepCommand(accessor, paths, texts, opts) {
     if (f.filesOnly) {
       const warnings = [];
       const firstResolved2 = resolved[0];
-      if (firstResolved2 === void 0) return [new Uint8Array(0), new IOResult6({ exitCode: 1 })];
+      if (firstResolved2 === void 0) return [new Uint8Array(0), new IOResult3({ exitCode: 1 })];
       const results = await grepFilesOnly(
         readdirFn,
         statFn,
@@ -1130,10 +1081,10 @@ async function grepCommand(accessor, paths, texts, opts) {
         },
         warnings
       );
-      const stderr = warnings.length > 0 ? ENC7.encode(warnings.join("\n")) : null;
-      if (results.length === 0) return [new Uint8Array(0), new IOResult6({ exitCode: 1, stderr })];
-      const out = ENC7.encode(results.join("\n"));
-      return [out, new IOResult6({ stderr })];
+      const stderr = warnings.length > 0 ? formatRecords2(warnings) : null;
+      if (results.length === 0) return [new Uint8Array(0), new IOResult3({ exitCode: 1, stderr })];
+      const out = formatRecords2(results);
+      return [out, new IOResult3({ stderr })];
     }
     const pat2 = compilePattern(pattern, f.ignoreCase, f.fixedString, f.wholeWord);
     if (resolved.length > 1) {
@@ -1149,37 +1100,37 @@ async function grepCommand(accessor, paths, texts, opts) {
           for (const h of hits) allResults.push(`${p.original}:${h}`);
         }
       }
-      if (allResults.length === 0) return [new Uint8Array(0), new IOResult6({ exitCode: 1 })];
-      const out = ENC7.encode(allResults.join("\n"));
-      return [out, new IOResult6()];
+      if (allResults.length === 0) return [new Uint8Array(0), new IOResult3({ exitCode: 1 })];
+      const out = formatRecords2(allResults);
+      return [out, new IOResult3()];
     }
     const firstResolved = resolved[0];
-    if (firstResolved === void 0) return [null, new IOResult6()];
+    if (firstResolved === void 0) return [null, new IOResult3()];
     const data = await read(accessor, firstResolved, opts.index ?? void 0);
     const source2 = yieldBytes(data);
     const stream2 = grepStream(source2, pat2, f);
     if (f.quiet) {
-      const io3 = new IOResult6({ exitCode: 1 });
+      const io3 = new IOResult3({ exitCode: 1 });
       return [quietMatch(stream2, io3), io3];
     }
-    const io2 = new IOResult6();
+    const io2 = new IOResult3();
     return [exitOnEmpty(stream2, io2), io2];
   }
   let source;
   try {
-    source = resolveSource2(opts.stdin, "grep: usage: grep [flags] pattern [path]");
+    source = resolveSource(opts.stdin, "grep: usage: grep [flags] pattern [path]");
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
-    return [null, new IOResult6({ exitCode: 2, stderr: ENC7.encode(`${msg}
+    return [null, new IOResult3({ exitCode: 2, stderr: ENC3.encode(`${msg}
 `) })];
   }
   const pat = compilePattern(pattern, f.ignoreCase, f.fixedString, f.wholeWord);
   const stream = grepStream(source, pat, f);
   if (f.quiet) {
-    const io2 = new IOResult6({ exitCode: 1 });
+    const io2 = new IOResult3({ exitCode: 1 });
     return [quietMatch(stream, io2), io2];
   }
-  const io = new IOResult6();
+  const io = new IOResult3();
   return [exitOnEmpty(stream, io), io];
 }
 var EMAIL_GREP = command6({
@@ -1193,43 +1144,23 @@ var EMAIL_GREP = command6({
 
 // src/commands/builtin/email/head.ts
 import {
-  IOResult as IOResult7,
   ResourceName as ResourceName7,
   command as command7,
-  readStdinAsync,
+  headGeneric,
   specOf as specOf6
 } from "@struktoai/mirage-core";
-var ENC8 = new TextEncoder();
-function headBytes(data, lines, bytesMode) {
-  if (bytesMode !== null) return data.slice(0, bytesMode);
-  let count = 0;
-  let end = 0;
-  for (let i = 0; i < data.byteLength && count < lines; i++) {
-    if (data[i] === 10) {
-      count += 1;
-      end = i + 1;
-    }
-  }
-  if (count < lines) return data;
-  return data.slice(0, end - 1);
-}
-async function headCommand(accessor, paths, _texts, opts) {
-  const lines = typeof opts.flags.n === "string" ? Number.parseInt(opts.flags.n, 10) : 10;
-  const bytesMode = typeof opts.flags.c === "string" ? Number.parseInt(opts.flags.c, 10) : null;
-  if (paths.length > 0) {
-    const resolved = await resolveGlob(accessor, paths, opts.index ?? void 0);
-    const first = resolved[0];
-    if (first === void 0) return [null, new IOResult7()];
-    const data = await read(accessor, first, opts.index ?? void 0);
-    const out2 = headBytes(data, lines, bytesMode);
-    return [out2, new IOResult7()];
-  }
-  const raw = await readStdinAsync(opts.stdin);
-  if (raw === null) {
-    return [null, new IOResult7({ exitCode: 1, stderr: ENC8.encode("head: missing operand\n") })];
-  }
-  const out = headBytes(raw, lines, bytesMode);
-  return [out, new IOResult7()];
+async function* emailStream2(accessor, p, index) {
+  yield await read(accessor, p, index);
+}
+async function headCommand(accessor, paths, texts, opts) {
+  const resolved = paths.length > 0 ? await resolveGlob(accessor, paths, opts.index ?? void 0) : [];
+  return headGeneric(
+    resolved,
+    texts,
+    opts,
+    (p) => stat(accessor, p, opts.index ?? void 0),
+    (p) => emailStream2(accessor, p, opts.index ?? void 0)
+  );
 }
 var EMAIL_HEAD = command7({
   name: "head",
@@ -1241,79 +1172,18 @@ var EMAIL_HEAD = command7({
 
 // src/commands/builtin/email/jq.ts
 import {
-  IOResult as IOResult8,
   ResourceName as ResourceName8,
   command as command8,
-  jqEval,
-  parseJsonAuto,
-  parseJsonPath,
-  readStdinAsync as readStdinAsync2,
+  jqGeneric,
   specOf as specOf7
 } from "@struktoai/mirage-core";
-var ENC9 = new TextEncoder();
-function formatResult(result, raw, compact) {
-  if (raw && typeof result === "string") return ENC9.encode(result + "\n");
-  const json = compact ? JSON.stringify(result) : JSON.stringify(result, null, 2);
-  return ENC9.encode(json + "\n");
-}
-function formatResults(results, raw, compact, spread) {
-  if (spread && Array.isArray(results)) {
-    const parts = [];
-    for (const item of results) parts.push(formatResult(item, raw, compact));
-    let total = 0;
-    for (const p of parts) total += p.byteLength;
-    const out = new Uint8Array(total);
-    let offset = 0;
-    for (const p of parts) {
-      out.set(p, offset);
-      offset += p.byteLength;
-    }
-    return out;
-  }
-  return formatResult(results, raw, compact);
+async function* emailStream3(accessor, p, index) {
+  yield await read(accessor, p, index);
 }
 async function jqCommand(accessor, paths, texts, opts) {
-  if (texts.length === 0 || texts[0] === void 0) {
-    return [
-      null,
-      new IOResult8({ exitCode: 2, stderr: ENC9.encode("jq: usage: jq EXPRESSION [path]\n") })
-    ];
-  }
-  const expression = texts[0];
-  const r = opts.flags.r === true;
-  const c = opts.flags.c === true;
-  const s = opts.flags.s === true;
-  const spread = expression.includes("[]");
-  if (paths.length > 0) {
-    const resolved = await resolveGlob(accessor, paths, opts.index ?? void 0);
-    const parts = [];
-    for (const p of resolved) {
-      const raw2 = await read(accessor, p, opts.index ?? void 0);
-      let data2 = parseJsonPath(raw2, p.original);
-      if (s) data2 = Array.isArray(data2) ? data2 : [data2];
-      const result3 = await jqEval(data2, expression.trim());
-      parts.push(formatResults(result3, r, c, spread));
-    }
-    let total = 0;
-    for (const part of parts) total += part.byteLength;
-    const out2 = new Uint8Array(total);
-    let offset = 0;
-    for (const part of parts) {
-      out2.set(part, offset);
-      offset += part.byteLength;
-    }
-    const result2 = out2;
-    return [result2, new IOResult8()];
-  }
-  const raw = await readStdinAsync2(opts.stdin);
-  if (raw === null) {
-    return [null, new IOResult8({ exitCode: 2, stderr: ENC9.encode("jq: missing input\n") })];
-  }
-  let data = parseJsonAuto(raw);
-  if (s && !Array.isArray(data)) data = [data];
-  const result = await jqEval(data, expression.trim());
-  const out = formatResults(result, r, c, spread);
-  return [out, new IOResult8()];
+  const resolved = paths.length > 0 ? await resolveGlob(accessor, paths, opts.index ?? void 0) : [];
+  const stream = (p) => emailStream3(accessor, p, opts.index ?? void 0);
+  return jqGeneric(resolved, texts, opts, stream);
 }
 var EMAIL_JQ = command8({
   name: "jq",
@@ -1324,138 +1194,31 @@ var EMAIL_JQ = command8({
 
 // src/commands/builtin/email/ls.ts
 import {
-  FileType as FileType2,
-  IOResult as IOResult9,
   PathSpec as PathSpec3,
   ResourceName as ResourceName9,
   command as command9,
-  humanSize,
+  lsGeneric,
   specOf as specOf8
 } from "@struktoai/mirage-core";
-var ENC10 = new TextEncoder();
-async function lsEntries(accessor, path, allFiles, sortBy, reverse, recursive, listDir, warnings, indexCache) {
-  if (listDir) {
-    const s = await stat(accessor, path, indexCache ?? void 0);
-    return [s];
-  }
-  let entries;
-  try {
-    entries = await readdir(accessor, path, indexCache ?? void 0);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    warnings.push(`ls: cannot access '${path.original}': ${msg}`);
-    return [];
-  }
-  const stats = [];
-  for (const entry of entries) {
-    try {
-      const eSpec = new PathSpec3({
-        original: entry,
-        directory: entry,
-        resolved: false,
-        prefix: path.prefix
-      });
-      const s = await stat(accessor, eSpec, indexCache ?? void 0);
-      if (!allFiles && s.name.startsWith(".")) continue;
-      stats.push(s);
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
-      warnings.push(`ls: cannot access '${entry}': ${msg}`);
-    }
-  }
-  if (sortBy === "size") {
-    stats.sort((a, b) => (a.size ?? 0) - (b.size ?? 0));
-    if (!reverse) stats.reverse();
-  } else {
-    stats.sort((a, b) => a.name.localeCompare(b.name));
-    if (reverse) stats.reverse();
-  }
-  if (recursive) {
-    const subEntries = [];
-    for (const s of stats) {
-      subEntries.push(s);
-      if (s.type === FileType2.DIRECTORY) {
-        const childPath = path.child(s.name);
-        const childSpec = new PathSpec3({
-          original: childPath,
-          directory: childPath,
-          resolved: false,
-          prefix: path.prefix
-        });
-        const sub = await lsEntries(
-          accessor,
-          childSpec,
-          allFiles,
-          sortBy,
-          reverse,
-          recursive,
-          false,
-          warnings,
-          indexCache
-        );
-        subEntries.push(...sub);
-      }
-    }
-    return subEntries;
-  }
-  return stats;
-}
 async function lsCommand(accessor, paths, _texts, opts) {
-  const resolved = await resolveGlob(accessor, paths, opts.index ?? void 0);
-  const targets = resolved.length > 0 ? resolved : [
-    new PathSpec3({
-      original: opts.cwd,
-      directory: opts.cwd,
-      resolved: false,
-      prefix: opts.mountPrefix ?? ""
-    })
-  ];
-  const long = opts.flags.args_l === true;
-  const allFiles = opts.flags.a === true || opts.flags.A === true;
-  const human = opts.flags.h === true;
-  const reverse = opts.flags.r === true;
-  const recursive = opts.flags.R === true;
-  const listDir = opts.flags.d === true;
-  const classify = opts.flags.F === true;
-  const sortBy = opts.flags.S === true ? "size" : "name";
-  const warnings = [];
-  const results = [];
-  for (const p of targets) {
-    let entries;
-    try {
-      entries = await lsEntries(
-        accessor,
-        p,
-        allFiles,
-        sortBy,
-        reverse,
-        recursive,
-        listDir,
-        warnings,
-        opts.index
-      );
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
-      warnings.push(`ls: cannot access '${p.original}': ${msg}`);
-      continue;
-    }
-    if (long) {
-      for (const e of entries) {
-        const sizeStr = human ? humanSize(e.size ?? 0) : String(e.size ?? 0);
-        results.push(`${e.type ?? "-"}	${sizeStr}	${e.modified ?? ""}	${e.name}`);
-      }
-    } else {
-      for (const e of entries) {
-        const isDir = classify && e.type === FileType2.DIRECTORY;
-        const name = isDir ? e.name + "/" : e.name;
-        results.push(name);
-      }
-    }
+  let workingPaths = paths;
+  if (workingPaths.length === 0) {
+    workingPaths = [
+      new PathSpec3({
+        original: opts.cwd,
+        directory: opts.cwd,
+        resolved: false,
+        prefix: opts.mountPrefix ?? ""
+      })
+    ];
   }
-  const stderr = warnings.length > 0 ? ENC10.encode(warnings.join("\n")) : null;
-  const exitCode = warnings.length > 0 && results.length === 0 ? 1 : 0;
-  const out = ENC10.encode(results.join("\n"));
-  return [out, new IOResult9({ stderr, exitCode })];
+  const resolved = await resolveGlob(accessor, workingPaths, opts.index ?? void 0);
+  return lsGeneric(
+    resolved,
+    opts,
+    (p) => readdir(accessor, p, opts.index ?? void 0),
+    (p) => stat(accessor, p, opts.index ?? void 0)
+  );
 }
 var EMAIL_LS = command9({
   name: "ls",
@@ -1467,78 +1230,36 @@ var EMAIL_LS = command9({
 
 // src/commands/builtin/email/nl.ts
 import {
-  IOResult as IOResult10,
   ResourceName as ResourceName10,
   command as command10,
-  readStdinAsync as readStdinAsync3,
+  nlGeneric,
   specOf as specOf9
 } from "@struktoai/mirage-core";
-var ENC11 = new TextEncoder();
-var DEC2 = new TextDecoder("utf-8", { fatal: false });
-function shouldNumber(line, mode, pattern) {
-  if (mode === "n") return false;
-  if (mode === "a") return true;
-  if (mode === "p" && pattern !== null) return pattern.test(line);
-  return line.trim() !== "";
-}
-function pad(n, width) {
-  const s = String(n);
-  return s.length >= width ? s : " ".repeat(width - s.length) + s;
+async function* emailStream4(accessor, p, index) {
+  yield await read(accessor, p, index);
 }
 async function nlCommand(accessor, paths, _texts, opts) {
-  const bRaw = typeof opts.flags.b === "string" ? opts.flags.b : "t";
-  let mode = bRaw;
-  let pattern = null;
-  if (bRaw.startsWith("p")) {
-    mode = "p";
-    pattern = new RegExp(bRaw.slice(1));
-  }
-  const start = typeof opts.flags.v === "string" ? Number.parseInt(opts.flags.v, 10) : 1;
-  const increment = typeof opts.flags.i === "string" ? Number.parseInt(opts.flags.i, 10) : 1;
-  const width = typeof opts.flags.w === "string" ? Number.parseInt(opts.flags.w, 10) : 6;
-  const separator = typeof opts.flags.s === "string" ? opts.flags.s : "	";
-  let raw = null;
-  if (paths.length > 0) {
-    const resolved = await resolveGlob(accessor, paths, opts.index ?? void 0);
-    const first = resolved[0];
-    if (first === void 0) return [null, new IOResult10()];
-    raw = await read(accessor, first, opts.index ?? void 0);
-  } else {
-    raw = await readStdinAsync3(opts.stdin);
-    if (raw === null) {
-      return [null, new IOResult10({ exitCode: 1, stderr: ENC11.encode("nl: missing operand\n") })];
-    }
-  }
-  let num = start;
-  const outLines = [];
-  for (const line of DEC2.decode(raw).split("\n")) {
-    if (shouldNumber(line, mode, pattern)) {
-      outLines.push(`${pad(num, width)}${separator}${line}`);
-      num += increment;
-    } else {
-      outLines.push(`${" ".repeat(width)}${separator}${line}`);
-    }
-  }
-  const out = ENC11.encode(outLines.join("\n") + "\n");
-  return [out, new IOResult10()];
+  const resolved = paths.length > 0 ? await resolveGlob(accessor, paths, opts.index ?? void 0) : [];
+  return nlGeneric(resolved, opts, (p) => emailStream4(accessor, p, opts.index ?? void 0));
 }
 var EMAIL_NL = command10({
   name: "nl",
   resource: ResourceName10.EMAIL,
   spec: specOf9("nl"),
-  fn: nlCommand
+  fn: nlCommand,
+  provision: fileReadProvision
 });
 
 // src/commands/builtin/email/email_read.ts
 import {
   CommandSpec as CommandSpec2,
-  IOResult as IOResult11,
+  IOResult as IOResult4,
   OperandKind as OperandKind2,
   Option as Option2,
   ResourceName as ResourceName11,
   command as command11
 } from "@struktoai/mirage-core";
-var ENC12 = new TextEncoder();
+var ENC4 = new TextEncoder();
 var SPEC2 = new CommandSpec2({
   options: [
     new Option2({ long: "--uid", valueKind: OperandKind2.TEXT }),
@@ -1549,14 +1270,14 @@ 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 IOResult11({ exitCode: 2, stderr: ENC12.encode("--uid is required\n") })];
+    return [null, new IOResult4({ exitCode: 2, stderr: ENC4.encode("--uid is required\n") })];
   }
   if (folder === "") {
-    return [null, new IOResult11({ exitCode: 2, stderr: ENC12.encode("--folder is required\n") })];
+    return [null, new IOResult4({ exitCode: 2, stderr: ENC4.encode("--folder is required\n") })];
   }
   const processed = await fetchMessage(accessor, folder, uid);
-  const out = ENC12.encode(JSON.stringify(processed));
-  return [out, new IOResult11()];
+  const out = ENC4.encode(JSON.stringify(processed));
+  return [out, new IOResult4()];
 }
 var EMAIL_READ = command11({
   name: "email-read",
@@ -1566,72 +1287,24 @@ var EMAIL_READ = command11({
 });
 
 // src/commands/builtin/email/realpath.ts
-import {
-  IOResult as IOResult12,
-  PathSpec as PathSpec4,
-  ResourceName as ResourceName12,
-  command as command12,
-  specOf as specOf10
-} from "@struktoai/mirage-core";
-var ENC13 = new TextEncoder();
-function normalize(p) {
-  const isAbs = p.startsWith("/");
-  const segments = p.split("/").filter((s) => s !== "" && s !== ".");
-  const out = [];
-  for (const s of segments) {
-    if (s === "..") {
-      if (out.length > 0) out.pop();
-      else if (!isAbs) out.push("..");
-    } else {
-      out.push(s);
-    }
-  }
-  const joined = out.join("/");
-  return isAbs ? "/" + joined : joined === "" ? "." : joined;
-}
-async function exists(accessor, path, index, prefix) {
-  try {
-    const spec = new PathSpec4({ original: path, directory: path, prefix });
-    await stat(accessor, spec, index ?? void 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
-async function realpathCommand(accessor, paths, _texts, opts) {
-  const prefix = opts.mountPrefix ?? "";
-  const e = opts.flags.e === true;
-  const lines = [];
-  for (const p of paths) {
-    const full = prefix !== "" ? prefix + p.original : p.original;
-    const resolved = normalize(full);
-    if (e && !await exists(accessor, resolved, opts.index, prefix)) {
-      const msg = `realpath: '${p.original}': No such file or directory
-`;
-      return [null, new IOResult12({ exitCode: 1, stderr: ENC13.encode(msg) })];
-    }
-    lines.push(resolved);
-  }
-  const out = ENC13.encode(lines.join("\n") + "\n");
-  return [out, new IOResult12()];
-}
+import { ResourceName as ResourceName12, command as command12, realpathGeneric, specOf as specOf10 } from "@struktoai/mirage-core";
 var EMAIL_REALPATH = command12({
   name: "realpath",
   resource: ResourceName12.EMAIL,
   spec: specOf10("realpath"),
-  fn: realpathCommand
+  fn: (accessor, paths, texts, opts) => realpathGeneric(paths, texts, opts, (p) => stat(accessor, p, opts.index ?? void 0))
 });
 
 // src/commands/builtin/email/email_reply.ts
 import {
   CommandSpec as CommandSpec3,
-  IOResult as IOResult13,
+  IOResult as IOResult5,
   OperandKind as OperandKind3,
   Option as Option3,
   ResourceName as ResourceName13,
   command as command13
 } from "@struktoai/mirage-core";
-var ENC14 = new TextEncoder();
+var ENC5 = new TextEncoder();
 var SPEC3 = new CommandSpec3({
   options: [
     new Option3({ long: "--uid", valueKind: OperandKind3.TEXT }),
@@ -1644,18 +1317,18 @@ async function emailReplyCommand(accessor, _paths, _texts, opts) {
   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 IOResult13({ exitCode: 2, stderr: ENC14.encode("--uid is required\n") })];
+    return [null, new IOResult5({ exitCode: 2, stderr: ENC5.encode("--uid is required\n") })];
   }
   if (folder === "") {
-    return [null, new IOResult13({ exitCode: 2, stderr: ENC14.encode("--folder is required\n") })];
+    return [null, new IOResult5({ exitCode: 2, stderr: ENC5.encode("--folder is required\n") })];
   }
   if (body === "") {
-    return [null, new IOResult13({ exitCode: 2, stderr: ENC14.encode("--body is required\n") })];
+    return [null, new IOResult5({ exitCode: 2, stderr: ENC5.encode("--body is required\n") })];
   }
   const original = await fetchMessage(accessor, folder, uid);
   const result = await replyMessage(accessor.config, original, body);
-  const out = ENC14.encode(JSON.stringify(result));
-  return [out, new IOResult13()];
+  const out = ENC5.encode(JSON.stringify(result));
+  return [out, new IOResult5()];
 }
 var EMAIL_REPLY = command13({
   name: "email-reply",
@@ -1668,13 +1341,13 @@ var EMAIL_REPLY = command13({
 // src/commands/builtin/email/email_reply_all.ts
 import {
   CommandSpec as CommandSpec4,
-  IOResult as IOResult14,
+  IOResult as IOResult6,
   OperandKind as OperandKind4,
   Option as Option4,
   ResourceName as ResourceName14,
   command as command14
 } from "@struktoai/mirage-core";
-var ENC15 = new TextEncoder();
+var ENC6 = new TextEncoder();
 var SPEC4 = new CommandSpec4({
   options: [
     new Option4({ long: "--uid", valueKind: OperandKind4.TEXT }),
@@ -1687,18 +1360,18 @@ async function emailReplyAllCommand(accessor, _paths, _texts, opts) {
   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 IOResult14({ exitCode: 2, stderr: ENC15.encode("--uid is required\n") })];
+    return [null, new IOResult6({ exitCode: 2, stderr: ENC6.encode("--uid is required\n") })];
   }
   if (folder === "") {
-    return [null, new IOResult14({ exitCode: 2, stderr: ENC15.encode("--folder is required\n") })];
+    return [null, new IOResult6({ exitCode: 2, stderr: ENC6.encode("--folder is required\n") })];
   }
   if (body === "") {
-    return [null, new IOResult14({ exitCode: 2, stderr: ENC15.encode("--body is required\n") })];
+    return [null, new IOResult6({ exitCode: 2, stderr: ENC6.encode("--body is required\n") })];
   }
   const original = await fetchMessage(accessor, folder, uid);
   const result = await replyAllMessage(accessor.config, original, body);
-  const out = ENC15.encode(JSON.stringify(result));
-  return [out, new IOResult14()];
+  const out = ENC6.encode(JSON.stringify(result));
+  return [out, new IOResult6()];
 }
 var EMAIL_REPLY_ALL = command14({
   name: "email-reply-all",
@@ -1710,48 +1383,23 @@ var EMAIL_REPLY_ALL = command14({
 
 // src/commands/builtin/email/rg.ts
 import {
-  IOResult as IOResult15,
-  PathSpec as PathSpec5,
+  IOResult as IOResult7,
   ResourceName as ResourceName15,
   command as command15,
   compilePattern as compilePattern2,
   grepLines as grepLines2,
-  readStdinAsync as readStdinAsync4,
+  rgGeneric,
   specOf as specOf11
 } from "@struktoai/mirage-core";
-var ENC16 = new TextEncoder();
-var DEC3 = new TextDecoder("utf-8", { fatal: false });
-async function collectFiles(accessor, path, index) {
-  if (path.original.endsWith(".json") || path.original.endsWith(".jsonl")) {
-    return [path.original];
-  }
-  let children;
-  try {
-    children = await readdir(accessor, path, index ?? void 0);
-  } catch {
-    return [];
-  }
-  const files = [];
-  for (const child of children) {
-    if (child.endsWith(".email.json")) {
-      files.push(child);
-    } else {
-      const childSpec = new PathSpec5({
-        original: child,
-        directory: child,
-        resolved: false,
-        prefix: path.prefix
-      });
-      files.push(...await collectFiles(accessor, childSpec, index));
-    }
-  }
-  return files;
+var ENC7 = new TextEncoder();
+async function* emailStream5(accessor, p, index) {
+  yield await read(accessor, p, index);
 }
 async function rgCommand(accessor, paths, texts, opts) {
   if (texts.length === 0 || texts[0] === void 0) {
     return [
       null,
-      new IOResult15({ exitCode: 2, stderr: ENC16.encode("rg: usage: rg [flags] pattern [path]\n") })
+      new IOResult7({ exitCode: 2, stderr: ENC7.encode("rg: usage: rg [flags] pattern [path]\n") })
     ];
   }
   const pattern = texts[0];
@@ -1764,7 +1412,6 @@ async function rgCommand(accessor, paths, texts, opts) {
   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 hidden = opts.flags.hidden === true;
   const pat = compilePattern2(pattern, ignoreCase, fixedString, wholeWord);
   const lineOpts = {
     invert,
@@ -1779,74 +1426,30 @@ async function rgCommand(accessor, paths, texts, opts) {
     if (first !== void 0) {
       const scope = detectScope(first);
       if (scope.useNative) {
-        const filePrefix2 = first.prefix !== "" ? first.prefix : "";
-        const pairs = await searchAndFormat(accessor, scope, pattern, filePrefix2, maxCount ?? 50);
-        const lines2 = [];
+        const filePrefix = first.prefix !== "" ? first.prefix : "";
+        const pairs = await searchAndFormat(accessor, scope, pattern, filePrefix, maxCount ?? 50);
+        const lines = [];
         for (const [vfsPath, msgText] of pairs) {
-          const matched2 = grepLines2(vfsPath, [msgText], pat, lineOpts);
-          for (const line of matched2) lines2.push(`${vfsPath}:${line}`);
+          const matched = grepLines2(vfsPath, [msgText], pat, lineOpts);
+          for (const line of matched) lines.push(`${vfsPath}:${line}`);
         }
-        if (lines2.length === 0) return [new Uint8Array(0), new IOResult15({ exitCode: 1 })];
-        const out3 = ENC16.encode(lines2.join("\n") + "\n");
-        return [out3, new IOResult15()];
-      }
-    }
-    const resolved = await resolveGlob(accessor, paths, opts.index ?? void 0);
-    const filePrefix = resolved[0]?.prefix ?? "";
-    const blobPaths = [];
-    for (const p of resolved) blobPaths.push(...await collectFiles(accessor, p, opts.index));
-    const sortedUnique = [...new Set(blobPaths)].sort();
-    const allResults = [];
-    let anyMatch = false;
-    for (const bp of sortedUnique) {
-      if (!hidden && bp.split("/").some((part) => part.startsWith("."))) continue;
-      let data;
-      try {
-        const spec = new PathSpec5({
-          original: bp,
-          directory: bp,
-          resolved: true,
-          prefix: filePrefix
-        });
-        data = await read(accessor, spec, opts.index ?? void 0);
-      } catch {
-        continue;
-      }
-      const text = DEC3.decode(data);
-      if (text === "") continue;
-      const lines2 = text.split("\n");
-      if (lines2.length > 0 && lines2[lines2.length - 1] === "") lines2.pop();
-      const matched2 = grepLines2(bp, lines2, pat, lineOpts);
-      if (matched2.length === 0) continue;
-      anyMatch = true;
-      if (filesOnly) {
-        allResults.push(bp);
-        continue;
-      }
-      if (countOnly) {
-        allResults.push(`${bp}:${String(matched2.length)}`);
-        continue;
+        if (lines.length === 0) return [new Uint8Array(0), new IOResult7({ exitCode: 1 })];
+        const out = ENC7.encode(lines.join("\n") + "\n");
+        return [out, new IOResult7()];
       }
-      for (const line of matched2) allResults.push(`${bp}:${line}`);
     }
-    if (!anyMatch) return [new Uint8Array(0), new IOResult15({ exitCode: 1 })];
-    const out2 = ENC16.encode(allResults.join("\n"));
-    return [out2, new IOResult15()];
   }
-  const raw = await readStdinAsync4(opts.stdin);
-  if (raw === null) {
-    return [
-      null,
-      new IOResult15({ exitCode: 2, stderr: ENC16.encode("rg: usage: rg [flags] pattern path\n") })
-    ];
-  }
-  const lines = DEC3.decode(raw).split("\n");
-  if (lines.length > 0 && lines[lines.length - 1] === "") lines.pop();
-  const matched = grepLines2("<stdin>", lines, pat, lineOpts);
-  if (matched.length === 0) return [new Uint8Array(0), new IOResult15({ exitCode: 1 })];
-  if (countOnly) return [ENC16.encode(String(matched.length)), new IOResult15()];
-  const out = ENC16.encode(matched.join("\n"));
-  return [out, new IOResult15()];
+  const resolved = paths.length > 0 ? await resolveGlob(accessor, paths, opts.index ?? void 0) : [];
+  const stat2 = (p) => stat(accessor, p, opts.index ?? void 0);
+  const readdir2 = (p) => readdir(accessor, p, opts.index ?? void 0);
+  return rgGeneric(
+    resolved,
+    texts,
+    opts,
+    stat2,
+    readdir2,
+    (p) => emailStream5(accessor, p, opts.index ?? void 0)
+  );
 }
 var EMAIL_RG = command15({
   name: "rg",
@@ -1858,13 +1461,13 @@ var EMAIL_RG = command15({
 // src/commands/builtin/email/email_send.ts
 import {
   CommandSpec as CommandSpec5,
-  IOResult as IOResult16,
+  IOResult as IOResult8,
   OperandKind as OperandKind5,
   Option as Option5,
   ResourceName as ResourceName16,
   command as command16
 } from "@struktoai/mirage-core";
-var ENC17 = new TextEncoder();
+var ENC8 = new TextEncoder();
 var SPEC5 = new CommandSpec5({
   options: [
     new Option5({ long: "--to", valueKind: OperandKind5.TEXT }),
@@ -1877,17 +1480,17 @@ async function emailSendCommand(accessor, _paths, _texts, opts) {
   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 IOResult16({ exitCode: 2, stderr: ENC17.encode("--to is required\n") })];
+    return [null, new IOResult8({ exitCode: 2, stderr: ENC8.encode("--to is required\n") })];
   }
   if (subject === "") {
-    return [null, new IOResult16({ exitCode: 2, stderr: ENC17.encode("--subject is required\n") })];
+    return [null, new IOResult8({ exitCode: 2, stderr: ENC8.encode("--subject is required\n") })];
   }
   if (body === "") {
-    return [null, new IOResult16({ exitCode: 2, stderr: ENC17.encode("--body is required\n") })];
+    return [null, new IOResult8({ exitCode: 2, stderr: ENC8.encode("--body is required\n") })];
   }
   const result = await sendMessage(accessor.config, to, subject, body);
-  const out = ENC17.encode(JSON.stringify(result));
-  return [out, new IOResult16()];
+  const out = ENC8.encode(JSON.stringify(result));
+  return [out, new IOResult8()];
 }
 var EMAIL_SEND = command16({
   name: "email-send",
@@ -1899,50 +1502,14 @@ var EMAIL_SEND = command16({
 
 // src/commands/builtin/email/stat.ts
 import {
-  FileType as FileType3,
-  IOResult as IOResult17,
   ResourceName as ResourceName17,
   command as command17,
-  specOf as specOf12
+  specOf as specOf12,
+  statGeneric
 } from "@struktoai/mirage-core";
-var ENC18 = new TextEncoder();
-var TYPE_LABELS = {
-  [FileType3.DIRECTORY]: "directory",
-  [FileType3.TEXT]: "regular file",
-  [FileType3.BINARY]: "regular file",
-  [FileType3.JSON]: "regular file",
-  [FileType3.CSV]: "regular file"
-};
-function formatStat(fmt, s) {
-  return fmt.replace(/%(.)/g, (_, spec) => {
-    if (spec === "n") return s.name;
-    if (spec === "s") return String(s.size ?? 0);
-    if (spec === "F")
-      return s.type !== null ? TYPE_LABELS[s.type] ?? "regular file" : "regular file";
-    if (spec === "y") return s.modified ?? "";
-    return "?";
-  });
-}
 async function statCommand(accessor, paths, _texts, opts) {
-  if (paths.length === 0) {
-    return [null, new IOResult17({ exitCode: 1, stderr: ENC18.encode("stat: missing operand\n") })];
-  }
-  const resolved = await resolveGlob(accessor, paths, opts.index ?? void 0);
-  const fmt = typeof opts.flags.c === "string" ? opts.flags.c : typeof opts.flags.f === "string" ? opts.flags.f : null;
-  const lines = [];
-  for (const p of resolved) {
-    const s = await stat(accessor, p, opts.index ?? void 0);
-    if (fmt !== null) {
-      lines.push(formatStat(fmt, s));
-    } else {
-      const sizeStr = s.size === null ? "None" : String(s.size);
-      const modStr = s.modified ?? "None";
-      const typeStr = s.type ?? "None";
-      lines.push(`name=${s.name} size=${sizeStr} modified=${modStr} type=${typeStr}`);
-    }
-  }
-  const out = ENC18.encode(lines.join("\n"));
-  return [out, new IOResult17()];
+  const resolved = paths.length > 0 ? await resolveGlob(accessor, paths, opts.index ?? void 0) : [];
+  return statGeneric(resolved, opts, (p) => stat(accessor, p, opts.index ?? void 0));
 }
 var EMAIL_STAT = command17({
   name: "stat",
@@ -1954,32 +1521,22 @@ var EMAIL_STAT = command17({
 
 // src/commands/builtin/email/tail.ts
 import {
-  IOResult as IOResult18,
   ResourceName as ResourceName18,
   command as command18,
-  parseN,
-  readStdinAsync as readStdinAsync5,
   specOf as specOf13,
-  tailBytes
+  tailGeneric
 } from "@struktoai/mirage-core";
-var ENC19 = new TextEncoder();
-async function tailCommand(accessor, paths, _texts, opts) {
-  const [lines, plusMode] = parseN(typeof opts.flags.n === "string" ? opts.flags.n : null);
-  const bytesMode = typeof opts.flags.c === "string" ? Number.parseInt(opts.flags.c, 10) : null;
-  if (paths.length > 0) {
-    const resolved = await resolveGlob(accessor, paths, opts.index ?? void 0);
-    const first = resolved[0];
-    if (first === void 0) return [null, new IOResult18()];
-    const raw2 = await read(accessor, first, opts.index ?? void 0);
-    const out2 = tailBytes(raw2, lines, bytesMode, plusMode);
-    return [out2, new IOResult18()];
-  }
-  const raw = await readStdinAsync5(opts.stdin);
-  if (raw === null) {
-    return [null, new IOResult18({ exitCode: 1, stderr: ENC19.encode("tail: missing operand\n") })];
-  }
-  const out = tailBytes(raw, lines, bytesMode, plusMode);
-  return [out, new IOResult18()];
+async function* emailStream6(accessor, p, index) {
+  yield await read(accessor, p, index);
+}
+async function tailCommand(accessor, paths, texts, opts) {
+  const resolved = paths.length > 0 ? await resolveGlob(accessor, paths, opts.index ?? void 0) : [];
+  return tailGeneric(
+    resolved,
+    texts,
+    opts,
+    (p) => emailStream6(accessor, p, opts.index ?? void 0)
+  );
 }
 var EMAIL_TAIL = command18({
   name: "tail",
@@ -1991,95 +1548,19 @@ var EMAIL_TAIL = command18({
 
 // src/commands/builtin/email/tree.ts
 import {
-  FileType as FileType4,
-  IOResult as IOResult19,
-  PathSpec as PathSpec6,
   ResourceName as ResourceName19,
   command as command19,
-  specOf as specOf14
+  specOf as specOf14,
+  treeGeneric
 } from "@struktoai/mirage-core";
-var ENC20 = new TextEncoder();
-function fnmatch3(name, pattern) {
-  const re = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\?/g, ".").replace(/\*/g, ".*");
-  return new RegExp(`^${re}$`).test(name);
-}
-async function treeRecurse(accessor, path, prefix, depth, treeOpts, warnings, indexCache) {
-  const lines = [];
-  let entries;
-  try {
-    entries = await readdir(accessor, path, indexCache ?? void 0);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    warnings.push(`tree: '${path.original}': ${msg}`);
-    return lines;
-  }
-  const filtered = [];
-  for (const entry of entries) {
-    try {
-      const entrySpec = new PathSpec6({
-        original: entry,
-        directory: entry,
-        resolved: false,
-        prefix: path.prefix
-      });
-      const s = await stat(accessor, entrySpec, indexCache ?? void 0);
-      if (!treeOpts.showHidden && s.name.startsWith(".")) continue;
-      if (treeOpts.ignorePattern !== null && fnmatch3(s.name, treeOpts.ignorePattern)) continue;
-      if (treeOpts.dirsOnly && s.type !== FileType4.DIRECTORY) continue;
-      const notDir = s.type !== FileType4.DIRECTORY;
-      if (treeOpts.matchPattern !== null && notDir && !fnmatch3(s.name, treeOpts.matchPattern))
-        continue;
-      filtered.push([entrySpec, s]);
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
-      warnings.push(`tree: '${entry}': ${msg}`);
-    }
-  }
-  for (let i = 0; i < filtered.length; i++) {
-    const pair = filtered[i];
-    if (pair === void 0) continue;
-    const [entrySpec, s] = pair;
-    const isLast = i === filtered.length - 1;
-    const connector = isLast ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 ";
-    lines.push(prefix + connector + s.name);
-    if (s.type === FileType4.DIRECTORY) {
-      if (treeOpts.maxDepth !== null && depth >= treeOpts.maxDepth) continue;
-      const extension = isLast ? "    " : "\u2502   ";
-      const sub = await treeRecurse(
-        accessor,
-        entrySpec,
-        prefix + extension,
-        depth + 1,
-        treeOpts,
-        warnings,
-        indexCache
-      );
-      lines.push(...sub);
-    }
-  }
-  return lines;
-}
 async function treeCommand(accessor, paths, _texts, opts) {
   const resolved = await resolveGlob(accessor, paths, opts.index ?? void 0);
-  const p0 = resolved[0] ?? new PathSpec6({
-    original: opts.cwd,
-    directory: opts.cwd,
-    resolved: false,
-    prefix: opts.mountPrefix ?? ""
-  });
-  const maxDepth = typeof opts.flags.L === "string" ? Number.parseInt(opts.flags.L, 10) : null;
-  const treeOpts = {
-    maxDepth,
-    showHidden: opts.flags.a === true,
-    ignorePattern: typeof opts.flags.args_I === "string" ? opts.flags.args_I : null,
-    dirsOnly: opts.flags.d === true,
-    matchPattern: typeof opts.flags.P === "string" ? opts.flags.P : null
-  };
-  const warnings = [];
-  const results = await treeRecurse(accessor, p0, "", 0, treeOpts, warnings, opts.index);
-  const out = ENC20.encode(results.join("\n"));
-  const stderr = warnings.length > 0 ? ENC20.encode(warnings.join("\n")) : null;
-  return [out, new IOResult19({ stderr })];
+  return treeGeneric(
+    resolved,
+    opts,
+    (p) => readdir(accessor, p, opts.index ?? void 0),
+    (p) => stat(accessor, p, opts.index ?? void 0)
+  );
 }
 var EMAIL_TREE = command19({
   name: "tree",
@@ -2091,13 +1572,13 @@ var EMAIL_TREE = command19({
 // src/commands/builtin/email/email_triage.ts
 import {
   CommandSpec as CommandSpec6,
-  IOResult as IOResult20,
+  IOResult as IOResult9,
   OperandKind as OperandKind6,
   Option as Option6,
   ResourceName as ResourceName20,
   command as command20
 } from "@struktoai/mirage-core";
-var ENC21 = new TextEncoder();
+var ENC9 = new TextEncoder();
 var SPEC6 = new CommandSpec6({
   options: [
     new Option6({ long: "--folder", valueKind: OperandKind6.TEXT }),
@@ -2129,12 +1610,12 @@ async function emailTriageCommand(accessor, _paths, _texts, opts) {
     maxResults
   );
   if (uids.length === 0) {
-    const out2 = ENC21.encode("[]");
-    return [out2, new IOResult20()];
+    const out2 = ENC9.encode("[]");
+    return [out2, new IOResult9()];
   }
   const headers = await fetchHeaders(accessor, folder, uids);
-  const out = ENC21.encode(JSON.stringify(headers));
-  return [out, new IOResult20()];
+  const out = ENC9.encode(JSON.stringify(headers));
+  return [out, new IOResult9()];
 }
 var EMAIL_TRIAGE = command20({
   name: "email-triage",
@@ -2145,58 +1626,17 @@ var EMAIL_TRIAGE = command20({
 
 // src/commands/builtin/email/wc.ts
 import {
-  IOResult as IOResult21,
   ResourceName as ResourceName21,
   command as command21,
-  readStdinAsync as readStdinAsync6,
-  specOf as specOf15
+  specOf as specOf15,
+  wcGeneric
 } from "@struktoai/mirage-core";
-var ENC22 = new TextEncoder();
-var DEC4 = new TextDecoder("utf-8", { fatal: false });
-function countLines(text) {
-  let n = 0;
-  for (let i = 0; i < text.length; i++) if (text.charCodeAt(i) === 10) n += 1;
-  return n;
-}
-function countWords(text) {
-  const trimmed = text.trim();
-  if (trimmed === "") return 0;
-  return trimmed.split(/\s+/).length;
-}
-function maxLineLen(text) {
-  let max = 0;
-  for (const line of text.split("\n")) if (line.length > max) max = line.length;
-  return max;
-}
-async function wcCommand(accessor, paths, _texts, opts) {
-  let data = null;
-  if (paths.length > 0) {
-    const resolved = await resolveGlob(accessor, paths, opts.index ?? void 0);
-    const first = resolved[0];
-    if (first === void 0) return [null, new IOResult21()];
-    data = await read(accessor, first, opts.index ?? void 0);
-  } else {
-    data = await readStdinAsync6(opts.stdin);
-    if (data === null) {
-      return [null, new IOResult21({ exitCode: 1, stderr: ENC22.encode("wc: missing operand\n") })];
-    }
-  }
-  const text = DEC4.decode(data);
-  const lineCount = countLines(text);
-  const wordCount = countWords(text);
-  const byteCount = data.byteLength;
-  if (opts.flags.L === true) {
-    const out2 = ENC22.encode(String(maxLineLen(text)));
-    return [out2, new IOResult21()];
-  }
-  if (opts.flags.args_l === true) return [ENC22.encode(String(lineCount)), new IOResult21()];
-  if (opts.flags.w === true) return [ENC22.encode(String(wordCount)), new IOResult21()];
-  if (opts.flags.m === true) return [ENC22.encode(String(text.length)), new IOResult21()];
-  if (opts.flags.c === true) return [ENC22.encode(String(byteCount)), new IOResult21()];
-  const out = ENC22.encode(
-    `${String(lineCount)}	${String(wordCount)}	${String(byteCount)}`
-  );
-  return [out, new IOResult21()];
+async function* emailStream7(accessor, p, index) {
+  yield await read(accessor, p, index);
+}
+async function wcCommand(accessor, paths, texts, opts) {
+  const resolved = paths.length > 0 ? await resolveGlob(accessor, paths, opts.index ?? void 0) : [];
+  return wcGeneric(resolved, texts, opts, (p) => emailStream7(accessor, p, opts.index ?? void 0));
 }
 var EMAIL_WC = command21({
   name: "wc",
@@ -2284,18 +1724,17 @@ var EMAIL_WRITE_PROMPT = `  Write commands:
     email-forward <email-path> "to@email.com"`;
 
 // src/resource/email/email.ts
-var EmailResource = class {
+var EmailResource = class extends BaseResource {
   kind = ResourceName25.EMAIL;
   isRemote = true;
   indexTtl = 86400;
   prompt = EMAIL_PROMPT;
   config;
   accessor;
-  index;
   constructor(config) {
+    super();
     this.config = config;
     this.accessor = new EmailAccessor(config);
-    this.index = new RAMIndexCacheStore({ ttl: 86400 });
   }
   open() {
     return Promise.resolve();
@@ -2324,7 +1763,7 @@ var EmailResource = class {
   }
   glob(paths, prefix = "") {
     const effective = prefix !== "" ? paths.map(
-      (p) => p.prefix !== "" ? p : new PathSpec7({
+      (p) => p.prefix !== "" ? p : new PathSpec4({
         original: p.original,
         directory: p.directory,
         ...p.pattern !== null ? { pattern: p.pattern } : {},
@@ -2337,8 +1776,6 @@ var EmailResource = class {
   getState() {
     return Promise.resolve({
       type: this.kind,
-      needsOverride: true,
-      redactedFields: ["password"],
       config: redactEmailConfig(this.config)
     });
   }
@@ -2355,4 +1792,4 @@ export {
   EMAIL_WRITE_PROMPT,
   EmailResource
 };
-//# sourceMappingURL=chunk-OYJXYJTE.js.map
+//# sourceMappingURL=chunk-DTAY7LPC.js.map