agent-relay 1.1.0 → 1.2.3

package/dist/cloud/webhooks/parsers/slack.js

@@ -0,0 +1,214 @@
+/**
+ * Slack Webhook Parser
+ *
+ * Transforms Slack Events API payloads into normalized events.
+ * https://api.slack.com/apis/connections/events-api
+ */
+/**
+ * Extract user mentions from Slack message text
+ * Slack format: <@U12345678> or <@U12345678|username>
+ */
+function extractSlackMentions(text) {
+    if (!text)
+        return [];
+    const mentionPattern = /<@([A-Z0-9]+)(?:\|([^>]+))?>/g;
+    const mentions = [];
+    let match;
+    while ((match = mentionPattern.exec(text)) !== null) {
+        // Prefer display name if available, otherwise use ID
+        mentions.push(match[2] || match[1]);
+    }
+    return [...new Set(mentions)];
+}
+/**
+ * Extract agent mentions from text (our custom @agent-name format)
+ */
+function extractAgentMentions(text) {
+    if (!text)
+        return [];
+    // Match @agent-name patterns that aren't Slack user mentions
+    const mentionPattern = /(?<![<])@([a-zA-Z][a-zA-Z0-9_-]*)(?![>])/g;
+    const mentions = [];
+    let match;
+    while ((match = mentionPattern.exec(text)) !== null) {
+        mentions.push(match[1].toLowerCase());
+    }
+    return [...new Set(mentions)];
+}
+/**
+ * Clean Slack message text (remove user mention formatting)
+ */
+function cleanSlackText(text) {
+    if (!text)
+        return '';
+    // Replace <@U12345678|username> with @username
+    return text.replace(/<@[A-Z0-9]+\|([^>]+)>/g, '@$1')
+        .replace(/<@[A-Z0-9]+>/g, '@user')
+        // Replace <URL|text> with text
+        .replace(/<([^|>]+)\|([^>]+)>/g, '$2')
+        // Replace <URL> with URL
+        .replace(/<([^>]+)>/g, '$1');
+}
+export const slackParser = {
+    id: 'slack',
+    parse(payload) {
+        const data = payload;
+        const events = [];
+        // Handle URL verification challenge
+        if (data.type === 'url_verification') {
+            // This is handled separately in the router
+            return [];
+        }
+        // Events API wrapper
+        if (data.type !== 'event_callback') {
+            return [];
+        }
+        const event = data.event;
+        if (!event)
+            return [];
+        const eventType = event.type;
+        const teamId = data.team_id || 'unknown';
+        const eventId = data.event_id || `slack-${Date.now()}`;
+        const eventTime = data.event_time;
+        const baseEvent = {
+            id: eventId,
+            source: 'slack',
+            timestamp: eventTime ? new Date(eventTime * 1000) : new Date(),
+            actor: {
+                id: String(event.user || 'unknown'),
+                name: String(event.user || 'unknown'),
+            },
+            context: {
+                name: teamId,
+            },
+            labels: [],
+            mentions: [],
+            metadata: {
+                teamId,
+                channelId: event.channel,
+                channelType: event.channel_type,
+            },
+            rawPayload: payload,
+        };
+        switch (eventType) {
+            case 'app_mention': {
+                // Bot was mentioned in a channel
+                const text = event.text;
+                const agentMentions = extractAgentMentions(text);
+                events.push({
+                    ...baseEvent,
+                    type: 'mention',
+                    item: {
+                        type: 'message',
+                        id: String(event.ts),
+                        body: cleanSlackText(text),
+                    },
+                    mentions: agentMentions.length > 0 ? agentMentions : ['lead'], // Default to lead if no specific agent
+                    metadata: {
+                        ...baseEvent.metadata,
+                        ts: event.ts,
+                        threadTs: event.thread_ts,
+                        userMentions: extractSlackMentions(text),
+                    },
+                });
+                break;
+            }
+            case 'message': {
+                // Regular message in channel
+                const text = event.text;
+                const subtype = event.subtype;
+                // Ignore bot messages, message changes, etc.
+                if (subtype && subtype !== 'thread_broadcast') {
+                    break;
+                }
+                const agentMentions = extractAgentMentions(text);
+                // Only create event if there are agent mentions
+                if (agentMentions.length > 0) {
+                    events.push({
+                        ...baseEvent,
+                        type: 'mention',
+                        item: {
+                            type: 'message',
+                            id: String(event.ts),
+                            body: cleanSlackText(text),
+                        },
+                        mentions: agentMentions,
+                        metadata: {
+                            ...baseEvent.metadata,
+                            ts: event.ts,
+                            threadTs: event.thread_ts,
+                            userMentions: extractSlackMentions(text),
+                        },
+                    });
+                }
+                break;
+            }
+            case 'reaction_added': {
+                // Reaction added to a message
+                const reaction = event.reaction;
+                const item = event.item;
+                events.push({
+                    ...baseEvent,
+                    type: 'reaction_added',
+                    item: {
+                        type: 'message',
+                        id: String(item?.ts || 'unknown'),
+                    },
+                    labels: [reaction],
+                    metadata: {
+                        ...baseEvent.metadata,
+                        reaction,
+                        itemType: item?.type,
+                        itemChannel: item?.channel,
+                        itemTs: item?.ts,
+                    },
+                });
+                break;
+            }
+            case 'channel_created': {
+                const channel = event.channel;
+                events.push({
+                    ...baseEvent,
+                    type: 'channel_created',
+                    context: {
+                        name: String(channel?.name || 'unknown'),
+                    },
+                    metadata: {
+                        ...baseEvent.metadata,
+                        channelId: channel?.id,
+                        channelName: channel?.name,
+                        creator: channel?.creator,
+                    },
+                });
+                break;
+            }
+            case 'member_joined_channel': {
+                events.push({
+                    ...baseEvent,
+                    type: 'member_joined',
+                    actor: {
+                        id: String(event.user),
+                        name: String(event.user),
+                    },
+                    metadata: {
+                        ...baseEvent.metadata,
+                        inviter: event.inviter,
+                    },
+                });
+                break;
+            }
+            default:
+                // Unknown event type
+                events.push({
+                    ...baseEvent,
+                    type: `slack.${eventType}`,
+                    metadata: {
+                        ...baseEvent.metadata,
+                        subtype: event.subtype,
+                    },
+                });
+        }
+        return events;
+    },
+};
+//# sourceMappingURL=slack.js.map

