@celljs/cli 3.8.0 → 4.0.0

package/lib/mcp/dev-mcp-endpoint.d.ts

@@ -0,0 +1,62 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type McpToolDefinition } from '@celljs/kit';
+import type { CellDevServer } from '@celljs/vite';
+import { DevActivity } from './dev-activity.js';
+import { McpServer } from './mcp-server.js';
+/** The parts of an inversify 6 container the endpoint reads. */
+interface ContainerLike {
+    get(id: unknown): unknown;
+    parent?: ContainerLike | null;
+    _bindingDictionary?: {
+        getMap(): Map<unknown, BindingLike[]>;
+    };
+}
+interface BindingLike {
+    type?: string;
+    scope?: string;
+    implementationType?: {
+        name?: string;
+    } | null;
+    constraint?: {
+        metaData?: {
+            key?: unknown;
+            value?: unknown;
+        };
+    };
+}
+/**
+ * `POST /_cell/mcp` of `cell dev`: an MCP endpoint (Streamable HTTP, JSON responses) into the running
+ * application: errors, routes, DI bindings, configuration, recent requests and logs
+ * (docs/design/agent-first.md R8). Only answers same-machine origins.
+ */
+export declare class DevMcpEndpoint {
+    protected readonly dev: () => CellDevServer | undefined;
+    protected readonly activity: DevActivity;
+    static readonly PATH = "/_cell/mcp";
+    static readonly MAX_BODY: number;
+    static readonly LOOPBACK: string[];
+    /** A key, not an expression: `get_config` evaluates `${key}`. */
+    static readonly KEY: RegExp;
+    readonly server: McpServer;
+    constructor(dev: () => CellDevServer | undefined, activity: DevActivity, version: string);
+    /** A connect-style handler for the dev server. */
+    readonly handler: (req: IncomingMessage, res: ServerResponse) => void;
+    protected handle(req: IncomingMessage, res: ServerResponse): Promise<void>;
+    /** No Origin (a CLI client), a loopback origin, or the page of the dev server itself. */
+    static sameMachine(req: IncomingMessage): boolean;
+    protected static read(req: IncomingMessage): Promise<string | undefined>;
+    protected static send(res: ServerResponse, status: number, body: unknown): void;
+    tools(): McpToolDefinition[];
+    protected errors(): Record<string, unknown>;
+    protected container(): ContainerLike;
+    /** Every binding of the container and its parents, by identifier. */
+    protected static entries(container: ContainerLike): [unknown, BindingLike[]][];
+    static idName(id: unknown): string;
+    /** A service bound under a symbol of that description, e.g. `RouteProvider` of @celljs/mvc. */
+    protected find(description: string): unknown;
+    protected bindings(filter: string | undefined, limit: number): Record<string, unknown>;
+    protected routes(filter: string | undefined): Promise<Record<string, unknown>>;
+    protected config(key: string): Record<string, unknown>;
+}
+export {};
+//# sourceMappingURL=dev-mcp-endpoint.d.ts.map

package/lib/mcp/dev-mcp-endpoint.d.ts.map

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

package/lib/mcp/dev-mcp-endpoint.js

