@aigne/afs-cli 1.11.0-beta.5 → 1.11.0-beta.7

package/dist/core/index.mjs

@@ -0,0 +1,24 @@
+import { formatDeleteOutput } from "./formatters/delete.mjs";
+import { formatExecOutput } from "./formatters/exec.mjs";
+import { formatExplainOutput } from "./formatters/explain.mjs";
+import { formatLsOutput } from "./formatters/ls.mjs";
+import { formatMountListOutput } from "./formatters/mount.mjs";
+import { formatReadOutput } from "./formatters/read.mjs";
+import { formatStatOutput } from "./formatters/stat.mjs";
+import { formatWriteOutput } from "./formatters/write.mjs";
+import { cliPathToCanonical, parseCliPath } from "../path-utils.mjs";
+import "./path-utils.mjs";
+import { createDeleteCommand } from "./commands/delete.mjs";
+import { readStdin } from "./helpers/stdin.mjs";
+import { RESERVED_OPTIONS, parseExecArgs, parseExecArgsWithStdin, parseValueBySchema, schemaTypeToYargs } from "./helpers/exec-args.mjs";
+import { createExecCommand } from "./commands/exec.mjs";
+import { createExplainCommand } from "./commands/explain.mjs";
+import { createLsCommand } from "./commands/ls.mjs";
+import { createMountCommand } from "./commands/mount.mjs";
+import { createReadCommand } from "./commands/read.mjs";
+import { createStatCommand } from "./commands/stat.mjs";
+import { createWriteCommand } from "./commands/write.mjs";
+import { commandFactories } from "./commands/index.mjs";
+import { AFSCommandExecutor } from "./executor/index.mjs";
+
+export { AFSCommandExecutor, RESERVED_OPTIONS, cliPathToCanonical, commandFactories, createDeleteCommand, createExecCommand, createExplainCommand, createLsCommand, createMountCommand, createReadCommand, createStatCommand, createWriteCommand, formatDeleteOutput, formatExecOutput, formatExplainOutput, formatLsOutput, formatMountListOutput, formatReadOutput, formatStatOutput, formatWriteOutput, parseCliPath, parseExecArgs, parseExecArgsWithStdin, parseValueBySchema, readStdin, schemaTypeToYargs };

package/dist/core/path-utils.cjs

@@ -0,0 +1 @@
+const require_path_utils = require('../path-utils.cjs');

package/dist/core/path-utils.mjs

@@ -0,0 +1,3 @@
+import { cliPathToCanonical, parseCliPath } from "../path-utils.mjs";
+
+export {  };

package/dist/core/types.d.cts

@@ -0,0 +1,24 @@
+//#region src/core/types.d.ts
+/**
+ * CLI Core Types
+ *
+ * Minimal type definitions for the core CLI layer.
+ * Uses AFS native types (AFSListResult, AFSReadResult, etc.) directly.
+ */
+type ViewType = "default" | "json" | "yaml" | "llm" | "human";
+/**
+ * Simplified JSON Schema type for CLI parameter parsing
+ */
+interface JSONSchema {
+  type?: "string" | "number" | "integer" | "boolean" | "array" | "object" | "null";
+  properties?: Record<string, JSONSchema>;
+  items?: JSONSchema;
+  required?: string[];
+  description?: string;
+  default?: unknown;
+  enum?: unknown[];
+  [key: string]: unknown;
+}
+//#endregion
+export { JSONSchema, ViewType };
+//# sourceMappingURL=types.d.cts.map

package/dist/core/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/core/types.ts"],"mappings":";;AAWA;;;;;KAAY,QAAA;;;;UASK,UAAA;EACf,IAAA;EACA,UAAA,GAAa,MAAA,SAAe,UAAA;EAC5B,KAAA,GAAQ,UAAA;EACR,QAAA;EACA,WAAA;EACA,OAAA;EACA,IAAA;EAAA,CACC,GAAA;AAAA"}

package/dist/core/types.d.mts

