@xtrable-ltd/nanoesis 0.1.11 → 0.1.12

package/dist/mcp.d.ts

@@ -0,0 +1,48 @@
+import { ApiDeps } from '@nanoesis/editor-api';
+
+/**
+ * Identity reported to MCP clients on `initialize`. Defaults: `{ name: 'nanoesis', version:
+ * '0.0.0' }`. Adopters embedding the HTTP route in their own host typically override `name`
+ * with their site identifier and `version` with their app version so client UIs identify
+ * the deployment, not the framework.
+ */
+interface McpServerIdentity {
+    readonly name?: string;
+    readonly version?: string;
+}
+
+/**
+ * Options for {@link handleMcpRequest}. Both fields are passed straight through to the
+ * MCP `Server`'s `initialize` response so client UIs (Claude Desktop, Cursor, …) identify
+ * the deployment rather than the framework.
+ */
+type HandleMcpRequestOptions = McpServerIdentity;
+/**
+ * Handle a single MCP HTTP request over the SDK's web-standard Streamable HTTP transport
+ * (DESIGN §11c/§14). Stateless: each call builds a fresh `Server` + `Transport` pair, so
+ * the caller's per-request `Authorization: Bearer …` header — propagated by the SDK into
+ * the request handlers as `extra.requestInfo.headers` — drives the editor's per-user role
+ * gate exactly as `/api/*` does.
+ *
+ * The signature is Fetch-API neutral: any runtime that hands a handler a standard
+ * `Request` (Azure Functions v4, Cloudflare Workers, plain Node 18+, Bun, Deno, Hono)
+ * wires it the same way:
+ *
+ * ```ts
+ * import { handleMcpRequest } from '@xtrable-ltd/nanoesis/mcp';
+ * // ... build `deps` once at startup
+ * app.http('mcp', {
+ *   methods: ['POST', 'GET', 'DELETE'],
+ *   handler: (req) => handleMcpRequest(deps, req, { name: 'my-site', version: pkg.version }),
+ * });
+ * ```
+ *
+ * Runtimes whose request shape is not a standard `Request` (e.g. Azure Functions' enhanced
+ * HttpRequest, Express' IncomingMessage) translate to/from `Request`/`Response` at the
+ * boundary — that translation is adopter-side because it depends on the host runtime; the
+ * MCP server construction and transport handling, which used to be ~120 lines of inlined
+ * boilerplate per adopter, is now this one call.
+ */
+declare function handleMcpRequest(deps: ApiDeps, request: Request, opts?: HandleMcpRequestOptions): Promise<Response>;
+
+export { type HandleMcpRequestOptions, handleMcpRequest };

package/dist/mcp.js

@@ -0,0 +1,76 @@
+import {
+  MCP_RESOURCES,
+  MCP_TOOLS,
+  callMcpTool,
+  readMcpResource
+} from "./chunk-EN5SMEWJ.js";
+import "./chunk-XO3CT6GL.js";
+
+// ../../hosts/host-mcp/src/http.ts
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+
+// ../../hosts/host-mcp/src/server.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import {
+  CallToolRequestSchema,
+  ListResourcesRequestSchema,
+  ListToolsRequestSchema,
+  ReadResourceRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+var BEARER_PREFIX = /^Bearer\s+/i;
+function bearerFrom(headers) {
+  if (headers === void 0) return void 0;
+  const raw = headers["authorization"] ?? headers["Authorization"];
+  const value = Array.isArray(raw) ? raw[0] : raw;
+  if (value === void 0) return void 0;
+  const match = BEARER_PREFIX.exec(value);
+  return match ? value.slice(match[0].length).trim() : void 0;
+}
+function createMcpServer(deps, identity) {
+  const server = new Server(
+    { name: identity?.name ?? "nanoesis", version: identity?.version ?? "0.0.0" },
+    { capabilities: { tools: {}, resources: {} } }
+  );
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [...MCP_TOOLS] }));
+  server.setRequestHandler(CallToolRequestSchema, async (req, extra) => {
+    const args = req.params.arguments ?? {};
+    const token = bearerFrom(extra.requestInfo?.headers);
+    const result = await callMcpTool(
+      deps,
+      req.params.name,
+      args,
+      token !== void 0 ? { token } : {}
+    );
+    return { content: [{ type: "text", text: result.text }], isError: result.isError };
+  });
+  server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+    resources: [...MCP_RESOURCES]
+  }));
+  server.setRequestHandler(ReadResourceRequestSchema, async (req) => {
+    const { uri } = req.params;
+    const resource = readMcpResource(uri);
+    if (resource === void 0) throw new Error(`Unknown resource: ${uri}`);
+    return { contents: [{ uri, mimeType: resource.mimeType, text: resource.text }] };
+  });
+  return server;
+}
+
+// ../../hosts/host-mcp/src/http.ts
+var DEFAULT_VERSION = true ? "0.1.12" : "0.0.0-workspace";
+async function handleMcpRequest(deps, request, opts) {
+  const server = createMcpServer(deps, {
+    name: opts?.name ?? "nanoesis",
+    version: opts?.version ?? DEFAULT_VERSION
+  });
+  const transport = new WebStandardStreamableHTTPServerTransport({ enableJsonResponse: true });
+  await server.connect(transport);
+  try {
+    return await transport.handleRequest(request);
+  } finally {
+    await transport.close();
+    await server.close();
+  }
+}
+export {
+  handleMcpRequest
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xtrable-ltd/nanoesis",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "nanoesis: a static-first publishing compiler. The engine, the mountable editor API, the storage/image/auth adapters, and the editor UI bundle, in one package (DESIGN 11c).",
   "license": "MIT",
   "author": "Xtrable Ltd",
@@ -49,6 +49,10 @@
       "types": "./dist/editor.d.ts",
       "default": "./dist/editor.js"
     },
+    "./mcp": {
+      "types": "./dist/mcp.d.ts",
+      "default": "./dist/mcp.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -66,6 +70,7 @@
   },
   "dependencies": {
     "@azure/storage-blob": "^12.26.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "parse5": "^7.2.1",
     "sharp": "^0.33.0"
   },
@@ -79,6 +84,7 @@
     "@nanoesis/adapter-trusted-header": "*",
     "@nanoesis/editor-api": "*",
     "@nanoesis/engine": "*",
+    "@nanoesis/host-mcp": "*",
     "@types/node": "^22.10.0",
     "tsup": "^8.3.0"
   }