@utaba/ucm-mcp-server 6.5.1 → 6.7.0

package/dist/tools/sharepoint/SharePointSignOutTool.js

@@ -1,114 +0,0 @@
-/**
- * SharePointSignOutTool
- * Revoke user's OnBehalfOf authorization for a SharePoint connection
- */
-import { BaseToolController } from '../base/BaseToolController.js';
-import { McpError, McpErrorCode } from '../../utils/McpErrorHandler.js';
-export class SharePointSignOutTool extends BaseToolController {
-    constructor(ucmClient, logger, publishingAuthorId) {
-        super(ucmClient, logger, publishingAuthorId);
-    }
-    get name() {
-        return 'ucm_sharepoint_signout';
-    }
-    get description() {
-        return 'This signs the user out only for connections with user-delegated permissions.';
-    }
-    get inputSchema() {
-        return {
-            type: 'object',
-            properties: {
-                connectionId: {
-                    type: 'string',
-                    description: 'SharePoint connection ID to revoke authorization for (get this from list_connections)',
-                    minLength: 36,
-                    maxLength: 36
-                }
-            },
-            required: ['connectionId']
-        };
-    }
-    validateParams(params) {
-        super.validateParams(params);
-        // Validate connectionId
-        if (!params.connectionId || typeof params.connectionId !== 'string') {
-            throw new McpError(McpErrorCode.InvalidParams, 'connectionId is required and must be a string');
-        }
-        if (params.connectionId.length !== 36) {
-            throw new McpError(McpErrorCode.InvalidParams, 'connectionId must be a valid UUID (36 characters)');
-        }
-    }
-    async handleExecute(params) {
-        this.logger.info('SharePointSignOutTool', `Revoking SharePoint authorization for connection ${params.connectionId}`);
-        try {
-            // Call API to revoke authorization
-            const result = await this.ucmClient.sharePointSignOut(params.connectionId);
-            this.logger.info('SharePointSignOutTool', 'Authorization revoked successfully', '', {
-                connectionId: params.connectionId,
-                success: result.success
-            });
-            // Return structured markdown response
-            const markdown = this.formatSignOutResponse(result);
-            return markdown;
-        }
-        catch (error) {
-            // Sanitize error for logging to avoid circular reference issues
-            const sanitizedError = {
-                message: error?.message,
-                status: error?.response?.status,
-                data: error?.response?.data
-            };
-            this.logger.error('SharePointSignOutTool', 'Failed to revoke authorization', '', sanitizedError);
-            if (error instanceof McpError) {
-                throw error;
-            }
-            // Handle API errors
-            if (error.response) {
-                const status = error.response.status;
-                const errorData = error.response.data;
-                if (status === 401 || status === 403) {
-                    throw new McpError(McpErrorCode.InvalidRequest, `Access denied: ${errorData?.message || 'Not authorized to revoke SharePoint authorization'}`);
-                }
-                if (status === 404) {
-                    throw new McpError(McpErrorCode.InvalidRequest, `Connection not found: ${errorData?.message || 'SharePoint connection does not exist'}`);
-                }
-                if (status === 400 && errorData?.error === 'INVALID_AUTH_TYPE') {
-                    throw new McpError(McpErrorCode.InvalidRequest, `Invalid operation: Only OnBehalfOf (user-delegated) connections support user authorization. This connection uses ServicePrincipal authentication.`);
-                }
-                throw new McpError(McpErrorCode.InternalError, `API error: ${errorData?.message || error.message}`);
-            }
-            throw new McpError(McpErrorCode.InternalError, `Failed to revoke SharePoint authorization: ${error.message}`);
-        }
-    }
-    /**
-     * Format sign out response as markdown
-     */
-    formatSignOutResponse(result) {
-        const lines = [];
-        lines.push('# SharePoint Authorization Revoked\n');
-        if (result.success) {
-            lines.push('✅ **Status**: Authorization successfully revoked\n');
-            lines.push(`**Connection ID**: ${result.connectionId}\n`);
-            if (result.revokedAt) {
-                lines.push(`**Revoked At**: ${new Date(result.revokedAt).toLocaleString()}\n`);
-            }
-            lines.push('\n## What This Means\n');
-            lines.push('- Your access tokens have been deleted from the system');
-            lines.push('- You are now signed out of this SharePoint connection');
-            lines.push('- To access SharePoint files again, you must re-authorize\n');
-            if (result._links?.authorize) {
-                lines.push('\n## Re-authorize Access\n');
-                lines.push(`To grant access again, visit: ${result._links.authorize.href}\n`);
-            }
-        }
-        else {
-            lines.push('⚠️ **Status**: Revocation failed or not needed\n');
-            lines.push(`**Message**: ${result.message}\n`);
-            if (result.details?.reason) {
-                lines.push(`**Reason**: ${result.details.reason}\n`);
-            }
-        }
-        return lines.join('\n');
-    }
-}
-//# sourceMappingURL=SharePointSignOutTool.js.map

package/dist/tools/utility/HealthCheckController.d.ts

@@ -1,11 +0,0 @@
-import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmLocalApiClient } from '../../clients/UcmLocalApiClient.js';
-import { ILogger } from '../../interfaces/ILogger.js';
-export declare class HealthCheckController 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=HealthCheckController.d.ts.map

