@struktoai/mirage-node 0.0.5 → 0.0.7-alpha.1

package/dist/resource/disk/disk.js

@@ -0,0 +1,218 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { chmod, mkdir, readdir, readFile, stat as fsStat, statfs as fsStatfs, writeFile, } from 'node:fs/promises';
+import path from 'node:path';
+import { makeResolveGlob } from '@struktoai/mirage-core/commands/builtin/generic_bind/index';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import { CapacityState, PathSpec, ResourceName } from '@struktoai/mirage-core/types';
+import { mountKey, mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { DISK_COMMANDS } from "../../commands/builtin/disk/index.js";
+import { appendBytes as appendCore } from "../../core/disk/append.js";
+import { SCOPE_ERROR } from "../../core/disk/constants.js";
+import { copy as copyCore } from "../../core/disk/copy.js";
+import { create as createCore } from "../../core/disk/create.js";
+import { size as duSizeCore, entries as duEntriesCore } from "../../core/disk/du/index.js";
+import { exists as existsCore } from "../../core/disk/exists.js";
+import { find as findCore } from "../../core/disk/find.js";
+import { mkdir as mkdirCore } from "../../core/disk/mkdir.js";
+import { read as readCoreFn } from "../../core/disk/read.js";
+import { readdir as readdirCore } from "../../core/disk/readdir.js";
+import { rename as renameCore } from "../../core/disk/rename.js";
+import { rmR as rmRCore } from "../../core/disk/rm.js";
+import { rmdir as rmdirCore } from "../../core/disk/rmdir.js";
+import { stat as statCore } from "../../core/disk/stat.js";
+import { stream as streamCore } from "../../core/disk/stream.js";
+import { truncate as truncateCore } from "../../core/disk/truncate.js";
+import { unlink as unlinkCore } from "../../core/disk/unlink.js";
+import { writeBytes as writeCore } from "../../core/disk/write.js";
+import { DiskAccessor } from "../../accessor/disk.js";
+import { DISK_OPS } from "../../ops/disk/index.js";
+import { DISK_PROMPT } from "./prompt.js";
+import {} from '@struktoai/mirage-core/watch/index';
+import { buildDeltaHook } from "../../core/disk/watch/index.js";
+const globCore = makeResolveGlob(readdirCore, SCOPE_ERROR);
+async function walkFiles(root, current, out) {
+    const entries = await readdir(current, { withFileTypes: true });
+    for (const e of entries) {
+        const child = path.join(current, e.name);
+        if (e.isDirectory()) {
+            await walkFiles(root, child, out);
+        }
+        else if (e.isFile()) {
+            out.push(child);
+        }
+    }
+}
+export class DiskResource extends BaseResource {
+    kind = ResourceName.DISK;
+    cachesReads = false;
+    // byte store: stat() sizes every file from metadata
+    sizesAlwaysKnown = true;
+    indexTtl = 60;
+    prompt = DISK_PROMPT;
+    root;
+    accessor;
+    opsMap = {
+        read_bytes: readCoreFn,
+        write: writeCore,
+        readdir: readdirCore,
+        stat: statCore,
+        unlink: unlinkCore,
+        rmdir: rmdirCore,
+        copy: copyCore,
+        rename: renameCore,
+        mkdir: mkdirCore,
+        read_stream: streamCore,
+        rm_recursive: rmRCore,
+        du_size: duSizeCore,
+        du_entries: duEntriesCore,
+        create: createCore,
+        truncate: truncateCore,
+        exists: existsCore,
+        find_flat: findCore,
+        append: appendCore,
+    };
+    constructor(options) {
+        super();
+        this.root = path.resolve(options.root);
+        this.accessor = new DiskAccessor(this.root);
+    }
+    // The resolved root is the storage: two DiskResources built on the same
+    // directory are one store, however they were spelled.
+    storageId() {
+        return `${this.kind}:${this.root}`;
+    }
+    async open() {
+        await mkdir(this.root, { recursive: true });
+    }
+    // A real filesystem reports real numbers (QUOTA). GNU df: used counts
+    // reserved blocks (blocks - bfree), available excludes them (bavail).
+    async statfs() {
+        const st = await fsStatfs(this.root);
+        const bsize = st.bsize;
+        return {
+            state: CapacityState.QUOTA,
+            total: st.blocks * bsize,
+            used: (st.blocks - st.bfree) * bsize,
+            available: st.bavail * bsize,
+            inodes: st.files,
+            inodesUsed: st.files - st.ffree,
+            inodesFree: st.ffree,
+        };
+    }
+    ops() {
+        return DISK_OPS;
+    }
+    commands() {
+        return DISK_COMMANDS;
+    }
+    streamPath(p) {
+        return streamCore(this.accessor, p);
+    }
+    readFile(p) {
+        return readCoreFn(this.accessor, p);
+    }
+    writeFile(p, data) {
+        return writeCore(this.accessor, p, data);
+    }
+    appendFile(p, data) {
+        return appendCore(this.accessor, p, data);
+    }
+    readdir(p) {
+        return readdirCore(this.accessor, p, this.index);
+    }
+    stat(p) {
+        return statCore(this.accessor, p);
+    }
+    exists(p) {
+        return existsCore(this.accessor, p);
+    }
+    mkdir(p, options) {
+        return mkdirCore(this.accessor, p, options?.recursive === true);
+    }
+    rmdir(p) {
+        return rmdirCore(this.accessor, p);
+    }
+    unlink(p) {
+        return unlinkCore(this.accessor, p);
+    }
+    rename(src, dst) {
+        return renameCore(this.accessor, src, dst);
+    }
+    truncate(p, length) {
+        return truncateCore(this.accessor, p, length);
+    }
+    copy(src, dst) {
+        return copyCore(this.accessor, src, dst);
+    }
+    rmR(p) {
+        return rmRCore(this.accessor, p);
+    }
+    du(p) {
+        return duSizeCore(this.accessor, p);
+    }
+    find(p, options = {}) {
+        return findCore(this.accessor, p, options);
+    }
+    deltaHook() {
+        return buildDeltaHook(this.accessor);
+    }
+    glob(paths, prefix = '') {
+        const effective = prefix
+            ? paths.map((p) => mountPrefixOf(p.virtual, p.resourcePath)
+                ? p
+                : new PathSpec({
+                    virtual: p.virtual,
+                    directory: p.directory,
+                    ...(p.pattern !== null ? { pattern: p.pattern } : {}),
+                    resolved: p.resolved,
+                    resourcePath: mountKey(p.virtual, prefix),
+                }))
+            : paths;
+        return globCore(this.accessor, effective, this.index);
+    }
+    async getState() {
+        await mkdir(this.root, { recursive: true });
+        const files = {};
+        const modes = {};
+        const fileList = [];
+        await walkFiles(this.root, this.root, fileList);
+        for (const full of fileList) {
+            const rel = path.relative(this.root, full).split(path.sep).join('/');
+            const data = await readFile(full);
+            files[rel] = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+            // Capture the real inode mode: it is the base truth for disk
+            // permissions (the sidecar is gone), so restore must reapply it or
+            // a chmod would reset to the host umask.
+            modes[rel] = (await fsStat(full)).mode & 0o7777;
+        }
+        return {
+            type: this.kind,
+            files,
+            modes,
+        };
+    }
+    async loadState(state) {
+        await mkdir(this.root, { recursive: true });
+        for (const [rel, data] of Object.entries(state.files)) {
+            const full = path.join(this.root, rel);
+            await mkdir(path.dirname(full), { recursive: true });
+            await writeFile(full, data);
+            const mode = state.modes?.[rel];
+            if (mode !== undefined)
+                await chmod(full, mode);
+        }
+    }
+}
+//# sourceMappingURL=disk.js.map

package/dist/resource/disk/disk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk.js","sourceRoot":"","sources":["../../../src/resource/disk/disk.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EACL,KAAK,EACL,KAAK,EACL,OAAO,EACP,QAAQ,EACR,IAAI,IAAI,MAAM,EACd,MAAM,IAAI,QAAQ,EAClB,SAAS,GACV,MAAM,kBAAkB,CAAA;AACzB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,4DAA4D,CAAA;AAG5F,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AAEnE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAEpF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAA;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAA;AACpE,OAAO,EAAE,WAAW,IAAI,UAAU,EAAE,MAAM,2BAA2B,CAAA;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC1D,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC1F,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAuC,MAAM,yBAAyB,CAAA;AAC/F,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACnE,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,GAAG,IAAI,OAAO,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,6BAA6B,CAAA;AACtE,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,UAAU,IAAI,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAkB,MAAM,oCAAoC,CAAA;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAE/D,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;AAY1D,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,OAAe,EAAE,GAAa;IACnE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;QACxC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACpB,MAAM,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;QACnC,CAAC;aAAM,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACtB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACjB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,OAAO,YAAa,SAAQ,YAAY;IACnC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAA;IACxB,WAAW,GAAY,KAAK,CAAA;IACrC,oDAAoD;IAC3C,gBAAgB,GAAY,IAAI,CAAA;IACvB,QAAQ,GAAW,EAAE,CAAA;IAC9B,MAAM,GAAG,WAAW,CAAA;IACpB,IAAI,CAAQ;IACZ,QAAQ,CAAc;IACtB,MAAM,GAA4B;QACzC,UAAU,EAAE,UAAU;QACtB,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,WAAW;QACpB,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,UAAU;QAClB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,UAAU;QAClB,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,UAAU;QACvB,YAAY,EAAE,OAAO;QACrB,OAAO,EAAE,UAAU;QACnB,UAAU,EAAE,aAAa;QACzB,MAAM,EAAE,UAAU;QAClB,QAAQ,EAAE,YAAY;QACtB,MAAM,EAAE,UAAU;QAClB,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,UAAU;KACnB,CAAA;IAED,YAAY,OAA4B;QACtC,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC7C,CAAC;IAED,wEAAwE;IACxE,sDAAsD;IAC7C,SAAS;QAChB,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAA;IACpC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7C,CAAC;IAED,sEAAsE;IACtE,sEAAsE;IAC7D,KAAK,CAAC,MAAM;QACnB,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAA;QACtB,OAAO;YACL,KAAK,EAAE,aAAa,CAAC,KAAK;YAC1B,KAAK,EAAE,EAAE,CAAC,MAAM,GAAG,KAAK;YACxB,IAAI,EAAE,CAAC,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK;YACpC,SAAS,EAAE,EAAE,CAAC,MAAM,GAAG,KAAK;YAC5B,MAAM,EAAE,EAAE,CAAC,KAAK;YAChB,UAAU,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,KAAK;YAC/B,UAAU,EAAE,EAAE,CAAC,KAAK;SACrB,CAAA;IACH,CAAC;IAED,GAAG;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,QAAQ;QACN,OAAO,aAAa,CAAA;IACtB,CAAC;IAED,UAAU,CAAC,CAAW;QACpB,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;IACrC,CAAC;IAED,QAAQ,CAAC,CAAW;QAClB,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;IACrC,CAAC;IAED,SAAS,CAAC,CAAW,EAAE,IAAgB;QACrC,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;IAC1C,CAAC;IAED,UAAU,CAAC,CAAW,EAAE,IAAgB;QACtC,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;IAC3C,CAAC;IAED,OAAO,CAAC,CAAW;QACjB,OAAO,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;IAClD,CAAC;IAED,IAAI,CAAC,CAAW;QACd,OAAO,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;IACnC,CAAC;IAED,MAAM,CAAC,CAAW;QAChB,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;IACrC,CAAC;IAED,KAAK,CAAC,CAAW,EAAE,OAAiC;QAClD,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,KAAK,IAAI,CAAC,CAAA;IACjE,CAAC;IAED,KAAK,CAAC,CAAW;QACf,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;IACpC,CAAC;IAED,MAAM,CAAC,CAAW;QAChB,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;IACrC,CAAC;IAED,MAAM,CAAC,GAAa,EAAE,GAAa;QACjC,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;IAC5C,CAAC;IAED,QAAQ,CAAC,CAAW,EAAE,MAAc;QAClC,OAAO,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,MAAM,CAAC,CAAA;IAC/C,CAAC;IAED,IAAI,CAAC,GAAa,EAAE,GAAa;QAC/B,OAAO,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;IAC1C,CAAC;IAED,GAAG,CAAC,CAAW;QACb,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;IAClC,CAAC;IAED,EAAE,CAAC,CAAW;QACZ,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;IACrC,CAAC;IAED,IAAI,CAAC,CAAW,EAAE,UAAuB,EAAE;QACzC,OAAO,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,OAA0B,CAAC,CAAA;IAC/D,CAAC;IAED,SAAS;QACP,OAAO,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACtC,CAAC;IAED,IAAI,CAAC,KAA0B,EAAE,MAAM,GAAG,EAAE;QAC1C,MAAM,SAAS,GAAG,MAAM;YACtB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACd,aAAa,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC;gBACtC,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,IAAI,QAAQ,CAAC;oBACX,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrD,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC;iBAC1C,CAAC,CACP;YACH,CAAC,CAAC,KAAK,CAAA;QACT,OAAO,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;IACvD,CAAC;IAEQ,KAAK,CAAC,QAAQ;QACrB,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC3C,MAAM,KAAK,GAA+B,EAAE,CAAA;QAC5C,MAAM,KAAK,GAA2B,EAAE,CAAA;QACxC,MAAM,QAAQ,GAAa,EAAE,CAAA;QAC7B,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QAC/C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACpE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAA;YACjC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;YAC1E,6DAA6D;YAC7D,mEAAmE;YACnE,yCAAyC;YACzC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAA;QACjD,CAAC;QACD,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK;YACL,KAAK;SACN,CAAA;IACH,CAAC;IAEQ,KAAK,CAAC,SAAS,CAAC,KAAwB;QAC/C,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;YACtC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YACpD,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;YAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAA;YAC/B,IAAI,IAAI,KAAK,SAAS;gBAAE,MAAM,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACjD,CAAC;IACH,CAAC;CACF"}

package/dist/resource/disk/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const DISK_PROMPT = "{prefix}\n  Local disk filesystem. Mirrors the configured root directory.\n  Standard commands: ls, cat, head, tail, grep, wc, find, tree, mkdir, touch, cp, mv, rm, tee.";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/resource/disk/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/resource/disk/prompt.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,WAAW,8KAEuE,CAAA"}

package/dist/resource/disk/prompt.js

@@ -0,0 +1,17 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+export const DISK_PROMPT = `{prefix}
+  Local disk filesystem. Mirrors the configured root directory.
+  Standard commands: ls, cat, head, tail, grep, wc, find, tree, mkdir, touch, cp, mv, rm, tee.`;
+//# sourceMappingURL=prompt.js.map

package/dist/resource/disk/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/resource/disk/prompt.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,MAAM,CAAC,MAAM,WAAW,GAAG;;+FAEoE,CAAA"}

package/dist/resource/dropbox/config.d.ts

@@ -0,0 +1,34 @@
+import { z } from '@struktoai/mirage-core/resource/secrets';
+import type { ConfigOf, RedactedConfig } from '@struktoai/mirage-core/resource/secrets';
+export interface DropboxConfig {
+    clientId: string;
+    clientSecret: string;
+    refreshToken: string;
+    rootPath?: string;
+    contentSearch?: boolean;
+    endpoint?: string;
+    refreshFn?: (refreshToken: string) => Promise<{
+        accessToken: string;
+        expiresIn: number;
+    }>;
+}
+declare const DropboxConfigSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    refreshToken: z.ZodString;
+    rootPath: z.ZodOptional<z.ZodString>;
+    contentSearch: z.ZodOptional<z.ZodBoolean>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    refreshFn: z.ZodOptional<z.ZodCustom<(refreshToken: string) => Promise<{
+        accessToken: string;
+        expiresIn: number;
+    }>, (refreshToken: string) => Promise<{
+        accessToken: string;
+        expiresIn: number;
+    }>>>;
+}, z.core.$strip>;
+export type DropboxConfigRedacted = RedactedConfig<ConfigOf<typeof DropboxConfigSchema>, 'clientSecret' | 'refreshToken' | 'refreshFn'>;
+export declare function redactDropboxConfig(config: DropboxConfig): DropboxConfigRedacted;
+export declare function normalizeDropboxConfig(input: Record<string, unknown>): DropboxConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/resource/dropbox/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/resource/dropbox/config.ts"],"names":[],"mappings":"AAcA,OAAO,EAKL,CAAC,EACF,MAAM,yCAAyC,CAAA;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AAEvF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC1F;AAED,QAAA,MAAM,mBAAmB;;;;;;;wDAHI,MAAM,KAAK,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,iBAA9D,MAAM,KAAK,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;iBAczF,CAAA;AAIF,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAChD,QAAQ,CAAC,OAAO,mBAAmB,CAAC,EACpC,cAAc,GAAG,cAAc,GAAG,WAAW,CAC9C,CAAA;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,qBAAqB,CAEhF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAEpF"}

