@mrpatronz/nexusflow 1.3.2 → 1.5.0

package/dist/mcp/server.js

@@ -1,17 +1,35 @@
 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 { execa } from 'execa';
-import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import { loadConfig } from '../core/config.js';
-import { loadFeatureConfig } from '../core/workspace.js';
-import { syncWorkspace } from '../core/sync.js';
-import { callLocalLlm } from '../utils/local-ai.js';
+import { enabledTools, findTool } from './tools.js';
+/**
+ * Resolves the workspace path for a tool call.
+ *
+ * Precedence: an explicit `startMcpServer` argument, then `args.workspaceId`
+ * under `config.workspacesDir`, then the current working directory. A
+ * `workspaceId` that resolves outside `workspacesDir` (via `..` or an absolute
+ * path) is rejected — the HTTP server has this guard; the MCP server did not.
+ */
+function resolveWorkspacePath(explicit, config, args) {
+    if (explicit)
+        return explicit;
+    if (args && typeof args.workspaceId === 'string' && args.workspaceId.length > 0) {
+        const base = path.resolve(config.workspacesDir);
+        const resolved = path.resolve(base, args.workspaceId);
+        const rel = path.relative(base, resolved);
+        if (rel === '' || rel.startsWith('..') || path.isAbsolute(rel)) {
+            throw new Error(`Invalid workspaceId "${args.workspaceId}": resolves outside the workspaces directory.`);
+        }
+        return resolved;
+    }
+    return process.cwd();
+}
 export async function startMcpServer(workspacePath) {
     const server = new Server({
         name: 'nexusflow-mcp',
-        version: '0.1.2',
+        version: '0.2.0',
     }, {
         capabilities: {
             tools: {},
@@ -19,289 +37,40 @@ export async function startMcpServer(workspacePath) {
     });
     server.setRequestHandler(ListToolsRequestSchema, async () => {
         const config = await loadConfig();
-        const tools = [
-            {
-                name: 'search_workspace',
-                description: 'Search for a string or regex across all repositories in the NexusFlow workspace. Extremely fast and useful for finding where a specific variable, function, or concept is used across microservices.',
-                inputSchema: {
-                    type: 'object',
-                    properties: {
-                        query: {
-                            type: 'string',
-                            description: 'The search query or regular expression',
-                        },
-                        workspaceId: {
-                            type: 'string',
-                            description: 'Optional ID/branchName of the workspace to search. If omitted, uses the currently active workspace.',
-                        },
-                    },
-                    required: ['query'],
-                },
-            },
-            {
-                name: 'sync_workspace',
-                description: 'Rebase every repository in the NexusFlow workspace onto its base branch. Safe to call non-interactively: dirty working trees are auto-stashed and restored, so a dirty tree is never mis-reported as a conflict. Returns structured per-repo results (status: up-to-date | rebased | conflict | stash-conflict | error) and records them to the workspace state file.',
-                inputSchema: {
-                    type: 'object',
-                    properties: {
-                        workspaceId: {
-                            type: 'string',
-                            description: 'Optional ID/branchName of the workspace to sync. If omitted, uses the currently active workspace.',
-                        },
-                    },
-                },
-            },
-            {
-                name: 'get_service_logs',
-                description: 'Get the recent logs for a specific running service in the workspace to debug runtime issues.',
-                inputSchema: {
-                    type: 'object',
-                    properties: {
-                        serviceName: {
-                            type: 'string',
-                            description: 'The name of the service to fetch logs for (e.g. "frontend", "backend-api")',
-                        },
-                        lines: {
-                            type: 'number',
-                            description: 'Number of lines to fetch. Default 50.',
-                        },
-                        workspaceId: {
-                            type: 'string',
-                            description: 'Optional ID/branchName of the workspace. If omitted, uses the currently active workspace.',
-                        },
-                    },
-                    required: ['serviceName'],
-                },
-            },
-        ];
-        if (config.localLlm?.enabled) {
-            tools.push({
-                name: 'delegate_to_local_agent',
-                description: 'Delegate simple, high-volume, or repetitive tasks (like searching code, parsing raw service logs, or generating boilerplate) to the local Small Language Model (SLM) running on the user\'s machine to save remote tokens.',
-                inputSchema: {
-                    type: 'object',
-                    properties: {
-                        instruction: {
-                            type: 'string',
-                            description: 'The specific instruction for the local agent (e.g., "Scan the last 50 lines of logs and explain the database error").',
-                        },
-                        filesToRead: {
-                            type: 'array',
-                            items: { type: 'string' },
-                            description: 'Optional list of workspace-relative file paths or log files that the local agent should read and use as context.',
-                        },
-                    },
-                    required: ['instruction'],
-                },
-            });
-        }
-        return { tools };
+        return {
+            tools: enabledTools(config).map((t) => ({
+                name: t.name,
+                description: t.description,
+                inputSchema: t.inputSchema,
+                ...(t.annotations ? { annotations: t.annotations } : {}),
+            })),
+        };
     });
+    // Return type is annotated `any` because the SDK's ServerResult union now
+    // includes a task-augmented variant; a plain `{ content, isError }` result is
+    // valid but does not narrow cleanly against it.
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const { name, arguments: args } = request.params;
         const config = await loadConfig();
-        // Resolve workspace path
-        let resolvedWorkspacePath = workspacePath;
-        if (!resolvedWorkspacePath) {
-            if (args && typeof args === 'object' && 'workspaceId' in args && typeof args.workspaceId === 'string') {
-                resolvedWorkspacePath = path.join(config.workspacesDir, args.workspaceId);
-            }
-            else {
-                // Fallback to CWD
-                resolvedWorkspacePath = process.cwd();
-            }
-        }
-        if (name === 'delegate_to_local_agent') {
-            const instruction = args.instruction;
-            const filesToRead = args.filesToRead || [];
-            try {
-                if (!config.localLlm || !config.localLlm.enabled) {
-                    throw new Error('Local AI agent delegation is disabled. Enable it in ~/.nexusflow/config.json or settings.');
-                }
-                const contextFiles = [];
-                const normalizedWorkspace = resolvedWorkspacePath.endsWith(path.sep)
-                    ? resolvedWorkspacePath
-                    : resolvedWorkspacePath + path.sep;
-                for (const relativePath of filesToRead) {
-                    const filePath = path.resolve(resolvedWorkspacePath, relativePath);
-                    if (!filePath.startsWith(normalizedWorkspace)) {
-                        contextFiles.push({
-                            path: relativePath,
-                            content: '[Access denied: path is outside workspace boundary]',
-                        });
-                        continue;
-                    }
-                    try {
-                        const content = await fs.readFile(filePath, 'utf-8');
-                        // Truncate file content if it's too large to prevent overloading local SLM
-                        const truncatedContent = content.length > 50000
-                            ? content.substring(0, 50000) + '\n\n[Content truncated by NexusFlow to save local context size...]'
-                            : content;
-                        contextFiles.push({
-                            path: relativePath,
-                            content: truncatedContent,
-                        });
-                    }
-                    catch (e) {
-                        contextFiles.push({
-                            path: relativePath,
-                            content: `[Error reading file: ${e.message || 'unknown error'}]`,
-                        });
-                    }
-                }
-                // Build messages
-                const messages = [];
-                let systemPrompt = 'You are the NexusFlow local assistant. You are running locally on the user\'s machine to help the remote supervisor agent solve a specific sub-task in a multi-repo workspace.\n';
-                systemPrompt += 'Your goal is to be extremely precise, concise, and return only the distilled findings/code to save remote network tokens. Keep your response short, focused, and directly address the instruction.';
-                messages.push({ role: 'system', content: systemPrompt });
-                let userPrompt = '';
-                if (contextFiles.length > 0) {
-                    userPrompt += 'Here is the local file/log context:\n\n';
-                    for (const file of contextFiles) {
-                        userPrompt += `--- FILE: ${file.path} ---\n${file.content}\n\n`;
-                    }
-                }
-                userPrompt += `Instruction: ${instruction}`;
-                messages.push({ role: 'user', content: userPrompt });
-                const result = await callLocalLlm(config.localLlm, messages);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: result,
-                        },
-                    ],
-                };
-            }
-            catch (error) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `Error delegating to local agent: ${error.message}`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-        }
-        if (name === 'search_workspace') {
-            const query = args.query;
-            try {
-                const feature = await loadFeatureConfig(resolvedWorkspacePath);
-                if (!feature) {
-                    throw new Error(`Workspace not found at ${resolvedWorkspacePath}. Make sure you are in a NexusFlow workspace or provide a valid workspaceId.`);
-                }
-                let allResults = '';
-                for (const repoPath of feature.repos) {
-                    const repoName = path.basename(repoPath);
-                    const worktreePath = path.join(resolvedWorkspacePath, repoName);
-                    try {
-                        await fs.access(worktreePath);
-                        const { stdout } = await execa('git', ['grep', '-n', '-I', query], { cwd: worktreePath, reject: false });
-                        if (stdout) {
-                            const lines = stdout.split('\n').map(line => `[${repoName}] ${line}`);
-                            allResults += lines.join('\n') + '\n';
-                        }
-                    }
-                    catch (e) {
-                        // Ignore error or exitCode 1 (no match)
-                    }
-                }
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: allResults || 'No results found across the workspace repositories.',
-                        },
-                    ],
-                };
-            }
-            catch (error) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `Error searching workspace: ${error.message}`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
+        const tool = findTool(name);
+        if (!tool || (tool.enabled && !tool.enabled(config))) {
+            return {
+                content: [{ type: 'text', text: `Tool not found: ${name}` }],
+                isError: true,
+            };
         }
