@carlonicora/nestjs-neo4jsonapi 1.110.3 → 1.112.0

package/dist/mcp/mcp.module.js

@@ -0,0 +1,59 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpModule = void 0;
+const common_1 = require("@nestjs/common");
+const agents_modules_1 = require("../agents/agents.modules");
+const search_documents_tool_1 = require("../agents/operator/tools/search-documents.tool");
+const oauth_module_1 = require("../foundations/oauth/oauth.module");
+const rbac_permission_module_1 = require("../foundations/rbac/rbac-permission.module");
+const mcp_controller_1 = require("./controllers/mcp.controller");
+const mcp_entity_write_service_1 = require("./services/mcp.entity.write.service");
+const mcp_generic_tools_service_1 = require("./services/mcp.generic.tools.service");
+const mcp_promoted_tools_factory_1 = require("./services/mcp.promoted.tools.factory");
+const mcp_server_factory_1 = require("./services/mcp.server.factory");
+const mcp_tool_registry_1 = require("./services/mcp.tool.registry");
+/**
+ * MCP (Model Context Protocol) server module.
+ *
+ * Mounted by the bootstrap gate (`BootstrapOptions.mcp === true`) and served
+ * at `POST /mcp`, OAuth-authenticated and RBAC-gated. Exports McpToolRegistry
+ * so consuming apps can contribute additional tools via the MCP_TOOLS token.
+ *
+ * Module wiring notes:
+ * - `RbacPermissionModule` supplies RbacPermissionService (the RbacModule
+ *   proper is a config-requiring dynamic module and cannot be imported here).
+ * - Audit is NOT wired here: AbstractService.create/put audits internally when
+ *   the concrete entity service injects AuditService, so MCP writes audit
+ *   exactly like HTTP writes.
+ * - `SearchDocumentsTool` is provided locally: OperatorModule declares but
+ *   does not export it, and importing OperatorModule would drag in its
+ *   forwardRef(AssistantModule) cycle. Its dependencies (ToolFactory,
+ *   ContextualiserService) are exported by AgentsModule's inner modules.
+ * - EntityServiceRegistry, Neo4jService, ClsService and ConfigService resolve
+ *   through the global core/cls/config modules.
+ */
+let McpModule = class McpModule {
+};
+exports.McpModule = McpModule;
+exports.McpModule = McpModule = __decorate([
+    (0, common_1.Module)({
+        imports: [oauth_module_1.OAuthModule, rbac_permission_module_1.RbacPermissionModule, agents_modules_1.AgentsModule],
+        controllers: [mcp_controller_1.McpController],
+        providers: [
+            mcp_server_factory_1.McpServerFactory,
+            mcp_tool_registry_1.McpToolRegistry,
+            mcp_generic_tools_service_1.McpGenericToolsService,
+            mcp_entity_write_service_1.McpEntityWriteService,
+            mcp_promoted_tools_factory_1.McpPromotedToolsFactory,
+            search_documents_tool_1.SearchDocumentsTool,
+        ],
+        exports: [mcp_tool_registry_1.McpToolRegistry],
+    })
+], McpModule);
+//# sourceMappingURL=mcp.module.js.map

package/dist/mcp/mcp.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.module.js","sourceRoot":"","sources":["../../src/mcp/mcp.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,6DAAwD;AACxD,0FAAqF;AACrF,oEAAgE;AAChE,uFAAkF;AAClF,iEAA6D;AAC7D,kFAA4E;AAC5E,oFAA8E;AAC9E,sFAAgF;AAChF,sEAAiE;AACjE,oEAA+D;AAE/D;;;;;;;;;;;;;;;;;;;GAmBG;AAcI,IAAM,SAAS,GAAf,MAAM,SAAS;CAAG,CAAA;AAAZ,8BAAS;oBAAT,SAAS;IAbrB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,0BAAW,EAAE,6CAAoB,EAAE,6BAAY,CAAC;QAC1D,WAAW,EAAE,CAAC,8BAAa,CAAC;QAC5B,SAAS,EAAE;YACT,qCAAgB;YAChB,mCAAe;YACf,kDAAsB;YACtB,gDAAqB;YACrB,oDAAuB;YACvB,2CAAmB;SACpB;QACD,OAAO,EAAE,CAAC,mCAAe,CAAC;KAC3B,CAAC;GACW,SAAS,CAAG"}

