@cmssy/mcp-server 0.68.0 → 0.69.0

package/dist/__tests__/tool-catalogue.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-catalogue.test.d.ts.map

package/dist/__tests__/tool-catalogue.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-catalogue.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tool-catalogue.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/tool-catalogue.test.js

@@ -0,0 +1,110 @@
+import { describe, it, expect, vi } from "vitest";
+import { boundTools, buildCatalogue, catalogueOfServer, catalogueDrift, catalogueFrom, } from "../tool-catalogue.js";
+import { boundDeclarations } from "../ai-tools-binder.js";
+import { createServer } from "../server.js";
+const client = { query: vi.fn() };
+describe("catalogueFrom", () => {
+    it("publishes one row per bound tool, ordered by name", () => {
+        const rows = catalogueFrom({ publish_page: {}, add_block_to_page: {} }, [
+            { name: "publish_page", requiredPermissions: ["pages:publish"] },
+            { name: "add_block_to_page", requiredPermissions: ["pages:edit"] },
+        ]);
+        expect(rows).toEqual([
+            {
+                name: "add_block_to_page",
+                permission: "pages:edit",
+                description: "",
+            },
+            { name: "publish_page", permission: "pages:publish", description: "" },
+        ]);
+    });
+    it("joins every permission a tool needs", () => {
+        const rows = catalogueFrom({ edit_order: {} }, [
+            {
+                name: "edit_order",
+                requiredPermissions: ["orders:manage", "models:edit"],
+            },
+        ]);
+        expect(rows[0]?.permission).toBe("orders:manage, models:edit");
+    });
+    it("leaves the permission empty for a tool that needs none", () => {
+        const rows = catalogueFrom({ get_workspace_info: {} }, [
+            { name: "get_workspace_info", requiredPermissions: [] },
+        ]);
+        expect(rows[0]?.permission).toBe("");
+    });
+    it("collapses the whitespace a multi-line description carries", () => {
+        const rows = catalogueFrom({ get_page: { description: " One\n  two.  " } }, [{ name: "get_page", requiredPermissions: ["pages:view"] }]);
+        expect(rows[0]?.description).toBe("One two.");
+    });
+    it("falls back to the declared description when the binding carries none", () => {
+        const rows = catalogueFrom({ get_page: {} }, [
+            { name: "get_page", description: "Reads a page." },
+        ]);
+        expect(rows[0]?.description).toBe("Reads a page.");
+    });
+});
+describe("boundTools", () => {
+    it("refuses to publish an empty catalogue", () => {
+        expect(() => boundTools({})).toThrow(/no tools/);
+        expect(() => boundTools({ _registeredTools: {} })).toThrow(/no tools/);
+    });
+});
+describe("buildCatalogue", () => {
+    const rows = buildCatalogue();
+    it("lists every tool the server binds, and no more", () => {
+        const server = createServer(client);
+        const registered = Object.keys(boundTools(server)).sort();
+        expect(rows.map((row) => row.name)).toEqual(registered);
+        expect(rows.length).toBeGreaterThan(50);
+    });
+    it("has a declaration behind every binding, so no permission is guessed", () => {
+        const server = createServer(client);
+        expect(Object.keys(boundTools(server)).filter((name) => !boundDeclarations(server).has(name))).toEqual([]);
+    });
+    it("describes every tool it publishes", () => {
+        expect(rows.filter((row) => row.description === "")).toEqual([]);
+    });
+    it("refuses a tool bound past the binder, whose permissions it cannot know", () => {
+        const rogue = {
+            _registeredTools: { sneak_in: { description: "bound directly" } },
+        };
+        expect(() => catalogueOfServer(rogue)).toThrow(/sneak_in/);
+    });
+    it("names a write tool's permission, not none", () => {
+        const write = rows.find((row) => row.name === "update_region_settings");
+        expect(write?.permission).toBe("pages:edit");
+    });
+});
+describe("catalogueDrift", () => {
+    const built = [
+        { name: "get_page", permission: "pages:view", description: "Reads." },
+    ];
+    it("stays quiet when the page lists exactly what the server exposes", () => {
+        expect(catalogueDrift(built, [...built])).toEqual([]);
+    });
+    it("reports a tool the page never got", () => {
+        expect(catalogueDrift(built, [])).toEqual(["get_page is not on the page"]);
+    });
+    it("reports a tool the page kept after the server dropped it", () => {
+        expect(catalogueDrift(built, [
+            ...built,
+            { name: "old_tool", permission: "", description: "" },
+        ])).toEqual(["old_tool is on the page but the server does not expose it"]);
+    });
+    it("reports a row the page lists twice, which a lookup would swallow", () => {
+        expect(catalogueDrift(built, [...built, ...built])).toEqual([
+            "get_page is listed twice on the page",
+        ]);
+    });
+    it("reports a permission and a description that moved", () => {
+        const drift = catalogueDrift(built, [
+            { name: "get_page", permission: "pages:edit", description: "Writes." },
+        ]);
+        expect(drift).toEqual([
+            "get_page requires pages:view, the page says pages:edit",
+            "get_page is described differently on the page",
+        ]);
+    });
+});
+//# sourceMappingURL=tool-catalogue.test.js.map

