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

package/dist/core/commands/serve.cjs

@@ -0,0 +1,242 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_index = require('../../ui/index.cjs');
+const require_loader = require('../../config/loader.cjs');
+const require_types = require('./types.cjs');
+let node_http = require("node:http");
+let _aigne_afs_http = require("@aigne/afs-http");
+
+//#region src/core/commands/serve.ts
+/**
+* Create an AFSModule wrapper around AFS
+*/
+function createAFSModule(afs, readonly) {
+	return {
+		name: "afs-server",
+		accessMode: readonly ? "readonly" : "readwrite",
+		async list(path, options) {
+			return afs.list(path, options);
+		},
+		async read(path, options) {
+			return afs.read(path, options);
+		},
+		async write(path, content, options) {
+			if (readonly) throw new Error("Server is in readonly mode");
+			return afs.write(path, content, options);
+		},
+		async delete(path, options) {
+			if (readonly) throw new Error("Server is in readonly mode");
+			return afs.delete(path, options);
+		},
+		async search(path, query, options) {
+			return afs.search(path, query, options);
+		},
+		async stat(path, options) {
+			return afs.stat(path, options);
+		},
+		async explain(path, options) {
+			return afs.explain(path, options);
+		},
+		async exec(path, args, options) {
+			if (readonly) throw new Error("Server is in readonly mode");
+			return afs.exec(path, args, options);
+		},
+		async rename(oldPath, newPath, options) {
+			if (readonly) throw new Error("Server is in readonly mode");
+			return afs.rename(oldPath, newPath, options);
+		}
+	};
+}
+/**
+* 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");
+}
+/**
+* Create serve command
+*/
+function createServeCommand(options) {
+	return {
+		command: "serve",
+		describe: "Start AFS server (HTTP or MCP)",
+		builder: {
+			host: {
+				type: "string",
+				default: "localhost",
+				description: "Host to bind"
+			},
+			port: {
+				type: "number",
+				default: 3e3,
+				description: "Port to listen on"
+			},
+			path: {
+				type: "string",
+				default: "/afs",
+				description: "Base path for API"
+			},
+			readonly: {
+				type: "boolean",
+				default: false,
+				description: "Read-only mode"
+			},
+			cors: {
+				type: "boolean",
+				default: false,
+				description: "Enable CORS"
+			},
+			transport: {
+				type: "string",
+				default: "http",
+				choices: [
+					"http",
+					"mcp-stdio",
+					"mcp-http"
+				],
+				description: "Transport: http (default), mcp-stdio, or mcp-http"
+			}
+		},
+		handler: async (argv) => {
+			const config = await new require_loader.ConfigLoader().load(process.cwd());
+			const serveConfig = config.serve ?? {};
+			const host = argv.host ?? serveConfig.host ?? "localhost";
+			const port = argv.port ?? serveConfig.port ?? 3e3;
+			const basePath = argv.path ?? serveConfig.path ?? "/afs";
+			const readonly = argv.readonly ?? serveConfig.readonly ?? false;
+			const cors = argv.cors ?? serveConfig.cors ?? false;
+			const maxBodySize = serveConfig.max_body_size ?? 10 * 1024 * 1024;
+			const token = serveConfig.token;
+			const mounts = config.mounts.map((m) => ({
+				path: m.path,
+				provider: m.uri
+			}));
+			const afs = await require_types.resolveAFS(options);
+			if (argv.transport === "mcp-stdio") {
+				const { createAFSMcpServer } = await Promise.resolve().then(() => require("../../mcp/server.cjs"));
+				const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+				const { server: mcpServer } = createAFSMcpServer({ afs });
+				const transport = new StdioServerTransport();
+				await mcpServer.connect(transport);
+				await new Promise((resolve) => {
+					process.on("SIGINT", async () => {
+						await mcpServer.close();
+						resolve();
+					});
+					process.on("SIGTERM", async () => {
+						await mcpServer.close();
+						resolve();
+					});
+				});
+				return;
+			}
+			if (argv.transport === "mcp-http") {
+				const { createAFSMcpServer } = await Promise.resolve().then(() => require("../../mcp/server.cjs"));
+				const { startMcpHttpServer } = await Promise.resolve().then(() => require("../../mcp/http-transport.cjs"));
+				const { server: mcpServer } = createAFSMcpServer({ afs });
+				await startMcpHttpServer({
+					mcpServer,
+					host,
+					port,
+					cors
+				});
+				await new Promise((resolve) => {
+					process.on("SIGINT", async () => {
+						await mcpServer.close();
+						resolve();
+					});
+					process.on("SIGTERM", async () => {
+						await mcpServer.close();
+						resolve();
+					});
+				});
+				return;
+			}
+			const handler = (0, _aigne_afs_http.createAFSHttpHandler)({
+				module: createAFSModule(afs, readonly),
+				maxBodySize,
+				token
+			});
+			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);
+			const result = {
+				success: true,
+				host,
+				port,
+				path: basePath,
+				url: `http://${host}:${port}${basePath}`,
+				mounts
+			};
+			console.log(formatServeOutput(result));
+			await new Promise(() => {});
+		}
+	};
+}
+
+//#endregion
+exports.createServeCommand = createServeCommand;

