Open source file-system and knowledge based agent template. Build AI agents that stay up to date with your knowledge base
use vercel waitUntil and improve logging
Hugo Richard6df78e8da43c
diff --git a/apps/chat/server/api/discord/gateway.get.ts b/apps/chat/server/api/discord/gateway.get.tsindex f7a6ed4..7eeafea 100644--- a/apps/chat/server/api/discord/gateway.get.ts+++ b/apps/chat/server/api/discord/gateway.get.ts@@ -1,7 +1,10 @@import type { DiscordAdapter } from '@chat-adapter/discord'+import { waitUntil } from '@vercel/functions'+import { createError, useLogger } from 'evlog'import { useBot } from '../../utils/bot/index'export default defineEventHandler(async (event) => {+ const requestLog = useLogger(event)const bot = useBot()await bot.initialize()@@ -9,22 +12,23 @@ export default defineEventHandler(async (event) => {try {discord = bot.getAdapter('discord') as DiscordAdapter} catch {- throw createError({ statusCode: 404, message: 'Discord adapter not configured' })+ requestLog.set({ outcome: 'adapter_not_configured' })+ throw createError({+ message: 'Discord adapter not configured',+ why: 'The Discord adapter requires NUXT_DISCORD_BOT_TOKEN to be set',+ fix: 'Set NUXT_DISCORD_BOT_TOKEN, NUXT_DISCORD_PUBLIC_KEY, and NUXT_DISCORD_APPLICATION_ID in your environment',+ })}const durationMs = 10 * 60 * 1000const { origin } = getRequestURL(event)const webhookUrl = `${origin}/api/webhooks/discord`+ requestLog.set({ gatewayDurationMs: durationMs, webhookUrl })+return discord.startGatewayListener({- waitUntil: (task: Promise<unknown>) => {- if (typeof event.waitUntil === 'function') {- event.waitUntil(task)- } else {- task.catch(() => {})- }- },+ waitUntil: (task: Promise<unknown>) => waitUntil(task),},durationMs,undefined,diff --git a/apps/chat/server/api/webhooks/[platform].post.ts b/apps/chat/server/api/webhooks/[platform].post.tsindex 2301739..002a6f1 100644--- a/apps/chat/server/api/webhooks/[platform].post.ts+++ b/apps/chat/server/api/webhooks/[platform].post.ts@@ -1,23 +1,35 @@+import { waitUntil } from '@vercel/functions'+import { createError, useLogger } from 'evlog'import { useBot } from '../../utils/bot/index'export default defineEventHandler((event) => {+ const requestLog = useLogger(event)const platform = getRouterParam(event, 'platform')++ requestLog.set({ platform })++ if (!platform) {+ throw createError({+ message: 'Missing platform parameter',+ why: 'The webhook URL must include a platform segment (e.g. /api/webhooks/github)',+ fix: 'Ensure the webhook URL is correctly configured in the platform settings',+ })+ }+const bot = useBot()const handler = bot.webhooks[platform as keyof typeof bot.webhooks]if (!handler) {- setResponseStatus(event, 404)- return { error: `Unknown platform: ${platform}` }+ requestLog.set({ outcome: 'unknown_platform' })+ throw createError({+ message: `Unknown platform: ${platform}`,+ why: `No adapter registered for platform "${platform}"`,+ fix: 'Check that the corresponding adapter env vars are set (NUXT_GITHUB_APP_ID, NUXT_DISCORD_BOT_TOKEN, etc.)',+ })}const request = toWebRequest(event)return handler(request, {- waitUntil: (task: Promise<unknown>) => {- if (typeof event.waitUntil === 'function') {- event.waitUntil(task)- } else {- task.catch(() => {})- }- },+ waitUntil: (task: Promise<unknown>) => waitUntil(task),})})diff --git a/apps/chat/server/utils/bot/adapters/github.ts b/apps/chat/server/utils/bot/adapters/github.tsindex 766fb63..c318268 100644--- a/apps/chat/server/utils/bot/adapters/github.ts+++ b/apps/chat/server/utils/bot/adapters/github.ts@@ -2,6 +2,7 @@ import { createHmac, timingSafeEqual } from 'node:crypto'import { createAppAuth } from '@octokit/auth-app'import { Octokit } from '@octokit/rest'import { Message, parseMarkdown, stringifyMarkdown, type Adapter, type AdapterPostableMessage, type RawMessage, type WebhookOptions, type FetchResult, type ThreadInfo, type FormattedContent, type ChatInstance } from 'chat'+import { createError, log } from 'evlog'import type { ThreadContext } from '../types'export interface GitHubThreadId {@@ -99,6 +100,11 @@ export class SavoirGitHubAdapter implements Adapter<GitHubThreadId, GitHubRawMes// eslint-disable-next-line require-awaitasync initialize(chat: ChatInstance): Promise<void> {this.chat = chat+ log.info({+ event: 'github.adapter.initialized',+ userName: this.userName,+ replyToNewIssues: this.replyToNewIssues,+ })}private async getOctokit(owner: string, repo: string): Promise<Octokit> {@@ -115,7 +121,17 @@ export class SavoirGitHubAdapter implements Adapter<GitHubThreadId, GitHubRawMesconst appOctokit = new Octokit({ authStrategy: createAppAuth, auth: { appId: this.appId, privateKey: this.privateKey } })- const { data: installation } = await appOctokit.apps.getRepoInstallation({ owner, repo })+ let installation+ try {+ const result = await appOctokit.apps.getRepoInstallation({ owner, repo })+ installation = result.data+ } catch (error) {+ throw createError({+ message: `GitHub App not installed on ${cacheKey}`,+ why: error instanceof Error ? error.message : 'Failed to get installation',+ fix: `Install the GitHub App on the repository ${cacheKey} from the app settings page`,+ })+ }const { token } = await auth({ type: 'installation', installationId: installation.id })@@ -123,6 +139,12 @@ export class SavoirGitHubAdapter implements Adapter<GitHubThreadId, GitHubRawMesthis.octokitCache.set(cacheKey, { octokit, expiresAt: Date.now() + 50 * 60 * 1000 })+ log.info({+ event: 'github.octokit.created',+ repo: cacheKey,+ installationId: installation.id,+ })+return octokit}@@ -140,12 +162,24 @@ export class SavoirGitHubAdapter implements Adapter<GitHubThreadId, GitHubRawMesasync handleWebhook(request: Request, options?: WebhookOptions): Promise<Response> {const body = await request.text()const signature = request.headers.get('X-Hub-Signature-256')+ const eventType = request.headers.get('X-GitHub-Event')+ const deliveryId = request.headers.get('X-GitHub-Delivery')if (!this.verifySignature(body, signature)) {+ log.warn({+ event: 'github.webhook.invalid_signature',+ deliveryId,+ eventType,+ })return new Response(JSON.stringify({ error: 'Invalid signature' }), { status: 401 })}- const eventType = request.headers.get('X-GitHub-Event')+ log.info({+ event: 'github.webhook.received',+ eventType,+ deliveryId,+ chatReady: !!this.chat,+ })if (eventType === 'ping') {return new Response(JSON.stringify({ ok: true, message: 'pong' }), { status: 200 })@@ -153,20 +187,36 @@ export class SavoirGitHubAdapter implements Adapter<GitHubThreadId, GitHubRawMesif (eventType === 'issue_comment') {const payload = JSON.parse(body) as GitHubIssueCommentPayload+ const repo = `${payload.repository.owner.login}/${payload.repository.name}`+ const issue = payload.issue.numberif (payload.action !== 'created') {+ log.info({+ event: 'github.webhook.skipped',+ reason: 'action_not_created',+ action: payload.action,+ repo,+ issue,+ })return new Response(JSON.stringify({ ok: true }), { status: 200 })}const botUserName = `${this.userName}[bot]`if (payload.comment.user.login === this.userName || payload.comment.user.login === botUserName) {+ log.info({+ event: 'github.webhook.skipped',+ reason: 'own_comment',+ author: payload.comment.user.login,+ repo,+ issue,+ })return new Response(JSON.stringify({ ok: true }), { status: 200 })}const threadId = this.encodeThreadId({owner: payload.repository.owner.login,repo: payload.repository.name,- issueNumber: payload.issue.number,+ issueNumber: issue,})const message = this.parseMessage({@@ -177,6 +227,17 @@ export class SavoirGitHubAdapter implements Adapter<GitHubThreadId, GitHubRawMescreated_at: payload.comment.created_at,})+ log.info({+ event: 'github.webhook.processing',+ type: 'issue_comment',+ repo,+ issue,+ threadId,+ author: payload.comment.user.login,+ isMention: message.isMention,+ commentId: payload.comment.id,+ })+this.chat!.processMessage(this, threadId, message, options)return new Response(JSON.stringify({ ok: true }), { status: 200 })@@ -184,13 +245,29 @@ export class SavoirGitHubAdapter implements Adapter<GitHubThreadId, GitHubRawMesif (eventType === 'issues') {const payload = JSON.parse(body) as GitHubIssuesPayload+ const repo = `${payload.repository.owner.login}/${payload.repository.name}`+ const issue = payload.issue.numberif (payload.action !== 'opened') {+ log.info({+ event: 'github.webhook.skipped',+ reason: 'action_not_opened',+ action: payload.action,+ repo,+ issue,+ })return new Response(JSON.stringify({ ok: true }), { status: 200 })}const botUserName = `${this.userName}[bot]`if (payload.issue.user.login === this.userName || payload.issue.user.login === botUserName) {+ log.info({+ event: 'github.webhook.skipped',+ reason: 'own_issue',+ author: payload.issue.user.login,+ repo,+ issue,+ })return new Response(JSON.stringify({ ok: true }), { status: 200 })}@@ -198,13 +275,21 @@ export class SavoirGitHubAdapter implements Adapter<GitHubThreadId, GitHubRawMesconst hasMention = issueText.includes(`@${this.userName}`)if (!this.replyToNewIssues && !hasMention) {+ log.info({+ event: 'github.webhook.skipped',+ reason: 'no_mention_and_reply_disabled',+ repo,+ issue,+ replyToNewIssues: this.replyToNewIssues,+ hasMention,+ })return new Response(JSON.stringify({ ok: true }), { status: 200 })}const threadId = this.encodeThreadId({owner: payload.repository.owner.login,repo: payload.repository.name,- issueNumber: payload.issue.number,+ issueNumber: issue,})const message = this.parseMessage({@@ -217,11 +302,27 @@ export class SavoirGitHubAdapter implements Adapter<GitHubThreadId, GitHubRawMesmessage.isMention = true+ log.info({+ event: 'github.webhook.processing',+ type: 'new_issue',+ repo,+ issue,+ threadId,+ author: payload.issue.user.login,+ hasMention,+ replyToNewIssues: this.replyToNewIssues,+ })+this.chat!.processMessage(this, threadId, message, options)return new Response(JSON.stringify({ ok: true }), { status: 200 })}+ log.info({+ event: 'github.webhook.unhandled',+ eventType,+ deliveryId,+ })return new Response(JSON.stringify({ ok: true }), { status: 200 })}@@ -238,6 +339,13 @@ export class SavoirGitHubAdapter implements Adapter<GitHubThreadId, GitHubRawMesbody,})+ log.info({+ event: 'github.comment.posted',+ repo: `${owner}/${repo}`,+ issue: issueNumber,+ commentId: data.id,+ })+return {id: String(data.id),threadId,diff --git a/apps/chat/server/utils/bot/index.ts b/apps/chat/server/utils/bot/index.tsindex b4d2adb..4c761f0 100644--- a/apps/chat/server/utils/bot/index.ts+++ b/apps/chat/server/utils/bot/index.ts@@ -2,7 +2,7 @@ import { Chat, ConsoleLogger, type Adapter, type Message, type Thread } from 'chimport { createDiscordAdapter } from '@chat-adapter/discord'import { createMemoryState } from '@chat-adapter/state-memory'import { createRedisState } from '@chat-adapter/state-redis'-import { log } from 'evlog'+import { createError, log } from 'evlog'import { SavoirGitHubAdapter } from './adapters/github'import { generateAIResponse } from './ai'import { hasContextProvider } from './types'@@ -11,12 +11,36 @@ let botInstance: Chat | null = nullasync function handleBotResponse(thread: Thread, message: Message) {const { adapter } = thread+ const startTime = Date.now()++ log.info({+ event: 'bot.response.start',+ adapter: adapter.name,+ threadId: thread.id,+ author: message.author.userName,+ isMention: message.isMention,+ messageLength: message.text.length,+ })- await adapter.addReaction(thread.id, message.id, 'eyes').catch(() => {})+ await adapter.addReaction(thread.id, message.id, 'eyes').catch((error) => {+ log.warn({+ event: 'bot.reaction.failed',+ emoji: 'eyes',+ threadId: thread.id,+ error: error instanceof Error ? error.message : 'Unknown',+ })+ })try {const context = hasContextProvider(adapter)- ? await adapter.fetchThreadContext(thread.id).catch(() => undefined)+ ? await adapter.fetchThreadContext(thread.id).catch((error) => {+ log.warn({+ event: 'bot.context.failed',+ threadId: thread.id,+ error: error instanceof Error ? error.message : 'Unknown',+ })+ return undefined+ }): { platform: adapter.name, title: '', body: '', labels: [], state: '', source: adapter.name }const response = await generateAIResponse(message.text, context)@@ -25,8 +49,22 @@ async function handleBotResponse(thread: Thread, message: Message) {await adapter.removeReaction(thread.id, message.id, 'eyes').catch(() => {})await adapter.addReaction(thread.id, message.id, 'thumbs_up').catch(() => {})++ log.info({+ event: 'bot.response.success',+ adapter: adapter.name,+ threadId: thread.id,+ durationMs: Date.now() - startTime,+ responseLength: response.length,+ })} catch (error) {- log.error('bot', `Error: ${error instanceof Error ? error.message : 'Unknown'}`)+ log.error({+ event: 'bot.response.failed',+ adapter: adapter.name,+ threadId: thread.id,+ durationMs: Date.now() - startTime,+ error: error instanceof Error ? error.message : 'Unknown',+ })await adapter.removeReaction(thread.id, message.id, 'eyes').catch(() => {})@@ -40,8 +78,12 @@ async function handleBotResponse(thread: Thread, message: Message) {${error instanceof Error ? error.message : 'Unknown error'}\`\`\`</details>`)- } catch (error) {- log.error('bot', `Error: ${error instanceof Error ? error.message : 'Unknown'}`)+ } catch (postError) {+ log.error({+ event: 'bot.error_post.failed',+ threadId: thread.id,+ error: postError instanceof Error ? postError.message : 'Unknown',+ })}}}@@ -49,7 +91,16 @@ ${error instanceof Error ? error.message : 'Unknown error'}function createBot(): Chat {const config = useRuntimeConfig()- const botUserName = (config.public.github?.botTrigger as string).replace('@', '')+ const botTrigger = config.public.github?.botTrigger as string+ if (!botTrigger) {+ throw createError({+ message: 'Bot trigger not configured',+ why: 'NUXT_PUBLIC_GITHUB_BOT_TRIGGER is not set',+ fix: 'Set NUXT_PUBLIC_GITHUB_BOT_TRIGGER to the bot mention trigger (e.g. @nuxt-agent)',+ })+ }++ const botUserName = botTrigger.replace('@', '')const adapters: Record<string, Adapter> = {}@@ -87,12 +138,16 @@ function createBot(): Chat {logger: 'info',})- // Direct mentions — works for any adapterbot.onNewMention(async (thread, message) => {+ log.info({+ event: 'bot.mention',+ adapter: thread.adapter.name,+ threadId: thread.id,+ author: message.author.userName,+ })await handleBotResponse(thread, message)})- // Thread continuation — respond in threads where the bot already participated (Discord only)bot.onNewMessage(/.*/, async (thread, message) => {if (message.isMention || message.author.isBot) returnif (thread.adapter.name === 'github') return@@ -101,9 +156,22 @@ function createBot(): Chat {const botHasReplied = messages.some((m: Message) => m.author.isBot)if (!botHasReplied) return+ log.info({+ event: 'bot.thread_continuation',+ adapter: thread.adapter.name,+ threadId: thread.id,+ author: message.author.userName,+ })await handleBotResponse(thread, message)})+ log.info({+ event: 'bot.created',+ userName: botUserName,+ adapters: Object.keys(adapters),+ state: redisUrl ? 'redis' : 'memory',+ })+return bot}