@node-in-layers/mcp-server 2.0.3 → 2.1.0

package/models.js

@@ -0,0 +1,204 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { ValidationError } from 'functional-models';
+import { defaultModelTypeParser, createMcpToolSave, createMcpToolRetrieve, createMcpToolDelete, createMcpToolSearch, createMcpToolBulkInsert, createMcpToolBulkDelete, } from 'functional-models-orm-mcp';
+import { createErrorObject, isErrorObject, } from '@node-in-layers/core';
+import { asyncMap } from 'modern-async';
+import { isDomainHidden, areAllModelsHidden, isModelHidden, commonMcpExecute, createDomainNotFoundError, createModelsNotFoundError, createMcpResponse, createModelNotFoundError, } from './libs.js';
+import { McpNamespace } from './types.js';
+const describeModelMcpTool = () => {
+    return {
+        name: 'describe_model',
+        description: 'Gets the schema of a given model',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                domain: { type: 'string' },
+                modelType: { type: 'string' },
+            },
+            required: ['domain', 'modelType'],
+        },
+        outputSchema: {
+            type: 'object',
+            // @ts-ignore
+            additionalProperties: true,
+        },
+    };
+};
+const listModelsMcpTool = () => {
+    return {
+        name: 'list_models',
+        description: 'Gets a list of models for a given domain and their description.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                domain: { type: 'string' },
+            },
+            required: ['domain'],
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                models: {
+                    type: 'array',
+                    // @ts-ignore
+                    items: {
+                        type: 'object',
+                        required: ['modelType'],
+                        properties: {
+                            modelType: { type: 'string' },
+                            description: { type: 'string' },
+                        },
+                    },
+                },
+            },
+        },
+    };
+};
+export const create = (context) => {
+    const hiddenPaths = new Set([
+        '@node-in-layers/core',
+        '@node-in-layers/data',
+        '@node-in-layers/mcp-server',
+        ...(context.config[McpNamespace].hiddenPaths || []),
+    ]);
+    const isDomainHiddenFunc = isDomainHidden(hiddenPaths);
+    const areAllModelsHiddenFunc = areAllModelsHidden(hiddenPaths);
+    const isModelHiddenFunc = isModelHidden(hiddenPaths);
+    const listModels = () => {
+        return Object.assign(Object.assign({}, listModelsMcpTool()), { execute: commonMcpExecute((input) => __awaiter(void 0, void 0, void 0, function* () {
+                const domain = input.domain;
+                if (isDomainHiddenFunc(domain) || areAllModelsHiddenFunc(domain)) {
+                    return createDomainNotFoundError();
+                }
+                const models = context.features[domain].cruds;
+                if (!models) {
+                    return createMcpResponse(createModelsNotFoundError());
+                }
+                const result = Object.entries(models).reduce((acc, [modelName, model]) => {
+                    if (isModelHiddenFunc(domain, modelName)) {
+                        return acc;
+                    }
+                    const description = model
+                        .getModel()
+                        .getModelDefinition().description;
+                    return acc.concat(Object.assign({ modelType: model.getModel().getName() }, (description ? { description } : {})));
+                }, []);
+                return createMcpResponse(result);
+            })) });
+    };
+    const describe = () => {
+        return Object.assign(Object.assign({}, describeModelMcpTool()), { execute: commonMcpExecute((input) => __awaiter(void 0, void 0, void 0, function* () {
+                const domain = input.domain;
+                if (isDomainHiddenFunc(domain)) {
+                    return createDomainNotFoundError();
+                }
+                const { modelName } = defaultModelTypeParser(input.modelType);
+                const model = context.features[domain].cruds[modelName];
+                if (!model ||
+                    isModelHiddenFunc(domain, modelName) ||
+                    areAllModelsHiddenFunc(domain)) {
+                    return createModelNotFoundError();
+                }
+                const schema = model.getModel().getModelDefinition().schema;
+                return createMcpResponse(schema);
+            })) });
+    };
+    const _createMcpModelFunc = (modelFunc) => {
+        return commonMcpExecute((input) => __awaiter(void 0, void 0, void 0, function* () {
+            const modelType = input.modelType;
+            const { domain, modelName } = defaultModelTypeParser(modelType);
+            if (isDomainHiddenFunc(domain)) {
+                return createDomainNotFoundError();
+            }
+            const model = context.features[domain].cruds[modelName];
+            if (!model ||
+                isModelHiddenFunc(domain, modelName) ||
+                areAllModelsHiddenFunc(domain)) {
+                return createModelNotFoundError();
+            }
+            const result = yield modelFunc(input, model.getModel()).catch(e => {
+                if (e instanceof ValidationError) {
+                    return createErrorObject('VALIDATION_ERROR', 'Validation Error', {
+                        details: {
+                            keysToErrors: e.keysToErrors,
+                            modelName: e.modelName,
+                        },
+                    });
+                }
+                return createErrorObject('UNCAUGHT_EXCEPTION', 'An uncaught exception occurred while executing the feature.', e);
+            });
+            if (isErrorObject(result)) {
+                return createMcpResponse(result, { isError: true });
+            }
+            return createMcpResponse(result);
+        }));
+    };
+    const save = () => {
+        return Object.assign(Object.assign({}, createMcpToolSave()), { execute: _createMcpModelFunc((input, model) => __awaiter(void 0, void 0, void 0, function* () {
+                const data = input.instance;
+                const result = yield model.save(data).catch(e => {
+                    if (e instanceof ValidationError) {
+                        return createErrorObject('VALIDATION_ERROR', 'Validation Error', e);
+                    }
+                    return createErrorObject('UNCAUGHT_EXCEPTION', 'An uncaught exception occurred while executing the feature.', e);
+                });
+                if (isErrorObject(result)) {
+                    return result;
+                }
+                return result.toObj();
+            })) });
+    };
+    const retrieve = () => {
+        return Object.assign(Object.assign({}, createMcpToolRetrieve()), { execute: _createMcpModelFunc((input, model) => __awaiter(void 0, void 0, void 0, function* () {
+                const result = yield model.retrieve(input.id);
+                if (!result) {
+                    return createModelNotFoundError();
+                }
+                return result.toObj();
+            })) });
+    };
+    const deleteFunc = () => {
+        return Object.assign(Object.assign({}, createMcpToolDelete()), { execute: _createMcpModelFunc((input, model) => __awaiter(void 0, void 0, void 0, function* () {
+                yield model.delete(input.id);
+                return null;
+            })) });
+    };
+    const search = () => {
+        return Object.assign(Object.assign({}, createMcpToolSearch()), { execute: _createMcpModelFunc((input, model) => __awaiter(void 0, void 0, void 0, function* () {
+                const result = yield model.search(input.query);
+                const instances = yield asyncMap(result.instances, i => i.toObj());
+                return { instances, page: result.page };
+            })) });
+    };
+    const bulkInsert = () => {
+        return Object.assign(Object.assign({}, createMcpToolBulkInsert()), { execute: _createMcpModelFunc((input, model) => __awaiter(void 0, void 0, void 0, function* () {
+                yield model.bulkInsert(input.items);
+                return null;
+            })) });
+    };
+    const bulkDelete = () => {
+        return Object.assign(Object.assign({}, createMcpToolBulkDelete()), { execute: _createMcpModelFunc((input, model) => __awaiter(void 0, void 0, void 0, function* () {
+                yield model.bulkDelete(input.ids);
+                return null;
+            })) });
+    };
+    return {
+        listModels,
+        describe,
+        save,
+        retrieve,
+        delete: deleteFunc,
+        search,
+        bulkInsert,
+        bulkDelete,
+    };
+};
+//# sourceMappingURL=models.js.map

