turboflux 1.0.0

package/dist/core/mcp/client.d.ts

@@ -0,0 +1,32 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import type { McpServerConfig, McpToolInfo } from './types';
+export declare function buildMcpEnvironment(config: McpServerConfig, sourceEnv?: NodeJS.ProcessEnv): Record<string, string>;
+export interface McpConnection {
+    name: string;
+    client: Client;
+    transport?: Transport;
+    tools: McpToolInfo[];
+    status: 'connecting' | 'connected' | 'error' | 'closed';
+    error?: string;
+    instructions?: string;
+    toolTimeoutMs: number;
+}
+export declare class McpClient {
+    private connections;
+    private buildEnvironment;
+    connect(name: string, config: McpServerConfig): Promise<McpConnection>;
+    private discoverTools;
+    callTool(serverName: string, toolName: string, args: Record<string, unknown>, options?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        content: string;
+        isError: boolean;
+    }>;
+    disconnect(name: string): Promise<void>;
+    disconnectAll(): Promise<void>;
+    getConnection(name: string): McpConnection | undefined;
+    getAllConnections(): McpConnection[];
+    getAllTools(): McpToolInfo[];
+    searchTools(query: string, limit?: number): McpToolInfo[];
+}

package/dist/core/mcp/client.js

@@ -0,0 +1,186 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+const INHERITED_ENV_ALLOWLIST = new Set([
+    'PATH',
+    'PATHEXT',
+    'SYSTEMROOT',
+    'WINDIR',
+    'COMSPEC',
+    'TMPDIR',
+    'TMP',
+    'TEMP',
+    'SHELL',
+    'LANG',
+    'LC_ALL',
+    'LC_CTYPE',
+    'TERM',
+    'COLORTERM',
+    'NO_COLOR',
+    'FORCE_COLOR',
+]);
+export function buildMcpEnvironment(config, sourceEnv = process.env) {
+    const environment = {};
+    for (const [name, value] of Object.entries(sourceEnv)) {
+        if (typeof value === 'string' && INHERITED_ENV_ALLOWLIST.has(name.toUpperCase())) {
+            environment[name] = value;
+        }
+    }
+    return { ...environment, ...(config.env || {}) };
+}
+export class McpClient {
+    connections = new Map();
+    buildEnvironment(config) {
+        return buildMcpEnvironment(config);
+    }
+    async connect(name, config) {
+        if (!config.command && !config.url) {
+            throw new Error(`MCP server "${name}" has no command or URL configured`);
+        }
+        if (this.connections.has(name))
+            await this.disconnect(name);
+        const client = new Client({ name: 'turboflux', version: '1.0.0' }, { capabilities: {} });
+        const conn = {
+            name,
+            client,
+            tools: [],
+            status: 'connecting',
+            toolTimeoutMs: normalizeTimeout(config.toolTimeoutMs, 60_000),
+        };
+        this.connections.set(name, conn);
+        try {
+            const environment = this.buildEnvironment(config);
+            const transport = config.url
+                ? new StreamableHTTPClientTransport(new URL(config.url), {
+                    requestInit: config.httpHeaders ? { headers: config.httpHeaders } : undefined,
+                })
+                : new StdioClientTransport({
+                    command: config.command,
+                    args: config.args || [],
+                    env: environment,
+                    cwd: config.cwd,
+                    stderr: 'pipe',
+                });
+            conn.transport = transport;
+            if (transport instanceof StdioClientTransport)
+                transport.stderr?.on('data', () => { });
+            await withTimeout(client.connect(transport), normalizeTimeout(config.startupTimeoutMs, 10_000), `MCP server "${name}" startup timed out`);
+            conn.status = 'connected';
+            conn.instructions = client.getInstructions();
+            conn.tools = await this.discoverTools(name, client, config, conn.instructions);
+        }
+        catch (err) {
+            try {
+                await conn.transport?.close();
+            }
+            catch { }
+            conn.status = 'error';
+            conn.error = err.message;
+        }
+        return conn;
+    }
+    async discoverTools(serverName, client, config, instructions) {
+        try {
+            const result = await client.listTools();
+            const enabled = config.enabledTools?.length ? new Set(config.enabledTools) : null;
+            const disabled = new Set(config.disabledTools || []);
+            return (result.tools || [])
+                .filter(tool => (!enabled || enabled.has(tool.name)) && !disabled.has(tool.name))
+                .map(tool => ({
+                name: `${serverName}__${tool.name}`,
+                description: tool.description || '',
+                inputSchema: tool.inputSchema || {},
+                serverName,
+                instructions,
+                annotations: tool.annotations,
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    async callTool(serverName, toolName, args, options) {
+        const conn = this.connections.get(serverName);
+        if (!conn || conn.status !== 'connected') {
+            return { content: `MCP server "${serverName}" is not connected`, isError: true };
+        }
+        try {
+            const result = await conn.client.callTool({ name: toolName, arguments: args }, undefined, { timeout: conn.toolTimeoutMs, signal: options?.signal });
+            const text = result.content
+                ?.map((c) => c.type === 'text' ? c.text : JSON.stringify(c))
+                .join('\n') || '';
+            return { content: text, isError: !!result.isError };
+        }
+        catch (err) {
+            return { content: `MCP tool error: ${err.message}`, isError: true };
+        }
+    }
+    async disconnect(name) {
+        const conn = this.connections.get(name);
+        if (!conn)
+            return;
+        try {
+            await conn.transport?.close();
+        }
+        catch { }
+        conn.status = 'closed';
+        this.connections.delete(name);
+    }
+    async disconnectAll() {
+        for (const name of this.connections.keys()) {
+            await this.disconnect(name);
+        }
+    }
+    getConnection(name) {
+        return this.connections.get(name);
+    }
+    getAllConnections() {
+        return [...this.connections.values()];
+    }
+    getAllTools() {
+        const tools = [];
+        for (const conn of this.connections.values()) {
+            if (conn.status === 'connected') {
+                tools.push(...conn.tools);
+            }
+        }
+        return tools;
+    }
+    searchTools(query, limit = 8) {
+        const terms = query.toLowerCase().split(/[^a-z0-9_]+/).filter(Boolean);
+        const cap = Math.max(1, Math.min(20, Math.floor(limit)));
+        return this.getAllTools()
+            .map((tool, index) => {
+            const haystack = `${tool.name} ${tool.description} ${tool.instructions || ''}`.toLowerCase();
+            const score = terms.length === 0
+                ? 0
+                : terms.reduce((total, term) => total + (haystack.includes(term) ? (tool.name.toLowerCase().includes(term) ? 3 : 1) : 0), 0);
+            return { tool, score, index };
+        })
+            .filter(entry => terms.length === 0 || entry.score > 0)
+            .sort((left, right) => right.score - left.score || left.index - right.index)
+            .slice(0, cap)
+            .map(entry => entry.tool);
+    }
+}
+function normalizeTimeout(value, fallback) {
+    if (!Number.isFinite(value))
+        return fallback;
+    return Math.max(250, Math.min(10 * 60_000, Math.floor(value)));
+}
+async function withTimeout(promise, timeoutMs, message) {
+    let timer;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error(message)), timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/core/mcp/client.js.map

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

package/dist/core/mcp/settings.d.ts

@@ -0,0 +1,2 @@
+import type { McpSettings } from './types';
+export declare function loadMcpSettings(workspacePath: string): McpSettings;

package/dist/core/mcp/settings.js

@@ -0,0 +1,26 @@
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+export function loadMcpSettings(workspacePath) {
+    const projectSettings = join(workspacePath, '.turboflux', 'settings.json');
+    const globalSettings = join(homedir(), '.turboflux', 'settings.json');
+    let merged = { mcpServers: {} };
+    if (existsSync(globalSettings)) {
+        try {
+            const raw = JSON.parse(readFileSync(globalSettings, 'utf-8'));
+            if (raw.mcpServers)
+                merged.mcpServers = { ...merged.mcpServers, ...raw.mcpServers };
+        }
+        catch { }
+    }
+    if (existsSync(projectSettings)) {
+        try {
+            const raw = JSON.parse(readFileSync(projectSettings, 'utf-8'));
+            if (raw.mcpServers)
+                merged.mcpServers = { ...merged.mcpServers, ...raw.mcpServers };
+        }
+        catch { }
+    }
+    return merged;
+}
+//# sourceMappingURL=settings.js.map

package/dist/core/mcp/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../../src/core/mcp/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAA;AAG5B,MAAM,UAAU,eAAe,CAAC,aAAqB;IACnD,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,EAAE,YAAY,EAAE,eAAe,CAAC,CAAA;IAC1E,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,eAAe,CAAC,CAAA;IAErE,IAAI,MAAM,GAAgB,EAAE,UAAU,EAAE,EAAE,EAAE,CAAA;IAG5C,IAAI,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAA;YAC7D,IAAI,GAAG,CAAC,UAAU;gBAAE,MAAM,CAAC,UAAU,GAAG,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,GAAG,GAAG,CAAC,UAAU,EAAE,CAAA;QACrF,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAGD,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAA;YAC9D,IAAI,GAAG,CAAC,UAAU;gBAAE,MAAM,CAAC,UAAU,GAAG,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,GAAG,GAAG,CAAC,UAAU,EAAE,CAAA;QACrF,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/core/mcp/toolBridge.d.ts

@@ -0,0 +1,20 @@
+import type { AgentTool } from '../../shared/agentTypes';
+import type { McpClient } from './client';
+import type { McpToolInfo } from './types';
+export declare function mcpToolToAgentTool(tool: McpToolInfo): AgentTool;
+export declare function validateMcpToolArgs(schema: Record<string, unknown>, args: Record<string, unknown>): {
+    valid: boolean;
+    error?: string;
+};
+export declare function getMcpAgentTools(mcpClient: McpClient): AgentTool[];
+export declare function isMcpTool(toolName: string): boolean;
+export declare function parseMcpToolName(toolName: string): {
+    serverName: string;
+    originalName: string;
+} | null;
+export declare function executeMcpTool(mcpClient: McpClient, toolName: string, args: Record<string, unknown>, options?: {
+    signal?: AbortSignal;
+}): Promise<{
+    output: string;
+    isError: boolean;
+}>;

package/dist/core/mcp/toolBridge.js

@@ -0,0 +1,74 @@
+import { validateSchemaValue } from '../schemaValidation';
+export function mcpToolToAgentTool(tool) {
+    const params = extractParameters(tool.inputSchema);
+    const isReadOnly = tool.annotations?.readOnlyHint === true;
+    const isDestructive = isReadOnly ? false : tool.annotations?.destructiveHint !== false;
+    return {
+        name: tool.name,
+        description: `[MCP:${tool.serverName}] ${tool.description}${tool.instructions ? `\nServer guidance: ${tool.instructions.slice(0, 512)}` : ''}`,
+        category: isReadOnly ? 'read' : 'execute',
+        parameters: params,
+        isReadOnly,
+        isDestructive,
+        isConcurrencySafe: isReadOnly && tool.annotations?.openWorldHint !== true,
+        inputSchema: tool.inputSchema,
+    };
+}
+export function validateMcpToolArgs(schema, args) {
+    return validateSchemaValue(schema, args, '');
+}
+function extractParameters(schema) {
+    const properties = (schema.properties || {});
+    const required = (schema.required || []);
+    const params = [];
+    for (const [name, prop] of Object.entries(properties).sort(([a], [b]) => a.localeCompare(b))) {
+        params.push({
+            name,
+            type: mapJsonSchemaType(prop.type),
+            description: prop.description || '',
+            required: required.includes(name),
+            enum: prop.enum,
+            default: prop.default,
+        });
+    }
+    return params;
+}
+function mapJsonSchemaType(type) {
+    switch (type) {
+        case 'string': return 'string';
+        case 'number':
+        case 'integer': return 'number';
+        case 'boolean': return 'boolean';
+        case 'array': return 'array';
+        case 'object': return 'object';
+        default: return 'string';
+    }
+}
+export function getMcpAgentTools(mcpClient) {
+    return mcpClient
+        .getAllTools()
+        .map(mcpToolToAgentTool)
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+export function isMcpTool(toolName) {
+    return toolName.includes('__');
+}
+export function parseMcpToolName(toolName) {
+    const idx = toolName.indexOf('__');
+    if (idx === -1)
+        return null;
+    return {
+        serverName: toolName.slice(0, idx),
+        originalName: toolName.slice(idx + 2),
+    };
+}
+export async function executeMcpTool(mcpClient, toolName, args, options) {
+    const parsed = parseMcpToolName(toolName);
+    if (!parsed)
+        return { output: `Invalid MCP tool name: ${toolName}`, isError: true };
+    const result = options
+        ? await mcpClient.callTool(parsed.serverName, parsed.originalName, args, options)
+        : await mcpClient.callTool(parsed.serverName, parsed.originalName, args);
+    return { output: result.content, isError: result.isError };
+}
+//# sourceMappingURL=toolBridge.js.map

package/dist/core/mcp/toolBridge.js.map

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

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

@@ -0,0 +1,29 @@
+export interface McpServerConfig {
+    command?: string;
+    args?: string[];
+    url?: string;
+    env?: Record<string, string>;
+    cwd?: string;
+    httpHeaders?: Record<string, string>;
+    startupTimeoutMs?: number;
+    toolTimeoutMs?: number;
+    enabledTools?: string[];
+    disabledTools?: string[];
+    enabled: boolean;
+}
+export interface McpSettings {
+    mcpServers: Record<string, McpServerConfig>;
+}
+export interface McpToolInfo {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    serverName: string;
+    instructions?: string;
+    annotations?: {
+        readOnlyHint?: boolean;
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
+    };
+}

package/dist/core/mcp/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/mcp/types.js.map

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

package/dist/core/modelDiscovery.d.ts

@@ -0,0 +1,14 @@
+import { type ModelPreset, type TurboFluxConfig } from './config';
+export interface ModelDiscoveryResult {
+    models: ModelPreset[];
+    fetchedAt: number;
+    source: 'network' | 'cache' | 'fallback';
+    stale: boolean;
+    error?: string;
+}
+export interface ModelDiscoveryOptions {
+    force?: boolean;
+}
+export declare function readCachedModelDiscovery(config: TurboFluxConfig, allowStale?: boolean): ModelDiscoveryResult | undefined;
+export declare function discoverModelPresets(config: TurboFluxConfig, options?: ModelDiscoveryOptions): Promise<ModelDiscoveryResult>;
+export declare function getModelPresets(config: TurboFluxConfig, options?: ModelDiscoveryOptions): Promise<ModelPreset[]>;