@hailer/mcp 0.0.1

package/dist/mcp/tools/discussion.js

@@ -0,0 +1,950 @@
+"use strict";
+/**
+ * Discussion Tools - Clean Architecture Implementation
+ *
+ * Tools for managing Hailer discussions/chats:
+ * - List user's discussions (READ)
+ * - Fetch discussion messages with pagination (WRITE)
+ * - Join/leave discussions (WRITE)
+ * - Post messages to discussions (WRITE)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getActivityFromDiscussionTool = exports.inviteDiscussionMembersTool = exports.addDiscussionMessageTool = exports.leaveDiscussionTool = exports.joinDiscussionTool = exports.fetchPreviousDiscussionMessagesTool = exports.fetchDiscussionMessagesTool = exports.listMyDiscussionsTool = void 0;
+const zod_1 = require("zod");
+const tool_registry_1 = require("../tool-registry");
+const index_1 = require("../utils/index");
+const workspace_cache_1 = require("../workspace-cache");
+const logger = (0, index_1.createLogger)({ component: 'discussion-tools' });
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Sanitize string to remove invalid Unicode characters
+ */
+function sanitizeString(str) {
+    if (!str)
+        return '';
+    return str.replace(/[\ud800-\udfff]/g, '\ufffd');
+}
+/**
+ * Format system/meta message content based on message type
+ */
+function formatSystemMessage(msg) {
+    const type = msg.type;
+    const meta = msg.meta;
+    switch (type) {
+        case 'user.join':
+            return '[User joined the discussion]';
+        case 'user.leave':
+            return '[User left the discussion]';
+        case 'activity.created':
+            return meta?.activityName
+                ? `[Activity created: ${meta.activityName}]`
+                : '[Activity created]';
+        case 'activity.updated':
+            return meta?.activityName
+                ? `[Activity updated: ${meta.activityName}]`
+                : '[Activity updated]';
+        case 'linked.activity.created':
+            return meta?.activityName
+                ? `[Linked activity created: ${meta.activityName}]`
+                : '[Linked activity created]';
+        case 'linked.activity.moved':
+            return meta?.activityName
+                ? `[Linked activity moved: ${meta.activityName}]`
+                : '[Linked activity moved]';
+        case 'discussion.invites':
+            return '[Users invited to discussion]';
+        case 'discussion.removesinvites':
+            return '[Users removed from discussion]';
+        case 'event.new':
+            return meta?.eventName
+                ? `[Event created: ${meta.eventName}]`
+                : '[Event created]';
+        case 'event.updated':
+            return meta?.eventName
+                ? `[Event updated: ${meta.eventName}]`
+                : '[Event updated]';
+        case 'event.attend_response':
+            return '[Event attendance response]';
+        default:
+            return `[System message: ${type}]`;
+    }
+}
+// ============================================================================
+// TOOL 1: LIST MY DISCUSSIONS
+// ============================================================================
+const listMyDiscussionsDescription = `💬 List all discussions you are currently participating in - Shows discussion names, unread counts, starred status, and linked activities`;
+exports.listMyDiscussionsTool = {
+    name: 'list_my_discussions',
+    group: tool_registry_1.ToolGroup.READ,
+    description: listMyDiscussionsDescription,
+    schema: zod_1.z.object({}),
+    async execute(args, context) {
+        try {
+            const syncResponse = await context.hailer.request('v2.discussion.sync', [{ timestamp: 0 }]);
+            logger.debug('Discussion sync response', {
+                discussionsCount: syncResponse.discussions?.length
+            });
+            const discussions = syncResponse.discussions || [];
+            const unreadCounts = syncResponse.unread_counts || {};
+            let responseText = `💬 **MY DISCUSSIONS** (${discussions.length} total):\n\n`;
+            if (discussions.length === 0) {
+                responseText += `❌ You are not currently participating in any discussions.\n\n`;
+                responseText += `💡 **TIP**: Join activity discussions using the \`join_discussion\` tool.`;
+                return {
+                    content: [{ type: "text", text: responseText }],
+                };
+            }
+            // Collect all linked activity IDs to fetch their names
+            const activityIds = discussions
+                .filter((d) => d.linked_activity)
+                .map((d) => d.linked_activity);
+            // Fetch activity names in parallel for better UX
+            const activityNames = {};
+            if (activityIds.length > 0) {
+                const activityPromises = activityIds.map(async (activityId) => {
+                    try {
+                        const activity = await context.hailer.fetchActivityById(activityId);
+                        return { id: activityId, name: activity?.name || null };
+                    }
+                    catch (error) {
+                        logger.debug('Failed to fetch activity name', { activityId, error });
+                        return { id: activityId, name: null };
+                    }
+                });
+                const results = await Promise.all(activityPromises);
+                results.forEach(({ id, name }) => {
+                    if (name)
+                        activityNames[id] = name;
+                });
+            }
+            const discussionsByType = {
+                activity: [],
+                event: [],
+                group: [],
+                private: [],
+                other: []
+            };
+            discussions.forEach((discussion) => {
+                let type = 'other';
+                if (discussion.linked_activity) {
+                    type = 'activity';
+                }
+                else if (discussion.linked_event) {
+                    type = 'event';
+                }
+                else if (discussion.private === true) {
+                    type = 'private';
+                }
+                else if (discussion.private === false) {
+                    type = 'group';
+                }
+                discussionsByType[type].push(discussion);
+            });
+            const typeLabels = {
+                activity: '📋 Activity Discussions',
+                event: '📅 Event Discussions',
+                group: '👥 Group Discussions',
+                private: '💬 Private Discussions',
+                other: '❓ Other Discussions'
+            };
+            for (const [type, typeDiscussions] of Object.entries(discussionsByType)) {
+                if (typeDiscussions.length === 0)
+                    continue;
+                responseText += `${typeLabels[type]} (${typeDiscussions.length}):\n\n`;
+                typeDiscussions.forEach((discussion, index) => {
+                    const unreadCount = unreadCounts[discussion._id] || 0;
+                    responseText += `${index + 1}. `;
+                    if (unreadCount > 0)
+                        responseText += `🔴 `;
+                    // For activity discussions, prefer the activity name over discussion.name
+                    let displayName = sanitizeString(discussion.name) || 'Untitled';
+                    if (discussion.linked_activity && activityNames[discussion.linked_activity]) {
+                        displayName = activityNames[discussion.linked_activity];
+                    }
+                    responseText += `**${displayName}**\n`;
+                    responseText += `   - Discussion ID: \`${sanitizeString(discussion._id)}\`\n`;
+                    responseText += `   - Type: ${type}\n`;
+                    if (discussion.linked_activity) {
+                        responseText += `   - Activity ID: \`${sanitizeString(discussion.linked_activity)}\`\n`;
+                    }
+                    if (discussion.linked_event) {
+                        responseText += `   - Event ID: \`${sanitizeString(discussion.linked_event)}\`\n`;
+                    }
+                    if (unreadCount > 0) {
+                        responseText += `   - Unread: ${unreadCount} message(s)\n`;
+                    }
+                    if (discussion.hasMessages) {
+                        responseText += `   - Has messages: Yes\n`;
+                    }
+                    responseText += `\n`;
+                });
+            }
+            const totalUnread = Object.values(unreadCounts).reduce((sum, count) => sum + count, 0);
+            responseText += `\n📊 **SUMMARY:**\n`;
+            responseText += `- Total discussions: ${discussions.length}\n`;
+            for (const [type, typeDiscussions] of Object.entries(discussionsByType)) {
+                if (typeDiscussions.length > 0) {
+                    const labelWithoutEmoji = typeLabels[type].substring(typeLabels[type].indexOf(' ') + 1);
+                    responseText += `- ${labelWithoutEmoji}: ${typeDiscussions.length}\n`;
+                }
+            }
+            responseText += `- Total unread: ${totalUnread}\n`;
+            responseText += `\n💡 **USAGE:**\n`;
+            responseText += `- Use \`fetch_discussion_messages\` with discussion ID to read messages\n`;
+            responseText += `- Use \`add_discussion_message\` with discussion ID to post a message\n`;
+            responseText += `- Use \`leave_discussion\` with discussion ID to leave a discussion`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: responseText,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error("Failed to list discussions", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ Failed to list discussions: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+            };
+        }
+    },
+};
+// ============================================================================
+// TOOL 2: FETCH DISCUSSION MESSAGES
+// ============================================================================
+const fetchDiscussionMessagesDescription = `Read latest messages from any Hailer discussion/chat (up to 50 messages - API limit)`;
+exports.fetchDiscussionMessagesTool = {
+    name: 'fetch_discussion_messages',
+    group: tool_registry_1.ToolGroup.READ,
+    description: fetchDiscussionMessagesDescription,
+    schema: zod_1.z.object({
+        discussionId: zod_1.z
+            .string()
+            .min(24, "Discussion ID must be at least 24 characters")
+            .describe("The discussion ID to read messages from. You can get this from activity results (look for 'discussion' field) or from URLs like https://app.hailer.com/#/discussions/DISCUSSION_ID"),
+        limit: zod_1.z
+            .number()
+            .int()
+            .min(1, "Limit must be at least 1")
+            .max(50, "Limit cannot exceed 50 messages (API maximum)")
+            .default(50)
+            .optional()
+            .describe("Number of messages to fetch (default: 50, max: 50 due to API limit). Use fetch_previous_discussion_messages for older messages")
+    }),
+    async execute(args, context) {
+        const limit = args.limit || 50;
+        logger.debug('Fetching discussion messages', {
+            discussionId: args.discussionId,
+            limit: limit,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            const result = await context.hailer.fetchDiscussionMessages(args.discussionId, limit);
+            const messages = result.messages || [];
+            const messageCount = messages.length;
+            const userMessages = messages.filter((m) => m.type === "user");
+            const recentMessage = messages[0];
+            const optimizedMessages = messages.map((msg) => {
+                let cleanMsg = msg.msg || '';
+                if (cleanMsg) {
+                    cleanMsg = cleanMsg.replace(/data:[^;]+;base64,[A-Za-z0-9+/=]+/g, '[FILE_REMOVED]');
+                    cleanMsg = cleanMsg.replace(/!\[.*?\]\(data:[^)]+\)/g, '[IMAGE_REMOVED]');
+                }
+                const userInfo = (0, workspace_cache_1.getUserById)(context.workspaceCache, msg.uid);
+                let username = `User ${msg.uid}`;
+                if (userInfo) {
+                    const fullName = `${userInfo.firstname || ''} ${userInfo.lastname || ''}`.trim();
+                    username = fullName || userInfo.fullName || `User ${msg.uid}`;
+                }
+                const optimizedMsg = {
+                    _id: msg._id,
+                    username: username,
+                    created: new Date(msg.created).toLocaleString(),
+                    type: msg.type,
+                    msg: cleanMsg
+                };
+                if (msg.type !== 'user' && !msg.msg) {
+                    optimizedMsg.systemDescription = formatSystemMessage(msg);
+                    if (msg.meta && Object.keys(msg.meta).length > 0) {
+                        optimizedMsg.meta = msg.meta;
+                    }
+                }
+                if (msg.replyTo) {
+                    optimizedMsg.replyTo = msg.replyTo;
+                }
+                return optimizedMsg;
+            });
+            const optimizedResult = {
+                oldestLoaded: result.oldestLoaded,
+                newestLoaded: result.newestLoaded,
+                messages: optimizedMessages
+            };
+            let responseText = `📬 Successfully fetched ${messageCount} messages from discussion ${args.discussionId}`;
+            if (result.truncated) {
+                responseText += ` (limited from ${result.originalCount} available messages)`;
+            }
+            responseText += `\n\n📊 Summary:\n- ${userMessages.length} user messages\n- ${messages.length - userMessages.length} system messages (joins, activity creation, etc.)\n- Most recent: ${recentMessage ? `"${recentMessage.msg || "System event"}" at ${new Date(recentMessage.created).toLocaleString()}` : "No messages"}`;
+            responseText += `\n- Requested limit: ${limit} messages (API max: 50)`;
+            if (result.truncated) {
+                responseText += `\n- ⚠️  More messages available: ${result.originalCount - limit} additional messages not shown`;
+            }
+            if (optimizedMessages.length > 0) {
+                const oldestMessage = optimizedMessages[optimizedMessages.length - 1];
+                responseText += `\n\n🔄 **PAGINATION**: To get older messages, use fetch_previous_discussion_messages with:`;
+                responseText += `\n- oldestMessageId: "${oldestMessage._id}"`;
+                responseText += `\n- batches: 1-10 (each batch = ~50 messages)`;
+            }
+            responseText += `\n\n💡 Use this to understand conversation context, get project updates, or analyze team communications!\n\nOptimized conversation data (essential fields only):\n${JSON.stringify(optimizedResult, null, 2)}`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: responseText,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error("Error fetching discussion messages", error);
+            const errorMessage = error instanceof Error
+                ? error.message
+                : (typeof error === 'object' && error !== null)
+                    ? JSON.stringify(error, null, 2)
+                    : String(error);
+            const isPermissionError = errorMessage.toLowerCase().includes('permission') ||
+                errorMessage.toLowerCase().includes('access') ||
+                errorMessage.toLowerCase().includes('forbidden') ||
+                errorMessage.toLowerCase().includes('unauthorized');
+            let helpText = `❌ Error fetching discussion messages: ${errorMessage}\n\n`;
+            if (isPermissionError) {
+                helpText += `🔒 **PERMISSION REQUIRED**: You need to join this discussion before you can read messages.\n\n` +
+                    `💡 **Solution**: Use the join_discussion tool first:\n` +
+                    `   join_discussion(discussionId: "${args.discussionId}")\n\n`;
+            }
+            helpText += `💡 Tips:\n` +
+                `- Make sure the discussion ID is correct (24-character string)\n` +
+                `- You must be a member/follower of the discussion to read messages\n` +
+                `- Some discussions may be private or require specific permissions\n\n` +
+                `Example discussion ID: '683ef53087e3d8329abaa3ad'`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: helpText,
+                    },
+                ],
+            };
+        }
+    },
+};
+// ============================================================================
+// TOOL 3: FETCH PREVIOUS DISCUSSION MESSAGES
+// ============================================================================
+const fetchPreviousDiscussionMessagesDescription = `Fetch older messages from a discussion using pagination - requires a message ID from previous results to continue from`;
+exports.fetchPreviousDiscussionMessagesTool = {
+    name: 'fetch_previous_discussion_messages',
+    group: tool_registry_1.ToolGroup.READ,
+    description: fetchPreviousDiscussionMessagesDescription,
+    schema: zod_1.z.object({
+        oldestMessageId: zod_1.z
+            .string()
+            .min(24, "Message ID must be at least 24 characters")
+            .describe("The ID of the oldest message from your previous fetch - use this to continue pagination. Get this from the '_id' field of the last message in previous results"),
+        batches: zod_1.z
+            .number()
+            .int()
+            .min(1, "Batches must be at least 1")
+            .max(10, "Cannot fetch more than 10 batches at once")
+            .default(1)
+            .optional()
+            .describe("Number of previous message batches to fetch (default: 1, max: 10). Each batch contains up to 50 messages. Use higher values to get more history in one call")
+    }),
+    async execute(args, context) {
+        const batches = args.batches || 1;
+        logger.debug('Fetching previous discussion messages', {
+            oldestMessageId: args.oldestMessageId,
+            batches: batches,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            const result = await context.hailer.fetchPreviousDiscussionMessages(args.oldestMessageId, batches);
+            const messages = result.messages || [];
+            const messageCount = messages.length;
+            const userMessages = messages.filter((m) => m.type === "user");
+            const oldestMessage = messages.length > 0 ? messages[messages.length - 1] : null;
+            const optimizedMessages = messages.map((msg) => {
+                let cleanMsg = msg.msg || '';
+                if (cleanMsg) {
+                    cleanMsg = cleanMsg.replace(/data:[^;]+;base64,[A-Za-z0-9+/=]+/g, '[FILE_REMOVED]');
+                    cleanMsg = cleanMsg.replace(/!\[.*?\]\(data:[^)]+\)/g, '[IMAGE_REMOVED]');
+                }
+                const userInfo = (0, workspace_cache_1.getUserById)(context.workspaceCache, msg.uid);
+                let username = `User ${msg.uid}`;
+                if (userInfo) {
+                    const fullName = `${userInfo.firstname || ''} ${userInfo.lastname || ''}`.trim();
+                    username = fullName || userInfo.fullName || `User ${msg.uid}`;
+                }
+                const optimizedMsg = {
+                    _id: msg._id,
+                    username: username,
+                    created: new Date(msg.created).toLocaleString(),
+                    msg: cleanMsg
+                };
+                if (msg.replyTo) {
+                    optimizedMsg.replyTo = msg.replyTo;
+                }
+                return optimizedMsg;
+            });
+            const optimizedResult = {
+                messages: optimizedMessages,
+                totalFetched: result.totalFetched,
+                batchesCompleted: result.batchesCompleted,
+                oldestMessageId: result.oldestMessageId,
+                hasMore: result.hasMore
+            };
+            let responseText = `📬 Successfully fetched ${messageCount} previous messages`;
+            responseText += `\n\n📊 Summary:`;
+            responseText += `\n- ${userMessages.length} user messages`;
+            responseText += `\n- ${messages.length - userMessages.length} system messages`;
+            responseText += `\n- Batches completed: ${result.batchesCompleted}/${batches}`;
+            responseText += `\n- Total messages fetched: ${result.totalFetched}`;
+            if (oldestMessage) {
+                responseText += `\n- Oldest message: "${oldestMessage.msg || 'System event'}" at ${new Date(oldestMessage.created).toLocaleString()}`;
+            }
+            if (result.hasMore && optimizedMessages.length > 0) {
+                const oldestOptimizedMessage = optimizedMessages[optimizedMessages.length - 1];
+                responseText += `\n\n🔄 **CONTINUE PAGINATION**: To get even older messages:`;
+                responseText += `\n- oldestMessageId: "${oldestOptimizedMessage._id}"`;
+                responseText += `\n- batches: 1-10 (for more history)`;
+            }
+            else if (!result.hasMore) {
+                responseText += `\n\n✅ **END OF HISTORY**: No more messages available in this discussion.`;
+            }
+            responseText += `\n\n💡 Use this to explore conversation history and understand context!\n\nOptimized conversation data (essential fields only):\n${JSON.stringify(optimizedResult, null, 2)}`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: responseText,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error("Error fetching previous discussion messages", error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ Error fetching previous discussion messages: ${error instanceof Error ? error.message : String(error)}\n\n💡 **IMPORTANT**: Make sure you're using a MESSAGE ID, not a DISCUSSION ID!\n\n**How to get the correct oldestMessageId:**\n1. First call fetch_discussion_messages with your discussionId\n2. Look at the last message in the results\n3. Use that message's '_id' field as oldestMessageId\n\n**Example:**\n- ❌ Wrong: "682dcfa9d36a4907a88bb279" (this is a discussion ID)\n- ✅ Correct: "68e5c1903b104307efdebce9" (this is a message ID)\n\nMessage IDs are usually different from discussion IDs!`,
+                    },
+                ],
+            };
+        }
+    },
+};
+// ============================================================================
+// TOOL 4: JOIN DISCUSSION
+// ============================================================================
+const joinDiscussionDescription = `Join a discussion to gain access to read and post messages - Use this for activity discussions (provide activityId) or general discussions (provide discussionId)`;
+exports.joinDiscussionTool = {
+    name: 'join_discussion',
+    group: tool_registry_1.ToolGroup.WRITE,
+    description: joinDiscussionDescription,
+    schema: zod_1.z.object({
+        activityId: zod_1.z
+            .string()
+            .min(24, "Activity ID must be at least 24 characters")
+            .optional()
+            .describe("Activity ID to join its discussion (preferred method for activity discussions)"),
+        discussionId: zod_1.z
+            .string()
+            .min(24, "Discussion ID must be at least 24 characters")
+            .optional()
+            .describe("Discussion ID to join directly (use this for non-activity discussions)")
+    }).refine((data) => data.activityId || data.discussionId, {
+        message: "Either activityId or discussionId must be provided"
+    }),
+    async execute(args, context) {
+        logger.debug('Joining discussion', {
+            activityId: args.activityId,
+            discussionId: args.discussionId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            if (args.activityId) {
+                const result = await context.hailer.joinActivityDiscussion(args.activityId);
+                const activity = await context.hailer.fetchActivityById(args.activityId);
+                const discussionId = activity.discussion;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `✅ Successfully joined activity discussion!\n\n` +
+                                `📋 **Activity**: ${activity.name || args.activityId}\n` +
+                                `💬 **Discussion ID**: ${discussionId}\n` +
+                                `📊 **Status**: ${result ? 'Now following this activity' : 'Already following'}\n\n` +
+                                `🎉 You can now:\n` +
+                                `- Read messages with: fetch_discussion_messages(discussionId: "${discussionId}")\n` +
+                                `- Post messages with: add_discussion_message(discussionId: "${discussionId}", content: "your message")\n` +
+                                `- Leave with: leave_discussion(activityId: "${args.activityId}")\n\n` +
+                                `🔗 **Direct Links:**\n` +
+                                `- Activity: https://app.hailer.com/#/activities/${args.activityId}\n` +
+                                `- Discussion: https://app.hailer.com/#/discussions/${discussionId}`,
+                        },
+                    ],
+                };
+            }
+            if (args.discussionId) {
+                const result = await context.hailer.joinDiscussion(args.discussionId);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `✅ ${result.message}\n\n` +
+                                `💬 **Discussion ID**: ${args.discussionId}\n` +
+                                `📊 **Method**: ${result.method}\n\n` +
+                                `🎉 You can now:\n` +
+                                `- Read messages with: fetch_discussion_messages(discussionId: "${args.discussionId}")\n` +
+                                `- Post messages with: add_discussion_message(discussionId: "${args.discussionId}", content: "your message")\n\n` +
+                                `💡 **Note**: For activity discussions, prefer using activityId for better integration.\n\n` +
+                                `🔗 **Direct Link:** https://app.hailer.com/#/discussions/${args.discussionId}`,
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ Error: Either activityId or discussionId must be provided`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error("Error joining discussion", error);
+            const errorMessage = error instanceof Error
+                ? error.message
+                : (typeof error === 'object' && error !== null)
+                    ? JSON.stringify(error, null, 2)
+                    : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ Error joining discussion: ${errorMessage}\n\n` +
+                            `💡 Troubleshooting:\n` +
+                            `- For activity discussions: Use join_discussion(activityId: "...")\n` +
+                            `- The activity or discussion must exist and be accessible\n` +
+                            `- You need permission to join this discussion\n` +
+                            `- Some discussions may be private or require an invitation\n\n` +
+                            `📖 Examples:\n` +
+                            `- Activity discussion: join_discussion(activityId: "68446dc05b30685f67c6fcd4")\n` +
+                            `- General discussion: join_discussion(discussionId: "683ef53087e3d8329abaa3ad")`,
+                    },
+                ],
+            };
+        }
+    },
+};
+// ============================================================================
+// TOOL 5: LEAVE DISCUSSION
+// ============================================================================
+const leaveDiscussionDescription = `Leave a discussion - Works for activity discussions (provide activityId) or general discussions (provide discussionId)`;
+exports.leaveDiscussionTool = {
+    name: 'leave_discussion',
+    group: tool_registry_1.ToolGroup.WRITE,
+    description: leaveDiscussionDescription,
+    schema: zod_1.z.object({
+        activityId: zod_1.z
+            .string()
+            .min(24, "Activity ID must be at least 24 characters")
+            .optional()
+            .describe("Activity ID to leave its discussion (preferred method for activity discussions)"),
+        discussionId: zod_1.z
+            .string()
+            .min(24, "Discussion ID must be at least 24 characters")
+            .optional()
+            .describe("Discussion ID to leave directly")
+    }).refine((data) => data.activityId || data.discussionId, {
+        message: "Either activityId or discussionId must be provided"
+    }),
+    async execute(args, context) {
+        logger.debug('Leaving discussion', {
+            activityId: args.activityId,
+            discussionId: args.discussionId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            if (args.activityId) {
+                const result = await context.hailer.leaveActivityDiscussion(args.activityId);
+                const activity = await context.hailer.fetchActivityById(args.activityId);
+                const discussionId = activity.discussion;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `✅ Successfully left activity discussion!\n\n` +
+                                `📋 **Activity**: ${activity.name || args.activityId}\n` +
+                                `💬 **Discussion ID**: ${discussionId}\n` +
+                                `📊 **Status**: ${result ? 'Unfollowed activity' : 'Was not following'}\n\n` +
+                                `🔔 You will no longer receive notifications from this discussion.\n\n` +
+                                `💡 To rejoin: join_discussion(activityId: "${args.activityId}")\n\n` +
+                                `🔗 **Links:**\n` +
+                                `- Activity: https://app.hailer.com/#/activities/${args.activityId}\n` +
+                                `- Discussion: https://app.hailer.com/#/discussions/${discussionId}`,
+                        },
+                    ],
+                };
+            }
+            if (args.discussionId) {
+                await context.hailer.leaveDiscussion(args.discussionId);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `✅ Successfully left discussion!\n\n` +
+                                `💬 **Discussion ID**: ${args.discussionId}\n\n` +
+                                `🔔 You will no longer receive notifications from this discussion.\n\n` +
+                                `💡 To rejoin: join_discussion(discussionId: "${args.discussionId}")\n\n` +
+                                `🔗 **Direct Link:** https://app.hailer.com/#/discussions/${args.discussionId}`,
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ Error: Either activityId or discussionId must be provided`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error("Error leaving discussion", error);
+            const errorMessage = error instanceof Error
+                ? error.message
+                : (typeof error === 'object' && error !== null)
+                    ? JSON.stringify(error, null, 2)
+                    : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ Error leaving discussion: ${errorMessage}\n\n` +
+                            `💡 Troubleshooting:\n` +
+                            `- For activity discussions: Use leave_discussion(activityId: "...")\n` +
+                            `- For general discussions: Use leave_discussion(discussionId: "...")\n` +
+                            `- The activity or discussion must exist and be accessible\n` +
+                            `- You need permission to leave this discussion\n` +
+                            `- Some discussions may have restrictions on leaving\n\n` +
+                            `📖 Examples:\n` +
+                            `- Activity discussion: leave_discussion(activityId: "68446dc05b30685f67c6fcd4")\n` +
+                            `- General discussion: leave_discussion(discussionId: "683ef53087e3d8329abaa3ad")`,
+                    },
+                ],
+            };
+        }
+    },
+};
+// ============================================================================
+// TOOL 6: ADD DISCUSSION MESSAGE
+// ============================================================================
+const addDiscussionMessageDescription = `Post a message to a Hailer discussion with optional file attachments - AI agents can participate in conversations`;
+exports.addDiscussionMessageTool = {
+    name: 'add_discussion_message',
+    group: tool_registry_1.ToolGroup.WRITE,
+    description: addDiscussionMessageDescription,
+    schema: zod_1.z.object({
+        discussionId: zod_1.z.string().min(24, "Discussion ID must be at least 24 characters").describe("The discussion ID where to post the message"),
+        content: zod_1.z.string().min(1, "Message content cannot be empty").describe("The message text to post"),
+        fileIds: zod_1.z.array(zod_1.z.string()).optional().describe("Optional array of file IDs to attach (from upload_files tool)")
+    }),
+    async execute(args, context) {
+        try {
+            const result = await context.hailer.sendDiscussionMessage(args.discussionId, args.content, args.fileIds);
+            let responseText = `✅ Successfully posted message to discussion ${args.discussionId}!\n\n📝 Message: "${args.content}"`;
+            if (args.fileIds && args.fileIds.length > 0) {
+                responseText += `\n📎 Attachments: ${args.fileIds.length} file(s)`;
+            }
+            responseText += `\n\n💬 Your message has been added to the conversation and team members will be notified.\n\nResponse data:\n${JSON.stringify(result, null, 2)}`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: responseText,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ Error posting message: ${error instanceof Error ? error.message : String(error)}\n\n💡 Tips:\n- Make sure the discussion ID is correct (24-character string)\n- Check that you have permission to post to this discussion\n- Verify the discussion exists and is accessible\n- If attaching files, ensure file IDs are valid (from upload_files tool)\n\nExample discussion ID: '683ef53087e3d8329abaa3ad'`,
+                    },
+                ],
+            };
+        }
+    },
+};
+// ============================================================================
+// TOOL 7: INVITE DISCUSSION MEMBERS
+// ============================================================================
+const inviteDiscussionMembersDescription = `Invite users to a discussion - Manager bots can use this to bring specialized bots or users into conversations based on needs`;
+exports.inviteDiscussionMembersTool = {
+    name: 'invite_discussion_members',
+    group: tool_registry_1.ToolGroup.WRITE,
+    description: inviteDiscussionMembersDescription,
+    schema: zod_1.z.object({
+        discussionId: zod_1.z
+            .string()
+            .min(24, "Discussion ID must be at least 24 characters")
+            .describe("The discussion ID where to invite members"),
+        userIds: zod_1.z
+            .array(zod_1.z.string().min(24, "User ID must be at least 24 characters"))
+            .min(1, "At least one user ID must be provided")
+            .describe("Array of user IDs to invite to the discussion. Use search_workspace_users to find user IDs")
+    }),
+    async execute(args, context) {
+        logger.debug('Inviting members to discussion', {
+            discussionId: args.discussionId,
+            userIds: args.userIds,
+            count: args.userIds.length,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            // Use messenger.invite_users endpoint
+            const result = await context.hailer.request('messenger.invite_users', [
+                args.discussionId,
+                args.userIds
+            ]);
+            logger.debug('Invite result', { result });
+            // Get usernames for better feedback
+            const invitedUsers = args.userIds.map((userId) => {
+                const userInfo = (0, workspace_cache_1.getUserById)(context.workspaceCache, userId);
+                const fullName = userInfo
+                    ? `${userInfo.firstname || ''} ${userInfo.lastname || ''}`.trim() || userInfo.fullName
+                    : userId;
+                return `- ${fullName} (${userId})`;
+            }).join('\n');
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `✅ Successfully invited ${args.userIds.length} member(s) to discussion!\n\n` +
+                            `💬 **Discussion ID**: ${args.discussionId}\n` +
+                            `👥 **Invited Members**:\n${invitedUsers}\n\n` +
+                            `🎉 The invited members can now:\n` +
+                            `- See all messages in the discussion\n` +
+                            `- Post messages and participate\n` +
+                            `- Receive notifications for new activity\n\n` +
+                            `💡 **Use Case**: Perfect for bringing specialized bots or team members into conversations!\n\n` +
+                            `🔗 **Discussion Link:** https://app.hailer.com/#/discussions/${args.discussionId}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error("Error inviting discussion members", error);
+            const errorMessage = error instanceof Error
+                ? error.message
+                : (typeof error === 'object' && error !== null)
+                    ? JSON.stringify(error, null, 2)
+                    : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ Error inviting members to discussion: ${errorMessage}\n\n` +
+                            `💡 Troubleshooting:\n` +
+                            `- Verify the discussion ID is correct (24-character string)\n` +
+                            `- Ensure all user IDs are valid (use search_workspace_users tool)\n` +
+                            `- You need permission to invite members to this discussion\n` +
+                            `- Some discussions may have restrictions on adding members\n\n` +
+                            `📖 Example:\n` +
+                            `invite_discussion_members({\n` +
+                            `  discussionId: "683ef53087e3d8329abaa3ad",\n` +
+                            `  userIds: ["690aed2924d79161d7529fd7", "690aed2924d79161d7529fd8"]\n` +
+                            `})`,
+                    },
+                ],
+            };
+        }
+    },
+};
+// Note: Hailer API does not have a "kick" or "remove members" feature.
+// Bots can only remove themselves using the leave_discussion tool.
+// ============================================================================
+// TOOL 8: GET ACTIVITY FROM DISCUSSION
+// ============================================================================
+const getActivityFromDiscussionDescription = `🔍 Reverse lookup: Get activity details from a discussion ID
+
+**Purpose**: When you have a discussion ID but need to know what activity it belongs to.
+
+**Example**:
+\`\`\`javascript
+get_activity_from_discussion({
+  discussionId: "691ffe874217e9e8434e57f5"
+})
+\`\`\`
+
+**Returns**: Activity name, ID, workflow info, phase, and field values
+
+**Use Cases**:
+- Identify which activity a discussion belongs to
+- Get activity context when processing discussion messages
+- Navigate from chat to activity details`;
+exports.getActivityFromDiscussionTool = {
+    name: 'get_activity_from_discussion',
+    group: tool_registry_1.ToolGroup.READ,
+    description: getActivityFromDiscussionDescription,
+    schema: zod_1.z.object({
+        discussionId: zod_1.z
+            .string()
+            .min(24, "Discussion ID must be at least 24 characters")
+            .describe("The discussion ID to look up the associated activity for")
+    }),
+    async execute(args, context) {
+        logger.debug('Getting activity from discussion', {
+            discussionId: args.discussionId,
+            apiKey: context.apiKey.substring(0, 8) + '...'
+        });
+        try {
+            // First, sync discussions to find the one with this ID
+            const syncResponse = await context.hailer.request('v2.discussion.sync', [{ timestamp: 0 }]);
+            const discussions = syncResponse.discussions || [];
+            const targetDiscussion = discussions.find((d) => d._id === args.discussionId);
+            if (!targetDiscussion) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ Discussion not found: ${args.discussionId}\n\n` +
+                                `💡 **Possible reasons:**\n` +
+                                `- You are not a member of this discussion\n` +
+                                `- The discussion ID is incorrect\n` +
+                                `- The discussion has been deleted\n\n` +
+                                `**Tip**: Use \`list_my_discussions\` to see discussions you have access to.`
+                        }]
+                };
+            }
+            // Check if this discussion is linked to an activity
+            if (!targetDiscussion.linked_activity) {
+                let discussionType = 'unknown';
+                if (targetDiscussion.linked_event) {
+                    discussionType = 'event';
+                }
+                else if (targetDiscussion.private === true) {
+                    discussionType = 'private';
+                }
+                else if (targetDiscussion.private === false) {
+                    discussionType = 'group';
+                }
+                return {
+                    content: [{
+                            type: "text",
+                            text: `⚠️ Discussion found but not linked to an activity\n\n` +
+                                `💬 **Discussion ID**: \`${args.discussionId}\`\n` +
+                                `📋 **Type**: ${discussionType}\n` +
+                                `📝 **Name**: ${sanitizeString(targetDiscussion.name) || 'Untitled'}\n` +
+                                (targetDiscussion.linked_event ? `📅 **Event ID**: \`${targetDiscussion.linked_event}\`\n` : '') +
+                                `\n💡 This discussion is not associated with any activity.`
+                        }]
+                };
+            }
+            // Fetch the linked activity details
+            const activityId = targetDiscussion.linked_activity;
+            const activity = await context.hailer.fetchActivityById(activityId);
+            if (!activity) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `⚠️ Discussion is linked to activity \`${activityId}\` but activity could not be loaded.\n\n` +
+                                `💡 **Possible reasons:**\n` +
+                                `- The activity has been deleted\n` +
+                                `- You don't have permission to view the activity\n` +
+                                `- The activity is in a different workspace`
+                        }]
+                };
+            }
+            // Build comprehensive response
+            let responseText = `✅ **Activity Found!**\n\n`;
+            responseText += `📋 **Activity Details:**\n`;
+            responseText += `- **Name**: ${activity.name || 'Untitled'}\n`;
+            responseText += `- **Activity ID**: \`${activity._id}\`\n`;
+            responseText += `- **Discussion ID**: \`${args.discussionId}\`\n`;
+            if (activity.workflowId) {
+                responseText += `- **Workflow ID**: \`${activity.workflowId}\`\n`;
+            }
+            if (activity.workflowName) {
+                responseText += `- **Workflow**: ${activity.workflowName}\n`;
+            }
+            if (activity.phaseName) {
+                responseText += `- **Phase**: ${activity.phaseName}\n`;
+            }
+            if (activity.phaseId) {
+                responseText += `- **Phase ID**: \`${activity.phaseId}\`\n`;
+            }
+            if (activity.created) {
+                responseText += `- **Created**: ${new Date(activity.created).toLocaleString()}\n`;
+            }
+            if (activity.updated) {
+                responseText += `- **Updated**: ${new Date(activity.updated).toLocaleString()}\n`;
+            }
+            // Add field values if present
+            if (activity.fields && Object.keys(activity.fields).length > 0) {
+                responseText += `\n📊 **Field Values:**\n`;
+                for (const [fieldId, value] of Object.entries(activity.fields)) {
+                    if (value !== null && value !== undefined && value !== '') {
+                        const displayValue = typeof value === 'object' ? JSON.stringify(value) : String(value);
+                        responseText += `- \`${fieldId}\`: ${displayValue}\n`;
+                    }
+                }
+            }
+            responseText += `\n🔗 **Links:**\n`;
+            responseText += `- Activity: https://app.hailer.com/#/activities/${activity._id}\n`;
+            responseText += `- Discussion: https://app.hailer.com/#/discussions/${args.discussionId}\n`;
+            responseText += `\n💡 **Next Steps:**\n`;
+            responseText += `- View full activity: \`show_activity_by_id({ activityId: "${activity._id}" })\`\n`;
+            responseText += `- List workflow activities: \`list_activities({ workflowId: "${activity.workflowId}", phaseId: "${activity.phaseId}", fields: [...] })\``;
+            return {
+                content: [{
+                        type: "text",
+                        text: responseText
+                    }]
+            };
+        }
+        catch (error) {
+            logger.error("Error getting activity from discussion", error);
+            const errorMessage = error instanceof Error
+                ? error.message
+                : (typeof error === 'object' && error !== null)
+                    ? JSON.stringify(error, null, 2)
+                    : String(error);
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ Error getting activity from discussion: ${errorMessage}\n\n` +
+                            `💡 **Troubleshooting:**\n` +
+                            `- Verify the discussion ID is correct (24-character string)\n` +
+                            `- Ensure you have access to the discussion\n` +
+                            `- Try \`list_my_discussions\` to see available discussions\n\n` +
+                            `📖 **Example:**\n` +
+                            `get_activity_from_discussion({ discussionId: "691ffe874217e9e8434e57f5" })`
+                    }]
+            };
+        }
+    }
+};
+//# sourceMappingURL=discussion.js.map