@node-in-layers/mcp-server 2.1.15 → 2.2.1

package/docs/node-in-layers-system.json

@@ -0,0 +1,339 @@
+[
+    {
+        "id": "2e19b8bf-2a4f-4f3c-9b7e-0f10c9e55c01",
+        "name": "What is a Node-In-Layers (NIL) system?",
+        "tags": ["intro", "layers", "models"],
+        "details": "A Node-In-Layers (NIL) system organizes application code into cohesive apps and layered responsibilities. Key default layers: globals (shared config and infra), services (talk to the outside world: DBs, APIs, files), features (business flows orchestrating steps), and entries (starting points like REST, CLI, serverless). Models are first-class: they define validated data structures and, when configured with an ORM, expose CRUDS APIs across services and features. This document focuses on how to navigate and use a NIL system via the MCP server tools."
+    },
+    {
+        "id": "7c0c9643-92f4-4603-984d-3a25b9bd3a28",
+        "name": "MCP navigation workflow (high level)",
+        "tags": ["mcp", "workflow", "discovery"],
+        "details": "Typical AI-driven navigation flow: (1) Call list_domains to discover business domains. (2) For the chosen domain, call list_features and list_models to understand available actions and data. (3) Optionally call describe_feature or describe_model to get precise input/output schemas. (4) Execute a feature with execute_feature, or operate on models with save/retrieve/delete/search/bulkInsert/bulkDelete. Prefer describe_* before execution to align arguments correctly."
+    },
+    {
+        "id": "0f9f5b67-9b8e-4b2a-8b28-2a8800d2c3a1",
+        "name": "Cross Layer Props (tracing across calls)",
+        "tags": ["mcp", "tracing", "crossLayerProps"],
+        "details": "crossLayerProps is an optional argument you can send with NIL MCP tool calls to enable end-to-end tracing across layers (features/services) and across multiple tool invocations. It carries correlation ids that the system logs at each hop so you can stitch together a full execution story.",
+        "example": {
+            "strategy": "Generate a single aiSessionId (uuid) for the entire AI session, and an aiRequestId (uuid) per user request. Reuse both ids for every tool call made while fulfilling that one user request.",
+            "idsObject": {
+                "crossLayerProps": {
+                    "logging": {
+                        "ids": [
+                            {
+                                "name": "aiSessionId",
+                                "value": "8c2ab2c0-6f8e-4a6b-9b4e-3e9c1e3a9d10"
+                            },
+                            {
+                                "name": "aiRequestId",
+                                "value": "f4c7a8e2-1b9c-49bf-9f07-6b9d7f4e2a33"
+                            }
+                        ]
+                    }
+                }
+            },
+            "calls": [
+                {
+                    "tool": "list_domains",
+                    "input": {
+                        "crossLayerProps": {
+                            "logging": {
+                                "ids": [
+                                    {
+                                        "name": "aiSessionId",
+                                        "value": "8c2ab2c0-6f8e-4a6b-9b4e-3e9c1e3a9d10"
+                                    },
+                                    {
+                                        "name": "aiRequestId",
+                                        "value": "f4c7a8e2-1b9c-49bf-9f07-6b9d7f4e2a33"
+                                    }
+                                ]
+                            }
+                        }
+                    }
+                },
+                {
+                    "tool": "list_features",
+                    "input": {
+                        "domain": "inventory",
+                        "crossLayerProps": {
+                            "logging": {
+                                "ids": [
+                                    {
+                                        "name": "aiSessionId",
+                                        "value": "8c2ab2c0-6f8e-4a6b-9b4e-3e9c1e3a9d10"
+                                    },
+                                    {
+                                        "name": "aiRequestId",
+                                        "value": "f4c7a8e2-1b9c-49bf-9f07-6b9d7f4e2a33"
+                                    }
+                                ]
+                            }
+                        }
+                    }
+                },
+                {
+                    "tool": "execute_feature",
+                    "input": {
+                        "domain": "inventory",
+                        "featureName": "reserveItem",
+                        "args": { "sku": "ABC-123", "quantity": 1, "userId": "u-42" },
+                        "crossLayerProps": {
+                            "logging": {
+                                "ids": [
+                                    {
+                                        "name": "aiSessionId",
+                                        "value": "8c2ab2c0-6f8e-4a6b-9b4e-3e9c1e3a9d10"
+                                    },
+                                    {
+                                        "name": "aiRequestId",
+                                        "value": "f4c7a8e2-1b9c-49bf-9f07-6b9d7f4e2a33"
+                                    }
+                                ]
+                            }
+                        }
+                    }
+                }
+            ],
+            "notes": "Do not create a new id per individual tool call during the same user request; that breaks correlation. Keep aiSessionId stable for the chat/session, rotate aiRequestId per top-level user instruction."
+        }
+    },
+    {
+        "id": "a0a1c3cf-7f3f-4e4b-9f1e-2b1a9a7b11aa",
+        "name": "list_domains",
+        "tags": ["mcp", "nil", "discovery"],
+        "details": "Lists domains available in the system (from NIL features context). Hidden domains are omitted by server policy.",
+        "example": {
+            "request": {
+                "tool": "list_domains",
+                "input": {}
+            },
+            "response": {
+                "domains": [
+                    { "name": "auth", "description": "User accounts and authentication" },
+                    { "name": "inventory", "description": "Stock and availability" }
+                ]
+            },
+            "notes": "Start here. Use a domain's description to decide next actions."
+        }
+    },
+    {
+        "id": "f3b7b0d1-0d4e-4a25-9c76-8a7ef0f2d3c2",
+        "name": "list_features",
+        "tags": ["mcp", "nil", "discovery", "features"],
+        "details": "Lists callable business features for a domain. Use before execute_feature to see options.",
+        "example": {
+            "request": {
+                "tool": "list_features",
+                "input": { "domain": "inventory" }
+            },
+            "response": {
+                "features": [
+                    {
+                        "name": "checkItemAvailability",
+                        "description": "Check stock for an item"
+                    },
+                    { "name": "reserveItem", "description": "Place a hold on an item" }
+                ]
+            },
+            "notes": "Only function-typed exports are listed; hidden features are omitted."
+        }
+    },
+    {
+        "id": "3f2f4a9a-4d75-41f0-b1a9-3b7f5a223c17",
+        "name": "describe_feature",
+        "tags": ["mcp", "nil", "schema", "features"],
+        "details": "Returns an OpenAPI-like schema for a feature. If the feature is NIL-annotated, the full schema is derived; otherwise, a generic schema is produced.",
+        "example": {
+            "request": {
+                "tool": "describe_feature",
+                "input": { "domain": "inventory", "featureName": "reserveItem" }
+            },
+            "response": {
+                "schema": {
+                    "description": "Reserve an item for a user",
+                    "properties": { "args": { "type": "object" } }
+                }
+            },
+            "notes": "Use before execute_feature to validate arguments."
+        }
+    },
+    {
+        "id": "9a1a7b5d-1b2e-4b6c-9f0c-2d3e4f5a6b7c",
+        "name": "execute_feature",
+        "tags": ["mcp", "nil", "execution", "features"],
+        "details": "Executes a specific domain feature. Pass feature-specific args and optional crossLayerProps for tracing.",
+        "example": {
+            "request": {
+                "tool": "execute_feature",
+                "input": {
+                    "domain": "inventory",
+                    "featureName": "reserveItem",
+                    "args": { "sku": "ABC-123", "quantity": 1, "userId": "u-42" },
+                    "crossLayerProps": {
+                        "logging": { "ids": [{ "name": "traceId", "value": "123e4567" }] }
+                    }
+                }
+            },
+            "response": {
+                "result": { "reservationId": "r-1001", "status": "RESERVED" }
+            },
+            "notes": "Errors are returned as structured error objects by the server."
+        }
+    },
+    {
+        "id": "b0c5c3f3-6a7d-4f0a-8b1c-6d3a2f1e9c88",
+        "name": "list_models",
+        "tags": ["mcp", "models", "discovery"],
+        "details": "Lists ORM-backed models for a domain with optional descriptions. Hidden models/domains are omitted.",
+        "example": {
+            "request": { "tool": "list_models", "input": { "domain": "inventory" } },
+            "response": {
+                "models": [
+                    {
+                        "modelType": "inventory/Inventories",
+                        "description": "Inventory records"
+                    }
+                ]
+            },
+            "notes": "Model type strings encode namespace and plural name."
+        }
+    },
+    {
+        "id": "d7f2b1c0-1b9d-4ef3-88a9-1c2e3f4a5b6c",
+        "name": "describe_model",
+        "tags": ["mcp", "models", "schema"],
+        "details": "Returns the model schema for a given modelType. Use to learn required fields and types.",
+        "example": {
+            "request": {
+                "tool": "describe_model",
+                "input": { "domain": "inventory", "modelType": "inventory/Inventories" }
+            },
+            "response": {
+                "schema": {
+                    "properties": {
+                        "id": { "type": "string" },
+                        "sku": { "type": "string" },
+                        "quantity": { "type": "number" }
+                    }
+                }
+            },
+            "notes": "modelType is parsed into namespace and plural model name."
+        }
+    },
+    {
+        "id": "c5b7e0a2-4a6f-4a4e-8629-0f1a2b3c4d5e",
+        "name": "Model CRUD: save",
+        "tags": ["mcp", "models", "crud", "save"],
+        "details": "Creates or updates a model instance. Pass modelType and instance data.",
+        "example": {
+            "request": {
+                "tool": "save",
+                "input": {
+                    "modelType": "inventory/Inventories",
+                    "instance": { "sku": "ABC-123", "quantity": 10 }
+                }
+            },
+            "response": { "id": "inv-1", "sku": "ABC-123", "quantity": 10 },
+            "notes": "Validation errors are returned as structured error objects."
+        }
+    },
+    {
+        "id": "e1d2c3b4-a5f6-4a7b-8c9d-0e1f2a3b4c5d",
+        "name": "Model CRUD: retrieve",
+        "tags": ["mcp", "models", "crud", "retrieve"],
+        "details": "Retrieves a single instance by id.",
+        "example": {
+            "request": {
+                "tool": "retrieve",
+                "input": { "modelType": "inventory/Inventories", "id": "inv-1" }
+            },
+            "response": { "id": "inv-1", "sku": "ABC-123", "quantity": 10 },
+            "notes": "If not found, server returns a model-not-found error object."
+        }
+    },
+    {
+        "id": "f6a5b4c3-d2e1-4c0b-9a8f-7e6d5c4b3a21",
+        "name": "Model CRUD: delete",
+        "tags": ["mcp", "models", "crud", "delete"],
+        "details": "Deletes an instance by id.",
+        "example": {
+            "request": {
+                "tool": "delete",
+                "input": { "modelType": "inventory/Inventories", "id": "inv-1" }
+            },
+            "response": null,
+            "notes": "Returns null on success."
+        }
+    },
+    {
+        "id": "1a2b3c4d-5e6f-4701-8a9b-0c1d2e3f4a5b",
+        "name": "Model CRUD: search",
+        "tags": ["mcp", "models", "crud", "search"],
+        "details": "Searches model instances via ORM query format.",
+        "example": {
+            "request": {
+                "tool": "search",
+                "input": {
+                    "modelType": "inventory/Inventories",
+                    "query": {
+                        "filters": [{ "field": "sku", "op": "=", "value": "ABC-123" }]
+                    }
+                }
+            },
+            "response": {
+                "instances": [{ "id": "inv-1", "sku": "ABC-123", "quantity": 10 }],
+                "page": { "size": 25, "number": 1, "total": 1 }
+            },
+            "notes": "The exact search format depends on the ORM configured."
+        }
+    },
+    {
+        "id": "6b7c8d9e-0f1a-42b3-8c4d-5e6f7a8b9c0d",
+        "name": "Model CRUD: bulkInsert",
+        "tags": ["mcp", "models", "crud", "bulk"],
+        "details": "Inserts many instances in a single call.",
+        "example": {
+            "request": {
+                "tool": "bulkInsert",
+                "input": {
+                    "modelType": "inventory/Inventories",
+                    "items": [
+                        { "sku": "ABC-123", "quantity": 5 },
+                        { "sku": "XYZ-999", "quantity": 2 }
+                    ]
+                }
+            },
+            "response": null,
+            "notes": "Returns null on success; validate inputs with describe_model first."
+        }
+    },
+    {
+        "id": "7c8d9e0f-1a2b-43c4-9d5e-6f7a8b9c0d1e",
+        "name": "Model CRUD: bulkDelete",
+        "tags": ["mcp", "models", "crud", "bulk"],
+        "details": "Deletes many instances by ids.",
+        "example": {
+            "request": {
+                "tool": "bulkDelete",
+                "input": {
+                    "modelType": "inventory/Inventories",
+                    "ids": ["inv-1", "inv-2"]
+                }
+            },
+            "response": null,
+            "notes": "Use search first to decide which ids to delete."
+        }
+    },
+    {
+        "id": "0a1b2c3d-4e5f-4607-8a90-b1c2d3e4f506",
+        "name": "Putting it together: example conversation flow",
+        "tags": ["mcp", "workflow", "examples"],
+        "details": "Example of an AI deciding which tools to call and in what order.",
+        "example": {
+            "markdown": "User asks: \"Reserve 1 unit of ABC-123 if available.\"\n\n1. list_domains {}\n   - Choose domain = inventory.\n2. list_features { domain: \"inventory\" } and list_models { domain: \"inventory\" }\n   - See feature reserveItem and model Inventories.\n3. describe_feature { domain: \"inventory\", featureName: \"checkItemAvailability\" }\n   - Confirm args: { sku: string, quantity: number }.\n4. execute_feature { domain: \"inventory\", featureName: \"checkItemAvailability\", args: { sku: \"ABC-123\", quantity: 1 }, crossLayerProps: { logging: { ids: [{ name: \"aiSessionId\", value: \"8c2ab...\" }, { name: \"aiRequestId\", value: \"f4c7a...\" }] } } }\n   - If available: true -> proceed.\n5. execute_feature { domain: \"inventory\", featureName: \"reserveItem\", args: { sku: \"ABC-123\", quantity: 1, userId: \"u-42\" }, crossLayerProps: { logging: { ids: [{ name: \"aiSessionId\", value: \"8c2ab...\" }, { name: \"aiRequestId\", value: \"f4c7a...\" }] } } }\n   - Returns reservationId.\n"
+        }
+    }
+]

