agent-relay 1.1.0 → 1.2.3

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

@@ -0,0 +1,234 @@
+/**
+ * GitHub Webhook Parser
+ *
+ * Transforms GitHub webhook payloads into normalized events.
+ */
+/**
+ * Extract @mentions from text
+ */
+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 GitHub priority labels to normalized priority
+ */
+function extractPriority(labels) {
+    const labelNames = labels.map(l => l.name.toLowerCase());
+    if (labelNames.includes('critical') || labelNames.includes('p0'))
+        return 'critical';
+    if (labelNames.includes('high') || labelNames.includes('p1'))
+        return 'high';
+    if (labelNames.includes('medium') || labelNames.includes('p2'))
+        return 'medium';
+    if (labelNames.includes('low') || labelNames.includes('p3'))
+        return 'low';
+    return undefined;
+}
+export const githubParser = {
+    id: 'github',
+    parse(payload, headers) {
+        const eventType = headers['x-github-event'];
+        const deliveryId = headers['x-github-delivery'];
+        const data = payload;
+        const events = [];
+        const repository = data.repository;
+        const sender = data.sender;
+        const baseEvent = {
+            id: deliveryId || `github-${Date.now()}`,
+            source: 'github',
+            timestamp: new Date(),
+            actor: {
+                id: String(sender?.id || 'unknown'),
+                name: String(sender?.login || 'unknown'),
+            },
+            context: {
+                name: String(repository?.full_name || 'unknown'),
+                url: String(repository?.html_url || ''),
+            },
+            labels: [],
+            mentions: [],
+            metadata: {},
+            rawPayload: payload,
+        };
+        switch (eventType) {
+            case 'check_run': {
+                const checkRun = data.check_run;
+                const action = data.action;
+                const conclusion = checkRun?.conclusion;
+                const pullRequests = checkRun?.pull_requests;
+                if (action === 'completed' && conclusion === 'failure' && pullRequests?.length) {
+                    const pr = pullRequests[0];
+                    const output = checkRun.output;
+                    const annotations = output?.annotations;
+                    events.push({
+                        ...baseEvent,
+                        type: 'ci_failure',
+                        item: {
+                            type: 'check',
+                            id: String(checkRun.id),
+                            number: pr.number,
+                            title: String(checkRun.name),
+                            body: String(output?.summary || ''),
+                            url: String(checkRun.html_url || ''),
+                            state: 'failure',
+                        },
+                        metadata: {
+                            checkName: checkRun.name,
+                            conclusion,
+                            branch: pr.head?.ref,
+                            commitSha: pr.head?.sha,
+                            failureTitle: output?.title,
+                            failureSummary: output?.summary,
+                            failureDetails: output?.text,
+                            annotations: annotations?.map(a => ({
+                                path: a.path,
+                                startLine: a.start_line,
+                                endLine: a.end_line,
+                                level: a.annotation_level,
+                                message: a.message,
+                            })),
+                        },
+                    });
+                }
+                break;
+            }
+            case 'issues': {
+                const issue = data.issue;
+                const action = data.action;
+                const labels = (issue?.labels || []);
+                if (action === 'opened' || action === 'labeled') {
+                    events.push({
+                        ...baseEvent,
+                        type: 'issue_created',
+                        item: {
+                            type: 'issue',
+                            id: String(issue.id),
+                            number: issue.number,
+                            title: String(issue.title),
+                            body: String(issue.body || ''),
+                            url: String(issue.html_url),
+                            state: String(issue.state),
+                        },
+                        labels: labels.map(l => l.name),
+                        priority: extractPriority(labels),
+                        mentions: extractMentions(issue.body),
+                        metadata: {
+                            action,
+                            assignees: (issue.assignees || []).map(a => a.login),
+                        },
+                    });
+                }
+                break;
+            }
+            case 'issue_comment': {
+                const issue = data.issue;
+                const comment = data.comment;
+                const action = data.action;
+                const isPR = !!(issue?.pull_request);
+                if (action === 'created') {
+                    const mentions = extractMentions(comment.body);
+                    if (mentions.length > 0) {
+                        events.push({
+                            ...baseEvent,
+                            type: 'mention',
+                            item: {
+                                type: isPR ? 'pull_request' : 'issue',
+                                id: String(comment.id),
+                                number: issue.number,
+                                title: String(issue.title),
+                                body: String(comment.body),
+                                url: String(comment.html_url),
+                            },
+                            mentions,
+                            metadata: {
+                                commentId: comment.id,
+                                commentUrl: comment.html_url,
+                                isPR,
+                            },
+                        });
+                    }
+                }
+                break;
+            }
+            case 'pull_request_review_comment': {
+                const pr = data.pull_request;
+                const comment = data.comment;
+                const action = data.action;
+                if (action === 'created') {
+                    const mentions = extractMentions(comment.body);
+                    if (mentions.length > 0) {
+                        events.push({
+                            ...baseEvent,
+                            type: 'mention',
+                            item: {
+                                type: 'pull_request',
+                                id: String(comment.id),
+                                number: pr.number,
+                                title: String(pr.title),
+                                body: String(comment.body),
+                                url: String(comment.html_url),
+                            },
+                            mentions,
+                            metadata: {
+                                commentId: comment.id,
+                                commentUrl: comment.html_url,
+                                filePath: comment.path,
+                                line: comment.line,
+                                isPR: true,
+                                isReviewComment: true,
+                            },
+                        });
+                    }
+                }
+                break;
+            }
+            case 'pull_request': {
+                const pr = data.pull_request;
+                const action = data.action;
+                const labels = (pr?.labels || []);
+                if (action === 'opened') {
+                    events.push({
+                        ...baseEvent,
+                        type: 'pr_opened',
+                        item: {
+                            type: 'pull_request',
+                            id: String(pr.id),
+                            number: pr.number,
+                            title: String(pr.title),
+                            body: String(pr.body || ''),
+                            url: String(pr.html_url),
+                            state: String(pr.state),
+                        },
+                        labels: labels.map(l => l.name),
+                        priority: extractPriority(labels),
+                        mentions: extractMentions(pr.body),
+                        metadata: {
+                            action,
+                            head: pr.head?.ref,
+                            base: pr.base?.ref,
+                            draft: pr.draft,
+                        },
+                    });
+                }
+                break;
+            }
+            default:
+                // Unknown event type - create a generic event
+                events.push({
+                    ...baseEvent,
+                    type: `github.${eventType}`,
+                    metadata: { action: data.action },
+                });
+        }
+        return events;
+    },
+};
+//# sourceMappingURL=github.js.map

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

