ai-consultation-mcp 1.0.0

package/dist/installer/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Tool configuration types for multi-tool installer
+ */
+export type Platform = 'darwin' | 'win32' | 'linux';
+export interface ToolConfigPath {
+    /** Path relative to home directory or absolute */
+    path: string;
+    /** Whether path is relative to home directory */
+    relative: boolean;
+    /** JSON key path to mcpServers object (e.g., "mcpServers" or "context_servers") */
+    mcpKey: string;
+    /** Config format */
+    format: 'json' | 'yaml';
+}
+export interface ToolDefinition {
+    /** Tool identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Tool description */
+    description: string;
+    /** Config paths per platform */
+    configPaths: Partial<Record<Platform, ToolConfigPath>>;
+    /** Detection methods */
+    detection: {
+        /** Check if binary exists in PATH */
+        binary?: string;
+        /** Check if directory exists (relative to home) */
+        directory?: string;
+        /** Check if config file exists */
+        configFile?: boolean;
+        /** VSCode extension ID to check */
+        vscodeExtension?: string;
+    };
+    /** MCP server configuration to add */
+    mcpConfig: {
+        /** Server name in config */
+        serverName: string;
+        /** Command to run */
+        command: string;
+        /** Command arguments */
+        args: string[];
+    };
+    /** Whether tool requires restart after installation */
+    requiresRestart: boolean;
+    /** Installation notes/instructions */
+    notes?: string;
+}
+export interface DetectedTool {
+    tool: ToolDefinition;
+    installed: boolean;
+    configExists: boolean;
+    mcpAlreadyInstalled: boolean;
+    configPath: string;
+}
+export interface InstallResult {
+    tool: ToolDefinition;
+    success: boolean;
+    message: string;
+    configPath?: string;
+    error?: string;
+}
+export interface InstallSummary {
+    detected: DetectedTool[];
+    installed: InstallResult[];
+    skipped: DetectedTool[];
+    errors: InstallResult[];
+}

package/dist/installer/types.js

@@ -0,0 +1,5 @@
+/**
+ * Tool configuration types for multi-tool installer
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/installer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/installer/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/providers/base.d.ts

@@ -0,0 +1,44 @@
+import type { ProviderType } from '../types/index.js';
+import type { IProvider, ProviderMessage, CompletionOptions, ProviderResponse, ProviderErrorInfo } from './types.js';
+/**
+ * Custom error class for provider errors
+ */
+export declare class ProviderError extends Error {
+    readonly info: ProviderErrorInfo;
+    constructor(info: ProviderErrorInfo);
+}
+/**
+ * Abstract base class for all providers
+ */
+export declare abstract class BaseProvider implements IProvider {
+    abstract readonly name: ProviderType;
+    /**
+     * Get the API key for this provider
+     */
+    protected getApiKey(): string | undefined;
+    /**
+     * Check if the provider is configured
+     */
+    isConfigured(): boolean;
+    /**
+     * Create a chat completion - must be implemented by subclasses
+     */
+    abstract createCompletion(messages: ProviderMessage[], options: CompletionOptions): Promise<ProviderResponse>;
+    /**
+     * Format system prompt for models that don't support it directly
+     * Prepends system prompt to the first user message
+     */
+    protected formatSystemPromptAsUser(messages: ProviderMessage[], systemPrompt?: string): ProviderMessage[];
+    /**
+     * Log completion request
+     */
+    protected logRequest(model: string, messageCount: number, options: CompletionOptions): void;
+    /**
+     * Log completion response
+     */
+    protected logResponse(response: ProviderResponse): void;
+    /**
+     * Create a standardized provider error
+     */
+    protected createError(code: string, message: string, retryable: boolean, statusCode?: number): ProviderError;
+}

package/dist/providers/base.js

