agent-relay 1.0.22 → 1.2.0

package/dist/cloud/services/mention-handler.js

@@ -0,0 +1,405 @@
+/**
+ * Mention Handler Service
+ *
+ * Handles @mentions of agents in GitHub issues and PR comments.
+ * Routes mentions to appropriate agents for response.
+ *
+ * Flow:
+ * 1. App posts acknowledgment comment
+ * 2. Finds a linked daemon for the repository
+ * 3. Queues spawn command for the daemon
+ * 4. Agent works and posts response comment
+ */
+import { db } from '../db/index.js';
+import { nangoService } from './nango.js';
+/**
+ * Known agent types that can be mentioned
+ */
+export const KNOWN_AGENTS = {
+    // Generic agents
+    'agent-relay': 'General purpose agent for any task',
+    'lead': 'Lead agent for coordination and delegation',
+    'developer': 'Developer agent for coding tasks',
+    'reviewer': 'Code review agent',
+    // Specialized agents
+    'ci-fix': 'CI failure fixing agent',
+    'debugger': 'Bug investigation and fixing agent',
+    'docs': 'Documentation agent',
+    'test': 'Test writing agent',
+    'refactor': 'Code refactoring agent',
+};
+/**
+ * Check if a mention is for a known agent type
+ */
+export function isKnownAgent(mention) {
+    return mention in KNOWN_AGENTS;
+}
+/**
+ * Get the GitHub App name for comments
+ */
+function getAppName() {
+    return process.env.GITHUB_APP_NAME || 'Agent Relay';
+}
+/**
+ * Post an acknowledgment comment on GitHub
+ */
+async function postAcknowledgmentComment(repository, issueNumber, mentionedAgent, authorLogin) {
+    if (!repository.nangoConnectionId) {
+        console.warn(`[mention-handler] Repository ${repository.githubFullName} has no Nango connection`);
+        return null;
+    }
+    const [owner, repo] = repository.githubFullName.split('/');
+    const appName = getAppName();
+    const agentDescription = isKnownAgent(mentionedAgent)
+        ? KNOWN_AGENTS[mentionedAgent]
+        : 'Custom agent';
+    const body = `👋 @${authorLogin}, I've received your request and am routing it to **@${mentionedAgent}** (${agentDescription}).
+
+The agent will respond shortly. You can track progress in this thread.
+
+_— ${appName}_`;
+    try {
+        const result = await nangoService.addGithubIssueComment(repository.nangoConnectionId, owner, repo, issueNumber, body);
+        console.log(`[mention-handler] Posted acknowledgment comment: ${result.html_url}`);
+        return { id: result.id, url: result.html_url };
+    }
+    catch (error) {
+        console.error(`[mention-handler] Failed to post acknowledgment comment:`, error);
+        return null;
+    }
+}
+/**
+ * Find a linked daemon that can handle this repository
+ */
+async function findAvailableDaemon(repository) {
+    // The daemon must belong to the repository owner
+    if (!repository.userId) {
+        console.warn(`[mention-handler] Repository ${repository.githubFullName} has no userId`);
+        return null;
+    }
+    const daemons = await db.linkedDaemons.findByUserId(repository.userId);
+    const onlineDaemon = daemons.find(d => d.status === 'online');
+    if (!onlineDaemon) {
+        console.warn(`[mention-handler] No online daemon found for user ${repository.userId}`);
+        return null;
+    }
+    return { id: onlineDaemon.id, userId: repository.userId };
+}
+/**
+ * Queue a spawn command for a linked daemon
+ */
+async function queueSpawnCommand(daemonId, agentName, prompt, metadata) {
+    const command = {
+        type: 'spawn_agent',
+        agentName,
+        cli: 'claude', // Default to Claude CLI
+        task: prompt,
+        metadata,
+        timestamp: new Date().toISOString(),
+    };
+    await db.linkedDaemons.queueMessage(daemonId, {
+        from: { daemonId: 'cloud', daemonName: 'Agent Relay Cloud', agent: 'system' },
+        to: '__spawner__',
+        content: JSON.stringify(command),
+        metadata: { type: 'spawn_command' },
+        timestamp: new Date().toISOString(),
+    });
+    console.log(`[mention-handler] Queued spawn command for daemon ${daemonId}`);
+}
+/**
+ * Handle a mention record
+ *
+ * This function:
+ * 1. Validates the mention is for a known agent
+ * 2. Posts an acknowledgment comment
+ * 3. Finds a linked daemon
+ * 4. Queues a spawn command for the agent
+ */
+export async function handleMention(mention) {
+    console.log(`[mention-handler] Processing mention: @${mention.mentionedAgent} in ${mention.repository}`);
+    // Check if this is a known agent type
+    if (!isKnownAgent(mention.mentionedAgent)) {
+        console.log(`[mention-handler] Unknown agent: @${mention.mentionedAgent}, checking workspace config`);
+        // TODO: Check workspace configuration for custom agent names
+        // For now, mark as ignored
+        await db.commentMentions.markIgnored(mention.id);
+        return;
+    }
+    // Find the repository to get Nango connection
+    const repository = await db.repositories.findByFullName(mention.repository);
+    if (!repository) {
+        console.error(`[mention-handler] Repository not found: ${mention.repository}`);
+        await db.commentMentions.markIgnored(mention.id);
+        return;
+    }
+    // Generate agent info
+    const agentId = `mention-${mention.id}`;
+    const agentName = `${mention.mentionedAgent}-${mention.issueOrPrNumber}`;
+    // Update status to processing
+    await db.commentMentions.markProcessing(mention.id, agentId, agentName);
+    // Step 1: Post acknowledgment comment
+    const ackResult = await postAcknowledgmentComment(repository, mention.issueOrPrNumber, mention.mentionedAgent, mention.authorLogin);
+    if (!ackResult) {
+        console.warn(`[mention-handler] Could not post acknowledgment, continuing anyway`);
+    }
+    // Step 2: Find a linked daemon
+    const daemon = await findAvailableDaemon(repository);
+    if (!daemon) {
+        console.warn(`[mention-handler] No available daemon for ${mention.repository}`);
+        // Post a comment explaining the situation
+        if (repository.nangoConnectionId) {
+            const [owner, repo] = repository.githubFullName.split('/');
+            try {
+                await nangoService.addGithubIssueComment(repository.nangoConnectionId, owner, repo, mention.issueOrPrNumber, `⚠️ @${mention.authorLogin}, I couldn't find an available agent to handle this request. Please ensure you have a linked Agent Relay daemon running.
+
+You can set this up by running \`agent-relay cloud link\` on your development machine.
+
+_— ${getAppName()}_`);
+            }
+            catch (error) {
+                console.error(`[mention-handler] Failed to post error comment:`, error);
+            }
+        }
+        return;
+    }
+    // Step 3: Build the prompt for the agent
+    const prompt = buildMentionPrompt(mention, repository);
+    // Step 4: Queue spawn command for the daemon
+    await queueSpawnCommand(daemon.id, agentName, prompt, {
+        mentionId: mention.id,
+        repository: mention.repository,
+        issueNumber: mention.issueOrPrNumber,
+        authorLogin: mention.authorLogin,
+    });
+    console.log(`[mention-handler] Spawned agent @${mention.mentionedAgent} for mention ${mention.id}`);
+}
+/**
+ * Build a prompt for handling a mention
+ */
+function buildMentionPrompt(mention, _repository) {
+    const agentDescription = isKnownAgent(mention.mentionedAgent)
+        ? KNOWN_AGENTS[mention.mentionedAgent]
+        : 'Custom agent';
+    const sourceTypeDescription = {
+        issue_comment: 'GitHub issue comment',
+        pr_comment: 'GitHub PR comment',
+        pr_review: 'GitHub PR review comment',
+    }[mention.sourceType] || 'GitHub comment';
+    const responseInstructions = `
+## Response Instructions
+
+When you complete your work:
+1. Post a comment on GitHub to notify @${mention.authorLogin}
+2. Reference specific files and line numbers when relevant
+3. If you made code changes, push them and reference the commit
+
+Use the GitHub CLI (\`gh\`) to post your response:
+\`\`\`bash
+gh issue comment ${mention.issueOrPrNumber} --repo ${mention.repository} --body "Your response here @${mention.authorLogin}"
+\`\`\`
+
+Or for PR comments:
+\`\`\`bash
+gh pr comment ${mention.issueOrPrNumber} --repo ${mention.repository} --body "Your response here @${mention.authorLogin}"
+\`\`\`
+`;
+    return `
+# Agent Mention Task
+
+You (@${mention.mentionedAgent}) have been mentioned in a ${sourceTypeDescription}.
+
+## Your Role
+${agentDescription}
+
+## Context
+
+**Repository:** ${mention.repository}
+**Issue/PR:** #${mention.issueOrPrNumber}
+**Comment by:** @${mention.authorLogin}
+**Comment URL:** ${mention.commentUrl || 'N/A'}
+
+## Comment
+
+${mention.commentBody}
+
+## Your Task
+
+Analyze the comment and respond appropriately:
+
+1. If a question was asked, provide a helpful answer
+2. If a task was requested, either complete it or explain what's needed
+3. If feedback was given, acknowledge it and act on it if needed
+
+${responseInstructions}
+
+## Important
+
+- Be concise and helpful
+- If you need to make code changes, create a commit and push
+- If the request is unclear, ask for clarification in your response
+- Always @mention ${mention.authorLogin} in your response so they get notified
+`.trim();
+}
+/**
+ * Handle an issue assignment
+ *
+ * Called when an issue should be assigned to an agent
+ */
+export async function handleIssueAssignment(assignment) {
+    console.log(`[mention-handler] Processing issue assignment: #${assignment.issueNumber} in ${assignment.repository}`);
+    // Find the repository
+    const repository = await db.repositories.findByFullName(assignment.repository);
+    if (!repository) {
+        console.error(`[mention-handler] Repository not found: ${assignment.repository}`);
+        return;
+    }
+    // Post acknowledgment comment
+    if (repository.nangoConnectionId) {
+        const [owner, repo] = repository.githubFullName.split('/');
+        try {
+            await nangoService.addGithubIssueComment(repository.nangoConnectionId, owner, repo, assignment.issueNumber, `🤖 I've been assigned to work on this issue. I'll analyze the problem and get started.
+
+You can track my progress in this thread. I'll update you when I have a solution or need more information.
+
+_— ${getAppName()}_`);
+        }
+        catch (error) {
+            console.error(`[mention-handler] Failed to post assignment comment:`, error);
+        }
+    }
+    // Find a linked daemon
+    const daemon = await findAvailableDaemon(repository);
+    if (!daemon) {
+        console.warn(`[mention-handler] No available daemon for ${assignment.repository}`);
+        if (repository.nangoConnectionId) {
+            const [owner, repo] = repository.githubFullName.split('/');
+            try {
+                await nangoService.addGithubIssueComment(repository.nangoConnectionId, owner, repo, assignment.issueNumber, `⚠️ I couldn't start working on this issue because no Agent Relay daemon is available.
+
+Please ensure you have a linked daemon running by executing \`agent-relay cloud link\` on your development machine.
+
+_— ${getAppName()}_`);
+            }
+            catch (error) {
+                console.error(`[mention-handler] Failed to post error comment:`, error);
+            }
+        }
+        return;
+    }
+    // Build prompt for the issue
+    const prompt = buildIssuePrompt(assignment, repository);
+    // Queue spawn command
+    const agentName = `issue-${assignment.issueNumber}`;
+    await queueSpawnCommand(daemon.id, agentName, prompt, {
+        mentionId: assignment.id,
+        repository: assignment.repository,
+        issueNumber: assignment.issueNumber,
+        authorLogin: 'issue-author', // TODO: Get from issue
+    });
+    // Update assignment status and assign agent
+    await db.issueAssignments.assignAgent(assignment.id, agentName, agentName);
+    await db.issueAssignments.updateStatus(assignment.id, 'in_progress');
+    console.log(`[mention-handler] Spawned agent for issue #${assignment.issueNumber}`);
+}
+/**
+ * Build a prompt for an issue assignment
+ */
+function buildIssuePrompt(assignment, _repository) {
+    const priorityNote = assignment.priority
+        ? `\n**Priority:** ${assignment.priority.toUpperCase()}`
+        : '';
+    const labelsNote = assignment.labels && assignment.labels.length > 0
+        ? `\n**Labels:** ${assignment.labels.join(', ')}`
+        : '';
+    return `
+# Issue Assignment
+
+You have been assigned to work on GitHub issue #${assignment.issueNumber}.
+
+## Issue Details
+
+**Repository:** ${assignment.repository}
+**Title:** ${assignment.issueTitle}${priorityNote}${labelsNote}
+**URL:** ${assignment.issueUrl || 'N/A'}
+
+## Description
+
+${assignment.issueBody || 'No description provided.'}
+
+## Your Task
+
+1. Analyze the issue and understand what needs to be done
+2. Investigate the codebase to find relevant files
+3. Implement a solution if possible
+4. Create a PR with your changes
+5. Link the PR to this issue
+
+## Response Instructions
+
+Keep the issue updated with your progress:
+\`\`\`bash
+gh issue comment ${assignment.issueNumber} --repo ${assignment.repository} --body "Your update here"
+\`\`\`
+
+When you create a PR:
+\`\`\`bash
+gh pr create --repo ${assignment.repository} --title "Fix #${assignment.issueNumber}: Brief description" --body "Fixes #${assignment.issueNumber}
+
+Description of changes..."
+\`\`\`
+
+## Important
+
+- Start with a comment on the issue acknowledging you're working on it
+- If you need clarification, ask in the issue comments
+- Create a draft PR early if the fix is complex
+- Reference the issue number in your commit messages (e.g., "Fix #${assignment.issueNumber}")
+`.trim();
+}
+/**
+ * Get pending mentions for processing
+ */
+export async function getPendingMentions(limit = 50) {
+    return db.commentMentions.findPending(limit);
+}
+/**
+ * Get pending issue assignments for processing
+ */
+export async function getPendingIssueAssignments(limit = 50) {
+    return db.issueAssignments.findPending(limit);
+}
+/**
+ * Process all pending mentions (background job)
+ */
+export async function processPendingMentions() {
+    const pending = await getPendingMentions();
+    let processed = 0;
+    for (const mention of pending) {
+        try {
+            await handleMention(mention);
+            processed++;
+        }
+        catch (error) {
+            console.error(`[mention-handler] Failed to process mention ${mention.id}:`, error);
+        }
+    }
+    return processed;
+}
+/**
+ * Process all pending issue assignments (background job)
+ */
+export async function processPendingIssueAssignments() {
+    const pending = await getPendingIssueAssignments();
+    let processed = 0;
+    for (const assignment of pending) {
+        try {
+            await handleIssueAssignment(assignment);
+            processed++;
+        }
+        catch (error) {
+            console.error(`[mention-handler] Failed to process assignment ${assignment.id}:`, error);
+        }
+    }
+    return processed;
+}
+//# sourceMappingURL=mention-handler.js.map

