@mastra/files-sdk 0.3.0-alpha.0 → 0.3.1-alpha.0

package/dist/index.js

@@ -1,424 +1,455 @@
-import { MastraFilesystem, FileNotFoundError, FileExistsError, DirectoryNotEmptyError, WorkspaceReadOnlyError } from '@mastra/core/workspace';
-
-// src/filesystem/index.ts
+import { DirectoryNotEmptyError, FileExistsError, FileNotFoundError, MastraFilesystem, WorkspaceReadOnlyError } from "@mastra/core/workspace";
+//#region src/filesystem/index.ts
+/**
+* Normalize a POSIX-style path to an object-storage key.
+* Strips leading slashes, resolves `.`/`./` to empty string.
+*/
 function toKey(path) {
-  let start = 0;
-  while (start < path.length && path.charCodeAt(start) === 47) start++;
-  let end = path.length;
-  while (end > start && path.charCodeAt(end - 1) === 47) end--;
-  const key = path.slice(start, end);
-  if (key === "." || key === "./") return "";
-  return key;
+	let start = 0;
+	while (start < path.length && path.charCodeAt(start) === 47) start++;
+	let end = path.length;
+	while (end > start && path.charCodeAt(end - 1) === 47) end--;
+	const key = path.slice(start, end);
+	if (key === "." || key === "./") return "";
+	return key;
 }
+/**
+* Extract the basename (last path segment) from a key.
+*/
 function basename(key) {
-  const idx = key.lastIndexOf("/");
-  return idx === -1 ? key : key.slice(idx + 1);
+	const idx = key.lastIndexOf("/");
+	return idx === -1 ? key : key.slice(idx + 1);
 }
+/**
+* Walk the FilesSDK error code chain.
+*
+* FilesSDK frequently wraps an inner `NotFound` / `Unauthorized` error in an
+* outer `Provider` error (`error.cause` carries the original). Some adapters
+* may wrap multiple levels deep, so we walk the cause chain and return any
+* matching code found along the way.
+*/
 function hasFilesSDKCode(err, code, depth = 0) {
-  if (depth > 5 || !err || typeof err !== "object") return false;
-  const e = err;
-  if (e.code === code) return true;
-  if (e.cause) return hasFilesSDKCode(e.cause, code, depth + 1);
-  return false;
+	if (depth > 5 || !err || typeof err !== "object") return false;
+	const e = err;
+	if (e.code === code) return true;
+	if (e.cause) return hasFilesSDKCode(e.cause, code, depth + 1);
+	return false;
 }
 function isNotFoundError(err) {
-  return hasFilesSDKCode(err, "NotFound");
+	return hasFilesSDKCode(err, "NotFound");
 }
 function isUnauthorizedError(err) {
-  return hasFilesSDKCode(err, "Unauthorized");
+	return hasFilesSDKCode(err, "Unauthorized");
 }
 function generateId() {
-  return `files-sdk-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+	return `files-sdk-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
 }
+/**
+* Convert FileContent (string | Buffer | Uint8Array) to a body acceptable by files-sdk.
+*/
 function toBody(content) {
-  if (typeof content === "string") return content;
-  if (Buffer.isBuffer(content)) return new Uint8Array(content);
-  return content;
+	if (typeof content === "string") return content;
+	if (Buffer.isBuffer(content)) return new Uint8Array(content);
+	return content;
 }