package/models.js.map

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

package/nil.d.ts

@@ -0,0 +1,153 @@
+import { LayerContext } from '@node-in-layers/core';
+import { ServerTool } from '@l4t/mcp-ai/simple-server/types.js';
+export declare const create: <TConfig extends Readonly<{
+    "@node-in-layers/mcp-server": {
+        name?: string | undefined;
+        version?: string | undefined;
+        stateless?: boolean | undefined;
+        server: {
+            connection: Readonly<{
+                server: Readonly<{
+                    connection: Readonly<{
+                        type: "http";
+                        url: string;
+                        port?: number | undefined;
+                        headers?: Readonly<Record<string, string>> | undefined;
+                        timeout?: number | undefined;
+                        retry?: Readonly<{
+                            attempts: number;
+                            backoff: number;
+                        }> | undefined;
+                    }>;
+                    path?: string | undefined;
+                }>;
+            }> | Readonly<{
+                server: Readonly<{
+                    connection: {
+                        type: "cli";
+                    };
+                }>;
+            }> | Readonly<{
+                server: Readonly<{
+                    connection: Readonly<{
+                        type: "sse";
+                        url: string;
+                        port?: number | undefined;
+                    }>;
+                    path?: string | undefined;
+                    messagesPath?: string | undefined;
+                }>;
+            }> | Readonly<{
+                server: Readonly<{
+                    connection: Readonly<{
+                        type: "http";
+                        url: string;
+                        port?: number | undefined;
+                        headers?: Readonly<Record<string, string>> | undefined;
+                        timeout?: number | undefined;
+                        retry?: Readonly<{
+                            attempts: number;
+                            backoff: number;
+                        }> | undefined;
+                    }>;
+                    path?: string | undefined;
+                }>;
+                stateless: true;
+            }>;
+        };
+        hiddenPaths?: string[] | undefined;
+        logging?: {
+            requestLogLevel?: import("@node-in-layers/core/types.js").LogLevelNames | undefined;
+            responseLogLevel?: import("@node-in-layers/core/types.js").LogLevelNames | undefined;
+            requestLogGetData?: ((req: Request) => Record<string, any>) | undefined;
+            responseLogGetData?: ((req: Request) => Record<string, any>) | undefined;
+        } | undefined;
+    };
+}> & Readonly<{
+    systemName: string;
+    environment: string;
+    "@node-in-layers/core": Readonly<{
+        logging: {
+            logLevel: import("@node-in-layers/core/types.js").LogLevelNames;
+            logFormat: import("@node-in-layers/core/types.js").LogFormat | readonly import("@node-in-layers/core/types.js").LogFormat[];
+            maxLogSizeInCharacters?: number | undefined;
+            tcpLoggingOptions?: Readonly<{
+                url: string;
+                headers?: Record<string, string | object> | undefined;
+            }> | undefined;
+            customLogger?: Readonly<{
+                getLogger: (context: Readonly<{
+                    config: Readonly<any>;
+                    rootLogger: Readonly<any>;
+                    constants: {
+                        environment: string;
+                        workingDirectory: string;
+                        runtimeId: string;
+                    };
+                }>, props?: {
+                    ids?: readonly Readonly<Record<string, string>>[] | undefined;
+                    data?: Record<string, any> | undefined;
+                } | undefined) => import("@node-in-layers/core/types.js").HighLevelLogger;
+            }> | undefined;
+            getFunctionWrapLogLevel?: ((layerName: string, functionName?: string | undefined) => import("@node-in-layers/core/types.js").LogLevelNames) | undefined;
+            ignoreLayerFunctions?: Record<string, boolean | Record<string, boolean | Record<string, boolean>>> | undefined;
+        };
+        layerOrder: readonly import("@node-in-layers/core/types.js").LayerDescription[];
+        apps: readonly Readonly<{
+            name: string;
+            description?: string | undefined;
+            services?: Readonly<{
+                create: (context: any) => import("@node-in-layers/core/types.js").MaybePromise<object>;
+            }> | undefined;
+            features?: Readonly<{
+                create: (context: any) => import("@node-in-layers/core/types.js").MaybePromise<object>;
+            }> | undefined;
+            globals?: Readonly<{
+                create: (context: Readonly<{
+                    config: Readonly<any>;
+                    rootLogger: Readonly<{
+                        getLogger: (context: Readonly<{
+                            config: Readonly<any>;
+                            rootLogger: Readonly<any>;
+                            constants: {
+                                environment: string;
+                                workingDirectory: string;
+                                runtimeId: string;
+                            };
+                        }>, props?: {
+                            ids?: readonly Readonly<Record<string, string>>[] | undefined;
+                            data?: Record<string, any> | undefined;
+                        } | undefined) => import("@node-in-layers/core/types.js").HighLevelLogger;
+                    }>;
+                    constants: {
+                        environment: string;
+                        workingDirectory: string;
+                        runtimeId: string;
+                    };
+                }>) => Promise<any>;
+            }> | undefined;
+            models?: Record<string, Readonly<{
+                create: <T extends Readonly<{
+                    [s: string]: any;
+                }>, TModelExtensions extends object = object, TModelInstanceExtensions extends object = object>(modelProps: Readonly<{
+                    Model: import("functional-models/types.js").ModelFactory<object, object>;
+                    fetcher: import("functional-models/types.js").ModelInstanceFetcher<object, object>;
+                    getModel: <T_1 extends Readonly<{
+                        [s: string]: any;
+                    }>>(namespace: string, modelName: string) => () => import("functional-models/types.js").ModelType<T_1, object, object>;
+                }>) => import("functional-models/types.js").ModelType<T, TModelExtensions, TModelInstanceExtensions>;
+            }>> | undefined;
+        }>[];
+        modelFactory?: string | undefined;
+        modelCruds?: boolean | undefined;
+        customModelFactory?: {
+            [x: string]: {
+                [x: string]: string | [string, string] | [string, string, any[]];
+            };
+        } | undefined;
+    }>;
+}>>(context: any) => {
+    listDomains: () => ServerTool;
+    describeFeature: () => ServerTool;
+    listFeatures: () => ServerTool;
+};

