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

package/dist/afs-enrichment.cjs

@@ -0,0 +1,79 @@
+let ufo = require("ufo");
+
+//#region src/afs-enrichment.ts
+/**
+* Enrichment helpers for AFS entries.
+*
+* These functions fetch actions and meta from a provider module
+* and merge them into AFS entries. They are pure functions that
+* operate on an AFSModule and a subpath — no AFS instance needed.
+*/
+/**
+* Check if a path should skip enrichment.
+* Virtual system paths (/.meta, /.actions, /.perception) are not enrichable.
+*/
+function shouldSkipEnrich(path) {
+	return path.endsWith("/.meta") || path.endsWith("/.actions") || path.includes("/.perception");
+}
+/**
+* Fetch actions for a path by listing path/.actions.
+* Returns ActionSummary[] on success, [] on failure.
+*/
+async function fetchActions(module, subpath) {
+	try {
+		const actionsPath = (0, ufo.joinURL)(subpath, ".actions");
+		const result = await module.list?.(actionsPath);
+		if (!result?.data) return [];
+		return result.data.filter((entry) => entry.meta?.kind === "afs:executable").map((entry) => {
+			const summary = {
+				name: entry.id,
+				description: entry.meta?.description,
+				inputSchema: entry.meta?.inputSchema
+			};
+			const sev = entry.meta?.severity;
+			if (sev === "ambient" || sev === "boundary" || sev === "critical") summary.severity = sev;
+			return summary;
+		});
+	} catch {
+		return [];
+	}
+}
+/**
+* Fetch meta for a path by reading path/.meta.
+* Returns the meta content on success, null on failure.
+*/
+async function fetchMeta(module, subpath) {
+	try {
+		const metaPath = (0, ufo.joinURL)(subpath, ".meta");
+		const result = await module.read?.(metaPath);
+		if (!result?.data?.content) return null;
+		const content = result.data.content;
+		if (typeof content === "object" && content !== null && !Array.isArray(content)) return content;
+		return null;
+	} catch {
+		return null;
+	}
+}
+/**
+* Enrich an AFS entry with actions and meta from the provider.
+* Skips enrichment for virtual system paths.
+*/
+async function enrichData(data, module, subpath) {
+	if (shouldSkipEnrich(subpath)) return data;
+	const result = { ...data };
+	const enrichPromises = [];
+	if (result.actions === void 0) enrichPromises.push(fetchActions(module, subpath).then((actions) => {
+		result.actions = actions;
+	}));
+	if (result.meta?.kind === void 0) enrichPromises.push(fetchMeta(module, subpath).then((meta) => {
+		if (meta) result.meta = {
+			...result.meta,
+			...meta
+		};
+	}));
+	await Promise.all(enrichPromises);
+	return result;
+}
+
+//#endregion
+exports.enrichData = enrichData;

package/dist/afs-enrichment.mjs

@@ -0,0 +1,80 @@
+import { joinURL } from "ufo";
+
+//#region src/afs-enrichment.ts
+/**
+* Enrichment helpers for AFS entries.
+*
+* These functions fetch actions and meta from a provider module
+* and merge them into AFS entries. They are pure functions that
+* operate on an AFSModule and a subpath — no AFS instance needed.
+*/
+/**
+* Check if a path should skip enrichment.
+* Virtual system paths (/.meta, /.actions, /.perception) are not enrichable.
+*/
+function shouldSkipEnrich(path) {
+	return path.endsWith("/.meta") || path.endsWith("/.actions") || path.includes("/.perception");
+}
+/**
+* Fetch actions for a path by listing path/.actions.
+* Returns ActionSummary[] on success, [] on failure.
+*/
+async function fetchActions(module, subpath) {
+	try {
+		const actionsPath = joinURL(subpath, ".actions");
+		const result = await module.list?.(actionsPath);
+		if (!result?.data) return [];
+		return result.data.filter((entry) => entry.meta?.kind === "afs:executable").map((entry) => {
+			const summary = {
+				name: entry.id,
+				description: entry.meta?.description,
+				inputSchema: entry.meta?.inputSchema
+			};
+			const sev = entry.meta?.severity;
+			if (sev === "ambient" || sev === "boundary" || sev === "critical") summary.severity = sev;
+			return summary;
+		});
+	} catch {
+		return [];
+	}
+}
+/**
+* Fetch meta for a path by reading path/.meta.
+* Returns the meta content on success, null on failure.
+*/
+async function fetchMeta(module, subpath) {
+	try {
+		const metaPath = joinURL(subpath, ".meta");
+		const result = await module.read?.(metaPath);
+		if (!result?.data?.content) return null;
+		const content = result.data.content;
+		if (typeof content === "object" && content !== null && !Array.isArray(content)) return content;
+		return null;
+	} catch {
+		return null;
+	}
+}
+/**
+* Enrich an AFS entry with actions and meta from the provider.
+* Skips enrichment for virtual system paths.
+*/
+async function enrichData(data, module, subpath) {
+	if (shouldSkipEnrich(subpath)) return data;
+	const result = { ...data };
+	const enrichPromises = [];
+	if (result.actions === void 0) enrichPromises.push(fetchActions(module, subpath).then((actions) => {
+		result.actions = actions;
+	}));
+	if (result.meta?.kind === void 0) enrichPromises.push(fetchMeta(module, subpath).then((meta) => {
+		if (meta) result.meta = {
+			...result.meta,
+			...meta
+		};
+	}));
+	await Promise.all(enrichPromises);
+	return result;
+}
+
+//#endregion
+export { enrichData };
+//# sourceMappingURL=afs-enrichment.mjs.map