package/dist/core/commands/serve.d.mts

@@ -0,0 +1,2 @@
+import "./types.mjs";
+import { CommandModule } from "yargs";

package/dist/core/commands/serve.mjs

@@ -0,0 +1,242 @@
+import { colors } from "../../ui/index.mjs";
+import { ConfigLoader } from "../../config/loader.mjs";
+import { resolveAFS } from "./types.mjs";
+import { createServer } from "node:http";
+import { createAFSHttpHandler } from "@aigne/afs-http";
+
+//#region src/core/commands/serve.ts
+/**
+* Create an AFSModule wrapper around AFS
+*/
+function createAFSModule(afs, readonly) {
+	return {
+		name: "afs-server",
+		accessMode: readonly ? "readonly" : "readwrite",
+		async list(path, options) {
+			return afs.list(path, options);
+		},
+		async read(path, options) {
+			return afs.read(path, options);
+		},
+		async write(path, content, options) {
+			if (readonly) throw new Error("Server is in readonly mode");
+			return afs.write(path, content, options);
+		},
+		async delete(path, options) {
+			if (readonly) throw new Error("Server is in readonly mode");
+			return afs.delete(path, options);
+		},
+		async search(path, query, options) {
+			return afs.search(path, query, options);
+		},
+		async stat(path, options) {
+			return afs.stat(path, options);
+		},
+		async explain(path, options) {
+			return afs.explain(path, options);
+		},
+		async exec(path, args, options) {
+			if (readonly) throw new Error("Server is in readonly mode");
+			return afs.exec(path, args, options);
+		},
+		async rename(oldPath, newPath, options) {
+			if (readonly) throw new Error("Server is in readonly mode");
+			return afs.rename(oldPath, newPath, options);
+		}
+	};
+}
+/**
+* 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");
+}
+/**
+* Create serve command
+*/
+function createServeCommand(options) {
+	return {
+		command: "serve",
+		describe: "Start AFS server (HTTP or MCP)",
+		builder: {
+			host: {
+				type: "string",
+				default: "localhost",
+				description: "Host to bind"
+			},
+			port: {
+				type: "number",
+				default: 3e3,
+				description: "Port to listen on"
+			},
+			path: {
+				type: "string",
+				default: "/afs",
+				description: "Base path for API"
+			},
+			readonly: {
+				type: "boolean",
+				default: false,
+				description: "Read-only mode"
+			},
+			cors: {
+				type: "boolean",
+				default: false,
+				description: "Enable CORS"
+			},
+			transport: {
+				type: "string",
+				default: "http",
+				choices: [
+					"http",
+					"mcp-stdio",
+					"mcp-http"
+				],
+				description: "Transport: http (default), mcp-stdio, or mcp-http"
+			}
+		},
+		handler: async (argv) => {
+			const config = await new ConfigLoader().load(process.cwd());
+			const serveConfig = config.serve ?? {};
+			const host = argv.host ?? serveConfig.host ?? "localhost";
+			const port = argv.port ?? serveConfig.port ?? 3e3;
+			const basePath = argv.path ?? serveConfig.path ?? "/afs";
+			const readonly = argv.readonly ?? serveConfig.readonly ?? false;
+			const cors = argv.cors ?? serveConfig.cors ?? false;
+			const maxBodySize = serveConfig.max_body_size ?? 10 * 1024 * 1024;
+			const token = serveConfig.token;
+			const mounts = config.mounts.map((m) => ({
+				path: m.path,
+				provider: m.uri
+			}));
+			const afs = await resolveAFS(options);
+			if (argv.transport === "mcp-stdio") {
+				const { createAFSMcpServer } = await import("../../mcp/server.mjs");
+				const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+				const { server: mcpServer } = createAFSMcpServer({ afs });
+				const transport = new StdioServerTransport();
+				await mcpServer.connect(transport);
+				await new Promise((resolve) => {
+					process.on("SIGINT", async () => {
+						await mcpServer.close();
+						resolve();
+					});
+					process.on("SIGTERM", async () => {
+						await mcpServer.close();
+						resolve();
+					});
+				});
+				return;
+			}
+			if (argv.transport === "mcp-http") {
+				const { createAFSMcpServer } = await import("../../mcp/server.mjs");
+				const { startMcpHttpServer } = await import("../../mcp/http-transport.mjs");
+				const { server: mcpServer } = createAFSMcpServer({ afs });
+				await startMcpHttpServer({
+					mcpServer,
+					host,
+					port,
+					cors
+				});
+				await new Promise((resolve) => {
+					process.on("SIGINT", async () => {
+						await mcpServer.close();
+						resolve();
+					});
+					process.on("SIGTERM", async () => {
+						await mcpServer.close();
+						resolve();
+					});
+				});
+				return;
+			}
+			const handler = createAFSHttpHandler({
+				module: createAFSModule(afs, readonly),
+				maxBodySize,
+				token
+			});
+			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);
+			const result = {
+				success: true,
+				host,
+				port,
+				path: basePath,
+				url: `http://${host}:${port}${basePath}`,
+				mounts
+			};
+			console.log(formatServeOutput(result));
+			await new Promise(() => {});
+		}
+	};
+}
+
+//#endregion
+export { createServeCommand };
+//# sourceMappingURL=serve.mjs.map

