@aigne/afs-cli 1.11.0-beta.11 → 1.11.0-beta.13

package/dist/daemon/server.cjs

@@ -0,0 +1,220 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let node_crypto = require("node:crypto");
+let node_path = require("node:path");
+let _aigne_afs_http = require("@aigne/afs-http");
+let _aigne_afs_explorer = require("@aigne/afs-explorer");
+let _modelcontextprotocol_sdk_server_streamableHttp_js = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
+
+//#region src/daemon/server.ts
+/**
+* Daemon Server
+*
+* Unified HTTP server that serves:
+* - Web Explorer UI (static files + WebSocket JSON-RPC)
+* - HTTP REST API on /afs/* (backward compatible)
+* - MCP Streamable HTTP on /mcp (NEW)
+*
+* Uses ExplorerWSServer with httpMiddleware for REST API and MCP routing.
+*/
+/**
+* Create an AFSModule wrapper around AFS for the REST API handler.
+*/
+function createAFSModule(afs) {
+	return {
+		name: "afs-daemon",
+		accessMode: "readwrite",
+		async list(path, options) {
+			return afs.list(path, options);
+		},
+		async read(path, options) {
+			return afs.read(path, options);
+		},
+		async write(path, content, options) {
+			return afs.write(path, content, options);
+		},
+		async delete(path, options) {
+			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) {
+			return afs.exec(path, args, options);
+		},
+		async rename(oldPath, newPath, options) {
+			return afs.rename(oldPath, newPath, options);
+		}
+	};
+}
+/**
+* Start the daemon server.
+*
+* Routes (via ExplorerWSServer with httpMiddleware):
+* - GET/POST/DELETE /mcp → MCP Streamable HTTP
+* - POST /afs/*          → HTTP REST API
+* - GET /api/read        → AFS content proxy (handled by ExplorerWSServer)
+* - WS /ws               → JSON-RPC (handled by ExplorerWSServer)
+* - GET /*               → Explorer UI static files (handled by ExplorerWSServer)
+*/
+async function startDaemonServer(options) {
+	const { afs, host = "localhost", apiPath = "/afs", configManager } = options;
+	const port = options.port || 4900;
+	let webRoot = options.webRoot;
+	if (!webRoot) try {
+		const { createRequire } = await import("node:module");
+		webRoot = (0, node_path.resolve)(createRequire(require("url").pathToFileURL(__filename).href).resolve("@aigne/afs-explorer/package.json"), "..", "web");
+	} catch {}
+	const restHandler = (0, _aigne_afs_http.createAFSHttpHandler)({ module: createAFSModule(afs) });
+	const { createMcpServerInstance, createAFSMcpServer } = await Promise.resolve().then(() => require("../mcp/server.cjs"));
+	/** Create a fresh McpServer wired to the AFS instance (one per session). */
+	const createSessionMcpServer = () => {
+		const srv = createMcpServerInstance();
+		createAFSMcpServer({
+			afs,
+			server: srv
+		});
+		return srv;
+	};
+	const mcpSessions = /* @__PURE__ */ new Map();
+	const logTs = () => (/* @__PURE__ */ new Date()).toISOString();
+	const httpMiddleware = async (req, res) => {
+		const url = new URL(req.url || "/", `http://${req.headers.host}`);
+		if (url.pathname === "/mcp") return handleMcpRequest(req, res, createSessionMcpServer, mcpSessions);
+		if (url.pathname.startsWith("/api/programs") && options.programManager) {
+			const { handleProgramsAPI } = await Promise.resolve().then(() => require("../program/daemon-integration.cjs"));
+			const headers$1 = new Headers();
+			for (const [key, value] of Object.entries(req.headers)) if (value) headers$1.append(key, Array.isArray(value) ? value.join(", ") : value);
+			const chunks$1 = [];
+			for await (const chunk of req) chunks$1.push(chunk);
+			const body$1 = Buffer.concat(chunks$1);
+			const request$1 = new Request(`http://${req.headers.host}${req.url}`, {
+				method: req.method,
+				headers: headers$1,
+				body: body$1.length > 0 ? body$1 : void 0
+			});
+			try {
+				const response = await handleProgramsAPI(request$1, options.programManager);
+				res.writeHead(response.status, { "Content-Type": response.headers.get("Content-Type") || "application/json" });
+				res.end(await response.text());
+			} catch (err) {
+				console.error(`[${logTs()}] Programs API error ${req.method} ${req.url}: ${err instanceof Error ? err.stack || err.message : err}`);
+				res.writeHead(500, { "Content-Type": "application/json" });
+				res.end(JSON.stringify({ error: "Internal server error" }));
+			}
+			return true;
+		}
+		if (!url.pathname.startsWith(apiPath)) return false;
+		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 restHandler(request);
+			res.writeHead(response.status, { "Content-Type": response.headers.get("Content-Type") || "application/json" });
+			const responseBody = await response.text();
+			res.end(responseBody);
+		} catch (err) {
+			console.error(`[${logTs()}] REST error ${req.method} ${req.url}: ${err instanceof Error ? err.stack || err.message : err}`);
+			res.writeHead(500, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({
+				code: 5,
+				error: "Internal server error"
+			}));
+		}
+		return true;
+	};
+	const explorerServer = new _aigne_afs_explorer.ExplorerWSServer(afs, {
+		port,
+		host,
+		webRoot,
+		configManager,
+		httpMiddleware
+	});
+	const info = await explorerServer.start();
+	return {
+		port: info.port,
+		url: info.url,
+		mcpUrl: `http://${host}:${info.port}/mcp`,
+		server: explorerServer,
+		stop: () => explorerServer.stop()
+	};
+}
+/**
+* Handle MCP Streamable HTTP requests on /mcp.
+*
+* Each client session gets its own McpServer + StreamableHTTPServerTransport pair.
+* The MCP SDK's McpServer only supports one transport at a time, so we create
+* a dedicated instance per session rather than sharing one across connections.
+*/
+async function handleMcpRequest(req, res, createMcpServer, sessions) {
+	res.setHeader("Access-Control-Allow-Origin", "*");
+	res.setHeader("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
+	res.setHeader("Access-Control-Allow-Headers", "Content-Type, mcp-session-id");
+	if (req.method === "OPTIONS") {
+		res.writeHead(204);
+		res.end();
+		return true;
+	}
+	if (req.method !== "GET" && req.method !== "POST" && req.method !== "DELETE") {
+		res.writeHead(405, { "Content-Type": "application/json" });
+		res.end(JSON.stringify({ error: "Method not allowed" }));
+		return true;
+	}
+	const sessionId = req.headers["mcp-session-id"];
+	let session;
+	if (sessionId) session = sessions.get(sessionId);
+	if (!session) {
+		const transport = new _modelcontextprotocol_sdk_server_streamableHttp_js.StreamableHTTPServerTransport({
+			sessionIdGenerator: () => (0, node_crypto.randomUUID)(),
+			onsessioninitialized: (sid) => {
+				sessions.set(sid, session);
+			}
+		});
+		transport.onclose = () => {
+			const sid = transport.sessionId;
+			if (sid) sessions.delete(sid);
+		};
+		const server = createMcpServer();
+		try {
+			await server.connect(transport);
+		} catch (err) {
+			const ts = (/* @__PURE__ */ new Date()).toISOString();
+			console.error(`[${ts}] MCP connect error: ${err instanceof Error ? err.stack || err.message : err}`);
+			if (!res.headersSent) {
+				res.writeHead(500, { "Content-Type": "application/json" });
+				res.end(JSON.stringify({ error: "MCP session initialization failed" }));
+			}
+			return true;
+		}
+		session = {
+			transport,
+			server
+		};
+	}
+	try {
+		await session.transport.handleRequest(req, res);
+	} catch (err) {
+		const ts = (/* @__PURE__ */ new Date()).toISOString();
+		console.error(`[${ts}] MCP error ${req.method} /mcp: ${err instanceof Error ? err.stack || err.message : err}`);
+		if (!res.headersSent) {
+			res.writeHead(500, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({ error: "Internal server error" }));
+		}
+	}
+	return true;
+}
+
+//#endregion
+exports.startDaemonServer = startDaemonServer;

package/dist/daemon/server.mjs

@@ -0,0 +1,220 @@
+import { randomUUID } from "node:crypto";
+import { resolve } from "node:path";
+import { createAFSHttpHandler } from "@aigne/afs-http";
+import { ExplorerWSServer } from "@aigne/afs-explorer";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+
+//#region src/daemon/server.ts
+/**
+* Daemon Server
+*
+* Unified HTTP server that serves:
+* - Web Explorer UI (static files + WebSocket JSON-RPC)
+* - HTTP REST API on /afs/* (backward compatible)
+* - MCP Streamable HTTP on /mcp (NEW)
+*
+* Uses ExplorerWSServer with httpMiddleware for REST API and MCP routing.
+*/
+/**
+* Create an AFSModule wrapper around AFS for the REST API handler.
+*/
+function createAFSModule(afs) {
+	return {
+		name: "afs-daemon",
+		accessMode: "readwrite",
+		async list(path, options) {
+			return afs.list(path, options);
+		},
+		async read(path, options) {
+			return afs.read(path, options);
+		},
+		async write(path, content, options) {
+			return afs.write(path, content, options);
+		},
+		async delete(path, options) {
+			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) {
+			return afs.exec(path, args, options);
+		},
+		async rename(oldPath, newPath, options) {
+			return afs.rename(oldPath, newPath, options);
+		}
+	};
+}
+/**
+* Start the daemon server.
+*
+* Routes (via ExplorerWSServer with httpMiddleware):
+* - GET/POST/DELETE /mcp → MCP Streamable HTTP
+* - POST /afs/*          → HTTP REST API
+* - GET /api/read        → AFS content proxy (handled by ExplorerWSServer)
+* - WS /ws               → JSON-RPC (handled by ExplorerWSServer)
+* - GET /*               → Explorer UI static files (handled by ExplorerWSServer)
+*/
+async function startDaemonServer(options) {
+	const { afs, host = "localhost", apiPath = "/afs", configManager } = options;
+	const port = options.port || 4900;
+	let webRoot = options.webRoot;
+	if (!webRoot) try {
+		const { createRequire } = await import("node:module");
+		webRoot = resolve(createRequire(import.meta.url).resolve("@aigne/afs-explorer/package.json"), "..", "web");
+	} catch {}
+	const restHandler = createAFSHttpHandler({ module: createAFSModule(afs) });
+	const { createMcpServerInstance, createAFSMcpServer } = await import("../mcp/server.mjs");
+	/** Create a fresh McpServer wired to the AFS instance (one per session). */
+	const createSessionMcpServer = () => {
+		const srv = createMcpServerInstance();
+		createAFSMcpServer({
+			afs,
+			server: srv
+		});
+		return srv;
+	};
+	const mcpSessions = /* @__PURE__ */ new Map();
+	const logTs = () => (/* @__PURE__ */ new Date()).toISOString();
+	const httpMiddleware = async (req, res) => {
+		const url = new URL(req.url || "/", `http://${req.headers.host}`);
+		if (url.pathname === "/mcp") return handleMcpRequest(req, res, createSessionMcpServer, mcpSessions);
+		if (url.pathname.startsWith("/api/programs") && options.programManager) {
+			const { handleProgramsAPI } = await import("../program/daemon-integration.mjs");
+			const headers$1 = new Headers();
+			for (const [key, value] of Object.entries(req.headers)) if (value) headers$1.append(key, Array.isArray(value) ? value.join(", ") : value);
+			const chunks$1 = [];
+			for await (const chunk of req) chunks$1.push(chunk);
+			const body$1 = Buffer.concat(chunks$1);
+			const request$1 = new Request(`http://${req.headers.host}${req.url}`, {
+				method: req.method,
+				headers: headers$1,
+				body: body$1.length > 0 ? body$1 : void 0
+			});
+			try {
+				const response = await handleProgramsAPI(request$1, options.programManager);
+				res.writeHead(response.status, { "Content-Type": response.headers.get("Content-Type") || "application/json" });
+				res.end(await response.text());
+			} catch (err) {
+				console.error(`[${logTs()}] Programs API error ${req.method} ${req.url}: ${err instanceof Error ? err.stack || err.message : err}`);
+				res.writeHead(500, { "Content-Type": "application/json" });
+				res.end(JSON.stringify({ error: "Internal server error" }));
+			}
+			return true;
+		}
+		if (!url.pathname.startsWith(apiPath)) return false;
+		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 restHandler(request);
+			res.writeHead(response.status, { "Content-Type": response.headers.get("Content-Type") || "application/json" });
+			const responseBody = await response.text();
+			res.end(responseBody);
+		} catch (err) {
+			console.error(`[${logTs()}] REST error ${req.method} ${req.url}: ${err instanceof Error ? err.stack || err.message : err}`);
+			res.writeHead(500, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({
+				code: 5,
+				error: "Internal server error"
+			}));
+		}
+		return true;
+	};
+	const explorerServer = new ExplorerWSServer(afs, {
+		port,
+		host,
+		webRoot,
+		configManager,
+		httpMiddleware
+	});
+	const info = await explorerServer.start();
+	return {
+		port: info.port,
+		url: info.url,
+		mcpUrl: `http://${host}:${info.port}/mcp`,
+		server: explorerServer,
+		stop: () => explorerServer.stop()
+	};
+}
+/**
+* Handle MCP Streamable HTTP requests on /mcp.
+*
+* Each client session gets its own McpServer + StreamableHTTPServerTransport pair.
+* The MCP SDK's McpServer only supports one transport at a time, so we create
+* a dedicated instance per session rather than sharing one across connections.
+*/
+async function handleMcpRequest(req, res, createMcpServer, sessions) {
+	res.setHeader("Access-Control-Allow-Origin", "*");
+	res.setHeader("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
+	res.setHeader("Access-Control-Allow-Headers", "Content-Type, mcp-session-id");
+	if (req.method === "OPTIONS") {
+		res.writeHead(204);
+		res.end();
+		return true;
+	}
+	if (req.method !== "GET" && req.method !== "POST" && req.method !== "DELETE") {
+		res.writeHead(405, { "Content-Type": "application/json" });
+		res.end(JSON.stringify({ error: "Method not allowed" }));
+		return true;
+	}
+	const sessionId = req.headers["mcp-session-id"];
+	let session;
+	if (sessionId) session = sessions.get(sessionId);
+	if (!session) {
+		const transport = new StreamableHTTPServerTransport({
+			sessionIdGenerator: () => randomUUID(),
+			onsessioninitialized: (sid) => {
+				sessions.set(sid, session);
+			}
+		});
+		transport.onclose = () => {
+			const sid = transport.sessionId;
+			if (sid) sessions.delete(sid);
+		};
+		const server = createMcpServer();
+		try {
+			await server.connect(transport);
+		} catch (err) {
+			const ts = (/* @__PURE__ */ new Date()).toISOString();
+			console.error(`[${ts}] MCP connect error: ${err instanceof Error ? err.stack || err.message : err}`);
+			if (!res.headersSent) {
+				res.writeHead(500, { "Content-Type": "application/json" });
+				res.end(JSON.stringify({ error: "MCP session initialization failed" }));
+			}
+			return true;
+		}
+		session = {
+			transport,
+			server
+		};
+	}
+	try {
+		await session.transport.handleRequest(req, res);
+	} catch (err) {
+		const ts = (/* @__PURE__ */ new Date()).toISOString();
+		console.error(`[${ts}] MCP error ${req.method} /mcp: ${err instanceof Error ? err.stack || err.message : err}`);
+		if (!res.headersSent) {
+			res.writeHead(500, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({ error: "Internal server error" }));
+		}
+	}
+	return true;
+}
+
+//#endregion
+export { startDaemonServer };
+//# sourceMappingURL=server.mjs.map

package/dist/daemon/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.mjs","names":["headers","chunks","body","request"],"sources":["../../src/daemon/server.ts"],"sourcesContent":["/**\n * Daemon Server\n *\n * Unified HTTP server that serves:\n * - Web Explorer UI (static files + WebSocket JSON-RPC)\n * - HTTP REST API on /afs/* (backward compatible)\n * - MCP Streamable HTTP on /mcp (NEW)\n *\n * Uses ExplorerWSServer with httpMiddleware for REST API and MCP routing.\n */\n\nimport { randomUUID } from \"node:crypto\";\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\nimport { resolve } from \"node:path\";\nimport type { AFS, AFSModule } from \"@aigne/afs\";\nimport { type ConfigManager, ExplorerWSServer } from \"@aigne/afs-explorer\";\nimport { createAFSHttpHandler } from \"@aigne/afs-http\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StreamableHTTPServerTransport } from \"@modelcontextprotocol/sdk/server/streamableHttp.js\";\n\nexport interface DaemonServerOptions {\n  afs: AFS;\n  port?: number;\n  host?: string;\n  /** REST API base path (default: \"/afs\") */\n  apiPath?: string;\n  /** Path to web/ directory for Explorer UI. */\n  webRoot?: string;\n  /** Optional ConfigManager for mount management RPCs. */\n  configManager?: ConfigManager;\n  /** Optional ProgramManager for /api/programs/* routes. */\n  programManager?: import(\"../program/program-manager.js\").ProgramManager;\n}\n\nexport interface DaemonServerInfo {\n  port: number;\n  url: string;\n  mcpUrl: string;\n  server: ExplorerWSServer;\n  stop: () => void;\n}\n\n/**\n * Create an AFSModule wrapper around AFS for the REST API handler.\n */\nfunction createAFSModule(afs: AFS): AFSModule {\n  return {\n    name: \"afs-daemon\",\n    accessMode: \"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      return afs.write(path, content, options);\n    },\n    async delete(path, options) {\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      return afs.exec(path, args, options);\n    },\n    async rename(oldPath, newPath, options) {\n      return afs.rename(oldPath, newPath, options);\n    },\n  };\n}\n\n/**\n * Start the daemon server.\n *\n * Routes (via ExplorerWSServer with httpMiddleware):\n * - GET/POST/DELETE /mcp → MCP Streamable HTTP\n * - POST /afs/*          → HTTP REST API\n * - GET /api/read        → AFS content proxy (handled by ExplorerWSServer)\n * - WS /ws               → JSON-RPC (handled by ExplorerWSServer)\n * - GET /*               → Explorer UI static files (handled by ExplorerWSServer)\n */\nexport async function startDaemonServer(options: DaemonServerOptions): Promise<DaemonServerInfo> {\n  const { afs, host = \"localhost\", apiPath = \"/afs\", configManager } = options;\n  const port = options.port || 4900;\n\n  // Resolve web root for Explorer assets\n  let webRoot = options.webRoot;\n  if (!webRoot) {\n    try {\n      const { createRequire } = await import(\"node:module\");\n      const req = createRequire(import.meta.url);\n      const explorerPkg = req.resolve(\"@aigne/afs-explorer/package.json\");\n      webRoot = resolve(explorerPkg, \"..\", \"web\");\n    } catch {\n      // Fallback — embedded assets may be used\n    }\n  }\n\n  // Create REST API handler for backward compatibility\n  const module = createAFSModule(afs);\n  const restHandler = createAFSHttpHandler({ module });\n\n  // MCP: per-session server + transport\n  const { createMcpServerInstance, createAFSMcpServer } = await import(\"../mcp/server.js\");\n\n  /** Create a fresh McpServer wired to the AFS instance (one per session). */\n  const createSessionMcpServer = () => {\n    const srv = createMcpServerInstance();\n    createAFSMcpServer({ afs, server: srv });\n    return srv;\n  };\n\n  // Per-session state: transport + its dedicated McpServer\n  const mcpSessions = new Map<\n    string,\n    { transport: StreamableHTTPServerTransport; server: McpServer }\n  >();\n\n  const logTs = () => new Date().toISOString();\n\n  // HTTP middleware: intercept MCP, Programs API, and REST API requests before static file serving\n  const httpMiddleware = async (req: IncomingMessage, res: ServerResponse): Promise<boolean> => {\n    const url = new URL(req.url || \"/\", `http://${req.headers.host}`);\n\n    // --- MCP Streamable HTTP on /mcp ---\n    if (url.pathname === \"/mcp\") {\n      return handleMcpRequest(req, res, createSessionMcpServer, mcpSessions);\n    }\n\n    // --- Programs API on /api/programs/* ---\n    if (url.pathname.startsWith(\"/api/programs\") && options.programManager) {\n      const { handleProgramsAPI } = await import(\"../program/daemon-integration.js\");\n      const headers = new Headers();\n      for (const [key, value] of Object.entries(req.headers)) {\n        if (value) headers.append(key, Array.isArray(value) ? value.join(\", \") : value);\n      }\n      const chunks: Buffer[] = [];\n      for await (const chunk of req) chunks.push(chunk as Buffer);\n      const body = Buffer.concat(chunks);\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      try {\n        const response = await handleProgramsAPI(request, options.programManager);\n        res.writeHead(response.status, {\n          \"Content-Type\": response.headers.get(\"Content-Type\") || \"application/json\",\n        });\n        res.end(await response.text());\n      } catch (err) {\n        console.error(\n          `[${logTs()}] Programs API error ${req.method} ${req.url}: ${err instanceof Error ? err.stack || err.message : err}`,\n        );\n        res.writeHead(500, { \"Content-Type\": \"application/json\" });\n        res.end(JSON.stringify({ error: \"Internal server error\" }));\n      }\n      return true;\n    }\n\n    // --- REST API on /afs/* ---\n    if (!url.pathname.startsWith(apiPath)) return false;\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    const chunks: Buffer[] = [];\n    for await (const chunk of req) {\n      chunks.push(chunk as Buffer);\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      const response = await restHandler(request);\n      res.writeHead(response.status, {\n        \"Content-Type\": response.headers.get(\"Content-Type\") || \"application/json\",\n      });\n      const responseBody = await response.text();\n      res.end(responseBody);\n    } catch (err) {\n      console.error(\n        `[${logTs()}] REST error ${req.method} ${req.url}: ${err instanceof Error ? err.stack || err.message : err}`,\n      );\n      res.writeHead(500, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify({ code: 5, error: \"Internal server error\" }));\n    }\n\n    return true;\n  };\n\n  const explorerServer = new ExplorerWSServer(afs, {\n    port,\n    host,\n    webRoot,\n    configManager,\n    httpMiddleware,\n  });\n\n  const info = await explorerServer.start();\n\n  return {\n    port: info.port,\n    url: info.url,\n    mcpUrl: `http://${host}:${info.port}/mcp`,\n    server: explorerServer,\n    stop: () => explorerServer.stop(),\n  };\n}\n\ninterface McpSession {\n  transport: StreamableHTTPServerTransport;\n  server: McpServer;\n}\n\n/**\n * Handle MCP Streamable HTTP requests on /mcp.\n *\n * Each client session gets its own McpServer + StreamableHTTPServerTransport pair.\n * The MCP SDK's McpServer only supports one transport at a time, so we create\n * a dedicated instance per session rather than sharing one across connections.\n */\nasync function handleMcpRequest(\n  req: IncomingMessage,\n  res: ServerResponse,\n  createMcpServer: () => McpServer,\n  sessions: Map<string, McpSession>,\n): Promise<true> {\n  // CORS\n  res.setHeader(\"Access-Control-Allow-Origin\", \"*\");\n  res.setHeader(\"Access-Control-Allow-Methods\", \"GET, POST, DELETE, OPTIONS\");\n  res.setHeader(\"Access-Control-Allow-Headers\", \"Content-Type, mcp-session-id\");\n\n  if (req.method === \"OPTIONS\") {\n    res.writeHead(204);\n    res.end();\n    return true;\n  }\n\n  // Only GET, POST, DELETE are valid MCP methods\n  if (req.method !== \"GET\" && req.method !== \"POST\" && req.method !== \"DELETE\") {\n    res.writeHead(405, { \"Content-Type\": \"application/json\" });\n    res.end(JSON.stringify({ error: \"Method not allowed\" }));\n    return true;\n  }\n\n  // Look up existing session or create new one\n  const sessionId = req.headers[\"mcp-session-id\"] as string | undefined;\n  let session: McpSession | undefined;\n\n  if (sessionId) {\n    session = sessions.get(sessionId);\n  }\n\n  if (!session) {\n    const transport = new StreamableHTTPServerTransport({\n      sessionIdGenerator: () => randomUUID(),\n      onsessioninitialized: (sid) => {\n        sessions.set(sid, session!);\n      },\n    });\n\n    transport.onclose = () => {\n      const sid = transport.sessionId;\n      if (sid) sessions.delete(sid);\n    };\n\n    const server = createMcpServer();\n\n    try {\n      await server.connect(transport);\n    } catch (err) {\n      const ts = new Date().toISOString();\n      console.error(\n        `[${ts}] MCP connect error: ${err instanceof Error ? err.stack || err.message : err}`,\n      );\n      if (!res.headersSent) {\n        res.writeHead(500, { \"Content-Type\": \"application/json\" });\n        res.end(JSON.stringify({ error: \"MCP session initialization failed\" }));\n      }\n      return true;\n    }\n\n    session = { transport, server };\n  }\n\n  try {\n    await session.transport.handleRequest(req, res);\n  } catch (err) {\n    const ts = new Date().toISOString();\n    console.error(\n      `[${ts}] MCP error ${req.method} /mcp: ${err instanceof Error ? err.stack || err.message : err}`,\n    );\n    if (!res.headersSent) {\n      res.writeHead(500, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify({ error: \"Internal server error\" }));\n    }\n  }\n\n  return true;\n}\n"],"mappings":"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"}

