@hailer/mcp 1.0.29 → 1.1.3

package/dist/mcp/tools/file.js

@@ -46,6 +46,7 @@ exports.downloadFileTool = exports.uploadFilesTool = void 0;
 const zod_1 = require("zod");
 const tool_registry_1 = require("../tool-registry");
 const logger_1 = require("../../lib/logger");
+const request_logger_1 = require("../../lib/request-logger");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const logger = (0, logger_1.createLogger)({ component: 'file-tools' });
@@ -141,7 +142,8 @@ exports.uploadFilesTool = {
             return { content: [{ type: "text", text }] };
         }
         catch (error) {
-            logger.error('Upload failed', error);
+            if (!request_logger_1.RequestLogger.getCurrent())
+                logger.error('Upload failed', error);
             return {
                 content: [{
                         type: "text",
@@ -224,7 +226,8 @@ exports.downloadFileTool = {
             };
         }
         catch (error) {
-            logger.error('Download failed', error);
+            if (!request_logger_1.RequestLogger.getCurrent())
+                logger.error('Download failed', error);
             return {
                 content: [{
                         type: "text",

package/dist/mcp/tools/insight.js

@@ -14,6 +14,7 @@ exports.listInsightsTool = exports.removeInsightTool = exports.updateInsightTool
 const zod_1 = require("zod");
 const tool_registry_1 = require("../tool-registry");
 const logger_1 = require("../../lib/logger");
+const request_logger_1 = require("../../lib/request-logger");
 const tool_helpers_1 = require("../utils/tool-helpers");
 const logger = (0, logger_1.createLogger)({ component: 'insight-tools' });
 // ============================================================================
@@ -91,7 +92,19 @@ const sourceSchema = zod_1.z.object({
 // ============================================================================
 // CREATE INSIGHT TOOL
 // ============================================================================
-const createInsightDescription = `Create SQL insight over workflow data (workflows=tables, activities=rows, fields=columns)`;
+const createInsightDescription = `Create SQL insight over workflow data.
+
+**How sources map to SQL:**
+- sources[].name → TABLE NAME in SQL (use in FROM/JOIN)
+- sources[].workflowId → just tells Hailer which workflow, NOT used in SQL
+- sources[].fields[].name → COLUMN NAME in SQL (use in SELECT/WHERE/ORDER BY)
+- sources[].fields[].fieldId → just tells Hailer which field, NOT used in SQL
+
+**Pattern:**
+sources: [{ name: "MyTable", workflowId: "...", fields: [{ name: "myColumn", fieldId: "..." }] }]
+query: "SELECT myColumn FROM MyTable"
+
+**NEVER use workflowId or fieldId in the SQL query - only use name values.**`;
 exports.createInsightTool = {
     name: 'create_insight',
     group: tool_registry_1.ToolGroup.PLAYGROUND,
@@ -113,7 +126,7 @@ exports.createInsightTool = {
         sources: zod_1.z
             .array(sourceSchema)
             .min(1)
-            .describe("Workflow sources (like SQL table references)"),
+            .describe("Workflow sources. source.name = SQL table name, field.name = SQL column name. Never use IDs in the query."),
         query: zod_1.z
             .string()
             .min(1)
@@ -204,7 +217,8 @@ exports.createInsightTool = {
             };
         }
         catch (error) {
-            logger.error("Error creating insight", error);
+            if (!request_logger_1.RequestLogger.getCurrent())
+                logger.error("Error creating insight", error);
             let errorMessage = 'Unknown error occurred';
             let errorDetails = '';
             if (error instanceof Error) {
@@ -254,7 +268,13 @@ exports.createInsightTool = {
 // ============================================================================
 // PREVIEW INSIGHT TOOL
 // ============================================================================
-const previewInsightDescription = `Test SQL query on sample data before creating/updating insight`;
+const previewInsightDescription = `Test SQL query before creating insight.
+
+**SQL naming rules:**
+- Table names = sources[].name (NOT workflowId)
+- Column names = fields[].name (NOT fieldId)
+
+Always preview before create_insight.`;
 exports.previewInsightTool = {
     name: 'preview_insight',
     group: tool_registry_1.ToolGroup.PLAYGROUND,
@@ -267,7 +287,7 @@ exports.previewInsightTool = {
         sources: zod_1.z
             .array(sourceSchema)
             .min(1)
-            .describe("Workflow sources (like SQL table references)"),
+            .describe("Workflow sources. Use source.name as table, field.name as column in SQL."),
         query: zod_1.z
             .string()
             .min(1)
@@ -297,11 +317,10 @@ exports.previewInsightTool = {
             });
             // Normalize sources (convert 'id' to 'fieldId' if needed)
             const normalizedSources = normalizeFields(args.sources);
-            // Build preview payload
+            // Build preview payload (insightId not accepted by v3.insight.preview)
             const previewData = {
                 sources: normalizedSources,
                 query: args.query,
-                ...(args.insightId && { insightId: args.insightId }),
             };
             // Call v3.insight.preview endpoint
             const result = await context.hailer.request('v3.insight.preview', [workspaceId, previewData]);
@@ -343,7 +362,8 @@ exports.previewInsightTool = {
             };
         }
         catch (error) {
-            logger.error("Error previewing insight", error);
+            if (!request_logger_1.RequestLogger.getCurrent())
+                logger.error("Error previewing insight", error);
             let errorMessage = 'Unknown error occurred';
             if (error instanceof Error) {
                 errorMessage = error.message;
@@ -439,7 +459,8 @@ exports.getInsightDataTool = {
             };
         }
         catch (error) {
-            logger.error("Error getting insight data", error);
+            if (!request_logger_1.RequestLogger.getCurrent())
+                logger.error("Error getting insight data", error);
             let errorMessage = 'Unknown error occurred';
             if (error instanceof Error) {
                 errorMessage = error.message;
@@ -570,7 +591,8 @@ exports.updateInsightTool = {
             };
         }
         catch (error) {
-            logger.error("Error updating insight", error);
+            if (!request_logger_1.RequestLogger.getCurrent())
+                logger.error("Error updating insight", error);
             const errorMessage = (0, tool_helpers_1.extractErrorMessage)(error);
             // Handle SQL syntax errors
             if (errorMessage.toLowerCase().includes('sql') || errorMessage.toLowerCase().includes('syntax')) {
@@ -711,7 +733,8 @@ exports.removeInsightTool = {
             };
         }
         catch (error) {
-            logger.error("Error removing insight", error);
+            if (!request_logger_1.RequestLogger.getCurrent())
+                logger.error("Error removing insight", error);
             let errorMessage = 'Unknown error occurred';
             if (error instanceof Error) {
                 errorMessage = error.message;
@@ -801,7 +824,8 @@ exports.listInsightsTool = {
             };
         }
         catch (error) {
-            logger.error("Error listing insights", error);
+            if (!request_logger_1.RequestLogger.getCurrent())
+                logger.error("Error listing insights", error);
             let errorMessage = 'Unknown error occurred';
             if (error instanceof Error) {
                 errorMessage = error.message;

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

@@ -0,0 +1,9 @@
+/**
+ * Investigation Tool - Spawn Claude Code agents to investigate local repos
+ *
+ * Uses `claude -p` (headless mode, subscription-based) to autonomously
+ * explore codebases, search for bugs, and analyze code.
+ */
+import { Tool } from '../tool-registry';
+export declare const investigateRepoTool: Tool;
+//# sourceMappingURL=investigate.d.ts.map

package/dist/mcp/tools/investigate.js

@@ -0,0 +1,254 @@
+"use strict";
+/**
+ * Investigation Tool - Spawn Claude Code agents to investigate local repos
+ *
+ * Uses `claude -p` (headless mode, subscription-based) to autonomously
+ * explore codebases, search for bugs, and analyze code.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.investigateRepoTool = void 0;
+const zod_1 = require("zod");
+const child_process_1 = require("child_process");
+const tool_registry_1 = require("../tool-registry");
+const logger_1 = require("../../lib/logger");
+const config_1 = require("../../config");
+const logger = (0, logger_1.createLogger)({ component: 'investigate-tool' });
+/**
+ * Resolve claude CLI path at module load
+ */
+const CLAUDE_BIN = (() => {
+    try {
+        return (0, child_process_1.execSync)('which claude', { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        return 'claude'; // fallback to PATH lookup
+    }
+})();
+/**
+ * Parse DEV_AI_REPOS env var into a name->path map.
+ * Format: "name1:/path/one,name2:/path/two"
+ */
+function parseRepoPaths() {
+    const raw = config_1.environment.DEV_AI_REPOS;
+    const map = new Map();
+    if (!raw)
+        return map;
+    for (const entry of raw.split(',')) {
+        const colonIdx = entry.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const name = entry.slice(0, colonIdx).trim();
+        const repoPath = entry.slice(colonIdx + 1).trim();
+        if (name && repoPath) {
+            map.set(name, repoPath);
+        }
+    }
+    return map;
+}
+/**
+ * Resolve a repo name to its local filesystem path.
+ */
+function resolveRepoPath(repoName) {
+    const repos = parseRepoPaths();
+    return repos.get(repoName) || null;
+}
+/**
+ * Spawn `claude -p` in a repo directory and return its output.
+ */
+async function spawnInvestigation(prompt, cwd, maxTurns, repoName) {
+    const timeout = config_1.environment.DEV_AI_INVESTIGATION_TIMEOUT;
+    return new Promise((resolve, reject) => {
+        const proc = (0, child_process_1.spawn)(CLAUDE_BIN, [
+            '-p', prompt,
+            '--output-format', 'stream-json',
+            '--verbose',
+            '--allowedTools', 'Read,Glob,Grep,Bash,Task',
+            '--max-turns', String(maxTurns),
+        ], {
+            cwd,
+            timeout,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: {
+                ...process.env,
+                // Strip MCP vars so investigation agent doesn't connect to our MCP server
+                MCP_SERVER_URL: undefined,
+                MCP_CLIENT_API_KEY: undefined,
+                MCP_CLIENT_ENABLED: undefined,
+                CLIENT_CONFIGS: undefined,
+                BOT_EMAIL: undefined,
+                BOT_PASSWORD: undefined,
+                BOT_API_BASE_URL: undefined,
+                ANTHROPIC_API_KEY: undefined,
+            },
+        });
+        let lineBuffer = '';
+        let resultText = '';
+        let stderr = '';
+        proc.stdout.on('data', (data) => {
+            lineBuffer += data.toString();
+            const lines = lineBuffer.split('\n');
+            lineBuffer = lines.pop() || ''; // Keep incomplete last line in buffer
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                try {
+                    const event = JSON.parse(trimmed);
+                    if (event.type === 'system' && event.subtype === 'init') {
+                        logger.debug(`[investigation:${repoName}] Agent initialized | tools: ${(event.tools || []).length} | model: ${event.model || 'unknown'}`);
+                    }
+                    else if (event.type === 'assistant' && event.message?.content) {
+                        for (const block of event.message.content) {
+                            if (block.type === 'tool_use') {
+                                const inputStr = JSON.stringify(block.input || {});
+                                logger.debug(`[investigation:${repoName}] Tool: ${block.name} ${inputStr.length > 200 ? inputStr.slice(0, 200) + '...' : inputStr}`);
+                            }
+                            else if (block.type === 'text') {
+                                const text = (block.text || '').trim();
+                                if (text) {
+                                    logger.debug(`[investigation:${repoName}] ${text.length > 300 ? text.slice(0, 300) + '...' : text}`);
+                                }
+                            }
+                        }
+                    }
+                    else if (event.type === 'tool') {
+                        const content = typeof event.content === 'string' ? event.content : JSON.stringify(event.content || '');
+                        logger.debug(`[investigation:${repoName}] Tool result (${event.tool_name}): ${content.length > 300 ? content.slice(0, 300) + '...' : content}`);
+                    }
+                    else if (event.type === 'result') {
+                        resultText = event.result || '';
+                        const cost = event.total_cost_usd ? `$${event.total_cost_usd.toFixed(4)}` : 'unknown';
+                        const duration = event.duration_ms ? `${(event.duration_ms / 1000).toFixed(1)}s` : 'unknown';
+                        logger.info(`[investigation:${repoName}] Complete | ${resultText.length} chars | ${duration} | cost: ${cost}`);
+                    }
+                }
+                catch {
+                    // Non-JSON line
+                    if (trimmed.length > 0) {
+                        logger.debug(`[investigation:${repoName}] ${trimmed.length > 300 ? trimmed.slice(0, 300) + '...' : trimmed}`);
+                    }
+                }
+            }
+        });
+        proc.stderr.on('data', (data) => {
+            const chunk = data.toString();
+            stderr += chunk;
+            const trimmed = chunk.trim();
+            if (trimmed) {
+                logger.warn(`[investigation:${repoName}] ${trimmed.length > 500 ? trimmed.slice(0, 500) + '...' : trimmed}`);
+            }
+        });
+        proc.on('error', (err) => {
+            reject(new Error(`Failed to spawn claude: ${err.message}`));
+        });
+        proc.on('close', (code) => {
+            // Process any remaining data in lineBuffer
+            if (lineBuffer.trim()) {
+                try {
+                    const event = JSON.parse(lineBuffer.trim());
+                    if (event.type === 'result') {
+                        resultText = event.result || '';
+                    }
+                }
+                catch {
+                    // ignore
+                }
+            }
+            if (code === 0) {
+                resolve(resultText || 'Investigation completed but returned no structured result.');
+            }
+            else {
+                const errDetail = stderr.trim() || `exit code ${code}`;
+                reject(new Error(`Investigation failed: ${errDetail}`));
+            }
+        });
+    });
+}
+const investigateRepoSchema = zod_1.z.object({
+    repoName: zod_1.z.string().describe('Target repo name (must match a configured repo). Available repos depend on DEV_AI_REPOS config.'),
+    prompt: zod_1.z.string().describe('What to investigate - bug description, search query, code question, etc.'),
+    maxTurns: zod_1.z.number().optional().default(30).describe('Max investigation depth (number of agentic turns). Default: 30.'),
+});
+exports.investigateRepoTool = {
+    name: 'investigate_repo',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: 'Spawn a Claude Code agent to investigate code in a local repo. ' +
+        'Uses claude -p (headless mode, subscription-based). ' +
+        'The agent can explore files, search code, analyze the codebase autonomously, ' +
+        'and spawn investigation teams for parallel exploration of complex issues. ' +
+        'Returns the investigation findings as text.',
+    schema: investigateRepoSchema,
+    async execute(args, _context) {
+        const repos = parseRepoPaths();
+        // If no repos configured, return helpful error
+        if (repos.size === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: 'No repos configured. Set DEV_AI_REPOS in .env.local (format: "name:/path,name2:/path2").',
+                    }],
+            };
+        }
+        const repoPath = resolveRepoPath(args.repoName);
+        if (!repoPath) {
+            const available = Array.from(repos.keys()).join(', ');
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Unknown repo: "${args.repoName}". Available repos: ${available}`,
+                    }],
+            };
+        }
+        const enhancedPrompt = `You are a lead investigator. Use parallel agents to explore the codebase efficiently.
+
+HOW TO USE PARALLEL AGENTS:
+- Call multiple Task tools in a SINGLE response to run them in parallel
+- Each Task call blocks until that agent finishes and returns its findings directly to you
+- Use subagent_type: "Explore" with model: "haiku" — these are fast, read-only codebase search agents
+- Do NOT use TeamCreate, SendMessage, or TaskCreate — just call Task directly
+
+APPROACH:
+1. In your FIRST response, call 2-3 Task tools simultaneously, each with a focused search prompt
+2. You will receive all their findings in the next turn
+3. If needed, do additional targeted searches yourself with Grep/Read
+4. Write your FINAL REPORT
+
+REPORT FORMAT:
+- Root cause of the issue
+- Affected files with paths and line numbers
+- Suggested fix with specific code changes
+
+INVESTIGATION TASK:
+${args.prompt}`;
+        logger.info('Starting investigation', {
+            repo: args.repoName,
+            repoPath,
+            maxTurns: args.maxTurns,
+            promptLength: enhancedPrompt.length,
+        });
+        try {
+            const result = await spawnInvestigation(enhancedPrompt, repoPath, args.maxTurns, args.repoName);
+            logger.info('Investigation completed', {
+                repo: args.repoName,
+                resultLength: result.length,
+            });
+            return {
+                content: [{
+                        type: 'text',
+                        text: result || 'Investigation completed but returned no output.',
+                    }],
+            };
+        }
+        catch (error) {
+            const errMsg = error instanceof Error ? error.message : String(error);
+            logger.error('Investigation failed', { repo: args.repoName, error: errMsg });
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Investigation failed: ${errMsg}`,
+                    }],
+            };
+        }
+    },
+};
+//# sourceMappingURL=investigate.js.map

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

@@ -2,12 +2,10 @@
  * User Tools - Clean Architecture Implementation
  *
  * Tools for managing users in Hailer workspaces:
- * - List user's workspaces (READ)
- * - Search for users by name (READ)
- * - Get workspace balance (READ)
+ * - Search for users by name (WRITE)
+ * - Get initialization data (READ) - currently disabled
  */
 import { Tool } from '../tool-registry';
-export declare const listMyWorkspacesTool: Tool;
 export declare const searchWorkspaceUsersTool: Tool;
 export declare const getWorkspaceBalanceTool: Tool;
 //# sourceMappingURL=user.d.ts.map

package/dist/mcp/tools/user.js

@@ -3,62 +3,19 @@
  * User Tools - Clean Architecture Implementation
  *
  * Tools for managing users in Hailer workspaces:
- * - List user's workspaces (READ)
- * - Search for users by name (READ)
- * - Get workspace balance (READ)
+ * - Search for users by name (WRITE)
+ * - Get initialization data (READ) - currently disabled
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getWorkspaceBalanceTool = exports.searchWorkspaceUsersTool = exports.listMyWorkspacesTool = void 0;
+exports.getWorkspaceBalanceTool = exports.searchWorkspaceUsersTool = void 0;
 const zod_1 = require("zod");
 const tool_registry_1 = require("../tool-registry");
 const index_1 = require("../utils/index");
 const tool_helpers_1 = require("../utils/tool-helpers");
+const request_logger_1 = require("../../lib/request-logger");
 const logger = (0, index_1.createLogger)({ component: 'user-tools' });
 // ============================================================================
-// TOOL 1: LIST MY WORKSPACES
-// ============================================================================
-const listMyWorkspacesDescription = `List all workspaces the current user has access to. Use this when user needs to see their workspaces or switch between them. Returns workspace IDs that can be used in other tools.`;
-exports.listMyWorkspacesTool = {
-    name: 'list_my_workspaces',
-    group: tool_registry_1.ToolGroup.READ,
-    description: listMyWorkspacesDescription,
-    schema: zod_1.z.object({}),
-    async execute(_args, context) {
-        logger.debug('Listing user workspaces', {
-            apiKey: context.apiKey.substring(0, 8) + '...'
-        });
-        try {
-            if (!context.workspaceCache) {
-                return (0, tool_helpers_1.missingWorkspaceCacheResponse)();
-            }
-            const workspaces = context.workspaceCache.allWorkspaces;
-            const currentWorkspaceId = context.workspaceCache.currentWorkspace?._id;
-            const workspaceList = Object.entries(workspaces);
-            if (workspaceList.length === 0) {
-                return (0, index_1.textResponse)('❌ No workspaces found for this user.');
-            }
-            const formattedWorkspaces = workspaceList
-                .map(([id, ws]) => {
-                const isCurrent = id === currentWorkspaceId;
-                const marker = isCurrent ? ' ← current' : '';
-                return `• **${ws.name}**${marker}\n  - ID: \`${id}\``;
-            })
-                .join('\n\n');
-            const hint = workspaceList.length > 1
-                ? `\n\n💡 **Tip:** To work with a specific workspace, pass the \`workspaceId\` parameter to tools like \`list_activities\`, \`create_activity\`, etc.`
-                : '';
-            return (0, index_1.textResponse)(`📋 **Your Workspaces** (${workspaceList.length} total)\n\n` +
-                formattedWorkspaces +
-                hint);
-        }
-        catch (error) {
-            logger.error('Error listing workspaces', error);
-            return (0, index_1.errorResponse)(`Error listing workspaces: ${(0, index_1.getErrorMessage)(error)}`);
-        }
-    },
-};
-// ============================================================================
-// TOOL 2: SEARCH WORKSPACE USERS
+// TOOL 1: SEARCH WORKSPACE USERS
 // ============================================================================
 const searchWorkspaceUsersDescription = `Search for users in the current workspace by name - Returns valid user IDs for assignment`;
 exports.searchWorkspaceUsersTool = {
@@ -119,7 +76,8 @@ exports.searchWorkspaceUsersTool = {
                 `\n\n💡 Use these IDs in create_activity fields or followerIds parameters.`);
         }
         catch (error) {
-            logger.error("Error searching workspace users", error);
+            if (!request_logger_1.RequestLogger.getCurrent())
+                logger.error("Error searching workspace users", error);
             return (0, index_1.errorResponse)(`Error searching users: ${(0, index_1.getErrorMessage)(error)}`);
         }
     },
@@ -212,7 +170,8 @@ exports.getWorkspaceBalanceTool = {
                 `${message}`);
         }
         catch (error) {
-            logger.error("Error checking workspace balance", error);
+            if (!request_logger_1.RequestLogger.getCurrent())
+                logger.error("Error checking workspace balance", error);
             return (0, index_1.errorResponse)(`Error checking workspace balance: ${(0, index_1.getErrorMessage)(error)}`);
         }
     },

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

@@ -14,5 +14,6 @@ export declare const updateWorkflowFieldTool: Tool;
 export declare const testFunctionFieldTool: Tool;
 export declare const listWorkflowsMinimalTool: Tool;
 export declare const countActivitiesTool: Tool;
+export declare const coreInitTool: Tool;
 export declare const updateWorkflowPhaseTool: Tool;
 //# sourceMappingURL=workflow.d.ts.map