@@ -0,0 +1,280 @@
+import { CellError } from '@celljs/kit';
+import { DevActivity } from './dev-activity.js';
+import { McpServer } from './mcp-server.js';
+/**
+ * `POST /_cell/mcp` of `cell dev`: an MCP endpoint (Streamable HTTP, JSON responses) into the running
+ * application: errors, routes, DI bindings, configuration, recent requests and logs
+ * (docs/design/agent-first.md R8). Only answers same-machine origins.
+ */
+export class DevMcpEndpoint {
+    dev;
+    activity;
+    static PATH = '/_cell/mcp';
+    static MAX_BODY = 1024 * 1024;
+    static LOOPBACK = ['localhost', '127.0.0.1', '[::1]', '::1'];
+    /** A key, not an expression: `get_config` evaluates `${key}`. */
+    static KEY = /^[A-Za-z_$][\w$]*(\.[A-Za-z_$][\w$]*|\[\d+\])*$/;
+    server;
+    constructor(dev, activity, version) {
+        this.dev = dev;
+        this.activity = activity;
+        this.server = new McpServer({
+            name: 'cell-dev',
+            version,
+            instructions: 'The running Cell application of cell dev. Call get_errors first when something fails; list_routes, list_bindings and get_config show what the application really loaded.',
+            tools: () => this.tools(),
+        });
+    }
+    /** A connect-style handler for the dev server. */
+    handler = (req, res) => {
+        this.handle(req, res).catch(error => {
+            if (!res.headersSent) {
+                DevMcpEndpoint.send(res, 500, McpServer.error(null, error));
+            }
+        });
+    };
+    async handle(req, res) {
+        if (!DevMcpEndpoint.sameMachine(req)) {
+            DevMcpEndpoint.send(res, 403, { error: 'Forbidden: the dev MCP endpoint only answers pages and clients of this machine.' });
+            return;
+        }
+        if (req.method !== 'POST') {
+            res.setHeader('Allow', 'POST');
+            DevMcpEndpoint.send(res, 405, { error: 'Use POST with a JSON-RPC message (MCP Streamable HTTP, JSON responses).' });
+            return;
+        }
+        const body = await DevMcpEndpoint.read(req);
+        if (body === undefined) {
+            DevMcpEndpoint.send(res, 413, { error: `The message is larger than ${DevMcpEndpoint.MAX_BODY} bytes.` });
+            return;
+        }
+        const response = await this.server.handleText(body);
+        if (response === undefined) {
+            res.statusCode = 202;
+            res.end();
+            return;
+        }
+        res.statusCode = 200;
+        res.setHeader('Content-Type', 'application/json');
+        res.end(response);
+    }
+    /** No Origin (a CLI client), a loopback origin, or the page of the dev server itself. */
+    static sameMachine(req) {
+        const origin = req.headers.origin;
+        if (!origin) {
+            return true;
+        }
+        try {
+            const url = new URL(origin);
+            return DevMcpEndpoint.LOOPBACK.includes(url.hostname) || url.host === req.headers.host;
+        }
+        catch {
+            return false;
+        }
+    }
+    static read(req) {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            let size = 0;
+            req.on('data', (chunk) => {
+                size += chunk.length;
+                if (size <= DevMcpEndpoint.MAX_BODY) {
+                    chunks.push(chunk);
+                }
+            });
+            req.on('end', () => resolve(size > DevMcpEndpoint.MAX_BODY ? undefined : Buffer.concat(chunks).toString('utf8')));
+            req.on('error', reject);
+        });
+    }
+    static send(res, status, body) {
+        res.statusCode = status;
+        res.setHeader('Content-Type', 'application/json');
+        res.end(JSON.stringify(body));
+    }
+    tools() {
+        const object = (properties = {}, required = []) => ({
+            type: 'object',
+            properties,
+            ...(required.length > 0 ? { required } : {}),
+            additionalProperties: false,
+        });
+        const limit = { type: 'integer', description: 'How many of the latest entries (default 20).' };
+        return [
+            {
+                name: 'get_errors',
+                description: 'Why the application fails: the current backend start error (with file, line and fix), earlier failed reloads, requests answered with 5xx and recent error logs.',
+                inputSchema: object(),
+                readOnly: true,
+                run: () => this.errors(),
+            },
+            {
+                name: 'list_routes',
+                description: 'HTTP routes of the running backend (@celljs/mvc): method, path, controller and method name, and error handlers.',
+                inputSchema: object({ filter: { type: 'string', description: 'Only routes whose path or controller contains this text.' } }),
+                readOnly: true,
+                run: input => this.routes(input.filter),
+            },
+            {
+                name: 'list_bindings',
+                description: 'DI bindings of the running container: service identifier, implementation, scope and binding type.',
+                inputSchema: object({
+                    filter: { type: 'string', description: 'Only bindings whose identifier or implementation contains this text (case-insensitive).' },
+                    limit: { type: 'integer', description: 'At most this many (default 200).' },
+                }),
+                readOnly: true,
+                run: input => this.bindings(input.filter, input.limit ?? 200),
+            },
+            {
+                name: 'get_config',
+                description: 'A configuration value as the running backend sees it, with ${...} expressions evaluated (e.g. cell.server.port). For where a value comes from, use config_get of cell mcp.',
+                inputSchema: object({ key: { type: 'string', description: 'Dotted key, e.g. cell.server.port.' } }, ['key']),
+                readOnly: true,
+                run: input => this.config(input.key),
+            },
+            {
+                name: 'recent_requests',
+                description: 'The latest requests the backend answered: time, method, URL, status and duration.',
+                inputSchema: object({
+                    limit,
+                    minStatus: { type: 'integer', description: 'Only responses with at least this status, e.g. 400.' },
+                    filter: { type: 'string', description: 'Only URLs containing this text.' },
+                }),
+                readOnly: true,
+                run: input => {
+                    const min = input.minStatus ?? 0;
+                    const filter = input.filter;
+                    const requests = this.activity.requests.filter(r => r.status >= min && (!filter || r.url.includes(filter)));
+                    return { total: requests.length, requests: requests.slice(-(input.limit ?? 20)) };
+                },
+            },
+            {
+                name: 'logs',
+                description: 'Console output of the dev process (application, Vite, Cell), newest last.',
+                inputSchema: object({
+                    limit: { type: 'integer', description: 'How many of the latest entries (default 50).' },
+                    level: { type: 'string', enum: DevActivity.LEVELS, description: 'Minimum level (default debug).' },
+                    filter: { type: 'string', description: 'Only messages containing this text.' },
+                }),
+                readOnly: true,
+                run: input => {
+                    const min = DevActivity.LEVELS.indexOf(input.level ?? 'debug');
+                    const filter = input.filter;
+                    const logs = this.activity.logs.filter(l => DevActivity.LEVELS.indexOf(l.level) >= min && (!filter || l.message.includes(filter)));
+                    return { total: logs.length, logs: logs.slice(-(input.limit ?? 50)) };
+                },
+            },
+        ];
+    }
+    errors() {
+        const dev = this.dev();
+        return {
+            backend: dev?.error?.toJSON() ?? null,
+            running: Boolean(dev?.application),
+            reloads: this.activity.errors.slice(-5),
+            failedRequests: this.activity.requests.filter(r => r.status >= 500).slice(-10),
+            errorLogs: this.activity.logs.filter(l => l.level === 'error').slice(-10),
+        };
+    }
+    container() {
+        const dev = this.dev();
+        const container = dev?.application?.container;
+        if (!container) {
+            throw new CellError({
+                code: 'CELL_DEV_BACKEND_NOT_RUNNING',
+                message: dev?.error ? `The backend is not running: ${dev.error.message}` : 'The backend is not running.',
+                hint: dev?.error
+                    ? 'Call get_errors for the details; the backend starts again when a file is saved.'
+                    : 'The project has no backend, or it is still starting.',
+            });
+        }
+        return container;
+    }
+    /** Every binding of the container and its parents, by identifier. */
+    static entries(container) {
+        const entries = [];
+        for (let c = container; c; c = c.parent) {
+            const map = c._bindingDictionary?.getMap();
+            if (map) {
+                entries.push(...map.entries());
+            }
+        }
+        return entries;
+    }
+    static idName(id) {
+        if (typeof id === 'symbol') {
+            return id.description ?? id.toString();
+        }
+        if (typeof id === 'function') {
+            return id.name || '(anonymous class)';
+        }
+        return String(id);
+    }
+    /** A service bound under a symbol of that description, e.g. `RouteProvider` of @celljs/mvc. */
+    find(description) {
+        const container = this.container();
+        const entry = DevMcpEndpoint.entries(container).find(([id]) => typeof id === 'symbol' && id.description === description);
+        return entry && container.get(entry[0]);
+    }
+    bindings(filter, limit) {
+        const needle = filter?.toLowerCase();
+        const rows = DevMcpEndpoint.entries(this.container()).flatMap(([id, bindings]) => bindings.map(binding => ({
+            id: DevMcpEndpoint.idName(id),
+            ...(binding.implementationType?.name ? { implementation: binding.implementationType.name } : {}),
+            type: binding.type,
+            scope: binding.scope,
+            ...(binding.constraint?.metaData?.key !== undefined
+                ? { constraint: `${String(binding.constraint.metaData.key)}=${String(binding.constraint.metaData.value)}` }
+                : {}),
+        })));
+        const matching = needle ? rows.filter(r => r.id.toLowerCase().includes(needle) || r.implementation?.toLowerCase().includes(needle)) : rows;
+        return { total: matching.length, bindings: matching.slice(0, limit), ...(matching.length > limit ? { truncated: true } : {}) };
+    }
+    async routes(filter) {
+        const provider = this.find('RouteProvider');
+        if (!provider) {
+            return { routes: [], errorHandlers: [], note: 'The backend has no @celljs/mvc routes.' };
+        }
+        const route = await provider.provide();
+        const routes = [...route.mapping].flatMap(([method, paths]) => paths.map(p => ({
+            method,
+            path: typeof p.path === 'string' ? p.path : String(p.path),
+            controller: p.controllerMetadata?.target?.name,
+            handler: p.methodMetadata?.key === undefined ? undefined : String(p.methodMetadata.key),
+        })));
+        const errorHandlers = [...(route.errorMapping ?? [])].map(([type, metadata]) => ({
+            error: type?.name,
+            controller: metadata.controllerMetadata?.target?.name,
+            handler: metadata.methodMetadata?.key === undefined ? undefined : String(metadata.methodMetadata.key),
+        }));
+        const matches = (text) => !filter || (text ?? '').includes(filter);
+        return { routes: routes.filter(r => matches(r.path) || matches(r.controller)), errorHandlers };
+    }
+    config(key) {
+        if (!DevMcpEndpoint.KEY.test(key)) {
+            throw new CellError({
+                code: 'CELL_ARGUMENT_INVALID',
+                message: `Invalid configuration key '${key}'.`,
+                hint: 'Pass a dotted key, e.g. cell.server.port or items[0].name.',
+            });
+        }
+        // ConfigProvider.get() turns 0, false and '' into the default; the expression handler does not.
+        const handler = this.find('ExpressionHandler');
+        if (!handler) {
+            throw new CellError({
+                code: 'CELL_DEV_BACKEND_NOT_RUNNING',
+                message: 'The backend has no ExpressionHandler.',
+                hint: 'Depend on @celljs/core 4 or later.',
+            });
+        }
+        const value = handler.handle(`\${${key}}`);
+        if (value === undefined) {
+            throw new CellError({
+                code: 'CELL_CONFIG_KEY_NOT_FOUND',
+                message: `'${key}' is not set in the running backend.`,
+                hint: `Run cell config get ${key} (or config_get of cell mcp) for the nearest keys and where values come from.`,
+            });
+        }
+        return { key, value };
+    }
+}
+//# sourceMappingURL=dev-mcp-endpoint.js.map

