@utaba/ucm-mcp-server 5.0.0 → 5.1.0

package/dist/server/ToolRegistry.js

@@ -16,13 +16,14 @@ import { DeleteArtifactTool } from '../tools/core/DeleteArtifactTool.js';
 import { GetArtifactVersionsTool } from '../tools/core/GetArtifactVersionsTool.js';
 import { SearchArtifactsTool } from '../tools/core/SearchArtifactsTool.js';
 import { EditArtifactMetadataTool } from '../tools/core/EditArtifactMetadataTool.js';
+import { MoveArtifactTool } from '../tools/core/MoveArtifactTool.js';
 // Import repository tools
 import { CreateRepositoryTool } from '../tools/repository/CreateRepositoryTool.js';
 import { GetRepositoryTool } from '../tools/repository/GetRepositoryTool.js';
 import { UpdateRepositoryTool } from '../tools/repository/UpdateRepositoryTool.js';
 import { DeleteRepositoryGuidanceTool } from '../tools/repository/DeleteRepositoryGuidanceTool.js';
 // Import connection/SharePoint tools
-import { SharePointListConnectionsTool as ListConnectionsTool } from '../tools/sharepoint/SharePointListConnectionsTool.js';
+import { ListConnectionsTool } from '../tools/sharepoint/SharePointListConnectionsTool.js';
 // DEPRECATED: Legacy SharePoint tools - use ucm_call_remote_tool via unified gateway instead
 // Commented out 2026-02-13 - pending confirmation that unified gateway works correctly
 // import { SharePointSearchTool } from '../tools/sharepoint/SharePointSearchTool.js';
