@mastra/core 1.4.0 → 1.5.0-alpha.1

package/dist/workspace/filesystem/composite-filesystem.d.ts

@@ -19,35 +19,58 @@
  * ```
  */
 import type { ProviderStatus } from '../lifecycle.js';
-import type { WorkspaceFilesystem, FileContent, FileEntry, FileStat, ReadOptions, WriteOptions, ListOptions, CopyOptions, RemoveOptions } from './filesystem.js';
+import type { WorkspaceFilesystem, FileContent, FileEntry, FileStat, FilesystemInfo, ReadOptions, WriteOptions, ListOptions, CopyOptions, RemoveOptions } from './filesystem.js';
 /**
  * Configuration for CompositeFilesystem.
  */
-export interface CompositeFilesystemConfig {
+export interface CompositeFilesystemConfig<TMounts extends Record<string, WorkspaceFilesystem> = Record<string, WorkspaceFilesystem>> {
     /** Map of mount paths to filesystem instances */
-    mounts: Record<string, WorkspaceFilesystem>;
+    mounts: TMounts;
 }
 /**
  * CompositeFilesystem implementation.
  *
  * Routes file operations to the appropriate underlying filesystem based on path.
  * Supports cross-mount operations (copy/move between different filesystems).
+ *
+ * The generic parameter preserves the concrete types of mounted filesystems,
+ * enabling typed access via `mounts.get()`.
+ *
+ * @example
+ * ```typescript
+ * const cfs = new CompositeFilesystem({
+ *   mounts: {
+ *     '/local': new LocalFilesystem({ basePath: './data' }),
+ *     '/s3': new S3Filesystem({ bucket: 'my-bucket' }),
+ *   },
+ * });
+ *
+ * cfs.mounts.get('/local') // LocalFilesystem
+ * cfs.mounts.get('/s3')    // S3Filesystem
+ * ```
  */
-export declare class CompositeFilesystem implements WorkspaceFilesystem {
+export declare class CompositeFilesystem<TMounts extends Record<string, WorkspaceFilesystem> = Record<string, WorkspaceFilesystem>> implements WorkspaceFilesystem {
     readonly id: string;
     readonly name = "CompositeFilesystem";
     readonly provider = "composite";
+    readonly readOnly?: boolean;
     status: ProviderStatus;
     private readonly _mounts;
-    constructor(config: CompositeFilesystemConfig);
+    constructor(config: CompositeFilesystemConfig<TMounts>);
     /**
      * Get all mount paths.
      */
     get mountPaths(): string[];
     /**
      * Get the mounts map.
+     * Returns a typed map where `get()` preserves the concrete filesystem type per mount path.
      */
-    get mounts(): ReadonlyMap<string, WorkspaceFilesystem>;
+    get mounts(): ReadonlyMountMap<TMounts>;
+    /**
+     * Get status and metadata for this composite filesystem.
+     * Includes info from each mounted filesystem in `metadata.mounts`.
+     */
+    getInfo(): Promise<FilesystemInfo>;
     /**
      * Get the underlying filesystem for a given path.
      * Returns undefined if the path doesn't resolve to any mount.
@@ -90,4 +113,50 @@ export declare class CompositeFilesystem implements WorkspaceFilesystem {
      */
     getInstructions(): string;
 }
+/**
+ * Distributive mapped type that produces a union of correlated `[key, value]` tuples.
+ *
+ * For `{ '/local': LocalFilesystem, '/s3': S3Filesystem }` this yields:
+ * `['/local', LocalFilesystem] | ['/s3', S3Filesystem]`
+ *
+ * This enables discriminated-union narrowing when iterating entries without destructuring:
+ * ```typescript
+ * for (const entry of mounts.entries()) {
+ *   if (entry[0] === '/local') {
+ *     entry[1] // LocalFilesystem
+ *   }
+ * }
+ * ```
+ */
+export type MountMapEntry<TMounts extends Record<string, WorkspaceFilesystem>> = {
+    [K in string & keyof TMounts]: [K, TMounts[K]];
+}[string & keyof TMounts];
+/**
+ * A read-only view of mounted filesystems with typed per-key access.
+ *
+ * Unlike `ReadonlyMap<string, WorkspaceFilesystem>`, this preserves the
+ * concrete filesystem type for each mount path via an overloaded `get()`.
+ *
+ * Iteration methods return correlated `[key, value]` tuples ({@link MountMapEntry})
+ * so that checking `entry[0]` narrows `entry[1]` to the concrete filesystem type.
+ *
+ * @example
+ * ```typescript
+ * const mounts = cfs.mounts;
+ * mounts.get('/local') // LocalFilesystem
+ * mounts.get('/s3')    // S3Filesystem
+ * ```
+ */
+export interface ReadonlyMountMap<TMounts extends Record<string, WorkspaceFilesystem>> {
+    /** Get a mounted filesystem by path. Returns the concrete type for known mount paths. */
+    get<K extends string & keyof TMounts>(key: K): TMounts[K];
+    get(key: string): WorkspaceFilesystem | undefined;
+    has(key: string): boolean;
+    readonly size: number;
+    keys(): IterableIterator<string & keyof TMounts>;
+    values(): IterableIterator<TMounts[keyof TMounts & string]>;
+    entries(): IterableIterator<MountMapEntry<TMounts>>;
+    forEach(callbackfn: (value: TMounts[keyof TMounts & string], key: string & keyof TMounts, map: ReadonlyMountMap<TMounts>) => void): void;
+    [Symbol.iterator](): IterableIterator<MountMapEntry<TMounts>>;
+}
 //# sourceMappingURL=composite-filesystem.d.ts.map

package/dist/workspace/filesystem/composite-filesystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composite-filesystem.d.ts","sourceRoot":"","sources":["../../../src/workspace/filesystem/composite-filesystem.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"composite-filesystem.d.ts","sourceRoot":"","sources":["../../../src/workspace/filesystem/composite-filesystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,SAAS,EACT,QAAQ,EACR,cAAc,EACd,WAAW,EACX,YAAY,EACZ,WAAW,EACX,WAAW,EACX,aAAa,EACd,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,yBAAyB,CACxC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAEzF,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;CACjB;AAQD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,mBAAmB,CAC9B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CACzF,YAAW,mBAAmB;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,yBAAyB;IACtC,QAAQ,CAAC,QAAQ,eAAe;IAEhC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,EAAE,cAAc,CAAW;IAEjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;gBAE/C,MAAM,EAAE,yBAAyB,CAAC,OAAO,CAAC;IA2BtD;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,EAAE,CAEzB;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAEtC;IAED;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC;IAgBxC;;;OAGG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAKnE;;;OAGG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKrD,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,iBAAiB;IAoCzB,OAAO,CAAC,aAAa;IASrB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAUhB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBxB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IAMvE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpF,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7D,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhE,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBzE,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBzE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IASlE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAStC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAoCrC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYtC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAcjD;;;OAGG;IACH,eAAe,IAAI,MAAM;CAW1B;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,IAAI;KAC9E,CAAC,IAAI,MAAM,GAAG,MAAM,OAAO,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CAC/C,CAAC,MAAM,GAAG,MAAM,OAAO,CAAC,CAAC;AAE1B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,gBAAgB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACnF,yFAAyF;IACzF,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAElD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,IAAI,IAAI,gBAAgB,CAAC,MAAM,GAAG,MAAM,OAAO,CAAC,CAAC;IACjD,MAAM,IAAI,gBAAgB,CAAC,OAAO,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;IAC5D,OAAO,IAAI,gBAAgB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,OAAO,CACL,UAAU,EAAE,CACV,KAAK,EAAE,OAAO,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,EACtC,GAAG,EAAE,MAAM,GAAG,MAAM,OAAO,EAC3B,GAAG,EAAE,gBAAgB,CAAC,OAAO,CAAC,KAC3B,IAAI,GACR,IAAI,CAAC;IACR,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;CAC/D"}

package/dist/workspace/filesystem/local-filesystem.d.ts

@@ -40,6 +40,23 @@ export interface LocalFilesystemOptions extends MastraFilesystemOptions {
      * @default false
      */
     readOnly?: boolean;
+    /**
+     * Additional paths (absolute) that are allowed beyond basePath.
+     * Useful with `contained: true` to grant access to specific directories
+     * outside the basePath without disabling containment entirely.
+     *
+     * Paths are resolved to absolute paths using `path.resolve()`.
+     *
+     * @example
+     * ```typescript
+     * new LocalFilesystem({
+     *   basePath: '/project',
+     *   contained: true,
+     *   allowedPaths: ['/home/user/.config'],
+     * })
+     * ```
+     */
+    allowedPaths?: string[];
 }
 /**
  * Local filesystem implementation.
@@ -67,13 +84,37 @@ export declare class LocalFilesystem extends MastraFilesystem {
     status: ProviderStatus;
     private readonly _basePath;
     private readonly _contained;
+    private _allowedPaths;
     /**
      * The absolute base path on disk where files are stored.
      * Useful for understanding how workspace paths map to disk paths.
      */
     get basePath(): string;
+    /**
+     * Current set of additional allowed paths (absolute, resolved).
+     * These paths are permitted beyond basePath when containment is enabled.
+     */
+    get allowedPaths(): readonly string[];
+    /**
+     * Update allowed paths. Accepts a direct array or an updater callback
+     * receiving the current paths (React setState pattern).
+     *
+     * @example
+     * ```typescript
+     * // Set directly
+     * fs.setAllowedPaths(['/home/user/.config']);
+     *
+     * // Update with callback
+     * fs.setAllowedPaths(prev => [...prev, '/home/user/.ssh']);
+     * ```
+     */
+    setAllowedPaths(pathsOrUpdater: string[] | ((current: readonly string[]) => string[])): void;
     constructor(options: LocalFilesystemOptions);
     private generateId;
+    /**
+     * Check if an absolute path falls within basePath or any allowed path.
+     */
+    private _isWithinAnyRoot;
     private toBuffer;
     private resolvePath;
     private toRelativePath;
@@ -111,6 +152,7 @@ export declare class LocalFilesystem extends MastraFilesystem {
     getInfo(): FilesystemInfo<{
         basePath: string;
         contained: boolean;
+        allowedPaths?: string[];
     }>;
     getInstructions(): string;
 }

package/dist/workspace/filesystem/local-filesystem.d.ts.map

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

package/dist/workspace/glob.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Glob Pattern Utilities
+ *
+ * Shared glob pattern matching for workspace operations.
+ * Uses picomatch for battle-tested glob support including
+ * brace expansion, character classes, negation, and `**`.
+ */
+/**
+ * Check if a string contains glob metacharacters.
+ *
+ * @example
+ * isGlobPattern('/docs')           // false
+ * isGlobPattern('/docs/**\/*.md')   // true
+ * isGlobPattern('*.ts')            // true
+ * isGlobPattern('/src/{a,b}')      // true
+ */
+export declare function isGlobPattern(input: string): boolean;
+/**
+ * Extract the static directory prefix before the first glob metacharacter.
+ * Returns the deepest non-glob ancestor directory.
+ *
+ * @example
+ * extractGlobBase('/docs/**\/*.md')  // '/docs'
+ * extractGlobBase('**\/*.md')        // '/'
+ * extractGlobBase('/src/*.ts')      // '/src'
+ * extractGlobBase('/exact/path')    // '/exact/path'
+ */
+export declare function extractGlobBase(pattern: string): string;
+/** A compiled matcher function: returns true if a path matches */
+export type GlobMatcher = (path: string) => boolean;
+export interface GlobMatcherOptions {
+    /** Match dotfiles (default: false) */
+    dot?: boolean;
+}
+/**
+ * Compile glob pattern(s) into a reusable matcher function.
+ * The matcher tests paths using workspace-style forward slashes.
+ *
+ * Automatically normalizes leading './' and '/' from both patterns
+ * and test paths, since picomatch does not match these prefixes.
+ *
+ * @example
+ * const match = createGlobMatcher('**\/*.ts');
+ * match('src/index.ts')     // true
+ * match('src/style.css')    // false
+ *
+ * const multi = createGlobMatcher(['**\/*.ts', '**\/*.tsx']);
+ * multi('App.tsx')           // true
+ */
+export declare function createGlobMatcher(patterns: string | string[], options?: GlobMatcherOptions): GlobMatcher;
+/**
+ * One-off convenience: test if a path matches a glob pattern.
+ *
+ * For repeated matching against the same pattern, prefer createGlobMatcher()
+ * to compile once and reuse.
+ *
+ * @example
+ * matchGlob('src/index.ts', '**\/*.ts')  // true
+ */
+export declare function matchGlob(path: string, pattern: string | string[], options?: GlobMatcherOptions): boolean;
+//# sourceMappingURL=glob.d.ts.map

package/dist/workspace/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../src/workspace/glob.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAMD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAqBvD;AAMD,kEAAkE;AAClE,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAgBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAOxG;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAEzG"}

package/dist/workspace/index.cjs

@@ -1,168 +1,260 @@
 'use strict';
 
-var chunk4KFEMXTV_cjs = require('../chunk-4KFEMXTV.cjs');
+var chunkS4VVZI4E_cjs = require('../chunk-S4VVZI4E.cjs');
 
 
 
 Object.defineProperty(exports, "CompositeFilesystem", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.CompositeFilesystem; }
+  get: function () { return chunkS4VVZI4E_cjs.CompositeFilesystem; }
+});
+Object.defineProperty(exports, "CompositeVersionedSkillSource", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.CompositeVersionedSkillSource; }
 });
 Object.defineProperty(exports, "DirectoryNotEmptyError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.DirectoryNotEmptyError; }
+  get: function () { return chunkS4VVZI4E_cjs.DirectoryNotEmptyError; }
 });
 Object.defineProperty(exports, "DirectoryNotFoundError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.DirectoryNotFoundError; }
+  get: function () { return chunkS4VVZI4E_cjs.DirectoryNotFoundError; }
 });
 Object.defineProperty(exports, "FileExistsError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.FileExistsError; }
+  get: function () { return chunkS4VVZI4E_cjs.FileExistsError; }
 });
 Object.defineProperty(exports, "FileNotFoundError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.FileNotFoundError; }
+  get: function () { return chunkS4VVZI4E_cjs.FileNotFoundError; }
 });
 Object.defineProperty(exports, "FileReadRequiredError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.FileReadRequiredError; }
+  get: function () { return chunkS4VVZI4E_cjs.FileReadRequiredError; }
 });
 Object.defineProperty(exports, "FilesystemError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.FilesystemError; }
+  get: function () { return chunkS4VVZI4E_cjs.FilesystemError; }
 });
 Object.defineProperty(exports, "FilesystemNotAvailableError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.FilesystemNotAvailableError; }
+  get: function () { return chunkS4VVZI4E_cjs.FilesystemNotAvailableError; }
 });
 Object.defineProperty(exports, "FilesystemNotMountableError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.FilesystemNotMountableError; }
+  get: function () { return chunkS4VVZI4E_cjs.FilesystemNotMountableError; }
 });
 Object.defineProperty(exports, "FilesystemNotReadyError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.FilesystemNotReadyError; }
+  get: function () { return chunkS4VVZI4E_cjs.FilesystemNotReadyError; }
 });
 Object.defineProperty(exports, "IsDirectoryError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.IsDirectoryError; }
+  get: function () { return chunkS4VVZI4E_cjs.IsDirectoryError; }
 });
 Object.defineProperty(exports, "IsolationUnavailableError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.IsolationUnavailableError; }
+  get: function () { return chunkS4VVZI4E_cjs.IsolationUnavailableError; }
 });
 Object.defineProperty(exports, "LocalFilesystem", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.LocalFilesystem; }
+  get: function () { return chunkS4VVZI4E_cjs.LocalFilesystem; }
 });
 Object.defineProperty(exports, "LocalSandbox", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.LocalSandbox; }
+  get: function () { return chunkS4VVZI4E_cjs.LocalSandbox; }
+});
+Object.defineProperty(exports, "LocalSkillSource", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.LocalSkillSource; }
 });
 Object.defineProperty(exports, "MastraFilesystem", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.MastraFilesystem; }
+  get: function () { return chunkS4VVZI4E_cjs.MastraFilesystem; }
 });
 Object.defineProperty(exports, "MastraSandbox", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.MastraSandbox; }
+  get: function () { return chunkS4VVZI4E_cjs.MastraSandbox; }
 });
 Object.defineProperty(exports, "MountError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.MountError; }
+  get: function () { return chunkS4VVZI4E_cjs.MountError; }
 });
 Object.defineProperty(exports, "MountManager", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.MountManager; }
+  get: function () { return chunkS4VVZI4E_cjs.MountManager; }
 });
 Object.defineProperty(exports, "MountNotSupportedError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.MountNotSupportedError; }
+  get: function () { return chunkS4VVZI4E_cjs.MountNotSupportedError; }
 });
 Object.defineProperty(exports, "NotDirectoryError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.NotDirectoryError; }
+  get: function () { return chunkS4VVZI4E_cjs.NotDirectoryError; }
 });
 Object.defineProperty(exports, "PermissionError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.PermissionError; }
+  get: function () { return chunkS4VVZI4E_cjs.PermissionError; }
 });
 Object.defineProperty(exports, "SandboxError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.SandboxError; }
+  get: function () { return chunkS4VVZI4E_cjs.SandboxError; }
 });
 Object.defineProperty(exports, "SandboxExecutionError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.SandboxExecutionError; }
+  get: function () { return chunkS4VVZI4E_cjs.SandboxExecutionError; }
 });
 Object.defineProperty(exports, "SandboxFeatureNotSupportedError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.SandboxFeatureNotSupportedError; }
+  get: function () { return chunkS4VVZI4E_cjs.SandboxFeatureNotSupportedError; }
 });
 Object.defineProperty(exports, "SandboxNotAvailableError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.SandboxNotAvailableError; }
+  get: function () { return chunkS4VVZI4E_cjs.SandboxNotAvailableError; }
 });
 Object.defineProperty(exports, "SandboxNotReadyError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.SandboxNotReadyError; }
+  get: function () { return chunkS4VVZI4E_cjs.SandboxNotReadyError; }
 });
 Object.defineProperty(exports, "SandboxTimeoutError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.SandboxTimeoutError; }
+  get: function () { return chunkS4VVZI4E_cjs.SandboxTimeoutError; }
 });
 Object.defineProperty(exports, "SearchNotAvailableError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.SearchNotAvailableError; }
+  get: function () { return chunkS4VVZI4E_cjs.SearchNotAvailableError; }
+});
+Object.defineProperty(exports, "VersionedSkillSource", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.VersionedSkillSource; }
 });
 Object.defineProperty(exports, "WORKSPACE_TOOLS", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.WORKSPACE_TOOLS; }
+  get: function () { return chunkS4VVZI4E_cjs.WORKSPACE_TOOLS; }
 });
 Object.defineProperty(exports, "WORKSPACE_TOOLS_PREFIX", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.WORKSPACE_TOOLS_PREFIX; }
+  get: function () { return chunkS4VVZI4E_cjs.WORKSPACE_TOOLS_PREFIX; }
 });
 Object.defineProperty(exports, "Workspace", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.Workspace; }
+  get: function () { return chunkS4VVZI4E_cjs.Workspace; }
 });
 Object.defineProperty(exports, "WorkspaceError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.WorkspaceError; }
+  get: function () { return chunkS4VVZI4E_cjs.WorkspaceError; }
+});
+Object.defineProperty(exports, "WorkspaceNotAvailableError", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.WorkspaceNotAvailableError; }
 });
 Object.defineProperty(exports, "WorkspaceNotReadyError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.WorkspaceNotReadyError; }
+  get: function () { return chunkS4VVZI4E_cjs.WorkspaceNotReadyError; }
 });
 Object.defineProperty(exports, "WorkspaceReadOnlyError", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.WorkspaceReadOnlyError; }
+  get: function () { return chunkS4VVZI4E_cjs.WorkspaceReadOnlyError; }
 });
 Object.defineProperty(exports, "callLifecycle", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.callLifecycle; }
+  get: function () { return chunkS4VVZI4E_cjs.callLifecycle; }
+});
+Object.defineProperty(exports, "collectSkillForPublish", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.collectSkillForPublish; }
+});
+Object.defineProperty(exports, "createGlobMatcher", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.createGlobMatcher; }
 });
 Object.defineProperty(exports, "createWorkspaceTools", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.createWorkspaceTools; }
+  get: function () { return chunkS4VVZI4E_cjs.createWorkspaceTools; }
+});
+Object.defineProperty(exports, "deleteFileTool", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.deleteFileTool; }
 });
 Object.defineProperty(exports, "detectIsolation", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.detectIsolation; }
+  get: function () { return chunkS4VVZI4E_cjs.detectIsolation; }
+});
+Object.defineProperty(exports, "editFileTool", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.editFileTool; }
+});
+Object.defineProperty(exports, "executeCommandTool", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.executeCommandTool; }
+});
+Object.defineProperty(exports, "extractGlobBase", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.extractGlobBase; }
+});
+Object.defineProperty(exports, "fileStatTool", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.fileStatTool; }
 });
 Object.defineProperty(exports, "getRecommendedIsolation", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.getRecommendedIsolation; }
+  get: function () { return chunkS4VVZI4E_cjs.getRecommendedIsolation; }
+});
+Object.defineProperty(exports, "indexContentTool", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.indexContentTool; }
+});
+Object.defineProperty(exports, "isGlobPattern", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.isGlobPattern; }
 });
 Object.defineProperty(exports, "isIsolationAvailable", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.isIsolationAvailable; }
+  get: function () { return chunkS4VVZI4E_cjs.isIsolationAvailable; }
+});
+Object.defineProperty(exports, "listFilesTool", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.listFilesTool; }
+});
+Object.defineProperty(exports, "matchGlob", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.matchGlob; }
+});
+Object.defineProperty(exports, "mkdirTool", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.mkdirTool; }
+});
+Object.defineProperty(exports, "publishSkillFromSource", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.publishSkillFromSource; }
+});
+Object.defineProperty(exports, "readFileTool", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.readFileTool; }
+});
+Object.defineProperty(exports, "requireFilesystem", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.requireFilesystem; }
+});
+Object.defineProperty(exports, "requireSandbox", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.requireSandbox; }
+});
+Object.defineProperty(exports, "requireWorkspace", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.requireWorkspace; }
 });
 Object.defineProperty(exports, "resolveToolConfig", {
   enumerable: true,
-  get: function () { return chunk4KFEMXTV_cjs.resolveToolConfig; }
+  get: function () { return chunkS4VVZI4E_cjs.resolveToolConfig; }
+});
+Object.defineProperty(exports, "searchTool", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.searchTool; }
+});
+Object.defineProperty(exports, "writeFileTool", {
+  enumerable: true,
+  get: function () { return chunkS4VVZI4E_cjs.writeFileTool; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/workspace/index.d.ts

@@ -6,7 +6,7 @@ export { MastraFilesystem, type FilesystemLifecycleHook, type MastraFilesystemOp
 export { MastraSandbox } from './sandbox/index.js';
 export * from './errors.js';
 export { SandboxError, SandboxExecutionError, SandboxTimeoutError, SandboxNotReadyError, IsolationUnavailableError, MountError, MountNotSupportedError, FilesystemNotMountableError, type SandboxOperation, } from './sandbox/index.js';
-export { createWorkspaceTools, resolveToolConfig, type WorkspaceToolConfig, type WorkspaceToolsConfig } from './tools/index.js';
+export { createWorkspaceTools, resolveToolConfig, type WorkspaceToolConfig, type WorkspaceToolsConfig, readFileTool, writeFileTool, editFileTool, listFilesTool, deleteFileTool, fileStatTool, mkdirTool, searchTool, indexContentTool, executeCommandTool, requireWorkspace, requireFilesystem, requireSandbox, } from './tools/index.js';
 export * from './lifecycle.js';
 export type { WorkspaceFilesystem, FileContent, FileStat, FileEntry, FilesystemInfo, ReadOptions, WriteOptions, ListOptions, RemoveOptions, CopyOptions, } from './filesystem/index.js';
 export type { FilesystemMountConfig, MountResult, FilesystemIcon } from './filesystem/index.js';
@@ -16,5 +16,12 @@ export type { MountManagerConfig, MountFn, OnMountHook, OnMountArgs, OnMountResu
 export type { IsolationBackend, NativeSandboxConfig, SandboxDetectionResult } from './sandbox/index.js';
 export { detectIsolation, isIsolationAvailable, getRecommendedIsolation } from './sandbox/index.js';
 export { WORKSPACE_TOOLS_PREFIX, WORKSPACE_TOOLS, type WorkspaceToolName } from './constants/index.js';
+export { isGlobPattern, extractGlobBase, createGlobMatcher, matchGlob, type GlobMatcher, type GlobMatcherOptions, } from './glob.js';
 export type { SkillFormat, SkillMetadata, Skill, SkillSearchResult, SkillSearchOptions, WorkspaceSkills, SkillsResolver, SkillsContext, } from './skills/index.js';
+export type { SkillPublishResult } from './skills/index.js';
+export { collectSkillForPublish, publishSkillFromSource } from './skills/index.js';
+export type { SkillSource, SkillSourceEntry, SkillSourceStat } from './skills/index.js';
+export { LocalSkillSource } from './skills/index.js';
+export { VersionedSkillSource } from './skills/index.js';
+export { CompositeVersionedSkillSource, type VersionedSkillEntry } from './skills/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGnE,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5G,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,cAAc,UAAU,CAAC;AACzB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,UAAU,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAGvH,cAAc,aAAa,CAAC;AAG5B,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,SAAS,EACT,cAAc,EACd,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGvF,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,kBAAkB,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAGtG,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAG3F,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG9F,YAAY,EACV,WAAW,EACX,aAAa,EACb,KAAK,EACL,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGnE,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5G,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,cAAc,UAAU,CAAC;AACzB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,UAAU,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAEzB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAElB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,cAAc,aAAa,CAAC;AAG5B,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,SAAS,EACT,cAAc,EACd,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGvF,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,kBAAkB,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAGtG,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAG3F,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG9F,OAAO,EACL,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,QAAQ,CAAC;AAGhB,YAAY,EACV,WAAW,EACX,aAAa,EACb,KAAK,EACL,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,UAAU,CAAC;AAGlB,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAG1E,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,6BAA6B,EAAE,KAAK,mBAAmB,EAAE,MAAM,UAAU,CAAC"}

package/dist/workspace/index.js

@@ -1,3 +1,3 @@
-export { CompositeFilesystem, DirectoryNotEmptyError, DirectoryNotFoundError, FileExistsError, FileNotFoundError, FileReadRequiredError, FilesystemError, FilesystemNotAvailableError, FilesystemNotMountableError, FilesystemNotReadyError, IsDirectoryError, IsolationUnavailableError, LocalFilesystem, LocalSandbox, MastraFilesystem, MastraSandbox, MountError, MountManager, MountNotSupportedError, NotDirectoryError, PermissionError, SandboxError, SandboxExecutionError, SandboxFeatureNotSupportedError, SandboxNotAvailableError, SandboxNotReadyError, SandboxTimeoutError, SearchNotAvailableError, WORKSPACE_TOOLS, WORKSPACE_TOOLS_PREFIX, Workspace, WorkspaceError, WorkspaceNotReadyError, WorkspaceReadOnlyError, callLifecycle, createWorkspaceTools, detectIsolation, getRecommendedIsolation, isIsolationAvailable, resolveToolConfig } from '../chunk-4EHGOATH.js';
+export { CompositeFilesystem, CompositeVersionedSkillSource, DirectoryNotEmptyError, DirectoryNotFoundError, FileExistsError, FileNotFoundError, FileReadRequiredError, FilesystemError, FilesystemNotAvailableError, FilesystemNotMountableError, FilesystemNotReadyError, IsDirectoryError, IsolationUnavailableError, LocalFilesystem, LocalSandbox, LocalSkillSource, MastraFilesystem, MastraSandbox, MountError, MountManager, MountNotSupportedError, NotDirectoryError, PermissionError, SandboxError, SandboxExecutionError, SandboxFeatureNotSupportedError, SandboxNotAvailableError, SandboxNotReadyError, SandboxTimeoutError, SearchNotAvailableError, VersionedSkillSource, WORKSPACE_TOOLS, WORKSPACE_TOOLS_PREFIX, Workspace, WorkspaceError, WorkspaceNotAvailableError, WorkspaceNotReadyError, WorkspaceReadOnlyError, callLifecycle, collectSkillForPublish, createGlobMatcher, createWorkspaceTools, deleteFileTool, detectIsolation, editFileTool, executeCommandTool, extractGlobBase, fileStatTool, getRecommendedIsolation, indexContentTool, isGlobPattern, isIsolationAvailable, listFilesTool, matchGlob, mkdirTool, publishSkillFromSource, readFileTool, requireFilesystem, requireSandbox, requireWorkspace, resolveToolConfig, searchTool, writeFileTool } from '../chunk-FZ5DRHKE.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/workspace/sandbox/local-sandbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-sandbox.d.ts","sourceRoot":"","sources":["../../../src/workspace/sandbox/local-sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAwEjF;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D,kDAAkD;IAClD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;;;;;;;;OAgBG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAa,SAAQ,aAAa;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,QAAQ,WAAW;IAE5B,MAAM,EAAE,cAAc,CAAa;IAEnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAsB;IAC3D,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,oBAAoB,CAAC,CAAS;IACtC,OAAO,CAAC,kBAAkB,CAAC,CAAS;IACpC,OAAO,CAAC,wBAAwB,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAO;IAElC;;OAEG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,gBAAgB,CAEhC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,eAAe;gBAIV,OAAO,GAAE,mBAAwB;IAmB7C,OAAO,CAAC,UAAU;IAIlB;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAQhB;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoD5B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBxB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAI3B,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;IA4BrC,eAAe,IAAI,MAAM;IAOzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAazB,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,aAAa,CAAC;CAiD1B"}
+{"version":3,"file":"local-sandbox.d.ts","sourceRoot":"","sources":["../../../src/workspace/sandbox/local-sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAwEjF;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D,kDAAkD;IAClD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;;;;;;;;OAgBG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAa,SAAQ,aAAa;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,QAAQ,WAAW;IAE5B,MAAM,EAAE,cAAc,CAAa;IAEnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAsB;IAC3D,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,oBAAoB,CAAC,CAAS;IACtC,OAAO,CAAC,kBAAkB,CAAC,CAAS;IACpC,OAAO,CAAC,wBAAwB,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAO;IAElC;;OAEG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,gBAAgB,CAEhC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,eAAe;gBAIV,OAAO,GAAE,mBAAwB;IAmB7C,OAAO,CAAC,UAAU;IAIlB;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAQhB;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuD5B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBxB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAI3B,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;IA4BrC,eAAe,IAAI,MAAM;IAOzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAazB,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,aAAa,CAAC;CAiD1B"}