@celljs/cli 3.8.0 → 4.0.0

package/lib/mcp/mcp-server.js

@@ -0,0 +1,201 @@
+import { CellError } from '@celljs/kit';
+import { Reporter } from '../cli/reporter.js';
+import { TextUtil } from '../utils/text-util.js';
+class RpcError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.code = code;
+        this.data = data;
+    }
+}
+/**
+ * The protocol side of an MCP server (JSON-RPC 2.0, tools only), without a transport: `cell mcp`
+ * feeds it lines from stdin, `cell dev` the bodies of POST /_cell/mcp. Tool calls run one at a time;
+ * a failing tool answers with `isError` and the CellError as JSON (docs/design/agent-first.md R5, R8).
+ */
+export class McpServer {
+    options;
+    static PROTOCOL_VERSIONS = ['2025-11-25', '2025-06-18', '2025-03-26', '2024-11-05'];
+    static PARSE_ERROR = -32700;
+    static INVALID_REQUEST = -32600;
+    static METHOD_NOT_FOUND = -32601;
+    static INVALID_PARAMS = -32602;
+    queue = Promise.resolve();
+    constructor(options) {
+        this.options = options;
+    }
+    /** Handles one line or body of JSON; returns the response text, or undefined for a notification. */
+    async handleText(text) {
+        let message;
+        try {
+            message = JSON.parse(text);
+        }
+        catch {
+            return JSON.stringify(McpServer.error(null, new RpcError(McpServer.PARSE_ERROR, 'Parse error: the message is not JSON.')));
+        }
+        const response = await this.handle(message);
+        return response && JSON.stringify(response);
+    }
+    async handle(message) {
+        const request = message;
+        if (typeof request !== 'object' || request === null || Array.isArray(request) || request.jsonrpc !== '2.0' || typeof request.method !== 'string') {
+            // A response from the client (to a request this server never sends) is not an error.
+            if (typeof request === 'object' && request !== null && 'id' in request && ('result' in request || 'error' in request)) {
+                return undefined;
+            }
+            return McpServer.error(null, new RpcError(McpServer.INVALID_REQUEST, 'Invalid request: expected a JSON-RPC 2.0 object with a method.'));
+        }
+        const notification = !('id' in request);
+        try {
+            const result = await this.dispatch(request.method, request.params ?? {});
+            return notification ? undefined : { jsonrpc: '2.0', id: request.id ?? null, result };
+        }
+        catch (error) {
+            return notification ? undefined : McpServer.error(request.id ?? null, error);
+        }
+    }
+    async dispatch(method, params) {
+        switch (method) {
+            case 'initialize': {
+                const requested = params.protocolVersion;
+                return {
+                    protocolVersion: McpServer.PROTOCOL_VERSIONS.includes(requested) ? requested : McpServer.PROTOCOL_VERSIONS[0],
+                    capabilities: { tools: { listChanged: false } },
+                    serverInfo: { name: this.options.name, version: this.options.version },
+                    ...(this.options.instructions ? { instructions: this.options.instructions } : {}),
+                };
+            }
+            case 'ping':
+                return {};
+            case 'tools/list':
+                return { tools: (await this.options.tools()).map(tool => McpServer.describe(tool)) };
+            case 'tools/call':
+                return this.serialize(() => this.call(params.name, params.arguments));
+            default:
+                if (method.startsWith('notifications/')) {
+                    return {};
+                }
+                throw new RpcError(McpServer.METHOD_NOT_FOUND, `Method not found: ${method}`);
+        }
+    }
+    serialize(task) {
+        const run = this.queue.then(task, task);
+        this.queue = run.catch(() => undefined);
+        return run;
+    }
+    async call(name, args = {}) {
+        const tools = await this.options.tools();
+        const tool = tools.find(t => t.name === name);
+        if (!tool) {
+            const suggestion = typeof name === 'string'
+                ? TextUtil.closest(name, tools.map(t => t.name))
+                : undefined;
+            throw new RpcError(McpServer.INVALID_PARAMS, `Unknown tool '${String(name)}'.${suggestion ? ` Did you mean '${suggestion}'?` : ` Tools: ${tools.map(t => t.name).join(', ')}.`}`);
+        }
+        if (typeof args !== 'object' || args === null || Array.isArray(args)) {
+            throw new RpcError(McpServer.INVALID_PARAMS, `The arguments of '${tool.name}' must be an object.`);
+        }
+        const problem = McpServer.validate(tool.inputSchema, args);
+        if (problem) {
+            return McpServer.result(new CellError({
+                code: 'CELL_ARGUMENT_INVALID',
+                message: `Invalid arguments for '${tool.name}': ${problem}`,
+                hint: 'Call tools/list for the input schema.',
+            }).toJSON(), true);
+        }
+        try {
+            return McpServer.result(await tool.run(args), false);
+        }
+        catch (error) {
+            return McpServer.result(Reporter.toCellError(error).toJSON(), true);
+        }
+    }
+    static describe(tool) {
+        return {
+            name: tool.name,
+            description: tool.description,
+            inputSchema: { type: 'object', ...tool.inputSchema },
+            annotations: { readOnlyHint: tool.readOnly, destructiveHint: false, openWorldHint: tool.network ?? false },
+        };
+    }
+    /** Text for every client; objects also as structured content. */
+    static result(value, isError) {
+        const text = typeof value === 'string' ? value : (JSON.stringify(value) ?? 'null');
+        const structured = typeof value === 'object' && value !== null && !Array.isArray(value);
+        return { content: [{ type: 'text', text }], ...(structured ? { structuredContent: value } : {}), isError };
+    }
+    /**
+     * Checks the arguments against the top level of the tool's JSON Schema: required properties, the
+     * type of each property (and of array items), enums, and unknown properties when
+     * `additionalProperties` is false. Returns the first problem, or undefined.
+     */
+    static validate(schema, args) {
+        const properties = (schema.properties ?? {});
+        for (const key of (schema.required ?? [])) {
+            if (args[key] === undefined) {
+                return `'${key}' is required.`;
+            }
+        }
+        for (const [key, value] of Object.entries(args)) {
+            const property = properties[key];
+            if (!property) {
+                if (schema.additionalProperties === false) {
+                    const suggestion = TextUtil.closest(key, Object.keys(properties));
+                    return `unknown property '${key}'.${suggestion ? ` Did you mean '${suggestion}'?` : ` Properties: ${Object.keys(properties).join(', ') || 'none'}.`}`;
+                }
+                continue;
+            }
+            const problem = McpServer.checkValue(value, property);
+            if (problem) {
+                return `'${key}' ${problem}`;
+            }
+        }
+        return undefined;
+    }
+    static checkValue(value, schema) {
+        const type = schema.type;
+        if (type && !McpServer.hasType(value, type)) {
+            return `must be ${type === 'array' || type === 'object' || type === 'integer' ? 'an' : 'a'} ${type}.`;
+        }
+        if (Array.isArray(schema.enum) && !schema.enum.includes(value)) {
+            return `must be one of: ${schema.enum.map(v => JSON.stringify(v)).join(', ')}.`;
+        }
+        if (type === 'array' && schema.items && Array.isArray(value)) {
+            for (const item of value) {
+                const problem = McpServer.checkValue(item, schema.items);
+                if (problem) {
+                    return `items ${problem}`;
+                }
+            }
+        }
+        return undefined;
+    }
+    static hasType(value, type) {
+        switch (type) {
+            case 'string':
+                return typeof value === 'string';
+            case 'boolean':
+                return typeof value === 'boolean';
+            case 'number':
+                return typeof value === 'number' && Number.isFinite(value);
+            case 'integer':
+                return Number.isInteger(value);
+            case 'array':
+                return Array.isArray(value);
+            case 'object':
+                return typeof value === 'object' && value !== null && !Array.isArray(value);
+            default:
+                return true;
+        }
+    }
+    static error(id, error) {
+        if (error instanceof RpcError) {
+            return { jsonrpc: '2.0', id, error: { code: error.code, message: error.message, ...(error.data === undefined ? {} : { data: error.data }) } };
+        }
+        const cellError = Reporter.toCellError(error);
+        return { jsonrpc: '2.0', id, error: { code: -32603, message: cellError.message, data: cellError.toJSON() } };
+    }
+}
+//# sourceMappingURL=mcp-server.js.map