package/dist/cloud/services/mention-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-handler.js","sourceRoot":"","sources":["../../../src/cloud/services/mention-handler.ts"],"names":[],"mappings":"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"}

package/dist/cloud/services/nango.d.ts

@@ -0,0 +1,126 @@
+export declare const NANGO_INTEGRATIONS: {
+    readonly GITHUB_USER: "github";
+    readonly GITHUB_APP: "github-app-oauth";
+};
+export interface GithubUserProfile {
+    id: number;
+    login: string;
+    email?: string;
+    avatar_url?: string;
+}
+declare class NangoService {
+    private client;
+    private secret;
+    constructor();
+    /**
+     * Create a Nango connect session restricted to specific integrations.
+     */
+    createConnectSession(allowedIntegrations: string[], endUser: {
+        id: string;
+        email?: string;
+    }): Promise<{
+        token: string;
+        connect_link: string;
+        expires_at: string;
+    }>;
+    /**
+     * Fetch GitHub user profile via Nango proxy.
+     */
+    getGithubUser(connectionId: string): Promise<GithubUserProfile>;
+    /**
+     * Retrieve an installation access token from a GitHub App connection.
+     * Use this ONLY when you need the raw token (e.g., for git clone URLs).
+     * For API calls, use the proxy methods instead.
+     */
+    getGithubAppToken(connectionId: string): Promise<string>;
+    /**
+     * List repositories available to a GitHub App installation using the Nango Proxy.
+     * The proxy automatically handles token injection and refresh.
+     * @see https://nango.dev/docs/implementation-guides/requests-proxy/implement-requests-proxy
+     */
+    listGithubAppRepos(connectionId: string): Promise<{
+        repositories: Array<{
+            id: number;
+            full_name: string;
+            private: boolean;
+            default_branch: string;
+        }>;
+    }>;
+    /**
+     * Get the GitHub App installation ID from a connection.
+     * The installation ID is stored in connection_config.installation_id
+     */
+    getGithubAppInstallationId(connectionId: string): Promise<number | null>;
+    /**
+     * Create an issue via Nango Proxy.
+     */
+    createGithubIssue(connectionId: string, owner: string, repo: string, data: {
+        title: string;
+        body?: string;
+        labels?: string[];
+    }): Promise<{
+        number: number;
+        html_url: string;
+    }>;
+    /**
+     * Create a pull request via Nango Proxy.
+     */
+    createGithubPullRequest(connectionId: string, owner: string, repo: string, data: {
+        title: string;
+        body?: string;
+        head: string;
+        base: string;
+    }): Promise<{
+        number: number;
+        html_url: string;
+    }>;
+    /**
+     * Add a comment to an issue via Nango Proxy.
+     */
+    addGithubIssueComment(connectionId: string, owner: string, repo: string, issueNumber: number, body: string): Promise<{
+        id: number;
+        html_url: string;
+    }>;
+    /**
+     * Update connection end user metadata (e.g., after creating a user record).
+     */
+    updateEndUser(connectionId: string, providerConfigKey: string, endUser: {
+        id: string;
+        email?: string;
+    }): Promise<void>;
+    /**
+     * Delete a connection from Nango.
+     *
+     * Used to remove temporary session connections for returning users
+     * to prevent duplicate connections in Nango. In the two-connection pattern,
+     * new users get a permanent connection but returning users authenticate
+     * with a temporary one that gets deleted.
+     *
+     * @param connectionId - Nango connection ID to delete
+     * @param providerConfigKey - The integration key (e.g., 'github')
+     */
+    deleteConnection(connectionId: string, providerConfigKey: string): Promise<void>;
+    /**
+     * Get connection metadata including end_user info.
+     * Useful when webhook doesn't include end_user data.
+     */
+    getConnection(connectionId: string, providerConfigKey: string): Promise<{
+        id: number;
+        connection_id: string;
+        provider_config_key: string;
+        end_user?: {
+            id?: string;
+            email?: string;
+        };
+        metadata?: Record<string, unknown>;
+    }>;
+    /**
+     * Verify webhook signature sent by Nango.
+     * Uses the new verifyIncomingWebhookRequest method.
+     * @see https://nango.dev/docs/reference/sdks/node#verify-webhook-signature
+     */
+    verifyWebhookSignature(rawBody: string, headers: Record<string, string | string[] | undefined>): boolean;
+}
+export declare const nangoService: NangoService;
+export {};
+//# sourceMappingURL=nango.d.ts.map

package/dist/cloud/services/nango.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nango.d.ts","sourceRoot":"","sources":["../../../src/cloud/services/nango.ts"],"names":[],"mappings":"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"}