package/dist/mcp/services/mcp.entity.write.service.d.ts

@@ -0,0 +1,79 @@
+import { GraphCatalogService } from "../../agents/graph/services/graph.catalog.service";
+import { EntityServiceRegistry } from "../../common/registries/entity.service.registry";
+import { RbacPermissionService } from "../../foundations/rbac/services/rbac-permission.service";
+import type { McpToolDefinition, McpToolResult, McpUserContext } from "../interfaces/mcp.tool.interface";
+/**
+ * MCP write executors (C4): create/update entities and add/remove to-many
+ * relationship items for any JSON:API type registered in EntityServiceRegistry.
+ *
+ * Every write is gated by the catalog (type visible to the user's modules) and
+ * RBAC (`create`/`update` permission on the entity's module), dispatched through
+ * the framework's `AbstractService.*FromDTO` path (never hand-built JSON:API
+ * beyond the `JsonApiDTOData` framework type). Audit is NOT performed here:
+ * `AbstractService.create/put` audits internally when the concrete entity
+ * service injects AuditService, so MCP writes audit exactly like HTTP writes.
+ */
+export declare class McpEntityWriteService {
+    private readonly registry;
+    private readonly catalog;
+    private readonly rbac;
+    constructor(registry: EntityServiceRegistry, catalog: GraphCatalogService, rbac: RbacPermissionService);
+    /**
+     * The four write McpToolDefinitions (all `readOnly: false`) with hand-written
+     * JSON Schemas matching the C4 method params. Consumed by McpGenericToolsService.
+     */
+    buildTools(_ctx: McpUserContext): McpToolDefinition[];
+    /** Create a new entity of the given type. RBAC action: `create`. */
+    createEntity(params: {
+        type: string;
+        attributes: Record<string, unknown>;
+        relationships?: Record<string, {
+            data: Array<{
+                type: string;
+                id: string;
+            }>;
+        }>;
+    }, ctx: McpUserContext): Promise<McpToolResult>;
+    /**
+     * Update an existing entity. RBAC action: `update`.
+     *
+     * PATCH semantics via `patchFromDTO` — only the provided attributes change.
+     * Deliberately NOT `putFromDTO`: the framework's PUT maps every descriptor
+     * relationship and treats the ones absent from the DTO as "delete all
+     * edges". The HTTP path is safe because the frontend model always sends the
+     * complete relationship set on PUT, but an MCP caller sends attributes only —
+     * a PUT here would silently strip every mutable relationship off the record.
+     */
+    updateEntity(params: {
+        type: string;
+        id: string;
+        attributes: Record<string, unknown>;
+    }, ctx: McpUserContext): Promise<McpToolResult>;
+    /** Add items to a to-many relationship. RBAC action: `update`. */
+    addRelationship(params: {
+        type: string;
+        id: string;
+        relationship: string;
+        relatedType: string;
+        relatedIds: string[];
+    }, ctx: McpUserContext): Promise<McpToolResult>;
+    /** Remove items from a to-many relationship. RBAC action: `update`. */
+    removeRelationship(params: {
+        type: string;
+        id: string;
+        relationship: string;
+        relatedType: string;
+        relatedIds: string[];
+    }, ctx: McpUserContext): Promise<McpToolResult>;
+    /**
+     * Shared gate: catalog visibility (unknown_type), RBAC (forbidden), and
+     * service registration (unknown_type).
+     */
+    private gate;
+    /**
+     * Rejects attribute keys that are not in the entity's catalog field list.
+     * Catalog fields are a CatalogField[] array — keys are the `name` property.
+     */
+    private unknownAttributes;
+}
+//# sourceMappingURL=mcp.entity.write.service.d.ts.map