@@ -0,0 +1,24 @@
+//#region src/core/types.d.ts
+/**
+ * CLI Core Types
+ *
+ * Minimal type definitions for the core CLI layer.
+ * Uses AFS native types (AFSListResult, AFSReadResult, etc.) directly.
+ */
+type ViewType = "default" | "json" | "yaml" | "llm" | "human";
+/**
+ * Simplified JSON Schema type for CLI parameter parsing
+ */
+interface JSONSchema {
+  type?: "string" | "number" | "integer" | "boolean" | "array" | "object" | "null";
+  properties?: Record<string, JSONSchema>;
+  items?: JSONSchema;
+  required?: string[];
+  description?: string;
+  default?: unknown;
+  enum?: unknown[];
+  [key: string]: unknown;
+}
+//#endregion
+export { JSONSchema, ViewType };
+//# sourceMappingURL=types.d.mts.map

package/dist/core/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/core/types.ts"],"mappings":";;AAWA;;;;;KAAY,QAAA;;;;UASK,UAAA;EACf,IAAA;EACA,UAAA,GAAa,MAAA,SAAe,UAAA;EAC5B,KAAA,GAAQ,UAAA;EACR,QAAA;EACA,WAAA;EACA,OAAA;EACA,IAAA;EAAA,CACC,GAAA;AAAA"}

package/dist/errors.cjs

@@ -13,17 +13,6 @@ const ExitCode = {
 	PARTIAL: 4,
 	RUNTIME_ERROR: 5
 };
-/**
-* CLI Error with exit code
-*/
-var CLIError = class extends Error {
-	constructor(message, exitCode = ExitCode.RUNTIME_ERROR) {
-		super(message);
-		this.exitCode = exitCode;
-		this.name = "CLIError";
-	}
-};
 
 //#endregion
-exports.CLIError = CLIError;
 exports.ExitCode = ExitCode;

package/dist/errors.mjs

@@ -12,17 +12,7 @@ const ExitCode = {
 	PARTIAL: 4,
 	RUNTIME_ERROR: 5
 };
-/**
-* CLI Error with exit code
-*/
-var CLIError = class extends Error {
-	constructor(message, exitCode = ExitCode.RUNTIME_ERROR) {
-		super(message);
-		this.exitCode = exitCode;
-		this.name = "CLIError";
-	}
-};
 
 //#endregion
-export { CLIError, ExitCode };
+export { ExitCode };
 //# sourceMappingURL=errors.mjs.map

package/dist/errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * AFS CLI Exit Codes\n *\n * Exit codes are part of the protocol - agents and scripts depend on them.\n */\nexport const ExitCode = {\n  /** Operation successful */\n  OK: 0,\n  /** Path or resource not found */\n  NOT_FOUND: 1,\n  /** Permission denied */\n  PERMISSION_DENIED: 2,\n  /** Conflict (e.g., concurrent modification) */\n  CONFLICT: 3,\n  /** Partial success (some operations succeeded, some failed) */\n  PARTIAL: 4,\n  /** Runtime error */\n  RUNTIME_ERROR: 5,\n} as const;\n\nexport type ExitCodeType = (typeof ExitCode)[keyof typeof ExitCode];\n\n/**\n * CLI Error with exit code\n */\nexport class CLIError extends Error {\n  constructor(\n    message: string,\n    public exitCode: ExitCodeType = ExitCode.RUNTIME_ERROR,\n  ) {\n    super(message);\n    this.name = \"CLIError\";\n  }\n}\n\n/**\n * Not found error\n */\nexport class NotFoundError extends CLIError {\n  constructor(message: string) {\n    super(message, ExitCode.NOT_FOUND);\n    this.name = \"NotFoundError\";\n  }\n}\n\n/**\n * Permission denied error\n */\nexport class PermissionDeniedError extends CLIError {\n  constructor(message: string) {\n    super(message, ExitCode.PERMISSION_DENIED);\n    this.name = \"PermissionDeniedError\";\n  }\n}\n"],"mappings":";;;;;;AAKA,MAAa,WAAW;CAEtB,IAAI;CAEJ,WAAW;CAEX,mBAAmB;CAEnB,UAAU;CAEV,SAAS;CAET,eAAe;CAChB;;;;AAOD,IAAa,WAAb,cAA8B,MAAM;CAClC,YACE,SACA,AAAO,WAAyB,SAAS,eACzC;AACA,QAAM,QAAQ;EAFP;AAGP,OAAK,OAAO"}
+{"version":3,"file":"errors.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * AFS CLI Exit Codes\n *\n * Exit codes are part of the protocol - agents and scripts depend on them.\n */\nexport const ExitCode = {\n  /** Operation successful */\n  OK: 0,\n  /** Path or resource not found */\n  NOT_FOUND: 1,\n  /** Permission denied */\n  PERMISSION_DENIED: 2,\n  /** Conflict (e.g., concurrent modification) */\n  CONFLICT: 3,\n  /** Partial success (some operations succeeded, some failed) */\n  PARTIAL: 4,\n  /** Runtime error */\n  RUNTIME_ERROR: 5,\n} as const;\n\nexport type ExitCodeType = (typeof ExitCode)[keyof typeof ExitCode];\n\n/**\n * CLI Error with exit code\n */\nexport class CLIError extends Error {\n  constructor(\n    message: string,\n    public exitCode: ExitCodeType = ExitCode.RUNTIME_ERROR,\n  ) {\n    super(message);\n    this.name = \"CLIError\";\n  }\n}\n\n/**\n * Not found error\n */\nexport class NotFoundError extends CLIError {\n  constructor(message: string) {\n    super(message, ExitCode.NOT_FOUND);\n    this.name = \"NotFoundError\";\n  }\n}\n\n/**\n * Permission denied error\n */\nexport class PermissionDeniedError extends CLIError {\n  constructor(message: string) {\n    super(message, ExitCode.PERMISSION_DENIED);\n    this.name = \"PermissionDeniedError\";\n  }\n}\n"],"mappings":";;;;;;AAKA,MAAa,WAAW;CAEtB,IAAI;CAEJ,WAAW;CAEX,mBAAmB;CAEnB,UAAU;CAEV,SAAS;CAET,eAAe;CAChB"}

