@adaptabletools/adaptable-mcp 0.0.0-stage → 0.1.0-canary.0

package/dist/environment.js

@@ -0,0 +1,181 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+const FRAMEWORK_PACKAGES = {
+    '@adaptabletools/adaptable-react-aggrid': 'react',
+    '@adaptabletools/adaptable-angular-aggrid': 'angular',
+    '@adaptabletools/adaptable-vue3-aggrid': 'vue',
+};
+function readJson(path) {
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+function findInstalledPackageJson(projectPath, name) {
+    let dir = projectPath;
+    for (;;) {
+        const candidate = join(dir, 'node_modules', name, 'package.json');
+        if (existsSync(candidate)) {
+            return readJson(candidate);
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            return undefined;
+        }
+        dir = parent;
+    }
+}
+/** Nearest folder with a package.json, starting at `start` */
+export function findProjectRoot(start) {
+    let dir = resolve(start);
+    for (;;) {
+        if (existsSync(join(dir, 'package.json'))) {
+            return dir;
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            return resolve(start);
+        }
+        dir = parent;
+    }
+}
+export function detectEnvironment(start) {
+    const projectPath = findProjectRoot(start);
+    const pkg = readJson(join(projectPath, 'package.json'));
+    const declared = {
+        ...(pkg?.peerDependencies ?? {}),
+        ...(pkg?.devDependencies ?? {}),
+        ...(pkg?.dependencies ?? {}),
+    };
+    const names = Object.keys(declared);
+    const info = (name) => ({
+        name,
+        declared: declared[name],
+        installed: findInstalledPackageJson(projectPath, name)?.version,
+    });
+    const adaptablePackages = names
+        .filter((n) => n.startsWith('@adaptabletools/') && n !== '@adaptabletools/adaptable-mcp')
+        .map(info);
+    const agGridPackages = names
+        .filter((n) => n === 'ag-stack' || n.startsWith('ag-grid-') || n.startsWith('@ag-grid-'))
+        .map(info);
+    const adaptable = adaptablePackages.find((p) => p.name === '@adaptabletools/adaptable') ??
+        (findInstalledPackageJson(projectPath, '@adaptabletools/adaptable')
+            ? info('@adaptabletools/adaptable')
+            : adaptablePackages.find((p) => FRAMEWORK_PACKAGES[p.name]));
+    const version = adaptable?.installed ?? adaptable?.declared?.match(/\d+\.\d+\.\d+[^\s]*/)?.[0];
+    const adaptableMajor = version ? Number(version.split('.')[0]) : undefined;
+    const framework = names.map((n) => FRAMEWORK_PACKAGES[n]).find(Boolean) ?? (adaptable ? 'vanilla' : undefined);
+    const agGridPeer = findInstalledPackageJson(projectPath, '@adaptabletools/adaptable')
+        ?.peerDependencies?.['ag-grid-enterprise'];
+    return {
+        projectPath,
+        hasPackageJson: !!pkg,
+        framework,
+        adaptable,
+        adaptableMajor: Number.isFinite(adaptableMajor) ? adaptableMajor : undefined,
+        adaptablePackages,
+        agGridPackages,
+        agGridPeer,
+    };
+}
+function parseVersion(version) {
+    const match = version.match(/(\d+)\.(\d+)\.(\d+)/);
+    return match ? match.slice(1).map(Number) : undefined;
+}
+function compare(a, b) {
+    for (let i = 0; i < 3; i++) {
+        if (a[i] !== b[i]) {
+            return a[i] - b[i];
+        }
+    }
+    return 0;
+}
+/**
+ * Enough of semver for AdapTable's peer ranges (`>=36.2.0`, `^36.2.0`,
+ * `~36.2.0`, exact, space-separated AND, `||`). Returns undefined when the
+ * range has a form this does not understand.
+ */
+export function satisfies(version, range) {
+    const v = parseVersion(version);
+    if (!v) {
+        return undefined;
+    }
+    const alternatives = range.split('||').map((alt) => alt.trim().split(/\s+/).filter(Boolean));
+    let understood = true;
+    const result = alternatives.some((comparators) => comparators.every((comparator) => {
+        const match = comparator.match(/^(>=|<=|>|<|\^|~|=)?v?(\d+\.\d+\.\d+)/);
+        if (!match) {
+            understood = false;
+            return false;
+        }
+        const target = parseVersion(match[2]);
+        const c = compare(v, target);
+        switch (match[1]) {
+            case '>=':
+                return c >= 0;
+            case '<=':
+                return c <= 0;
+            case '>':
+                return c > 0;
+            case '<':
+                return c < 0;
+            case '^':
+                return c >= 0 && v[0] === target[0];
+            case '~':
+                return c >= 0 && v[0] === target[0] && v[1] === target[1];
+            default:
+                return c === 0;
+        }
+    }));
+    return understood ? result : undefined;
+}
+export function getEnvironmentWarnings(env, pairings = []) {
+    const warnings = [];
+    if (!env.hasPackageJson) {
+        warnings.push(`No package.json found at or above ${env.projectPath}.`);
+        return warnings;
+    }
+    if (!env.adaptable) {
+        warnings.push('AdapTable is not installed in this project.');
+        return warnings;
+    }
+    if (!env.adaptable.installed) {
+        warnings.push('@adaptabletools/adaptable is declared but not installed; run your package manager install so checks can use the installed version.');
+    }
+    const enterprise = env.agGridPackages.find((p) => p.name === 'ag-grid-enterprise');
+    const community = env.agGridPackages.find((p) => p.name === 'ag-grid-community');
+    if (!enterprise) {
+        warnings.push(community
+            ? 'AdapTable requires ag-grid-enterprise; only ag-grid-community is declared.'
+            : 'AdapTable requires ag-grid-enterprise, which is not declared in package.json.');
+    }
+    const enterpriseVersion = enterprise?.installed;
+    if (enterpriseVersion && env.agGridPeer) {
+        const ok = satisfies(enterpriseVersion, env.agGridPeer);
+        if (ok === false) {
+            warnings.push(`ag-grid-enterprise ${enterpriseVersion} does not satisfy AdapTable's peer range ${env.agGridPeer}.`);
+        }
+    }
+    const agGridVersions = new Set(env.agGridPackages
+        .filter((p) => p.name !== 'ag-stack' && p.installed)
+        .map((p) => p.installed));
+    if (agGridVersions.size > 1) {
+        warnings.push(`AG Grid packages are on different versions (${[...agGridVersions].join(', ')}); keep them identical.`);
+    }
+    if (enterpriseVersion && env.adaptableMajor !== undefined) {
+        const pairing = pairings.find((p) => Number(p.adaptableVersion.split('.')[0]) === env.adaptableMajor);
+        const agGridMajor = Number(enterpriseVersion.split('.')[0]);
+        if (pairing && pairing.agGridMajor !== agGridMajor) {
+            warnings.push(`AdapTable ${env.adaptableMajor} is documented with AG Grid ${pairing.agGridMajor}; this project has AG Grid ${agGridMajor}.`);
+        }
+    }
+    const adaptableVersions = new Set(env.adaptablePackages.filter((p) => p.installed).map((p) => p.installed));
+    if (adaptableVersions.size > 1) {
+        warnings.push(`@adaptabletools/* packages are on different versions (${[...adaptableVersions].join(', ')}); keep them identical.`);
+    }
+    return warnings;
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

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

package/dist/index.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+const { version } = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+await createServer(version).connect(new StdioServerTransport());
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAC3C,CAAC;AAEzB,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC"}

package/dist/prompts.js

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+import { resolveEnvironment } from './context.js';
+import { loadCorpus } from './docs/source.js';
+const INSTALL_PAGES = {
+    vanilla: 'getting-started-installation',
+    react: 'react-installation',
+    angular: 'angular-installation',
+    vue: 'vue-installation',
+};
+const INTEGRATION_PAGES = {
+    vanilla: 'getting-started-integration',
+    react: 'react-integration',
+    angular: 'angular-integration',
+    vue: 'vue-integration',
+};
+const PLACEMENT = `Put each setting in the right place:
+- Adaptable Options: design-time configuration the user cannot change (primaryKey, licenseKey, adaptableId, module options such as layoutOptions, custom functions).
+- Initial State (\`initialState\` in Adaptable Options): objects the user can edit and that are persisted (Layouts, Calculated Columns, Format Columns, Alerts, Named Queries, ...). There is no PredefinedConfig.
+- Adaptable API: runtime changes from application code, after AdapTable is ready.`;
+const userMessage = (text) => ({
+    messages: [{ role: 'user', content: { type: 'text', text } }],
+});
+/** `version-240-release-note` is 24, `version-17-release-note` is 17 */
+const releaseNoteMajor = (routePath) => {
+    const match = routePath.match(/\/version-(\d+)-release-note$/);
+    if (!match) {
+        return undefined;
+    }
+    const n = Number(match[1]);
+    return n >= 100 ? Math.floor(n / 10) : n;
+};
+export function registerPrompts(server) {
+    server.registerPrompt('setup-adaptable', {
+        title: 'Set up AdapTable',
+        description: 'Add AdapTable to an AG Grid project: packages, CSS, AG Grid modules, minimal Adaptable Options and one Layout',
+        argsSchema: {
+            framework: z.string().optional().describe('vanilla, react, angular or vue; defaults to the detected framework'),
+        },
+    }, async ({ framework: requested }) => {
+        const env = await resolveEnvironment(server);
+        const framework = requested && INSTALL_PAGES[requested] ? requested : (env.framework ?? 'vanilla');
+        return userMessage(`Set up AdapTable (${framework}) in this project.
+
+1. Call detect_environment and fix any warnings it reports (AdapTable needs ag-grid-enterprise, at the documented AG Grid version).
+2. Read get_doc("${INSTALL_PAGES[framework]}") and get_doc("${INTEGRATION_PAGES[framework]}"), then get_doc("getting-started-aggrid-modules") and get_doc("getting-started-license-key"). Follow them exactly for packages, CSS imports and AG Grid modules; do not rely on memory, older versions differ.
+3. Write minimal Adaptable Options: primaryKey (a unique column), adaptableId, licenseKey, and an initialState with one Table Layout listing the grid's columns in TableColumns.
+4. ${PLACEMENT}
+5. Run check_state on the initialState, passing the columns from columnDefs, and fix every error.
+6. For AG Grid itself (columnDefs, AG Grid modules, row models, grid options) use the ag-mcp server.
+
+Cite the docs URLs you used.`);
+    });
+    server.registerPrompt('upgrade-adaptable', {
+        title: 'Upgrade AdapTable',
+        description: 'Upgrade a project to a newer AdapTable major version: release-note breaking changes, state and expression migration',
+        argsSchema: {
+            from: z.string().describe('Current AdapTable major version, e.g. 22'),
+            to: z.string().optional().describe('Target major version; defaults to the latest documented one'),
+        },
+    }, async ({ from, to }) => {
+        const env = await resolveEnvironment(server);
+        const corpus = await loadCorpus(undefined);
+        const fromMajor = Number.parseInt(from, 10);
+        const toMajor = to ? Number.parseInt(to, 10) : corpus.manifest.major;
+        const notes = [...corpus.pages.keys()]
+            .map((routePath) => ({ routePath, major: releaseNoteMajor(routePath) }))
+            .filter(({ major }) => major !== undefined && major > fromMajor && major <= toMajor)
+            .sort((a, b) => a.routePath.localeCompare(b.routePath, 'en', { numeric: true }))
+            .map(({ routePath }) => `- get_doc("${routePath.replace('/support/', '')}")`);
+        const installed = env.adaptableMajor;
+        return userMessage(`Upgrade AdapTable in this project from version ${fromMajor} to ${toMajor}.
+
+1. Call detect_environment. ${installed === toMajor ? `AdapTable ${toMajor} is installed.` : `Then update every @adaptabletools/* package to ${toMajor} (all to the same version), and AG Grid to the version get_doc("release-schedule") pairs with AdapTable ${toMajor}; install, and call detect_environment again.`}
+2. Read the release note of every version in between and apply each breaking change that affects this code (renamed or removed options, API changes, state shape changes):
+${notes.length ? notes.join('\n') : '- (no release notes found in the docs for this range)'}
+3. Find every Initial State object (\`initialState\`) in the code. For each, call migrate_state with fromVersion ${fromMajor}, replace it with the migrated result (keep code that cannot be JSON, such as functions, by hand), then run check_state with the grid's columns and fix every error.
+4. Find every AdapTableQL expression outside state (e.g. strings passed to the Adaptable API) and run migrate_expression, then check_expression.
+5. Search the code for options the release notes rename or remove; use search_docs to find their current place.
+6. Build and type-check the project; fix what the compiler reports.
+
+Summarise the changes, with the release-note URLs that required them.`);
+    });
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

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

package/dist/resources.js

@@ -0,0 +1,59 @@
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { loadEntry } from './adaptable/loadEntry.js';
+import { resolveEnvironment, resolveProjectPath } from './context.js';
+import { filterFramework } from './docs/corpus.js';
+import { loadCorpus } from './docs/source.js';
+import { findPage } from './tools/docs.js';
+const single = (value) => (Array.isArray(value) ? value[0] : value);
+export function registerResources(server) {
+    const readPage = async (uri, major, routePath) => {
+        const corpus = await loadCorpus(Number(major) || undefined);
+        if (corpus.manifest.major !== Number(major)) {
+            throw new Error(`Docs for AdapTable ${major} are not available (found ${corpus.manifest.major} at ${corpus.origin}).`);
+        }
+        const page = findPage(corpus, routePath);
+        if (!page) {
+            throw new Error(`No docs page ${routePath}`);
+        }
+        const env = await resolveEnvironment(server);
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: 'text/markdown',
+                    text: filterFramework(page.markdown, env.framework),
+                },
+            ],
+        };
+    };
+    server.registerResource('docs-page', new ResourceTemplate('adaptable://docs/{major}/{slug}', { list: undefined }), {
+        title: 'AdapTable docs page',
+        description: 'Markdown of a docs page, e.g. adaptable://docs/24/handbook-layouts; sections for other frameworks are removed',
+        mimeType: 'text/markdown',
+    }, (uri, { major, slug }) => readPage(uri, single(major), `/docs/${single(slug)}`));
+    server.registerResource('api-reference', new ResourceTemplate('adaptable://api/{major}/{typeName}', { list: undefined }), {
+        title: 'AdapTable API reference',
+        description: 'Reference page of an AdapTable type, e.g. adaptable://api/24/LayoutApi',
+        mimeType: 'text/markdown',
+    }, (uri, { major, typeName }) => readPage(uri, single(major), `/docs/reference/${single(typeName).toLowerCase()}`));
+    server.registerResource('aql-functions', 'adaptable://aql/functions', {
+        title: 'AdapTableQL functions',
+        description: 'Every built-in AdapTableQL function, aggregation, observable function and clause of the installed AdapTable version (JSON)',
+        mimeType: 'application/json',
+    }, async (uri) => {
+        const loaded = await loadEntry(await resolveProjectPath(server), 'aql');
+        if (!loaded.ok) {
+            throw new Error(loaded.reason);
+        }
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(loaded.module.getExpressionFunctionCatalogue(), null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

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

package/dist/server.js

@@ -0,0 +1,23 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerPrompts } from './prompts.js';
+import { registerResources } from './resources.js';
+import { registerCheckTools } from './tools/checks.js';
+import { registerDocsTools } from './tools/docs.js';
+import { registerEnvironmentTools } from './tools/environment.js';
+export const SERVER_INSTRUCTIONS = `AdapTable is an AG Grid Enterprise extension. Its APIs, state shapes and AdapTableQL syntax change between major versions, and older material (including your training data) is often wrong for the version a project uses.
+
+- Call detect_environment first; every other tool uses the version and framework it finds.
+- Look things up with search_docs / get_doc before writing AdapTable config; cite the URLs.
+- Run check_expression (passing the module the expression is used in) on every AdapTableQL expression and check_state on Initial State before presenting them; fix every error.
+- For upgrades, use migrate_state and migrate_expression rather than rewriting by hand.
+- AdapTable questions belong here; AG Grid questions (columnDefs, AG Grid modules, row models, grid API) belong to AG Grid's ag-mcp.`;
+export function createServer(version) {
+    const server = new McpServer({ name: 'adaptable-mcp', version }, { instructions: SERVER_INSTRUCTIONS });
+    registerEnvironmentTools(server);
+    registerDocsTools(server);
+    registerCheckTools(server);
+    registerResources(server);
+    registerPrompts(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;qIAMkG,CAAC;AAEtI,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,EAClC,EAAE,YAAY,EAAE,mBAAmB,EAAE,CACtC,CAAC;IACF,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,eAAe,CAAC,MAAM,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/checks.js

@@ -0,0 +1,250 @@
+import { z } from 'zod';
+import { loadEntry } from '../adaptable/loadEntry.js';
+import { EXPRESSION_MODULES, } from '../adaptable/types.js';
+import { checkStateRules, collectExpressions, getStateColumnIds, } from '../checks/stateRules.js';
+import { typeCheckState, unexplainedTypeIssues } from '../checks/stateTypes.js';
+import { resolveProjectPath } from '../context.js';
+const KIND = z
+    .enum(['boolean', 'scalar', 'aggregatedScalar', 'aggregatedBoolean'])
+    .describe('boolean: filters, rules, boolean Named Queries, Relative Change (ANY_CHANGE()) and boolean Observable rules (CHANGE_COUNT{...} >= n); scalar: Calculated Columns and Named Queries returning a value, Observable values (MAX{[x], WITHIN(1d)}); aggregatedScalar: Calculated Columns with SUM{...}, Cumulative, Quantile or Window (LAG, RANK) expressions; aggregatedBoolean: Alert rules with aggregation (SUM{[x]} > n)');
+const MODULE = z
+    .enum(EXPRESSION_MODULES)
+    .optional()
+    .describe("Module the expression is used in. Pass it: Observable functions, Relative Change functions, Cumulative / Window functions and aggregations are only available in some Modules");
+const COLUMNS = z
+    .array(z.object({ id: z.string(), dataType: z.string().optional() }))
+    .optional()
+    .describe("Grid columns from columnDefs (colId or field), with AdapTable data types (text, number, boolean, date, textArray, numberArray, ...); enables column checks");
+const STATE = z
+    .union([z.string(), z.record(z.string(), z.unknown())])
+    .describe('Initial State as a JSON object or JSON string (convert TypeScript object literals to JSON)');
+const CUSTOM_NOTE = 'Custom expression functions, custom aggregations and Named Queries from AdaptableOptions / state are not known to this check; issues about those names can be ignored.';
+const text = (value) => ({ content: [{ type: 'text', text: value }] });
+const failure = (value) => ({ ...text(value), isError: true });
+function formatIssue(expression, issue) {
+    let line = `- ${issue.severity}${issue.code ? ` ${issue.code}` : ''}: ${issue.message}`;
+    if (issue.range) {
+        line += ` (at ${issue.range[0]}-${issue.range[1]}: \`${expression.slice(issue.range[0], issue.range[1])}\`)`;
+    }
+    if (issue.quickFix) {
+        line += `\n  fix: ${issue.quickFix.label} -> \`${issue.quickFix.replacement}\``;
+    }
+    return line;
+}
+function summarize(lines, clean) {
+    const count = (severity) => lines.filter((l) => new RegExp(`^\\s*- ${severity}\\b`).test(l)).length;
+    const errors = count('error');
+    const warnings = count('warning');
+    if (!errors && !warnings) {
+        return clean;
+    }
+    return `${errors} error(s), ${warnings} warning(s)${errors ? '; fix the errors' : ''}:`;
+}
+const toColumnTypes = (columns) => columns ? Object.fromEntries(columns.map((c) => [c.id, c.dataType])) : undefined;
+function parseState(state) {
+    if (typeof state !== 'string') {
+        return state;
+    }
+    try {
+        const parsed = JSON.parse(state);
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+            ? parsed
+            : 'State must be a JSON object.';
+    }
+    catch (error) {
+        return `State is not valid JSON (${error instanceof Error ? error.message : String(error)}). Convert the TypeScript object literal to JSON: quote keys, no comments, no trailing commas, no functions.`;
+    }
+}
+async function getAql(projectPath) {
+    return loadEntry(await projectPath, 'aql');
+}
+function checkOne(aql, expression, kind, module, columns) {
+    const result = aql.validateExpression(expression, { kind, module, columns });
+    const lines = result.issues.map((issue) => formatIssue(expression, issue));
+    if (!result.isValid) {
+        const migrated = aql.migrateExpression(expression, { kind });
+        if (!migrated.error && migrated.changed) {
+            const recheck = aql.validateExpression(migrated.expression, { kind, module, columns });
+            const errorCount = (issues) => issues.filter((issue) => issue.severity === 'error').length;
+            if (errorCount(recheck.issues) < errorCount(result.issues)) {
+                lines.push(`  This is pre-v24 syntax. v24 form: \`${migrated.expression}\`${recheck.isValid ? ' (valid)' : ' (still has issues)'}`);
+            }
+        }
+    }
+    return lines;
+}
+export function registerCheckTools(server) {
+    server.registerTool('check_expression', {
+        title: 'Check an AdapTableQL expression',
+        description: "Validates an AdapTableQL expression with the AdapTable version installed in the project: syntax, known functions, argument types, aggregation rules, (with module) the functions that Module offers, and (with columns) column references and data types. Returns issues with positions and quick fixes; pre-v24 syntax gets the v24 rewrite. Run it on every expression before presenting config.",
+        inputSchema: {
+            expression: z.string(),
+            kind: KIND,
+            module: MODULE,
+            columns: COLUMNS,
+            projectPath: z.string().optional(),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ expression, kind, module, columns, projectPath }) => {
+        const loaded = await getAql(resolveProjectPath(server, projectPath));
+        if (!loaded.ok) {
+            return failure(loaded.reason);
+        }
+        const lines = checkOne(loaded.module, expression, kind, module, toColumnTypes(columns));
+        return text([
+            summarize(lines, 'Expression is valid.'),
+            ...lines,
+            '',
+            CUSTOM_NOTE,
+        ].join('\n'));
+    });
+    server.registerTool('migrate_expression', {
+        title: 'Migrate an AdapTableQL expression to v24',
+        description: 'Rewrites a pre-v24 AdapTableQL expression (legacy function spellings, paren-form aggregations such as SUM([x]), old clauses) into v24 syntax, using the installed AdapTable version.',
+        inputSchema: { expression: z.string(), kind: KIND.optional(), projectPath: z.string().optional() },
+        annotations: { readOnlyHint: true },
+    }, async ({ expression, kind, projectPath }) => {
+        const loaded = await getAql(resolveProjectPath(server, projectPath));
+        if (!loaded.ok) {
+            return failure(loaded.reason);
+        }
+        const result = loaded.module.migrateExpression(expression, { kind });
+        if (result.error) {
+            return failure(`Could not migrate: ${result.error}`);
+        }
+        const notes = result.notes?.length
+            ? `\n\nThe rewrite changes behaviour; tell the user:\n${result.notes.map((n) => `- ${n}`).join('\n')}`
+            : '';
+        return text(result.changed
+            ? `v24 form:\n${result.expression}${notes}`
+            : `Already v24 syntax; no changes:\n${result.expression}`);
+    });
+    server.registerTool('list_expression_functions', {
+        title: 'List AdapTableQL functions',
+        description: 'Built-in AdapTableQL functions, aggregations, observable functions and clauses of the installed AdapTable version, with signatures and examples. Filter by group or by text.',
+        inputSchema: {
+            group: z.enum(['scalar', 'aggregation', 'observable', 'clause']).optional(),
+            query: z.string().optional().describe('Case-insensitive match on name, description or category'),
+            projectPath: z.string().optional(),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ group, query, projectPath }) => {
+        const loaded = await getAql(resolveProjectPath(server, projectPath));
+        if (!loaded.ok) {
+            return failure(loaded.reason);
+        }
+        const needle = query?.toLowerCase();
+        const entries = loaded.module
+            .getExpressionFunctionCatalogue()
+            .filter((f) => !group || f.group === group)
+            .filter((f) => !needle ||
+            [f.name, f.description, f.category].some((v) => v?.toLowerCase().includes(needle)));
+        if (!entries.length) {
+            return text('No matching functions.');
+        }
+        return text(entries
+            .map((f) => [
+            `## ${f.name} (${f.group}${f.category ? `, ${f.category}` : ''}${f.returnType ? ` -> ${f.returnType}` : ''})`,
+            f.description,
+            ...f.signatures.map((s) => `- \`${s}\``),
+            ...f.examples.slice(0, 2).map((e) => `- e.g. \`${e}\``),
+        ]
+            .filter(Boolean)
+            .join('\n'))
+            .join('\n\n'));
+    });
+    server.registerTool('check_state', {
+        title: 'Check AdapTable Initial State',
+        description: "Checks an Initial State object: type-checks it against InitialState from the installed AdapTable (wrong or missing properties, pre-v24 shapes), plus semantic checks TypeScript cannot catch: unknown sections (e.g. PredefinedConfig), unique Layout names, CurrentLayout present, Table vs Pivot Layout properties, Width xor Flex, column references (with columns), and every embedded AdapTableQL expression validated as check_expression would.",
+        inputSchema: { state: STATE, columns: COLUMNS, projectPath: z.string().optional() },
+        annotations: { readOnlyHint: true },
+    }, async ({ state, columns, projectPath }) => {
+        const parsed = parseState(state);
+        if (typeof parsed === 'string') {
+            return failure(parsed);
+        }
+        const loaded = await getAql(resolveProjectPath(server, projectPath));
+        const aggregations = new Map(loaded.ok
+            ? loaded.module
+                .getExpressionFunctionCatalogue()
+                .filter((f) => f.group === 'aggregation')
+                .map((f) => [f.name.toUpperCase(), f.callForm])
+            : []);
+        const ruleIssues = checkStateRules(parsed, { columnIds: columns?.map((c) => c.id) });
+        const typed = await typeCheckState(await resolveProjectPath(server, projectPath), parsed);
+        const typeIssues = typed.ok ? unexplainedTypeIssues(typed.issues, ruleIssues) : [];
+        const lines = [
+            ...ruleIssues.map((issue) => `- ${issue.severity} at ${issue.path || '(root)'}: ${issue.message}`),
+            ...typeIssues.map((issue) => `- ${issue.severity} at ${issue.path || '(root)'}: (types) ${issue.message}`),
+        ];
+        if (!typed.ok) {
+            lines.push(`- warning: types not checked: ${typed.reason}`);
+        }
+        const expressions = collectExpressions(parsed, aggregations);
+        if (loaded.ok) {
+            const columnTypes = columns
+                ? { ...Object.fromEntries(getStateColumnIds(parsed)), ...toColumnTypes(columns) }
+                : undefined;
+            for (const { path, expression, kind, module } of expressions) {
+                const issues = checkOne(loaded.module, expression, kind, module, columnTypes);
+                if (issues.length) {
+                    lines.push(`- expression at ${path} (${module}, ${kind}): \`${expression}\``, ...issues.map((l) => `  ${l}`));
+                }
+            }
+        }
+        else {
+            lines.push(`- warning: expressions not checked: ${loaded.reason}`);
+        }
+        return text([
+            summarize(lines, 'No problems found.'),
+            ...lines,
+            '',
+            `Checked ${expressions.length} expression(s)${typed.ok ? ` and the state's types (against ${typed.source})` : ''}. ${CUSTOM_NOTE}`,
+        ].join('\n'));
+    });
+    server.registerTool('migrate_state', {
+        title: 'Migrate AdapTable state to the installed version',
+        description: "Upgrades an Initial State (or persisted state) object from an older AdapTable major version using AdaptableUpgradeHelper.migrateAdaptableState from the installed package — the same migration AdapTable runs at startup. Install the target AdapTable version first. Returns the migrated JSON and the migration log; run check_state on the result.",
+        inputSchema: {
+            state: STATE,
+            fromVersion: z.number().int().describe('AdapTable major version the state was written for, e.g. 22'),
+            toVersion: z.number().int().optional().describe('Defaults to the installed major version'),
+            projectPath: z.string().optional(),
+        },
+        annotations: { readOnlyHint: true },
+    }, async ({ state, fromVersion, toVersion, projectPath }) => {
+        const parsed = parseState(state);
+        if (typeof parsed === 'string') {
+            return failure(parsed);
+        }
+        const loaded = await loadEntry(await resolveProjectPath(server, projectPath), 'upgrade');
+        if (!loaded.ok) {
+            return failure(loaded.reason);
+        }
+        const helper = loaded.module.AdaptableUpgradeHelper;
+        const target = toVersion ?? helper.getCurrentMajorVersion();
+        if (fromVersion >= target) {
+            return failure(`fromVersion (${fromVersion}) must be lower than the target version (${target}).`);
+        }
+        const log = [];
+        const record = (level) => (message) => log.push(`- ${level}: ${message}`);
+        const logger = {
+            success: record('success'),
+            info: record('info'),
+            warn: record('warning'),
+            error: record('error'),
+        };
+        const migrated = helper.migrateAdaptableState(parsed, { fromVersion, toVersion: target, logger });
+        return text([
+            `Migrated from ${fromVersion} to ${target}.`,
+            '',
+            'Migration log:',
+            ...(log.length ? log : ['- (no messages)']),
+            '',
+            '```json',
+            JSON.stringify(migrated, null, 2),
+            '```',
+        ].join('\n'));
+    });
+}
+//# sourceMappingURL=checks.js.map