@mastra/files-sdk 0.0.0-feat-playground-ui-input-button-groups-20260529070627

package/CHANGELOG.md

@@ -0,0 +1,58 @@
+# @mastra/files-sdk
+
+## 0.0.0-feat-playground-ui-input-button-groups-20260529070627
+
+### Patch Changes
+
+- Updated dependencies [[`d779de3`](https://github.com/mastra-ai/mastra/commit/d779de3cd9d2e7ed8110547190e2f15e786a0e41), [`1750c97`](https://github.com/mastra-ai/mastra/commit/1750c975d6179fbf6db2813b15229d4f8f23fc55), [`0f0d1ba`](https://github.com/mastra-ai/mastra/commit/0f0d1ba67bfcb2204e571401662f1eceefc03357), [`0e32507`](https://github.com/mastra-ai/mastra/commit/0e32507962cdfa5569b7bda5bc6fb3dd34e40b03), [`07c3de7`](https://github.com/mastra-ai/mastra/commit/07c3de7f7bc418beccaea3b5e6b7f7cdda79d492), [`50ceae2`](https://github.com/mastra-ai/mastra/commit/50ceae270878e2f8fb2b2c6c2faab09df0007c8a), [`3a081c1`](https://github.com/mastra-ai/mastra/commit/3a081c1255c5ae8c99f6dad91cc612934ef6f2bd), [`49f8abc`](https://github.com/mastra-ai/mastra/commit/49f8abce8258e4f2f87bd326acfbdb641264a47c), [`fe9eacd`](https://github.com/mastra-ai/mastra/commit/fe9eacd9545a0a9d64aad31c9fa90294a425289e), [`db79c86`](https://github.com/mastra-ai/mastra/commit/db79c86c60723d57e02f9636ca2611bd4515f194)]:
+  - @mastra/core@0.0.0-feat-playground-ui-input-button-groups-20260529070627
+
+## 0.2.0
+
+### Minor Changes
+
+- Added @mastra/files-sdk workspace filesystem provider — a unified storage adapter backed by [FilesSDK](https://files-sdk.dev). Supports any FilesSDK adapter (S3, R2, GCS, Azure Blob, Vercel Blob, local filesystem, and more) through a single `FilesSDKFilesystem` class that implements the `WorkspaceFilesystem` interface. ([#17027](https://github.com/mastra-ai/mastra/pull/17027))
+
+  **Usage**
+
+  ```ts
+  import { Files } from 'files-sdk';
+  import { s3 } from 'files-sdk/s3';
+  import { FilesSDKFilesystem } from '@mastra/files-sdk';
+
+  const files = new Files({ adapter: s3({ bucket: 'my-bucket', region: 'us-east-1' }) });
+
+  const filesystem = new FilesSDKFilesystem({ files });
+  ```
+
+  Swap adapters without changing code — just replace `s3()` with `r2()`, `gcs()`, `azure()`, `fs()`, etc.
+
+### Patch Changes
+
+- Updated dependencies [[`cfa2e3a`](https://github.com/mastra-ai/mastra/commit/cfa2e3a5292322f48bb28b4d257d631da7f9d3cc), [`0cbece9`](https://github.com/mastra-ai/mastra/commit/0cbece9d832cb134a74cdbf3682d390a058215a4), [`2f5f58a`](https://github.com/mastra-ai/mastra/commit/2f5f58a9a8bb13bcdc6789db221eef7c9bf1ff02), [`7dfe1bc`](https://github.com/mastra-ai/mastra/commit/7dfe1bcfe71d261a6fd6bbf29b1dec49d78fb98f), [`ac442a4`](https://github.com/mastra-ai/mastra/commit/ac442a42fda0354ac2bcea772bf6691cb3e9dbb3), [`b7286f4`](https://github.com/mastra-ai/mastra/commit/b7286f4308267f5fd70e6bfee10dba9472640906), [`6096445`](https://github.com/mastra-ai/mastra/commit/60964459733f0ab384584d95e19c36607ffdf7b0), [`d72dc4b`](https://github.com/mastra-ai/mastra/commit/d72dc4b12d832546c05c20255fa96fe4eb515900), [`a481027`](https://github.com/mastra-ai/mastra/commit/a481027b549ba1018414990c8f045eaee7b9f413), [`1e5c067`](https://github.com/mastra-ai/mastra/commit/1e5c067d2e20a781af670578180d1ee249806d41), [`168fa09`](https://github.com/mastra-ai/mastra/commit/168fa09d6b39114cb8c13bd06f1dccb9bc81c6cd), [`df1947a`](https://github.com/mastra-ai/mastra/commit/df1947affa40f742067542251fac7ca759492ef4), [`ee59b74`](https://github.com/mastra-ai/mastra/commit/ee59b743ce73ad11784b4d9c6fbba8568edee1c8), [`a97b1a0`](https://github.com/mastra-ai/mastra/commit/a97b1a0abaed83946c3519d1e0f680d0815b8a67), [`008baaf`](https://github.com/mastra-ai/mastra/commit/008baafd8d851f831407045aebead5a2e3342eff), [`801baa0`](https://github.com/mastra-ai/mastra/commit/801baa07cccdbaec1d00942a92bdc831111744a2), [`8116436`](https://github.com/mastra-ai/mastra/commit/81164363eb225d774e41ff27da6a5ea611406688), [`c35b962`](https://github.com/mastra-ai/mastra/commit/c35b9625c7e854fcfdeee226a3338a750d0ff211), [`c27c4b9`](https://github.com/mastra-ai/mastra/commit/c27c4b9f137df5414fca4e45896aceccff6b0ed5), [`08b3b59`](https://github.com/mastra-ai/mastra/commit/08b3b590dd960dee6c9a6e39272f8927d803db6e), [`b3c3b18`](https://github.com/mastra-ai/mastra/commit/b3c3b189121489a3a51a8fd8204b569be9a89fe5), [`4084113`](https://github.com/mastra-ai/mastra/commit/408411370fc48a822e8b616b3b63f9409774e0e9), [`70cb714`](https://github.com/mastra-ai/mastra/commit/70cb7149c8f16f478e15b58498254a53181750a4), [`91cf0e0`](https://github.com/mastra-ai/mastra/commit/91cf0e027e511b871481a8576b56b7af83b15afd), [`7f9da22`](https://github.com/mastra-ai/mastra/commit/7f9da22efd5aa595e138a31de55a5f0f2f28b33d)]:
+  - @mastra/core@1.37.0
+
+## 0.2.0-alpha.0
+
+### Minor Changes
+
+- Added @mastra/files-sdk workspace filesystem provider — a unified storage adapter backed by [FilesSDK](https://files-sdk.dev). Supports any FilesSDK adapter (S3, R2, GCS, Azure Blob, Vercel Blob, local filesystem, and more) through a single `FilesSDKFilesystem` class that implements the `WorkspaceFilesystem` interface. ([#17027](https://github.com/mastra-ai/mastra/pull/17027))
+
+  **Usage**
+
+  ```ts
+  import { Files } from 'files-sdk';
+  import { s3 } from 'files-sdk/s3';
+  import { FilesSDKFilesystem } from '@mastra/files-sdk';
+
+  const files = new Files({ adapter: s3({ bucket: 'my-bucket', region: 'us-east-1' }) });
+
+  const filesystem = new FilesSDKFilesystem({ files });
+  ```
+
+  Swap adapters without changing code — just replace `s3()` with `r2()`, `gcs()`, `azure()`, `fs()`, etc.
+
+### Patch Changes
+
+- Updated dependencies [[`c35b962`](https://github.com/mastra-ai/mastra/commit/c35b9625c7e854fcfdeee226a3338a750d0ff211), [`4084113`](https://github.com/mastra-ai/mastra/commit/408411370fc48a822e8b616b3b63f9409774e0e9)]:
+  - @mastra/core@1.37.0-alpha.8

package/LICENSE.md

@@ -0,0 +1,30 @@
+Portions of this software are licensed as follows:
+
+- All content that resides under any directory named "ee/" within this
+  repository, including but not limited to:
+  - `packages/core/src/auth/ee/`
+  - `packages/server/src/server/auth/ee/`
+    is licensed under the license defined in `ee/LICENSE`.
+
+- All third-party components incorporated into the Mastra Software are
+  licensed under the original license provided by the owner of the
+  applicable component.
+
+- Content outside of the above-mentioned directories or restrictions is
+  available under the "Apache License 2.0" as defined below.
+
+# 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,107 @@
+# @mastra/files-sdk
+
+Unified storage filesystem provider for Mastra workspaces, powered by [FilesSDK](https://files-sdk.dev). Works with any FilesSDK adapter — S3, Cloudflare R2, Google Cloud Storage, Azure Blob, Vercel Blob, local filesystem, and more.
+
+## Installation
+
+```bash
+npm install @mastra/files-sdk files-sdk
+```
+
+Then install the FilesSDK adapter for your storage backend:
+
+```bash
+# AWS S3 / R2 / MinIO / DigitalOcean Spaces
+npm install @aws-sdk/client-s3 @aws-sdk/s3-presigned-post @aws-sdk/s3-request-presigner
+
+# Google Cloud Storage
+npm install @google-cloud/storage google-auth-library
+
+# Azure Blob Storage
+npm install @azure/storage-blob @azure/core-auth @azure/identity
+
+# Vercel Blob
+npm install @vercel/blob
+
+# Local filesystem (dev/test)
+# No extra dependencies needed
+```
+
+## Usage
+
+```typescript
+import { Agent } from '@mastra/core/agent';
+import { Workspace } from '@mastra/core/workspace';
+import { FilesSDKFilesystem } from '@mastra/files-sdk';
+import { Files } from 'files-sdk';
+import { s3 } from 'files-sdk/s3';
+
+const files = new Files({
+  adapter: s3({
+    bucket: 'my-bucket',
+    region: 'us-east-1',
+  }),
+});
+
+const workspace = new Workspace({
+  filesystem: new FilesSDKFilesystem({ files }),
+});
+
+const agent = new Agent({
+  name: 'my-agent',
+  model: 'anthropic/claude-opus-4-5',
+  workspace,
+});
+```
+
+### Switching adapters
+
+The power of FilesSDK is that you can swap storage backends by changing only the adapter import:
+
+```typescript
+import { Files } from 'files-sdk';
+import { r2 } from 'files-sdk/r2';
+
+const files = new Files({
+  adapter: r2({
+    accountId: process.env.R2_ACCOUNT_ID!,
+    accessKeyId: process.env.R2_ACCESS_KEY_ID!,
+    secretAccessKey: process.env.R2_SECRET_ACCESS_KEY!,
+    bucket: 'my-bucket',
+  }),
+});
+
+const workspace = new Workspace({
+  filesystem: new FilesSDKFilesystem({ files }),
+});
+```
+
+### Local filesystem for development
+
+```typescript
+import { Files } from 'files-sdk';
+import { fs } from 'files-sdk/fs';
+
+const files = new Files({
+  adapter: fs({ root: './.uploads' }),
+});
+
+const workspace = new Workspace({
+  filesystem: new FilesSDKFilesystem({ files }),
+});
+```
+
+## Options
+
+| Option        | Type      | Required | Description                           |
+| ------------- | --------- | -------- | ------------------------------------- |
+| `files`       | `Files`   | Yes      | Pre-configured FilesSDK instance      |
+| `id`          | `string`  | No       | Unique filesystem ID (auto-generated) |
+| `displayName` | `string`  | No       | Human-friendly name for UI            |
+| `icon`        | `string`  | No       | Icon identifier                       |
+| `description` | `string`  | No       | Description for UI                    |
+| `readOnly`    | `boolean` | No       | Mount as read-only                    |
+
+## License
+
+Apache-2.0

package/dist/filesystem/index.d.ts

@@ -0,0 +1,81 @@
+import type { FileContent, FileStat, FileEntry, ReadOptions, WriteOptions, ListOptions, RemoveOptions, CopyOptions, FilesystemIcon, FilesystemInfo, ProviderStatus, MastraFilesystemOptions } from '@mastra/core/workspace';
+import { MastraFilesystem } from '@mastra/core/workspace';
+import type { Files } from 'files-sdk';
+export interface FilesSDKFilesystemOptions extends MastraFilesystemOptions {
+    /** Pre-configured FilesSDK `Files` instance. */
+    files: Files;
+    /** Unique filesystem ID (auto-generated if not provided). */
+    id?: string;
+    /** Human-friendly display name for UI. */
+    displayName?: string;
+    /** Icon identifier for UI. */
+    icon?: FilesystemIcon;
+    /** Description shown in UI / instructions. */
+    description?: string;
+    /** Mount as read-only — all write operations will throw. */
+    readOnly?: boolean;
+}
+/**
+ * Workspace filesystem adapter backed by [FilesSDK](https://files-sdk.dev).
+ *
+ * Accepts a pre-configured `Files` instance so users choose their own adapter
+ * (S3, R2, GCS, Azure, local fs, etc.) and this class bridges it to the
+ * Mastra `WorkspaceFilesystem` interface.
+ *
+ * Object-storage semantics are bridged to the POSIX-like interface:
+ * - `mkdir` is a no-op (directories don't exist in object storage)
+ * - `readdir` uses `list()` with prefix filtering to synthesize directory entries
+ * - `rmdir` lists all keys under a prefix and batch-deletes them
+ */
+export declare class FilesSDKFilesystem extends MastraFilesystem {
+    readonly id: string;
+    readonly name = "FilesSDKFilesystem";
+    readonly provider = "files-sdk";
+    status: ProviderStatus;
+    readonly readOnly?: boolean;
+    readonly icon?: FilesystemIcon;
+    readonly displayName?: string;
+    readonly description?: string;
+    private readonly _files;
+    constructor(options: FilesSDKFilesystemOptions);
+    /** The underlying FilesSDK instance, for escape-hatch access. */
+    get files(): Files;
+    init(): Promise<void>;
+    getInfo(): FilesystemInfo;
+    getInstructions(): string;
+    readFile(path: string, options?: ReadOptions): Promise<string | Buffer>;
+    writeFile(path: string, content: FileContent, options?: WriteOptions): Promise<void>;
+    /**
+     * Append content to a file.
+     *
+     * **Not atomic.** Object storage has no native append, so this is implemented
+     * as a read-modify-write: the existing object is downloaded, the new content
+     * is concatenated, and the result is uploaded as a new object. Concurrent
+     * appends to the same key may overwrite each other. This limitation is
+     * inherent to object storage, not specific to FilesSDK, and matches the
+     * behavior of the sibling S3, GCS, and Azure workspace providers.
+     */
+    appendFile(path: string, content: FileContent): Promise<void>;
+    deleteFile(path: string, options?: RemoveOptions): Promise<void>;
+    copyFile(src: string, dest: string, options?: CopyOptions): Promise<void>;
+    moveFile(src: string, dest: string, options?: CopyOptions): Promise<void>;
+    mkdir(_path: string, _options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rmdir(path: string, options?: RemoveOptions): Promise<void>;
+    readdir(path: string, options?: ListOptions): Promise<FileEntry[]>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<FileStat>;
+    private assertWritable;
+    /** Check if a key prefix has any children (i.e. acts like a directory). */
+    private isDirectory;
+    /**
+     * Check whether `key` refers to a real stored file (not an empty leftover
+     * directory). Uses prefix listing constrained to the exact key, which only
+     * matches actually-stored objects across all adapters.
+     */
+    private isFile;
+    /** Convert a FilesSDK StoredFile to a Mastra FileStat. */
+    private storedFileToStat;
+}
+//# sourceMappingURL=index.d.ts.map

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

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