@utaba/ucm-mcp-server 2.0.0 → 4.1.0

package/README.md

@@ -14,7 +14,7 @@ The server provides 11 MCP tools following the `ucm_` naming convention:
 
 ### System Tools
 - `ucm_health_check` - Check MCP server and UCM API connectivity
-- `ucm_quickstart` - Get the UCM quickstart guide (Tell your AI to load this first)
+- `ucm_connect` - Get the UCM quickstart guide (Tell your AI to load this first)
 
 ### Discovery Tools
 - `ucm_get_author_index` - Generate dynamic markdown index for an author

package/dist/clients/UcmApiClient.d.ts

@@ -1,10 +1,11 @@
+import https from 'https';
 import { ArtifactData, AuthorData } from '../types/UcmApiTypes.js';
-export declare class UcmApiClient {
+export declare class UcmLocalApiClient {
     private baseUrl;
     private authToken?;
     private authorId?;
     private client;
-    constructor(baseUrl: string, authToken?: string | undefined, timeout?: number, authorId?: string | undefined);
+    constructor(baseUrl: string, authToken?: string | undefined, timeout?: number, authorId?: string | undefined, httpsAgent?: https.Agent);
     private setupInterceptors;
     private ensureClient;
     getAuthors(): Promise<AuthorData[]>;

package/dist/clients/UcmApiClient.js

@@ -1,10 +1,10 @@
 import axios from 'axios';
-export class UcmApiClient {
+export class UcmLocalApiClient {
     baseUrl;
     authToken;
     authorId;
     client;
-    constructor(baseUrl, authToken, timeout = 600000, authorId) {
+    constructor(baseUrl, authToken, timeout = 600000, authorId, httpsAgent) {
         this.baseUrl = baseUrl;
         this.authToken = authToken;
         this.authorId = authorId;
@@ -14,7 +14,8 @@ export class UcmApiClient {
             headers: {
                 'Content-Type': 'application/json',
                 ...(authToken && { 'Authorization': `Bearer ${authToken}` })
-            }
+            },
+            ...(httpsAgent && { httpsAgent })
         });
         this.setupInterceptors();
     }
@@ -187,7 +188,8 @@ export class UcmApiClient {
         if (data.queryParams) {
             // New API structure with query params
             Object.entries(data.queryParams).forEach(([key, value]) => {
-                if (value !== undefined && value !== null && value !== '') {
+                // Skip if value is undefined, null, empty string, or string "null"/"undefined"
+                if (value !== undefined && value !== null && value !== '' && value !== 'null' && value !== 'undefined') {
                     // Handle arrays (e.g., tags) by JSON stringifying them
                     if (Array.isArray(value)) {
                         params.append(key, JSON.stringify(value));
@@ -221,7 +223,8 @@ export class UcmApiClient {
         if (data.queryParams) {
             // New API structure with query params
             Object.entries(data.queryParams).forEach(([key, value]) => {
-                if (value !== undefined && value !== null && value !== '') {
+                // Skip if value is undefined, null, empty string, or string "null"/"undefined"
+                if (value !== undefined && value !== null && value !== '' && value !== 'null' && value !== 'undefined') {
                     // Handle arrays (e.g., tags) by JSON stringifying them
                     if (Array.isArray(value)) {
                         params.append(key, JSON.stringify(value));

package/dist/index.js

@@ -11,13 +11,13 @@ async function main() {
     const program = new Command();
     program
         .name('ucm-mcp-server')
-        .description('Universal Context Manager - Read the ucm_quickstart first to avoid mistakes')
-        .version('1.0.5')
+        .description('Universal Context Manager - Read the ucm_connect tool first to avoid mistakes')
+        .version('4.1.0')
         .option('-u, --ucm-url <url>', 'UCM API base URL (defaults to https://ucm.utaba.ai)')
         .option('-p, --port <port>', 'Server port', '3001')
         .option('--log-level <level>', 'Log level', 'ERROR')
         .option('--auth-token <token>', 'Authentication token for UCM API format is {auhtorid}:{apikey}. Get one from https://ucm.utaba.ai')
-        .option('--trusted-authors <authors>', 'Comma-separated list of trusted authors (e.g., "utaba,{anotherauthor}")', "utaba")
+        .option('--ca-cert <path>', 'Path to CA certificate file (PEM format) for self-signed certificates')
         .parse();
     const options = program.opts();
     const config = new McpConfig({
@@ -25,7 +25,8 @@ async function main() {
         port: parseInt(options.port),
         logLevel: options.logLevel,
         authToken: options.authToken,
-        trustedAuthors: options.trustedAuthors ? options.trustedAuthors.split(',').map((a) => a.trim()) : ["utaba"]
+        trustedAuthors: options.trustedAuthors ? options.trustedAuthors.split(',').map((a) => a.trim()) : ["utaba"],
+        caCertPath: options.caCert
     });
     // Set the log level in the factory before creating any loggers
     LoggerFactory.setLogLevel(config.logLevel);

package/dist/server/McpConfig.d.ts

@@ -6,6 +6,7 @@ export interface McpServerConfig {
     logLevel: 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
     requestTimeout: number;
     trustedAuthors: string[];
+    caCertPath?: string;
 }
 export declare class McpConfig {
     private config;
@@ -21,6 +22,7 @@ export declare class McpConfig {
     get requestTimeout(): number;
     get trustedAuthors(): string[];
     get authorId(): string | undefined;
+    get caCertPath(): string | undefined;
     getFullConfig(): McpServerConfig;
 }
 //# sourceMappingURL=McpConfig.d.ts.map

package/dist/server/McpConfig.js

@@ -12,7 +12,8 @@ export class McpConfig {
             authorId: options.authorId || authorId,
             logLevel: options.logLevel || this.getEnvVar('MCP_LOG_LEVEL', 'ERROR'),
             requestTimeout: options.requestTimeout || parseInt(this.getEnvVar('MCP_REQUEST_TIMEOUT', '30000')),
-            trustedAuthors: options.trustedAuthors || this.parseTrustedAuthors(this.getEnvVar('MCP_TRUSTED_AUTHORS', ''))
+            trustedAuthors: options.trustedAuthors || this.parseTrustedAuthors(this.getEnvVar('MCP_TRUSTED_AUTHORS', '')),
+            caCertPath: options.caCertPath
         };
         this.validateConfig();
     }
@@ -82,6 +83,9 @@ export class McpConfig {
     get authorId() {
         return this.config.authorId;
     }
+    get caCertPath() {
+        return this.config.caCertPath;
+    }
     // Get full configuration object (for testing and debugging)
     getFullConfig() {
         return { ...this.config };

package/dist/server/McpServer.js

@@ -2,8 +2,9 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { McpHandler } from './McpHandler.js';
-import { UcmApiClient } from '../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../clients/UcmApiClient.js';
 import { ToolRegistry } from './ToolRegistry.js';
+import { HttpsAgentFactory } from '../utils/HttpsAgentFactory.js';
 export class McpServer {
     config;
     logger;
@@ -14,7 +15,11 @@ export class McpServer {
     constructor(config, logger) {
         this.config = config;
         this.logger = logger;
-        this.ucmClient = new UcmApiClient(config.ucmApiUrl, config.authToken, config.requestTimeout, config.authorId);
+        // Create HTTPS agent with custom CA certificate if provided
+        const httpsAgent = config.caCertPath
+            ? HttpsAgentFactory.createAgent({ caCertPath: config.caCertPath }, logger)
+            : undefined;
+        this.ucmClient = new UcmLocalApiClient(config.ucmApiUrl, config.authToken, config.requestTimeout, config.authorId, httpsAgent);
         this.toolRegistry = new ToolRegistry(this.ucmClient, this.logger, config.trustedAuthors, config.authorId, config.ucmApiUrl);
         this.handler = new McpHandler(this.toolRegistry, this.logger, config.authorId);
         this.server = new Server({

package/dist/server/ToolRegistry.d.ts

@@ -1,4 +1,4 @@
-import { UcmApiClient } from '../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../clients/UcmApiClient.js';
 import { ILogger } from '../interfaces/ILogger.js';
 export interface ToolInfo {
     name: string;
@@ -12,7 +12,7 @@ export declare class ToolRegistry {
     private authorId?;
     private baseUrl?;
     private tools;
-    constructor(ucmClient: UcmApiClient, logger: ILogger, trustedAuthors?: string[], authorId?: string | undefined, baseUrl?: string | undefined);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, trustedAuthors?: string[], authorId?: string | undefined, baseUrl?: string | undefined);
     private registerTools;
     private registerTool;
     listTools(): Promise<ToolInfo[]>;

package/dist/tools/base/BaseToolController.d.ts

@@ -1,11 +1,11 @@
 import { IMcpTool } from '../../interfaces/IMcpTool.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare abstract class BaseToolController implements IMcpTool {
-    protected ucmClient: UcmApiClient;
+    protected ucmClient: UcmLocalApiClient;
     protected logger: ILogger;
     protected publishingAuthorId?: string | undefined;
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string | undefined);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string | undefined);
     abstract get name(): string;
     abstract get description(): string;
     abstract get inputSchema(): any;

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

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class DeleteArtifactTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

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

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class EditArtifactMetadataTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/core/EditArtifactMetadataTool.js

@@ -9,7 +9,7 @@ export class EditArtifactMetadataTool extends BaseToolController {
         return 'ucm_edit_artifact_metadata';
     }
     get description() {
-        return 'Edit artifact metadata and optionally move artifacts to new locations. Supports updating description, namespace, filename, MIME type, technology, and tags. Move operations affect all versions while metadata-only updates apply to latest version only.';
+        return 'Edit artifact metadata and move artifacts. Supports updating description, namespace, filename, MIME type, technology, and tags. Move operations affect all versions while metadata-only updates apply to latest version only.';
     }
     get inputSchema() {
         return {

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

@@ -1,9 +1,9 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class GetArtifactTool extends BaseToolController {
     private trustedAuthors;
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string, trustedAuthors?: string[]);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string, trustedAuthors?: string[]);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

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

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class GetArtifactVersionsTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

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

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class GetChunkTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

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

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class ListArtifactsTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

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

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class PublishArtifactFromFileTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

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

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class PublishArtifactTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

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

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class SearchArtifactsTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/repository/CreateRepositoryTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class CreateRepositoryTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/repository/DeleteRepositoryGuidanceTool.d.ts

@@ -1,9 +1,9 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class DeleteRepositoryGuidanceTool extends BaseToolController {
     private baseUrl?;
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string, baseUrl?: string | undefined);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string, baseUrl?: string | undefined);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/repository/GetRepositoryTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class GetRepositoryTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/repository/UpdateRepositoryTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class UpdateRepositoryTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

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

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class AuthorIndexTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

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

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class AuthorRecentsTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

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

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class HealthCheckController extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

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 = '1.1.8'; //TODO: tried to sync this with packageJson but it didn't work.
+const version = '3.0.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/dist/tools/utility/ListRepositoriesTool.d.ts

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class ListRepositoriesTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

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

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class QuickstartTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/tools/utility/QuickstartTool.js

@@ -4,10 +4,10 @@ export class QuickstartTool extends BaseToolController {
         super(ucmClient, logger, publishingAuthorId);
     }
     get name() {
-        return 'ucm_quickstart';
+        return 'ucm_connect';
     }
     get description() {
-        return 'CRITICAL MANDATORY READING: READ THIS FIRST before using any other tools as it will guide you to understand how to use the UCM system and MCP tools effectively';
+        return 'CRITICAL MANDATORY READING QUICKSTART: READ THIS FIRST before using any other tools as it will guide you to understand how to use the UCM system and MCP tools effectively';
     }
     get inputSchema() {
         return {

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

@@ -1,8 +1,8 @@
 import { BaseToolController } from '../base/BaseToolController.js';
-import { UcmApiClient } from '../../clients/UcmApiClient.js';
+import { UcmLocalApiClient } from '../../clients/UcmApiClient.js';
 import { ILogger } from '../../interfaces/ILogger.js';
 export declare class SubmitFeedbackTool extends BaseToolController {
-    constructor(ucmClient: UcmApiClient, logger: ILogger, publishingAuthorId?: string);
+    constructor(ucmClient: UcmLocalApiClient, logger: ILogger, publishingAuthorId?: string);
     get name(): string;
     get description(): string;
     get inputSchema(): any;

package/dist/utils/HttpsAgentFactory.d.ts

@@ -0,0 +1,21 @@
+import https from 'https';
+import { ILogger } from '../interfaces/ILogger.js';
+export interface HttpsAgentOptions {
+    caCertPath?: string;
+}
+/**
+ * Factory for creating HTTPS agents with custom CA certificate support
+ * Enables secure connections to self-signed certificate environments
+ */
+export declare class HttpsAgentFactory {
+    /**
+     * Create an HTTPS agent with optional custom CA certificate
+     *
+     * @param options - Configuration options for the HTTPS agent
+     * @param logger - Logger instance for diagnostic messages
+     * @returns https.Agent configured with custom CA if provided, otherwise undefined
+     * @throws Error if certificate file cannot be read or is invalid
+     */
+    static createAgent(options: HttpsAgentOptions, logger?: ILogger): https.Agent | undefined;
+}
+//# sourceMappingURL=HttpsAgentFactory.d.ts.map

package/dist/utils/HttpsAgentFactory.js

@@ -0,0 +1,50 @@
+import https from 'https';
+import fs from 'fs';
+/**
+ * Factory for creating HTTPS agents with custom CA certificate support
+ * Enables secure connections to self-signed certificate environments
+ */
+export class HttpsAgentFactory {
+    /**
+     * Create an HTTPS agent with optional custom CA certificate
+     *
+     * @param options - Configuration options for the HTTPS agent
+     * @param logger - Logger instance for diagnostic messages
+     * @returns https.Agent configured with custom CA if provided, otherwise undefined
+     * @throws Error if certificate file cannot be read or is invalid
+     */
+    static createAgent(options, logger) {
+        // If no CA certificate path provided, return undefined to use default behavior
+        if (!options.caCertPath) {
+            return undefined;
+        }
+        try {
+            // Load the CA certificate from file
+            const caCert = fs.readFileSync(options.caCertPath, 'utf-8');
+            // Create HTTPS agent with custom CA certificate
+            // rejectUnauthorized: true ensures full certificate validation is maintained
+            const agent = new https.Agent({
+                ca: caCert
+            });
+            if (logger) {
+                logger.info('HttpsAgentFactory', `✓ Loaded CA certificate from: ${options.caCertPath}`);
+            }
+            return agent;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            const detailedMessage = `Failed to load CA certificate from ${options.caCertPath}: ${errorMessage}`;
+            if (logger) {
+                logger.warn('HttpsAgentFactory', detailedMessage);
+                logger.warn('HttpsAgentFactory', 'Continuing without custom CA certificate - using default certificate validation');
+            }
+            else {
+                console.warn(`⚠️  ${detailedMessage}`);
+                console.warn('⚠️  Continuing without custom CA certificate - using default certificate validation');
+            }
+            // Return undefined to fall back to default behavior instead of crashing
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=HttpsAgentFactory.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utaba/ucm-mcp-server",
-  "version": "2.0.0",
+  "version": "4.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": "2.0.0",
+  "version": "4.1.0",
   "description": "Universal Context Manager MCP Server - AI-native artifact management",
   "main": "dist/index.js",
   "type": "module",