@hailer/mcp 0.0.1

package/dist/mcp/tools/insight.js

@@ -0,0 +1,806 @@
+"use strict";
+/**
+ * Insight Tools - Clean Architecture Implementation
+ *
+ * SQL-like insights over Hailer workflows:
+ * - Workflows = Tables
+ * - Activities = Rows
+ * - Fields = Columns
+ *
+ * All 4 insight management tools in one file for cohesion.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listInsightsTool = exports.removeInsightTool = exports.getInsightDataTool = exports.previewInsightTool = exports.createInsightTool = void 0;
+const zod_1 = require("zod");
+const tool_registry_1 = require("../tool-registry");
+const workspace_cache_1 = require("../workspace-cache");
+const logger_1 = require("../../lib/logger");
+const logger = (0, logger_1.createLogger)({ component: 'insight-tools' });
+// ============================================================================
+// SHARED TYPES & SCHEMAS
+// ============================================================================
+/**
+ * Field definition schema - either meta field or custom fieldId
+ */
+const fieldSchema = zod_1.z.object({
+    name: zod_1.z.string().describe("Column name in SQL query"),
+}).and(zod_1.z.union([
+    zod_1.z.object({
+        meta: zod_1.z.enum([
+            '_id',
+            'uid',
+            'team',
+            'createdBy',
+            'name',
+            'created',
+            'updated',
+            'phaseId',
+            'phaseName',
+            'phaseLastMove',
+            'workflowId',
+            'workflowName',
+            'priority'
+        ]).describe("Built-in activity property"),
+    }),
+    zod_1.z.object({
+        fieldId: zod_1.z.string().describe("Custom field ID from workflow"),
+    }),
+]));
+/**
+ * Source definition schema - workflow as SQL table
+ */
+const sourceSchema = zod_1.z.object({
+    name: zod_1.z.string().describe("Table alias for SQL query"),
+    workflowId: zod_1.z.string().describe("Workflow ID to query"),
+    fields: zod_1.z.array(fieldSchema).min(1).describe("Field mappings for SQL columns"),
+});
+// ============================================================================
+// CREATE INSIGHT TOOL
+// ============================================================================
+const createInsightDescription = `🧪 [PLAYGROUND] Create SQL-like insights (workflows = tables, activities = rows, fields = columns)
+
+⚠️ **MANDATORY: YOU MUST LOAD SKILL FIRST**
+**BEFORE calling this tool, you are REQUIRED to:**
+1. Load the skill: \`get_skill({ skillName: "create-insight-skill" })\`
+2. Read the query examples, JOIN patterns, and aggregation examples
+3. Test your SQL with \`preview_insight\` first
+**FAILURE TO LOAD THE SKILL FIRST IS AN ERROR**
+
+**Required Parameters**:
+- name: Insight name
+- sources: Array with name (table alias), workflowId, fields (meta or fieldId)
+- query: Standard SQL (SELECT, JOIN, WHERE, GROUP BY, ORDER BY, LIMIT)
+
+**Meta Fields**: _id, uid, team, createdBy, name, created, updated, phaseId, phaseName, phaseLastMove, workflowId, workflowName, priority
+**SQL Support**: All standard SQL features including JOINs and aggregations`;
+exports.createInsightTool = {
+    name: 'create_insight',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: createInsightDescription,
+    schema: zod_1.z.object({
+        workspaceId: zod_1.z
+            .string()
+            .optional()
+            .describe("Optional workspace ID or name - defaults to current workspace"),
+        name: zod_1.z
+            .string()
+            .min(1)
+            .describe("Insight name"),
+        public: zod_1.z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Whether insight is publicly accessible (default: false)"),
+        sources: zod_1.z
+            .array(sourceSchema)
+            .min(1)
+            .describe("Workflow sources (like SQL table references)"),
+        query: zod_1.z
+            .string()
+            .min(1)
+            .describe("SQL query (SELECT, JOIN, WHERE, GROUP BY, ORDER BY, etc.)"),
+    }),
+    async execute(args, context) {
+        logger.debug('Creating insight', {
+            name: args.name,
+            workspaceId: args.workspaceId,
+            sourcesCount: args.sources.length,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            if (!context.workspaceCache) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: "❌ Workspace cache not available",
+                        }],
+                };
+            }
+            // Resolve workspace ID
+            const workspaceId = args.workspaceId
+                ? (0, workspace_cache_1.resolveWorkspaceId)(context.workspaceCache, args.workspaceId)
+                : context.workspaceCache.currentWorkspace._id;
+            if (!workspaceId) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ Could not resolve workspace: ${args.workspaceId}`,
+                        }],
+                };
+            }
+            logger.debug('Calling v3.insight.create', {
+                workspaceId,
+                name: args.name,
+                sourcesCount: args.sources.length
+            });
+            // Build insight payload
+            const insightData = {
+                name: args.name,
+                public: args.public || false,
+                sources: args.sources,
+                query: args.query,
+            };
+            // Call v3.insight.create endpoint
+            const result = await context.hailer.request('v3.insight.create', [workspaceId, insightData]);
+            logger.debug('Insight creation successful', {
+                insightId: result.insightId || result._id,
+                result: JSON.stringify(result)
+            });
+            const insightId = result.insightId || result._id;
+            const discussionId = result.discussionId || result.discussion;
+            // Automatically join the insight's discussion
+            if (discussionId) {
+                try {
+                    logger.debug('Automatically joining insight discussion', { discussionId });
+                    await context.hailer.joinDiscussion(discussionId);
+                    logger.debug('Successfully joined insight discussion', { discussionId });
+                }
+                catch (joinError) {
+                    logger.warn('Failed to join insight discussion (non-fatal)', {
+                        discussionId,
+                        error: joinError instanceof Error ? joinError.message : String(joinError)
+                    });
+                }
+            }
+            else {
+                logger.debug('No discussion ID in response, skipping auto-join');
+            }
+            // Build success response
+            let responseText = `✅ **Insight Created Successfully**\n\n`;
+            responseText += `**Insight Name:** ${args.name}\n`;
+            responseText += `**Insight ID:** \`${insightId}\`\n`;
+            responseText += `**Workspace:** ${workspaceId}\n`;
+            responseText += `**Public:** ${args.public ? 'Yes' : 'No'}\n`;
+            responseText += `**Sources:** ${args.sources.length} workflow(s)\n`;
+            if (discussionId) {
+                responseText += `**Discussion:** Automatically joined ✓\n`;
+            }
+            responseText += `\n`;
+            // Show sources
+            responseText += `**Query Sources:**\n`;
+            args.sources.forEach((source) => {
+                responseText += `- \`${source.name}\` → Workflow: \`${source.workflowId}\` (${source.fields.length} fields)\n`;
+            });
+            responseText += `\n**SQL Query:**\n\`\`\`sql\n${args.query}\n\`\`\`\n\n`;
+            responseText += `💡 **Next Steps:**\n`;
+            responseText += `- Use \`get_insight_data\` to execute the query and see results\n`;
+            responseText += `- Use \`list_insights\` to see all insights in workspace\n`;
+            responseText += `- Use \`update_insight\` to modify the insight\n`;
+            responseText += `- Use \`preview_insight\` to test query changes before saving\n\n`;
+            if (args.public) {
+                responseText += `🌐 **Public Insight:** This insight can be accessed without authentication.\n`;
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error creating insight", error);
+            let errorMessage = 'Unknown error occurred';
+            let errorDetails = '';
+            if (error instanceof Error) {
+                errorMessage = error.message;
+                if (error.stack) {
+                    errorDetails = `\n\n**Stack trace:**\n\`\`\`\n${error.stack}\n\`\`\``;
+                }
+            }
+            else if (typeof error === 'object' && error !== null) {
+                try {
+                    errorMessage = JSON.stringify(error, null, 2);
+                }
+                catch {
+                    errorMessage = String(error);
+                }
+            }
+            else {
+                errorMessage = String(error);
+            }
+            // Handle SQL syntax errors
+            if (errorMessage.toLowerCase().includes('sql') || errorMessage.toLowerCase().includes('syntax')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **SQL Query Error**\n\nThere's a problem with your SQL query.\n\n**Error:** ${errorMessage}\n\n**Tips:**\n- Check column names match field names in sources\n- Check table names match source names\n- Use \`preview_insight\` to test queries before creating\n- Make sure field IDs are correct (use \`get_workflow_schema\`)`,
+                        }],
+                };
+            }
+            // Handle permission errors
+            if (errorMessage.includes('permission') || errorMessage.includes('PermissionDenied')) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Permission Denied**\n\nYou may not have permission to create insights or access the specified workflows.\n\n**Error:** ${errorMessage}`,
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error creating insight**\n\n**Error:** ${errorMessage}${errorDetails}\n\n**Common Issues:**\n- SQL query syntax errors\n- Invalid field IDs or workflow IDs\n- Workflow fields don't exist\n- Permission issues\n- Check field IDs with \`get_workflow_schema\`\n- Test query with \`preview_insight\` first`,
+                    }],
+            };
+        }
+    }
+};
+// ============================================================================
+// PREVIEW INSIGHT TOOL
+// ============================================================================
+const previewInsightDescription = `🧪 [PLAYGROUND] Preview insight - Test SQL on ~20 activities before saving
+
+⚠️ **MANDATORY: YOU MUST LOAD SKILL FIRST**
+**BEFORE calling this tool, you are REQUIRED to:**
+1. Load the skill: \`get_skill({ skillName: "preview-insight-skill" })\`
+2. Read the debugging tips and security notes
+3. Understand the SQL testing patterns
+**FAILURE TO LOAD THE SKILL FIRST IS AN ERROR**
+
+**Purpose**: Debug SQL syntax, test JOINs, verify field mappings without creating insight
+
+**Required Parameters**:
+- sources: Same format as create_insight (name, workflowId, fields)
+- query: SQL query to test
+- insightId (optional): Test changes to existing insight`;
+exports.previewInsightTool = {
+    name: 'preview_insight',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: previewInsightDescription,
+    schema: zod_1.z.object({
+        workspaceId: zod_1.z
+            .string()
+            .optional()
+            .describe("Optional workspace ID or name - defaults to current workspace"),
+        sources: zod_1.z
+            .array(sourceSchema)
+            .min(1)
+            .describe("Workflow sources (like SQL table references)"),
+        query: zod_1.z
+            .string()
+            .min(1)
+            .describe("SQL query to test"),
+        insightId: zod_1.z
+            .string()
+            .optional()
+            .describe("Optional insight ID if previewing changes to existing insight"),
+    }),
+    async execute(args, context) {
+        logger.debug('Previewing insight', {
+            workspaceId: args.workspaceId,
+            sourcesCount: args.sources.length,
+            insightId: args.insightId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            if (!context.workspaceCache) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: "❌ Workspace cache not available",
+                        }],
+                };
+            }
+            // Resolve workspace ID
+            const workspaceId = args.workspaceId
+                ? (0, workspace_cache_1.resolveWorkspaceId)(context.workspaceCache, args.workspaceId)
+                : context.workspaceCache.currentWorkspace._id;
+            if (!workspaceId) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ Could not resolve workspace: ${args.workspaceId}`,
+                        }],
+                };
+            }
+            logger.debug('Calling v3.insight.preview', {
+                workspaceId,
+                sourcesCount: args.sources.length,
+                insightId: args.insightId
+            });
+            // Build preview payload
+            const previewData = {
+                sources: args.sources,
+                query: args.query,
+                ...(args.insightId && { insightId: args.insightId }),
+            };
+            // Call v3.insight.preview endpoint
+            const result = await context.hailer.request('v3.insight.preview', [workspaceId, previewData]);
+            logger.debug('Preview successful', {
+                columns: result.columns?.length,
+                rows: result.rows?.length
+            });
+            // Format results
+            let responseText = `✅ **Preview Results** (~${result.rows?.length || 0} rows)\n\n`;
+            if (!result.columns || !result.rows) {
+                responseText += `⚠️ No data returned from preview\n`;
+            }
+            else if (result.rows.length === 0) {
+                responseText += `**Columns:** ${result.columns.join(', ')}\n\n`;
+                responseText += `⚠️ **No rows matched** - Check your query filters\n`;
+            }
+            else {
+                responseText += `**Columns:** ${result.columns.join(', ')}\n\n`;
+                responseText += `**Sample Data:**\n\`\`\`\n`;
+                // Show column headers
+                responseText += result.columns.join(' | ') + '\n';
+                responseText += result.columns.map(() => '---').join(' | ') + '\n';
+                // Show first 10 rows
+                const rowsToShow = Math.min(result.rows.length, 10);
+                for (let i = 0; i < rowsToShow; i++) {
+                    responseText += result.rows[i].map(v => String(v || '')).join(' | ') + '\n';
+                }
+                if (result.rows.length > 10) {
+                    responseText += `\n... and ${result.rows.length - 10} more rows\n`;
+                }
+                responseText += `\`\`\`\n\n`;
+            }
+            responseText += `\n✅ **Query is valid!** Ready to use in \`create_insight\` or \`update_insight\`.`;
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error previewing insight", error);
+            let errorMessage = 'Unknown error occurred';
+            if (error instanceof Error) {
+                errorMessage = error.message;
+            }
+            else if (typeof error === 'object' && error !== null) {
+                try {
+                    errorMessage = JSON.stringify(error, null, 2);
+                }
+                catch {
+                    errorMessage = String(error);
+                }
+            }
+            else {
+                errorMessage = String(error);
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Preview Failed**\n\n**Error:** ${errorMessage}\n\n**Tips:**\n- Check SQL syntax\n- Verify field names match source definitions\n- Ensure workflow IDs are correct\n- Check table aliases match source names`,
+                    }],
+            };
+        }
+    }
+};
+// ============================================================================
+// GET INSIGHT DATA TOOL
+// ============================================================================
+const getInsightDataDescription = `🧪 [PLAYGROUND] Get Insight Data - Execute insight and retrieve results
+
+**What is Get Insight Data?**
+Executes a saved insight's SQL query and returns the complete results. Unlike preview (limited to ~20 rows), this returns all matching activities.
+
+**When to Use**:
+- Get full results from a saved insight
+- Export insight data
+- Verify insight after creation
+- Check updated data after changes
+
+**Example - Basic Usage**:
+\`\`\`javascript
+get_insight_data({
+  insightId: '<insight-id>'
+})
+\`\`\`
+
+**Update Option**:
+- \`update: false\` (default) - Returns cached results (faster)
+- \`update: true\` - Recalculates from current activity data (slower but fresh)
+
+**Tips**:
+- Use \`update: true\` if activity data has changed
+- Results can be large - may take time for big datasets
+- Use \`preview_insight\` first to test queries
+- Get insight ID from \`create_insight\` or \`list_insights\``;
+exports.getInsightDataTool = {
+    name: 'get_insight_data',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: getInsightDataDescription,
+    schema: zod_1.z.object({
+        insightId: zod_1.z
+            .string()
+            .describe("Insight ID to execute"),
+        update: zod_1.z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Whether to recalculate data (true) or use cached results (false, default)"),
+    }),
+    async execute(args, context) {
+        logger.debug('Getting insight data', {
+            insightId: args.insightId,
+            update: args.update,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            logger.debug('Calling v3.insight.data', {
+                insightId: args.insightId,
+                update: args.update
+            });
+            // Call v3.insight.data endpoint
+            const result = await context.hailer.request('v3.insight.data', [args.insightId, { update: args.update || false }]);
+            logger.debug('Insight data retrieved', {
+                headers: result.headers?.length,
+                rows: result.rows?.length,
+                fullResult: JSON.stringify(result).substring(0, 500)
+            });
+            // Format results
+            let responseText = `✅ **Insight Data Retrieved** (${result.rows?.length || 0} rows)\n\n`;
+            if (!result.headers || !result.rows) {
+                responseText += `⚠️ No data returned\n`;
+                responseText += `**Debug:** Response keys: ${Object.keys(result).join(', ')}\n`;
+                responseText += `**Full response (truncated):** \`${JSON.stringify(result).substring(0, 300)}\`\n`;
+            }
+            else if (result.rows.length === 0) {
+                responseText += `**Columns:** ${result.headers.join(', ')}\n\n`;
+                responseText += `⚠️ **No rows matched**\n`;
+            }
+            else {
+                responseText += `**Columns:** ${result.headers.join(', ')}\n\n`;
+                responseText += `**Sample Data (first 10 rows):**\n\`\`\`\n`;
+                // Show column headers
+                responseText += result.headers.join(' | ') + '\n';
+                responseText += result.headers.map(() => '---').join(' | ') + '\n';
+                // Show first 10 rows
+                const rowsToShow = Math.min(result.rows.length, 10);
+                for (let i = 0; i < rowsToShow; i++) {
+                    responseText += result.rows[i].map(v => String(v || '')).join(' | ') + '\n';
+                }
+                if (result.rows.length > 10) {
+                    responseText += `\n... and ${result.rows.length - 10} more rows\n`;
+                }
+                responseText += `\`\`\`\n`;
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error getting insight data", error);
+            let errorMessage = 'Unknown error occurred';
+            if (error instanceof Error) {
+                errorMessage = error.message;
+            }
+            else if (typeof error === 'object' && error !== null) {
+                try {
+                    errorMessage = JSON.stringify(error, null, 2);
+                }
+                catch {
+                    errorMessage = String(error);
+                }
+            }
+            else {
+                errorMessage = String(error);
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error getting insight data**\n\n**Error:** ${errorMessage}\n\n**Common Issues:**\n- Insight ID not found\n- Permission denied\n- Insight query has errors\n- Use \`list_insights\` to verify insight ID`,
+                    }],
+            };
+        }
+    }
+};
+// ============================================================================
+// REMOVE INSIGHT TOOL
+// ============================================================================
+const removeInsightDescription = `🧪 [PLAYGROUND] Remove Insight - ⚠️ DANGER: Permanently deletes insight and all its data
+
+⚠️ **MANDATORY: GATHER COMPLETE CONTEXT BEFORE CALLING THIS TOOL**
+**BEFORE calling this tool, you are REQUIRED to:**
+1. Load the skill: \`get_skill({ skillName: "remove-insight-skill" })\`
+2. Fetch insight details with \`list_insights\` to get:
+   - Insight name and ID
+   - Workspace ID and name
+   - SQL query
+   - Source workflows
+   - Number of sources
+3. Show comprehensive confirmation message including:
+   - Workspace ID and name
+   - Insight ID and name
+   - What will be deleted (definition, results, permissions, discussion)
+   - Sources being queried (workflows)
+   - Clear irreversibility warning
+4. Wait for explicit user confirmation
+**FAILURE TO GATHER AND SHOW THIS CONTEXT IS AN ERROR**
+
+**Required**: insightId
+**Permission**: Workspace administrator
+
+**What Gets Deleted**:
+- Insight definition (sources, query, name)
+- Saved query results
+- Insight permissions
+- Associated discussion
+
+**Example**:
+\`\`\`javascript
+remove_insight({
+  insightId: '<insight-id>'
+})
+\`\`\`
+
+**Tips**:
+- Use \`list_insights\` to find insight IDs
+- Use \`get_insight_data\` to verify before deleting
+- Operation cannot be undone - data is permanently lost`;
+exports.removeInsightTool = {
+    name: 'remove_insight',
+    group: tool_registry_1.ToolGroup.NUCLEAR,
+    description: removeInsightDescription,
+    schema: zod_1.z.object({
+        insightId: zod_1.z
+            .string()
+            .describe("Insight ID to remove (get from list_insights or create_insight)"),
+        confirmed: zod_1.z
+            .boolean()
+            .optional()
+            .describe("First confirmation - must be true to proceed"),
+        secondConfirmed: zod_1.z
+            .boolean()
+            .optional()
+            .describe("Second confirmation - must be true to proceed (required for double-check safety)"),
+    }),
+    async execute(args, context) {
+        logger.debug('Removing insight', {
+            insightId: args.insightId,
+            confirmed: args.confirmed,
+            secondConfirmed: args.secondConfirmed,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            if (!context.workspaceCache) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: "❌ Workspace cache not available",
+                        }],
+                };
+            }
+            const workspaceId = context.workspaceCache.currentWorkspace._id;
+            // Fetch insight info and workspace info
+            const [insightListResult, initData] = await Promise.all([
+                context.hailer.request('v3.insight.list', [workspaceId]),
+                context.hailer.request('v2.core.init', [["network"]])
+            ]);
+            const insights = Array.isArray(insightListResult) ? insightListResult : (insightListResult.details || insightListResult.insights || []);
+            const insight = insights.find((i) => i._id === args.insightId);
+            const insightName = insight?.name || 'Unknown';
+            const workspaceName = initData.network?.name || 'Unknown';
+            // SAFETY CHECK: Require double confirmation
+            if (!args.confirmed || !args.secondConfirmed) {
+                let warningText = `⚠️ **DESTRUCTIVE OPERATION - CONFIRMATION REQUIRED**\n\n`;
+                warningText += `You are about to **permanently delete** the following:\n\n`;
+                warningText += `**Insight:** ${insightName}\n`;
+                warningText += `**Insight ID:** \`${args.insightId}\`\n`;
+                warningText += `**Workspace:** ${workspaceName} (\`${workspaceId}\`)\n\n`;
+                warningText += `**⚠️ This will permanently delete:**\n`;
+                warningText += `- Insight definition (sources, query, name)\n`;
+                warningText += `- Saved query results\n`;
+                warningText += `- Insight permissions\n`;
+                warningText += `- Associated discussion\n\n`;
+                warningText += `**🚨 THIS CANNOT BE UNDONE! 🚨**\n\n`;
+                warningText += `**To proceed, you must:**\n`;
+                warningText += `1. Review the \`remove-insight-skill\` (REQUIRED)\n`;
+                warningText += `2. Call this tool again with BOTH confirmations:\n\n`;
+                warningText += `\`\`\`javascript\n`;
+                warningText += `remove_insight({\n`;
+                warningText += `  insightId: "${args.insightId}",\n`;
+                warningText += `  confirmed: true,\n`;
+                warningText += `  secondConfirmed: true\n`;
+                warningText += `})\n`;
+                warningText += `\`\`\`\n\n`;
+                warningText += `💡 **Before proceeding:**\n`;
+                warningText += `- Load \`remove-insight-skill\` to review safety checklist\n`;
+                warningText += `- Use \`get_insight_data\` to verify before deleting\n`;
+                warningText += `- Verify with user that this is intentional`;
+                return {
+                    content: [{
+                            type: "text",
+                            text: warningText,
+                        }],
+                };
+            }
+            logger.debug('Calling v3.insight.remove', {
+                insightId: args.insightId,
+                insightName,
+                workspaceId,
+                workspaceName
+            });
+            // Call v3.insight.remove endpoint
+            await context.hailer.request('v3.insight.remove', [args.insightId]);
+            logger.debug('Insight removed successfully', {
+                insightId: args.insightId,
+                insightName
+            });
+            let responseText = `✅ **Insight Removed Successfully**\n\n`;
+            responseText += `**Insight:** ${insightName}\n`;
+            responseText += `**Insight ID:** \`${args.insightId}\`\n`;
+            responseText += `**Workspace:** ${workspaceName} (\`${workspaceId}\`)\n\n`;
+            responseText += `⚠️ **The insight, its SQL definition, and all associated data have been permanently deleted.**\n\n`;
+            responseText += `💡 Use \`list_insights\` to see remaining insights.`;
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error removing insight", error);
+            let errorMessage = 'Unknown error occurred';
+            if (error instanceof Error) {
+                errorMessage = error.message;
+            }
+            else if (typeof error === 'object' && error !== null) {
+                try {
+                    errorMessage = JSON.stringify(error, null, 2);
+                }
+                catch {
+                    errorMessage = String(error);
+                }
+            }
+            else {
+                errorMessage = String(error);
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error removing insight**\n\n**Error:** ${errorMessage}\n\n**Common Issues:**\n- Insight ID not found\n- Permission denied\n- Insight already deleted\n- Use \`list_insights\` to verify insight ID`,
+                    }],
+            };
+        }
+    }
+};
+// ============================================================================
+// LIST INSIGHTS TOOL
+// ============================================================================
+const listInsightsDescription = `🧪 [PLAYGROUND] List Insights - View all insights in workspace
+
+**What are Insights?**
+Insights are SQL-like reports over Hailer workflow data. They allow querying activities like database tables.
+
+**Purpose**: List all insights in the workspace to find insight IDs.
+
+**Example**:
+\`\`\`javascript
+list_insights({
+  workspaceId: "optional-workspace-id"
+})
+\`\`\`
+
+**Response includes**:
+- Insight ID and name
+- SQL query
+- Sources (workflows being queried)
+- Public/private status
+- Created/updated timestamps`;
+exports.listInsightsTool = {
+    name: 'list_insights',
+    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    description: listInsightsDescription,
+    schema: zod_1.z.object({
+        workspaceId: zod_1.z
+            .string()
+            .optional()
+            .describe("Optional workspace ID or name - defaults to current workspace"),
+    }),
+    async execute(args, context) {
+        logger.debug('Listing insights', {
+            workspaceId: args.workspaceId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            if (!context.workspaceCache) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: "❌ Workspace cache not available",
+                        }],
+                };
+            }
+            // Resolve workspace ID
+            const workspaceId = args.workspaceId
+                ? (0, workspace_cache_1.resolveWorkspaceId)(context.workspaceCache, args.workspaceId)
+                : context.workspaceCache.currentWorkspace._id;
+            if (!workspaceId) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ Could not resolve workspace: ${args.workspaceId}`,
+                        }],
+                };
+            }
+            logger.debug('Calling v3.insight.list', { workspaceId });
+            // Call v3.insight.list endpoint
+            const result = await context.hailer.request('v3.insight.list', [workspaceId]);
+            // API returns array directly for list_insights
+            const insights = Array.isArray(result) ? result : (result.details || result.insights || []);
+            logger.debug('Insights retrieved', {
+                count: insights.length || 0,
+                isArray: Array.isArray(result),
+                responseKeys: Array.isArray(result) ? `array[${result.length}]` : Object.keys(result).join(',')
+            });
+            // Format output
+            let responseText = `📊 **Insights Found** (${insights.length || 0} total)\n\n`;
+            if (!insights || insights.length === 0) {
+                responseText += `No insights found in this workspace.\n\n`;
+                responseText += `💡 Use \`create_insight\` to create a new SQL-like report.`;
+            }
+            else {
+                insights.forEach((insight, index) => {
+                    responseText += `${index + 1}. **${insight.name}**\n`;
+                    responseText += `   - Insight ID: \`${insight._id}\`\n`;
+                    responseText += `   - Public: ${insight.public ? 'Yes' : 'No'}\n`;
+                    responseText += `   - Sources: ${insight.sources.length} workflow(s)\n`;
+                    responseText += `   - Query: \`${insight.query.substring(0, 80)}${insight.query.length > 80 ? '...' : ''}\`\n\n`;
+                });
+                responseText += `💡 **Next Steps:**\n`;
+                responseText += `- Use \`get_insight_data\` to execute an insight\n`;
+                responseText += `- Use \`preview_insight\` to test query changes\n`;
+                responseText += `- Use \`remove_insight\` to delete an insight\n`;
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText,
+                    }],
+            };
+        }
+        catch (error) {
+            logger.error("Error listing insights", error);
+            let errorMessage = 'Unknown error occurred';
+            if (error instanceof Error) {
+                errorMessage = error.message;
+            }
+            else if (typeof error === 'object' && error !== null) {
+                try {
+                    errorMessage = JSON.stringify(error, null, 2);
+                }
+                catch {
+                    errorMessage = String(error);
+                }
+            }
+            else {
+                errorMessage = String(error);
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error listing insights**\n\n**Error:** ${errorMessage}\n\n**Tips:**\n- Check workspace ID is valid\n- Verify you have permission to list insights`,
+                    }],
+            };
+        }
+    }
+};
+//# sourceMappingURL=insight.js.map