package/dist/mcp/services/mcp.entity.write.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.entity.write.service.d.ts","sourceRoot":"","sources":["../../../src/mcp/services/mcp.entity.write.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mDAAmD,CAAC;AACxF,OAAO,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAExF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yDAAyD,CAAC;AAChG,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAMzG;;;;;;;;;;GAUG;AACH,qBACa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAFJ,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,qBAAqB;IAG9C;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,iBAAiB,EAAE;IAsHrD,oEAAoE;IAC9D,YAAY,CAChB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC,CAAC;KAC/E,EACD,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,aAAa,CAAC;IAoBzB;;;;;;;;;OASG;IACG,YAAY,CAChB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EACzE,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,aAAa,CAAC;IAiBzB,kEAAkE;IAC5D,eAAe,CACnB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,EACrG,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,aAAa,CAAC;IAiBzB,uEAAuE;IACjE,kBAAkB,CACtB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,EACrG,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,aAAa,CAAC;IAiBzB;;;OAGG;YACW,IAAI;IA0BlB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CAW1B"}

package/dist/mcp/services/mcp.entity.write.service.js

@@ -0,0 +1,270 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpEntityWriteService = void 0;
+const common_1 = require("@nestjs/common");
+const node_crypto_1 = require("node:crypto");
+const graph_catalog_service_1 = require("../../agents/graph/services/graph.catalog.service");
+const entity_service_registry_1 = require("../../common/registries/entity.service.registry");
+const rbac_permission_service_1 = require("../../foundations/rbac/services/rbac-permission.service");
+const mcp_errors_1 = require("./mcp.errors");
+const UPDATE_SEMANTICS = "Partial update: only the attributes you provide are changed; omitted attributes and all relationships are left untouched. Use add_relationship/remove_relationship to change relationships.";
+/**
+ * MCP write executors (C4): create/update entities and add/remove to-many
+ * relationship items for any JSON:API type registered in EntityServiceRegistry.
+ *
+ * Every write is gated by the catalog (type visible to the user's modules) and
+ * RBAC (`create`/`update` permission on the entity's module), dispatched through
+ * the framework's `AbstractService.*FromDTO` path (never hand-built JSON:API
+ * beyond the `JsonApiDTOData` framework type). Audit is NOT performed here:
+ * `AbstractService.create/put` audits internally when the concrete entity
+ * service injects AuditService, so MCP writes audit exactly like HTTP writes.
+ */
+let McpEntityWriteService = class McpEntityWriteService {
+    constructor(registry, catalog, rbac) {
+        this.registry = registry;
+        this.catalog = catalog;
+        this.rbac = rbac;
+    }
+    /**
+     * The four write McpToolDefinitions (all `readOnly: false`) with hand-written
+     * JSON Schemas matching the C4 method params. Consumed by McpGenericToolsService.
+     */
+    buildTools(_ctx) {
+        const typeProperty = {
+            type: "string",
+            description: 'JSON:API entity type (plural, e.g. "orders"). Call describe_entity first for the field list.',
+        };
+        const idProperty = { type: "string", description: "The id of the target record." };
+        return [
+            {
+                name: "create_entity",
+                description: "Create a new record of the given JSON:API entity type. " +
+                    "Call describe_entity first to learn the valid attributes and relationships.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        type: typeProperty,
+                        attributes: {
+                            type: "object",
+                            description: "Attribute values keyed by field name (see describe_entity).",
+                        },
+                        relationships: {
+                            type: "object",
+                            description: "Optional JSON:API relationships keyed by relationship name.",
+                            additionalProperties: {
+                                type: "object",
+                                properties: {
+                                    data: {
+                                        type: "array",
+                                        items: {
+                                            type: "object",
+                                            properties: { type: { type: "string" }, id: { type: "string" } },
+                                            required: ["type", "id"],
+                                        },
+                                    },
+                                },
+                                required: ["data"],
+                            },
+                        },
+                    },
+                    required: ["type", "attributes"],
+                },
+                readOnly: false,
+                execute: (input, ctx) => this.createEntity(input, ctx),
+            },
+            {
+                name: "update_entity",
+                description: `Update an existing record. ${UPDATE_SEMANTICS}`,
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        type: typeProperty,
+                        id: idProperty,
+                        attributes: {
+                            type: "object",
+                            description: `The attribute values to change. ${UPDATE_SEMANTICS}`,
+                        },
+                    },
+                    required: ["type", "id", "attributes"],
+                },
+                readOnly: false,
+                execute: (input, ctx) => this.updateEntity(input, ctx),
+            },
+            {
+                name: "add_relationship",
+                description: "Add one or more related records to a to-many relationship of an existing record. " +
+                    "Call describe_entity first for the relationship names.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        type: typeProperty,
+                        id: idProperty,
+                        relationship: { type: "string", description: "Relationship name on the entity (see describe_entity)." },
+                        relatedType: { type: "string", description: "JSON:API type of the related records." },
+                        relatedIds: { type: "array", items: { type: "string" }, minItems: 1 },
+                    },
+                    required: ["type", "id", "relationship", "relatedType", "relatedIds"],
+                },
+                readOnly: false,
+                execute: (input, ctx) => this.addRelationship(input, ctx),
+            },
+            {
+                name: "remove_relationship",
+                description: "Remove one or more related records from a to-many relationship of an existing record.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        type: typeProperty,
+                        id: idProperty,
+                        relationship: { type: "string", description: "Relationship name on the entity (see describe_entity)." },
+                        relatedType: { type: "string", description: "JSON:API type of the related records." },
+                        relatedIds: { type: "array", items: { type: "string" }, minItems: 1 },
+                    },
+                    required: ["type", "id", "relationship", "relatedType", "relatedIds"],
+                },
+                readOnly: false,
+                execute: (input, ctx) => this.removeRelationship(input, ctx),
+            },
+        ];
+    }
+    /** Create a new entity of the given type. RBAC action: `create`. */
+    async createEntity(params, ctx) {
+        const gate = await this.gate(params.type, "create", ctx);
+        if ("error" in gate)
+            return gate.error;
+        const { entity, service } = gate;
+        const invalid = this.unknownAttributes(entity, params.attributes);
+        if (invalid)
+            return invalid;
+        try {
+            const data = {
+                id: (0, node_crypto_1.randomUUID)(),
+                type: params.type,
+                attributes: params.attributes,
+                ...(params.relationships ? { relationships: params.relationships } : {}),
+            };
+            const result = await service.createFromDTO({ data });
+            return { content: [{ type: "text", text: JSON.stringify(result) }] };
+        }
+        catch (e) {
+            return (0, mcp_errors_1.mcpError)(e);
+        }
+    }
+    /**
+     * Update an existing entity. RBAC action: `update`.
+     *
+     * PATCH semantics via `patchFromDTO` — only the provided attributes change.
+     * Deliberately NOT `putFromDTO`: the framework's PUT maps every descriptor
+     * relationship and treats the ones absent from the DTO as "delete all
+     * edges". The HTTP path is safe because the frontend model always sends the
+     * complete relationship set on PUT, but an MCP caller sends attributes only —
+     * a PUT here would silently strip every mutable relationship off the record.
+     */
+    async updateEntity(params, ctx) {
+        const gate = await this.gate(params.type, "update", ctx);
+        if ("error" in gate)
+            return gate.error;
+        const { entity, service } = gate;
+        const invalid = this.unknownAttributes(entity, params.attributes);
+        if (invalid)
+            return invalid;
+        try {
+            const before = await service.findRecordById({ id: params.id });
+            if (!before)
+                return (0, mcp_errors_1.mcpFlatError)("not_found", `No ${params.type} record with id ${params.id}.`);
+            const data = { id: params.id, type: params.type, attributes: params.attributes };
+            const result = await service.patchFromDTO({ data });
+            return { content: [{ type: "text", text: JSON.stringify(result) }] };
+        }
+        catch (e) {
+            return (0, mcp_errors_1.mcpError)(e);
+        }
+    }
+    /** Add items to a to-many relationship. RBAC action: `update`. */
+    async addRelationship(params, ctx) {
+        const gate = await this.gate(params.type, "update", ctx);
+        if ("error" in gate)
+            return gate.error;
+        const { service } = gate;
+        try {
+            const data = params.relatedIds.map((id) => ({ type: params.relatedType, id }));
+            const result = await service.addToRelationshipFromDTO({
+                id: params.id,
+                relationship: params.relationship,
+                data,
+            });
+            return { content: [{ type: "text", text: JSON.stringify(result) }] };
+        }
+        catch (e) {
+            return (0, mcp_errors_1.mcpError)(e);
+        }
+    }
+    /** Remove items from a to-many relationship. RBAC action: `update`. */
+    async removeRelationship(params, ctx) {
+        const gate = await this.gate(params.type, "update", ctx);
+        if ("error" in gate)
+            return gate.error;
+        const { service } = gate;
+        try {
+            const data = params.relatedIds.map((id) => ({ type: params.relatedType, id }));
+            const result = await service.removeFromRelationshipFromDTO({
+                id: params.id,
+                relationship: params.relationship,
+                data,
+            });
+            return { content: [{ type: "text", text: JSON.stringify(result) }] };
+        }
+        catch (e) {
+            return (0, mcp_errors_1.mcpError)(e);
+        }
+    }
+    /**
+     * Shared gate: catalog visibility (unknown_type), RBAC (forbidden), and
+     * service registration (unknown_type).
+     */
+    async gate(type, action, ctx) {
+        const entity = this.catalog.getEntityDetail(type, ctx.userModuleIds);
+        if (!entity) {
+            return {
+                error: (0, mcp_errors_1.mcpFlatError)("unknown_type", `Unknown or inaccessible entity type: ${type}. Call describe_entity first.`),
+            };
+        }
+        if (!(await this.rbac.can({ userId: ctx.userId, moduleId: entity.moduleId, action }))) {
+            return { error: (0, mcp_errors_1.mcpFlatError)("forbidden", `You lack ${action} permission on ${type}.`) };
+        }
+        const service = this.registry.get(type);
+        if (!service) {
+            return { error: (0, mcp_errors_1.mcpFlatError)("unknown_type", `No service registered for ${type}.`) };
+        }
+        return { entity, service };
+    }
+    /**
+     * Rejects attribute keys that are not in the entity's catalog field list.
+     * Catalog fields are a CatalogField[] array — keys are the `name` property.
+     */
+    unknownAttributes(entity, attributes) {
+        const known = new Set(entity.fields.map((f) => f.name));
+        const unknown = Object.keys(attributes).filter((k) => !known.has(k));
+        if (unknown.length) {
+            return (0, mcp_errors_1.mcpFlatError)("validation_failed", `Unknown attributes: ${unknown.join(", ")}. Call describe_entity("${entity.type}") for the field list.`);
+        }
+        return null;
+    }
+};
+exports.McpEntityWriteService = McpEntityWriteService;
+exports.McpEntityWriteService = McpEntityWriteService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [entity_service_registry_1.EntityServiceRegistry,
+        graph_catalog_service_1.GraphCatalogService,
+        rbac_permission_service_1.RbacPermissionService])
+], McpEntityWriteService);
+//# sourceMappingURL=mcp.entity.write.service.js.map

