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

package/dist/core/formatters/explain.cjs

@@ -0,0 +1,97 @@
+
+//#region src/core/formatters/explain.ts
+/**
+* Format concept explain output for different views
+*/
+function formatExplainOutput(result, view) {
+	switch (view) {
+		case "json": return JSON.stringify(result, null, 2);
+		case "llm": return formatLlm(result);
+		default: return formatDefault(result);
+	}
+}
+function formatDefault(result) {
+	let output = `${result.topic}\n${"=".repeat(result.topic.length)}\n\n${result.explanation}`;
+	if (result.examples && result.examples.length > 0) output += `\n\nExamples:\n${result.examples.map((e) => `  $ ${e}`).join("\n")}`;
+	return output;
+}
+function formatLlm(result) {
+	const lines = [
+		`TOPIC ${result.topic}`,
+		"",
+		result.explanation
+	];
+	if (result.examples && result.examples.length > 0) {
+		lines.push("", "EXAMPLES");
+		for (const example of result.examples) lines.push(`CMD ${example}`);
+	}
+	return lines.join("\n");
+}
+/**
+* Format path explain output for different views
+*/
+function formatPathExplainOutput(result, view) {
+	switch (view) {
+		case "json": return JSON.stringify(result, null, 2);
+		case "llm": return formatPathLlm(result);
+		default: return formatPathDefault(result);
+	}
+}
+function formatPathDefault(result) {
+	const lines = [];
+	lines.push(`PATH ${result.path}`);
+	lines.push("");
+	lines.push("TYPE");
+	lines.push(result.type);
+	if (result.description) {
+		lines.push("");
+		lines.push("DESCRIPTION");
+		lines.push(result.description);
+	}
+	if (result.inputs && result.inputs.length > 0) {
+		lines.push("");
+		lines.push("INPUTS");
+		for (const input of result.inputs) lines.push(`- ${input}`);
+	}
+	if (result.outputs && result.outputs.length > 0) {
+		lines.push("");
+		lines.push("OUTPUTS");
+		for (const output of result.outputs) lines.push(`- ${output}`);
+	}
+	if (result.errors && result.errors.length > 0) {
+		lines.push("");
+		lines.push("ERRORS");
+		for (const error of result.errors) lines.push(`- ${error}`);
+	}
+	if (result.sideEffects && result.sideEffects.length > 0) {
+		lines.push("");
+		lines.push("SIDE EFFECTS");
+		for (const effect of result.sideEffects) lines.push(`- ${effect}`);
+	} else {
+		lines.push("");
+		lines.push("SIDE EFFECTS");
+		lines.push("- none");
+	}
+	if (result.meta && Object.keys(result.meta).length > 0) {
+		lines.push("");
+		lines.push("METADATA");
+		for (const [key, value] of Object.entries(result.meta)) lines.push(`- ${key}: ${value}`);
+	}
+	return lines.join("\n");
+}
+function formatPathLlm(result) {
+	const lines = [];
+	lines.push(`PATH ${result.path}`);
+	lines.push(`TYPE ${result.type.toUpperCase()}`);
+	if (result.description) lines.push(`DESC ${result.description}`);
+	if (result.inputs && result.inputs.length > 0) lines.push(`INPUTS ${result.inputs.join(", ")}`);
+	if (result.outputs && result.outputs.length > 0) lines.push(`OUTPUTS ${result.outputs.join(", ")}`);
+	if (result.errors && result.errors.length > 0) lines.push(`ERRORS ${result.errors.join(", ")}`);
+	lines.push(`SIDE_EFFECTS ${result.sideEffects?.join(", ") || "none"}`);
+	if (result.meta) for (const [key, value] of Object.entries(result.meta)) lines.push(`${key.toUpperCase()} ${value}`);
+	return lines.join("\n");
+}
+
+//#endregion
+exports.formatExplainOutput = formatExplainOutput;
+exports.formatPathExplainOutput = formatPathExplainOutput;

