@mastra/gcs 0.0.0

package/LICENSE.md

@@ -0,0 +1,15 @@
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,58 @@
+# @mastra/gcs
+
+Google Cloud Storage filesystem provider for Mastra workspaces.
+
+## Installation
+
+```bash
+npm install @mastra/gcs
+```
+
+## Usage
+
+```typescript
+import { Agent } from '@mastra/core/agent';
+import { Workspace } from '@mastra/core/workspace';
+import { GCSFilesystem } from '@mastra/gcs';
+
+const workspace = new Workspace({
+  filesystem: new GCSFilesystem({
+    bucket: 'my-gcs-bucket',
+    // Uses Application Default Credentials by default
+    // Or provide a service account key:
+    projectId: 'my-project-id',
+    credentials: JSON.parse(process.env.GCS_SERVICE_ACCOUNT_KEY),
+  }),
+});
+
+const agent = new Agent({
+  name: 'my-agent',
+  model: 'anthropic/claude-opus-4-5',
+  workspace,
+});
+```
+
+### With E2B Sandbox
+
+When used with `@mastra/e2b`, GCS filesystems can be mounted into E2B sandboxes via gcsfuse:
+
+```typescript
+import { Workspace } from '@mastra/core/workspace';
+import { GCSFilesystem } from '@mastra/gcs';
+import { E2BSandbox } from '@mastra/e2b';
+
+const workspace = new Workspace({
+  mounts: {
+    '/my-bucket': new GCSFilesystem({
+      bucket: 'my-gcs-bucket',
+      projectId: 'my-project-id',
+      credentials: JSON.parse(process.env.GCS_SERVICE_ACCOUNT_KEY),
+    }),
+  },
+  sandbox: new E2BSandbox(),
+});
+```
+
+## Documentation
+
+For more information, see the [Mastra Workspaces documentation](https://mastra.ai/docs/workspace/overview).

package/dist/filesystem/index.d.ts

@@ -0,0 +1,118 @@
+/**
+ * GCS Filesystem Provider
+ *
+ * A filesystem implementation backed by Google Cloud Storage.
+ */
+import type { FileContent, FileStat, FileEntry, ReadOptions, WriteOptions, ListOptions, RemoveOptions, CopyOptions, FilesystemInfo, FilesystemMountConfig, FilesystemIcon, ProviderStatus } from '@mastra/core/workspace';
+import { MastraFilesystem } from '@mastra/core/workspace';
+/**
+ * GCS mount configuration.
+ * Returned by GCSFilesystem.getMountConfig() for FUSE mounting in sandboxes.
+ */
+export interface GCSMountConfig extends FilesystemMountConfig {
+    type: 'gcs';
+    /** GCS bucket name */
+    bucket: string;
+    /** Service account key JSON (optional - omit for public buckets or ADC) */
+    serviceAccountKey?: string;
+}
+/**
+ * GCS filesystem provider configuration.
+ */
+export interface GCSFilesystemOptions {
+    /** Unique identifier for this filesystem instance */
+    id?: string;
+    /** GCS bucket name */
+    bucket: string;
+    /** Human-friendly display name for the UI */
+    displayName?: string;
+    /** Icon identifier for the UI (defaults to 'gcs') */
+    icon?: FilesystemIcon;
+    /** Description shown in tooltips */
+    description?: string;
+    /**
+     * GCS project ID.
+     * Required when using service account credentials.
+     */
+    projectId?: string;
+    /**
+     * Service account key JSON object or path to key file.
+     * If not provided, uses Application Default Credentials (ADC).
+     */
+    credentials?: object | string;
+    /** Optional prefix for all keys (acts like a subdirectory) */
+    prefix?: string;
+    /** Mount as read-only (blocks write operations, mounts read-only in sandboxes) */
+    readOnly?: boolean;
+    /**
+     * Custom API endpoint URL.
+     * Used for local development with emulators like fake-gcs-server.
+     */
+    endpoint?: string;
+}
+export declare class GCSFilesystem extends MastraFilesystem {
+    readonly id: string;
+    readonly name = "GCSFilesystem";
+    readonly provider = "gcs";
+    readonly readOnly?: boolean;
+    status: ProviderStatus;
+    readonly displayName?: string;
+    readonly icon: FilesystemIcon;
+    readonly description?: string;
+    private readonly bucketName;
+    private readonly projectId?;
+    private readonly credentials?;
+    private readonly prefix;
+    private readonly endpoint?;
+    private _storage;
+    private _bucket;
+    constructor(options: GCSFilesystemOptions);
+    /**
+     * Get mount configuration for E2B sandbox.
+     * Returns GCS-compatible config that works with gcsfuse.
+     */
+    getMountConfig(): GCSMountConfig;
+    /**
+     * Get filesystem info for status reporting.
+     */
+    getInfo(): FilesystemInfo;
+    /**
+     * Get instructions describing this GCS filesystem.
+     * Used by agents to understand storage semantics.
+     */
+    getInstructions(): string;
+    private getStorage;
+    private getBucket;
+    /**
+     * Ensure the filesystem is initialized and return the bucket.
+     * Uses base class ensureReady() for status management, then returns bucket.
+     */
+    private getReadyBucket;
+    private toKey;
+    readFile(path: string, options?: ReadOptions): Promise<string | Buffer>;
+    writeFile(path: string, content: FileContent, _options?: WriteOptions): Promise<void>;
+    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>;
+    isFile(path: string): Promise<boolean>;
+    isDirectory(path: string): Promise<boolean>;
+    /**
+     * Initialize the GCS client.
+     * Status management is handled by the base class.
+     */
+    init(): Promise<void>;
+    /**
+     * Clean up the GCS client.
+     * Status management is handled by the base class.
+     */
+    destroy(): Promise<void>;
+}
+//# 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,426 @@
+'use strict';
+
+var storage = require('@google-cloud/storage');
+var workspace = require('@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 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 GCSFilesystem = class extends workspace.MastraFilesystem {
+  id;
+  name = "GCSFilesystem";
+  provider = "gcs";
+  readOnly;
+  status = "pending";
+  // Display metadata for UI
+  displayName;
+  icon = "gcs";
+  description;
+  bucketName;
+  projectId;
+  credentials;
+  prefix;
+  endpoint;
+  _storage = null;
+  _bucket = null;
+  constructor(options) {
+    super({ name: "GCSFilesystem" });
+    this.id = options.id ?? `gcs-fs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+    this.bucketName = options.bucket;
+    this.projectId = options.projectId;
+    this.credentials = options.credentials;
+    this.prefix = options.prefix ? trimSlashes(options.prefix) + "/" : "";
+    this.endpoint = options.endpoint;
+    this.displayName = options.displayName ?? "Google Cloud Storage";
+    this.icon = options.icon ?? "gcs";
+    this.description = options.description;
+    this.readOnly = options.readOnly;
+  }
+  /**
+   * Get mount configuration for E2B sandbox.
+   * Returns GCS-compatible config that works with gcsfuse.
+   */
+  getMountConfig() {
+    const config = {
+      type: "gcs",
+      bucket: this.bucketName
+    };
+    if (this.credentials && typeof this.credentials === "object") {
+      config.serviceAccountKey = JSON.stringify(this.credentials);
+    }
+    return config;
+  }
+  /**
+   * Get filesystem info for status reporting.
+   */
+  getInfo() {
+    return {
+      id: this.id,
+      name: this.name,
+      provider: this.provider,
+      status: this.status,
+      icon: this.icon,
+      metadata: {
+        bucket: this.bucketName,
+        ...this.endpoint && { endpoint: this.endpoint },
+        ...this.prefix && { prefix: this.prefix }
+      }
+    };
+  }
+  /**
+   * Get instructions describing this GCS filesystem.
+   * Used by agents to understand storage semantics.
+   */
+  getInstructions() {
+    const access = this.readOnly ? "Read-only" : "Persistent";
+    return `Google Cloud Storage in bucket "${this.bucketName}". ${access} storage - files are retained across sessions.`;
+  }
+  getStorage() {
+    if (this._storage) return this._storage;
+    const options = {};
+    if (this.projectId) {
+      options.projectId = this.projectId;
+    }
+    if (this.credentials) {
+      if (typeof this.credentials === "string") {
+        options.keyFilename = this.credentials;
+      } else {
+        options.credentials = this.credentials;
+      }
+    }
+    if (this.endpoint) {
+      options.apiEndpoint = this.endpoint;
+    }
+    this._storage = new storage.Storage(options);
+    return this._storage;
+  }
+  getBucket() {
+    if (this._bucket) return this._bucket;
+    const storage = this.getStorage();
+    this._bucket = storage.bucket(this.bucketName);
+    return this._bucket;
+  }
+  /**
+   * Ensure the filesystem is initialized and return the bucket.
+   * Uses base class ensureReady() for status management, then returns bucket.
+   */
+  async getReadyBucket() {
+    await this.ensureReady();
+    return this.getBucket();
+  }
+  toKey(path) {
+    const cleanPath = path.replace(/^\/+/, "");
+    return this.prefix + cleanPath;
+  }
+  // ---------------------------------------------------------------------------
+  // File Operations
+  // ---------------------------------------------------------------------------
+  async readFile(path, options) {
+    const bucket = await this.getReadyBucket();
+    const file = bucket.file(this.toKey(path));
+    try {
+      const [content] = await file.download();
+      if (options?.encoding) {
+        return content.toString(options.encoding);
+      }
+      return content;
+    } catch (error) {
+      if (error && typeof error === "object" && "code" in error && error.code === 404) {
+        throw new workspace.FileNotFoundError(path);
+      }
+      throw error;
+    }
+  }
+  async writeFile(path, content, _options) {
+    const bucket = await this.getReadyBucket();
+    const file = bucket.file(this.toKey(path));
+    const body = typeof content === "string" ? Buffer.from(content, "utf-8") : Buffer.from(content);
+    const contentType = getMimeType(path);
+    await file.save(body, {
+      contentType,
+      resumable: false
+    });
+  }
+  async appendFile(path, content) {
+    let existing = "";
+    try {
+      existing = await this.readFile(path, { encoding: "utf-8" });
+    } catch (error) {
+      if (error instanceof workspace.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 bucket = await this.getReadyBucket();
+    const file = bucket.file(this.toKey(path));
+    try {
+      await file.delete();
+    } catch (error) {
+      if (!options?.force) {
+        if (error && typeof error === "object" && "code" in error && error.code === 404) {
+          throw new workspace.FileNotFoundError(path);
+        }
+        throw error;
+      }
+    }
+  }
+  async copyFile(src, dest, _options) {
+    const bucket = await this.getReadyBucket();
+    const srcFile = bucket.file(this.toKey(src));
+    const destFile = bucket.file(this.toKey(dest));
+    try {
+      await srcFile.copy(destFile);
+    } catch (error) {
+      if (error && typeof error === "object" && "code" in error && error.code === 404) {
+        throw new workspace.FileNotFoundError(src);
+      }
+      throw 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 bucket2 = await this.getReadyBucket();
+      const prefix2 = this.toKey(path).replace(/\/$/, "") + "/";
+      const [files] = await bucket2.getFiles({ prefix: prefix2, maxResults: 1 });
+      if (files.length > 0) {
+        throw new Error(`Directory not empty: ${path}`);
+      }
+      return;
+    }
+    const bucket = await this.getReadyBucket();
+    const prefix = this.toKey(path).replace(/\/$/, "") + "/";
+    await bucket.deleteFiles({ prefix });
+  }
+  async readdir(path, options) {
+    const bucket = await this.getReadyBucket();
+    const prefix = this.toKey(path).replace(/\/$/, "");
+    const searchPrefix = prefix ? prefix + "/" : "";
+    const entries = [];
+    const seenDirs = /* @__PURE__ */ new Set();
+    const [files] = await bucket.getFiles({
+      prefix: searchPrefix,
+      autoPaginate: true
+    });
+    for (const file of files) {
+      const key = file.name;
+      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?.recursive && relativePath.includes("/")) {
+        if (!seenDirs.has(name)) {
+          seenDirs.add(name);
+          entries.push({ name, type: "directory" });
+        }
+        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: file.metadata.size != null ? Number(file.metadata.size) : void 0
+      });
+    }
+    return entries;
+  }
+  // ---------------------------------------------------------------------------
+  // Path Operations
+  // ---------------------------------------------------------------------------
+  async exists(path) {
+    const key = this.toKey(path);
+    if (!key) return true;
+    const bucket = await this.getReadyBucket();
+    const file = bucket.file(key);
+    const [exists] = await file.exists();
+    if (exists) return true;
+    const [files] = await bucket.getFiles({
+      prefix: key.replace(/\/$/, "") + "/",
+      maxResults: 1
+    });
+    return files.length > 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 bucket = await this.getReadyBucket();
+    const file = bucket.file(key);
+    const [exists] = await file.exists();
+    if (exists) {
+      const [metadata] = await file.getMetadata();
+      const name = path.split("/").pop() ?? "";
+      return {
+        name,
+        path,
+        type: "file",
+        size: Number(metadata.size) || 0,
+        createdAt: metadata.timeCreated ? new Date(metadata.timeCreated) : /* @__PURE__ */ new Date(),
+        modifiedAt: metadata.updated ? new Date(metadata.updated) : /* @__PURE__ */ new Date()
+      };
+    }
+    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 workspace.FileNotFoundError(path);
+  }
+  async isFile(path) {
+    const key = this.toKey(path);
+    if (!key) return false;
+    const bucket = await this.getReadyBucket();
+    const file = bucket.file(key);
+    const [exists] = await file.exists();
+    return exists;
+  }
+  async isDirectory(path) {
+    const key = this.toKey(path);
+    if (!key) return true;
+    const bucket = await this.getReadyBucket();
+    const [files] = await bucket.getFiles({
+      prefix: key.replace(/\/$/, "") + "/",
+      maxResults: 1
+    });
+    return files.length > 0;
+  }
+  // ---------------------------------------------------------------------------
+  // Lifecycle (overrides base class protected methods)
+  // ---------------------------------------------------------------------------
+  /**
+   * Initialize the GCS client.
+   * Status management is handled by the base class.
+   */
+  async init() {
+    const bucket = this.getBucket();
+    try {
+      const [exists] = await bucket.exists();
+      if (!exists) {
+        const err = new Error(`Bucket "${this.bucketName}" does not exist`);
+        err.status = 404;
+        throw err;
+      }
+    } catch (error) {
+      if (error.status) {
+        throw error;
+      }
+      const code = error.code;
+      if (typeof code === "number") {
+        const message = error instanceof Error ? error.message : String(error);
+        const err = new Error(
+          message
+          // code === 403
+          //   ? `Access denied to bucket "${this.bucketName}" - check credentials and permissions`
+          //   : message,
+        );
+        err.status = code;
+        throw err;
+      }
+      throw error;
+    }
+  }
+  /**
+   * Clean up the GCS client.
+   * Status management is handled by the base class.
+   */
+  async destroy() {
+    this._storage = null;
+    this._bucket = null;
+  }
+};
+
+exports.GCSFilesystem = GCSFilesystem;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/filesystem/index.ts"],"names":["MastraFilesystem","Storage","FileNotFoundError","bucket","prefix"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * GCS Filesystem Provider\n *\n * A filesystem implementation backed by Google Cloud Storage.\n */\n\nimport { Storage } from '@google-cloud/storage';\nimport type { Bucket } from '@google-cloud/storage';\n\nimport type {\n  FileContent,\n  FileStat,\n  FileEntry,\n  ReadOptions,\n  WriteOptions,\n  ListOptions,\n  RemoveOptions,\n  CopyOptions,\n  FilesystemInfo,\n  FilesystemMountConfig,\n  FilesystemIcon,\n  ProviderStatus,\n} from '@mastra/core/workspace';\nimport { MastraFilesystem, FileNotFoundError } from '@mastra/core/workspace';\n\n/**\n * GCS mount configuration.\n * Returned by GCSFilesystem.getMountConfig() for FUSE mounting in sandboxes.\n */\nexport interface GCSMountConfig extends FilesystemMountConfig {\n  type: 'gcs';\n  /** GCS bucket name */\n  bucket: string;\n  /** Service account key JSON (optional - omit for public buckets or ADC) */\n  serviceAccountKey?: string;\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/**\n * GCS filesystem provider configuration.\n */\nexport interface GCSFilesystemOptions {\n  /** Unique identifier for this filesystem instance */\n  id?: string;\n  /** GCS bucket name */\n  bucket: string;\n  /** Human-friendly display name for the UI */\n  displayName?: string;\n  /** Icon identifier for the UI (defaults to 'gcs') */\n  icon?: FilesystemIcon;\n  /** Description shown in tooltips */\n  description?: string;\n  /**\n   * GCS project ID.\n   * Required when using service account credentials.\n   */\n  projectId?: string;\n  /**\n   * Service account key JSON object or path to key file.\n   * If not provided, uses Application Default Credentials (ADC).\n   */\n  credentials?: object | string;\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   * Custom API endpoint URL.\n   * Used for local development with emulators like fake-gcs-server.\n   */\n  endpoint?: string;\n}\n\n/**\n * GCS filesystem implementation.\n *\n * Stores files in a Google Cloud Storage bucket.\n * Supports mounting into E2B sandboxes via gcsfuse.\n *\n * @example Using Application Default Credentials\n * ```typescript\n * import { GCSFilesystem } from '@mastra/gcs';\n *\n * // Uses ADC (gcloud auth application-default login)\n * const fs = new GCSFilesystem({\n *   bucket: 'my-bucket',\n *   projectId: 'my-project',\n * });\n * ```\n *\n * @example Using Service Account Key\n * ```typescript\n * import { GCSFilesystem } from '@mastra/gcs';\n *\n * const fs = new GCSFilesystem({\n *   bucket: 'my-bucket',\n *   projectId: 'my-project',\n *   credentials: {\n *     type: 'service_account',\n *     project_id: 'my-project',\n *     private_key_id: '...',\n *     private_key: '-----BEGIN PRIVATE KEY-----\\n...',\n *     client_email: '...@...iam.gserviceaccount.com',\n *     // ... rest of service account key\n *   },\n * });\n * ```\n *\n * @example Using Key File Path\n * ```typescript\n * import { GCSFilesystem } from '@mastra/gcs';\n *\n * const fs = new GCSFilesystem({\n *   bucket: 'my-bucket',\n *   projectId: 'my-project',\n *   credentials: '/path/to/service-account-key.json',\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 GCSFilesystem extends MastraFilesystem {\n  readonly id: string;\n  readonly name = 'GCSFilesystem';\n  readonly provider = 'gcs';\n  readonly readOnly?: boolean;\n\n  status: ProviderStatus = 'pending';\n\n  // Display metadata for UI\n  readonly displayName?: string;\n  readonly icon: FilesystemIcon = 'gcs';\n  readonly description?: string;\n\n  private readonly bucketName: string;\n  private readonly projectId?: string;\n  private readonly credentials?: object | string;\n  private readonly prefix: string;\n  private readonly endpoint?: string;\n\n  private _storage: Storage | null = null;\n  private _bucket: Bucket | null = null;\n\n  constructor(options: GCSFilesystemOptions) {\n    super({ name: 'GCSFilesystem' });\n    this.id = options.id ?? `gcs-fs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;\n    this.bucketName = options.bucket;\n    this.projectId = options.projectId;\n    this.credentials = options.credentials;\n    // Trim leading/trailing slashes from prefix using iterative approach (avoids polynomial regex)\n    this.prefix = options.prefix ? trimSlashes(options.prefix) + '/' : '';\n    this.endpoint = options.endpoint;\n\n    // Display metadata\n    this.displayName = options.displayName ?? 'Google Cloud Storage';\n    this.icon = options.icon ?? 'gcs';\n    this.description = options.description;\n    this.readOnly = options.readOnly;\n  }\n\n  /**\n   * Get mount configuration for E2B sandbox.\n   * Returns GCS-compatible config that works with gcsfuse.\n   */\n  getMountConfig(): GCSMountConfig {\n    const config: GCSMountConfig = {\n      type: 'gcs',\n      bucket: this.bucketName,\n    };\n\n    // Include service account key if credentials are an object\n    if (this.credentials && typeof this.credentials === 'object') {\n      config.serviceAccountKey = JSON.stringify(this.credentials);\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      icon: this.icon,\n      metadata: {\n        bucket: this.bucketName,\n        ...(this.endpoint && { endpoint: this.endpoint }),\n        ...(this.prefix && { prefix: this.prefix }),\n      },\n    };\n  }\n\n  /**\n   * Get instructions describing this GCS filesystem.\n   * Used by agents to understand storage semantics.\n   */\n  getInstructions(): string {\n    const access = this.readOnly ? 'Read-only' : 'Persistent';\n    return `Google Cloud Storage in bucket \"${this.bucketName}\". ${access} storage - files are retained across sessions.`;\n  }\n\n  private getStorage(): Storage {\n    if (this._storage) return this._storage;\n\n    const options: { projectId?: string; credentials?: object; keyFilename?: string; apiEndpoint?: string } = {};\n\n    if (this.projectId) {\n      options.projectId = this.projectId;\n    }\n\n    if (this.credentials) {\n      if (typeof this.credentials === 'string') {\n        // Path to key file\n        options.keyFilename = this.credentials;\n      } else {\n        // Credentials object\n        options.credentials = this.credentials;\n      }\n    }\n\n    if (this.endpoint) {\n      options.apiEndpoint = this.endpoint;\n    }\n\n    this._storage = new Storage(options);\n    return this._storage;\n  }\n\n  private getBucket(): Bucket {\n    if (this._bucket) return this._bucket;\n\n    const storage = this.getStorage();\n    this._bucket = storage.bucket(this.bucketName);\n    return this._bucket;\n  }\n\n  /**\n   * Ensure the filesystem is initialized and return the bucket.\n   * Uses base class ensureReady() for status management, then returns bucket.\n   */\n  private async getReadyBucket(): Promise<Bucket> {\n    await this.ensureReady();\n    return this.getBucket();\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 bucket = await this.getReadyBucket();\n    const file = bucket.file(this.toKey(path));\n\n    try {\n      const [content] = await file.download();\n\n      if (options?.encoding) {\n        return content.toString(options.encoding);\n      }\n      return content;\n    } catch (error: unknown) {\n      if (error && typeof error === 'object' && 'code' in error && error.code === 404) {\n        throw new FileNotFoundError(path);\n      }\n      throw error;\n    }\n  }\n\n  async writeFile(path: string, content: FileContent, _options?: WriteOptions): Promise<void> {\n    const bucket = await this.getReadyBucket();\n    const file = bucket.file(this.toKey(path));\n\n    const body = typeof content === 'string' ? Buffer.from(content, 'utf-8') : Buffer.from(content);\n    const contentType = getMimeType(path);\n\n    await file.save(body, {\n      contentType,\n      resumable: false,\n    });\n  }\n\n  async appendFile(path: string, content: FileContent): Promise<void> {\n    // GCS 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 bucket = await this.getReadyBucket();\n    const file = bucket.file(this.toKey(path));\n\n    try {\n      await file.delete();\n    } catch (error: unknown) {\n      if (!options?.force) {\n        if (error && typeof error === 'object' && 'code' in error && error.code === 404) {\n          throw new FileNotFoundError(path);\n        }\n        throw error;\n      }\n    }\n  }\n\n  async copyFile(src: string, dest: string, _options?: CopyOptions): Promise<void> {\n    const bucket = await this.getReadyBucket();\n    const srcFile = bucket.file(this.toKey(src));\n    const destFile = bucket.file(this.toKey(dest));\n\n    try {\n      await srcFile.copy(destFile);\n    } catch (error: unknown) {\n      if (error && typeof error === 'object' && 'code' in error && error.code === 404) {\n        throw new FileNotFoundError(src);\n      }\n      throw 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    // GCS 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      // Quick emptiness check — only fetch one object instead of full readdir\n      const bucket = await this.getReadyBucket();\n      const prefix = this.toKey(path).replace(/\\/$/, '') + '/';\n      const [files] = await bucket.getFiles({ prefix, maxResults: 1 });\n      if (files.length > 0) {\n        throw new Error(`Directory not empty: ${path}`);\n      }\n      return;\n    }\n\n    // Delete all objects with this prefix\n    const bucket = await this.getReadyBucket();\n    const prefix = this.toKey(path).replace(/\\/$/, '') + '/';\n\n    await bucket.deleteFiles({ prefix });\n  }\n\n  async readdir(path: string, options?: ListOptions): Promise<FileEntry[]> {\n    const bucket = await this.getReadyBucket();\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    const [files] = await bucket.getFiles({\n      prefix: searchPrefix,\n      autoPaginate: true,\n    });\n\n    for (const file of files) {\n      const key = file.name;\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      // For non-recursive listing, if there's a slash, it's a directory\n      if (!options?.recursive && relativePath.includes('/')) {\n        if (!seenDirs.has(name)) {\n          seenDirs.add(name);\n          entries.push({ name, type: 'directory' });\n        }\n        continue;\n      }\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: file.metadata.size != null ? Number(file.metadata.size) : undefined,\n      });\n    }\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\n    // Root path always exists (it's the bucket itself)\n    if (!key) return true;\n\n    const bucket = await this.getReadyBucket();\n    const file = bucket.file(key);\n\n    // Check if it's a file\n    const [exists] = await file.exists();\n    if (exists) return true;\n\n    // Check if it's a \"directory\" (has objects with this prefix)\n    const [files] = await bucket.getFiles({\n      prefix: key.replace(/\\/$/, '') + '/',\n      maxResults: 1,\n    });\n\n    return files.length > 0;\n  }\n\n  async stat(path: string): Promise<FileStat> {\n    const key = this.toKey(path);\n\n    // Root path 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 bucket = await this.getReadyBucket();\n    const file = bucket.file(key);\n\n    const [exists] = await file.exists();\n    if (exists) {\n      const [metadata] = await file.getMetadata();\n      const name = path.split('/').pop() ?? '';\n\n      return {\n        name,\n        path,\n        type: 'file',\n        size: Number(metadata.size) || 0,\n        createdAt: metadata.timeCreated ? new Date(metadata.timeCreated) : new Date(),\n        modifiedAt: metadata.updated ? new Date(metadata.updated) : new Date(),\n      };\n    }\n\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\n    throw new FileNotFoundError(path);\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 bucket = await this.getReadyBucket();\n    const file = bucket.file(key);\n\n    const [exists] = await file.exists();\n    return exists;\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 bucket = await this.getReadyBucket();\n\n    const [files] = await bucket.getFiles({\n      prefix: key.replace(/\\/$/, '') + '/',\n      maxResults: 1,\n    });\n\n    return files.length > 0;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Lifecycle (overrides base class protected methods)\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Initialize the GCS 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 bucket = this.getBucket();\n    try {\n      const [exists] = await bucket.exists();\n      if (!exists) {\n        const err = new Error(`Bucket \"${this.bucketName}\" does not exist`) as Error & { status?: number };\n        err.status = 404;\n        throw err;\n      }\n    } catch (error) {\n      // Check if error already has status (from our 404 throw above)\n      if ((error as { status?: number }).status) {\n        throw error;\n      }\n      // Extract status code from GCS errors and add to error for proper HTTP response\n      const code = (error as { code?: number }).code;\n      if (typeof code === 'number') {\n        const message = error instanceof Error ? error.message : String(error);\n        const err = new Error(\n          message,\n          // code === 403\n          //   ? `Access denied to bucket \"${this.bucketName}\" - check credentials and permissions`\n          //   : message,\n        ) as Error & { status?: number };\n        err.status = code;\n        throw err;\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Clean up the GCS client.\n   * Status management is handled by the base class.\n   */\n  async destroy(): Promise<void> {\n    this._storage = null;\n    this._bucket = null;\n  }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @mastra/gcs - Google Cloud Storage Filesystem Provider
+ *
+ * A filesystem implementation backed by Google Cloud Storage.
+ */
+export { GCSFilesystem, type GCSFilesystemOptions, type GCSMountConfig } from './filesystem/index.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;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,424 @@
+import { Storage } from '@google-cloud/storage';
+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 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 GCSFilesystem = class extends MastraFilesystem {
+  id;
+  name = "GCSFilesystem";
+  provider = "gcs";
+  readOnly;
+  status = "pending";
+  // Display metadata for UI
+  displayName;
+  icon = "gcs";
+  description;
+  bucketName;
+  projectId;
+  credentials;
+  prefix;
+  endpoint;
+  _storage = null;
+  _bucket = null;
+  constructor(options) {
+    super({ name: "GCSFilesystem" });
+    this.id = options.id ?? `gcs-fs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+    this.bucketName = options.bucket;
+    this.projectId = options.projectId;
+    this.credentials = options.credentials;
+    this.prefix = options.prefix ? trimSlashes(options.prefix) + "/" : "";
+    this.endpoint = options.endpoint;
+    this.displayName = options.displayName ?? "Google Cloud Storage";
+    this.icon = options.icon ?? "gcs";
+    this.description = options.description;
+    this.readOnly = options.readOnly;
+  }
+  /**
+   * Get mount configuration for E2B sandbox.
+   * Returns GCS-compatible config that works with gcsfuse.
+   */
+  getMountConfig() {
+    const config = {
+      type: "gcs",
+      bucket: this.bucketName
+    };
+    if (this.credentials && typeof this.credentials === "object") {
+      config.serviceAccountKey = JSON.stringify(this.credentials);
+    }
+    return config;
+  }
+  /**
+   * Get filesystem info for status reporting.
+   */
+  getInfo() {
+    return {
+      id: this.id,
+      name: this.name,
+      provider: this.provider,
+      status: this.status,
+      icon: this.icon,
+      metadata: {
+        bucket: this.bucketName,
+        ...this.endpoint && { endpoint: this.endpoint },
+        ...this.prefix && { prefix: this.prefix }
+      }
+    };
+  }
+  /**
+   * Get instructions describing this GCS filesystem.
+   * Used by agents to understand storage semantics.
+   */
+  getInstructions() {
+    const access = this.readOnly ? "Read-only" : "Persistent";
+    return `Google Cloud Storage in bucket "${this.bucketName}". ${access} storage - files are retained across sessions.`;
+  }
+  getStorage() {
+    if (this._storage) return this._storage;
+    const options = {};
+    if (this.projectId) {
+      options.projectId = this.projectId;
+    }
+    if (this.credentials) {
+      if (typeof this.credentials === "string") {
+        options.keyFilename = this.credentials;
+      } else {
+        options.credentials = this.credentials;
+      }
+    }
+    if (this.endpoint) {
+      options.apiEndpoint = this.endpoint;
+    }
+    this._storage = new Storage(options);
+    return this._storage;
+  }
+  getBucket() {
+    if (this._bucket) return this._bucket;
+    const storage = this.getStorage();
+    this._bucket = storage.bucket(this.bucketName);
+    return this._bucket;
+  }
+  /**
+   * Ensure the filesystem is initialized and return the bucket.
+   * Uses base class ensureReady() for status management, then returns bucket.
+   */
+  async getReadyBucket() {
+    await this.ensureReady();
+    return this.getBucket();
+  }
+  toKey(path) {
+    const cleanPath = path.replace(/^\/+/, "");
+    return this.prefix + cleanPath;
+  }
+  // ---------------------------------------------------------------------------
+  // File Operations
+  // ---------------------------------------------------------------------------
+  async readFile(path, options) {
+    const bucket = await this.getReadyBucket();
+    const file = bucket.file(this.toKey(path));
+    try {
+      const [content] = await file.download();
+      if (options?.encoding) {
+        return content.toString(options.encoding);
+      }
+      return content;
+    } catch (error) {
+      if (error && typeof error === "object" && "code" in error && error.code === 404) {
+        throw new FileNotFoundError(path);
+      }
+      throw error;
+    }
+  }
+  async writeFile(path, content, _options) {
+    const bucket = await this.getReadyBucket();
+    const file = bucket.file(this.toKey(path));
+    const body = typeof content === "string" ? Buffer.from(content, "utf-8") : Buffer.from(content);
+    const contentType = getMimeType(path);
+    await file.save(body, {
+      contentType,
+      resumable: false
+    });
+  }
+  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 bucket = await this.getReadyBucket();
+    const file = bucket.file(this.toKey(path));
+    try {
+      await file.delete();
+    } catch (error) {
+      if (!options?.force) {
+        if (error && typeof error === "object" && "code" in error && error.code === 404) {
+          throw new FileNotFoundError(path);
+        }
+        throw error;
+      }
+    }
+  }
+  async copyFile(src, dest, _options) {
+    const bucket = await this.getReadyBucket();
+    const srcFile = bucket.file(this.toKey(src));
+    const destFile = bucket.file(this.toKey(dest));
+    try {
+      await srcFile.copy(destFile);
+    } catch (error) {
+      if (error && typeof error === "object" && "code" in error && error.code === 404) {
+        throw new FileNotFoundError(src);
+      }
+      throw 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 bucket2 = await this.getReadyBucket();
+      const prefix2 = this.toKey(path).replace(/\/$/, "") + "/";
+      const [files] = await bucket2.getFiles({ prefix: prefix2, maxResults: 1 });
+      if (files.length > 0) {
+        throw new Error(`Directory not empty: ${path}`);
+      }
+      return;
+    }
+    const bucket = await this.getReadyBucket();
+    const prefix = this.toKey(path).replace(/\/$/, "") + "/";
+    await bucket.deleteFiles({ prefix });
+  }
+  async readdir(path, options) {
+    const bucket = await this.getReadyBucket();
+    const prefix = this.toKey(path).replace(/\/$/, "");
+    const searchPrefix = prefix ? prefix + "/" : "";
+    const entries = [];
+    const seenDirs = /* @__PURE__ */ new Set();
+    const [files] = await bucket.getFiles({
+      prefix: searchPrefix,
+      autoPaginate: true
+    });
+    for (const file of files) {
+      const key = file.name;
+      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?.recursive && relativePath.includes("/")) {
+        if (!seenDirs.has(name)) {
+          seenDirs.add(name);
+          entries.push({ name, type: "directory" });
+        }
+        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: file.metadata.size != null ? Number(file.metadata.size) : void 0
+      });
+    }
+    return entries;
+  }
+  // ---------------------------------------------------------------------------
+  // Path Operations
+  // ---------------------------------------------------------------------------
+  async exists(path) {
+    const key = this.toKey(path);
+    if (!key) return true;
+    const bucket = await this.getReadyBucket();
+    const file = bucket.file(key);
+    const [exists] = await file.exists();
+    if (exists) return true;
+    const [files] = await bucket.getFiles({
+      prefix: key.replace(/\/$/, "") + "/",
+      maxResults: 1
+    });
+    return files.length > 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 bucket = await this.getReadyBucket();
+    const file = bucket.file(key);
+    const [exists] = await file.exists();
+    if (exists) {
+      const [metadata] = await file.getMetadata();
+      const name = path.split("/").pop() ?? "";
+      return {
+        name,
+        path,
+        type: "file",
+        size: Number(metadata.size) || 0,
+        createdAt: metadata.timeCreated ? new Date(metadata.timeCreated) : /* @__PURE__ */ new Date(),
+        modifiedAt: metadata.updated ? new Date(metadata.updated) : /* @__PURE__ */ new Date()
+      };
+    }
+    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 bucket = await this.getReadyBucket();
+    const file = bucket.file(key);
+    const [exists] = await file.exists();
+    return exists;
+  }
+  async isDirectory(path) {
+    const key = this.toKey(path);
+    if (!key) return true;
+    const bucket = await this.getReadyBucket();
+    const [files] = await bucket.getFiles({
+      prefix: key.replace(/\/$/, "") + "/",
+      maxResults: 1
+    });
+    return files.length > 0;
+  }
+  // ---------------------------------------------------------------------------
+  // Lifecycle (overrides base class protected methods)
+  // ---------------------------------------------------------------------------
+  /**
+   * Initialize the GCS client.
+   * Status management is handled by the base class.
+   */
+  async init() {
+    const bucket = this.getBucket();
+    try {
+      const [exists] = await bucket.exists();
+      if (!exists) {
+        const err = new Error(`Bucket "${this.bucketName}" does not exist`);
+        err.status = 404;
+        throw err;
+      }
+    } catch (error) {
+      if (error.status) {
+        throw error;
+      }
+      const code = error.code;
+      if (typeof code === "number") {
+        const message = error instanceof Error ? error.message : String(error);
+        const err = new Error(
+          message
+          // code === 403
+          //   ? `Access denied to bucket "${this.bucketName}" - check credentials and permissions`
+          //   : message,
+        );
+        err.status = code;
+        throw err;
+      }
+      throw error;
+    }
+  }
+  /**
+   * Clean up the GCS client.
+   * Status management is handled by the base class.
+   */
+  async destroy() {
+    this._storage = null;
+    this._bucket = null;
+  }
+};
+
+export { GCSFilesystem };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/filesystem/index.ts"],"names":["bucket","prefix"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * GCS Filesystem Provider\n *\n * A filesystem implementation backed by Google Cloud Storage.\n */\n\nimport { Storage } from '@google-cloud/storage';\nimport type { Bucket } from '@google-cloud/storage';\n\nimport type {\n  FileContent,\n  FileStat,\n  FileEntry,\n  ReadOptions,\n  WriteOptions,\n  ListOptions,\n  RemoveOptions,\n  CopyOptions,\n  FilesystemInfo,\n  FilesystemMountConfig,\n  FilesystemIcon,\n  ProviderStatus,\n} from '@mastra/core/workspace';\nimport { MastraFilesystem, FileNotFoundError } from '@mastra/core/workspace';\n\n/**\n * GCS mount configuration.\n * Returned by GCSFilesystem.getMountConfig() for FUSE mounting in sandboxes.\n */\nexport interface GCSMountConfig extends FilesystemMountConfig {\n  type: 'gcs';\n  /** GCS bucket name */\n  bucket: string;\n  /** Service account key JSON (optional - omit for public buckets or ADC) */\n  serviceAccountKey?: string;\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/**\n * GCS filesystem provider configuration.\n */\nexport interface GCSFilesystemOptions {\n  /** Unique identifier for this filesystem instance */\n  id?: string;\n  /** GCS bucket name */\n  bucket: string;\n  /** Human-friendly display name for the UI */\n  displayName?: string;\n  /** Icon identifier for the UI (defaults to 'gcs') */\n  icon?: FilesystemIcon;\n  /** Description shown in tooltips */\n  description?: string;\n  /**\n   * GCS project ID.\n   * Required when using service account credentials.\n   */\n  projectId?: string;\n  /**\n   * Service account key JSON object or path to key file.\n   * If not provided, uses Application Default Credentials (ADC).\n   */\n  credentials?: object | string;\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   * Custom API endpoint URL.\n   * Used for local development with emulators like fake-gcs-server.\n   */\n  endpoint?: string;\n}\n\n/**\n * GCS filesystem implementation.\n *\n * Stores files in a Google Cloud Storage bucket.\n * Supports mounting into E2B sandboxes via gcsfuse.\n *\n * @example Using Application Default Credentials\n * ```typescript\n * import { GCSFilesystem } from '@mastra/gcs';\n *\n * // Uses ADC (gcloud auth application-default login)\n * const fs = new GCSFilesystem({\n *   bucket: 'my-bucket',\n *   projectId: 'my-project',\n * });\n * ```\n *\n * @example Using Service Account Key\n * ```typescript\n * import { GCSFilesystem } from '@mastra/gcs';\n *\n * const fs = new GCSFilesystem({\n *   bucket: 'my-bucket',\n *   projectId: 'my-project',\n *   credentials: {\n *     type: 'service_account',\n *     project_id: 'my-project',\n *     private_key_id: '...',\n *     private_key: '-----BEGIN PRIVATE KEY-----\\n...',\n *     client_email: '...@...iam.gserviceaccount.com',\n *     // ... rest of service account key\n *   },\n * });\n * ```\n *\n * @example Using Key File Path\n * ```typescript\n * import { GCSFilesystem } from '@mastra/gcs';\n *\n * const fs = new GCSFilesystem({\n *   bucket: 'my-bucket',\n *   projectId: 'my-project',\n *   credentials: '/path/to/service-account-key.json',\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 GCSFilesystem extends MastraFilesystem {\n  readonly id: string;\n  readonly name = 'GCSFilesystem';\n  readonly provider = 'gcs';\n  readonly readOnly?: boolean;\n\n  status: ProviderStatus = 'pending';\n\n  // Display metadata for UI\n  readonly displayName?: string;\n  readonly icon: FilesystemIcon = 'gcs';\n  readonly description?: string;\n\n  private readonly bucketName: string;\n  private readonly projectId?: string;\n  private readonly credentials?: object | string;\n  private readonly prefix: string;\n  private readonly endpoint?: string;\n\n  private _storage: Storage | null = null;\n  private _bucket: Bucket | null = null;\n\n  constructor(options: GCSFilesystemOptions) {\n    super({ name: 'GCSFilesystem' });\n    this.id = options.id ?? `gcs-fs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;\n    this.bucketName = options.bucket;\n    this.projectId = options.projectId;\n    this.credentials = options.credentials;\n    // Trim leading/trailing slashes from prefix using iterative approach (avoids polynomial regex)\n    this.prefix = options.prefix ? trimSlashes(options.prefix) + '/' : '';\n    this.endpoint = options.endpoint;\n\n    // Display metadata\n    this.displayName = options.displayName ?? 'Google Cloud Storage';\n    this.icon = options.icon ?? 'gcs';\n    this.description = options.description;\n    this.readOnly = options.readOnly;\n  }\n\n  /**\n   * Get mount configuration for E2B sandbox.\n   * Returns GCS-compatible config that works with gcsfuse.\n   */\n  getMountConfig(): GCSMountConfig {\n    const config: GCSMountConfig = {\n      type: 'gcs',\n      bucket: this.bucketName,\n    };\n\n    // Include service account key if credentials are an object\n    if (this.credentials && typeof this.credentials === 'object') {\n      config.serviceAccountKey = JSON.stringify(this.credentials);\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      icon: this.icon,\n      metadata: {\n        bucket: this.bucketName,\n        ...(this.endpoint && { endpoint: this.endpoint }),\n        ...(this.prefix && { prefix: this.prefix }),\n      },\n    };\n  }\n\n  /**\n   * Get instructions describing this GCS filesystem.\n   * Used by agents to understand storage semantics.\n   */\n  getInstructions(): string {\n    const access = this.readOnly ? 'Read-only' : 'Persistent';\n    return `Google Cloud Storage in bucket \"${this.bucketName}\". ${access} storage - files are retained across sessions.`;\n  }\n\n  private getStorage(): Storage {\n    if (this._storage) return this._storage;\n\n    const options: { projectId?: string; credentials?: object; keyFilename?: string; apiEndpoint?: string } = {};\n\n    if (this.projectId) {\n      options.projectId = this.projectId;\n    }\n\n    if (this.credentials) {\n      if (typeof this.credentials === 'string') {\n        // Path to key file\n        options.keyFilename = this.credentials;\n      } else {\n        // Credentials object\n        options.credentials = this.credentials;\n      }\n    }\n\n    if (this.endpoint) {\n      options.apiEndpoint = this.endpoint;\n    }\n\n    this._storage = new Storage(options);\n    return this._storage;\n  }\n\n  private getBucket(): Bucket {\n    if (this._bucket) return this._bucket;\n\n    const storage = this.getStorage();\n    this._bucket = storage.bucket(this.bucketName);\n    return this._bucket;\n  }\n\n  /**\n   * Ensure the filesystem is initialized and return the bucket.\n   * Uses base class ensureReady() for status management, then returns bucket.\n   */\n  private async getReadyBucket(): Promise<Bucket> {\n    await this.ensureReady();\n    return this.getBucket();\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 bucket = await this.getReadyBucket();\n    const file = bucket.file(this.toKey(path));\n\n    try {\n      const [content] = await file.download();\n\n      if (options?.encoding) {\n        return content.toString(options.encoding);\n      }\n      return content;\n    } catch (error: unknown) {\n      if (error && typeof error === 'object' && 'code' in error && error.code === 404) {\n        throw new FileNotFoundError(path);\n      }\n      throw error;\n    }\n  }\n\n  async writeFile(path: string, content: FileContent, _options?: WriteOptions): Promise<void> {\n    const bucket = await this.getReadyBucket();\n    const file = bucket.file(this.toKey(path));\n\n    const body = typeof content === 'string' ? Buffer.from(content, 'utf-8') : Buffer.from(content);\n    const contentType = getMimeType(path);\n\n    await file.save(body, {\n      contentType,\n      resumable: false,\n    });\n  }\n\n  async appendFile(path: string, content: FileContent): Promise<void> {\n    // GCS 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 bucket = await this.getReadyBucket();\n    const file = bucket.file(this.toKey(path));\n\n    try {\n      await file.delete();\n    } catch (error: unknown) {\n      if (!options?.force) {\n        if (error && typeof error === 'object' && 'code' in error && error.code === 404) {\n          throw new FileNotFoundError(path);\n        }\n        throw error;\n      }\n    }\n  }\n\n  async copyFile(src: string, dest: string, _options?: CopyOptions): Promise<void> {\n    const bucket = await this.getReadyBucket();\n    const srcFile = bucket.file(this.toKey(src));\n    const destFile = bucket.file(this.toKey(dest));\n\n    try {\n      await srcFile.copy(destFile);\n    } catch (error: unknown) {\n      if (error && typeof error === 'object' && 'code' in error && error.code === 404) {\n        throw new FileNotFoundError(src);\n      }\n      throw 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    // GCS 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      // Quick emptiness check — only fetch one object instead of full readdir\n      const bucket = await this.getReadyBucket();\n      const prefix = this.toKey(path).replace(/\\/$/, '') + '/';\n      const [files] = await bucket.getFiles({ prefix, maxResults: 1 });\n      if (files.length > 0) {\n        throw new Error(`Directory not empty: ${path}`);\n      }\n      return;\n    }\n\n    // Delete all objects with this prefix\n    const bucket = await this.getReadyBucket();\n    const prefix = this.toKey(path).replace(/\\/$/, '') + '/';\n\n    await bucket.deleteFiles({ prefix });\n  }\n\n  async readdir(path: string, options?: ListOptions): Promise<FileEntry[]> {\n    const bucket = await this.getReadyBucket();\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    const [files] = await bucket.getFiles({\n      prefix: searchPrefix,\n      autoPaginate: true,\n    });\n\n    for (const file of files) {\n      const key = file.name;\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      // For non-recursive listing, if there's a slash, it's a directory\n      if (!options?.recursive && relativePath.includes('/')) {\n        if (!seenDirs.has(name)) {\n          seenDirs.add(name);\n          entries.push({ name, type: 'directory' });\n        }\n        continue;\n      }\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: file.metadata.size != null ? Number(file.metadata.size) : undefined,\n      });\n    }\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\n    // Root path always exists (it's the bucket itself)\n    if (!key) return true;\n\n    const bucket = await this.getReadyBucket();\n    const file = bucket.file(key);\n\n    // Check if it's a file\n    const [exists] = await file.exists();\n    if (exists) return true;\n\n    // Check if it's a \"directory\" (has objects with this prefix)\n    const [files] = await bucket.getFiles({\n      prefix: key.replace(/\\/$/, '') + '/',\n      maxResults: 1,\n    });\n\n    return files.length > 0;\n  }\n\n  async stat(path: string): Promise<FileStat> {\n    const key = this.toKey(path);\n\n    // Root path 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 bucket = await this.getReadyBucket();\n    const file = bucket.file(key);\n\n    const [exists] = await file.exists();\n    if (exists) {\n      const [metadata] = await file.getMetadata();\n      const name = path.split('/').pop() ?? '';\n\n      return {\n        name,\n        path,\n        type: 'file',\n        size: Number(metadata.size) || 0,\n        createdAt: metadata.timeCreated ? new Date(metadata.timeCreated) : new Date(),\n        modifiedAt: metadata.updated ? new Date(metadata.updated) : new Date(),\n      };\n    }\n\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\n    throw new FileNotFoundError(path);\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 bucket = await this.getReadyBucket();\n    const file = bucket.file(key);\n\n    const [exists] = await file.exists();\n    return exists;\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 bucket = await this.getReadyBucket();\n\n    const [files] = await bucket.getFiles({\n      prefix: key.replace(/\\/$/, '') + '/',\n      maxResults: 1,\n    });\n\n    return files.length > 0;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Lifecycle (overrides base class protected methods)\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Initialize the GCS 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 bucket = this.getBucket();\n    try {\n      const [exists] = await bucket.exists();\n      if (!exists) {\n        const err = new Error(`Bucket \"${this.bucketName}\" does not exist`) as Error & { status?: number };\n        err.status = 404;\n        throw err;\n      }\n    } catch (error) {\n      // Check if error already has status (from our 404 throw above)\n      if ((error as { status?: number }).status) {\n        throw error;\n      }\n      // Extract status code from GCS errors and add to error for proper HTTP response\n      const code = (error as { code?: number }).code;\n      if (typeof code === 'number') {\n        const message = error instanceof Error ? error.message : String(error);\n        const err = new Error(\n          message,\n          // code === 403\n          //   ? `Access denied to bucket \"${this.bucketName}\" - check credentials and permissions`\n          //   : message,\n        ) as Error & { status?: number };\n        err.status = code;\n        throw err;\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Clean up the GCS client.\n   * Status management is handled by the base class.\n   */\n  async destroy(): Promise<void> {\n    this._storage = null;\n    this._bucket = null;\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@mastra/gcs",
+  "version": "0.0.0",
+  "description": "Google Cloud Storage filesystem provider for Mastra workspaces",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@google-cloud/storage": "^7.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.19.7",
+    "dotenv": "^17.2.3",
+    "@vitest/coverage-v8": "4.0.12",
+    "@vitest/ui": "4.0.12",
+    "eslint": "^9.37.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "4.0.16",
+    "@internal/lint": "0.0.57",
+    "@internal/workspace-test-utils": "0.0.1",
+    "@internal/types-builder": "0.0.32",
+    "@mastra/core": "1.2.1-alpha.0"
+  },
+  "peerDependencies": {
+    "@mastra/core": ">=1.3.0-0 <2.0.0-0"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "homepage": "https://mastra.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mastra-ai/mastra.git",
+    "directory": "workspaces/gcs"
+  },
+  "bugs": {
+    "url": "https://github.com/mastra-ai/mastra/issues"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "scripts": {
+    "build": "tsup --silent --config tsup.config.ts",
+    "build:lib": "pnpm build",
+    "build:watch": "pnpm build --watch",
+    "test:unit": "vitest run --exclude '**/*.integration.test.ts'",
+    "test:watch": "vitest watch",
+    "pretest": "docker compose up -d && sleep 3",
+    "test": "GCS_ENDPOINT=http://localhost:4443 TEST_GCS_BUCKET=test-bucket vitest run ./src/**/*.integration.test.ts",
+    "posttest": "docker compose down -v",
+    "test:cloud": "vitest run ./src/**/*.integration.test.ts",
+    "lint": "eslint ."
+  }
+}