package/lib/mcp/mcp-server.js.map

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

package/lib/mcp/mcp-server.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-server.spec.d.ts.map

package/lib/mcp/mcp-server.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.spec.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-server.spec.ts"],"names":[],"mappings":""}

package/lib/mcp/mcp-server.spec.js

@@ -0,0 +1,136 @@
+import { describe, expect, it } from 'bun:test';
+import { CellError } from '@celljs/kit';
+import { McpServer } from './mcp-server.js';
+const echo = {
+    name: 'echo',
+    description: 'echoes',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            text: { type: 'string' },
+            times: { type: 'integer' },
+            tags: { type: 'array', items: { type: 'string' } },
+            level: { type: 'string', enum: ['a', 'b'] },
+        },
+        required: ['text'],
+        additionalProperties: false,
+    },
+    readOnly: true,
+    run: input => ({ text: input.text }),
+};
+function server(tools = [echo]) {
+    return new McpServer({ name: 'test', version: '1.0.0', instructions: 'hi', tools: () => tools });
+}
+async function call(s, name, args) {
+    const response = await s.handle({ jsonrpc: '2.0', id: 1, method: 'tools/call', params: { name, arguments: args } });
+    return response?.result;
+}
+describe('McpServer', () => {
+    it('negotiates the protocol version on initialize and describes itself', async () => {
+        const s = server();
+        const known = await s.handle({ jsonrpc: '2.0', id: 1, method: 'initialize', params: { protocolVersion: '2025-03-26' } });
+        expect(known).toEqual({
+            jsonrpc: '2.0',
+            id: 1,
+            result: {
+                protocolVersion: '2025-03-26',
+                capabilities: { tools: { listChanged: false } },
+                serverInfo: { name: 'test', version: '1.0.0' },
+                instructions: 'hi',
+            },
+        });
+        const unknown = await s.handle({ jsonrpc: '2.0', id: 2, method: 'initialize', params: { protocolVersion: '1999-01-01' } });
+        expect((unknown?.result).protocolVersion).toBe(McpServer.PROTOCOL_VERSIONS[0]);
+    });
+    it('answers ping, ignores notifications and client responses, and rejects unknown methods', async () => {
+        const s = server();
+        expect(await s.handle({ jsonrpc: '2.0', id: 'a', method: 'ping' })).toEqual({ jsonrpc: '2.0', id: 'a', result: {} });
+        expect(await s.handle({ jsonrpc: '2.0', method: 'notifications/initialized' })).toBeUndefined();
+        expect(await s.handle({ jsonrpc: '2.0', method: 'nope' })).toBeUndefined();
+        expect(await s.handle({ jsonrpc: '2.0', id: 3, result: {} })).toBeUndefined();
+        expect((await s.handle({ jsonrpc: '2.0', id: 4, method: 'resources/list' }))?.error).toEqual({
+            code: -32601,
+            message: 'Method not found: resources/list',
+        });
+    });
+    it('reports messages that are not JSON or not JSON-RPC', async () => {
+        const s = server();
+        expect(JSON.parse((await s.handleText('{')))).toMatchObject({ id: null, error: { code: -32700 } });
+        expect(JSON.parse((await s.handleText('[1]')))).toMatchObject({ id: null, error: { code: -32600 } });
+        expect(await s.handleText('{"jsonrpc":"2.0","method":"notifications/x"}')).toBeUndefined();
+    });
+    it('lists tools with their schema and read-only / network annotations', async () => {
+        const s = server([echo, { ...echo, name: 'fetch', inputSchema: {}, readOnly: false, network: true }]);
+        const { tools } = (await s.handle({ jsonrpc: '2.0', id: 1, method: 'tools/list' }))?.result;
+        expect(tools[0]).toEqual({
+            name: 'echo',
+            description: 'echoes',
+            inputSchema: echo.inputSchema,
+            annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        });
+        expect(tools[1]).toMatchObject({ inputSchema: { type: 'object' }, annotations: { readOnlyHint: false, openWorldHint: true } });
+    });
+    it('returns objects as JSON text and structured content, other values as text', async () => {
+        const s = server([echo, { ...echo, name: 'list', inputSchema: {}, run: () => [1, 2] }, { ...echo, name: 'say', inputSchema: {}, run: () => 'hello' }]);
+        expect(await call(s, 'echo', { text: 'x' })).toEqual({
+            content: [{ type: 'text', text: '{"text":"x"}' }],
+            structuredContent: { text: 'x' },
+            isError: false,
+        });
+        expect(await call(s, 'list', {})).toEqual({ content: [{ type: 'text', text: '[1,2]' }], isError: false });
+        expect((await call(s, 'say', {})).content[0].text).toBe('hello');
+    });
+    it('rejects unknown tools with a suggestion', async () => {
+        const response = await server().handle({ jsonrpc: '2.0', id: 1, method: 'tools/call', params: { name: 'ecoh', arguments: {} } });
+        expect(response?.error).toEqual({ code: -32602, message: "Unknown tool 'ecoh'. Did you mean 'echo'?" });
+    });
+    it('validates arguments against the input schema and answers with a CellError', async () => {
+        const s = server();
+        const problem = async (args) => {
+            const result = await call(s, 'echo', args);
+            expect(result.isError).toBe(true);
+            expect(result.structuredContent?.code).toBe('CELL_ARGUMENT_INVALID');
+            return result.structuredContent?.message;
+        };
+        expect(await problem({})).toBe("Invalid arguments for 'echo': 'text' is required.");
+        expect(await problem({ text: 1 })).toBe("Invalid arguments for 'echo': 'text' must be a string.");
+        expect(await problem({ text: 'x', times: 1.5 })).toBe("Invalid arguments for 'echo': 'times' must be an integer.");
+        expect(await problem({ text: 'x', tags: ['a', 2] })).toBe("Invalid arguments for 'echo': 'tags' items must be a string.");
+        expect(await problem({ text: 'x', level: 'c' })).toBe('Invalid arguments for \'echo\': \'level\' must be one of: "a", "b".');
+        expect(await problem({ text: 'x', tmes: 2 })).toBe("Invalid arguments for 'echo': unknown property 'tmes'. Did you mean 'times'?");
+        const response = await s.handle({ jsonrpc: '2.0', id: 1, method: 'tools/call', params: { name: 'echo', arguments: [] } });
+        expect(response?.error?.code).toBe(-32602);
+    });
+    it('turns a failing tool into isError with the CellError, and other errors into CELL_INTERNAL_ERROR', async () => {
+        const failing = (error) => ({
+            ...echo,
+            name: 'fail',
+            inputSchema: {},
+            run: () => {
+                throw error;
+            },
+        });
+        const cellError = await call(server([failing(new CellError({ code: 'CELL_X', message: 'broken', hint: 'fix it' }))]), 'fail', {});
+        expect(cellError).toMatchObject({ isError: true, structuredContent: { code: 'CELL_X', message: 'broken', hint: 'fix it' } });
+        const internal = await call(server([failing(new TypeError('oops'))]), 'fail', {});
+        expect(internal.structuredContent).toMatchObject({ code: 'CELL_INTERNAL_ERROR', message: 'oops' });
+    });
+    it('runs tool calls one at a time', async () => {
+        const order = [];
+        const slow = {
+            ...echo,
+            name: 'slow',
+            inputSchema: {},
+            run: async (input) => {
+                order.push(`start ${input.id}`);
+                await new Promise(resolve => setTimeout(resolve, 20));
+                order.push(`end ${input.id}`);
+                return {};
+            },
+        };
+        const s = server([slow]);
+        await Promise.all([call(s, 'slow', { id: 1 }), call(s, 'slow', { id: 2 })]);
+        expect(order).toEqual(['start 1', 'end 1', 'start 2', 'end 2']);
+    });
+});
+//# sourceMappingURL=mcp-server.spec.js.map