package/dist/explorer/actions.cjs

@@ -1,17 +1,41 @@
 
 //#region src/explorer/actions.ts
 /**
+* Check if an entry is executable based on its meta
+*/
+function isExecutable(meta) {
+	if (!meta) return false;
+	if (Array.isArray(meta.kinds)) return meta.kinds.includes("afs:executable");
+	return meta.kind === "afs:executable";
+}
+/**
+* Check if a value is a valid directory-indicating childrenCount
+*
+* Per Provider Protocol spec:
+* - childrenCount > 0: known children → directory
+* - childrenCount = -1: unknown children count → directory
+* - childrenCount = 0 or undefined: leaf node → file
+*/
+function isDirectory(childrenCount) {
+	if (typeof childrenCount !== "number" || Number.isNaN(childrenCount)) return false;
+	return childrenCount === -1 || childrenCount > 0;
+}
+/**
 * Convert AFS entry to explorer entry
+*
+* Type determination priority:
+* 1. afs:executable → exec
+* 2. afs:link → link
+* 3. childrenCount > 0 or -1 → directory
+* 4. Otherwise (childrenCount = 0, undefined, invalid) → file
 */
 function toExplorerEntry(entry, _basePath) {
 	const name = entry.path.split("/").pop() || entry.path;
-	const metadata = entry.metadata || {};
-	const entryType = entry.type || metadata.type;
+	const metadata = entry.meta || {};
 	let type = "file";
-	if (entryType === "directory" || entryType === "module") type = "directory";
-	else if (entryType === "exec") type = "exec";
-	else if (entryType === "link") type = "link";
-	else if (metadata.childrenCount !== void 0 || entry.path === "/modules" || entry.path.startsWith("/modules/") && !entry.path.includes(".")) type = "directory";
+	if (isExecutable(metadata)) type = "exec";
+	else if (metadata.kind === "afs:link" || metadata.kinds?.includes("afs:link")) type = "link";
+	else if (isDirectory(metadata.childrenCount)) type = "directory";
 	return {
 		name,
 		path: entry.path,
@@ -21,7 +45,13 @@ function toExplorerEntry(entry, _basePath) {
 		childrenCount: metadata.childrenCount,
 		hash: metadata.hash,
 		description: metadata.description,
-		provider: metadata.provider
+		provider: metadata.provider,
+		icon: metadata.icon,
+		kind: metadata.kind,
+		kinds: Array.isArray(metadata.kinds) ? metadata.kinds : void 0,
+		label: metadata.label,
+		tags: Array.isArray(metadata.tags) ? metadata.tags : void 0,
+		actions: entry.actions
 	};
 }
 /**
@@ -35,20 +65,43 @@ function createUpEntry(parentPath) {
 	};
 }
 /**
+* Build immediate children from a list of deep paths
+* For example, if path is "/" and entries contain "/github/ArcBlock/afs",
+* this returns a virtual directory entry for "/github"
+*/
+function buildImmediateChildren(path, afsEntries) {
+	const normalizedPath = path === "/" ? "" : path;
+	const pathDepth = normalizedPath === "" ? 0 : normalizedPath.split("/").filter(Boolean).length;
+	const childrenMap = /* @__PURE__ */ new Map();
+	for (const entry of afsEntries) {
+		if (entry.path === path) continue;
+		const entryParts = entry.path.split("/").filter(Boolean);
+		const childName = entryParts[pathDepth];
+		if (!childName) continue;
+		const childPath = `/${entryParts.slice(0, pathDepth + 1).join("/")}`;
+		if (entryParts.length === pathDepth + 1) childrenMap.set(childName, toExplorerEntry(entry, path));
+		else if (!childrenMap.has(childName)) childrenMap.set(childName, {
+			name: childName,
+			path: childPath,
+			type: "directory",
+			childrenCount: -1
+		});
+	}
+	return childrenMap;
+}
+/**
 * Load directory entries from AFS
 */
-async function loadDirectory(runtime, path) {
+async function loadDirectory(afs, path) {
 	try {
-		const result = await runtime.list(path, { maxDepth: 1 });
+		const result = await afs.list(path, { maxDepth: 1 });
 		const entries = [];
 		if (path !== "/") {
 			const parentPath = path.split("/").slice(0, -1).join("/") || "/";
 			entries.push(createUpEntry(parentPath));
 		}
-		for (const entry of result.data) {
-			if (entry.path === path) continue;
-			entries.push(toExplorerEntry(entry, path));
-		}
+		const childrenMap = buildImmediateChildren(path, result.data);
+		entries.push(...childrenMap.values());
 		entries.sort((a, b) => {
 			if (a.type === "up") return -1;
 			if (b.type === "up") return 1;
@@ -67,37 +120,35 @@ async function loadDirectory(runtime, path) {
 	}
 }
 /**
-* Load metadata for an entry
+* Load metadata for an entry using stat() to get enriched data (including actions)
 */
-async function loadMetadata(runtime, entry) {
+async function loadMetadata(afs, entry) {
 	if (entry.type === "up") return;
 	try {
-		const afsEntry = (await runtime.list(entry.path, { maxDepth: 0 })).data[0];
-		if (!afsEntry) return {
+		const data = (await afs.stat(entry.path)).data;
+		if (!data) return {
 			path: entry.path,
-			type: entry.type,
 			size: entry.size,
 			modified: entry.modified
 		};
-		const metadata = afsEntry.metadata || {};
+		const meta = data.meta || {};
 		return {
 			path: entry.path,
-			type: entry.type,
-			size: metadata.size,
-			modified: afsEntry.updatedAt instanceof Date ? afsEntry.updatedAt : void 0,
-			childrenCount: metadata.childrenCount,
-			hash: metadata.hash,
-			description: metadata.description,
-			provider: metadata.provider,
-			mountPath: metadata.mountPath,
-			uri: metadata.uri,
-			permissions: metadata.permissions,
-			extra: metadata
+			size: meta.size,
+			modified: data.updatedAt instanceof Date ? data.updatedAt : void 0,
+			childrenCount: meta.childrenCount,
+			hash: meta.hash,
+			description: meta.description,
+			provider: meta.provider,
+			mountPath: meta.mountPath,
+			uri: meta.uri,
+			permissions: meta.permissions,
+			actions: data.actions,
+			extra: meta
 		};
 	} catch {
 		return {
 			path: entry.path,
-			type: entry.type,
 			size: entry.size,
 			modified: entry.modified
 		};
@@ -106,20 +157,17 @@ async function loadMetadata(runtime, entry) {
 /**
 * Get explain output for an entry
 */
-async function getExplain(runtime, path) {
+async function getExplain(afs, path) {
 	try {
-		const entry = (await runtime.list(path, { maxDepth: 0 })).data[0];
+		const entry = (await afs.list(path, { maxDepth: 0 })).data[0];
 		if (!entry) return {
 			content: "",
 			error: "Entry not found"
 		};
-		const metadata = entry.metadata || {};
+		const metadata = entry.meta || {};
 		const lines = [];
 		lines.push(`OBJECT ${path}`);
 		lines.push("");
-		lines.push("TYPE");
-		lines.push(metadata.type || "unknown");
-		lines.push("");
 		if (metadata.description) {
 			lines.push("DESCRIPTION");
 			lines.push(metadata.description);
@@ -156,31 +204,48 @@ async function getExplain(runtime, path) {
 /**
 * Execute an action on an entry
 *
-* Note: The AFSRuntime doesn't currently expose exec functionality.
-* This is a placeholder that returns a "not available" message.
+* For executable entries (kinds includes "afs:executable"), this calls
+* the underlying exec command. The action parameter is currently not used
+* but reserved for future action selection.
 */
-async function executeAction(_runtime, path, action, _params) {
-	return {
-		success: false,
-		message: `Action '${action}' on '${path}' is not available in the explorer`
-	};
+async function executeAction(afs, path, _action, params) {
+	try {
+		const result = await afs.exec(path, params || {}, {});
+		return {
+			success: result.success,
+			message: result.error?.message,
+			data: result.data
+		};
+	} catch (error) {
+		return {
+			success: false,
+			message: error instanceof Error ? error.message : String(error)
+		};
+	}
 }
 /**
 * Read file content
 */
-async function readFileContent(runtime, path) {
+async function readFileContent(afs, path) {
 	try {
-		const entry = (await runtime.read(path)).data;
+		const entry = (await afs.read(path)).data;
 		if (!entry) return {
 			content: "",
 			error: "File not found"
 		};
 		const rawContent = entry.content;
-		if (rawContent === void 0) return {
+		if (rawContent === void 0 || rawContent === null) return {
 			content: "",
 			error: "No content available"
 		};
-		return { content: typeof rawContent === "string" ? rawContent : Buffer.from(rawContent).toString("utf-8") };
+		let content;
+		if (typeof rawContent === "string") content = rawContent;
+		else if (Buffer.isBuffer(rawContent)) content = rawContent.toString("utf-8");
+		else if (rawContent instanceof Uint8Array) content = Buffer.from(rawContent).toString("utf-8");
+		else if (rawContent instanceof ArrayBuffer) content = Buffer.from(new Uint8Array(rawContent)).toString("utf-8");
+		else if (typeof rawContent === "object") content = JSON.stringify(rawContent, null, 2);
+		else content = String(rawContent);
+		return { content };
 	} catch (error) {
 		return {
 			content: "",

package/dist/explorer/actions.mjs

@@ -1,16 +1,40 @@
 //#region src/explorer/actions.ts
 /**
+* Check if an entry is executable based on its meta
+*/
+function isExecutable(meta) {
+	if (!meta) return false;
+	if (Array.isArray(meta.kinds)) return meta.kinds.includes("afs:executable");
+	return meta.kind === "afs:executable";
+}
+/**
+* Check if a value is a valid directory-indicating childrenCount
+*
+* Per Provider Protocol spec:
+* - childrenCount > 0: known children → directory
+* - childrenCount = -1: unknown children count → directory
+* - childrenCount = 0 or undefined: leaf node → file
+*/
+function isDirectory(childrenCount) {
+	if (typeof childrenCount !== "number" || Number.isNaN(childrenCount)) return false;
+	return childrenCount === -1 || childrenCount > 0;
+}
+/**
 * Convert AFS entry to explorer entry
+*
+* Type determination priority:
+* 1. afs:executable → exec
+* 2. afs:link → link
+* 3. childrenCount > 0 or -1 → directory
+* 4. Otherwise (childrenCount = 0, undefined, invalid) → file
 */
 function toExplorerEntry(entry, _basePath) {
 	const name = entry.path.split("/").pop() || entry.path;
-	const metadata = entry.metadata || {};
-	const entryType = entry.type || metadata.type;
+	const metadata = entry.meta || {};
 	let type = "file";
-	if (entryType === "directory" || entryType === "module") type = "directory";
-	else if (entryType === "exec") type = "exec";
-	else if (entryType === "link") type = "link";
-	else if (metadata.childrenCount !== void 0 || entry.path === "/modules" || entry.path.startsWith("/modules/") && !entry.path.includes(".")) type = "directory";
+	if (isExecutable(metadata)) type = "exec";
+	else if (metadata.kind === "afs:link" || metadata.kinds?.includes("afs:link")) type = "link";
+	else if (isDirectory(metadata.childrenCount)) type = "directory";
 	return {
 		name,
 		path: entry.path,
@@ -20,7 +44,13 @@ function toExplorerEntry(entry, _basePath) {
 		childrenCount: metadata.childrenCount,
 		hash: metadata.hash,
 		description: metadata.description,
-		provider: metadata.provider
+		provider: metadata.provider,
+		icon: metadata.icon,
+		kind: metadata.kind,
+		kinds: Array.isArray(metadata.kinds) ? metadata.kinds : void 0,
+		label: metadata.label,
+		tags: Array.isArray(metadata.tags) ? metadata.tags : void 0,
+		actions: entry.actions
 	};
 }
 /**
@@ -34,20 +64,43 @@ function createUpEntry(parentPath) {
 	};
 }
 /**
+* Build immediate children from a list of deep paths
+* For example, if path is "/" and entries contain "/github/ArcBlock/afs",
+* this returns a virtual directory entry for "/github"
+*/
+function buildImmediateChildren(path, afsEntries) {
+	const normalizedPath = path === "/" ? "" : path;
+	const pathDepth = normalizedPath === "" ? 0 : normalizedPath.split("/").filter(Boolean).length;
+	const childrenMap = /* @__PURE__ */ new Map();
+	for (const entry of afsEntries) {
+		if (entry.path === path) continue;
+		const entryParts = entry.path.split("/").filter(Boolean);
+		const childName = entryParts[pathDepth];
+		if (!childName) continue;
+		const childPath = `/${entryParts.slice(0, pathDepth + 1).join("/")}`;
+		if (entryParts.length === pathDepth + 1) childrenMap.set(childName, toExplorerEntry(entry, path));
+		else if (!childrenMap.has(childName)) childrenMap.set(childName, {
+			name: childName,
+			path: childPath,
+			type: "directory",
+			childrenCount: -1
+		});
+	}
+	return childrenMap;
+}
+/**
 * Load directory entries from AFS
 */
-async function loadDirectory(runtime, path) {
+async function loadDirectory(afs, path) {
 	try {
-		const result = await runtime.list(path, { maxDepth: 1 });
+		const result = await afs.list(path, { maxDepth: 1 });
 		const entries = [];
 		if (path !== "/") {
 			const parentPath = path.split("/").slice(0, -1).join("/") || "/";
 			entries.push(createUpEntry(parentPath));
 		}
-		for (const entry of result.data) {
-			if (entry.path === path) continue;
-			entries.push(toExplorerEntry(entry, path));
-		}
+		const childrenMap = buildImmediateChildren(path, result.data);
+		entries.push(...childrenMap.values());
 		entries.sort((a, b) => {
 			if (a.type === "up") return -1;
 			if (b.type === "up") return 1;
@@ -66,37 +119,35 @@ async function loadDirectory(runtime, path) {
 	}
 }
 /**
-* Load metadata for an entry
+* Load metadata for an entry using stat() to get enriched data (including actions)
 */
-async function loadMetadata(runtime, entry) {
+async function loadMetadata(afs, entry) {
 	if (entry.type === "up") return;
 	try {
-		const afsEntry = (await runtime.list(entry.path, { maxDepth: 0 })).data[0];
-		if (!afsEntry) return {
+		const data = (await afs.stat(entry.path)).data;
+		if (!data) return {
 			path: entry.path,
-			type: entry.type,
 			size: entry.size,
 			modified: entry.modified
 		};
-		const metadata = afsEntry.metadata || {};
+		const meta = data.meta || {};
 		return {
 			path: entry.path,
-			type: entry.type,
-			size: metadata.size,
-			modified: afsEntry.updatedAt instanceof Date ? afsEntry.updatedAt : void 0,
-			childrenCount: metadata.childrenCount,
-			hash: metadata.hash,
-			description: metadata.description,
-			provider: metadata.provider,
-			mountPath: metadata.mountPath,
-			uri: metadata.uri,
-			permissions: metadata.permissions,
-			extra: metadata
+			size: meta.size,
+			modified: data.updatedAt instanceof Date ? data.updatedAt : void 0,
+			childrenCount: meta.childrenCount,
+			hash: meta.hash,
+			description: meta.description,
+			provider: meta.provider,
+			mountPath: meta.mountPath,
+			uri: meta.uri,
+			permissions: meta.permissions,
+			actions: data.actions,
+			extra: meta
 		};
 	} catch {
 		return {
 			path: entry.path,
-			type: entry.type,
 			size: entry.size,
 			modified: entry.modified
 		};
@@ -105,20 +156,17 @@ async function loadMetadata(runtime, entry) {
 /**
 * Get explain output for an entry
 */
-async function getExplain(runtime, path) {
+async function getExplain(afs, path) {
 	try {
-		const entry = (await runtime.list(path, { maxDepth: 0 })).data[0];
+		const entry = (await afs.list(path, { maxDepth: 0 })).data[0];
 		if (!entry) return {
 			content: "",
 			error: "Entry not found"
 		};
-		const metadata = entry.metadata || {};
+		const metadata = entry.meta || {};
 		const lines = [];
 		lines.push(`OBJECT ${path}`);
 		lines.push("");
-		lines.push("TYPE");
-		lines.push(metadata.type || "unknown");
-		lines.push("");
 		if (metadata.description) {
 			lines.push("DESCRIPTION");
 			lines.push(metadata.description);
@@ -155,31 +203,48 @@ async function getExplain(runtime, path) {
 /**
 * Execute an action on an entry
 *
-* Note: The AFSRuntime doesn't currently expose exec functionality.
-* This is a placeholder that returns a "not available" message.
+* For executable entries (kinds includes "afs:executable"), this calls
+* the underlying exec command. The action parameter is currently not used
+* but reserved for future action selection.
 */
-async function executeAction(_runtime, path, action, _params) {
-	return {
-		success: false,
-		message: `Action '${action}' on '${path}' is not available in the explorer`
-	};
+async function executeAction(afs, path, _action, params) {
+	try {
+		const result = await afs.exec(path, params || {}, {});
+		return {
+			success: result.success,
+			message: result.error?.message,
+			data: result.data
+		};
+	} catch (error) {
+		return {
+			success: false,
+			message: error instanceof Error ? error.message : String(error)
+		};
+	}
 }
 /**
 * Read file content
 */
-async function readFileContent(runtime, path) {
+async function readFileContent(afs, path) {
 	try {
-		const entry = (await runtime.read(path)).data;
+		const entry = (await afs.read(path)).data;
 		if (!entry) return {
 			content: "",
 			error: "File not found"
 		};
 		const rawContent = entry.content;
-		if (rawContent === void 0) return {
+		if (rawContent === void 0 || rawContent === null) return {
 			content: "",
 			error: "No content available"
 		};
-		return { content: typeof rawContent === "string" ? rawContent : Buffer.from(rawContent).toString("utf-8") };
+		let content;
+		if (typeof rawContent === "string") content = rawContent;
+		else if (Buffer.isBuffer(rawContent)) content = rawContent.toString("utf-8");
+		else if (rawContent instanceof Uint8Array) content = Buffer.from(rawContent).toString("utf-8");
+		else if (rawContent instanceof ArrayBuffer) content = Buffer.from(new Uint8Array(rawContent)).toString("utf-8");
+		else if (typeof rawContent === "object") content = JSON.stringify(rawContent, null, 2);
+		else content = String(rawContent);
+		return { content };
 	} catch (error) {
 		return {
 			content: "",