package/dist/mcp/services/mcp.entity.write.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.entity.write.service.js","sourceRoot":"","sources":["../../../src/mcp/services/mcp.entity.write.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,6CAAyC;AAEzC,6FAAwF;AACxF,6FAAwF;AAExF,qGAAgG;AAEhG,6CAAsD;AAEtD,MAAM,gBAAgB,GACpB,6LAA6L,CAAC;AAEhM;;;;;;;;;;GAUG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,YACmB,QAA+B,EAC/B,OAA4B,EAC5B,IAA2B;QAF3B,aAAQ,GAAR,QAAQ,CAAuB;QAC/B,YAAO,GAAP,OAAO,CAAqB;QAC5B,SAAI,GAAJ,IAAI,CAAuB;IAC3C,CAAC;IAEJ;;;OAGG;IACH,UAAU,CAAC,IAAoB;QAC7B,MAAM,YAAY,GAAG;YACnB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8FAA8F;SAC5G,CAAC;QACF,MAAM,UAAU,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE,CAAC;QACnF,OAAO;YACL;gBACE,IAAI,EAAE,eAAe;gBACrB,WAAW,EACT,yDAAyD;oBACzD,6EAA6E;gBAC/E,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE,YAAY;wBAClB,UAAU,EAAE;4BACV,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,6DAA6D;yBAC3E;wBACD,aAAa,EAAE;4BACb,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,6DAA6D;4BAC1E,oBAAoB,EAAE;gCACpB,IAAI,EAAE,QAAQ;gCACd,UAAU,EAAE;oCACV,IAAI,EAAE;wCACJ,IAAI,EAAE,OAAO;wCACb,KAAK,EAAE;4CACL,IAAI,EAAE,QAAQ;4CACd,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;4CAChE,QAAQ,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC;yCACzB;qCACF;iCACF;gCACD,QAAQ,EAAE,CAAC,MAAM,CAAC;6BACnB;yBACF;qBACF;oBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC;iBACjC;gBACD,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CACtB,IAAI,CAAC,YAAY,CACf,KAIC,EACD,GAAG,CACJ;aACJ;YACD;gBACE,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,8BAA8B,gBAAgB,EAAE;gBAC7D,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE,YAAY;wBAClB,EAAE,EAAE,UAAU;wBACd,UAAU,EAAE;4BACV,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,mCAAmC,gBAAgB,EAAE;yBACnE;qBACF;oBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC;iBACvC;gBACD,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CACtB,IAAI,CAAC,YAAY,CAAC,KAA0E,EAAE,GAAG,CAAC;aACrG;YACD;gBACE,IAAI,EAAE,kBAAkB;gBACxB,WAAW,EACT,mFAAmF;oBACnF,wDAAwD;gBAC1D,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE,YAAY;wBAClB,EAAE,EAAE,UAAU;wBACd,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wDAAwD,EAAE;wBACvG,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;wBACrF,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE;qBACtE;oBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,CAAC;iBACtE;gBACD,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CACtB,IAAI,CAAC,eAAe,CAClB,KAAsG,EACtG,GAAG,CACJ;aACJ;YACD;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,WAAW,EAAE,uFAAuF;gBACpG,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE,YAAY;wBAClB,EAAE,EAAE,UAAU;wBACd,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wDAAwD,EAAE;wBACvG,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;wBACrF,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE;qBACtE;oBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,CAAC;iBACtE;gBACD,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CACtB,IAAI,CAAC,kBAAkB,CACrB,KAAsG,EACtG,GAAG,CACJ;aACJ;SACF,CAAC;IACJ,CAAC;IAED,oEAAoE;IACpE,KAAK,CAAC,YAAY,CAChB,MAIC,EACD,GAAmB;QAEnB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QACzD,IAAI,OAAO,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QACvC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAClE,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,IAAI,GAAmB;gBAC3B,EAAE,EAAE,IAAA,wBAAU,GAAE;gBAChB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzE,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YACrD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QACvE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,IAAA,qBAAQ,EAAC,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,YAAY,CAChB,MAAyE,EACzE,GAAmB;QAEnB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QACzD,IAAI,OAAO,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QACvC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAClE,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/D,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAA,yBAAY,EAAC,WAAW,EAAE,MAAM,MAAM,CAAC,IAAI,mBAAmB,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;YAChG,MAAM,IAAI,GAAmB,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;YACjG,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QACvE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,IAAA,qBAAQ,EAAC,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,KAAK,CAAC,eAAe,CACnB,MAAqG,EACrG,GAAmB;QAEnB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QACzD,IAAI,OAAO,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QACvC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;YAC/E,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,wBAAwB,CAAC;gBACpD,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,IAAI;aACL,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QACvE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,IAAA,qBAAQ,EAAC,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,kBAAkB,CACtB,MAAqG,EACrG,GAAmB;QAEnB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QACzD,IAAI,OAAO,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QACvC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;YAC/E,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,6BAA6B,CAAC;gBACzD,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,IAAI;aACL,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QACvE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,IAAA,qBAAQ,EAAC,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,IAAI,CAChB,IAAY,EACZ,MAA2B,EAC3B,GAAmB;QAInB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;QACrE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,KAAK,EAAE,IAAA,yBAAY,EACjB,cAAc,EACd,wCAAwC,IAAI,+BAA+B,CAC5E;aACF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC;YACtF,OAAO,EAAE,KAAK,EAAE,IAAA,yBAAY,EAAC,WAAW,EAAE,YAAY,MAAM,kBAAkB,IAAI,GAAG,CAAC,EAAE,CAAC;QAC3F,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,KAAK,EAAE,IAAA,yBAAY,EAAC,cAAc,EAAE,6BAA6B,IAAI,GAAG,CAAC,EAAE,CAAC;QACvF,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACK,iBAAiB,CAAC,MAAqB,EAAE,UAAmC;QAClF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,IAAA,yBAAY,EACjB,mBAAmB,EACnB,uBAAuB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B,MAAM,CAAC,IAAI,wBAAwB,CACxG,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AAlRY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;qCAGkB,+CAAqB;QACtB,2CAAmB;QACtB,+CAAqB;GAJnC,qBAAqB,CAkRjC"}

