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

package/dist/commands/mount.mjs.map

@@ -1 +0,0 @@
-{"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,264 +0,0 @@
-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) {
-	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;
-	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,
-		isMeta,
-		isAction,
-		size: entry.metadata?.size,
-		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
-*/
-function formatReadOutput(read, view) {
-	switch (view) {
-		case "json": return formatJson(read);
-		case "llm": return formatLlm(read);
-		case "human": return formatHuman(read);
-		default: return formatDefault(read);
-	}
-}
-/**
-* 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) {
-	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 (includes meta field for regular files if present)
-*/
-function formatJson(read) {
-	return JSON.stringify(read, null, 2);
-}
-/**
-* LLM format: Structured text for AI parsing
-*/
-function formatLlm(read) {
-	const lines = [];
-	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}`);
-	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: Formatted display with metadata and actions
-*/
-function formatHuman(read) {
-	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
-exports.formatReadOutput = formatReadOutput;
-exports.readCommand = readCommand;

package/dist/commands/read.mjs

@@ -1,263 +0,0 @@
-import { isActionsPath, isMetaPath } from "../utils/meta.mjs";
-import { AFSNotFoundError } from "@aigne/afs";
-
-//#region src/commands/read.ts
-/**
-* Read file content
-*/
-async function readCommand(runtime, path) {
-	let result;
-	try {
-		result = await runtime.read(path);
-	} catch (error) {
-		if (error instanceof AFSNotFoundError) return {
-			path,
-			content: void 0
-		};
-		throw error;
-	}
-	if (!result.data) return {
-		path,
-		content: void 0
-	};
-	const entry = result.data;
-	const isMeta = isMetaPath(path);
-	const isAction = 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,
-		isMeta,
-		isAction,
-		size: entry.metadata?.size,
-		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
-*/
-function formatReadOutput(read, view) {
-	switch (view) {
-		case "json": return formatJson(read);
-		case "llm": return formatLlm(read);
-		case "human": return formatHuman(read);
-		default: return formatDefault(read);
-	}
-}
-/**
-* 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) {
-	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 (includes meta field for regular files if present)
-*/
-function formatJson(read) {
-	return JSON.stringify(read, null, 2);
-}
-/**
-* LLM format: Structured text for AI parsing
-*/
-function formatLlm(read) {
-	const lines = [];
-	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}`);
-	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: Formatted display with metadata and actions
-*/
-function formatHuman(read) {
-	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
-export { formatReadOutput, readCommand };
-//# sourceMappingURL=read.mjs.map

package/dist/commands/read.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"read.mjs","names":["parts"],"sources":["../../src/commands/read.ts"],"sourcesContent":["import { type ActionSummary, AFSNotFoundError } from \"@aigne/afs\";\nimport type { AFSRuntime } from \"../runtime.js\";\nimport { isActionsPath, isMetaPath } from \"../utils/meta.js\";\nimport type { ViewType } from \"./ls.js\";\n\nexport interface ReadResult {\n  path: string;\n  content?: string | object;\n  isMeta?: boolean;\n  isAction?: boolean;\n  size?: number;\n  mimeType?: string;\n  childrenCount?: number;\n  /** Actions available on this node (from stat) */\n  actions?: ActionSummary[];\n  meta?: {\n    kind?: string;\n    kinds?: string[];\n    description?: string;\n    inputSchema?: Record<string, unknown>;\n    required?: string[];\n    [key: string]: unknown;\n  };\n}\n\n/**\n * Read file content\n */\nexport async function readCommand(runtime: AFSRuntime, path: string): Promise<ReadResult> {\n  let result: Awaited<ReturnType<typeof runtime.read>>;\n  try {\n    result = await runtime.read(path);\n  } catch (error) {\n    if (error instanceof AFSNotFoundError) {\n      return { path, content: undefined };\n    }\n    throw error;\n  }\n\n  if (!result.data) {\n    return {\n      path,\n      content: undefined,\n    };\n  }\n\n  const entry = result.data;\n  const isMeta = isMetaPath(path);\n  const isAction = isActionsPath(path);\n\n  // For meta paths, content is already an object\n  const content = isMeta\n    ? entry.content\n    : typeof entry.content === \"string\"\n      ? entry.content\n      : entry.content !== undefined\n        ? JSON.stringify(entry.content)\n        : undefined;\n\n  const readResult: ReadResult = {\n    path: entry.path,\n    content,\n    isMeta,\n    isAction,\n    size: entry.metadata?.size,\n    mimeType: entry.metadata?.mimeType,\n    childrenCount: entry.metadata?.childrenCount,\n  };\n\n  // Try to get actions from stat for non-meta/non-action paths\n  if (!isMeta && !isAction) {\n    try {\n      const statResult = await runtime.stat(path);\n      if (statResult.data?.actions && statResult.data.actions.length > 0) {\n        readResult.actions = statResult.data.actions;\n      }\n    } catch {\n      // stat not supported, actions will be undefined\n    }\n  }\n\n  // Add meta for all paths (includes kind, kinds, inputSchema for actions)\n  const meta = extractMeta(entry.metadata);\n  if (meta && Object.keys(meta).length > 0) {\n    readResult.meta = meta;\n  }\n\n  return readResult;\n}\n\n/**\n * Extract meta fields from entry metadata\n * Excludes built-in fields that are exposed separately\n */\nfunction extractMeta(\n  metadata: Record<string, unknown> | null | undefined,\n): ReadResult[\"meta\"] | undefined {\n  if (!metadata) return undefined;\n\n  // Built-in fields that are exposed as separate ReadResult fields\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 as ReadResult[\"meta\"]) : undefined;\n}\n\n/**\n * Extract user-defined metadata (excludes system fields)\n */\nfunction extractUserMetadata(meta: ReadResult[\"meta\"]): Record<string, unknown> {\n  if (!meta) return {};\n  const systemFields = new Set([\n    \"kind\",\n    \"kinds\",\n    \"childrenCount\",\n    \"inputSchema\",\n    \"required\",\n    \"description\",\n  ]);\n  return Object.fromEntries(Object.entries(meta).filter(([k]) => !systemFields.has(k)));\n}\n\n/**\n * Format params summary: format*,path,limit (* = required)\n */\nfunction formatParamsSummary(\n  schema: Record<string, unknown> | undefined,\n  required: string[] = [],\n): string {\n  if (!schema) return \"\";\n  const props = (schema as { properties?: Record<string, unknown> }).properties || schema;\n  return Object.keys(props)\n    .map((name) => (required.includes(name) ? `${name}*` : name))\n    .join(\",\");\n}\n\n/**\n * Check if entry is executable (has afs:executable in kinds)\n */\nfunction isExecutable(meta: ReadResult[\"meta\"]): boolean {\n  if (!meta?.kinds) return false;\n  const kinds = meta.kinds as string[];\n  return kinds.includes(\"afs:executable\");\n}\n\n/**\n * Format read output for different views\n */\nexport function formatReadOutput(read: ReadResult, view: ViewType): string {\n  switch (view) {\n    case \"json\":\n      return formatJson(read);\n    case \"llm\":\n      return formatLlm(read);\n    case \"human\":\n      return formatHuman(read);\n    default:\n      return formatDefault(read);\n  }\n}\n\n/**\n * Default format: Raw content or one-liner summary\n * - If content exists: show raw content\n * - If no content (directories): show one-liner summary /path kind children=N actions=a,b,c\n * - For executables: /path afs:executable params=format*,path,limit\n * - For meta paths: raw JSON\n */\nfunction formatDefault(read: ReadResult): string {\n  // For meta paths, show raw JSON\n  if (read.isMeta && typeof read.content === \"object\") {\n    return JSON.stringify(read.content, null, 2);\n  }\n\n  // For executables (actions) without content, show one-liner with params\n  if (read.isAction && isExecutable(read.meta)) {\n    // If there's content, show it\n    if (read.content !== undefined && read.content !== null && read.content !== \"\") {\n      return typeof read.content === \"string\"\n        ? read.content\n        : JSON.stringify(read.content, null, 2);\n    }\n    // Otherwise show one-liner summary\n    const parts = [read.path, \"afs:executable\"];\n    if (read.meta?.inputSchema) {\n      const params = formatParamsSummary(read.meta.inputSchema, read.meta.required as string[]);\n      if (params) {\n        parts.push(`params=${params}`);\n      }\n    }\n    return parts.join(\" \");\n  }\n\n  // If there's content, show raw content\n  if (read.content !== undefined && read.content !== null && read.content !== \"\") {\n    return typeof read.content === \"string\" ? read.content : JSON.stringify(read.content, null, 2);\n  }\n\n  // For directories (no content), show one-liner summary\n  const parts = [read.path];\n\n  if (read.meta?.kind) {\n    parts.push(read.meta.kind as string);\n  }\n\n  if (read.childrenCount !== undefined) {\n    parts.push(`children=${read.childrenCount}`);\n  }\n\n  if (read.actions && read.actions.length > 0) {\n    parts.push(`actions=${read.actions.map((a) => a.name).join(\",\")}`);\n  }\n\n  return parts.join(\" \");\n}\n\n/**\n * JSON format (includes meta field for regular files if present)\n */\nfunction formatJson(read: ReadResult): string {\n  return JSON.stringify(read, null, 2);\n}\n\n/**\n * LLM format: Structured text for AI parsing\n */\nfunction formatLlm(read: ReadResult): string {\n  const lines: string[] = [];\n\n  // Use META for meta paths\n  if (read.isMeta) {\n    lines.push(`META ${read.path}`);\n\n    const content = read.content as Record<string, unknown> | undefined;\n    if (content?.kind) {\n      lines.push(`KIND ${content.kind}`);\n    }\n\n    lines.push(`CONTENT`);\n    lines.push(JSON.stringify(content));\n    return lines.join(\"\\n\");\n  }\n\n  // For action paths (executables), show EXECUTABLE format\n  if (read.isAction && isExecutable(read.meta)) {\n    lines.push(`EXECUTABLE ${read.path}`);\n\n    if (read.meta?.description) {\n      lines.push(`DESCRIPTION \"${read.meta.description}\"`);\n    }\n\n    // Show parameters\n    if (read.meta?.inputSchema) {\n      const schema = read.meta.inputSchema as { properties?: Record<string, unknown> };\n      const props = schema.properties || {};\n      const required = (read.meta.required as string[]) || [];\n\n      for (const [name, propDef] of Object.entries(props)) {\n        const prop = propDef as Record<string, unknown>;\n        const isReq = required.includes(name);\n        let paramLine = `PARAM ${name} TYPE ${prop.type || \"any\"}`;\n        paramLine += isReq ? \" REQUIRED\" : \" OPTIONAL\";\n\n        if (prop.enum) {\n          paramLine += ` CHOICES ${(prop.enum as string[]).join(\",\")}`;\n        }\n        if (prop.default !== undefined) {\n          paramLine += ` DEFAULT ${prop.default}`;\n        }\n        lines.push(paramLine);\n      }\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  // For regular nodes\n  lines.push(`NODE ${read.path}`);\n\n  if (read.meta?.kind) {\n    lines.push(`KIND ${read.meta.kind}`);\n  }\n  if (read.meta?.kinds && Array.isArray(read.meta.kinds) && read.meta.kinds.length > 0) {\n    lines.push(`KINDS ${read.meta.kinds.join(\" \")}`);\n  }\n\n  if (read.childrenCount !== undefined) {\n    lines.push(`CHILDREN ${read.childrenCount}`);\n  }\n\n  if (read.mimeType) {\n    lines.push(`MIME ${read.mimeType}`);\n  }\n\n  if (read.size !== undefined) {\n    lines.push(`SIZE ${read.size}`);\n  }\n\n  // User metadata\n  const userMeta = extractUserMetadata(read.meta);\n  if (Object.keys(userMeta).length > 0) {\n    const metaStr = Object.entries(userMeta)\n      .map(([k, v]) => `${k}=${JSON.stringify(v)}`)\n      .join(\" \");\n    lines.push(`META ${metaStr}`);\n  }\n\n  // Actions\n  if (read.actions && read.actions.length > 0) {\n    lines.push(`ACTIONS ${read.actions.map((a) => a.name).join(\" \")}`);\n  }\n\n  // Content\n  if (read.content !== undefined && read.content !== null && read.content !== \"\") {\n    lines.push(`CONTENT ${JSON.stringify(read.content)}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Human format: Formatted display with metadata and actions\n */\nfunction formatHuman(read: ReadResult): string {\n  const lines: string[] = [];\n\n  // For meta paths, show the content as JSON\n  if (read.isMeta && typeof read.content === \"object\") {\n    lines.push(`Metadata for ${read.path.replace(/\\/.meta$/, \"\")}`);\n    lines.push(\"\");\n    lines.push(JSON.stringify(read.content, null, 2));\n    return lines.join(\"\\n\");\n  }\n\n  // For action paths (executables), show action definition\n  if (read.isAction && isExecutable(read.meta)) {\n    const actionName = read.path.split(\"/\").pop() || \"action\";\n    lines.push(`Action: ${actionName}`);\n    lines.push(`Path:   ${read.path}`);\n\n    if (read.meta?.description) {\n      lines.push(\"\");\n      lines.push(\"Description:\");\n      lines.push(`  ${read.meta.description}`);\n    }\n\n    // Show parameters from inputSchema\n    if (read.meta?.inputSchema) {\n      const schema = read.meta.inputSchema as { properties?: Record<string, unknown> };\n      const props = schema.properties || {};\n      const required = (read.meta.required as string[]) || [];\n\n      if (Object.keys(props).length > 0) {\n        lines.push(\"\");\n        lines.push(\"Parameters:\");\n        for (const [name, propDef] of Object.entries(props)) {\n          const prop = propDef as Record<string, unknown>;\n          const isReq = required.includes(name);\n          const typeStr = `<${prop.type || \"any\"}>`;\n          const reqLabel = isReq ? \"(required)\" : \"(optional)\";\n          let line = `  --${name} ${typeStr}`.padEnd(24);\n          line += prop.description || \"\";\n          line += ` ${reqLabel}`;\n          lines.push(line);\n\n          if (prop.enum) {\n            lines.push(`${\"\".padEnd(24)}Choices: ${(prop.enum as string[]).join(\", \")}`);\n          }\n          if (prop.default !== undefined) {\n            lines.push(`${\"\".padEnd(24)}Default: ${prop.default}`);\n          }\n        }\n      }\n    }\n\n    lines.push(\"\");\n    lines.push(\"Usage:\");\n    lines.push(`  afs exec ${read.path}`);\n\n    return lines.join(\"\\n\");\n  }\n\n  // For regular nodes, show enhanced view\n  lines.push(read.path);\n  lines.push(\"\");\n\n  // Kind info\n  if (read.meta?.kind) {\n    lines.push(`Kind:         ${read.meta.kind}`);\n  }\n  if (read.meta?.kinds && Array.isArray(read.meta.kinds) && read.meta.kinds.length > 0) {\n    lines.push(`Kinds:        ${read.meta.kinds.join(\" → \")}`);\n  }\n\n  // Children\n  if (read.childrenCount !== undefined) {\n    lines.push(`Children:     ${read.childrenCount}`);\n  }\n\n  // User metadata\n  const userMeta = extractUserMetadata(read.meta);\n  if (Object.keys(userMeta).length > 0) {\n    lines.push(\"\");\n    lines.push(\"Metadata:\");\n    for (const [key, value] of Object.entries(userMeta)) {\n      lines.push(`  ${key.padEnd(12)} ${formatValue(value)}`);\n    }\n  }\n\n  // Actions\n  if (read.actions && read.actions.length > 0) {\n    lines.push(\"\");\n    lines.push(`Actions:      ${read.actions.map((a) => a.name).join(\", \")}`);\n  }\n\n  // Content\n  if (read.content !== undefined && read.content !== null && read.content !== \"\") {\n    lines.push(\"\");\n    lines.push(\"Content:\");\n    lines.push(formatContent(read.content));\n  } else if (read.childrenCount !== undefined && read.childrenCount > 0) {\n    lines.push(\"\");\n    lines.push(\"Content:\");\n    lines.push(\"  (directory - use 'afs ls' to list children)\");\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction formatValue(value: unknown): string {\n  if (value === null || value === undefined) return \"\";\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"boolean\") return String(value);\n  if (Array.isArray(value)) return value.join(\", \");\n  return JSON.stringify(value);\n}\n\nfunction formatContent(content: unknown): string {\n  if (typeof content === \"string\") {\n    // Indent content\n    return content\n      .split(\"\\n\")\n      .map((line) => `  ${line}`)\n      .join(\"\\n\");\n  }\n  return `  ${JSON.stringify(content, null, 2).split(\"\\n\").join(\"\\n  \")}`;\n}\n"],"mappings":"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"}