package/nil.js

@@ -0,0 +1,158 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { createDomainNotFoundError, createMcpResponse, createFeatureNotFoundError, isNilAnnotatedFunction, nilAnnotatedFunctionToOpenApi, createOpenApiForNonNilAnnotatedFunction, isDomainHidden, isFeatureHidden, commonMcpExecute, } from './libs.js';
+import { McpNamespace } from './types.js';
+const describeFeatureMcpTool = () => {
+    return {
+        name: 'describe_feature',
+        description: 'Gets the schema of a given feature',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                domain: { type: 'string' },
+                featureName: { type: 'string' },
+            },
+            required: ['domain', 'featureName'],
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                schema: { type: 'object' },
+            },
+        },
+    };
+};
+const listFeaturesMcpTool = () => {
+    return {
+        name: 'list_features',
+        description: 'Gets a list of features for a given domain',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                domain: { type: 'string' },
+            },
+            required: ['domain'],
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                features: {
+                    type: 'array',
+                    // @ts-ignore
+                    items: {
+                        type: 'object',
+                        required: ['name'],
+                        properties: {
+                            name: { type: 'string' },
+                            description: { type: 'string' },
+                        },
+                    },
+                },
+            },
+        },
+    };
+};
+const listDomainsMcpTool = () => {
+    return {
+        name: 'list_domains',
+        description: 'Gets a list of domains on the system, including their descriptions.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+        outputSchema: {
+            type: 'object',
+            properties: {
+                domains: {
+                    type: 'array',
+                    // @ts-ignore
+                    items: {
+                        type: 'object',
+                        required: ['name'],
+                        properties: {
+                            name: { type: 'string' },
+                            description: { type: 'string' },
+                        },
+                    },
+                },
+            },
+        },
+    };
+};
+export const create = (context) => {
+    const hiddenPaths = new Set([
+        '@node-in-layers/core',
+        '@node-in-layers/data',
+        '@node-in-layers/mcp-server',
+        ...(context.config[McpNamespace].hiddenPaths || []),
+    ]);
+    const isDomainHiddenFunc = isDomainHidden(hiddenPaths);
+    const isFeatureHiddenFunc = isFeatureHidden(hiddenPaths);
+    const _listDomainsTool = () => {
+        return Object.assign(Object.assign({}, listDomainsMcpTool()), { execute: commonMcpExecute(() => __awaiter(void 0, void 0, void 0, function* () {
+                const domains = Object.entries(context.features).reduce((acc, [domainName]) => {
+                    var _a;
+                    if (isDomainHiddenFunc(domainName)) {
+                        return acc;
+                    }
+                    const description = (_a = context.config['@node-in-layers/core'].apps.find(app => app.name === domainName)) === null || _a === void 0 ? void 0 : _a.description;
+                    return acc.concat(Object.assign({ name: domainName }, (description ? { description } : {})));
+                }, []);
+                return createMcpResponse(domains);
+            })) });
+    };
+    const _describeFeatureTool = () => {
+        return Object.assign(Object.assign({}, describeFeatureMcpTool()), { execute: commonMcpExecute((input) => __awaiter(void 0, void 0, void 0, function* () {
+                var _a;
+                const domain = input.domain;
+                const featureName = input.featureName;
+                const feature = (_a = context[domain]) === null || _a === void 0 ? void 0 : _a[featureName];
+                if (!feature ||
+                    isDomainHiddenFunc(domain) ||
+                    isFeatureHiddenFunc(domain, featureName)) {
+                    return createFeatureNotFoundError();
+                }
+                const openapi = isNilAnnotatedFunction(feature)
+                    ? nilAnnotatedFunctionToOpenApi(feature.name, feature)
+                    : createOpenApiForNonNilAnnotatedFunction(feature.name);
+                return createMcpResponse(openapi);
+            })) });
+    };
+    const _listFeaturesTool = () => {
+        return Object.assign(Object.assign({}, listFeaturesMcpTool()), { execute: commonMcpExecute((input) => __awaiter(void 0, void 0, void 0, function* () {
+                const domain = input.domain;
+                if (isDomainHiddenFunc(domain)) {
+                    return createDomainNotFoundError();
+                }
+                const features = domain.features;
+                const result = Object.entries(features).reduce((acc, [featureName, feature]) => {
+                    var _a;
+                    if (typeof feature !== 'function') {
+                        return acc;
+                    }
+                    if (isFeatureHiddenFunc(domain, featureName)) {
+                        return acc;
+                    }
+                    const obj = Object.assign({ name: featureName }, (((_a = feature.schema) === null || _a === void 0 ? void 0 : _a.description)
+                        ? // @ts-ignore
+                            { description: feature.schema.description }
+                        : {}));
+                    return acc.concat(obj);
+                }, []);
+                return createMcpResponse(result);
+            })) });
+    };
+    return {
+        listDomains: _listDomainsTool,
+        describeFeature: _describeFeatureTool,
+        listFeatures: _listFeaturesTool,
+    };
+};
+//# sourceMappingURL=nil.js.map

package/nil.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@node-in-layers/mcp-server",
   "type": "module",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "description": "An MCP Server Node In Layers Package, generated by the Node In Layers Toolkit.",
   "main": "index.js",
   "scripts": {

package/types.d.ts

@@ -66,7 +66,7 @@ export type McpServerConfig = Readonly<{
 }>;
 export declare const McpNamespace = "@node-in-layers/mcp-server";
 export type McpServerMcp = Readonly<{
-    start: (options?: AppOptions) => Promise<void>;
+    start: <T extends McpServerConfig & Config>(systemContext: LayerContext<T, any>, options?: AppOptions) => Promise<void>;
     addTool: (tool: ServerTool) => void;
     getApp: (options?: AppOptions) => Express;
     set: (key: string, value: any) => void;