package/dist/mcp/services/mcp.errors.d.ts

@@ -0,0 +1,24 @@
+import type { McpToolResult } from "../interfaces/mcp.tool.interface";
+/**
+ * MCP tool error codes (C10). Every executor failure is returned to the MCP
+ * client as a FLAT JSON payload `{ code, message, ...meta }` — mirroring the
+ * flat-error convention used by the HTTP layer's HttpExceptionFilter.
+ */
+export type McpErrorCode = "unknown_type" | "forbidden" | "validation_failed" | "not_found" | "internal";
+/**
+ * Maps an unknown thrown value to a flat MCP error result.
+ *
+ * - `HttpException` → status-derived code (404 → not_found, 403 → forbidden,
+ *   400/422 → validation_failed, anything else → internal)
+ * - `ZodError` → validation_failed with per-issue `issues` meta
+ * - other `Error` → internal with the error message
+ *
+ * Never includes stack traces.
+ */
+export declare function mcpError(e: unknown): McpToolResult;
+/**
+ * Builds a flat MCP error result directly from a code + message (+ optional meta).
+ * The payload shape is intentionally flat: `{ code, message, ...meta }`.
+ */
+export declare function mcpFlatError(code: string, message: string, meta?: Record<string, unknown>): McpToolResult;
+//# sourceMappingURL=mcp.errors.d.ts.map