-var MIME_TYPES = {
-  ".txt": "text/plain",
-  ".md": "text/markdown",
-  ".markdown": "text/markdown",
-  ".html": "text/html",
-  ".htm": "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",
-  ".rb": "text/x-ruby",
-  ".sh": "text/x-shellscript",
-  ".bash": "text/x-shellscript",
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".gif": "image/gif",
-  ".svg": "image/svg+xml",
-  ".webp": "image/webp",
-  ".ico": "image/x-icon",
-  ".pdf": "application/pdf",
-  ".zip": "application/zip",
-  ".gz": "application/gzip",
-  ".tar": "application/x-tar"
+/**
+* Infer MIME type from a file path extension.
+*/
+const MIME_TYPES = {
+	".txt": "text/plain",
+	".md": "text/markdown",
+	".markdown": "text/markdown",
+	".html": "text/html",
+	".htm": "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",
+	".rb": "text/x-ruby",
+	".sh": "text/x-shellscript",
+	".bash": "text/x-shellscript",
+	".png": "image/png",
+	".jpg": "image/jpeg",
+	".jpeg": "image/jpeg",
+	".gif": "image/gif",
+	".svg": "image/svg+xml",
+	".webp": "image/webp",
+	".ico": "image/x-icon",
+	".pdf": "application/pdf",
+	".zip": "application/zip",
+	".gz": "application/gzip",
+	".tar": "application/x-tar"
 };
 function getMimeType(path) {
-  const dot = path.lastIndexOf(".");
-  if (dot === -1) return "application/octet-stream";
-  return MIME_TYPES[path.slice(dot).toLowerCase()] ?? "application/octet-stream";
+	const dot = path.lastIndexOf(".");
+	if (dot === -1) return "application/octet-stream";
+	return MIME_TYPES[path.slice(dot).toLowerCase()] ?? "application/octet-stream";
 }
+/**
+* Workspace filesystem adapter backed by [FilesSDK](https://files-sdk.dev).
+*
+* Accepts a pre-configured `Files` instance so users choose their own adapter
+* (S3, R2, GCS, Azure, local fs, etc.) and this class bridges it to the
+* Mastra `WorkspaceFilesystem` interface.
+*
+* Object-storage semantics are bridged to the POSIX-like interface:
+* - `mkdir` is a no-op (directories don't exist in object storage)
+* - `readdir` uses `list()` with prefix filtering to synthesize directory entries
+* - `rmdir` lists all keys under a prefix and batch-deletes them
+*/
 var FilesSDKFilesystem = class extends MastraFilesystem {
-  id;
-  name = "FilesSDKFilesystem";
-  provider = "files-sdk";
-  status = "pending";
-  readOnly;
-  icon;
-  displayName;
-  description;
-  _files;
-  constructor(options) {
-    super({ name: "FilesSDKFilesystem", ...options });
-    this._files = options.files;
-    this.id = options.id ?? generateId();
-    this.readOnly = options.readOnly;
-    this.icon = options.icon;
-    this.displayName = options.displayName;
-    this.description = options.description;
-  }
-  /** The underlying FilesSDK instance, for escape-hatch access. */
-  get files() {
-    return this._files;
-  }
-  // ---------------------------------------------------------------------------
-  // Lifecycle
-  // ---------------------------------------------------------------------------
-  async init() {
-    try {
-      await this._files.list({ limit: 1 });
-    } catch (err) {
-      if (isUnauthorizedError(err)) {
-        throw new Error("Access denied \u2014 check credentials and storage permissions");
-      }
-      throw err;
-    }
-  }
-  // destroy() — default no-op is fine; FilesSDK has no explicit teardown.
-  getInfo() {
-    return {
-      id: this.id,
-      name: this.name,
-      provider: this.provider,
-      status: this.status,
-      error: this.error,
-      readOnly: this.readOnly,
-      icon: this.icon,
-      metadata: {
-        adapter: this._files.adapter?.name ?? "unknown"
-      }
-    };
-  }
-  getInstructions() {
-    const adapterName = this._files.adapter?.name ?? "unknown";
-    const parts = [`Unified storage via FilesSDK (${adapterName} adapter).`];
-    if (this.readOnly) parts.push("Mounted read-only.");
-    parts.push("Persistent storage \u2014 files are retained across sessions.");
-    return parts.join(" ");
-  }
-  // ---------------------------------------------------------------------------
-  // File operations
-  // ---------------------------------------------------------------------------
-  async readFile(path, options) {
-    await this.ensureReady();
-    const key = toKey(path);
-    try {
-      const file = await this._files.download(key);
-      const buf = Buffer.from(await file.arrayBuffer());
-      if (options?.encoding) return buf.toString(options.encoding);
-      return buf;
-    } catch (err) {
-      if (isNotFoundError(err)) throw new FileNotFoundError(path);
-      throw err;
-    }
-  }
-  async writeFile(path, content, options) {
-    await this.ensureReady();
-    this.assertWritable("writeFile");
-    const key = toKey(path);
-    if (options?.overwrite === false && await this.isFile(key)) {
-      throw new FileExistsError(path);
-    }
-    const body = toBody(content);
-    await this._files.upload(key, body, {
-      contentType: options?.mimeType ?? getMimeType(path)
-    });
-  }
-  /**
-   * Append content to a file.
-   *
-   * **Not atomic.** Object storage has no native append, so this is implemented
-   * as a read-modify-write: the existing object is downloaded, the new content
-   * is concatenated, and the result is uploaded as a new object. Concurrent
-   * appends to the same key may overwrite each other. This limitation is
-   * inherent to object storage, not specific to FilesSDK, and matches the
-   * behavior of the sibling S3, GCS, and Azure workspace providers.
-   */
-  async appendFile(path, content) {
-    await this.ensureReady();
-    this.assertWritable("appendFile");
-    const key = toKey(path);
-    let existing = Buffer.alloc(0);
-    try {
-      const file = await this._files.download(key);
-      existing = Buffer.from(await file.arrayBuffer());
-    } catch (err) {
-      if (!isNotFoundError(err)) throw err;
-    }
-    const append = typeof content === "string" ? Buffer.from(content) : toBody(content);
-    const merged = Buffer.concat([existing, Buffer.isBuffer(append) ? append : Buffer.from(append)]);
-    await this._files.upload(key, new Uint8Array(merged), {
-      contentType: getMimeType(path)
-    });
-  }
-  async deleteFile(path, options) {
-    await this.ensureReady();
-    this.assertWritable("deleteFile");
-    const key = toKey(path);
-    if (await this.isDirectory(key)) {
-      await this.rmdir(path, { recursive: true, force: options?.force });
-      return;
-    }
-    if (!options?.force && !await this.isFile(key)) {
-      throw new FileNotFoundError(path);
-    }
-    try {
-      await this._files.delete(key);
-    } catch (err) {
-      if (options?.force) return;
-      if (isNotFoundError(err)) throw new FileNotFoundError(path);
-      throw err;
-    }
-  }
-  async copyFile(src, dest, options) {
-    await this.ensureReady();
-    this.assertWritable("copyFile");
-    const fromKey = toKey(src);
-    const toKey_ = toKey(dest);
-    if (options?.overwrite === false && await this.isFile(toKey_)) {
-      throw new FileExistsError(dest);
-    }
-    try {
-      await this._files.copy(fromKey, toKey_);
-    } catch (err) {
-      if (isNotFoundError(err)) throw new FileNotFoundError(src);
-      throw err;
-    }
-  }
-  async moveFile(src, dest, options) {
-    await this.copyFile(src, dest, options);
-    await this.deleteFile(src, { force: true });
-  }
-  // ---------------------------------------------------------------------------
-  // Directory operations
-  // ---------------------------------------------------------------------------
-  async mkdir(_path, _options) {
-    await this.ensureReady();
-    this.assertWritable("mkdir");
-  }
-  async rmdir(path, options) {
-    await this.ensureReady();
-    this.assertWritable("rmdir");
-    const key = toKey(path);
-    const prefix = key ? `${key}/` : "";
-    const allKeys = [];
-    let cursor;
-    do {
-      const result = await this._files.list({ prefix, cursor, limit: 1e3 });
-      for (const item of result.items) {
-        allKeys.push(item.key);
-      }
-      cursor = result.cursor;
-    } while (cursor);
-    if (allKeys.length === 0) return;
-    if (!options?.recursive) {
-      throw new DirectoryNotEmptyError(path);
-    }
-    await this._files.delete(allKeys);
-  }
-  async readdir(path, options) {
-    await this.ensureReady();
-    const key = toKey(path);
-    const prefix = key ? `${key}/` : "";
-    const entries = [];
-    const seenDirs = /* @__PURE__ */ new Set();
-    let cursor;
-    const maxDepth = options?.maxDepth;
-    const recursive = options?.recursive ?? false;
-    const extensions = options?.extension ? Array.isArray(options.extension) ? options.extension : [options.extension] : void 0;
-    do {
-      const result = await this._files.list({ prefix, cursor, limit: 1e3 });
-      for (const item of result.items) {
-        const relativePath = prefix ? item.key.slice(prefix.length) : item.key;
-        if (!relativePath) continue;
-        const segments = relativePath.split("/");
-        if (segments.length === 1) {
-          const name = segments[0];
-          if (extensions) {
-            const ext = name.lastIndexOf(".") !== -1 ? name.slice(name.lastIndexOf(".")) : "";
-            if (!extensions.includes(ext)) continue;
-          }
-          entries.push({
-            name,
-            type: "file",
-            size: item.size
-          });
-        } else if (!recursive) {
-          const dirName = segments[0];
-          if (!seenDirs.has(dirName)) {
-            seenDirs.add(dirName);
-            entries.push({
-              name: dirName,
-              type: "directory"
-            });
-          }
-        } else {
-          for (let i = 1; i < segments.length; i++) {
-            const dirPath = segments.slice(0, i).join("/");
-            const dirDepth = i;
-            if (maxDepth !== void 0 && dirDepth > maxDepth) continue;
-            if (!seenDirs.has(dirPath)) {
-              seenDirs.add(dirPath);
-              entries.push({
-                name: dirPath,
-                type: "directory"
-              });
-            }
-          }
-          if (maxDepth !== void 0 && segments.length > maxDepth) continue;
-          const name = relativePath;
-          if (extensions) {
-            const ext = name.lastIndexOf(".") !== -1 ? name.slice(name.lastIndexOf(".")) : "";
-            if (!extensions.includes(ext)) continue;
-          }
-          entries.push({
-            name,
-            type: "file",
-            size: item.size
-          });
-        }
-      }
-      cursor = result.cursor;
-    } while (cursor);
-    return entries;
-  }
-  // ---------------------------------------------------------------------------
-  // Path operations
-  // ---------------------------------------------------------------------------
-  async exists(path) {
-    await this.ensureReady();
-    const key = toKey(path);
-    if (!key) return true;
-    if (await this.isDirectory(key)) return true;
-    return this.isFile(key);
-  }
-  async stat(path) {
-    await this.ensureReady();
-    const key = toKey(path);
-    if (!key) {
-      const now = /* @__PURE__ */ new Date();
-      return {
-        name: "/",
-        path: "/",
-        type: "directory",
-        size: 0,
-        createdAt: now,
-        modifiedAt: now
-      };
-    }
-    try {
-      const file = await this._files.head(key);
-      return this.storedFileToStat(file, path);
-    } catch (err) {
-      if (!isNotFoundError(err)) throw err;
-    }
-    if (await this.isDirectory(key)) {
-      const now = /* @__PURE__ */ new Date();
-      return {
-        name: basename(key),
-        path,
-        type: "directory",
-        size: 0,
-        createdAt: now,
-        modifiedAt: now
-      };
-    }
-    throw new FileNotFoundError(path);
-  }
-  // ---------------------------------------------------------------------------
-  // Private helpers
-  // ---------------------------------------------------------------------------
-  assertWritable(operation) {
-    if (this.readOnly) {
-      throw new WorkspaceReadOnlyError(operation);
-    }
-  }
-  /** Check if a key prefix has any children (i.e. acts like a directory). */
-  async isDirectory(key) {
-    if (!key) return true;
-    const prefix = `${key}/`;
-    const result = await this._files.list({ prefix, limit: 1 });
-    return result.items.length > 0;
-  }
-  /**
-   * Check whether `key` refers to a real stored file (not an empty leftover
-   * directory). Uses prefix listing constrained to the exact key, which only
-   * matches actually-stored objects across all adapters.
-   */
-  async isFile(key) {
-    if (!key) return false;
-    const result = await this._files.list({ prefix: key, limit: 10 });
-    return result.items.some((item) => item.key === key);
-  }
-  /** Convert a FilesSDK StoredFile to a Mastra FileStat. */
-  storedFileToStat(file, path) {
-    return {
-      name: basename(file.key ?? path),
-      path,
-      type: "file",
-      size: file.size ?? 0,
-      createdAt: file.lastModified ? new Date(file.lastModified) : /* @__PURE__ */ new Date(),
-      modifiedAt: file.lastModified ? new Date(file.lastModified) : /* @__PURE__ */ new Date(),
-      mimeType: file.type || void 0
-    };
-  }
+	id;
+	name = "FilesSDKFilesystem";
+	provider = "files-sdk";
+	status = "pending";
+	readOnly;
+	icon;
+	displayName;
+	description;
+	_files;
+	constructor(options) {
+		super({
+			name: "FilesSDKFilesystem",
+			...options
+		});
+		this._files = options.files;
+		this.id = options.id ?? generateId();
+		this.readOnly = options.readOnly;
+		this.icon = options.icon;
+		this.displayName = options.displayName;
+		this.description = options.description;
+	}
+	/** The underlying FilesSDK instance, for escape-hatch access. */
+	get files() {
+		return this._files;
+	}
+	async init() {
+		try {
+			await this._files.list({ limit: 1 });
+		} catch (err) {
+			if (isUnauthorizedError(err)) throw new Error("Access denied — check credentials and storage permissions");
+			throw err;
+		}
+	}
+	getInfo() {
+		return {
+			id: this.id,
+			name: this.name,
+			provider: this.provider,
+			status: this.status,
+			error: this.error,
+			readOnly: this.readOnly,
+			icon: this.icon,
+			metadata: { adapter: this._files.adapter?.name ?? "unknown" }
+		};
+	}
+	getInstructions() {
+		const parts = [`Unified storage via FilesSDK (${this._files.adapter?.name ?? "unknown"} adapter).`];
+		if (this.readOnly) parts.push("Mounted read-only.");
+		parts.push("Persistent storage — files are retained across sessions.");
+		return parts.join(" ");
+	}
+	async readFile(path, options) {
+		await this.ensureReady();
+		const key = toKey(path);
+		try {
+			const file = await this._files.download(key);
+			const buf = Buffer.from(await file.arrayBuffer());
+			if (options?.encoding) return buf.toString(options.encoding);
+			return buf;
+		} catch (err) {
+			if (isNotFoundError(err)) throw new FileNotFoundError(path);
+			throw err;
+		}
+	}
+	async writeFile(path, content, options) {
+		await this.ensureReady();
+		this.assertWritable("writeFile");
+		const key = toKey(path);
+		if (options?.overwrite === false && await this.isFile(key)) throw new FileExistsError(path);
+		const body = toBody(content);
+		await this._files.upload(key, body, { contentType: options?.mimeType ?? getMimeType(path) });
+	}
+	/**
+	* Append content to a file.
+	*
+	* **Not atomic.** Object storage has no native append, so this is implemented
+	* as a read-modify-write: the existing object is downloaded, the new content
+	* is concatenated, and the result is uploaded as a new object. Concurrent
+	* appends to the same key may overwrite each other. This limitation is
+	* inherent to object storage, not specific to FilesSDK, and matches the
+	* behavior of the sibling S3, GCS, and Azure workspace providers.
+	*/
+	async appendFile(path, content) {
+		await this.ensureReady();
+		this.assertWritable("appendFile");
+		const key = toKey(path);
+		let existing = Buffer.alloc(0);
+		try {
+			const file = await this._files.download(key);
+			existing = Buffer.from(await file.arrayBuffer());
+		} catch (err) {
+			if (!isNotFoundError(err)) throw err;
+		}
+		const append = typeof content === "string" ? Buffer.from(content) : toBody(content);
+		const merged = Buffer.concat([existing, Buffer.isBuffer(append) ? append : Buffer.from(append)]);
+		await this._files.upload(key, new Uint8Array(merged), { contentType: getMimeType(path) });
+	}
+	async deleteFile(path, options) {
+		await this.ensureReady();
+		this.assertWritable("deleteFile");
+		const key = toKey(path);
+		if (await this.isDirectory(key)) {
+			await this.rmdir(path, {
+				recursive: true,
+				force: options?.force
+			});
+			return;
+		}
+		if (!options?.force && !await this.isFile(key)) throw new FileNotFoundError(path);
+		try {
+			await this._files.delete(key);
+		} catch (err) {
+			if (options?.force) return;
+			if (isNotFoundError(err)) throw new FileNotFoundError(path);
+			throw err;
+		}
+	}
+	async copyFile(src, dest, options) {
+		await this.ensureReady();
+		this.assertWritable("copyFile");
+		const fromKey = toKey(src);
+		const toKey_ = toKey(dest);
+		if (options?.overwrite === false && await this.isFile(toKey_)) throw new FileExistsError(dest);
+		try {
+			await this._files.copy(fromKey, toKey_);
+		} catch (err) {
+			if (isNotFoundError(err)) throw new FileNotFoundError(src);
+			throw err;
+		}
+	}
+	async moveFile(src, dest, options) {
+		await this.copyFile(src, dest, options);
+		await this.deleteFile(src, { force: true });
+	}
+	async mkdir(_path, _options) {
+		await this.ensureReady();
+		this.assertWritable("mkdir");
+	}
+	async rmdir(path, options) {
+		await this.ensureReady();
+		this.assertWritable("rmdir");
+		const key = toKey(path);
+		const prefix = key ? `${key}/` : "";
+		const allKeys = [];
+		let cursor;
+		do {
+			const result = await this._files.list({
+				prefix,
+				cursor,
+				limit: 1e3
+			});
+			for (const item of result.items) allKeys.push(item.key);
+			cursor = result.cursor;
+		} while (cursor);
+		if (allKeys.length === 0) return;
+		if (!options?.recursive) throw new DirectoryNotEmptyError(path);
+		await this._files.delete(allKeys);
+	}
+	async readdir(path, options) {
+		await this.ensureReady();
+		const key = toKey(path);
+		const prefix = key ? `${key}/` : "";
+		const entries = [];
+		const seenDirs = /* @__PURE__ */ new Set();
+		let cursor;
+		const maxDepth = options?.maxDepth;
+		const recursive = options?.recursive ?? false;
+		const extensions = options?.extension ? Array.isArray(options.extension) ? options.extension : [options.extension] : void 0;
+		do {
+			const result = await this._files.list({
+				prefix,
+				cursor,
+				limit: 1e3
+			});
+			for (const item of result.items) {
+				const relativePath = prefix ? item.key.slice(prefix.length) : item.key;
+				if (!relativePath) continue;
+				const segments = relativePath.split("/");
+				if (segments.length === 1) {
+					const name = segments[0];
+					if (extensions) {
+						const ext = name.lastIndexOf(".") !== -1 ? name.slice(name.lastIndexOf(".")) : "";
+						if (!extensions.includes(ext)) continue;
+					}
+					entries.push({
+						name,
+						type: "file",
+						size: item.size
+					});
+				} else if (!recursive) {
+					const dirName = segments[0];
+					if (!seenDirs.has(dirName)) {
+						seenDirs.add(dirName);
+						entries.push({
+							name: dirName,
+							type: "directory"
+						});
+					}
+				} else {
+					for (let i = 1; i < segments.length; i++) {
+						const dirPath = segments.slice(0, i).join("/");
+						if (maxDepth !== void 0 && i > maxDepth) continue;
+						if (!seenDirs.has(dirPath)) {
+							seenDirs.add(dirPath);
+							entries.push({
+								name: dirPath,
+								type: "directory"
+							});
+						}
+					}
+					if (maxDepth !== void 0 && segments.length > maxDepth) continue;
+					const name = relativePath;
+					if (extensions) {
+						const ext = name.lastIndexOf(".") !== -1 ? name.slice(name.lastIndexOf(".")) : "";
+						if (!extensions.includes(ext)) continue;
+					}
+					entries.push({
+						name,
+						type: "file",
+						size: item.size
+					});
+				}
+			}
+			cursor = result.cursor;
+		} while (cursor);
+		return entries;
+	}
+	async exists(path) {
+		await this.ensureReady();
+		const key = toKey(path);
+		if (!key) return true;
+		if (await this.isDirectory(key)) return true;
+		return this.isFile(key);
+	}
+	async stat(path) {
+		await this.ensureReady();
+		const key = toKey(path);
+		if (!key) {
+			const now = /* @__PURE__ */ new Date();
+			return {
+				name: "/",
+				path: "/",
+				type: "directory",
+				size: 0,
+				createdAt: now,
+				modifiedAt: now
+			};
+		}
+		try {
+			const file = await this._files.head(key);
+			return this.storedFileToStat(file, path);
+		} catch (err) {
+			if (!isNotFoundError(err)) throw err;
+		}
+		if (await this.isDirectory(key)) {
+			const now = /* @__PURE__ */ new Date();
+			return {
+				name: basename(key),
+				path,
+				type: "directory",
+				size: 0,
+				createdAt: now,
+				modifiedAt: now
+			};
+		}
+		throw new FileNotFoundError(path);
+	}
+	assertWritable(operation) {
+		if (this.readOnly) throw new WorkspaceReadOnlyError(operation);
+	}
+	/** Check if a key prefix has any children (i.e. acts like a directory). */
+	async isDirectory(key) {
+		if (!key) return true;
+		const prefix = `${key}/`;
+		return (await this._files.list({
+			prefix,
+			limit: 1
+		})).items.length > 0;
+	}
+	/**
+	* Check whether `key` refers to a real stored file (not an empty leftover
+	* directory). Uses prefix listing constrained to the exact key, which only
+	* matches actually-stored objects across all adapters.
+	*/
+	async isFile(key) {
+		if (!key) return false;
+		return (await this._files.list({
+			prefix: key,
+			limit: 10
+		})).items.some((item) => item.key === key);
+	}
+	/** Convert a FilesSDK StoredFile to a Mastra FileStat. */
+	storedFileToStat(file, path) {
+		return {
+			name: basename(file.key ?? path),
+			path,
+			type: "file",
+			size: file.size ?? 0,
+			createdAt: file.lastModified ? new Date(file.lastModified) : /* @__PURE__ */ new Date(),
+			modifiedAt: file.lastModified ? new Date(file.lastModified) : /* @__PURE__ */ new Date(),
+			mimeType: file.type || void 0
+		};
+	}
 };
-
-// src/provider.ts
-var filesSDKFilesystemProvider = {
-  id: "files-sdk",
-  name: "FilesSDK (Unified Storage)",
-  description: "Unified storage via FilesSDK \u2014 supports S3, R2, GCS, Azure, Vercel Blob, local filesystem, and more",
-  configSchema: {
-    type: "object",
-    required: ["files"],
-    properties: {
-      files: { type: "object", description: "Pre-configured FilesSDK Files instance" },
-      id: { type: "string", description: "Unique filesystem ID" },
-      displayName: { type: "string", description: "Human-friendly display name" },
-      icon: { type: "string", description: "Icon identifier for UI" },
-      description: { type: "string", description: "Description for UI" },
-      readOnly: { type: "boolean", description: "Mount as read-only", default: false }
-    }
-  },
-  createFilesystem: (config) => new FilesSDKFilesystem(config)
+//#endregion
+//#region src/provider.ts
+const filesSDKFilesystemProvider = {
+	id: "files-sdk",
+	name: "FilesSDK (Unified Storage)",
+	description: "Unified storage via FilesSDK — supports S3, R2, GCS, Azure, Vercel Blob, local filesystem, and more",
+	configSchema: {
+		type: "object",
+		required: ["files"],
+		properties: {
+			files: {
+				type: "object",
+				description: "Pre-configured FilesSDK Files instance"
+			},
+			id: {
+				type: "string",
+				description: "Unique filesystem ID"
+			},
+			displayName: {
+				type: "string",
+				description: "Human-friendly display name"
+			},
+			icon: {
+				type: "string",
+				description: "Icon identifier for UI"
+			},
+			description: {
+				type: "string",
+				description: "Description for UI"
+			},
+			readOnly: {
+				type: "boolean",
+				description: "Mount as read-only",
+				default: false
+			}
+		}
+	},
+	createFilesystem: (config) => new FilesSDKFilesystem(config)
 };
-
+//#endregion
 export { FilesSDKFilesystem, filesSDKFilesystemProvider };
-//# sourceMappingURL=index.js.map
+
 //# sourceMappingURL=index.js.map