imcp 0.0.16 → 0.0.18

package/dist/core/metadatas/constants.js

@@ -0,0 +1,94 @@
+import os from 'os';
+import path from 'path';
+/**
+ * Defines constants used across the application.
+ */
+/**
+ * GitHub repository configuration for feeds
+ */
+export const GITHUB_REPO = {
+    url: 'https://github.com/ai-microsoft/imcp-feed.git',
+    repoName: 'ai-microsoft/imcp-feed',
+    feedsPath: 'feeds',
+    feedAssetsName: 'imcp-feeds-${latest}.zip',
+};
+/**
+ * Local settings directory path based on OS
+ */
+export const SETTINGS_DIR = (() => {
+    switch (process.platform) {
+        case 'win32':
+            return path.join(os.homedir(), '.imcp');
+        default: // linux, darwin (macOS), etc.
+            return path.join(os.homedir(), '.imcp');
+    }
+})();
+/**
+ * Local feeds directory path
+ */
+export const LOCAL_FEEDS_DIR = path.join(SETTINGS_DIR, 'feeds');
+export const LOCAL_FEEDS_SCHEMA_DIR = path.join(LOCAL_FEEDS_DIR, 'schemas');
+const CODE_STRORAGE_DIR = (() => {
+    switch (process.platform) {
+        case 'win32':
+            return path.join(os.homedir(), 'AppData', 'Roaming', 'Code', 'User');
+        case 'darwin': // macOS
+            return path.join(os.homedir(), 'Library', 'Application Support', 'Code', 'User');
+        default: // linux
+            return path.join(os.homedir(), '.config', 'Code', 'User');
+    }
+})();
+const CODE_INSIDER_STRORAGE_DIR = (() => {
+    switch (process.platform) {
+        case 'win32':
+            return path.join(os.homedir(), 'AppData', 'Roaming', 'Code - Insiders', 'User');
+        case 'darwin': // macOS
+            return path.join(os.homedir(), 'Library', 'Application Support', 'Code - Insiders', 'User');
+        default: // linux
+            return path.join(os.homedir(), '.config', 'Code - Insiders', 'User');
+    }
+})();
+/**
+ * Supported client configurations.
+ * Key: Client name (e.g., 'vscode')
+ * Value: Client-specific settings or configuration details.
+ * TODO: Define actual client settings structure.
+ */
+export const SUPPORTED_CLIENTS = {
+    'MSRooCode': {
+        extension: {
+            extensionId: 'microsoftai.ms-roo-cline',
+            leastVersion: '0.0.8',
+            repository: 'ai-microsoft/roo-cline',
+            assetName: 'ms-roo-cline-${version}.vsix',
+            private: true
+        },
+        codeSettingPath: path.join(CODE_STRORAGE_DIR, 'globalStorage', 'microsoftai.ms-roo-cline', 'settings', 'cline_mcp_settings.json'),
+        codeInsiderSettingPath: path.join(CODE_INSIDER_STRORAGE_DIR, 'globalStorage', 'microsoftai.ms-roo-cline', 'settings', 'cline_mcp_settings.json'),
+    },
+    'Cline': {
+        extension: {
+            extensionId: 'saoudrizwan.claude-dev',
+        },
+        codeSettingPath: path.join(CODE_STRORAGE_DIR, 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json'),
+        codeInsiderSettingPath: path.join(CODE_INSIDER_STRORAGE_DIR, 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json'),
+    },
+    'GithubCopilot': {
+        extension: {
+            extensionId: 'github.copilot',
+        },
+        codeSettingPath: path.join(CODE_STRORAGE_DIR, 'settings.json'),
+        codeInsiderSettingPath: path.join(CODE_INSIDER_STRORAGE_DIR, 'settings.json'),
+    },
+    // Add other supported clients here
+};
+/**
+ * List of supported client names.
+ */
+export const SUPPORTED_CLIENT_NAMES = Object.keys(SUPPORTED_CLIENTS);
+/**
+ * Minimum time between requirement update checks (in milliseconds)
+ * 10 minutes = 10 * 60 * 1000 = 600000 ms
+ */
+export const UPDATE_CHECK_INTERVAL_MS = 10 * 60 * 1000; // 10 minutes
+//# sourceMappingURL=constants.js.map

package/dist/core/metadatas/types.d.ts

@@ -0,0 +1,167 @@
+export declare enum OSType {
+    Windows = "windows",
+    MacOS = "macos",
+    Linux = "linux"
+}
+export interface RequirementStatus {
+    name: string;
+    type: string;
+    installed: boolean;
+    inProgress?: boolean;
+    version?: string;
+    error?: string;
+    availableUpdate?: {
+        version: string;
+        message: string;
+    };
+    lastCheckTime?: string;
+    operationStatus?: OperationStatus;
+    pythonEnv?: string;
+    npmPath?: string;
+}
+export interface MCPServerStatus {
+    installedStatus: Record<string, OperationStatus>;
+    name: string;
+    error?: string;
+}
+export interface OperationStatus {
+    status: 'pending' | 'in-progress' | 'completed' | 'failed';
+    type: 'install' | 'uninstall' | 'update' | 'check';
+    target: 'requirement' | 'server';
+    message?: string;
+    error?: string;
+    operationId?: string;
+}
+export interface InstallationStatus {
+    requirementsStatus: Record<string, RequirementStatus>;
+    serversStatus: Record<string, MCPServerStatus>;
+    lastUpdated: string;
+}
+export interface MCPServerCategory {
+    name: string;
+    displayName: string;
+    description?: string;
+    type: 'local';
+    path?: string;
+    installationStatus?: InstallationStatus;
+    feedConfiguration?: FeedConfiguration;
+}
+export interface ServerCategoryListOptions {
+    local?: boolean;
+}
+export interface ServerOperationResult {
+    success: boolean;
+    message?: string;
+    error?: Error;
+    output?: string;
+    status?: OperationStatus[];
+}
+export interface MCPConfiguration {
+    localServerCategories: MCPServerCategory[];
+    feeds: Record<string, FeedConfiguration>;
+    clientMCPSettings?: Record<string, Record<string, any>>;
+}
+export interface ServerInstallOptions {
+    force?: boolean;
+    env?: Record<string, string>;
+    targetClients?: string[];
+    requirements?: RequirementConfig[];
+    args?: string[];
+    settings?: Record<string, any>;
+}
+export interface UpdateRequirementOptions {
+    requirementName: string;
+    updateVersion: string;
+}
+export interface ServerUninstallOptions {
+    removeData?: boolean;
+    targets?: string[];
+}
+export interface EnvVariableConfig {
+    Required: boolean;
+    Description: string;
+    Default?: string;
+}
+export interface InstallationConfig {
+    command: string;
+    args: string[];
+    env?: Record<string, EnvVariableConfig>;
+    url?: string;
+}
+export interface DependencyConfig {
+    requirements?: Array<{
+        name: string;
+        version: string;
+        order?: number;
+    }>;
+    mcpServers?: Array<{
+        name: string;
+    }>;
+}
+export interface McpConfig {
+    name: string;
+    description: string;
+    mode: 'stdio' | 'sse';
+    dependencies?: DependencyConfig;
+    schemas?: string;
+    repository?: string;
+    systemTags?: Record<string, string>;
+    installation: InstallationConfig;
+}
+export interface RegistryConfig {
+    githubRelease?: {
+        repository: string;
+        assetsName?: string;
+        assetName: string;
+    };
+    artifacts?: {
+        registryUrl: string;
+        registryName: string;
+    };
+}
+export interface RequirementConfig {
+    name: string;
+    type: 'npm' | 'pip' | 'command' | 'extension' | 'other';
+    alias?: string;
+    version: string;
+    registry?: RegistryConfig;
+}
+export interface FeedConfiguration {
+    name: string;
+    displayName: string;
+    description: string;
+    repository?: string;
+    PullRequest?: string;
+    requirements: RequirementConfig[];
+    mcpServers: McpConfig[];
+    systemTags?: Record<string, string>;
+}
+export interface ClientSettings {
+    codeSettingPath: string;
+    codeInsiderSettingPath: string;
+}
+export declare enum MCPEvent {
+    SERVER_INSTALLED = "server:installed",
+    SERVER_UNINSTALLED = "server:uninstalled",
+    SERVER_STARTED = "server:started",
+    SERVER_STOPPED = "server:stopped",
+    CONFIG_CHANGED = "config:changed"
+}
+export interface MCPEventData {
+    [MCPEvent.SERVER_INSTALLED]: {
+        server: MCPServerCategory;
+    };
+    [MCPEvent.SERVER_UNINSTALLED]: {
+        serverName: string;
+        targets?: string[];
+    };
+    [MCPEvent.SERVER_STARTED]: {
+        server: MCPServerCategory;
+    };
+    [MCPEvent.SERVER_STOPPED]: {
+        serverName: string;
+    };
+    [MCPEvent.CONFIG_CHANGED]: {
+        configuration: MCPConfiguration;
+    };
+}

package/dist/core/metadatas/types.js

@@ -0,0 +1,16 @@
+export var OSType;
+(function (OSType) {
+    OSType["Windows"] = "windows";
+    OSType["MacOS"] = "macos";
+    OSType["Linux"] = "linux";
+})(OSType || (OSType = {}));
+// Events that can be emitted by the SDK
+export var MCPEvent;
+(function (MCPEvent) {
+    MCPEvent["SERVER_INSTALLED"] = "server:installed";
+    MCPEvent["SERVER_UNINSTALLED"] = "server:uninstalled";
+    MCPEvent["SERVER_STARTED"] = "server:started";
+    MCPEvent["SERVER_STOPPED"] = "server:stopped";
+    MCPEvent["CONFIG_CHANGED"] = "config:changed";
+})(MCPEvent || (MCPEvent = {}));
+//# sourceMappingURL=types.js.map

package/dist/core/onboard/FeedOnboardService.d.ts

@@ -1,10 +1,17 @@
-import { FeedConfiguration } from '../types.js';
+import { FeedConfiguration } from '../metadatas/types.js';
 import { OperationStatus } from './OnboardStatus.js';
 /**
  * Service for handling feed onboarding operations
  */
 export declare class FeedOnboardService {
     constructor();
+    /**
+     * Creates an operation ID that combines feed name and operation type.
+     * @param feedName The name of the feed.
+     * @param operationType The type of operation.
+     * @returns Combined operation ID string.
+     */
+    private createOperationId;
     /**
      * Onboard a new feed configuration
      * @param config Feed configuration to onboard
@@ -26,20 +33,15 @@ export declare class FeedOnboardService {
      * If an existing operation is found, its status is returned. Otherwise, a new operation is created and started.
      * @param config The feed configuration.
      * @param operationType The type of operation to initiate (FULL_ONBOARDING or VALIDATION_ONLY).
+     * @param serverList The list of server names to process.
      * @returns A promise that resolves to the operation status.
      */
     private _initiateOperation;
-    /**
-     * Finds an existing non-completed operation for a given feed name, server name, and operation type.
-     * @param feedName The name of the feed.
-     * @param operationType The type of operation.
-     * @returns A promise that resolves to the OnboardStatus of the existing operation, or undefined if not found.
-     */
-    private _findExistingNonCompletedOperation;
     /**
      * Performs static validation of the feed configuration.
      * @param config The feed configuration to validate.
      * @param forExistingCategory Whether this is for an existing category.
+     * @returns A promise that resolves to a list of server names to be processed.
      * @throws Error if validation fails.
      */
     private validateStaticConfig;
@@ -48,6 +50,8 @@ export declare class FeedOnboardService {
      * Updates the onboarding status to VALIDATING, then to VALIDATED or FAILED based on the validation result.
      * @param onboardingId The ID of the onboarding process.
      * @param config The feed configuration to validate.
+     * @param operationType The type of operation this validation is for.
+     * @param serverList The list of server names to validate.
      * @throws Error if validation fails, to be caught by the calling process.
      */
     private _validateFeedConfiguration;
@@ -57,6 +61,8 @@ export declare class FeedOnboardService {
      * If validation fails, the error is handled by _validateFeedConfiguration and the calling _initiateOperation method.
      * @param onboardingId The ID of the onboarding process.
      * @param config The feed configuration.
+     * @param operationType The type of operation (should be 'VALIDATION_ONLY').
+     * @param serverList The list of server names to validate.
      */
     private processValidationOnly;
     /**
@@ -65,6 +71,7 @@ export declare class FeedOnboardService {
      * Manages status updates throughout the process and handles cleanup of temporary directories.
      * @param onboardingId The ID of the onboarding process.
      * @param config The feed configuration.
+     * @param operationType The type of operation (should be 'FULL_ONBOARDING').
      * @throws Error if any step of the full onboarding process fails.
      */
     private processFullOnboarding;