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

package/dist/commands/mount.cjs

@@ -1,18 +1,32 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_schema = require('../config/schema.cjs');
 const require_loader = require('../config/loader.cjs');
+const require_index = require('../ui/index.cjs');
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
 let smol_toml = require("smol-toml");
 
 //#region src/commands/mount.ts
 /**
+* Check if a path looks like a remote Git URL
+* Matches SSH format (git@host:path) or embedded protocols (https://, http://, ssh://)
+*/
+function isRemoteGitUrl(path) {
+	if (/^[a-zA-Z0-9._-]+@[a-zA-Z0-9._-]+:/.test(path)) return true;
+	if (/^(https?|ssh|git):\/\//.test(path)) return true;
+	return false;
+}
+/**
 * Resolve relative paths in URI to absolute paths
 * Supports fs://, git://, sqlite://, json:// schemes
-* Paths without protocol prefix are treated as fs:// paths
+* Paths without protocol prefix are treated as fs:// paths (unless it's a remote git URL)
 */
 function resolveUriPath(uri, cwd) {
 	const schemeMatch = uri.match(/^([a-z]+):\/\//);
-	if (!schemeMatch) return `fs://${(0, node_path.isAbsolute)(uri) ? uri : (0, node_path.resolve)(cwd, uri)}`;
+	if (!schemeMatch) {
+		if (isRemoteGitUrl(uri)) return `git://${uri}`;
+		return `fs://${(0, node_path.isAbsolute)(uri) ? uri : (0, node_path.resolve)(cwd, uri)}`;
+	}
 	const scheme = schemeMatch[1];
 	const pathPart = uri.slice(schemeMatch[0].length);
 	if (![
@@ -21,6 +35,7 @@ function resolveUriPath(uri, cwd) {
 		"sqlite",
 		"json"
 	].includes(scheme)) return uri;
+	if (scheme === "git" && isRemoteGitUrl(pathPart)) return uri;
 	if ((0, node_path.isAbsolute)(pathPart)) return uri;
 	return `${scheme}://${(0, node_path.resolve)(cwd, pathPart)}`;
 }
@@ -34,27 +49,45 @@ async function mountListCommand(cwd) {
 * Add a mount to config
 */
 async function mountAddCommand(cwd, path, uri, options = {}) {
+	if (!uri || uri.trim() === "") return {
+		success: false,
+		message: "URI is required"
+	};
+	const resolvedUri = resolveUriPath(uri, cwd);
+	const validation = require_schema.MountSchema.safeParse({
+		path,
+		uri: resolvedUri,
+		...options
+	});
+	if (!validation.success) return {
+		success: false,
+		message: validation.error.errors.map((e) => e.message).join("; ")
+	};
+	const newMount = {
+		path: validation.data.path,
+		uri: validation.data.uri,
+		...options.description && { description: options.description }
+	};
 	const configDir = (0, node_path.join)(cwd, require_loader.CONFIG_DIR_NAME);
 	const configPath = (0, node_path.join)(configDir, require_loader.CONFIG_FILE_NAME);
 	const config = { mounts: [] };
 	try {
 		config.mounts = (0, smol_toml.parse)(await (0, node_fs_promises.readFile)(configPath, "utf-8")).mounts ?? [];
 	} catch {}
-	if (config.mounts.some((m) => m.path === path)) return {
+	const normalizedPath = validation.data.path;
+	if (config.mounts.some((m) => m.path === normalizedPath)) return {
 		success: false,
-		message: `Mount path "${path}" already exists`
-	};
-	const newMount = {
-		path,
-		uri: resolveUriPath(uri, cwd),
-		...options.description && { description: options.description }
+		message: `Mount path "${normalizedPath}" already exists`
 	};
 	config.mounts.push(newMount);
 	try {
 		await (0, node_fs_promises.mkdir)(configDir, { recursive: true });
 	} catch {}
 	await (0, node_fs_promises.writeFile)(configPath, (0, smol_toml.stringify)(config), "utf-8");
-	return { success: true };
+	return {
+		success: true,
+		normalizedPath
+	};
 }
 /**
 * Remove a mount from config
@@ -89,8 +122,11 @@ async function mountValidateCommand(cwd) {
 	try {
 		const mounts = (0, smol_toml.parse)(await (0, node_fs_promises.readFile)(configPath, "utf-8")).mounts ?? [];
 		for (const mount of mounts) {
-			if (!mount.path.startsWith("/")) errors.push(`Mount path "${mount.path}" must start with /`);
-			if (!mount.uri || mount.uri.trim() === "") errors.push(`Mount at "${mount.path}" has empty URI`);
+			const validation = require_schema.MountSchema.safeParse(mount);
+			if (!validation.success) {
+				for (const err of validation.error.errors) errors.push(`Mount "${mount.path}": ${err.message}`);
+				continue;
+			}
 			if (mount.uri.startsWith("fs://")) {
 				const targetPath = mount.uri.replace("fs://", "");
 				try {
@@ -138,12 +174,12 @@ function formatLlm(mounts) {
 	}).join("\n\n");
 }
 function formatHuman(mounts) {
-	if (mounts.length === 0) return "No mounts configured.";
-	const lines = ["Configured Mounts:", ""];
+	if (mounts.length === 0) return require_index.colors.dim("No mounts configured.");
+	const lines = [require_index.colors.bold("Configured Mounts:"), ""];
 	for (const m of mounts) {
-		lines.push(`  ${m.path}`);
-		lines.push(`    URI: ${m.uri}`);
-		if (m.description) lines.push(`    Description: ${m.description}`);
+		lines.push(`  ${require_index.colors.cyan(m.path)}`);
+		lines.push(`    ${require_index.colors.dim("URI:")} ${m.uri}`);
+		if (m.description) lines.push(`    ${require_index.colors.dim("Description:")} ${m.description}`);
 		lines.push("");
 	}
 	return lines.join("\n").trimEnd();

package/dist/commands/mount.mjs

@@ -1,17 +1,31 @@
+import { MountSchema } from "../config/schema.mjs";
 import { CONFIG_DIR_NAME, CONFIG_FILE_NAME, ConfigLoader } from "../config/loader.mjs";
+import { colors } from "../ui/index.mjs";
 import { access, mkdir, readFile, writeFile } from "node:fs/promises";
 import { isAbsolute, join, resolve } from "node:path";
 import { parse, stringify } from "smol-toml";
 
 //#region src/commands/mount.ts
 /**
+* Check if a path looks like a remote Git URL
+* Matches SSH format (git@host:path) or embedded protocols (https://, http://, ssh://)
+*/
+function isRemoteGitUrl(path) {
+	if (/^[a-zA-Z0-9._-]+@[a-zA-Z0-9._-]+:/.test(path)) return true;
+	if (/^(https?|ssh|git):\/\//.test(path)) return true;
+	return false;
+}
+/**
 * Resolve relative paths in URI to absolute paths
 * Supports fs://, git://, sqlite://, json:// schemes
-* Paths without protocol prefix are treated as fs:// paths
+* Paths without protocol prefix are treated as fs:// paths (unless it's a remote git URL)
 */
 function resolveUriPath(uri, cwd) {
 	const schemeMatch = uri.match(/^([a-z]+):\/\//);
-	if (!schemeMatch) return `fs://${isAbsolute(uri) ? uri : resolve(cwd, uri)}`;
+	if (!schemeMatch) {
+		if (isRemoteGitUrl(uri)) return `git://${uri}`;
+		return `fs://${isAbsolute(uri) ? uri : resolve(cwd, uri)}`;
+	}
 	const scheme = schemeMatch[1];
 	const pathPart = uri.slice(schemeMatch[0].length);
 	if (![
@@ -20,6 +34,7 @@ function resolveUriPath(uri, cwd) {
 		"sqlite",
 		"json"
 	].includes(scheme)) return uri;
+	if (scheme === "git" && isRemoteGitUrl(pathPart)) return uri;
 	if (isAbsolute(pathPart)) return uri;
 	return `${scheme}://${resolve(cwd, pathPart)}`;
 }
@@ -33,27 +48,45 @@ async function mountListCommand(cwd) {
 * Add a mount to config
 */
 async function mountAddCommand(cwd, path, uri, options = {}) {
+	if (!uri || uri.trim() === "") return {
+		success: false,
+		message: "URI is required"
+	};
+	const resolvedUri = resolveUriPath(uri, cwd);
+	const validation = MountSchema.safeParse({
+		path,
+		uri: resolvedUri,
+		...options
+	});
+	if (!validation.success) return {
+		success: false,
+		message: validation.error.errors.map((e) => e.message).join("; ")
+	};
+	const newMount = {
+		path: validation.data.path,
+		uri: validation.data.uri,
+		...options.description && { description: options.description }
+	};
 	const configDir = join(cwd, CONFIG_DIR_NAME);
 	const configPath = join(configDir, CONFIG_FILE_NAME);
 	const config = { mounts: [] };
 	try {
 		config.mounts = parse(await readFile(configPath, "utf-8")).mounts ?? [];
 	} catch {}
-	if (config.mounts.some((m) => m.path === path)) return {
+	const normalizedPath = validation.data.path;
+	if (config.mounts.some((m) => m.path === normalizedPath)) return {
 		success: false,
-		message: `Mount path "${path}" already exists`
-	};
-	const newMount = {
-		path,
-		uri: resolveUriPath(uri, cwd),
-		...options.description && { description: options.description }
+		message: `Mount path "${normalizedPath}" already exists`
 	};
 	config.mounts.push(newMount);
 	try {
 		await mkdir(configDir, { recursive: true });
 	} catch {}
 	await writeFile(configPath, stringify(config), "utf-8");
-	return { success: true };
+	return {
+		success: true,
+		normalizedPath
+	};
 }
 /**
 * Remove a mount from config
@@ -88,8 +121,11 @@ async function mountValidateCommand(cwd) {
 	try {
 		const mounts = parse(await readFile(configPath, "utf-8")).mounts ?? [];
 		for (const mount of mounts) {
-			if (!mount.path.startsWith("/")) errors.push(`Mount path "${mount.path}" must start with /`);
-			if (!mount.uri || mount.uri.trim() === "") errors.push(`Mount at "${mount.path}" has empty URI`);
+			const validation = MountSchema.safeParse(mount);
+			if (!validation.success) {
+				for (const err of validation.error.errors) errors.push(`Mount "${mount.path}": ${err.message}`);
+				continue;
+			}
 			if (mount.uri.startsWith("fs://")) {
 				const targetPath = mount.uri.replace("fs://", "");
 				try {
@@ -137,12 +173,12 @@ function formatLlm(mounts) {
 	}).join("\n\n");
 }
 function formatHuman(mounts) {
-	if (mounts.length === 0) return "No mounts configured.";
-	const lines = ["Configured Mounts:", ""];
+	if (mounts.length === 0) return colors.dim("No mounts configured.");
+	const lines = [colors.bold("Configured Mounts:"), ""];
 	for (const m of mounts) {
-		lines.push(`  ${m.path}`);
-		lines.push(`    URI: ${m.uri}`);
-		if (m.description) lines.push(`    Description: ${m.description}`);
+		lines.push(`  ${colors.cyan(m.path)}`);
+		lines.push(`    ${colors.dim("URI:")} ${m.uri}`);
+		if (m.description) lines.push(`    ${colors.dim("Description:")} ${m.description}`);
 		lines.push("");
 	}
 	return lines.join("\n").trimEnd();

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 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}\n\nexport interface MountValidateResult {\n  valid: boolean;\n  errors: string[];\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\n */\nfunction resolveUriPath(uri: string, cwd: string): string {\n  const schemeMatch = uri.match(/^([a-z]+):\\/\\//);\n\n  // No protocol prefix - treat as local filesystem path\n  if (!schemeMatch) {\n    // If it's a relative path, resolve it; otherwise use as-is\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  // 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  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\n  if (config.mounts.some((m) => m.path === path)) {\n    return {\n      success: false,\n      message: `Mount path \"${path}\" already exists`,\n    };\n  }\n\n  // Resolve relative paths in URI to absolute paths\n  const resolvedUri = resolveUriPath(uri, cwd);\n\n  // Add new mount\n  const newMount: MountEntry = {\n    path,\n    uri: resolvedUri,\n    ...(options.description && { description: options.description }),\n  };\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  };\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 path starts with /\n      if (!mount.path.startsWith(\"/\")) {\n        errors.push(`Mount path \"${mount.path}\" must start with /`);\n      }\n\n      // Validate URI is not empty\n      if (!mount.uri || mount.uri.trim() === \"\") {\n        errors.push(`Mount at \"${mount.path}\" has empty URI`);\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 \"No mounts configured.\";\n  }\n\n  const lines = [\"Configured Mounts:\", \"\"];\n  for (const m of mounts) {\n    lines.push(`  ${m.path}`);\n    lines.push(`    URI: ${m.uri}`);\n    if (m.description) {\n      lines.push(`    Description: ${m.description}`);\n    }\n    lines.push(\"\");\n  }\n\n  return lines.join(\"\\n\").trimEnd();\n}\n"],"mappings":";;;;;;;;;;;AAkCA,SAAS,eAAe,KAAa,KAAqB;CACxD,MAAM,cAAc,IAAI,MAAM,iBAAiB;AAG/C,KAAI,CAAC,YAGH,QAAO,QADc,WAAW,IAAI,GAAG,MAAM,QAAQ,KAAK,IAAI;CAIhE,MAAM,SAAS,YAAY;CAC3B,MAAM,WAAW,IAAI,MAAM,YAAY,GAAG,OAAO;AAGjD,KAAI,CAAC;EAAC;EAAM;EAAO;EAAU;EAAO,CAAC,SAAS,OAAQ,CACpD,QAAO;AAIT,KAAI,WAAW,SAAS,CACtB,QAAO;AAKT,QAAO,GAAG,OAAO,KADI,QAAQ,KAAK,SAAS;;;;;AAO7C,eAAsB,iBAAiB,KAAuC;AAG5E,QAAO,EACL,SAFa,MADA,IAAI,cAAc,CACL,KAAK,IAAI,EAEpB,QAChB;;;;;AAMH,eAAsB,gBACpB,KACA,MACA,KACA,UAAoC,EAAE,EACT;CAC7B,MAAM,YAAY,KAAK,KAAK,gBAAgB;CAC5C,MAAM,aAAa,KAAK,WAAW,iBAAiB;CAGpD,MAAM,SAAmC,EAAE,QAAQ,EAAE,EAAE;AAEvD,KAAI;AAGF,SAAO,SADQ,MADC,MAAM,SAAS,YAAY,QAAQ,CACtB,CACN,UAAU,EAAE;SAC7B;AAKR,KAAI,OAAO,OAAO,MAAM,MAAM,EAAE,SAAS,KAAK,CAC5C,QAAO;EACL,SAAS;EACT,SAAS,eAAe,KAAK;EAC9B;CAOH,MAAM,WAAuB;EAC3B;EACA,KALkB,eAAe,KAAK,IAAI;EAM1C,GAAI,QAAQ,eAAe,EAAE,aAAa,QAAQ,aAAa;EAChE;AACD,QAAO,OAAO,KAAK,SAAS;AAG5B,KAAI;AACF,QAAM,MAAM,WAAW,EAAE,WAAW,MAAM,CAAC;SACrC;AAKR,OAAM,UAAU,YAAY,UAAU,OAAO,EAAE,QAAQ;AAEvD,QAAO,EACL,SAAS,MACV;;;;;AAMH,eAAsB,mBAAmB,KAAa,MAA2C;CAC/F,MAAM,aAAa,KAAK,KAAK,iBAAiB,iBAAiB;AAE/D,KAAI;EAEF,MAAM,SAAS,MADC,MAAM,SAAS,YAAY,QAAQ,CACtB;EAC7B,MAAM,SAAS,OAAO,UAAU,EAAE;EAElC,MAAM,QAAQ,OAAO,WAAW,MAAM,EAAE,SAAS,KAAK;AACtD,MAAI,UAAU,GACZ,QAAO;GACL,SAAS;GACT,SAAS,eAAe,KAAK;GAC9B;AAGH,SAAO,OAAO,OAAO,EAAE;AACvB,SAAO,SAAS;AAEhB,QAAM,UAAU,YAAY,UAAU,OAAO,EAAE,QAAQ;AAEvD,SAAO,EACL,SAAS,MACV;SACK;AACN,SAAO;GACL,SAAS;GACT,SAAS,eAAe,KAAK;GAC9B;;;;;;AAOL,eAAsB,qBAAqB,KAA2C;CACpF,MAAM,aAAa,KAAK,KAAK,iBAAiB,iBAAiB;CAC/D,MAAM,SAAmB,EAAE;AAE3B,KAAI;EAGF,MAAM,SADS,MADC,MAAM,SAAS,YAAY,QAAQ,CACtB,CACP,UAAU,EAAE;AAElC,OAAK,MAAM,SAAS,QAAQ;AAE1B,OAAI,CAAC,MAAM,KAAK,WAAW,IAAI,CAC7B,QAAO,KAAK,eAAe,MAAM,KAAK,qBAAqB;AAI7D,OAAI,CAAC,MAAM,OAAO,MAAM,IAAI,MAAM,KAAK,GACrC,QAAO,KAAK,aAAa,MAAM,KAAK,iBAAiB;AAIvD,OAAI,MAAM,IAAI,WAAW,QAAQ,EAAE;IACjC,MAAM,aAAa,MAAM,IAAI,QAAQ,SAAS,GAAG;AACjD,QAAI;AACF,WAAM,OAAO,WAAW;YAClB;AACN,YAAO,KAAK,iBAAiB,WAAW,kBAAkB;;;;AAKhE,SAAO;GACL,OAAO,OAAO,WAAW;GACzB;GACD;SACK;AACN,SAAO;GACL,OAAO;GACP,QAAQ,EAAE;GACX;;;;;;AAOL,SAAgB,sBAAsB,QAAsB,MAAwB;AAClF,SAAQ,MAAR;EACE,KAAK,OACH,QAAO,KAAK,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE;EAC5C,KAAK,MACH,QAAO,UAAU,OAAO;EAC1B,KAAK,QACH,QAAO,YAAY,OAAO;EAC5B,QACE,QAAO,cAAc,OAAO;;;AAIlC,SAAS,cAAc,QAA8B;AACnD,KAAI,OAAO,WAAW,EACpB,QAAO;AAGT,QAAO,OACJ,KAAK,MAAM;EACV,MAAM,OAAO,EAAE,cAAc,KAAK,EAAE,YAAY,KAAK;AACrD,SAAO,GAAG,EAAE,KAAK,KAAK,EAAE,MAAM;GAC9B,CACD,KAAK,KAAK;;AAGf,SAAS,UAAU,QAA8B;AAC/C,KAAI,OAAO,WAAW,EACpB,QAAO;AAGT,QAAO,OACJ,KAAK,MAAM;EACV,MAAM,QAAQ,CAAC,SAAS,EAAE,QAAQ,OAAO,EAAE,MAAM;AACjD,MAAI,EAAE,YACJ,OAAM,KAAK,QAAQ,EAAE,cAAc;AAErC,SAAO,MAAM,KAAK,KAAK;GACvB,CACD,KAAK,OAAO;;AAGjB,SAAS,YAAY,QAA8B;AACjD,KAAI,OAAO,WAAW,EACpB,QAAO;CAGT,MAAM,QAAQ,CAAC,sBAAsB,GAAG;AACxC,MAAK,MAAM,KAAK,QAAQ;AACtB,QAAM,KAAK,KAAK,EAAE,OAAO;AACzB,QAAM,KAAK,YAAY,EAAE,MAAM;AAC/B,MAAI,EAAE,YACJ,OAAM,KAAK,oBAAoB,EAAE,cAAc;AAEjD,QAAM,KAAK,GAAG;;AAGhB,QAAO,MAAM,KAAK,KAAK,CAAC,SAAS"}
+{"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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"}

package/dist/commands/serve.cjs

@@ -0,0 +1,142 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_loader = require('../config/loader.cjs');
+const require_index = require('../ui/index.cjs');
+const require_runtime = require('../runtime.cjs');
+let node_http = require("node:http");
+let _aigne_afs_http = require("@aigne/afs-http");
+
+//#region src/commands/serve.ts
+/**
+* Create an AFSModule wrapper around AFSRuntime
+*/
+function createRuntimeModule(runtime, readonly) {
+	return {
+		name: "afs-server",
+		accessMode: readonly ? "readonly" : "readwrite",
+		async list(path, options) {
+			return runtime.list(path, options);
+		},
+		async read(path, options) {
+			return runtime.read(path, options);
+		},
+		async write(path, content, options) {
+			if (readonly) throw new Error("Server is in readonly mode");
+			return runtime.write(path, content, options);
+		},
+		async delete(path, options) {
+			if (readonly) throw new Error("Server is in readonly mode");
+			return runtime.delete(path, options);
+		},
+		async search(path, query, options) {
+			return runtime.search(path, query, options);
+		}
+	};
+}
+/**
+* Start HTTP server to expose AFS providers
+*/
+async function serveCommand(options = {}) {
+	const config = await new require_loader.ConfigLoader().load(process.cwd());
+	const serveConfig = config.serve ?? {};
+	const host = options.host ?? serveConfig.host ?? "localhost";
+	const port = options.port ?? serveConfig.port ?? 3e3;
+	const basePath = options.path ?? serveConfig.path ?? "/afs";
+	const readonly = options.readonly ?? serveConfig.readonly ?? false;
+	const cors = options.cors ?? serveConfig.cors ?? false;
+	const maxBodySize = options.maxBodySize ?? serveConfig.max_body_size ?? 10 * 1024 * 1024;
+	const runtime = await require_runtime.createRuntime();
+	const mounts = config.mounts.map((m) => ({
+		path: m.path,
+		provider: m.uri
+	}));
+	const handler = (0, _aigne_afs_http.createAFSHttpHandler)({
+		module: createRuntimeModule(runtime, readonly),
+		maxBodySize
+	});
+	const server = (0, node_http.createServer)(async (req, res) => {
+		const url = new URL(req.url || "/", `http://${req.headers.host}`);
+		const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+		console.error(`${timestamp} ${req.method} ${url.pathname}`);
+		if (cors) {
+			res.setHeader("Access-Control-Allow-Origin", "*");
+			res.setHeader("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS");
+			res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization");
+			if (req.method === "OPTIONS") {
+				res.writeHead(204);
+				res.end();
+				return;
+			}
+		}
+		if (!url.pathname.startsWith(basePath)) {
+			res.writeHead(404, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({
+				code: 1,
+				error: "Not found"
+			}));
+			return;
+		}
+		const headers = new Headers();
+		for (const [key, value] of Object.entries(req.headers)) if (value) headers.append(key, Array.isArray(value) ? value.join(", ") : value);
+		const chunks = [];
+		for await (const chunk of req) chunks.push(chunk);
+		const body = Buffer.concat(chunks);
+		const request = new Request(`http://${req.headers.host}${req.url}`, {
+			method: req.method,
+			headers,
+			body: body.length > 0 ? body : void 0
+		});
+		try {
+			const response = await handler(request);
+			res.writeHead(response.status, { "Content-Type": response.headers.get("Content-Type") || "application/json" });
+			const responseBody = await response.text();
+			res.end(responseBody);
+			console.error(`${timestamp} ${req.method} ${url.pathname} status=${response.status}`);
+		} catch (error) {
+			console.error(`Error handling request:`, error);
+			res.writeHead(500, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({
+				code: 5,
+				error: "Internal server error"
+			}));
+		}
+	});
+	await new Promise((resolve, reject) => {
+		server.listen(port, host, () => {
+			resolve();
+		});
+		server.on("error", reject);
+	});
+	const shutdown = () => {
+		console.error("\nShutting down server...");
+		server.close(() => {
+			process.exit(0);
+		});
+	};
+	process.on("SIGINT", shutdown);
+	process.on("SIGTERM", shutdown);
+	return {
+		success: true,
+		host,
+		port,
+		path: basePath,
+		url: `http://${host}:${port}${basePath}`,
+		mounts
+	};
+}
+/**
+* Format serve result for output
+*/
+function formatServeOutput(result) {
+	const lines = [];
+	lines.push(require_index.colors.green("AFS HTTP Server starting..."));
+	lines.push(require_index.colors.bold("Mounted providers:"));
+	for (const mount of result.mounts) lines.push(`  ${require_index.colors.cyan(mount.path.padEnd(20))} ${require_index.colors.dim(mount.provider)}`);
+	lines.push("");
+	lines.push(`${require_index.colors.dim("Listening on:")} ${require_index.colors.brightCyan(result.url)}`);
+	lines.push(require_index.colors.dim("Press Ctrl+C to stop"));
+	return lines.join("\n");
+}
+
+//#endregion
+exports.formatServeOutput = formatServeOutput;
+exports.serveCommand = serveCommand;

package/dist/commands/serve.mjs

@@ -0,0 +1,141 @@
+import { ConfigLoader } from "../config/loader.mjs";
+import { colors } from "../ui/index.mjs";
+import { createRuntime } from "../runtime.mjs";
+import { createServer } from "node:http";
+import { createAFSHttpHandler } from "@aigne/afs-http";
+
+//#region src/commands/serve.ts
+/**
+* Create an AFSModule wrapper around AFSRuntime
+*/
+function createRuntimeModule(runtime, readonly) {
+	return {
+		name: "afs-server",
+		accessMode: readonly ? "readonly" : "readwrite",
+		async list(path, options) {
+			return runtime.list(path, options);
+		},
+		async read(path, options) {
+			return runtime.read(path, options);
+		},
+		async write(path, content, options) {
+			if (readonly) throw new Error("Server is in readonly mode");
+			return runtime.write(path, content, options);
+		},
+		async delete(path, options) {
+			if (readonly) throw new Error("Server is in readonly mode");
+			return runtime.delete(path, options);
+		},
+		async search(path, query, options) {
+			return runtime.search(path, query, options);
+		}
+	};
+}
+/**
+* Start HTTP server to expose AFS providers
+*/
+async function serveCommand(options = {}) {
+	const config = await new ConfigLoader().load(process.cwd());
+	const serveConfig = config.serve ?? {};
+	const host = options.host ?? serveConfig.host ?? "localhost";
+	const port = options.port ?? serveConfig.port ?? 3e3;
+	const basePath = options.path ?? serveConfig.path ?? "/afs";
+	const readonly = options.readonly ?? serveConfig.readonly ?? false;
+	const cors = options.cors ?? serveConfig.cors ?? false;
+	const maxBodySize = options.maxBodySize ?? serveConfig.max_body_size ?? 10 * 1024 * 1024;
+	const runtime = await createRuntime();
+	const mounts = config.mounts.map((m) => ({
+		path: m.path,
+		provider: m.uri
+	}));
+	const handler = createAFSHttpHandler({
+		module: createRuntimeModule(runtime, readonly),
+		maxBodySize
+	});
+	const server = createServer(async (req, res) => {
+		const url = new URL(req.url || "/", `http://${req.headers.host}`);
+		const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+		console.error(`${timestamp} ${req.method} ${url.pathname}`);
+		if (cors) {
+			res.setHeader("Access-Control-Allow-Origin", "*");
+			res.setHeader("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS");
+			res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization");
+			if (req.method === "OPTIONS") {
+				res.writeHead(204);
+				res.end();
+				return;
+			}
+		}
+		if (!url.pathname.startsWith(basePath)) {
+			res.writeHead(404, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({
+				code: 1,
+				error: "Not found"
+			}));
+			return;
+		}
+		const headers = new Headers();
+		for (const [key, value] of Object.entries(req.headers)) if (value) headers.append(key, Array.isArray(value) ? value.join(", ") : value);
+		const chunks = [];
+		for await (const chunk of req) chunks.push(chunk);
+		const body = Buffer.concat(chunks);
+		const request = new Request(`http://${req.headers.host}${req.url}`, {
+			method: req.method,
+			headers,
+			body: body.length > 0 ? body : void 0
+		});
+		try {
+			const response = await handler(request);
+			res.writeHead(response.status, { "Content-Type": response.headers.get("Content-Type") || "application/json" });
+			const responseBody = await response.text();
+			res.end(responseBody);
+			console.error(`${timestamp} ${req.method} ${url.pathname} status=${response.status}`);
+		} catch (error) {
+			console.error(`Error handling request:`, error);
+			res.writeHead(500, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({
+				code: 5,
+				error: "Internal server error"
+			}));
+		}
+	});
+	await new Promise((resolve, reject) => {
+		server.listen(port, host, () => {
+			resolve();
+		});
+		server.on("error", reject);
+	});
+	const shutdown = () => {
+		console.error("\nShutting down server...");
+		server.close(() => {
+			process.exit(0);
+		});
+	};
+	process.on("SIGINT", shutdown);
+	process.on("SIGTERM", shutdown);
+	return {
+		success: true,
+		host,
+		port,
+		path: basePath,
+		url: `http://${host}:${port}${basePath}`,
+		mounts
+	};
+}
+/**
+* Format serve result for output
+*/
+function formatServeOutput(result) {
+	const lines = [];
+	lines.push(colors.green("AFS HTTP Server starting..."));
+	lines.push(colors.bold("Mounted providers:"));
+	for (const mount of result.mounts) lines.push(`  ${colors.cyan(mount.path.padEnd(20))} ${colors.dim(mount.provider)}`);
+	lines.push("");
+	lines.push(`${colors.dim("Listening on:")} ${colors.brightCyan(result.url)}`);
+	lines.push(colors.dim("Press Ctrl+C to stop"));
+	return lines.join("\n");
+}
+
+//#endregion
+export { formatServeOutput, serveCommand };
+//# sourceMappingURL=serve.mjs.map

package/dist/commands/serve.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.mjs","names":[],"sources":["../../src/commands/serve.ts"],"sourcesContent":["/**\n * AFS Serve Command\n *\n * Starts an HTTP server to expose AFS providers over HTTP transport\n */\n\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\nimport { createServer } from \"node:http\";\nimport type { AFSModule } from \"@aigne/afs\";\nimport { createAFSHttpHandler } from \"@aigne/afs-http\";\nimport { ConfigLoader } from \"../config/loader.js\";\nimport type { MountConfig, ServeConfig } from \"../config/schema.js\";\nimport { type AFSRuntime, createRuntime } from \"../runtime.js\";\nimport { colors } from \"../ui/index.js\";\n\nexport interface ServeOptions {\n  host?: string;\n  port?: number;\n  path?: string;\n  readonly?: boolean;\n  cors?: boolean;\n  maxBodySize?: number;\n}\n\nexport interface ServeResult {\n  success: boolean;\n  host: string;\n  port: number;\n  path: string;\n  url: string;\n  mounts: Array<{ path: string; provider: string }>;\n}\n\n/**\n * Create an AFSModule wrapper around AFSRuntime\n */\nfunction createRuntimeModule(runtime: AFSRuntime, readonly: boolean): AFSModule {\n  return {\n    name: \"afs-server\",\n    accessMode: readonly ? \"readonly\" : \"readwrite\",\n    async list(path, options) {\n      return runtime.list(path, options);\n    },\n    async read(path, options) {\n      return runtime.read(path, options);\n    },\n    async write(path, content, options) {\n      if (readonly) {\n        throw new Error(\"Server is in readonly mode\");\n      }\n      return runtime.write(path, content, options);\n    },\n    async delete(path, options) {\n      if (readonly) {\n        throw new Error(\"Server is in readonly mode\");\n      }\n      return runtime.delete(path, options);\n    },\n    async search(path, query, options) {\n      return runtime.search(path, query, options);\n    },\n  };\n}\n\n/**\n * Start HTTP server to expose AFS providers\n */\nexport async function serveCommand(options: ServeOptions = {}): Promise<ServeResult> {\n  // Load config to get mount information and serve defaults\n  const configLoader = new ConfigLoader();\n  const config = await configLoader.load(process.cwd());\n\n  // Get serve config from config file (may be partial or undefined)\n  const serveConfig: Partial<ServeConfig> = config.serve ?? {};\n\n  // Merge: command line > config file > defaults\n  const host = options.host ?? serveConfig.host ?? \"localhost\";\n  const port = options.port ?? serveConfig.port ?? 3000;\n  const basePath = options.path ?? serveConfig.path ?? \"/afs\";\n  const readonly = options.readonly ?? serveConfig.readonly ?? false;\n  const cors = options.cors ?? serveConfig.cors ?? false;\n  const maxBodySize = options.maxBodySize ?? serveConfig.max_body_size ?? 10 * 1024 * 1024;\n\n  // Create runtime and load all mounts\n  const runtime = await createRuntime();\n  const mounts: Array<{ path: string; provider: string }> = config.mounts.map((m: MountConfig) => ({\n    path: m.path,\n    provider: m.uri,\n  }));\n\n  // Create AFSModule wrapper\n  const module = createRuntimeModule(runtime, readonly);\n\n  // Create HTTP handler\n  const handler = createAFSHttpHandler({\n    module,\n    maxBodySize,\n  });\n\n  // Create HTTP server with path routing\n  const server = createServer(async (req: IncomingMessage, res: ServerResponse) => {\n    const url = new URL(req.url || \"/\", `http://${req.headers.host}`);\n\n    // Log request (default view)\n    const timestamp = new Date().toISOString();\n    console.error(`${timestamp} ${req.method} ${url.pathname}`);\n\n    // CORS support\n    if (cors) {\n      res.setHeader(\"Access-Control-Allow-Origin\", \"*\");\n      res.setHeader(\"Access-Control-Allow-Methods\", \"GET, POST, PUT, DELETE, OPTIONS\");\n      res.setHeader(\"Access-Control-Allow-Headers\", \"Content-Type, Authorization\");\n\n      if (req.method === \"OPTIONS\") {\n        res.writeHead(204);\n        res.end();\n        return;\n      }\n    }\n\n    // Check if request is for our base path\n    if (!url.pathname.startsWith(basePath)) {\n      res.writeHead(404, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify({ code: 1, error: \"Not found\" }));\n      return;\n    }\n\n    // Convert Node.js request to Web Standard Request\n    const headers = new Headers();\n    for (const [key, value] of Object.entries(req.headers)) {\n      if (value) {\n        headers.append(key, Array.isArray(value) ? value.join(\", \") : value);\n      }\n    }\n\n    // Collect request body\n    const chunks: Buffer[] = [];\n    for await (const chunk of req) {\n      chunks.push(chunk);\n    }\n    const body = Buffer.concat(chunks);\n\n    const request = new Request(`http://${req.headers.host}${req.url}`, {\n      method: req.method,\n      headers,\n      body: body.length > 0 ? body : undefined,\n    });\n\n    try {\n      // Call handler\n      const response = await handler(request);\n\n      // Copy response to Node.js response\n      res.writeHead(response.status, {\n        \"Content-Type\": response.headers.get(\"Content-Type\") || \"application/json\",\n      });\n\n      const responseBody = await response.text();\n      res.end(responseBody);\n\n      // Log response\n      console.error(`${timestamp} ${req.method} ${url.pathname} status=${response.status}`);\n    } catch (error) {\n      console.error(`Error handling request:`, error);\n      res.writeHead(500, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify({ code: 5, error: \"Internal server error\" }));\n    }\n  });\n\n  // Start server\n  await new Promise<void>((resolve, reject) => {\n    server.listen(port, host, () => {\n      resolve();\n    });\n    server.on(\"error\", reject);\n  });\n\n  // Handle graceful shutdown\n  const shutdown = () => {\n    console.error(\"\\nShutting down server...\");\n    server.close(() => {\n      process.exit(0);\n    });\n  };\n\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n\n  const url = `http://${host}:${port}${basePath}`;\n\n  return {\n    success: true,\n    host,\n    port,\n    path: basePath,\n    url,\n    mounts,\n  };\n}\n\n/**\n * Format serve result for output\n */\nexport function formatServeOutput(result: ServeResult): string {\n  const lines: string[] = [];\n\n  lines.push(colors.green(\"AFS HTTP Server starting...\"));\n  lines.push(colors.bold(\"Mounted providers:\"));\n\n  for (const mount of result.mounts) {\n    lines.push(`  ${colors.cyan(mount.path.padEnd(20))} ${colors.dim(mount.provider)}`);\n  }\n\n  lines.push(\"\");\n  lines.push(`${colors.dim(\"Listening on:\")} ${colors.brightCyan(result.url)}`);\n  lines.push(colors.dim(\"Press Ctrl+C to stop\"));\n\n  return lines.join(\"\\n\");\n}\n"],"mappings":"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"}

package/dist/config/loader.cjs

@@ -114,17 +114,39 @@ var ConfigLoader = class {
 		return result.data;
 	}
 	/**
-	* Merge multiple configs, checking for duplicate mount paths
+	* Create a composite key for namespace+path duplicate detection
+	* Uses empty string for undefined namespace (default namespace)
+	*/
+	makeNamespacePathKey(namespace, path) {
+		return `${namespace ?? ""}:${path}`;
+	}
+	/**
+	* Merge multiple configs, checking for duplicate mount paths within same namespace
+	* For serve config, later (more specific) configs override earlier ones
 	*/
 	mergeConfigs(configs) {
 		const allMounts = [];
 		const seenPaths = /* @__PURE__ */ new Map();
-		for (const config of configs) for (const mount of config.mounts) {
-			if (seenPaths.has(mount.path)) throw new Error(`Duplicate mount path "${mount.path}" found in configuration. Mount paths must be unique across all config files.`);
-			seenPaths.set(mount.path, mount.uri);
-			allMounts.push(mount);
+		let mergedServe;
+		for (const config of configs) {
+			for (const mount of config.mounts) {
+				const key = this.makeNamespacePathKey(mount.namespace, mount.path);
+				if (seenPaths.has(key)) {
+					const nsLabel = mount.namespace ? `namespace '${mount.namespace}'` : "default namespace";
+					throw new Error(`Duplicate mount path "${mount.path}" in ${nsLabel} found in configuration. Mount paths must be unique within each namespace.`);
+				}
+				seenPaths.set(key, mount.uri);
+				allMounts.push(mount);
+			}
+			if (config.serve) mergedServe = mergedServe ? {
+				...mergedServe,
+				...config.serve
+			} : config.serve;
 		}
-		return { mounts: allMounts };
+		return {
+			mounts: allMounts,
+			serve: mergedServe
+		};
 	}
 	/**
 	* Find project root by looking for .git