@@ -0,0 +1,84 @@
+import { getConfigManager } from '../config/index.js';
+import { logger } from '../utils/index.js';
+/**
+ * Custom error class for provider errors
+ */
+export class ProviderError extends Error {
+    info;
+    constructor(info) {
+        super(info.message);
+        this.name = 'ProviderError';
+        this.info = info;
+    }
+}
+/**
+ * Abstract base class for all providers
+ */
+export class BaseProvider {
+    /**
+     * Get the API key for this provider
+     */
+    getApiKey() {
+        return getConfigManager().getProviderKey(this.name);
+    }
+    /**
+     * Check if the provider is configured
+     */
+    isConfigured() {
+        return getConfigManager().isProviderConfigured(this.name);
+    }
+    /**
+     * Format system prompt for models that don't support it directly
+     * Prepends system prompt to the first user message
+     */
+    formatSystemPromptAsUser(messages, systemPrompt) {
+        if (!systemPrompt)
+            return messages;
+        const result = [...messages];
+        const firstUserIndex = result.findIndex((m) => m.role === 'user');
+        if (firstUserIndex >= 0) {
+            result[firstUserIndex] = {
+                ...result[firstUserIndex],
+                content: `[System Instructions]\n${systemPrompt}\n\n[User Query]\n${result[firstUserIndex].content}`,
+            };
+        }
+        return result;
+    }
+    /**
+     * Log completion request
+     */
+    logRequest(model, messageCount, options) {
+        logger.info('Provider completion request', {
+            provider: this.name,
+            model,
+            messageCount,
+            maxTokens: options.maxTokens,
+            hasSystemPrompt: !!options.systemPrompt,
+        });
+    }
+    /**
+     * Log completion response
+     */
+    logResponse(response) {
+        logger.info('Provider completion response', {
+            provider: this.name,
+            model: response.model,
+            finishReason: response.finishReason,
+            usage: response.usage,
+            hasReasoningContent: !!response.reasoningContent,
+        });
+    }
+    /**
+     * Create a standardized provider error
+     */
+    createError(code, message, retryable, statusCode) {
+        return new ProviderError({
+            provider: this.name,
+            code,
+            message,
+            retryable,
+            statusCode,
+        });
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/providers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,IAAI,CAAoB;IAEjC,YAAY,IAAuB;QACjC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAgB,YAAY;IAGhC;;OAEG;IACO,SAAS;QACjB,OAAO,gBAAgB,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,gBAAgB,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAUD;;;OAGG;IACO,wBAAwB,CAChC,QAA2B,EAC3B,YAAqB;QAErB,IAAI,CAAC,YAAY;YAAE,OAAO,QAAQ,CAAC;QAEnC,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;QAC7B,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QAElE,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,cAAc,CAAC,GAAG;gBACvB,GAAG,MAAM,CAAC,cAAc,CAAC;gBACzB,OAAO,EAAE,0BAA0B,YAAY,qBAAqB,MAAM,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE;aACrG,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACO,UAAU,CAClB,KAAa,EACb,YAAoB,EACpB,OAA0B;QAE1B,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE;YACzC,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,KAAK;YACL,YAAY;YACZ,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY;SACxC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACO,WAAW,CAAC,QAA0B;QAC9C,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;YAC1C,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,mBAAmB,EAAE,CAAC,CAAC,QAAQ,CAAC,gBAAgB;SACjD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACO,WAAW,CACnB,IAAY,EACZ,OAAe,EACf,SAAkB,EAClB,UAAmB;QAEnB,OAAO,IAAI,aAAa,CAAC;YACvB,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,IAAI;YACJ,OAAO;YACP,SAAS;YACT,UAAU;SACX,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/providers/deepseek.d.ts

@@ -0,0 +1,30 @@
+import type { ProviderType } from '../types/index.js';
+import type { ProviderMessage, CompletionOptions, ProviderResponse } from './types.js';
+import { BaseProvider } from './base.js';
+/**
+ * DeepSeek Provider - Uses OpenAI-compatible SDK
+ */
+export declare class DeepSeekProvider extends BaseProvider {
+    readonly name: ProviderType;
+    private client;
+    /**
+     * Get or create the OpenAI-compatible client for DeepSeek
+     */
+    private getClient;
+    /**
+     * Check if a model is a reasoning model
+     */
+    private isReasoningModel;
+    /**
+     * Check if a model supports system prompts
+     */
+    private supportsSystemPrompt;
+    /**
+     * Get the actual API model ID
+     */
+    private getApiModel;
+    /**
+     * Create a chat completion
+     */
+    createCompletion(messages: ProviderMessage[], options: CompletionOptions): Promise<ProviderResponse>;
+}

package/dist/providers/deepseek.js

@@ -0,0 +1,148 @@
+import OpenAI from 'openai';
+import { MODEL_CONFIG } from '../types/index.js';
+import { BaseProvider } from './base.js';
+import { logger } from '../utils/index.js';
+/**
+ * DeepSeek API base URL
+ */
+const DEEPSEEK_BASE_URL = 'https://api.deepseek.com';
+/**
+ * DeepSeek Provider - Uses OpenAI-compatible SDK
+ */
+export class DeepSeekProvider extends BaseProvider {
+    name = 'deepseek';
+    client = null;
+    /**
+     * Get or create the OpenAI-compatible client for DeepSeek
+     */
+    getClient() {
+        if (!this.client) {
+            const apiKey = this.getApiKey();
+            if (!apiKey) {
+                throw this.createError('AUTH_ERROR', 'DeepSeek API key not configured', false);
+            }
+            this.client = new OpenAI({
+                apiKey,
+                baseURL: DEEPSEEK_BASE_URL,
+            });
+        }
+        return this.client;
+    }
+    /**
+     * Check if a model is a reasoning model
+     */
+    isReasoningModel(model) {
+        const config = MODEL_CONFIG[model];
+        return config?.isReasoning ?? false;
+    }
+    /**
+     * Check if a model supports system prompts
+     */
+    supportsSystemPrompt(model) {
+        const config = MODEL_CONFIG[model];
+        return config?.supportsSystemPrompt ?? true;
+    }
+    /**
+     * Get the actual API model ID
+     */
+    getApiModel(model) {
+        const config = MODEL_CONFIG[model];
+        return config?.apiModel ?? model;
+    }
+    /**
+     * Create a chat completion
+     */
+    async createCompletion(messages, options) {
+        const client = this.getClient();
+        const apiModel = this.getApiModel(options.model);
+        const isReasoning = this.isReasoningModel(options.model);
+        const supportsSystem = this.supportsSystemPrompt(options.model);
+        this.logRequest(apiModel, messages.length, options);
+        const startTime = Date.now();
+        try {
+            // Build messages array
+            let chatMessages = [];
+            // Handle system prompt
+            if (options.systemPrompt) {
+                if (supportsSystem) {
+                    chatMessages.push({
+                        role: 'system',
+                        content: options.systemPrompt,
+                    });
+                }
+                else {
+                    // For reasoning models, prepend to first user message
+                    messages = this.formatSystemPromptAsUser(messages, options.systemPrompt);
+                }
+            }
+            // Add conversation messages
+            chatMessages.push(...messages.map((m) => ({
+                role: m.role,
+                content: m.content,
+            })));
+            // Build request parameters
+            const requestParams = {
+                model: apiModel,
+                messages: chatMessages,
+            };
+            // Handle token limits differently for reasoning models
+            if (isReasoning) {
+                // Reasoning models use max_completion_tokens
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                requestParams.max_completion_tokens =
+                    options.maxTokens || 4096;
+                // DeepSeek reasoner: temperature must be 0
+                requestParams.temperature = 0;
+            }
+            else {
+                // Standard models use max_tokens
+                requestParams.max_tokens = options.maxTokens || 4096;
+                // Set temperature for non-reasoning models
+                if (options.temperature !== undefined) {
+                    requestParams.temperature = options.temperature;
+                }
+            }
+            const response = await client.chat.completions.create(requestParams);
+            const choice = response.choices[0];
+            const content = choice?.message?.content || '';
+            // Extract reasoning content if present (DeepSeek Reasoner specific)
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const reasoningContent = choice?.message
+                ?.reasoning_content;
+            const responseTime = Date.now() - startTime;
+            if (reasoningContent) {
+                logger.debug('Reasoning content received', {
+                    model: apiModel,
+                    reasoningLength: reasoningContent.length,
+                    thinkingTime: responseTime,
+                });
+            }
+            const result = {
+                content,
+                model: response.model,
+                usage: response.usage
+                    ? {
+                        promptTokens: response.usage.prompt_tokens,
+                        completionTokens: response.usage.completion_tokens,
+                        totalTokens: response.usage.total_tokens,
+                    }
+                    : undefined,
+                finishReason: choice?.finish_reason || undefined,
+                reasoningContent,
+                responseTime,
+            };
+            this.logResponse(result);
+            return result;
+        }
+        catch (error) {
+            if (error instanceof OpenAI.APIError) {
+                const retryable = error.status === 429 ||
+                    error.status === 500 ||
+                    error.status === 503;
+                throw this.createError(error.code || 'API_ERROR', error.message, retryable, error.status);
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=deepseek.js.map

package/dist/providers/deepseek.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseek.js","sourceRoot":"","sources":["../../src/providers/deepseek.ts"],"names":[],"mappings":"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"}

package/dist/providers/index.d.ts

@@ -0,0 +1,5 @@
+export type { IProvider, ProviderMessage, CompletionOptions, ProviderResponse, TokenUsage, ProviderErrorInfo, ModelConfig, } from './types.js';
+export { BaseProvider, ProviderError } from './base.js';
+export { ProviderRegistry, getProviderRegistry, initializeProviders, } from './registry.js';
+export { DeepSeekProvider } from './deepseek.js';
+export { OpenAIProvider } from './openai.js';

package/dist/providers/index.js

@@ -0,0 +1,8 @@
+// Base
+export { BaseProvider, ProviderError } from './base.js';
+// Registry
+export { ProviderRegistry, getProviderRegistry, initializeProviders, } from './registry.js';
+// Providers
+export { DeepSeekProvider } from './deepseek.js';
+export { OpenAIProvider } from './openai.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAWA,OAAO;AACP,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAExD,WAAW;AACX,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/providers/openai.d.ts

@@ -0,0 +1,30 @@
+import type { ProviderType } from '../types/index.js';
+import type { ProviderMessage, CompletionOptions, ProviderResponse } from './types.js';
+import { BaseProvider } from './base.js';
+/**
+ * OpenAI Provider - GPT-5.2 models
+ */
+export declare class OpenAIProvider extends BaseProvider {
+    readonly name: ProviderType;
+    private client;
+    /**
+     * Get or create the OpenAI client
+     */
+    private getClient;
+    /**
+     * Check if a model is a reasoning model
+     */
+    private isReasoningModel;
+    /**
+     * Get reasoning effort for the model
+     */
+    private getReasoningEffort;
+    /**
+     * Get the actual API model ID
+     */
+    private getApiModel;
+    /**
+     * Create a chat completion
+     */
+    createCompletion(messages: ProviderMessage[], options: CompletionOptions): Promise<ProviderResponse>;
+}

package/dist/providers/openai.js

@@ -0,0 +1,123 @@
+import OpenAI from 'openai';
+import { MODEL_CONFIG } from '../types/index.js';
+import { BaseProvider } from './base.js';
+import { logger } from '../utils/index.js';
+/**
+ * OpenAI Provider - GPT-5.2 models
+ */
+export class OpenAIProvider extends BaseProvider {
+    name = 'openai';
+    client = null;
+    /**
+     * Get or create the OpenAI client
+     */
+    getClient() {
+        if (!this.client) {
+            const apiKey = this.getApiKey();
+            if (!apiKey) {
+                throw this.createError('AUTH_ERROR', 'OpenAI API key not configured', false);
+            }
+            this.client = new OpenAI({
+                apiKey,
+            });
+        }
+        return this.client;
+    }
+    /**
+     * Check if a model is a reasoning model
+     */
+    isReasoningModel(model) {
+        const config = MODEL_CONFIG[model];
+        return config?.isReasoning ?? false;
+    }
+    /**
+     * Get reasoning effort for the model
+     */
+    getReasoningEffort(model) {
+        const config = MODEL_CONFIG[model];
+        return config?.reasoningEffort;
+    }
+    /**
+     * Get the actual API model ID
+     */
+    getApiModel(model) {
+        const config = MODEL_CONFIG[model];
+        return config?.apiModel ?? model;
+    }
+    /**
+     * Create a chat completion
+     */
+    async createCompletion(messages, options) {
+        const client = this.getClient();
+        const apiModel = this.getApiModel(options.model);
+        const isReasoning = this.isReasoningModel(options.model);
+        const reasoningEffort = this.getReasoningEffort(options.model);
+        this.logRequest(apiModel, messages.length, options);
+        const startTime = Date.now();
+        try {
+            // Build messages array
+            const chatMessages = [];
+            // Add system prompt if provided
+            if (options.systemPrompt) {
+                chatMessages.push({
+                    role: 'system',
+                    content: options.systemPrompt,
+                });
+            }
+            // Add conversation messages
+            chatMessages.push(...messages.map((m) => ({
+                role: m.role,
+                content: m.content,
+            })));
+            // Build request parameters
+            const requestParams = {
+                model: apiModel,
+                messages: chatMessages,
+                max_tokens: options.maxTokens || 4096,
+            };
+            // Add reasoning effort for GPT-5.2 models
+            if (isReasoning && reasoningEffort) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                requestParams.reasoning_effort = reasoningEffort;
+            }
+            // Set temperature for non-reasoning or if specified
+            if (options.temperature !== undefined) {
+                requestParams.temperature = options.temperature;
+            }
+            const response = await client.chat.completions.create(requestParams);
+            const choice = response.choices[0];
+            const content = choice?.message?.content || '';
+            const responseTime = Date.now() - startTime;
+            logger.debug('OpenAI response received', {
+                model: apiModel,
+                responseTime,
+                finishReason: choice?.finish_reason,
+            });
+            const result = {
+                content,
+                model: response.model,
+                usage: response.usage
+                    ? {
+                        promptTokens: response.usage.prompt_tokens,
+                        completionTokens: response.usage.completion_tokens,
+                        totalTokens: response.usage.total_tokens,
+                    }
+                    : undefined,
+                finishReason: choice?.finish_reason || undefined,
+                responseTime,
+            };
+            this.logResponse(result);
+            return result;
+        }
+        catch (error) {
+            if (error instanceof OpenAI.APIError) {
+                const retryable = error.status === 429 ||
+                    error.status === 500 ||
+                    error.status === 503;
+                throw this.createError(error.code || 'API_ERROR', error.message, retryable, error.status);
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"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"}

package/dist/providers/registry.d.ts

@@ -0,0 +1,37 @@
+import type { ProviderType } from '../types/index.js';
+import type { IProvider } from './types.js';
+/**
+ * Registry for managing provider instances
+ */
+export declare class ProviderRegistry {
+    private providers;
+    /**
+     * Register a provider
+     */
+    register(provider: IProvider): void;
+    /**
+     * Get a provider by name
+     */
+    getProvider(name: ProviderType): IProvider;
+    /**
+     * Check if a provider exists
+     */
+    hasProvider(name: ProviderType): boolean;
+    /**
+     * Get all registered providers
+     */
+    getAllProviders(): IProvider[];
+    /**
+     * Get all configured providers
+     */
+    getConfiguredProviders(): IProvider[];
+}
+/**
+ * Get the provider registry instance
+ */
+export declare function getProviderRegistry(): ProviderRegistry;
+/**
+ * Initialize the registry with all providers
+ * Called during server startup
+ */
+export declare function initializeProviders(): Promise<void>;