Skip to content

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.ts
index 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 * 1000
const { 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.ts
index 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.ts
index 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-await
async 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, GitHubRawMes
const 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, GitHubRawMes
this.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, GitHubRawMes
async 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, GitHubRawMes
if (eventType === 'issue_comment') {
const payload = JSON.parse(body) as GitHubIssueCommentPayload
+ const repo = `${payload.repository.owner.login}/${payload.repository.name}`
+ const issue = payload.issue.number
if (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, GitHubRawMes
created_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, GitHubRawMes
if (eventType === 'issues') {
const payload = JSON.parse(body) as GitHubIssuesPayload
+ const repo = `${payload.repository.owner.login}/${payload.repository.name}`
+ const issue = payload.issue.number
if (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, GitHubRawMes
const 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, GitHubRawMes
message.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, GitHubRawMes
body,
})
+ 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.ts
index 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 'ch
import { 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 = null
async 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 adapter
bot.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) return
if (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
}