package/dist/core/commands/serve.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.mjs","names":[],"sources":["../../../src/core/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 { AFS, AFSModule } from \"@aigne/afs\";\nimport { createAFSHttpHandler } from \"@aigne/afs-http\";\nimport type { CommandModule } from \"yargs\";\nimport { ConfigLoader } from \"../../config/loader.js\";\nimport type { MountConfig, ServeConfig } from \"../../config/schema.js\";\nimport { colors } from \"../../ui/index.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\nexport interface ServeArgs {\n  host: string;\n  port: number;\n  path: string;\n  readonly: boolean;\n  cors: boolean;\n  transport: \"http\" | \"mcp-stdio\" | \"mcp-http\";\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 AFS\n */\nfunction createAFSModule(afs: AFS, readonly: boolean): AFSModule {\n  return {\n    name: \"afs-server\",\n    accessMode: readonly ? \"readonly\" : \"readwrite\",\n    async list(path, options) {\n      return afs.list(path, options);\n    },\n    async read(path, options) {\n      return afs.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 afs.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 afs.delete(path, options);\n    },\n    async search(path, query, options) {\n      return afs.search(path, query, options);\n    },\n    async stat(path, options) {\n      return afs.stat(path, options);\n    },\n    async explain(path, options) {\n      return afs.explain(path, options);\n    },\n    async exec(path, args, options) {\n      if (readonly) {\n        throw new Error(\"Server is in readonly mode\");\n      }\n      return afs.exec(path, args, options);\n    },\n    async rename(oldPath, newPath, options) {\n      if (readonly) {\n        throw new Error(\"Server is in readonly mode\");\n      }\n      return afs.rename(oldPath, newPath, options);\n    },\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\n/**\n * Create serve command\n */\nexport function createServeCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, ServeArgs> {\n  return {\n    command: \"serve\",\n    describe: \"Start AFS server (HTTP or MCP)\",\n    builder: {\n      host: { type: \"string\", default: \"localhost\", description: \"Host to bind\" },\n      port: { type: \"number\", default: 3000, description: \"Port to listen on\" },\n      path: { type: \"string\", default: \"/afs\", description: \"Base path for API\" },\n      readonly: { type: \"boolean\", default: false, description: \"Read-only mode\" },\n      cors: { type: \"boolean\", default: false, description: \"Enable CORS\" },\n      transport: {\n        type: \"string\",\n        default: \"http\",\n        choices: [\"http\", \"mcp-stdio\", \"mcp-http\"],\n        description: \"Transport: http (default), mcp-stdio, or mcp-http\",\n      },\n    },\n    handler: async (argv) => {\n      // Load config for serve defaults and mount info\n      const configLoader = new ConfigLoader();\n      const config = await configLoader.load(process.cwd());\n\n      const serveConfig: Partial<ServeConfig> = config.serve ?? {};\n\n      // Merge: command line > config file > defaults\n      const host = argv.host ?? serveConfig.host ?? \"localhost\";\n      const port = argv.port ?? serveConfig.port ?? 3000;\n      const basePath = argv.path ?? serveConfig.path ?? \"/afs\";\n      const readonly = argv.readonly ?? serveConfig.readonly ?? false;\n      const cors = argv.cors ?? serveConfig.cors ?? false;\n      const maxBodySize = serveConfig.max_body_size ?? 10 * 1024 * 1024;\n      const token = serveConfig.token;\n\n      const mounts: Array<{ path: string; provider: string }> = config.mounts.map(\n        (m: MountConfig) => ({\n          path: m.path,\n          provider: m.uri,\n        }),\n      );\n\n      // Create AFS instance\n      const afs = await resolveAFS(options);\n\n      // Dispatch based on transport mode\n      if (argv.transport === \"mcp-stdio\") {\n        const { createAFSMcpServer } = await import(\"../../mcp/server.js\");\n        const { StdioServerTransport } = await import(\"@modelcontextprotocol/sdk/server/stdio.js\");\n        const { server: mcpServer } = createAFSMcpServer({ afs });\n        const transport = new StdioServerTransport();\n        await mcpServer.connect(transport);\n        // Block until server closes\n        await new Promise<void>((resolve) => {\n          process.on(\"SIGINT\", async () => {\n            await mcpServer.close();\n            resolve();\n          });\n          process.on(\"SIGTERM\", async () => {\n            await mcpServer.close();\n            resolve();\n          });\n        });\n        return;\n      }\n\n      if (argv.transport === \"mcp-http\") {\n        const { createAFSMcpServer } = await import(\"../../mcp/server.js\");\n        const { startMcpHttpServer } = await import(\"../../mcp/http-transport.js\");\n        const { server: mcpServer } = createAFSMcpServer({ afs });\n        await startMcpHttpServer({\n          mcpServer,\n          host,\n          port,\n          cors,\n        });\n        // Block until server closes\n        await new Promise<void>((resolve) => {\n          process.on(\"SIGINT\", async () => {\n            await mcpServer.close();\n            resolve();\n          });\n          process.on(\"SIGTERM\", async () => {\n            await mcpServer.close();\n            resolve();\n          });\n        });\n        return;\n      }\n\n      // Default: HTTP transport (existing behavior)\n      const module = createAFSModule(afs, readonly);\n\n      // Create HTTP handler\n      const handler = createAFSHttpHandler({\n        module,\n        maxBodySize,\n        token,\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\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      const result: ServeResult = {\n        success: true,\n        host,\n        port,\n        path: basePath,\n        url,\n        mounts,\n      };\n\n      console.log(formatServeOutput(result));\n\n      // Keep running\n      await new Promise(() => {});\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/core/commands/stat.cjs