package/dist/cloud/webhooks/responders/github.d.ts

@@ -0,0 +1,8 @@
+/**
+ * GitHub Responder
+ *
+ * Sends responses back to GitHub via the GitHub App API.
+ */
+import type { WebhookResponder } from '../types.js';
+export declare const githubResponder: WebhookResponder;
+//# sourceMappingURL=github.d.ts.map

package/dist/cloud/webhooks/responders/github.js

@@ -0,0 +1,73 @@
+/**
+ * GitHub Responder
+ *
+ * Sends responses back to GitHub via the GitHub App API.
+ */
+import { nangoService } from '../../services/nango.js';
+import { db } from '../../db/index.js';
+export const githubResponder = {
+    id: 'github',
+    async respond(event, response, _config) {
+        try {
+            // Get repository info from event context
+            const repoFullName = event.context.name;
+            const [owner, repo] = repoFullName.split('/');
+            if (!owner || !repo) {
+                return { success: false, error: `Invalid repository name: ${repoFullName}` };
+            }
+            // Find the repository in our database to get the Nango connection
+            const repository = await db.repositories.findByFullName(repoFullName);
+            if (!repository?.nangoConnectionId) {
+                return {
+                    success: false,
+                    error: `Repository ${repoFullName} not found or has no Nango connection`,
+                };
+            }
+            switch (response.type) {
+                case 'comment': {
+                    // Post a comment on an issue or PR
+                    const issueNumber = typeof response.target === 'number'
+                        ? response.target
+                        : parseInt(String(response.target), 10);
+                    if (isNaN(issueNumber)) {
+                        return { success: false, error: `Invalid issue number: ${response.target}` };
+                    }
+                    const result = await nangoService.addGithubIssueComment(repository.nangoConnectionId, owner, repo, issueNumber, response.body);
+                    return {
+                        success: true,
+                        id: String(result.id),
+                        url: result.html_url,
+                    };
+                }
+                case 'reaction': {
+                    // Add a reaction to a comment or issue
+                    // Note: This would need to be added to NangoService
+                    return {
+                        success: false,
+                        error: 'Reactions not yet implemented for GitHub',
+                    };
+                }
+                case 'status': {
+                    // Update a check run status
+                    // Note: This would need to be added to NangoService
+                    return {
+                        success: false,
+                        error: 'Status updates not yet implemented for GitHub',
+                    };
+                }
+                default:
+                    return {
+                        success: false,
+                        error: `Unknown response type: ${response.type}`,
+                    };
+            }
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+};
+//# sourceMappingURL=github.js.map

package/dist/cloud/webhooks/responders/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Webhook Responders Index
+ *
+ * Registry of all available responders.
+ */
+import type { WebhookResponder } from '../types.js';
+import { githubResponder } from './github.js';
+import { linearResponder } from './linear.js';
+import { slackResponder, formatSlackBlocks } from './slack.js';
+/**
+ * Registry of all available responders
+ */
+export declare const responders: Record<string, WebhookResponder>;
+/**
+ * Get a responder by ID
+ */
+export declare function getResponder(id: string): WebhookResponder | undefined;
+/**
+ * Register a custom responder
+ */
+export declare function registerResponder(responder: WebhookResponder): void;
+export { githubResponder, linearResponder, slackResponder, formatSlackBlocks };
+//# sourceMappingURL=index.d.ts.map

package/dist/cloud/webhooks/responders/index.js

@@ -0,0 +1,30 @@
+/**
+ * Webhook Responders Index
+ *
+ * Registry of all available responders.
+ */
+import { githubResponder } from './github.js';
+import { linearResponder } from './linear.js';
+import { slackResponder, formatSlackBlocks } from './slack.js';
+/**
+ * Registry of all available responders
+ */
+export const responders = {
+    github: githubResponder,
+    linear: linearResponder,
+    slack: slackResponder,
+};
+/**
+ * Get a responder by ID
+ */
+export function getResponder(id) {
+    return responders[id];
+}
+/**
+ * Register a custom responder
+ */
+export function registerResponder(responder) {
+    responders[responder.id] = responder;
+}
+export { githubResponder, linearResponder, slackResponder, formatSlackBlocks };
+//# sourceMappingURL=index.js.map

package/dist/cloud/webhooks/responders/linear.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Linear Responder
+ *
+ * Sends responses back to Linear via their GraphQL API.
+ * https://developers.linear.app/docs/graphql/working-with-the-graphql-api
+ */
+import type { WebhookResponder } from '../types.js';
+export declare const linearResponder: WebhookResponder;
+//# sourceMappingURL=linear.d.ts.map

package/dist/cloud/webhooks/responders/linear.js

@@ -0,0 +1,149 @@
+/**
+ * Linear Responder
+ *
+ * Sends responses back to Linear via their GraphQL API.
+ * https://developers.linear.app/docs/graphql/working-with-the-graphql-api
+ */
+/**
+ * Execute a Linear GraphQL mutation
+ */
+async function linearGraphQL(apiKey, query, variables) {
+    const response = await fetch('https://api.linear.app/graphql', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'Authorization': apiKey,
+        },
+        body: JSON.stringify({ query, variables }),
+    });
+    return response.json();
+}
+export const linearResponder = {
+    id: 'linear',
+    async respond(event, response, config) {
+        const apiKey = config?.apiKey || process.env.LINEAR_API_KEY;
+        if (!apiKey) {
+            return {
+                success: false,
+                error: 'Linear API key not configured',
+            };
+        }
+        try {
+            switch (response.type) {
+                case 'comment': {
+                    // Create a comment on an issue
+                    const issueId = String(response.target);
+                    const mutation = `
+            mutation CreateComment($issueId: String!, $body: String!) {
+              commentCreate(input: { issueId: $issueId, body: $body }) {
+                success
+                comment {
+                  id
+                  url
+                }
+              }
+            }
+          `;
+                    const result = await linearGraphQL(apiKey, mutation, {
+                        issueId,
+                        body: response.body,
+                    });
+                    if (result.errors?.length) {
+                        return {
+                            success: false,
+                            error: result.errors.map(e => e.message).join(', '),
+                        };
+                    }
+                    const commentCreate = result.data?.commentCreate;
+                    const comment = commentCreate?.comment;
+                    return {
+                        success: !!commentCreate?.success,
+                        id: comment?.id,
+                        url: comment?.url,
+                    };
+                }
+                case 'reaction': {
+                    // Add a reaction/emoji to a comment
+                    const commentId = String(response.target);
+                    const emoji = response.metadata?.emoji || '👍';
+                    const mutation = `
+            mutation CreateReaction($commentId: String!, $emoji: String!) {
+              reactionCreate(input: { commentId: $commentId, emoji: $emoji }) {
+                success
+                reaction {
+                  id
+                }
+              }
+            }
+          `;
+                    const result = await linearGraphQL(apiKey, mutation, {
+                        commentId,
+                        emoji,
+                    });
+                    if (result.errors?.length) {
+                        return {
+                            success: false,
+                            error: result.errors.map(e => e.message).join(', '),
+                        };
+                    }
+                    const reactionCreate = result.data?.reactionCreate;
+                    return {
+                        success: !!reactionCreate?.success,
+                        id: reactionCreate?.reaction?.id,
+                    };
+                }
+                case 'status': {
+                    // Update issue state
+                    const issueId = String(response.target);
+                    const stateId = response.metadata?.stateId;
+                    if (!stateId) {
+                        return {
+                            success: false,
+                            error: 'State ID required for status update',
+                        };
+                    }
+                    const mutation = `
+            mutation UpdateIssue($issueId: String!, $stateId: String!) {
+              issueUpdate(id: $issueId, input: { stateId: $stateId }) {
+                success
+                issue {
+                  id
+                  url
+                }
+              }
+            }
+          `;
+                    const result = await linearGraphQL(apiKey, mutation, {
+                        issueId,
+                        stateId,
+                    });
+                    if (result.errors?.length) {
+                        return {
+                            success: false,
+                            error: result.errors.map(e => e.message).join(', '),
+                        };
+                    }
+                    const issueUpdate = result.data?.issueUpdate;
+                    const issue = issueUpdate?.issue;
+                    return {
+                        success: !!issueUpdate?.success,
+                        id: issue?.id,
+                        url: issue?.url,
+                    };
+                }
+                default:
+                    return {
+                        success: false,
+                        error: `Unknown response type: ${response.type}`,
+                    };
+            }
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+};
+//# sourceMappingURL=linear.js.map

package/dist/cloud/webhooks/responders/slack.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Slack Responder
+ *
+ * Sends responses back to Slack via their Web API.
+ * https://api.slack.com/methods
+ */
+import type { WebhookResponder } from '../types.js';
+export declare const slackResponder: WebhookResponder;
+/**
+ * Helper to format a message with blocks for richer formatting
+ */
+export declare function formatSlackBlocks(text: string, options?: {
+    header?: string;
+    context?: string;
+    actions?: Array<{
+        text: string;
+        url: string;
+    }>;
+}): Array<Record<string, unknown>>;
+//# sourceMappingURL=slack.d.ts.map