package/dist/afs-enrichment.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"afs-enrichment.mjs","names":[],"sources":["../src/afs-enrichment.ts"],"sourcesContent":["/**\n * Enrichment helpers for AFS entries.\n *\n * These functions fetch actions and meta from a provider module\n * and merge them into AFS entries. They are pure functions that\n * operate on an AFSModule and a subpath — no AFS instance needed.\n */\nimport { joinURL } from \"ufo\";\nimport type { ActionSummary, AFSModule } from \"./type.js\";\n\n/**\n * Check if a path should skip enrichment.\n * Virtual system paths (/.meta, /.actions, /.perception) are not enrichable.\n */\nexport function shouldSkipEnrich(path: string): boolean {\n  return path.endsWith(\"/.meta\") || path.endsWith(\"/.actions\") || path.includes(\"/.perception\");\n}\n\n/**\n * Fetch actions for a path by listing path/.actions.\n * Returns ActionSummary[] on success, [] on failure.\n */\nexport async function fetchActions(module: AFSModule, subpath: string): Promise<ActionSummary[]> {\n  try {\n    const actionsPath = joinURL(subpath, \".actions\");\n    const result = await module.list?.(actionsPath);\n    if (!result?.data) return [];\n\n    return result.data\n      .filter((entry) => entry.meta?.kind === \"afs:executable\")\n      .map((entry) => {\n        const summary: ActionSummary = {\n          name: entry.id,\n          description: entry.meta?.description as string | undefined,\n          inputSchema: entry.meta?.inputSchema as ActionSummary[\"inputSchema\"],\n        };\n        const sev = entry.meta?.severity as string | undefined;\n        if (sev === \"ambient\" || sev === \"boundary\" || sev === \"critical\") {\n          summary.severity = sev;\n        }\n        return summary;\n      });\n  } catch {\n    return [];\n  }\n}\n\n/**\n * Fetch meta for a path by reading path/.meta.\n * Returns the meta content on success, null on failure.\n */\nexport async function fetchMeta(\n  module: AFSModule,\n  subpath: string,\n): Promise<Record<string, unknown> | null> {\n  try {\n    const metaPath = joinURL(subpath, \".meta\");\n    const result = await module.read?.(metaPath);\n    if (!result?.data?.content) return null;\n\n    // content should be an object containing meta fields\n    const content = result.data.content;\n    if (typeof content === \"object\" && content !== null && !Array.isArray(content)) {\n      return content as Record<string, unknown>;\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Enrich an AFS entry with actions and meta from the provider.\n * Skips enrichment for virtual system paths.\n */\nexport async function enrichData<\n  T extends { path: string; actions?: ActionSummary[]; meta?: Record<string, unknown> | null },\n>(data: T, module: AFSModule, subpath: string): Promise<T> {\n  // Skip enrichment for virtual paths\n  if (shouldSkipEnrich(subpath)) {\n    return data;\n  }\n\n  const result = { ...data };\n  const enrichPromises: Promise<void>[] = [];\n\n  // Fetch actions if not present (undefined means fetch, [] means keep as-is)\n  if (result.actions === undefined) {\n    enrichPromises.push(\n      fetchActions(module, subpath).then((actions) => {\n        result.actions = actions;\n      }),\n    );\n  }\n\n  // Fetch meta if kind is not present\n  if (result.meta?.kind === undefined) {\n    enrichPromises.push(\n      fetchMeta(module, subpath).then((meta) => {\n        if (meta) {\n          result.meta = { ...result.meta, ...meta };\n        }\n      }),\n    );\n  }\n\n  await Promise.all(enrichPromises);\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;AAcA,SAAgB,iBAAiB,MAAuB;AACtD,QAAO,KAAK,SAAS,SAAS,IAAI,KAAK,SAAS,YAAY,IAAI,KAAK,SAAS,eAAe;;;;;;AAO/F,eAAsB,aAAa,QAAmB,SAA2C;AAC/F,KAAI;EACF,MAAM,cAAc,QAAQ,SAAS,WAAW;EAChD,MAAM,SAAS,MAAM,OAAO,OAAO,YAAY;AAC/C,MAAI,CAAC,QAAQ,KAAM,QAAO,EAAE;AAE5B,SAAO,OAAO,KACX,QAAQ,UAAU,MAAM,MAAM,SAAS,iBAAiB,CACxD,KAAK,UAAU;GACd,MAAM,UAAyB;IAC7B,MAAM,MAAM;IACZ,aAAa,MAAM,MAAM;IACzB,aAAa,MAAM,MAAM;IAC1B;GACD,MAAM,MAAM,MAAM,MAAM;AACxB,OAAI,QAAQ,aAAa,QAAQ,cAAc,QAAQ,WACrD,SAAQ,WAAW;AAErB,UAAO;IACP;SACE;AACN,SAAO,EAAE;;;;;;;AAQb,eAAsB,UACpB,QACA,SACyC;AACzC,KAAI;EACF,MAAM,WAAW,QAAQ,SAAS,QAAQ;EAC1C,MAAM,SAAS,MAAM,OAAO,OAAO,SAAS;AAC5C,MAAI,CAAC,QAAQ,MAAM,QAAS,QAAO;EAGnC,MAAM,UAAU,OAAO,KAAK;AAC5B,MAAI,OAAO,YAAY,YAAY,YAAY,QAAQ,CAAC,MAAM,QAAQ,QAAQ,CAC5E,QAAO;AAET,SAAO;SACD;AACN,SAAO;;;;;;;AAQX,eAAsB,WAEpB,MAAS,QAAmB,SAA6B;AAEzD,KAAI,iBAAiB,QAAQ,CAC3B,QAAO;CAGT,MAAM,SAAS,EAAE,GAAG,MAAM;CAC1B,MAAM,iBAAkC,EAAE;AAG1C,KAAI,OAAO,YAAY,OACrB,gBAAe,KACb,aAAa,QAAQ,QAAQ,CAAC,MAAM,YAAY;AAC9C,SAAO,UAAU;GACjB,CACH;AAIH,KAAI,OAAO,MAAM,SAAS,OACxB,gBAAe,KACb,UAAU,QAAQ,QAAQ,CAAC,MAAM,SAAS;AACxC,MAAI,KACF,QAAO,OAAO;GAAE,GAAG,OAAO;GAAM,GAAG;GAAM;GAE3C,CACH;AAGH,OAAM,QAAQ,IAAI,eAAe;AACjC,QAAO"}

