kemdicode-mcp 1.15.0

package/dist/tools/system/ai-config.tool.js

@@ -0,0 +1,252 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can distributed under the terms of the GNU
+ * General Public License as published by the Free Software Foundation.
+ */
+/**
+ * AI Configuration Tool
+ *
+ * Manages AI provider settings (API URL, model, API key) and saves them
+ * to the project configuration file (.kemdicode-mcp.json).
+ *
+ * Uses OpenAI SDK - compatible with any OpenAI-compatible API:
+ * - OpenAI
+ * - NVIDIA NIM
+ * - Azure OpenAI
+ * - OpenRouter
+ * - Local models (Ollama, LM Studio)
+ *
+ * @module tools/system/ai-config
+ */
+import { z } from 'zod';
+import { config } from '../../config/index.js';
+import { initAIClient, testConnection as testAIConnection } from '../../ai/index.js';
+/**
+ * AI Config Tool Schema
+ */
+const schema = z.object({
+    action: z
+        .enum(['get', 'set', 'set-key', 'list-providers', 'test'])
+        .describe('Action: get (show current), set (update settings), set-key (set API key securely), list-providers (show available), test (test connection)'),
+    apiBaseUrl: z
+        .string()
+        .url()
+        .optional()
+        .describe('API base URL (e.g., https://api.openai.com/v1, https://integrate.api.nvidia.com/v1)'),
+    primaryModel: z
+        .string()
+        .optional()
+        .describe('Primary model ID (e.g., gpt-4o, moonshotai/kimi-k2.5)'),
+    fallbackModel: z.string().optional().describe('Fallback model ID for quota errors'),
+    apiKey: z.string().optional().describe('API key (use set-key action for secure storage)'),
+    provider: z
+        .string()
+        .optional()
+        .describe('Provider name for presets (openai, nvidia, anthropic, openrouter, local)'),
+});
+/**
+ * Provider presets - examples only, not hardcoded defaults
+ * Users should configure via ai-config --action set
+ */
+const PROVIDER_PRESETS = {
+    openai: {
+        url: 'https://api.openai.com/v1',
+        description: 'OpenAI API',
+    },
+    nvidia: {
+        url: 'https://integrate.api.nvidia.com/v1',
+        description: 'NVIDIA NIM (OpenAI-compatible)',
+    },
+    anthropic: {
+        url: 'https://api.anthropic.com/v1',
+        description: 'Anthropic API',
+    },
+    openrouter: {
+        url: 'https://openrouter.ai/api/v1',
+        description: 'OpenRouter (multi-provider)',
+    },
+    local: {
+        url: 'http://localhost:11434/v1',
+        description: 'Local Ollama/LM Studio',
+    },
+};
+/**
+ * Get current AI configuration (with masked API key)
+ */
+function getCurrentConfig() {
+    const serverConfig = config.get('server');
+    return {
+        apiBaseUrl: serverConfig.apiBaseUrl,
+        primaryModel: serverConfig.primaryModel,
+        fallbackModel: serverConfig.fallbackModel,
+        apiKey: serverConfig.apiKey ? '***' : '(not set)',
+        source: 'config',
+    };
+}
+/**
+ * Set AI configuration values
+ */
+function setConfig(updates) {
+    const serverConfig = config.get('server');
+    if (updates.apiBaseUrl) {
+        serverConfig.apiBaseUrl = updates.apiBaseUrl;
+    }
+    if (updates.primaryModel) {
+        serverConfig.primaryModel = updates.primaryModel;
+    }
+    if (updates.fallbackModel) {
+        serverConfig.fallbackModel = updates.fallbackModel;
+    }
+    if (updates.apiKey) {
+        serverConfig.apiKey = updates.apiKey;
+    }
+    // Save to config file
+    const saved = config.saveToFile(['server']);
+    // Re-initialize AI client with new settings
+    try {
+        if (serverConfig.apiBaseUrl && serverConfig.apiKey) {
+            initAIClient({
+                baseURL: serverConfig.apiBaseUrl,
+                apiKey: serverConfig.apiKey,
+                defaultModel: serverConfig.primaryModel,
+                fallbackModel: serverConfig.fallbackModel,
+            });
+        }
+    }
+    catch {
+        // Ignore re-init errors, will be caught on first use
+    }
+    return (`Configuration updated${saved ? ' and saved to .kemdicode-mcp.json' : ''}:\n` +
+        `- API URL: ${serverConfig.apiBaseUrl}\n` +
+        `- Primary Model: ${serverConfig.primaryModel || '(not set)'}\n` +
+        `- Fallback Model: ${serverConfig.fallbackModel || '(not set)'}`);
+}
+/**
+ * Set API key securely
+ */
+function setApiKey(apiKey) {
+    const serverConfig = config.get('server');
+    serverConfig.apiKey = apiKey;
+    // Save to config file
+    const saved = config.saveToFile(['server']);
+    // Re-initialize AI client
+    try {
+        if (serverConfig.apiBaseUrl) {
+            initAIClient({
+                baseURL: serverConfig.apiBaseUrl,
+                apiKey: apiKey,
+                defaultModel: serverConfig.primaryModel,
+                fallbackModel: serverConfig.fallbackModel,
+            });
+        }
+    }
+    catch {
+        // Ignore re-init errors
+    }
+    return (`API key set${saved ? ' and saved to .kemdicode-mcp.json' : ''}.\n` +
+        `⚠️  Warning: API key is stored in plain text in the config file.\n` +
+        `   Consider using KEMDICODE_SERVER_API_KEY environment variable instead.`);
+}
+/**
+ * List available providers
+ */
+function listProviders() {
+    let output = 'Available AI Providers (OpenAI-compatible):\n\n';
+    for (const [name, preset] of Object.entries(PROVIDER_PRESETS)) {
+        output += `${name}:\n`;
+        output += `  URL: ${preset.url}\n`;
+        output += `  Description: ${preset.description}\n\n`;
+    }
+    output += 'Usage:\n';
+    output += '  ai-config --action set --apiBaseUrl <url> --primaryModel <model>\n';
+    output += '  ai-config --action set --apiKey <key>\n';
+    output += '  ai-config --action test\n';
+    output += '\nUse ai-models --action list to discover available models from your provider.\n';
+    return output;
+}
+/**
+ * Test AI connection using OpenAI SDK
+ */
+async function testConnectionHandler() {
+    const serverConfig = config.get('server');
+    if (!serverConfig.apiBaseUrl) {
+        return '❌ API base URL not configured. Use: ai-config --action set --apiBaseUrl <url>';
+    }
+    if (!serverConfig.apiKey) {
+        return '❌ API key not configured. Use: ai-config --action set --apiKey <key>';
+    }
+    if (!serverConfig.primaryModel) {
+        return '❌ Primary model not configured. Use: ai-config --action set --primaryModel <model>';
+    }
+    try {
+        // Initialize client with current config
+        initAIClient({
+            baseURL: serverConfig.apiBaseUrl,
+            apiKey: serverConfig.apiKey,
+            defaultModel: serverConfig.primaryModel,
+            fallbackModel: serverConfig.fallbackModel,
+        });
+        // Test connection
+        const result = await testAIConnection();
+        if (result.success) {
+            return (`✅ ${result.message}\n` +
+                `   URL: ${serverConfig.apiBaseUrl}\n` +
+                `   Model: ${serverConfig.primaryModel}`);
+        }
+        else {
+            return `❌ ${result.message}`;
+        }
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return `❌ Connection failed: ${msg}`;
+    }
+}
+/**
+ * AI Config Tool
+ */
+export const aiConfigTool = {
+    name: 'ai-config',
+    description: 'Manage AI provider settings (API URL, model, API key). Saves to .kemdicode-mcp.json. Actions: get, set, set-key, list-providers, test. Providers: openai, nvidia, anthropic, openrouter, local',
+    zodSchema: schema,
+    prompt: {
+        description: 'Configure AI provider settings (API URL, model, API key)',
+    },
+    execute: async (args) => {
+        const action = args.action;
+        switch (action) {
+            case 'get':
+                return JSON.stringify(getCurrentConfig(), null, 2);
+            case 'set': {
+                const provider = args.provider;
+                let apiBaseUrl = args.apiBaseUrl;
+                // Apply provider URL preset if specified (model must be set explicitly)
+                if (provider && PROVIDER_PRESETS[provider] && !apiBaseUrl) {
+                    apiBaseUrl = PROVIDER_PRESETS[provider].url;
+                }
+                return setConfig({
+                    apiBaseUrl,
+                    primaryModel: args.primaryModel,
+                    fallbackModel: args.fallbackModel,
+                    apiKey: args.apiKey,
+                });
+            }
+            case 'set-key': {
+                const apiKey = args.apiKey;
+                if (!apiKey) {
+                    throw new Error('API key required. Use: --apiKey <your-key>');
+                }
+                return setApiKey(apiKey);
+            }
+            case 'list-providers':
+                return listProviders();
+            case 'test':
+                return await testConnectionHandler();
+            default:
+                return `Unknown action: ${action}. Use: get, set, set-key, list-providers, test`;
+        }
+    },
+};
+//# sourceMappingURL=ai-config.tool.js.map