package/lib/mcp/mcp-server.spec.js.map

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

package/lib/mcp/project-mcp-tools.d.ts

@@ -0,0 +1,35 @@
+import { type McpToolDefinition } from '@celljs/kit';
+import { Toolchain } from '../toolchain/toolchain.js';
+/** Runs `cell <argv>` in this process and returns what it printed. */
+export type CellRunner = (argv: string[]) => Promise<{
+    code: number;
+    stdout: string;
+}>;
+/**
+ * The tools of `cell mcp` (docs/design/agent-first.md R8): `info`, `check`, `config_get`,
+ * `docs_search`, `build` and `deploy_plan` (`cell deploy --dry-run`) run the commands with `--json`
+ * and return their result, so the two interfaces never disagree. Deploying is not a tool. Tools of toolchain modules (`cell.addMcpTool`)
+ * follow; the toolchain is loaded again when cell.config.*, package.json or a module file changes.
+ */
+export declare class ProjectMcpTools {
+    protected readonly root: string;
+    protected readonly run: CellRunner;
+    protected readonly env: NodeJS.ProcessEnv;
+    protected readonly log: (message: string) => void;
+    protected toolchain?: Toolchain;
+    protected fingerprint: string;
+    protected moduleTools: McpToolDefinition[];
+    constructor(root: string, run: CellRunner, env: NodeJS.ProcessEnv, log: (message: string) => void);
+    tools(): Promise<McpToolDefinition[]>;
+    close(): Promise<void>;
+    protected builtin(): McpToolDefinition[];
+    /** Arguments as flags: arrays repeat, `true` is a bare flag, `false` and positional keys are left out. */
+    static flags(input: Record<string, unknown>, names?: Record<string, string>, skip?: string[]): string[];
+    /** Runs the command with `--json` and returns its result; a failure becomes the CellError it reported. */
+    protected cell(argv: string[], success?: number[]): Promise<Record<string, unknown>>;
+    /** Tools of toolchain modules, from a toolchain loaded again when one of its files changed. */
+    protected modules(): Promise<McpToolDefinition[]>;
+    /** Modification times of the files a toolchain is made of. */
+    protected currentFingerprint(): string;
+}
+//# sourceMappingURL=project-mcp-tools.d.ts.map