package/dist/mcp/http-transport.cjs

@@ -43,7 +43,20 @@ async function startMcpHttpServer(options) {
 		}
 		const sessionId = req.headers["mcp-session-id"];
 		let transport;
-		if (sessionId) transport = sessions.get(sessionId);
+		if (sessionId) {
+			transport = sessions.get(sessionId);
+			if (!transport) {
+				res.writeHead(404, { "Content-Type": "application/json" });
+				res.end(JSON.stringify({
+					jsonrpc: "2.0",
+					error: {
+						code: -32e3,
+						message: "Session not found"
+					}
+				}));
+				return;
+			}
+		}
 		if (!transport) {
 			transport = new _modelcontextprotocol_sdk_server_streamableHttp_js.StreamableHTTPServerTransport({
 				sessionIdGenerator: () => (0, node_crypto.randomUUID)(),

package/dist/mcp/http-transport.mjs

@@ -42,7 +42,20 @@ async function startMcpHttpServer(options) {
 		}
 		const sessionId = req.headers["mcp-session-id"];
 		let transport;
-		if (sessionId) transport = sessions.get(sessionId);
+		if (sessionId) {
+			transport = sessions.get(sessionId);
+			if (!transport) {
+				res.writeHead(404, { "Content-Type": "application/json" });
+				res.end(JSON.stringify({
+					jsonrpc: "2.0",
+					error: {
+						code: -32e3,
+						message: "Session not found"
+					}
+				}));
+				return;
+			}
+		}
 		if (!transport) {
 			transport = new StreamableHTTPServerTransport({
 				sessionIdGenerator: () => randomUUID(),

package/dist/mcp/http-transport.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"http-transport.mjs","names":[],"sources":["../../src/mcp/http-transport.ts"],"sourcesContent":["/**\n * MCP HTTP Transport\n *\n * Starts an HTTP server that serves MCP over Streamable HTTP transport.\n * Creates a new transport per client session to support reconnection.\n */\n\nimport { randomUUID } from \"node:crypto\";\nimport type { IncomingMessage, Server, ServerResponse } from \"node:http\";\nimport { createServer } from \"node:http\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StreamableHTTPServerTransport } from \"@modelcontextprotocol/sdk/server/streamableHttp.js\";\n\nexport interface StartMcpHttpServerOptions {\n  mcpServer: McpServer;\n  host: string;\n  port: number;\n  cors: boolean;\n}\n\nexport interface StartMcpHttpServerResult {\n  httpServer: Server;\n  port: number;\n  url: string;\n}\n\n/**\n * Start MCP server over Streamable HTTP transport.\n *\n * Creates a new transport per client session so that reconnections\n * and multiple clients are supported.\n */\nexport async function startMcpHttpServer(\n  options: StartMcpHttpServerOptions,\n): Promise<StartMcpHttpServerResult> {\n  const { mcpServer, host, port, cors } = options;\n\n  // Per-session transport map\n  const sessions = new Map<string, StreamableHTTPServerTransport>();\n\n  const httpServer = createServer(async (req: IncomingMessage, res: ServerResponse) => {\n    // Strip version headers to avoid data leaks\n    res.removeHeader(\"X-Powered-By\");\n\n    // CORS handling\n    if (cors) {\n      res.setHeader(\"Access-Control-Allow-Origin\", \"*\");\n      res.setHeader(\"Access-Control-Allow-Methods\", \"GET, POST, DELETE, OPTIONS\");\n      res.setHeader(\"Access-Control-Allow-Headers\", \"Content-Type, mcp-session-id\");\n\n      if (req.method === \"OPTIONS\") {\n        res.writeHead(204);\n        res.end();\n        return;\n      }\n    }\n\n    const url = new URL(req.url || \"/\", `http://${req.headers.host}`);\n\n    // Only handle /mcp path\n    if (url.pathname !== \"/mcp\") {\n      res.writeHead(404, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify({ error: \"Not found\" }));\n      return;\n    }\n\n    // Only allow GET, POST, DELETE (MCP protocol methods)\n    if (req.method !== \"GET\" && req.method !== \"POST\" && req.method !== \"DELETE\") {\n      res.writeHead(405, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify({ error: \"Method not allowed\" }));\n      return;\n    }\n\n    // Look up existing session or create new one for initialization requests\n    const sessionId = req.headers[\"mcp-session-id\"] as string | undefined;\n    let transport: StreamableHTTPServerTransport | undefined;\n\n    if (sessionId) {\n      transport = sessions.get(sessionId);\n    }\n\n    if (!transport) {\n      // New session — create a new transport\n      transport = new StreamableHTTPServerTransport({\n        sessionIdGenerator: () => randomUUID(),\n        onsessioninitialized: (sid) => {\n          sessions.set(sid, transport!);\n        },\n      });\n\n      transport.onclose = () => {\n        const sid = transport!.sessionId;\n        if (sid) sessions.delete(sid);\n      };\n\n      await mcpServer.connect(transport);\n    }\n\n    try {\n      await transport.handleRequest(req, res);\n    } catch {\n      if (!res.headersSent) {\n        res.writeHead(500, { \"Content-Type\": \"application/json\" });\n        res.end(JSON.stringify({ error: \"Internal server error\" }));\n      }\n    }\n  });\n\n  // Start listening\n  const actualPort = await new Promise<number>((resolve, reject) => {\n    httpServer.on(\"error\", reject);\n    httpServer.listen(port, host, () => {\n      const addr = httpServer.address();\n      if (addr && typeof addr === \"object\") {\n        resolve(addr.port);\n      } else {\n        resolve(port);\n      }\n    });\n  });\n\n  const url = `http://${host}:${actualPort}/mcp`;\n\n  // Print listening info to stderr (stdout reserved for protocol)\n  console.error(`MCP HTTP server listening on ${url}`);\n\n  return { httpServer, port: actualPort, url };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgCA,eAAsB,mBACpB,SACmC;CACnC,MAAM,EAAE,WAAW,MAAM,MAAM,SAAS;CAGxC,MAAM,2BAAW,IAAI,KAA4C;CAEjE,MAAM,aAAa,aAAa,OAAO,KAAsB,QAAwB;AAEnF,MAAI,aAAa,eAAe;AAGhC,MAAI,MAAM;AACR,OAAI,UAAU,+BAA+B,IAAI;AACjD,OAAI,UAAU,gCAAgC,6BAA6B;AAC3E,OAAI,UAAU,gCAAgC,+BAA+B;AAE7E,OAAI,IAAI,WAAW,WAAW;AAC5B,QAAI,UAAU,IAAI;AAClB,QAAI,KAAK;AACT;;;AAOJ,MAHY,IAAI,IAAI,IAAI,OAAO,KAAK,UAAU,IAAI,QAAQ,OAAO,CAGzD,aAAa,QAAQ;AAC3B,OAAI,UAAU,KAAK,EAAE,gBAAgB,oBAAoB,CAAC;AAC1D,OAAI,IAAI,KAAK,UAAU,EAAE,OAAO,aAAa,CAAC,CAAC;AAC/C;;AAIF,MAAI,IAAI,WAAW,SAAS,IAAI,WAAW,UAAU,IAAI,WAAW,UAAU;AAC5E,OAAI,UAAU,KAAK,EAAE,gBAAgB,oBAAoB,CAAC;AAC1D,OAAI,IAAI,KAAK,UAAU,EAAE,OAAO,sBAAsB,CAAC,CAAC;AACxD;;EAIF,MAAM,YAAY,IAAI,QAAQ;EAC9B,IAAI;AAEJ,MAAI,UACF,aAAY,SAAS,IAAI,UAAU;AAGrC,MAAI,CAAC,WAAW;AAEd,eAAY,IAAI,8BAA8B;IAC5C,0BAA0B,YAAY;IACtC,uBAAuB,QAAQ;AAC7B,cAAS,IAAI,KAAK,UAAW;;IAEhC,CAAC;AAEF,aAAU,gBAAgB;IACxB,MAAM,MAAM,UAAW;AACvB,QAAI,IAAK,UAAS,OAAO,IAAI;;AAG/B,SAAM,UAAU,QAAQ,UAAU;;AAGpC,MAAI;AACF,SAAM,UAAU,cAAc,KAAK,IAAI;UACjC;AACN,OAAI,CAAC,IAAI,aAAa;AACpB,QAAI,UAAU,KAAK,EAAE,gBAAgB,oBAAoB,CAAC;AAC1D,QAAI,IAAI,KAAK,UAAU,EAAE,OAAO,yBAAyB,CAAC,CAAC;;;GAG/D;CAGF,MAAM,aAAa,MAAM,IAAI,SAAiB,SAAS,WAAW;AAChE,aAAW,GAAG,SAAS,OAAO;AAC9B,aAAW,OAAO,MAAM,YAAY;GAClC,MAAM,OAAO,WAAW,SAAS;AACjC,OAAI,QAAQ,OAAO,SAAS,SAC1B,SAAQ,KAAK,KAAK;OAElB,SAAQ,KAAK;IAEf;GACF;CAEF,MAAM,MAAM,UAAU,KAAK,GAAG,WAAW;AAGzC,SAAQ,MAAM,gCAAgC,MAAM;AAEpD,QAAO;EAAE;EAAY,MAAM;EAAY;EAAK"}
+{"version":3,"file":"http-transport.mjs","names":[],"sources":["../../src/mcp/http-transport.ts"],"sourcesContent":["/**\n * MCP HTTP Transport\n *\n * Starts an HTTP server that serves MCP over Streamable HTTP transport.\n * Creates a new transport per client session to support reconnection.\n */\n\nimport { randomUUID } from \"node:crypto\";\nimport type { IncomingMessage, Server, ServerResponse } from \"node:http\";\nimport { createServer } from \"node:http\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StreamableHTTPServerTransport } from \"@modelcontextprotocol/sdk/server/streamableHttp.js\";\n\nexport interface StartMcpHttpServerOptions {\n  mcpServer: McpServer;\n  host: string;\n  port: number;\n  cors: boolean;\n}\n\nexport interface StartMcpHttpServerResult {\n  httpServer: Server;\n  port: number;\n  url: string;\n}\n\n/**\n * Start MCP server over Streamable HTTP transport.\n *\n * Creates a new transport per client session so that reconnections\n * and multiple clients are supported.\n */\nexport async function startMcpHttpServer(\n  options: StartMcpHttpServerOptions,\n): Promise<StartMcpHttpServerResult> {\n  const { mcpServer, host, port, cors } = options;\n\n  // Per-session transport map\n  const sessions = new Map<string, StreamableHTTPServerTransport>();\n\n  const httpServer = createServer(async (req: IncomingMessage, res: ServerResponse) => {\n    // Strip version headers to avoid data leaks\n    res.removeHeader(\"X-Powered-By\");\n\n    // CORS handling\n    if (cors) {\n      res.setHeader(\"Access-Control-Allow-Origin\", \"*\");\n      res.setHeader(\"Access-Control-Allow-Methods\", \"GET, POST, DELETE, OPTIONS\");\n      res.setHeader(\"Access-Control-Allow-Headers\", \"Content-Type, mcp-session-id\");\n\n      if (req.method === \"OPTIONS\") {\n        res.writeHead(204);\n        res.end();\n        return;\n      }\n    }\n\n    const url = new URL(req.url || \"/\", `http://${req.headers.host}`);\n\n    // Only handle /mcp path\n    if (url.pathname !== \"/mcp\") {\n      res.writeHead(404, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify({ error: \"Not found\" }));\n      return;\n    }\n\n    // Only allow GET, POST, DELETE (MCP protocol methods)\n    if (req.method !== \"GET\" && req.method !== \"POST\" && req.method !== \"DELETE\") {\n      res.writeHead(405, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify({ error: \"Method not allowed\" }));\n      return;\n    }\n\n    // Look up existing session or create new one for initialization requests\n    const sessionId = req.headers[\"mcp-session-id\"] as string | undefined;\n    let transport: StreamableHTTPServerTransport | undefined;\n\n    if (sessionId) {\n      transport = sessions.get(sessionId);\n      if (!transport) {\n        // Stale/unknown session — tell client to re-initialize (MCP spec)\n        res.writeHead(404, { \"Content-Type\": \"application/json\" });\n        res.end(\n          JSON.stringify({ jsonrpc: \"2.0\", error: { code: -32000, message: \"Session not found\" } }),\n        );\n        return;\n      }\n    }\n\n    if (!transport) {\n      // No session ID — new client, create a fresh transport\n      transport = new StreamableHTTPServerTransport({\n        sessionIdGenerator: () => randomUUID(),\n        onsessioninitialized: (sid) => {\n          sessions.set(sid, transport!);\n        },\n      });\n\n      transport.onclose = () => {\n        const sid = transport!.sessionId;\n        if (sid) sessions.delete(sid);\n      };\n\n      await mcpServer.connect(transport);\n    }\n\n    try {\n      await transport.handleRequest(req, res);\n    } catch {\n      if (!res.headersSent) {\n        res.writeHead(500, { \"Content-Type\": \"application/json\" });\n        res.end(JSON.stringify({ error: \"Internal server error\" }));\n      }\n    }\n  });\n\n  // Start listening\n  const actualPort = await new Promise<number>((resolve, reject) => {\n    httpServer.on(\"error\", reject);\n    httpServer.listen(port, host, () => {\n      const addr = httpServer.address();\n      if (addr && typeof addr === \"object\") {\n        resolve(addr.port);\n      } else {\n        resolve(port);\n      }\n    });\n  });\n\n  const url = `http://${host}:${actualPort}/mcp`;\n\n  // Print listening info to stderr (stdout reserved for protocol)\n  console.error(`MCP HTTP server listening on ${url}`);\n\n  return { httpServer, port: actualPort, url };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgCA,eAAsB,mBACpB,SACmC;CACnC,MAAM,EAAE,WAAW,MAAM,MAAM,SAAS;CAGxC,MAAM,2BAAW,IAAI,KAA4C;CAEjE,MAAM,aAAa,aAAa,OAAO,KAAsB,QAAwB;AAEnF,MAAI,aAAa,eAAe;AAGhC,MAAI,MAAM;AACR,OAAI,UAAU,+BAA+B,IAAI;AACjD,OAAI,UAAU,gCAAgC,6BAA6B;AAC3E,OAAI,UAAU,gCAAgC,+BAA+B;AAE7E,OAAI,IAAI,WAAW,WAAW;AAC5B,QAAI,UAAU,IAAI;AAClB,QAAI,KAAK;AACT;;;AAOJ,MAHY,IAAI,IAAI,IAAI,OAAO,KAAK,UAAU,IAAI,QAAQ,OAAO,CAGzD,aAAa,QAAQ;AAC3B,OAAI,UAAU,KAAK,EAAE,gBAAgB,oBAAoB,CAAC;AAC1D,OAAI,IAAI,KAAK,UAAU,EAAE,OAAO,aAAa,CAAC,CAAC;AAC/C;;AAIF,MAAI,IAAI,WAAW,SAAS,IAAI,WAAW,UAAU,IAAI,WAAW,UAAU;AAC5E,OAAI,UAAU,KAAK,EAAE,gBAAgB,oBAAoB,CAAC;AAC1D,OAAI,IAAI,KAAK,UAAU,EAAE,OAAO,sBAAsB,CAAC,CAAC;AACxD;;EAIF,MAAM,YAAY,IAAI,QAAQ;EAC9B,IAAI;AAEJ,MAAI,WAAW;AACb,eAAY,SAAS,IAAI,UAAU;AACnC,OAAI,CAAC,WAAW;AAEd,QAAI,UAAU,KAAK,EAAE,gBAAgB,oBAAoB,CAAC;AAC1D,QAAI,IACF,KAAK,UAAU;KAAE,SAAS;KAAO,OAAO;MAAE,MAAM;MAAQ,SAAS;MAAqB;KAAE,CAAC,CAC1F;AACD;;;AAIJ,MAAI,CAAC,WAAW;AAEd,eAAY,IAAI,8BAA8B;IAC5C,0BAA0B,YAAY;IACtC,uBAAuB,QAAQ;AAC7B,cAAS,IAAI,KAAK,UAAW;;IAEhC,CAAC;AAEF,aAAU,gBAAgB;IACxB,MAAM,MAAM,UAAW;AACvB,QAAI,IAAK,UAAS,OAAO,IAAI;;AAG/B,SAAM,UAAU,QAAQ,UAAU;;AAGpC,MAAI;AACF,SAAM,UAAU,cAAc,KAAK,IAAI;UACjC;AACN,OAAI,CAAC,IAAI,aAAa;AACpB,QAAI,UAAU,KAAK,EAAE,gBAAgB,oBAAoB,CAAC;AAC1D,QAAI,IAAI,KAAK,UAAU,EAAE,OAAO,yBAAyB,CAAC,CAAC;;;GAG/D;CAGF,MAAM,aAAa,MAAM,IAAI,SAAiB,SAAS,WAAW;AAChE,aAAW,GAAG,SAAS,OAAO;AAC9B,aAAW,OAAO,MAAM,YAAY;GAClC,MAAM,OAAO,WAAW,SAAS;AACjC,OAAI,QAAQ,OAAO,SAAS,SAC1B,SAAQ,KAAK,KAAK;OAElB,SAAQ,KAAK;IAEf;GACF;CAEF,MAAM,MAAM,UAAU,KAAK,GAAG,WAAW;AAGzC,SAAQ,MAAM,gCAAgC,MAAM;AAEpD,QAAO;EAAE;EAAY,MAAM;EAAY;EAAK"}

package/dist/mcp/server.cjs

@@ -17,7 +17,8 @@ function createMcpServerInstance() {
 	}, { capabilities: {
 		tools: {},
 		resources: {},
-		prompts: {}
+		prompts: {},
+		logging: {}
 	} });
 }
 /**
@@ -26,7 +27,8 @@ function createMcpServerInstance() {
 */
 function buildInstructions(afs) {
 	const lines = [];
-	lines.push("AFS (Agentic File System) is a virtual filesystem that unifies different data sources into a single namespace.");
+	lines.push("AFS (Agentic File System) is a virtual filesystem developed by ArcBlock that gives AI agents a unified, path-based interface to any data source.");
+	lines.push("Inspired by Unix and Plan 9's \"everything is a file\", AFS extends the idea to \"everything is context\" — databases, APIs, smart home devices, and cloud services all become files and directories that agents can read, write, search, and act on.");
 	lines.push("All data sources are accessed through a consistent path-based API with standard operations: read, list, stat, explain, search, write, delete, exec.");
 	lines.push("");
 	lines.push("## Mounted Providers");

package/dist/mcp/server.mjs

@@ -16,7 +16,8 @@ function createMcpServerInstance() {
 	}, { capabilities: {
 		tools: {},
 		resources: {},
-		prompts: {}
+		prompts: {},
+		logging: {}
 	} });
 }
 /**
@@ -25,7 +26,8 @@ function createMcpServerInstance() {
 */
 function buildInstructions(afs) {
 	const lines = [];
-	lines.push("AFS (Agentic File System) is a virtual filesystem that unifies different data sources into a single namespace.");
+	lines.push("AFS (Agentic File System) is a virtual filesystem developed by ArcBlock that gives AI agents a unified, path-based interface to any data source.");
+	lines.push("Inspired by Unix and Plan 9's \"everything is a file\", AFS extends the idea to \"everything is context\" — databases, APIs, smart home devices, and cloud services all become files and directories that agents can read, write, search, and act on.");
 	lines.push("All data sources are accessed through a consistent path-based API with standard operations: read, list, stat, explain, search, write, delete, exec.");
 	lines.push("");
 	lines.push("## Mounted Providers");

package/dist/mcp/server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.mjs","names":[],"sources":["../../src/mcp/server.ts"],"sourcesContent":["/**\n * AFS MCP Server\n *\n * Creates an MCP Server that exposes AFS operations as MCP tools,\n * resources, and prompts.\n */\n\nimport type { AFS } from \"@aigne/afs\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { VERSION } from \"../version.js\";\nimport { registerPrompts } from \"./prompts.js\";\nimport { registerResources } from \"./resources.js\";\nimport { registerTools } from \"./tools.js\";\n\nexport interface CreateAFSMcpServerOptions {\n  /** AFS instance to expose */\n  afs: AFS;\n  /** Pre-created McpServer instance. If not provided, a new one is created. */\n  server?: McpServer;\n}\n\nexport interface AFSMcpServerResult {\n  /** The MCP server instance */\n  server: McpServer;\n}\n\n/**\n * Create a new McpServer instance with AFS capabilities.\n * Useful when you need the server before AFS is created (e.g. for MCP auth context).\n */\nexport function createMcpServerInstance(): McpServer {\n  return new McpServer(\n    { name: \"afs\", version: VERSION },\n    {\n      capabilities: {\n        tools: {},\n        resources: {},\n        prompts: {},\n      },\n    },\n  );\n}\n\n/**\n * Build MCP instructions string from AFS instance.\n * Includes base AFS description + dynamically mounted provider details.\n */\nfunction buildInstructions(afs: AFS): string {\n  const lines: string[] = [];\n\n  lines.push(\n    \"AFS (Agentic File System) is a virtual filesystem that unifies different data sources into a single namespace.\",\n  );\n  lines.push(\n    \"All data sources are accessed through a consistent path-based API with standard operations: read, list, stat, explain, search, write, delete, exec.\",\n  );\n  lines.push(\"\");\n  lines.push(\"## Mounted Providers\");\n  lines.push(\"\");\n\n  const mounts = afs.getMounts(null);\n  if (mounts.length === 0) {\n    lines.push(\"No providers currently mounted.\");\n  } else {\n    for (const m of mounts) {\n      const desc = m.module.description;\n      lines.push(`### ${m.module.name} (${m.path})`);\n      if (desc) {\n        for (const line of desc.split(\"\\n\")) {\n          lines.push(line);\n        }\n      }\n      lines.push(\"\");\n    }\n  }\n\n  lines.push(\"## Usage\");\n  lines.push(\"\");\n  lines.push(\"- Use `afs_list` to browse directories and discover content\");\n  lines.push(\"- Use `afs_read` to read file/node content\");\n  lines.push(\"- Use `afs_stat` to get metadata without content\");\n  lines.push(\"- Use `afs_explain` to get documentation for any path\");\n  lines.push(\"- Use `afs_search` to find content by pattern\");\n  lines.push(\"- Use `afs_write` to create or update content\");\n  lines.push(\"- Use `afs_delete` to remove files or nodes\");\n  lines.push(\"- Use `afs_exec` to execute actions (e.g., `/.actions/mount`)\");\n  lines.push(\"\");\n  lines.push(\n    \"Start with `afs_list /` to see all mounted providers, or `afs_explain /` for a complete overview.\",\n  );\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Create an MCP Server that exposes AFS operations as tools,\n * resources, and prompts.\n *\n * If `options.server` is provided, registers on that server instead of creating a new one.\n */\nexport function createAFSMcpServer(options: CreateAFSMcpServerOptions): AFSMcpServerResult {\n  const { afs } = options;\n  const server = options.server ?? createMcpServerInstance();\n\n  // Set instructions dynamically — includes mounted provider info\n  // Access the underlying Server's private _instructions field\n  (server.server as unknown as Record<string, unknown>)._instructions = buildInstructions(afs);\n\n  registerTools(server, afs);\n  registerResources(server, afs);\n  registerPrompts(server, afs);\n\n  return { server };\n}\n"],"mappings":";;;;;;;;;;;AA8BA,SAAgB,0BAAqC;AACnD,QAAO,IAAI,UACT;EAAE,MAAM;EAAO,SAAS;EAAS,EACjC,EACE,cAAc;EACZ,OAAO,EAAE;EACT,WAAW,EAAE;EACb,SAAS,EAAE;EACZ,EACF,CACF;;;;;;AAOH,SAAS,kBAAkB,KAAkB;CAC3C,MAAM,QAAkB,EAAE;AAE1B,OAAM,KACJ,iHACD;AACD,OAAM,KACJ,sJACD;AACD,OAAM,KAAK,GAAG;AACd,OAAM,KAAK,uBAAuB;AAClC,OAAM,KAAK,GAAG;CAEd,MAAM,SAAS,IAAI,UAAU,KAAK;AAClC,KAAI,OAAO,WAAW,EACpB,OAAM,KAAK,kCAAkC;KAE7C,MAAK,MAAM,KAAK,QAAQ;EACtB,MAAM,OAAO,EAAE,OAAO;AACtB,QAAM,KAAK,OAAO,EAAE,OAAO,KAAK,IAAI,EAAE,KAAK,GAAG;AAC9C,MAAI,KACF,MAAK,MAAM,QAAQ,KAAK,MAAM,KAAK,CACjC,OAAM,KAAK,KAAK;AAGpB,QAAM,KAAK,GAAG;;AAIlB,OAAM,KAAK,WAAW;AACtB,OAAM,KAAK,GAAG;AACd,OAAM,KAAK,8DAA8D;AACzE,OAAM,KAAK,6CAA6C;AACxD,OAAM,KAAK,mDAAmD;AAC9D,OAAM,KAAK,wDAAwD;AACnE,OAAM,KAAK,gDAAgD;AAC3D,OAAM,KAAK,gDAAgD;AAC3D,OAAM,KAAK,8CAA8C;AACzD,OAAM,KAAK,gEAAgE;AAC3E,OAAM,KAAK,GAAG;AACd,OAAM,KACJ,oGACD;AAED,QAAO,MAAM,KAAK,KAAK;;;;;;;;AASzB,SAAgB,mBAAmB,SAAwD;CACzF,MAAM,EAAE,QAAQ;CAChB,MAAM,SAAS,QAAQ,UAAU,yBAAyB;AAI1D,CAAC,OAAO,OAA8C,gBAAgB,kBAAkB,IAAI;AAE5F,eAAc,QAAQ,IAAI;AAC1B,mBAAkB,QAAQ,IAAI;AAC9B,iBAAgB,QAAQ,IAAI;AAE5B,QAAO,EAAE,QAAQ"}
+{"version":3,"file":"server.mjs","names":[],"sources":["../../src/mcp/server.ts"],"sourcesContent":["/**\n * AFS MCP Server\n *\n * Creates an MCP Server that exposes AFS operations as MCP tools,\n * resources, and prompts.\n */\n\nimport type { AFS } from \"@aigne/afs\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { VERSION } from \"../version.js\";\nimport { registerPrompts } from \"./prompts.js\";\nimport { registerResources } from \"./resources.js\";\nimport { registerTools } from \"./tools.js\";\n\nexport interface CreateAFSMcpServerOptions {\n  /** AFS instance to expose */\n  afs: AFS;\n  /** Pre-created McpServer instance. If not provided, a new one is created. */\n  server?: McpServer;\n}\n\nexport interface AFSMcpServerResult {\n  /** The MCP server instance */\n  server: McpServer;\n}\n\n/**\n * Create a new McpServer instance with AFS capabilities.\n * Useful when you need the server before AFS is created (e.g. for MCP auth context).\n */\nexport function createMcpServerInstance(): McpServer {\n  return new McpServer(\n    { name: \"afs\", version: VERSION },\n    {\n      capabilities: {\n        tools: {},\n        resources: {},\n        prompts: {},\n        logging: {},\n      },\n    },\n  );\n}\n\n/**\n * Build MCP instructions string from AFS instance.\n * Includes base AFS description + dynamically mounted provider details.\n */\nfunction buildInstructions(afs: AFS): string {\n  const lines: string[] = [];\n\n  lines.push(\n    \"AFS (Agentic File System) is a virtual filesystem developed by ArcBlock that gives AI agents a unified, path-based interface to any data source.\",\n  );\n  lines.push(\n    'Inspired by Unix and Plan 9\\'s \"everything is a file\", AFS extends the idea to \"everything is context\" — databases, APIs, smart home devices, and cloud services all become files and directories that agents can read, write, search, and act on.',\n  );\n  lines.push(\n    \"All data sources are accessed through a consistent path-based API with standard operations: read, list, stat, explain, search, write, delete, exec.\",\n  );\n  lines.push(\"\");\n  lines.push(\"## Mounted Providers\");\n  lines.push(\"\");\n\n  const mounts = afs.getMounts(null);\n  if (mounts.length === 0) {\n    lines.push(\"No providers currently mounted.\");\n  } else {\n    for (const m of mounts) {\n      const desc = m.module.description;\n      lines.push(`### ${m.module.name} (${m.path})`);\n      if (desc) {\n        for (const line of desc.split(\"\\n\")) {\n          lines.push(line);\n        }\n      }\n      lines.push(\"\");\n    }\n  }\n\n  lines.push(\"## Usage\");\n  lines.push(\"\");\n  lines.push(\"- Use `afs_list` to browse directories and discover content\");\n  lines.push(\"- Use `afs_read` to read file/node content\");\n  lines.push(\"- Use `afs_stat` to get metadata without content\");\n  lines.push(\"- Use `afs_explain` to get documentation for any path\");\n  lines.push(\"- Use `afs_search` to find content by pattern\");\n  lines.push(\"- Use `afs_write` to create or update content\");\n  lines.push(\"- Use `afs_delete` to remove files or nodes\");\n  lines.push(\"- Use `afs_exec` to execute actions (e.g., `/.actions/mount`)\");\n  lines.push(\"\");\n  lines.push(\n    \"Start with `afs_list /` to see all mounted providers, or `afs_explain /` for a complete overview.\",\n  );\n\n  return lines.join(\"\\n\");\n}\n\n/**\n * Create an MCP Server that exposes AFS operations as tools,\n * resources, and prompts.\n *\n * If `options.server` is provided, registers on that server instead of creating a new one.\n */\nexport function createAFSMcpServer(options: CreateAFSMcpServerOptions): AFSMcpServerResult {\n  const { afs } = options;\n  const server = options.server ?? createMcpServerInstance();\n\n  // Set instructions dynamically — includes mounted provider info\n  // Access the underlying Server's private _instructions field\n  (server.server as unknown as Record<string, unknown>)._instructions = buildInstructions(afs);\n\n  registerTools(server, afs);\n  registerResources(server, afs);\n  registerPrompts(server, afs);\n\n  return { server };\n}\n"],"mappings":";;;;;;;;;;;AA8BA,SAAgB,0BAAqC;AACnD,QAAO,IAAI,UACT;EAAE,MAAM;EAAO,SAAS;EAAS,EACjC,EACE,cAAc;EACZ,OAAO,EAAE;EACT,WAAW,EAAE;EACb,SAAS,EAAE;EACX,SAAS,EAAE;EACZ,EACF,CACF;;;;;;AAOH,SAAS,kBAAkB,KAAkB;CAC3C,MAAM,QAAkB,EAAE;AAE1B,OAAM,KACJ,mJACD;AACD,OAAM,KACJ,wPACD;AACD,OAAM,KACJ,sJACD;AACD,OAAM,KAAK,GAAG;AACd,OAAM,KAAK,uBAAuB;AAClC,OAAM,KAAK,GAAG;CAEd,MAAM,SAAS,IAAI,UAAU,KAAK;AAClC,KAAI,OAAO,WAAW,EACpB,OAAM,KAAK,kCAAkC;KAE7C,MAAK,MAAM,KAAK,QAAQ;EACtB,MAAM,OAAO,EAAE,OAAO;AACtB,QAAM,KAAK,OAAO,EAAE,OAAO,KAAK,IAAI,EAAE,KAAK,GAAG;AAC9C,MAAI,KACF,MAAK,MAAM,QAAQ,KAAK,MAAM,KAAK,CACjC,OAAM,KAAK,KAAK;AAGpB,QAAM,KAAK,GAAG;;AAIlB,OAAM,KAAK,WAAW;AACtB,OAAM,KAAK,GAAG;AACd,OAAM,KAAK,8DAA8D;AACzE,OAAM,KAAK,6CAA6C;AACxD,OAAM,KAAK,mDAAmD;AAC9D,OAAM,KAAK,wDAAwD;AACnE,OAAM,KAAK,gDAAgD;AAC3D,OAAM,KAAK,gDAAgD;AAC3D,OAAM,KAAK,8CAA8C;AACzD,OAAM,KAAK,gEAAgE;AAC3E,OAAM,KAAK,GAAG;AACd,OAAM,KACJ,oGACD;AAED,QAAO,MAAM,KAAK,KAAK;;;;;;;;AASzB,SAAgB,mBAAmB,SAAwD;CACzF,MAAM,EAAE,QAAQ;CAChB,MAAM,SAAS,QAAQ,UAAU,yBAAyB;AAI1D,CAAC,OAAO,OAA8C,gBAAgB,kBAAkB,IAAI;AAE5F,eAAc,QAAQ,IAAI;AAC1B,mBAAkB,QAAQ,IAAI;AAC9B,iBAAgB,QAAQ,IAAI;AAE5B,QAAO,EAAE,QAAQ"}