package/lib/mcp/dev-mcp-endpoint.js.map

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

package/lib/mcp/dev-mcp-endpoint.spec.d.ts

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

package/lib/mcp/dev-mcp-endpoint.spec.d.ts.map

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

package/lib/mcp/dev-mcp-endpoint.spec.js

@@ -0,0 +1,143 @@
+import { describe, expect, it } from 'bun:test';
+import { CellError } from '@celljs/kit';
+import { DevActivity } from './dev-activity.js';
+import { DevMcpEndpoint } from './dev-mcp-endpoint.js';
+async function call(endpoint, name, args = {}) {
+    const response = await endpoint.server.handle({ jsonrpc: '2.0', id: 1, method: 'tools/call', params: { name, arguments: args } });
+    return response?.result;
+}
+class HomeController {
+}
+/** The parts of an inversify container the endpoint reads. */
+function container(services) {
+    const bindings = new Map([
+        [HomeController, [{ type: 'Instance', scope: 'Singleton', implementationType: HomeController }]],
+        [Symbol('Controller'), [{ type: 'DynamicValue', scope: 'Transient', constraint: { metaData: { key: 'named', value: 'x' } } }]],
+        ...[...services.keys()].map(id => [id, [{ type: 'ConstantValue', scope: 'Singleton' }]]),
+    ]);
+    return { get: (id) => services.get(id), _bindingDictionary: { getMap: () => bindings } };
+}
+describe('DevMcpEndpoint', () => {
+    it('reports that the backend is not running, with its error', async () => {
+        const error = new CellError({ code: 'CELL_DEV_BACKEND_FAILED', message: 'Unexpected token', file: '/p/src/a.ts', line: 3, hint: 'Fix it' });
+        const activity = new DevActivity();
+        activity.recordError(error, ['/p/src/a.ts']);
+        activity.recordRequest({ time: 't', method: 'GET', url: '/x', status: 500, durationMs: 1 });
+        activity.recordRequest({ time: 't', method: 'GET', url: '/y', status: 200, durationMs: 1 });
+        activity.recordLog('error', 'boom');
+        activity.recordLog('info', 'fine');
+        const endpoint = new DevMcpEndpoint(() => ({ error, application: undefined }), activity, '1.0.0');
+        const errors = await call(endpoint, 'get_errors');
+        expect(errors.structuredContent).toMatchObject({
+            backend: { code: 'CELL_DEV_BACKEND_FAILED', file: '/p/src/a.ts', line: 3 },
+            running: false,
+            reloads: [{ files: ['/p/src/a.ts'], error: { code: 'CELL_DEV_BACKEND_FAILED' } }],
+            failedRequests: [{ url: '/x', status: 500 }],
+            errorLogs: [{ level: 'error', message: 'boom' }],
+        });
+        const routes = await call(endpoint, 'list_routes');
+        expect(routes.isError).toBe(true);
+        expect(routes.structuredContent).toMatchObject({ code: 'CELL_DEV_BACKEND_NOT_RUNNING', message: 'The backend is not running: Unexpected token' });
+    });
+    it('lists routes, bindings and configuration of the running container by symbol description', async () => {
+        const RouteProvider = Symbol('RouteProvider');
+        const ExpressionHandler = Symbol('ExpressionHandler');
+        const config = { 'cell.server.port': 0, 'cell.debug': false };
+        const services = new Map([
+            [
+                RouteProvider,
+                {
+                    provide: async () => ({
+                        mapping: new Map([
+                            ['GET', [{ path: '/users/:id', controllerMetadata: { target: { name: 'UserController' } }, methodMetadata: { key: 'get' } }]],
+                        ]),
+                        errorMapping: new Map([[Error, { controllerMetadata: { target: { name: 'ErrorController' } }, methodMetadata: { key: 'handle' } }]]),
+                    }),
+                },
+            ],
+            [ExpressionHandler, { handle: (text) => config[text.slice(2, -1)] }],
+        ]);
+        const endpoint = new DevMcpEndpoint(() => ({ application: { container: container(services) } }), new DevActivity(), '1.0.0');
+        expect((await call(endpoint, 'list_routes')).structuredContent).toEqual({
+            routes: [{ method: 'GET', path: '/users/:id', controller: 'UserController', handler: 'get' }],
+            errorHandlers: [{ error: 'Error', controller: 'ErrorController', handler: 'handle' }],
+        });
+        expect((await call(endpoint, 'list_routes', { filter: '/orders' })).structuredContent.routes).toEqual([]);
+        const bindings = await call(endpoint, 'list_bindings', { filter: 'controller' });
+        expect(bindings.structuredContent).toEqual({
+            total: 2,
+            bindings: [
+                { id: 'HomeController', implementation: 'HomeController', type: 'Instance', scope: 'Singleton' },
+                { id: 'Controller', type: 'DynamicValue', scope: 'Transient', constraint: 'named=x' },
+            ],
+        });
+        expect((await call(endpoint, 'list_bindings', { limit: 1 })).structuredContent).toMatchObject({ total: 4, truncated: true });
+        // 0 and false are values, not missing.
+        expect((await call(endpoint, 'get_config', { key: 'cell.server.port' })).structuredContent).toEqual({ key: 'cell.server.port', value: 0 });
+        expect((await call(endpoint, 'get_config', { key: 'cell.debug' })).structuredContent.value).toBe(false);
+        expect((await call(endpoint, 'get_config', { key: 'cell.nope' })).structuredContent.code).toBe('CELL_CONFIG_KEY_NOT_FOUND');
+        expect((await call(endpoint, 'get_config', { key: 'process.exit()' })).structuredContent.code).toBe('CELL_ARGUMENT_INVALID');
+    });
+    it('filters recent requests and logs', async () => {
+        const activity = new DevActivity();
+        for (const [url, status] of [
+            ['/a', 200],
+            ['/b', 404],
+            ['/c', 500],
+        ]) {
+            activity.recordRequest({ time: 't', method: 'GET', url, status, durationMs: 1 });
+        }
+        activity.recordLog('debug', 'detail');
+        activity.recordLog('warn', 'careful');
+        activity.recordLog('error', 'broken');
+        const endpoint = new DevMcpEndpoint(() => undefined, activity, '1.0.0');
+        expect((await call(endpoint, 'recent_requests', { minStatus: 400 })).structuredContent.requests.map((r) => r.url)).toEqual([
+            '/b',
+            '/c',
+        ]);
+        expect((await call(endpoint, 'recent_requests', { limit: 1 })).structuredContent).toMatchObject({ total: 3, requests: [{ url: '/c' }] });
+        expect((await call(endpoint, 'logs', { level: 'warn' })).structuredContent.logs.map((l) => l.message)).toEqual([
+            'careful',
+            'broken',
+        ]);
+        expect((await call(endpoint, 'logs', { filter: 'det' })).structuredContent.total).toBe(1);
+        expect((await call(endpoint, 'logs', { level: 'fatal' })).isError).toBe(true);
+    });
+    it('only answers clients of this machine', () => {
+        const req = (origin, host = '127.0.0.1:3000') => ({ headers: { origin, host } });
+        expect(DevMcpEndpoint.sameMachine(req())).toBe(true);
+        expect(DevMcpEndpoint.sameMachine(req('http://localhost:5173'))).toBe(true);
+        expect(DevMcpEndpoint.sameMachine(req('http://[::1]:3000'))).toBe(true);
+        expect(DevMcpEndpoint.sameMachine(req('http://192.168.1.2:3000', '192.168.1.2:3000'))).toBe(true);
+        expect(DevMcpEndpoint.sameMachine(req('https://evil.example'))).toBe(false);
+        expect(DevMcpEndpoint.sameMachine(req('null'))).toBe(false);
+    });
+});
+describe('DevActivity', () => {
+    it('keeps the latest entries only', () => {
+        const activity = new DevActivity();
+        for (let i = 0; i < DevActivity.MAX_REQUESTS + 5; i++) {
+            activity.recordRequest({ time: 't', method: 'GET', url: `/${i}`, status: 200, durationMs: 0 });
+        }
+        expect(activity.requests).toHaveLength(DevActivity.MAX_REQUESTS);
+        expect(activity.requests[0].url).toBe('/5');
+    });
+    it('copies console output and still prints it, until stopped', () => {
+        const printed = [];
+        const original = console.warn;
+        console.warn = (...args) => printed.push(args.join(' '));
+        const activity = new DevActivity();
+        const stop = activity.captureConsole();
+        try {
+            console.warn('port %d in use', 3000);
+        }
+        finally {
+            stop();
+        }
+        console.warn('after');
+        console.warn = original;
+        expect(activity.logs).toEqual([{ time: expect.any(String), level: 'warn', message: 'port 3000 in use' }]);
+        expect(printed).toEqual(['port %d in use 3000', 'after']);
+    });
+});
+//# sourceMappingURL=dev-mcp-endpoint.spec.js.map

