@filium/flite-js 0.1.0 → 0.2.0

package/package.json

@@ -1,18 +1,23 @@
 {
   "name": "@filium/flite-js",
-  "version": "0.1.0",
-  "description": "Byte-exact, token-saving source editor — a compiled wasm core (resilient sectioning + byte-exact splicing) plus fs. The standalone tool behind the filium-flite plugin. Runs in Node and Deno.",
+  "version": "0.2.0",
+  "description": "Byte-exact, token-saving source editor — a compiled wasm core (resilient sectioning + byte-exact splicing) plus fs. Ships as a library and as an MCP server (bin: filium-flite-mcp). Runs in Node and Deno.",
   "type": "module",
   "publishConfig": { "access": "public" },
   "main": "./src/index.js",
   "exports": {
     ".": "./src/index.js"
   },
+  "bin": { "filium-flite-mcp": "./src/mcp.js" },
   "files": ["src", "wasm"],
   "scripts": {
     "test": "node test/smoke.mjs"
   },
-  "keywords": ["editor", "wasm", "tokens", "llm", "agent", "filium", "flite"],
+  "keywords": ["editor", "wasm", "tokens", "llm", "agent", "filium", "flite", "mcp"],
   "license": "BUSL-1.1",
-  "engines": { "node": ">=18" }
+  "engines": { "node": ">=18" },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^3.23.0"
+  }
 }

package/src/mcp.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+// filium-flite MCP server — the package's second entry point (bin), alongside the
+// library. Thin wiring over the Session in ./index.js: receive a tool call, forward
+// it, return the result. The wasm core does the work (sectioning + byte-exact splices).
+//
+// The MCP SDK + zod are imported HERE only, never from index.js — so `import { Session }
+// from "@filium/flite-js"` (library use) never loads them at runtime.
+//
+// stdio transport OWNS stdout — never console.log here; diagnostics go to stderr.
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { Session } from "./index.js";
+
+const session = new Session();
+const server = new McpServer({ name: "filium-flite", version: "0.2.0" });
+
+const ok = (data) => ({ content: [{ type: "text", text: JSON.stringify(data ?? {}) }] });
+const fail = (e) => ({
+  content: [{ type: "text", text: JSON.stringify({ error: e?.kind ?? "error", message: e?.message ?? String(e) }) }],
+  isError: true,
+});
+
+function tool(name, description, shape, handler) {
+  server.registerTool(name, { description, inputSchema: shape }, async (args) => {
+    try {
+      return ok(await handler(args));
+    } catch (e) {
+      return fail(e);
+    }
+  });
+}
+
+const P = { path: z.string().describe("file path") };
+const SID = { section_id: z.string().describe("section id from the outline, e.g. s-3") };
+const BODY = { content: z.string().describe("replacement/inserted text, verbatim") };
+
+tool("filium_flite_open", "Section a file; returns its outline (id, heading, line range, balanced) without loading the whole file.",
+  { ...P }, async ({ path }) => ({ path, sections: await session.open(path) }));
+tool("filium_flite_list", "List open buffers.", {}, () => ({ open: session.list() }));
+tool("filium_flite_zoom", "Return the verbatim text of one section.",
+  { ...P, ...SID }, ({ path, section_id }) => ({ section_id, text: session.zoom(path, section_id) }));
+tool("filium_flite_find", "Find sections whose text matches a query.",
+  { ...P, pattern: z.string() }, ({ path, pattern }) => ({ hits: session.find(path, pattern) }));
+tool("filium_flite_edit", "Replace a section's bytes, byte-exact. Everything else is untouched.",
+  { ...P, ...SID, ...BODY }, ({ path, section_id, content }) => session.edit(path, section_id, content));
+tool("filium_flite_replace", "Replace the first verbatim occurrence of an anchor.",
+  { ...P, anchor: z.string(), replacement: z.string() }, ({ path, anchor, replacement }) => session.replace(path, anchor, replacement));
+tool("filium_flite_insert_before", "Insert text before a section.",
+  { ...P, ...SID, ...BODY }, ({ path, section_id, content }) => session.insertBefore(path, section_id, content));
+tool("filium_flite_insert_after", "Insert text after a section.",
+  { ...P, ...SID, ...BODY }, ({ path, section_id, content }) => session.insertAfter(path, section_id, content));
+tool("filium_flite_append", "Append text to the buffer.",
+  { ...P, ...BODY }, ({ path, content }) => session.append(path, content));
+tool("filium_flite_save", "Write the buffer to disk (refuses if the file changed on disk since open).",
+  { ...P }, ({ path }) => session.save(path));
+tool("filium_flite_close", "Close a buffer.",
+  { ...P }, ({ path }) => { session.close(path); return { path, closed: true }; });
+tool("filium_flite_read_slice", "Return the verbatim text of a 0-based line range [start, end).",
+  { ...P, start: z.number().int(), end: z.number().int() }, ({ path, start, end }) => ({ path, start, end, text: session.readSlice(path, start, end) }));
+
+await server.connect(new StdioServerTransport());