@@ -68,6 +69,7 @@ export class ToolRegistry {
         this.registerTool(new GetArtifactVersionsTool(this.ucmClient, this.logger, this.authorId));
         this.registerTool(new SearchArtifactsTool(this.ucmClient, this.logger, this.authorId));
         this.registerTool(new EditArtifactMetadataTool(this.ucmClient, this.logger, this.authorId));
+        this.registerTool(new MoveArtifactTool(this.ucmClient, this.logger, this.authorId));
         // Register repository tools
         this.registerTool(new CreateRepositoryTool(this.ucmClient, this.logger, this.authorId));
         this.registerTool(new GetRepositoryTool(this.ucmClient, this.logger, this.authorId));

package/dist/tools/core/MoveArtifactTool.d.ts

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

package/dist/tools/core/MoveArtifactTool.js

@@ -0,0 +1,104 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+import { parsePath } from '../../utils/PathUtils.js';
+import { McpError, McpErrorCode } from '../../utils/McpErrorHandler.js';
+export class MoveArtifactTool extends BaseToolController {
+    constructor(ucmClient, logger, publishingAuthorId) {
+        super(ucmClient, logger, publishingAuthorId);
+    }
+    get name() {
+        return 'ucm_move_artifact';
+    }
+    get description() {
+        return 'Move an artifact from one namespace location to another. All versions are moved. Requires read access on source and write access on destination.';
+    }
+    get inputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                sourcePath: {
+                    type: 'string',
+                    description: `Full source artifact path (e.g., "${this.publishingAuthorId || '1234567890'}/main/commands/user/CreateUserCommand.ts")`,
+                    minLength: 1,
+                    maxLength: 250
+                },
+                destinationPath: {
+                    type: 'string',
+                    description: `Full destination artifact path (e.g., "${this.publishingAuthorId || '1234567890'}/main/services/user/UserService.ts")`,
+                    minLength: 1,
+                    maxLength: 250
+                }
+            },
+            required: ['sourcePath', 'destinationPath'],
+            additionalProperties: false
+        };
+    }
+    async handleExecute(params) {
+        const { sourcePath, destinationPath } = params;
+        this.logger.debug('MoveArtifactTool', `Moving artifact: ${sourcePath} → ${destinationPath}`);
+        try {
+            const source = parsePath(sourcePath);
+            const dest = parsePath(destinationPath);
+            // Build destination namespace (author/repository/category/subcategory)
+            const destNamespace = `${dest.author}/${dest.repository}/${dest.category}/${dest.subcategory}`;
+            const result = await this.ucmClient.editArtifactMetadata(source.author, source.repository, source.category, source.subcategory, source.filename, {
+                updateNamespace: destNamespace,
+                updateFilename: dest.filename
+            });
+            const responseData = result.data || result;
+            const response = {
+                success: true,
+                operation: 'move',
+                artifact: {
+                    originalPath: sourcePath,
+                    newPath: destinationPath,
+                    affectedVersions: responseData.affectedVersions || 'all'
+                },
+                details: responseData.details || `Artifact moved from ${sourcePath} to ${destinationPath}`,
+                _links: responseData._links || {}
+            };
+            this.logger.info('MoveArtifactTool', `Artifact moved successfully: ${sourcePath} → ${destinationPath}`);
+            return response;
+        }
+        catch (error) {
+            this.logger.error('MoveArtifactTool', `Failed to move artifact: ${sourcePath} → ${destinationPath}`, '', error);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (errorMessage?.includes('not found')) {
+                throw new McpError(McpErrorCode.InvalidParams, `Artifact not found at path: ${sourcePath}. Please verify the path is correct and the artifact exists.`);
+            }
+            if (errorMessage?.includes('permission') || errorMessage?.includes('unauthorized')) {
+                throw new McpError(McpErrorCode.InvalidParams, `Insufficient permissions. You need read access on the source and write access on the destination namespace.`);
+            }
+            if (errorMessage?.includes('destination already exists')) {
+                throw new McpError(McpErrorCode.InvalidParams, `An artifact already exists at: ${destinationPath}. Choose a different destination.`);
+            }
+            if (errorMessage?.includes('Author not found')) {
+                throw new McpError(McpErrorCode.InvalidParams, `Author not found. Ensure both source and destination paths use valid author identifiers.`);
+            }
+            throw error;
+        }
+    }
+    validateParams(params) {
+        super.validateParams(params);
+        const { sourcePath, destinationPath } = params;
+        // Validate source path
+        const sourceParts = sourcePath.split('/');
+        if (sourceParts.length < 5) {
+            throw new McpError(McpErrorCode.InvalidParams, 'sourcePath must contain author/repository/category/subcategory/filename');
+        }
+        // Validate destination path
+        const destParts = destinationPath.split('/');
+        if (destParts.length < 5) {
+            throw new McpError(McpErrorCode.InvalidParams, 'destinationPath must contain author/repository/category/subcategory/filename');
+        }
+        // Validate destination filename
+        const destFilename = destParts[destParts.length - 1];
+        if (!/^[^\/\\:*?"<>|]+\.[a-zA-Z0-9]+$/.test(destFilename)) {
+            throw new McpError(McpErrorCode.InvalidParams, 'destinationPath filename must be valid with an extension (e.g., "UserService.ts")');
+        }
+        // Source and destination must differ
+        if (sourcePath === destinationPath) {
+            throw new McpError(McpErrorCode.InvalidParams, 'sourcePath and destinationPath must be different');
+        }
+    }
+}
+//# sourceMappingURL=MoveArtifactTool.js.map

package/dist/tools/core/PublishArtifactFromFileTool.js