@@ -0,0 +1,53 @@
+const require_stat = require('../formatters/stat.cjs');
+const require_path_utils = require('../../path-utils.cjs');
+require('../path-utils.cjs');
+const require_types = require('./types.cjs');
+const require_errors = require('../../errors.cjs');
+
+//#region src/core/commands/stat.ts
+/**
+* Create stat command factory
+*/
+function createStatCommand(options) {
+	return {
+		command: "stat <path>",
+		describe: "Get file or directory info",
+		builder: { path: {
+			type: "string",
+			demandOption: true,
+			description: "Path to stat"
+		} },
+		handler: async (argv) => {
+			const afs = await require_types.resolveAFS(options);
+			const canonicalPath = require_path_utils.cliPathToCanonical(argv.path);
+			let result;
+			try {
+				result = await afs.stat(canonicalPath);
+			} catch {}
+			if (!result) try {
+				const entry = (await afs.read(canonicalPath)).data;
+				if (entry) result = { data: {
+					...entry,
+					meta: entry.meta ?? {}
+				} };
+			} catch {}
+			if (result?.data) result.data.path = argv.path;
+			const notFound = !result?.data;
+			options.onResult({
+				command: "stat",
+				result: result ?? {
+					data: void 0,
+					message: `No data found for path: ${argv.path}`
+				},
+				format: require_stat.formatStatOutput,
+				...notFound && { error: {
+					code: require_errors.ExitCode.NOT_FOUND,
+					message: `No data found for path: ${argv.path}`
+				} }
+			});
+		}
+	};
+}
+
+//#endregion
+exports.createStatCommand = createStatCommand;

