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

package/dist/commands/ls.mjs

@@ -1,4 +1,5 @@
 import { colors } from "../ui/index.mjs";
+import { isActionsPath } from "../utils/meta.mjs";
 
 //#region src/commands/ls.ts
 /**
@@ -11,15 +12,18 @@ async function lsCommand(runtime, path, options = {}) {
 		maxChildren: options.maxChildren,
 		pattern: options.pattern
 	});
-	const entries = result.data.map((entry) => ({
-		path: entry.path,
-		type: mapEntryType(entry.metadata?.type),
-		size: entry.metadata?.size,
-		modified: formatDate(entry.updatedAt),
-		childrenCount: entry.metadata?.childrenCount,
-		childrenTruncated: entry.metadata?.childrenTruncated
-	}));
-	const truncated = entries.some((e) => e.childrenTruncated) || options.limit !== void 0 && entries.length >= options.limit || result.message?.toLowerCase().includes("truncat");
+	const entries = result.data.map((entry) => {
+		const lsEntry = {
+			path: entry.path,
+			size: entry.metadata?.size,
+			modified: formatDate(entry.updatedAt),
+			childrenCount: entry.metadata?.childrenCount
+		};
+		const meta = extractMeta(entry.metadata);
+		if (meta && Object.keys(meta).length > 0) lsEntry.meta = meta;
+		return lsEntry;
+	});
+	const truncated = options.limit !== void 0 && entries.length >= options.limit || result.message?.toLowerCase().includes("truncat");
 	return {
 		entries,
 		total: entries.length,
@@ -27,9 +31,20 @@ async function lsCommand(runtime, path, options = {}) {
 		message: result.message
 	};
 }
-function mapEntryType(type) {
-	if (type === "file") return "file";
-	return "directory";
+/**
+* Extract meta fields from entry metadata
+*/
+function extractMeta(metadata) {
+	if (!metadata) return void 0;
+	const builtInFields = new Set([
+		"type",
+		"size",
+		"mimeType",
+		"childrenCount"
+	]);
+	const meta = {};
+	for (const [key, value] of Object.entries(metadata)) if (!builtInFields.has(key) && value !== void 0) meta[key] = value;
+	return Object.keys(meta).length > 0 ? meta : void 0;
 }
 function formatDate(date) {
 	if (!date) return void 0;
@@ -39,18 +54,20 @@ function formatDate(date) {
 /**
 * Format ls output for different views
 */
-function formatLsOutput(result, view) {
+function formatLsOutput(result, view, options) {
+	const isActions = options?.path && isActionsPath(options.path);
 	switch (view) {
-		case "json": return formatJson(result);
-		case "llm": return formatLlm(result);
-		case "human": return formatHuman(result);
-		default: return formatDefault(result);
+		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.entries.length === 0 && result.message) return `# ${result.message}`;
 	const lines = result.entries.map((entry) => entry.path);
 	if (result.truncated) lines.push(`# Results truncated (${result.total} shown)`);
 	return lines.join("\n");
@@ -67,16 +84,19 @@ function formatJson(result) {
 	}, null, 2);
 }
 /**
-* LLM format: Token-efficient, semantic facts
+* LLM format: Token-efficient, semantic facts (includes KIND if present)
 */
 function formatLlm(result) {
 	const lines = [];
+	if (result.entries.length === 0 && result.message) {
+		lines.push(`ERROR ${result.message}`);
+		return lines.join("\n");
+	}
 	for (const entry of result.entries) {
 		const parts = [`ENTRY ${entry.path}`];
-		parts.push(`TYPE=${entry.type}`);
+		if (entry.meta?.kind) parts.push(`KIND=${entry.meta.kind}`);
 		if (entry.size !== void 0) parts.push(`SIZE=${entry.size}`);
 		if (entry.childrenCount !== void 0) parts.push(`CHILDREN=${entry.childrenCount}`);
-		if (entry.childrenTruncated) parts.push("TRUNCATED");
 		lines.push(parts.join(" "));
 	}
 	lines.push(`TOTAL ${result.total}`);
@@ -87,6 +107,7 @@ function formatLlm(result) {
 * Human format: Tree structure
 */
 function formatHuman(result) {
+	if (result.entries.length === 0 && result.message) return colors.yellow(result.message);
 	const root = {
 		name: "",
 		children: /* @__PURE__ */ new Map()
@@ -118,25 +139,103 @@ function renderTree(node, prefix, lines) {
 		const child = children[i];
 		const isLast = i === children.length - 1;
 		const connector = colors.dim(isLast ? "└── " : "├── ");
-		const icon = child.entry ? getTypeIcon(child.entry.type) : "📂";
-		const name = child.entry?.type === "directory" ? colors.cyan(child.name) : child.name;
+		const icon = typeof child.entry?.childrenCount === "number" || child.children.size > 0 ? "📁" : "📄";
 		const sizeStr = child.entry?.size !== void 0 ? colors.dim(`  ${formatSize(child.entry.size)}`) : "";
-		lines.push(`${colors.dim(prefix)}${connector}${icon} ${name}${sizeStr}`);
+		const kindStr = child.entry?.meta?.kind ? colors.dim(` (${child.entry.meta.kind})`) : "";
+		lines.push(`${colors.dim(prefix)}${connector}${icon} ${child.name}${kindStr}${sizeStr}`);
 		renderTree(child, prefix + (isLast ? "    " : "│   "), lines);
 	}
 }
-function getTypeIcon(type) {
-	switch (type) {
-		case "directory": return "📂";
-		case "file": return "📄";
-		default: return "📄";
-	}
-}
 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`;
 }
+/**
+* Extract action name from path (last segment after .actions/)
+*/
+function getActionName(entry) {
+	const parts = entry.path.split("/");
+	return parts[parts.length - 1] || entry.path;
+}
+/**
+* Get action description from entry metadata
+*/
+function getActionDescription(entry) {
+	return entry.meta?.description;
+}
+/**
+* Get the node path from an actions path (path before /.actions)
+*/
+function getNodePathFromActions(actionsPath) {
+	const idx = actionsPath.lastIndexOf("/.actions");
+	return idx > 0 ? actionsPath.substring(0, idx) : "/";
+}
+/**
+* Format actions list - Human view
+* Shows: Available actions for /path:
+*   export      Export table data to file
+*   truncate    Delete all rows from table
+*/
+function formatActionsHuman(result, path) {
+	const lines = [];
+	const nodePath = getNodePathFromActions(path);
+	if (result.entries.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.entries.map((e) => getActionName(e).length));
+	for (const entry of result.entries) {
+		const name = getActionName(entry);
+		const desc = getActionDescription(entry) || "";
+		lines.push(`  ${name.padEnd(maxNameLen + 2)}${desc}`);
+	}
+	return lines.join("\n");
+}
+/**
+* Format actions list - LLM view
+* Shows: ACTIONS /path/.actions
+*   ACTION export DESCRIPTION "Export table data to file"
+*/
+function formatActionsLlm(result, path) {
+	const lines = [];
+	lines.push(`ACTIONS ${path}`);
+	if (result.entries.length === 0) {
+		lines.push("ACTIONS_COUNT 0");
+		return lines.join("\n");
+	}
+	for (const entry of result.entries) {
+		const name = getActionName(entry);
+		const desc = getActionDescription(entry);
+		const descPart = desc ? ` DESCRIPTION "${desc}"` : "";
+		lines.push(`ACTION ${name}${descPart}`);
+	}
+	return lines.join("\n");
+}
+/**
+* Format actions list - JSON view
+* Shows structured JSON with path and actions array
+*/
+function formatActionsJson(result, path) {
+	const actions = result.entries.map((entry) => ({
+		name: getActionName(entry),
+		description: getActionDescription(entry)
+	}));
+	return JSON.stringify({
+		path,
+		data: actions
+	}, null, 2);
+}
+/**
+* Format actions list - Default view
+* Shows action names, one per line
+*/
+function formatActionsDefault(result) {
+	if (result.entries.length === 0) return "";
+	return result.entries.map((entry) => getActionName(entry)).join("\n");
+}
 
 //#endregion
 export { formatLsOutput, lsCommand };

package/dist/commands/ls.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ls.mjs","names":[],"sources":["../../src/commands/ls.ts"],"sourcesContent":["import type { AFSEntry } from \"@aigne/afs\";\nimport type { AFSRuntime } from \"../runtime.js\";\nimport { colors } from \"../ui/index.js\";\n\nexport type ViewType = \"default\" | \"json\" | \"llm\" | \"human\";\n\nexport interface LsEntry {\n  path: string;\n  type: \"file\" | \"directory\";\n  size?: number;\n  modified?: string;\n  hash?: string;\n  childrenCount?: number;\n  childrenTruncated?: boolean;\n}\n\nexport interface LsOptions {\n  maxDepth?: number;\n  limit?: number;\n  maxChildren?: number;\n  pattern?: string;\n}\n\nexport interface LsResult {\n  entries: LsEntry[];\n  total: number;\n  truncated?: boolean;\n  message?: string;\n}\n\n/**\n * List directory contents\n */\nexport async function lsCommand(\n  runtime: AFSRuntime,\n  path: string,\n  options: LsOptions = {},\n): Promise<LsResult> {\n  const result = await runtime.list(path, {\n    maxDepth: options.maxDepth ?? 1,\n    limit: options.limit,\n    maxChildren: options.maxChildren,\n    pattern: options.pattern,\n  });\n\n  const entries: LsEntry[] = result.data.map((entry: AFSEntry) => ({\n    path: entry.path,\n    type: mapEntryType(entry.metadata?.type),\n    size: entry.metadata?.size,\n    modified: formatDate(entry.updatedAt),\n    childrenCount: entry.metadata?.childrenCount,\n    childrenTruncated: entry.metadata?.childrenTruncated,\n  }));\n\n  // Check if any entry has truncated children\n  const hasTruncatedChildren = entries.some((e) => e.childrenTruncated);\n\n  // Determine if results were truncated\n  const truncated =\n    hasTruncatedChildren ||\n    (options.limit !== undefined && entries.length >= options.limit) ||\n    result.message?.toLowerCase().includes(\"truncat\");\n\n  return {\n    entries,\n    total: entries.length,\n    truncated,\n    message: result.message,\n  };\n}\n\nfunction mapEntryType(type?: string): LsEntry[\"type\"] {\n  // Only \"file\" is a true file, all other types are treated as directories\n  if (type === \"file\") {\n    return \"file\";\n  }\n  return \"directory\";\n}\n\nfunction formatDate(date: Date | string | undefined): string | undefined {\n  if (!date) return undefined;\n  // If it's already a string (from HTTP JSON), return as-is\n  if (typeof date === \"string\") return date;\n  // If it's a Date object, convert to ISO string\n  return date.toISOString();\n}\n\n/**\n * Format ls output for different views\n */\nexport function formatLsOutput(result: LsResult, view: ViewType): string {\n  switch (view) {\n    case \"json\":\n      return formatJson(result);\n    case \"llm\":\n      return formatLlm(result);\n    case \"human\":\n      return formatHuman(result);\n    default:\n      return formatDefault(result);\n  }\n}\n\n/**\n * Default format: Machine truth, one path per line\n */\nfunction formatDefault(result: LsResult): string {\n  const lines = result.entries.map((entry) => entry.path);\n  if (result.truncated) {\n    lines.push(`# Results truncated (${result.total} shown)`);\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * JSON format: Structured output\n */\nfunction formatJson(result: LsResult): string {\n  return JSON.stringify(\n    {\n      entries: result.entries,\n      total: result.total,\n      truncated: result.truncated,\n      message: result.message,\n    },\n    null,\n    2,\n  );\n}\n\n/**\n * LLM format: Token-efficient, semantic facts\n */\nfunction formatLlm(result: LsResult): string {\n  const lines: string[] = [];\n\n  for (const entry of result.entries) {\n    const parts = [`ENTRY ${entry.path}`];\n    parts.push(`TYPE=${entry.type}`);\n\n    if (entry.size !== undefined) {\n      parts.push(`SIZE=${entry.size}`);\n    }\n\n    if (entry.childrenCount !== undefined) {\n      parts.push(`CHILDREN=${entry.childrenCount}`);\n    }\n\n    if (entry.childrenTruncated) {\n      parts.push(\"TRUNCATED\");\n    }\n\n    lines.push(parts.join(\" \"));\n  }\n\n  lines.push(`TOTAL ${result.total}`);\n  if (result.truncated) {\n    lines.push(\"TRUNCATED true\");\n  }\n  return lines.join(\"\\n\");\n}\n\ninterface TreeNode {\n  name: string;\n  entry?: LsEntry;\n  children: Map<string, TreeNode>;\n}\n\n/**\n * Human format: Tree structure\n */\nfunction formatHuman(result: LsResult): string {\n  // Build tree structure from flat paths\n  const root: TreeNode = { name: \"\", children: new Map() };\n\n  for (const entry of result.entries) {\n    const parts = entry.path.split(\"/\").filter(Boolean);\n    let current = root;\n\n    for (let i = 0; i < parts.length; i++) {\n      const part = parts[i]!;\n      if (!current.children.has(part)) {\n        current.children.set(part, { name: part, children: new Map() });\n      }\n      current = current.children.get(part)!;\n\n      // Attach entry to the leaf node\n      if (i === parts.length - 1) {\n        current.entry = entry;\n      }\n    }\n  }\n\n  // Render tree\n  const lines: string[] = [];\n  renderTree(root, \"\", lines);\n\n  if (result.truncated) {\n    lines.push(\"\");\n    lines.push(colors.yellow(`(Results truncated - ${result.total} entries shown)`));\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction renderTree(node: TreeNode, prefix: string, lines: string[]): void {\n  const children = Array.from(node.children.values());\n\n  for (let i = 0; i < children.length; i++) {\n    const child = children[i]!;\n    const isLast = i === children.length - 1;\n    const connector = colors.dim(isLast ? \"└── \" : \"├── \");\n    const icon = child.entry ? getTypeIcon(child.entry.type) : \"\\u{1F4C2}\"; // 📂\n    const name = child.entry?.type === \"directory\" ? colors.cyan(child.name) : child.name;\n    const sizeStr =\n      child.entry?.size !== undefined ? colors.dim(`  ${formatSize(child.entry.size)}`) : \"\";\n\n    lines.push(`${colors.dim(prefix)}${connector}${icon} ${name}${sizeStr}`);\n\n    // Recurse into children\n    const childPrefix = prefix + (isLast ? \"    \" : \"│   \");\n    renderTree(child, childPrefix, lines);\n  }\n}\n\nfunction getTypeIcon(type: LsEntry[\"type\"]): string {\n  switch (type) {\n    case \"directory\":\n      return \"\\u{1F4C2}\"; // 📂\n    case \"file\":\n      return \"\\u{1F4C4}\"; // 📄\n    default:\n      return \"\\u{1F4C4}\"; // 📄\n  }\n}\n\nfunction formatSize(bytes: number): string {\n  if (bytes < 1024) return `${bytes}B`;\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;\n  return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;\n}\n"],"mappings":"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"}
+{"version":3,"file":"ls.mjs","names":[],"sources":["../../src/commands/ls.ts"],"sourcesContent":["import type { AFSEntry } from \"@aigne/afs\";\nimport type { AFSRuntime } from \"../runtime.js\";\nimport { colors } from \"../ui/index.js\";\nimport { isActionsPath } from \"../utils/meta.js\";\n\nexport type ViewType = \"default\" | \"json\" | \"llm\" | \"human\";\n\nexport interface LsEntry {\n  path: string;\n  size?: number;\n  modified?: string;\n  hash?: string;\n  childrenCount?: number;\n  meta?: {\n    kind?: string;\n    icon?: string;\n    label?: string;\n    [key: string]: unknown;\n  };\n}\n\nexport interface LsOptions {\n  maxDepth?: number;\n  limit?: number;\n  maxChildren?: number;\n  pattern?: string;\n}\n\nexport interface LsResult {\n  entries: LsEntry[];\n  total: number;\n  truncated?: boolean;\n  message?: string;\n}\n\n/**\n * List directory contents\n */\nexport async function lsCommand(\n  runtime: AFSRuntime,\n  path: string,\n  options: LsOptions = {},\n): Promise<LsResult> {\n  const result = await runtime.list(path, {\n    maxDepth: options.maxDepth ?? 1,\n    limit: options.limit,\n    maxChildren: options.maxChildren,\n    pattern: options.pattern,\n  });\n\n  const entries: LsEntry[] = result.data.map((entry: AFSEntry) => {\n    const lsEntry: LsEntry = {\n      path: entry.path,\n      size: entry.metadata?.size,\n      modified: formatDate(entry.updatedAt),\n      childrenCount: entry.metadata?.childrenCount,\n    };\n\n    // Add meta if present\n    const meta = extractMeta(entry.metadata);\n    if (meta && Object.keys(meta).length > 0) {\n      lsEntry.meta = meta;\n    }\n\n    return lsEntry;\n  });\n\n  // Determine if results were truncated\n  const truncated =\n    (options.limit !== undefined && entries.length >= options.limit) ||\n    result.message?.toLowerCase().includes(\"truncat\");\n\n  return {\n    entries,\n    total: entries.length,\n    truncated,\n    message: result.message,\n  };\n}\n\n/**\n * Extract meta fields from entry metadata\n */\nfunction extractMeta(\n  metadata: Record<string, unknown> | null | undefined,\n): LsEntry[\"meta\"] | undefined {\n  if (!metadata) return undefined;\n\n  const builtInFields = new Set([\"type\", \"size\", \"mimeType\", \"childrenCount\"]);\n\n  const meta: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(metadata)) {\n    if (!builtInFields.has(key) && value !== undefined) {\n      meta[key] = value;\n    }\n  }\n\n  return Object.keys(meta).length > 0 ? meta : undefined;\n}\n\nfunction formatDate(date: Date | string | undefined): string | undefined {\n  if (!date) return undefined;\n  // If it's already a string (from HTTP JSON), return as-is\n  if (typeof date === \"string\") return date;\n  // If it's a Date object, convert to ISO string\n  return date.toISOString();\n}\n\nexport interface FormatLsOptions {\n  /** The path being listed (used for special formatting of .actions paths) */\n  path?: string;\n}\n\n/**\n * Format ls output for different views\n */\nexport function formatLsOutput(\n  result: LsResult,\n  view: ViewType,\n  options?: FormatLsOptions,\n): string {\n  // Check if we're listing an actions path for special formatting\n  const isActions = options?.path && isActionsPath(options.path);\n\n  switch (view) {\n    case \"json\":\n      return isActions ? formatActionsJson(result, options.path!) : formatJson(result);\n    case \"llm\":\n      return isActions ? formatActionsLlm(result, options.path!) : formatLlm(result);\n    case \"human\":\n      return isActions ? formatActionsHuman(result, options.path!) : formatHuman(result);\n    default:\n      return isActions ? formatActionsDefault(result) : formatDefault(result);\n  }\n}\n\n/**\n * Default format: Machine truth, one path per line\n */\nfunction formatDefault(result: LsResult): string {\n  // If there are no entries and there's an error message, show it\n  if (result.entries.length === 0 && result.message) {\n    return `# ${result.message}`;\n  }\n\n  const lines = result.entries.map((entry) => entry.path);\n  if (result.truncated) {\n    lines.push(`# Results truncated (${result.total} shown)`);\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * JSON format: Structured output\n */\nfunction formatJson(result: LsResult): string {\n  return JSON.stringify(\n    {\n      entries: result.entries,\n      total: result.total,\n      truncated: result.truncated,\n      message: result.message,\n    },\n    null,\n    2,\n  );\n}\n\n/**\n * LLM format: Token-efficient, semantic facts (includes KIND if present)\n */\nfunction formatLlm(result: LsResult): string {\n  const lines: string[] = [];\n\n  // If there are no entries and there's an error message, show it\n  if (result.entries.length === 0 && result.message) {\n    lines.push(`ERROR ${result.message}`);\n    return lines.join(\"\\n\");\n  }\n\n  for (const entry of result.entries) {\n    const parts = [`ENTRY ${entry.path}`];\n\n    if (entry.meta?.kind) {\n      parts.push(`KIND=${entry.meta.kind}`);\n    }\n\n    if (entry.size !== undefined) {\n      parts.push(`SIZE=${entry.size}`);\n    }\n\n    if (entry.childrenCount !== undefined) {\n      parts.push(`CHILDREN=${entry.childrenCount}`);\n    }\n\n    lines.push(parts.join(\" \"));\n  }\n\n  lines.push(`TOTAL ${result.total}`);\n  if (result.truncated) {\n    lines.push(\"TRUNCATED true\");\n  }\n  return lines.join(\"\\n\");\n}\n\ninterface TreeNode {\n  name: string;\n  entry?: LsEntry;\n  children: Map<string, TreeNode>;\n}\n\n/**\n * Human format: Tree structure\n */\nfunction formatHuman(result: LsResult): string {\n  // If there are no entries and there's an error message, show it prominently\n  if (result.entries.length === 0 && result.message) {\n    return colors.yellow(result.message);\n  }\n\n  // Build tree structure from flat paths\n  const root: TreeNode = { name: \"\", children: new Map() };\n\n  for (const entry of result.entries) {\n    const parts = entry.path.split(\"/\").filter(Boolean);\n    let current = root;\n\n    for (let i = 0; i < parts.length; i++) {\n      const part = parts[i]!;\n      if (!current.children.has(part)) {\n        current.children.set(part, { name: part, children: new Map() });\n      }\n      current = current.children.get(part)!;\n\n      // Attach entry to the leaf node\n      if (i === parts.length - 1) {\n        current.entry = entry;\n      }\n    }\n  }\n\n  // Render tree\n  const lines: string[] = [];\n  renderTree(root, \"\", lines);\n\n  if (result.truncated) {\n    lines.push(\"\");\n    lines.push(colors.yellow(`(Results truncated - ${result.total} entries shown)`));\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction renderTree(node: TreeNode, prefix: string, lines: string[]): void {\n  const children = Array.from(node.children.values());\n\n  for (let i = 0; i < children.length; i++) {\n    const child = children[i]!;\n    const isLast = i === children.length - 1;\n    const connector = colors.dim(isLast ? \"└── \" : \"├── \");\n    // Use folder icon if:\n    // 1. childrenCount is defined (directory), OR\n    // 2. This tree node has children (implies it's a directory/mount point)\n    const isDirectory = typeof child.entry?.childrenCount === \"number\" || child.children.size > 0;\n    const icon = isDirectory ? \"\\u{1F4C1}\" : \"\\u{1F4C4}\"; // 📁 or 📄\n    const sizeStr =\n      child.entry?.size !== undefined ? colors.dim(`  ${formatSize(child.entry.size)}`) : \"\";\n\n    // Add kind in parentheses if present\n    const kindStr = child.entry?.meta?.kind ? colors.dim(` (${child.entry.meta.kind})`) : \"\";\n\n    lines.push(`${colors.dim(prefix)}${connector}${icon} ${child.name}${kindStr}${sizeStr}`);\n\n    // Recurse into children\n    const childPrefix = prefix + (isLast ? \"    \" : \"│   \");\n    renderTree(child, childPrefix, lines);\n  }\n}\n\nfunction formatSize(bytes: number): string {\n  if (bytes < 1024) return `${bytes}B`;\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;\n  return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;\n}\n\n/**\n * Extract action name from path (last segment after .actions/)\n */\nfunction getActionName(entry: LsEntry): string {\n  const parts = entry.path.split(\"/\");\n  return parts[parts.length - 1] || entry.path;\n}\n\n/**\n * Get action description from entry metadata\n */\nfunction getActionDescription(entry: LsEntry): string | undefined {\n  return entry.meta?.description as string | undefined;\n}\n\n/**\n * Get the node path from an actions path (path before /.actions)\n */\nfunction getNodePathFromActions(actionsPath: string): string {\n  const idx = actionsPath.lastIndexOf(\"/.actions\");\n  return idx > 0 ? actionsPath.substring(0, idx) : \"/\";\n}\n\n/**\n * Format actions list - Human view\n * Shows: Available actions for /path:\n *   export      Export table data to file\n *   truncate    Delete all rows from table\n */\nfunction formatActionsHuman(result: LsResult, path: string): string {\n  const lines: string[] = [];\n  const nodePath = getNodePathFromActions(path);\n\n  if (result.entries.length === 0) {\n    lines.push(`No actions available for ${nodePath}`);\n    return lines.join(\"\\n\");\n  }\n\n  lines.push(`Available actions for ${nodePath}:`);\n  lines.push(\"\");\n\n  // Find max action name length for padding\n  const maxNameLen = Math.max(...result.entries.map((e) => getActionName(e).length));\n\n  for (const entry of result.entries) {\n    const name = getActionName(entry);\n    const desc = getActionDescription(entry) || \"\";\n    lines.push(`  ${name.padEnd(maxNameLen + 2)}${desc}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Format actions list - LLM view\n * Shows: ACTIONS /path/.actions\n *   ACTION export DESCRIPTION \"Export table data to file\"\n */\nfunction formatActionsLlm(result: LsResult, path: string): string {\n  const lines: string[] = [];\n\n  lines.push(`ACTIONS ${path}`);\n\n  if (result.entries.length === 0) {\n    lines.push(\"ACTIONS_COUNT 0\");\n    return lines.join(\"\\n\");\n  }\n\n  for (const entry of result.entries) {\n    const name = getActionName(entry);\n    const desc = getActionDescription(entry);\n    const descPart = desc ? ` DESCRIPTION \"${desc}\"` : \"\";\n    lines.push(`ACTION ${name}${descPart}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Format actions list - JSON view\n * Shows structured JSON with path and actions array\n */\nfunction formatActionsJson(result: LsResult, path: string): string {\n  const actions = result.entries.map((entry) => ({\n    name: getActionName(entry),\n    description: getActionDescription(entry),\n  }));\n\n  return JSON.stringify(\n    {\n      path,\n      data: actions,\n    },\n    null,\n    2,\n  );\n}\n\n/**\n * Format actions list - Default view\n * Shows action names, one per line\n */\nfunction formatActionsDefault(result: LsResult): string {\n  if (result.entries.length === 0) {\n    return \"\";\n  }\n  return result.entries.map((entry) => getActionName(entry)).join(\"\\n\");\n}\n"],"mappings":"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"}

package/dist/commands/mount.cjs

@@ -66,7 +66,8 @@ async function mountAddCommand(cwd, path, uri, options = {}) {
 	const newMount = {
 		path: validation.data.path,
 		uri: validation.data.uri,
-		...options.description && { description: options.description }
+		...options.description && { description: options.description },
+		...options.token && { token: options.token }
 	};
 	const configDir = (0, node_path.join)(cwd, require_loader.CONFIG_DIR_NAME);
 	const configPath = (0, node_path.join)(configDir, require_loader.CONFIG_FILE_NAME);

package/dist/commands/mount.mjs

@@ -65,7 +65,8 @@ async function mountAddCommand(cwd, path, uri, options = {}) {
 	const newMount = {
 		path: validation.data.path,
 		uri: validation.data.uri,
-		...options.description && { description: options.description }
+		...options.description && { description: options.description },
+		...options.token && { token: options.token }
 	};
 	const configDir = join(cwd, CONFIG_DIR_NAME);
 	const configPath = join(configDir, CONFIG_FILE_NAME);

package/dist/commands/mount.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mount.mjs","names":[],"sources":["../../src/commands/mount.ts"],"sourcesContent":["import { access, mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { isAbsolute, join, resolve } from \"node:path\";\nimport { parse, stringify } from \"smol-toml\";\nimport { CONFIG_DIR_NAME, CONFIG_FILE_NAME, ConfigLoader } from \"../config/loader.js\";\nimport { MountSchema } from \"../config/schema.js\";\nimport { colors } from \"../ui/index.js\";\nimport type { ViewType } from \"./ls.js\";\n\nexport interface MountEntry {\n  path: string;\n  uri: string;\n  description?: string;\n  access_mode?: \"readonly\" | \"readwrite\";\n  auth?: string;\n  options?: Record<string, unknown>;\n}\n\nexport interface MountListResult {\n  mounts: MountEntry[];\n}\n\nexport interface MountCommandResult {\n  success: boolean;\n  message?: string;\n  /** The normalized path (for display after successful add) */\n  normalizedPath?: string;\n}\n\nexport interface MountValidateResult {\n  valid: boolean;\n  errors: string[];\n}\n\n/**\n * Check if a path looks like a remote Git URL\n * Matches SSH format (git@host:path) or embedded protocols (https://, http://, ssh://)\n */\nfunction isRemoteGitUrl(path: string): boolean {\n  // SSH format: git@github.com:user/repo.git or user@host:path\n  if (/^[a-zA-Z0-9._-]+@[a-zA-Z0-9._-]+:/.test(path)) {\n    return true;\n  }\n  // Embedded protocol: https://github.com/user/repo.git\n  if (/^(https?|ssh|git):\\/\\//.test(path)) {\n    return true;\n  }\n  return false;\n}\n\n/**\n * Resolve relative paths in URI to absolute paths\n * Supports fs://, git://, sqlite://, json:// schemes\n * Paths without protocol prefix are treated as fs:// paths (unless it's a remote git URL)\n */\nfunction resolveUriPath(uri: string, cwd: string): string {\n  const schemeMatch = uri.match(/^([a-z]+):\\/\\//);\n\n  // No protocol prefix\n  if (!schemeMatch) {\n    // Check if it's a remote git URL (SSH format like git@github.com:user/repo.git)\n    if (isRemoteGitUrl(uri)) {\n      return `git://${uri}`;\n    }\n    // Treat as local filesystem path\n    const absolutePath = isAbsolute(uri) ? uri : resolve(cwd, uri);\n    return `fs://${absolutePath}`;\n  }\n\n  const scheme = schemeMatch[1];\n  const pathPart = uri.slice(schemeMatch[0].length);\n\n  // Only resolve for local file-based schemes\n  if (![\"fs\", \"git\", \"sqlite\", \"json\"].includes(scheme!)) {\n    return uri;\n  }\n\n  // For git:// scheme, check if the path is a remote URL (not a local path)\n  if (scheme === \"git\" && isRemoteGitUrl(pathPart)) {\n    return uri;\n  }\n\n  // If path is already absolute, return as-is\n  if (isAbsolute(pathPart)) {\n    return uri;\n  }\n\n  // Resolve relative path against cwd\n  const absolutePath = resolve(cwd, pathPart);\n  return `${scheme}://${absolutePath}`;\n}\n\n/**\n * List all mounts from config (merged from all config layers)\n */\nexport async function mountListCommand(cwd: string): Promise<MountListResult> {\n  const loader = new ConfigLoader();\n  const config = await loader.load(cwd);\n  return {\n    mounts: config.mounts as MountEntry[],\n  };\n}\n\n/**\n * Add a mount to config\n */\nexport async function mountAddCommand(\n  cwd: string,\n  path: string,\n  uri: string,\n  options: { description?: string } = {},\n): Promise<MountCommandResult> {\n  // Check for empty URI before resolving (resolveUriPath would transform empty string)\n  if (!uri || uri.trim() === \"\") {\n    return {\n      success: false,\n      message: \"URI is required\",\n    };\n  }\n\n  // Resolve relative paths in URI to absolute paths\n  const resolvedUri = resolveUriPath(uri, cwd);\n\n  // Validate and normalize inputs using schema\n  // The schema transforms path (normalizes it) and validates all fields\n  const validation = MountSchema.safeParse({\n    path,\n    uri: resolvedUri,\n    ...options,\n  });\n  if (!validation.success) {\n    const errors = validation.error.errors.map((e) => e.message).join(\"; \");\n    return {\n      success: false,\n      message: errors,\n    };\n  }\n\n  // Build mount entry with validated/normalized path and resolved URI\n  const newMount: MountEntry = {\n    path: validation.data.path, // Use normalized path from schema\n    uri: validation.data.uri,\n    ...(options.description && { description: options.description }),\n  };\n\n  const configDir = join(cwd, CONFIG_DIR_NAME);\n  const configPath = join(configDir, CONFIG_FILE_NAME);\n\n  // Load existing config or create new\n  const config: { mounts: MountEntry[] } = { mounts: [] };\n\n  try {\n    const content = await readFile(configPath, \"utf-8\");\n    const parsed = parse(content) as { mounts?: MountEntry[] };\n    config.mounts = parsed.mounts ?? [];\n  } catch {\n    // Config doesn't exist, will create\n  }\n\n  // Check for duplicate path (use normalized path for comparison)\n  const normalizedPath = validation.data.path;\n  if (config.mounts.some((m) => m.path === normalizedPath)) {\n    return {\n      success: false,\n      message: `Mount path \"${normalizedPath}\" already exists`,\n    };\n  }\n\n  // Add validated mount\n  config.mounts.push(newMount);\n\n  // Ensure config directory exists\n  try {\n    await mkdir(configDir, { recursive: true });\n  } catch {\n    // Directory might already exist\n  }\n\n  // Write config\n  await writeFile(configPath, stringify(config), \"utf-8\");\n\n  return {\n    success: true,\n    normalizedPath,\n  };\n}\n\n/**\n * Remove a mount from config\n */\nexport async function mountRemoveCommand(cwd: string, path: string): Promise<MountCommandResult> {\n  const configPath = join(cwd, CONFIG_DIR_NAME, CONFIG_FILE_NAME);\n\n  try {\n    const content = await readFile(configPath, \"utf-8\");\n    const config = parse(content) as { mounts?: MountEntry[] };\n    const mounts = config.mounts ?? [];\n\n    const index = mounts.findIndex((m) => m.path === path);\n    if (index === -1) {\n      return {\n        success: false,\n        message: `Mount path \"${path}\" not found`,\n      };\n    }\n\n    mounts.splice(index, 1);\n    config.mounts = mounts;\n\n    await writeFile(configPath, stringify(config), \"utf-8\");\n\n    return {\n      success: true,\n    };\n  } catch {\n    return {\n      success: false,\n      message: `Mount path \"${path}\" not found`,\n    };\n  }\n}\n\n/**\n * Validate mount configuration\n */\nexport async function mountValidateCommand(cwd: string): Promise<MountValidateResult> {\n  const configPath = join(cwd, CONFIG_DIR_NAME, CONFIG_FILE_NAME);\n  const errors: string[] = [];\n\n  try {\n    const content = await readFile(configPath, \"utf-8\");\n    const config = parse(content) as { mounts?: MountEntry[] };\n    const mounts = config.mounts ?? [];\n\n    for (const mount of mounts) {\n      // Validate mount using schema\n      const validation = MountSchema.safeParse(mount);\n      if (!validation.success) {\n        for (const err of validation.error.errors) {\n          errors.push(`Mount \"${mount.path}\": ${err.message}`);\n        }\n        continue;\n      }\n\n      // For fs:// URIs, check if target exists\n      if (mount.uri.startsWith(\"fs://\")) {\n        const targetPath = mount.uri.replace(\"fs://\", \"\");\n        try {\n          await access(targetPath);\n        } catch {\n          errors.push(`Mount target \"${targetPath}\" does not exist`);\n        }\n      }\n    }\n\n    return {\n      valid: errors.length === 0,\n      errors,\n    };\n  } catch {\n    return {\n      valid: true,\n      errors: [],\n    };\n  }\n}\n\n/**\n * Format mount list output for different views\n */\nexport function formatMountListOutput(mounts: MountEntry[], view: ViewType): string {\n  switch (view) {\n    case \"json\":\n      return JSON.stringify({ mounts }, null, 2);\n    case \"llm\":\n      return formatLlm(mounts);\n    case \"human\":\n      return formatHuman(mounts);\n    default:\n      return formatDefault(mounts);\n  }\n}\n\nfunction formatDefault(mounts: MountEntry[]): string {\n  if (mounts.length === 0) {\n    return \"No mounts configured\";\n  }\n\n  return mounts\n    .map((m) => {\n      const desc = m.description ? ` (${m.description})` : \"\";\n      return `${m.path} → ${m.uri}${desc}`;\n    })\n    .join(\"\\n\");\n}\n\nfunction formatLlm(mounts: MountEntry[]): string {\n  if (mounts.length === 0) {\n    return \"NO_MOUNTS\";\n  }\n\n  return mounts\n    .map((m) => {\n      const lines = [`MOUNT ${m.path}`, `URI=${m.uri}`];\n      if (m.description) {\n        lines.push(`DESC=${m.description}`);\n      }\n      return lines.join(\"\\n\");\n    })\n    .join(\"\\n\\n\");\n}\n\nfunction formatHuman(mounts: MountEntry[]): string {\n  if (mounts.length === 0) {\n    return colors.dim(\"No mounts configured.\");\n  }\n\n  const lines = [colors.bold(\"Configured Mounts:\"), \"\"];\n  for (const m of mounts) {\n    lines.push(`  ${colors.cyan(m.path)}`);\n    lines.push(`    ${colors.dim(\"URI:\")} ${m.uri}`);\n    if (m.description) {\n      lines.push(`    ${colors.dim(\"Description:\")} ${m.description}`);\n    }\n    lines.push(\"\");\n  }\n\n  return lines.join(\"\\n\").trimEnd();\n}\n"],"mappings":"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"}
+{"version":3,"file":"mount.mjs","names":[],"sources":["../../src/commands/mount.ts"],"sourcesContent":["import { access, mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { isAbsolute, join, resolve } from \"node:path\";\nimport { parse, stringify } from \"smol-toml\";\nimport { CONFIG_DIR_NAME, CONFIG_FILE_NAME, ConfigLoader } from \"../config/loader.js\";\nimport { MountSchema } from \"../config/schema.js\";\nimport { colors } from \"../ui/index.js\";\nimport type { ViewType } from \"./ls.js\";\n\nexport interface MountEntry {\n  path: string;\n  uri: string;\n  description?: string;\n  access_mode?: \"readonly\" | \"readwrite\";\n  auth?: string;\n  token?: string;\n  options?: Record<string, unknown>;\n}\n\nexport interface MountListResult {\n  mounts: MountEntry[];\n}\n\nexport interface MountCommandResult {\n  success: boolean;\n  message?: string;\n  /** The normalized path (for display after successful add) */\n  normalizedPath?: string;\n}\n\nexport interface MountValidateResult {\n  valid: boolean;\n  errors: string[];\n}\n\n/**\n * Check if a path looks like a remote Git URL\n * Matches SSH format (git@host:path) or embedded protocols (https://, http://, ssh://)\n */\nfunction isRemoteGitUrl(path: string): boolean {\n  // SSH format: git@github.com:user/repo.git or user@host:path\n  if (/^[a-zA-Z0-9._-]+@[a-zA-Z0-9._-]+:/.test(path)) {\n    return true;\n  }\n  // Embedded protocol: https://github.com/user/repo.git\n  if (/^(https?|ssh|git):\\/\\//.test(path)) {\n    return true;\n  }\n  return false;\n}\n\n/**\n * Resolve relative paths in URI to absolute paths\n * Supports fs://, git://, sqlite://, json:// schemes\n * Paths without protocol prefix are treated as fs:// paths (unless it's a remote git URL)\n */\nfunction resolveUriPath(uri: string, cwd: string): string {\n  const schemeMatch = uri.match(/^([a-z]+):\\/\\//);\n\n  // No protocol prefix\n  if (!schemeMatch) {\n    // Check if it's a remote git URL (SSH format like git@github.com:user/repo.git)\n    if (isRemoteGitUrl(uri)) {\n      return `git://${uri}`;\n    }\n    // Treat as local filesystem path\n    const absolutePath = isAbsolute(uri) ? uri : resolve(cwd, uri);\n    return `fs://${absolutePath}`;\n  }\n\n  const scheme = schemeMatch[1];\n  const pathPart = uri.slice(schemeMatch[0].length);\n\n  // Only resolve for local file-based schemes\n  if (![\"fs\", \"git\", \"sqlite\", \"json\"].includes(scheme!)) {\n    return uri;\n  }\n\n  // For git:// scheme, check if the path is a remote URL (not a local path)\n  if (scheme === \"git\" && isRemoteGitUrl(pathPart)) {\n    return uri;\n  }\n\n  // If path is already absolute, return as-is\n  if (isAbsolute(pathPart)) {\n    return uri;\n  }\n\n  // Resolve relative path against cwd\n  const absolutePath = resolve(cwd, pathPart);\n  return `${scheme}://${absolutePath}`;\n}\n\n/**\n * List all mounts from config (merged from all config layers)\n */\nexport async function mountListCommand(cwd: string): Promise<MountListResult> {\n  const loader = new ConfigLoader();\n  const config = await loader.load(cwd);\n  return {\n    mounts: config.mounts as MountEntry[],\n  };\n}\n\n/**\n * Add a mount to config\n */\nexport async function mountAddCommand(\n  cwd: string,\n  path: string,\n  uri: string,\n  options: { description?: string; token?: string } = {},\n): Promise<MountCommandResult> {\n  // Check for empty URI before resolving (resolveUriPath would transform empty string)\n  if (!uri || uri.trim() === \"\") {\n    return {\n      success: false,\n      message: \"URI is required\",\n    };\n  }\n\n  // Resolve relative paths in URI to absolute paths\n  const resolvedUri = resolveUriPath(uri, cwd);\n\n  // Validate and normalize inputs using schema\n  // The schema transforms path (normalizes it) and validates all fields\n  const validation = MountSchema.safeParse({\n    path,\n    uri: resolvedUri,\n    ...options,\n  });\n  if (!validation.success) {\n    const errors = validation.error.errors.map((e) => e.message).join(\"; \");\n    return {\n      success: false,\n      message: errors,\n    };\n  }\n\n  // Build mount entry with validated/normalized path and resolved URI\n  const newMount: MountEntry = {\n    path: validation.data.path, // Use normalized path from schema\n    uri: validation.data.uri,\n    ...(options.description && { description: options.description }),\n    ...(options.token && { token: options.token }),\n  };\n\n  const configDir = join(cwd, CONFIG_DIR_NAME);\n  const configPath = join(configDir, CONFIG_FILE_NAME);\n\n  // Load existing config or create new\n  const config: { mounts: MountEntry[] } = { mounts: [] };\n\n  try {\n    const content = await readFile(configPath, \"utf-8\");\n    const parsed = parse(content) as { mounts?: MountEntry[] };\n    config.mounts = parsed.mounts ?? [];\n  } catch {\n    // Config doesn't exist, will create\n  }\n\n  // Check for duplicate path (use normalized path for comparison)\n  const normalizedPath = validation.data.path;\n  if (config.mounts.some((m) => m.path === normalizedPath)) {\n    return {\n      success: false,\n      message: `Mount path \"${normalizedPath}\" already exists`,\n    };\n  }\n\n  // Add validated mount\n  config.mounts.push(newMount);\n\n  // Ensure config directory exists\n  try {\n    await mkdir(configDir, { recursive: true });\n  } catch {\n    // Directory might already exist\n  }\n\n  // Write config\n  await writeFile(configPath, stringify(config), \"utf-8\");\n\n  return {\n    success: true,\n    normalizedPath,\n  };\n}\n\n/**\n * Remove a mount from config\n */\nexport async function mountRemoveCommand(cwd: string, path: string): Promise<MountCommandResult> {\n  const configPath = join(cwd, CONFIG_DIR_NAME, CONFIG_FILE_NAME);\n\n  try {\n    const content = await readFile(configPath, \"utf-8\");\n    const config = parse(content) as { mounts?: MountEntry[] };\n    const mounts = config.mounts ?? [];\n\n    const index = mounts.findIndex((m) => m.path === path);\n    if (index === -1) {\n      return {\n        success: false,\n        message: `Mount path \"${path}\" not found`,\n      };\n    }\n\n    mounts.splice(index, 1);\n    config.mounts = mounts;\n\n    await writeFile(configPath, stringify(config), \"utf-8\");\n\n    return {\n      success: true,\n    };\n  } catch {\n    return {\n      success: false,\n      message: `Mount path \"${path}\" not found`,\n    };\n  }\n}\n\n/**\n * Validate mount configuration\n */\nexport async function mountValidateCommand(cwd: string): Promise<MountValidateResult> {\n  const configPath = join(cwd, CONFIG_DIR_NAME, CONFIG_FILE_NAME);\n  const errors: string[] = [];\n\n  try {\n    const content = await readFile(configPath, \"utf-8\");\n    const config = parse(content) as { mounts?: MountEntry[] };\n    const mounts = config.mounts ?? [];\n\n    for (const mount of mounts) {\n      // Validate mount using schema\n      const validation = MountSchema.safeParse(mount);\n      if (!validation.success) {\n        for (const err of validation.error.errors) {\n          errors.push(`Mount \"${mount.path}\": ${err.message}`);\n        }\n        continue;\n      }\n\n      // For fs:// URIs, check if target exists\n      if (mount.uri.startsWith(\"fs://\")) {\n        const targetPath = mount.uri.replace(\"fs://\", \"\");\n        try {\n          await access(targetPath);\n        } catch {\n          errors.push(`Mount target \"${targetPath}\" does not exist`);\n        }\n      }\n    }\n\n    return {\n      valid: errors.length === 0,\n      errors,\n    };\n  } catch {\n    return {\n      valid: true,\n      errors: [],\n    };\n  }\n}\n\n/**\n * Format mount list output for different views\n */\nexport function formatMountListOutput(mounts: MountEntry[], view: ViewType): string {\n  switch (view) {\n    case \"json\":\n      return JSON.stringify({ mounts }, null, 2);\n    case \"llm\":\n      return formatLlm(mounts);\n    case \"human\":\n      return formatHuman(mounts);\n    default:\n      return formatDefault(mounts);\n  }\n}\n\nfunction formatDefault(mounts: MountEntry[]): string {\n  if (mounts.length === 0) {\n    return \"No mounts configured\";\n  }\n\n  return mounts\n    .map((m) => {\n      const desc = m.description ? ` (${m.description})` : \"\";\n      return `${m.path} → ${m.uri}${desc}`;\n    })\n    .join(\"\\n\");\n}\n\nfunction formatLlm(mounts: MountEntry[]): string {\n  if (mounts.length === 0) {\n    return \"NO_MOUNTS\";\n  }\n\n  return mounts\n    .map((m) => {\n      const lines = [`MOUNT ${m.path}`, `URI=${m.uri}`];\n      if (m.description) {\n        lines.push(`DESC=${m.description}`);\n      }\n      return lines.join(\"\\n\");\n    })\n    .join(\"\\n\\n\");\n}\n\nfunction formatHuman(mounts: MountEntry[]): string {\n  if (mounts.length === 0) {\n    return colors.dim(\"No mounts configured.\");\n  }\n\n  const lines = [colors.bold(\"Configured Mounts:\"), \"\"];\n  for (const m of mounts) {\n    lines.push(`  ${colors.cyan(m.path)}`);\n    lines.push(`    ${colors.dim(\"URI:\")} ${m.uri}`);\n    if (m.description) {\n      lines.push(`    ${colors.dim(\"Description:\")} ${m.description}`);\n    }\n    lines.push(\"\");\n  }\n\n  return lines.join(\"\\n\").trimEnd();\n}\n"],"mappings":"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"}

package/dist/commands/read.cjs

@@ -1,22 +1,92 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_meta = require('../utils/meta.cjs');
+let _aigne_afs = require("@aigne/afs");
 
 //#region src/commands/read.ts
 /**
 * Read file content
 */
 async function readCommand(runtime, path) {
-	const result = await runtime.read(path);
+	let result;
+	try {
+		result = await runtime.read(path);
+	} catch (error) {
+		if (error instanceof _aigne_afs.AFSNotFoundError) return {
+			path,
+			content: void 0
+		};
+		throw error;
+	}
 	if (!result.data) return {
 		path,
 		content: void 0
 	};
 	const entry = result.data;
-	return {
+	const isMeta = require_meta.isMetaPath(path);
+	const isAction = require_meta.isActionsPath(path);
+	const content = isMeta ? entry.content : typeof entry.content === "string" ? entry.content : entry.content !== void 0 ? JSON.stringify(entry.content) : void 0;
+	const readResult = {
 		path: entry.path,
-		content: typeof entry.content === "string" ? entry.content : JSON.stringify(entry.content),
-		type: entry.metadata?.type === "directory" ? "directory" : "file",
+		content,
+		isMeta,
+		isAction,
 		size: entry.metadata?.size,
-		mimeType: entry.metadata?.mimeType
+		mimeType: entry.metadata?.mimeType,
+		childrenCount: entry.metadata?.childrenCount
 	};
+	if (!isMeta && !isAction) try {
+		const statResult = await runtime.stat(path);
+		if (statResult.data?.actions && statResult.data.actions.length > 0) readResult.actions = statResult.data.actions;
+	} catch {}
+	const meta = extractMeta(entry.metadata);
+	if (meta && Object.keys(meta).length > 0) readResult.meta = meta;
+	return readResult;
+}
+/**
+* Extract meta fields from entry metadata
+* Excludes built-in fields that are exposed separately
+*/
+function extractMeta(metadata) {
+	if (!metadata) return void 0;
+	const builtInFields = new Set([
+		"type",
+		"size",
+		"mimeType",
+		"childrenCount"
+	]);
+	const meta = {};
+	for (const [key, value] of Object.entries(metadata)) if (!builtInFields.has(key) && value !== void 0) meta[key] = value;
+	return Object.keys(meta).length > 0 ? meta : void 0;
+}
+/**
+* Extract user-defined metadata (excludes system fields)
+*/
+function extractUserMetadata(meta) {
+	if (!meta) return {};
+	const systemFields = new Set([
+		"kind",
+		"kinds",
+		"childrenCount",
+		"inputSchema",
+		"required",
+		"description"
+	]);
+	return Object.fromEntries(Object.entries(meta).filter(([k]) => !systemFields.has(k)));
+}
+/**
+* Format params summary: format*,path,limit (* = required)
+*/
+function formatParamsSummary(schema, required = []) {
+	if (!schema) return "";
+	const props = schema.properties || schema;
+	return Object.keys(props).map((name) => required.includes(name) ? `${name}*` : name).join(",");
+}
+/**
+* Check if entry is executable (has afs:executable in kinds)
+*/
+function isExecutable(meta) {
+	if (!meta?.kinds) return false;
+	return meta.kinds.includes("afs:executable");
 }
 /**
 * Format read output for different views
@@ -30,34 +100,163 @@ function formatReadOutput(read, view) {
 	}
 }
 /**
-* Default format: Raw content
+* Default format: Raw content or one-liner summary
+* - If content exists: show raw content
+* - If no content (directories): show one-liner summary /path kind children=N actions=a,b,c
+* - For executables: /path afs:executable params=format*,path,limit
+* - For meta paths: raw JSON
 */
 function formatDefault(read) {
-	return read.content ?? "";
+	if (read.isMeta && typeof read.content === "object") return JSON.stringify(read.content, null, 2);
+	if (read.isAction && isExecutable(read.meta)) {
+		if (read.content !== void 0 && read.content !== null && read.content !== "") return typeof read.content === "string" ? read.content : JSON.stringify(read.content, null, 2);
+		const parts$1 = [read.path, "afs:executable"];
+		if (read.meta?.inputSchema) {
+			const params = formatParamsSummary(read.meta.inputSchema, read.meta.required);
+			if (params) parts$1.push(`params=${params}`);
+		}
+		return parts$1.join(" ");
+	}
+	if (read.content !== void 0 && read.content !== null && read.content !== "") return typeof read.content === "string" ? read.content : JSON.stringify(read.content, null, 2);
+	const parts = [read.path];
+	if (read.meta?.kind) parts.push(read.meta.kind);
+	if (read.childrenCount !== void 0) parts.push(`children=${read.childrenCount}`);
+	if (read.actions && read.actions.length > 0) parts.push(`actions=${read.actions.map((a) => a.name).join(",")}`);
+	return parts.join(" ");
 }
 /**
-* JSON format
+* JSON format (includes meta field for regular files if present)
 */
 function formatJson(read) {
 	return JSON.stringify(read, null, 2);
 }
 /**
-* LLM format: Content with header
+* LLM format: Structured text for AI parsing
 */
 function formatLlm(read) {
 	const lines = [];
-	lines.push(`FILE ${read.path}`);
+	if (read.isMeta) {
+		lines.push(`META ${read.path}`);
+		const content = read.content;
+		if (content?.kind) lines.push(`KIND ${content.kind}`);
+		lines.push(`CONTENT`);
+		lines.push(JSON.stringify(content));
+		return lines.join("\n");
+	}
+	if (read.isAction && isExecutable(read.meta)) {
+		lines.push(`EXECUTABLE ${read.path}`);
+		if (read.meta?.description) lines.push(`DESCRIPTION "${read.meta.description}"`);
+		if (read.meta?.inputSchema) {
+			const props = read.meta.inputSchema.properties || {};
+			const required = read.meta.required || [];
+			for (const [name, propDef] of Object.entries(props)) {
+				const prop = propDef;
+				const isReq = required.includes(name);
+				let paramLine = `PARAM ${name} TYPE ${prop.type || "any"}`;
+				paramLine += isReq ? " REQUIRED" : " OPTIONAL";
+				if (prop.enum) paramLine += ` CHOICES ${prop.enum.join(",")}`;
+				if (prop.default !== void 0) paramLine += ` DEFAULT ${prop.default}`;
+				lines.push(paramLine);
+			}
+		}
+		return lines.join("\n");
+	}
+	lines.push(`NODE ${read.path}`);
+	if (read.meta?.kind) lines.push(`KIND ${read.meta.kind}`);
+	if (read.meta?.kinds && Array.isArray(read.meta.kinds) && read.meta.kinds.length > 0) lines.push(`KINDS ${read.meta.kinds.join(" ")}`);
+	if (read.childrenCount !== void 0) lines.push(`CHILDREN ${read.childrenCount}`);
 	if (read.mimeType) lines.push(`MIME ${read.mimeType}`);
 	if (read.size !== void 0) lines.push(`SIZE ${read.size}`);
-	lines.push(`CONTENT`);
-	lines.push(read.content ?? "");
+	const userMeta = extractUserMetadata(read.meta);
+	if (Object.keys(userMeta).length > 0) {
+		const metaStr = Object.entries(userMeta).map(([k, v]) => `${k}=${JSON.stringify(v)}`).join(" ");
+		lines.push(`META ${metaStr}`);
+	}
+	if (read.actions && read.actions.length > 0) lines.push(`ACTIONS ${read.actions.map((a) => a.name).join(" ")}`);
+	if (read.content !== void 0 && read.content !== null && read.content !== "") lines.push(`CONTENT ${JSON.stringify(read.content)}`);
 	return lines.join("\n");
 }
 /**
-* Human format: With syntax highlighting placeholder
+* Human format: Formatted display with metadata and actions
 */
 function formatHuman(read) {
-	return `${`--- ${read.path} ---`}\n${read.content ?? "(empty)"}`;
+	const lines = [];
+	if (read.isMeta && typeof read.content === "object") {
+		lines.push(`Metadata for ${read.path.replace(/\/.meta$/, "")}`);
+		lines.push("");
+		lines.push(JSON.stringify(read.content, null, 2));
+		return lines.join("\n");
+	}
+	if (read.isAction && isExecutable(read.meta)) {
+		const actionName = read.path.split("/").pop() || "action";
+		lines.push(`Action: ${actionName}`);
+		lines.push(`Path:   ${read.path}`);
+		if (read.meta?.description) {
+			lines.push("");
+			lines.push("Description:");
+			lines.push(`  ${read.meta.description}`);
+		}
+		if (read.meta?.inputSchema) {
+			const props = read.meta.inputSchema.properties || {};
+			const required = read.meta.required || [];
+			if (Object.keys(props).length > 0) {
+				lines.push("");
+				lines.push("Parameters:");
+				for (const [name, propDef] of Object.entries(props)) {
+					const prop = propDef;
+					const isReq = required.includes(name);
+					const typeStr = `<${prop.type || "any"}>`;
+					const reqLabel = isReq ? "(required)" : "(optional)";
+					let line = `  --${name} ${typeStr}`.padEnd(24);
+					line += prop.description || "";
+					line += ` ${reqLabel}`;
+					lines.push(line);
+					if (prop.enum) lines.push(`${"".padEnd(24)}Choices: ${prop.enum.join(", ")}`);
+					if (prop.default !== void 0) lines.push(`${"".padEnd(24)}Default: ${prop.default}`);
+				}
+			}
+		}
+		lines.push("");
+		lines.push("Usage:");
+		lines.push(`  afs exec ${read.path}`);
+		return lines.join("\n");
+	}
+	lines.push(read.path);
+	lines.push("");
+	if (read.meta?.kind) lines.push(`Kind:         ${read.meta.kind}`);
+	if (read.meta?.kinds && Array.isArray(read.meta.kinds) && read.meta.kinds.length > 0) lines.push(`Kinds:        ${read.meta.kinds.join(" → ")}`);
+	if (read.childrenCount !== void 0) lines.push(`Children:     ${read.childrenCount}`);
+	const userMeta = extractUserMetadata(read.meta);
+	if (Object.keys(userMeta).length > 0) {
+		lines.push("");
+		lines.push("Metadata:");
+		for (const [key, value] of Object.entries(userMeta)) lines.push(`  ${key.padEnd(12)} ${formatValue(value)}`);
+	}
+	if (read.actions && read.actions.length > 0) {
+		lines.push("");
+		lines.push(`Actions:      ${read.actions.map((a) => a.name).join(", ")}`);
+	}
+	if (read.content !== void 0 && read.content !== null && read.content !== "") {
+		lines.push("");
+		lines.push("Content:");
+		lines.push(formatContent(read.content));
+	} else if (read.childrenCount !== void 0 && read.childrenCount > 0) {
+		lines.push("");
+		lines.push("Content:");
+		lines.push("  (directory - use 'afs ls' to list children)");
+	}
+	return lines.join("\n");
+}
+function formatValue(value) {
+	if (value === null || value === void 0) return "";
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean") return String(value);
+	if (Array.isArray(value)) return value.join(", ");
+	return JSON.stringify(value);
+}
+function formatContent(content) {
+	if (typeof content === "string") return content.split("\n").map((line) => `  ${line}`).join("\n");
+	return `  ${JSON.stringify(content, null, 2).split("\n").join("\n  ")}`;
 }
 
 //#endregion