package/dist/mcp/services/mcp.errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.errors.d.ts","sourceRoot":"","sources":["../../../src/mcp/services/mcp.errors.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,WAAW,GAAG,mBAAmB,GAAG,WAAW,GAAG,UAAU,CAAC;AAEzG;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,CAuBlD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,aAAa,CAE7G"}

package/dist/mcp/services/mcp.errors.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpError = mcpError;
+exports.mcpFlatError = mcpFlatError;
+const common_1 = require("@nestjs/common");
+const zod_1 = require("zod");
+/**
+ * Maps an unknown thrown value to a flat MCP error result.
+ *
+ * - `HttpException` → status-derived code (404 → not_found, 403 → forbidden,
+ *   400/422 → validation_failed, anything else → internal)
+ * - `ZodError` → validation_failed with per-issue `issues` meta
+ * - other `Error` → internal with the error message
+ *
+ * Never includes stack traces.
+ */
+function mcpError(e) {
+    let code = "internal";
+    let message = "Unexpected error";
+    let meta = {};
+    if (e instanceof common_1.HttpException) {
+        const status = e.getStatus();
+        code =
+            status === 404
+                ? "not_found"
+                : status === 403
+                    ? "forbidden"
+                    : status === 400 || status === 422
+                        ? "validation_failed"
+                        : "internal";
+        message = e.message;
+    }
+    else if (e instanceof zod_1.ZodError) {
+        code = "validation_failed";
+        message = "Input validation failed";
+        meta = { issues: e.issues.map((i) => ({ path: i.path.join("."), message: i.message })) };
+    }
+    else if (e instanceof Error) {
+        message = e.message;
+    }
+    return mcpFlatError(code, message, meta);
+}
+/**
+ * Builds a flat MCP error result directly from a code + message (+ optional meta).
+ * The payload shape is intentionally flat: `{ code, message, ...meta }`.
+ */
+function mcpFlatError(code, message, meta = {}) {
+    return { isError: true, content: [{ type: "text", text: JSON.stringify({ code, message, ...meta }) }] };
+}
+//# sourceMappingURL=mcp.errors.js.map