package/dist/core/commands/stat.d.cts

@@ -0,0 +1,17 @@
+import { CommandFactoryOptions } from "./types.cjs";
+import { CommandModule } from "yargs";
+
+//#region src/core/commands/stat.d.ts
+/**
+ * Stat command arguments
+ */
+interface StatArgs {
+  path: string;
+}
+/**
+ * Create stat command factory
+ */
+declare function createStatCommand(options: CommandFactoryOptions): CommandModule<unknown, StatArgs>;
+//#endregion
+export { StatArgs, createStatCommand };
+//# sourceMappingURL=stat.d.cts.map

package/dist/core/commands/stat.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stat.d.cts","names":[],"sources":["../../../src/core/commands/stat.ts"],"mappings":";;;;;AAwBA;;UAPiB,QAAA;EACf,IAAA;AAAA;;;;iBAMc,iBAAA,CACd,OAAA,EAAS,qBAAA,GACR,aAAA,UAAuB,QAAA"}

package/dist/core/commands/stat.d.mts

@@ -0,0 +1,17 @@
+import { CommandFactoryOptions } from "./types.mjs";
+import { CommandModule } from "yargs";
+
+//#region src/core/commands/stat.d.ts
+/**
+ * Stat command arguments
+ */
+interface StatArgs {
+  path: string;
+}
+/**
+ * Create stat command factory
+ */
+declare function createStatCommand(options: CommandFactoryOptions): CommandModule<unknown, StatArgs>;
+//#endregion
+export { StatArgs, createStatCommand };
+//# sourceMappingURL=stat.d.mts.map

package/dist/core/commands/stat.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stat.d.mts","names":[],"sources":["../../../src/core/commands/stat.ts"],"mappings":";;;;;AAwBA;;UAPiB,QAAA;EACf,IAAA;AAAA;;;;iBAMc,iBAAA,CACd,OAAA,EAAS,qBAAA,GACR,aAAA,UAAuB,QAAA"}

package/dist/core/commands/stat.mjs

@@ -0,0 +1,54 @@
+import { formatStatOutput } from "../formatters/stat.mjs";
+import { cliPathToCanonical } from "../../path-utils.mjs";
+import "../path-utils.mjs";
+import { resolveAFS } from "./types.mjs";
+import { ExitCode } from "../../errors.mjs";
+
+//#region src/core/commands/stat.ts
+/**
+* Create stat command factory
+*/
+function createStatCommand(options) {
+	return {
+		command: "stat <path>",
+		describe: "Get file or directory info",
+		builder: { path: {
+			type: "string",
+			demandOption: true,
+			description: "Path to stat"
+		} },
+		handler: async (argv) => {
+			const afs = await resolveAFS(options);
+			const canonicalPath = cliPathToCanonical(argv.path);
+			let result;
+			try {
+				result = await afs.stat(canonicalPath);
+			} catch {}
+			if (!result) try {
+				const entry = (await afs.read(canonicalPath)).data;
+				if (entry) result = { data: {
+					...entry,
+					meta: entry.meta ?? {}
+				} };
+			} catch {}
+			if (result?.data) result.data.path = argv.path;
+			const notFound = !result?.data;
+			options.onResult({
+				command: "stat",
+				result: result ?? {
+					data: void 0,
+					message: `No data found for path: ${argv.path}`
+				},
+				format: formatStatOutput,
+				...notFound && { error: {
+					code: ExitCode.NOT_FOUND,
+					message: `No data found for path: ${argv.path}`
+				} }
+			});
+		}
+	};
+}
+
+//#endregion
+export { createStatCommand };
+//# sourceMappingURL=stat.mjs.map