package/dist/resource/dropbox/config.js

@@ -0,0 +1,31 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { parseConfigWithSchema, redactConfigWithSchema, secretSchema, secretStr, z, } from '@struktoai/mirage-core/resource/secrets';
+const DropboxConfigSchema = z.object({
+    clientId: z.string(),
+    clientSecret: secretStr(),
+    refreshToken: secretStr(),
+    rootPath: z.string().optional(),
+    contentSearch: z.boolean().optional(),
+    endpoint: z.string().optional(),
+    // Declared so parse keeps it, marked secret so no snapshot carries it.
+    refreshFn: secretSchema(z.custom((value) => typeof value === 'function')).optional(),
+});
+export function redactDropboxConfig(config) {
+    return redactConfigWithSchema(DropboxConfigSchema, config);
+}
+export function normalizeDropboxConfig(input) {
+    return parseConfigWithSchema(DropboxConfigSchema, input);
+}
+//# sourceMappingURL=config.js.map

package/dist/resource/dropbox/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/resource/dropbox/config.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,EACZ,SAAS,EACT,CAAC,GACF,MAAM,yCAAyC,CAAA;AAahD,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,YAAY,EAAE,SAAS,EAAE;IACzB,YAAY,EAAE,SAAS,EAAE;IACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,uEAAuE;IACvE,SAAS,EAAE,YAAY,CACrB,CAAC,CAAC,MAAM,CAA0C,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC,CAC1F,CAAC,QAAQ,EAAE;CACb,CAAC,CAAA;AASF,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,OAAO,sBAAsB,CAAC,mBAAmB,EAAE,MAAM,CAAqC,CAAA;AAChG,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAA8B;IACnE,OAAO,qBAAqB,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAA;AAC1D,CAAC"}