package/dist/core/formatters/explain.d.cts

@@ -0,0 +1,11 @@
+import { ViewType } from "../types.cjs";
+import { ExplainResult } from "../commands/explain.cjs";
+
+//#region src/core/formatters/explain.d.ts
+/**
+ * Format concept explain output for different views
+ */
+declare function formatExplainOutput(result: ExplainResult, view: ViewType): string;
+//#endregion
+export { formatExplainOutput };
+//# sourceMappingURL=explain.d.cts.map

package/dist/core/formatters/explain.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.cts","names":[],"sources":["../../../src/core/formatters/explain.ts"],"mappings":";;;;;;;iBAagB,mBAAA,CAAoB,MAAA,EAAQ,aAAA,EAAe,IAAA,EAAM,QAAA"}

package/dist/core/formatters/explain.d.mts

@@ -0,0 +1,11 @@
+import { ViewType } from "../types.mjs";
+import { ExplainResult } from "../commands/explain.mjs";
+
+//#region src/core/formatters/explain.d.ts
+/**
+ * Format concept explain output for different views
+ */
+declare function formatExplainOutput(result: ExplainResult, view: ViewType): string;
+//#endregion
+export { formatExplainOutput };
+//# sourceMappingURL=explain.d.mts.map

package/dist/core/formatters/explain.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.mts","names":[],"sources":["../../../src/core/formatters/explain.ts"],"mappings":";;;;;;;iBAagB,mBAAA,CAAoB,MAAA,EAAQ,aAAA,EAAe,IAAA,EAAM,QAAA"}

package/dist/core/formatters/explain.mjs

@@ -0,0 +1,96 @@
+//#region src/core/formatters/explain.ts
+/**
+* Format concept explain output for different views
+*/
+function formatExplainOutput(result, view) {
+	switch (view) {
+		case "json": return JSON.stringify(result, null, 2);
+		case "llm": return formatLlm(result);
+		default: return formatDefault(result);
+	}
+}
+function formatDefault(result) {
+	let output = `${result.topic}\n${"=".repeat(result.topic.length)}\n\n${result.explanation}`;
+	if (result.examples && result.examples.length > 0) output += `\n\nExamples:\n${result.examples.map((e) => `  $ ${e}`).join("\n")}`;
+	return output;
+}
+function formatLlm(result) {
+	const lines = [
+		`TOPIC ${result.topic}`,
+		"",
+		result.explanation
+	];
+	if (result.examples && result.examples.length > 0) {
+		lines.push("", "EXAMPLES");
+		for (const example of result.examples) lines.push(`CMD ${example}`);
+	}
+	return lines.join("\n");
+}
+/**
+* Format path explain output for different views
+*/
+function formatPathExplainOutput(result, view) {
+	switch (view) {
+		case "json": return JSON.stringify(result, null, 2);
+		case "llm": return formatPathLlm(result);
+		default: return formatPathDefault(result);
+	}
+}
+function formatPathDefault(result) {
+	const lines = [];
+	lines.push(`PATH ${result.path}`);
+	lines.push("");
+	lines.push("TYPE");
+	lines.push(result.type);
+	if (result.description) {
+		lines.push("");
+		lines.push("DESCRIPTION");
+		lines.push(result.description);
+	}
+	if (result.inputs && result.inputs.length > 0) {
+		lines.push("");
+		lines.push("INPUTS");
+		for (const input of result.inputs) lines.push(`- ${input}`);
+	}
+	if (result.outputs && result.outputs.length > 0) {
+		lines.push("");
+		lines.push("OUTPUTS");
+		for (const output of result.outputs) lines.push(`- ${output}`);
+	}
+	if (result.errors && result.errors.length > 0) {
+		lines.push("");
+		lines.push("ERRORS");
+		for (const error of result.errors) lines.push(`- ${error}`);
+	}
+	if (result.sideEffects && result.sideEffects.length > 0) {
+		lines.push("");
+		lines.push("SIDE EFFECTS");
+		for (const effect of result.sideEffects) lines.push(`- ${effect}`);
+	} else {
+		lines.push("");
+		lines.push("SIDE EFFECTS");
+		lines.push("- none");
+	}
+	if (result.meta && Object.keys(result.meta).length > 0) {
+		lines.push("");
+		lines.push("METADATA");
+		for (const [key, value] of Object.entries(result.meta)) lines.push(`- ${key}: ${value}`);
+	}
+	return lines.join("\n");
+}
+function formatPathLlm(result) {
+	const lines = [];
+	lines.push(`PATH ${result.path}`);
+	lines.push(`TYPE ${result.type.toUpperCase()}`);
+	if (result.description) lines.push(`DESC ${result.description}`);
+	if (result.inputs && result.inputs.length > 0) lines.push(`INPUTS ${result.inputs.join(", ")}`);
+	if (result.outputs && result.outputs.length > 0) lines.push(`OUTPUTS ${result.outputs.join(", ")}`);
+	if (result.errors && result.errors.length > 0) lines.push(`ERRORS ${result.errors.join(", ")}`);
+	lines.push(`SIDE_EFFECTS ${result.sideEffects?.join(", ") || "none"}`);
+	if (result.meta) for (const [key, value] of Object.entries(result.meta)) lines.push(`${key.toUpperCase()} ${value}`);
+	return lines.join("\n");
+}
+
+//#endregion
+export { formatExplainOutput, formatPathExplainOutput };
+//# sourceMappingURL=explain.mjs.map