-        if (name === 'sync_workspace') {
-            try {
-                const feature = await loadFeatureConfig(resolvedWorkspacePath);
-                if (!feature) {
-                    throw new Error(`Workspace not found at ${resolvedWorkspacePath}. Make sure you are in a NexusFlow workspace or provide a valid workspaceId.`);
-                }
-                const report = await syncWorkspace(resolvedWorkspacePath);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify(report, null, 2),
-                        },
-                    ],
-                };
-            }
-            catch (error) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `Error syncing workspace: ${error.message}`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
+        let resolvedWorkspacePath;
+        try {
+            resolvedWorkspacePath = resolveWorkspacePath(workspacePath, config, args);
         }
-        if (name === 'get_service_logs') {
-            const serviceName = args.serviceName;
-            const lines = args.lines || 50;
-            try {
-                const logFilePath = path.join(resolvedWorkspacePath, '.nexusflow-logs', `${serviceName}.log`);
-                try {
-                    await fs.access(logFilePath);
-                }
-                catch {
-                    return {
-                        content: [
-                            {
-                                type: 'text',
-                                text: `Log file for service "${serviceName}" not found. Ensure the service is running via "nexusflow start".`,
-                            },
-                        ],
-                        isError: true,
-                    };
-                }
-                const content = await fs.readFile(logFilePath, 'utf8');
-                const logLines = content.split('\n');
-                const tail = logLines.slice(-lines).join('\n');
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: tail || '(empty log)',
-                        },
-                    ],
-                };
-            }
-            catch (error) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `Error reading logs: ${error.message}`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: error.message }],
+                isError: true,
+            };
         }