package/dist/afs-explain.cjs

@@ -0,0 +1,224 @@
+
+//#region src/afs-explain.ts
+/**
+* Format bytes to human-readable string.
+*/
+function formatBytes(bytes) {
+	if (bytes === 0) return "0 B";
+	const k = 1024;
+	const sizes = [
+		"B",
+		"KB",
+		"MB",
+		"GB",
+		"TB"
+	];
+	const i = Math.floor(Math.log(bytes) / Math.log(k));
+	return `${Number.parseFloat((bytes / k ** i).toFixed(2))} ${sizes[i]}`;
+}
+/**
+* Build explain markdown from stat data.
+* Used by both the module-found fallback and the no-module safety net.
+*/
+function buildExplainFromStat(path, data) {
+	const lines = [];
+	lines.push(`# ${path}`);
+	lines.push("");
+	const meta = data.meta || {};
+	if (meta.size !== void 0) lines.push(`- **Size**: ${formatBytes(meta.size)}`);
+	if (meta.childrenCount !== void 0) lines.push(`- **Children**: ${meta.childrenCount} items`);
+	if (data.updatedAt) lines.push(`- **Modified**: ${data.updatedAt.toISOString()}`);
+	if (meta.description) {
+		lines.push("");
+		lines.push("## Description");
+		lines.push(String(meta.description));
+	}
+	if (meta.provider) lines.push(`- **Provider**: ${meta.provider}`);
+	if (meta.kind) lines.push(`- **Kind**: ${meta.kind}`);
+	if (meta.kinds && Array.isArray(meta.kinds)) lines.push(`- **Kinds**: ${meta.kinds.join(", ")}`);
+	if (data.actions && data.actions.length > 0) {
+		lines.push("");
+		lines.push("## Actions");
+		for (const action of data.actions) lines.push(`- **${action.name}**${action.description ? `: ${action.description}` : ""}`);
+	}
+	return {
+		format: "markdown",
+		content: lines.join("\n")
+	};
+}
+/**
+* Build explain for a virtual intermediate directory.
+*/
+function buildVirtualDirExplain(path, data) {
+	const childrenCount = data.meta?.childrenCount;
+	const lines = [];
+	lines.push(`# ${path}`);
+	lines.push("");
+	lines.push("- **Type**: Virtual directory");
+	if (childrenCount !== void 0) lines.push(`- **Children**: ${childrenCount} items`);
+	return {
+		format: "markdown",
+		content: lines.join("\n")
+	};
+}
+/**
+* Generate root explain: intro + 4 sections.
+*/
+async function explainRoot(mounts, listRootActions) {
+	const lines = [];
+	lines.push("# AFS — Agentic File System");
+	lines.push("");
+	lines.push("AFS is a virtual filesystem developed by [ArcBlock](https://www.arcblock.io) that gives AI agents a unified, path-based interface to any data source.");
+	lines.push("Inspired by Unix and Plan 9's \"everything is a file\", AFS extends the idea to **everything is context** — databases, APIs, smart home devices, and cloud services all become files and directories that agents can read, write, search, and act on.");
+	lines.push("");
+	lines.push("## Mounted Providers");
+	lines.push("");
+	if (mounts.length === 0) {
+		lines.push("No providers currently mounted. Use the `mount` action to add providers.");
+		lines.push("");
+	} else {
+		for (const m of mounts) if (m.module.description) {
+			const descLines = m.module.description.split("\n");
+			lines.push(`- **${m.module.name}** (\`${m.path}\`) — ${descLines[0]}`);
+			for (let i = 1; i < descLines.length; i++) lines.push(`  ${descLines[i]}`);
+		} else lines.push(`- **${m.module.name}** (\`${m.path}\`)`);
+		lines.push("");
+	}
+	lines.push("## Standard Operations");
+	lines.push("");
+	lines.push("- **read** — Read file or node content");
+	lines.push("- **list** — List children of a directory or container");
+	lines.push("- **stat** — Get metadata without content");
+	lines.push("- **explain** — Get human-readable documentation for a path");
+	lines.push("- **search** — Search within a mounted provider");
+	lines.push("- **write** — Create or update content");
+	lines.push("- **delete** — Remove a file or node");
+	lines.push("- **exec** — Execute an action at a path");
+	lines.push("");
+	lines.push("## Root Actions");
+	lines.push("");
+	const { data: actions } = await listRootActions();
+	for (const action of actions) {
+		const desc = action.actions?.[0]?.description || action.summary || "";
+		lines.push(`- **${action.id}** — ${desc}`);
+	}
+	lines.push("");
+	lines.push("Use `explain('/.actions/<name>')` for detailed usage.");
+	lines.push("");
+	lines.push("## Built-in Systems");
+	lines.push("");
+	lines.push("- **`.meta`** — Metadata for any node. Access via `read('/.meta')` at root, or append `/.meta` to any path.");
+	lines.push("- **`.actions`** — Executable actions. Access via `read('/.actions')` to list, `exec('/.actions/<name>', args)` to run.");
+	lines.push("");
+	return {
+		format: "markdown",
+		content: lines.join("\n")
+	};
+}
+/**
+* Explain a root action path (/.actions or /.actions/{name}).
+*/
+async function explainRootAction(path, listRootActions) {
+	if (path === "/.actions") {
+		const lines$1 = [];
+		lines$1.push("# Root Actions");
+		lines$1.push("");
+		lines$1.push("Available actions at the AFS root level:");
+		lines$1.push("");
+		const { data: actions$1 } = await listRootActions();
+		for (const action$1 of actions$1) {
+			const desc = action$1.actions?.[0]?.description || action$1.summary || "";
+			lines$1.push(`- **${action$1.id}** — ${desc}`);
+		}
+		lines$1.push("");
+		lines$1.push("Use `explain('/.actions/<name>')` for detailed parameters and usage.");
+		return {
+			format: "markdown",
+			content: lines$1.join("\n")
+		};
+	}
+	const actionName = path.slice(10);
+	const { data: actions } = await listRootActions();
+	const entry = actions.find((a) => a.id === actionName);
+	if (!entry) return {
+		format: "markdown",
+		content: ""
+	};
+	const action = entry.actions?.[0];
+	const lines = [];
+	lines.push(`# ${actionName}`);
+	lines.push("");
+	if (action?.description) {
+		lines.push(action.description);
+		lines.push("");
+	}
+	const schema = action?.inputSchema;
+	const properties = schema?.properties;
+	const required = schema?.required || [];
+	if (properties && Object.keys(properties).length > 0) {
+		lines.push("## Parameters");
+		lines.push("");
+		lines.push("| Name | Type | Required | Description |");
+		lines.push("|------|------|----------|-------------|");
+		for (const [name, prop] of Object.entries(properties)) {
+			const propObj = prop;
+			const type = propObj.type || "any";
+			const isRequired = required.includes(name) ? "yes" : "no";
+			const desc = propObj.description || "";
+			lines.push(`| ${name} | ${type} | ${isRequired} | ${desc} |`);
+		}
+		lines.push("");
+	}
+	lines.push("## Example");
+	lines.push("");
+	const exampleArgs = {};
+	for (const name of required) exampleArgs[name] = `<${name}>`;
+	lines.push(`\`\`\`\nexec('/.actions/${actionName}', ${JSON.stringify(exampleArgs, null, 2)})\n\`\`\``);
+	return {
+		format: "markdown",
+		content: lines.join("\n")
+	};
+}
+/**
+* Explain a root meta path (/.meta or /.meta/{subpath}).
+* Returns null if the path is not a recognized root meta path.
+*/
+function explainRootMeta(path) {
+	if (path === "/.meta") {
+		const lines = [];
+		lines.push("# Root Metadata");
+		lines.push("");
+		lines.push("The `.meta` system provides metadata about any AFS node.");
+		lines.push("");
+		lines.push("## Available Sub-paths");
+		lines.push("");
+		lines.push("- **`.capabilities`** — Aggregated capabilities from all mounted providers");
+		lines.push("");
+		lines.push("Use `read('/.meta')` to get structured root metadata including mounted providers and available actions.");
+		return {
+			format: "markdown",
+			content: lines.join("\n")
+		};
+	}
+	if (path === "/.meta/.capabilities") {
+		const lines = [];
+		lines.push("# Capabilities");
+		lines.push("");
+		lines.push("Aggregated capabilities manifest from all mounted providers.");
+		lines.push("Describes the combined operations, tools, and action catalogs available across the system.");
+		lines.push("");
+		lines.push("Use `read('/.meta/.capabilities')` to get the full structured capabilities data.");
+		return {
+			format: "markdown",
+			content: lines.join("\n")
+		};
+	}
+	return null;
+}
+
+//#endregion
+exports.buildExplainFromStat = buildExplainFromStat;
+exports.buildVirtualDirExplain = buildVirtualDirExplain;
+exports.explainRoot = explainRoot;
+exports.explainRootAction = explainRootAction;
+exports.explainRootMeta = explainRootMeta;