package/mcp.js

@@ -52,6 +52,11 @@ const create = (context) => {
         const modelsMcp = createModelsMcp(systemContext);
         const nilMcp = createNilMcp(systemContext);
         const allTools = [
+            nilMcp.startHere(),
+            nilMcp.listDomains(),
+            nilMcp.listFeatures(),
+            nilMcp.describeFeature(),
+            nilMcp.executeFeature(),
             modelsMcp.listModels(),
             modelsMcp.describe(),
             modelsMcp.save(),
@@ -60,10 +65,6 @@ const create = (context) => {
             modelsMcp.search(),
             modelsMcp.bulkInsert(),
             modelsMcp.bulkDelete(),
-            nilMcp.listDomains(),
-            nilMcp.listFeatures(),
-            nilMcp.describeFeature(),
-            nilMcp.executeFeature(),
             ...tools,
         ].map(_wrapToolsWithLogger);
         const server = createSimpleServer({

package/mcp.js.map

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

package/models.d.ts

@@ -56,6 +56,18 @@ export declare const create: <TConfig extends Readonly<{
             }>;
         };
         hiddenPaths?: string[] | undefined;
+        systemDescription?: {
+            description?: string | undefined;
+            version?: string | undefined;
+            examplesOfUse?: readonly Readonly<{
+                name: string;
+                description?: string | undefined;
+                value?: string | undefined;
+                tags?: string[] | undefined;
+                details?: string | undefined;
+                example?: string | undefined;
+            }>[] | undefined;
+        } | undefined;
         logging?: {
             requestLogLevel?: import("@node-in-layers/core/types.js").LogLevelNames | undefined;
             responseLogLevel?: import("@node-in-layers/core/types.js").LogLevelNames | undefined;

package/nil.d.ts

@@ -56,6 +56,18 @@ export declare const create: <TConfig extends Readonly<{
             }>;
         };
         hiddenPaths?: string[] | undefined;
+        systemDescription?: {
+            description?: string | undefined;
+            version?: string | undefined;
+            examplesOfUse?: readonly Readonly<{
+                name: string;
+                description?: string | undefined;
+                value?: string | undefined;
+                tags?: string[] | undefined;
+                details?: string | undefined;
+                example?: string | undefined;
+            }>[] | undefined;
+        } | undefined;
         logging?: {
             requestLogLevel?: import("@node-in-layers/core/types.js").LogLevelNames | undefined;
             responseLogLevel?: import("@node-in-layers/core/types.js").LogLevelNames | undefined;
@@ -151,4 +163,5 @@ export declare const create: <TConfig extends Readonly<{
     describeFeature: () => ServerTool;
     listFeatures: () => ServerTool;
     executeFeature: () => ServerTool;
+    startHere: () => ServerTool;
 };

package/nil.js

@@ -7,8 +7,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { createErrorObject, isErrorObject, } from '@node-in-layers/core';
+import { CoreNamespace, createErrorObject, isErrorObject, } from '@node-in-layers/core';
 import { createDomainNotFoundError, createMcpResponse, createFeatureNotFoundError, isNilAnnotatedFunction, nilAnnotatedFunctionToOpenApi, createOpenApiForNonNilAnnotatedFunction, isDomainHidden, isFeatureHidden, commonMcpExecute, crossLayerPropsOpenApi, } from './libs.js';
+import { default as nilSystem } from './docs/node-in-layers-system.json' with { type: 'json' };
 import { McpNamespace } from './types.js';
 const describeFeatureMcpTool = () => {
     return {
@@ -194,11 +195,49 @@ export const create = (context) => {
                 return createMcpResponse(result);
             })) });
     };
+    const startHereMcpTool = () => {
+        return {
+            name: 'START_HERE',
+            description: 'BEFORE YOU DO ANYTHING, you should call this tool first!!! It provides a robust description about the system and how to use it.',
+            inputSchema: { type: 'object', properties: {}, required: [] },
+            // @ts-ignore
+            outputSchema: { type: 'object', additionalProperties: true },
+        };
+    };
+    const _startHereTool = () => {
+        return Object.assign(Object.assign({}, startHereMcpTool()), { execute: commonMcpExecute(() => __awaiter(void 0, void 0, void 0, function* () {
+                const systemDescription = context.config[McpNamespace].systemDescription;
+                const systemName = context.config[CoreNamespace.root].systemName;
+                const systemEntries = nilSystem;
+                const entries = [
+                    {
+                        name: 'systemName',
+                        value: systemName,
+                    },
+                    ...(systemDescription
+                        ? [
+                            {
+                                name: 'systemDescription',
+                                value: systemDescription,
+                            },
+                        ]
+                        : []),
+                    ...((systemDescription === null || systemDescription === void 0 ? void 0 : systemDescription.examplesOfUse)
+                        ? systemDescription.examplesOfUse
+                        : []),
+                    ...systemEntries,
+                ];
+                return createMcpResponse({
+                    entries,
+                });
+            })) });
+    };
     return {
         listDomains: _listDomainsTool,
         describeFeature: _describeFeatureTool,
         listFeatures: _listFeaturesTool,
         executeFeature: _executeFeatureTool,
+        startHere: _startHereTool,
     };
 };
 //# sourceMappingURL=nil.js.map