package/dist/resource/dropbox/dropbox.d.ts

@@ -0,0 +1,34 @@
+import { DropboxAccessor } from '@struktoai/mirage-core/accessor/dropbox';
+import type { RegisteredCommand } from '@struktoai/mirage-core/commands/config';
+import type { RegisteredOp } from '@struktoai/mirage-core/ops/registry';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import type { Resource } from '@struktoai/mirage-core/resource/base';
+import { PathSpec } from '@struktoai/mirage-core/types';
+import type { FileStat } from '@struktoai/mirage-core/types';
+import { type DropboxConfig, type DropboxConfigRedacted } from './config.ts';
+import { type DeltaHook } from '@struktoai/mirage-core/watch/index';
+export interface DropboxResourceState {
+    type: string;
+    config: DropboxConfigRedacted;
+}
+export declare class DropboxResource extends BaseResource implements Resource {
+    readonly kind: string;
+    readonly cachesReads: boolean;
+    readonly sizesAlwaysKnown: boolean;
+    readonly indexTtl: number;
+    readonly prompt: string;
+    readonly config: DropboxConfig;
+    readonly accessor: DropboxAccessor;
+    constructor(config: DropboxConfig);
+    open(): Promise<void>;
+    commands(): readonly RegisteredCommand[];
+    ops(): readonly RegisteredOp[];
+    readFile(p: PathSpec): Promise<Uint8Array>;
+    readdir(p: PathSpec): Promise<string[]>;
+    stat(p: PathSpec): Promise<FileStat>;
+    glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
+    deltaHook(): DeltaHook;
+    getState(): Promise<DropboxResourceState>;
+    loadState(_state: DropboxResourceState): Promise<void>;
+}
+//# sourceMappingURL=dropbox.d.ts.map

