@aigne/afs-cli 1.11.0-beta.1 → 1.11.0-beta.11

package/dist/explorer/actions.cjs

@@ -0,0 +1,311 @@
+
+//#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.meta || {};
+	let type = "file";
+	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,
+		type,
+		size: metadata.size,
+		modified: entry.updatedAt instanceof Date ? entry.updatedAt : void 0,
+		childrenCount: metadata.childrenCount,
+		hash: metadata.hash,
+		description: metadata.description,
+		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
+	};
+}
+/**
+* Create parent directory entry
+*/
+function createUpEntry(parentPath) {
+	return {
+		name: "..",
+		path: parentPath,
+		type: "up"
+	};
+}
+/**
+* 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(afs, path) {
+	try {
+		const result = await afs.list(path, { maxDepth: 1 });
+		const entries = [];
+		if (path !== "/") {
+			const parentPath = path.split("/").slice(0, -1).join("/") || "/";
+			entries.push(createUpEntry(parentPath));
+		}
+		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;
+			const aIsDir = a.type === "directory";
+			const bIsDir = b.type === "directory";
+			if (aIsDir && !bIsDir) return -1;
+			if (!aIsDir && bIsDir) return 1;
+			return a.name.localeCompare(b.name);
+		});
+		return { entries };
+	} catch (error) {
+		return {
+			entries: [],
+			error: error instanceof Error ? error.message : "Failed to load directory"
+		};
+	}
+}
+/**
+* Load metadata for an entry using stat() to get enriched data (including actions)
+*/
+async function loadMetadata(afs, entry) {
+	if (entry.type === "up") return;
+	try {
+		const data = (await afs.stat(entry.path)).data;
+		if (!data) return {
+			path: entry.path,
+			size: entry.size,
+			modified: entry.modified
+		};
+		const meta = data.meta || {};
+		return {
+			path: entry.path,
+			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,
+			size: entry.size,
+			modified: entry.modified
+		};
+	}
+}
+/**
+* Get explain output for an entry
+*/
+async function getExplain(afs, path) {
+	try {
+		const entry = (await afs.list(path, { maxDepth: 0 })).data[0];
+		if (!entry) return {
+			content: "",
+			error: "Entry not found"
+		};
+		const metadata = entry.meta || {};
+		const lines = [];
+		lines.push(`OBJECT ${path}`);
+		lines.push("");
+		if (metadata.description) {
+			lines.push("DESCRIPTION");
+			lines.push(metadata.description);
+			lines.push("");
+		}
+		if (metadata.size !== void 0) {
+			lines.push("SIZE");
+			lines.push(`${metadata.size} bytes`);
+			lines.push("");
+		}
+		if (metadata.childrenCount !== void 0) {
+			lines.push("CHILDREN");
+			lines.push(`${metadata.childrenCount} items`);
+			lines.push("");
+		}
+		if (metadata.provider) {
+			lines.push("PROVIDER");
+			lines.push(metadata.provider);
+			lines.push("");
+		}
+		if (metadata.hash) {
+			lines.push("HASH");
+			lines.push(metadata.hash);
+			lines.push("");
+		}
+		return { content: lines.join("\n") };
+	} catch (error) {
+		return {
+			content: "",
+			error: error instanceof Error ? error.message : "Failed to get explain"
+		};
+	}
+}
+/**
+* Execute an action on an entry
+*
+* 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(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(afs, path) {
+	try {
+		const entry = (await afs.read(path)).data;
+		if (!entry) return {
+			content: "",
+			error: "File not found"
+		};
+		const rawContent = entry.content;
+		if (rawContent === void 0 || rawContent === null) return {
+			content: "",
+			error: "No content available"
+		};
+		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: "",
+			error: error instanceof Error ? error.message : "Failed to read file"
+		};
+	}
+}
+/**
+* Navigation helpers
+*/
+const navigation = {
+	up(state) {
+		return { selectedIndex: Math.max(0, state.selectedIndex - 1) };
+	},
+	down(state) {
+		return { selectedIndex: Math.min(state.entries.length - 1, state.selectedIndex + 1) };
+	},
+	home(_state) {
+		return {
+			selectedIndex: 0,
+			scrollOffset: 0
+		};
+	},
+	end(state) {
+		return { selectedIndex: Math.max(0, state.entries.length - 1) };
+	},
+	pageUp(state, pageSize) {
+		return { selectedIndex: Math.max(0, state.selectedIndex - pageSize) };
+	},
+	pageDown(state, pageSize) {
+		return { selectedIndex: Math.min(state.entries.length - 1, state.selectedIndex + pageSize) };
+	},
+	getSelected(state) {
+		return state.entries[state.selectedIndex];
+	},
+	getParentPath(path) {
+		if (path === "/") return "/";
+		const parts = path.split("/").filter(Boolean);
+		parts.pop();
+		return `/${parts.join("/")}` || "/";
+	}
+};
+/**
+* Create initial state
+*/
+function createInitialState(startPath = "/") {
+	return {
+		currentPath: startPath,
+		entries: [],
+		selectedIndex: 0,
+		scrollOffset: 0,
+		loading: true
+	};
+}
+
+//#endregion
+exports.createInitialState = createInitialState;
+exports.executeAction = executeAction;
+exports.getExplain = getExplain;
+exports.loadDirectory = loadDirectory;
+exports.loadMetadata = loadMetadata;
+exports.navigation = navigation;
+exports.readFileContent = readFileContent;