package/dist/afs-explain.mjs

@@ -0,0 +1,220 @@
+//#region src/afs-explain.ts
+/**
+* Format bytes to human-readable string.
+*/
+function formatBytes(bytes) {
+	if (bytes === 0) return "0 B";
+	const k = 1024;
+	const sizes = [
+		"B",
+		"KB",
+		"MB",
+		"GB",
+		"TB"
+	];
+	const i = Math.floor(Math.log(bytes) / Math.log(k));
+	return `${Number.parseFloat((bytes / k ** i).toFixed(2))} ${sizes[i]}`;
+}
+/**
+* Build explain markdown from stat data.
+* Used by both the module-found fallback and the no-module safety net.
+*/
+function buildExplainFromStat(path, data) {
+	const lines = [];
+	lines.push(`# ${path}`);
+	lines.push("");
+	const meta = data.meta || {};
+	if (meta.size !== void 0) lines.push(`- **Size**: ${formatBytes(meta.size)}`);
+	if (meta.childrenCount !== void 0) lines.push(`- **Children**: ${meta.childrenCount} items`);
+	if (data.updatedAt) lines.push(`- **Modified**: ${data.updatedAt.toISOString()}`);
+	if (meta.description) {
+		lines.push("");
+		lines.push("## Description");
+		lines.push(String(meta.description));
+	}
+	if (meta.provider) lines.push(`- **Provider**: ${meta.provider}`);
+	if (meta.kind) lines.push(`- **Kind**: ${meta.kind}`);
+	if (meta.kinds && Array.isArray(meta.kinds)) lines.push(`- **Kinds**: ${meta.kinds.join(", ")}`);
+	if (data.actions && data.actions.length > 0) {
+		lines.push("");
+		lines.push("## Actions");
+		for (const action of data.actions) lines.push(`- **${action.name}**${action.description ? `: ${action.description}` : ""}`);
+	}
+	return {
+		format: "markdown",
+		content: lines.join("\n")
+	};
+}
+/**
+* Build explain for a virtual intermediate directory.
+*/
+function buildVirtualDirExplain(path, data) {
+	const childrenCount = data.meta?.childrenCount;
+	const lines = [];
+	lines.push(`# ${path}`);
+	lines.push("");
+	lines.push("- **Type**: Virtual directory");
+	if (childrenCount !== void 0) lines.push(`- **Children**: ${childrenCount} items`);
+	return {
+		format: "markdown",
+		content: lines.join("\n")
+	};
+}
+/**
+* Generate root explain: intro + 4 sections.
+*/
+async function explainRoot(mounts, listRootActions) {
+	const lines = [];
+	lines.push("# AFS — Agentic File System");
+	lines.push("");
+	lines.push("AFS is a virtual filesystem developed by [ArcBlock](https://www.arcblock.io) that gives AI agents a unified, path-based interface to any data source.");
+	lines.push("Inspired by Unix and Plan 9's \"everything is a file\", AFS extends the idea to **everything is context** — databases, APIs, smart home devices, and cloud services all become files and directories that agents can read, write, search, and act on.");
+	lines.push("");
+	lines.push("## Mounted Providers");
+	lines.push("");
+	if (mounts.length === 0) {
+		lines.push("No providers currently mounted. Use the `mount` action to add providers.");
+		lines.push("");
+	} else {
+		for (const m of mounts) if (m.module.description) {
+			const descLines = m.module.description.split("\n");
+			lines.push(`- **${m.module.name}** (\`${m.path}\`) — ${descLines[0]}`);
+			for (let i = 1; i < descLines.length; i++) lines.push(`  ${descLines[i]}`);
+		} else lines.push(`- **${m.module.name}** (\`${m.path}\`)`);
+		lines.push("");
+	}
+	lines.push("## Standard Operations");
+	lines.push("");
+	lines.push("- **read** — Read file or node content");
+	lines.push("- **list** — List children of a directory or container");
+	lines.push("- **stat** — Get metadata without content");
+	lines.push("- **explain** — Get human-readable documentation for a path");
+	lines.push("- **search** — Search within a mounted provider");
+	lines.push("- **write** — Create or update content");
+	lines.push("- **delete** — Remove a file or node");
+	lines.push("- **exec** — Execute an action at a path");
+	lines.push("");
+	lines.push("## Root Actions");
+	lines.push("");
+	const { data: actions } = await listRootActions();
+	for (const action of actions) {
+		const desc = action.actions?.[0]?.description || action.summary || "";
+		lines.push(`- **${action.id}** — ${desc}`);
+	}
+	lines.push("");
+	lines.push("Use `explain('/.actions/<name>')` for detailed usage.");
+	lines.push("");
+	lines.push("## Built-in Systems");
+	lines.push("");
+	lines.push("- **`.meta`** — Metadata for any node. Access via `read('/.meta')` at root, or append `/.meta` to any path.");
+	lines.push("- **`.actions`** — Executable actions. Access via `read('/.actions')` to list, `exec('/.actions/<name>', args)` to run.");
+	lines.push("");
+	return {
+		format: "markdown",
+		content: lines.join("\n")
+	};
+}
+/**
+* Explain a root action path (/.actions or /.actions/{name}).
+*/
+async function explainRootAction(path, listRootActions) {
+	if (path === "/.actions") {
+		const lines$1 = [];
+		lines$1.push("# Root Actions");
+		lines$1.push("");
+		lines$1.push("Available actions at the AFS root level:");
+		lines$1.push("");
+		const { data: actions$1 } = await listRootActions();
+		for (const action$1 of actions$1) {
+			const desc = action$1.actions?.[0]?.description || action$1.summary || "";
+			lines$1.push(`- **${action$1.id}** — ${desc}`);
+		}
+		lines$1.push("");
+		lines$1.push("Use `explain('/.actions/<name>')` for detailed parameters and usage.");
+		return {
+			format: "markdown",
+			content: lines$1.join("\n")
+		};
+	}
+	const actionName = path.slice(10);
+	const { data: actions } = await listRootActions();
+	const entry = actions.find((a) => a.id === actionName);
+	if (!entry) return {
+		format: "markdown",
+		content: ""
+	};
+	const action = entry.actions?.[0];
+	const lines = [];
+	lines.push(`# ${actionName}`);
+	lines.push("");
+	if (action?.description) {
+		lines.push(action.description);
+		lines.push("");
+	}
+	const schema = action?.inputSchema;
+	const properties = schema?.properties;
+	const required = schema?.required || [];
+	if (properties && Object.keys(properties).length > 0) {
+		lines.push("## Parameters");
+		lines.push("");
+		lines.push("| Name | Type | Required | Description |");
+		lines.push("|------|------|----------|-------------|");
+		for (const [name, prop] of Object.entries(properties)) {
+			const propObj = prop;
+			const type = propObj.type || "any";
+			const isRequired = required.includes(name) ? "yes" : "no";
+			const desc = propObj.description || "";
+			lines.push(`| ${name} | ${type} | ${isRequired} | ${desc} |`);
+		}
+		lines.push("");
+	}
+	lines.push("## Example");
+	lines.push("");
+	const exampleArgs = {};
+	for (const name of required) exampleArgs[name] = `<${name}>`;
+	lines.push(`\`\`\`\nexec('/.actions/${actionName}', ${JSON.stringify(exampleArgs, null, 2)})\n\`\`\``);
+	return {
+		format: "markdown",
+		content: lines.join("\n")
+	};
+}
+/**
+* Explain a root meta path (/.meta or /.meta/{subpath}).
+* Returns null if the path is not a recognized root meta path.
+*/
+function explainRootMeta(path) {
+	if (path === "/.meta") {
+		const lines = [];
+		lines.push("# Root Metadata");
+		lines.push("");
+		lines.push("The `.meta` system provides metadata about any AFS node.");
+		lines.push("");
+		lines.push("## Available Sub-paths");
+		lines.push("");
+		lines.push("- **`.capabilities`** — Aggregated capabilities from all mounted providers");
+		lines.push("");
+		lines.push("Use `read('/.meta')` to get structured root metadata including mounted providers and available actions.");
+		return {
+			format: "markdown",
+			content: lines.join("\n")
+		};
+	}
+	if (path === "/.meta/.capabilities") {
+		const lines = [];
+		lines.push("# Capabilities");
+		lines.push("");
+		lines.push("Aggregated capabilities manifest from all mounted providers.");
+		lines.push("Describes the combined operations, tools, and action catalogs available across the system.");
+		lines.push("");
+		lines.push("Use `read('/.meta/.capabilities')` to get the full structured capabilities data.");
+		return {
+			format: "markdown",
+			content: lines.join("\n")
+		};
+	}
+	return null;
+}
+
+//#endregion
+export { buildExplainFromStat, buildVirtualDirExplain, explainRoot, explainRootAction, explainRootMeta };
+//# sourceMappingURL=afs-explain.mjs.map

