@mastra/mcp-docs-server 1.2.0 → 1.2.1-alpha.1

package/.docs/reference/workspace/archil-filesystem.md

@@ -0,0 +1,203 @@
+# ArchilFilesystem
+
+Stores files on [Archil](https://docs.archil.com) elastic, serverless disks. Combines an S3-compatible object API for fast reads/writes with `exec()` for POSIX shell operations and `grep()` for parallel server-side search.
+
+> **Info:** For interface details, see [WorkspaceFilesystem Interface](https://mastra.ai/reference/workspace/filesystem).
+
+## Installation
+
+**npm**:
+
+```bash
+npm install @mastra/archil
+```
+
+**pnpm**:
+
+```bash
+pnpm add @mastra/archil
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/archil
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/archil
+```
+
+## Usage
+
+Add an `ArchilFilesystem` to a workspace and assign it to an agent:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { Workspace } from '@mastra/core/workspace'
+import { ArchilFilesystem } from '@mastra/archil'
+
+const workspace = new Workspace({
+  filesystem: new ArchilFilesystem({
+    diskId: 'dsk-0123456789abcdef',
+    apiKey: process.env.ARCHIL_API_KEY,
+    region: 'aws-us-east-1',
+  }),
+})
+
+const agent = new Agent({
+  name: 'file-agent',
+  model: 'anthropic/claude-opus-4-7',
+  workspace,
+})
+```
+
+### Creating a new disk on init
+
+If you don't have an existing disk, provide `createDiskOptions` to create one automatically:
+
+```typescript
+import { ArchilFilesystem } from '@mastra/archil'
+
+const filesystem = new ArchilFilesystem({
+  apiKey: process.env.ARCHIL_API_KEY,
+  region: 'aws-us-east-1',
+  createDiskOptions: {
+    name: 'my-agent-workspace',
+  },
+})
+
+await filesystem.init()
+// filesystem.diskId now contains the newly created disk ID
+```
+
+### Environment variable fallbacks
+
+When `apiKey` and `region` are omitted, the provider reads from environment variables:
+
+- `ARCHIL_API_KEY` - API key
+- `ARCHIL_REGION` - Region (e.g. `aws-us-east-1`)
+- `ARCHIL_S3_BASE_URL` - Custom S3 endpoint (optional)
+
+```typescript
+import { ArchilFilesystem } from '@mastra/archil'
+
+// Uses ARCHIL_API_KEY and ARCHIL_REGION from environment
+const filesystem = new ArchilFilesystem({
+  diskId: 'dsk-0123456789abcdef',
+})
+```
+
+## Constructor parameters
+
+**diskId** (`string`): Existing Archil disk ID (e.g. "dsk-0123456789abcdef"). Mutually exclusive with \`createDiskOptions\`.
+
+**createDiskOptions** (`CreateDiskRequest`): Options for creating a new disk on init. Mutually exclusive with \`diskId\`.
+
+**apiKey** (`string`): Archil API key. Falls back to \`ARCHIL\_API\_KEY\` environment variable.
+
+**region** (`string`): Archil region (e.g. "aws-us-east-1"). Falls back to \`ARCHIL\_REGION\` environment variable.
+
+**baseUrl** (`string`): Custom Archil control-plane URL (for testing or self-hosted deployments).
+
+**s3BaseUrl** (`string`): Custom S3-compatible API URL. Falls back to \`ARCHIL\_S3\_BASE\_URL\` environment variable.
+
+**id** (`string`): Unique identifier for this filesystem instance. (Default: `Auto-generated`)
+
+**displayName** (`string`): Human-friendly display name for the UI.
+
+**icon** (`FilesystemIcon`): Icon identifier for the UI.
+
+**description** (`string`): Short description of this filesystem for the UI.
+
+**readOnly** (`boolean`): When true, all write operations are blocked. (Default: `false`)
+
+## Properties
+
+**id** (`string`): Filesystem instance identifier.
+
+**name** (`string`): Provider name ('ArchilFilesystem').
+
+**provider** (`string`): Provider identifier ('archil').
+
+**diskId** (`string | undefined`): The Archil disk ID (available after init).
+
+**readOnly** (`boolean | undefined`): Whether the filesystem is in read-only mode.
+
+## Methods
+
+ArchilFilesystem implements the [WorkspaceFilesystem interface](https://mastra.ai/reference/workspace/filesystem), providing all standard filesystem methods:
+
+- `readFile(path, options?)` - Read file contents
+- `writeFile(path, content, options?)` - Write content to a file
+- `appendFile(path, content)` - Append content to a file
+- `deleteFile(path, options?)` - Delete a file
+- `copyFile(src, dest, options?)` - Copy a file
+- `moveFile(src, dest, options?)` - Move or rename a file
+- `mkdir(path, options?)` - Create a directory
+- `rmdir(path, options?)` - Remove a directory
+- `readdir(path, options?)` - List directory contents
+- `exists(path)` - Check if a path exists
+- `stat(path)` - Get file or directory metadata
+
+### `init()`
+
+Initialize the filesystem. Connects to the existing disk or creates a new one.
+
+```typescript
+await filesystem.init()
+```
+
+### `getInfo()`
+
+Returns metadata about this filesystem instance.
+
+```typescript
+const info = filesystem.getInfo()
+// { id: '...', name: 'ArchilFilesystem', provider: 'archil', status: 'ready' }
+```
+
+### Archil-specific methods
+
+#### `exec(command)`
+
+Run a shell command on the disk. Returns exit code, stdout, and stderr.
+
+```typescript
+const result = await filesystem.exec('ls -la /data')
+// { exitCode: 0, stdout: '...', stderr: '' }
+```
+
+#### `grep(options)`
+
+Run a parallel server-side search across files on the disk.
+
+```typescript
+const results = await filesystem.grep({
+  directory: '/logs',
+  pattern: 'ERROR',
+  recursive: true,
+  glob: '*.log',
+})
+// { matches: [...], stoppedReason: null }
+```
+
+#### `share(path, options?)`
+
+Generate a signed URL for sharing a file.
+
+```typescript
+const { url } = await filesystem.share('/reports/output.pdf', {
+  expiresIn: 3600,
+})
+```
+
+## Related
+
+- [WorkspaceFilesystem interface](https://mastra.ai/reference/workspace/filesystem)
+- [S3Filesystem reference](https://mastra.ai/reference/workspace/s3-filesystem)
+- [GCSFilesystem reference](https://mastra.ai/reference/workspace/gcs-filesystem)
+- [AzureBlobFilesystem reference](https://mastra.ai/reference/workspace/azure-blob-filesystem)
+- [Archil documentation](https://docs.archil.com)

package/.docs/reference/workspace/gcs-filesystem.md

@@ -189,6 +189,7 @@ See [E2BSandbox reference](https://mastra.ai/reference/workspace/e2b-sandbox) fo
 ## Related
 
 - [WorkspaceFilesystem interface](https://mastra.ai/reference/workspace/filesystem)
+- [ArchilFilesystem reference](https://mastra.ai/reference/workspace/archil-filesystem)
 - [S3Filesystem reference](https://mastra.ai/reference/workspace/s3-filesystem)
 - [AzureBlobFilesystem reference](https://mastra.ai/reference/workspace/azure-blob-filesystem)
 - [E2BSandbox reference](https://mastra.ai/reference/workspace/e2b-sandbox)

package/.docs/reference/workspace/s3-filesystem.md

@@ -266,6 +266,7 @@ See [E2BSandbox reference](https://mastra.ai/reference/workspace/e2b-sandbox) fo
 ## Related
 
 - [WorkspaceFilesystem interface](https://mastra.ai/reference/workspace/filesystem)
+- [ArchilFilesystem reference](https://mastra.ai/reference/workspace/archil-filesystem)
 - [GCSFilesystem reference](https://mastra.ai/reference/workspace/gcs-filesystem)
 - [AzureBlobFilesystem reference](https://mastra.ai/reference/workspace/azure-blob-filesystem)
 - [E2BSandbox reference](https://mastra.ai/reference/workspace/e2b-sandbox)

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @mastra/mcp-docs-server
 
+## 1.2.1-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [[`7794d71`](https://github.com/mastra-ai/mastra/commit/7794d71872c68733a30e028dfb7b1705daf6c5d2)]:
+  - @mastra/core@1.46.0-alpha.1
+
+## 1.2.1-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`5bd72d2`](https://github.com/mastra-ai/mastra/commit/5bd72d255f45b5ea8ab342643bd463814a980a24), [`1cc9ee1`](https://github.com/mastra-ai/mastra/commit/1cc9ee1ba51db53020a735626d33017a60b4b5b3), [`417baae`](https://github.com/mastra-ai/mastra/commit/417baae40b995db5819c845036947f0c27dc1c00), [`74955f9`](https://github.com/mastra-ai/mastra/commit/74955f9120cde8b1d8ce4399232b4033236be858), [`30ebaf0`](https://github.com/mastra-ai/mastra/commit/30ebaf07bed5f4d30f2f257836c15d1bf7e40aae), [`5704634`](https://github.com/mastra-ai/mastra/commit/5704634b22133167dea337a942a34f57aaa3fa14), [`417baae`](https://github.com/mastra-ai/mastra/commit/417baae40b995db5819c845036947f0c27dc1c00), [`74955f9`](https://github.com/mastra-ai/mastra/commit/74955f9120cde8b1d8ce4399232b4033236be858), [`74955f9`](https://github.com/mastra-ai/mastra/commit/74955f9120cde8b1d8ce4399232b4033236be858), [`c0eda2b`](https://github.com/mastra-ai/mastra/commit/c0eda2bcd91a228427314b12c91d8b147f3a739f), [`c0eda2b`](https://github.com/mastra-ai/mastra/commit/c0eda2bcd91a228427314b12c91d8b147f3a739f), [`b13925b`](https://github.com/mastra-ai/mastra/commit/b13925bfa91aa8700f56fa54a9ce707ee7e4ba62), [`bf94ec6`](https://github.com/mastra-ai/mastra/commit/bf94ec68192d9f16e46ef7e5ac36370aeeddf35d), [`a29f371`](https://github.com/mastra-ai/mastra/commit/a29f371aef629ac8562661524a497127e93b5131), [`74955f9`](https://github.com/mastra-ai/mastra/commit/74955f9120cde8b1d8ce4399232b4033236be858), [`073f910`](https://github.com/mastra-ai/mastra/commit/073f910481e7d94b95ba3830f96531774ae95d33), [`ebbe1d3`](https://github.com/mastra-ai/mastra/commit/ebbe1d31a965a3adb0e728758f326b8122b4b55f), [`1f97ce5`](https://github.com/mastra-ai/mastra/commit/1f97ce5695463bebb4eaacf501da6fb403e20885), [`74955f9`](https://github.com/mastra-ai/mastra/commit/74955f9120cde8b1d8ce4399232b4033236be858), [`64f58c0`](https://github.com/mastra-ai/mastra/commit/64f58c04e78b40137497d47f781e897e416f22a5), [`74955f9`](https://github.com/mastra-ai/mastra/commit/74955f9120cde8b1d8ce4399232b4033236be858), [`ebbe1d3`](https://github.com/mastra-ai/mastra/commit/ebbe1d31a965a3adb0e728758f326b8122b4b55f), [`417baae`](https://github.com/mastra-ai/mastra/commit/417baae40b995db5819c845036947f0c27dc1c00), [`b89fbd1`](https://github.com/mastra-ai/mastra/commit/b89fbd15bfdceeee469651c81133f70cc22a6fb9), [`8e25a78`](https://github.com/mastra-ai/mastra/commit/8e25a78e0597575f0b0729bae8c5e190c84869b5), [`417baae`](https://github.com/mastra-ai/mastra/commit/417baae40b995db5819c845036947f0c27dc1c00), [`a5b22d3`](https://github.com/mastra-ai/mastra/commit/a5b22d314d62a68d801886a8d3d0eb6c089473db), [`417baae`](https://github.com/mastra-ai/mastra/commit/417baae40b995db5819c845036947f0c27dc1c00), [`74955f9`](https://github.com/mastra-ai/mastra/commit/74955f9120cde8b1d8ce4399232b4033236be858), [`74955f9`](https://github.com/mastra-ai/mastra/commit/74955f9120cde8b1d8ce4399232b4033236be858)]:
+  - @mastra/core@1.46.0-alpha.0
+  - @mastra/mcp@1.12.0-alpha.0
+
 ## 1.2.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.2.0",
+  "version": "1.2.1-alpha.1",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -28,8 +28,8 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.4.3",
-    "@mastra/mcp": "^1.11.0",
-    "@mastra/core": "1.45.0"
+    "@mastra/core": "1.46.0-alpha.1",
+    "@mastra/mcp": "^1.12.0-alpha.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
@@ -45,9 +45,9 @@
     "tsx": "^4.22.4",
     "typescript": "^6.0.3",
     "vitest": "4.1.8",
-    "@mastra/core": "1.45.0",
     "@internal/types-builder": "0.0.82",
-    "@internal/lint": "0.0.107"
+    "@internal/lint": "0.0.107",
+    "@mastra/core": "1.46.0-alpha.1"
   },
   "homepage": "https://mastra.ai",
   "repository": {