package/dist/resource/dropbox/dropbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dropbox.d.ts","sourceRoot":"","sources":["../../../src/resource/dropbox/dropbox.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAA;AAGzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAM/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAA;AAEpE,OAAO,EAAE,QAAQ,EAAgB,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,EAAuB,KAAK,aAAa,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEjG,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,oCAAoC,CAAA;AAInE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,qBAAqB,CAAA;CAC9B;AAED,qBAAa,eAAgB,SAAQ,YAAa,YAAW,QAAQ;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAuB;IAC5C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAO;IAGpC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAO;IACzC,SAAkB,QAAQ,EAAE,MAAM,CAAS;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAiB;IACxC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;gBAEtB,MAAM,EAAE,aAAa;IAWjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,QAAQ,IAAI,SAAS,iBAAiB,EAAE;IAIxC,GAAG,IAAI,SAAS,YAAY,EAAE;IAI9B,QAAQ,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAI1C,OAAO,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIvC,IAAI,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpC,IAAI,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAAE,MAAM,SAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAkBlE,SAAS,IAAI,SAAS;IAIb,QAAQ,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAOzC,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhE"}

package/dist/resource/dropbox/dropbox.js

@@ -0,0 +1,95 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { DropboxAccessor } from '@struktoai/mirage-core/accessor/dropbox';
+import { DROPBOX_COMMANDS } from '@struktoai/mirage-core/commands/builtin/dropbox/index';
+import { makeResolveGlob } from '@struktoai/mirage-core/commands/builtin/generic_bind/index';
+import { DropboxTokenManager } from '@struktoai/mirage-core/core/dropbox/client';
+import { read as dropboxRead } from '@struktoai/mirage-core/core/dropbox/read';
+import { readdir as dropboxReaddir } from '@struktoai/mirage-core/core/dropbox/readdir';
+import { stat as dropboxStat } from '@struktoai/mirage-core/core/dropbox/stat';
+import { DROPBOX_OPS } from '@struktoai/mirage-core/ops/dropbox/index';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import { DROPBOX_PROMPT } from '@struktoai/mirage-core/resource/dropbox/prompt';
+import { PathSpec, ResourceName } from '@struktoai/mirage-core/types';
+import { mountKey, mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { redactDropboxConfig } from "./config.js";
+import { buildDeltaHook } from '@struktoai/mirage-core/core/dropbox/watch';
+import {} from '@struktoai/mirage-core/watch/index';
+const dropboxResolveGlob = makeResolveGlob(dropboxReaddir);
+export class DropboxResource extends BaseResource {
+    kind = ResourceName.DROPBOX;
+    cachesReads = true;
+    // list_folder carries an exact byte `size` for every file (0 included).
+    // Paper docs 409 on raw download, a loud error, never a silent empty read.
+    sizesAlwaysKnown = true;
+    indexTtl = 86_400;
+    prompt = DROPBOX_PROMPT;
+    config;
+    accessor;
+    constructor(config) {
+        super();
+        this.config = config;
+        const tm = new DropboxTokenManager(config);
+        this.accessor = new DropboxAccessor({
+            tokenManager: tm,
+            ...(config.rootPath !== undefined ? { rootPath: config.rootPath } : {}),
+            ...(config.contentSearch !== undefined ? { contentSearch: config.contentSearch } : {}),
+        });
+    }
+    open() {
+        return Promise.resolve();
+    }
+    commands() {
+        return DROPBOX_COMMANDS;
+    }
+    ops() {
+        return DROPBOX_OPS;
+    }
+    readFile(p) {
+        return dropboxRead(this.accessor, p, this.index);
+    }
+    readdir(p) {
+        return dropboxReaddir(this.accessor, p, this.index);
+    }
+    stat(p) {
+        return dropboxStat(this.accessor, p, this.index);
+    }
+    glob(paths, prefix = '') {
+        const effective = prefix !== ''
+            ? paths.map((p) => mountPrefixOf(p.virtual, p.resourcePath) !== ''
+                ? p
+                : new PathSpec({
+                    virtual: p.virtual,
+                    directory: p.directory,
+                    ...(p.pattern !== null ? { pattern: p.pattern } : {}),
+                    resolved: p.resolved,
+                    resourcePath: mountKey(p.virtual, prefix),
+                }))
+            : paths;
+        return dropboxResolveGlob(this.accessor, effective, this.index);
+    }
+    deltaHook() {
+        return buildDeltaHook(this.accessor);
+    }
+    getState() {
+        return Promise.resolve({
+            type: this.kind,
+            config: redactDropboxConfig(this.config),
+        });
+    }
+    loadState(_state) {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=dropbox.js.map

package/dist/resource/dropbox/dropbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dropbox.js","sourceRoot":"","sources":["../../../src/resource/dropbox/dropbox.ts"],"names":[],"mappings":"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"}

package/dist/resource/email/email.d.ts

@@ -0,0 +1,33 @@
+import type { RegisteredCommand } from '@struktoai/mirage-core/commands/config';
+import type { RegisteredOp } from '@struktoai/mirage-core/ops/registry';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import type { Resource } from '@struktoai/mirage-core/resource/base';
+import { PathSpec } from '@struktoai/mirage-core/types';
+import type { FileStat } from '@struktoai/mirage-core/types';
+import { EmailAccessor } from '../../accessor/email.ts';
+import { type EmailConfig, type EmailConfigRedacted } from '../../core/email/config.ts';
+export interface EmailResourceState {
+    type: string;
+    config: EmailConfigRedacted;
+}
+export declare class EmailResource extends BaseResource implements Resource {
+    readonly kind: string;
+    readonly cachesReads: boolean;
+    readonly sizesAlwaysKnown: boolean;
+    readonly indexTtl: number;
+    readonly prompt: string;
+    readonly config: EmailConfig;
+    readonly accessor: EmailAccessor;
+    constructor(config: EmailConfig);
+    open(): Promise<void>;
+    close(): Promise<void>;
+    commands(): readonly RegisteredCommand[];
+    ops(): readonly RegisteredOp[];
+    readFile(p: PathSpec): Promise<Uint8Array>;
+    readdir(p: PathSpec): Promise<string[]>;
+    stat(p: PathSpec): Promise<FileStat>;
+    glob(paths: readonly PathSpec[], prefix?: string): Promise<PathSpec[]>;
+    getState(): Promise<EmailResourceState>;
+    loadState(_state: EmailResourceState): Promise<void>;
+}
+//# sourceMappingURL=email.d.ts.map

package/dist/resource/email/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../../src/resource/email/email.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAA;AACpE,OAAO,EAAE,QAAQ,EAAgB,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAMvD,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACzB,MAAM,4BAA4B,CAAA;AAKnC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,mBAAmB,CAAA;CAC5B;AAED,qBAAa,aAAc,SAAQ,YAAa,YAAW,QAAQ;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAqB;IAC1C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAO;IAIpC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAO;IACzC,SAAkB,QAAQ,EAAE,MAAM,CAAS;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAe;IACtC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;gBAEpB,MAAM,EAAE,WAAW;IAM/B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIN,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrC,QAAQ,IAAI,SAAS,iBAAiB,EAAE;IAIxC,GAAG,IAAI,SAAS,YAAY,EAAE;IAI9B,QAAQ,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAI1C,OAAO,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIvC,IAAI,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpC,IAAI,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAAE,MAAM,SAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAkBzD,QAAQ,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAOvC,SAAS,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9D"}

package/dist/resource/email/email.js

@@ -0,0 +1,89 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { makeResolveGlob } from '@struktoai/mirage-core/commands/builtin/generic_bind/index';
+import { BaseResource } from '@struktoai/mirage-core/resource/base';
+import { PathSpec, ResourceName } from '@struktoai/mirage-core/types';
+import { mountKey, mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { EmailAccessor } from "../../accessor/email.js";
+import { EMAIL_COMMANDS } from "../../commands/builtin/email/index.js";
+import { read as emailRead } from "../../core/email/read.js";
+import { readdir as emailReaddir } from "../../core/email/readdir.js";
+import { stat as emailStat } from "../../core/email/stat.js";
+import { EMAIL_OPS } from "../../ops/email/index.js";
+import { redactEmailConfig, } from "../../core/email/config.js";
+import { EMAIL_PROMPT } from "./prompt.js";
+const resolveGlob = makeResolveGlob(emailReaddir);
+export class EmailResource extends BaseResource {
+    kind = ResourceName.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 = 86_400;
+    prompt = EMAIL_PROMPT;
+    config;
+    accessor;
+    constructor(config) {
+        super();
+        this.config = config;
+        this.accessor = new EmailAccessor(config);
+    }
+    open() {
+        return Promise.resolve();
+    }
+    async close() {
+        await this.accessor.close();
+        await super.close();
+    }
+    commands() {
+        return EMAIL_COMMANDS;
+    }
+    ops() {
+        return EMAIL_OPS;
+    }
+    readFile(p) {
+        return emailRead(this.accessor, p, this.index);
+    }
+    readdir(p) {
+        return emailReaddir(this.accessor, p, this.index);
+    }
+    stat(p) {
+        return emailStat(this.accessor, p, this.index);
+    }
+    glob(paths, prefix = '') {
+        const effective = prefix !== ''
+            ? paths.map((p) => mountPrefixOf(p.virtual, p.resourcePath) !== ''
+                ? p
+                : new PathSpec({
+                    virtual: p.virtual,
+                    directory: p.directory,
+                    ...(p.pattern !== null ? { pattern: p.pattern } : {}),
+                    resolved: p.resolved,
+                    resourcePath: mountKey(p.virtual, prefix),
+                }))
+            : paths;
+        return resolveGlob(this.accessor, effective, this.index);
+    }
+    getState() {
+        return Promise.resolve({
+            type: this.kind,
+            config: redactEmailConfig(this.config),
+        });
+    }
+    loadState(_state) {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=email.js.map

package/dist/resource/email/email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.js","sourceRoot":"","sources":["../../../src/resource/email/email.ts"],"names":[],"mappings":"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"}

package/dist/resource/email/index.d.ts

@@ -0,0 +1,3 @@
+export { buildEmailConfig, normalizeEmailConfig, redactEmailConfig, type EmailConfig, type EmailConfigInput, type EmailConfigRedacted, } from '../../core/email/config.ts';
+export { EMAIL_PROMPT, EMAIL_WRITE_PROMPT } from './prompt.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/resource/email/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resource/email/index.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA"}

package/dist/resource/email/index.js

@@ -0,0 +1,16 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+export { buildEmailConfig, normalizeEmailConfig, redactEmailConfig, } from "../../core/email/config.js";
+export { EMAIL_PROMPT, EMAIL_WRITE_PROMPT } from "./prompt.js";
+//# sourceMappingURL=index.js.map