@mastra/files-sdk 0.0.0 → 0.2.0-alpha.0

package/CHANGELOG.md

@@ -1 +1,26 @@
 # @mastra/files-sdk
+
+## 0.2.0-alpha.0
+
+### Minor Changes
+
+- Added @mastra/files-sdk workspace filesystem provider — a unified storage adapter backed by [FilesSDK](https://files-sdk.dev). Supports any FilesSDK adapter (S3, R2, GCS, Azure Blob, Vercel Blob, local filesystem, and more) through a single `FilesSDKFilesystem` class that implements the `WorkspaceFilesystem` interface. ([#17027](https://github.com/mastra-ai/mastra/pull/17027))
+
+  **Usage**
+
+  ```ts
+  import { Files } from 'files-sdk';
+  import { s3 } from 'files-sdk/s3';
+  import { FilesSDKFilesystem } from '@mastra/files-sdk';
+
+  const files = new Files({ adapter: s3({ bucket: 'my-bucket', region: 'us-east-1' }) });
+
+  const filesystem = new FilesSDKFilesystem({ files });
+  ```
+
+  Swap adapters without changing code — just replace `s3()` with `r2()`, `gcs()`, `azure()`, `fs()`, etc.
+
+### Patch Changes
+
+- Updated dependencies [[`c35b962`](https://github.com/mastra-ai/mastra/commit/c35b9625c7e854fcfdeee226a3338a750d0ff211), [`4084113`](https://github.com/mastra-ai/mastra/commit/408411370fc48a822e8b616b3b63f9409774e0e9)]:
+  - @mastra/core@1.37.0-alpha.8

package/dist/filesystem/index.d.ts

@@ -0,0 +1,81 @@
+import type { FileContent, FileStat, FileEntry, ReadOptions, WriteOptions, ListOptions, RemoveOptions, CopyOptions, FilesystemIcon, FilesystemInfo, ProviderStatus, MastraFilesystemOptions } from '@mastra/core/workspace';
+import { MastraFilesystem } from '@mastra/core/workspace';
+import type { Files } from 'files-sdk';
+export interface FilesSDKFilesystemOptions extends MastraFilesystemOptions {
+    /** Pre-configured FilesSDK `Files` instance. */
+    files: Files;
+    /** Unique filesystem ID (auto-generated if not provided). */
+    id?: string;
+    /** Human-friendly display name for UI. */
+    displayName?: string;
+    /** Icon identifier for UI. */
+    icon?: FilesystemIcon;
+    /** Description shown in UI / instructions. */
+    description?: string;
+    /** Mount as read-only — all write operations will throw. */
+    readOnly?: boolean;
+}
+/**
+ * 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
+ */
+export declare class FilesSDKFilesystem extends MastraFilesystem {
+    readonly id: string;
+    readonly name = "FilesSDKFilesystem";
+    readonly provider = "files-sdk";
+    status: ProviderStatus;
+    readonly readOnly?: boolean;
+    readonly icon?: FilesystemIcon;
+    readonly displayName?: string;
+    readonly description?: string;
+    private readonly _files;
+    constructor(options: FilesSDKFilesystemOptions);
+    /** The underlying FilesSDK instance, for escape-hatch access. */
+    get files(): Files;
+    init(): Promise<void>;
+    getInfo(): FilesystemInfo;
+    getInstructions(): string;
+    readFile(path: string, options?: ReadOptions): Promise<string | Buffer>;
+    writeFile(path: string, content: FileContent, options?: WriteOptions): Promise<void>;
+    /**
+     * 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.
+     */
+    appendFile(path: string, content: FileContent): Promise<void>;
+    deleteFile(path: string, options?: RemoveOptions): Promise<void>;
+    copyFile(src: string, dest: string, options?: CopyOptions): Promise<void>;
+    moveFile(src: string, dest: string, options?: CopyOptions): Promise<void>;
+    mkdir(_path: string, _options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rmdir(path: string, options?: RemoveOptions): Promise<void>;
+    readdir(path: string, options?: ListOptions): Promise<FileEntry[]>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<FileStat>;
+    private assertWritable;
+    /** Check if a key prefix has any children (i.e. acts like a directory). */
+    private isDirectory;
+    /**
+     * 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.
+     */
+    private isFile;
+    /** Convert a FilesSDK StoredFile to a Mastra FileStat. */
+    private storedFileToStat;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/filesystem/index.d.ts.map

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

package/dist/index.cjs

@@ -0,0 +1,427 @@
+'use strict';
+
+var workspace = require('@mastra/core/workspace');
+
+// src/filesystem/index.ts
+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;
+}
+function basename(key) {
+  const idx = key.lastIndexOf("/");
+  return idx === -1 ? key : key.slice(idx + 1);
+}
+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;
+}
+function isNotFoundError(err) {
+  return hasFilesSDKCode(err, "NotFound");
+}
+function isUnauthorizedError(err) {
+  return hasFilesSDKCode(err, "Unauthorized");
+}
+function generateId() {
+  return `files-sdk-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+}
+function toBody(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"
+};
+function getMimeType(path) {
+  const dot = path.lastIndexOf(".");
+  if (dot === -1) return "application/octet-stream";
+  return MIME_TYPES[path.slice(dot).toLowerCase()] ?? "application/octet-stream";
+}
+var FilesSDKFilesystem = class extends workspace.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 workspace.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 workspace.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 workspace.FileNotFoundError(path);
+    }
+    try {
+      await this._files.delete(key);
+    } catch (err) {
+      if (options?.force) return;
+      if (isNotFoundError(err)) throw new workspace.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 workspace.FileExistsError(dest);
+    }
+    try {
+      await this._files.copy(fromKey, toKey_);
+    } catch (err) {
+      if (isNotFoundError(err)) throw new workspace.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 workspace.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 workspace.FileNotFoundError(path);
+  }
+  // ---------------------------------------------------------------------------
+  // Private helpers
+  // ---------------------------------------------------------------------------
+  assertWritable(operation) {
+    if (this.readOnly) {
+      throw new workspace.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
+    };
+  }
+};
+
+// 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)
+};
+
+exports.FilesSDKFilesystem = FilesSDKFilesystem;
+exports.filesSDKFilesystemProvider = filesSDKFilesystemProvider;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/filesystem/index.ts","../src/provider.ts"],"names":["MastraFilesystem","FileNotFoundError","FileExistsError","DirectoryNotEmptyError","WorkspaceReadOnlyError"],"mappings":"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","file":"index.cjs","sourcesContent":["import type {\n  FileContent,\n  FileStat,\n  FileEntry,\n  ReadOptions,\n  WriteOptions,\n  ListOptions,\n  RemoveOptions,\n  CopyOptions,\n  FilesystemIcon,\n  FilesystemInfo,\n  ProviderStatus,\n  MastraFilesystemOptions,\n} from '@mastra/core/workspace';\nimport {\n  MastraFilesystem,\n  FileNotFoundError,\n  FileExistsError,\n  DirectoryNotEmptyError,\n  WorkspaceReadOnlyError,\n} from '@mastra/core/workspace';\nimport type { Files, StoredFile as SDKStoredFile } from 'files-sdk';\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\nexport interface FilesSDKFilesystemOptions extends MastraFilesystemOptions {\n  /** Pre-configured FilesSDK `Files` instance. */\n  files: Files;\n  /** Unique filesystem ID (auto-generated if not provided). */\n  id?: string;\n  /** Human-friendly display name for UI. */\n  displayName?: string;\n  /** Icon identifier for UI. */\n  icon?: FilesystemIcon;\n  /** Description shown in UI / instructions. */\n  description?: string;\n  /** Mount as read-only — all write operations will throw. */\n  readOnly?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Normalize a POSIX-style path to an object-storage key.\n * Strips leading slashes, resolves `.`/`./` to empty string.\n */\nfunction toKey(path: string): string {\n  // Strip leading slashes (avoid regex backtracking concerns flagged by CodeQL\n  // — these are character-class loops that are linear, but explicit indexing\n  // sidesteps any analyzer false positives).\n  let start = 0;\n  while (start < path.length && path.charCodeAt(start) === 47 /* \"/\" */) start++;\n  let end = path.length;\n  while (end > start && path.charCodeAt(end - 1) === 47) end--;\n  const key = path.slice(start, end);\n  if (key === '.' || key === './') return '';\n  return key;\n}\n\n/**\n * Extract the basename (last path segment) from a key.\n */\nfunction basename(key: string): string {\n  const idx = key.lastIndexOf('/');\n  return idx === -1 ? key : key.slice(idx + 1);\n}\n\n/**\n * Walk the FilesSDK error code chain.\n *\n * FilesSDK frequently wraps an inner `NotFound` / `Unauthorized` error in an\n * outer `Provider` error (`error.cause` carries the original). Some adapters\n * may wrap multiple levels deep, so we walk the cause chain and return any\n * matching code found along the way.\n */\nfunction hasFilesSDKCode(err: unknown, code: string, depth = 0): boolean {\n  if (depth > 5 || !err || typeof err !== 'object') return false;\n  const e = err as { code?: unknown; cause?: unknown };\n  if (e.code === code) return true;\n  if (e.cause) return hasFilesSDKCode(e.cause, code, depth + 1);\n  return false;\n}\n\nfunction isNotFoundError(err: unknown): boolean {\n  return hasFilesSDKCode(err, 'NotFound');\n}\n\nfunction isUnauthorizedError(err: unknown): boolean {\n  return hasFilesSDKCode(err, 'Unauthorized');\n}\n\nfunction generateId(): string {\n  return `files-sdk-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;\n}\n\n/**\n * Convert FileContent (string | Buffer | Uint8Array) to a body acceptable by files-sdk.\n */\nfunction toBody(content: FileContent): string | Uint8Array {\n  if (typeof content === 'string') return content;\n  if (Buffer.isBuffer(content)) return new Uint8Array(content);\n  return content;\n}\n\n/**\n * Infer MIME type from a file path extension.\n */\nconst MIME_TYPES: Record<string, string> = {\n  '.txt': 'text/plain',\n  '.md': 'text/markdown',\n  '.markdown': 'text/markdown',\n  '.html': 'text/html',\n  '.htm': 'text/html',\n  '.css': 'text/css',\n  '.csv': 'text/csv',\n  '.xml': 'text/xml',\n  '.js': 'text/javascript',\n  '.mjs': 'text/javascript',\n  '.ts': 'text/typescript',\n  '.tsx': 'text/typescript',\n  '.jsx': 'text/javascript',\n  '.json': 'application/json',\n  '.yaml': 'text/yaml',\n  '.yml': 'text/yaml',\n  '.py': 'text/x-python',\n  '.rb': 'text/x-ruby',\n  '.sh': 'text/x-shellscript',\n  '.bash': 'text/x-shellscript',\n  '.png': 'image/png',\n  '.jpg': 'image/jpeg',\n  '.jpeg': 'image/jpeg',\n  '.gif': 'image/gif',\n  '.svg': 'image/svg+xml',\n  '.webp': 'image/webp',\n  '.ico': 'image/x-icon',\n  '.pdf': 'application/pdf',\n  '.zip': 'application/zip',\n  '.gz': 'application/gzip',\n  '.tar': 'application/x-tar',\n};\n\nfunction getMimeType(path: string): string {\n  const dot = path.lastIndexOf('.');\n  if (dot === -1) return 'application/octet-stream';\n  return MIME_TYPES[path.slice(dot).toLowerCase()] ?? 'application/octet-stream';\n}\n\n// ---------------------------------------------------------------------------\n// FilesSDKFilesystem\n// ---------------------------------------------------------------------------\n\n/**\n * Workspace filesystem adapter backed by [FilesSDK](https://files-sdk.dev).\n *\n * Accepts a pre-configured `Files` instance so users choose their own adapter\n * (S3, R2, GCS, Azure, local fs, etc.) and this class bridges it to the\n * Mastra `WorkspaceFilesystem` interface.\n *\n * Object-storage semantics are bridged to the POSIX-like interface:\n * - `mkdir` is a no-op (directories don't exist in object storage)\n * - `readdir` uses `list()` with prefix filtering to synthesize directory entries\n * - `rmdir` lists all keys under a prefix and batch-deletes them\n */\nexport class FilesSDKFilesystem extends MastraFilesystem {\n  readonly id: string;\n  readonly name = 'FilesSDKFilesystem';\n  readonly provider = 'files-sdk';\n  status: ProviderStatus = 'pending';\n\n  readonly readOnly?: boolean;\n  readonly icon?: FilesystemIcon;\n  readonly displayName?: string;\n  readonly description?: string;\n\n  private readonly _files: Files;\n\n  constructor(options: FilesSDKFilesystemOptions) {\n    super({ name: 'FilesSDKFilesystem', ...options });\n\n    this._files = options.files;\n    this.id = options.id ?? generateId();\n    this.readOnly = options.readOnly;\n    this.icon = options.icon;\n    this.displayName = options.displayName;\n    this.description = options.description;\n  }\n\n  /** The underlying FilesSDK instance, for escape-hatch access. */\n  get files(): Files {\n    return this._files;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Lifecycle\n  // ---------------------------------------------------------------------------\n\n  override async init(): Promise<void> {\n    // Verify connectivity by listing at most 1 key\n    try {\n      await this._files.list({ limit: 1 });\n    } catch (err) {\n      if (isUnauthorizedError(err)) {\n        throw new Error('Access denied — check credentials and storage permissions');\n      }\n      throw err;\n    }\n  }\n\n  // destroy() — default no-op is fine; FilesSDK has no explicit teardown.\n\n  getInfo(): FilesystemInfo {\n    return {\n      id: this.id,\n      name: this.name,\n      provider: this.provider,\n      status: this.status,\n      error: this.error,\n      readOnly: this.readOnly,\n      icon: this.icon,\n      metadata: {\n        adapter: this._files.adapter?.name ?? 'unknown',\n      },\n    };\n  }\n\n  getInstructions(): string {\n    const adapterName = this._files.adapter?.name ?? 'unknown';\n    const parts = [`Unified storage via FilesSDK (${adapterName} adapter).`];\n    if (this.readOnly) parts.push('Mounted read-only.');\n    parts.push('Persistent storage — files are retained across sessions.');\n    return parts.join(' ');\n  }\n\n  // ---------------------------------------------------------------------------\n  // File operations\n  // ---------------------------------------------------------------------------\n\n  async readFile(path: string, options?: ReadOptions): Promise<string | Buffer> {\n    await this.ensureReady();\n    const key = toKey(path);\n\n    try {\n      const file = await this._files.download(key);\n      const buf = Buffer.from(await file.arrayBuffer());\n      if (options?.encoding) return buf.toString(options.encoding);\n      return buf;\n    } catch (err) {\n      if (isNotFoundError(err)) throw new FileNotFoundError(path);\n      throw err;\n    }\n  }\n\n  async writeFile(path: string, content: FileContent, options?: WriteOptions): Promise<void> {\n    await this.ensureReady();\n    this.assertWritable('writeFile');\n    const key = toKey(path);\n\n    // Respect overwrite option (default: true). Use isFile() rather than\n    // _files.exists() so leftover empty directories (some adapters) don't\n    // incorrectly trigger FileExistsError.\n    if (options?.overwrite === false && (await this.isFile(key))) {\n      throw new FileExistsError(path);\n    }\n\n    const body = toBody(content);\n    await this._files.upload(key, body, {\n      contentType: options?.mimeType ?? getMimeType(path),\n    });\n  }\n\n  /**\n   * Append content to a file.\n   *\n   * **Not atomic.** Object storage has no native append, so this is implemented\n   * as a read-modify-write: the existing object is downloaded, the new content\n   * is concatenated, and the result is uploaded as a new object. Concurrent\n   * appends to the same key may overwrite each other. This limitation is\n   * inherent to object storage, not specific to FilesSDK, and matches the\n   * behavior of the sibling S3, GCS, and Azure workspace providers.\n   */\n  async appendFile(path: string, content: FileContent): Promise<void> {\n    await this.ensureReady();\n    this.assertWritable('appendFile');\n    const key = toKey(path);\n\n    // Read-modify-write (object storage has no native append)\n    let existing = Buffer.alloc(0);\n    try {\n      const file = await this._files.download(key);\n      existing = Buffer.from(await file.arrayBuffer());\n    } catch (err) {\n      if (!isNotFoundError(err)) throw err;\n      // File doesn't exist yet — start fresh\n    }\n\n    const append = typeof content === 'string' ? Buffer.from(content) : toBody(content);\n    const merged = Buffer.concat([existing, Buffer.isBuffer(append) ? append : Buffer.from(append as Uint8Array)]);\n\n    await this._files.upload(key, new Uint8Array(merged), {\n      contentType: getMimeType(path),\n    });\n  }\n\n  async deleteFile(path: string, options?: RemoveOptions): Promise<void> {\n    await this.ensureReady();\n    this.assertWritable('deleteFile');\n    const key = toKey(path);\n\n    // If the path is a directory, recursively delete (matches sibling\n    // filesystems like S3/GCS). Object storage has no first-class directories,\n    // so callers calling deleteFile on a prefix expect it to clean up.\n    if (await this.isDirectory(key)) {\n      await this.rmdir(path, { recursive: true, force: options?.force });\n      return;\n    }\n\n    // Some FilesSDK adapters (notably the local `fs` adapter) silently succeed\n    // when deleting a non-existent key instead of raising `NotFound`. Match the\n    // shared filesystem contract (and S3/GCS behavior) by checking existence\n    // first when `force` is not set.\n    if (!options?.force && !(await this.isFile(key))) {\n      throw new FileNotFoundError(path);\n    }\n\n    try {\n      await this._files.delete(key);\n    } catch (err) {\n      if (options?.force) return;\n      if (isNotFoundError(err)) throw new FileNotFoundError(path);\n      throw err;\n    }\n  }\n\n  async copyFile(src: string, dest: string, options?: CopyOptions): Promise<void> {\n    await this.ensureReady();\n    this.assertWritable('copyFile');\n    const fromKey = toKey(src);\n    const toKey_ = toKey(dest);\n\n    if (options?.overwrite === false && (await this.isFile(toKey_))) {\n      throw new FileExistsError(dest);\n    }\n\n    try {\n      await this._files.copy(fromKey, toKey_);\n    } catch (err) {\n      if (isNotFoundError(err)) throw new FileNotFoundError(src);\n      throw err;\n    }\n  }\n\n  async moveFile(src: string, dest: string, options?: CopyOptions): Promise<void> {\n    // Object storage has no atomic rename. Mirrors the S3/GCS pattern:\n    // copy first; if that succeeds, force-delete the source.\n    await this.copyFile(src, dest, options);\n    await this.deleteFile(src, { force: true });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Directory operations\n  // ---------------------------------------------------------------------------\n\n  async mkdir(_path: string, _options?: { recursive?: boolean }): Promise<void> {\n    await this.ensureReady();\n    this.assertWritable('mkdir');\n    // No-op: object storage creates \"directories\" implicitly on file write.\n  }\n\n  async rmdir(path: string, options?: RemoveOptions): Promise<void> {\n    await this.ensureReady();\n    this.assertWritable('rmdir');\n    const key = toKey(path);\n    const prefix = key ? `${key}/` : '';\n\n    // List all keys under the prefix\n    const allKeys: string[] = [];\n    let cursor: string | undefined;\n\n    do {\n      const result = await this._files.list({ prefix, cursor, limit: 1000 });\n      for (const item of result.items) {\n        allKeys.push(item.key);\n      }\n      cursor = result.cursor;\n    } while (cursor);\n\n    if (allKeys.length === 0) return;\n\n    // Non-recursive: fail if directory is not empty\n    if (!options?.recursive) {\n      throw new DirectoryNotEmptyError(path);\n    }\n\n    // Batch delete all keys\n    await this._files.delete(allKeys);\n  }\n\n  async readdir(path: string, options?: ListOptions): Promise<FileEntry[]> {\n    await this.ensureReady();\n    const key = toKey(path);\n    const prefix = key ? `${key}/` : '';\n\n    const entries: FileEntry[] = [];\n    const seenDirs = new Set<string>();\n\n    let cursor: string | undefined;\n    const maxDepth = options?.maxDepth;\n    const recursive = options?.recursive ?? false;\n    const extensions = options?.extension\n      ? Array.isArray(options.extension)\n        ? options.extension\n        : [options.extension]\n      : undefined;\n\n    do {\n      const result = await this._files.list({ prefix, cursor, limit: 1000 });\n\n      for (const item of result.items) {\n        // item.key is relative to the Files instance's prefix.\n        // We need to get the portion after our directory prefix.\n        const relativePath = prefix ? item.key.slice(prefix.length) : item.key;\n        if (!relativePath) continue;\n\n        const segments = relativePath.split('/');\n\n        if (segments.length === 1) {\n          // Direct child (file)\n          const name = segments[0]!;\n\n          // Extension filter\n          if (extensions) {\n            const ext = name.lastIndexOf('.') !== -1 ? name.slice(name.lastIndexOf('.')) : '';\n            if (!extensions.includes(ext)) continue;\n          }\n\n          entries.push({\n            name,\n            type: 'file',\n            size: item.size,\n          });\n        } else if (!recursive) {\n          // Non-recursive: synthesize a directory entry for the first segment only.\n          const dirName = segments[0]!;\n          if (!seenDirs.has(dirName)) {\n            seenDirs.add(dirName);\n            entries.push({\n              name: dirName,\n              type: 'directory',\n            });\n          }\n        } else {\n          // Recursive: emit every intermediate directory along the path, then the file.\n          // For \"a/b/c/file.txt\": emit \"a\", \"a/b\", \"a/b/c\" as directories, then the file.\n          for (let i = 1; i < segments.length; i++) {\n            const dirPath = segments.slice(0, i).join('/');\n            const dirDepth = i; // number of segments in dirPath\n            if (maxDepth !== undefined && dirDepth > maxDepth) continue;\n            if (!seenDirs.has(dirPath)) {\n              seenDirs.add(dirPath);\n              entries.push({\n                name: dirPath,\n                type: 'directory',\n              });\n            }\n          }\n\n          // Depth check for the file itself\n          if (maxDepth !== undefined && segments.length > maxDepth) continue;\n\n          const name = relativePath;\n          if (extensions) {\n            const ext = name.lastIndexOf('.') !== -1 ? name.slice(name.lastIndexOf('.')) : '';\n            if (!extensions.includes(ext)) continue;\n          }\n\n          entries.push({\n            name,\n            type: 'file',\n            size: item.size,\n          });\n        }\n      }\n\n      cursor = result.cursor;\n    } while (cursor);\n\n    return entries;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Path operations\n  // ---------------------------------------------------------------------------\n\n  async exists(path: string): Promise<boolean> {\n    await this.ensureReady();\n    const key = toKey(path);\n\n    // Root always exists\n    if (!key) return true;\n\n    // Check as directory first (any key under this prefix). Doing the prefix\n    // list before the per-key check matters for adapters like FilesSDK's `fs`\n    // that leave empty parent directories on disk after their contents are\n    // deleted — those would otherwise report true via `_files.exists` even\n    // though no objects exist there. Object-store semantics: a \"directory\"\n    // exists iff it has children.\n    if (await this.isDirectory(key)) return true;\n\n    // Check as a real stored file. We deliberately avoid `_files.exists(key)`\n    // here because some adapters (e.g. the local `fs` adapter) consider an\n    // empty leftover directory to exist as a key, which would break\n    // object-store semantics. A prefix list constrained to the exact key only\n    // matches actually-stored files.\n    return this.isFile(key);\n  }\n\n  async stat(path: string): Promise<FileStat> {\n    await this.ensureReady();\n    const key = toKey(path);\n\n    // Root is a directory\n    if (!key) {\n      const now = new Date();\n      return {\n        name: '/',\n        path: '/',\n        type: 'directory',\n        size: 0,\n        createdAt: now,\n        modifiedAt: now,\n      };\n    }\n\n    // Try as file first\n    try {\n      const file = await this._files.head(key);\n      return this.storedFileToStat(file, path);\n    } catch (err) {\n      if (!isNotFoundError(err)) throw err;\n    }\n\n    // Try as directory\n    if (await this.isDirectory(key)) {\n      const now = new Date();\n      return {\n        name: basename(key),\n        path,\n        type: 'directory',\n        size: 0,\n        createdAt: now,\n        modifiedAt: now,\n      };\n    }\n\n    throw new FileNotFoundError(path);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private helpers\n  // ---------------------------------------------------------------------------\n\n  private assertWritable(operation: string): void {\n    if (this.readOnly) {\n      throw new WorkspaceReadOnlyError(operation);\n    }\n  }\n\n  /** Check if a key prefix has any children (i.e. acts like a directory). */\n  private async isDirectory(key: string): Promise<boolean> {\n    if (!key) return true; // root\n    const prefix = `${key}/`;\n    const result = await this._files.list({ prefix, limit: 1 });\n    return result.items.length > 0;\n  }\n\n  /**\n   * Check whether `key` refers to a real stored file (not an empty leftover\n   * directory). Uses prefix listing constrained to the exact key, which only\n   * matches actually-stored objects across all adapters.\n   */\n  private async isFile(key: string): Promise<boolean> {\n    if (!key) return false;\n    const result = await this._files.list({ prefix: key, limit: 10 });\n    return result.items.some(item => item.key === key);\n  }\n\n  /** Convert a FilesSDK StoredFile to a Mastra FileStat. */\n  private storedFileToStat(file: SDKStoredFile, path: string): FileStat {\n    return {\n      name: basename(file.key ?? path),\n      path,\n      type: 'file',\n      size: file.size ?? 0,\n      createdAt: file.lastModified ? new Date(file.lastModified) : new Date(),\n      modifiedAt: file.lastModified ? new Date(file.lastModified) : new Date(),\n      mimeType: file.type || undefined,\n    };\n  }\n}\n","/**\n * FilesSDK filesystem provider descriptor for MastraEditor.\n *\n * @example\n * ```typescript\n * import { filesSDKFilesystemProvider } from '@mastra/files-sdk';\n *\n * const editor = new MastraEditor({\n *   filesystems: [filesSDKFilesystemProvider],\n * });\n * ```\n */\nimport type { FilesystemProvider } from '@mastra/core/editor';\nimport { FilesSDKFilesystem } from './filesystem';\nimport type { FilesSDKFilesystemOptions } from './filesystem';\n\nexport const filesSDKFilesystemProvider: FilesystemProvider<FilesSDKFilesystemOptions> = {\n  id: 'files-sdk',\n  name: 'FilesSDK (Unified Storage)',\n  description: 'Unified storage via FilesSDK — supports S3, R2, GCS, Azure, Vercel Blob, local filesystem, and more',\n  configSchema: {\n    type: 'object',\n    required: ['files'],\n    properties: {\n      files: { type: 'object', description: 'Pre-configured FilesSDK Files instance' },\n      id: { type: 'string', description: 'Unique filesystem ID' },\n      displayName: { type: 'string', description: 'Human-friendly display name' },\n      icon: { type: 'string', description: 'Icon identifier for UI' },\n      description: { type: 'string', description: 'Description for UI' },\n      readOnly: { type: 'boolean', description: 'Mount as read-only', default: false },\n    },\n  },\n  createFilesystem: config => new FilesSDKFilesystem(config),\n};\n"]}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @mastra/files-sdk - Unified Storage Filesystem Provider
+ *
+ * A filesystem implementation backed by FilesSDK (https://files-sdk.dev).
+ * Works with any FilesSDK adapter: S3, R2, GCS, Azure Blob, Vercel Blob,
+ * local filesystem, and more.
+ */
+export { FilesSDKFilesystem, type FilesSDKFilesystemOptions } from './filesystem/index.js';
+export { filesSDKFilesystemProvider } from './provider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,424 @@
+import { MastraFilesystem, FileNotFoundError, FileExistsError, DirectoryNotEmptyError, WorkspaceReadOnlyError } from '@mastra/core/workspace';
+
+// src/filesystem/index.ts
+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;
+}
+function basename(key) {
+  const idx = key.lastIndexOf("/");
+  return idx === -1 ? key : key.slice(idx + 1);
+}
+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;
+}
+function isNotFoundError(err) {
+  return hasFilesSDKCode(err, "NotFound");
+}
+function isUnauthorizedError(err) {
+  return hasFilesSDKCode(err, "Unauthorized");
+}
+function generateId() {
+  return `files-sdk-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+}
+function toBody(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"
+};
+function getMimeType(path) {
+  const dot = path.lastIndexOf(".");
+  if (dot === -1) return "application/octet-stream";
+  return MIME_TYPES[path.slice(dot).toLowerCase()] ?? "application/octet-stream";
+}
+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
+    };
+  }
+};
+
+// 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)
+};
+
+export { FilesSDKFilesystem, filesSDKFilesystemProvider };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/filesystem/index.ts","../src/provider.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type {\n  FileContent,\n  FileStat,\n  FileEntry,\n  ReadOptions,\n  WriteOptions,\n  ListOptions,\n  RemoveOptions,\n  CopyOptions,\n  FilesystemIcon,\n  FilesystemInfo,\n  ProviderStatus,\n  MastraFilesystemOptions,\n} from '@mastra/core/workspace';\nimport {\n  MastraFilesystem,\n  FileNotFoundError,\n  FileExistsError,\n  DirectoryNotEmptyError,\n  WorkspaceReadOnlyError,\n} from '@mastra/core/workspace';\nimport type { Files, StoredFile as SDKStoredFile } from 'files-sdk';\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\nexport interface FilesSDKFilesystemOptions extends MastraFilesystemOptions {\n  /** Pre-configured FilesSDK `Files` instance. */\n  files: Files;\n  /** Unique filesystem ID (auto-generated if not provided). */\n  id?: string;\n  /** Human-friendly display name for UI. */\n  displayName?: string;\n  /** Icon identifier for UI. */\n  icon?: FilesystemIcon;\n  /** Description shown in UI / instructions. */\n  description?: string;\n  /** Mount as read-only — all write operations will throw. */\n  readOnly?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Normalize a POSIX-style path to an object-storage key.\n * Strips leading slashes, resolves `.`/`./` to empty string.\n */\nfunction toKey(path: string): string {\n  // Strip leading slashes (avoid regex backtracking concerns flagged by CodeQL\n  // — these are character-class loops that are linear, but explicit indexing\n  // sidesteps any analyzer false positives).\n  let start = 0;\n  while (start < path.length && path.charCodeAt(start) === 47 /* \"/\" */) start++;\n  let end = path.length;\n  while (end > start && path.charCodeAt(end - 1) === 47) end--;\n  const key = path.slice(start, end);\n  if (key === '.' || key === './') return '';\n  return key;\n}\n\n/**\n * Extract the basename (last path segment) from a key.\n */\nfunction basename(key: string): string {\n  const idx = key.lastIndexOf('/');\n  return idx === -1 ? key : key.slice(idx + 1);\n}\n\n/**\n * Walk the FilesSDK error code chain.\n *\n * FilesSDK frequently wraps an inner `NotFound` / `Unauthorized` error in an\n * outer `Provider` error (`error.cause` carries the original). Some adapters\n * may wrap multiple levels deep, so we walk the cause chain and return any\n * matching code found along the way.\n */\nfunction hasFilesSDKCode(err: unknown, code: string, depth = 0): boolean {\n  if (depth > 5 || !err || typeof err !== 'object') return false;\n  const e = err as { code?: unknown; cause?: unknown };\n  if (e.code === code) return true;\n  if (e.cause) return hasFilesSDKCode(e.cause, code, depth + 1);\n  return false;\n}\n\nfunction isNotFoundError(err: unknown): boolean {\n  return hasFilesSDKCode(err, 'NotFound');\n}\n\nfunction isUnauthorizedError(err: unknown): boolean {\n  return hasFilesSDKCode(err, 'Unauthorized');\n}\n\nfunction generateId(): string {\n  return `files-sdk-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;\n}\n\n/**\n * Convert FileContent (string | Buffer | Uint8Array) to a body acceptable by files-sdk.\n */\nfunction toBody(content: FileContent): string | Uint8Array {\n  if (typeof content === 'string') return content;\n  if (Buffer.isBuffer(content)) return new Uint8Array(content);\n  return content;\n}\n\n/**\n * Infer MIME type from a file path extension.\n */\nconst MIME_TYPES: Record<string, string> = {\n  '.txt': 'text/plain',\n  '.md': 'text/markdown',\n  '.markdown': 'text/markdown',\n  '.html': 'text/html',\n  '.htm': 'text/html',\n  '.css': 'text/css',\n  '.csv': 'text/csv',\n  '.xml': 'text/xml',\n  '.js': 'text/javascript',\n  '.mjs': 'text/javascript',\n  '.ts': 'text/typescript',\n  '.tsx': 'text/typescript',\n  '.jsx': 'text/javascript',\n  '.json': 'application/json',\n  '.yaml': 'text/yaml',\n  '.yml': 'text/yaml',\n  '.py': 'text/x-python',\n  '.rb': 'text/x-ruby',\n  '.sh': 'text/x-shellscript',\n  '.bash': 'text/x-shellscript',\n  '.png': 'image/png',\n  '.jpg': 'image/jpeg',\n  '.jpeg': 'image/jpeg',\n  '.gif': 'image/gif',\n  '.svg': 'image/svg+xml',\n  '.webp': 'image/webp',\n  '.ico': 'image/x-icon',\n  '.pdf': 'application/pdf',\n  '.zip': 'application/zip',\n  '.gz': 'application/gzip',\n  '.tar': 'application/x-tar',\n};\n\nfunction getMimeType(path: string): string {\n  const dot = path.lastIndexOf('.');\n  if (dot === -1) return 'application/octet-stream';\n  return MIME_TYPES[path.slice(dot).toLowerCase()] ?? 'application/octet-stream';\n}\n\n// ---------------------------------------------------------------------------\n// FilesSDKFilesystem\n// ---------------------------------------------------------------------------\n\n/**\n * Workspace filesystem adapter backed by [FilesSDK](https://files-sdk.dev).\n *\n * Accepts a pre-configured `Files` instance so users choose their own adapter\n * (S3, R2, GCS, Azure, local fs, etc.) and this class bridges it to the\n * Mastra `WorkspaceFilesystem` interface.\n *\n * Object-storage semantics are bridged to the POSIX-like interface:\n * - `mkdir` is a no-op (directories don't exist in object storage)\n * - `readdir` uses `list()` with prefix filtering to synthesize directory entries\n * - `rmdir` lists all keys under a prefix and batch-deletes them\n */\nexport class FilesSDKFilesystem extends MastraFilesystem {\n  readonly id: string;\n  readonly name = 'FilesSDKFilesystem';\n  readonly provider = 'files-sdk';\n  status: ProviderStatus = 'pending';\n\n  readonly readOnly?: boolean;\n  readonly icon?: FilesystemIcon;\n  readonly displayName?: string;\n  readonly description?: string;\n\n  private readonly _files: Files;\n\n  constructor(options: FilesSDKFilesystemOptions) {\n    super({ name: 'FilesSDKFilesystem', ...options });\n\n    this._files = options.files;\n    this.id = options.id ?? generateId();\n    this.readOnly = options.readOnly;\n    this.icon = options.icon;\n    this.displayName = options.displayName;\n    this.description = options.description;\n  }\n\n  /** The underlying FilesSDK instance, for escape-hatch access. */\n  get files(): Files {\n    return this._files;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Lifecycle\n  // ---------------------------------------------------------------------------\n\n  override async init(): Promise<void> {\n    // Verify connectivity by listing at most 1 key\n    try {\n      await this._files.list({ limit: 1 });\n    } catch (err) {\n      if (isUnauthorizedError(err)) {\n        throw new Error('Access denied — check credentials and storage permissions');\n      }\n      throw err;\n    }\n  }\n\n  // destroy() — default no-op is fine; FilesSDK has no explicit teardown.\n\n  getInfo(): FilesystemInfo {\n    return {\n      id: this.id,\n      name: this.name,\n      provider: this.provider,\n      status: this.status,\n      error: this.error,\n      readOnly: this.readOnly,\n      icon: this.icon,\n      metadata: {\n        adapter: this._files.adapter?.name ?? 'unknown',\n      },\n    };\n  }\n\n  getInstructions(): string {\n    const adapterName = this._files.adapter?.name ?? 'unknown';\n    const parts = [`Unified storage via FilesSDK (${adapterName} adapter).`];\n    if (this.readOnly) parts.push('Mounted read-only.');\n    parts.push('Persistent storage — files are retained across sessions.');\n    return parts.join(' ');\n  }\n\n  // ---------------------------------------------------------------------------\n  // File operations\n  // ---------------------------------------------------------------------------\n\n  async readFile(path: string, options?: ReadOptions): Promise<string | Buffer> {\n    await this.ensureReady();\n    const key = toKey(path);\n\n    try {\n      const file = await this._files.download(key);\n      const buf = Buffer.from(await file.arrayBuffer());\n      if (options?.encoding) return buf.toString(options.encoding);\n      return buf;\n    } catch (err) {\n      if (isNotFoundError(err)) throw new FileNotFoundError(path);\n      throw err;\n    }\n  }\n\n  async writeFile(path: string, content: FileContent, options?: WriteOptions): Promise<void> {\n    await this.ensureReady();\n    this.assertWritable('writeFile');\n    const key = toKey(path);\n\n    // Respect overwrite option (default: true). Use isFile() rather than\n    // _files.exists() so leftover empty directories (some adapters) don't\n    // incorrectly trigger FileExistsError.\n    if (options?.overwrite === false && (await this.isFile(key))) {\n      throw new FileExistsError(path);\n    }\n\n    const body = toBody(content);\n    await this._files.upload(key, body, {\n      contentType: options?.mimeType ?? getMimeType(path),\n    });\n  }\n\n  /**\n   * Append content to a file.\n   *\n   * **Not atomic.** Object storage has no native append, so this is implemented\n   * as a read-modify-write: the existing object is downloaded, the new content\n   * is concatenated, and the result is uploaded as a new object. Concurrent\n   * appends to the same key may overwrite each other. This limitation is\n   * inherent to object storage, not specific to FilesSDK, and matches the\n   * behavior of the sibling S3, GCS, and Azure workspace providers.\n   */\n  async appendFile(path: string, content: FileContent): Promise<void> {\n    await this.ensureReady();\n    this.assertWritable('appendFile');\n    const key = toKey(path);\n\n    // Read-modify-write (object storage has no native append)\n    let existing = Buffer.alloc(0);\n    try {\n      const file = await this._files.download(key);\n      existing = Buffer.from(await file.arrayBuffer());\n    } catch (err) {\n      if (!isNotFoundError(err)) throw err;\n      // File doesn't exist yet — start fresh\n    }\n\n    const append = typeof content === 'string' ? Buffer.from(content) : toBody(content);\n    const merged = Buffer.concat([existing, Buffer.isBuffer(append) ? append : Buffer.from(append as Uint8Array)]);\n\n    await this._files.upload(key, new Uint8Array(merged), {\n      contentType: getMimeType(path),\n    });\n  }\n\n  async deleteFile(path: string, options?: RemoveOptions): Promise<void> {\n    await this.ensureReady();\n    this.assertWritable('deleteFile');\n    const key = toKey(path);\n\n    // If the path is a directory, recursively delete (matches sibling\n    // filesystems like S3/GCS). Object storage has no first-class directories,\n    // so callers calling deleteFile on a prefix expect it to clean up.\n    if (await this.isDirectory(key)) {\n      await this.rmdir(path, { recursive: true, force: options?.force });\n      return;\n    }\n\n    // Some FilesSDK adapters (notably the local `fs` adapter) silently succeed\n    // when deleting a non-existent key instead of raising `NotFound`. Match the\n    // shared filesystem contract (and S3/GCS behavior) by checking existence\n    // first when `force` is not set.\n    if (!options?.force && !(await this.isFile(key))) {\n      throw new FileNotFoundError(path);\n    }\n\n    try {\n      await this._files.delete(key);\n    } catch (err) {\n      if (options?.force) return;\n      if (isNotFoundError(err)) throw new FileNotFoundError(path);\n      throw err;\n    }\n  }\n\n  async copyFile(src: string, dest: string, options?: CopyOptions): Promise<void> {\n    await this.ensureReady();\n    this.assertWritable('copyFile');\n    const fromKey = toKey(src);\n    const toKey_ = toKey(dest);\n\n    if (options?.overwrite === false && (await this.isFile(toKey_))) {\n      throw new FileExistsError(dest);\n    }\n\n    try {\n      await this._files.copy(fromKey, toKey_);\n    } catch (err) {\n      if (isNotFoundError(err)) throw new FileNotFoundError(src);\n      throw err;\n    }\n  }\n\n  async moveFile(src: string, dest: string, options?: CopyOptions): Promise<void> {\n    // Object storage has no atomic rename. Mirrors the S3/GCS pattern:\n    // copy first; if that succeeds, force-delete the source.\n    await this.copyFile(src, dest, options);\n    await this.deleteFile(src, { force: true });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Directory operations\n  // ---------------------------------------------------------------------------\n\n  async mkdir(_path: string, _options?: { recursive?: boolean }): Promise<void> {\n    await this.ensureReady();\n    this.assertWritable('mkdir');\n    // No-op: object storage creates \"directories\" implicitly on file write.\n  }\n\n  async rmdir(path: string, options?: RemoveOptions): Promise<void> {\n    await this.ensureReady();\n    this.assertWritable('rmdir');\n    const key = toKey(path);\n    const prefix = key ? `${key}/` : '';\n\n    // List all keys under the prefix\n    const allKeys: string[] = [];\n    let cursor: string | undefined;\n\n    do {\n      const result = await this._files.list({ prefix, cursor, limit: 1000 });\n      for (const item of result.items) {\n        allKeys.push(item.key);\n      }\n      cursor = result.cursor;\n    } while (cursor);\n\n    if (allKeys.length === 0) return;\n\n    // Non-recursive: fail if directory is not empty\n    if (!options?.recursive) {\n      throw new DirectoryNotEmptyError(path);\n    }\n\n    // Batch delete all keys\n    await this._files.delete(allKeys);\n  }\n\n  async readdir(path: string, options?: ListOptions): Promise<FileEntry[]> {\n    await this.ensureReady();\n    const key = toKey(path);\n    const prefix = key ? `${key}/` : '';\n\n    const entries: FileEntry[] = [];\n    const seenDirs = new Set<string>();\n\n    let cursor: string | undefined;\n    const maxDepth = options?.maxDepth;\n    const recursive = options?.recursive ?? false;\n    const extensions = options?.extension\n      ? Array.isArray(options.extension)\n        ? options.extension\n        : [options.extension]\n      : undefined;\n\n    do {\n      const result = await this._files.list({ prefix, cursor, limit: 1000 });\n\n      for (const item of result.items) {\n        // item.key is relative to the Files instance's prefix.\n        // We need to get the portion after our directory prefix.\n        const relativePath = prefix ? item.key.slice(prefix.length) : item.key;\n        if (!relativePath) continue;\n\n        const segments = relativePath.split('/');\n\n        if (segments.length === 1) {\n          // Direct child (file)\n          const name = segments[0]!;\n\n          // Extension filter\n          if (extensions) {\n            const ext = name.lastIndexOf('.') !== -1 ? name.slice(name.lastIndexOf('.')) : '';\n            if (!extensions.includes(ext)) continue;\n          }\n\n          entries.push({\n            name,\n            type: 'file',\n            size: item.size,\n          });\n        } else if (!recursive) {\n          // Non-recursive: synthesize a directory entry for the first segment only.\n          const dirName = segments[0]!;\n          if (!seenDirs.has(dirName)) {\n            seenDirs.add(dirName);\n            entries.push({\n              name: dirName,\n              type: 'directory',\n            });\n          }\n        } else {\n          // Recursive: emit every intermediate directory along the path, then the file.\n          // For \"a/b/c/file.txt\": emit \"a\", \"a/b\", \"a/b/c\" as directories, then the file.\n          for (let i = 1; i < segments.length; i++) {\n            const dirPath = segments.slice(0, i).join('/');\n            const dirDepth = i; // number of segments in dirPath\n            if (maxDepth !== undefined && dirDepth > maxDepth) continue;\n            if (!seenDirs.has(dirPath)) {\n              seenDirs.add(dirPath);\n              entries.push({\n                name: dirPath,\n                type: 'directory',\n              });\n            }\n          }\n\n          // Depth check for the file itself\n          if (maxDepth !== undefined && segments.length > maxDepth) continue;\n\n          const name = relativePath;\n          if (extensions) {\n            const ext = name.lastIndexOf('.') !== -1 ? name.slice(name.lastIndexOf('.')) : '';\n            if (!extensions.includes(ext)) continue;\n          }\n\n          entries.push({\n            name,\n            type: 'file',\n            size: item.size,\n          });\n        }\n      }\n\n      cursor = result.cursor;\n    } while (cursor);\n\n    return entries;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Path operations\n  // ---------------------------------------------------------------------------\n\n  async exists(path: string): Promise<boolean> {\n    await this.ensureReady();\n    const key = toKey(path);\n\n    // Root always exists\n    if (!key) return true;\n\n    // Check as directory first (any key under this prefix). Doing the prefix\n    // list before the per-key check matters for adapters like FilesSDK's `fs`\n    // that leave empty parent directories on disk after their contents are\n    // deleted — those would otherwise report true via `_files.exists` even\n    // though no objects exist there. Object-store semantics: a \"directory\"\n    // exists iff it has children.\n    if (await this.isDirectory(key)) return true;\n\n    // Check as a real stored file. We deliberately avoid `_files.exists(key)`\n    // here because some adapters (e.g. the local `fs` adapter) consider an\n    // empty leftover directory to exist as a key, which would break\n    // object-store semantics. A prefix list constrained to the exact key only\n    // matches actually-stored files.\n    return this.isFile(key);\n  }\n\n  async stat(path: string): Promise<FileStat> {\n    await this.ensureReady();\n    const key = toKey(path);\n\n    // Root is a directory\n    if (!key) {\n      const now = new Date();\n      return {\n        name: '/',\n        path: '/',\n        type: 'directory',\n        size: 0,\n        createdAt: now,\n        modifiedAt: now,\n      };\n    }\n\n    // Try as file first\n    try {\n      const file = await this._files.head(key);\n      return this.storedFileToStat(file, path);\n    } catch (err) {\n      if (!isNotFoundError(err)) throw err;\n    }\n\n    // Try as directory\n    if (await this.isDirectory(key)) {\n      const now = new Date();\n      return {\n        name: basename(key),\n        path,\n        type: 'directory',\n        size: 0,\n        createdAt: now,\n        modifiedAt: now,\n      };\n    }\n\n    throw new FileNotFoundError(path);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private helpers\n  // ---------------------------------------------------------------------------\n\n  private assertWritable(operation: string): void {\n    if (this.readOnly) {\n      throw new WorkspaceReadOnlyError(operation);\n    }\n  }\n\n  /** Check if a key prefix has any children (i.e. acts like a directory). */\n  private async isDirectory(key: string): Promise<boolean> {\n    if (!key) return true; // root\n    const prefix = `${key}/`;\n    const result = await this._files.list({ prefix, limit: 1 });\n    return result.items.length > 0;\n  }\n\n  /**\n   * Check whether `key` refers to a real stored file (not an empty leftover\n   * directory). Uses prefix listing constrained to the exact key, which only\n   * matches actually-stored objects across all adapters.\n   */\n  private async isFile(key: string): Promise<boolean> {\n    if (!key) return false;\n    const result = await this._files.list({ prefix: key, limit: 10 });\n    return result.items.some(item => item.key === key);\n  }\n\n  /** Convert a FilesSDK StoredFile to a Mastra FileStat. */\n  private storedFileToStat(file: SDKStoredFile, path: string): FileStat {\n    return {\n      name: basename(file.key ?? path),\n      path,\n      type: 'file',\n      size: file.size ?? 0,\n      createdAt: file.lastModified ? new Date(file.lastModified) : new Date(),\n      modifiedAt: file.lastModified ? new Date(file.lastModified) : new Date(),\n      mimeType: file.type || undefined,\n    };\n  }\n}\n","/**\n * FilesSDK filesystem provider descriptor for MastraEditor.\n *\n * @example\n * ```typescript\n * import { filesSDKFilesystemProvider } from '@mastra/files-sdk';\n *\n * const editor = new MastraEditor({\n *   filesystems: [filesSDKFilesystemProvider],\n * });\n * ```\n */\nimport type { FilesystemProvider } from '@mastra/core/editor';\nimport { FilesSDKFilesystem } from './filesystem';\nimport type { FilesSDKFilesystemOptions } from './filesystem';\n\nexport const filesSDKFilesystemProvider: FilesystemProvider<FilesSDKFilesystemOptions> = {\n  id: 'files-sdk',\n  name: 'FilesSDK (Unified Storage)',\n  description: 'Unified storage via FilesSDK — supports S3, R2, GCS, Azure, Vercel Blob, local filesystem, and more',\n  configSchema: {\n    type: 'object',\n    required: ['files'],\n    properties: {\n      files: { type: 'object', description: 'Pre-configured FilesSDK Files instance' },\n      id: { type: 'string', description: 'Unique filesystem ID' },\n      displayName: { type: 'string', description: 'Human-friendly display name' },\n      icon: { type: 'string', description: 'Icon identifier for UI' },\n      description: { type: 'string', description: 'Description for UI' },\n      readOnly: { type: 'boolean', description: 'Mount as read-only', default: false },\n    },\n  },\n  createFilesystem: config => new FilesSDKFilesystem(config),\n};\n"]}

package/dist/provider.d.ts

@@ -0,0 +1,16 @@
+/**
+ * FilesSDK filesystem provider descriptor for MastraEditor.
+ *
+ * @example
+ * ```typescript
+ * import { filesSDKFilesystemProvider } from '@mastra/files-sdk';
+ *
+ * const editor = new MastraEditor({
+ *   filesystems: [filesSDKFilesystemProvider],
+ * });
+ * ```
+ */
+import type { FilesystemProvider } from '@mastra/core/editor';
+import type { FilesSDKFilesystemOptions } from './filesystem/index.js';
+export declare const filesSDKFilesystemProvider: FilesystemProvider<FilesSDKFilesystemOptions>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAE9D,eAAO,MAAM,0BAA0B,EAAE,kBAAkB,CAAC,yBAAyB,CAiBpF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/files-sdk",
-  "version": "0.0.0",
+  "version": "0.2.0-alpha.0",
   "description": "FilesSDK filesystem provider for Mastra workspaces — unified storage across S3, R2, GCS, Azure, Vercel Blob, and more",
   "type": "module",
   "main": "dist/index.js",
@@ -30,8 +30,8 @@
     "vitest": "4.1.5",
     "@internal/lint": "0.0.97",
     "@internal/types-builder": "0.0.72",
-    "@mastra/core": "1.37.0-alpha.7",
-    "@internal/workspace-test-utils": "0.0.41"
+    "@internal/workspace-test-utils": "0.0.41",
+    "@mastra/core": "1.37.0-alpha.8"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.4.0-0 <2.0.0-0"
@@ -57,7 +57,7 @@
     "build:lib": "pnpm build",
     "build:watch": "pnpm build --watch",
     "test:unit": "vitest run --exclude '**/*.integration.test.ts'",
-    "test:integration": "vitest run ./src/**/*.integration.test.ts",
+    "test:cloud": "vitest run ./src/**/*.integration.test.ts",
     "test:watch": "vitest watch",
     "lint": "eslint ."
   }