@mastra/mesa 0.3.0 → 0.3.1

package/dist/filesystem/index.d.ts

@@ -0,0 +1,101 @@
+import type { CopyOptions, FileContent, FileEntry, FilesystemInfo, FileStat, ListOptions, MastraFilesystemOptions, ProviderStatus, ReadOptions, RemoveOptions, WriteOptions } from '@mastra/core/workspace';
+import { MastraFilesystem } from '@mastra/core/workspace';
+import { Mesa } from '@mesadev/sdk';
+import type { Author, Bash, FsMountRuntimeOptions, Layout, MesaBashOptions, MesaFileSystem, MesaOptions, TelemetryConfig } from '@mesadev/sdk';
+export interface MesaFilesystemOptions extends MastraFilesystemOptions {
+    /** Mesa private key. Falls back to MESA_PRIVATE_KEY when omitted. */
+    privateKey?: string;
+    /** Commit authors attributed to writes made through this filesystem. */
+    authors: readonly [Author, ...Author[]];
+    /** Mesa mount layout mapping absolute paths to repos, built with `repo()`. */
+    layout: Layout;
+    /** Mount every layout repo read-only and block writes through the Mastra filesystem interface. */
+    readOnly?: boolean;
+    /** Mesa filesystem cache configuration. */
+    cache?: FsMountRuntimeOptions['cache'];
+    /** Mesa mount token lifetime in seconds. */
+    ttl?: number;
+    /** Mesa filesystem telemetry configuration. */
+    telemetry?: TelemetryConfig;
+    /** Custom fetch implementation for Mesa API calls. */
+    fetch?: MesaOptions['fetch'];
+    /** User agent for Mesa API calls. */
+    userAgent?: string;
+}
+/**
+ * Workspace filesystem adapter backed by Mesa.
+ *
+ * This provider runs in the Mastra process and implements the workspace file
+ * API against Mesa repos. It does not mount Mesa into a sandbox.
+ */
+export declare class MesaFilesystem extends MastraFilesystem {
+    readonly id: string;
+    readonly name = "MesaFilesystem";
+    readonly provider = "mesa";
+    readonly readOnly?: boolean;
+    readonly icon = "mesa";
+    readonly displayName = "Mesa";
+    readonly description = "Versioned Mesa filesystem for workspace files";
+    status: ProviderStatus;
+    private readonly _privateKey?;
+    private readonly _authors;
+    private readonly _layout;
+    private readonly _cache?;
+    private readonly _ttl?;
+    private readonly _telemetry?;
+    private readonly _fetch?;
+    private readonly _userAgent?;
+    private _mesa?;
+    private _filesystem?;
+    constructor(options: MesaFilesystemOptions);
+    /**
+     * The active Mesa client, available after initialization when this instance
+     * created the client itself.
+     */
+    get client(): Mesa | undefined;
+    /**
+     * The active Mesa filesystem. Accessing this before initialization throws.
+     */
+    get filesystem(): MesaFileSystem;
+    init(): Promise<void>;
+    getInfo(): FilesystemInfo<{
+        paths: string[];
+        mode: 'mounted' | 'client';
+    }>;
+    getInstructions(): string;
+    readFile(inputPath: string, options?: ReadOptions): Promise<string | Buffer>;
+    writeFile(inputPath: string, content: FileContent, options?: WriteOptions): Promise<void>;
+    appendFile(inputPath: string, content: FileContent): Promise<void>;
+    deleteFile(inputPath: string, options?: RemoveOptions): Promise<void>;
+    copyFile(src: string, dest: string, options?: CopyOptions): Promise<void>;
+    moveFile(src: string, dest: string, options?: CopyOptions): Promise<void>;
+    mkdir(inputPath: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rmdir(inputPath: string, options?: RemoveOptions): Promise<void>;
+    readdir(inputPath: string, options?: ListOptions): Promise<FileEntry[]>;
+    exists(inputPath: string): Promise<boolean>;
+    stat(inputPath: string): Promise<FileStat>;
+    realpath(inputPath: string): Promise<string>;
+    /**
+     * Create a Mesa-backed Bash runtime for this filesystem.
+     */
+    bash(options?: MesaBashOptions): Promise<Bash>;
+    /**
+     * Mesa change management operations for the mounted filesystem.
+     */
+    get change(): MesaFileSystem['change'];
+    /**
+     * Mesa bookmark management operations for the mounted filesystem.
+     */
+    get bookmark(): MesaFileSystem['bookmark'];
+    private assertWritable;
+    private assertExpectedMtime;
+    private ensureParentDirectory;
+    private assertParentDirectoryExists;
+    private readDirectory;
+    private safeStat;
+    private toFileEntry;
+    private toFileStat;
+}
+//# 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.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @mastra/mesa - Mesa Filesystem Provider
+ *
+ * A filesystem implementation backed by Mesa repos.
+ */
+export { MesaFilesystem, type MesaFilesystemOptions } from './filesystem/index.js';
+export { mesaFilesystemProvider } from './provider.js';
+export { repo, type Author, type Layout } from '@mesadev/sdk';
+//# 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,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Mesa filesystem provider descriptor for MastraEditor.
+ */
+import type { FilesystemProvider } from '@mastra/core/editor';
+import type { MesaFilesystemOptions } from './filesystem/index.js';
+export declare const mesaFilesystemProvider: FilesystemProvider<MesaFilesystemOptions>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1D,eAAO,MAAM,sBAAsB,EAAE,kBAAkB,CAAC,qBAAqB,CA+C5E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mesa",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Mesa filesystem provider for Mastra workspaces",
   "type": "module",
   "main": "dist/index.js",
@@ -28,10 +28,10 @@
     "tsdown": "0.22.9",
     "typescript": "^7.0.2",
     "vitest": "4.1.11",
-    "@internal/lint": "0.0.141",
-    "@internal/workspace-test-utils": "0.0.85",
-    "@internal/types-builder": "0.0.116",
-    "@mastra/core": "1.75.0"
+    "@internal/lint": "0.0.142",
+    "@internal/workspace-test-utils": "0.0.86",
+    "@internal/types-builder": "0.0.117",
+    "@mastra/core": "1.76.0"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.4.0-0 <2.0.0-0"