package/dist/mcp/services/mcp.errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.errors.js","sourceRoot":"","sources":["../../../src/mcp/services/mcp.errors.ts"],"names":[],"mappings":";;AAqBA,4BAuBC;AAMD,oCAEC;AApDD,2CAA+C;AAC/C,6BAA+B;AAU/B;;;;;;;;;GASG;AACH,SAAgB,QAAQ,CAAC,CAAU;IACjC,IAAI,IAAI,GAAiB,UAAU,CAAC;IACpC,IAAI,OAAO,GAAG,kBAAkB,CAAC;IACjC,IAAI,IAAI,GAA4B,EAAE,CAAC;IACvC,IAAI,CAAC,YAAY,sBAAa,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC;QAC7B,IAAI;YACF,MAAM,KAAK,GAAG;gBACZ,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,MAAM,KAAK,GAAG;oBACd,CAAC,CAAC,WAAW;oBACb,CAAC,CAAC,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;wBAChC,CAAC,CAAC,mBAAmB;wBACrB,CAAC,CAAC,UAAU,CAAC;QACrB,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;IACtB,CAAC;SAAM,IAAI,CAAC,YAAY,cAAQ,EAAE,CAAC;QACjC,IAAI,GAAG,mBAAmB,CAAC;QAC3B,OAAO,GAAG,yBAAyB,CAAC;QACpC,IAAI,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC;IAC3F,CAAC;SAAM,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;QAC9B,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;IACtB,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,IAAY,EAAE,OAAe,EAAE,OAAgC,EAAE;IAC5F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AAC1G,CAAC"}