package/lib/mcp/project-mcp-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-mcp-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/project-mcp-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD,sEAAsE;AACtE,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEvF;;;;;GAKG;AACH,qBAAa,eAAe;IAMpB,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAC/B,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU;IAClC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU;IACzC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;IARrD,SAAS,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAChC,SAAS,CAAC,WAAW,SAAM;IAC3B,SAAS,CAAC,WAAW,EAAE,iBAAiB,EAAE,CAAM;IAEhD,YACuB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EACjD;IAEE,KAAK,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAI1C;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;IAED,SAAS,CAAC,OAAO,IAAI,iBAAiB,EAAE,CAwFvC;IAED,0GAA0G;IAC1G,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAW9G;IAED,0GAA0G;IAC1G,UAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,WAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAyBpF;IAED,+FAA+F;IAC/F,UAAgB,OAAO,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAgCtD;IAED,8DAA8D;IAC9D,SAAS,CAAC,kBAAkB,IAAI,MAAM,CASrC;CACJ"}

package/lib/mcp/project-mcp-tools.js

@@ -0,0 +1,199 @@
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { CellError } from '@celljs/kit';
+import { Toolchain } from '../toolchain/toolchain.js';
+/**
+ * The tools of `cell mcp` (docs/design/agent-first.md R8): `info`, `check`, `config_get`,
+ * `docs_search`, `build` and `deploy_plan` (`cell deploy --dry-run`) run the commands with `--json`
+ * and return their result, so the two interfaces never disagree. Deploying is not a tool. Tools of toolchain modules (`cell.addMcpTool`)
+ * follow; the toolchain is loaded again when cell.config.*, package.json or a module file changes.
+ */
+export class ProjectMcpTools {
+    root;
+    run;
+    env;
+    log;
+    toolchain;
+    fingerprint = '';
+    moduleTools = [];
+    constructor(root, run, env, log) {
+        this.root = root;
+        this.run = run;
+        this.env = env;
+        this.log = log;
+    }
+    async tools() {
+        const builtin = this.builtin();
+        const names = new Set(builtin.map(t => t.name));
+        return [...builtin, ...(await this.modules()).filter(t => !names.has(t.name))];
+    }
+    async close() {
+        await this.toolchain?.close();
+        this.toolchain = undefined;
+    }
+    builtin() {
+        const object = (properties, required = []) => ({
+            type: 'object',
+            properties,
+            ...(required.length > 0 ? { required } : {}),
+            additionalProperties: false,
+        });
+        const mode = { type: 'array', items: { type: 'string' }, description: 'Extra modes: each reads cell.<mode>.yml.' };
+        const preset = { type: 'string', description: 'Preset (default: cell.config.ts, CELL_PRESET, else node).' };
+        return [
+            {
+                name: 'info',
+                description: 'The project model: preset, modes, targets, components, DI modules of each target, toolchain modules, hooks and the state of the output. Read-only and fast; start here.',
+                inputSchema: object({ preset, mode, appConfig: { type: 'boolean', description: 'Include the merged cell.yml of each target.' } }),
+                readOnly: true,
+                run: input => this.cell(['info', ...ProjectMcpTools.flags(input, { appConfig: 'app-config' })]),
+            },
+            {
+                name: 'check',
+                description: 'Checks configuration, TypeScript types, decorator settings, DI bindings and module checks in one run. Every issue has a stable code, file, line and a fix hint; passed is false when an error-level issue is found.',
+                inputSchema: object({
+                    preset,
+                    mode,
+                    skip: { type: 'array', items: { type: 'string' }, description: 'Checks to skip: config, types, decorators, di or a module check.' },
+                }),
+                readOnly: true,
+                run: input => this.cell(['check', ...ProjectMcpTools.flags(input)], [0, 1]),
+            },
+            {
+                name: 'config_get',
+                description: 'One value of the merged application configuration (cell*.yml of all components and modes, then CELL_<TARGET>__* variables) and the files and variables that set it. Backend values keep ${...}; the server evaluates them.',
+                inputSchema: object({
+                    key: { type: 'string', description: 'Dotted key, e.g. cell.server.port.' },
+                    target: { type: 'string', enum: ['backend', 'frontend'], description: 'Default: backend, else frontend.' },
+                    mode,
+                }, ['key']),
+                readOnly: true,
+                run: input => this.cell(['config', 'get', input.key, ...ProjectMcpTools.flags(input, {}, ['key'])]),
+            },
+            {
+                name: 'docs_search',
+                description: 'Searches the docs (README.md, docs/) of the installed Cell components and toolchain modules, the versions this project uses. Returns the best matching sections with file and line.',
+                inputSchema: object({
+                    query: { type: 'string', description: 'Words to look for, e.g. "transactional typeorm".' },
+                    limit: { type: 'integer', description: 'Sections to return (default 5).' },
+                }, ['query']),
+                readOnly: true,
+                run: input => this.cell(['docs', input.query, ...ProjectMcpTools.flags(input, {}, ['query'])]),
+            },
+            {
+                name: 'build',
+                description: 'Builds the application into the output directory (default .cell/output) as the preset prescribes, running build hooks. Writes files; no network.',
+                inputSchema: object({
+                    preset,
+                    mode,
+                    format: { type: 'string', enum: ['esm', 'cjs'], description: 'Server bundle format.' },
+                    sourcemap: { type: 'boolean' },
+                    outDir: { type: 'string', description: 'Output directory relative to the project root.' },
+                }),
+                readOnly: false,
+                run: input => this.cell(['build', ...ProjectMcpTools.flags(input, { outDir: 'out-dir' })]),
+            },
+            {
+                name: 'deploy_plan',
+                description: 'What cell deploy would change on the platform of the preset (e.g. cloudflare), without deploying: builds (or reuses the output with skipBuild) and asks the deployer for a plan. Deploying itself is left to a person: cell deploy.',
+                inputSchema: object({
+                    preset,
+                    mode,
+                    skipBuild: { type: 'boolean', description: 'Plan the existing output instead of building.' },
+                    outDir: { type: 'string', description: 'Output directory relative to the project root.' },
+                }),
+                readOnly: false,
+                network: true,
+                run: input => this.cell(['deploy', '--dry-run', ...ProjectMcpTools.flags(input, { skipBuild: 'skip-build', outDir: 'out-dir' })]),
+            },
+        ];
+    }
+    /** Arguments as flags: arrays repeat, `true` is a bare flag, `false` and positional keys are left out. */
+    static flags(input, names = {}, skip = []) {
+        return Object.entries(input).flatMap(([key, value]) => {
+            if (skip.includes(key) || value === undefined || value === false) {
+                return [];
+            }
+            const flag = `--${names[key] ?? key}`;
+            if (value === true) {
+                return [flag];
+            }
+            return (Array.isArray(value) ? value : [value]).flatMap(v => [flag, String(v)]);
+        });
+    }
+    /** Runs the command with `--json` and returns its result; a failure becomes the CellError it reported. */
+    async cell(argv, success = [0]) {
+        const { code, stdout } = await this.run([...argv, '--root', this.root, '--json']);
+        let result;
+        try {
+            result = JSON.parse(stdout);
+        }
+        catch (cause) {
+            throw new CellError({
+                code: 'CELL_INTERNAL_ERROR',
+                message: `cell ${argv[0]} printed no JSON result (exit code ${code}).`,
+                hint: 'Rerun the command in a terminal to see its output.',
+                cause,
+            });
+        }
+        if (!success.includes(code) || result.ok === false) {
+            const error = (result.error ?? {});
+            throw new CellError({
+                code: error.code ?? 'CELL_INTERNAL_ERROR',
+                message: error.message ?? `cell ${argv[0]} failed with exit code ${code}.`,
+                hint: error.hint,
+                file: error.file,
+                line: error.line,
+                column: error.column,
+            });
+        }
+        return result;
+    }
+    /** Tools of toolchain modules, from a toolchain loaded again when one of its files changed. */
+    async modules() {
+        const fingerprint = this.currentFingerprint();
+        if (this.toolchain && fingerprint === this.fingerprint) {
+            return this.moduleTools;
+        }
+        await this.close();
+        this.moduleTools = [];
+        try {
+            this.toolchain = await Toolchain.create({
+                root: this.root,
+                command: 'mcp',
+                env: this.env,
+                quiet: true,
+                runHooks: false,
+                logger: { info: m => this.log(m), warn: m => this.log(`warning: ${m}`) },
+            });
+        }
+        catch (error) {
+            // The built-in tools still work and report the problem (info, check).
+            this.fingerprint = '';
+            this.log(`cell mcp: toolchain modules not loaded: ${error.message}`);
+            return [];
+        }
+        this.fingerprint = this.currentFingerprint();
+        const builtin = new Set(this.builtin().map(t => t.name));
+        for (const { source, value } of this.toolchain.modules.mcpTools) {
+            if (builtin.has(value.name) || this.moduleTools.some(t => t.name === value.name)) {
+                this.log(`warning: MCP tool '${value.name}' of ${source} is left out: the name is taken.`);
+                continue;
+            }
+            this.moduleTools.push(value);
+        }
+        return this.moduleTools;
+    }
+    /** Modification times of the files a toolchain is made of. */
+    currentFingerprint() {
+        const files = [
+            join(this.root, 'package.json'),
+            ...readdirSync(this.root)
+                .filter(name => /^cell\.config\.[cm]?[jt]s$/.test(name))
+                .map(name => join(this.root, name)),
+            ...(this.toolchain?.modules.loaded.map(m => resolve(this.root, m.file)) ?? []),
+        ];
+        return files.map(file => `${file}:${existsSync(file) ? statSync(file).mtimeMs : 0}`).join('|');
+    }
+}
+//# sourceMappingURL=project-mcp-tools.js.map