package/dist/__tests__/tool-catalogue.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-catalogue.test.js","sourceRoot":"","sources":["../../src/__tests__/tool-catalogue.test.ts"],"names":[],"mappings":"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"}

package/dist/ai-tools-binder.d.ts

@@ -1,4 +1,5 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { AiTool, WorkspaceOps } from "@cmssy/ai-tools";
+export declare function boundDeclarations(server: McpServer): Map<string, AiTool>;
 export declare function bindSharedTool(server: McpServer, tool: AiTool, ops: WorkspaceOps): void;
 //# sourceMappingURL=ai-tools-binder.d.ts.map

package/dist/ai-tools-binder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-tools-binder.d.ts","sourceRoot":"","sources":["../src/ai-tools-binder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAY5D,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,YAAY,GAChB,IAAI,CA8BN"}
+{"version":3,"file":"ai-tools-binder.d.ts","sourceRoot":"","sources":["../src/ai-tools-binder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAc5D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAExE;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,YAAY,GAChB,IAAI,CAkCN"}

package/dist/ai-tools-binder.js

@@ -10,7 +10,14 @@ const jsonPreprocess = (val) => {
         return val;
     }
 };
+const declarations = new WeakMap();
+export function boundDeclarations(server) {
+    return declarations.get(server) ?? new Map();
+}
 export function bindSharedTool(server, tool, ops) {
+    const declared = declarations.get(server) ?? new Map();
+    declared.set(tool.name, tool);
+    declarations.set(server, declared);
     const shape = tool.inputSchema
         .shape;
     const mcpShape = Object.fromEntries(Object.entries(shape).map(([key, schema]) => [

package/dist/ai-tools-binder.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-tools-binder.js","sourceRoot":"","sources":["../src/ai-tools-binder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,cAAc,GAAG,CAAC,GAAY,EAAE,EAAE;IACtC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,UAAU,cAAc,CAC5B,MAAiB,EACjB,IAAY,EACZ,GAAiB;IAEjB,MAAM,KAAK,GAAI,IAAI,CAAC,WAAqD;SACtE,KAAK,CAAC;IACT,MAAM,QAAQ,GAAkB,MAAM,CAAC,WAAW,CAChD,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;QAC3C,GAAG;QACH,CAAC,CAAC,UAAU,CAAC,cAAc,EAAE,MAAsB,CAAC;KACrD,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAc,EAAE,EAAE;QAC1E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC9C,OAAO;gBACL,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;iBACjE;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qBACvD;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"ai-tools-binder.js","sourceRoot":"","sources":["../src/ai-tools-binder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,cAAc,GAAG,CAAC,GAAY,EAAE,EAAE;IACtC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,IAAI,OAAO,EAAkC,CAAC;AAEnE,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,OAAO,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAAiB,EACjB,IAAY,EACZ,GAAiB;IAEjB,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAkB,CAAC;IACvE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEnC,MAAM,KAAK,GAAI,IAAI,CAAC,WAAqD;SACtE,KAAK,CAAC;IACT,MAAM,QAAQ,GAAkB,MAAM,CAAC,WAAW,CAChD,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;QAC3C,GAAG;QACH,CAAC,CAAC,UAAU,CAAC,cAAc,EAAE,MAAsB,CAAC;KACrD,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAc,EAAE,EAAE;QAC1E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC9C,OAAO;gBACL,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;iBACjE;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qBACvD;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tool-catalogue.d.ts

@@ -0,0 +1,20 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export interface CatalogueRow {
+    name: string;
+    permission: string;
+    description: string;
+}
+export interface BoundTool {
+    description?: string;
+}
+export interface DeclaredTool {
+    name: string;
+    description?: string;
+    requiredPermissions?: readonly string[];
+}
+export declare function catalogueFrom(bound: Record<string, BoundTool>, declared: readonly DeclaredTool[]): CatalogueRow[];
+export declare function boundTools(server: unknown): Record<string, BoundTool>;
+export declare function catalogueOfServer(server: McpServer): CatalogueRow[];
+export declare function buildCatalogue(): CatalogueRow[];
+export declare function catalogueDrift(built: readonly CatalogueRow[], published: readonly CatalogueRow[]): string[];
+//# sourceMappingURL=tool-catalogue.d.ts.map

package/dist/tool-catalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-catalogue.d.ts","sourceRoot":"","sources":["../src/tool-catalogue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAChC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAChC,YAAY,EAAE,CAahB;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAUrE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,YAAY,EAAE,CAcnE;AAED,wBAAgB,cAAc,IAAI,YAAY,EAAE,CAE/C;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,SAAS,EAAE,SAAS,YAAY,EAAE,GACjC,MAAM,EAAE,CAqCV"}

package/dist/tool-catalogue.js

@@ -0,0 +1,67 @@
+import { createServer } from "./server.js";
+import { boundDeclarations } from "./ai-tools-binder.js";
+export function catalogueFrom(bound, declared) {
+    const byName = new Map(declared.map((tool) => [tool.name, tool]));
+    return Object.entries(bound)
+        .map(([name, tool]) => {
+        const declaration = byName.get(name);
+        const description = tool.description ?? declaration?.description ?? "";
+        return {
+            name,
+            permission: (declaration?.requiredPermissions ?? []).join(", "),
+            description: description.replace(/\s+/g, " ").trim(),
+        };
+    })
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+export function boundTools(server) {
+    const registered = server._registeredTools;
+    if (!registered || Object.keys(registered).length === 0) {
+        throw new Error("the server exposes no tools - the MCP SDK no longer keeps them on _registeredTools");
+    }
+    return registered;
+}
+export function catalogueOfServer(server) {
+    const registered = boundTools(server);
+    const declared = boundDeclarations(server);
+    const undeclared = Object.keys(registered).filter((name) => !declared.has(name));
+    if (undeclared.length > 0) {
+        throw new Error(`bound without a declaration, so their permissions cannot be published: ${undeclared.join(", ")}`);
+    }
+    return catalogueFrom(registered, [...declared.values()]);
+}
+export function buildCatalogue() {
+    return catalogueOfServer(createServer({}));
+}
+export function catalogueDrift(built, published) {
+    const drift = [];
+    const live = new Map();
+    for (const row of published) {
+        if (live.has(row.name)) {
+            drift.push(`${row.name} is listed twice on the page`);
+            continue;
+        }
+        live.set(row.name, row);
+    }
+    for (const row of built) {
+        const onPage = live.get(row.name);
+        if (!onPage) {
+            drift.push(`${row.name} is not on the page`);
+            continue;
+        }
+        if (onPage.permission !== row.permission) {
+            drift.push(`${row.name} requires ${row.permission || "no permission"}, the page says ${onPage.permission || "none"}`);
+        }
+        if (onPage.description !== row.description) {
+            drift.push(`${row.name} is described differently on the page`);
+        }
+    }
+    const exposed = new Set(built.map((row) => row.name));
+    for (const row of published) {
+        if (!exposed.has(row.name)) {
+            drift.push(`${row.name} is on the page but the server does not expose it`);
+        }
+    }
+    return drift;
+}
+//# sourceMappingURL=tool-catalogue.js.map

package/dist/tool-catalogue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-catalogue.js","sourceRoot":"","sources":["../src/tool-catalogue.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmssy/mcp-server",
-  "version": "0.68.0",
+  "version": "0.69.0",
   "description": "MCP server for Cmssy CMS \u2014 enables AI-driven page creation and management",
   "type": "module",
   "bin": {
@@ -12,6 +12,8 @@
     "sync-schema": "node scripts/sync-schema.mjs",
     "fetch-prod-schema": "node scripts/fetch-prod-schema.mjs",
     "check-schema-drift": "node scripts/check-schema-drift.mjs",
+    "catalogue": "pnpm build && node scripts/publish-tool-catalogue.mjs",
+    "catalogue:check": "pnpm build && node scripts/publish-tool-catalogue.mjs --check",
     "dev": "tsx src/index.ts",
     "typecheck": "tsc --noEmit",
     "test": "vitest run"