package/dist/mcp/services/mcp.generic.tools.service.d.ts

@@ -0,0 +1,26 @@
+import { DescribeEntityTool } from "../../agents/graph/tools/describe-entity.tool";
+import { ReadEntityTool } from "../../agents/graph/tools/read-entity.tool";
+import { ResolveEntityTool } from "../../agents/graph/tools/resolve-entity.tool";
+import { SearchEntitiesTool } from "../../agents/graph/tools/search-entities.tool";
+import { TraverseTool } from "../../agents/graph/tools/traverse.tool";
+import { SearchDocumentsTool } from "../../agents/operator/tools/search-documents.tool";
+import { McpToolDefinition, McpUserContext } from "../interfaces/mcp.tool.interface";
+import { McpEntityWriteService } from "./mcp.entity.write.service";
+/**
+ * Builds the generic MCP tool set for one authenticated request:
+ * the five graph read tools, the document-retrieval tool, and the four
+ * entity write tools contributed by McpEntityWriteService.
+ */
+export declare class McpGenericToolsService {
+    private readonly resolveEntityTool;
+    private readonly describeEntityTool;
+    private readonly searchEntitiesTool;
+    private readonly readEntityTool;
+    private readonly traverseTool;
+    private readonly searchDocumentsTool;
+    private readonly writeService;
+    constructor(resolveEntityTool: ResolveEntityTool, describeEntityTool: DescribeEntityTool, searchEntitiesTool: SearchEntitiesTool, readEntityTool: ReadEntityTool, traverseTool: TraverseTool, searchDocumentsTool: SearchDocumentsTool, writeService: McpEntityWriteService);
+    /** Builds the per-request generic tool definitions (read tools + write tools). */
+    build(ctx: McpUserContext): McpToolDefinition[];
+}
+//# sourceMappingURL=mcp.generic.tools.service.d.ts.map

package/dist/mcp/services/mcp.generic.tools.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.generic.tools.service.d.ts","sourceRoot":"","sources":["../../../src/mcp/services/mcp.generic.tools.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAA6B,MAAM,+CAA+C,CAAC;AAC9G,OAAO,EAAE,cAAc,EAAyB,MAAM,2CAA2C,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAA4B,MAAM,8CAA8C,CAAC;AAC3G,OAAO,EAAE,kBAAkB,EAA6B,MAAM,+CAA+C,CAAC;AAE9G,OAAO,EAAE,YAAY,EAAuB,MAAM,wCAAwC,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAA8B,MAAM,mDAAmD,CAAC;AACpH,OAAO,EAAE,iBAAiB,EAAiB,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEpG,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAgBnE;;;;GAIG;AACH,qBACa,sBAAsB;IAE/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY;gBANZ,iBAAiB,EAAE,iBAAiB,EACpC,kBAAkB,EAAE,kBAAkB,EACtC,kBAAkB,EAAE,kBAAkB,EACtC,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,YAAY,EAC1B,mBAAmB,EAAE,mBAAmB,EACxC,YAAY,EAAE,qBAAqB;IAGtD,kFAAkF;IAClF,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,iBAAiB,EAAE;CA2EhD"}