agent-relay 2.0.23 → 2.0.24

package/packages/cloud/dist/webhooks/parsers/linear.js

@@ -1,258 +0,0 @@
-/**
- * Linear Webhook Parser
- *
- * Transforms Linear webhook payloads into normalized events.
- * Linear webhooks: https://developers.linear.app/docs/graphql/webhooks
- */
-/**
- * Extract @mentions from text (Linear uses @username format)
- */
-function extractMentions(text) {
-    if (!text)
-        return [];
-    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)];
-}
-/**
- * Map Linear priority to normalized priority
- * Linear: 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low
- */
-function mapPriority(priority) {
-    switch (priority) {
-        case 1: return 'critical';
-        case 2: return 'high';
-        case 3: return 'medium';
-        case 4: return 'low';
-        default: return undefined;
-    }
-}
-export const linearParser = {
-    id: 'linear',
-    parse(payload) {
-        const data = payload;
-        const events = [];
-        const action = data.action; // create, update, remove
-        const type = data.type; // Issue, Comment, Project, etc.
-        const webhookData = data.data;
-        const webhookId = data.webhookId;
-        const createdAt = data.createdAt;
-        if (!webhookData)
-            return events;
-        const baseEvent = {
-            id: webhookId || `linear-${Date.now()}`,
-            source: 'linear',
-            timestamp: createdAt ? new Date(createdAt) : new Date(),
-            actor: {
-                id: 'unknown',
-                name: 'unknown',
-            },
-            context: {
-                name: 'unknown',
-            },
-            labels: [],
-            mentions: [],
-            metadata: {},
-            rawPayload: payload,
-        };
-        // Extract actor from various fields
-        const creator = webhookData.creator;
-        const user = webhookData.user;
-        const actor = creator || user;
-        if (actor) {
-            baseEvent.actor = {
-                id: String(actor.id || 'unknown'),
-                name: String(actor.name || actor.email || 'unknown'),
-                email: actor.email,
-            };
-        }
-        // Extract team/project context
-        const team = webhookData.team;
-        const project = webhookData.project;
-        if (team) {
-            baseEvent.context = {
-                name: String(team.key || team.name || 'unknown'),
-                url: `https://linear.app/team/${team.key}`,
-            };
-        }
-        else if (project) {
-            baseEvent.context = {
-                name: String(project.name || 'unknown'),
-                url: project.url,
-            };
-        }
-        switch (type) {
-            case 'Issue': {
-                const issue = webhookData;
-                const labels = (issue.labels || []);
-                const labelNames = labels.map(l => String(l.name));
-                const assignee = issue.assignee;
-                if (action === 'create') {
-                    events.push({
-                        ...baseEvent,
-                        type: 'issue_created',
-                        item: {
-                            type: 'ticket',
-                            id: String(issue.id),
-                            number: issue.number,
-                            title: String(issue.title || ''),
-                            body: String(issue.description || ''),
-                            url: String(issue.url || ''),
-                            state: String(issue.state?.name || issue.state || 'unknown'),
-                        },
-                        labels: labelNames,
-                        priority: mapPriority(issue.priority),
-                        mentions: extractMentions(issue.description),
-                        metadata: {
-                            action,
-                            identifier: issue.identifier, // e.g., "ENG-123"
-                            estimate: issue.estimate,
-                            dueDate: issue.dueDate,
-                            assignee: assignee?.name,
-                            assigneeEmail: assignee?.email,
-                            cycle: issue.cycle?.name,
-                        },
-                    });
-                }
-                else if (action === 'update') {
-                    // Check for assignment changes
-                    const updatedFrom = data.updatedFrom;
-                    const wasAssigned = updatedFrom?.assigneeId !== undefined &&
-                        !updatedFrom?.assigneeId &&
-                        assignee?.id;
-                    // Check if assigned to an agent (name matches agent pattern)
-                    const assigneeName = String(assignee?.name || '').toLowerCase();
-                    // Order matters: more specific patterns first, generic 'agent' and 'bot' last
-                    const agentPatterns = ['developer', 'reviewer', 'debugger', 'ci-fix', 'refactor', 'lead', 'test', 'docs', 'agent', 'bot'];
-                    const isAgentAssignment = wasAssigned && agentPatterns.some(p => assigneeName.includes(p));
-                    if (isAgentAssignment) {
-                        // Extract the agent type from the assignee name (finds first/most-specific match)
-                        const matchedAgent = agentPatterns.find(p => assigneeName.includes(p)) || 'developer';
-                        events.push({
-                            ...baseEvent,
-                            type: 'issue_assigned',
-                            item: {
-                                type: 'ticket',
-                                id: String(issue.id),
-                                number: issue.number,
-                                title: String(issue.title || ''),
-                                body: String(issue.description || ''),
-                                url: String(issue.url || ''),
-                                state: String(issue.state?.name || issue.state || 'unknown'),
-                            },
-                            labels: labelNames,
-                            priority: mapPriority(issue.priority),
-                            mentions: [matchedAgent], // The assigned agent type
-                            metadata: {
-                                action: 'assigned',
-                                identifier: issue.identifier,
-                                assignee: assignee?.name,
-                                assigneeEmail: assignee?.email,
-                                previousAssignee: updatedFrom?.assigneeId,
-                            },
-                        });
-                    }
-                    else {
-                        // Regular update event
-                        events.push({
-                            ...baseEvent,
-                            type: 'issue_updated',
-                            item: {
-                                type: 'ticket',
-                                id: String(issue.id),
-                                number: issue.number,
-                                title: String(issue.title || ''),
-                                body: String(issue.description || ''),
-                                url: String(issue.url || ''),
-                                state: String(issue.state?.name || issue.state || 'unknown'),
-                            },
-                            labels: labelNames,
-                            priority: mapPriority(issue.priority),
-                            metadata: {
-                                action,
-                                identifier: issue.identifier,
-                                updatedFrom,
-                            },
-                        });
-                    }
-                }
-                break;
-            }
-            case 'Comment': {
-                const comment = webhookData;
-                const issue = comment.issue;
-                if (action === 'create' && issue) {
-                    const mentions = extractMentions(comment.body);
-                    events.push({
-                        ...baseEvent,
-                        type: mentions.length > 0 ? 'mention' : 'comment_created',
-                        item: {
-                            type: 'comment',
-                            id: String(comment.id),
-                            number: issue.number,
-                            title: String(issue.title || ''),
-                            body: String(comment.body || ''),
-                            url: String(comment.url || issue.url || ''),
-                        },
-                        mentions,
-                        metadata: {
-                            action,
-                            issueId: issue.id,
-                            issueIdentifier: issue.identifier,
-                            parentCommentId: comment.parent?.id,
-                        },
-                    });
-                }
-                break;
-            }
-            case 'Project': {
-                const project = webhookData;
-                if (action === 'create') {
-                    events.push({
-                        ...baseEvent,
-                        type: 'project_created',
-                        context: {
-                            name: String(project.name || 'unknown'),
-                            url: String(project.url || ''),
-                        },
-                        metadata: {
-                            action,
-                            projectId: project.id,
-                            description: project.description,
-                            targetDate: project.targetDate,
-                        },
-                    });
-                }
-                break;
-            }
-            case 'IssueLabel': {
-                // Label added/removed from issue
-                const label = webhookData;
-                events.push({
-                    ...baseEvent,
-                    type: 'label_change',
-                    labels: [String(label.name || '')],
-                    metadata: {
-                        action,
-                        labelId: label.id,
-                        color: label.color,
-                    },
-                });
-                break;
-            }
-            default:
-                // Unknown type - create generic event
-                events.push({
-                    ...baseEvent,
-                    type: `linear.${type?.toLowerCase() || 'unknown'}.${action || 'unknown'}`,
-                    metadata: { action, type },
-                });
-        }
-        return events;
-    },
-};
-//# sourceMappingURL=linear.js.map

package/packages/cloud/dist/webhooks/parsers/slack.d.ts

@@ -1,9 +0,0 @@
-/**
- * Slack Webhook Parser
- *
- * Transforms Slack Events API payloads into normalized events.
- * https://api.slack.com/apis/connections/events-api
- */
-import type { WebhookParser } from '../types.js';
-export declare const slackParser: WebhookParser;
-//# sourceMappingURL=slack.d.ts.map

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

@@ -1,214 +0,0 @@
-/**
- * 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/packages/cloud/dist/webhooks/responders/github.d.ts

@@ -1,8 +0,0 @@
-/**
- * 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/packages/cloud/dist/webhooks/responders/github.js

@@ -1,73 +0,0 @@
-/**
- * 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/packages/cloud/dist/webhooks/responders/index.d.ts

@@ -1,23 +0,0 @@
-/**
- * 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/packages/cloud/dist/webhooks/responders/index.js

@@ -1,30 +0,0 @@
-/**
- * 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/packages/cloud/dist/webhooks/responders/linear.d.ts

@@ -1,9 +0,0 @@
-/**
- * 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