package/dist/tools/utility/HealthCheckController.js

@@ -1,60 +0,0 @@
-import { BaseToolController } from '../base/BaseToolController.js';
-//import packageJson from '../../../../publish/package.json' assert { type: 'json' };
-const version = '6.5.1'; //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);
-    }
-    get name() {
-        return 'ucm_health_check';
-    }
-    get description() {
-        return 'Checks API connectivity only — does NOT load operational context. Use ucm_connect for conversation initialisation';
-    }
-    get inputSchema() {
-        return {
-            type: 'object',
-            properties: {},
-            required: []
-        };
-    }
-    async handleExecute(_params) {
-        try {
-            // Check UCM API connectivity
-            const ucmHealth = await this.ucmClient.healthCheck();
-            return {
-                status: 'healthy',
-                mcpServer: {
-                    status: 'running',
-                    timestamp: new Date().toISOString(),
-                    uptime: process.uptime(),
-                    version: version
-                },
-                ucmApi: {
-                    status: 'connected',
-                    response: ucmHealth
-                },
-                config: {
-                    defaultRepository: 'main',
-                    author: this.publishingAuthorId
-                }
-            };
-        }
-        catch (error) {
-            return {
-                status: 'unhealthy',
-                mcpServer: {
-                    status: 'running',
-                    timestamp: new Date().toISOString(),
-                    uptime: process.uptime(),
-                    version: version
-                },
-                ucmApi: {
-                    status: 'disconnected',
-                    error: error instanceof Error ? error.message : String(error)
-                }
-            };
-        }
-    }
-}
-//# sourceMappingURL=HealthCheckController.js.map

package/dist/tools/utility/SubmitFeedbackTool.d.ts

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

package/dist/tools/utility/SubmitFeedbackTool.js

@@ -1,68 +0,0 @@
-import { BaseToolController } from '../base/BaseToolController.js';
-export class SubmitFeedbackTool extends BaseToolController {
-    constructor(ucmClient, logger, publishingAuthorId) {
-        super(ucmClient, logger, publishingAuthorId);
-    }
-    get name() {
-        return 'ucm_submit_user_issue_or_feedback';
-    }
-    get description() {
-        return 'Submit user feedback, bug reports, feature requests ONLY if the user requests it and they want to send details to the UCM development team. Do NOT include sensitive or project related details. Ask the user before submitting the data if it is appropriate.';
-    }
-    get inputSchema() {
-        return {
-            type: 'object',
-            properties: {
-                title: {
-                    type: 'string',
-                    description: 'Brief title for the feedback or issue (1-100 characters)',
-                    minLength: 1,
-                    maxLength: 100
-                },
-                body: {
-                    type: 'string',
-                    description: 'Detailed description of the feedback or issue (1-1000 characters)',
-                    minLength: 1,
-                    maxLength: 1000
-                },
-                reportType: {
-                    type: 'string',
-                    enum: ['issue', 'feedback'],
-                    description: 'Type of report: "issue" for bug reports and problems, "feedback" for feature requests and general feedback'
-                },
-                tags: {
-                    type: 'string',
-                    description: 'Optional comma-separated tags for categorization (e.g., "ui,bug,performance")',
-                    maxLength: 1000
-                }
-            },
-            required: ['title', 'body', 'reportType']
-        };
-    }
-    async handleExecute(params) {
-        this.logger.info('SubmitFeedbackTool', `Submitting ${params.reportType}: ${params.title}`);
-        try {
-            const result = await this.ucmClient.submitFeedback({
-                title: params.title,
-                body: params.body,
-                reportType: params.reportType,
-                tags: params.tags
-            });
-            this.logger.info('SubmitFeedbackTool', `Successfully submitted ${params.reportType} with ID: ${result.feedbackId}`);
-            return {
-                success: true,
-                feedbackId: result.feedbackId,
-                submittedAt: result.createdAt,
-                message: result.message,
-                reportType: params.reportType,
-                title: params.title
-            };
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            this.logger.error('SubmitFeedbackTool', `Failed to submit ${params.reportType}: ${errorMessage}`, '', error);
-            throw error;
-        }
-    }
-}
-//# sourceMappingURL=SubmitFeedbackTool.js.map

package/dist/tools/utility/ValidatePathController.d.ts

@@ -1,30 +0,0 @@
-import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmLocalApiClient.js';
-import { ILogger } from '../../interfaces/ILogger.js';
-export declare class ValidatePathController extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger);
-    get name(): string;
-    get description(): string;
-    get inputSchema(): any;
-    protected handleExecute(params: any): Promise<any>;
-    private performPathValidation;
-    private validateBasicFormat;
-    private parsePathComponents;
-    private determinePathType;
-    private isVersionedPath;
-    private looksLikeVersion;
-    private validateComponents;
-    private validateSemantics;
-    private checkPathExistence;
-    private checkParentPathExistence;
-    private findSimilarPaths;
-    private generateSuggestions;
-    private applyStrictModeValidation;
-    private validateComponentConsistency;
-    private isValidAuthorId;
-    private isValidSubcategory;
-    private isValidTechnology;
-    private calculatePathSimilarity;
-    private generateSimilarityReason;
-}
-//# sourceMappingURL=ValidatePathController.d.ts.map