package/dist/core/commands/stat.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stat.mjs","names":[],"sources":["../../../src/core/commands/stat.ts"],"sourcesContent":["/**\n * stat Command - Core Implementation\n *\n * Gets file/node statistics. Accepts AFS instance directly.\n * Returns AFSStatResult directly (no custom type).\n */\n\nimport type { AFSStatResult } from \"@aigne/afs\";\nimport type { CommandModule } from \"yargs\";\nimport { ExitCode } from \"../../errors.js\";\nimport { formatStatOutput } from \"../formatters/index.js\";\nimport { cliPathToCanonical } from \"../path-utils.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\n/**\n * Stat command arguments\n */\nexport interface StatArgs {\n  path: string;\n}\n\n/**\n * Create stat command factory\n */\nexport function createStatCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, StatArgs> {\n  return {\n    command: \"stat <path>\",\n    describe: \"Get file or directory info\",\n    builder: {\n      path: {\n        type: \"string\",\n        demandOption: true,\n        description: \"Path to stat\",\n      },\n    },\n    handler: async (argv) => {\n      const afs = await resolveAFS(options);\n      const canonicalPath = cliPathToCanonical(argv.path);\n      let result: AFSStatResult | undefined;\n      try {\n        result = await afs.stat(canonicalPath);\n      } catch {}\n\n      if (!result) {\n        // Fallback: Use read to get detailed metadata\n        try {\n          const entry = (await afs.read(canonicalPath)).data;\n          if (entry) {\n            result = { data: { ...entry, meta: entry.meta ?? {} } };\n          }\n        } catch {}\n      }\n\n      // Use the original CLI path for display (UX-friendly, e.g. /fs instead of $afs/fs)\n      if (result?.data) {\n        result.data.path = argv.path;\n      }\n\n      const notFound = !result?.data;\n      options.onResult({\n        command: \"stat\",\n        result: result ?? { data: undefined, message: `No data found for path: ${argv.path}` },\n        format: formatStatOutput,\n        ...(notFound && {\n          error: {\n            code: ExitCode.NOT_FOUND,\n            message: `No data found for path: ${argv.path}`,\n          },\n        }),\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;AAwBA,SAAgB,kBACd,SACkC;AAClC,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS,EACP,MAAM;GACJ,MAAM;GACN,cAAc;GACd,aAAa;GACd,EACF;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,MAAM,MAAM,WAAW,QAAQ;GACrC,MAAM,gBAAgB,mBAAmB,KAAK,KAAK;GACnD,IAAI;AACJ,OAAI;AACF,aAAS,MAAM,IAAI,KAAK,cAAc;WAChC;AAER,OAAI,CAAC,OAEH,KAAI;IACF,MAAM,SAAS,MAAM,IAAI,KAAK,cAAc,EAAE;AAC9C,QAAI,MACF,UAAS,EAAE,MAAM;KAAE,GAAG;KAAO,MAAM,MAAM,QAAQ,EAAE;KAAE,EAAE;WAEnD;AAIV,OAAI,QAAQ,KACV,QAAO,KAAK,OAAO,KAAK;GAG1B,MAAM,WAAW,CAAC,QAAQ;AAC1B,WAAQ,SAAS;IACf,SAAS;IACT,QAAQ,UAAU;KAAE,MAAM;KAAW,SAAS,2BAA2B,KAAK;KAAQ;IACtF,QAAQ;IACR,GAAI,YAAY,EACd,OAAO;KACL,MAAM,SAAS;KACf,SAAS,2BAA2B,KAAK;KAC1C,EACF;IACF,CAAC;;EAEL"}