@aigne/afs 1.11.0-beta.2 → 1.11.0-beta.4

package/dist/afs.cjs

@@ -1,4 +1,5 @@
 const require_error = require('./error.cjs');
+const require_path = require('./path.cjs');
 const require_type = require('./type.cjs');
 let _aigne_uuid = require("@aigne/uuid");
 let strict_event_emitter = require("strict-event-emitter");
@@ -8,14 +9,62 @@ let zod = require("zod");
 //#region src/afs.ts
 const DEFAULT_MAX_DEPTH = 1;
 const MODULES_ROOT_DIR = "/modules";
+/**
+* Characters forbidden in namespace names (security-sensitive)
+*/
+const NAMESPACE_FORBIDDEN_CHARS = [
+	"/",
+	"\\",
+	":",
+	";",
+	"|",
+	"&",
+	"`",
+	"$",
+	"(",
+	")",
+	">",
+	"<",
+	"\n",
+	"\r",
+	"	",
+	"\0"
+];
+/**
+* Validate a namespace name for mount operations
+* @throws Error if namespace is invalid
+*/
+function validateNamespaceName(namespace) {
+	if (namespace.trim() === "") throw new Error("Namespace cannot be empty or whitespace-only");
+	for (const char of NAMESPACE_FORBIDDEN_CHARS) if (namespace.includes(char)) throw new Error(`Namespace contains forbidden character: '${char}'`);
+}
 var AFS = class extends strict_event_emitter.Emitter {
 	name = "AFSRoot";
 	constructor(options = {}) {
 		super();
 		this.options = options;
-		for (const module of options?.modules ?? []) this.mount(module);
+		for (const module of options?.modules ?? []) this.mount(module, (0, ufo.joinURL)(MODULES_ROOT_DIR, module.name));
+	}
+	/**
+	* Internal storage: Map<compositeKey, MountEntry>
+	* compositeKey = `${namespace ?? ""}:${path}`
+	*/
+	mounts = /* @__PURE__ */ new Map();
+	/**
+	* Legacy compatibility: Map<path, AFSModule> for modules mounted via old API
+	* This is used internally by findModules for backward compatibility
+	*/
+	get modules() {
+		const map = /* @__PURE__ */ new Map();
+		for (const entry of this.mounts.values()) if (entry.namespace === null) map.set(entry.path, entry.module);
+		return map;
+	}
+	/**
+	* Create composite key for mount storage
+	*/
+	makeKey(namespace, path) {
+		return `${namespace ?? ""}:${path}`;
 	}
-	modules = /* @__PURE__ */ new Map();
 	/**
 	* Check if write operations are allowed for the given module.
 	* Throws AFSReadonlyError if not allowed.
@@ -23,57 +72,197 @@ var AFS = class extends strict_event_emitter.Emitter {
 	checkWritePermission(module, operation, path) {
 		if (module.accessMode !== "readwrite") throw new require_error.AFSReadonlyError(`Module '${module.name}' is readonly, cannot perform ${operation} to ${path}`);
 	}
-	mount(module) {
-		if (module.name.includes("/")) throw new Error(`Invalid module name: ${module.name}. Module name must not contain '/'`);
-		const path = (0, ufo.joinURL)(MODULES_ROOT_DIR, module.name);
-		if (this.modules.has(path)) throw new Error(`Module already mounted at path: ${path}`);
-		this.modules.set(path, module);
+	/**
+	* Mount a module at a path in a namespace
+	*
+	* @param module - The module to mount
+	* @param path - The path to mount at (optional, defaults to /modules/{module.name} for backward compatibility)
+	* @param options - Mount options (namespace, replace)
+	*/
+	mount(module, path, options) {
+		require_path.validateModuleName(module.name);
+		const normalizedPath = require_path.validatePath(path ?? (0, ufo.joinURL)(MODULES_ROOT_DIR, module.name));
+		const namespace = options?.namespace === void 0 ? null : options.namespace;
+		if (namespace !== null) {
+			if (namespace === "") throw new Error("Namespace cannot be empty or whitespace-only");
+			validateNamespaceName(namespace);
+		}
+		const key = this.makeKey(namespace, normalizedPath);
+		if (this.mounts.has(key)) if (options?.replace) this.mounts.delete(key);
+		else throw new Error(`Mount conflict: path '${normalizedPath}' already mounted in namespace '${namespace ?? "default"}'`);
+		for (const entry of this.mounts.values()) {
+			if (entry.namespace !== namespace) continue;
+			const existingPath = entry.path;
+			if (normalizedPath === "/" || existingPath === "/") throw new Error(`Mount conflict: path '${normalizedPath}' conflicts with existing mount '${existingPath}' in namespace '${namespace ?? "default"}'`);
+			if (existingPath.startsWith(normalizedPath) && (existingPath === normalizedPath || existingPath.length === normalizedPath.length || existingPath[normalizedPath.length] === "/")) throw new Error(`Mount conflict: path '${normalizedPath}' conflicts with existing mount '${existingPath}' in namespace '${namespace ?? "default"}'`);
+			if (normalizedPath.startsWith(existingPath) && (normalizedPath === existingPath || normalizedPath.length === existingPath.length || normalizedPath[existingPath.length] === "/")) throw new Error(`Mount conflict: path '${normalizedPath}' conflicts with existing mount '${existingPath}' in namespace '${namespace ?? "default"}'`);
+		}
+		this.mounts.set(key, {
+			namespace,
+			path: normalizedPath,
+			module
+		});
 		module.onMount?.(this);
 		return this;
 	}
+	/**
+	* Get all mounts, optionally filtered by namespace
+	*
+	* @param namespace - Filter by namespace (undefined = all, null = default only)
+	*/
+	getMounts(namespace) {
+		const result = [];
+		for (const entry of this.mounts.values()) if (namespace === void 0 || entry.namespace === namespace) result.push({
+			namespace: entry.namespace,
+			path: entry.path,
+			module: entry.module
+		});
+		return result;
+	}
+	/**
+	* Get all unique namespaces that have mounts
+	*/
+	getNamespaces() {
+		const namespaces = /* @__PURE__ */ new Set();
+		for (const entry of this.mounts.values()) namespaces.add(entry.namespace);
+		return Array.from(namespaces);
+	}
+	/**
+	* Unmount a module at a path in a namespace
+	*
+	* @param path - The path to unmount
+	* @param namespace - The namespace (undefined/null for default namespace)
+	* @returns true if unmounted, false if not found
+	*/
+	unmount(path, namespace) {
+		const normalizedPath = require_path.validatePath(path);
+		const ns = namespace === void 0 ? null : namespace;
+		const key = this.makeKey(ns, normalizedPath);
+		if (this.mounts.has(key)) {
+			this.mounts.delete(key);
+			return true;
+		}
+		return false;
+	}
+	/**
+	* Check if a path is mounted in a namespace
+	*
+	* @param path - The path to check
+	* @param namespace - The namespace (undefined/null for default namespace)
+	*/
+	isMounted(path, namespace) {
+		const normalizedPath = require_path.validatePath(path);
+		const ns = namespace === void 0 ? null : namespace;
+		const key = this.makeKey(ns, normalizedPath);
+		return this.mounts.has(key);
+	}
 	async listModules() {
-		return Array.from(this.modules.entries()).map(([path, module]) => ({
-			path,
-			name: module.name,
-			description: module.description,
-			module
+		return Array.from(this.mounts.values()).map((entry) => ({
+			path: entry.path,
+			namespace: entry.namespace,
+			name: entry.module.name,
+			description: entry.module.description,
+			module: entry.module
 		}));
 	}
+	/**
+	* Parse a path and extract namespace if it's a canonical path
+	* Returns the namespace and the path within the namespace
+	*/
+	parsePathWithNamespace(inputPath) {
+		if (require_path.isCanonicalPath(inputPath)) {
+			const parsed = require_path.parseCanonicalPath(inputPath);
+			return {
+				namespace: parsed.namespace,
+				path: parsed.path
+			};
+		}
+		return {
+			namespace: null,
+			path: require_path.validatePath(inputPath)
+		};
+	}
+	/**
+	* Find modules that can handle a path in a specific namespace
+	*/
+	findModulesInNamespace(path, namespace, options) {
+		const maxDepth = Math.max(options?.maxDepth ?? DEFAULT_MAX_DEPTH, 1);
+		const matched = [];
+		for (const entry of this.mounts.values()) {
+			if (entry.namespace !== namespace) continue;
+			const modulePath = entry.path;
+			const module = entry.module;
+			const pathSegments = path.split("/").filter(Boolean);
+			const modulePathSegments = modulePath.split("/").filter(Boolean);
+			let newMaxDepth;
+			let subpath;
+			let remainedModulePath;
+			if (!options?.exactMatch && modulePath.startsWith(path)) {
+				newMaxDepth = Math.max(0, maxDepth - (modulePathSegments.length - pathSegments.length));
+				subpath = "/";
+				remainedModulePath = (0, ufo.joinURL)("/", ...modulePathSegments.slice(pathSegments.length).slice(0, maxDepth));
+			} else if (path.startsWith(modulePath)) {
+				newMaxDepth = maxDepth;
+				subpath = (0, ufo.joinURL)("/", ...pathSegments.slice(modulePathSegments.length));
+				remainedModulePath = "/";
+			} else continue;
+			if (newMaxDepth < 0) continue;
+			matched.push({
+				module,
+				modulePath,
+				maxDepth: newMaxDepth,
+				subpath,
+				remainedModulePath
+			});
+		}
+		return matched;
+	}
 	async list(path, options = {}) {
+		const { namespace, path: normalizedPath } = this.parsePathWithNamespace(path);
 		let preset;
 		if (options.preset) {
 			preset = this.options?.context?.list?.presets?.[options.preset];
 			if (!preset) throw new Error(`Preset not found: ${options.preset}`);
 		}
-		return await this.processWithPreset(path, void 0, preset, {
+		return await this.processWithPreset(normalizedPath, void 0, preset, {
 			...options,
-			defaultSelect: () => this._list(path, options)
+			defaultSelect: () => this._list(normalizedPath, namespace, options)
 		});
 	}
-	async _list(path, options = {}) {
+	async _list(path, namespace, options = {}) {
 		const results = [];
-		if (path === "/" && this.modules.size > 0) {
+		const hasModulesMounts = namespace === null && [...this.mounts.values()].some((m) => m.namespace === null && m.path.startsWith(`${MODULES_ROOT_DIR}/`));
+		if (path === "/" && hasModulesMounts) {
 			const maxDepth = options?.maxDepth ?? DEFAULT_MAX_DEPTH;
 			results.push({
 				id: "modules",
 				path: MODULES_ROOT_DIR,
-				summary: "All mounted modules"
+				summary: "All mounted modules",
+				metadata: {
+					type: "directory",
+					description: "All mounted modules"
+				}
 			});
 			if (maxDepth === 1) return { data: results };
-			const childrenResult = await this._list(MODULES_ROOT_DIR, {
+			const childrenResult = await this._list(MODULES_ROOT_DIR, namespace, {
 				...options,
 				maxDepth: maxDepth - 1
 			});
 			results.push(...childrenResult.data);
 			return { data: results };
 		}
-		const matches = this.findModules(path, options);
+		const matches = this.findModulesInNamespace(path, namespace, options);
+		if (matches.length === 0) return { data: results };
 		for (const matched of matches) {
 			if (matched.maxDepth === 0) {
 				const moduleEntry = {
 					id: matched.module.name,
 					path: matched.modulePath,
-					summary: matched.module.description
+					summary: matched.module.description,
+					metadata: {
+						type: "module",
+						description: matched.module.description
+					}
 				};
 				results.push(moduleEntry);
 				continue;
@@ -96,7 +285,8 @@ var AFS = class extends strict_event_emitter.Emitter {
 		return { data: results };
 	}
 	async read(path, _options) {
-		const modules = this.findModules(path, { exactMatch: true });
+		const { namespace, path: normalizedPath } = this.parsePathWithNamespace(path);
+		const modules = this.findModulesInNamespace(normalizedPath, namespace, { exactMatch: true });
 		for (const { module, modulePath, subpath } of modules) {
 			const res = await module.read?.(subpath);
 			if (res?.data) return {
@@ -113,8 +303,9 @@ var AFS = class extends strict_event_emitter.Emitter {
 		};
 	}
 	async write(path, content, options) {
-		const module = this.findModules(path, { exactMatch: true })[0];
-		if (!module?.module.write) throw new Error(`No module found for path: ${path}`);
+		const { namespace, path: normalizedPath } = this.parsePathWithNamespace(path);
+		const module = this.findModulesInNamespace(normalizedPath, namespace, { exactMatch: true })[0];
+		if (!module?.module.write) throw new Error(`No module found for path: ${normalizedPath} in namespace '${namespace ?? "default"}'`);
 		this.checkWritePermission(module.module, "write", path);
 		const res = await module.module.write(module.subpath, content, options);
 		return {
@@ -126,28 +317,33 @@ var AFS = class extends strict_event_emitter.Emitter {
 		};
 	}
 	async delete(path, options) {
-		const module = this.findModules(path, { exactMatch: true })[0];
-		if (!module?.module.delete) throw new Error(`No module found for path: ${path}`);
+		const { namespace, path: normalizedPath } = this.parsePathWithNamespace(path);
+		const module = this.findModulesInNamespace(normalizedPath, namespace, { exactMatch: true })[0];
+		if (!module?.module.delete) throw new Error(`No module found for path: ${normalizedPath} in namespace '${namespace ?? "default"}'`);
 		this.checkWritePermission(module.module, "delete", path);
 		return await module.module.delete(module.subpath, options);
 	}
 	async rename(oldPath, newPath, options) {
-		const oldModule = this.findModules(oldPath, { exactMatch: true })[0];
-		const newModule = this.findModules(newPath, { exactMatch: true })[0];
+		const { namespace: oldNamespace, path: normalizedOldPath } = this.parsePathWithNamespace(oldPath);
+		const { namespace: newNamespace, path: normalizedNewPath } = this.parsePathWithNamespace(newPath);
+		if (oldNamespace !== newNamespace) throw new Error(`Cannot rename across different namespaces.`);
+		const oldModule = this.findModulesInNamespace(normalizedOldPath, oldNamespace, { exactMatch: true })[0];
+		const newModule = this.findModulesInNamespace(normalizedNewPath, newNamespace, { exactMatch: true })[0];
 		if (!oldModule || !newModule || oldModule.modulePath !== newModule.modulePath) throw new Error(`Cannot rename across different modules. Both paths must be in the same module.`);
 		if (!oldModule.module.rename) throw new Error(`Module does not support rename operation: ${oldModule.modulePath}`);
 		this.checkWritePermission(oldModule.module, "rename", oldPath);
 		return await oldModule.module.rename(oldModule.subpath, newModule.subpath, options);
 	}
 	async search(path, query, options = {}) {
+		const { namespace, path: normalizedPath } = this.parsePathWithNamespace(path);
 		let preset;
 		if (options.preset) {
 			preset = this.options?.context?.search?.presets?.[options.preset];
 			if (!preset) throw new Error(`Preset not found: ${options.preset}`);
 		}
-		return await this.processWithPreset(path, query, preset, {
+		return await this.processWithPreset(normalizedPath, query, preset, {
 			...options,
-			defaultSelect: () => this._search(path, query, options)
+			defaultSelect: () => this._search(normalizedPath, namespace, query, options)
 		});
 	}
 	async processWithPreset(path, query, preset, options) {
@@ -174,10 +370,10 @@ var AFS = class extends strict_event_emitter.Emitter {
 		}, options);
 		return { data: (await Promise.all(data.map((p) => this.read(p).then((res) => res.data)))).filter((i) => !!i) };
 	}
-	async _search(path, query, options) {
+	async _search(path, namespace, query, options) {
 		const results = [];
 		const messages = [];
-		for (const { module, modulePath, subpath } of this.findModules(path)) {
+		for (const { module, modulePath, subpath } of this.findModulesInNamespace(path, namespace)) {
 			if (!module.search) continue;
 			try {
 				const { data, message } = await module.search(subpath, query, options);
@@ -195,38 +391,10 @@ var AFS = class extends strict_event_emitter.Emitter {
 			message: messages.join("; ")
 		};
 	}
-	findModules(path, options) {
-		const maxDepth = Math.max(options?.maxDepth ?? DEFAULT_MAX_DEPTH, 1);
-		const matched = [];
-		for (const [modulePath, module] of this.modules) {
-			const pathSegments = path.split("/").filter(Boolean);
-			const modulePathSegments = modulePath.split("/").filter(Boolean);
-			let newMaxDepth;
-			let subpath;
-			let remainedModulePath;
-			if (!options?.exactMatch && modulePath.startsWith(path)) {
-				newMaxDepth = Math.max(0, maxDepth - (modulePathSegments.length - pathSegments.length));
-				subpath = "/";
-				remainedModulePath = (0, ufo.joinURL)("/", ...modulePathSegments.slice(pathSegments.length).slice(0, maxDepth));
-			} else if (path.startsWith(modulePath)) {
-				newMaxDepth = maxDepth;
-				subpath = (0, ufo.joinURL)("/", ...pathSegments.slice(modulePathSegments.length));
-				remainedModulePath = "/";
-			} else continue;
-			if (newMaxDepth < 0) continue;
-			matched.push({
-				module,
-				modulePath,
-				maxDepth: newMaxDepth,
-				subpath,
-				remainedModulePath
-			});
-		}
-		return matched;
-	}
 	async exec(path, args, options) {
-		const module = this.findModules(path)[0];
-		if (!module?.module.exec) throw new Error(`No module found for path: ${path}`);
+		const { namespace, path: normalizedPath } = this.parsePathWithNamespace(path);
+		const module = this.findModulesInNamespace(normalizedPath, namespace)[0];
+		if (!module?.module.exec) throw new Error(`No module found for path: ${normalizedPath} in namespace '${namespace ?? "default"}'`);
 		return await module.module.exec(module.subpath, args, options);
 	}
 	buildSimpleListView(entries) {
@@ -276,10 +444,11 @@ var AFS = class extends strict_event_emitter.Emitter {
 			const fs = await import("node:fs/promises");
 			const rootDir = path.join(os.tmpdir(), (0, _aigne_uuid.v7)());
 			await fs.mkdir(rootDir, { recursive: true });
-			for (const [modulePath, module] of this.modules) {
-				const physicalModulePath = path.join(rootDir, modulePath);
+			for (const entry of this.mounts.values()) {
+				const namespacePart = entry.namespace ?? "_default";
+				const physicalModulePath = path.join(rootDir, namespacePart, entry.path);
 				await fs.mkdir(path.dirname(physicalModulePath), { recursive: true });
-				await module.symlinkToPhysical?.(physicalModulePath);
+				await entry.module.symlinkToPhysical?.(physicalModulePath);
 			}
 			return rootDir;
 		})();

package/dist/afs.d.cts

@@ -2,6 +2,26 @@ import { AFSContext, AFSDeleteOptions, AFSDeleteResult, AFSExecOptions, AFSExecR
 import { Emitter } from "strict-event-emitter";
 
 //#region src/afs.d.ts
+/**
+ * Information about a mounted module
+ */
+interface MountInfo {
+  /** The namespace (null for default namespace) */
+  namespace: string | null;
+  /** The mount path within the namespace */
+  path: string;
+  /** The mounted module */
+  module: AFSModule;
+}
+/**
+ * Options for mounting a module
+ */
+interface MountOptions {
+  /** Namespace to mount into (null/undefined for default namespace) */
+  namespace?: string | null;
+  /** Replace existing mount at the same path */
+  replace?: boolean;
+}
 interface AFSOptions {
   modules?: AFSModule[];
   context?: AFSContext;
@@ -10,19 +30,74 @@ declare class AFS extends Emitter<AFSRootEvents> implements AFSRoot {
   options: AFSOptions;
   name: string;
   constructor(options?: AFSOptions);
-  private modules;
+  /**
+       * Internal storage: Map<compositeKey, MountEntry>
+       * compositeKey = `${namespace ?? ""}:${path}`
+       */
+  private mounts;
+  /**
+       * Legacy compatibility: Map<path, AFSModule> for modules mounted via old API
+       * This is used internally by findModules for backward compatibility
+       */
+  private get modules();
+  /**
+       * Create composite key for mount storage
+       */
+  private makeKey;
   /**
        * Check if write operations are allowed for the given module.
        * Throws AFSReadonlyError if not allowed.
        */
   private checkWritePermission;
-  mount(module: AFSModule): this;
+  /**
+       * Mount a module at a path in a namespace
+       *
+       * @param module - The module to mount
+       * @param path - The path to mount at (optional, defaults to /modules/{module.name} for backward compatibility)
+       * @param options - Mount options (namespace, replace)
+       */
+  mount(module: AFSModule, path?: string, options?: MountOptions): this;
+  /**
+       * Get all mounts, optionally filtered by namespace
+       *
+       * @param namespace - Filter by namespace (undefined = all, null = default only)
+       */
+  getMounts(namespace?: string | null): MountInfo[];
+  /**
+       * Get all unique namespaces that have mounts
+       */
+  getNamespaces(): (string | null)[];
+  /**
+       * Unmount a module at a path in a namespace
+       *
+       * @param path - The path to unmount
+       * @param namespace - The namespace (undefined/null for default namespace)
+       * @returns true if unmounted, false if not found
+       */
+  unmount(path: string, namespace?: string | null): boolean;
+  /**
+       * Check if a path is mounted in a namespace
+       *
+       * @param path - The path to check
+       * @param namespace - The namespace (undefined/null for default namespace)
+       */
+  isMounted(path: string, namespace?: string | null): boolean;
   listModules(): Promise<{
     name: string;
     path: string;
+    namespace: string | null;
     description?: string;
     module: AFSModule;
   }[]>;
+  /**
+       * Parse a path and extract namespace if it's a canonical path
+       * Returns the namespace and the path within the namespace
+       */
+  private parsePathWithNamespace;
+  /**
+       * Find modules that can handle a path in a specific namespace
+       */
+  private findModulesInNamespace;
   list(path: string, options?: AFSRootListOptions): Promise<AFSRootListResult>;
   private _list;
   read(path: string, _options?: AFSReadOptions): Promise<AFSReadResult>;
@@ -33,7 +108,6 @@ declare class AFS extends Emitter<AFSRootEvents> implements AFSRoot {
   private processWithPreset;
   private _select;
   private _search;
-  private findModules;
   exec(path: string, args: Record<string, any>, options: AFSExecOptions): Promise<AFSExecResult>;
   private buildSimpleListView;
   private buildTreeView;
@@ -43,5 +117,5 @@ declare class AFS extends Emitter<AFSRootEvents> implements AFSRoot {
   cleanupPhysicalPath(): Promise<void>;
 }
 //#endregion
-export { AFS, AFSOptions };
+export { AFS, AFSOptions, MountInfo, MountOptions };
 //# sourceMappingURL=afs.d.cts.map

package/dist/afs.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"afs.d.cts","names":[],"sources":["../src/afs.ts"],"mappings":";;;;UAqCiB,UAAA;EAAA,OAAA,GACL,SAAA;EAAA,OAAA,GACA,UAAA;AAAA;AAAA,cAGC,GAAA,SAAY,OAAA,CAAQ,aAAA,aAA0B,OAAA;EAAA,OAAA,EAG7B,UAAA;EAAA,IAAA;EAAA,YAAA,OAAA,GAAA,UAAA;EAAA,QAAA,OAAA;EAAA;;;;EAAA,QAAA,oBAAA;EAAA,MAAA,MAAA,EAuBd,SAAA;EAAA,YAAA,GAiBO,OAAA;IAAA,IAAA;IAAA,IAAA;IAAA,WAAA;IAAA,MAAA,EACyC,SAAA;EAAA;EAAA,KAAA,IAAA,UAAA,OAAA,GAU5B,kBAAA,GAA0B,OAAA,CAAQ,iBAAA;EAAA,QAAA,KAAA;EAAA,KAAA,IAAA,UAAA,QAAA,GAiFhC,cAAA,GAAiB,OAAA,CAAQ,aAAA;EAAA,MAAA,IAAA,UAAA,OAAA,EAsBlD,oBAAA,EAAA,OAAA,GACC,eAAA,GACT,OAAA,CAAQ,cAAA;EAAA,OAAA,IAAA,UAAA,OAAA,GAiB0B,gBAAA,GAAmB,OAAA,CAAQ,eAAA;EAAA,OAAA,OAAA,UAAA,OAAA,UAAA,OAAA,GAYpD,gBAAA,GACT,OAAA,CAAQ,eAAA;EAAA,OAAA,IAAA,UAAA,KAAA,UAAA,OAAA,GAuBA,oBAAA,GACR,OAAA,CAAQ,mBAAA;EAAA,QAAA,iBAAA;EAAA,QAAA,OAAA;EAAA,QAAA,OAAA;EAAA,QAAA,WAAA;EAAA,KAAA,IAAA,UAAA,IAAA,EAoJH,MAAA,eAAA,OAAA,EACG,cAAA,GACR,OAAA,CAAQ,aAAA;EAAA,QAAA,mBAAA;EAAA,QAAA,aAAA;EAAA,QAAA,mBAAA;EAAA,QAAA,YAAA;EAAA,uBAAA,GA8EqB,OAAA;EAAA,oBAAA,GAqBH,OAAA;AAAA"}
+{"version":3,"file":"afs.d.cts","names":[],"sources":["../src/afs.ts"],"mappings":";;;;;AA+EA;AAYA;UAZiB,SAAA;EAAA;EAAA,SAAA;EAAA;EAAA,IAAA;EAAA;EAAA,MAAA,EAMP,SAAA;AAAA;AAAA;AAMV;AAgBA;AAtBU,UAMO,YAAA;EAAA;EAAA,SAAA;EAAA;EAAA,OAAA;AAAA;AAAA,UAgBA,UAAA;EAAA,OAAA,GACL,SAAA;EAAA,OAAA,GACA,UAAA;AAAA;AAAA,cAGC,GAAA,SAAY,OAAA,CAAQ,aAAA,aAA0B,OAAA;EAAA,OAAA,EAG7B,UAAA;EAAA,IAAA;EAAA,YAAA,OAAA,GAAA,UAAA;EAAA;;;;EAAA,QAAA,MAAA;EAAA;;;;EAAA,YAAA,QAAA;EAAA;;;EAAA,QAAA,OAAA;EAAA;;;;EAAA,QAAA,oBAAA;EAAA;;;;;;;EAAA,MAAA,MAAA,EAwDd,SAAA,EAAA,IAAA,WAAA,OAAA,GAAoC,YAAA;EAAA;;;;;EAAA,UAAA,SAAA,mBAyFZ,SAAA;EAAA;;;EAAA,cAAA;EAAA;;;;;;;EAAA,QAAA,IAAA,UAAA,SAAA;EAAA;;;;;;EAAA,UAAA,IAAA,UAAA,SAAA;EAAA,YAAA,GA2DjB,OAAA;IAAA,IAAA;IAAA,IAAA;IAAA,SAAA;IAAA,WAAA;IAAA,MAAA,EAMT,SAAA;EAAA;EAAA;;;;EAAA,QAAA,sBAAA;EAAA;;;EAAA,QAAA,sBAAA;EAAA,KAAA,IAAA,UAAA,OAAA,GAqFsB,kBAAA,GAA0B,OAAA,CAAQ,iBAAA;EAAA,QAAA,KAAA;EAAA,KAAA,IAAA,UAAA,QAAA,GA6GhC,cAAA,GAAiB,OAAA,CAAQ,aAAA;EAAA,MAAA,IAAA,UAAA,OAAA,EAyBlD,oBAAA,EAAA,OAAA,GACC,eAAA,GACT,OAAA,CAAQ,cAAA;EAAA,OAAA,IAAA,UAAA,OAAA,GAuB0B,gBAAA,GAAmB,OAAA,CAAQ,eAAA;EAAA,OAAA,OAAA,UAAA,OAAA,UAAA,OAAA,GAkBpD,gBAAA,GACT,OAAA,CAAQ,eAAA;EAAA,OAAA,IAAA,UAAA,KAAA,UAAA,OAAA,GAsCA,oBAAA,GACR,OAAA,CAAQ,mBAAA;EAAA,QAAA,iBAAA;EAAA,QAAA,OAAA;EAAA,QAAA,OAAA;EAAA,KAAA,IAAA,UAAA,IAAA,EAsGH,MAAA,eAAA,OAAA,EACG,cAAA,GACR,OAAA,CAAQ,aAAA;EAAA,QAAA,mBAAA;EAAA,QAAA,aAAA;EAAA,QAAA,mBAAA;EAAA,QAAA,YAAA;EAAA,uBAAA,GAoFqB,OAAA;EAAA,oBAAA,GAuBH,OAAA;AAAA"}

package/dist/afs.d.mts

@@ -2,6 +2,26 @@ import { AFSContext, AFSDeleteOptions, AFSDeleteResult, AFSExecOptions, AFSExecR
 import { Emitter } from "strict-event-emitter";
 
 //#region src/afs.d.ts
+/**
+ * Information about a mounted module
+ */
+interface MountInfo {
+  /** The namespace (null for default namespace) */
+  namespace: string | null;
+  /** The mount path within the namespace */
+  path: string;
+  /** The mounted module */
+  module: AFSModule;
+}
+/**
+ * Options for mounting a module
+ */
+interface MountOptions {
+  /** Namespace to mount into (null/undefined for default namespace) */
+  namespace?: string | null;
+  /** Replace existing mount at the same path */
+  replace?: boolean;
+}
 interface AFSOptions {
   modules?: AFSModule[];
   context?: AFSContext;
@@ -10,19 +30,74 @@ declare class AFS extends Emitter<AFSRootEvents> implements AFSRoot {
   options: AFSOptions;
   name: string;
   constructor(options?: AFSOptions);
-  private modules;
+  /**
+       * Internal storage: Map<compositeKey, MountEntry>
+       * compositeKey = `${namespace ?? ""}:${path}`
+       */
+  private mounts;
+  /**
+       * Legacy compatibility: Map<path, AFSModule> for modules mounted via old API
+       * This is used internally by findModules for backward compatibility
+       */
+  private get modules();
+  /**
+       * Create composite key for mount storage
+       */
+  private makeKey;
   /**
        * Check if write operations are allowed for the given module.
        * Throws AFSReadonlyError if not allowed.
        */
   private checkWritePermission;
-  mount(module: AFSModule): this;
+  /**
+       * Mount a module at a path in a namespace
+       *
+       * @param module - The module to mount
+       * @param path - The path to mount at (optional, defaults to /modules/{module.name} for backward compatibility)
+       * @param options - Mount options (namespace, replace)
+       */
+  mount(module: AFSModule, path?: string, options?: MountOptions): this;
+  /**
+       * Get all mounts, optionally filtered by namespace
+       *
+       * @param namespace - Filter by namespace (undefined = all, null = default only)
+       */
+  getMounts(namespace?: string | null): MountInfo[];
+  /**
+       * Get all unique namespaces that have mounts
+       */
+  getNamespaces(): (string | null)[];
+  /**
+       * Unmount a module at a path in a namespace
+       *
+       * @param path - The path to unmount
+       * @param namespace - The namespace (undefined/null for default namespace)
+       * @returns true if unmounted, false if not found
+       */
+  unmount(path: string, namespace?: string | null): boolean;
+  /**
+       * Check if a path is mounted in a namespace
+       *
+       * @param path - The path to check
+       * @param namespace - The namespace (undefined/null for default namespace)
+       */
+  isMounted(path: string, namespace?: string | null): boolean;
   listModules(): Promise<{
     name: string;
     path: string;
+    namespace: string | null;
     description?: string;
     module: AFSModule;
   }[]>;
+  /**
+       * Parse a path and extract namespace if it's a canonical path
+       * Returns the namespace and the path within the namespace
+       */
+  private parsePathWithNamespace;
+  /**
+       * Find modules that can handle a path in a specific namespace
+       */
+  private findModulesInNamespace;
   list(path: string, options?: AFSRootListOptions): Promise<AFSRootListResult>;
   private _list;
   read(path: string, _options?: AFSReadOptions): Promise<AFSReadResult>;
@@ -33,7 +108,6 @@ declare class AFS extends Emitter<AFSRootEvents> implements AFSRoot {
   private processWithPreset;
   private _select;
   private _search;
-  private findModules;
   exec(path: string, args: Record<string, any>, options: AFSExecOptions): Promise<AFSExecResult>;
   private buildSimpleListView;
   private buildTreeView;
@@ -43,5 +117,5 @@ declare class AFS extends Emitter<AFSRootEvents> implements AFSRoot {
   cleanupPhysicalPath(): Promise<void>;
 }
 //#endregion
-export { AFS, AFSOptions };
+export { AFS, AFSOptions, MountInfo, MountOptions };
 //# sourceMappingURL=afs.d.mts.map

package/dist/afs.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"afs.d.mts","names":[],"sources":["../src/afs.ts"],"mappings":";;;;UAqCiB,UAAA;EAAA,OAAA,GACL,SAAA;EAAA,OAAA,GACA,UAAA;AAAA;AAAA,cAGC,GAAA,SAAY,OAAA,CAAQ,aAAA,aAA0B,OAAA;EAAA,OAAA,EAG7B,UAAA;EAAA,IAAA;EAAA,YAAA,OAAA,GAAA,UAAA;EAAA,QAAA,OAAA;EAAA;;;;EAAA,QAAA,oBAAA;EAAA,MAAA,MAAA,EAuBd,SAAA;EAAA,YAAA,GAiBO,OAAA;IAAA,IAAA;IAAA,IAAA;IAAA,WAAA;IAAA,MAAA,EACyC,SAAA;EAAA;EAAA,KAAA,IAAA,UAAA,OAAA,GAU5B,kBAAA,GAA0B,OAAA,CAAQ,iBAAA;EAAA,QAAA,KAAA;EAAA,KAAA,IAAA,UAAA,QAAA,GAiFhC,cAAA,GAAiB,OAAA,CAAQ,aAAA;EAAA,MAAA,IAAA,UAAA,OAAA,EAsBlD,oBAAA,EAAA,OAAA,GACC,eAAA,GACT,OAAA,CAAQ,cAAA;EAAA,OAAA,IAAA,UAAA,OAAA,GAiB0B,gBAAA,GAAmB,OAAA,CAAQ,eAAA;EAAA,OAAA,OAAA,UAAA,OAAA,UAAA,OAAA,GAYpD,gBAAA,GACT,OAAA,CAAQ,eAAA;EAAA,OAAA,IAAA,UAAA,KAAA,UAAA,OAAA,GAuBA,oBAAA,GACR,OAAA,CAAQ,mBAAA;EAAA,QAAA,iBAAA;EAAA,QAAA,OAAA;EAAA,QAAA,OAAA;EAAA,QAAA,WAAA;EAAA,KAAA,IAAA,UAAA,IAAA,EAoJH,MAAA,eAAA,OAAA,EACG,cAAA,GACR,OAAA,CAAQ,aAAA;EAAA,QAAA,mBAAA;EAAA,QAAA,aAAA;EAAA,QAAA,mBAAA;EAAA,QAAA,YAAA;EAAA,uBAAA,GA8EqB,OAAA;EAAA,oBAAA,GAqBH,OAAA;AAAA"}
+{"version":3,"file":"afs.d.mts","names":[],"sources":["../src/afs.ts"],"mappings":";;;;;AA+EA;AAYA;UAZiB,SAAA;EAAA;EAAA,SAAA;EAAA;EAAA,IAAA;EAAA;EAAA,MAAA,EAMP,SAAA;AAAA;AAAA;AAMV;AAgBA;AAtBU,UAMO,YAAA;EAAA;EAAA,SAAA;EAAA;EAAA,OAAA;AAAA;AAAA,UAgBA,UAAA;EAAA,OAAA,GACL,SAAA;EAAA,OAAA,GACA,UAAA;AAAA;AAAA,cAGC,GAAA,SAAY,OAAA,CAAQ,aAAA,aAA0B,OAAA;EAAA,OAAA,EAG7B,UAAA;EAAA,IAAA;EAAA,YAAA,OAAA,GAAA,UAAA;EAAA;;;;EAAA,QAAA,MAAA;EAAA;;;;EAAA,YAAA,QAAA;EAAA;;;EAAA,QAAA,OAAA;EAAA;;;;EAAA,QAAA,oBAAA;EAAA;;;;;;;EAAA,MAAA,MAAA,EAwDd,SAAA,EAAA,IAAA,WAAA,OAAA,GAAoC,YAAA;EAAA;;;;;EAAA,UAAA,SAAA,mBAyFZ,SAAA;EAAA;;;EAAA,cAAA;EAAA;;;;;;;EAAA,QAAA,IAAA,UAAA,SAAA;EAAA;;;;;;EAAA,UAAA,IAAA,UAAA,SAAA;EAAA,YAAA,GA2DjB,OAAA;IAAA,IAAA;IAAA,IAAA;IAAA,SAAA;IAAA,WAAA;IAAA,MAAA,EAMT,SAAA;EAAA;EAAA;;;;EAAA,QAAA,sBAAA;EAAA;;;EAAA,QAAA,sBAAA;EAAA,KAAA,IAAA,UAAA,OAAA,GAqFsB,kBAAA,GAA0B,OAAA,CAAQ,iBAAA;EAAA,QAAA,KAAA;EAAA,KAAA,IAAA,UAAA,QAAA,GA6GhC,cAAA,GAAiB,OAAA,CAAQ,aAAA;EAAA,MAAA,IAAA,UAAA,OAAA,EAyBlD,oBAAA,EAAA,OAAA,GACC,eAAA,GACT,OAAA,CAAQ,cAAA;EAAA,OAAA,IAAA,UAAA,OAAA,GAuB0B,gBAAA,GAAmB,OAAA,CAAQ,eAAA;EAAA,OAAA,OAAA,UAAA,OAAA,UAAA,OAAA,GAkBpD,gBAAA,GACT,OAAA,CAAQ,eAAA;EAAA,OAAA,IAAA,UAAA,KAAA,UAAA,OAAA,GAsCA,oBAAA,GACR,OAAA,CAAQ,mBAAA;EAAA,QAAA,iBAAA;EAAA,QAAA,OAAA;EAAA,QAAA,OAAA;EAAA,KAAA,IAAA,UAAA,IAAA,EAsGH,MAAA,eAAA,OAAA,EACG,cAAA,GACR,OAAA,CAAQ,aAAA;EAAA,QAAA,mBAAA;EAAA,QAAA,aAAA;EAAA,QAAA,mBAAA;EAAA,QAAA,YAAA;EAAA,uBAAA,GAoFqB,OAAA;EAAA,oBAAA,GAuBH,OAAA;AAAA"}