package/dist/core/formatters/explain.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.mjs","names":[],"sources":["../../../src/core/formatters/explain.ts"],"sourcesContent":["/**\n * explain Formatter - Core Implementation\n *\n * Formats explain output for concepts and paths.\n * Matches old version output format.\n */\n\nimport type { ExplainResult, PathExplainResult } from \"../commands/explain.js\";\nimport type { ViewType } from \"../types.js\";\n\n/**\n * Format concept explain output for different views\n */\nexport function formatExplainOutput(result: ExplainResult, view: ViewType): string {\n  switch (view) {\n    case \"json\":\n      return JSON.stringify(result, null, 2);\n    case \"llm\":\n      return formatLlm(result);\n    default:\n      return formatDefault(result);\n  }\n}\n\nfunction formatDefault(result: ExplainResult): string {\n  let output = `${result.topic}\\n${\"=\".repeat(result.topic.length)}\\n\\n${result.explanation}`;\n\n  if (result.examples && result.examples.length > 0) {\n    output += `\\n\\nExamples:\\n${result.examples.map((e) => `  $ ${e}`).join(\"\\n\")}`;\n  }\n\n  return output;\n}\n\nfunction formatLlm(result: ExplainResult): string {\n  const lines = [`TOPIC ${result.topic}`, \"\", result.explanation];\n\n  if (result.examples && result.examples.length > 0) {\n    lines.push(\"\", \"EXAMPLES\");\n    for (const example of result.examples) {\n      lines.push(`CMD ${example}`);\n    }\n  }\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Format path explain output for different views\n */\nexport function formatPathExplainOutput(result: PathExplainResult, view: ViewType): string {\n  switch (view) {\n    case \"json\":\n      return JSON.stringify(result, null, 2);\n    case \"llm\":\n      return formatPathLlm(result);\n    default:\n      return formatPathDefault(result);\n  }\n}\n\nfunction formatPathDefault(result: PathExplainResult): string {\n  const lines: string[] = [];\n\n  lines.push(`PATH ${result.path}`);\n  lines.push(\"\");\n  lines.push(\"TYPE\");\n  lines.push(result.type);\n\n  if (result.description) {\n    lines.push(\"\");\n    lines.push(\"DESCRIPTION\");\n    lines.push(result.description);\n  }\n\n  if (result.inputs && result.inputs.length > 0) {\n    lines.push(\"\");\n    lines.push(\"INPUTS\");\n    for (const input of result.inputs) {\n      lines.push(`- ${input}`);\n    }\n  }\n\n  if (result.outputs && result.outputs.length > 0) {\n    lines.push(\"\");\n    lines.push(\"OUTPUTS\");\n    for (const output of result.outputs) {\n      lines.push(`- ${output}`);\n    }\n  }\n\n  if (result.errors && result.errors.length > 0) {\n    lines.push(\"\");\n    lines.push(\"ERRORS\");\n    for (const error of result.errors) {\n      lines.push(`- ${error}`);\n    }\n  }\n\n  if (result.sideEffects && result.sideEffects.length > 0) {\n    lines.push(\"\");\n    lines.push(\"SIDE EFFECTS\");\n    for (const effect of result.sideEffects) {\n      lines.push(`- ${effect}`);\n    }\n  } else {\n    lines.push(\"\");\n    lines.push(\"SIDE EFFECTS\");\n    lines.push(\"- none\");\n  }\n\n  if (result.meta && Object.keys(result.meta).length > 0) {\n    lines.push(\"\");\n    lines.push(\"METADATA\");\n    for (const [key, value] of Object.entries(result.meta)) {\n      lines.push(`- ${key}: ${value}`);\n    }\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction formatPathLlm(result: PathExplainResult): string {\n  const lines: string[] = [];\n\n  lines.push(`PATH ${result.path}`);\n  lines.push(`TYPE ${result.type.toUpperCase()}`);\n\n  if (result.description) {\n    lines.push(`DESC ${result.description}`);\n  }\n\n  if (result.inputs && result.inputs.length > 0) {\n    lines.push(`INPUTS ${result.inputs.join(\", \")}`);\n  }\n\n  if (result.outputs && result.outputs.length > 0) {\n    lines.push(`OUTPUTS ${result.outputs.join(\", \")}`);\n  }\n\n  if (result.errors && result.errors.length > 0) {\n    lines.push(`ERRORS ${result.errors.join(\", \")}`);\n  }\n\n  lines.push(`SIDE_EFFECTS ${result.sideEffects?.join(\", \") || \"none\"}`);\n\n  if (result.meta) {\n    for (const [key, value] of Object.entries(result.meta)) {\n      lines.push(`${key.toUpperCase()} ${value}`);\n    }\n  }\n\n  return lines.join(\"\\n\");\n}\n"],"mappings":"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"}