package/lib/mcp/dev-mcp-endpoint.spec.js.map

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

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

@@ -0,0 +1,64 @@
+import { type McpToolDefinition } from '@celljs/kit';
+export interface McpServerOptions {
+    name: string;
+    version: string;
+    /** Told to the client on `initialize`: what the server is for. */
+    instructions?: string;
+    /** The tools, asked for on every `tools/list` and `tools/call` (they may change with the project). */
+    tools(): McpToolDefinition[] | Promise<McpToolDefinition[]>;
+}
+type JsonRpcId = string | number | null;
+export interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: JsonRpcId;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/** A tool result of MCP: the value as JSON text, and as structured content when it is an object. */
+export interface McpToolResult {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    structuredContent?: Record<string, unknown>;
+    isError: boolean;
+}
+/**
+ * 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 declare class McpServer {
+    protected readonly options: McpServerOptions;
+    static readonly PROTOCOL_VERSIONS: string[];
+    static readonly PARSE_ERROR = -32700;
+    static readonly INVALID_REQUEST = -32600;
+    static readonly METHOD_NOT_FOUND = -32601;
+    static readonly INVALID_PARAMS = -32602;
+    protected queue: Promise<unknown>;
+    constructor(options: McpServerOptions);
+    /** Handles one line or body of JSON; returns the response text, or undefined for a notification. */
+    handleText(text: string): Promise<string | undefined>;
+    handle(message: unknown): Promise<JsonRpcResponse | undefined>;
+    protected dispatch(method: string, params: Record<string, unknown>): Promise<unknown>;
+    protected serialize<T>(task: () => Promise<T>): Promise<T>;
+    protected call(name: unknown, args?: unknown): Promise<McpToolResult>;
+    static describe(tool: McpToolDefinition): Record<string, unknown>;
+    /** Text for every client; objects also as structured content. */
+    static result(value: unknown, isError: boolean): McpToolResult;
+    /**
+     * 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: Record<string, unknown>, args: Record<string, unknown>): string | undefined;
+    protected static checkValue(value: unknown, schema: Record<string, unknown>): string | undefined;
+    protected static hasType(value: unknown, type: string): boolean;
+    static error(id: JsonRpcId, error: unknown): JsonRpcResponse;
+}
+export {};
+//# sourceMappingURL=mcp-server.d.ts.map

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

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