@mastra/archil 0.0.0

package/dist/filesystem.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Archil Filesystem Provider
+ *
+ * A filesystem implementation backed by Archil — elastic, serverless
+ * filesystems for AI agents. Uses the `disk` SDK's S3-compatible object
+ * API for fast reads/writes and `exec` for POSIX operations.
+ */
+import type { FileContent, FileStat, FileEntry, ReadOptions, WriteOptions, ListOptions, RemoveOptions, CopyOptions, FilesystemInfo, FilesystemIcon, ProviderStatus, MastraFilesystemOptions } from '@mastra/core/workspace';
+import { MastraFilesystem } from '@mastra/core/workspace';
+import { Archil } from 'disk';
+import type { Disk, CreateDiskRequest, ExecResult, GrepOptions, GrepResult, ListObjectsOptions, ListObjectsResult, ObjectMetadata, ShareUrlOptions, ShareUrlResult } from 'disk';
+export interface ArchilFilesystemOptions extends MastraFilesystemOptions {
+    /** Unique identifier for this filesystem instance */
+    id?: string;
+    /** Human-friendly display name for the UI */
+    displayName?: string;
+    /** Icon identifier for the UI (defaults to 'cloud') */
+    icon?: FilesystemIcon;
+    /** Description shown in tooltips */
+    description?: string;
+    /** Mount as read-only (blocks write operations) */
+    readOnly?: boolean;
+    /**
+     * Existing disk ID to attach to (e.g. "dsk-0123456789abcdef").
+     * Mutually exclusive with `createDiskOptions`.
+     */
+    diskId?: string;
+    /**
+     * Options for creating a new disk on init.
+     * Mutually exclusive with `diskId`.
+     */
+    createDiskOptions?: CreateDiskRequest;
+    /**
+     * Archil API key. Falls back to ARCHIL_API_KEY env var.
+     */
+    apiKey?: string;
+    /**
+     * Archil region (e.g. "aws-us-east-1"). Falls back to ARCHIL_REGION env var.
+     */
+    region?: string;
+    /**
+     * Override the Archil control-plane base URL (for testing/self-hosted).
+     */
+    baseUrl?: string;
+    /**
+     * Override the S3-compatible API base URL.
+     * Falls back to ARCHIL_S3_BASE_URL env var.
+     */
+    s3BaseUrl?: string;
+}
+export declare class ArchilFilesystem extends MastraFilesystem {
+    readonly id: string;
+    readonly name = "ArchilFilesystem";
+    readonly provider = "archil";
+    readonly readOnly?: boolean;
+    readonly displayName?: string;
+    readonly icon: FilesystemIcon;
+    readonly description?: string;
+    status: ProviderStatus;
+    private _disk;
+    private _archil;
+    private readonly _diskId?;
+    private readonly _createDiskOptions?;
+    private readonly _archilOptions;
+    constructor(options: ArchilFilesystemOptions);
+    /** The underlying Archil Disk instance (available after init). */
+    get disk(): Disk;
+    /** The Archil SDK client instance. */
+    get archil(): Archil;
+    init(): Promise<void>;
+    destroy(): Promise<void>;
+    isReady(): boolean;
+    getInfo(): FilesystemInfo<{
+        diskId: string;
+        region: string;
+        diskName: string;
+    }>;
+    getInstructions(): string;
+    /**
+     * Execute a shell command on the disk's filesystem.
+     * The disk is mounted as the working directory.
+     */
+    exec(command: string): Promise<ExecResult>;
+    /**
+     * Parallel grep across files on the disk.
+     */
+    grep(opts: GrepOptions): Promise<GrepResult>;
+    /**
+     * Create a signed, time-limited download URL for a file.
+     */
+    share(key: string, opts?: ShareUrlOptions): Promise<ShareUrlResult>;
+    /**
+     * List objects using the S3-compatible API directly.
+     */
+    listObjects(prefix?: string, opts?: ListObjectsOptions): Promise<ListObjectsResult>;
+    /**
+     * Get object metadata without downloading.
+     */
+    headObject(key: string): Promise<ObjectMetadata | null>;
+    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[]>;
+    private readdirRecursive;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<FileStat>;
+    private assertWritable;
+}
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/filesystem.d.ts.map

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

