@utaba/ucm-mcp-server 6.5.0 → 6.6.0

package/dist/tools/memory-graph/GraphCreateRelationshipsTool.js

@@ -0,0 +1,55 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { McpError, McpErrorCode } from '../../utils/McpErrorHandler.js';
+export class GraphCreateRelationshipsTool extends BaseToolController {
+    constructor(ucmClient, logger, publishingAuthorId) {
+        super(ucmClient, logger, publishingAuthorId);
+    }
+    get name() { return 'ucm_graph_create_relationships'; }
+    get description() {
+        return 'Create one or more relationships between entities in a Memory Graph. Each relationship requires a type (from vocabulary), source entity ID, and target entity ID. Pass a single item in the array for single operations.';
+    }
+    get inputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                memoryGraphId: {
+                    type: 'string',
+                    description: 'The Memory Graph ID'
+                },
+                relationships: {
+                    type: 'array',
+                    description: 'Array of relationships to create',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            relationshipType: { type: 'string', description: 'Relationship type (must exist in vocabulary)' },
+                            sourceEntityId: { type: 'string', description: 'Source entity ID' },
+                            targetEntityId: { type: 'string', description: 'Target entity ID' },
+                            properties: { type: 'object', description: 'Optional relationship properties' }
+                        },
+                        required: ['relationshipType', 'sourceEntityId', 'targetEntityId']
+                    }
+                }
+            },
+            required: ['memoryGraphId', 'relationships']
+        };
+    }
+    async handleExecute(params) {
+        const { memoryGraphId, relationships } = params;
+        this.logger.info('GraphCreateRelationshipsTool', `Creating ${relationships.length} relationships in graph: ${memoryGraphId}`);
+        try {
+            const result = await this.ucmClient.graphCreateRelationships(memoryGraphId, relationships);
+            return JSON.stringify(result);
+        }
+        catch (error) {
+            if (error.response?.status === 400) {
+                throw new McpError(McpErrorCode.InvalidParams, error.response.data?.message || 'Validation error');
+            }
+            if (error.response?.status === 404) {
+                throw new McpError(McpErrorCode.InvalidParams, `Entity or Memory Graph not found`);
+            }
+            throw new McpError(McpErrorCode.InternalError, `Failed to create relationships: ${error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=GraphCreateRelationshipsTool.js.map

package/dist/tools/memory-graph/GraphCreateTool.d.ts

@@ -0,0 +1,11 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
+import { ILogger } from '../../interfaces/ILogger.js';
+export declare class GraphCreateTool extends BaseToolController {
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
+    get name(): string;
+    get description(): string;
+    get inputSchema(): any;
+    protected handleExecute(params: any): Promise<any>;
+}
+//# sourceMappingURL=GraphCreateTool.d.ts.map

package/dist/tools/memory-graph/GraphCreateTool.js

@@ -0,0 +1,62 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { McpError, McpErrorCode } from '../../utils/McpErrorHandler.js';
+export class GraphCreateTool extends BaseToolController {
+    constructor(ucmClient, logger, publishingAuthorId) {
+        super(ucmClient, logger, publishingAuthorId);
+    }
+    get name() { return 'ucm_graph_create'; }
+    get description() {
+        return 'Create a new Memory Graph with a vocabulary template. Defaults to a personal graph. Set scope to \'organization\' to create an org-wide graph (requires Owner role). Call ucm_graph_list_templates first to see available templates.';
+    }
+    get inputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                label: {
+                    type: 'string',
+                    description: 'Display name for the new Memory Graph'
+                },
+                templateId: {
+                    type: 'string',
+                    description: 'Vocabulary template ID to use for the graph. Use ucm_graph_list_templates to see available templates.'
+                },
+                description: {
+                    type: 'string',
+                    description: 'Optional description of the Memory Graph purpose'
+                },
+                scope: {
+                    type: 'string',
+                    enum: ['personal', 'organization'],
+                    description: 'Graph ownership scope. "personal" (default) creates a graph owned by you. "organization" creates an org-wide graph (requires Owner role).'
+                }
+            },
+            required: ['label', 'templateId']
+        };
+    }
+    async handleExecute(params) {
+        const { label, templateId, description, scope } = params;
+        const resolvedScope = scope || 'personal';
+        this.logger.info('GraphCreateTool', `Creating ${resolvedScope} memory graph: ${label}`);
+        try {
+            const result = await this.ucmClient.createMemoryGraph({ label, templateId, description, scope: resolvedScope });
+            return JSON.stringify(result);
+        }
+        catch (error) {
+            if (error.response?.status === 400) {
+                const detail = error.response?.data?.message || 'Invalid parameters for graph creation';
+                throw new McpError(McpErrorCode.InvalidParams, detail);
+            }
+            if (error.response?.status === 403) {
+                throw new McpError(McpErrorCode.InvalidParams, 'Creating an organisation graph requires Owner role on the organisation.');
+            }
+            if (error.response?.status === 404) {
+                throw new McpError(McpErrorCode.InvalidParams, `Template not found: ${templateId}`);
+            }
+            if (error.response?.status === 503) {
+                throw new McpError(McpErrorCode.InternalError, `Deep Memory service is not configured`);
+            }
+            throw new McpError(McpErrorCode.InternalError, `Failed to create memory graph: ${error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=GraphCreateTool.js.map

package/dist/tools/memory-graph/GraphDeleteEntitiesTool.d.ts

@@ -0,0 +1,11 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
+import { ILogger } from '../../interfaces/ILogger.js';
+export declare class GraphDeleteEntitiesTool extends BaseToolController {
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
+    get name(): string;
+    get description(): string;
+    get inputSchema(): any;
+    protected handleExecute(params: any): Promise<any>;
+}
+//# sourceMappingURL=GraphDeleteEntitiesTool.d.ts.map

package/dist/tools/memory-graph/GraphDeleteEntitiesTool.js

@@ -0,0 +1,43 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { McpError, McpErrorCode } from '../../utils/McpErrorHandler.js';
+export class GraphDeleteEntitiesTool extends BaseToolController {
+    constructor(ucmClient, logger, publishingAuthorId) {
+        super(ucmClient, logger, publishingAuthorId);
+    }
+    get name() { return 'ucm_graph_delete_entities'; }
+    get description() {
+        return 'Delete one or more entities from a Memory Graph. Each deleted entity also has its relationships removed. Pass entity IDs as an array.';
+    }
+    get inputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                memoryGraphId: {
+                    type: 'string',
+                    description: 'The Memory Graph ID'
+                },
+                entityIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Array of entity IDs to delete'
+                }
+            },
+            required: ['memoryGraphId', 'entityIds']
+        };
+    }
+    async handleExecute(params) {
+        const { memoryGraphId, entityIds } = params;
+        this.logger.info('GraphDeleteEntitiesTool', `Deleting ${entityIds.length} entities from graph: ${memoryGraphId}`);
+        try {
+            const result = await this.ucmClient.graphDeleteEntities(memoryGraphId, entityIds);
+            return JSON.stringify(result);
+        }
+        catch (error) {
+            if (error.response?.status === 404) {
+                throw new McpError(McpErrorCode.InvalidParams, `Memory Graph not found`);
+            }
+            throw new McpError(McpErrorCode.InternalError, `Failed to delete entities: ${error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=GraphDeleteEntitiesTool.js.map

package/dist/tools/memory-graph/GraphDeleteRelationshipsTool.d.ts

@@ -0,0 +1,11 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
+import { ILogger } from '../../interfaces/ILogger.js';
+export declare class GraphDeleteRelationshipsTool extends BaseToolController {
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
+    get name(): string;
+    get description(): string;
+    get inputSchema(): any;
+    protected handleExecute(params: any): Promise<any>;
+}
+//# sourceMappingURL=GraphDeleteRelationshipsTool.d.ts.map

package/dist/tools/memory-graph/GraphDeleteRelationshipsTool.js

@@ -0,0 +1,43 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { McpError, McpErrorCode } from '../../utils/McpErrorHandler.js';
+export class GraphDeleteRelationshipsTool extends BaseToolController {
+    constructor(ucmClient, logger, publishingAuthorId) {
+        super(ucmClient, logger, publishingAuthorId);
+    }
+    get name() { return 'ucm_graph_delete_relationships'; }
+    get description() {
+        return 'Delete one or more relationships from a Memory Graph by their IDs. Pass relationship IDs as an array.';
+    }
+    get inputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                memoryGraphId: {
+                    type: 'string',
+                    description: 'The Memory Graph ID'
+                },
+                relationshipIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Array of relationship IDs to delete'
+                }
+            },
+            required: ['memoryGraphId', 'relationshipIds']
+        };
+    }
+    async handleExecute(params) {
+        const { memoryGraphId, relationshipIds } = params;
+        this.logger.info('GraphDeleteRelationshipsTool', `Deleting ${relationshipIds.length} relationships from graph: ${memoryGraphId}`);
+        try {
+            const result = await this.ucmClient.graphDeleteRelationships(memoryGraphId, relationshipIds);
+            return JSON.stringify(result);
+        }
+        catch (error) {
+            if (error.response?.status === 404) {
+                throw new McpError(McpErrorCode.InvalidParams, `Memory Graph not found`);
+            }
+            throw new McpError(McpErrorCode.InternalError, `Failed to delete relationships: ${error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=GraphDeleteRelationshipsTool.js.map

package/dist/tools/memory-graph/GraphExploreTool.d.ts

@@ -0,0 +1,11 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
+import { ILogger } from '../../interfaces/ILogger.js';
+export declare class GraphExploreTool extends BaseToolController {
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
+    get name(): string;
+    get description(): string;
+    get inputSchema(): any;
+    protected handleExecute(params: any): Promise<any>;
+}
+//# sourceMappingURL=GraphExploreTool.d.ts.map

package/dist/tools/memory-graph/GraphExploreTool.js

@@ -0,0 +1,71 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { McpError, McpErrorCode } from '../../utils/McpErrorHandler.js';
+export class GraphExploreTool extends BaseToolController {
+    constructor(ucmClient, logger, publishingAuthorId) {
+        super(ucmClient, logger, publishingAuthorId);
+    }
+    get name() { return 'ucm_graph_explore'; }
+    get description() {
+        return 'Explore the neighbourhood around an entity using BFS traversal (1-3 hops). Returns connected entities grouped by distance, with optional relationship/entity type filters.';
+    }
+    get inputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                memoryGraphId: {
+                    type: 'string',
+                    description: 'The Memory Graph ID'
+                },
+                entityId: {
+                    type: 'string',
+                    description: 'Starting entity ID for exploration'
+                },
+                depth: {
+                    type: 'number',
+                    description: 'Exploration depth: 1, 2, or 3 hops (default: 1)'
+                },
+                relationshipTypes: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Filter by relationship types'
+                },
+                entityTypes: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Filter by entity types'
+                },
+                direction: {
+                    type: 'string',
+                    enum: ['outbound', 'inbound', 'both'],
+                    description: 'Traversal direction (default: both)'
+                },
+                limitPerType: {
+                    type: 'number',
+                    description: 'Maximum results per relationship type (default: 10)'
+                }
+            },
+            required: ['memoryGraphId', 'entityId']
+        };
+    }
+    async handleExecute(params) {
+        const { memoryGraphId, entityId, depth, relationshipTypes, entityTypes, direction, limitPerType } = params;
+        this.logger.info('GraphExploreTool', `Exploring from entity ${entityId} in graph: ${memoryGraphId}`);
+        try {
+            const result = await this.ucmClient.graphExplore(memoryGraphId, {
+                entityId,
+                maxDepth: depth,
+                relationshipTypes,
+                entityTypes,
+                limit: limitPerType
+            });
+            return JSON.stringify(result);
+        }
+        catch (error) {
+            if (error.response?.status === 404) {
+                throw new McpError(McpErrorCode.InvalidParams, `Entity or Memory Graph not found`);
+            }
+            throw new McpError(McpErrorCode.InternalError, `Failed to explore neighbourhood: ${error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=GraphExploreTool.js.map

package/dist/tools/memory-graph/GraphFindEntitiesTool.d.ts

@@ -0,0 +1,11 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
+import { ILogger } from '../../interfaces/ILogger.js';
+export declare class GraphFindEntitiesTool extends BaseToolController {
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
+    get name(): string;
+    get description(): string;
+    get inputSchema(): any;
+    protected handleExecute(params: any): Promise<any>;
+}
+//# sourceMappingURL=GraphFindEntitiesTool.d.ts.map

package/dist/tools/memory-graph/GraphFindEntitiesTool.js

@@ -0,0 +1,66 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { McpError, McpErrorCode } from '../../utils/McpErrorHandler.js';
+export class GraphFindEntitiesTool extends BaseToolController {
+    constructor(ucmClient, logger, publishingAuthorId) {
+        super(ucmClient, logger, publishingAuthorId);
+    }
+    get name() { return 'ucm_graph_find_entities'; }
+    get description() {
+        return 'Find entities in a Memory Graph by label, type, or property filters. Supports pagination and detail levels (brief/summary/full).';
+    }
+    get inputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                memoryGraphId: {
+                    type: 'string',
+                    description: 'The Memory Graph ID'
+                },
+                searchTerm: {
+                    type: 'string',
+                    description: 'Search term to match against entity labels (partial match)'
+                },
+                entityTypes: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Filter by entity types (from vocabulary)'
+                },
+                detailLevel: {
+                    type: 'string',
+                    enum: ['brief', 'summary', 'full'],
+                    description: 'Detail level for returned entities (default: summary)'
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum results to return (default: 20, max: 100)'
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Pagination offset (default: 0)'
+                }
+            },
+            required: ['memoryGraphId']
+        };
+    }
+    async handleExecute(params) {
+        const { memoryGraphId, searchTerm, entityTypes, detailLevel, limit, offset } = params;
+        this.logger.info('GraphFindEntitiesTool', `Finding entities in graph: ${memoryGraphId}`);
+        try {
+            const result = await this.ucmClient.graphFindEntities(memoryGraphId, {
+                entityTypes,
+                searchTerm,
+                detailLevel,
+                offset,
+                limit
+            });
+            return JSON.stringify(result);
+        }
+        catch (error) {
+            if (error.response?.status === 404) {
+                throw new McpError(McpErrorCode.InvalidParams, `Memory Graph not found`);
+            }
+            throw new McpError(McpErrorCode.InternalError, `Failed to find entities: ${error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=GraphFindEntitiesTool.js.map

package/dist/tools/memory-graph/GraphFindPathsTool.d.ts

@@ -0,0 +1,11 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
+import { ILogger } from '../../interfaces/ILogger.js';
+export declare class GraphFindPathsTool extends BaseToolController {
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
+    get name(): string;
+    get description(): string;
+    get inputSchema(): any;
+    protected handleExecute(params: any): Promise<any>;
+}
+//# sourceMappingURL=GraphFindPathsTool.d.ts.map

package/dist/tools/memory-graph/GraphFindPathsTool.js

@@ -0,0 +1,60 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { McpError, McpErrorCode } from '../../utils/McpErrorHandler.js';
+export class GraphFindPathsTool extends BaseToolController {
+    constructor(ucmClient, logger, publishingAuthorId) {
+        super(ucmClient, logger, publishingAuthorId);
+    }
+    get name() { return 'ucm_graph_find_paths'; }
+    get description() {
+        return 'Find paths between two entities in a Memory Graph. Returns all paths up to the specified max depth with optional relationship/entity type filtering.';
+    }
+    get inputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                memoryGraphId: {
+                    type: 'string',
+                    description: 'The Memory Graph ID'
+                },
+                sourceEntityId: {
+                    type: 'string',
+                    description: 'Starting entity ID'
+                },
+                targetEntityId: {
+                    type: 'string',
+                    description: 'Target entity ID'
+                },
+                maxDepth: {
+                    type: 'number',
+                    description: 'Maximum path depth (3-5, default: 3)'
+                },
+                relationshipTypes: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Filter by relationship types'
+                }
+            },
+            required: ['memoryGraphId', 'sourceEntityId', 'targetEntityId']
+        };
+    }
+    async handleExecute(params) {
+        const { memoryGraphId, sourceEntityId, targetEntityId, maxDepth, relationshipTypes } = params;
+        this.logger.info('GraphFindPathsTool', `Finding paths in graph: ${memoryGraphId}`);
+        try {
+            const result = await this.ucmClient.graphFindPaths(memoryGraphId, {
+                sourceEntityId,
+                targetEntityId,
+                maxDepth,
+                relationshipTypes
+            });
+            return JSON.stringify(result);
+        }
+        catch (error) {
+            if (error.response?.status === 404) {
+                throw new McpError(McpErrorCode.InvalidParams, `Entity or Memory Graph not found`);
+            }
+            throw new McpError(McpErrorCode.InternalError, `Failed to find paths: ${error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=GraphFindPathsTool.js.map

package/dist/tools/memory-graph/GraphGetEntityTool.d.ts

@@ -0,0 +1,11 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
+import { ILogger } from '../../interfaces/ILogger.js';
+export declare class GraphGetEntityTool extends BaseToolController {
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
+    get name(): string;
+    get description(): string;
+    get inputSchema(): any;
+    protected handleExecute(params: any): Promise<any>;
+}
+//# sourceMappingURL=GraphGetEntityTool.d.ts.map

package/dist/tools/memory-graph/GraphGetEntityTool.js

@@ -0,0 +1,47 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { McpError, McpErrorCode } from '../../utils/McpErrorHandler.js';
+export class GraphGetEntityTool extends BaseToolController {
+    constructor(ucmClient, logger, publishingAuthorId) {
+        super(ucmClient, logger, publishingAuthorId);
+    }
+    get name() { return 'ucm_graph_get_entity'; }
+    get description() {
+        return 'Get full details of an entity including all properties, data, and provenance. Use the entityId from find_entities or explore results.';
+    }
+    get inputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                memoryGraphId: {
+                    type: 'string',
+                    description: 'The Memory Graph ID'
+                },
+                entityId: {
+                    type: 'string',
+                    description: 'The entity ID or slug to retrieve'
+                },
+                detailLevel: {
+                    type: 'string',
+                    enum: ['brief', 'summary', 'full'],
+                    description: 'Detail level (default: full)'
+                }
+            },
+            required: ['memoryGraphId', 'entityId']
+        };
+    }
+    async handleExecute(params) {
+        const { memoryGraphId, entityId, detailLevel } = params;
+        this.logger.info('GraphGetEntityTool', `Getting entity ${entityId} from graph: ${memoryGraphId}`);
+        try {
+            const result = await this.ucmClient.graphGetEntity(memoryGraphId, entityId, detailLevel);
+            return JSON.stringify(result);
+        }
+        catch (error) {
+            if (error.response?.status === 404) {
+                throw new McpError(McpErrorCode.InvalidParams, `Entity or Memory Graph not found`);
+            }
+            throw new McpError(McpErrorCode.InternalError, `Failed to get entity: ${error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=GraphGetEntityTool.js.map

package/dist/tools/memory-graph/GraphGetRelationshipsTool.d.ts

@@ -0,0 +1,11 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
+import { ILogger } from '../../interfaces/ILogger.js';
+export declare class GraphGetRelationshipsTool extends BaseToolController {
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
+    get name(): string;
+    get description(): string;
+    get inputSchema(): any;
+    protected handleExecute(params: any): Promise<any>;
+}
+//# sourceMappingURL=GraphGetRelationshipsTool.d.ts.map

package/dist/tools/memory-graph/GraphGetRelationshipsTool.js

@@ -0,0 +1,60 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { McpError, McpErrorCode } from '../../utils/McpErrorHandler.js';
+export class GraphGetRelationshipsTool extends BaseToolController {
+    constructor(ucmClient, logger, publishingAuthorId) {
+        super(ucmClient, logger, publishingAuthorId);
+    }
+    get name() { return 'ucm_graph_get_relationships'; }
+    get description() {
+        return 'Get relationships for an entity with optional type filtering and direction control (outbound, inbound, or both).';
+    }
+    get inputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                memoryGraphId: {
+                    type: 'string',
+                    description: 'The Memory Graph ID'
+                },
+                entityId: {
+                    type: 'string',
+                    description: 'The entity ID to get relationships for'
+                },
+                relationshipTypes: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Filter by relationship types (from vocabulary)'
+                },
+                direction: {
+                    type: 'string',
+                    enum: ['outbound', 'inbound', 'both'],
+                    description: 'Relationship direction (default: both)'
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum results (default: 50)'
+                }
+            },
+            required: ['memoryGraphId', 'entityId']
+        };
+    }
+    async handleExecute(params) {
+        const { memoryGraphId, entityId, relationshipTypes, direction, limit } = params;
+        this.logger.info('GraphGetRelationshipsTool', `Getting relationships for entity ${entityId}`);
+        try {
+            const result = await this.ucmClient.graphGetRelationships(memoryGraphId, entityId, {
+                direction,
+                relationshipTypes,
+                limit
+            });
+            return JSON.stringify(result);
+        }
+        catch (error) {
+            if (error.response?.status === 404) {
+                throw new McpError(McpErrorCode.InvalidParams, `Entity or Memory Graph not found`);
+            }
+            throw new McpError(McpErrorCode.InternalError, `Failed to get relationships: ${error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=GraphGetRelationshipsTool.js.map

package/dist/tools/memory-graph/GraphGetStatsTool.d.ts

@@ -0,0 +1,11 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
+import { ILogger } from '../../interfaces/ILogger.js';
+export declare class GraphGetStatsTool extends BaseToolController {
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
+    get name(): string;
+    get description(): string;
+    get inputSchema(): any;
+    protected handleExecute(params: any): Promise<any>;
+}
+//# sourceMappingURL=GraphGetStatsTool.d.ts.map