@mastra/archil 0.2.0 → 0.2.1-alpha.0

package/dist/index.js

@@ -1,488 +1,441 @@
-import { MastraFilesystem, FileNotFoundError, FileExistsError } from '@mastra/core/workspace';
-import { Archil } from 'disk';
-
-// src/filesystem.ts
-var MIME_TYPES = {
-  ".txt": "text/plain",
-  ".md": "text/markdown",
-  ".html": "text/html",
-  ".css": "text/css",
-  ".csv": "text/csv",
-  ".xml": "text/xml",
-  ".js": "text/javascript",
-  ".mjs": "text/javascript",
-  ".ts": "text/typescript",
-  ".tsx": "text/typescript",
-  ".jsx": "text/javascript",
-  ".json": "application/json",
-  ".yaml": "text/yaml",
-  ".yml": "text/yaml",
-  ".py": "text/x-python",
-  ".sh": "text/x-shellscript",
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".gif": "image/gif",
-  ".svg": "image/svg+xml",
-  ".webp": "image/webp",
-  ".pdf": "application/pdf",
-  ".zip": "application/zip",
-  ".gz": "application/gzip",
-  ".tar": "application/x-tar"
+import { FileExistsError, FileNotFoundError, MastraFilesystem } from "@mastra/core/workspace";
+import { Archil } from "disk";
+//#region src/filesystem.ts
+const MIME_TYPES = {
+	".txt": "text/plain",
+	".md": "text/markdown",
+	".html": "text/html",
+	".css": "text/css",
+	".csv": "text/csv",
+	".xml": "text/xml",
+	".js": "text/javascript",
+	".mjs": "text/javascript",
+	".ts": "text/typescript",
+	".tsx": "text/typescript",
+	".jsx": "text/javascript",
+	".json": "application/json",
+	".yaml": "text/yaml",
+	".yml": "text/yaml",
+	".py": "text/x-python",
+	".sh": "text/x-shellscript",
+	".png": "image/png",
+	".jpg": "image/jpeg",
+	".jpeg": "image/jpeg",
+	".gif": "image/gif",
+	".svg": "image/svg+xml",
+	".webp": "image/webp",
+	".pdf": "application/pdf",
+	".zip": "application/zip",
+	".gz": "application/gzip",
+	".tar": "application/x-tar"
 };
 function getMimeType(path) {
-  const ext = path.toLowerCase().match(/\.[^.]+$/)?.[0];
-  return ext ? MIME_TYPES[ext] ?? "application/octet-stream" : "application/octet-stream";
+	const ext = path.toLowerCase().match(/\.[^.]+$/)?.[0];
+	return ext ? MIME_TYPES[ext] ?? "application/octet-stream" : "application/octet-stream";
 }
+/** Trim leading and trailing slashes. */
 function trimSlashes(s) {
-  let start = 0;
-  let end = s.length;
-  while (start < end && s[start] === "/") start++;
-  while (end > start && s[end - 1] === "/") end--;
-  return s.slice(start, end);
+	let start = 0;
+	let end = s.length;
+	while (start < end && s[start] === "/") start++;
+	while (end > start && s[end - 1] === "/") end--;
+	return s.slice(start, end);
 }
+/** Normalize a workspace path to a key (no leading slash). */
 function toKey(path) {
-  return trimSlashes(path) || "";
+	return trimSlashes(path) || "";
 }
+/** Get the basename from a path. */
 function basename(path) {
-  const key = toKey(path);
-  const idx = key.lastIndexOf("/");
-  return idx === -1 ? key : key.slice(idx + 1);
+	const key = toKey(path);
+	const idx = key.lastIndexOf("/");
+	return idx === -1 ? key : key.slice(idx + 1);
 }
+/** Get the parent directory key (empty = root). */
 function dirname(path) {
-  const key = toKey(path);
-  const idx = key.lastIndexOf("/");
-  return idx === -1 ? "" : key.slice(0, idx);
+	const key = toKey(path);
+	const idx = key.lastIndexOf("/");
+	return idx === -1 ? "" : key.slice(0, idx);
 }
+/** Shell-escape a string for use in exec commands. */
 function shellEscape(s) {
-  return "'" + s.replace(/'/g, "'\\''") + "'";
+	return "'" + s.replace(/'/g, "'\\''") + "'";
 }
 var ArchilFilesystem = class extends MastraFilesystem {
-  id;
-  name = "ArchilFilesystem";
-  provider = "archil";
-  readOnly;
-  displayName;
-  icon;
-  description;
-  status = "pending";
-  _disk = null;
-  _archil = null;
-  _diskId;
-  _createDiskOptions;
-  _archilOptions;
-  constructor(options) {
-    super({ ...options, name: "ArchilFilesystem" });
-    this.id = options.id ?? `archil-fs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
-    this.readOnly = options.readOnly;
-    this.displayName = options.displayName ?? "Archil";
-    this.icon = options.icon ?? "cloud";
-    this.description = options.description ?? "Elastic serverless filesystem powered by Archil";
-    this._diskId = options.diskId;
-    this._createDiskOptions = options.createDiskOptions;
-    this._archilOptions = {
-      apiKey: options.apiKey,
-      region: options.region,
-      baseUrl: options.baseUrl,
-      s3BaseUrl: options.s3BaseUrl
-    };
-  }
-  // ---------------------------------------------------------------------------
-  // Public accessors
-  // ---------------------------------------------------------------------------
-  /** The underlying Archil Disk instance (available after init). */
-  get disk() {
-    if (!this._disk) {
-      throw new Error("ArchilFilesystem not initialized \u2014 call init() first");
-    }
-    return this._disk;
-  }
-  /** The Archil SDK client instance. */
-  get archil() {
-    if (!this._archil) {
-      this._archil = new Archil(this._archilOptions);
-    }
-    return this._archil;
-  }
-  // ---------------------------------------------------------------------------
-  // Lifecycle
-  // ---------------------------------------------------------------------------
-  async init() {
-    try {
-      if (this._diskId && this._createDiskOptions) {
-        throw new Error("diskId and createDiskOptions are mutually exclusive");
-      }
-      if (this._diskId) {
-        this._disk = await this.archil.disks.get(this._diskId);
-      } else if (this._createDiskOptions) {
-        const result = await this.archil.disks.create(this._createDiskOptions);
-        this._disk = result.disk;
-      } else {
-        throw new Error("Either diskId or createDiskOptions must be provided");
-      }
-      this.status = "ready";
-    } catch (err) {
-      this.status = "error";
-      this.error = err instanceof Error ? err.message : String(err);
-      throw err;
-    }
-  }
-  async destroy() {
-    this._disk = null;
-    this._archil = null;
-  }
-  isReady() {
-    return this.status === "ready" && this._disk !== null;
-  }
-  getInfo() {
-    return {
-      id: this.id,
-      name: this.name,
-      provider: this.provider,
-      status: this.status,
-      error: this.error,
-      readOnly: this.readOnly,
-      icon: this.icon,
-      metadata: {
-        diskId: this._disk?.id ?? "",
-        region: this._disk?.region ?? "",
-        diskName: this._disk?.name ?? ""
-      }
-    };
-  }
-  getInstructions() {
-    const access = this.readOnly ? "Read-only" : "Persistent";
-    const diskName = this._disk?.name ?? "Archil disk";
-    return `Archil elastic filesystem "${diskName}". ${access} storage \u2014 files persist across sessions. Supports serverless execution via exec().`;
-  }
-  // ---------------------------------------------------------------------------
-  // Archil-specific operations
-  // ---------------------------------------------------------------------------
-  /**
-   * Execute a shell command on the disk's filesystem.
-   * The disk is mounted as the working directory.
-   */
-  async exec(command) {
-    await this.ensureReady();
-    this.assertWritable();
-    return this.disk.exec(command);
-  }
-  /**
-   * Parallel grep across files on the disk.
-   */
-  async grep(opts) {
-    await this.ensureReady();
-    return this.disk.grep(opts);
-  }
-  /**
-   * Create a signed, time-limited download URL for a file.
-   */
-  async share(key, opts) {
-    await this.ensureReady();
-    return this.disk.share(key, opts);
-  }
-  /**
-   * List objects using the S3-compatible API directly.
-   */
-  async listObjects(prefix, opts) {
-    await this.ensureReady();
-    return this.disk.listObjects(prefix, opts);
-  }
-  /**
-   * Get object metadata without downloading.
-   */
-  async headObject(key) {
-    await this.ensureReady();
-    return this.disk.headObject(key);
-  }
-  // ---------------------------------------------------------------------------
-  // File Operations (WorkspaceFilesystem interface)
-  // ---------------------------------------------------------------------------
-  async readFile(path, options) {
-    await this.ensureReady();
-    const key = toKey(path);
-    if (!key) {
-      throw new Error("Cannot read file at root path");
-    }
-    try {
-      const data = await this.disk.getObject(key);
-      if (options?.encoding) {
-        return Buffer.from(data).toString(options.encoding);
-      }
-      return Buffer.from(data);
-    } catch (err) {
-      if (isNotFound(err)) {
-        throw new FileNotFoundError(path);
-      }
-      throw err;
-    }
-  }
-  async writeFile(path, content, options) {
-    await this.ensureReady();
-    this.assertWritable();
-    const key = toKey(path);
-    if (!key) {
-      throw new Error("Cannot write file at root path");
-    }
-    if (options?.overwrite === false) {
-      const exists = await this.disk.objectExists(key);
-      if (exists) {
-        throw new FileExistsError(path);
-      }
-    }
-    if (options?.recursive) {
-      const dir = dirname(path);
-      if (dir) {
-        await this.disk.exec(`mkdir -p ${shellEscape(dir)}`);
-      }
-    }
-    const body = typeof content === "string" ? content : content instanceof Uint8Array ? content : new Uint8Array(content);
-    const mimeType = options?.mimeType ?? getMimeType(path);
-    await this.disk.putObject(key, body, mimeType);
-  }
-  async appendFile(path, content) {
-    await this.ensureReady();
-    this.assertWritable();
-    const key = toKey(path);
-    if (!key) {
-      throw new Error("Cannot append to root path");
-    }
-    const data = typeof content === "string" ? content : Buffer.from(content).toString("base64");
-    if (typeof content === "string") {
-      await this.disk.exec(`printf '%s' ${shellEscape(data)} >> ${shellEscape(key)}`);
-    } else {
-      await this.disk.exec(`printf '%s' ${shellEscape(data)} | base64 -d >> ${shellEscape(key)}`);
-    }
-  }
-  async deleteFile(path, options) {
-    await this.ensureReady();
-    this.assertWritable();
-    const key = toKey(path);
-    if (!key) {
-      throw new Error("Cannot delete root path");
-    }
-    if (!options?.force) {
-      const exists = await this.disk.objectExists(key);
-      if (!exists) {
-        throw new FileNotFoundError(path);
-      }
-    }
-    await this.disk.deleteObject(key);
-  }
-  async copyFile(src, dest, options) {
-    await this.ensureReady();
-    this.assertWritable();
-    const srcKey = toKey(src);
-    const destKey = toKey(dest);
-    if (!options?.overwrite) {
-      const exists = await this.disk.objectExists(destKey);
-      if (exists) {
-        throw new FileExistsError(dest);
-      }
-    }
-    const flags = options?.recursive ? "-r" : "";
-    const result = await this.disk.exec(`cp ${flags} ${shellEscape(srcKey)} ${shellEscape(destKey)}`);
-    if (result.exitCode !== 0) {
-      if (result.stderr.includes("No such file")) {
-        throw new FileNotFoundError(src);
-      }
-      throw new Error(`cp failed: ${result.stderr}`);
-    }
-  }
-  async moveFile(src, dest, options) {
-    await this.ensureReady();
-    this.assertWritable();
-    const srcKey = toKey(src);
-    const destKey = toKey(dest);
-    if (!options?.overwrite) {
-      const exists = await this.disk.objectExists(destKey);
-      if (exists) {
-        throw new FileExistsError(dest);
-      }
-    }
-    const result = await this.disk.exec(`mv ${shellEscape(srcKey)} ${shellEscape(destKey)}`);
-    if (result.exitCode !== 0) {
-      if (result.stderr.includes("No such file")) {
-        throw new FileNotFoundError(src);
-      }
-      throw new Error(`mv failed: ${result.stderr}`);
-    }
-  }
-  // ---------------------------------------------------------------------------
-  // Directory Operations
-  // ---------------------------------------------------------------------------
-  async mkdir(path, options) {
-    await this.ensureReady();
-    this.assertWritable();
-    const key = toKey(path);
-    if (!key) return;
-    const flag = options?.recursive ? "-p" : "";
-    const result = await this.disk.exec(`mkdir ${flag} ${shellEscape(key)}`);
-    if (result.exitCode !== 0) {
-      if (result.stderr.includes("File exists")) {
-        throw new FileExistsError(path);
-      }
-      throw new Error(`mkdir failed: ${result.stderr}`);
-    }
-  }
-  async rmdir(path, options) {
-    await this.ensureReady();
-    this.assertWritable();
-    const key = toKey(path);
-    if (!key) {
-      throw new Error("Cannot remove root directory");
-    }
-    const cmd = options?.recursive ? `rm -r${options?.force ? "f" : ""} ${shellEscape(key)}` : `rmdir ${shellEscape(key)}`;
-    const result = await this.disk.exec(options?.force ? `${cmd} 2>/dev/null; true` : cmd);
-    if (result.exitCode !== 0 && !options?.force) {
-      if (result.stderr.includes("No such file") || result.stderr.includes("not found")) {
-        throw new FileNotFoundError(path);
-      }
-      throw new Error(`rmdir failed: ${result.stderr}`);
-    }
-  }
-  async readdir(path, options) {
-    await this.ensureReady();
-    const key = toKey(path);
-    const prefix = key ? key + "/" : "";
-    if (options?.recursive) {
-      return this.readdirRecursive(prefix, options);
-    }
-    const result = await this.disk.listObjects(prefix, { recursive: false });
-    const entries = [];
-    for (const obj of result.objects) {
-      const name = obj.key.slice(prefix.length);
-      if (!name || name.includes("/")) continue;
-      if (options?.extension) {
-        const extensions = Array.isArray(options.extension) ? options.extension : [options.extension];
-        const ext = name.match(/\.[^.]+$/)?.[0] ?? "";
-        if (!extensions.includes(ext)) continue;
-      }
-      entries.push({
-        name,
-        type: "file",
-        size: obj.size
-      });
-    }
-    for (const cp of result.commonPrefixes) {
-      const name = trimSlashes(cp.slice(prefix.length));
-      if (!name) continue;
-      entries.push({
-        name,
-        type: "directory"
-      });
-    }
-    return entries;
-  }
-  async readdirRecursive(prefix, options) {
-    const result = await this.disk.listObjects(prefix, { recursive: true });
-    const entries = [];
-    for (const obj of result.objects) {
-      const relativePath = obj.key.slice(prefix.length);
-      if (!relativePath) continue;
-      if (options?.maxDepth !== void 0) {
-        const depth = relativePath.split("/").length - 1;
-        if (depth > options.maxDepth) continue;
-      }
-      if (options?.extension) {
-        const extensions = Array.isArray(options.extension) ? options.extension : [options.extension];
-        const ext = relativePath.match(/\.[^.]+$/)?.[0] ?? "";
-        if (!extensions.includes(ext)) continue;
-      }
-      entries.push({
-        name: relativePath,
-        type: "file",
-        size: obj.size
-      });
-    }
-    return entries;
-  }
-  // ---------------------------------------------------------------------------
-  // Path Operations
-  // ---------------------------------------------------------------------------
-  async exists(path) {
-    await this.ensureReady();
-    const key = toKey(path);
-    if (!key) return true;
-    const fileExists = await this.disk.objectExists(key);
-    if (fileExists) return true;
-    const result = await this.disk.listObjects(key + "/", { singlePage: true, limit: 1 });
-    return result.objects.length > 0 || result.commonPrefixes.length > 0;
-  }
-  async stat(path) {
-    await this.ensureReady();
-    const key = toKey(path);
-    if (!key) {
-      return {
-        name: "",
-        path: "/",
-        type: "directory",
-        size: 0,
-        createdAt: /* @__PURE__ */ new Date(0),
-        modifiedAt: /* @__PURE__ */ new Date(0)
-      };
-    }
-    const meta = await this.disk.headObject(key);
-    if (meta) {
-      return {
-        name: basename(path),
-        path: "/" + key,
-        type: "file",
-        size: meta.size,
-        createdAt: meta.lastModified ?? /* @__PURE__ */ new Date(0),
-        modifiedAt: meta.lastModified ?? /* @__PURE__ */ new Date(0),
-        mimeType: meta.contentType
-      };
-    }
-    const result = await this.disk.listObjects(key + "/", { singlePage: true, limit: 1 });
-    if (result.objects.length > 0 || result.commonPrefixes.length > 0) {
-      return {
-        name: basename(path),
-        path: "/" + key,
-        type: "directory",
-        size: 0,
-        createdAt: /* @__PURE__ */ new Date(0),
-        modifiedAt: /* @__PURE__ */ new Date(0)
-      };
-    }
-    throw new FileNotFoundError(path);
-  }
-  // ---------------------------------------------------------------------------
-  // Helpers
-  // ---------------------------------------------------------------------------
-  assertWritable() {
-    if (this.readOnly) {
-      throw new Error("Filesystem is read-only");
-    }
-  }
+	id;
+	name = "ArchilFilesystem";
+	provider = "archil";
+	readOnly;
+	displayName;
+	icon;
+	description;
+	status = "pending";
+	_disk = null;
+	_archil = null;
+	_diskId;
+	_createDiskOptions;
+	_archilOptions;
+	constructor(options) {
+		super({
+			...options,
+			name: "ArchilFilesystem"
+		});
+		this.id = options.id ?? `archil-fs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+		this.readOnly = options.readOnly;
+		this.displayName = options.displayName ?? "Archil";
+		this.icon = options.icon ?? "cloud";
+		this.description = options.description ?? "Elastic serverless filesystem powered by Archil";
+		this._diskId = options.diskId;
+		this._createDiskOptions = options.createDiskOptions;
+		this._archilOptions = {
+			apiKey: options.apiKey,
+			region: options.region,
+			baseUrl: options.baseUrl,
+			s3BaseUrl: options.s3BaseUrl
+		};
+	}
+	/** The underlying Archil Disk instance (available after init). */
+	get disk() {
+		if (!this._disk) throw new Error("ArchilFilesystem not initialized — call init() first");
+		return this._disk;
+	}
+	/** The Archil SDK client instance. */
+	get archil() {
+		if (!this._archil) this._archil = new Archil(this._archilOptions);
+		return this._archil;
+	}
+	async init() {
+		try {
+			if (this._diskId && this._createDiskOptions) throw new Error("diskId and createDiskOptions are mutually exclusive");
+			if (this._diskId) this._disk = await this.archil.disks.get(this._diskId);
+			else if (this._createDiskOptions) {
+				const result = await this.archil.disks.create(this._createDiskOptions);
+				this._disk = result.disk;
+			} else throw new Error("Either diskId or createDiskOptions must be provided");
+			this.status = "ready";
+		} catch (err) {
+			this.status = "error";
+			this.error = err instanceof Error ? err.message : String(err);
+			throw err;
+		}
+	}
+	async destroy() {
+		this._disk = null;
+		this._archil = null;
+	}
+	isReady() {
+		return this.status === "ready" && this._disk !== null;
+	}
+	getInfo() {
+		return {
+			id: this.id,
+			name: this.name,
+			provider: this.provider,
+			status: this.status,
+			error: this.error,
+			readOnly: this.readOnly,
+			icon: this.icon,
+			metadata: {
+				diskId: this._disk?.id ?? "",
+				region: this._disk?.region ?? "",
+				diskName: this._disk?.name ?? ""
+			}
+		};
+	}
+	getInstructions() {
+		const access = this.readOnly ? "Read-only" : "Persistent";
+		return `Archil elastic filesystem "${this._disk?.name ?? "Archil disk"}". ${access} storage — files persist across sessions. Supports serverless execution via exec().`;
+	}
+	/**
+	* Execute a shell command on the disk's filesystem.
+	* The disk is mounted as the working directory.
+	*/
+	async exec(command) {
+		await this.ensureReady();
+		this.assertWritable();
+		return this.disk.exec(command);
+	}
+	/**
+	* Parallel grep across files on the disk.
+	*/
+	async grep(opts) {
+		await this.ensureReady();
+		return this.disk.grep(opts);
+	}
+	/**
+	* Create a signed, time-limited download URL for a file.
+	*/
+	async share(key, opts) {
+		await this.ensureReady();
+		return this.disk.share(key, opts);
+	}
+	/**
+	* List objects using the S3-compatible API directly.
+	*/
+	async listObjects(prefix, opts) {
+		await this.ensureReady();
+		return this.disk.listObjects(prefix, opts);
+	}
+	/**
+	* Get object metadata without downloading.
+	*/
+	async headObject(key) {
+		await this.ensureReady();
+		return this.disk.headObject(key);
+	}
+	async readFile(path, options) {
+		await this.ensureReady();
+		const key = toKey(path);
+		if (!key) throw new Error("Cannot read file at root path");
+		try {
+			const data = await this.disk.getObject(key);
+			if (options?.encoding) return Buffer.from(data).toString(options.encoding);
+			return Buffer.from(data);
+		} catch (err) {
+			if (isNotFound(err)) throw new FileNotFoundError(path);
+			throw err;
+		}
+	}
+	async writeFile(path, content, options) {
+		await this.ensureReady();
+		this.assertWritable();
+		const key = toKey(path);
+		if (!key) throw new Error("Cannot write file at root path");
+		if (options?.overwrite === false) {
+			if (await this.disk.objectExists(key)) throw new FileExistsError(path);
+		}
+		if (options?.recursive) {
+			const dir = dirname(path);
+			if (dir) await this.disk.exec(`mkdir -p ${shellEscape(dir)}`);
+		}
+		const body = typeof content === "string" ? content : content instanceof Uint8Array ? content : new Uint8Array(content);
+		const mimeType = options?.mimeType ?? getMimeType(path);
+		await this.disk.putObject(key, body, mimeType);
+	}
+	async appendFile(path, content) {
+		await this.ensureReady();
+		this.assertWritable();
+		const key = toKey(path);
+		if (!key) throw new Error("Cannot append to root path");
+		const data = typeof content === "string" ? content : Buffer.from(content).toString("base64");
+		if (typeof content === "string") await this.disk.exec(`printf '%s' ${shellEscape(data)} >> ${shellEscape(key)}`);
+		else await this.disk.exec(`printf '%s' ${shellEscape(data)} | base64 -d >> ${shellEscape(key)}`);
+	}
+	async deleteFile(path, options) {
+		await this.ensureReady();
+		this.assertWritable();
+		const key = toKey(path);
+		if (!key) throw new Error("Cannot delete root path");
+		if (!options?.force) {
+			if (!await this.disk.objectExists(key)) throw new FileNotFoundError(path);
+		}
+		await this.disk.deleteObject(key);
+	}
+	async copyFile(src, dest, options) {
+		await this.ensureReady();
+		this.assertWritable();
+		const srcKey = toKey(src);
+		const destKey = toKey(dest);
+		if (!options?.overwrite) {
+			if (await this.disk.objectExists(destKey)) throw new FileExistsError(dest);
+		}
+		const flags = options?.recursive ? "-r" : "";
+		const result = await this.disk.exec(`cp ${flags} ${shellEscape(srcKey)} ${shellEscape(destKey)}`);
+		if (result.exitCode !== 0) {
+			if (result.stderr.includes("No such file")) throw new FileNotFoundError(src);
+			throw new Error(`cp failed: ${result.stderr}`);
+		}
+	}
+	async moveFile(src, dest, options) {
+		await this.ensureReady();
+		this.assertWritable();
+		const srcKey = toKey(src);
+		const destKey = toKey(dest);
+		if (!options?.overwrite) {
+			if (await this.disk.objectExists(destKey)) throw new FileExistsError(dest);
+		}
+		const result = await this.disk.exec(`mv ${shellEscape(srcKey)} ${shellEscape(destKey)}`);
+		if (result.exitCode !== 0) {
+			if (result.stderr.includes("No such file")) throw new FileNotFoundError(src);
+			throw new Error(`mv failed: ${result.stderr}`);
+		}
+	}
+	async mkdir(path, options) {
+		await this.ensureReady();
+		this.assertWritable();
+		const key = toKey(path);
+		if (!key) return;
+		const flag = options?.recursive ? "-p" : "";
+		const result = await this.disk.exec(`mkdir ${flag} ${shellEscape(key)}`);
+		if (result.exitCode !== 0) {
+			if (result.stderr.includes("File exists")) throw new FileExistsError(path);
+			throw new Error(`mkdir failed: ${result.stderr}`);
+		}
+	}
+	async rmdir(path, options) {
+		await this.ensureReady();
+		this.assertWritable();
+		const key = toKey(path);
+		if (!key) throw new Error("Cannot remove root directory");
+		const cmd = options?.recursive ? `rm -r${options?.force ? "f" : ""} ${shellEscape(key)}` : `rmdir ${shellEscape(key)}`;
+		const result = await this.disk.exec(options?.force ? `${cmd} 2>/dev/null; true` : cmd);
+		if (result.exitCode !== 0 && !options?.force) {
+			if (result.stderr.includes("No such file") || result.stderr.includes("not found")) throw new FileNotFoundError(path);
+			throw new Error(`rmdir failed: ${result.stderr}`);
+		}
+	}
+	async readdir(path, options) {
+		await this.ensureReady();
+		const key = toKey(path);
+		const prefix = key ? key + "/" : "";
+		if (options?.recursive) return this.readdirRecursive(prefix, options);
+		const result = await this.disk.listObjects(prefix, { recursive: false });
+		const entries = [];
+		for (const obj of result.objects) {
+			const name = obj.key.slice(prefix.length);
+			if (!name || name.includes("/")) continue;
+			if (options?.extension) {
+				const extensions = Array.isArray(options.extension) ? options.extension : [options.extension];
+				const ext = name.match(/\.[^.]+$/)?.[0] ?? "";
+				if (!extensions.includes(ext)) continue;
+			}
+			entries.push({
+				name,
+				type: "file",
+				size: obj.size
+			});
+		}
+		for (const cp of result.commonPrefixes) {
+			const name = trimSlashes(cp.slice(prefix.length));
+			if (!name) continue;
+			entries.push({
+				name,
+				type: "directory"
+			});
+		}
+		return entries;
+	}
+	async readdirRecursive(prefix, options) {
+		const result = await this.disk.listObjects(prefix, { recursive: true });
+		const entries = [];
+		for (const obj of result.objects) {
+			const relativePath = obj.key.slice(prefix.length);
+			if (!relativePath) continue;
+			if (options?.maxDepth !== void 0) {
+				if (relativePath.split("/").length - 1 > options.maxDepth) continue;
+			}
+			if (options?.extension) {
+				const extensions = Array.isArray(options.extension) ? options.extension : [options.extension];
+				const ext = relativePath.match(/\.[^.]+$/)?.[0] ?? "";
+				if (!extensions.includes(ext)) continue;
+			}
+			entries.push({
+				name: relativePath,
+				type: "file",
+				size: obj.size
+			});
+		}
+		return entries;
+	}
+	async exists(path) {
+		await this.ensureReady();
+		const key = toKey(path);
+		if (!key) return true;
+		if (await this.disk.objectExists(key)) return true;
+		const result = await this.disk.listObjects(key + "/", {
+			singlePage: true,
+			limit: 1
+		});
+		return result.objects.length > 0 || result.commonPrefixes.length > 0;
+	}
+	async stat(path) {
+		await this.ensureReady();
+		const key = toKey(path);
+		if (!key) return {
+			name: "",
+			path: "/",
+			type: "directory",
+			size: 0,
+			createdAt: /* @__PURE__ */ new Date(0),
+			modifiedAt: /* @__PURE__ */ new Date(0)
+		};
+		const meta = await this.disk.headObject(key);
+		if (meta) return {
+			name: basename(path),
+			path: "/" + key,
+			type: "file",
+			size: meta.size,
+			createdAt: meta.lastModified ?? /* @__PURE__ */ new Date(0),
+			modifiedAt: meta.lastModified ?? /* @__PURE__ */ new Date(0),
+			mimeType: meta.contentType
+		};
+		const result = await this.disk.listObjects(key + "/", {
+			singlePage: true,
+			limit: 1
+		});
+		if (result.objects.length > 0 || result.commonPrefixes.length > 0) return {
+			name: basename(path),
+			path: "/" + key,
+			type: "directory",
+			size: 0,
+			createdAt: /* @__PURE__ */ new Date(0),
+			modifiedAt: /* @__PURE__ */ new Date(0)
+		};
+		throw new FileNotFoundError(path);
+	}
+	assertWritable() {
+		if (this.readOnly) throw new Error("Filesystem is read-only");
+	}
 };
 function isNotFound(err) {
-  if (!err || typeof err !== "object") return false;
-  const e = err;
-  return e.status === 404 || e.code === "NoSuchKey";
+	if (!err || typeof err !== "object") return false;
+	const e = err;
+	return e.status === 404 || e.code === "NoSuchKey";
 }
-
-// src/provider.ts
-var archilFilesystemProvider = {
-  id: "archil",
-  name: "Archil",
-  description: "Elastic, serverless filesystem for AI agents (Archil)",
-  configSchema: {
-    type: "object",
-    oneOf: [{ required: ["diskId"] }, { required: ["createDiskOptions"] }],
-    properties: {
-      diskId: { type: "string", description: 'Existing Archil disk ID (e.g. "dsk-0123456789abcdef")' },
-      createDiskOptions: { type: "object", description: "Options used to create a new Archil disk on init" },
-      apiKey: { type: "string", description: "Archil API key (falls back to ARCHIL_API_KEY env var)" },
-      region: { type: "string", description: 'Archil region (e.g. "aws-us-east-1")' },
-      readOnly: { type: "boolean", description: "Mount as read-only", default: false },
-      baseUrl: { type: "string", description: "Custom control-plane URL (for testing)" },
-      s3BaseUrl: { type: "string", description: "Custom S3 API URL" }
-    }
-  },
-  createFilesystem: (config) => new ArchilFilesystem(config)
+//#endregion
+//#region src/provider.ts
+const archilFilesystemProvider = {
+	id: "archil",
+	name: "Archil",
+	description: "Elastic, serverless filesystem for AI agents (Archil)",
+	configSchema: {
+		type: "object",
+		oneOf: [{ required: ["diskId"] }, { required: ["createDiskOptions"] }],
+		properties: {
+			diskId: {
+				type: "string",
+				description: "Existing Archil disk ID (e.g. \"dsk-0123456789abcdef\")"
+			},
+			createDiskOptions: {
+				type: "object",
+				description: "Options used to create a new Archil disk on init"
+			},
+			apiKey: {
+				type: "string",
+				description: "Archil API key (falls back to ARCHIL_API_KEY env var)"
+			},
+			region: {
+				type: "string",
+				description: "Archil region (e.g. \"aws-us-east-1\")"
+			},
+			readOnly: {
+				type: "boolean",
+				description: "Mount as read-only",
+				default: false
+			},
+			baseUrl: {
+				type: "string",
+				description: "Custom control-plane URL (for testing)"
+			},
+			s3BaseUrl: {
+				type: "string",
+				description: "Custom S3 API URL"
+			}
+		}
+	},
+	createFilesystem: (config) => new ArchilFilesystem(config)
 };
-
+//#endregion
 export { ArchilFilesystem, archilFilesystemProvider };
-//# sourceMappingURL=index.js.map
+
 //# sourceMappingURL=index.js.map