package/dist/index.cjs

@@ -0,0 +1,491 @@
+'use strict';
+
+var workspace = require('@mastra/core/workspace');
+var disk = require('disk');
+
+// src/filesystem.ts
+var MIME_TYPES = {
+  ".txt": "text/plain",
+  ".md": "text/markdown",
+  ".html": "text/html",
+  ".css": "text/css",
+  ".csv": "text/csv",
+  ".xml": "text/xml",
+  ".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",
+  ".sh": "text/x-shellscript",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".svg": "image/svg+xml",
+  ".webp": "image/webp",
+  ".pdf": "application/pdf",
+  ".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);
+}
+function toKey(path) {
+  return trimSlashes(path) || "";
+}
+function basename(path) {
+  const key = toKey(path);
+  const idx = key.lastIndexOf("/");
+  return idx === -1 ? key : key.slice(idx + 1);
+}
+function dirname(path) {
+  const key = toKey(path);
+  const idx = key.lastIndexOf("/");
+  return idx === -1 ? "" : key.slice(0, idx);
+}
+function shellEscape(s) {
+  return "'" + s.replace(/'/g, "'\\''") + "'";
+}
+var ArchilFilesystem = class extends workspace.MastraFilesystem {
+  id;
+  name = "ArchilFilesystem";
+  provider = "archil";
+  readOnly;
+  displayName;
+  icon;
+  description;
+  status = "pending";
+  _disk = null;
+  _archil = null;
+  _diskId;
+  _createDiskOptions;
+  _archilOptions;
+  constructor(options) {
+    super({ ...options, name: "ArchilFilesystem" });
+    this.id = options.id ?? `archil-fs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+    this.readOnly = options.readOnly;
+    this.displayName = options.displayName ?? "Archil";
+    this.icon = options.icon ?? "cloud";
+    this.description = options.description ?? "Elastic serverless filesystem powered by Archil";
+    this._diskId = options.diskId;
+    this._createDiskOptions = options.createDiskOptions;
+    this._archilOptions = {
+      apiKey: options.apiKey,
+      region: options.region,
+      baseUrl: options.baseUrl,
+      s3BaseUrl: options.s3BaseUrl
+    };
+  }
+  // ---------------------------------------------------------------------------
+  // Public accessors
+  // ---------------------------------------------------------------------------
+  /** The underlying Archil Disk instance (available after init). */
+  get disk() {
+    if (!this._disk) {
+      throw new Error("ArchilFilesystem not initialized \u2014 call init() first");
+    }
+    return this._disk;
+  }
+  /** The Archil SDK client instance. */
+  get archil() {
+    if (!this._archil) {
+      this._archil = new disk.Archil(this._archilOptions);
+    }
+    return this._archil;
+  }
+  // ---------------------------------------------------------------------------
+  // Lifecycle
+  // ---------------------------------------------------------------------------
+  async init() {
+    try {
+      if (this._diskId && this._createDiskOptions) {
+        throw new Error("diskId and createDiskOptions are mutually exclusive");
+      }
+      if (this._diskId) {
+        this._disk = await this.archil.disks.get(this._diskId);
+      } else if (this._createDiskOptions) {
+        const result = await this.archil.disks.create(this._createDiskOptions);
+        this._disk = result.disk;
+      } else {
+        throw new Error("Either diskId or createDiskOptions must be provided");
+      }
+      this.status = "ready";
+    } catch (err) {
+      this.status = "error";
+      this.error = err instanceof Error ? err.message : String(err);
+      throw err;
+    }
+  }
+  async destroy() {
+    this._disk = null;
+    this._archil = null;
+  }
+  isReady() {
+    return this.status === "ready" && this._disk !== null;
+  }
+  getInfo() {
+    return {
+      id: this.id,
+      name: this.name,
+      provider: this.provider,
+      status: this.status,
+      error: this.error,
+      readOnly: this.readOnly,
+      icon: this.icon,
+      metadata: {
+        diskId: this._disk?.id ?? "",
+        region: this._disk?.region ?? "",
+        diskName: this._disk?.name ?? ""
+      }
+    };
+  }
+  getInstructions() {
+    const access = this.readOnly ? "Read-only" : "Persistent";
+    const diskName = this._disk?.name ?? "Archil disk";
+    return `Archil elastic filesystem "${diskName}". ${access} storage \u2014 files persist across sessions. Supports serverless execution via exec().`;
+  }
+  // ---------------------------------------------------------------------------
+  // Archil-specific operations
+  // ---------------------------------------------------------------------------
+  /**
+   * Execute a shell command on the disk's filesystem.
+   * The disk is mounted as the working directory.
+   */
+  async exec(command) {
+    await this.ensureReady();
+    this.assertWritable();
+    return this.disk.exec(command);
+  }
+  /**
+   * Parallel grep across files on the disk.
+   */
+  async grep(opts) {
+    await this.ensureReady();
+    return this.disk.grep(opts);
+  }
+  /**
+   * Create a signed, time-limited download URL for a file.
+   */
+  async share(key, opts) {
+    await this.ensureReady();
+    return this.disk.share(key, opts);
+  }
+  /**
+   * List objects using the S3-compatible API directly.
+   */
+  async listObjects(prefix, opts) {
+    await this.ensureReady();
+    return this.disk.listObjects(prefix, opts);
+  }
+  /**
+   * Get object metadata without downloading.
+   */
+  async headObject(key) {
+    await this.ensureReady();
+    return this.disk.headObject(key);
+  }
+  // ---------------------------------------------------------------------------
+  // File Operations (WorkspaceFilesystem interface)
+  // ---------------------------------------------------------------------------
+  async readFile(path, options) {
+    await this.ensureReady();
+    const key = toKey(path);
+    if (!key) {
+      throw new Error("Cannot read file at root path");
+    }
+    try {
+      const data = await this.disk.getObject(key);
+      if (options?.encoding) {
+        return Buffer.from(data).toString(options.encoding);
+      }
+      return Buffer.from(data);
+    } catch (err) {
+      if (isNotFound(err)) {
+        throw new workspace.FileNotFoundError(path);
+      }
+      throw err;
+    }
+  }
+  async writeFile(path, content, options) {
+    await this.ensureReady();
+    this.assertWritable();
+    const key = toKey(path);
+    if (!key) {
+      throw new Error("Cannot write file at root path");
+    }
+    if (options?.overwrite === false) {
+      const exists = await this.disk.objectExists(key);
+      if (exists) {
+        throw new workspace.FileExistsError(path);
+      }
+    }
+    if (options?.recursive) {
+      const dir = dirname(path);
+      if (dir) {
+        await this.disk.exec(`mkdir -p ${shellEscape(dir)}`);
+      }
+    }
+    const body = typeof content === "string" ? content : content instanceof Uint8Array ? content : new Uint8Array(content);
+    const mimeType = options?.mimeType ?? getMimeType(path);
+    await this.disk.putObject(key, body, mimeType);
+  }
+  async appendFile(path, content) {
+    await this.ensureReady();
+    this.assertWritable();
+    const key = toKey(path);
+    if (!key) {
+      throw new Error("Cannot append to root path");
+    }
+    const data = typeof content === "string" ? content : Buffer.from(content).toString("base64");
+    if (typeof content === "string") {
+      await this.disk.exec(`printf '%s' ${shellEscape(data)} >> ${shellEscape(key)}`);
+    } else {
+      await this.disk.exec(`printf '%s' ${shellEscape(data)} | base64 -d >> ${shellEscape(key)}`);
+    }
+  }
+  async deleteFile(path, options) {
+    await this.ensureReady();
+    this.assertWritable();
+    const key = toKey(path);
+    if (!key) {
+      throw new Error("Cannot delete root path");
+    }
+    if (!options?.force) {
+      const exists = await this.disk.objectExists(key);
+      if (!exists) {
+        throw new workspace.FileNotFoundError(path);
+      }
+    }
+    await this.disk.deleteObject(key);
+  }
+  async copyFile(src, dest, options) {
+    await this.ensureReady();
+    this.assertWritable();
+    const srcKey = toKey(src);
+    const destKey = toKey(dest);
+    if (!options?.overwrite) {
+      const exists = await this.disk.objectExists(destKey);
+      if (exists) {
+        throw new workspace.FileExistsError(dest);
+      }
+    }
+    const flags = options?.recursive ? "-r" : "";
+    const result = await this.disk.exec(`cp ${flags} ${shellEscape(srcKey)} ${shellEscape(destKey)}`);
+    if (result.exitCode !== 0) {
+      if (result.stderr.includes("No such file")) {
+        throw new workspace.FileNotFoundError(src);
+      }
+      throw new Error(`cp failed: ${result.stderr}`);
+    }
+  }
+  async moveFile(src, dest, options) {
+    await this.ensureReady();
+    this.assertWritable();
+    const srcKey = toKey(src);
+    const destKey = toKey(dest);
+    if (!options?.overwrite) {
+      const exists = await this.disk.objectExists(destKey);
+      if (exists) {
+        throw new workspace.FileExistsError(dest);
+      }
+    }
+    const result = await this.disk.exec(`mv ${shellEscape(srcKey)} ${shellEscape(destKey)}`);
+    if (result.exitCode !== 0) {
+      if (result.stderr.includes("No such file")) {
+        throw new workspace.FileNotFoundError(src);
+      }
+      throw new Error(`mv failed: ${result.stderr}`);
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // Directory Operations
+  // ---------------------------------------------------------------------------
+  async mkdir(path, options) {
+    await this.ensureReady();
+    this.assertWritable();
+    const key = toKey(path);
+    if (!key) return;
+    const flag = options?.recursive ? "-p" : "";
+    const result = await this.disk.exec(`mkdir ${flag} ${shellEscape(key)}`);
+    if (result.exitCode !== 0) {
+      if (result.stderr.includes("File exists")) {
+        throw new workspace.FileExistsError(path);
+      }
+      throw new Error(`mkdir failed: ${result.stderr}`);
+    }
+  }
+  async rmdir(path, options) {
+    await this.ensureReady();
+    this.assertWritable();
+    const key = toKey(path);
+    if (!key) {
+      throw new Error("Cannot remove root directory");
+    }
+    const cmd = options?.recursive ? `rm -r${options?.force ? "f" : ""} ${shellEscape(key)}` : `rmdir ${shellEscape(key)}`;
+    const result = await this.disk.exec(options?.force ? `${cmd} 2>/dev/null; true` : cmd);
+    if (result.exitCode !== 0 && !options?.force) {
+      if (result.stderr.includes("No such file") || result.stderr.includes("not found")) {
+        throw new workspace.FileNotFoundError(path);
+      }
+      throw new Error(`rmdir failed: ${result.stderr}`);
+    }
+  }
+  async readdir(path, options) {
+    await this.ensureReady();
+    const key = toKey(path);
+    const prefix = key ? key + "/" : "";
+    if (options?.recursive) {
+      return this.readdirRecursive(prefix, options);
+    }
+    const result = await this.disk.listObjects(prefix, { recursive: false });
+    const entries = [];
+    for (const obj of result.objects) {
+      const name = obj.key.slice(prefix.length);
+      if (!name || name.includes("/")) continue;
+      if (options?.extension) {
+        const extensions = Array.isArray(options.extension) ? options.extension : [options.extension];
+        const ext = name.match(/\.[^.]+$/)?.[0] ?? "";
+        if (!extensions.includes(ext)) continue;
+      }
+      entries.push({
+        name,
+        type: "file",
+        size: obj.size
+      });
+    }
+    for (const cp of result.commonPrefixes) {
+      const name = trimSlashes(cp.slice(prefix.length));
+      if (!name) continue;
+      entries.push({
+        name,
+        type: "directory"
+      });
+    }
+    return entries;
+  }
+  async readdirRecursive(prefix, options) {
+    const result = await this.disk.listObjects(prefix, { recursive: true });
+    const entries = [];
+    for (const obj of result.objects) {
+      const relativePath = obj.key.slice(prefix.length);
+      if (!relativePath) continue;
+      if (options?.maxDepth !== void 0) {
+        const depth = relativePath.split("/").length - 1;
+        if (depth > options.maxDepth) continue;
+      }
+      if (options?.extension) {
+        const extensions = Array.isArray(options.extension) ? options.extension : [options.extension];
+        const ext = relativePath.match(/\.[^.]+$/)?.[0] ?? "";
+        if (!extensions.includes(ext)) continue;
+      }
+      entries.push({
+        name: relativePath,
+        type: "file",
+        size: obj.size
+      });
+    }
+    return entries;
+  }
+  // ---------------------------------------------------------------------------
+  // Path Operations
+  // ---------------------------------------------------------------------------
+  async exists(path) {
+    await this.ensureReady();
+    const key = toKey(path);
+    if (!key) return true;
+    const fileExists = await this.disk.objectExists(key);
+    if (fileExists) return true;
+    const result = await this.disk.listObjects(key + "/", { singlePage: true, limit: 1 });
+    return result.objects.length > 0 || result.commonPrefixes.length > 0;
+  }
+  async stat(path) {
+    await this.ensureReady();
+    const key = toKey(path);
+    if (!key) {
+      return {
+        name: "",
+        path: "/",
+        type: "directory",
+        size: 0,
+        createdAt: /* @__PURE__ */ new Date(0),
+        modifiedAt: /* @__PURE__ */ new Date(0)
+      };
+    }
+    const meta = await this.disk.headObject(key);
+    if (meta) {
+      return {
+        name: basename(path),
+        path: "/" + key,
+        type: "file",
+        size: meta.size,
+        createdAt: meta.lastModified ?? /* @__PURE__ */ new Date(0),
+        modifiedAt: meta.lastModified ?? /* @__PURE__ */ new Date(0),
+        mimeType: meta.contentType
+      };
+    }
+    const result = await this.disk.listObjects(key + "/", { singlePage: true, limit: 1 });
+    if (result.objects.length > 0 || result.commonPrefixes.length > 0) {
+      return {
+        name: basename(path),
+        path: "/" + key,
+        type: "directory",
+        size: 0,
+        createdAt: /* @__PURE__ */ new Date(0),
+        modifiedAt: /* @__PURE__ */ new Date(0)
+      };
+    }
+    throw new workspace.FileNotFoundError(path);
+  }
+  // ---------------------------------------------------------------------------
+  // Helpers
+  // ---------------------------------------------------------------------------
+  assertWritable() {
+    if (this.readOnly) {
+      throw new Error("Filesystem is read-only");
+    }
+  }
+};
+function isNotFound(err) {
+  if (!err || typeof err !== "object") return false;
+  const e = err;
+  return e.status === 404 || e.code === "NoSuchKey";
+}
+
+// src/provider.ts
+var archilFilesystemProvider = {
+  id: "archil",
+  name: "Archil",
+  description: "Elastic, serverless filesystem for AI agents (Archil)",
+  configSchema: {
+    type: "object",
+    oneOf: [{ required: ["diskId"] }, { required: ["createDiskOptions"] }],
+    properties: {
+      diskId: { type: "string", description: 'Existing Archil disk ID (e.g. "dsk-0123456789abcdef")' },
+      createDiskOptions: { type: "object", description: "Options used to create a new Archil disk on init" },
+      apiKey: { type: "string", description: "Archil API key (falls back to ARCHIL_API_KEY env var)" },
+      region: { type: "string", description: 'Archil region (e.g. "aws-us-east-1")' },
+      readOnly: { type: "boolean", description: "Mount as read-only", default: false },
+      baseUrl: { type: "string", description: "Custom control-plane URL (for testing)" },
+      s3BaseUrl: { type: "string", description: "Custom S3 API URL" }
+    }
+  },
+  createFilesystem: (config) => new ArchilFilesystem(config)
+};
+
+exports.ArchilFilesystem = ArchilFilesystem;
+exports.archilFilesystemProvider = archilFilesystemProvider;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map