@svgrid/mcp 3.0.22 → 3.0.24

package/README.md

@@ -102,6 +102,15 @@ The `studio_*` tools let an agent build and edit the **same validated project mo
 server's env. Tools that need a licence to be useful should not cost every
 other user context on every request.
 
+These tools and `svgrid_scaffold` run on `@svgrid/enterprise`, an optional
+peer that `npx -y @svgrid/mcp` does not install (it would double the cold
+start). Install both in the project and run the local server:
+
+```bash
+npm i -D @svgrid/mcp @svgrid/enterprise
+claude mcp add svgrid -- npx svgrid-mcp
+```
+
 | Tool | Purpose |
 | --- | --- |
 | `studio_project` | `new`, `load`, `describe`, `config`, `capabilities`. |

package/dist/core-tools.d.ts

@@ -1,3 +1,4 @@
+export { CORE_TOOLS } from './tool-defs.js';
 export type ToolResult = {
     isError?: boolean;
     content: {
@@ -5,70 +6,4 @@ export type ToolResult = {
         text: string;
     }[];
 };
-export declare const CORE_TOOLS: readonly [{
-    readonly name: "svgrid_search";
-    readonly title: "Search SvGrid";
-    readonly description: "Search SvGrid docs, example demos and the API surface in ONE call. Start here for any \"how do I ...\" question - it covers all three, so you do not have to guess which one holds the answer. Call with no arguments for an index of doc sections, demo categories and API groups. Returns ids/slugs you can pass to svgrid_get.";
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly query: {
-                readonly type: "string";
-                readonly description: "What you are trying to do, e.g. \"pin a column\", \"server side pagination\", \"kanban swimlanes\". Omit for the index.";
-            };
-            readonly kind: {
-                readonly type: "string";
-                readonly enum: readonly ["all", "docs", "examples", "api"];
-                readonly description: "Restrict the search. Default \"all\".";
-                readonly default: "all";
-            };
-            readonly detail: {
-                readonly type: "string";
-                readonly enum: readonly ["concise", "full"];
-                readonly description: "\"concise\" (default) returns titles plus a short excerpt. \"full\" returns the matching doc excerpts at length - more tokens, fewer follow-up calls.";
-                readonly default: "concise";
-            };
-            readonly section: {
-                readonly type: "string";
-                readonly description: "Restrict docs to one section, exactly, e.g. \"Help\". Call with no arguments to see the sections.";
-            };
-            readonly category: {
-                readonly type: "string";
-                readonly description: "Restrict demos to one category, exactly, e.g. \"Kanban\". Call with no arguments to see the categories.";
-            };
-            readonly limit: {
-                readonly type: "number";
-                readonly description: "Max results per corpus. Default 10, max 50.";
-                readonly default: 10;
-            };
-        };
-        readonly required: readonly [];
-    };
-}, {
-    readonly name: "svgrid_get";
-    readonly title: "Read a doc or demo";
-    readonly description: "Fetch one thing in full by reference: a doc slug (\"help/columns/column-definitions\"), a demo id (\"11-stock-market\"), or \"api\" for the curated API reference. Use svgrid_search first to find the reference.";
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly ref: {
-                readonly type: "string";
-                readonly description: "A doc slug, a demo id, \"api\", or a schema id such as \"chart-spec\" (or \"chart spec schema\"). The kind is inferred; pass `kind` to force it.";
-            };
-            readonly kind: {
-                readonly type: "string";
-                readonly enum: readonly ["auto", "doc", "example", "api", "schema"];
-                readonly description: "Override the inferred kind. Default \"auto\".";
-                readonly default: "auto";
-            };
-            readonly detail: {
-                readonly type: "string";
-                readonly enum: readonly ["concise", "full"];
-                readonly description: "\"full\" (default) returns the whole thing; \"concise\" truncates long content.";
-                readonly default: "full";
-            };
-        };
-        readonly required: readonly ["ref"];
-    };
-}];
 export declare function handleCoreTool(name: string, args: Record<string, unknown>): ToolResult | undefined;

