@mastra/s3 0.0.0

package/dist/index.js

@@ -0,0 +1,584 @@
+import { S3Client, GetObjectCommand, PutObjectCommand, DeleteObjectCommand, CopyObjectCommand, ListObjectsV2Command, DeleteObjectsCommand, HeadObjectCommand, HeadBucketCommand } from '@aws-sdk/client-s3';
+import { MastraFilesystem, FileNotFoundError } from '@mastra/core/workspace';
+
+// src/filesystem/index.ts
+var MIME_TYPES = {
+  // Text
+  ".txt": "text/plain",
+  ".md": "text/markdown",
+  ".markdown": "text/markdown",
+  ".html": "text/html",
+  ".htm": "text/html",
+  ".css": "text/css",
+  ".csv": "text/csv",
+  ".xml": "text/xml",
+  // Code
+  ".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",
+  // Images
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".svg": "image/svg+xml",
+  ".webp": "image/webp",
+  ".ico": "image/x-icon",
+  // Documents
+  ".pdf": "application/pdf",
+  // Archives
+  ".zip": "application/zip",
+  ".gz": "application/gzip",
+  ".tar": "application/x-tar"
+};
+function getMimeType(path) {
+  const ext = path.toLowerCase().match(/\.[^.]+$/)?.[0];
+  return ext ? MIME_TYPES[ext] ?? "application/octet-stream" : "application/octet-stream";
+}
+function isNotFoundError(error) {
+  if (!error || typeof error !== "object" || !("name" in error)) return false;
+  const name = error.name;
+  return name === "NotFound" || name === "NoSuchKey" || name === "404";
+}
+function isAccessDeniedError(error) {
+  if (!error || typeof error !== "object") return false;
+  const err = error;
+  return err.name === "AccessDenied" || err.$metadata?.httpStatusCode === 403;
+}
+function trimSlashes(s) {
+  let start = 0;
+  let end = s.length;
+  while (start < end && s[start] === "/") start++;
+  while (end > start && s[end - 1] === "/") end--;
+  return s.slice(start, end);
+}
+var S3Filesystem = class extends MastraFilesystem {
+  id;
+  name = "S3Filesystem";
+  provider = "s3";
+  readOnly;
+  status = "pending";
+  // Display metadata for UI
+  displayName;
+  icon = "s3";
+  description;
+  bucket;
+  region;
+  accessKeyId;
+  secretAccessKey;
+  endpoint;
+  forcePathStyle;
+  prefix;
+  _client = null;
+  constructor(options) {
+    super({ name: "S3Filesystem" });
+    this.id = options.id ?? `s3-fs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+    this.bucket = options.bucket;
+    this.region = options.region;
+    this.accessKeyId = options.accessKeyId;
+    this.secretAccessKey = options.secretAccessKey;
+    this.endpoint = options.endpoint;
+    this.forcePathStyle = options.forcePathStyle ?? !!options.endpoint;
+    this.prefix = options.prefix ? trimSlashes(options.prefix) + "/" : "";
+    this.icon = options.icon ?? this.detectIconFromEndpoint(options.endpoint);
+    this.displayName = options.displayName ?? this.getDefaultDisplayName(this.icon);
+    this.description = options.description;
+    this.readOnly = options.readOnly;
+  }
+  /**
+   * Get mount configuration for E2B sandbox.
+   * Returns S3-compatible config that works with s3fs-fuse.
+   */
+  getMountConfig() {
+    const config = {
+      type: "s3",
+      bucket: this.bucket,
+      region: this.region,
+      endpoint: this.endpoint
+    };
+    if (this.accessKeyId && this.secretAccessKey) {
+      config.accessKeyId = this.accessKeyId;
+      config.secretAccessKey = this.secretAccessKey;
+    }
+    if (this.readOnly) {
+      config.readOnly = true;
+    }
+    return config;
+  }
+  /**
+   * Get filesystem info for status reporting.
+   */
+  getInfo() {
+    return {
+      id: this.id,
+      name: this.name,
+      provider: this.provider,
+      status: this.status,
+      error: this.error,
+      icon: this.icon,
+      metadata: {
+        bucket: this.bucket,
+        region: this.region,
+        ...this.endpoint && { endpoint: this.endpoint },
+        ...this.prefix && { prefix: this.prefix }
+      }
+    };
+  }
+  /**
+   * Handle an error, checking for access denied and updating status accordingly.
+   * Returns the error for re-throwing.
+   */
+  handleError(error) {
+    if (isAccessDeniedError(error)) {
+      this.status = "error";
+      this.error = "Access denied - check credentials and bucket permissions";
+    }
+    return error;
+  }
+  /**
+   * Get instructions describing this S3 filesystem.
+   * Used by agents to understand storage semantics.
+   */
+  getInstructions() {
+    const providerName = this.displayName || "S3";
+    const access = this.readOnly ? "Read-only" : "Persistent";
+    return `${providerName} storage in bucket "${this.bucket}". ${access} storage - files are retained across sessions.`;
+  }
+  /**
+   * Detect the appropriate icon based on the S3 endpoint.
+   */
+  detectIconFromEndpoint(endpoint) {
+    if (!endpoint) {
+      return "aws-s3";
+    }
+    let hostname;
+    try {
+      const url = new URL(endpoint);
+      hostname = url.hostname.toLowerCase();
+    } catch {
+      hostname = endpoint.toLowerCase();
+    }
+    if (hostname === "r2.cloudflarestorage.com" || hostname.endsWith(".r2.cloudflarestorage.com") || hostname.endsWith(".cloudflare.com")) {
+      return "r2";
+    }
+    if (hostname === "storage.googleapis.com" || hostname.endsWith(".storage.googleapis.com") || hostname.endsWith(".googleapis.com")) {
+      return "gcs";
+    }
+    if (hostname === "blob.core.windows.net" || hostname.endsWith(".blob.core.windows.net") || hostname.endsWith(".azure.com")) {
+      return "azure";
+    }
+    if (hostname.includes("minio")) {
+      return "minio";
+    }
+    return "s3";
+  }
+  /**
+   * Get a user-friendly display name based on the icon/provider.
+   */
+  getDefaultDisplayName(icon) {
+    switch (icon) {
+      case "aws-s3":
+        return "AWS S3";
+      case "r2":
+      case "cloudflare":
+      case "cloudflare-r2":
+        return "Cloudflare R2";
+      case "gcs":
+      case "google-cloud":
+      case "google-cloud-storage":
+        return "Google Cloud Storage";
+      case "azure":
+      case "azure-blob":
+        return "Azure Blob";
+      case "minio":
+        return "MinIO";
+      case "s3":
+        return "S3";
+      default:
+        return void 0;
+    }
+  }
+  getClient() {
+    if (this._client) return this._client;
+    const hasCredentials = this.accessKeyId && this.secretAccessKey;
+    this._client = new S3Client({
+      region: this.region,
+      credentials: hasCredentials ? {
+        accessKeyId: this.accessKeyId,
+        secretAccessKey: this.secretAccessKey
+      } : (
+        // Anonymous access for public buckets - use empty credentials
+        // to prevent SDK from trying to find credentials elsewhere
+        { accessKeyId: "", secretAccessKey: "" }
+      ),
+      endpoint: this.endpoint,
+      forcePathStyle: this.forcePathStyle,
+      // Skip signing for anonymous access (public buckets).
+      // No-op signer passes the request through unsigned. Uses `any` because
+      // the correct type (HttpRequest from @smithy/types) is not a direct dependency.
+      ...hasCredentials ? {} : { signer: { sign: async (request) => request } }
+    });
+    return this._client;
+  }
+  /**
+   * Ensure the filesystem is initialized and return the S3 client.
+   * Uses base class ensureReady() for status management, then returns client.
+   */
+  async getReadyClient() {
+    await this.ensureReady();
+    return this.getClient();
+  }
+  toKey(path) {
+    const cleanPath = path.replace(/^\/+/, "");
+    return this.prefix + cleanPath;
+  }
+  // ---------------------------------------------------------------------------
+  // File Operations
+  // ---------------------------------------------------------------------------
+  async readFile(path, options) {
+    const client = await this.getReadyClient();
+    try {
+      const response = await client.send(
+        new GetObjectCommand({
+          Bucket: this.bucket,
+          Key: this.toKey(path)
+        })
+      );
+      const body = await response.Body?.transformToByteArray();
+      if (!body) throw new FileNotFoundError(path);
+      const buffer = Buffer.from(body);
+      if (options?.encoding) {
+        return buffer.toString(options.encoding);
+      }
+      return buffer;
+    } catch (error) {
+      if (isNotFoundError(error)) {
+        throw new FileNotFoundError(path);
+      }
+      throw this.handleError(error);
+    }
+  }
+  async writeFile(path, content, _options) {
+    const client = await this.getReadyClient();
+    const body = typeof content === "string" ? Buffer.from(content, "utf-8") : Buffer.from(content);
+    const contentType = getMimeType(path);
+    await client.send(
+      new PutObjectCommand({
+        Bucket: this.bucket,
+        Key: this.toKey(path),
+        Body: body,
+        ContentType: contentType
+      })
+    );
+  }
+  async appendFile(path, content) {
+    let existing = "";
+    try {
+      existing = await this.readFile(path, { encoding: "utf-8" });
+    } catch (error) {
+      if (error instanceof FileNotFoundError) ; else {
+        throw error;
+      }
+    }
+    const appendContent = typeof content === "string" ? content : Buffer.from(content).toString("utf-8");
+    await this.writeFile(path, existing + appendContent);
+  }
+  async deleteFile(path, options) {
+    const isDir = await this.isDirectory(path);
+    if (isDir) {
+      await this.rmdir(path, { recursive: true, force: options?.force });
+      return;
+    }
+    const client = await this.getReadyClient();
+    try {
+      await client.send(
+        new DeleteObjectCommand({
+          Bucket: this.bucket,
+          Key: this.toKey(path)
+        })
+      );
+    } catch (error) {
+      if (options?.force) return;
+      if (isNotFoundError(error)) {
+        throw new FileNotFoundError(path);
+      }
+      throw this.handleError(error);
+    }
+  }
+  async copyFile(src, dest, _options) {
+    const client = await this.getReadyClient();
+    try {
+      await client.send(
+        new CopyObjectCommand({
+          Bucket: this.bucket,
+          CopySource: `${this.bucket}/${encodeURIComponent(this.toKey(src)).replace(/%2F/g, "/")}`,
+          Key: this.toKey(dest)
+        })
+      );
+    } catch (error) {
+      if (isNotFoundError(error)) {
+        throw new FileNotFoundError(src);
+      }
+      throw this.handleError(error);
+    }
+  }
+  async moveFile(src, dest, options) {
+    await this.copyFile(src, dest, options);
+    await this.deleteFile(src, { force: true });
+  }
+  // ---------------------------------------------------------------------------
+  // Directory Operations
+  // ---------------------------------------------------------------------------
+  async mkdir(_path, _options) {
+  }
+  async rmdir(path, options) {
+    if (!options?.recursive) {
+      const entries = await this.readdir(path);
+      if (entries.length > 0) {
+        throw new Error(`Directory not empty: ${path}`);
+      }
+      return;
+    }
+    const client = await this.getReadyClient();
+    const prefix = this.toKey(path).replace(/\/$/, "") + "/";
+    let continuationToken;
+    do {
+      const listResponse = await client.send(
+        new ListObjectsV2Command({
+          Bucket: this.bucket,
+          Prefix: prefix,
+          ContinuationToken: continuationToken
+        })
+      );
+      if (listResponse.Contents && listResponse.Contents.length > 0) {
+        const deleteResponse = await client.send(
+          new DeleteObjectsCommand({
+            Bucket: this.bucket,
+            Delete: {
+              Objects: listResponse.Contents.filter((obj) => !!obj.Key).map((obj) => ({
+                Key: obj.Key
+              }))
+            }
+          })
+        );
+        if (deleteResponse.Errors && deleteResponse.Errors.length > 0) {
+          throw new Error(`Failed to delete ${deleteResponse.Errors.length} object(s) in ${path}`);
+        }
+      }
+      continuationToken = listResponse.NextContinuationToken;
+    } while (continuationToken);
+  }
+  async readdir(path, options) {
+    const client = await this.getReadyClient();
+    const prefix = this.toKey(path).replace(/\/$/, "");
+    const searchPrefix = prefix ? prefix + "/" : "";
+    const entries = [];
+    const seenDirs = /* @__PURE__ */ new Set();
+    let continuationToken;
+    do {
+      const response = await client.send(
+        new ListObjectsV2Command({
+          Bucket: this.bucket,
+          Prefix: searchPrefix,
+          Delimiter: options?.recursive ? void 0 : "/",
+          ContinuationToken: continuationToken
+        })
+      );
+      if (response.Contents) {
+        for (const obj of response.Contents) {
+          const key = obj.Key;
+          if (!key || key === searchPrefix) continue;
+          const relativePath = key.slice(searchPrefix.length);
+          if (!relativePath) continue;
+          if (relativePath.endsWith("/")) {
+            const dirName = relativePath.slice(0, -1);
+            if (!seenDirs.has(dirName)) {
+              seenDirs.add(dirName);
+              entries.push({ name: dirName, type: "directory" });
+            }
+            continue;
+          }
+          const name = options?.recursive ? relativePath : relativePath.split("/")[0];
+          if (!name) continue;
+          if (options?.extension) {
+            const extensions = Array.isArray(options.extension) ? options.extension : [options.extension];
+            if (!extensions.some((ext) => name.endsWith(ext))) {
+              continue;
+            }
+          }
+          entries.push({
+            name,
+            type: "file",
+            size: obj.Size
+          });
+        }
+      }
+      if (response.CommonPrefixes) {
+        for (const prefixObj of response.CommonPrefixes) {
+          if (!prefixObj.Prefix) continue;
+          const dirName = prefixObj.Prefix.slice(searchPrefix.length).replace(/\/$/, "");
+          if (dirName && !seenDirs.has(dirName)) {
+            seenDirs.add(dirName);
+            entries.push({ name: dirName, type: "directory" });
+          }
+        }
+      }
+      continuationToken = response.NextContinuationToken;
+    } while (continuationToken);
+    return entries;
+  }
+  // ---------------------------------------------------------------------------
+  // Path Operations
+  // ---------------------------------------------------------------------------
+  async exists(path) {
+    const key = this.toKey(path);
+    if (!key) return true;
+    const client = await this.getReadyClient();
+    try {
+      await client.send(
+        new HeadObjectCommand({
+          Bucket: this.bucket,
+          Key: key
+        })
+      );
+      return true;
+    } catch (error) {
+      if (!isNotFoundError(error)) throw this.handleError(error);
+    }
+    const response = await client.send(
+      new ListObjectsV2Command({
+        Bucket: this.bucket,
+        Prefix: key.replace(/\/$/, "") + "/",
+        MaxKeys: 1
+      })
+    );
+    return (response.Contents?.length ?? 0) > 0;
+  }
+  async stat(path) {
+    const key = this.toKey(path);
+    if (!key) {
+      return {
+        name: "",
+        path,
+        type: "directory",
+        size: 0,
+        createdAt: /* @__PURE__ */ new Date(),
+        modifiedAt: /* @__PURE__ */ new Date()
+      };
+    }
+    const client = await this.getReadyClient();
+    try {
+      const response = await client.send(
+        new HeadObjectCommand({
+          Bucket: this.bucket,
+          Key: key
+        })
+      );
+      const name = path.split("/").pop() ?? "";
+      return {
+        name,
+        path,
+        type: "file",
+        size: response.ContentLength ?? 0,
+        createdAt: response.LastModified ?? /* @__PURE__ */ new Date(),
+        modifiedAt: response.LastModified ?? /* @__PURE__ */ new Date()
+      };
+    } catch (error) {
+      if (!isNotFoundError(error)) throw this.handleError(error);
+      const isDir = await this.isDirectory(path);
+      if (isDir) {
+        const name = path.split("/").filter(Boolean).pop() ?? "";
+        return {
+          name,
+          path,
+          type: "directory",
+          size: 0,
+          createdAt: /* @__PURE__ */ new Date(),
+          modifiedAt: /* @__PURE__ */ new Date()
+        };
+      }
+      throw new FileNotFoundError(path);
+    }
+  }
+  async isFile(path) {
+    const key = this.toKey(path);
+    if (!key) return false;
+    const client = await this.getReadyClient();
+    try {
+      await client.send(
+        new HeadObjectCommand({
+          Bucket: this.bucket,
+          Key: key
+        })
+      );
+      return true;
+    } catch (error) {
+      if (!isNotFoundError(error)) throw this.handleError(error);
+      return false;
+    }
+  }
+  async isDirectory(path) {
+    const key = this.toKey(path);
+    if (!key) return true;
+    const client = await this.getReadyClient();
+    const response = await client.send(
+      new ListObjectsV2Command({
+        Bucket: this.bucket,
+        Prefix: key.replace(/\/$/, "") + "/",
+        MaxKeys: 1
+      })
+    );
+    return (response.Contents?.length ?? 0) > 0;
+  }
+  // ---------------------------------------------------------------------------
+  // Lifecycle (overrides base class protected methods)
+  // ---------------------------------------------------------------------------
+  /**
+   * Initialize the S3 client.
+   * Status management is handled by the base class.
+   */
+  async init() {
+    const client = this.getClient();
+    try {
+      await client.send(new HeadBucketCommand({ Bucket: this.bucket }));
+    } catch (error) {
+      const statusCode = error.$metadata?.httpStatusCode;
+      const createError = (message2) => {
+        const err = new Error(message2);
+        if (statusCode) err.status = statusCode;
+        return err;
+      };
+      if (isAccessDeniedError(error)) {
+        throw createError(`Access denied to bucket "${this.bucket}" - check credentials and permissions`);
+      }
+      if (isNotFoundError(error)) {
+        throw createError(`Bucket "${this.bucket}" not found`);
+      }
+      const message = error instanceof Error ? error.message : String(error);
+      if (statusCode) {
+        throw createError(`Failed to access bucket "${this.bucket}" (HTTP ${statusCode}): ${message}`);
+      }
+      throw error;
+    }
+  }
+  /**
+   * Clean up the S3 client.
+   * Status management is handled by the base class.
+   */
+  async destroy() {
+    this._client = null;
+  }
+};
+
+export { S3Filesystem };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/filesystem/index.ts"],"names":["message"],"mappings":"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","file":"index.js","sourcesContent":["import {\n  S3Client,\n  GetObjectCommand,\n  PutObjectCommand,\n  DeleteObjectCommand,\n  CopyObjectCommand,\n  ListObjectsV2Command,\n  DeleteObjectsCommand,\n  HeadObjectCommand,\n  HeadBucketCommand,\n} from '@aws-sdk/client-s3';\n\nimport type {\n  FileContent,\n  FileStat,\n  FileEntry,\n  ReadOptions,\n  WriteOptions,\n  ListOptions,\n  RemoveOptions,\n  CopyOptions,\n  FilesystemMountConfig,\n  FilesystemIcon,\n  FilesystemInfo,\n  ProviderStatus,\n} from '@mastra/core/workspace';\nimport { MastraFilesystem, FileNotFoundError } from '@mastra/core/workspace';\n\n/**\n * S3 mount configuration.\n * Returned by S3Filesystem.getMountConfig() for FUSE mounting in sandboxes.\n */\nexport interface S3MountConfig extends FilesystemMountConfig {\n  type: 's3';\n  /** S3 bucket name */\n  bucket: string;\n  /** AWS region (use 'auto' for R2) */\n  region?: string;\n  /** Optional endpoint for S3-compatible storage (MinIO, R2, etc.) */\n  endpoint?: string;\n  /** AWS access key ID */\n  accessKeyId?: string;\n  /** AWS secret access key */\n  secretAccessKey?: string;\n  /** Mount as read-only */\n  readOnly?: boolean;\n}\n\n/**\n * Common MIME types by file extension.\n */\nconst MIME_TYPES: Record<string, string> = {\n  // Text\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  // Code\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  // Images\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  // Documents\n  '.pdf': 'application/pdf',\n  // Archives\n  '.zip': 'application/zip',\n  '.gz': 'application/gzip',\n  '.tar': 'application/x-tar',\n};\n\n/**\n * Get MIME type from file path extension.\n */\nfunction getMimeType(path: string): string {\n  const ext = path.toLowerCase().match(/\\.[^.]+$/)?.[0];\n  return ext ? (MIME_TYPES[ext] ?? 'application/octet-stream') : 'application/octet-stream';\n}\n\n/** Check if an error is a \"not found\" error from the S3 SDK. */\nfunction isNotFoundError(error: unknown): boolean {\n  if (!error || typeof error !== 'object' || !('name' in error)) return false;\n  const name = (error as { name: string }).name;\n  return name === 'NotFound' || name === 'NoSuchKey' || name === '404';\n}\n\n/** Check if an error is an access denied error from the S3 SDK. */\nfunction isAccessDeniedError(error: unknown): boolean {\n  if (!error || typeof error !== 'object') return false;\n  const err = error as { name?: string; $metadata?: { httpStatusCode?: number } };\n  return err.name === 'AccessDenied' || err.$metadata?.httpStatusCode === 403;\n}\n\n/**\n * S3 filesystem provider configuration.\n */\nexport interface S3FilesystemOptions {\n  /** Unique identifier for this filesystem instance */\n  id?: string;\n  /** S3 bucket name */\n  bucket: string;\n  /** Human-friendly display name for the UI */\n  displayName?: string;\n  /** Icon identifier for the UI (defaults to 's3') */\n  icon?: FilesystemIcon;\n  /** Description shown in tooltips */\n  description?: string;\n  /** AWS region (use 'auto' for R2) */\n  region: string;\n  /**\n   * AWS access key ID.\n   * Optional - omit for public buckets (read-only access).\n   */\n  accessKeyId?: string;\n  /**\n   * AWS secret access key.\n   * Optional - omit for public buckets (read-only access).\n   */\n  secretAccessKey?: string;\n  /**\n   * Custom endpoint URL for S3-compatible storage.\n   * Examples:\n   * - Cloudflare R2: 'https://{accountId}.r2.cloudflarestorage.com'\n   * - MinIO: 'http://localhost:9000'\n   * - DigitalOcean Spaces: 'https://{region}.digitaloceanspaces.com'\n   */\n  endpoint?: string;\n  /** Force path-style URLs (required for some S3-compatible services) */\n  forcePathStyle?: boolean;\n  /** Optional prefix for all keys (acts like a subdirectory) */\n  prefix?: string;\n  /** Mount as read-only (blocks write operations, mounts read-only in sandboxes) */\n  readOnly?: boolean;\n}\n\n/**\n * S3 filesystem implementation.\n *\n * Stores files in an S3 bucket or S3-compatible storage service.\n * Supports mounting into E2B sandboxes via s3fs-fuse.\n *\n * @example AWS S3\n * ```typescript\n * import { S3Filesystem } from '@mastra/s3';\n *\n * const fs = new S3Filesystem({\n *   bucket: 'my-bucket',\n *   region: 'us-east-1',\n *   accessKeyId: process.env.AWS_ACCESS_KEY_ID!,\n *   secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY!,\n * });\n * ```\n *\n * @example Cloudflare R2\n * ```typescript\n * import { S3Filesystem } from '@mastra/s3';\n *\n * const fs = new S3Filesystem({\n *   bucket: 'my-bucket',\n *   region: 'auto',\n *   accessKeyId: process.env.R2_ACCESS_KEY_ID!,\n *   secretAccessKey: process.env.R2_SECRET_ACCESS_KEY!,\n *   endpoint: `https://${process.env.R2_ACCOUNT_ID}.r2.cloudflarestorage.com`,\n * });\n * ```\n *\n * @example MinIO (local)\n * ```typescript\n * import { S3Filesystem } from '@mastra/s3';\n *\n * const fs = new S3Filesystem({\n *   bucket: 'my-bucket',\n *   region: 'us-east-1',\n *   accessKeyId: 'minioadmin',\n *   secretAccessKey: 'minioadmin',\n *   endpoint: 'http://localhost:9000',\n *   forcePathStyle: true,\n * });\n * ```\n */\n\n/** Trim leading and trailing slashes without regex (avoids polynomial regex on user input). */\nfunction trimSlashes(s: string): string {\n  let start = 0;\n  let end = s.length;\n  while (start < end && s[start] === '/') start++;\n  while (end > start && s[end - 1] === '/') end--;\n  return s.slice(start, end);\n}\n\nexport class S3Filesystem extends MastraFilesystem {\n  readonly id: string;\n  readonly name = 'S3Filesystem';\n  readonly provider = 's3';\n  readonly readOnly?: boolean;\n\n  status: ProviderStatus = 'pending';\n\n  // Display metadata for UI\n  readonly displayName?: string;\n  readonly icon: FilesystemIcon = 's3';\n  readonly description?: string;\n\n  private readonly bucket: string;\n  private readonly region: string;\n  private readonly accessKeyId?: string;\n  private readonly secretAccessKey?: string;\n  private readonly endpoint?: string;\n  private readonly forcePathStyle: boolean;\n  private readonly prefix: string;\n\n  private _client: S3Client | null = null;\n\n  constructor(options: S3FilesystemOptions) {\n    super({ name: 'S3Filesystem' });\n    this.id = options.id ?? `s3-fs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;\n    this.bucket = options.bucket;\n    this.region = options.region;\n    this.accessKeyId = options.accessKeyId;\n    this.secretAccessKey = options.secretAccessKey;\n    this.endpoint = options.endpoint;\n    this.forcePathStyle = options.forcePathStyle ?? !!options.endpoint; // Default true for custom endpoints\n    // Trim leading/trailing slashes from prefix using iterative approach (avoids polynomial regex)\n    this.prefix = options.prefix ? trimSlashes(options.prefix) + '/' : '';\n\n    // Display metadata - detect icon first, then derive displayName from it\n    this.icon = options.icon ?? this.detectIconFromEndpoint(options.endpoint);\n    this.displayName = options.displayName ?? this.getDefaultDisplayName(this.icon);\n    this.description = options.description;\n    this.readOnly = options.readOnly;\n  }\n\n  /**\n   * Get mount configuration for E2B sandbox.\n   * Returns S3-compatible config that works with s3fs-fuse.\n   */\n  getMountConfig(): S3MountConfig {\n    const config: S3MountConfig = {\n      type: 's3',\n      bucket: this.bucket,\n      region: this.region,\n      endpoint: this.endpoint,\n    };\n\n    if (this.accessKeyId && this.secretAccessKey) {\n      config.accessKeyId = this.accessKeyId;\n      config.secretAccessKey = this.secretAccessKey;\n    }\n\n    if (this.readOnly) {\n      config.readOnly = true;\n    }\n\n    return config;\n  }\n\n  /**\n   * Get filesystem info for status reporting.\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      icon: this.icon,\n      metadata: {\n        bucket: this.bucket,\n        region: this.region,\n        ...(this.endpoint && { endpoint: this.endpoint }),\n        ...(this.prefix && { prefix: this.prefix }),\n      },\n    };\n  }\n\n  /**\n   * Handle an error, checking for access denied and updating status accordingly.\n   * Returns the error for re-throwing.\n   */\n  private handleError(error: unknown): unknown {\n    if (isAccessDeniedError(error)) {\n      this.status = 'error';\n      this.error = 'Access denied - check credentials and bucket permissions';\n    }\n    return error;\n  }\n\n  /**\n   * Get instructions describing this S3 filesystem.\n   * Used by agents to understand storage semantics.\n   */\n  getInstructions(): string {\n    const providerName = this.displayName || 'S3';\n    const access = this.readOnly ? 'Read-only' : 'Persistent';\n    return `${providerName} storage in bucket \"${this.bucket}\". ${access} storage - files are retained across sessions.`;\n  }\n\n  /**\n   * Detect the appropriate icon based on the S3 endpoint.\n   */\n  private detectIconFromEndpoint(endpoint?: string): FilesystemIcon {\n    if (!endpoint) {\n      // No custom endpoint = AWS S3\n      return 'aws-s3';\n    }\n\n    // Parse hostname from endpoint URL for secure matching\n    let hostname: string;\n    try {\n      const url = new URL(endpoint);\n      hostname = url.hostname.toLowerCase();\n    } catch {\n      // If URL parsing fails, use the endpoint as-is (lowercased)\n      hostname = endpoint.toLowerCase();\n    }\n\n    // Check hostname suffix for known providers (use dot-prefix or exact match to prevent subdomain spoofing)\n    if (\n      hostname === 'r2.cloudflarestorage.com' ||\n      hostname.endsWith('.r2.cloudflarestorage.com') ||\n      hostname.endsWith('.cloudflare.com')\n    ) {\n      return 'r2';\n    }\n\n    if (\n      hostname === 'storage.googleapis.com' ||\n      hostname.endsWith('.storage.googleapis.com') ||\n      hostname.endsWith('.googleapis.com')\n    ) {\n      return 'gcs';\n    }\n\n    if (\n      hostname === 'blob.core.windows.net' ||\n      hostname.endsWith('.blob.core.windows.net') ||\n      hostname.endsWith('.azure.com')\n    ) {\n      return 'azure';\n    }\n\n    if (hostname.includes('minio')) {\n      return 'minio';\n    }\n\n    // Generic S3-compatible (DigitalOcean Spaces, etc.)\n    return 's3';\n  }\n\n  /**\n   * Get a user-friendly display name based on the icon/provider.\n   */\n  private getDefaultDisplayName(icon: FilesystemIcon): string | undefined {\n    switch (icon) {\n      case 'aws-s3':\n        return 'AWS S3';\n      case 'r2':\n      case 'cloudflare':\n      case 'cloudflare-r2':\n        return 'Cloudflare R2';\n      case 'gcs':\n      case 'google-cloud':\n      case 'google-cloud-storage':\n        return 'Google Cloud Storage';\n      case 'azure':\n      case 'azure-blob':\n        return 'Azure Blob';\n      case 'minio':\n        return 'MinIO';\n      case 's3':\n        return 'S3';\n      default:\n        // Unknown icon - don't assume a display name\n        return undefined;\n    }\n  }\n\n  private getClient(): S3Client {\n    if (this._client) return this._client;\n\n    const hasCredentials = this.accessKeyId && this.secretAccessKey;\n\n    this._client = new S3Client({\n      region: this.region,\n      credentials: hasCredentials\n        ? {\n            accessKeyId: this.accessKeyId!,\n            secretAccessKey: this.secretAccessKey!,\n          }\n        : // Anonymous access for public buckets - use empty credentials\n          // to prevent SDK from trying to find credentials elsewhere\n          { accessKeyId: '', secretAccessKey: '' },\n      endpoint: this.endpoint,\n      forcePathStyle: this.forcePathStyle,\n      // Skip signing for anonymous access (public buckets).\n      // No-op signer passes the request through unsigned. Uses `any` because\n      // the correct type (HttpRequest from @smithy/types) is not a direct dependency.\n\n      ...(hasCredentials ? {} : { signer: { sign: async (request: any) => request } }),\n    });\n\n    return this._client;\n  }\n\n  /**\n   * Ensure the filesystem is initialized and return the S3 client.\n   * Uses base class ensureReady() for status management, then returns client.\n   */\n  private async getReadyClient(): Promise<S3Client> {\n    await this.ensureReady();\n    return this.getClient();\n  }\n\n  private toKey(path: string): string {\n    // Remove leading slash and add prefix\n    const cleanPath = path.replace(/^\\/+/, '');\n    return this.prefix + cleanPath;\n  }\n\n  // ---------------------------------------------------------------------------\n  // File Operations\n  // ---------------------------------------------------------------------------\n\n  async readFile(path: string, options?: ReadOptions): Promise<string | Buffer> {\n    const client = await this.getReadyClient();\n\n    try {\n      const response = await client.send(\n        new GetObjectCommand({\n          Bucket: this.bucket,\n          Key: this.toKey(path),\n        }),\n      );\n\n      const body = await response.Body?.transformToByteArray();\n      if (!body) throw new FileNotFoundError(path);\n\n      const buffer = Buffer.from(body);\n      if (options?.encoding) {\n        return buffer.toString(options.encoding);\n      }\n      return buffer;\n    } catch (error: unknown) {\n      if (isNotFoundError(error)) {\n        throw new FileNotFoundError(path);\n      }\n      throw this.handleError(error);\n    }\n  }\n\n  async writeFile(path: string, content: FileContent, _options?: WriteOptions): Promise<void> {\n    const client = await this.getReadyClient();\n\n    const body = typeof content === 'string' ? Buffer.from(content, 'utf-8') : Buffer.from(content);\n    const contentType = getMimeType(path);\n\n    await client.send(\n      new PutObjectCommand({\n        Bucket: this.bucket,\n        Key: this.toKey(path),\n        Body: body,\n        ContentType: contentType,\n      }),\n    );\n  }\n\n  async appendFile(path: string, content: FileContent): Promise<void> {\n    // S3 doesn't support append, so read + write\n    let existing = '';\n    try {\n      existing = (await this.readFile(path, { encoding: 'utf-8' })) as string;\n    } catch (error) {\n      if (error instanceof FileNotFoundError) {\n        // File doesn't exist, start fresh\n      } else {\n        throw error;\n      }\n    }\n\n    const appendContent = typeof content === 'string' ? content : Buffer.from(content).toString('utf-8');\n    await this.writeFile(path, existing + appendContent);\n  }\n\n  async deleteFile(path: string, options?: RemoveOptions): Promise<void> {\n    // Check if this is a directory - if so, use rmdir instead\n    const isDir = await this.isDirectory(path);\n    if (isDir) {\n      await this.rmdir(path, { recursive: true, force: options?.force });\n      return;\n    }\n\n    const client = await this.getReadyClient();\n\n    try {\n      await client.send(\n        new DeleteObjectCommand({\n          Bucket: this.bucket,\n          Key: this.toKey(path),\n        }),\n      );\n    } catch (error: unknown) {\n      if (options?.force) return;\n      if (isNotFoundError(error)) {\n        throw new FileNotFoundError(path);\n      }\n      throw this.handleError(error);\n    }\n  }\n\n  async copyFile(src: string, dest: string, _options?: CopyOptions): Promise<void> {\n    const client = await this.getReadyClient();\n\n    try {\n      await client.send(\n        new CopyObjectCommand({\n          Bucket: this.bucket,\n          CopySource: `${this.bucket}/${encodeURIComponent(this.toKey(src)).replace(/%2F/g, '/')}`,\n          Key: this.toKey(dest),\n        }),\n      );\n    } catch (error: unknown) {\n      if (isNotFoundError(error)) {\n        throw new FileNotFoundError(src);\n      }\n      throw this.handleError(error);\n    }\n  }\n\n  async moveFile(src: string, dest: string, options?: CopyOptions): Promise<void> {\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    // S3 doesn't have real directories - they're just key prefixes\n    // No-op, directories are created implicitly when files are written\n  }\n\n  async rmdir(path: string, options?: RemoveOptions): Promise<void> {\n    if (!options?.recursive) {\n      // Check if directory is empty\n      const entries = await this.readdir(path);\n      if (entries.length > 0) {\n        throw new Error(`Directory not empty: ${path}`);\n      }\n      return;\n    }\n\n    // Delete all objects with this prefix\n    const client = await this.getReadyClient();\n\n    const prefix = this.toKey(path).replace(/\\/$/, '') + '/';\n\n    let continuationToken: string | undefined;\n    do {\n      const listResponse = await client.send(\n        new ListObjectsV2Command({\n          Bucket: this.bucket,\n          Prefix: prefix,\n          ContinuationToken: continuationToken,\n        }),\n      );\n\n      if (listResponse.Contents && listResponse.Contents.length > 0) {\n        const deleteResponse = await client.send(\n          new DeleteObjectsCommand({\n            Bucket: this.bucket,\n            Delete: {\n              Objects: listResponse.Contents.filter((obj): obj is { Key: string } => !!obj.Key).map(obj => ({\n                Key: obj.Key,\n              })),\n            },\n          }),\n        );\n        if (deleteResponse.Errors && deleteResponse.Errors.length > 0) {\n          throw new Error(`Failed to delete ${deleteResponse.Errors.length} object(s) in ${path}`);\n        }\n      }\n\n      continuationToken = listResponse.NextContinuationToken;\n    } while (continuationToken);\n  }\n\n  async readdir(path: string, options?: ListOptions): Promise<FileEntry[]> {\n    const client = await this.getReadyClient();\n\n    const prefix = this.toKey(path).replace(/\\/$/, '');\n    const searchPrefix = prefix ? prefix + '/' : '';\n\n    const entries: FileEntry[] = [];\n    const seenDirs = new Set<string>();\n\n    let continuationToken: string | undefined;\n    do {\n      const response = await client.send(\n        new ListObjectsV2Command({\n          Bucket: this.bucket,\n          Prefix: searchPrefix,\n          Delimiter: options?.recursive ? undefined : '/',\n          ContinuationToken: continuationToken,\n        }),\n      );\n\n      // Add files\n      if (response.Contents) {\n        for (const obj of response.Contents) {\n          const key = obj.Key;\n          if (!key || key === searchPrefix) continue;\n\n          const relativePath = key.slice(searchPrefix.length);\n          if (!relativePath) continue;\n\n          // Skip if this looks like a directory marker\n          if (relativePath.endsWith('/')) {\n            const dirName = relativePath.slice(0, -1);\n            if (!seenDirs.has(dirName)) {\n              seenDirs.add(dirName);\n              entries.push({ name: dirName, type: 'directory' });\n            }\n            continue;\n          }\n\n          const name = options?.recursive ? relativePath : relativePath.split('/')[0];\n\n          // Skip if name is undefined or empty\n          if (!name) continue;\n\n          // Filter by extension if specified\n          if (options?.extension) {\n            const extensions = Array.isArray(options.extension) ? options.extension : [options.extension];\n            if (!extensions.some(ext => name.endsWith(ext))) {\n              continue;\n            }\n          }\n\n          entries.push({\n            name,\n            type: 'file',\n            size: obj.Size,\n          });\n        }\n      }\n\n      // Add directories (common prefixes)\n      if (response.CommonPrefixes) {\n        for (const prefixObj of response.CommonPrefixes) {\n          if (!prefixObj.Prefix) continue;\n          const dirName = prefixObj.Prefix.slice(searchPrefix.length).replace(/\\/$/, '');\n          if (dirName && !seenDirs.has(dirName)) {\n            seenDirs.add(dirName);\n            entries.push({ name: dirName, type: 'directory' });\n          }\n        }\n      }\n\n      continuationToken = response.NextContinuationToken;\n    } while (continuationToken);\n\n    return entries;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Path Operations\n  // ---------------------------------------------------------------------------\n\n  async exists(path: string): Promise<boolean> {\n    const key = this.toKey(path);\n    if (!key) return true; // Root always exists\n\n    const client = await this.getReadyClient();\n\n    // Check if it's a file\n    try {\n      await client.send(\n        new HeadObjectCommand({\n          Bucket: this.bucket,\n          Key: key,\n        }),\n      );\n      return true;\n    } catch (error: unknown) {\n      if (!isNotFoundError(error)) throw this.handleError(error);\n      // Not a file, check if it's a \"directory\" (has objects with this prefix)\n    }\n\n    // Check if it's a directory prefix\n    const response: { Contents?: unknown[] } = await client.send(\n      new ListObjectsV2Command({\n        Bucket: this.bucket,\n        Prefix: key.replace(/\\/$/, '') + '/',\n        MaxKeys: 1,\n      }),\n    );\n\n    return (response.Contents?.length ?? 0) > 0;\n  }\n\n  async stat(path: string): Promise<FileStat> {\n    const key = this.toKey(path);\n\n    // Root is always a directory\n    if (!key) {\n      return {\n        name: '',\n        path,\n        type: 'directory',\n        size: 0,\n        createdAt: new Date(),\n        modifiedAt: new Date(),\n      };\n    }\n\n    const client = await this.getReadyClient();\n\n    try {\n      const response: { ContentLength?: number; LastModified?: Date } = await client.send(\n        new HeadObjectCommand({\n          Bucket: this.bucket,\n          Key: key,\n        }),\n      );\n\n      const name = path.split('/').pop() ?? '';\n      return {\n        name,\n        path,\n        type: 'file',\n        size: response.ContentLength ?? 0,\n        createdAt: response.LastModified ?? new Date(),\n        modifiedAt: response.LastModified ?? new Date(),\n      };\n    } catch (error: unknown) {\n      if (!isNotFoundError(error)) throw this.handleError(error);\n      // Check if it's a directory\n      const isDir = await this.isDirectory(path);\n      if (isDir) {\n        const name = path.split('/').filter(Boolean).pop() ?? '';\n        return {\n          name,\n          path,\n          type: 'directory',\n          size: 0,\n          createdAt: new Date(),\n          modifiedAt: new Date(),\n        };\n      }\n      throw new FileNotFoundError(path);\n    }\n  }\n\n  async isFile(path: string): Promise<boolean> {\n    const key = this.toKey(path);\n    if (!key) return false; // Root is a directory, not a file\n\n    const client = await this.getReadyClient();\n\n    try {\n      await client.send(\n        new HeadObjectCommand({\n          Bucket: this.bucket,\n          Key: key,\n        }),\n      );\n      return true;\n    } catch (error: unknown) {\n      if (!isNotFoundError(error)) throw this.handleError(error);\n      return false;\n    }\n  }\n\n  async isDirectory(path: string): Promise<boolean> {\n    const key = this.toKey(path);\n    if (!key) return true; // Root is always a directory\n\n    const client = await this.getReadyClient();\n\n    const response: { Contents?: unknown[] } = await client.send(\n      new ListObjectsV2Command({\n        Bucket: this.bucket,\n        Prefix: key.replace(/\\/$/, '') + '/',\n        MaxKeys: 1,\n      }),\n    );\n\n    return (response.Contents?.length ?? 0) > 0;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Lifecycle (overrides base class protected methods)\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Initialize the S3 client.\n   * Status management is handled by the base class.\n   */\n  async init(): Promise<void> {\n    // Verify we can access the bucket\n    const client = this.getClient();\n    try {\n      await client.send(new HeadBucketCommand({ Bucket: this.bucket }));\n    } catch (error) {\n      // Extract httpStatusCode if available\n      const statusCode = (error as { $metadata?: { httpStatusCode?: number } }).$metadata?.httpStatusCode;\n\n      // Create error with status property for proper HTTP response codes\n      const createError = (message: string) => {\n        const err = new Error(message) as Error & { status?: number };\n        if (statusCode) err.status = statusCode;\n        return err;\n      };\n\n      // Provide better error messages for common S3 errors\n      if (isAccessDeniedError(error)) {\n        throw createError(`Access denied to bucket \"${this.bucket}\" - check credentials and permissions`);\n      }\n      if (isNotFoundError(error)) {\n        throw createError(`Bucket \"${this.bucket}\" not found`);\n      }\n      const message = error instanceof Error ? error.message : String(error);\n      if (statusCode) {\n        throw createError(`Failed to access bucket \"${this.bucket}\" (HTTP ${statusCode}): ${message}`);\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Clean up the S3 client.\n   * Status management is handled by the base class.\n   */\n  async destroy(): Promise<void> {\n    this._client = null;\n  }\n}\n"]}