@utaba/ucm-mcp-server 6.5.1 → 6.7.0

package/dist/tools/repository/CreateRepositoryTool.js

@@ -5,7 +5,7 @@ export class CreateRepositoryTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'ucm_create_repository';
+        return 'ucm_repository_create';
     }
     get description() {
         const authorInfo = this.publishingAuthorId ? ` Your default workspace id is '${this.publishingAuthorId}'.` : '';
@@ -15,7 +15,7 @@ export class CreateRepositoryTool extends BaseToolController {
         return {
             type: 'object',
             properties: {
-                author: {
+                workspace: {
                     type: 'string',
                     description: this.publishingAuthorId ? `Workspace identifier: ${this.publishingAuthorId}` : 'Workspace identifier (e.g., "utaba", "1064600359")',
                     minLength: 1,
@@ -39,14 +39,14 @@ export class CreateRepositoryTool extends BaseToolController {
                     maxLength: 1000
                 }
             },
-            required: ['author', 'repositoryName'],
+            required: ['workspace', 'repositoryName'],
             additionalProperties: false
         };
     }
     validateParams(params) {
         super.validateParams(params);
         // Additional validation
-        if (!params.author || typeof params.author !== 'string' || params.author.trim() === '') {
+        if (!params.workspace || typeof params.workspace !== 'string' || params.workspace.trim() === '') {
             throw new McpError(McpErrorCode.InvalidParams, 'Author identifier is required and cannot be empty');
         }
         if (!params.repositoryName || typeof params.repositoryName !== 'string' || params.repositoryName.trim() === '') {
@@ -71,14 +71,15 @@ export class CreateRepositoryTool extends BaseToolController {
         }
     }
     async handleExecute(params) {
-        this.logger.info('CreateRepositoryTool', `Creating repository ${params.repositoryName} for author ${params.author}`);
+        const author = params.workspace;
+        this.logger.info('CreateRepositoryTool', `Creating repository ${params.repositoryName} for author ${author}`);
         try {
             const repositoryData = {
                 repositoryName: params.repositoryName,
                 displayName: params.displayName,
                 description: params.description
             };
-            const result = await this.ucmClient.createRepository(params.author, repositoryData);
+            const result = await this.ucmClient.createRepository(author, repositoryData);
             this.logger.info('CreateRepositoryTool', `Repository created successfully: ${params.repositoryName}`);
             return {
                 content: [
@@ -86,7 +87,7 @@ export class CreateRepositoryTool extends BaseToolController {
                         type: 'text',
                         text: JSON.stringify({
                             success: true,
-                            message: `Repository '${params.repositoryName}' created successfully for author '${params.author}'`,
+                            message: `Repository '${params.repositoryName}' created successfully for author '${author}'`,
                             repository: result,
                             webUrl: `${process.env.NEXT_PUBLIC_BASE_URL || 'http://localhost:3000'}/repository/${result.id || params.repositoryName}`
                         }, null, 2)
@@ -99,10 +100,10 @@ export class CreateRepositoryTool extends BaseToolController {
             const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
             // Handle specific error cases
             if (errorMessage.includes('already exists') || errorMessage.includes('NAME_EXISTS')) {
-                throw new McpError(McpErrorCode.InvalidParams, `Repository name '${params.repositoryName}' already exists for author '${params.author}'. Please choose a different name.`);
+                throw new McpError(McpErrorCode.InvalidParams, `Repository name '${params.repositoryName}' already exists for author '${author}'. Please choose a different name.`);
             }
             if (errorMessage.includes('not found') || errorMessage.includes('404')) {
-                throw new McpError(McpErrorCode.InvalidParams, `Author '${params.author}' not found. Please verify the author identifier.`);
+                throw new McpError(McpErrorCode.InvalidParams, `Author '${author}' not found. Please verify the author identifier.`);
             }
             if (errorMessage.includes('validation') || errorMessage.includes('invalid')) {
                 throw new McpError(McpErrorCode.InvalidParams, `Repository creation failed due to validation error: ${errorMessage}`);

package/dist/tools/repository/GetRepositoryTool.js

@@ -5,17 +5,16 @@ export class GetRepositoryTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'ucm_get_repository';
+        return 'ucm_repository_get';
     }
     get description() {
-        const authorInfo = this.publishingAuthorId ? ` Your workspace id is '${this.publishingAuthorId}'.` : '';
-        return `Get detailed information about a specific repository, including metadata, statistics, and available categories. Returns repository details along with its content structure.${authorInfo}`;
+        return 'Get detailed information about a specific repository, including metadata, statistics, and available categories. Returns repository details along with its content structure.';
     }
     get inputSchema() {
         return {
             type: 'object',
             properties: {
-                author: {
+                workspace: {
                     type: 'string',
                     description: this.publishingAuthorId ? `Workspace identifier: ${this.publishingAuthorId}` : 'Workspace identifier (e.g., "utaba", "1064600359")',
                     minLength: 1,
@@ -28,13 +27,13 @@ export class GetRepositoryTool extends BaseToolController {
                     maxLength: 200
                 }
             },
-            required: ['author', 'repository'],
+            required: ['workspace', 'repository'],
             additionalProperties: false
         };
     }
     validateParams(params) {
         super.validateParams(params);
-        if (!params.author || typeof params.author !== 'string' || params.author.trim() === '') {
+        if (!params.workspace || typeof params.workspace !== 'string' || params.workspace.trim() === '') {
             throw new McpError(McpErrorCode.InvalidParams, 'Author identifier is required and cannot be empty');
         }
         if (!params.repository || typeof params.repository !== 'string' || params.repository.trim() === '') {
@@ -42,20 +41,21 @@ export class GetRepositoryTool extends BaseToolController {
         }
     }
     async handleExecute(params) {
-        this.logger.info('GetRepositoryTool', `Getting repository ${params.repository} for author ${params.author}`);
+        const author = params.workspace;
+        this.logger.info('GetRepositoryTool', `Getting repository ${params.repository} for author ${author}`);
         try {
-            const result = await this.ucmClient.getRepository(params.author, params.repository);
+            const result = await this.ucmClient.getRepository(author, params.repository);
             this.logger.info('GetRepositoryTool', `Repository retrieved successfully: ${params.repository}`);
             // Enhance the response with additional helpful information
             const enhancedResult = {
                 success: true,
-                message: `Repository '${params.repository}' retrieved successfully for author '${params.author}'`,
+                message: `Repository '${params.repository}' retrieved successfully for author '${author}'`,
                 repository: result,
-                webUrl: `${process.env.NEXT_PUBLIC_BASE_URL || 'http://localhost:3000'}/browse/${params.author}/${params.repository}`,
+                webUrl: `${process.env.NEXT_PUBLIC_BASE_URL || 'http://localhost:3000'}/browse/${author}/${params.repository}`,
                 apiEndpoints: {
-                    browse: `/api/v1/authors/${params.author}/${params.repository}`,
-                    artifacts: `/api/v1/authors/${params.author}/${params.repository}/{category}/{subcategory}`,
-                    files: `/api/v1/files/${params.author}/${params.repository}/{category}/{subcategory}/{filename}`
+                    browse: `/api/v1/authors/${author}/${params.repository}`,
+                    artifacts: `/api/v1/authors/${author}/${params.repository}/{category}/{subcategory}`,
+                    files: `/api/v1/files/${author}/${params.repository}/{category}/{subcategory}/{filename}`
                 }
             };
             return {
@@ -72,10 +72,10 @@ export class GetRepositoryTool extends BaseToolController {
             const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
             // Handle specific error cases
             if (errorMessage.includes('not found') || errorMessage.includes('404')) {
-                throw new McpError(McpErrorCode.InvalidParams, `Repository '${params.repository}' not found for author '${params.author}'. Please verify the repository name and author identifier.`);
+                throw new McpError(McpErrorCode.InvalidParams, `Repository '${params.repository}' not found for author '${author}'. Please verify the repository name and author identifier.`);
             }
             if (errorMessage.includes('403') || errorMessage.includes('Forbidden')) {
-                throw new McpError(McpErrorCode.InvalidParams, `Access denied to repository '${params.repository}' for author '${params.author}'. You may not have permission to view this repository.`);
+                throw new McpError(McpErrorCode.InvalidParams, `Access denied to repository '${params.repository}' for author '${author}'. You may not have permission to view this repository.`);
             }
             // Generic error
             throw new McpError(McpErrorCode.InternalError, `Failed to retrieve repository: ${errorMessage}`);

package/dist/tools/repository/UpdateRepositoryTool.js

@@ -5,7 +5,7 @@ export class UpdateRepositoryTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'ucm_update_repository';
+        return 'ucm_repository_update';
     }
     get description() {
         const authorInfo = this.publishingAuthorId ? ` Your default workspace id is '${this.publishingAuthorId}'.` : '';
@@ -15,7 +15,7 @@ export class UpdateRepositoryTool extends BaseToolController {
         return {
             type: 'object',
             properties: {
-                author: {
+                workspace: {
                     type: 'string',
                     description: this.publishingAuthorId ? `Workspace identifier: ${this.publishingAuthorId}` : 'Workspace identifier (e.g., "utaba", "1064600359")',
                     minLength: 1,
@@ -38,13 +38,13 @@ export class UpdateRepositoryTool extends BaseToolController {
                     maxLength: 1000
                 }
             },
-            required: ['author', 'repository'],
+            required: ['workspace', 'repository'],
             additionalProperties: false
         };
     }
     validateParams(params) {
         super.validateParams(params);
-        if (!params.author || typeof params.author !== 'string' || params.author.trim() === '') {
+        if (!params.workspace || typeof params.workspace !== 'string' || params.workspace.trim() === '') {
             throw new McpError(McpErrorCode.InvalidParams, 'Author identifier is required and cannot be empty');
         }
         if (!params.repository || typeof params.repository !== 'string' || params.repository.trim() === '') {
@@ -66,7 +66,8 @@ export class UpdateRepositoryTool extends BaseToolController {
         }
     }
     async handleExecute(params) {
-        this.logger.info('UpdateRepositoryTool', `Updating repository ${params.repository} for author ${params.author}`);
+        const author = params.workspace;
+        this.logger.info('UpdateRepositoryTool', `Updating repository ${params.repository} for author ${author}`);
         try {
             // Build update data from provided parameters
             const updateData = {};
@@ -76,7 +77,7 @@ export class UpdateRepositoryTool extends BaseToolController {
             if (params.description !== undefined) {
                 updateData.description = params.description;
             }
-            const result = await this.ucmClient.updateRepository(params.author, params.repository, updateData);
+            const result = await this.ucmClient.updateRepository(author, params.repository, updateData);
             this.logger.info('UpdateRepositoryTool', `Repository updated successfully: ${params.repository}`);
             return {
                 content: [
@@ -84,7 +85,7 @@ export class UpdateRepositoryTool extends BaseToolController {
                         type: 'text',
                         text: JSON.stringify({
                             success: true,
-                            message: `Repository '${params.repository}' updated successfully for author '${params.author}'`,
+                            message: `Repository '${params.repository}' updated successfully for author '${author}'`,
                             repository: result,
                             updatedFields: Object.keys(updateData),
                             webUrl: `${process.env.NEXT_PUBLIC_BASE_URL || 'http://localhost:3000'}/repository/${result.id || params.repository}/settings`
@@ -98,10 +99,10 @@ export class UpdateRepositoryTool extends BaseToolController {
             const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
             // Handle specific error cases
             if (errorMessage.includes('not found') || errorMessage.includes('404')) {
-                throw new McpError(McpErrorCode.InvalidParams, `Repository '${params.repository}' not found for author '${params.author}'. Please verify the repository name and author identifier.`);
+                throw new McpError(McpErrorCode.InvalidParams, `Repository '${params.repository}' not found for author '${author}'. Please verify the repository name and author identifier.`);
             }
             if (errorMessage.includes('403') || errorMessage.includes('Forbidden')) {
-                throw new McpError(McpErrorCode.InvalidParams, `Access denied to update repository '${params.repository}' for author '${params.author}'. You may not have permission to modify this repository.`);
+                throw new McpError(McpErrorCode.InvalidParams, `Access denied to update repository '${params.repository}' for author '${author}'. You may not have permission to modify this repository.`);
             }
             if (errorMessage.includes('validation') || errorMessage.includes('invalid')) {
                 throw new McpError(McpErrorCode.InvalidParams, `Repository update failed due to validation error: ${errorMessage}`);

package/dist/tools/sharepoint/SharePointListConnectionsTool.js

@@ -9,7 +9,7 @@ export class ListConnectionsTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'ucm_list_connections';
+        return 'ucm_connection_list';
     }
     get description() {
         return 'List all External connections including SharePoint available to the user. Returns connection details, use this to discover available connections before searching or browsing.';

package/dist/tools/sharepoint/SharePointListFoldersTool.js

@@ -13,7 +13,7 @@ export class SharePointListFoldersTool extends BaseToolController {
         return 'ucm_sharepoint_list_folders';
     }
     get description() {
-        return 'Browse SharePoint hierarchically: "/" lists document libraries, "/LibraryName" lists library root, "/LibraryName/Folder" lists subfolder. Supports pagination. Use ucm_list_connections first to get connection ID.';
+        return 'Browse SharePoint hierarchically: "/" lists document libraries, "/LibraryName" lists library root, "/LibraryName/Folder" lists subfolder. Supports pagination. Use ucm_connection_list first to get connection ID.';
     }
     get inputSchema() {
         return {

package/dist/tools/utility/AuthorIndexTool.js

@@ -4,25 +4,26 @@ export class AuthorIndexTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'ucm_get_author_index';
+        return 'ucm_workspace_get_index';
     }
     get description() {
-        return `Discover a dynamic markdown index guide for AI assistants working with a workspace\'s content. Your workspace id is '${this.publishingAuthorId}'`;
+        return 'Discover a dynamic markdown index guide for AI assistants working with a workspace\'s content.';
     }
     get inputSchema() {
         return {
             type: 'object',
             properties: {
-                author: {
+                workspace: {
                     type: 'string',
                     description: `Workspace identifier: ${this.publishingAuthorId || '1234567890'}`
                 }
             },
-            required: ['author']
+            required: ['workspace']
         };
     }
     async handleExecute(params) {
-        const { author } = params;
+        const { workspace } = params;
+        const author = workspace;
         this.logger.debug('AuthorIndexTool', `Retrieving author index for: ${author}`);
         try {
             // Get author index content from API (author-level index, not repository-specific)

package/dist/tools/utility/AuthorRecentsTool.js

@@ -4,25 +4,26 @@ export class AuthorRecentsTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'ucm_get_author_recents';
+        return 'ucm_workspace_get_recents';
     }
     get description() {
-        return `Generate workspace activity tracking showing the 20 most recently modified artifacts within a workspace. Your workspace id is '${this.publishingAuthorId}'`;
+        return 'Generate workspace activity tracking showing the 20 most recently modified artifacts within a workspace.';
     }
     get inputSchema() {
         return {
             type: 'object',
             properties: {
-                author: {
+                workspace: {
                     type: 'string',
                     description: `Workspace identifier: ${this.publishingAuthorId || '1234567890'}`
                 }
             },
-            required: ['author']
+            required: ['workspace']
         };
     }
     async handleExecute(params) {
-        const { author } = params;
+        const { workspace } = params;
+        const author = workspace;
         this.logger.debug('AuthorRecentsTool', `Retrieving author recents for: ${author}`);
         try {
             // Get author recent activity content from API

package/dist/tools/utility/ListRepositoriesTool.js

@@ -4,7 +4,7 @@ export class ListRepositoriesTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'ucm_list_repositories';
+        return 'ucm_workspace_list_repos';
     }
     get description() {
         return 'List all repositories for a specific workspace with pagination and statistics';
@@ -13,7 +13,7 @@ export class ListRepositoriesTool extends BaseToolController {
         return {
             type: 'object',
             properties: {
-                author: {
+                workspace: {
                     type: 'string',
                     description: `Workspace identifier (e.g., "${this.publishingAuthorId || '1234567890'}")`,
                     minLength: 1,
@@ -31,11 +31,12 @@ export class ListRepositoriesTool extends BaseToolController {
                     maximum: 100
                 }
             },
-            required: ['author']
+            required: ['workspace']
         };
     }
     async handleExecute(params) {
-        const { author, offset, limit } = params;
+        const { workspace, offset, limit } = params;
+        const author = workspace;
         this.logger.debug('ListRepositoriesTool', `Listing repositories for author: ${author}`, '', {
             offset: offset || 0,
             limit: limit || 'default'

package/dist/utils/McpErrorHandler.js

@@ -51,7 +51,7 @@ export class McpErrorHandler {
             return new McpError(McpErrorCode.InvalidParams, 'Parameter validation failed', { originalError: error });
         }
         if (message?.includes('ECONNREFUSED')) {
-            return new McpError(McpErrorCode.ExternalServiceUnavailable, 'External API is unavailable, try the ucm_health_check tool', { originalError: error });
+            return new McpError(McpErrorCode.ExternalServiceUnavailable, 'External API is unavailable, try ucm_connect to verify your connection', { originalError: error });
         }
         if (message?.includes('validation') || message?.includes('invalid') ||
             message?.includes('required') || message?.includes('must be')) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utaba/ucm-mcp-server",
-  "version": "6.5.1",
+  "version": "6.7.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": "6.5.1",
+  "version": "6.7.0",
   "description": "Universal Context Manager MCP Server - AI Productivity Platform",
   "main": "dist/index.js",
   "type": "module",

package/dist/clients/UcmApiClient.d.ts

@@ -1,157 +0,0 @@
-import { ArtifactData, AuthorData } from '../types/UcmApiTypes.js';
-export declare class UcmLocalApiClient {
-    private baseUrl;
-    private authToken?;
-    private authorId?;
-    private organizationId?;
-    private client;
-    constructor(baseUrl: string, authToken?: string | undefined, timeout?: number, authorId?: string | undefined, organizationId?: string | undefined);
-    /**
-     * Get organizationId from constructor or throw error
-     * For local MCP server, organizationId should be provided during initialization
-     */
-    getOrganizationId(): Promise<string>;
-    private setupInterceptors;
-    private ensureClient;
-    getAuthors(): Promise<AuthorData[]>;
-    getAuthor(authorId: string): Promise<AuthorData | null>;
-    private buildApiPath;
-    getArtifact(author?: string, repository?: string, category?: string, subcategory?: string, filename?: string, version?: string): Promise<ArtifactData>;
-    getLatestArtifact(author?: string, repository?: string, category?: string, subcategory?: string, filename?: string): Promise<ArtifactData>;
-    listArtifacts(author?: string, repository?: string, category?: string, subcategory?: string, offset?: number, limit?: number): Promise<{
-        data: any[];
-        pagination: {
-            offset: number;
-            limit: number;
-            total: number;
-        };
-        _links?: any;
-    }>;
-    searchArtifacts(filters?: {
-        repository?: string;
-        category?: string;
-        technology?: string;
-        subcategory?: string;
-        offset?: number;
-        limit?: number;
-    }): Promise<ArtifactData[]>;
-    searchArtifactsByText(searchParams: {
-        searchText?: string;
-        namespace?: string;
-        author?: string;
-        repository?: string;
-        category?: string;
-        subcategory?: string;
-        filename?: string;
-        tags?: string;
-        offset?: number;
-        limit?: number;
-    }): Promise<{
-        data: any[];
-        pagination: {
-            offset: number;
-            limit: number;
-            total: number;
-            hasMore: boolean;
-        };
-        _links?: any;
-    }>;
-    publishArtifact(author: string, repository: string, category: string, subcategory: string, data: any): Promise<ArtifactData>;
-    updateArtifact(author: string, repository: string, category: string, subcategory: string, filename: string, version: string, data: any): Promise<ArtifactData>;
-    deleteArtifact(author: string, repository: string, category: string, subcategory: string, filename: string, version?: string): Promise<any>;
-    getArtifactVersions(author: string, repository: string, category: string, subcategory: string, filename: string): Promise<any>;
-    getCategories(): Promise<string[]>;
-    healthCheck(): Promise<{
-        status: string;
-        timestamp: string;
-    }>;
-    getQuickstart(): Promise<string>;
-    getAuthorIndex(author: string, repository?: string): Promise<string>;
-    getAuthorRecents(author: string): Promise<string>;
-    /**
-     * Cleanup method to properly dispose of HTTP client resources
-     * This helps prevent memory leaks from accumulated AbortSignal listeners
-     */
-    cleanup(): void;
-    /**
-     * Check if the client is still available for use
-     */
-    isAvailable(): boolean;
-    createRepository(author: string, data: {
-        repositoryName: string;
-        displayName?: string;
-        description?: string;
-    }): Promise<any>;
-    getRepository(author: string, repository: string): Promise<any>;
-    updateRepository(author: string, repository: string, data: {
-        displayName?: string;
-        description?: string;
-    }): Promise<any>;
-    deleteRepository(author: string, repository: string): Promise<any>;
-    listRepositories(author: string, offset?: number, limit?: number): Promise<{
-        data: any[];
-        pagination: {
-            offset: number;
-            limit: number;
-            total: number;
-        };
-        _links?: any;
-    }>;
-    submitFeedback(data: {
-        title: string;
-        body: string;
-        reportType: 'issue' | 'feedback';
-        tags?: string;
-    }): Promise<any>;
-    editArtifactMetadata(author: string, repository: string, category: string, subcategory: string, filename: string, data: {
-        updateDescription?: string;
-        updateNamespace?: string;
-        updateFilename?: string;
-        updateMimeType?: string;
-        updateTechnology?: string;
-        updateTags?: string;
-    }): Promise<any>;
-    /**
-     * Generate markdown for SharePoint connections (safe, non-sensitive data only)
-     */
-    sharePointGenerateConnectionsMarkdown(organizationId: string, params: {
-        limit?: number;
-        offset?: number;
-    }): Promise<any>;
-    /**
-     * List SharePoint connections for an organization (includes sensitive data - use with caution)
-     */
-    sharePointListConnections(organizationId: string, params: {
-        limit?: number;
-        offset?: number;
-    }): Promise<any>;
-    /**
-     * Search SharePoint documents using Microsoft Search API
-     */
-    sharePointSearch(organizationId: string, connectionId: string, params: {
-        query: string;
-        limit?: number;
-        offset?: number;
-        fileType?: string;
-    }): Promise<any>;
-    /**
-     * List folders and files in SharePoint with pagination
-     */
-    sharePointListFolders(organizationId: string, connectionId: string, params: {
-        folderPath?: string;
-        includeFiles?: boolean;
-        recursive?: boolean;
-        limit?: number;
-        offset?: number;
-    }): Promise<any>;
-    /**
-     * Read SharePoint file content with support for both fileUrl and legacy fileId
-     */
-    sharePointReadFile(organizationId: string, connectionId: string, params: {
-        fileUrl?: string;
-        fileId?: string;
-        fileName?: string;
-        extractMetadata?: boolean;
-    }): Promise<any>;
-}
-//# sourceMappingURL=UcmApiClient.d.ts.map