@@ -0,0 +1,23 @@
+/**
+ * Webhook Parsers Index
+ *
+ * Registry of all available parsers.
+ */
+import type { WebhookParser } from '../types.js';
+import { githubParser } from './github.js';
+import { linearParser } from './linear.js';
+import { slackParser } from './slack.js';
+/**
+ * Registry of all available parsers
+ */
+export declare const parsers: Record<string, WebhookParser>;
+/**
+ * Get a parser by ID
+ */
+export declare function getParser(id: string): WebhookParser | undefined;
+/**
+ * Register a custom parser
+ */
+export declare function registerParser(parser: WebhookParser): void;
+export { githubParser, linearParser, slackParser };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,30 @@
+/**
+ * Webhook Parsers Index
+ *
+ * Registry of all available parsers.
+ */
+import { githubParser } from './github.js';
+import { linearParser } from './linear.js';
+import { slackParser } from './slack.js';
+/**
+ * Registry of all available parsers
+ */
+export const parsers = {
+    github: githubParser,
+    linear: linearParser,
+    slack: slackParser,
+};
+/**
+ * Get a parser by ID
+ */
+export function getParser(id) {
+    return parsers[id];
+}
+/**
+ * Register a custom parser
+ */
+export function registerParser(parser) {
+    parsers[parser.id] = parser;
+}
+export { githubParser, linearParser, slackParser };
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,9 @@
+/**
+ * Linear Webhook Parser
+ *
+ * Transforms Linear webhook payloads into normalized events.
+ * Linear webhooks: https://developers.linear.app/docs/graphql/webhooks
+ */
+import type { WebhookParser } from '../types.js';
+export declare const linearParser: WebhookParser;
+//# sourceMappingURL=linear.d.ts.map

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

@@ -0,0 +1,258 @@
+/**
+ * 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/dist/cloud/webhooks/parsers/slack.d.ts

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