-        // Unknown tool
-        throw new Error(`Tool not found: ${name}`);
+        const ctx = { config, workspacePath: resolvedWorkspacePath };
+        return tool.handler((args ?? {}), ctx);
     });
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/mcp/server.js.map

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

package/dist/mcp/tools.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @module mcp/tools
+ * Registry of MCP tools NexusFlow exposes to AI assistants. Each tool declares
+ * its schema, MCP annotations, an optional `enabled` predicate, and a handler.
+ * `server.ts` lists the enabled tools and dispatches calls to their handlers,
+ * so adding a tool means adding one entry here.
+ */
+import type { NexusFlowConfig } from '../types.js';
+/** Context passed to every tool handler. `workspacePath` is already resolved and validated. */
+export interface ToolContext {
+    config: NexusFlowConfig;
+    workspacePath: string;
+}
+/** MCP tool call result. */
+export interface ToolResult {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError?: boolean;
+}
+/** MCP tool annotations (hints only; clients may ignore them). */
+export interface ToolAnnotations {
+    title?: string;
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+}
+/** A single registered MCP tool. */
+export interface NexusFlowTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    annotations?: ToolAnnotations;
+    /** When present, the tool is only listed/callable if this returns true. */
+    enabled?: (config: NexusFlowConfig) => boolean;
+    handler: (args: Record<string, unknown>, ctx: ToolContext) => Promise<ToolResult>;
+}
+export declare const tools: NexusFlowTool[];
+/** Returns the tools enabled for the given config. */
+export declare function enabledTools(config: NexusFlowConfig): NexusFlowTool[];
+/** Finds a tool by name (regardless of enabled state). */
+export declare function findTool(name: string): NexusFlowTool | undefined;
+//# sourceMappingURL=tools.d.ts.map

package/dist/mcp/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAkBnD,+FAA+F;AAC/F,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,4BAA4B;AAC5B,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,2EAA2E;IAC3E,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC;IAC/C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACnF;AAiCD,eAAO,MAAM,KAAK,EAAE,aAAa,EAwWhC,CAAC;AAEF,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,aAAa,EAAE,CAErE;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEhE"}