@@ -75,6 +75,14 @@ export class PublishArtifactFromFileTool extends BaseToolController {
             this.logger.debug('PublishArtifactFromFileTool', `File read successfully: ${filePath}`, '', {
                 size: content.length
             });
+            // Validate path depth - must be exactly 4 segments: author/repository/category/subcategory
+            const cleanPathParts = path.replace(/^\/+|\/+$/g, '').split('/').filter((p) => p.length > 0);
+            if (cleanPathParts.length > 4) {
+                throw new McpError(McpErrorCode.InvalidParams, `Path has too many segments (got ${cleanPathParts.length}, maximum is 4). ` +
+                    `The path must follow the structure: author/repository/category/subcategory. ` +
+                    `The filename is a separate parameter. Do not add additional sub-levels. ` +
+                    `Example: "${this.publishingAuthorId || '1234567890'}/main/commands/user"`);
+            }
             // Parse the path to extract components
             const pathComponents = parsePath(path);
             // Validate path components exist including repository

package/dist/tools/core/PublishArtifactTool.js

@@ -66,6 +66,14 @@ export class PublishArtifactTool extends BaseToolController {
             size: content.length
         });
         try {
+            // Validate path depth - must be exactly 4 segments: author/repository/category/subcategory
+            const cleanPath = path.replace(/^\/+|\/+$/g, '').split('/').filter((p) => p.length > 0);
+            if (cleanPath.length > 4) {
+                throw new McpError(McpErrorCode.InvalidParams, `Path has too many segments (got ${cleanPath.length}, maximum is 4). ` +
+                    `The path must follow the structure: author/repository/category/subcategory. ` +
+                    `The filename is a separate parameter. Do not add additional sub-levels. ` +
+                    `Example: "${this.publishingAuthorId || '1234567890'}/main/commands/user"`);
+            }
             // Parse the path to extract components
             const pathComponents = parsePath(path);
             // Validate path components exist including repository

package/dist/tools/sharepoint/SharePointListConnectionsTool.d.ts

@@ -1,11 +1,11 @@
 /**
- * SharePointListConnectionsTool
- * List all SharePoint connections available to the user
+ * ListConnectionsTool
+ * List all external connections available to the user
  */
 import { BaseToolController } from '../base/BaseToolController.js';
 import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
-export declare class SharePointListConnectionsTool extends BaseToolController {
+export declare class ListConnectionsTool extends BaseToolController {
     constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;

package/dist/tools/sharepoint/SharePointListConnectionsTool.js

@@ -1,10 +1,10 @@
 /**
- * SharePointListConnectionsTool
- * List all SharePoint connections available to the user
+ * ListConnectionsTool
+ * List all external connections available to the user
  */
 import { BaseToolController } from '../base/BaseToolController.js';
 import { McpError, McpErrorCode } from '../../utils/McpErrorHandler.js';
-export class SharePointListConnectionsTool extends BaseToolController {
+export class ListConnectionsTool extends BaseToolController {
     constructor(ucmClient, logger, publishingAuthorId) {
         super(ucmClient, logger, publishingAuthorId);
     }
@@ -49,7 +49,7 @@ export class SharePointListConnectionsTool extends BaseToolController {
         }
     }
     async handleExecute(params) {
-        this.logger.info('SharePointListConnectionsTool', `Listing SharePoint connections (limit: ${params.limit || 20}, offset: ${params.offset || 0})`);
+        this.logger.info('ListConnectionsTool', `Listing external connections (limit: ${params.limit || 20}, offset: ${params.offset || 0})`);
         try {
             // Get organizationId from auth ticket (via UcmApiClient)
             // Call API to list connections with pagination params
@@ -70,7 +70,7 @@ export class SharePointListConnectionsTool extends BaseToolController {
                 status: error?.response?.status,
                 data: error?.response?.data
             };
-            this.logger.error('SharePointListConnectionsTool', 'Failed to list connections', '', sanitizedError);
+            this.logger.error('ListConnectionsTool', 'Failed to list connections', '', sanitizedError);
             if (error instanceof McpError) {
                 throw error;
             }

package/dist/tools/utility/HealthCheckController.js

@@ -1,6 +1,6 @@
 import { BaseToolController } from '../base/BaseToolController.js';
 //import packageJson from '../../../../publish/package.json' assert { type: 'json' };
-const version = '3.0.0'; //TODO: tried to sync this with packageJson but it didn't work.
+const version = '5.1.0'; //TODO: tried to sync this with packageJson but it didn't work.
 export class HealthCheckController extends BaseToolController {
     constructor(ucmClient, logger, publishingAuthorId) {
         super(ucmClient, logger, publishingAuthorId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utaba/ucm-mcp-server",
-  "version": "5.0.0",
+  "version": "5.1.0",
   "description": "Universal Context Manager MCP Server - AI Productivity Platform",
   "main": "dist/index.js",
   "type": "module",

package/package.json.backup

@@ -1,6 +1,6 @@
 {
   "name": "ucm-mcp-server",
-  "version": "5.0.0",
+  "version": "5.1.0",
   "description": "Universal Context Manager MCP Server - AI Productivity Platform",
   "main": "dist/index.js",
   "type": "module",