package/dist/tools/system/ai-config.tool.js.map

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

package/dist/tools/system/ai-models.tool.d.ts

@@ -0,0 +1,45 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ */
+/**
+ * AI Models Tool
+ *
+ * Lists available AI models from the current provider and allows
+ * agents to select models dynamically for their sessions.
+ *
+ * @module tools/system/ai-models
+ */
+import { z } from 'zod';
+import { UnifiedTool } from '../registry.js';
+/**
+ * AI Models Tool Schema
+ */
+declare const schema: z.ZodObject<{
+    action: z.ZodDefault<z.ZodEnum<{
+        search: "search";
+        list: "list";
+        select: "select";
+    }>>;
+    filter: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    category: z.ZodDefault<z.ZodEnum<{
+        all: "all";
+        code: "code";
+        chat: "chat";
+        vision: "vision";
+        embedding: "embedding";
+    }>>;
+}, z.core.$strip>;
+/**
+ * AI Models Tool
+ */
+export declare const aiModelsTool: UnifiedTool<typeof schema>;
+export {};
+//# sourceMappingURL=ai-models.tool.d.ts.map

package/dist/tools/system/ai-models.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-models.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/system/ai-models.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAc7C;;GAEG;AACH,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;iBAuBV,CAAC;AAoGH;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,OAAO,MAAM,CAwEnD,CAAC"}