package/dist/core/formatters/index.d.mts

@@ -0,0 +1,9 @@
+import { formatDeleteOutput } from "./delete.mjs";
+import { formatExecOutput } from "./exec.mjs";
+import { formatExplainOutput } from "./explain.mjs";
+import { formatLsOutput } from "./ls.mjs";
+import { formatMountListOutput } from "./mount.mjs";
+import { formatReadOutput } from "./read.mjs";
+import "./search.mjs";
+import { formatStatOutput } from "./stat.mjs";
+import { formatWriteOutput } from "./write.mjs";

package/dist/core/formatters/ls.cjs

@@ -0,0 +1,179 @@
+
+//#region src/core/formatters/ls.ts
+/**
+* Check if a path is an actions path
+*/
+function isActionsPath(path) {
+	return path.endsWith("/.actions") || path.includes("/.actions/");
+}
+/**
+* Format ls output for different views
+*
+* @param result - AFS list result (native type)
+* @param view - View type (default, json, llm, human)
+* @param options - Format options
+* @returns Formatted string (no ANSI colors)
+*/
+function formatLsOutput(result, view, options) {
+	const isActions = options?.path && isActionsPath(options.path);
+	switch (view) {
+		case "json": return isActions ? formatActionsJson(result, options.path) : formatJson(result);
+		case "llm": return isActions ? formatActionsLlm(result, options.path) : formatLlm(result);
+		case "human": return isActions ? formatActionsHuman(result, options.path) : formatHuman(result);
+		default: return isActions ? formatActionsDefault(result) : formatDefault(result);
+	}
+}
+/**
+* Default format: Machine truth, one path per line
+*/
+function formatDefault(result) {
+	if (result.data.length === 0 && result.message) return `# ${result.message}`;
+	const lines = result.data.map((entry) => entry.path);
+	if (result.total !== void 0 && result.total > result.data.length) lines.push(`# Results truncated (${result.data.length} of ${result.total} shown)`);
+	return lines.join("\n");
+}
+/**
+* JSON format: Structured output with meta field preserved
+*/
+function formatJson(result) {
+	const entries = result.data.map((entry) => {
+		const output = { path: entry.path };
+		if (entry.meta && Object.keys(entry.meta).length > 0) output.meta = entry.meta;
+		return output;
+	});
+	return JSON.stringify({
+		entries,
+		total: result.total ?? entries.length
+	}, null, 2);
+}
+/**
+* LLM format: Token-efficient, semantic facts
+*/
+function formatLlm(result) {
+	const lines = [];
+	if (result.data.length === 0 && result.message) {
+		lines.push(`ERROR ${result.message}`);
+		return lines.join("\n");
+	}
+	for (const entry of result.data) {
+		const parts = [`ENTRY ${entry.path}`];
+		if (entry.meta?.kind) parts.push(`KIND=${entry.meta.kind}`);
+		if (entry.meta?.size !== void 0) parts.push(`SIZE=${entry.meta.size}`);
+		if (entry.meta?.childrenCount !== void 0) parts.push(`CHILDREN=${entry.meta.childrenCount}`);
+		lines.push(parts.join(" "));
+	}
+	lines.push(`TOTAL ${result.data.length}`);
+	if (result.total !== void 0 && result.total > result.data.length) lines.push("TRUNCATED true");
+	return lines.join("\n");
+}
+/**
+* Human format: Tree structure (without colors)
+*/
+function formatHuman(result) {
+	if (result.data.length === 0 && result.message) return result.message;
+	const root = {
+		name: "",
+		children: /* @__PURE__ */ new Map()
+	};
+	for (const entry of result.data) {
+		const parts = entry.path.split("/").filter(Boolean);
+		let current = root;
+		for (let i = 0; i < parts.length; i++) {
+			const part = parts[i];
+			if (!current.children.has(part)) current.children.set(part, {
+				name: part,
+				children: /* @__PURE__ */ new Map()
+			});
+			current = current.children.get(part);
+			if (i === parts.length - 1) current.entry = entry;
+		}
+	}
+	const lines = [];
+	renderTree(root, "", lines);
+	if (result.total !== void 0 && result.total > result.data.length) {
+		lines.push("");
+		lines.push(`(Results truncated - ${result.data.length} of ${result.total} entries shown)`);
+	}
+	return lines.join("\n");
+}
+function renderTree(node, prefix, lines) {
+	const children = Array.from(node.children.values());
+	for (let i = 0; i < children.length; i++) {
+		const child = children[i];
+		const isLast = i === children.length - 1;
+		const connector = isLast ? "└── " : "├── ";
+		const icon = typeof child.entry?.meta?.childrenCount === "number" || child.children.size > 0 ? "📁" : "📄";
+		const sizeStr = child.entry?.meta?.size !== void 0 ? `  ${formatSize(child.entry.meta.size)}` : "";
+		const kindStr = child.entry?.meta?.kind ? ` (${child.entry.meta.kind})` : "";
+		lines.push(`${prefix}${connector}${icon} ${child.name}${kindStr}${sizeStr}`);
+		renderTree(child, prefix + (isLast ? "    " : "│   "), lines);
+	}
+}
+function formatSize(bytes) {
+	if (bytes < 1024) return `${bytes}B`;
+	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
+	return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+function getActionName(entry) {
+	const parts = entry.path.split("/");
+	return parts[parts.length - 1] || entry.path;
+}
+function getActionDescription(entry) {
+	return entry.meta?.description;
+}
+function getNodePathFromActions(actionsPath) {
+	const idx = actionsPath.lastIndexOf("/.actions");
+	return idx > 0 ? actionsPath.substring(0, idx) : "/";
+}
+function formatActionsHuman(result, path) {
+	const lines = [];
+	const nodePath = getNodePathFromActions(path);
+	if (result.data.length === 0) {
+		lines.push(`No actions available for ${nodePath}`);
+		return lines.join("\n");
+	}
+	lines.push(`Available actions for ${nodePath}:`);
+	lines.push("");
+	const maxNameLen = Math.max(...result.data.map((e) => getActionName(e).length));
+	for (const entry of result.data) {
+		const name = getActionName(entry);
+		const desc = getActionDescription(entry) || "";
+		lines.push(`  ${name.padEnd(maxNameLen + 2)}${desc}`);
+	}
+	return lines.join("\n");
+}
+function formatActionsLlm(result, path) {
+	const lines = [];
+	lines.push(`ACTIONS ${path}`);
+	if (result.data.length === 0) {
+		lines.push("ACTIONS_COUNT 0");
+		return lines.join("\n");
+	}
+	for (const entry of result.data) {
+		const name = getActionName(entry);
+		const desc = getActionDescription(entry);
+		const schema = entry.meta?.inputSchema;
+		const descPart = desc ? ` DESCRIPTION "${desc}"` : "";
+		const schemaPart = schema !== void 0 ? ` SCHEMA ${JSON.stringify(schema)}` : "";
+		lines.push(`ACTION ${name}${descPart}${schemaPart}`);
+	}
+	return lines.join("\n");
+}
+function formatActionsJson(result, path) {
+	const actions = result.data.map((entry) => ({
+		name: getActionName(entry),
+		description: getActionDescription(entry),
+		inputSchema: entry.meta?.inputSchema
+	}));
+	return JSON.stringify({
+		path,
+		data: actions
+	}, null, 2);
+}
+function formatActionsDefault(result) {
+	if (result.data.length === 0) return "";
+	return result.data.map((entry) => getActionName(entry)).join("\n");
+}
+
+//#endregion
+exports.formatLsOutput = formatLsOutput;

package/dist/core/formatters/ls.d.cts

@@ -0,0 +1,20 @@
+import { ViewType } from "../types.cjs";
+import { AFSListResult } from "@aigne/afs";
+
+//#region src/core/formatters/ls.d.ts
+interface FormatLsOptions {
+  /** The path being listed (used for special formatting of .actions paths) */
+  path?: string;
+}
+/**
+ * Format ls output for different views
+ *
+ * @param result - AFS list result (native type)
+ * @param view - View type (default, json, llm, human)
+ * @param options - Format options
+ * @returns Formatted string (no ANSI colors)
+ */
+declare function formatLsOutput(result: AFSListResult, view: ViewType, options?: FormatLsOptions): string;
+//#endregion
+export { FormatLsOptions, formatLsOutput };
+//# sourceMappingURL=ls.d.cts.map

package/dist/core/formatters/ls.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.d.cts","names":[],"sources":["../../../src/core/formatters/ls.ts"],"mappings":";;;;UAUiB,eAAA;EAoBD;EAlBd,IAAA;AAAA;;;;;;;;;iBAkBc,cAAA,CACd,MAAA,EAAQ,aAAA,EACR,IAAA,EAAM,QAAA,EACN,OAAA,GAAU,eAAA"}

package/dist/core/formatters/ls.d.mts

@@ -0,0 +1,20 @@
+import { ViewType } from "../types.mjs";
+import { AFSListResult } from "@aigne/afs";
+
+//#region src/core/formatters/ls.d.ts
+interface FormatLsOptions {
+  /** The path being listed (used for special formatting of .actions paths) */
+  path?: string;
+}
+/**
+ * Format ls output for different views
+ *
+ * @param result - AFS list result (native type)
+ * @param view - View type (default, json, llm, human)
+ * @param options - Format options
+ * @returns Formatted string (no ANSI colors)
+ */
+declare function formatLsOutput(result: AFSListResult, view: ViewType, options?: FormatLsOptions): string;
+//#endregion
+export { FormatLsOptions, formatLsOutput };
+//# sourceMappingURL=ls.d.mts.map

package/dist/core/formatters/ls.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.d.mts","names":[],"sources":["../../../src/core/formatters/ls.ts"],"mappings":";;;;UAUiB,eAAA;EAoBD;EAlBd,IAAA;AAAA;;;;;;;;;iBAkBc,cAAA,CACd,MAAA,EAAQ,aAAA,EACR,IAAA,EAAM,QAAA,EACN,OAAA,GAAU,eAAA"}

package/dist/core/formatters/ls.mjs

@@ -0,0 +1,179 @@
+//#region src/core/formatters/ls.ts
+/**
+* Check if a path is an actions path
+*/
+function isActionsPath(path) {
+	return path.endsWith("/.actions") || path.includes("/.actions/");
+}
+/**
+* Format ls output for different views
+*
+* @param result - AFS list result (native type)
+* @param view - View type (default, json, llm, human)
+* @param options - Format options
+* @returns Formatted string (no ANSI colors)
+*/
+function formatLsOutput(result, view, options) {
+	const isActions = options?.path && isActionsPath(options.path);
+	switch (view) {
+		case "json": return isActions ? formatActionsJson(result, options.path) : formatJson(result);
+		case "llm": return isActions ? formatActionsLlm(result, options.path) : formatLlm(result);
+		case "human": return isActions ? formatActionsHuman(result, options.path) : formatHuman(result);
+		default: return isActions ? formatActionsDefault(result) : formatDefault(result);
+	}
+}
+/**
+* Default format: Machine truth, one path per line
+*/
+function formatDefault(result) {
+	if (result.data.length === 0 && result.message) return `# ${result.message}`;
+	const lines = result.data.map((entry) => entry.path);
+	if (result.total !== void 0 && result.total > result.data.length) lines.push(`# Results truncated (${result.data.length} of ${result.total} shown)`);
+	return lines.join("\n");
+}
+/**
+* JSON format: Structured output with meta field preserved
+*/
+function formatJson(result) {
+	const entries = result.data.map((entry) => {
+		const output = { path: entry.path };
+		if (entry.meta && Object.keys(entry.meta).length > 0) output.meta = entry.meta;
+		return output;
+	});
+	return JSON.stringify({
+		entries,
+		total: result.total ?? entries.length
+	}, null, 2);
+}
+/**
+* LLM format: Token-efficient, semantic facts
+*/
+function formatLlm(result) {
+	const lines = [];
+	if (result.data.length === 0 && result.message) {
+		lines.push(`ERROR ${result.message}`);
+		return lines.join("\n");
+	}
+	for (const entry of result.data) {
+		const parts = [`ENTRY ${entry.path}`];
+		if (entry.meta?.kind) parts.push(`KIND=${entry.meta.kind}`);
+		if (entry.meta?.size !== void 0) parts.push(`SIZE=${entry.meta.size}`);
+		if (entry.meta?.childrenCount !== void 0) parts.push(`CHILDREN=${entry.meta.childrenCount}`);
+		lines.push(parts.join(" "));
+	}
+	lines.push(`TOTAL ${result.data.length}`);
+	if (result.total !== void 0 && result.total > result.data.length) lines.push("TRUNCATED true");
+	return lines.join("\n");
+}
+/**
+* Human format: Tree structure (without colors)
+*/
+function formatHuman(result) {
+	if (result.data.length === 0 && result.message) return result.message;
+	const root = {
+		name: "",
+		children: /* @__PURE__ */ new Map()
+	};
+	for (const entry of result.data) {
+		const parts = entry.path.split("/").filter(Boolean);
+		let current = root;
+		for (let i = 0; i < parts.length; i++) {
+			const part = parts[i];
+			if (!current.children.has(part)) current.children.set(part, {
+				name: part,
+				children: /* @__PURE__ */ new Map()
+			});
+			current = current.children.get(part);
+			if (i === parts.length - 1) current.entry = entry;
+		}
+	}
+	const lines = [];
+	renderTree(root, "", lines);
+	if (result.total !== void 0 && result.total > result.data.length) {
+		lines.push("");
+		lines.push(`(Results truncated - ${result.data.length} of ${result.total} entries shown)`);
+	}
+	return lines.join("\n");
+}
+function renderTree(node, prefix, lines) {
+	const children = Array.from(node.children.values());
+	for (let i = 0; i < children.length; i++) {
+		const child = children[i];
+		const isLast = i === children.length - 1;
+		const connector = isLast ? "└── " : "├── ";
+		const icon = typeof child.entry?.meta?.childrenCount === "number" || child.children.size > 0 ? "📁" : "📄";
+		const sizeStr = child.entry?.meta?.size !== void 0 ? `  ${formatSize(child.entry.meta.size)}` : "";
+		const kindStr = child.entry?.meta?.kind ? ` (${child.entry.meta.kind})` : "";
+		lines.push(`${prefix}${connector}${icon} ${child.name}${kindStr}${sizeStr}`);
+		renderTree(child, prefix + (isLast ? "    " : "│   "), lines);
+	}
+}
+function formatSize(bytes) {
+	if (bytes < 1024) return `${bytes}B`;
+	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
+	return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+function getActionName(entry) {
+	const parts = entry.path.split("/");
+	return parts[parts.length - 1] || entry.path;
+}
+function getActionDescription(entry) {
+	return entry.meta?.description;
+}
+function getNodePathFromActions(actionsPath) {
+	const idx = actionsPath.lastIndexOf("/.actions");
+	return idx > 0 ? actionsPath.substring(0, idx) : "/";
+}
+function formatActionsHuman(result, path) {
+	const lines = [];
+	const nodePath = getNodePathFromActions(path);
+	if (result.data.length === 0) {
+		lines.push(`No actions available for ${nodePath}`);
+		return lines.join("\n");
+	}
+	lines.push(`Available actions for ${nodePath}:`);
+	lines.push("");
+	const maxNameLen = Math.max(...result.data.map((e) => getActionName(e).length));
+	for (const entry of result.data) {
+		const name = getActionName(entry);
+		const desc = getActionDescription(entry) || "";
+		lines.push(`  ${name.padEnd(maxNameLen + 2)}${desc}`);
+	}
+	return lines.join("\n");
+}
+function formatActionsLlm(result, path) {
+	const lines = [];
+	lines.push(`ACTIONS ${path}`);
+	if (result.data.length === 0) {
+		lines.push("ACTIONS_COUNT 0");
+		return lines.join("\n");
+	}
+	for (const entry of result.data) {
+		const name = getActionName(entry);
+		const desc = getActionDescription(entry);
+		const schema = entry.meta?.inputSchema;
+		const descPart = desc ? ` DESCRIPTION "${desc}"` : "";
+		const schemaPart = schema !== void 0 ? ` SCHEMA ${JSON.stringify(schema)}` : "";
+		lines.push(`ACTION ${name}${descPart}${schemaPart}`);
+	}
+	return lines.join("\n");
+}
+function formatActionsJson(result, path) {
+	const actions = result.data.map((entry) => ({
+		name: getActionName(entry),
+		description: getActionDescription(entry),
+		inputSchema: entry.meta?.inputSchema
+	}));
+	return JSON.stringify({
+		path,
+		data: actions
+	}, null, 2);
+}
+function formatActionsDefault(result) {
+	if (result.data.length === 0) return "";
+	return result.data.map((entry) => getActionName(entry)).join("\n");
+}
+
+//#endregion
+export { formatLsOutput };
+//# sourceMappingURL=ls.mjs.map