@aigne/afs-fs 1.11.0-beta.11 → 1.11.0-beta.12

package/dist/index.cjs

@@ -9,6 +9,7 @@ let node_os = require("node:os");
 let node_path = require("node:path");
 let _aigne_afs = require("@aigne/afs");
 let _aigne_afs_utils_zod = require("@aigne/afs/utils/zod");
+let _aigne_afs_provider_utils = require("@aigne/afs-provider-utils");
 let ignore = require("ignore");
 ignore = require_rolldown_runtime.__toESM(ignore);
 let js_yaml = require("js-yaml");
@@ -53,7 +54,49 @@ var AFSFS = class AFSFS extends _aigne_afs.AFSBaseProvider {
 			uriTemplate: "fs://{localPath+}",
 			category: "storage",
 			schema: zod.z.object({ localPath: zod.z.string() }),
-			tags: ["local", "filesystem"]
+			tags: ["local", "filesystem"],
+			capabilityTags: [
+				"read-write",
+				"crud",
+				"search",
+				"auth:none",
+				"local"
+			],
+			security: {
+				riskLevel: "local",
+				resourceAccess: ["local-filesystem"],
+				dataSensitivity: ["code"],
+				notes: ["Exposes a local directory — scope is limited to the configured localPath"]
+			},
+			capabilities: { filesystem: {
+				read: true,
+				write: true,
+				allowedPaths: ["${localPath}/**"]
+			} }
+		};
+	}
+	static treeSchema() {
+		return {
+			operations: [
+				"list",
+				"read",
+				"write",
+				"delete",
+				"search",
+				"stat",
+				"explain"
+			],
+			tree: {
+				"/": { kind: "fs:directory" },
+				"/{path}": { kind: "fs:file" }
+			},
+			auth: { type: "none" },
+			bestFor: [
+				"local file access",
+				"project source code",
+				"config files"
+			],
+			notFor: ["remote storage", "large binary files"]
 		};
 	}
 	static async load({ basePath, config } = {}) {
@@ -69,14 +112,7 @@ var AFSFS = class AFSFS extends _aigne_afs.AFSBaseProvider {
 		super();
 		this.options = options;
 		(0, _aigne_afs_utils_zod.zodParse)(afsFSOptionsSchema, options);
-		let localPath;
-		if (options.localPath === ".") localPath = process.cwd();
-		else {
-			localPath = options.localPath.replaceAll("${CWD}", process.cwd());
-			if (localPath.startsWith("~/")) localPath = (0, node_path.join)(process.env.HOME || "", localPath.slice(2));
-			if (!(0, node_path.isAbsolute)(localPath)) localPath = (0, node_path.join)(options.cwd || process.cwd(), localPath);
-		}
-		if (!(0, node_fs.existsSync)(localPath)) (0, node_fs.mkdirSync)(localPath, { recursive: true });
+		const localPath = (0, _aigne_afs_provider_utils.resolveLocalPath)(options.localPath, { cwd: options.cwd });
 		this.name = options.name || (0, node_path.basename)(localPath) || "fs";
 		this.description = options.description;
 		this.agentSkills = options.agentSkills;
@@ -86,62 +122,51 @@ var AFSFS = class AFSFS extends _aigne_afs.AFSBaseProvider {
 		this.useAfsignore = options.useAfsignore ?? true;
 	}
 	agentSkills;
+	afsRoot;
+	onMount(afs) {
+		this.afsRoot = afs;
+		this.scanAshScripts().catch(() => {});
+	}
+	/** Recursively scan for .ash files and emit script:registered events */
+	async scanAshScripts(dir) {
+		const scanDir = dir ?? this.options.localPath;
+		let items;
+		try {
+			items = await (0, node_fs_promises.readdir)(scanDir);
+		} catch {
+			return;
+		}
+		for (const item of items) {
+			if (this.isHiddenAfsDir(item)) continue;
+			const fullPath = (0, node_path.join)(scanDir, item);
+			try {
+				if ((await (0, node_fs_promises.stat)(fullPath)).isDirectory()) await this.scanAshScripts(fullPath);
+				else if (item.endsWith(".ash")) {
+					const relPath = (0, node_path.join)("/", (0, node_path.relative)(this.options.localPath, fullPath));
+					this.emit({
+						type: "script:registered",
+						path: relPath,
+						data: { runtime: "ash" }
+					});
+				}
+			} catch {}
+		}
+	}
+	async ready() {
+		const { localPath } = this.options;
+		if (!(0, node_fs.existsSync)(localPath)) (0, node_fs.mkdirSync)(localPath, { recursive: true });
+	}
 	/** Whether to apply .gitignore rules (default: false) */
 	useGitignore;
 	/** Whether to apply .afsignore rules (default: true) */
 	useAfsignore;
+	async assertWithinMount(fullPath) {
+		return (0, _aigne_afs_provider_utils.assertPathWithinRoot)(fullPath, this.options.localPath);
+	}
 	get localPathExists() {
 		return (0, node_fs_promises.stat)(this.options.localPath).then(() => true).catch(() => false);
 	}
 	/**
-	* Detect MIME type based on file extension
-	*/
-	getMimeType(filePath) {
-		return {
-			png: "image/png",
-			jpg: "image/jpeg",
-			jpeg: "image/jpeg",
-			gif: "image/gif",
-			bmp: "image/bmp",
-			webp: "image/webp",
-			svg: "image/svg+xml",
-			ico: "image/x-icon",
-			pdf: "application/pdf",
-			txt: "text/plain",
-			md: "text/markdown",
-			js: "text/javascript",
-			ts: "text/typescript",
-			json: "application/json",
-			html: "text/html",
-			css: "text/css",
-			xml: "text/xml"
-		}[(0, node_path.basename)(filePath).split(".").pop()?.toLowerCase() || ""] || "application/octet-stream";
-	}
-	/**
-	* Check if file is likely binary based on extension
-	*/
-	isBinaryFile(filePath) {
-		const ext = (0, node_path.basename)(filePath).split(".").pop()?.toLowerCase();
-		return [
-			"png",
-			"jpg",
-			"jpeg",
-			"gif",
-			"bmp",
-			"webp",
-			"ico",
-			"pdf",
-			"zip",
-			"tar",
-			"gz",
-			"exe",
-			"dll",
-			"so",
-			"dylib",
-			"wasm"
-		].includes(ext || "");
-	}
-	/**
 	* Check if a segment is the hidden .afs directory
 	*/
 	isHiddenAfsDir(segment) {
@@ -272,7 +297,7 @@ var AFSFS = class AFSFS extends _aigne_afs.AFSBaseProvider {
 		for (const childName of itemsToProcess) {
 			if (entries.length >= limit) break;
 			const childFullPath = (0, node_path.join)(fullPath, childName);
-			const childRelativePath = (0, node_path.join)(path, childName);
+			const childRelativePath = (0, ufo.joinURL)(path, childName);
 			const itemRelativePath = (0, node_path.relative)(ignoreBase, childFullPath);
 			let isIgnored = false;
 			if (this.isIgnoredByMountPatterns(itemRelativePath, mountIgnorePatterns)) isIgnored = true;
@@ -306,7 +331,7 @@ var AFSFS = class AFSFS extends _aigne_afs.AFSBaseProvider {
 				size: childStats.size,
 				kind: nodeMeta?.kind ?? (childIsDirectory ? "fs:directory" : "fs:file")
 			};
-			if (!childIsDirectory) meta.mimeType = this.getMimeType(childFullPath);
+			if (!childIsDirectory) meta.mimeType = (0, _aigne_afs_provider_utils.getMimeType)(childFullPath);
 			const entry = {
 				id: childRelativePath,
 				path: childRelativePath,
@@ -336,6 +361,7 @@ var AFSFS = class AFSFS extends _aigne_afs.AFSBaseProvider {
 				stats = mountStats;
 			} else {
 				fullPath = (0, node_path.join)(mountRoot, path);
+				await this.assertWithinMount(fullPath);
 				stats = await (0, node_fs_promises.stat)(fullPath);
 			}
 		} catch (error) {
@@ -350,8 +376,8 @@ var AFSFS = class AFSFS extends _aigne_afs.AFSBaseProvider {
 		};
 		if (stats.isDirectory()) meta.childrenCount = (await (0, node_fs_promises.readdir)(fullPath)).filter((c) => !this.isHiddenAfsDir(c)).length;
 		else if (stats.isFile()) {
-			const mimeType = this.getMimeType(fullPath);
-			const isBinary = this.isBinaryFile(fullPath);
+			const mimeType = (0, _aigne_afs_provider_utils.getMimeType)(fullPath);
+			const isBinary = (0, _aigne_afs_provider_utils.isBinaryFile)(fullPath);
 			meta.mimeType = mimeType;
 			if (isBinary) {
 				content = (await (0, node_fs_promises.readFile)(fullPath)).toString("base64");
@@ -372,7 +398,8 @@ var AFSFS = class AFSFS extends _aigne_afs.AFSBaseProvider {
 		const normalizedPath = (0, node_path.join)("/", path);
 		const options = ctx.options;
 		const fullPath = (0, node_path.join)(this.options.localPath, path);
-		const append = options?.append ?? false;
+		await this.assertWithinMount(fullPath);
+		const mode = options?.mode ?? "replace";
 		await (0, node_fs_promises.mkdir)((0, node_path.dirname)(fullPath), { recursive: true });
 		if (entry.content !== void 0) {
 			let contentToWrite;
@@ -380,7 +407,7 @@ var AFSFS = class AFSFS extends _aigne_afs.AFSBaseProvider {
 			else contentToWrite = JSON.stringify(entry.content, null, 2);
 			await (0, node_fs_promises.writeFile)(fullPath, contentToWrite, {
 				encoding: "utf8",
-				flag: append ? "a" : "w"
+				flag: mode === "append" ? "a" : "w"
 			});
 		}
 		if (entry.meta && Object.keys(entry.meta).length > 0) {
@@ -394,7 +421,7 @@ var AFSFS = class AFSFS extends _aigne_afs.AFSBaseProvider {
 			...meta,
 			size: stats.size
 		};
-		return { data: {
+		const writtenEntry = {
 			id: normalizedPath,
 			path: normalizedPath,
 			createdAt: stats.birthtime,
@@ -405,13 +432,20 @@ var AFSFS = class AFSFS extends _aigne_afs.AFSBaseProvider {
 			userId: entry.userId,
 			sessionId: entry.sessionId,
 			linkTo: entry.linkTo
-		} };
+		};
+		if (normalizedPath.endsWith(".ash")) this.emit({
+			type: "script:registered",
+			path: normalizedPath,
+			data: { runtime: "ash" }
+		});
+		return { data: writtenEntry };
 	}
 	async deleteHandler(ctx) {
 		const path = ctx.path;
 		const displayPath = path === "/" ? "/" : path.slice(1);
 		const options = ctx.options;
 		const fullPath = (0, node_path.join)(this.options.localPath, path);
+		await this.assertWithinMount(fullPath);
 		const recursive = options?.recursive ?? false;
 		let stats;
 		try {
@@ -420,10 +454,19 @@ var AFSFS = class AFSFS extends _aigne_afs.AFSBaseProvider {
 			wrapNotFoundError(error, path);
 		}
 		if (stats.isDirectory() && !recursive) throw new Error(`Cannot delete directory '${displayPath}' without recursive option. Set recursive: true to delete directories.`);
+		const isAshScript = !stats.isDirectory() && path.endsWith(".ash");
 		await (0, node_fs_promises.rm)(fullPath, {
 			recursive,
 			force: true
 		});
+		if (isAshScript) {
+			const normalizedPath = (0, node_path.join)("/", path);
+			this.emit({
+				type: "script:unregistered",
+				path: normalizedPath,
+				data: { runtime: "ash" }
+			});
+		}
 		return { message: `Successfully deleted: ${displayPath}` };
 	}
 	async renameHandler(ctx, newPath) {
@@ -432,6 +475,8 @@ var AFSFS = class AFSFS extends _aigne_afs.AFSBaseProvider {
 		const overwrite = ctx.options?.overwrite ?? false;
 		const oldFullPath = (0, node_path.join)(this.options.localPath, oldPath);
 		const newFullPath = (0, node_path.join)(this.options.localPath, newPath);
+		await this.assertWithinMount(oldFullPath);
+		await this.assertWithinMount(newFullPath);
 		try {
 			await (0, node_fs_promises.stat)(oldFullPath);
 		} catch (error) {
@@ -466,7 +511,7 @@ var AFSFS = class AFSFS extends _aigne_afs.AFSBaseProvider {
 		let hasMoreFiles = false;
 		for (const match of matches) if (match.type === "match" && match.data.path) {
 			const absolutePath = match.data.path.text;
-			const itemRelativePath = (0, node_path.join)(path, (0, node_path.relative)(basePath, absolutePath));
+			const itemRelativePath = (0, ufo.joinURL)(path, (0, node_path.relative)(basePath, absolutePath));
 			const pathFromRoot = (0, node_path.relative)(mountRoot, absolutePath);
 			if (this.isIgnoredByMountPatterns(pathFromRoot, mountIgnorePatterns)) continue;
 			if (ig && (ig.ignores(pathFromRoot) || ig.ignores(`${pathFromRoot}/`))) continue;
@@ -807,6 +852,57 @@ var AFSFS = class AFSFS extends _aigne_afs.AFSBaseProvider {
 			};
 		}
 	}
+	async execHandler(ctx, args) {
+		const path = ctx.path;
+		if (path.includes("/.actions/")) throw new Error(`No actions available for path: ${path}`);
+		if (!path.endsWith(".ash")) return {
+			success: false,
+			error: {
+				code: "UNSUPPORTED",
+				message: `Exec not supported for non-.ash files: ${path}`
+			}
+		};
+		const fullPath = (0, node_path.join)(this.options.localPath, path);
+		await this.assertWithinMount(fullPath);
+		let source;
+		try {
+			source = await (0, node_fs_promises.readFile)(fullPath, "utf-8");
+		} catch (error) {
+			wrapNotFoundError(error, path);
+		}
+		const afs = this.afsRoot;
+		if (!afs?.exec) return {
+			success: false,
+			error: {
+				code: "ASH_UNAVAILABLE",
+				message: "ASH provider is not mounted or does not support exec"
+			}
+		};
+		const ashRunPath = this.resolveAshRunPath();
+		if (!ashRunPath) return {
+			success: false,
+			error: {
+				code: "ASH_UNAVAILABLE",
+				message: "ASH provider not found. No provider with URI 'ash://' is mounted."
+			}
+		};
+		const ashArgs = {
+			...args,
+			source
+		};
+		return afs.exec(ashRunPath, ashArgs, {});
+	}
+	/**
+	* Resolve the ASH run action path by finding the ASH provider via URI.
+	* Returns the full path to /.actions/run on the ASH provider, or undefined if not found.
+	*/
+	resolveAshRunPath() {
+		const afs = this.afsRoot;
+		if (!afs) return void 0;
+		const matches = (0, _aigne_afs.findMountByURI)(afs, "ash://");
+		if (matches.length !== 1) return void 0;
+		return (0, ufo.joinURL)(matches[0].path, ".actions", "run");
+	}
 	/**
 	* Recursively collect files for archiving.
 	* Excludes .afs directories and respects optional glob pattern.
@@ -1094,6 +1190,7 @@ require_decorate.__decorate([(0, _aigne_afs.Explain)("/:path*")], AFSFS.prototyp
 require_decorate.__decorate([(0, _aigne_afs.Read)("/.meta/.capabilities")], AFSFS.prototype, "readCapabilitiesHandler", null);
 require_decorate.__decorate([_aigne_afs.Actions.Exec("/:path*", "archive")], AFSFS.prototype, "archiveAction", null);
 require_decorate.__decorate([_aigne_afs.Actions.Exec("/:path*", "checksum")], AFSFS.prototype, "checksumAction", null);
+require_decorate.__decorate([(0, _aigne_afs.Exec)("/:path*")], AFSFS.prototype, "execHandler", null);
 var src_default = AFSFS;
 
 //#endregion

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { AFSAccessMode, AFSBaseProvider, AFSDeleteResult, AFSEntry, AFSExecResult, AFSExplainResult, AFSModuleLoadParams, AFSRenameResult, AFSSearchOptions, AFSSearchResult, AFSStatResult, AFSWriteEntryPayload, AFSWriteResult, ProviderManifest, RouteContext } from "@aigne/afs";
+import { AFSAccessMode, AFSBaseProvider, AFSDeleteResult, AFSEntry, AFSExecResult, AFSExplainResult, AFSModuleLoadParams, AFSRenameResult, AFSRoot, AFSSearchOptions, AFSSearchResult, AFSStatResult, AFSWriteEntryPayload, AFSWriteResult, ProviderManifest, ProviderTreeSchema, RouteContext } from "@aigne/afs";
 import { z } from "zod";
 
 //#region src/index.d.ts
@@ -55,6 +55,7 @@ declare class AFSFS extends AFSBaseProvider {
     agentSkills: boolean | undefined;
   }, unknown>>;
   static manifest(): ProviderManifest;
+  static treeSchema(): ProviderTreeSchema;
   static load({
     basePath,
     config
@@ -66,19 +67,17 @@ declare class AFSFS extends AFSBaseProvider {
     cwd?: string;
   });
   agentSkills?: boolean;
+  private afsRoot?;
+  onMount(afs: AFSRoot): void;
+  /** Recursively scan for .ash files and emit script:registered events */
+  private scanAshScripts;
+  ready(): Promise<void>;
   /** Whether to apply .gitignore rules (default: false) */
   private useGitignore;
   /** Whether to apply .afsignore rules (default: true) */
   private useAfsignore;
+  private assertWithinMount;
   private get localPathExists();
-  /**
-   * Detect MIME type based on file extension
-   */
-  private getMimeType;
-  /**
-   * Check if file is likely binary based on extension
-   */
-  private isBinaryFile;
   /**
    * Check if a segment is the hidden .afs directory
    */
@@ -148,6 +147,14 @@ declare class AFSFS extends AFSBaseProvider {
   checksumAction(ctx: RouteContext<{
     path?: string;
   }>, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execHandler(ctx: RouteContext<{
+    path?: string;
+  }>, args: Record<string, unknown>): Promise<AFSExecResult>;
+  /**
+   * Resolve the ASH run action path by finding the ASH provider via URI.
+   * Returns the full path to /.actions/run on the ASH provider, or undefined if not found.
+   */
+  private resolveAshRunPath;
   /**
    * Recursively collect files for archiving.
    * Excludes .afs directories and respects optional glob pattern.

package/dist/index.d.cts.map

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

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { AFSAccessMode, AFSBaseProvider, AFSDeleteResult, AFSEntry, AFSExecResult, AFSExplainResult, AFSModuleLoadParams, AFSRenameResult, AFSSearchOptions, AFSSearchResult, AFSStatResult, AFSWriteEntryPayload, AFSWriteResult, ProviderManifest, RouteContext } from "@aigne/afs";
+import { AFSAccessMode, AFSBaseProvider, AFSDeleteResult, AFSEntry, AFSExecResult, AFSExplainResult, AFSModuleLoadParams, AFSRenameResult, AFSRoot, AFSSearchOptions, AFSSearchResult, AFSStatResult, AFSWriteEntryPayload, AFSWriteResult, ProviderManifest, ProviderTreeSchema, RouteContext } from "@aigne/afs";
 import { z } from "zod";
 
 //#region src/index.d.ts
@@ -55,6 +55,7 @@ declare class AFSFS extends AFSBaseProvider {
     agentSkills: boolean | undefined;
   }, unknown>>;
   static manifest(): ProviderManifest;
+  static treeSchema(): ProviderTreeSchema;
   static load({
     basePath,
     config
@@ -66,19 +67,17 @@ declare class AFSFS extends AFSBaseProvider {
     cwd?: string;
   });
   agentSkills?: boolean;
+  private afsRoot?;
+  onMount(afs: AFSRoot): void;
+  /** Recursively scan for .ash files and emit script:registered events */
+  private scanAshScripts;
+  ready(): Promise<void>;
   /** Whether to apply .gitignore rules (default: false) */
   private useGitignore;
   /** Whether to apply .afsignore rules (default: true) */
   private useAfsignore;
+  private assertWithinMount;
   private get localPathExists();
-  /**
-   * Detect MIME type based on file extension
-   */
-  private getMimeType;
-  /**
-   * Check if file is likely binary based on extension
-   */
-  private isBinaryFile;
   /**
    * Check if a segment is the hidden .afs directory
    */
@@ -148,6 +147,14 @@ declare class AFSFS extends AFSBaseProvider {
   checksumAction(ctx: RouteContext<{
     path?: string;
   }>, args: Record<string, unknown>): Promise<AFSExecResult>;
+  execHandler(ctx: RouteContext<{
+    path?: string;
+  }>, args: Record<string, unknown>): Promise<AFSExecResult>;
+  /**
+   * Resolve the ASH run action path by finding the ASH provider via URI.
+   * Returns the full path to /.actions/run on the ASH provider, or undefined if not found.
+   */
+  private resolveAshRunPath;
   /**
    * Recursively collect files for archiving.
    * Excludes .afs directories and respects optional glob pattern.

package/dist/index.d.mts.map

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