@utaba/ucm-mcp-server 1.0.7 → 1.1.0

package/dist/clients/UcmApiClient.d.ts

@@ -29,6 +29,26 @@ export declare class UcmApiClient {
         offset?: number;
         limit?: number;
     }): Promise<ArtifactData[]>;
+    searchArtifactsByText(searchParams: {
+        searchText: string;
+        namespace?: string;
+        author?: string;
+        repository?: string;
+        category?: string;
+        subcategory?: string;
+        filename?: 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>;
@@ -40,6 +60,7 @@ export declare class UcmApiClient {
     }>;
     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

package/dist/clients/UcmApiClient.js

@@ -26,7 +26,7 @@ export class UcmApiClient {
             const url = error.config?.url;
             const errorMessage = apiError?.message || apiError?.error || error.message || JSON.stringify(apiError);
             if (status === 404) {
-                return Promise.reject(new Error(`Resource not found: ${errorMessage}`));
+                return Promise.reject(new Error(`Resource not found at ${url}: ${errorMessage}`));
             }
             if (status >= 500) {
                 // For 5xx errors, include API error details if available
@@ -168,6 +168,17 @@ export class UcmApiClient {
         const response = await client.get(`/api/v1/artifacts?${params}`);
         return response.data;
     }
+    async searchArtifactsByText(searchParams) {
+        const params = new URLSearchParams();
+        // Add all parameters to URL
+        Object.entries(searchParams).forEach(([key, value]) => {
+            if (value !== undefined)
+                params.append(key, value.toString());
+        });
+        const client = this.ensureClient();
+        const response = await client.get(`/api/v1/search/artifacts?${params}`);
+        return response.data;
+    }
     async publishArtifact(author, repository, category, subcategory, data) {
         // Default repository to 'main' for MVP
         const repo = repository || 'main';
@@ -274,6 +285,15 @@ export class UcmApiClient {
         });
         return response.data;
     }
+    async getAuthorRecents(author) {
+        const client = this.ensureClient();
+        // Author-level recent activity (using new resources API structure)
+        const url = `/api/v1/resources/author/${author}/recents`;
+        const response = await client.get(url, {
+            headers: { 'accept': 'text/markdown' }
+        });
+        return response.data;
+    }
     /**
      * Cleanup method to properly dispose of HTTP client resources
      * This helps prevent memory leaks from accumulated AbortSignal listeners

package/dist/server/ToolRegistry.js

@@ -3,6 +3,7 @@ import { McpError, McpErrorCode } from '../utils/McpErrorHandler.js';
 import { HealthCheckController } from '../tools/utility/HealthCheckController.js';
 import { QuickstartTool } from '../tools/utility/QuickstartTool.js';
 import { AuthorIndexTool } from '../tools/utility/AuthorIndexTool.js';
+import { AuthorRecentsTool } from '../tools/utility/AuthorRecentsTool.js';
 import { ListRepositoriesTool } from '../tools/utility/ListRepositoriesTool.js';
 // Import core tools
 import { GetArtifactTool } from '../tools/core/GetArtifactTool.js';
@@ -12,6 +13,7 @@ import { PublishArtifactFromFileTool } from '../tools/core/PublishArtifactFromFi
 import { ListArtifactsTool } from '../tools/core/ListArtifactsTool.js';
 import { DeleteArtifactTool } from '../tools/core/DeleteArtifactTool.js';
 import { GetArtifactVersionsTool } from '../tools/core/GetArtifactVersionsTool.js';
+import { SearchArtifactsTool } from '../tools/core/SearchArtifactsTool.js';
 // Import repository tools
 import { CreateRepositoryTool } from '../tools/repository/CreateRepositoryTool.js';
 import { GetRepositoryTool } from '../tools/repository/GetRepositoryTool.js';
@@ -37,6 +39,7 @@ export class ToolRegistry {
         this.registerTool(new QuickstartTool(this.ucmClient, this.logger, this.authorId));
         this.registerTool(new HealthCheckController(this.ucmClient, this.logger, this.authorId));
         this.registerTool(new AuthorIndexTool(this.ucmClient, this.logger, this.authorId));
+        this.registerTool(new AuthorRecentsTool(this.ucmClient, this.logger, this.authorId));
         this.registerTool(new ListRepositoriesTool(this.ucmClient, this.logger, this.authorId));
         // Register core tools
         this.registerTool(new GetArtifactTool(this.ucmClient, this.logger, this.authorId, this.trustedAuthors));
@@ -46,6 +49,7 @@ export class ToolRegistry {
         this.registerTool(new ListArtifactsTool(this.ucmClient, this.logger, this.authorId));
         this.registerTool(new DeleteArtifactTool(this.ucmClient, this.logger, this.authorId));
         this.registerTool(new GetArtifactVersionsTool(this.ucmClient, this.logger, this.authorId));
+        this.registerTool(new SearchArtifactsTool(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/SearchArtifactsTool.d.ts

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

package/dist/tools/core/SearchArtifactsTool.js

@@ -0,0 +1,119 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+export class SearchArtifactsTool extends BaseToolController {
+    constructor(ucmClient, logger, publishingAuthorId) {
+        super(ucmClient, logger, publishingAuthorId);
+    }
+    get name() {
+        return 'mcp_ucm_search_artifacts';
+    }
+    get description() {
+        return `Search artifacts by text across multiple metadata fields with privacy filtering. Searches namespace, filename, and description fields. ${this.publishingAuthorId ? "Your author value is '" + this.publishingAuthorId + "'" : ''}`;
+    }
+    get inputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                searchText: {
+                    type: 'string',
+                    description: 'Required text to search across namespace, repository, category, subcategory, filename, and description (case-insensitive)',
+                    minLength: 1,
+                    maxLength: 200
+                },
+                namespace: {
+                    type: 'string',
+                    description: 'Optional namespace filter (e.g., "utaba/main/commands/user")',
+                    maxLength: 200
+                },
+                author: {
+                    type: 'string',
+                    description: `Optional.  Leave empty to search your own author and public authors.  '(e.g., "' + this.publishingAuthorId + '")' : ''}`,
+                    maxLength: 50
+                },
+                repository: {
+                    type: 'string',
+                    description: 'Optional repository filter',
+                    maxLength: 200
+                },
+                category: {
+                    type: 'string',
+                    description: 'Optional category filter (e.g., "commands", "services", "patterns")',
+                    maxLength: 50
+                },
+                subcategory: {
+                    type: 'string',
+                    description: 'Optional subcategory filter (e.g., "user", "auth", "database")',
+                    maxLength: 50
+                },
+                filename: {
+                    type: 'string',
+                    description: 'Optional filename filter (e.g., "CreateUserCommand.ts")',
+                    maxLength: 100
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Number of items to skip for pagination (default: 0)',
+                    minimum: 0
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of items to return (default: 20, max: 100)',
+                    minimum: 1,
+                    maximum: 100
+                }
+            },
+            required: ['searchText']
+        };
+    }
+    async handleExecute(params) {
+        const { searchText, namespace, author, repository, category, subcategory, filename, offset, limit } = params;
+        this.logger.debug('SearchArtifactsTool', `Searching for: "${searchText}" with filters`, '', {
+            namespace,
+            author,
+            repository: repository || 'main',
+            category,
+            subcategory,
+            filename,
+            offset: offset || 0,
+            limit: limit || 20
+        });
+        try {
+            // Call the new search API endpoint
+            const response = await this.ucmClient.searchArtifactsByText({
+                searchText,
+                namespace,
+                author,
+                repository: repository || 'main', // Default to 'main' for MVP
+                category,
+                subcategory,
+                filename,
+                offset: offset || 0,
+                limit: limit || 20
+            });
+            this.logger.info('SearchArtifactsTool', `Found ${response.data.length} artifacts matching: "${searchText}"`, '', {
+                totalResults: response.pagination.total,
+                filters: { namespace, author, repository, category, subcategory, filename }
+            });
+            // Return structured search results
+            return {
+                searchText,
+                filters: {
+                    namespace,
+                    author,
+                    repository: repository || 'main',
+                    category,
+                    subcategory,
+                    filename
+                },
+                results: response.data,
+                pagination: response.pagination,
+                hasMore: response.pagination.hasMore,
+                _links: response._links
+            };
+        }
+        catch (error) {
+            this.logger.error('SearchArtifactsTool', `Failed to search for: "${searchText}"`, '', error);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=SearchArtifactsTool.js.map

package/dist/tools/utility/AuthorIndexTool.js

@@ -37,8 +37,8 @@ export class AuthorIndexTool extends BaseToolController {
         catch (error) {
             let errorMessage = `Failed to retrieve author index for ${author}.`;
             if (this.publishingAuthorId && author != this.publishingAuthorId) {
-                errorMessage += `Did you mean '${this.publishingAuthorId}'`;
-                error.message = error.message += `Did you mean '${this.publishingAuthorId}'`;
+                errorMessage += ` did you mean '${this.publishingAuthorId}'`;
+                error.message = error.message += ` did you mean '${this.publishingAuthorId}'`;
             }
             this.logger.error('AuthorIndexTool', `${errorMessage}`, '', error);
             throw error;

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

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

package/dist/tools/utility/AuthorRecentsTool.js

@@ -0,0 +1,48 @@
+import { BaseToolController } from '../base/BaseToolController.js';
+export class AuthorRecentsTool extends BaseToolController {
+    constructor(ucmClient, logger, publishingAuthorId) {
+        super(ucmClient, logger, publishingAuthorId);
+    }
+    get name() {
+        return 'mcp_ucm_get_author_recents';
+    }
+    get description() {
+        return `Generate author activity tracking showing the 20 most recently modified artifacts within an author context. Your author id is '${this.publishingAuthorId}'`;
+    }
+    get inputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                author: {
+                    type: 'string',
+                    description: `Author identifier: ${this.publishingAuthorId || '1234567890'}`
+                }
+            },
+            required: ['author']
+        };
+    }
+    async handleExecute(params) {
+        const { author } = params;
+        this.logger.debug('AuthorRecentsTool', `Retrieving author recents for: ${author}`);
+        try {
+            // Get author recent activity content from API
+            const authorRecentsContent = await this.ucmClient.getAuthorRecents(author);
+            this.logger.info('AuthorRecentsTool', 'Author recents retrieved successfully', '', {
+                author,
+                contentLength: authorRecentsContent.length,
+                source: `UCM API /api/v1/resources/author/${author}/recents`
+            });
+            return authorRecentsContent;
+        }
+        catch (error) {
+            let errorMessage = `Failed to retrieve author recents for ${author}.`;
+            if (this.publishingAuthorId && author != this.publishingAuthorId) {
+                errorMessage += ` did you mean '${this.publishingAuthorId}'?`;
+                error.message = error.message += ` did you mean '${this.publishingAuthorId}'?`;
+            }
+            this.logger.error('AuthorRecentsTool', `${errorMessage}`, '', error);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=AuthorRecentsTool.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utaba/ucm-mcp-server",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "description": "Universal Context Manager MCP Server - AI-native artifact management",
   "main": "dist/index.js",
   "type": "module",

package/package.json.backup

@@ -1,6 +1,6 @@
 {
   "name": "ucm-mcp-server",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "description": "Universal Context Manager MCP Server - AI-native artifact management",
   "main": "dist/index.js",
   "type": "module",