package/dist/core-tools.js

@@ -16,6 +16,7 @@
 import { apiReference, apiSurface, docs, examples, schemas } from './data.js';
 import { meaningfulTerms, rankDocs } from './search.js';
 import { ENTERPRISE_LINE, ENTERPRISE_NOTE, importsEnterprise, isEnterpriseDoc, isPaidQuestion } from './enterprise.js';
+export { CORE_TOOLS } from './tool-defs.js';
 const DOCS_FOOTER = `\n\nSvGrid reference: full docs & ${examples.length} live demos at https://svgrid.com/docs`;
 const text = (body) => ({ content: [{ type: 'text', text: body }] });
 const withDocs = (body) => text(body + DOCS_FOOTER);
@@ -74,71 +75,6 @@ const apiNames = (() => {
 /** Docs and demos that use the paid package, found once from their source. */
 const enterpriseDocs = new Set(docs.filter((d) => isEnterpriseDoc(d.slug, d.markdown)).map((d) => d.slug));
 const enterpriseExamples = new Set(examples.filter((e) => importsEnterprise(e.source)).map((e) => e.id));
-export const CORE_TOOLS = [
-    {
-        name: 'svgrid_search',
-        title: 'Search SvGrid',
-        description: 'Search SvGrid docs, example demos and the API surface in ONE call. Start here for any "how do I ..." question - it covers all three, so you do not have to guess which one holds the answer. Call with no arguments for an index of doc sections, demo categories and API groups. Returns ids/slugs you can pass to svgrid_get.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                query: {
-                    type: 'string',
-                    description: 'What you are trying to do, e.g. "pin a column", "server side pagination", "kanban swimlanes". Omit for the index.',
-                },
-                kind: {
-                    type: 'string',
-                    enum: ['all', 'docs', 'examples', 'api'],
-                    description: 'Restrict the search. Default "all".',
-                    default: 'all',
-                },
-                detail: {
-                    type: 'string',
-                    enum: ['concise', 'full'],
-                    description: '"concise" (default) returns titles plus a short excerpt. "full" returns the matching doc excerpts at length - more tokens, fewer follow-up calls.',
-                    default: 'concise',
-                },
-                section: {
-                    type: 'string',
-                    description: 'Restrict docs to one section, exactly, e.g. "Help". Call with no arguments to see the sections.',
-                },
-                category: {
-                    type: 'string',
-                    description: 'Restrict demos to one category, exactly, e.g. "Kanban". Call with no arguments to see the categories.',
-                },
-                limit: { type: 'number', description: 'Max results per corpus. Default 10, max 50.', default: 10 },
-            },
-            required: [],
-        },
-    },
-    {
-        name: 'svgrid_get',
-        title: 'Read a doc or demo',
-        description: 'Fetch one thing in full by reference: a doc slug ("help/columns/column-definitions"), a demo id ("11-stock-market"), or "api" for the curated API reference. Use svgrid_search first to find the reference.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                ref: {
-                    type: 'string',
-                    description: 'A doc slug, a demo id, "api", or a schema id such as "chart-spec" (or "chart spec schema"). The kind is inferred; pass `kind` to force it.',
-                },
-                kind: {
-                    type: 'string',
-                    enum: ['auto', 'doc', 'example', 'api', 'schema'],
-                    description: 'Override the inferred kind. Default "auto".',
-                    default: 'auto',
-                },
-                detail: {
-                    type: 'string',
-                    enum: ['concise', 'full'],
-                    description: '"full" (default) returns the whole thing; "concise" truncates long content.',
-                    default: 'full',
-                },
-            },
-            required: ['ref'],
-        },
-    },
-];
 /** Rank examples by a term match over id/title/blurb, optionally within a category. */
 function searchExamples(query, limit, category) {
     const pool = category