package/lib/mcp/project-mcp-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-mcp-tools.js","sourceRoot":"","sources":["../../src/mcp/project-mcp-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,SAAS,EAA0B,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAKtD;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAMD,IAAI;IACJ,GAAG;IACH,GAAG;IACH,GAAG;IARhB,SAAS,CAAa;IACtB,WAAW,GAAG,EAAE,CAAC;IACjB,WAAW,GAAwB,EAAE,CAAC;IAEhD,YACuB,IAAY,EACZ,GAAe,EACf,GAAsB,EACtB,GAA8B;oBAH9B,IAAI;mBACJ,GAAG;mBACH,GAAG;mBACH,GAAG;IACvB,CAAC;IAEJ,KAAK,CAAC,KAAK;QACP,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,OAAO,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,KAAK,CAAC,KAAK;QACP,MAAM,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAES,OAAO;QACb,MAAM,MAAM,GAAG,CAAC,UAAmC,EAAE,QAAQ,GAAa,EAAE,EAAE,EAAE,CAAC,CAAC;YAC9E,IAAI,EAAE,QAAQ;YACd,UAAU;YACV,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5C,oBAAoB,EAAE,KAAK;SAC9B,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,0CAA0C,EAAE,CAAC;QACnH,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2DAA2D,EAAE,CAAC;QAC5G,OAAO;YACH;gBACI,IAAI,EAAE,MAAM;gBACZ,WAAW,EACP,yKAAyK;gBAC7K,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6CAA6C,EAAE,EAAE,CAAC;gBACjI,QAAQ,EAAE,IAAI;gBACd,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;aAClG;YACD;gBACI,IAAI,EAAE,OAAO;gBACb,WAAW,EACP,qNAAqN;gBACzN,WAAW,EAAE,MAAM,CAAC;oBAChB,MAAM;oBACN,IAAI;oBACJ,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,kEAAkE,EAAE;iBACtI,CAAC;gBACF,QAAQ,EAAE,IAAI;gBACd,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;aAC9E;YACD;gBACI,IAAI,EAAE,YAAY;gBAClB,WAAW,EACP,4NAA4N;gBAChO,WAAW,EAAE,MAAM,CACf;oBACI,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;oBAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,WAAW,EAAE,kCAAkC,EAAE;oBAC1G,IAAI;iBACP,EACD,CAAC,KAAK,CAAC,CACV;gBACD,QAAQ,EAAE,IAAI;gBACd,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,GAAa,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aAChH;YACD;gBACI,IAAI,EAAE,aAAa;gBACnB,WAAW,EACP,qLAAqL;gBACzL,WAAW,EAAE,MAAM,CACf;oBACI,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kDAAkD,EAAE;oBAC1F,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,iCAAiC,EAAE;iBAC7E,EACD,CAAC,OAAO,CAAC,CACZ;gBACD,QAAQ,EAAE,IAAI;gBACd,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,KAAe,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;aAC3G;YACD;gBACI,IAAI,EAAE,OAAO;gBACb,WAAW,EACP,kJAAkJ;gBACtJ,WAAW,EAAE,MAAM,CAAC;oBAChB,MAAM;oBACN,IAAI;oBACJ,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,WAAW,EAAE,uBAAuB,EAAE;oBACtF,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC9B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;iBAC5F,CAAC;gBACF,QAAQ,EAAE,KAAK;gBACf,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;aAC7F;YACD;gBACI,IAAI,EAAE,aAAa;gBACnB,WAAW,EACP,qOAAqO;gBACzO,WAAW,EAAE,MAAM,CAAC;oBAChB,MAAM;oBACN,IAAI;oBACJ,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,+CAA+C,EAAE;oBAC5F,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;iBAC5F,CAAC;gBACF,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,IAAI;gBACb,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;aACpI;SACJ,CAAC;IACN,CAAC;IAED,0GAA0G;IAC1G,MAAM,CAAC,KAAK,CAAC,KAA8B,EAAE,KAAK,GAA2B,EAAE,EAAE,IAAI,GAAa,EAAE;QAChG,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAClD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC/D,OAAO,EAAE,CAAC;YACd,CAAC;YACD,MAAM,IAAI,GAAG,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;YACtC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpF,CAAC,CAAC,CAAC;IACP,CAAC;IAED,0GAA0G;IAChG,KAAK,CAAC,IAAI,CAAC,IAAc,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;QAC9C,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QAClF,IAAI,MAA+B,CAAC;QACpC,IAAI,CAAC;YACD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,SAAS,CAAC;gBAChB,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,QAAQ,IAAI,CAAC,CAAC,CAAC,sCAAsC,IAAI,IAAI;gBACtE,IAAI,EAAE,oDAAoD;gBAC1D,KAAK;aACR,CAAC,CAAC;QACP,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAsG,CAAC;YACxI,MAAM,IAAI,SAAS,CAAC;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,qBAAqB;gBACzC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,QAAQ,IAAI,CAAC,CAAC,CAAC,0BAA0B,IAAI,GAAG;gBAC1E,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM,EAAE,KAAK,CAAC,MAAM;aACvB,CAAC,CAAC;QACP,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,+FAA+F;IACrF,KAAK,CAAC,OAAO;QACnB,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC9C,IAAI,IAAI,CAAC,SAAS,IAAI,WAAW,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YACrD,OAAO,IAAI,CAAC,WAAW,CAAC;QAC5B,CAAC;QACD,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC;YACD,IAAI,CAAC,SAAS,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC;gBACpC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,KAAK;gBACd,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,KAAK,EAAE,IAAI;gBACX,QAAQ,EAAE,KAAK;gBACf,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE;aAC3E,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,sEAAsE;YACtE,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,2CAA4C,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;YAChF,OAAO,EAAE,CAAC;QACd,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,KAAK,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC9D,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/E,IAAI,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,IAAI,QAAQ,MAAM,kCAAkC,CAAC,CAAC;gBAC3F,SAAS;YACb,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED,8DAA8D;IACpD,kBAAkB;QACxB,MAAM,KAAK,GAAG;YACV,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC;YAC/B,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;iBACpB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;iBACvD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACvC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;SACjF,CAAC;QACF,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnG,CAAC;CACJ"}