package/dist/explorer/actions.mjs

@@ -0,0 +1,305 @@
+//#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.meta || {};
+	let type = "file";
+	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,
+		type,
+		size: metadata.size,
+		modified: entry.updatedAt instanceof Date ? entry.updatedAt : void 0,
+		childrenCount: metadata.childrenCount,
+		hash: metadata.hash,
+		description: metadata.description,
+		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
+	};
+}
+/**
+* Create parent directory entry
+*/
+function createUpEntry(parentPath) {
+	return {
+		name: "..",
+		path: parentPath,
+		type: "up"
+	};
+}
+/**
+* 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(afs, path) {
+	try {
+		const result = await afs.list(path, { maxDepth: 1 });
+		const entries = [];
+		if (path !== "/") {
+			const parentPath = path.split("/").slice(0, -1).join("/") || "/";
+			entries.push(createUpEntry(parentPath));
+		}
+		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;
+			const aIsDir = a.type === "directory";
+			const bIsDir = b.type === "directory";
+			if (aIsDir && !bIsDir) return -1;
+			if (!aIsDir && bIsDir) return 1;
+			return a.name.localeCompare(b.name);
+		});
+		return { entries };
+	} catch (error) {
+		return {
+			entries: [],
+			error: error instanceof Error ? error.message : "Failed to load directory"
+		};
+	}
+}
+/**
+* Load metadata for an entry using stat() to get enriched data (including actions)
+*/
+async function loadMetadata(afs, entry) {
+	if (entry.type === "up") return;
+	try {
+		const data = (await afs.stat(entry.path)).data;
+		if (!data) return {
+			path: entry.path,
+			size: entry.size,
+			modified: entry.modified
+		};
+		const meta = data.meta || {};
+		return {
+			path: entry.path,
+			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,
+			size: entry.size,
+			modified: entry.modified
+		};
+	}
+}
+/**
+* Get explain output for an entry
+*/
+async function getExplain(afs, path) {
+	try {
+		const entry = (await afs.list(path, { maxDepth: 0 })).data[0];
+		if (!entry) return {
+			content: "",
+			error: "Entry not found"
+		};
+		const metadata = entry.meta || {};
+		const lines = [];
+		lines.push(`OBJECT ${path}`);
+		lines.push("");
+		if (metadata.description) {
+			lines.push("DESCRIPTION");
+			lines.push(metadata.description);
+			lines.push("");
+		}
+		if (metadata.size !== void 0) {
+			lines.push("SIZE");
+			lines.push(`${metadata.size} bytes`);
+			lines.push("");
+		}
+		if (metadata.childrenCount !== void 0) {
+			lines.push("CHILDREN");
+			lines.push(`${metadata.childrenCount} items`);
+			lines.push("");
+		}
+		if (metadata.provider) {
+			lines.push("PROVIDER");
+			lines.push(metadata.provider);
+			lines.push("");
+		}
+		if (metadata.hash) {
+			lines.push("HASH");
+			lines.push(metadata.hash);
+			lines.push("");
+		}
+		return { content: lines.join("\n") };
+	} catch (error) {
+		return {
+			content: "",
+			error: error instanceof Error ? error.message : "Failed to get explain"
+		};
+	}
+}
+/**
+* Execute an action on an entry
+*
+* 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(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(afs, path) {
+	try {
+		const entry = (await afs.read(path)).data;
+		if (!entry) return {
+			content: "",
+			error: "File not found"
+		};
+		const rawContent = entry.content;
+		if (rawContent === void 0 || rawContent === null) return {
+			content: "",
+			error: "No content available"
+		};
+		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: "",
+			error: error instanceof Error ? error.message : "Failed to read file"
+		};
+	}
+}
+/**
+* Navigation helpers
+*/
+const navigation = {
+	up(state) {
+		return { selectedIndex: Math.max(0, state.selectedIndex - 1) };
+	},
+	down(state) {
+		return { selectedIndex: Math.min(state.entries.length - 1, state.selectedIndex + 1) };
+	},
+	home(_state) {
+		return {
+			selectedIndex: 0,
+			scrollOffset: 0
+		};
+	},
+	end(state) {
+		return { selectedIndex: Math.max(0, state.entries.length - 1) };
+	},
+	pageUp(state, pageSize) {
+		return { selectedIndex: Math.max(0, state.selectedIndex - pageSize) };
+	},
+	pageDown(state, pageSize) {
+		return { selectedIndex: Math.min(state.entries.length - 1, state.selectedIndex + pageSize) };
+	},
+	getSelected(state) {
+		return state.entries[state.selectedIndex];
+	},
+	getParentPath(path) {
+		if (path === "/") return "/";
+		const parts = path.split("/").filter(Boolean);
+		parts.pop();
+		return `/${parts.join("/")}` || "/";
+	}
+};
+/**
+* Create initial state
+*/
+function createInitialState(startPath = "/") {
+	return {
+		currentPath: startPath,
+		entries: [],
+		selectedIndex: 0,
+		scrollOffset: 0,
+		loading: true
+	};
+}
+
+//#endregion
+export { createInitialState, executeAction, getExplain, loadDirectory, loadMetadata, navigation, readFileContent };
+//# sourceMappingURL=actions.mjs.map