package/dist/tools/system/ai-models.tool.js

@@ -0,0 +1,194 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ */
+/**
+ * AI Models Tool
+ *
+ * Lists available AI models from the current provider and allows
+ * agents to select models dynamically for their sessions.
+ *
+ * @module tools/system/ai-models
+ */
+import { z } from 'zod';
+import { config } from '../../config/index.js';
+import { initAIClient } from '../../ai/index.js';
+/**
+ * AI Models Tool Schema
+ */
+const schema = z.object({
+    action: z
+        .enum(['list', 'select', 'search'])
+        .default('list')
+        .describe('Action: list (show all models), select (choose model for session), search (filter models)'),
+    filter: z
+        .string()
+        .optional()
+        .describe('Filter models by name pattern (e.g., "kimi", "llama", "deepseek")'),
+    model: z.string().optional().describe('Model ID to select (for select action)'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .default(50)
+        .describe('Maximum number of models to return'),
+    category: z
+        .enum(['all', 'chat', 'code', 'vision', 'embedding'])
+        .default('all')
+        .describe('Filter by model category (based on common naming patterns)'),
+});
+/**
+ * Fetch models from OpenAI-compatible API
+ */
+async function fetchModels() {
+    const serverConfig = config.get('server');
+    if (!serverConfig.apiBaseUrl) {
+        throw new Error('API base URL not configured');
+    }
+    if (!serverConfig.apiKey) {
+        throw new Error('API key not configured');
+    }
+    const response = await fetch(`${serverConfig.apiBaseUrl}/models`, {
+        method: 'GET',
+        headers: {
+            Authorization: `Bearer ${serverConfig.apiKey}`,
+            'Content-Type': 'application/json',
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`API error: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return data.data || [];
+}
+/**
+ * Categorize model based on name patterns
+ */
+function categorizeModel(modelId) {
+    const id = modelId.toLowerCase();
+    if (id.includes('embed') || id.includes('bge') || id.includes('e5')) {
+        return 'embedding';
+    }
+    if (id.includes('vision') || id.includes('vl') || id.includes('pali') || id.includes('fuyu')) {
+        return 'vision';
+    }
+    if (id.includes('code') || id.includes('starcoder') || id.includes('coder')) {
+        return 'code';
+    }
+    return 'chat';
+}
+/**
+ * Format model list for display
+ */
+function formatModelList(models, filter, category) {
+    let filtered = models;
+    // Apply name filter
+    if (filter) {
+        const pattern = filter.toLowerCase();
+        filtered = filtered.filter((m) => m.id.toLowerCase().includes(pattern));
+    }
+    // Apply category filter
+    if (category && category !== 'all') {
+        filtered = filtered.filter((m) => categorizeModel(m.id) === category);
+    }
+    // Sort alphabetically
+    filtered.sort((a, b) => a.id.localeCompare(b.id));
+    if (filtered.length === 0) {
+        return 'No models found matching criteria.';
+    }
+    // Group by provider/owner
+    const grouped = new Map();
+    for (const model of filtered) {
+        const provider = model.id.split('/')[0] || model.owned_by || 'other';
+        if (!grouped.has(provider)) {
+            grouped.set(provider, []);
+        }
+        grouped.get(provider).push(model);
+    }
+    let output = `Found ${filtered.length} models:\n\n`;
+    for (const [provider, providerModels] of grouped) {
+        output += `## ${provider}\n`;
+        for (const model of providerModels) {
+            const cat = categorizeModel(model.id);
+            const catIcon = cat === 'chat' ? '💬' : cat === 'code' ? '💻' : cat === 'vision' ? '👁️' : '📊';
+            output += `  ${catIcon} ${model.id}\n`;
+        }
+        output += '\n';
+    }
+    return output;
+}
+/**
+ * AI Models Tool
+ */
+export const aiModelsTool = {
+    name: 'ai-models',
+    description: 'List and select AI models from the current provider. Agents can use this to discover available models and switch models dynamically.',
+    zodSchema: schema,
+    execute: async (args) => {
+        const { action, filter, model, limit, category } = args;
+        const serverConfig = config.get('server');
+        switch (action) {
+            case 'list':
+            case 'search': {
+                try {
+                    const models = await fetchModels();
+                    const limited = models.slice(0, limit);
+                    return formatModelList(limited, filter, category);
+                }
+                catch (error) {
+                    const msg = error instanceof Error ? error.message : String(error);
+                    return `Failed to fetch models: ${msg}`;
+                }
+            }
+            case 'select': {
+                if (!model) {
+                    return 'Error: Model ID required. Use: ai-models --action select --model <model-id>';
+                }
+                // Verify model exists
+                try {
+                    const models = await fetchModels();
+                    const found = models.find((m) => m.id === model || m.id.endsWith(`/${model}`));
+                    if (!found) {
+                        // Model not in list, but might still work - warn user
+                        const suggestions = models
+                            .filter((m) => m.id.toLowerCase().includes(model.toLowerCase()))
+                            .slice(0, 5)
+                            .map((m) => m.id);
+                        if (suggestions.length > 0) {
+                            return `Model "${model}" not found. Did you mean:\n${suggestions.map((s) => `  - ${s}`).join('\n')}`;
+                        }
+                    }
+                }
+                catch {
+                    // Can't verify, proceed anyway
+                }
+                // Update config
+                serverConfig.primaryModel = model;
+                config.saveToFile(['server']);
+                // Re-initialize AI client
+                try {
+                    if (serverConfig.apiBaseUrl && serverConfig.apiKey) {
+                        initAIClient({
+                            baseURL: serverConfig.apiBaseUrl,
+                            apiKey: serverConfig.apiKey,
+                            defaultModel: model,
+                        });
+                    }
+                }
+                catch {
+                    // Ignore init errors
+                }
+                return `Model selected: ${model}\n\nThis model will be used for all AI operations in this session.`;
+            }
+            default:
+                return `Unknown action: ${action}`;
+        }
+    },
+};
+//# sourceMappingURL=ai-models.tool.js.map

package/dist/tools/system/ai-models.tool.js.map

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

package/dist/tools/system/config.tool.d.ts

@@ -0,0 +1,57 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * Config Tool
+ *
+ * Runtime configuration management for KemdiCode MCP server.
+ * Manages all configuration groups: server, redis, timeouts,
+ * cache, session, context, limits, retry, rl, loci.
+ *
+ * @module tools/system/config
+ */
+import { z } from 'zod';
+import { UnifiedTool } from '../registry.js';
+declare const schema: z.ZodObject<{
+    action: z.ZodEnum<{
+        set: "set";
+        list: "list";
+        get: "get";
+        reset: "reset";
+        save: "save";
+    }>;
+    group: z.ZodOptional<z.ZodEnum<{
+        server: "server";
+        redis: "redis";
+        timeouts: "timeouts";
+        cache: "cache";
+        session: "session";
+        context: "context";
+        limits: "limits";
+        retry: "retry";
+        rl: "rl";
+        loci: "loci";
+        providers: "providers";
+        all: "all";
+    }>>;
+    primaryModel: z.ZodOptional<z.ZodString>;
+    fallbackModel: z.ZodOptional<z.ZodString>;
+    updates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const configTool: UnifiedTool<typeof schema>;
+export {};
+//# sourceMappingURL=config.tool.d.ts.map

package/dist/tools/system/config.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/system/config.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAsF7C,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;iBA+BV,CAAC;AA6EH,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,OAAO,MAAM,CAgKjD,CAAC"}