package/nil.js.map

@@ -1 +1 @@
-{"version":3,"file":"nil.js","sourceRoot":"","sources":["../src/nil.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAEL,iBAAiB,EACjB,aAAa,GAEd,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,0BAA0B,EAC1B,sBAAsB,EACtB,6BAA6B,EAC7B,uCAAuC,EACvC,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,YAAY,EAAmB,MAAM,YAAY,CAAA;AAE1D,MAAM,sBAAsB,GAAG,GAAY,EAAE;IAC3C,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,oCAAoC;QACjD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC1B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAChC;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC;SACpC;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC3B;SACF;KACF,CAAA;AACH,CAAC,CAAA;AAED,MAAM,mBAAmB,GAAG,GAAY,EAAE;IACxC,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,4CAA4C;QACzD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC3B;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,OAAO;oBACb,aAAa;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,QAAQ,EAAE,CAAC,MAAM,CAAC;wBAClB,UAAU,EAAE;4BACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;4BACxB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;yBAChC;qBACF;iBACF;aACF;SACF;KACF,CAAA;AACH,CAAC,CAAA;AAED,MAAM,qBAAqB,GAAG,GAAY,EAAE;IAC1C,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,0BAA0B;QACvC,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC1B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC/B,aAAa;gBACb,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE;gBACpD,eAAe,EAAE,sBAAsB,EAAE;aAC1C;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,CAAC;SAC5C;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;SAC3C;KACF,CAAA;AACH,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,GAAY,EAAE;IACvC,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,qEAAqE;QACvE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,OAAO;oBACb,aAAa;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,QAAQ,EAAE,CAAC,MAAM,CAAC;wBAClB,UAAU,EAAE;4BACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;4BACxB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;yBAChC;qBACF;iBACF;aACF;SACF;KACF,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,OAAmC,EACnC,EAAE;IACF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;QAC1B,sBAAsB;QACtB,sBAAsB;QACtB,4BAA4B;QAC5B,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC;KACpD,CAAC,CAAA;IAEF,MAAM,kBAAkB,GAAG,cAAc,CAAC,WAAW,CAAC,CAAA;IACtD,MAAM,mBAAmB,GAAG,eAAe,CAAC,WAAW,CAAC,CAAA;IAExD,MAAM,gBAAgB,GAAG,GAAe,EAAE;QACxC,uCACK,kBAAkB,EAAE,KACvB,OAAO,EAAE,gBAAgB,CAAC,GAAS,EAAE;gBACnC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CACrD,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE;;oBACpB,IAAI,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;wBACnC,OAAO,GAAG,CAAA;oBACZ,CAAC;oBACD,MAAM,WAAW,GAAG,MAAA,OAAO,CAAC,MAAM,CAChC,sBAAsB,CACvB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,UAAU,CAAC,0CAAE,WAAW,CAAA;oBACxD,OAAO,GAAG,CAAC,MAAM,iBACf,IAAI,EAAE,UAAU,IACb,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EACvC,CAAA;gBACJ,CAAC,EACD,EAA8C,CAC/C,CAAA;gBACD,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAA;YACnC,CAAC,CAAA,CAAC,IACH;IACH,CAAC,CAAA;IAED,MAAM,oBAAoB,GAAG,GAAe,EAAE;QAC5C,uCACK,sBAAsB,EAAE,KAC3B,OAAO,EAAE,gBAAgB,CAAC,CAAO,KAAU,EAAE,EAAE;;gBAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAA;gBAC3B,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAA;gBACrC,MAAM,OAAO,GAAG,MAAA,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,0CAAG,WAAW,CAAC,CAAA;gBACvD,IACE,CAAC,OAAO;oBACR,kBAAkB,CAAC,MAAM,CAAC;oBAC1B,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,EACxC,CAAC;oBACD,OAAO,0BAA0B,EAAE,CAAA;gBACrC,CAAC;gBACD,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC;oBAC7C,CAAC,CAAC,6BAA6B,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;oBACtD,CAAC,CAAC,uCAAuC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;gBACzD,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAA;YACnC,CAAC,CAAA,CAAC,IACH;IACH,CAAC,CAAA;IAED,MAAM,iBAAiB,GAAG,GAAe,EAAE;QACzC,uCACK,mBAAmB,EAAE,KACxB,OAAO,EAAE,gBAAgB,CAAC,CAAO,KAAU,EAAE,EAAE;gBAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAA;gBAC3B,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC/B,OAAO,yBAAyB,EAAE,CAAA;gBACpC,CAAC;gBACD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;gBACjC,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC3C,OAAO,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAA;gBAC5C,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CACpD,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE;;oBAC9B,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;wBAClC,OAAO,GAAG,CAAA;oBACZ,CAAC;oBACD,IAAI,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC;wBAC7C,OAAO,GAAG,CAAA;oBACZ,CAAC;oBACD,MAAM,GAAG,mBACP,IAAI,EAAE,WAAW,IAEd,CAAC,CAAA,MAAA,OAAO,CAAC,MAAM,0CAAE,WAAW;wBAC7B,CAAC,CAAC,aAAa;4BACb,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE;wBAC7C,CAAC,CAAC,EAAE,CAAC,CACR,CAAA;oBACD,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBACxB,CAAC,EACD,EAA8C,CAC/C,CAAA;gBACD,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAA;YAClC,CAAC,CAAA,CAAC,IACH;IACH,CAAC,CAAA;IAED,MAAM,mBAAmB,GAAG,GAAe,EAAE;QAC3C,uCACK,qBAAqB,EAAE,KAC1B,OAAO,EAAE,gBAAgB,CAAC,CAAO,KAAU,EAAE,EAAE;;gBAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAA;gBAC3B,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAA;gBACrC,MAAM,OAAO,GAAG,MAAA,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,0CAAG,WAAW,CAAC,CAAA;gBACvD,IACE,CAAC,OAAO;oBACR,kBAAkB,CAAC,MAAM,CAAC;oBAC1B,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,EACxC,CAAC;oBACD,OAAO,0BAA0B,EAAE,CAAA;gBACrC,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,KAAK,CACnE,CAAC,CAAC,EAAE;oBACF,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;wBACrB,OAAO,CAAC,CAAA;oBACV,CAAC;oBACD,OAAO,iBAAiB,CACtB,oBAAoB,EACpB,6DAA6D,EAC7D,CAAC,CACF,CAAA;gBACH,CAAC,CACF,CAAA;gBACD,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAA;YAClC,CAAC,CAAA,CAAC,IACH;IACH,CAAC,CAAA;IAED,OAAO;QACL,WAAW,EAAE,gBAAgB;QAC7B,eAAe,EAAE,oBAAoB;QACrC,YAAY,EAAE,iBAAiB;QAC/B,cAAc,EAAE,mBAAmB;KACpC,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"nil.js","sourceRoot":"","sources":["../src/nil.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAEL,aAAa,EACb,iBAAiB,EACjB,aAAa,GAEd,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,0BAA0B,EAC1B,sBAAsB,EACtB,6BAA6B,EAC7B,uCAAuC,EACvC,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,mCAAmC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAC9F,OAAO,EAAE,YAAY,EAAmB,MAAM,YAAY,CAAA;AAE1D,MAAM,sBAAsB,GAAG,GAAY,EAAE;IAC3C,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,oCAAoC;QACjD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC1B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAChC;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC;SACpC;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC3B;SACF;KACF,CAAA;AACH,CAAC,CAAA;AAED,MAAM,mBAAmB,GAAG,GAAY,EAAE;IACxC,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,4CAA4C;QACzD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC3B;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,OAAO;oBACb,aAAa;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,QAAQ,EAAE,CAAC,MAAM,CAAC;wBAClB,UAAU,EAAE;4BACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;4BACxB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;yBAChC;qBACF;iBACF;aACF;SACF;KACF,CAAA;AACH,CAAC,CAAA;AAED,MAAM,qBAAqB,GAAG,GAAY,EAAE;IAC1C,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,0BAA0B;QACvC,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC1B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC/B,aAAa;gBACb,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE;gBACpD,eAAe,EAAE,sBAAsB,EAAE;aAC1C;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,CAAC;SAC5C;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;SAC3C;KACF,CAAA;AACH,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,GAAY,EAAE;IACvC,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,qEAAqE;QACvE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,OAAO;oBACb,aAAa;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,QAAQ,EAAE,CAAC,MAAM,CAAC;wBAClB,UAAU,EAAE;4BACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;4BACxB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;yBAChC;qBACF;iBACF;aACF;SACF;KACF,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,OAAmC,EACnC,EAAE;IACF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;QAC1B,sBAAsB;QACtB,sBAAsB;QACtB,4BAA4B;QAC5B,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC;KACpD,CAAC,CAAA;IAEF,MAAM,kBAAkB,GAAG,cAAc,CAAC,WAAW,CAAC,CAAA;IACtD,MAAM,mBAAmB,GAAG,eAAe,CAAC,WAAW,CAAC,CAAA;IAExD,MAAM,gBAAgB,GAAG,GAAe,EAAE;QACxC,uCACK,kBAAkB,EAAE,KACvB,OAAO,EAAE,gBAAgB,CAAC,GAAS,EAAE;gBACnC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CACrD,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE;;oBACpB,IAAI,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;wBACnC,OAAO,GAAG,CAAA;oBACZ,CAAC;oBACD,MAAM,WAAW,GAAG,MAAA,OAAO,CAAC,MAAM,CAChC,sBAAsB,CACvB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,UAAU,CAAC,0CAAE,WAAW,CAAA;oBACxD,OAAO,GAAG,CAAC,MAAM,iBACf,IAAI,EAAE,UAAU,IACb,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EACvC,CAAA;gBACJ,CAAC,EACD,EAA8C,CAC/C,CAAA;gBACD,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAA;YACnC,CAAC,CAAA,CAAC,IACH;IACH,CAAC,CAAA;IAED,MAAM,oBAAoB,GAAG,GAAe,EAAE;QAC5C,uCACK,sBAAsB,EAAE,KAC3B,OAAO,EAAE,gBAAgB,CAAC,CAAO,KAAU,EAAE,EAAE;;gBAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAA;gBAC3B,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAA;gBACrC,MAAM,OAAO,GAAG,MAAA,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,0CAAG,WAAW,CAAC,CAAA;gBACvD,IACE,CAAC,OAAO;oBACR,kBAAkB,CAAC,MAAM,CAAC;oBAC1B,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,EACxC,CAAC;oBACD,OAAO,0BAA0B,EAAE,CAAA;gBACrC,CAAC;gBACD,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC;oBAC7C,CAAC,CAAC,6BAA6B,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;oBACtD,CAAC,CAAC,uCAAuC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;gBACzD,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAA;YACnC,CAAC,CAAA,CAAC,IACH;IACH,CAAC,CAAA;IAED,MAAM,iBAAiB,GAAG,GAAe,EAAE;QACzC,uCACK,mBAAmB,EAAE,KACxB,OAAO,EAAE,gBAAgB,CAAC,CAAO,KAAU,EAAE,EAAE;gBAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAA;gBAC3B,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC/B,OAAO,yBAAyB,EAAE,CAAA;gBACpC,CAAC;gBACD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;gBACjC,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC3C,OAAO,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAA;gBAC5C,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CACpD,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE;;oBAC9B,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;wBAClC,OAAO,GAAG,CAAA;oBACZ,CAAC;oBACD,IAAI,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC;wBAC7C,OAAO,GAAG,CAAA;oBACZ,CAAC;oBACD,MAAM,GAAG,mBACP,IAAI,EAAE,WAAW,IAEd,CAAC,CAAA,MAAA,OAAO,CAAC,MAAM,0CAAE,WAAW;wBAC7B,CAAC,CAAC,aAAa;4BACb,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE;wBAC7C,CAAC,CAAC,EAAE,CAAC,CACR,CAAA;oBACD,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBACxB,CAAC,EACD,EAA8C,CAC/C,CAAA;gBACD,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAA;YAClC,CAAC,CAAA,CAAC,IACH;IACH,CAAC,CAAA;IAED,MAAM,mBAAmB,GAAG,GAAe,EAAE;QAC3C,uCACK,qBAAqB,EAAE,KAC1B,OAAO,EAAE,gBAAgB,CAAC,CAAO,KAAU,EAAE,EAAE;;gBAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAA;gBAC3B,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAA;gBACrC,MAAM,OAAO,GAAG,MAAA,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,0CAAG,WAAW,CAAC,CAAA;gBACvD,IACE,CAAC,OAAO;oBACR,kBAAkB,CAAC,MAAM,CAAC;oBAC1B,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,EACxC,CAAC;oBACD,OAAO,0BAA0B,EAAE,CAAA;gBACrC,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,KAAK,CACnE,CAAC,CAAC,EAAE;oBACF,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;wBACrB,OAAO,CAAC,CAAA;oBACV,CAAC;oBACD,OAAO,iBAAiB,CACtB,oBAAoB,EACpB,6DAA6D,EAC7D,CAAC,CACF,CAAA;gBACH,CAAC,CACF,CAAA;gBACD,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAA;YAClC,CAAC,CAAA,CAAC,IACH;IACH,CAAC,CAAA;IAED,MAAM,gBAAgB,GAAG,GAAY,EAAE;QACrC,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,WAAW,EACT,iIAAiI;YACnI,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;YAC7D,aAAa;YACb,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE;SAC7D,CAAA;IACH,CAAC,CAAA;IAED,MAAM,cAAc,GAAG,GAAe,EAAE;QACtC,uCACK,gBAAgB,EAAE,KACrB,OAAO,EAAE,gBAAgB,CAAC,GAAS,EAAE;gBACnC,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,iBAAiB,CAAA;gBACxE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,UAAU,CAAA;gBAChE,MAAM,aAAa,GAAG,SAAS,CAAA;gBAC/B,MAAM,OAAO,GAAG;oBACd;wBACE,IAAI,EAAE,YAAY;wBAClB,KAAK,EAAE,UAAU;qBAClB;oBACD,GAAG,CAAC,iBAAiB;wBACnB,CAAC,CAAC;4BACE;gCACE,IAAI,EAAE,mBAAmB;gCACzB,KAAK,EAAE,iBAAiB;6BACzB;yBACF;wBACH,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,CAAC,CAAA,iBAAiB,aAAjB,iBAAiB,uBAAjB,iBAAiB,CAAE,aAAa;wBAClC,CAAC,CAAC,iBAAiB,CAAC,aAAa;wBACjC,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,aAAa;iBACjB,CAAA;gBACD,OAAO,iBAAiB,CAAC;oBACvB,OAAO;iBACR,CAAC,CAAA;YACJ,CAAC,CAAA,CAAC,IACH;IACH,CAAC,CAAA;IAED,OAAO;QACL,WAAW,EAAE,gBAAgB;QAC7B,eAAe,EAAE,oBAAoB;QACrC,YAAY,EAAE,iBAAiB;QAC/B,cAAc,EAAE,mBAAmB;QACnC,SAAS,EAAE,cAAc;KAC1B,CAAA;AACH,CAAC,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@node-in-layers/mcp-server",
   "type": "module",
-  "version": "2.1.15",
+  "version": "2.2.1",
   "description": "An MCP Server Node In Layers Package, generated by the Node In Layers Toolkit.",
   "main": "index.js",
   "scripts": {
@@ -65,7 +65,7 @@
   "dependencies": {
     "@l4t/mcp-ai": "^1.6.0",
     "@modelcontextprotocol/sdk": "^1.13.2",
-    "@node-in-layers/core": "^1.10.4",
+    "@node-in-layers/core": "^1.10.6",
     "express": "^5.1.0",
     "functional-models": "^3.6.0",
     "functional-models-openapi": "^3.0.2",

package/types.d.ts

@@ -5,6 +5,14 @@ import { Config, LogLevelNames, LayerContext } from '@node-in-layers/core';
 import { Express } from 'express';
 import { JsonAble } from 'functional-models';
 type Connection = ServerHttpConfig | ServerCliConfig | ServerSseConfig | ServerStatelessHttpConfig;
+export type SystemUseExample = Readonly<{
+    name: string;
+    description?: string;
+    value?: string;
+    tags?: string[];
+    details?: string;
+    example?: string;
+}>;
 /**
  * Configuration for the MCP server.
  * @interface
@@ -41,6 +49,15 @@ export type McpServerConfig = Readonly<{
          * myDomain.cruds.MyModel - hides a specific model
          */
         hiddenPaths?: string[];
+        /**
+         * Ability to set information about the system so that it can be fed to AI consumers.
+         *
+         */
+        systemDescription?: {
+            description?: string;
+            version?: string;
+            examplesOfUse?: ReadonlyArray<SystemUseExample>;
+        };
         /**
          * Logging configuration.
          */

package/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA8EA,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAgGA,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAA"}