package/dist/explorer/actions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.mjs","names":[],"sources":["../../src/explorer/actions.ts"],"sourcesContent":["/**\n * AFS Explorer Actions\n *\n * Core action handlers for the explorer.\n * These are separated from UI for testability.\n */\n\nimport type { AFS, AFSEntry, AFSEntryMetadata } from \"@aigne/afs\";\nimport type { ActionResult, EntryMetadata, ExplorerEntry, ExplorerState } from \"./types.js\";\n\n/**\n * Check if an entry is executable based on its meta\n */\nexport function isExecutable(meta: AFSEntryMetadata | null | undefined): boolean {\n  if (!meta) return false;\n\n  if (Array.isArray(meta.kinds)) {\n    return meta.kinds.includes(\"afs:executable\");\n  }\n\n  return meta.kind === \"afs:executable\";\n}\n\n/**\n * Check if a value is a valid directory-indicating childrenCount\n *\n * Per Provider Protocol spec:\n * - childrenCount > 0: known children → directory\n * - childrenCount = -1: unknown children count → directory\n * - childrenCount = 0 or undefined: leaf node → file\n */\nfunction isDirectory(childrenCount: unknown): boolean {\n  if (typeof childrenCount !== \"number\" || Number.isNaN(childrenCount)) {\n    return false;\n  }\n  // -1 means unknown children (directory), > 0 means has children (directory)\n  return childrenCount === -1 || childrenCount > 0;\n}\n\n/**\n * Convert AFS entry to explorer entry\n *\n * Type determination priority:\n * 1. afs:executable → exec\n * 2. afs:link → link\n * 3. childrenCount > 0 or -1 → directory\n * 4. Otherwise (childrenCount = 0, undefined, invalid) → file\n */\nexport function toExplorerEntry(entry: AFSEntry, _basePath: string): ExplorerEntry {\n  const name = entry.path.split(\"/\").pop() || entry.path;\n  const metadata = entry.meta || {};\n\n  // Determine type based on childrenCount (per Provider Protocol spec)\n  // - childrenCount > 0 or -1 → directory\n  // - childrenCount = 0, undefined, or invalid → file (leaf node)\n  let type: ExplorerEntry[\"type\"] = \"file\"; // Default to file (leaf node)\n\n  // Check for special types from kinds array or kind field (highest priority)\n  if (isExecutable(metadata)) {\n    type = \"exec\";\n  } else if (metadata.kind === \"afs:link\" || metadata.kinds?.includes(\"afs:link\")) {\n    type = \"link\";\n  } else if (isDirectory(metadata.childrenCount)) {\n    type = \"directory\";\n  }\n  // Otherwise keep default \"file\" - leaf node\n\n  return {\n    name,\n    path: entry.path,\n    type,\n    size: metadata.size,\n    modified: entry.updatedAt instanceof Date ? entry.updatedAt : undefined,\n    childrenCount: metadata.childrenCount,\n    hash: metadata.hash,\n    description: metadata.description,\n    provider: metadata.provider,\n    // Meta fields from .afs/meta.yaml\n    icon: metadata.icon,\n    kind: metadata.kind,\n    kinds: Array.isArray(metadata.kinds) ? metadata.kinds : undefined,\n    label: metadata.label,\n    tags: Array.isArray(metadata.tags) ? metadata.tags : undefined,\n    // Actions from AFSEntry\n    actions: entry.actions,\n  };\n}\n\n/**\n * Create parent directory entry\n */\nexport function createUpEntry(parentPath: string): ExplorerEntry {\n  return {\n    name: \"..\",\n    path: parentPath,\n    type: \"up\",\n  };\n}\n\n/**\n * Build immediate children from a list of deep paths\n * For example, if path is \"/\" and entries contain \"/github/ArcBlock/afs\",\n * this returns a virtual directory entry for \"/github\"\n */\nfunction buildImmediateChildren(path: string, afsEntries: AFSEntry[]): Map<string, ExplorerEntry> {\n  const normalizedPath = path === \"/\" ? \"\" : path;\n  const pathDepth = normalizedPath === \"\" ? 0 : normalizedPath.split(\"/\").filter(Boolean).length;\n  const childrenMap = new Map<string, ExplorerEntry>();\n\n  for (const entry of afsEntries) {\n    // Skip the current directory itself\n    if (entry.path === path) continue;\n\n    const entryParts = entry.path.split(\"/\").filter(Boolean);\n\n    // Get the immediate child name (the part right after current path)\n    const childName = entryParts[pathDepth];\n    if (!childName) continue;\n\n    const childPath = `/${entryParts.slice(0, pathDepth + 1).join(\"/\")}`;\n\n    // Check if this entry IS the immediate child (not a deeper descendant)\n    const isDirectChild = entryParts.length === pathDepth + 1;\n\n    if (isDirectChild) {\n      // This is a direct child - use the actual entry\n      childrenMap.set(childName, toExplorerEntry(entry, path));\n    } else if (!childrenMap.has(childName)) {\n      // This is a deeper descendant - create a virtual directory for the intermediate path\n      childrenMap.set(childName, {\n        name: childName,\n        path: childPath,\n        type: \"directory\",\n        childrenCount: -1, // Unknown\n      });\n    }\n  }\n\n  return childrenMap;\n}\n\n/**\n * Load directory entries from AFS\n */\nexport async function loadDirectory(\n  afs: AFS,\n  path: string,\n): Promise<{ entries: ExplorerEntry[]; error?: string }> {\n  try {\n    const result = await afs.list(path, { maxDepth: 1 });\n    const entries: ExplorerEntry[] = [];\n\n    // Add parent directory entry if not at root\n    if (path !== \"/\") {\n      const parentPath = path.split(\"/\").slice(0, -1).join(\"/\") || \"/\";\n      entries.push(createUpEntry(parentPath));\n    }\n\n    // Build immediate children from potentially deep paths\n    const childrenMap = buildImmediateChildren(path, result.data);\n    entries.push(...childrenMap.values());\n\n    // Sort: directories first, then by name\n    entries.sort((a, b) => {\n      // Up always first\n      if (a.type === \"up\") return -1;\n      if (b.type === \"up\") return 1;\n\n      // Directories before files\n      const aIsDir = a.type === \"directory\";\n      const bIsDir = b.type === \"directory\";\n      if (aIsDir && !bIsDir) return -1;\n      if (!aIsDir && bIsDir) return 1;\n\n      // Alphabetical\n      return a.name.localeCompare(b.name);\n    });\n\n    return { entries };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : \"Failed to load directory\";\n    return { entries: [], error: message };\n  }\n}\n\n/**\n * Load metadata for an entry using stat() to get enriched data (including actions)\n */\nexport async function loadMetadata(\n  afs: AFS,\n  entry: ExplorerEntry,\n): Promise<EntryMetadata | undefined> {\n  if (entry.type === \"up\") {\n    return undefined;\n  }\n\n  try {\n    // Use stat to get detailed metadata with auto-enriched actions\n    const result = await afs.stat(entry.path);\n    const data = result.data;\n\n    if (!data) {\n      return {\n        path: entry.path,\n        size: entry.size,\n        modified: entry.modified,\n      };\n    }\n\n    const meta = data.meta || {};\n\n    return {\n      path: entry.path,\n      size: meta.size as number | undefined,\n      modified: data.updatedAt instanceof Date ? data.updatedAt : undefined,\n      childrenCount: meta.childrenCount as number | undefined,\n      hash: meta.hash as string | undefined,\n      description: meta.description as string | undefined,\n      provider: meta.provider as string | undefined,\n      mountPath: meta.mountPath as string | undefined,\n      uri: meta.uri as string | undefined,\n      permissions: meta.permissions as string[] | undefined,\n      // Actions from stat (auto-enriched by core)\n      actions: data.actions,\n      // All metadata fields for display\n      extra: meta,\n    };\n  } catch {\n    // Return basic metadata if detailed load fails\n    return {\n      path: entry.path,\n      size: entry.size,\n      modified: entry.modified,\n    };\n  }\n}\n\n/**\n * Get explain output for an entry\n */\nexport async function getExplain(\n  afs: AFS,\n  path: string,\n): Promise<{ content: string; error?: string }> {\n  try {\n    // Try to get explain from AFS if available\n    // For now, build explain from metadata\n    const result = await afs.list(path, { maxDepth: 0 });\n    const entry = result.data[0];\n\n    if (!entry) {\n      return { content: \"\", error: \"Entry not found\" };\n    }\n\n    const metadata = entry.meta || {};\n    const lines: string[] = [];\n\n    lines.push(`OBJECT ${path}`);\n    lines.push(\"\");\n\n    if (metadata.description) {\n      lines.push(\"DESCRIPTION\");\n      lines.push(metadata.description);\n      lines.push(\"\");\n    }\n\n    if (metadata.size !== undefined) {\n      lines.push(\"SIZE\");\n      lines.push(`${metadata.size} bytes`);\n      lines.push(\"\");\n    }\n\n    if (metadata.childrenCount !== undefined) {\n      lines.push(\"CHILDREN\");\n      lines.push(`${metadata.childrenCount} items`);\n      lines.push(\"\");\n    }\n\n    if (metadata.provider) {\n      lines.push(\"PROVIDER\");\n      lines.push(metadata.provider);\n      lines.push(\"\");\n    }\n\n    if (metadata.hash) {\n      lines.push(\"HASH\");\n      lines.push(metadata.hash);\n      lines.push(\"\");\n    }\n\n    return { content: lines.join(\"\\n\") };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : \"Failed to get explain\";\n    return { content: \"\", error: message };\n  }\n}\n\n/**\n * Execute an action on an entry\n *\n * For executable entries (kinds includes \"afs:executable\"), this calls\n * the underlying exec command. The action parameter is currently not used\n * but reserved for future action selection.\n */\nexport async function executeAction(\n  afs: AFS,\n  path: string,\n  _action: string,\n  params?: Record<string, unknown>,\n): Promise<ActionResult> {\n  try {\n    const result = await afs.exec(path, params || {}, {});\n\n    return {\n      success: result.success,\n      message: result.error?.message,\n      data: result.data,\n    };\n  } catch (error) {\n    return {\n      success: false,\n      message: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\n/**\n * Read file content\n */\nexport async function readFileContent(\n  afs: AFS,\n  path: string,\n): Promise<{ content: string; error?: string }> {\n  try {\n    const result = await afs.read(path);\n    const entry = result.data;\n    if (!entry) {\n      return { content: \"\", error: \"File not found\" };\n    }\n\n    // Content can be string, Buffer, ArrayBuffer, Uint8Array, or undefined\n    const rawContent = entry.content;\n    if (rawContent === undefined || rawContent === null) {\n      return { content: \"\", error: \"No content available\" };\n    }\n\n    // Convert to string based on type\n    let content: string;\n    if (typeof rawContent === \"string\") {\n      content = rawContent;\n    } else if (Buffer.isBuffer(rawContent)) {\n      content = rawContent.toString(\"utf-8\");\n    } else if (rawContent instanceof Uint8Array) {\n      content = Buffer.from(rawContent).toString(\"utf-8\");\n    } else if (rawContent instanceof ArrayBuffer) {\n      content = Buffer.from(new Uint8Array(rawContent)).toString(\"utf-8\");\n    } else if (typeof rawContent === \"object\") {\n      // If content is an object (e.g., JSON data), stringify it\n      content = JSON.stringify(rawContent, null, 2);\n    } else {\n      // Fallback for other types\n      content = String(rawContent);\n    }\n\n    return { content };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : \"Failed to read file\";\n    return { content: \"\", error: message };\n  }\n}\n\n/**\n * Navigation helpers\n */\nexport const navigation = {\n  /**\n   * Move selection up\n   */\n  up(state: ExplorerState): Partial<ExplorerState> {\n    const newIndex = Math.max(0, state.selectedIndex - 1);\n    return { selectedIndex: newIndex };\n  },\n\n  /**\n   * Move selection down\n   */\n  down(state: ExplorerState): Partial<ExplorerState> {\n    const newIndex = Math.min(state.entries.length - 1, state.selectedIndex + 1);\n    return { selectedIndex: newIndex };\n  },\n\n  /**\n   * Go to first item\n   */\n  home(_state: ExplorerState): Partial<ExplorerState> {\n    return { selectedIndex: 0, scrollOffset: 0 };\n  },\n\n  /**\n   * Go to last item\n   */\n  end(state: ExplorerState): Partial<ExplorerState> {\n    return { selectedIndex: Math.max(0, state.entries.length - 1) };\n  },\n\n  /**\n   * Page up (move by pageSize items)\n   */\n  pageUp(state: ExplorerState, pageSize: number): Partial<ExplorerState> {\n    const newIndex = Math.max(0, state.selectedIndex - pageSize);\n    return { selectedIndex: newIndex };\n  },\n\n  /**\n   * Page down (move by pageSize items)\n   */\n  pageDown(state: ExplorerState, pageSize: number): Partial<ExplorerState> {\n    const newIndex = Math.min(state.entries.length - 1, state.selectedIndex + pageSize);\n    return { selectedIndex: newIndex };\n  },\n\n  /**\n   * Get selected entry\n   */\n  getSelected(state: ExplorerState): ExplorerEntry | undefined {\n    return state.entries[state.selectedIndex];\n  },\n\n  /**\n   * Get parent path\n   */\n  getParentPath(path: string): string {\n    if (path === \"/\") return \"/\";\n    const parts = path.split(\"/\").filter(Boolean);\n    parts.pop();\n    return `/${parts.join(\"/\")}` || \"/\";\n  },\n};\n\n/**\n * Filter entries by search text\n */\nexport function filterEntries(entries: ExplorerEntry[], filterText: string): ExplorerEntry[] {\n  if (!filterText) return entries;\n\n  const lower = filterText.toLowerCase();\n  return entries.filter((e) => e.name.toLowerCase().includes(lower) || e.type === \"up\");\n}\n\n/**\n * Create initial state\n */\nexport function createInitialState(startPath: string = \"/\"): ExplorerState {\n  return {\n    currentPath: startPath,\n    entries: [],\n    selectedIndex: 0,\n    scrollOffset: 0,\n    loading: true,\n  };\n}\n"],"mappings":"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"}