package/dist/afs-explain.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"afs-explain.mjs","names":["lines","actions","action"],"sources":["../src/afs-explain.ts"],"sourcesContent":["/**\n * Explain generation helpers for AFS.\n *\n * These functions produce human-readable markdown documentation\n * for AFS paths. They take structured data as input and return\n * formatted markdown — no AFS instance dependencies.\n */\nimport type { AFSEntry, AFSExplainResult, AFSListResult } from \"./type.js\";\n\n/** Mount info needed by explainRoot() */\nexport interface MountInfo {\n  path: string;\n  module: { name: string; description?: string };\n}\n\n/**\n * Format bytes to human-readable string.\n */\nexport function formatBytes(bytes: number): string {\n  if (bytes === 0) return \"0 B\";\n  const k = 1024;\n  const sizes = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\"];\n  const i = Math.floor(Math.log(bytes) / Math.log(k));\n  return `${Number.parseFloat((bytes / k ** i).toFixed(2))} ${sizes[i]}`;\n}\n\n/**\n * Build explain markdown from stat data.\n * Used by both the module-found fallback and the no-module safety net.\n */\nexport function buildExplainFromStat(\n  path: string,\n  data: Omit<AFSEntry, \"content\">,\n): AFSExplainResult {\n  const lines: string[] = [];\n  lines.push(`# ${path}`);\n  lines.push(\"\");\n\n  const meta = data.meta || {};\n\n  if (meta.size !== undefined) {\n    lines.push(`- **Size**: ${formatBytes(meta.size as number)}`);\n  }\n  if (meta.childrenCount !== undefined) {\n    lines.push(`- **Children**: ${meta.childrenCount} items`);\n  }\n  if (data.updatedAt) {\n    lines.push(`- **Modified**: ${data.updatedAt.toISOString()}`);\n  }\n\n  if (meta.description) {\n    lines.push(\"\");\n    lines.push(\"## Description\");\n    lines.push(String(meta.description));\n  }\n  if (meta.provider) {\n    lines.push(`- **Provider**: ${meta.provider}`);\n  }\n  if (meta.kind) {\n    lines.push(`- **Kind**: ${meta.kind}`);\n  }\n  if (meta.kinds && Array.isArray(meta.kinds)) {\n    lines.push(`- **Kinds**: ${meta.kinds.join(\", \")}`);\n  }\n\n  if (data.actions && data.actions.length > 0) {\n    lines.push(\"\");\n    lines.push(\"## Actions\");\n    for (const action of data.actions) {\n      lines.push(`- **${action.name}**${action.description ? `: ${action.description}` : \"\"}`);\n    }\n  }\n\n  return {\n    format: \"markdown\",\n    content: lines.join(\"\\n\"),\n  };\n}\n\n/**\n * Build explain for a virtual intermediate directory.\n */\nexport function buildVirtualDirExplain(path: string, data: AFSEntry): AFSExplainResult {\n  const childrenCount = data.meta?.childrenCount;\n  const lines: string[] = [];\n  lines.push(`# ${path}`);\n  lines.push(\"\");\n  lines.push(\"- **Type**: Virtual directory\");\n  if (childrenCount !== undefined) {\n    lines.push(`- **Children**: ${childrenCount} items`);\n  }\n\n  return {\n    format: \"markdown\",\n    content: lines.join(\"\\n\"),\n  };\n}\n\n/**\n * Generate root explain: intro + 4 sections.\n */\nexport async function explainRoot(\n  mounts: MountInfo[],\n  listRootActions: () => Promise<AFSListResult>,\n): Promise<AFSExplainResult> {\n  const lines: string[] = [];\n  lines.push(\"# AFS — Agentic File System\");\n  lines.push(\"\");\n  lines.push(\n    \"AFS is a virtual filesystem developed by [ArcBlock](https://www.arcblock.io) that gives AI agents a unified, path-based interface to any data source.\",\n  );\n  lines.push(\n    'Inspired by Unix and Plan 9\\'s \"everything is a file\", AFS extends the idea to **everything is context** — databases, APIs, smart home devices, and cloud services all become files and directories that agents can read, write, search, and act on.',\n  );\n  lines.push(\"\");\n\n  // Section 1: Mounted Providers\n  lines.push(\"## Mounted Providers\");\n  lines.push(\"\");\n  if (mounts.length === 0) {\n    lines.push(\"No providers currently mounted. Use the `mount` action to add providers.\");\n    lines.push(\"\");\n  } else {\n    for (const m of mounts) {\n      if (m.module.description) {\n        // Multi-line descriptions: first line as header, rest indented\n        const descLines = m.module.description.split(\"\\n\");\n        lines.push(`- **${m.module.name}** (\\`${m.path}\\`) — ${descLines[0]}`);\n        for (let i = 1; i < descLines.length; i++) {\n          lines.push(`  ${descLines[i]}`);\n        }\n      } else {\n        lines.push(`- **${m.module.name}** (\\`${m.path}\\`)`);\n      }\n    }\n    lines.push(\"\");\n  }\n\n  // Section 2: Standard Operations\n  lines.push(\"## Standard Operations\");\n  lines.push(\"\");\n  lines.push(\"- **read** — Read file or node content\");\n  lines.push(\"- **list** — List children of a directory or container\");\n  lines.push(\"- **stat** — Get metadata without content\");\n  lines.push(\"- **explain** — Get human-readable documentation for a path\");\n  lines.push(\"- **search** — Search within a mounted provider\");\n  lines.push(\"- **write** — Create or update content\");\n  lines.push(\"- **delete** — Remove a file or node\");\n  lines.push(\"- **exec** — Execute an action at a path\");\n  lines.push(\"\");\n\n  // Section 3: Root Actions\n  lines.push(\"## Root Actions\");\n  lines.push(\"\");\n  const { data: actions } = await listRootActions();\n  for (const action of actions) {\n    const desc = action.actions?.[0]?.description || action.summary || \"\";\n    lines.push(`- **${action.id}** — ${desc}`);\n  }\n  lines.push(\"\");\n  lines.push(\"Use `explain('/.actions/<name>')` for detailed usage.\");\n  lines.push(\"\");\n\n  // Section 4: Built-in Systems\n  lines.push(\"## Built-in Systems\");\n  lines.push(\"\");\n  lines.push(\n    \"- **`.meta`** — Metadata for any node. Access via `read('/.meta')` at root, or append `/.meta` to any path.\",\n  );\n  lines.push(\n    \"- **`.actions`** — Executable actions. Access via `read('/.actions')` to list, `exec('/.actions/<name>', args)` to run.\",\n  );\n  lines.push(\"\");\n\n  return { format: \"markdown\", content: lines.join(\"\\n\") };\n}\n\n/**\n * Explain a root action path (/.actions or /.actions/{name}).\n */\nexport async function explainRootAction(\n  path: string,\n  listRootActions: () => Promise<AFSListResult>,\n): Promise<AFSExplainResult> {\n  if (path === \"/.actions\") {\n    const lines: string[] = [];\n    lines.push(\"# Root Actions\");\n    lines.push(\"\");\n    lines.push(\"Available actions at the AFS root level:\");\n    lines.push(\"\");\n    const { data: actions } = await listRootActions();\n    for (const action of actions) {\n      const desc = action.actions?.[0]?.description || action.summary || \"\";\n      lines.push(`- **${action.id}** — ${desc}`);\n    }\n    lines.push(\"\");\n    lines.push(\"Use `explain('/.actions/<name>')` for detailed parameters and usage.\");\n    return { format: \"markdown\", content: lines.join(\"\\n\") };\n  }\n\n  // /.actions/{name} — generate parameter table from inputSchema\n  const actionName = path.slice(\"/.actions/\".length);\n  const { data: actions } = await listRootActions();\n  const entry = actions.find((a) => a.id === actionName);\n  if (!entry) {\n    // Caller should handle AFSNotFoundError\n    return { format: \"markdown\", content: \"\" };\n  }\n\n  const action = entry.actions?.[0];\n  const lines: string[] = [];\n  lines.push(`# ${actionName}`);\n  lines.push(\"\");\n  if (action?.description) {\n    lines.push(action.description);\n    lines.push(\"\");\n  }\n\n  // Parameter table from inputSchema\n  const schema = action?.inputSchema as Record<string, any> | undefined;\n  const properties = schema?.properties as Record<string, any> | undefined;\n  const required = (schema?.required as string[]) || [];\n\n  if (properties && Object.keys(properties).length > 0) {\n    lines.push(\"## Parameters\");\n    lines.push(\"\");\n    lines.push(\"| Name | Type | Required | Description |\");\n    lines.push(\"|------|------|----------|-------------|\");\n    for (const [name, prop] of Object.entries(properties)) {\n      const propObj = prop as Record<string, unknown>;\n      const type = (propObj.type as string) || \"any\";\n      const isRequired = required.includes(name) ? \"yes\" : \"no\";\n      const desc = (propObj.description as string) || \"\";\n      lines.push(`| ${name} | ${type} | ${isRequired} | ${desc} |`);\n    }\n    lines.push(\"\");\n  }\n\n  // Usage example\n  lines.push(\"## Example\");\n  lines.push(\"\");\n  const exampleArgs: Record<string, string> = {};\n  for (const name of required) {\n    exampleArgs[name] = `<${name}>`;\n  }\n  lines.push(\n    `\\`\\`\\`\\nexec('/.actions/${actionName}', ${JSON.stringify(exampleArgs, null, 2)})\\n\\`\\`\\``,\n  );\n\n  return { format: \"markdown\", content: lines.join(\"\\n\") };\n}\n\n/**\n * Explain a root meta path (/.meta or /.meta/{subpath}).\n * Returns null if the path is not a recognized root meta path.\n */\nexport function explainRootMeta(path: string): AFSExplainResult | null {\n  if (path === \"/.meta\") {\n    const lines: string[] = [];\n    lines.push(\"# Root Metadata\");\n    lines.push(\"\");\n    lines.push(\"The `.meta` system provides metadata about any AFS node.\");\n    lines.push(\"\");\n    lines.push(\"## Available Sub-paths\");\n    lines.push(\"\");\n    lines.push(\"- **`.capabilities`** — Aggregated capabilities from all mounted providers\");\n    lines.push(\"\");\n    lines.push(\n      \"Use `read('/.meta')` to get structured root metadata including mounted providers and available actions.\",\n    );\n    return { format: \"markdown\", content: lines.join(\"\\n\") };\n  }\n\n  if (path === \"/.meta/.capabilities\") {\n    const lines: string[] = [];\n    lines.push(\"# Capabilities\");\n    lines.push(\"\");\n    lines.push(\"Aggregated capabilities manifest from all mounted providers.\");\n    lines.push(\n      \"Describes the combined operations, tools, and action catalogs available across the system.\",\n    );\n    lines.push(\"\");\n    lines.push(\"Use `read('/.meta/.capabilities')` to get the full structured capabilities data.\");\n    return { format: \"markdown\", content: lines.join(\"\\n\") };\n  }\n\n  return null;\n}\n"],"mappings":"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"}